The Hike SDK provides developers with a robust set of APIs to interact with our healthcare manufacturing effectively. It is designed for both server-side and client-side TypeScript environments, ensuring flexible integration into various web applications.
Before you begin, you need to have Node.js installed on your machine. Additionally, ensure you have an API key, which is essential for authenticating requests made through this SDK.
Install the SDK via npm:
npm install @hike/sdkOr using yarn:
yarn add @hike/sdkOr using pnpm:
pnpm add @hike/sdkTo use the Hike SDK, you must first initialize it with your configuration. This is done by providing an API key, the application environment, application ID, and version as follows:
// utils/hikeClient.ts
import hike from '@hike/sdk';
export default hike.init({
apiKey: process.env.HIKE_API_KEY,
appEnv: process.env.NODE_ENV,
appId: '@hike/my-web', // or process.env.npm_package_name
appVersion: '1.0.0' // or process.env.npm_package_version
companyId: '***'
});Once initialized, you can use the SDK to perform various operations. For example, to find a patient by their ID:
import hikeClient from '@/utils/hikeClient';
const patient = await hikeClient.services.findPatientById('Abc123');Or using destructuring:
const { findPatientById } = await hikeClient.services;
const patient = await findPatientById('Abc123');For client-side applications, initialize the SDK on the server-side and then wrap your root application component with the HikeProvider to ensure all server and client sub-components have access to the configured SDK:
// Inside your root App or Layout component
import hikeClient from '@/utils/hikeClient';
import { HikeProvider } from '@hike/sdk/ui';
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
<HikeProvider config={hikeClient.safeConfig}>{children}</HikeProvider>
</body>
</html>
);
}Once your application is wrapped in a HikeProvider, you can import and use SDK functions anywhere in your component tree.
import { statsForEvaluations, type EvaluationsStats } from '@hike/sdk';
export const EvaluationStats = () => {
const [stats, setStats] = useState<EvaluationsStats | null>(null);
useEffect(() => {
const fetchStats = async () => {
const response = await statsForEvaluations();
setStats(response);
};
fetchStats();
}, []);
if (!stats) {
return <p>Loading evaluation stats...</p>;
}
return (
<div>
<h1>Evaluation Stats</h1>
<p>Diabetic: {stats.diabeticCount}</p>
</div>
);
};Contributions are welcomed and appreciated; whether it's fixing bugs, improving documentation, implementing new features, or sharing your ideas.
-
Report Bugs: If you encounter any bugs or issues, please open an issue and provide detailed information to help us reproduce and resolve the problem.
-
Suggest Enhancements: If you have an idea for a new feature or enhancement, we'd love to hear it! Open an issue and describe your proposal in detail.
-
Submit Pull Requests: If you've implemented a bug fix or a new feature, feel free to submit a pull request. Make sure to provide a clear description of your changes.
-
Improve Documentation: Documentation is crucial for any project. If you find areas where the documentation can be improved, please submit a pull request or open an issue to let us know.
-
Share Your Expertise: If you're knowledgeable about a particular aspect of the project, consider sharing your expertise by answering questions in the issue section or contributing by updating the readme.
Distributed under the Apache License 2.0. See LICENSE for more information.
