@documedis/react-components 1.0.0-RC.5 → 1.0.0-RC.6

package/index.d.ts

@@ -1,3 +1,602 @@
-export * from './components/PharmacySelector';
-export * from './components/PrescriptionSign';
-export type { Environment, DomainError, Pharmacy } from '@documedis/shared-components/core';
+// Generated by dts-bundle-generator v9.5.1
+
+export interface Pharmacy {
+	id: string;
+	gln: string;
+	name: string;
+	hinEmail?: string;
+	galenicaChain?: string;
+}
+/**
+ * Environment configuration for Documedis components
+ *
+ * Architecture:
+ * - 'local': Local development (localhost:52247)
+ * - 'int': Integration/testing environment (int.apps.documedis.ch)
+ * - 'demo': Demo environment with non-prod data (demo.apps.documedis.ch)
+ * - 'prod': Production environment (apps.documedis.ch)
+ *
+ * URLs are predefined for each environment and should be updated in this file
+ * when deployment URLs change.
+ */
+export type Environment = "local" | "int" | "demo" | "prod";
+declare const ErrorCodes: {
+	/** Current section is expired and the user needs to re-authenticate */
+	readonly SESSION_EXPIRED: "SESSION_EXPIRED";
+	/** Provided token is invalid or malformed */
+	readonly INVALID_TOKEN: "INVALID_TOKEN";
+	/** User is not authenticated */
+	readonly NOT_AUTHENTICATED: "NOT_AUTHENTICATED";
+	/** The action is forbidden */
+	readonly FORBIDDEN: "FORBIDDEN";
+	/** The action is allowed but the user does not have sufficient permissions */
+	readonly INSUFFICIENT_PERMISSIONS: "INSUFFICIENT_PERMISSIONS";
+	/** Input is invalid (e.g., missing required fields, wrong data types) */
+	readonly INVALID_INPUT: "INVALID_INPUT";
+	/** Header is invalid (e.g., missing required fields, wrong format) */
+	readonly INVALID_HEADER: "INVALID_HEADER";
+	/** Operation could not be completed due to conflicting state */
+	readonly INVALID_STATE: "INVALID_STATE";
+	/** User closed the popup window before completing the action */
+	readonly POPUP_CLOSED: "POPUP_CLOSED";
+	/** User cancelled the action */
+	readonly USER_CANCELLED: "USER_CANCELLED";
+	/** User denied the required permissions */
+	readonly PERMISSION_DENIED_BY_USER: "PERMISSION_DENIED_BY_USER";
+	/** Required configuration is missing */
+	readonly MISSING_CONFIG: "MISSING_CONFIG";
+	/** Provided configuration is invalid or malformed */
+	readonly INVALID_CONFIG: "INVALID_CONFIG";
+	/** Popup window could not be opened because it was blocked by the browser */
+	readonly POPUP_BLOCKED: "POPUP_BLOCKED";
+	/** Browser is not compatible with the required features */
+	readonly BROWSER_INCOMPATIBLE: "BROWSER_INCOMPATIBLE";
+	/** Error during component initialization */
+	readonly COMPONENT_INITIALIZATION_ERROR: "COMPONENT_INITIALIZATION_ERROR";
+	/** Error related to database operations */
+	readonly DATABASE_ERROR: "DATABASE_ERROR";
+	/** Error related to cache operations */
+	readonly CACHE_ERROR: "CACHE_ERROR";
+	/** Service is not reachable because of network issues (no connection, CORS, etc.) */
+	readonly NETWORK_ERROR: "NETWORK_ERROR";
+	/** Service did not respond within the expected time frame */
+	readonly SERVICE_TIMEOUT: "SERVICE_TIMEOUT";
+	/** Service is reachable but returned a 503 Service Unavailable */
+	readonly SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE";
+	/** Access to the service is blocked by a firewall */
+	readonly FIREWALL_BLOCKED: "FIREWALL_BLOCKED";
+	/** Unknown error from internal service */
+	readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+	/** Unknown error from an external service */
+	readonly EXT_UNKNOWN_ERROR: "EXT_UNKNOWN_ERROR";
+	/** Too many requests sent in a given amount of time */
+	readonly RATE_LIMITED: "RATE_LIMITED";
+	/** Failures to complete the OAuth process */
+	readonly OAUTH_ERROR: "OAUTH_ERROR";
+	/** Failure to set up a service */
+	readonly SETUP_ERROR: "SETUP_ERROR";
+	/** Invalid response structure (unexpected format, fields, etc.) */
+	readonly INVALID_RESPONSE: "INVALID_RESPONSE";
+	/** The state in which an action is executed is invalid (e.g., wrong context, missing prerequisites) */
+	readonly INVALID_CONTEXT: "INVALID_CONTEXT";
+	/** Origin of the request is not trusted */
+	readonly UNTRUSTED_ORIGIN: "UNTRUSTED_ORIGIN";
+	/** Signature verification failed */
+	readonly INVALID_SIGNATURE: "INVALID_SIGNATURE";
+	/** Cross-Site Request Forgery violation */
+	readonly CSRF_VIOLATION: "CSRF_VIOLATION";
+	/** Cross-Origin Resource Sharing violation */
+	readonly CORS_VIOLATION: "CORS_VIOLATION";
+	/** Certificate error (e.g., invalid, expired, untrusted) */
+	readonly CERTIFICATE_ERROR: "CERTIFICATE_ERROR";
+};
+/**
+ * Type representing all possible error codes
+ */
+export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+declare namespace ErrorCode {
+	/** @see {@link ErrorCodes.SESSION_EXPIRED} */
+	type SESSION_EXPIRED = typeof ErrorCodes.SESSION_EXPIRED;
+	/** @see {@link ErrorCodes.INVALID_TOKEN} */
+	type INVALID_TOKEN = typeof ErrorCodes.INVALID_TOKEN;
+	/** @see {@link ErrorCodes.NOT_AUTHENTICATED} */
+	type NOT_AUTHENTICATED = typeof ErrorCodes.NOT_AUTHENTICATED;
+	/** @see {@link ErrorCodes.FORBIDDEN} */
+	type FORBIDDEN = typeof ErrorCodes.FORBIDDEN;
+	/** @see {@link ErrorCodes.INSUFFICIENT_PERMISSIONS} */
+	type INSUFFICIENT_PERMISSIONS = typeof ErrorCodes.INSUFFICIENT_PERMISSIONS;
+	/** @see {@link ErrorCodes.INVALID_INPUT} */
+	type INVALID_INPUT = typeof ErrorCodes.INVALID_INPUT;
+	/** @see {@link ErrorCodes.INVALID_HEADER} */
+	type INVALID_HEADER = typeof ErrorCodes.INVALID_HEADER;
+	/** @see {@link ErrorCodes.INVALID_STATE} */
+	type INVALID_STATE = typeof ErrorCodes.INVALID_STATE;
+	/** @see {@link ErrorCodes.POPUP_CLOSED} */
+	type POPUP_CLOSED = typeof ErrorCodes.POPUP_CLOSED;
+	/** @see {@link ErrorCodes.USER_CANCELLED} */
+	type USER_CANCELLED = typeof ErrorCodes.USER_CANCELLED;
+	/** @see {@link ErrorCodes.PERMISSION_DENIED_BY_USER} */
+	type PERMISSION_DENIED_BY_USER = typeof ErrorCodes.PERMISSION_DENIED_BY_USER;
+	/** @see {@link ErrorCodes.MISSING_CONFIG} */
+	type MISSING_CONFIG = typeof ErrorCodes.MISSING_CONFIG;
+	/** @see {@link ErrorCodes.INVALID_CONFIG} */
+	type INVALID_CONFIG = typeof ErrorCodes.INVALID_CONFIG;
+	/** @see {@link ErrorCodes.POPUP_BLOCKED} */
+	type POPUP_BLOCKED = typeof ErrorCodes.POPUP_BLOCKED;
+	/** @see {@link ErrorCodes.BROWSER_INCOMPATIBLE} */
+	type BROWSER_INCOMPATIBLE = typeof ErrorCodes.BROWSER_INCOMPATIBLE;
+	/** @see {@link ErrorCodes.COMPONENT_INITIALIZATION_ERROR} */
+	type COMPONENT_INITIALIZATION_ERROR = typeof ErrorCodes.COMPONENT_INITIALIZATION_ERROR;
+	/** @see {@link ErrorCodes.DATABASE_ERROR} */
+	type DATABASE_ERROR = typeof ErrorCodes.DATABASE_ERROR;
+	/** @see {@link ErrorCodes.CACHE_ERROR} */
+	type CACHE_ERROR = typeof ErrorCodes.CACHE_ERROR;
+	/** @see {@link ErrorCodes.NETWORK_ERROR} */
+	type NETWORK_ERROR = typeof ErrorCodes.NETWORK_ERROR;
+	/** @see {@link ErrorCodes.SERVICE_TIMEOUT} */
+	type SERVICE_TIMEOUT = typeof ErrorCodes.SERVICE_TIMEOUT;
+	/** @see {@link ErrorCodes.SERVICE_UNAVAILABLE} */
+	type SERVICE_UNAVAILABLE = typeof ErrorCodes.SERVICE_UNAVAILABLE;
+	/** @see {@link ErrorCodes.FIREWALL_BLOCKED} */
+	type FIREWALL_BLOCKED = typeof ErrorCodes.FIREWALL_BLOCKED;
+	/** @see {@link ErrorCodes.INTERNAL_ERROR} */
+	type INTERNAL_ERROR = typeof ErrorCodes.INTERNAL_ERROR;
+	/** @see {@link ErrorCodes.EXT_UNKNOWN_ERROR} */
+	type EXT_UNKNOWN_ERROR = typeof ErrorCodes.EXT_UNKNOWN_ERROR;
+	/** @see {@link ErrorCodes.RATE_LIMITED} */
+	type RATE_LIMITED = typeof ErrorCodes.RATE_LIMITED;
+	/** @see {@link ErrorCodes.OAUTH_ERROR} */
+	type OAUTH_ERROR = typeof ErrorCodes.OAUTH_ERROR;
+	/** @see {@link ErrorCodes.SETUP_ERROR} */
+	type SETUP_ERROR = typeof ErrorCodes.SETUP_ERROR;
+	/** @see {@link ErrorCodes.INVALID_RESPONSE} */
+	type INVALID_RESPONSE = typeof ErrorCodes.INVALID_RESPONSE;
+	/** @see {@link ErrorCodes.INVALID_CONTEXT} */
+	type INVALID_CONTEXT = typeof ErrorCodes.INVALID_CONTEXT;
+	/** @see {@link ErrorCodes.UNTRUSTED_ORIGIN} */
+	type UNTRUSTED_ORIGIN = typeof ErrorCodes.UNTRUSTED_ORIGIN;
+	/** @see {@link ErrorCodes.INVALID_SIGNATURE} */
+	type INVALID_SIGNATURE = typeof ErrorCodes.INVALID_SIGNATURE;
+	/** @see {@link ErrorCodes.CSRF_VIOLATION} */
+	type CSRF_VIOLATION = typeof ErrorCodes.CSRF_VIOLATION;
+	/** @see {@link ErrorCodes.CORS_VIOLATION} */
+	type CORS_VIOLATION = typeof ErrorCodes.CORS_VIOLATION;
+	/** @see {@link ErrorCodes.CERTIFICATE_ERROR} */
+	type CERTIFICATE_ERROR = typeof ErrorCodes.CERTIFICATE_ERROR;
+}
+/**
+ * Authentication errors define when authentication
+ * fails due to errors caused by factors controlled by
+ * this application.
+ */
+export interface AuthenticationError {
+	/** Error type discriminator for deserialization */
+	type: "Authentication";
+	/** Subset of error codes valid for Authentication errors */
+	code: ErrorCode.INVALID_TOKEN | ErrorCode.NOT_AUTHENTICATED | ErrorCode.SESSION_EXPIRED | ErrorCode.INVALID_SIGNATURE | ErrorCode.CERTIFICATE_ERROR | ErrorCode.SERVICE_TIMEOUT | ErrorCode.EXT_UNKNOWN_ERROR;
+	/** Error-specific data */
+	data: {
+		/** Authentication realm/system (e.g., 'hin', 'oauth') */
+		service?: string;
+	};
+}
+/**
+ * Authorization errors define when authorization
+ * fails due to insufficient permissions or access rights.
+ */
+export interface AuthorizationError {
+	/** Error type discriminator for deserialization */
+	type: "Authorization";
+	/** Subset of error codes valid for Authorization errors */
+	code: ErrorCode.INSUFFICIENT_PERMISSIONS | ErrorCode.FORBIDDEN | ErrorCode.UNTRUSTED_ORIGIN;
+	/** Error-specific data */
+	data: {
+		/** Action being attempted (e.g., 'sign-prescription') */
+		action: string;
+		/** Resource over which the action is being attempted (e.g., 'hin-prescription') */
+		resource?: string;
+		/** Permission required (e.g., 'practitioner-role') */
+		permission?: string;
+		/** Additional reason or context for the authorization failure */
+		reason?: string;
+	};
+}
+export type FieldIssue = "FIELD_MISSING" | "INVALID_FORMAT" | "OUT_OF_RANGE" | "INVALID_VALUE";
+export interface FieldValidationData {
+	/** Name of the invalid field */
+	field: string;
+	/** How the field is invalid */
+	reason?: FieldIssue;
+	/** Invalid value provided */
+	invalidValue?: unknown;
+	/** Additional details about the validation error */
+	details?: unknown;
+}
+/**
+ * Validation errors indicate that input data provided by
+ * this application to a service is invalid or inconsistent.
+ */
+export type ValidationError = {
+	/** Error type discriminator for deserialization */
+	type: "Validation";
+} & ({
+	/** Subset of error codes valid for Validation errors */
+	code: ErrorCode.INVALID_INPUT | ErrorCode.INVALID_HEADER;
+	/** Error-specific data */
+	data: {
+		/** List of fields that failed validation */
+		invalidFields: FieldValidationData[];
+	};
+} | {
+	/** Subset of error codes valid for Validation errors */
+	code: ErrorCode.INVALID_STATE;
+	/** Error-specific data */
+	data: {
+		/** Name of the entity in invalid state */
+		entity?: string;
+		/** Additional details on the reason */
+		details?: unknown;
+	};
+});
+/**
+ * User interaction errors indicate that an operation
+ * could not be completed due to user actions or decisions.
+ */
+export interface UserInteractionError {
+	type: "UserInteraction";
+	code: ErrorCode.USER_CANCELLED | ErrorCode.POPUP_CLOSED | ErrorCode.PERMISSION_DENIED_BY_USER;
+	data?: {
+		cause?: unknown;
+		duringOperation?: string;
+	};
+}
+/**
+ *  Configuration errors indicate issues with application
+ *  configuration that prevent normal operation.
+ */
+export interface ConfigurationError {
+	/** Error type discriminator for deserialization */
+	type: "Configuration";
+	/** Subset of error codes valid for Configuration errors */
+	code: ErrorCode.MISSING_CONFIG | ErrorCode.POPUP_BLOCKED | ErrorCode.INVALID_CONFIG | ErrorCode.FORBIDDEN | ErrorCode.COMPONENT_INITIALIZATION_ERROR;
+	/** Error-specific data */
+	data: {
+		/** Name of the missing or invalid configuration */
+		configName?: string;
+		/** Source of the configuration (e.g., 'azure keyvault', 'file') */
+		source?: string;
+		/** Additional details about the configuration error */
+		details?: unknown;
+	};
+}
+/**
+ * Security errors indicate violations of security policies,
+ * invalid signatures, untrusted origins, or other security threats.
+ */
+export interface SecurityError {
+	/** Error type discriminator for deserialization */
+	type: "Security";
+	/** Subset of error codes valid for Security errors */
+	code: ErrorCode.UNTRUSTED_ORIGIN | ErrorCode.INVALID_SIGNATURE | ErrorCode.CSRF_VIOLATION | ErrorCode.CORS_VIOLATION | ErrorCode.CERTIFICATE_ERROR;
+	/** Error-specific data */
+	data: {
+		/** Security context or domain (e.g., 'hin-saml', 'oauth') */
+		context?: string;
+		/** The operation that was blocked (e.g., 'authentication', 'api-call') */
+		operation?: string;
+		/** Additional security-related details (sanitized for logging) */
+		details?: unknown;
+	};
+}
+/**
+ * Service errors indicate failures in external or internal
+ * services that this application depends on.
+ */
+export interface ServiceError {
+	/** Error type discriminator for deserialization */
+	type: "Service";
+	/** Subset of error codes valid for Infrastructure errors */
+	code: ErrorCode.NETWORK_ERROR | ErrorCode.SERVICE_UNAVAILABLE | ErrorCode.INTERNAL_ERROR | ErrorCode.OAUTH_ERROR | ErrorCode.RATE_LIMITED | ErrorCode.SETUP_ERROR | ErrorCode.FIREWALL_BLOCKED | ErrorCode.DATABASE_ERROR | ErrorCode.CACHE_ERROR | ErrorCode.SERVICE_TIMEOUT | ErrorCode.INVALID_RESPONSE | ErrorCode.INVALID_CONTEXT | ErrorCode.EXT_UNKNOWN_ERROR;
+	/** Error-specific data */
+	data: {
+		/** Infrastructure service name (e.g., 'azure-keyvault') */
+		service: string;
+		/** Operation that failed (e.g., 'get-secret') */
+		operation: string;
+		/** Whether the error originated from an external system */
+		isExternal?: boolean;
+		/** List of invalid fields related to the error */
+		invalidFields?: FieldValidationData[];
+		/** Additional details about the infrastructure error */
+		details?: unknown;
+	};
+}
+export type ErrorType = AuthenticationError | AuthorizationError | ValidationError | UserInteractionError | ConfigurationError | SecurityError | ServiceError;
+/**
+ * @fileoverview Base error classes for the Documedis error handling system.
+ *
+ * Core principles:
+ * - Domain-driven errors (describe WHAT went wrong)
+ * - Three-message pattern (technical, code, user-friendly)
+ * - Safe serialization for cross-boundary communication
+ *
+ * @module @documedis/errors
+ */
+/**
+ * Serialized error format for API responses and postMessage communication.
+ * Contains only safe data for cross-boundary communication.
+ *
+ * Note: Error types extend this with their specific properties:
+ * - TimeoutError: adds `operation`, `timeoutMs`
+ * - ExternalServiceError: adds `statusCode` (if present)
+ * - AuthenticationError: adds `realm` (if present)
+ * - AuthorizationError: adds `resource`, `permission` (if present)
+ * - ValidationError: adds `validations`
+ * - BusinessRuleError: adds `rule`
+ * - UserInteractionError: adds `interactionType`
+ * - ConfigurationError: adds `configKey`, `source`
+ * - InfrastructureError: adds `service`, `operation`
+ */
+export interface SerializedError<T extends ErrorType> {
+	/** Error type discriminator for deserialization */
+	type: T["type"];
+	/** Stable error code for programmatic handling (e.g., 'SESSION_EXPIRED', 'INVALID_INPUT') */
+	code: T["code"];
+	/** User-friendly message safe for end users */
+	message: string;
+	/** Error-specific data */
+	data?: T["data"];
+}
+/**
+ * Base class for all domain errors.
+ *
+ * Features:
+ * - Three-message pattern (technical, code, user-friendly)
+ * - Unique error IDs for tracking
+ * - Safe serialization via toJSON()
+ *
+ * @abstract
+ */
+export declare class DomainError<T extends ErrorType = ErrorType> extends Error {
+	readonly type: T["type"];
+	readonly code: T["code"];
+	readonly userMessage: string;
+	readonly data?: T["data"] | undefined;
+	readonly cause?: unknown | undefined;
+	/** Unique error instance ID (format: err_timestamp_random) */
+	readonly id: string;
+	/** Timestamp of when the error occurred */
+	readonly timestamp: Date;
+	/**
+	 * Creates a new domain error.
+	 *
+	 * @param message - Technical message for developers (included in logs, not sent to users)
+	 * @param code - Stable error code for programmatic handling from ErrorCodes constants
+	 * @param userMessage - Safe, user-friendly message for end users
+	 * @param cause - Original error for debugging (included in logs, not serialized)
+	 */
+	constructor(type: T["type"], code: T["code"], message: string, userMessage: string, data?: T["data"] | undefined, cause?: unknown | undefined);
+	/**
+	 * Determines if errors should be logged to console in current environment.
+	 * Only logs in dev/int/demo, not in production.
+	 * Returns false if environment cannot be determined (safe default).
+	 *
+	 * @private
+	 * @returns true if should log to console
+	 */
+	private shouldLogInDevelopment;
+	/**
+	 * Generates a unique error ID for this error instance.
+	 * Format: err_timestamp_random
+	 *
+	 * @private
+	 * @returns Unique error ID
+	 */
+	private generateErrorId;
+	/**
+	 * Serializes the error for API responses or cross-boundary communication.
+	 *
+	 * Only includes safe data:
+	 * - User-friendly message (not technical details)
+	 * - Stable error code
+	 * - IDs for tracking
+	 *
+	 * Excludes:
+	 * - Stack traces
+	 * - Technical error messages
+	 * - Original cause
+	 * - Any sensitive information
+	 *
+	 * @returns Serialized error safe for external consumption
+	 */
+	toJSON(): SerializedError<T>;
+	/**
+	 * Maps this domain error to an appropriate HTTP status code.
+	 *
+	 * @returns HTTP status code for this error
+	 */
+	toHttpStatus(): number;
+	/**
+	 * Deserializes a JSON error back into the appropriate domain error instance.
+	 *
+	 * @param data - Serialized error data
+	 * @returns A domain error instance
+	 */
+	static fromJSON(data: any): DomainError;
+}
+export interface ComboBoxStyleProps {
+	color?: string;
+}
+export type KeyOf<T extends object> = keyof T extends string ? keyof T : never;
+export type OmitFunctionsKeys<T> = Omit<T, {
+	[K in keyof T]: T[K] extends (...args: any[]) => any ? K : never;
+}[keyof T]>;
+export type OptionalNullableKeys<T> = {
+	[K in keyof T as undefined extends T[K] ? K : null extends T[K] ? K : never]?: T[K];
+} & {
+	[K in keyof T as undefined extends T[K] ? never : null extends T[K] ? never : K]: T[K];
+};
+export type PropKey<T extends object> = KeyOf<OmitFunctionsKeys<T>>;
+export type Props<T extends object> = OptionalNullableKeys<{
+	[K in PropKey<T>]: T[K];
+}>;
+export interface PharmacySelectorWebComponentProps extends ComboBoxStyleProps {
+	accessToken: string;
+	environment: Environment;
+	eRxEnableOnly?: boolean;
+	resultWindowSize?: number;
+}
+export interface PrescriptionSignWebComponentProps {
+	environment?: Environment;
+	chmed?: string;
+	accessToken?: string;
+	sessionToken?: string;
+	generatePdf?: boolean;
+	color?: string;
+}
+export interface PharmacySelectorProps extends Props<PharmacySelectorWebComponentProps> {
+	className?: string;
+	onPharmacySelected: (pharmacy: Pharmacy | null) => void;
+	onError?: (error: DomainError) => void;
+}
+export declare const PharmacySelector: ({ onPharmacySelected, onError, className, ...props }: PharmacySelectorProps) => import("react/jsx-runtime").JSX.Element;
+export interface UsePharmacySelectorConfig {
+	accessToken: string;
+	environment: Environment;
+	eRxEnableOnly?: boolean;
+	resultWindowSize?: number;
+}
+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;
+/**
+ * Props for the usePrescriptionSign hook
+ * Note: chmed is NOT included here because it's passed via the start() method
+ */
+export type UsePrescriptionSigningProps = {
+	/**
+	 * Environment configuration for the prescription service
+	 * - 'local': Development environment (localhost:52247)
+	 * - 'int': Integration Azure Container Apps
+	 * - 'demo': Demo 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
+	 * generatePdf is set to true.
+	 *
+	 * @see generatePdf
+	 */
+	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;
+	/**
+	 * Optional flag to generate PDF after signing.
+	 * Defaults to false if not specified.
+	 */
+	generatePdf?: boolean;
+};
+/**
+ * Props for the PrescriptionSign React component
+ * Uses camelCase (React convention) - internally converted to kebab-case for web component
+ */
+export interface PrescriptionSignProps extends Props<PrescriptionSignWebComponentProps> {
+	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 declare const PrescriptionSign: ({ onSuccess, onError, onSessionTokenUpdate, className, ...props }: PrescriptionSignProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Return type for the usePrescriptionSign hook
+ */
+export interface UsePrescriptionSignReturn {
+	/** Function to initiate the signing process with CHMED data */
+	start: (encodedCHMED: string, generatePdf?: 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;
+export interface ProductDetailsProps {
+	accessToken: string;
+	environment: Environment;
+	language?: string;
+	productNumber?: number;
+	className?: string;
+	onError?: (error: DomainError) => void;
+}
+export declare const ProductDetails: ({ onError, className, ...props }: ProductDetailsProps) => import("react/jsx-runtime").JSX.Element;
+
+export {};