@documedis/react-components 1.0.0-RC.1

package/LICENSE.md

@@ -0,0 +1,37 @@
+Copyright (c) 2025 Galenica AG. All rights reserved.
+
+PROPRIETARY SOFTWARE LICENSE
+
+This software and associated documentation files (the "Software") are the proprietary
+and confidential property of Galenica AG ("Licensor").
+
+NOTICE: This Software contains trade secrets and confidential information of Licensor.
+Use, reproduction, disclosure, or distribution of any portion of this Software is
+strictly prohibited without the express written permission of Licensor.
+
+NO LICENSE GRANTED
+No license, express or implied, by estoppel or otherwise, to any intellectual property
+rights is granted by this notice. The Software may not be copied, modified, distributed,
+published, uploaded, posted, transmitted, reproduced, or used in any way without
+Licensor's prior written consent.
+
+RESTRICTIONS
+You may not:
+
+1. Use the Software for any purpose without a valid license agreement with Licensor
+2. Modify, adapt, translate, or create derivative works based upon the Software
+3. Reverse engineer, disassemble, decompile, or otherwise attempt to derive the source code
+4. Remove, alter, or obscure any proprietary notices on the Software
+5. Transfer, sell, rent, lease, or sublicense the Software to any third party
+
+LIABILITY DISCLAIMER
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED.
+IN NO EVENT SHALL LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY ARISING
+FROM THE USE OR INABILITY TO USE THE SOFTWARE.
+
+GOVERNING LAW
+This notice shall be governed by and construed in accordance with the laws of Switzerland.
+
+For licensing inquiries, please contact:
+Galenica AG
+sales@hcisolutions.ch

package/README.md

@@ -0,0 +1,19 @@
+# @documedis/react-components
+
+React components for Documedis healthcare applications, providing seamless integration with electronic prescription workflows and pharmacy services.
+
+## Full Documentation
+
+For complete API reference, advanced usage examples, error handling, and interactive demos:
+
+**https://documentation.apps.documedis.ch**
+
+## License
+
+Copyright (c) 2025 Galenica AG. All rights reserved.
+
+This software is proprietary and confidential. Unauthorized copying, modification, distribution, or use of this software, via any medium, is strictly prohibited without the express written permission of Galenica AG.
+
+## Support
+
+Issues: Please contact your Documedis support representative

package/components/PharmacySelector/PharmacySelector.d.ts

@@ -0,0 +1,9 @@
+import { Environment, Pharmacy } from '../..';
+export interface PharmacySelectorProps {
+    accessToken: string;
+    environment: Environment;
+    enabledGalenicaChains?: string[];
+    className?: string;
+    onPharmacySelected: (pharmacy: Pharmacy | null) => void;
+}
+export declare const PharmacySelector: ({ accessToken, environment, enabledGalenicaChains, onPharmacySelected, className, }: PharmacySelectorProps) => import("react/jsx-runtime").JSX.Element;

package/components/PharmacySelector/index.d.ts

@@ -0,0 +1,4 @@
+export { PharmacySelector } from './PharmacySelector';
+export type { PharmacySelectorProps } from './PharmacySelector';
+export { usePharmacySelector } from './usePharmacySelector';
+export type { UsePharmacySelectorConfig, UsePharmacySelectorReturn, } from './usePharmacySelector';

package/components/PharmacySelector/usePharmacySelector.d.ts

@@ -0,0 +1,14 @@
+import { Environment, Pharmacy } from '../..';
+export interface UsePharmacySelectorConfig {
+    accessToken: string;
+    environment: Environment;
+    enabledGalenicaChains?: string[];
+}
+export interface UsePharmacySelectorReturn {
+    onQueryChange: (input: string) => void;
+    queriedPharmacies: Pharmacy[];
+    selectPharmacy: (pharmacy: Pharmacy) => void;
+    selectedPharmacy: Pharmacy | null;
+    isLoading: boolean;
+}
+export declare const usePharmacySelector: (config: UsePharmacySelectorConfig) => UsePharmacySelectorReturn;

package/components/PrescriptionSign/PrescriptionSign.d.ts

@@ -0,0 +1,2 @@
+import { PrescriptionSignProps } from './types';
+export declare const PrescriptionSign: ({ onSuccess, onError, onSessionTokenUpdate, className, ...props }: PrescriptionSignProps) => import("react/jsx-runtime").JSX.Element;

package/components/PrescriptionSign/index.d.ts

@@ -0,0 +1,4 @@
+export { PrescriptionSign } from './PrescriptionSign';
+export type { PrescriptionSignProps, UsePrescriptionSigningProps, } from './types';
+export { usePrescriptionSign } from './usePrescriptionSign';
+export type { UsePrescriptionSignReturn } from './usePrescriptionSign';

package/components/PrescriptionSign/types.d.ts

@@ -0,0 +1,77 @@
+import { DomainError, Environment } from '../..';
+interface PrescriptionSignReactProps {
+    accessToken: string;
+    environment: Environment;
+    chmed: string;
+    sessionToken?: string;
+    shouldGeneratePdf?: boolean;
+}
+/**
+ * Props for the usePrescriptionSign hook
+ */
+export type UsePrescriptionSigningProps = {
+    /**
+     * Environment configuration for the prescription service
+     * - 'local': Development environment (localhost:52247)
+     * - 'dev': Development Azure Container Apps
+     * - 'int': Integration Azure Container Apps
+     * - 'prod': Production Azure Container Apps
+     */
+    environment: Environment;
+    /** Access token for authenticating with the backend service */
+    accessToken: string;
+    /**
+     * Optional existing session token to reuse authentication state.
+     * If provided, the hook will attempt to use existing authentication.
+     */
+    sessionToken?: string;
+    /**
+     * Optional callback invoked when the session token is updated.
+     * Use this to persist the session token for reuse across hook instances.
+     */
+    onSessionTokenUpdate?: (token: string) => void;
+    /**
+     * Optional callback invoked when prescription signing succeeds.
+     * Receives the signed CHMED data as a base64-encoded string.
+     * Optionally receives the generatedPdf if the option
+     * shouldGeneratePdf is set to true.
+     *
+     * @see shouldGeneratePdf
+     */
+    onSuccess?: (signedCHMED: string, generatedPdf?: string) => void;
+    /**
+     * Optional callback invoked when prescription signing fails.
+     * Receives a specific error type indicating what went wrong.
+     */
+    onError?: (error: DomainError) => void;
+    /**
+     * Flag to generate PDF after signing.
+     */
+    shouldGeneratePdf: boolean;
+};
+/**
+ * Props for the PrescriptionSign React component
+ * Uses camelCase (React convention) - internally converted to kebab-case for web component
+ */
+export interface PrescriptionSignProps extends PrescriptionSignReactProps {
+    /** Optional additional CSS class names to apply to the component */
+    className?: string;
+    /**
+     * Optional callback invoked when the session token is updated.
+     * Use this to persist the session token for reuse across components.
+     */
+    onSessionTokenUpdate?: (sessionToken: string) => void;
+    /**
+     * Optional callback invoked when prescription signing succeeds.
+     * Receives the signed CHMED data as a base64-encoded string.
+     * Optionally receives the generatedPdf if the option
+     * generatePdf is set to true.
+     */
+    onSuccess?: (signedCHMED: string, generatedPdf?: string) => void;
+    /**
+     * Optional callback invoked when prescription signing fails.
+     * Receives a specific error type indicating what went wrong.
+     */
+    onError?: (error: DomainError) => void;
+}
+export {};

package/components/PrescriptionSign/useDocumentEvent.d.ts

@@ -0,0 +1 @@
+export declare function useDocumentEvent<T>(eventType: string, handler: ((detail: T) => void) | undefined): void;

package/components/PrescriptionSign/usePrescriptionSign.d.ts

@@ -0,0 +1,46 @@
+import { UsePrescriptionSigningProps } from './types';
+/**
+ * Return type for the usePrescriptionSign hook
+ */
+export interface UsePrescriptionSignReturn {
+    /** Function to initiate the signing process with CHMED data */
+    start: (encodedCHMED: string, shouldGeneratePdf: boolean) => void;
+    /** Function to terminate the signing process at any time */
+    interrupt: () => void;
+    /** Raw XState machine state (for advanced usage) */
+    state: any;
+    /** True when ready to start signing (initial state) */
+    isIdle: boolean;
+    /** True when actively processing (excludes error/success states) */
+    isActive: boolean;
+    /** True when in error state (persists until retry) */
+    isError: boolean;
+    /** True when signing completed successfully */
+    isSuccess: boolean;
+    /** True during the actual signature operation */
+    isSigning: boolean;
+    /** The signed prescription data (available after success) */
+    signedCHMED: string | undefined;
+}
+/**
+ * Hook to manage the ePrescription signature process
+ *
+ * This is a standalone hook that can be shipped in a library.
+ * It handles the complete HIN authentication and signing flow.
+ *
+ * Required peer dependencies:
+ * - next-auth/react (for session management)
+ * - xstate and @xstate/react
+ *
+ * @returns Object containing:
+ * - start: Function to initiate the signing process with CHMED data
+ * - interrupt: Function to terminate the signing process at any time
+ * - state: Raw XState machine state (for advanced usage)
+ * - isIdle: true when ready to start signing (initial state)
+ * - isActive: true when actively processing (excludes error/success states)
+ * - isError: true when in error state (persists until retry)
+ * - isSuccess: true when signing completed successfully
+ * - isSigning: true during the actual signature operation
+ * - signedCHMED: The signed prescription data (available after success)
+ */
+export declare function usePrescriptionSign(props: UsePrescriptionSigningProps): UsePrescriptionSignReturn;

package/index.d.ts

@@ -0,0 +1,23 @@
+export * from './components/PharmacySelector';
+export * from './components/PrescriptionSign';
+export type Environment = 'local' | 'int' | 'demo' | 'prod';
+export interface Pharmacy {
+    id: string;
+    gln: string;
+    name: string;
+    hinEmail?: string;
+    galenicaChain?: string;
+}
+export interface DomainError extends Error {
+    readonly id: string;
+    readonly timestamp: Date;
+    readonly code: string;
+    readonly userMessage: string;
+    readonly cause?: unknown;
+    toJSON(): {
+        type: string;
+        code: string;
+        message: string;
+    };
+    toHttpStatus(): number;
+}