@hipnation-truth/sdk 0.4.1 → 0.6.0

package/dist/react.d.mts

@@ -118,6 +118,109 @@ declare function usePatientMedical(elationId: number | undefined, options?: UseP
     allergies: unknown[] | undefined;
     appointments: unknown[] | undefined;
 };
+interface UsePatientBasicOptions {
+    /** Truth API base URL used for the background refresh. */
+    apiBaseUrl?: string;
+    /** API key for the refresh call. */
+    apiKey?: string;
+    /** Suppress the background refresh. */
+    skipRefresh?: boolean;
+}
+interface UsePatientBasicResult {
+    /**
+     * Raw Elation patient payload (matches the shape Elation's
+     * `/patients/{id}` returns — `first_name`, `last_name`, `phones`, etc).
+     * Returns `undefined` while the cache miss is loading, `null` if the
+     * patient isn't in Convex yet (first-open-after-backfill).
+     */
+    elationPatient: Record<string, unknown> | null | undefined;
+    /**
+     * Raw Hint patient payload (matches the shape Hint's
+     * `/provider/patients/{id}` returns — `memberships`, `account`,
+     * `phones`, etc).
+     */
+    hintPatient: Record<string, unknown> | null | undefined;
+    /**
+     * The full Convex row for Elation (includes `elationId`, `lastSyncedAt`,
+     * `photoS3Key`, `preferredPharmacyNcpdpId`, etc). Use this when you
+     * need the structured/typed fields rather than the raw Elation payload.
+     */
+    elationRow: Record<string, unknown> | null | undefined;
+    /**
+     * The full Convex row for Hint. Similar relationship to `hintPatient`.
+     */
+    hintRow: Record<string, unknown> | null | undefined;
+    /** True while either cache miss is still pending. */
+    loading: boolean;
+}
+/**
+ * Composite hook returning a patient's basic details — Hint demographics
+ * + memberships + account, Elation demographics + clinical metadata —
+ * from the Convex cache.
+ *
+ * On mount (and when inputs change) fires a background refresh against
+ * `/api/patients/basic/refresh` so stale rows get pulled fresh without
+ * blocking render. Returns cached data immediately; Convex subscription
+ * updates the UI when refresh completes.
+ */
+declare function usePatientBasic(input: {
+    hintId?: string;
+    elationId?: number;
+}, options?: UsePatientBasicOptions): UsePatientBasicResult;
+/**
+ * Read a shared pharmacy row by NCPDP id. Backs the pharmacy card in
+ * the patient panel (from Elation's preferred_pharmacy reference).
+ */
+declare function usePharmacyByNcpdpId(ncpdpId: string | undefined): any;
+interface UsePatientPhotoOptions {
+    apiBaseUrl?: string;
+    apiKey?: string;
+    skipRefresh?: boolean;
+}
+/**
+ * Subscribe to a patient's profile photo (s3Key + metadata). The
+ * consumer constructs a download URL via the Truth attachments resource
+ * (signed S3 URL). Fires a background refresh to pull the latest photo
+ * binary from Elation + upload to S3.
+ */
+declare function usePatientPhoto(elationId: number | undefined, options?: UsePatientPhotoOptions): any;
+interface ConversationMessage {
+    kind: "call" | "sms";
+    id: string;
+    providerId: string;
+    state: string | null;
+    direction: string | null;
+    fromNumber: string | null;
+    toNumber: string | null;
+    voicemailLink: string | null;
+    duration: number | null;
+    text: string | null;
+    mms: boolean;
+    mmsUrl: string | null;
+    messageStatus: string | null;
+    occurredAt: string;
+    conversationId: string | null;
+    patientId: string | null;
+}
+interface UseConversationMessagesOptions {
+    /** Max items to return (default 200). */
+    limit?: number;
+}
+/**
+ * Subscribe to a conversation's calls + SMS merged chronologically.
+ * Pass the patient phone + the provider phone — Truth computes a
+ * normalized pair key server-side so formatting differences don't
+ * matter.
+ *
+ * Returns `undefined` while loading, then `ConversationMessage[]`
+ * sorted newest-first. Updates live as new webhook events land in
+ * Convex via the kinesis consumer.
+ */
+declare function useConversationMessages(input: {
+    phoneA?: string;
+    phoneB?: string;
+    conversationId?: string;
+}, options?: UseConversationMessagesOptions): ConversationMessage[] | undefined;
 
 interface TruthProviderProps {
     /** Truth environment — determines which Convex deployment to connect to */
@@ -549,4 +652,4 @@ interface PatientListOptions {
     cursor?: string;
 }
 
-export { type Appointment, type AppointmentListOptions, type EventPayloadMap, type EventType, type Patient, type PatientListOptions, type Physician, type TrackOptions, TruthProvider, type TruthProviderProps, type TruthTrackingContextValue, TruthTrackingProvider, type TruthTrackingProviderProps, type UseAppointmentListOptions, type UsePatientListOptions, type UsePatientMedicalOptions, useAppointment, useAppointmentByElationId, useAppointments, usePatient, usePatientByElationId, usePatientByHintId, usePatientMedical, usePatients, usePhysicianByElationId, usePhysiciansByElationIds, useTruth };
+export { type Appointment, type AppointmentListOptions, type ConversationMessage, type EventPayloadMap, type EventType, type Patient, type PatientListOptions, type Physician, type TrackOptions, TruthProvider, type TruthProviderProps, type TruthTrackingContextValue, TruthTrackingProvider, type TruthTrackingProviderProps, type UseAppointmentListOptions, type UseConversationMessagesOptions, type UsePatientBasicOptions, type UsePatientBasicResult, type UsePatientListOptions, type UsePatientMedicalOptions, type UsePatientPhotoOptions, useAppointment, useAppointmentByElationId, useAppointments, useConversationMessages, usePatient, usePatientBasic, usePatientByElationId, usePatientByHintId, usePatientMedical, usePatientPhoto, usePatients, usePharmacyByNcpdpId, usePhysicianByElationId, usePhysiciansByElationIds, useTruth };

package/dist/react.d.ts

@@ -118,6 +118,109 @@ declare function usePatientMedical(elationId: number | undefined, options?: UseP
     allergies: unknown[] | undefined;
     appointments: unknown[] | undefined;
 };
+interface UsePatientBasicOptions {
+    /** Truth API base URL used for the background refresh. */
+    apiBaseUrl?: string;
+    /** API key for the refresh call. */
+    apiKey?: string;
+    /** Suppress the background refresh. */
+    skipRefresh?: boolean;
+}
+interface UsePatientBasicResult {
+    /**
+     * Raw Elation patient payload (matches the shape Elation's
+     * `/patients/{id}` returns — `first_name`, `last_name`, `phones`, etc).
+     * Returns `undefined` while the cache miss is loading, `null` if the
+     * patient isn't in Convex yet (first-open-after-backfill).
+     */
+    elationPatient: Record<string, unknown> | null | undefined;
+    /**
+     * Raw Hint patient payload (matches the shape Hint's
+     * `/provider/patients/{id}` returns — `memberships`, `account`,
+     * `phones`, etc).
+     */
+    hintPatient: Record<string, unknown> | null | undefined;
+    /**
+     * The full Convex row for Elation (includes `elationId`, `lastSyncedAt`,
+     * `photoS3Key`, `preferredPharmacyNcpdpId`, etc). Use this when you
+     * need the structured/typed fields rather than the raw Elation payload.
+     */
+    elationRow: Record<string, unknown> | null | undefined;
+    /**
+     * The full Convex row for Hint. Similar relationship to `hintPatient`.
+     */
+    hintRow: Record<string, unknown> | null | undefined;
+    /** True while either cache miss is still pending. */
+    loading: boolean;
+}
+/**
+ * Composite hook returning a patient's basic details — Hint demographics
+ * + memberships + account, Elation demographics + clinical metadata —
+ * from the Convex cache.
+ *
+ * On mount (and when inputs change) fires a background refresh against
+ * `/api/patients/basic/refresh` so stale rows get pulled fresh without
+ * blocking render. Returns cached data immediately; Convex subscription
+ * updates the UI when refresh completes.
+ */
+declare function usePatientBasic(input: {
+    hintId?: string;
+    elationId?: number;
+}, options?: UsePatientBasicOptions): UsePatientBasicResult;
+/**
+ * Read a shared pharmacy row by NCPDP id. Backs the pharmacy card in
+ * the patient panel (from Elation's preferred_pharmacy reference).
+ */
+declare function usePharmacyByNcpdpId(ncpdpId: string | undefined): any;
+interface UsePatientPhotoOptions {
+    apiBaseUrl?: string;
+    apiKey?: string;
+    skipRefresh?: boolean;
+}
+/**
+ * Subscribe to a patient's profile photo (s3Key + metadata). The
+ * consumer constructs a download URL via the Truth attachments resource
+ * (signed S3 URL). Fires a background refresh to pull the latest photo
+ * binary from Elation + upload to S3.
+ */
+declare function usePatientPhoto(elationId: number | undefined, options?: UsePatientPhotoOptions): any;
+interface ConversationMessage {
+    kind: "call" | "sms";
+    id: string;
+    providerId: string;
+    state: string | null;
+    direction: string | null;
+    fromNumber: string | null;
+    toNumber: string | null;
+    voicemailLink: string | null;
+    duration: number | null;
+    text: string | null;
+    mms: boolean;
+    mmsUrl: string | null;
+    messageStatus: string | null;
+    occurredAt: string;
+    conversationId: string | null;
+    patientId: string | null;
+}
+interface UseConversationMessagesOptions {
+    /** Max items to return (default 200). */
+    limit?: number;
+}
+/**
+ * Subscribe to a conversation's calls + SMS merged chronologically.
+ * Pass the patient phone + the provider phone — Truth computes a
+ * normalized pair key server-side so formatting differences don't
+ * matter.
+ *
+ * Returns `undefined` while loading, then `ConversationMessage[]`
+ * sorted newest-first. Updates live as new webhook events land in
+ * Convex via the kinesis consumer.
+ */
+declare function useConversationMessages(input: {
+    phoneA?: string;
+    phoneB?: string;
+    conversationId?: string;
+}, options?: UseConversationMessagesOptions): ConversationMessage[] | undefined;
 
 interface TruthProviderProps {
     /** Truth environment — determines which Convex deployment to connect to */
@@ -549,4 +652,4 @@ interface PatientListOptions {
     cursor?: string;
 }
 
-export { type Appointment, type AppointmentListOptions, type EventPayloadMap, type EventType, type Patient, type PatientListOptions, type Physician, type TrackOptions, TruthProvider, type TruthProviderProps, type TruthTrackingContextValue, TruthTrackingProvider, type TruthTrackingProviderProps, type UseAppointmentListOptions, type UsePatientListOptions, type UsePatientMedicalOptions, useAppointment, useAppointmentByElationId, useAppointments, usePatient, usePatientByElationId, usePatientByHintId, usePatientMedical, usePatients, usePhysicianByElationId, usePhysiciansByElationIds, useTruth };
+export { type Appointment, type AppointmentListOptions, type ConversationMessage, type EventPayloadMap, type EventType, type Patient, type PatientListOptions, type Physician, type TrackOptions, TruthProvider, type TruthProviderProps, type TruthTrackingContextValue, TruthTrackingProvider, type TruthTrackingProviderProps, type UseAppointmentListOptions, type UseConversationMessagesOptions, type UsePatientBasicOptions, type UsePatientBasicResult, type UsePatientListOptions, type UsePatientMedicalOptions, type UsePatientPhotoOptions, useAppointment, useAppointmentByElationId, useAppointments, useConversationMessages, usePatient, usePatientBasic, usePatientByElationId, usePatientByHintId, usePatientMedical, usePatientPhoto, usePatients, usePharmacyByNcpdpId, usePhysicianByElationId, usePhysiciansByElationIds, useTruth };

package/dist/react.js

@@ -47,11 +47,15 @@ __export(react_exports, {
   useAppointment: () => useAppointment,
   useAppointmentByElationId: () => useAppointmentByElationId,
   useAppointments: () => useAppointments,
+  useConversationMessages: () => useConversationMessages,
   usePatient: () => usePatient,
+  usePatientBasic: () => usePatientBasic,
   usePatientByElationId: () => usePatientByElationId,
   usePatientByHintId: () => usePatientByHintId,
   usePatientMedical: () => usePatientMedical,
+  usePatientPhoto: () => usePatientPhoto,
   usePatients: () => usePatients,
+  usePharmacyByNcpdpId: () => usePharmacyByNcpdpId,
   usePhysicianByElationId: () => usePhysicianByElationId,
   usePhysiciansByElationIds: () => usePhysiciansByElationIds,
   useTruth: () => useTruth
@@ -158,6 +162,110 @@ function usePatientMedical(elationId, options) {
   }, [elationId, options == null ? void 0 : options.apiBaseUrl, options == null ? void 0 : options.apiKey, options == null ? void 0 : options.skipRefresh]);
   return { medications, problems, allergies, appointments };
 }
+var elationPatientByIdRef = (0, import_server.makeFunctionReference)("elationPatients:getByElationId");
+var hintPatientByIdRef = (0, import_server.makeFunctionReference)("hintPatients:getByHintId");
+var pharmacyByNcpdpRef = (0, import_server.makeFunctionReference)("elationPharmacies:getByNcpdpId");
+var patientPhotoByIdRef = (0, import_server.makeFunctionReference)("elationPatientPhotos:getByElationPatientId");
+function usePatientBasic(input, options) {
+  var _a, _b;
+  const elationRow = (0, import_react.useQuery)(
+    elationPatientByIdRef,
+    input.elationId !== void 0 ? { elationId: input.elationId } : "skip"
+  );
+  const hintRow = (0, import_react.useQuery)(
+    hintPatientByIdRef,
+    input.hintId !== void 0 ? { hintId: input.hintId } : "skip"
+  );
+  (0, import_react2.useEffect)(() => {
+    if (options == null ? void 0 : options.skipRefresh) return;
+    if (!input.hintId && input.elationId === void 0) return;
+    const apiBaseUrl = options == null ? void 0 : options.apiBaseUrl;
+    const apiKey = options == null ? void 0 : options.apiKey;
+    if (!apiBaseUrl || !apiKey) return;
+    const controller = new AbortController();
+    void fetch(`${apiBaseUrl}/api/patients/basic/refresh`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": apiKey
+      },
+      body: JSON.stringify({
+        hintId: input.hintId,
+        elationId: input.elationId
+      }),
+      signal: controller.signal
+    }).catch(() => {
+    });
+    return () => controller.abort();
+  }, [
+    input.hintId,
+    input.elationId,
+    options == null ? void 0 : options.apiBaseUrl,
+    options == null ? void 0 : options.apiKey,
+    options == null ? void 0 : options.skipRefresh
+  ]);
+  const elationPatient = elationRow === void 0 ? void 0 : elationRow === null ? null : (_a = elationRow.raw) != null ? _a : null;
+  const hintPatient = hintRow === void 0 ? void 0 : hintRow === null ? null : (_b = hintRow.raw) != null ? _b : null;
+  const elationLoading = input.elationId !== void 0 && elationRow === void 0;
+  const hintLoading = input.hintId !== void 0 && hintRow === void 0;
+  return {
+    elationPatient,
+    hintPatient,
+    elationRow,
+    hintRow,
+    loading: elationLoading || hintLoading
+  };
+}
+function usePharmacyByNcpdpId(ncpdpId) {
+  return (0, import_react.useQuery)(
+    pharmacyByNcpdpRef,
+    ncpdpId ? { ncpdpId } : "skip"
+  );
+}
+function usePatientPhoto(elationId, options) {
+  const photo = (0, import_react.useQuery)(
+    patientPhotoByIdRef,
+    elationId !== void 0 ? { elationPatientId: elationId } : "skip"
+  );
+  (0, import_react2.useEffect)(() => {
+    if (options == null ? void 0 : options.skipRefresh) return;
+    if (elationId === void 0) return;
+    const apiBaseUrl = options == null ? void 0 : options.apiBaseUrl;
+    const apiKey = options == null ? void 0 : options.apiKey;
+    if (!apiBaseUrl || !apiKey) return;
+    const controller = new AbortController();
+    void fetch(`${apiBaseUrl}/api/patients/photo/refresh`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": apiKey
+      },
+      body: JSON.stringify({ elationId }),
+      signal: controller.signal
+    }).catch(() => {
+    });
+    return () => controller.abort();
+  }, [elationId, options == null ? void 0 : options.apiBaseUrl, options == null ? void 0 : options.apiKey, options == null ? void 0 : options.skipRefresh]);
+  return photo;
+}
+var messagesByPhonesRef = (0, import_server.makeFunctionReference)("conversationMessages:getByPhones");
+var messagesByConversationIdRef = (0, import_server.makeFunctionReference)("conversationMessages:getByConversationId");
+function useConversationMessages(input, options) {
+  const hasPair = !!input.phoneA && !!input.phoneB;
+  const byPair = (0, import_react.useQuery)(
+    messagesByPhonesRef,
+    hasPair ? {
+      phoneA: input.phoneA,
+      phoneB: input.phoneB,
+      limit: options == null ? void 0 : options.limit
+    } : "skip"
+  );
+  const byConvo = (0, import_react.useQuery)(
+    messagesByConversationIdRef,
+    !hasPair && input.conversationId ? { conversationId: input.conversationId, limit: options == null ? void 0 : options.limit } : "skip"
+  );
+  return hasPair ? byPair : byConvo;
+}
 
 // src/react/provider.ts
 var import_react3 = require("convex/react");
@@ -423,11 +531,15 @@ function useTruth() {
   useAppointment,
   useAppointmentByElationId,
   useAppointments,
+  useConversationMessages,
   usePatient,
+  usePatientBasic,
   usePatientByElationId,
   usePatientByHintId,
   usePatientMedical,
+  usePatientPhoto,
   usePatients,
+  usePharmacyByNcpdpId,
   usePhysicianByElationId,
   usePhysiciansByElationIds,
   useTruth

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react.ts","../src/react/hooks.ts","../src/react/provider.ts","../src/react/tracking.ts","../src/tracking/tracker.ts"],"sourcesContent":["/**\n * @hipnation-truth/sdk/react\n *\n * React hooks and provider for Truth SDK — real-time Convex-backed data.\n *\n * @example\n * ```tsx\n * import { TruthProvider, usePatients, useAppointments } from '@hipnation-truth/sdk/react';\n *\n * function App() {\n *   return (\n *     <TruthProvider environment=\"sandbox\">\n *       <PatientList />\n *     </TruthProvider>\n *   );\n * }\n *\n * function PatientList() {\n *   const patients = usePatients({ limit: 20 });\n *   if (!patients) return <div>Loading...</div>;\n *   return patients.map(p => <div key={p._id}>{p.firstName}</div>);\n * }\n * ```\n */\n\n// Re-export types consumers commonly need\nexport type {\n  Physician,\n  UseAppointmentListOptions,\n  UsePatientListOptions,\n  UsePatientMedicalOptions,\n} from \"./react/hooks\";\n// Patient / Appointment / Physician / Medical hooks\nexport {\n  useAppointment,\n  useAppointmentByElationId,\n  useAppointments,\n  usePatient,\n  usePatientByElationId,\n  usePatientByHintId,\n  usePatientMedical,\n  usePatients,\n  usePhysicianByElationId,\n  usePhysiciansByElationIds,\n} from \"./react/hooks\";\nexport type { TruthProviderProps } from \"./react/provider\";\n// Provider\nexport { TruthProvider } from \"./react/provider\";\nexport type {\n  TruthTrackingContextValue,\n  TruthTrackingProviderProps,\n} from \"./react/tracking\";\n// Tracking\nexport { TruthTrackingProvider, useTruth } from \"./react/tracking\";\n// Re-export event types for track() calls\nexport type {\n  EventPayloadMap,\n  EventType,\n  TrackOptions,\n} from \"./tracking/events\";\nexport type { Appointment, AppointmentListOptions } from \"./types/appointment\";\nexport type { Patient, PatientListOptions } from \"./types/patient\";\n","/**\n * React hooks for Truth SDK — real-time Convex-backed data access.\n *\n * These hooks use Convex React subscriptions for live-updating data.\n * Must be used within a ConvexProvider (see TruthProvider).\n *\n * @example\n * ```tsx\n * import { usePatients, useAppointments } from '@hipnation-truth/sdk/react';\n *\n * function PatientList() {\n *   const patients = usePatients({ limit: 20 });\n *   return patients?.map(p => <div key={p._id}>{p.firstName} {p.lastName}</div>);\n * }\n * ```\n */\n\n\"use client\";\n\nimport { useQuery } from \"convex/react\";\nimport { useEffect } from \"react\";\n\n// ---------------------------------------------------------------------------\n// Convex function references\n// ---------------------------------------------------------------------------\n// We use string-based references to avoid importing the generated API\n// (which lives in the consuming app, not the SDK). Convex supports this\n// via the `api` module pattern, but for a published SDK we use\n// makeFunctionReference to stay decoupled from the app's codegen.\n\nimport type { FunctionReference } from \"convex/server\";\nimport { makeFunctionReference } from \"convex/server\";\n\n// Patient query references\nconst patientsListRef = makeFunctionReference<\n  \"query\",\n  {\n    search?: string;\n    lastName?: string;\n    cursor?: string;\n    limit?: number;\n  },\n  unknown[]\n>(\"patients:list\");\n\nconst patientsGetRef = makeFunctionReference<\n  \"query\",\n  { id: string },\n  unknown | null\n>(\"patients:get\");\n\nconst patientsByElationIdRef = makeFunctionReference<\n  \"query\",\n  { elationId: string },\n  unknown | null\n>(\"patients:getByElationId\");\n\nconst patientsByHintIdRef = makeFunctionReference<\n  \"query\",\n  { hintId: string },\n  unknown | null\n>(\"patients:getByHintId\");\n\n// Appointment query references\nconst appointmentsListRef = makeFunctionReference<\n  \"query\",\n  {\n    patientId?: string;\n    status?: string;\n    startDate?: string;\n    endDate?: string;\n    limit?: number;\n  },\n  unknown[]\n>(\"appointments:list\");\n\nconst appointmentsGetRef = makeFunctionReference<\n  \"query\",\n  { id: string },\n  unknown | null\n>(\"appointments:get\");\n\nconst appointmentsByElationIdRef = makeFunctionReference<\n  \"query\",\n  { elationId: string },\n  unknown | null\n>(\"appointments:getByElationId\");\n\n// ---------------------------------------------------------------------------\n// Patient hooks\n// ---------------------------------------------------------------------------\n\ninterface UsePatientListOptions {\n  search?: string;\n  lastName?: string;\n  limit?: number;\n}\n\n/**\n * Subscribe to a list of patients with optional search and filtering.\n * Returns undefined while loading, then an array of patients.\n */\nfunction usePatients(options?: UsePatientListOptions) {\n  return useQuery(patientsListRef as FunctionReference<\"query\">, options ?? {});\n}\n\n/**\n * Subscribe to a single patient by Convex document ID.\n */\nfunction usePatient(id: string) {\n  return useQuery(patientsGetRef as FunctionReference<\"query\">, { id });\n}\n\n/**\n * Subscribe to a patient by their Elation ID.\n */\nfunction usePatientByElationId(elationId: string) {\n  return useQuery(patientsByElationIdRef as FunctionReference<\"query\">, {\n    elationId,\n  });\n}\n\n/**\n * Subscribe to a patient by their Hint ID.\n */\nfunction usePatientByHintId(hintId: string) {\n  return useQuery(patientsByHintIdRef as FunctionReference<\"query\">, {\n    hintId,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Appointment hooks\n// ---------------------------------------------------------------------------\n\ninterface UseAppointmentListOptions {\n  patientId?: string;\n  status?: string;\n  startDate?: string;\n  endDate?: string;\n  limit?: number;\n}\n\n/**\n * Subscribe to a list of appointments with optional filtering.\n */\nfunction useAppointments(options?: UseAppointmentListOptions) {\n  return useQuery(\n    appointmentsListRef as FunctionReference<\"query\">,\n    options ?? {},\n  );\n}\n\n/**\n * Subscribe to a single appointment by Convex document ID.\n */\nfunction useAppointment(id: string) {\n  return useQuery(appointmentsGetRef as FunctionReference<\"query\">, { id });\n}\n\n/**\n * Subscribe to an appointment by its Elation ID.\n */\nfunction useAppointmentByElationId(elationId: string) {\n  return useQuery(appointmentsByElationIdRef as FunctionReference<\"query\">, {\n    elationId,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Physician hooks\n// ---------------------------------------------------------------------------\n\ninterface Physician {\n  _id: string;\n  elationId: number;\n  firstName?: string;\n  lastName?: string;\n  npi?: string;\n  credentials?: string;\n  specialties?: string[];\n  practice?: number;\n  email?: string;\n  phone?: string;\n  lastSyncedAt: string;\n}\n\nconst physiciansGetByElationIdsRef = makeFunctionReference<\n  \"query\",\n  { ids: number[] },\n  Physician[]\n>(\"physicians:getByElationIds\");\n\nconst physiciansGetByElationIdRef = makeFunctionReference<\n  \"query\",\n  { id: number },\n  Physician | null\n>(\"physicians:getByElationId\");\n\n/**\n * Resolve a batch of physicians by their Elation IDs. Returns an array\n * of physicians that exist in Convex; missing ids are silently dropped.\n *\n * Use this to resolve medication `prescribing_physician` / appointment\n * physician ids to display names, avoiding the per-physician HTTP\n * round-trip through Truth's Elation proxy.\n *\n * Pass `undefined` (or an empty array) to skip the query — the hook\n * returns `undefined` until you pass a populated list.\n */\nfunction usePhysiciansByElationIds(ids: number[] | undefined) {\n  return useQuery(\n    physiciansGetByElationIdsRef as FunctionReference<\"query\">,\n    ids && ids.length > 0 ? { ids } : \"skip\",\n  );\n}\n\n/**\n * Subscribe to a single physician by their Elation ID.\n */\nfunction usePhysicianByElationId(id: number | undefined) {\n  return useQuery(\n    physiciansGetByElationIdRef as FunctionReference<\"query\">,\n    id !== undefined ? { id } : \"skip\",\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Patient medical hooks (medications, problems, allergies, appointments)\n// ---------------------------------------------------------------------------\n\nconst medicationsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getMedicationsByElationPatient\");\n\nconst problemsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getProblemsByElationPatient\");\n\nconst allergiesByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getAllergiesByElationPatient\");\n\nconst appointmentsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getAppointmentsByElationPatient\");\n\ninterface UsePatientMedicalOptions {\n  /**\n   * Base URL of the Truth API. Required to trigger the background refresh\n   * (e.g. `https://app.truth.communication-hub.com`). If omitted, the hook\n   * only reads from Convex and does not refresh.\n   */\n  apiBaseUrl?: string;\n  /** API key used for the refresh call. */\n  apiKey?: string;\n  /**\n   * If true, suppress the background refresh. Useful when you know the\n   * data was just refreshed by another component on the page.\n   */\n  skipRefresh?: boolean;\n}\n\n/**\n * Composite hook that returns a patient's medical records — medications,\n * problems, allergies, appointments — from the Convex cache.\n *\n * On mount (and when `elationId` changes) fires a background refresh\n * against Truth's `/api/patients/medical/refresh` endpoint so stale data\n * is pulled in without blocking render. Returns cached data immediately;\n * Convex subscription updates the UI when refresh completes.\n */\nfunction usePatientMedical(\n  elationId: number | undefined,\n  options?: UsePatientMedicalOptions,\n) {\n  const medications = useQuery(\n    medicationsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const problems = useQuery(\n    problemsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const allergies = useQuery(\n    allergiesByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const appointments = useQuery(\n    appointmentsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  useEffect(() => {\n    if (elationId === undefined || options?.skipRefresh) {\n      return;\n    }\n    const apiBaseUrl = options?.apiBaseUrl;\n    const apiKey = options?.apiKey;\n    if (!apiBaseUrl || !apiKey) {\n      return;\n    }\n\n    const controller = new AbortController();\n    void fetch(`${apiBaseUrl}/api/patients/medical/refresh`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-API-Key\": apiKey,\n      },\n      body: JSON.stringify({ elationId }),\n      signal: controller.signal,\n    }).catch(() => {\n      /* background refresh — failures are non-fatal */\n    });\n\n    return () => controller.abort();\n  }, [elationId, options?.apiBaseUrl, options?.apiKey, options?.skipRefresh]);\n\n  return { medications, problems, allergies, appointments };\n}\n\nexport {\n  usePatients,\n  usePatient,\n  usePatientByElationId,\n  usePatientByHintId,\n  useAppointments,\n  useAppointment,\n  useAppointmentByElationId,\n  usePhysiciansByElationIds,\n  usePhysicianByElationId,\n  usePatientMedical,\n};\nexport type {\n  UsePatientListOptions,\n  UseAppointmentListOptions,\n  UsePatientMedicalOptions,\n  Physician,\n};\n","/**\n * TruthProvider — Convex React provider pre-configured for Truth.\n *\n * Wraps children in a ConvexProvider connected to the correct\n * Truth Convex deployment for the given environment.\n *\n * @example\n * ```tsx\n * import { TruthProvider } from '@hipnation-truth/sdk/react';\n *\n * function App() {\n *   return (\n *     <TruthProvider environment=\"sandbox\">\n *       <MyApp />\n *     </TruthProvider>\n *   );\n * }\n * ```\n */\n\n\"use client\";\n\nimport { ConvexProvider, ConvexReactClient } from \"convex/react\";\nimport type { ReactNode } from \"react\";\nimport { createElement, useMemo } from \"react\";\n\n// Mirrors CONVEX_URLS in client.ts. UAT shares prod resources.\nconst CONVEX_URLS: Record<string, string> = {\n  local: \"https://courteous-duck-623.convex.cloud\",\n  staging: \"https://courteous-duck-623.convex.cloud\",\n  stg: \"https://courteous-duck-623.convex.cloud\",\n  sandbox: \"https://courteous-duck-623.convex.cloud\",\n  uat: \"https://gallant-gecko-217.convex.cloud\",\n  production: \"https://gallant-gecko-217.convex.cloud\",\n};\n\ninterface TruthProviderProps {\n  /** Truth environment — determines which Convex deployment to connect to */\n  environment?: string;\n  /** Override the Convex URL directly */\n  convexUrl?: string;\n  children: ReactNode;\n}\n\nfunction TruthProvider({\n  environment = \"sandbox\",\n  convexUrl,\n  children,\n}: TruthProviderProps) {\n  const url = convexUrl ?? CONVEX_URLS[environment] ?? CONVEX_URLS.sandbox;\n\n  const client = useMemo(() => new ConvexReactClient(url), [url]);\n\n  return createElement(ConvexProvider, { client }, children);\n}\n\nexport { TruthProvider };\nexport type { TruthProviderProps };\n","/**\n * React tracking hook — fire-and-forget event tracking from client components.\n *\n * Creates a lightweight Tracker instance scoped to the browser session\n * and exposes a useTrack() hook for emitting events to Truth's Kinesis stream.\n *\n * @example\n * ```tsx\n * import { useTruth } from '@hipnation-truth/sdk/react';\n *\n * function ConversationView({ conversationId }) {\n *   const truth = useTruth();\n *\n *   useEffect(() => {\n *     truth.track('conversation.marked_read.v1', {\n *       read_by_actor_id: userId,\n *       unread_count_before: 5,\n *       unread_count_after: 0,\n *     }, { subject: { conversation_id: conversationId } });\n *   }, [conversationId]);\n * }\n * ```\n */\n\n\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport { createContext, createElement, useContext, useMemo } from \"react\";\nimport type {\n  EventPayloadMap,\n  EventType,\n  TrackOptions,\n} from \"../tracking/events\";\nimport { Tracker } from \"../tracking/tracker\";\nimport type { ActorContext } from \"../types/config\";\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\ninterface TruthTrackingContextValue {\n  track: <T extends EventType>(\n    eventType: T,\n    payload: EventPayloadMap[T],\n    options?: TrackOptions,\n  ) => void;\n  identify: (actorId: string, actorType: ActorContext[\"actorType\"]) => void;\n}\n\nconst TruthTrackingContext = createContext<TruthTrackingContextValue | null>(\n  null,\n);\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\ninterface TruthTrackingProviderProps {\n  /** Truth environment — determines API URL for event delivery */\n  environment?: string;\n  /** Event source identifier */\n  source?: string;\n  /** Source version (git SHA) */\n  sourceVersion?: string;\n  /** Default tenant ID */\n  tenantId?: string;\n  /** API key for authentication */\n  apiKey?: string;\n  children: ReactNode;\n}\n\nfunction TruthTrackingProvider({\n  environment = \"sandbox\",\n  source = \"communication-hub.frontend\",\n  sourceVersion = \"unknown\",\n  tenantId = \"hipnation\",\n  apiKey = \"\",\n  children,\n}: TruthTrackingProviderProps) {\n  const value = useMemo<TruthTrackingContextValue>(() => {\n    const tracker = new Tracker({\n      apiKey,\n      environment,\n      source,\n      sourceVersion,\n      tenantId,\n      batchSize: 10,\n      flushIntervalMs: 5000,\n    });\n\n    return {\n      track: (eventType, payload, options) => {\n        tracker.track(eventType, payload, options);\n      },\n      identify: (actorId, actorType) => {\n        tracker.setActor({ actorId, actorType });\n      },\n    };\n  }, [apiKey, environment, source, sourceVersion, tenantId]);\n\n  return createElement(TruthTrackingContext.Provider, { value }, children);\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\n/**\n * Access the Truth tracking context. Must be within a TruthTrackingProvider.\n * Returns `{ track, identify }` for emitting events to Kinesis.\n */\nfunction useTruth(): TruthTrackingContextValue {\n  const ctx = useContext(TruthTrackingContext);\n  if (!ctx) {\n    throw new Error(\"useTruth must be used within a TruthTrackingProvider\");\n  }\n  return ctx;\n}\n\nexport { TruthTrackingProvider, useTruth };\nexport type { TruthTrackingProviderProps, TruthTrackingContextValue };\n","/**\n * Event tracker with batching, retry, and flush support.\n *\n * Buffers events in an internal queue and flushes them to the Truth API\n * endpoint. Flushes occur when the buffer reaches `batchSize` or every\n * `flushIntervalMs` milliseconds, whichever comes first.\n */\n\nimport type { ActorContext } from \"../types/config\";\nimport type {\n  EventEnvelope,\n  EventPayloadMap,\n  EventType,\n  TrackOptions,\n} from \"./events\";\n\n// ---------------------------------------------------------------------------\n// UUID v7 helper (no external dependency)\n// ---------------------------------------------------------------------------\n\n/**\n * Generates a UUID v7 string. Uses crypto.randomUUID where available,\n * falling back to a timestamp + random bytes implementation.\n *\n * UUID v7 layout (RFC 9562):\n *   48 bits - unix timestamp (ms)\n *   4 bits  - version (0b0111)\n *   12 bits - random\n *   2 bits  - variant (0b10)\n *   62 bits - random\n */\nfunction generateUuidV7(): string {\n  const now = Date.now();\n\n  // 6 bytes of timestamp\n  const timeBytes = new Uint8Array(6);\n  let ts = now;\n  for (let i = 5; i >= 0; i--) {\n    timeBytes[i] = ts & 0xff;\n    ts = Math.floor(ts / 256);\n  }\n\n  // 10 bytes of random\n  const randomBytes = new Uint8Array(10);\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    globalThis.crypto.getRandomValues\n  ) {\n    globalThis.crypto.getRandomValues(randomBytes);\n  } else {\n    for (let i = 0; i < 10; i++) {\n      randomBytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n\n  // Assemble 16 bytes\n  const bytes = new Uint8Array(16);\n  bytes.set(timeBytes, 0);\n  bytes.set(randomBytes, 6);\n\n  // Set version (bits 48-51 to 0b0111)\n  bytes[6] = (bytes[6] & 0x0f) | 0x70;\n\n  // Set variant (bits 64-65 to 0b10)\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n  // Format as hex string with dashes\n  const hex = Array.from(bytes)\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20, 32),\n  ].join(\"-\");\n}\n\n// ---------------------------------------------------------------------------\n// Environment-based API URL resolution\n// ---------------------------------------------------------------------------\n\n// Environment → Truth API base URL.\n//\n// Topology:\n//   local / staging / stg / sandbox → sandbox Truth (app.sandbox.*)\n//   uat / production                → production Truth (app.truth.*)\n//\n// UAT shares production resources (same Fly Postgres + Hasura + Truth +\n// Convex + EHR tokens as prod). Staging is the isolated sandbox env.\nconst API_URLS: Record<string, string> = {\n  local: \"http://localhost:3000\",\n  staging: \"https://app.sandbox.communication-hub.com\",\n  stg: \"https://app.sandbox.communication-hub.com\",\n  sandbox: \"https://app.sandbox.communication-hub.com\",\n  uat: \"https://app.truth.communication-hub.com\",\n  production: \"https://app.truth.communication-hub.com\",\n};\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_BATCH_SIZE = 25;\nconst DEFAULT_FLUSH_INTERVAL_MS = 5_000;\nconst MAX_RETRIES = 3;\nconst BASE_RETRY_DELAY_MS = 500;\n\n// ---------------------------------------------------------------------------\n// Tracker configuration\n// ---------------------------------------------------------------------------\n\ninterface TrackerConfig {\n  apiKey: string;\n  environment: string;\n  source: string;\n  sourceVersion: string;\n  tenantId: string;\n  batchSize: number;\n  flushIntervalMs: number;\n  apiBaseUrl?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Tracker class\n// ---------------------------------------------------------------------------\n\nclass Tracker {\n  private readonly config: TrackerConfig;\n  readonly apiUrl: string;\n  private queue: EventEnvelope[] = [];\n  private flushTimer: ReturnType<typeof setInterval> | null = null;\n  private defaultActor: ActorContext | undefined;\n  private isFlushing = false;\n  private isShutdown = false;\n\n  constructor(config: TrackerConfig) {\n    this.config = config;\n    this.apiUrl =\n      config.apiBaseUrl ?? API_URLS[config.environment] ?? API_URLS.local;\n\n    this.startFlushInterval();\n    this.registerShutdownHooks();\n  }\n\n  /**\n   * Set the default actor context for subsequent events.\n   */\n  setActor(actor: ActorContext): void {\n    this.defaultActor = actor;\n  }\n\n  /**\n   * Enqueue a typed event for delivery. This is fire-and-forget from\n   * the caller's perspective -- events are buffered and flushed in batches.\n   */\n  track<T extends EventType>(\n    eventType: T,\n    payload: EventPayloadMap[T],\n    options?: TrackOptions,\n  ): void {\n    if (this.isShutdown) {\n      return;\n    }\n\n    const now = new Date().toISOString();\n\n    const envelope: EventEnvelope = {\n      event_id: generateUuidV7(),\n      event_type: eventType,\n      schema_version: 1,\n      occurred_at: options?.occurredAt ?? now,\n      received_at: now,\n      source: this.config.source,\n      source_version: this.config.sourceVersion,\n      tenant_id: options?.tenantId ?? this.config.tenantId,\n      actor:\n        options?.actor ??\n        (this.defaultActor\n          ? {\n              actor_id: this.defaultActor.actorId,\n              actor_type: this.defaultActor.actorType,\n            }\n          : undefined),\n      subject: options?.subject,\n      compliance: options?.compliance,\n      payload: payload as unknown as Record<string, unknown>,\n    };\n\n    this.queue.push(envelope);\n\n    if (this.queue.length >= this.config.batchSize) {\n      void this.flush();\n    }\n  }\n\n  /**\n   * Force an immediate flush of all buffered events.\n   * Returns a promise that resolves when the flush completes.\n   */\n  async flush(): Promise<void> {\n    if (this.queue.length === 0 || this.isFlushing) {\n      return;\n    }\n\n    this.isFlushing = true;\n    const batch = this.queue.splice(0, this.config.batchSize);\n\n    try {\n      await this.sendBatch(batch);\n    } catch {\n      // Re-queue events that failed to send (prepend to maintain ordering)\n      this.queue.unshift(...batch);\n    } finally {\n      this.isFlushing = false;\n    }\n\n    // If there are still events in the queue, flush again\n    if (this.queue.length >= this.config.batchSize) {\n      await this.flush();\n    }\n  }\n\n  /**\n   * Gracefully shut down the tracker. Flushes remaining events and\n   * clears the flush interval.\n   */\n  async shutdown(): Promise<void> {\n    this.isShutdown = true;\n    this.stopFlushInterval();\n    await this.flush();\n  }\n\n  /**\n   * Send a batch of events to the Truth API with exponential backoff retry.\n   */\n  private async sendBatch(batch: EventEnvelope[]): Promise<void> {\n    let lastError: unknown;\n\n    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {\n      try {\n        const response = await fetch(`${this.apiUrl}/api/events/ingest`, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n            \"X-API-Key\": this.config.apiKey,\n          },\n          body: JSON.stringify({ events: batch }),\n        });\n\n        if (response.ok) {\n          return;\n        }\n\n        // Don't retry 4xx client errors (except 429)\n        if (\n          response.status >= 400 &&\n          response.status < 500 &&\n          response.status !== 429\n        ) {\n          return;\n        }\n\n        lastError = new Error(\n          `HTTP ${response.status}: ${response.statusText}`,\n        );\n      } catch (error) {\n        lastError = error;\n      }\n\n      // Exponential backoff with jitter\n      if (attempt < MAX_RETRIES) {\n        const delay = BASE_RETRY_DELAY_MS * 2 ** attempt;\n        const jitter = Math.random() * delay * 0.5;\n        await sleep(delay + jitter);\n      }\n    }\n\n    throw lastError;\n  }\n\n  private startFlushInterval(): void {\n    if (this.config.flushIntervalMs > 0) {\n      this.flushTimer = setInterval(() => {\n        void this.flush();\n      }, this.config.flushIntervalMs);\n\n      // Unref the timer so it doesn't prevent Node.js from exiting\n      if (typeof this.flushTimer === \"object\" && \"unref\" in this.flushTimer) {\n        this.flushTimer.unref();\n      }\n    }\n  }\n\n  private stopFlushInterval(): void {\n    if (this.flushTimer !== null) {\n      clearInterval(this.flushTimer);\n      this.flushTimer = null;\n    }\n  }\n\n  private registerShutdownHooks(): void {\n    // Only register in Node.js environments\n    if (typeof globalThis.process !== \"undefined\" && globalThis.process.on) {\n      const shutdownHandler = () => {\n        void this.shutdown();\n      };\n\n      globalThis.process.on(\"beforeExit\", shutdownHandler);\n      globalThis.process.on(\"SIGTERM\", shutdownHandler);\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport {\n  Tracker,\n  generateUuidV7,\n  DEFAULT_BATCH_SIZE,\n  DEFAULT_FLUSH_INTERVAL_MS,\n};\nexport type { TrackerConfig };\n"],"mappings":"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","names":["import_react","import_react","import_react"]}
+{"version":3,"sources":["../src/react.ts","../src/react/hooks.ts","../src/react/provider.ts","../src/react/tracking.ts","../src/tracking/tracker.ts"],"sourcesContent":["/**\n * @hipnation-truth/sdk/react\n *\n * React hooks and provider for Truth SDK — real-time Convex-backed data.\n *\n * @example\n * ```tsx\n * import { TruthProvider, usePatients, useAppointments } from '@hipnation-truth/sdk/react';\n *\n * function App() {\n *   return (\n *     <TruthProvider environment=\"sandbox\">\n *       <PatientList />\n *     </TruthProvider>\n *   );\n * }\n *\n * function PatientList() {\n *   const patients = usePatients({ limit: 20 });\n *   if (!patients) return <div>Loading...</div>;\n *   return patients.map(p => <div key={p._id}>{p.firstName}</div>);\n * }\n * ```\n */\n\n// Re-export types consumers commonly need\nexport type {\n  ConversationMessage,\n  Physician,\n  UseAppointmentListOptions,\n  UseConversationMessagesOptions,\n  UsePatientBasicOptions,\n  UsePatientBasicResult,\n  UsePatientListOptions,\n  UsePatientMedicalOptions,\n  UsePatientPhotoOptions,\n} from \"./react/hooks\";\n// Patient / Appointment / Physician / Medical / Messages hooks\nexport {\n  useAppointment,\n  useAppointmentByElationId,\n  useAppointments,\n  useConversationMessages,\n  usePatient,\n  usePatientBasic,\n  usePatientByElationId,\n  usePatientByHintId,\n  usePatientMedical,\n  usePatientPhoto,\n  usePatients,\n  usePharmacyByNcpdpId,\n  usePhysicianByElationId,\n  usePhysiciansByElationIds,\n} from \"./react/hooks\";\nexport type { TruthProviderProps } from \"./react/provider\";\n// Provider\nexport { TruthProvider } from \"./react/provider\";\nexport type {\n  TruthTrackingContextValue,\n  TruthTrackingProviderProps,\n} from \"./react/tracking\";\n// Tracking\nexport { TruthTrackingProvider, useTruth } from \"./react/tracking\";\n// Re-export event types for track() calls\nexport type {\n  EventPayloadMap,\n  EventType,\n  TrackOptions,\n} from \"./tracking/events\";\nexport type { Appointment, AppointmentListOptions } from \"./types/appointment\";\nexport type { Patient, PatientListOptions } from \"./types/patient\";\n","/**\n * React hooks for Truth SDK — real-time Convex-backed data access.\n *\n * These hooks use Convex React subscriptions for live-updating data.\n * Must be used within a ConvexProvider (see TruthProvider).\n *\n * @example\n * ```tsx\n * import { usePatients, useAppointments } from '@hipnation-truth/sdk/react';\n *\n * function PatientList() {\n *   const patients = usePatients({ limit: 20 });\n *   return patients?.map(p => <div key={p._id}>{p.firstName} {p.lastName}</div>);\n * }\n * ```\n */\n\n\"use client\";\n\nimport { useQuery } from \"convex/react\";\nimport { useEffect } from \"react\";\n\n// ---------------------------------------------------------------------------\n// Convex function references\n// ---------------------------------------------------------------------------\n// We use string-based references to avoid importing the generated API\n// (which lives in the consuming app, not the SDK). Convex supports this\n// via the `api` module pattern, but for a published SDK we use\n// makeFunctionReference to stay decoupled from the app's codegen.\n\nimport type { FunctionReference } from \"convex/server\";\nimport { makeFunctionReference } from \"convex/server\";\n\n// Patient query references\nconst patientsListRef = makeFunctionReference<\n  \"query\",\n  {\n    search?: string;\n    lastName?: string;\n    cursor?: string;\n    limit?: number;\n  },\n  unknown[]\n>(\"patients:list\");\n\nconst patientsGetRef = makeFunctionReference<\n  \"query\",\n  { id: string },\n  unknown | null\n>(\"patients:get\");\n\nconst patientsByElationIdRef = makeFunctionReference<\n  \"query\",\n  { elationId: string },\n  unknown | null\n>(\"patients:getByElationId\");\n\nconst patientsByHintIdRef = makeFunctionReference<\n  \"query\",\n  { hintId: string },\n  unknown | null\n>(\"patients:getByHintId\");\n\n// Appointment query references\nconst appointmentsListRef = makeFunctionReference<\n  \"query\",\n  {\n    patientId?: string;\n    status?: string;\n    startDate?: string;\n    endDate?: string;\n    limit?: number;\n  },\n  unknown[]\n>(\"appointments:list\");\n\nconst appointmentsGetRef = makeFunctionReference<\n  \"query\",\n  { id: string },\n  unknown | null\n>(\"appointments:get\");\n\nconst appointmentsByElationIdRef = makeFunctionReference<\n  \"query\",\n  { elationId: string },\n  unknown | null\n>(\"appointments:getByElationId\");\n\n// ---------------------------------------------------------------------------\n// Patient hooks\n// ---------------------------------------------------------------------------\n\ninterface UsePatientListOptions {\n  search?: string;\n  lastName?: string;\n  limit?: number;\n}\n\n/**\n * Subscribe to a list of patients with optional search and filtering.\n * Returns undefined while loading, then an array of patients.\n */\nfunction usePatients(options?: UsePatientListOptions) {\n  return useQuery(patientsListRef as FunctionReference<\"query\">, options ?? {});\n}\n\n/**\n * Subscribe to a single patient by Convex document ID.\n */\nfunction usePatient(id: string) {\n  return useQuery(patientsGetRef as FunctionReference<\"query\">, { id });\n}\n\n/**\n * Subscribe to a patient by their Elation ID.\n */\nfunction usePatientByElationId(elationId: string) {\n  return useQuery(patientsByElationIdRef as FunctionReference<\"query\">, {\n    elationId,\n  });\n}\n\n/**\n * Subscribe to a patient by their Hint ID.\n */\nfunction usePatientByHintId(hintId: string) {\n  return useQuery(patientsByHintIdRef as FunctionReference<\"query\">, {\n    hintId,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Appointment hooks\n// ---------------------------------------------------------------------------\n\ninterface UseAppointmentListOptions {\n  patientId?: string;\n  status?: string;\n  startDate?: string;\n  endDate?: string;\n  limit?: number;\n}\n\n/**\n * Subscribe to a list of appointments with optional filtering.\n */\nfunction useAppointments(options?: UseAppointmentListOptions) {\n  return useQuery(\n    appointmentsListRef as FunctionReference<\"query\">,\n    options ?? {},\n  );\n}\n\n/**\n * Subscribe to a single appointment by Convex document ID.\n */\nfunction useAppointment(id: string) {\n  return useQuery(appointmentsGetRef as FunctionReference<\"query\">, { id });\n}\n\n/**\n * Subscribe to an appointment by its Elation ID.\n */\nfunction useAppointmentByElationId(elationId: string) {\n  return useQuery(appointmentsByElationIdRef as FunctionReference<\"query\">, {\n    elationId,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Physician hooks\n// ---------------------------------------------------------------------------\n\ninterface Physician {\n  _id: string;\n  elationId: number;\n  firstName?: string;\n  lastName?: string;\n  npi?: string;\n  credentials?: string;\n  specialties?: string[];\n  practice?: number;\n  email?: string;\n  phone?: string;\n  lastSyncedAt: string;\n}\n\nconst physiciansGetByElationIdsRef = makeFunctionReference<\n  \"query\",\n  { ids: number[] },\n  Physician[]\n>(\"physicians:getByElationIds\");\n\nconst physiciansGetByElationIdRef = makeFunctionReference<\n  \"query\",\n  { id: number },\n  Physician | null\n>(\"physicians:getByElationId\");\n\n/**\n * Resolve a batch of physicians by their Elation IDs. Returns an array\n * of physicians that exist in Convex; missing ids are silently dropped.\n *\n * Use this to resolve medication `prescribing_physician` / appointment\n * physician ids to display names, avoiding the per-physician HTTP\n * round-trip through Truth's Elation proxy.\n *\n * Pass `undefined` (or an empty array) to skip the query — the hook\n * returns `undefined` until you pass a populated list.\n */\nfunction usePhysiciansByElationIds(ids: number[] | undefined) {\n  return useQuery(\n    physiciansGetByElationIdsRef as FunctionReference<\"query\">,\n    ids && ids.length > 0 ? { ids } : \"skip\",\n  );\n}\n\n/**\n * Subscribe to a single physician by their Elation ID.\n */\nfunction usePhysicianByElationId(id: number | undefined) {\n  return useQuery(\n    physiciansGetByElationIdRef as FunctionReference<\"query\">,\n    id !== undefined ? { id } : \"skip\",\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Patient medical hooks (medications, problems, allergies, appointments)\n// ---------------------------------------------------------------------------\n\nconst medicationsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getMedicationsByElationPatient\");\n\nconst problemsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getProblemsByElationPatient\");\n\nconst allergiesByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getAllergiesByElationPatient\");\n\nconst appointmentsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getAppointmentsByElationPatient\");\n\ninterface UsePatientMedicalOptions {\n  /**\n   * Base URL of the Truth API. Required to trigger the background refresh\n   * (e.g. `https://app.truth.communication-hub.com`). If omitted, the hook\n   * only reads from Convex and does not refresh.\n   */\n  apiBaseUrl?: string;\n  /** API key used for the refresh call. */\n  apiKey?: string;\n  /**\n   * If true, suppress the background refresh. Useful when you know the\n   * data was just refreshed by another component on the page.\n   */\n  skipRefresh?: boolean;\n}\n\n/**\n * Composite hook that returns a patient's medical records — medications,\n * problems, allergies, appointments — from the Convex cache.\n *\n * On mount (and when `elationId` changes) fires a background refresh\n * against Truth's `/api/patients/medical/refresh` endpoint so stale data\n * is pulled in without blocking render. Returns cached data immediately;\n * Convex subscription updates the UI when refresh completes.\n */\nfunction usePatientMedical(\n  elationId: number | undefined,\n  options?: UsePatientMedicalOptions,\n) {\n  const medications = useQuery(\n    medicationsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const problems = useQuery(\n    problemsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const allergies = useQuery(\n    allergiesByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const appointments = useQuery(\n    appointmentsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  useEffect(() => {\n    if (elationId === undefined || options?.skipRefresh) {\n      return;\n    }\n    const apiBaseUrl = options?.apiBaseUrl;\n    const apiKey = options?.apiKey;\n    if (!apiBaseUrl || !apiKey) {\n      return;\n    }\n\n    const controller = new AbortController();\n    void fetch(`${apiBaseUrl}/api/patients/medical/refresh`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-API-Key\": apiKey,\n      },\n      body: JSON.stringify({ elationId }),\n      signal: controller.signal,\n    }).catch(() => {\n      /* background refresh — failures are non-fatal */\n    });\n\n    return () => controller.abort();\n  }, [elationId, options?.apiBaseUrl, options?.apiKey, options?.skipRefresh]);\n\n  return { medications, problems, allergies, appointments };\n}\n\n// ---------------------------------------------------------------------------\n// Patient basic hooks (Elation demographics + Hint memberships/account)\n// ---------------------------------------------------------------------------\n//\n// Replaces the CommHub `getPatientBasicDetails` Hasura Action. Reads\n// from Convex-cached rows (populated by the patients-backfill cron +\n// `/api/patients/basic/refresh` on-demand), falling back to an empty\n// state until the background refresh completes.\n\nconst elationPatientByIdRef = makeFunctionReference<\n  \"query\",\n  { elationId: number },\n  unknown | null\n>(\"elationPatients:getByElationId\");\n\nconst hintPatientByIdRef = makeFunctionReference<\n  \"query\",\n  { hintId: string },\n  unknown | null\n>(\"hintPatients:getByHintId\");\n\nconst pharmacyByNcpdpRef = makeFunctionReference<\n  \"query\",\n  { ncpdpId: string },\n  unknown | null\n>(\"elationPharmacies:getByNcpdpId\");\n\nconst patientPhotoByIdRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown | null\n>(\"elationPatientPhotos:getByElationPatientId\");\n\ninterface UsePatientBasicOptions {\n  /** Truth API base URL used for the background refresh. */\n  apiBaseUrl?: string;\n  /** API key for the refresh call. */\n  apiKey?: string;\n  /** Suppress the background refresh. */\n  skipRefresh?: boolean;\n}\n\ninterface UsePatientBasicResult {\n  /**\n   * Raw Elation patient payload (matches the shape Elation's\n   * `/patients/{id}` returns — `first_name`, `last_name`, `phones`, etc).\n   * Returns `undefined` while the cache miss is loading, `null` if the\n   * patient isn't in Convex yet (first-open-after-backfill).\n   */\n  elationPatient: Record<string, unknown> | null | undefined;\n  /**\n   * Raw Hint patient payload (matches the shape Hint's\n   * `/provider/patients/{id}` returns — `memberships`, `account`,\n   * `phones`, etc).\n   */\n  hintPatient: Record<string, unknown> | null | undefined;\n  /**\n   * The full Convex row for Elation (includes `elationId`, `lastSyncedAt`,\n   * `photoS3Key`, `preferredPharmacyNcpdpId`, etc). Use this when you\n   * need the structured/typed fields rather than the raw Elation payload.\n   */\n  elationRow: Record<string, unknown> | null | undefined;\n  /**\n   * The full Convex row for Hint. Similar relationship to `hintPatient`.\n   */\n  hintRow: Record<string, unknown> | null | undefined;\n  /** True while either cache miss is still pending. */\n  loading: boolean;\n}\n\n/**\n * Composite hook returning a patient's basic details — Hint demographics\n * + memberships + account, Elation demographics + clinical metadata —\n * from the Convex cache.\n *\n * On mount (and when inputs change) fires a background refresh against\n * `/api/patients/basic/refresh` so stale rows get pulled fresh without\n * blocking render. Returns cached data immediately; Convex subscription\n * updates the UI when refresh completes.\n */\nfunction usePatientBasic(\n  input: { hintId?: string; elationId?: number },\n  options?: UsePatientBasicOptions,\n): UsePatientBasicResult {\n  const elationRow = useQuery(\n    elationPatientByIdRef as FunctionReference<\"query\">,\n    input.elationId !== undefined ? { elationId: input.elationId } : \"skip\",\n  ) as Record<string, unknown> | null | undefined;\n\n  const hintRow = useQuery(\n    hintPatientByIdRef as FunctionReference<\"query\">,\n    input.hintId !== undefined ? { hintId: input.hintId } : \"skip\",\n  ) as Record<string, unknown> | null | undefined;\n\n  useEffect(() => {\n    if (options?.skipRefresh) return;\n    if (!input.hintId && input.elationId === undefined) return;\n    const apiBaseUrl = options?.apiBaseUrl;\n    const apiKey = options?.apiKey;\n    if (!apiBaseUrl || !apiKey) return;\n\n    const controller = new AbortController();\n    void fetch(`${apiBaseUrl}/api/patients/basic/refresh`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-API-Key\": apiKey,\n      },\n      body: JSON.stringify({\n        hintId: input.hintId,\n        elationId: input.elationId,\n      }),\n      signal: controller.signal,\n    }).catch(() => {\n      /* background refresh — failures are non-fatal */\n    });\n\n    return () => controller.abort();\n  }, [\n    input.hintId,\n    input.elationId,\n    options?.apiBaseUrl,\n    options?.apiKey,\n    options?.skipRefresh,\n  ]);\n\n  // Surface the raw payload under elationPatient/hintPatient so consumers\n  // can keep using the exact Elation/Hint field names (first_name,\n  // memberships, account.past_due_in_cents) with zero mapping.\n  const elationPatient =\n    elationRow === undefined\n      ? undefined\n      : elationRow === null\n        ? null\n        : ((elationRow.raw as Record<string, unknown>) ?? null);\n  const hintPatient =\n    hintRow === undefined\n      ? undefined\n      : hintRow === null\n        ? null\n        : ((hintRow.raw as Record<string, unknown>) ?? null);\n\n  const elationLoading =\n    input.elationId !== undefined && elationRow === undefined;\n  const hintLoading = input.hintId !== undefined && hintRow === undefined;\n\n  return {\n    elationPatient,\n    hintPatient,\n    elationRow,\n    hintRow,\n    loading: elationLoading || hintLoading,\n  };\n}\n\n/**\n * Read a shared pharmacy row by NCPDP id. Backs the pharmacy card in\n * the patient panel (from Elation's preferred_pharmacy reference).\n */\nfunction usePharmacyByNcpdpId(ncpdpId: string | undefined) {\n  return useQuery(\n    pharmacyByNcpdpRef as FunctionReference<\"query\">,\n    ncpdpId ? { ncpdpId } : \"skip\",\n  );\n}\n\ninterface UsePatientPhotoOptions {\n  apiBaseUrl?: string;\n  apiKey?: string;\n  skipRefresh?: boolean;\n}\n\n/**\n * Subscribe to a patient's profile photo (s3Key + metadata). The\n * consumer constructs a download URL via the Truth attachments resource\n * (signed S3 URL). Fires a background refresh to pull the latest photo\n * binary from Elation + upload to S3.\n */\nfunction usePatientPhoto(\n  elationId: number | undefined,\n  options?: UsePatientPhotoOptions,\n) {\n  const photo = useQuery(\n    patientPhotoByIdRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  );\n\n  useEffect(() => {\n    if (options?.skipRefresh) return;\n    if (elationId === undefined) return;\n    const apiBaseUrl = options?.apiBaseUrl;\n    const apiKey = options?.apiKey;\n    if (!apiBaseUrl || !apiKey) return;\n\n    const controller = new AbortController();\n    void fetch(`${apiBaseUrl}/api/patients/photo/refresh`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-API-Key\": apiKey,\n      },\n      body: JSON.stringify({ elationId }),\n      signal: controller.signal,\n    }).catch(() => {\n      /* non-fatal */\n    });\n\n    return () => controller.abort();\n  }, [elationId, options?.apiBaseUrl, options?.apiKey, options?.skipRefresh]);\n\n  return photo;\n}\n\n// ---------------------------------------------------------------------------\n// Conversation messages (Dialpad calls + SMS merged)\n// ---------------------------------------------------------------------------\n\ninterface ConversationMessage {\n  kind: \"call\" | \"sms\";\n  id: string;\n  providerId: string;\n  state: string | null;\n  direction: string | null;\n  fromNumber: string | null;\n  toNumber: string | null;\n  voicemailLink: string | null;\n  duration: number | null;\n  text: string | null;\n  mms: boolean;\n  mmsUrl: string | null;\n  messageStatus: string | null;\n  occurredAt: string;\n  conversationId: string | null;\n  patientId: string | null;\n}\n\nconst messagesByPhonesRef = makeFunctionReference<\n  \"query\",\n  { phoneA: string; phoneB: string; limit?: number },\n  ConversationMessage[]\n>(\"conversationMessages:getByPhones\");\n\nconst messagesByConversationIdRef = makeFunctionReference<\n  \"query\",\n  { conversationId: string; limit?: number },\n  ConversationMessage[]\n>(\"conversationMessages:getByConversationId\");\n\ninterface UseConversationMessagesOptions {\n  /** Max items to return (default 200). */\n  limit?: number;\n}\n\n/**\n * Subscribe to a conversation's calls + SMS merged chronologically.\n * Pass the patient phone + the provider phone — Truth computes a\n * normalized pair key server-side so formatting differences don't\n * matter.\n *\n * Returns `undefined` while loading, then `ConversationMessage[]`\n * sorted newest-first. Updates live as new webhook events land in\n * Convex via the kinesis consumer.\n */\nfunction useConversationMessages(\n  input: { phoneA?: string; phoneB?: string; conversationId?: string },\n  options?: UseConversationMessagesOptions,\n): ConversationMessage[] | undefined {\n  const hasPair = !!input.phoneA && !!input.phoneB;\n  const byPair = useQuery(\n    messagesByPhonesRef as FunctionReference<\"query\">,\n    hasPair\n      ? {\n          phoneA: input.phoneA as string,\n          phoneB: input.phoneB as string,\n          limit: options?.limit,\n        }\n      : \"skip\",\n  ) as ConversationMessage[] | undefined;\n\n  const byConvo = useQuery(\n    messagesByConversationIdRef as FunctionReference<\"query\">,\n    !hasPair && input.conversationId\n      ? { conversationId: input.conversationId, limit: options?.limit }\n      : \"skip\",\n  ) as ConversationMessage[] | undefined;\n\n  return hasPair ? byPair : byConvo;\n}\n\nexport {\n  usePatients,\n  usePatient,\n  usePatientByElationId,\n  usePatientByHintId,\n  useAppointments,\n  useAppointment,\n  useAppointmentByElationId,\n  usePhysiciansByElationIds,\n  usePhysicianByElationId,\n  usePatientMedical,\n  usePatientBasic,\n  usePharmacyByNcpdpId,\n  usePatientPhoto,\n  useConversationMessages,\n};\nexport type { ConversationMessage, UseConversationMessagesOptions };\nexport type {\n  UsePatientListOptions,\n  UseAppointmentListOptions,\n  UsePatientMedicalOptions,\n  UsePatientBasicOptions,\n  UsePatientBasicResult,\n  UsePatientPhotoOptions,\n  Physician,\n};\n","/**\n * TruthProvider — Convex React provider pre-configured for Truth.\n *\n * Wraps children in a ConvexProvider connected to the correct\n * Truth Convex deployment for the given environment.\n *\n * @example\n * ```tsx\n * import { TruthProvider } from '@hipnation-truth/sdk/react';\n *\n * function App() {\n *   return (\n *     <TruthProvider environment=\"sandbox\">\n *       <MyApp />\n *     </TruthProvider>\n *   );\n * }\n * ```\n */\n\n\"use client\";\n\nimport { ConvexProvider, ConvexReactClient } from \"convex/react\";\nimport type { ReactNode } from \"react\";\nimport { createElement, useMemo } from \"react\";\n\n// Mirrors CONVEX_URLS in client.ts. UAT shares prod resources.\nconst CONVEX_URLS: Record<string, string> = {\n  local: \"https://courteous-duck-623.convex.cloud\",\n  staging: \"https://courteous-duck-623.convex.cloud\",\n  stg: \"https://courteous-duck-623.convex.cloud\",\n  sandbox: \"https://courteous-duck-623.convex.cloud\",\n  uat: \"https://gallant-gecko-217.convex.cloud\",\n  production: \"https://gallant-gecko-217.convex.cloud\",\n};\n\ninterface TruthProviderProps {\n  /** Truth environment — determines which Convex deployment to connect to */\n  environment?: string;\n  /** Override the Convex URL directly */\n  convexUrl?: string;\n  children: ReactNode;\n}\n\nfunction TruthProvider({\n  environment = \"sandbox\",\n  convexUrl,\n  children,\n}: TruthProviderProps) {\n  const url = convexUrl ?? CONVEX_URLS[environment] ?? CONVEX_URLS.sandbox;\n\n  const client = useMemo(() => new ConvexReactClient(url), [url]);\n\n  return createElement(ConvexProvider, { client }, children);\n}\n\nexport { TruthProvider };\nexport type { TruthProviderProps };\n","/**\n * React tracking hook — fire-and-forget event tracking from client components.\n *\n * Creates a lightweight Tracker instance scoped to the browser session\n * and exposes a useTrack() hook for emitting events to Truth's Kinesis stream.\n *\n * @example\n * ```tsx\n * import { useTruth } from '@hipnation-truth/sdk/react';\n *\n * function ConversationView({ conversationId }) {\n *   const truth = useTruth();\n *\n *   useEffect(() => {\n *     truth.track('conversation.marked_read.v1', {\n *       read_by_actor_id: userId,\n *       unread_count_before: 5,\n *       unread_count_after: 0,\n *     }, { subject: { conversation_id: conversationId } });\n *   }, [conversationId]);\n * }\n * ```\n */\n\n\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport { createContext, createElement, useContext, useMemo } from \"react\";\nimport type {\n  EventPayloadMap,\n  EventType,\n  TrackOptions,\n} from \"../tracking/events\";\nimport { Tracker } from \"../tracking/tracker\";\nimport type { ActorContext } from \"../types/config\";\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\ninterface TruthTrackingContextValue {\n  track: <T extends EventType>(\n    eventType: T,\n    payload: EventPayloadMap[T],\n    options?: TrackOptions,\n  ) => void;\n  identify: (actorId: string, actorType: ActorContext[\"actorType\"]) => void;\n}\n\nconst TruthTrackingContext = createContext<TruthTrackingContextValue | null>(\n  null,\n);\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\ninterface TruthTrackingProviderProps {\n  /** Truth environment — determines API URL for event delivery */\n  environment?: string;\n  /** Event source identifier */\n  source?: string;\n  /** Source version (git SHA) */\n  sourceVersion?: string;\n  /** Default tenant ID */\n  tenantId?: string;\n  /** API key for authentication */\n  apiKey?: string;\n  children: ReactNode;\n}\n\nfunction TruthTrackingProvider({\n  environment = \"sandbox\",\n  source = \"communication-hub.frontend\",\n  sourceVersion = \"unknown\",\n  tenantId = \"hipnation\",\n  apiKey = \"\",\n  children,\n}: TruthTrackingProviderProps) {\n  const value = useMemo<TruthTrackingContextValue>(() => {\n    const tracker = new Tracker({\n      apiKey,\n      environment,\n      source,\n      sourceVersion,\n      tenantId,\n      batchSize: 10,\n      flushIntervalMs: 5000,\n    });\n\n    return {\n      track: (eventType, payload, options) => {\n        tracker.track(eventType, payload, options);\n      },\n      identify: (actorId, actorType) => {\n        tracker.setActor({ actorId, actorType });\n      },\n    };\n  }, [apiKey, environment, source, sourceVersion, tenantId]);\n\n  return createElement(TruthTrackingContext.Provider, { value }, children);\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\n/**\n * Access the Truth tracking context. Must be within a TruthTrackingProvider.\n * Returns `{ track, identify }` for emitting events to Kinesis.\n */\nfunction useTruth(): TruthTrackingContextValue {\n  const ctx = useContext(TruthTrackingContext);\n  if (!ctx) {\n    throw new Error(\"useTruth must be used within a TruthTrackingProvider\");\n  }\n  return ctx;\n}\n\nexport { TruthTrackingProvider, useTruth };\nexport type { TruthTrackingProviderProps, TruthTrackingContextValue };\n","/**\n * Event tracker with batching, retry, and flush support.\n *\n * Buffers events in an internal queue and flushes them to the Truth API\n * endpoint. Flushes occur when the buffer reaches `batchSize` or every\n * `flushIntervalMs` milliseconds, whichever comes first.\n */\n\nimport type { ActorContext } from \"../types/config\";\nimport type {\n  EventEnvelope,\n  EventPayloadMap,\n  EventType,\n  TrackOptions,\n} from \"./events\";\n\n// ---------------------------------------------------------------------------\n// UUID v7 helper (no external dependency)\n// ---------------------------------------------------------------------------\n\n/**\n * Generates a UUID v7 string. Uses crypto.randomUUID where available,\n * falling back to a timestamp + random bytes implementation.\n *\n * UUID v7 layout (RFC 9562):\n *   48 bits - unix timestamp (ms)\n *   4 bits  - version (0b0111)\n *   12 bits - random\n *   2 bits  - variant (0b10)\n *   62 bits - random\n */\nfunction generateUuidV7(): string {\n  const now = Date.now();\n\n  // 6 bytes of timestamp\n  const timeBytes = new Uint8Array(6);\n  let ts = now;\n  for (let i = 5; i >= 0; i--) {\n    timeBytes[i] = ts & 0xff;\n    ts = Math.floor(ts / 256);\n  }\n\n  // 10 bytes of random\n  const randomBytes = new Uint8Array(10);\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    globalThis.crypto.getRandomValues\n  ) {\n    globalThis.crypto.getRandomValues(randomBytes);\n  } else {\n    for (let i = 0; i < 10; i++) {\n      randomBytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n\n  // Assemble 16 bytes\n  const bytes = new Uint8Array(16);\n  bytes.set(timeBytes, 0);\n  bytes.set(randomBytes, 6);\n\n  // Set version (bits 48-51 to 0b0111)\n  bytes[6] = (bytes[6] & 0x0f) | 0x70;\n\n  // Set variant (bits 64-65 to 0b10)\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n  // Format as hex string with dashes\n  const hex = Array.from(bytes)\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20, 32),\n  ].join(\"-\");\n}\n\n// ---------------------------------------------------------------------------\n// Environment-based API URL resolution\n// ---------------------------------------------------------------------------\n\n// Environment → Truth API base URL.\n//\n// Topology:\n//   local / staging / stg / sandbox → sandbox Truth (app.sandbox.*)\n//   uat / production                → production Truth (app.truth.*)\n//\n// UAT shares production resources (same Fly Postgres + Hasura + Truth +\n// Convex + EHR tokens as prod). Staging is the isolated sandbox env.\nconst API_URLS: Record<string, string> = {\n  local: \"http://localhost:3000\",\n  staging: \"https://app.sandbox.communication-hub.com\",\n  stg: \"https://app.sandbox.communication-hub.com\",\n  sandbox: \"https://app.sandbox.communication-hub.com\",\n  uat: \"https://app.truth.communication-hub.com\",\n  production: \"https://app.truth.communication-hub.com\",\n};\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_BATCH_SIZE = 25;\nconst DEFAULT_FLUSH_INTERVAL_MS = 5_000;\nconst MAX_RETRIES = 3;\nconst BASE_RETRY_DELAY_MS = 500;\n\n// ---------------------------------------------------------------------------\n// Tracker configuration\n// ---------------------------------------------------------------------------\n\ninterface TrackerConfig {\n  apiKey: string;\n  environment: string;\n  source: string;\n  sourceVersion: string;\n  tenantId: string;\n  batchSize: number;\n  flushIntervalMs: number;\n  apiBaseUrl?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Tracker class\n// ---------------------------------------------------------------------------\n\nclass Tracker {\n  private readonly config: TrackerConfig;\n  readonly apiUrl: string;\n  private queue: EventEnvelope[] = [];\n  private flushTimer: ReturnType<typeof setInterval> | null = null;\n  private defaultActor: ActorContext | undefined;\n  private isFlushing = false;\n  private isShutdown = false;\n\n  constructor(config: TrackerConfig) {\n    this.config = config;\n    this.apiUrl =\n      config.apiBaseUrl ?? API_URLS[config.environment] ?? API_URLS.local;\n\n    this.startFlushInterval();\n    this.registerShutdownHooks();\n  }\n\n  /**\n   * Set the default actor context for subsequent events.\n   */\n  setActor(actor: ActorContext): void {\n    this.defaultActor = actor;\n  }\n\n  /**\n   * Enqueue a typed event for delivery. This is fire-and-forget from\n   * the caller's perspective -- events are buffered and flushed in batches.\n   */\n  track<T extends EventType>(\n    eventType: T,\n    payload: EventPayloadMap[T],\n    options?: TrackOptions,\n  ): void {\n    if (this.isShutdown) {\n      return;\n    }\n\n    const now = new Date().toISOString();\n\n    const envelope: EventEnvelope = {\n      event_id: generateUuidV7(),\n      event_type: eventType,\n      schema_version: 1,\n      occurred_at: options?.occurredAt ?? now,\n      received_at: now,\n      source: this.config.source,\n      source_version: this.config.sourceVersion,\n      tenant_id: options?.tenantId ?? this.config.tenantId,\n      actor:\n        options?.actor ??\n        (this.defaultActor\n          ? {\n              actor_id: this.defaultActor.actorId,\n              actor_type: this.defaultActor.actorType,\n            }\n          : undefined),\n      subject: options?.subject,\n      compliance: options?.compliance,\n      payload: payload as unknown as Record<string, unknown>,\n    };\n\n    this.queue.push(envelope);\n\n    if (this.queue.length >= this.config.batchSize) {\n      void this.flush();\n    }\n  }\n\n  /**\n   * Force an immediate flush of all buffered events.\n   * Returns a promise that resolves when the flush completes.\n   */\n  async flush(): Promise<void> {\n    if (this.queue.length === 0 || this.isFlushing) {\n      return;\n    }\n\n    this.isFlushing = true;\n    const batch = this.queue.splice(0, this.config.batchSize);\n\n    try {\n      await this.sendBatch(batch);\n    } catch {\n      // Re-queue events that failed to send (prepend to maintain ordering)\n      this.queue.unshift(...batch);\n    } finally {\n      this.isFlushing = false;\n    }\n\n    // If there are still events in the queue, flush again\n    if (this.queue.length >= this.config.batchSize) {\n      await this.flush();\n    }\n  }\n\n  /**\n   * Gracefully shut down the tracker. Flushes remaining events and\n   * clears the flush interval.\n   */\n  async shutdown(): Promise<void> {\n    this.isShutdown = true;\n    this.stopFlushInterval();\n    await this.flush();\n  }\n\n  /**\n   * Send a batch of events to the Truth API with exponential backoff retry.\n   */\n  private async sendBatch(batch: EventEnvelope[]): Promise<void> {\n    let lastError: unknown;\n\n    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {\n      try {\n        const response = await fetch(`${this.apiUrl}/api/events/ingest`, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n            \"X-API-Key\": this.config.apiKey,\n          },\n          body: JSON.stringify({ events: batch }),\n        });\n\n        if (response.ok) {\n          return;\n        }\n\n        // Don't retry 4xx client errors (except 429)\n        if (\n          response.status >= 400 &&\n          response.status < 500 &&\n          response.status !== 429\n        ) {\n          return;\n        }\n\n        lastError = new Error(\n          `HTTP ${response.status}: ${response.statusText}`,\n        );\n      } catch (error) {\n        lastError = error;\n      }\n\n      // Exponential backoff with jitter\n      if (attempt < MAX_RETRIES) {\n        const delay = BASE_RETRY_DELAY_MS * 2 ** attempt;\n        const jitter = Math.random() * delay * 0.5;\n        await sleep(delay + jitter);\n      }\n    }\n\n    throw lastError;\n  }\n\n  private startFlushInterval(): void {\n    if (this.config.flushIntervalMs > 0) {\n      this.flushTimer = setInterval(() => {\n        void this.flush();\n      }, this.config.flushIntervalMs);\n\n      // Unref the timer so it doesn't prevent Node.js from exiting\n      if (typeof this.flushTimer === \"object\" && \"unref\" in this.flushTimer) {\n        this.flushTimer.unref();\n      }\n    }\n  }\n\n  private stopFlushInterval(): void {\n    if (this.flushTimer !== null) {\n      clearInterval(this.flushTimer);\n      this.flushTimer = null;\n    }\n  }\n\n  private registerShutdownHooks(): void {\n    // Only register in Node.js environments\n    if (typeof globalThis.process !== \"undefined\" && globalThis.process.on) {\n      const shutdownHandler = () => {\n        void this.shutdown();\n      };\n\n      globalThis.process.on(\"beforeExit\", shutdownHandler);\n      globalThis.process.on(\"SIGTERM\", shutdownHandler);\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport {\n  Tracker,\n  generateUuidV7,\n  DEFAULT_BATCH_SIZE,\n  DEFAULT_FLUSH_INTERVAL_MS,\n};\nexport type { TrackerConfig };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACmBA,mBAAyB;AACzB,IAAAA,gBAA0B;AAW1B,oBAAsC;AAGtC,IAAM,sBAAkB,qCAStB,eAAe;AAEjB,IAAM,qBAAiB,qCAIrB,cAAc;AAEhB,IAAM,6BAAyB,qCAI7B,yBAAyB;AAE3B,IAAM,0BAAsB,qCAI1B,sBAAsB;AAGxB,IAAM,0BAAsB,qCAU1B,mBAAmB;AAErB,IAAM,yBAAqB,qCAIzB,kBAAkB;AAEpB,IAAM,iCAA6B,qCAIjC,6BAA6B;AAgB/B,SAAS,YAAY,SAAiC;AACpD,aAAO,uBAAS,iBAA+C,4BAAW,CAAC,CAAC;AAC9E;AAKA,SAAS,WAAW,IAAY;AAC9B,aAAO,uBAAS,gBAA8C,EAAE,GAAG,CAAC;AACtE;AAKA,SAAS,sBAAsB,WAAmB;AAChD,aAAO,uBAAS,wBAAsD;AAAA,IACpE;AAAA,EACF,CAAC;AACH;AAKA,SAAS,mBAAmB,QAAgB;AAC1C,aAAO,uBAAS,qBAAmD;AAAA,IACjE;AAAA,EACF,CAAC;AACH;AAiBA,SAAS,gBAAgB,SAAqC;AAC5D,aAAO;AAAA,IACL;AAAA,IACA,4BAAW,CAAC;AAAA,EACd;AACF;AAKA,SAAS,eAAe,IAAY;AAClC,aAAO,uBAAS,oBAAkD,EAAE,GAAG,CAAC;AAC1E;AAKA,SAAS,0BAA0B,WAAmB;AACpD,aAAO,uBAAS,4BAA0D;AAAA,IACxE;AAAA,EACF,CAAC;AACH;AAoBA,IAAM,mCAA+B,qCAInC,4BAA4B;AAE9B,IAAM,kCAA8B,qCAIlC,2BAA2B;AAa7B,SAAS,0BAA0B,KAA2B;AAC5D,aAAO;AAAA,IACL;AAAA,IACA,OAAO,IAAI,SAAS,IAAI,EAAE,IAAI,IAAI;AAAA,EACpC;AACF;AAKA,SAAS,wBAAwB,IAAwB;AACvD,aAAO;AAAA,IACL;AAAA,IACA,OAAO,SAAY,EAAE,GAAG,IAAI;AAAA,EAC9B;AACF;AAMA,IAAM,8BAA0B,qCAI9B,+CAA+C;AAEjD,IAAM,2BAAuB,qCAI3B,4CAA4C;AAE9C,IAAM,4BAAwB,qCAI5B,6CAA6C;AAE/C,IAAM,+BAA2B,qCAI/B,gDAAgD;AA2BlD,SAAS,kBACP,WACA,SACA;AACA,QAAM,kBAAc;AAAA,IAClB;AAAA,IACA,cAAc,SAAY,EAAE,kBAAkB,UAAU,IAAI;AAAA,EAC9D;AAEA,QAAM,eAAW;AAAA,IACf;AAAA,IACA,cAAc,SAAY,EAAE,kBAAkB,UAAU,IAAI;AAAA,EAC9D;AAEA,QAAM,gBAAY;AAAA,IAChB;AAAA,IACA,cAAc,SAAY,EAAE,kBAAkB,UAAU,IAAI;AAAA,EAC9D;AAEA,QAAM,mBAAe;AAAA,IACnB;AAAA,IACA,cAAc,SAAY,EAAE,kBAAkB,UAAU,IAAI;AAAA,EAC9D;AAEA,+BAAU,MAAM;AACd,QAAI,cAAc,WAAa,mCAAS,cAAa;AACnD;AAAA,IACF;AACA,UAAM,aAAa,mCAAS;AAC5B,UAAM,SAAS,mCAAS;AACxB,QAAI,CAAC,cAAc,CAAC,QAAQ;AAC1B;AAAA,IACF;AAEA,UAAM,aAAa,IAAI,gBAAgB;AACvC,SAAK,MAAM,GAAG,UAAU,iCAAiC;AAAA,MACvD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa;AAAA,MACf;AAAA,MACA,MAAM,KAAK,UAAU,EAAE,UAAU,CAAC;AAAA,MAClC,QAAQ,WAAW;AAAA,IACrB,CAAC,EAAE,MAAM,MAAM;AAAA,IAEf,CAAC;AAED,WAAO,MAAM,WAAW,MAAM;AAAA,EAChC,GAAG,CAAC,WAAW,mCAAS,YAAY,mCAAS,QAAQ,mCAAS,WAAW,CAAC;AAE1E,SAAO,EAAE,aAAa,UAAU,WAAW,aAAa;AAC1D;AAWA,IAAM,4BAAwB,qCAI5B,gCAAgC;AAElC,IAAM,yBAAqB,qCAIzB,0BAA0B;AAE5B,IAAM,yBAAqB,qCAIzB,gCAAgC;AAElC,IAAM,0BAAsB,qCAI1B,4CAA4C;AAiD9C,SAAS,gBACP,OACA,SACuB;AAhazB;AAiaE,QAAM,iBAAa;AAAA,IACjB;AAAA,IACA,MAAM,cAAc,SAAY,EAAE,WAAW,MAAM,UAAU,IAAI;AAAA,EACnE;AAEA,QAAM,cAAU;AAAA,IACd;AAAA,IACA,MAAM,WAAW,SAAY,EAAE,QAAQ,MAAM,OAAO,IAAI;AAAA,EAC1D;AAEA,+BAAU,MAAM;AACd,QAAI,mCAAS,YAAa;AAC1B,QAAI,CAAC,MAAM,UAAU,MAAM,cAAc,OAAW;AACpD,UAAM,aAAa,mCAAS;AAC5B,UAAM,SAAS,mCAAS;AACxB,QAAI,CAAC,cAAc,CAAC,OAAQ;AAE5B,UAAM,aAAa,IAAI,gBAAgB;AACvC,SAAK,MAAM,GAAG,UAAU,+BAA+B;AAAA,MACrD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa;AAAA,MACf;AAAA,MACA,MAAM,KAAK,UAAU;AAAA,QACnB,QAAQ,MAAM;AAAA,QACd,WAAW,MAAM;AAAA,MACnB,CAAC;AAAA,MACD,QAAQ,WAAW;AAAA,IACrB,CAAC,EAAE,MAAM,MAAM;AAAA,IAEf,CAAC;AAED,WAAO,MAAM,WAAW,MAAM;AAAA,EAChC,GAAG;AAAA,IACD,MAAM;AAAA,IACN,MAAM;AAAA,IACN,mCAAS;AAAA,IACT,mCAAS;AAAA,IACT,mCAAS;AAAA,EACX,CAAC;AAKD,QAAM,iBACJ,eAAe,SACX,SACA,eAAe,OACb,QACE,gBAAW,QAAX,YAA8C;AACxD,QAAM,cACJ,YAAY,SACR,SACA,YAAY,OACV,QACE,aAAQ,QAAR,YAA2C;AAErD,QAAM,iBACJ,MAAM,cAAc,UAAa,eAAe;AAClD,QAAM,cAAc,MAAM,WAAW,UAAa,YAAY;AAE9D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS,kBAAkB;AAAA,EAC7B;AACF;AAMA,SAAS,qBAAqB,SAA6B;AACzD,aAAO;AAAA,IACL;AAAA,IACA,UAAU,EAAE,QAAQ,IAAI;AAAA,EAC1B;AACF;AAcA,SAAS,gBACP,WACA,SACA;AACA,QAAM,YAAQ;AAAA,IACZ;AAAA,IACA,cAAc,SAAY,EAAE,kBAAkB,UAAU,IAAI;AAAA,EAC9D;AAEA,+BAAU,MAAM;AACd,QAAI,mCAAS,YAAa;AAC1B,QAAI,cAAc,OAAW;AAC7B,UAAM,aAAa,mCAAS;AAC5B,UAAM,SAAS,mCAAS;AACxB,QAAI,CAAC,cAAc,CAAC,OAAQ;AAE5B,UAAM,aAAa,IAAI,gBAAgB;AACvC,SAAK,MAAM,GAAG,UAAU,+BAA+B;AAAA,MACrD,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,aAAa;AAAA,MACf;AAAA,MACA,MAAM,KAAK,UAAU,EAAE,UAAU,CAAC;AAAA,MAClC,QAAQ,WAAW;AAAA,IACrB,CAAC,EAAE,MAAM,MAAM;AAAA,IAEf,CAAC;AAED,WAAO,MAAM,WAAW,MAAM;AAAA,EAChC,GAAG,CAAC,WAAW,mCAAS,YAAY,mCAAS,QAAQ,mCAAS,WAAW,CAAC;AAE1E,SAAO;AACT;AAyBA,IAAM,0BAAsB,qCAI1B,kCAAkC;AAEpC,IAAM,kCAA8B,qCAIlC,0CAA0C;AAiB5C,SAAS,wBACP,OACA,SACmC;AACnC,QAAM,UAAU,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC,MAAM;AAC1C,QAAM,aAAS;AAAA,IACb;AAAA,IACA,UACI;AAAA,MACE,QAAQ,MAAM;AAAA,MACd,QAAQ,MAAM;AAAA,MACd,OAAO,mCAAS;AAAA,IAClB,IACA;AAAA,EACN;AAEA,QAAM,cAAU;AAAA,IACd;AAAA,IACA,CAAC,WAAW,MAAM,iBACd,EAAE,gBAAgB,MAAM,gBAAgB,OAAO,mCAAS,MAAM,IAC9D;AAAA,EACN;AAEA,SAAO,UAAU,SAAS;AAC5B;;;ACtlBA,IAAAC,gBAAkD;AAElD,IAAAA,gBAAuC;AAGvC,IAAM,cAAsC;AAAA,EAC1C,OAAO;AAAA,EACP,SAAS;AAAA,EACT,KAAK;AAAA,EACL,SAAS;AAAA,EACT,KAAK;AAAA,EACL,YAAY;AACd;AAUA,SAAS,cAAc;AAAA,EACrB,cAAc;AAAA,EACd;AAAA,EACA;AACF,GAAuB;AAhDvB;AAiDE,QAAM,OAAM,qCAAa,YAAY,WAAW,MAApC,YAAyC,YAAY;AAEjE,QAAM,aAAS,uBAAQ,MAAM,IAAI,gCAAkB,GAAG,GAAG,CAAC,GAAG,CAAC;AAE9D,aAAO,6BAAc,8BAAgB,EAAE,OAAO,GAAG,QAAQ;AAC3D;;;AC3BA,IAAAC,gBAAkE;;;ACIlE,SAAS,iBAAyB;AAChC,QAAM,MAAM,KAAK,IAAI;AAGrB,QAAM,YAAY,IAAI,WAAW,CAAC;AAClC,MAAI,KAAK;AACT,WAAS,IAAI,GAAG,KAAK,GAAG,KAAK;AAC3B,cAAU,CAAC,IAAI,KAAK;AACpB,SAAK,KAAK,MAAM,KAAK,GAAG;AAAA,EAC1B;AAGA,QAAM,cAAc,IAAI,WAAW,EAAE;AACrC,MACE,OAAO,WAAW,WAAW,eAC7B,WAAW,OAAO,iBAClB;AACA,eAAW,OAAO,gBAAgB,WAAW;AAAA,EAC/C,OAAO;AACL,aAAS,IAAI,GAAG,IAAI,IAAI,KAAK;AAC3B,kBAAY,CAAC,IAAI,KAAK,MAAM,KAAK,OAAO,IAAI,GAAG;AAAA,IACjD;AAAA,EACF;AAGA,QAAM,QAAQ,IAAI,WAAW,EAAE;AAC/B,QAAM,IAAI,WAAW,CAAC;AACtB,QAAM,IAAI,aAAa,CAAC;AAGxB,QAAM,CAAC,IAAK,MAAM,CAAC,IAAI,KAAQ;AAG/B,QAAM,CAAC,IAAK,MAAM,CAAC,IAAI,KAAQ;AAG/B,QAAM,MAAM,MAAM,KAAK,KAAK,EACzB,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG,CAAC,EAC1C,KAAK,EAAE;AAEV,SAAO;AAAA,IACL,IAAI,MAAM,GAAG,CAAC;AAAA,IACd,IAAI,MAAM,GAAG,EAAE;AAAA,IACf,IAAI,MAAM,IAAI,EAAE;AAAA,IAChB,IAAI,MAAM,IAAI,EAAE;AAAA,IAChB,IAAI,MAAM,IAAI,EAAE;AAAA,EAClB,EAAE,KAAK,GAAG;AACZ;AAcA,IAAM,WAAmC;AAAA,EACvC,OAAO;AAAA,EACP,SAAS;AAAA,EACT,KAAK;AAAA,EACL,SAAS;AAAA,EACT,KAAK;AAAA,EACL,YAAY;AACd;AAQA,IAAM,cAAc;AACpB,IAAM,sBAAsB;AAqB5B,IAAM,UAAN,MAAc;AAAA,EASZ,YAAY,QAAuB;AANnC,SAAQ,QAAyB,CAAC;AAClC,SAAQ,aAAoD;AAE5D,SAAQ,aAAa;AACrB,SAAQ,aAAa;AAxIvB;AA2II,SAAK,SAAS;AACd,SAAK,UACH,kBAAO,eAAP,YAAqB,SAAS,OAAO,WAAW,MAAhD,YAAqD,SAAS;AAEhE,SAAK,mBAAmB;AACxB,SAAK,sBAAsB;AAAA,EAC7B;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS,OAA2B;AAClC,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MACE,WACA,SACA,SACM;AAlKV;AAmKI,QAAI,KAAK,YAAY;AACnB;AAAA,IACF;AAEA,UAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AAEnC,UAAM,WAA0B;AAAA,MAC9B,UAAU,eAAe;AAAA,MACzB,YAAY;AAAA,MACZ,gBAAgB;AAAA,MAChB,cAAa,wCAAS,eAAT,YAAuB;AAAA,MACpC,aAAa;AAAA,MACb,QAAQ,KAAK,OAAO;AAAA,MACpB,gBAAgB,KAAK,OAAO;AAAA,MAC5B,YAAW,wCAAS,aAAT,YAAqB,KAAK,OAAO;AAAA,MAC5C,QACE,wCAAS,UAAT,YACC,KAAK,eACF;AAAA,QACE,UAAU,KAAK,aAAa;AAAA,QAC5B,YAAY,KAAK,aAAa;AAAA,MAChC,IACA;AAAA,MACN,SAAS,mCAAS;AAAA,MAClB,YAAY,mCAAS;AAAA,MACrB;AAAA,IACF;AAEA,SAAK,MAAM,KAAK,QAAQ;AAExB,QAAI,KAAK,MAAM,UAAU,KAAK,OAAO,WAAW;AAC9C,WAAK,KAAK,MAAM;AAAA,IAClB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMM,QAAuB;AAAA;AAC3B,UAAI,KAAK,MAAM,WAAW,KAAK,KAAK,YAAY;AAC9C;AAAA,MACF;AAEA,WAAK,aAAa;AAClB,YAAM,QAAQ,KAAK,MAAM,OAAO,GAAG,KAAK,OAAO,SAAS;AAExD,UAAI;AACF,cAAM,KAAK,UAAU,KAAK;AAAA,MAC5B,SAAQ;AAEN,aAAK,MAAM,QAAQ,GAAG,KAAK;AAAA,MAC7B,UAAE;AACA,aAAK,aAAa;AAAA,MACpB;AAGA,UAAI,KAAK,MAAM,UAAU,KAAK,OAAO,WAAW;AAC9C,cAAM,KAAK,MAAM;AAAA,MACnB;AAAA,IACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMM,WAA0B;AAAA;AAC9B,WAAK,aAAa;AAClB,WAAK,kBAAkB;AACvB,YAAM,KAAK,MAAM;AAAA,IACnB;AAAA;AAAA;AAAA;AAAA;AAAA,EAKc,UAAU,OAAuC;AAAA;AAC7D,UAAI;AAEJ,eAAS,UAAU,GAAG,WAAW,aAAa,WAAW;AACvD,YAAI;AACF,gBAAM,WAAW,MAAM,MAAM,GAAG,KAAK,MAAM,sBAAsB;AAAA,YAC/D,QAAQ;AAAA,YACR,SAAS;AAAA,cACP,gBAAgB;AAAA,cAChB,aAAa,KAAK,OAAO;AAAA,YAC3B;AAAA,YACA,MAAM,KAAK,UAAU,EAAE,QAAQ,MAAM,CAAC;AAAA,UACxC,CAAC;AAED,cAAI,SAAS,IAAI;AACf;AAAA,UACF;AAGA,cACE,SAAS,UAAU,OACnB,SAAS,SAAS,OAClB,SAAS,WAAW,KACpB;AACA;AAAA,UACF;AAEA,sBAAY,IAAI;AAAA,YACd,QAAQ,SAAS,MAAM,KAAK,SAAS,UAAU;AAAA,UACjD;AAAA,QACF,SAAS,OAAO;AACd,sBAAY;AAAA,QACd;AAGA,YAAI,UAAU,aAAa;AACzB,gBAAM,QAAQ,sBAAsB,SAAK;AACzC,gBAAM,SAAS,KAAK,OAAO,IAAI,QAAQ;AACvC,gBAAM,MAAM,QAAQ,MAAM;AAAA,QAC5B;AAAA,MACF;AAEA,YAAM;AAAA,IACR;AAAA;AAAA,EAEQ,qBAA2B;AACjC,QAAI,KAAK,OAAO,kBAAkB,GAAG;AACnC,WAAK,aAAa,YAAY,MAAM;AAClC,aAAK,KAAK,MAAM;AAAA,MAClB,GAAG,KAAK,OAAO,eAAe;AAG9B,UAAI,OAAO,KAAK,eAAe,YAAY,WAAW,KAAK,YAAY;AACrE,aAAK,WAAW,MAAM;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,oBAA0B;AAChC,QAAI,KAAK,eAAe,MAAM;AAC5B,oBAAc,KAAK,UAAU;AAC7B,WAAK,aAAa;AAAA,IACpB;AAAA,EACF;AAAA,EAEQ,wBAA8B;AAEpC,QAAI,OAAO,WAAW,YAAY,eAAe,WAAW,QAAQ,IAAI;AACtE,YAAM,kBAAkB,MAAM;AAC5B,aAAK,KAAK,SAAS;AAAA,MACrB;AAEA,iBAAW,QAAQ,GAAG,cAAc,eAAe;AACnD,iBAAW,QAAQ,GAAG,WAAW,eAAe;AAAA,IAClD;AAAA,EACF;AACF;AAMA,SAAS,MAAM,IAA2B;AACxC,SAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AACzD;;;ADjRA,IAAM,2BAAuB;AAAA,EAC3B;AACF;AAoBA,SAAS,sBAAsB;AAAA,EAC7B,cAAc;AAAA,EACd,SAAS;AAAA,EACT,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,SAAS;AAAA,EACT;AACF,GAA+B;AAC7B,QAAM,YAAQ,uBAAmC,MAAM;AACrD,UAAM,UAAU,IAAI,QAAQ;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW;AAAA,MACX,iBAAiB;AAAA,IACnB,CAAC;AAED,WAAO;AAAA,MACL,OAAO,CAAC,WAAW,SAAS,YAAY;AACtC,gBAAQ,MAAM,WAAW,SAAS,OAAO;AAAA,MAC3C;AAAA,MACA,UAAU,CAAC,SAAS,cAAc;AAChC,gBAAQ,SAAS,EAAE,SAAS,UAAU,CAAC;AAAA,MACzC;AAAA,IACF;AAAA,EACF,GAAG,CAAC,QAAQ,aAAa,QAAQ,eAAe,QAAQ,CAAC;AAEzD,aAAO,6BAAc,qBAAqB,UAAU,EAAE,MAAM,GAAG,QAAQ;AACzE;AAUA,SAAS,WAAsC;AAC7C,QAAM,UAAM,0BAAW,oBAAoB;AAC3C,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,sDAAsD;AAAA,EACxE;AACA,SAAO;AACT;","names":["import_react","import_react","import_react"]}

package/dist/react.mjs

@@ -121,6 +121,110 @@ function usePatientMedical(elationId, options) {
   }, [elationId, options == null ? void 0 : options.apiBaseUrl, options == null ? void 0 : options.apiKey, options == null ? void 0 : options.skipRefresh]);
   return { medications, problems, allergies, appointments };
 }
+var elationPatientByIdRef = makeFunctionReference("elationPatients:getByElationId");
+var hintPatientByIdRef = makeFunctionReference("hintPatients:getByHintId");
+var pharmacyByNcpdpRef = makeFunctionReference("elationPharmacies:getByNcpdpId");
+var patientPhotoByIdRef = makeFunctionReference("elationPatientPhotos:getByElationPatientId");
+function usePatientBasic(input, options) {
+  var _a, _b;
+  const elationRow = useQuery(
+    elationPatientByIdRef,
+    input.elationId !== void 0 ? { elationId: input.elationId } : "skip"
+  );
+  const hintRow = useQuery(
+    hintPatientByIdRef,
+    input.hintId !== void 0 ? { hintId: input.hintId } : "skip"
+  );
+  useEffect(() => {
+    if (options == null ? void 0 : options.skipRefresh) return;
+    if (!input.hintId && input.elationId === void 0) return;
+    const apiBaseUrl = options == null ? void 0 : options.apiBaseUrl;
+    const apiKey = options == null ? void 0 : options.apiKey;
+    if (!apiBaseUrl || !apiKey) return;
+    const controller = new AbortController();
+    void fetch(`${apiBaseUrl}/api/patients/basic/refresh`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": apiKey
+      },
+      body: JSON.stringify({
+        hintId: input.hintId,
+        elationId: input.elationId
+      }),
+      signal: controller.signal
+    }).catch(() => {
+    });
+    return () => controller.abort();
+  }, [
+    input.hintId,
+    input.elationId,
+    options == null ? void 0 : options.apiBaseUrl,
+    options == null ? void 0 : options.apiKey,
+    options == null ? void 0 : options.skipRefresh
+  ]);
+  const elationPatient = elationRow === void 0 ? void 0 : elationRow === null ? null : (_a = elationRow.raw) != null ? _a : null;
+  const hintPatient = hintRow === void 0 ? void 0 : hintRow === null ? null : (_b = hintRow.raw) != null ? _b : null;
+  const elationLoading = input.elationId !== void 0 && elationRow === void 0;
+  const hintLoading = input.hintId !== void 0 && hintRow === void 0;
+  return {
+    elationPatient,
+    hintPatient,
+    elationRow,
+    hintRow,
+    loading: elationLoading || hintLoading
+  };
+}
+function usePharmacyByNcpdpId(ncpdpId) {
+  return useQuery(
+    pharmacyByNcpdpRef,
+    ncpdpId ? { ncpdpId } : "skip"
+  );
+}
+function usePatientPhoto(elationId, options) {
+  const photo = useQuery(
+    patientPhotoByIdRef,
+    elationId !== void 0 ? { elationPatientId: elationId } : "skip"
+  );
+  useEffect(() => {
+    if (options == null ? void 0 : options.skipRefresh) return;
+    if (elationId === void 0) return;
+    const apiBaseUrl = options == null ? void 0 : options.apiBaseUrl;
+    const apiKey = options == null ? void 0 : options.apiKey;
+    if (!apiBaseUrl || !apiKey) return;
+    const controller = new AbortController();
+    void fetch(`${apiBaseUrl}/api/patients/photo/refresh`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": apiKey
+      },
+      body: JSON.stringify({ elationId }),
+      signal: controller.signal
+    }).catch(() => {
+    });
+    return () => controller.abort();
+  }, [elationId, options == null ? void 0 : options.apiBaseUrl, options == null ? void 0 : options.apiKey, options == null ? void 0 : options.skipRefresh]);
+  return photo;
+}
+var messagesByPhonesRef = makeFunctionReference("conversationMessages:getByPhones");
+var messagesByConversationIdRef = makeFunctionReference("conversationMessages:getByConversationId");
+function useConversationMessages(input, options) {
+  const hasPair = !!input.phoneA && !!input.phoneB;
+  const byPair = useQuery(
+    messagesByPhonesRef,
+    hasPair ? {
+      phoneA: input.phoneA,
+      phoneB: input.phoneB,
+      limit: options == null ? void 0 : options.limit
+    } : "skip"
+  );
+  const byConvo = useQuery(
+    messagesByConversationIdRef,
+    !hasPair && input.conversationId ? { conversationId: input.conversationId, limit: options == null ? void 0 : options.limit } : "skip"
+  );
+  return hasPair ? byPair : byConvo;
+}
 
 // src/react/provider.ts
 import { ConvexProvider, ConvexReactClient } from "convex/react";
@@ -385,11 +489,15 @@ export {
   useAppointment,
   useAppointmentByElationId,
   useAppointments,
+  useConversationMessages,
   usePatient,
+  usePatientBasic,
   usePatientByElationId,
   usePatientByHintId,
   usePatientMedical,
+  usePatientPhoto,
   usePatients,
+  usePharmacyByNcpdpId,
   usePhysicianByElationId,
   usePhysiciansByElationIds,
   useTruth

package/dist/react.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react/hooks.ts","../src/react/provider.ts","../src/react/tracking.ts","../src/tracking/tracker.ts"],"sourcesContent":["/**\n * React hooks for Truth SDK — real-time Convex-backed data access.\n *\n * These hooks use Convex React subscriptions for live-updating data.\n * Must be used within a ConvexProvider (see TruthProvider).\n *\n * @example\n * ```tsx\n * import { usePatients, useAppointments } from '@hipnation-truth/sdk/react';\n *\n * function PatientList() {\n *   const patients = usePatients({ limit: 20 });\n *   return patients?.map(p => <div key={p._id}>{p.firstName} {p.lastName}</div>);\n * }\n * ```\n */\n\n\"use client\";\n\nimport { useQuery } from \"convex/react\";\nimport { useEffect } from \"react\";\n\n// ---------------------------------------------------------------------------\n// Convex function references\n// ---------------------------------------------------------------------------\n// We use string-based references to avoid importing the generated API\n// (which lives in the consuming app, not the SDK). Convex supports this\n// via the `api` module pattern, but for a published SDK we use\n// makeFunctionReference to stay decoupled from the app's codegen.\n\nimport type { FunctionReference } from \"convex/server\";\nimport { makeFunctionReference } from \"convex/server\";\n\n// Patient query references\nconst patientsListRef = makeFunctionReference<\n  \"query\",\n  {\n    search?: string;\n    lastName?: string;\n    cursor?: string;\n    limit?: number;\n  },\n  unknown[]\n>(\"patients:list\");\n\nconst patientsGetRef = makeFunctionReference<\n  \"query\",\n  { id: string },\n  unknown | null\n>(\"patients:get\");\n\nconst patientsByElationIdRef = makeFunctionReference<\n  \"query\",\n  { elationId: string },\n  unknown | null\n>(\"patients:getByElationId\");\n\nconst patientsByHintIdRef = makeFunctionReference<\n  \"query\",\n  { hintId: string },\n  unknown | null\n>(\"patients:getByHintId\");\n\n// Appointment query references\nconst appointmentsListRef = makeFunctionReference<\n  \"query\",\n  {\n    patientId?: string;\n    status?: string;\n    startDate?: string;\n    endDate?: string;\n    limit?: number;\n  },\n  unknown[]\n>(\"appointments:list\");\n\nconst appointmentsGetRef = makeFunctionReference<\n  \"query\",\n  { id: string },\n  unknown | null\n>(\"appointments:get\");\n\nconst appointmentsByElationIdRef = makeFunctionReference<\n  \"query\",\n  { elationId: string },\n  unknown | null\n>(\"appointments:getByElationId\");\n\n// ---------------------------------------------------------------------------\n// Patient hooks\n// ---------------------------------------------------------------------------\n\ninterface UsePatientListOptions {\n  search?: string;\n  lastName?: string;\n  limit?: number;\n}\n\n/**\n * Subscribe to a list of patients with optional search and filtering.\n * Returns undefined while loading, then an array of patients.\n */\nfunction usePatients(options?: UsePatientListOptions) {\n  return useQuery(patientsListRef as FunctionReference<\"query\">, options ?? {});\n}\n\n/**\n * Subscribe to a single patient by Convex document ID.\n */\nfunction usePatient(id: string) {\n  return useQuery(patientsGetRef as FunctionReference<\"query\">, { id });\n}\n\n/**\n * Subscribe to a patient by their Elation ID.\n */\nfunction usePatientByElationId(elationId: string) {\n  return useQuery(patientsByElationIdRef as FunctionReference<\"query\">, {\n    elationId,\n  });\n}\n\n/**\n * Subscribe to a patient by their Hint ID.\n */\nfunction usePatientByHintId(hintId: string) {\n  return useQuery(patientsByHintIdRef as FunctionReference<\"query\">, {\n    hintId,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Appointment hooks\n// ---------------------------------------------------------------------------\n\ninterface UseAppointmentListOptions {\n  patientId?: string;\n  status?: string;\n  startDate?: string;\n  endDate?: string;\n  limit?: number;\n}\n\n/**\n * Subscribe to a list of appointments with optional filtering.\n */\nfunction useAppointments(options?: UseAppointmentListOptions) {\n  return useQuery(\n    appointmentsListRef as FunctionReference<\"query\">,\n    options ?? {},\n  );\n}\n\n/**\n * Subscribe to a single appointment by Convex document ID.\n */\nfunction useAppointment(id: string) {\n  return useQuery(appointmentsGetRef as FunctionReference<\"query\">, { id });\n}\n\n/**\n * Subscribe to an appointment by its Elation ID.\n */\nfunction useAppointmentByElationId(elationId: string) {\n  return useQuery(appointmentsByElationIdRef as FunctionReference<\"query\">, {\n    elationId,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Physician hooks\n// ---------------------------------------------------------------------------\n\ninterface Physician {\n  _id: string;\n  elationId: number;\n  firstName?: string;\n  lastName?: string;\n  npi?: string;\n  credentials?: string;\n  specialties?: string[];\n  practice?: number;\n  email?: string;\n  phone?: string;\n  lastSyncedAt: string;\n}\n\nconst physiciansGetByElationIdsRef = makeFunctionReference<\n  \"query\",\n  { ids: number[] },\n  Physician[]\n>(\"physicians:getByElationIds\");\n\nconst physiciansGetByElationIdRef = makeFunctionReference<\n  \"query\",\n  { id: number },\n  Physician | null\n>(\"physicians:getByElationId\");\n\n/**\n * Resolve a batch of physicians by their Elation IDs. Returns an array\n * of physicians that exist in Convex; missing ids are silently dropped.\n *\n * Use this to resolve medication `prescribing_physician` / appointment\n * physician ids to display names, avoiding the per-physician HTTP\n * round-trip through Truth's Elation proxy.\n *\n * Pass `undefined` (or an empty array) to skip the query — the hook\n * returns `undefined` until you pass a populated list.\n */\nfunction usePhysiciansByElationIds(ids: number[] | undefined) {\n  return useQuery(\n    physiciansGetByElationIdsRef as FunctionReference<\"query\">,\n    ids && ids.length > 0 ? { ids } : \"skip\",\n  );\n}\n\n/**\n * Subscribe to a single physician by their Elation ID.\n */\nfunction usePhysicianByElationId(id: number | undefined) {\n  return useQuery(\n    physiciansGetByElationIdRef as FunctionReference<\"query\">,\n    id !== undefined ? { id } : \"skip\",\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Patient medical hooks (medications, problems, allergies, appointments)\n// ---------------------------------------------------------------------------\n\nconst medicationsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getMedicationsByElationPatient\");\n\nconst problemsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getProblemsByElationPatient\");\n\nconst allergiesByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getAllergiesByElationPatient\");\n\nconst appointmentsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getAppointmentsByElationPatient\");\n\ninterface UsePatientMedicalOptions {\n  /**\n   * Base URL of the Truth API. Required to trigger the background refresh\n   * (e.g. `https://app.truth.communication-hub.com`). If omitted, the hook\n   * only reads from Convex and does not refresh.\n   */\n  apiBaseUrl?: string;\n  /** API key used for the refresh call. */\n  apiKey?: string;\n  /**\n   * If true, suppress the background refresh. Useful when you know the\n   * data was just refreshed by another component on the page.\n   */\n  skipRefresh?: boolean;\n}\n\n/**\n * Composite hook that returns a patient's medical records — medications,\n * problems, allergies, appointments — from the Convex cache.\n *\n * On mount (and when `elationId` changes) fires a background refresh\n * against Truth's `/api/patients/medical/refresh` endpoint so stale data\n * is pulled in without blocking render. Returns cached data immediately;\n * Convex subscription updates the UI when refresh completes.\n */\nfunction usePatientMedical(\n  elationId: number | undefined,\n  options?: UsePatientMedicalOptions,\n) {\n  const medications = useQuery(\n    medicationsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const problems = useQuery(\n    problemsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const allergies = useQuery(\n    allergiesByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const appointments = useQuery(\n    appointmentsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  useEffect(() => {\n    if (elationId === undefined || options?.skipRefresh) {\n      return;\n    }\n    const apiBaseUrl = options?.apiBaseUrl;\n    const apiKey = options?.apiKey;\n    if (!apiBaseUrl || !apiKey) {\n      return;\n    }\n\n    const controller = new AbortController();\n    void fetch(`${apiBaseUrl}/api/patients/medical/refresh`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-API-Key\": apiKey,\n      },\n      body: JSON.stringify({ elationId }),\n      signal: controller.signal,\n    }).catch(() => {\n      /* background refresh — failures are non-fatal */\n    });\n\n    return () => controller.abort();\n  }, [elationId, options?.apiBaseUrl, options?.apiKey, options?.skipRefresh]);\n\n  return { medications, problems, allergies, appointments };\n}\n\nexport {\n  usePatients,\n  usePatient,\n  usePatientByElationId,\n  usePatientByHintId,\n  useAppointments,\n  useAppointment,\n  useAppointmentByElationId,\n  usePhysiciansByElationIds,\n  usePhysicianByElationId,\n  usePatientMedical,\n};\nexport type {\n  UsePatientListOptions,\n  UseAppointmentListOptions,\n  UsePatientMedicalOptions,\n  Physician,\n};\n","/**\n * TruthProvider — Convex React provider pre-configured for Truth.\n *\n * Wraps children in a ConvexProvider connected to the correct\n * Truth Convex deployment for the given environment.\n *\n * @example\n * ```tsx\n * import { TruthProvider } from '@hipnation-truth/sdk/react';\n *\n * function App() {\n *   return (\n *     <TruthProvider environment=\"sandbox\">\n *       <MyApp />\n *     </TruthProvider>\n *   );\n * }\n * ```\n */\n\n\"use client\";\n\nimport { ConvexProvider, ConvexReactClient } from \"convex/react\";\nimport type { ReactNode } from \"react\";\nimport { createElement, useMemo } from \"react\";\n\n// Mirrors CONVEX_URLS in client.ts. UAT shares prod resources.\nconst CONVEX_URLS: Record<string, string> = {\n  local: \"https://courteous-duck-623.convex.cloud\",\n  staging: \"https://courteous-duck-623.convex.cloud\",\n  stg: \"https://courteous-duck-623.convex.cloud\",\n  sandbox: \"https://courteous-duck-623.convex.cloud\",\n  uat: \"https://gallant-gecko-217.convex.cloud\",\n  production: \"https://gallant-gecko-217.convex.cloud\",\n};\n\ninterface TruthProviderProps {\n  /** Truth environment — determines which Convex deployment to connect to */\n  environment?: string;\n  /** Override the Convex URL directly */\n  convexUrl?: string;\n  children: ReactNode;\n}\n\nfunction TruthProvider({\n  environment = \"sandbox\",\n  convexUrl,\n  children,\n}: TruthProviderProps) {\n  const url = convexUrl ?? CONVEX_URLS[environment] ?? CONVEX_URLS.sandbox;\n\n  const client = useMemo(() => new ConvexReactClient(url), [url]);\n\n  return createElement(ConvexProvider, { client }, children);\n}\n\nexport { TruthProvider };\nexport type { TruthProviderProps };\n","/**\n * React tracking hook — fire-and-forget event tracking from client components.\n *\n * Creates a lightweight Tracker instance scoped to the browser session\n * and exposes a useTrack() hook for emitting events to Truth's Kinesis stream.\n *\n * @example\n * ```tsx\n * import { useTruth } from '@hipnation-truth/sdk/react';\n *\n * function ConversationView({ conversationId }) {\n *   const truth = useTruth();\n *\n *   useEffect(() => {\n *     truth.track('conversation.marked_read.v1', {\n *       read_by_actor_id: userId,\n *       unread_count_before: 5,\n *       unread_count_after: 0,\n *     }, { subject: { conversation_id: conversationId } });\n *   }, [conversationId]);\n * }\n * ```\n */\n\n\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport { createContext, createElement, useContext, useMemo } from \"react\";\nimport type {\n  EventPayloadMap,\n  EventType,\n  TrackOptions,\n} from \"../tracking/events\";\nimport { Tracker } from \"../tracking/tracker\";\nimport type { ActorContext } from \"../types/config\";\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\ninterface TruthTrackingContextValue {\n  track: <T extends EventType>(\n    eventType: T,\n    payload: EventPayloadMap[T],\n    options?: TrackOptions,\n  ) => void;\n  identify: (actorId: string, actorType: ActorContext[\"actorType\"]) => void;\n}\n\nconst TruthTrackingContext = createContext<TruthTrackingContextValue | null>(\n  null,\n);\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\ninterface TruthTrackingProviderProps {\n  /** Truth environment — determines API URL for event delivery */\n  environment?: string;\n  /** Event source identifier */\n  source?: string;\n  /** Source version (git SHA) */\n  sourceVersion?: string;\n  /** Default tenant ID */\n  tenantId?: string;\n  /** API key for authentication */\n  apiKey?: string;\n  children: ReactNode;\n}\n\nfunction TruthTrackingProvider({\n  environment = \"sandbox\",\n  source = \"communication-hub.frontend\",\n  sourceVersion = \"unknown\",\n  tenantId = \"hipnation\",\n  apiKey = \"\",\n  children,\n}: TruthTrackingProviderProps) {\n  const value = useMemo<TruthTrackingContextValue>(() => {\n    const tracker = new Tracker({\n      apiKey,\n      environment,\n      source,\n      sourceVersion,\n      tenantId,\n      batchSize: 10,\n      flushIntervalMs: 5000,\n    });\n\n    return {\n      track: (eventType, payload, options) => {\n        tracker.track(eventType, payload, options);\n      },\n      identify: (actorId, actorType) => {\n        tracker.setActor({ actorId, actorType });\n      },\n    };\n  }, [apiKey, environment, source, sourceVersion, tenantId]);\n\n  return createElement(TruthTrackingContext.Provider, { value }, children);\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\n/**\n * Access the Truth tracking context. Must be within a TruthTrackingProvider.\n * Returns `{ track, identify }` for emitting events to Kinesis.\n */\nfunction useTruth(): TruthTrackingContextValue {\n  const ctx = useContext(TruthTrackingContext);\n  if (!ctx) {\n    throw new Error(\"useTruth must be used within a TruthTrackingProvider\");\n  }\n  return ctx;\n}\n\nexport { TruthTrackingProvider, useTruth };\nexport type { TruthTrackingProviderProps, TruthTrackingContextValue };\n","/**\n * Event tracker with batching, retry, and flush support.\n *\n * Buffers events in an internal queue and flushes them to the Truth API\n * endpoint. Flushes occur when the buffer reaches `batchSize` or every\n * `flushIntervalMs` milliseconds, whichever comes first.\n */\n\nimport type { ActorContext } from \"../types/config\";\nimport type {\n  EventEnvelope,\n  EventPayloadMap,\n  EventType,\n  TrackOptions,\n} from \"./events\";\n\n// ---------------------------------------------------------------------------\n// UUID v7 helper (no external dependency)\n// ---------------------------------------------------------------------------\n\n/**\n * Generates a UUID v7 string. Uses crypto.randomUUID where available,\n * falling back to a timestamp + random bytes implementation.\n *\n * UUID v7 layout (RFC 9562):\n *   48 bits - unix timestamp (ms)\n *   4 bits  - version (0b0111)\n *   12 bits - random\n *   2 bits  - variant (0b10)\n *   62 bits - random\n */\nfunction generateUuidV7(): string {\n  const now = Date.now();\n\n  // 6 bytes of timestamp\n  const timeBytes = new Uint8Array(6);\n  let ts = now;\n  for (let i = 5; i >= 0; i--) {\n    timeBytes[i] = ts & 0xff;\n    ts = Math.floor(ts / 256);\n  }\n\n  // 10 bytes of random\n  const randomBytes = new Uint8Array(10);\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    globalThis.crypto.getRandomValues\n  ) {\n    globalThis.crypto.getRandomValues(randomBytes);\n  } else {\n    for (let i = 0; i < 10; i++) {\n      randomBytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n\n  // Assemble 16 bytes\n  const bytes = new Uint8Array(16);\n  bytes.set(timeBytes, 0);\n  bytes.set(randomBytes, 6);\n\n  // Set version (bits 48-51 to 0b0111)\n  bytes[6] = (bytes[6] & 0x0f) | 0x70;\n\n  // Set variant (bits 64-65 to 0b10)\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n  // Format as hex string with dashes\n  const hex = Array.from(bytes)\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20, 32),\n  ].join(\"-\");\n}\n\n// ---------------------------------------------------------------------------\n// Environment-based API URL resolution\n// ---------------------------------------------------------------------------\n\n// Environment → Truth API base URL.\n//\n// Topology:\n//   local / staging / stg / sandbox → sandbox Truth (app.sandbox.*)\n//   uat / production                → production Truth (app.truth.*)\n//\n// UAT shares production resources (same Fly Postgres + Hasura + Truth +\n// Convex + EHR tokens as prod). Staging is the isolated sandbox env.\nconst API_URLS: Record<string, string> = {\n  local: \"http://localhost:3000\",\n  staging: \"https://app.sandbox.communication-hub.com\",\n  stg: \"https://app.sandbox.communication-hub.com\",\n  sandbox: \"https://app.sandbox.communication-hub.com\",\n  uat: \"https://app.truth.communication-hub.com\",\n  production: \"https://app.truth.communication-hub.com\",\n};\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_BATCH_SIZE = 25;\nconst DEFAULT_FLUSH_INTERVAL_MS = 5_000;\nconst MAX_RETRIES = 3;\nconst BASE_RETRY_DELAY_MS = 500;\n\n// ---------------------------------------------------------------------------\n// Tracker configuration\n// ---------------------------------------------------------------------------\n\ninterface TrackerConfig {\n  apiKey: string;\n  environment: string;\n  source: string;\n  sourceVersion: string;\n  tenantId: string;\n  batchSize: number;\n  flushIntervalMs: number;\n  apiBaseUrl?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Tracker class\n// ---------------------------------------------------------------------------\n\nclass Tracker {\n  private readonly config: TrackerConfig;\n  readonly apiUrl: string;\n  private queue: EventEnvelope[] = [];\n  private flushTimer: ReturnType<typeof setInterval> | null = null;\n  private defaultActor: ActorContext | undefined;\n  private isFlushing = false;\n  private isShutdown = false;\n\n  constructor(config: TrackerConfig) {\n    this.config = config;\n    this.apiUrl =\n      config.apiBaseUrl ?? API_URLS[config.environment] ?? API_URLS.local;\n\n    this.startFlushInterval();\n    this.registerShutdownHooks();\n  }\n\n  /**\n   * Set the default actor context for subsequent events.\n   */\n  setActor(actor: ActorContext): void {\n    this.defaultActor = actor;\n  }\n\n  /**\n   * Enqueue a typed event for delivery. This is fire-and-forget from\n   * the caller's perspective -- events are buffered and flushed in batches.\n   */\n  track<T extends EventType>(\n    eventType: T,\n    payload: EventPayloadMap[T],\n    options?: TrackOptions,\n  ): void {\n    if (this.isShutdown) {\n      return;\n    }\n\n    const now = new Date().toISOString();\n\n    const envelope: EventEnvelope = {\n      event_id: generateUuidV7(),\n      event_type: eventType,\n      schema_version: 1,\n      occurred_at: options?.occurredAt ?? now,\n      received_at: now,\n      source: this.config.source,\n      source_version: this.config.sourceVersion,\n      tenant_id: options?.tenantId ?? this.config.tenantId,\n      actor:\n        options?.actor ??\n        (this.defaultActor\n          ? {\n              actor_id: this.defaultActor.actorId,\n              actor_type: this.defaultActor.actorType,\n            }\n          : undefined),\n      subject: options?.subject,\n      compliance: options?.compliance,\n      payload: payload as unknown as Record<string, unknown>,\n    };\n\n    this.queue.push(envelope);\n\n    if (this.queue.length >= this.config.batchSize) {\n      void this.flush();\n    }\n  }\n\n  /**\n   * Force an immediate flush of all buffered events.\n   * Returns a promise that resolves when the flush completes.\n   */\n  async flush(): Promise<void> {\n    if (this.queue.length === 0 || this.isFlushing) {\n      return;\n    }\n\n    this.isFlushing = true;\n    const batch = this.queue.splice(0, this.config.batchSize);\n\n    try {\n      await this.sendBatch(batch);\n    } catch {\n      // Re-queue events that failed to send (prepend to maintain ordering)\n      this.queue.unshift(...batch);\n    } finally {\n      this.isFlushing = false;\n    }\n\n    // If there are still events in the queue, flush again\n    if (this.queue.length >= this.config.batchSize) {\n      await this.flush();\n    }\n  }\n\n  /**\n   * Gracefully shut down the tracker. Flushes remaining events and\n   * clears the flush interval.\n   */\n  async shutdown(): Promise<void> {\n    this.isShutdown = true;\n    this.stopFlushInterval();\n    await this.flush();\n  }\n\n  /**\n   * Send a batch of events to the Truth API with exponential backoff retry.\n   */\n  private async sendBatch(batch: EventEnvelope[]): Promise<void> {\n    let lastError: unknown;\n\n    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {\n      try {\n        const response = await fetch(`${this.apiUrl}/api/events/ingest`, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n            \"X-API-Key\": this.config.apiKey,\n          },\n          body: JSON.stringify({ events: batch }),\n        });\n\n        if (response.ok) {\n          return;\n        }\n\n        // Don't retry 4xx client errors (except 429)\n        if (\n          response.status >= 400 &&\n          response.status < 500 &&\n          response.status !== 429\n        ) {\n          return;\n        }\n\n        lastError = new Error(\n          `HTTP ${response.status}: ${response.statusText}`,\n        );\n      } catch (error) {\n        lastError = error;\n      }\n\n      // Exponential backoff with jitter\n      if (attempt < MAX_RETRIES) {\n        const delay = BASE_RETRY_DELAY_MS * 2 ** attempt;\n        const jitter = Math.random() * delay * 0.5;\n        await sleep(delay + jitter);\n      }\n    }\n\n    throw lastError;\n  }\n\n  private startFlushInterval(): void {\n    if (this.config.flushIntervalMs > 0) {\n      this.flushTimer = setInterval(() => {\n        void this.flush();\n      }, this.config.flushIntervalMs);\n\n      // Unref the timer so it doesn't prevent Node.js from exiting\n      if (typeof this.flushTimer === \"object\" && \"unref\" in this.flushTimer) {\n        this.flushTimer.unref();\n      }\n    }\n  }\n\n  private stopFlushInterval(): void {\n    if (this.flushTimer !== null) {\n      clearInterval(this.flushTimer);\n      this.flushTimer = null;\n    }\n  }\n\n  private registerShutdownHooks(): void {\n    // Only register in Node.js environments\n    if (typeof globalThis.process !== \"undefined\" && globalThis.process.on) {\n      const shutdownHandler = () => {\n        void this.shutdown();\n      };\n\n      globalThis.process.on(\"beforeExit\", shutdownHandler);\n      globalThis.process.on(\"SIGTERM\", shutdownHandler);\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport {\n  Tracker,\n  generateUuidV7,\n  DEFAULT_BATCH_SIZE,\n  DEFAULT_FLUSH_INTERVAL_MS,\n};\nexport type { TrackerConfig };\n"],"mappings":"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","names":["createElement","useMemo","useMemo","createElement"]}
+{"version":3,"sources":["../src/react/hooks.ts","../src/react/provider.ts","../src/react/tracking.ts","../src/tracking/tracker.ts"],"sourcesContent":["/**\n * React hooks for Truth SDK — real-time Convex-backed data access.\n *\n * These hooks use Convex React subscriptions for live-updating data.\n * Must be used within a ConvexProvider (see TruthProvider).\n *\n * @example\n * ```tsx\n * import { usePatients, useAppointments } from '@hipnation-truth/sdk/react';\n *\n * function PatientList() {\n *   const patients = usePatients({ limit: 20 });\n *   return patients?.map(p => <div key={p._id}>{p.firstName} {p.lastName}</div>);\n * }\n * ```\n */\n\n\"use client\";\n\nimport { useQuery } from \"convex/react\";\nimport { useEffect } from \"react\";\n\n// ---------------------------------------------------------------------------\n// Convex function references\n// ---------------------------------------------------------------------------\n// We use string-based references to avoid importing the generated API\n// (which lives in the consuming app, not the SDK). Convex supports this\n// via the `api` module pattern, but for a published SDK we use\n// makeFunctionReference to stay decoupled from the app's codegen.\n\nimport type { FunctionReference } from \"convex/server\";\nimport { makeFunctionReference } from \"convex/server\";\n\n// Patient query references\nconst patientsListRef = makeFunctionReference<\n  \"query\",\n  {\n    search?: string;\n    lastName?: string;\n    cursor?: string;\n    limit?: number;\n  },\n  unknown[]\n>(\"patients:list\");\n\nconst patientsGetRef = makeFunctionReference<\n  \"query\",\n  { id: string },\n  unknown | null\n>(\"patients:get\");\n\nconst patientsByElationIdRef = makeFunctionReference<\n  \"query\",\n  { elationId: string },\n  unknown | null\n>(\"patients:getByElationId\");\n\nconst patientsByHintIdRef = makeFunctionReference<\n  \"query\",\n  { hintId: string },\n  unknown | null\n>(\"patients:getByHintId\");\n\n// Appointment query references\nconst appointmentsListRef = makeFunctionReference<\n  \"query\",\n  {\n    patientId?: string;\n    status?: string;\n    startDate?: string;\n    endDate?: string;\n    limit?: number;\n  },\n  unknown[]\n>(\"appointments:list\");\n\nconst appointmentsGetRef = makeFunctionReference<\n  \"query\",\n  { id: string },\n  unknown | null\n>(\"appointments:get\");\n\nconst appointmentsByElationIdRef = makeFunctionReference<\n  \"query\",\n  { elationId: string },\n  unknown | null\n>(\"appointments:getByElationId\");\n\n// ---------------------------------------------------------------------------\n// Patient hooks\n// ---------------------------------------------------------------------------\n\ninterface UsePatientListOptions {\n  search?: string;\n  lastName?: string;\n  limit?: number;\n}\n\n/**\n * Subscribe to a list of patients with optional search and filtering.\n * Returns undefined while loading, then an array of patients.\n */\nfunction usePatients(options?: UsePatientListOptions) {\n  return useQuery(patientsListRef as FunctionReference<\"query\">, options ?? {});\n}\n\n/**\n * Subscribe to a single patient by Convex document ID.\n */\nfunction usePatient(id: string) {\n  return useQuery(patientsGetRef as FunctionReference<\"query\">, { id });\n}\n\n/**\n * Subscribe to a patient by their Elation ID.\n */\nfunction usePatientByElationId(elationId: string) {\n  return useQuery(patientsByElationIdRef as FunctionReference<\"query\">, {\n    elationId,\n  });\n}\n\n/**\n * Subscribe to a patient by their Hint ID.\n */\nfunction usePatientByHintId(hintId: string) {\n  return useQuery(patientsByHintIdRef as FunctionReference<\"query\">, {\n    hintId,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Appointment hooks\n// ---------------------------------------------------------------------------\n\ninterface UseAppointmentListOptions {\n  patientId?: string;\n  status?: string;\n  startDate?: string;\n  endDate?: string;\n  limit?: number;\n}\n\n/**\n * Subscribe to a list of appointments with optional filtering.\n */\nfunction useAppointments(options?: UseAppointmentListOptions) {\n  return useQuery(\n    appointmentsListRef as FunctionReference<\"query\">,\n    options ?? {},\n  );\n}\n\n/**\n * Subscribe to a single appointment by Convex document ID.\n */\nfunction useAppointment(id: string) {\n  return useQuery(appointmentsGetRef as FunctionReference<\"query\">, { id });\n}\n\n/**\n * Subscribe to an appointment by its Elation ID.\n */\nfunction useAppointmentByElationId(elationId: string) {\n  return useQuery(appointmentsByElationIdRef as FunctionReference<\"query\">, {\n    elationId,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Physician hooks\n// ---------------------------------------------------------------------------\n\ninterface Physician {\n  _id: string;\n  elationId: number;\n  firstName?: string;\n  lastName?: string;\n  npi?: string;\n  credentials?: string;\n  specialties?: string[];\n  practice?: number;\n  email?: string;\n  phone?: string;\n  lastSyncedAt: string;\n}\n\nconst physiciansGetByElationIdsRef = makeFunctionReference<\n  \"query\",\n  { ids: number[] },\n  Physician[]\n>(\"physicians:getByElationIds\");\n\nconst physiciansGetByElationIdRef = makeFunctionReference<\n  \"query\",\n  { id: number },\n  Physician | null\n>(\"physicians:getByElationId\");\n\n/**\n * Resolve a batch of physicians by their Elation IDs. Returns an array\n * of physicians that exist in Convex; missing ids are silently dropped.\n *\n * Use this to resolve medication `prescribing_physician` / appointment\n * physician ids to display names, avoiding the per-physician HTTP\n * round-trip through Truth's Elation proxy.\n *\n * Pass `undefined` (or an empty array) to skip the query — the hook\n * returns `undefined` until you pass a populated list.\n */\nfunction usePhysiciansByElationIds(ids: number[] | undefined) {\n  return useQuery(\n    physiciansGetByElationIdsRef as FunctionReference<\"query\">,\n    ids && ids.length > 0 ? { ids } : \"skip\",\n  );\n}\n\n/**\n * Subscribe to a single physician by their Elation ID.\n */\nfunction usePhysicianByElationId(id: number | undefined) {\n  return useQuery(\n    physiciansGetByElationIdRef as FunctionReference<\"query\">,\n    id !== undefined ? { id } : \"skip\",\n  );\n}\n\n// ---------------------------------------------------------------------------\n// Patient medical hooks (medications, problems, allergies, appointments)\n// ---------------------------------------------------------------------------\n\nconst medicationsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getMedicationsByElationPatient\");\n\nconst problemsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getProblemsByElationPatient\");\n\nconst allergiesByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getAllergiesByElationPatient\");\n\nconst appointmentsByPatientRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown[]\n>(\"medicalRecords:getAppointmentsByElationPatient\");\n\ninterface UsePatientMedicalOptions {\n  /**\n   * Base URL of the Truth API. Required to trigger the background refresh\n   * (e.g. `https://app.truth.communication-hub.com`). If omitted, the hook\n   * only reads from Convex and does not refresh.\n   */\n  apiBaseUrl?: string;\n  /** API key used for the refresh call. */\n  apiKey?: string;\n  /**\n   * If true, suppress the background refresh. Useful when you know the\n   * data was just refreshed by another component on the page.\n   */\n  skipRefresh?: boolean;\n}\n\n/**\n * Composite hook that returns a patient's medical records — medications,\n * problems, allergies, appointments — from the Convex cache.\n *\n * On mount (and when `elationId` changes) fires a background refresh\n * against Truth's `/api/patients/medical/refresh` endpoint so stale data\n * is pulled in without blocking render. Returns cached data immediately;\n * Convex subscription updates the UI when refresh completes.\n */\nfunction usePatientMedical(\n  elationId: number | undefined,\n  options?: UsePatientMedicalOptions,\n) {\n  const medications = useQuery(\n    medicationsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const problems = useQuery(\n    problemsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const allergies = useQuery(\n    allergiesByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  const appointments = useQuery(\n    appointmentsByPatientRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  ) as unknown[] | undefined;\n\n  useEffect(() => {\n    if (elationId === undefined || options?.skipRefresh) {\n      return;\n    }\n    const apiBaseUrl = options?.apiBaseUrl;\n    const apiKey = options?.apiKey;\n    if (!apiBaseUrl || !apiKey) {\n      return;\n    }\n\n    const controller = new AbortController();\n    void fetch(`${apiBaseUrl}/api/patients/medical/refresh`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-API-Key\": apiKey,\n      },\n      body: JSON.stringify({ elationId }),\n      signal: controller.signal,\n    }).catch(() => {\n      /* background refresh — failures are non-fatal */\n    });\n\n    return () => controller.abort();\n  }, [elationId, options?.apiBaseUrl, options?.apiKey, options?.skipRefresh]);\n\n  return { medications, problems, allergies, appointments };\n}\n\n// ---------------------------------------------------------------------------\n// Patient basic hooks (Elation demographics + Hint memberships/account)\n// ---------------------------------------------------------------------------\n//\n// Replaces the CommHub `getPatientBasicDetails` Hasura Action. Reads\n// from Convex-cached rows (populated by the patients-backfill cron +\n// `/api/patients/basic/refresh` on-demand), falling back to an empty\n// state until the background refresh completes.\n\nconst elationPatientByIdRef = makeFunctionReference<\n  \"query\",\n  { elationId: number },\n  unknown | null\n>(\"elationPatients:getByElationId\");\n\nconst hintPatientByIdRef = makeFunctionReference<\n  \"query\",\n  { hintId: string },\n  unknown | null\n>(\"hintPatients:getByHintId\");\n\nconst pharmacyByNcpdpRef = makeFunctionReference<\n  \"query\",\n  { ncpdpId: string },\n  unknown | null\n>(\"elationPharmacies:getByNcpdpId\");\n\nconst patientPhotoByIdRef = makeFunctionReference<\n  \"query\",\n  { elationPatientId: number },\n  unknown | null\n>(\"elationPatientPhotos:getByElationPatientId\");\n\ninterface UsePatientBasicOptions {\n  /** Truth API base URL used for the background refresh. */\n  apiBaseUrl?: string;\n  /** API key for the refresh call. */\n  apiKey?: string;\n  /** Suppress the background refresh. */\n  skipRefresh?: boolean;\n}\n\ninterface UsePatientBasicResult {\n  /**\n   * Raw Elation patient payload (matches the shape Elation's\n   * `/patients/{id}` returns — `first_name`, `last_name`, `phones`, etc).\n   * Returns `undefined` while the cache miss is loading, `null` if the\n   * patient isn't in Convex yet (first-open-after-backfill).\n   */\n  elationPatient: Record<string, unknown> | null | undefined;\n  /**\n   * Raw Hint patient payload (matches the shape Hint's\n   * `/provider/patients/{id}` returns — `memberships`, `account`,\n   * `phones`, etc).\n   */\n  hintPatient: Record<string, unknown> | null | undefined;\n  /**\n   * The full Convex row for Elation (includes `elationId`, `lastSyncedAt`,\n   * `photoS3Key`, `preferredPharmacyNcpdpId`, etc). Use this when you\n   * need the structured/typed fields rather than the raw Elation payload.\n   */\n  elationRow: Record<string, unknown> | null | undefined;\n  /**\n   * The full Convex row for Hint. Similar relationship to `hintPatient`.\n   */\n  hintRow: Record<string, unknown> | null | undefined;\n  /** True while either cache miss is still pending. */\n  loading: boolean;\n}\n\n/**\n * Composite hook returning a patient's basic details — Hint demographics\n * + memberships + account, Elation demographics + clinical metadata —\n * from the Convex cache.\n *\n * On mount (and when inputs change) fires a background refresh against\n * `/api/patients/basic/refresh` so stale rows get pulled fresh without\n * blocking render. Returns cached data immediately; Convex subscription\n * updates the UI when refresh completes.\n */\nfunction usePatientBasic(\n  input: { hintId?: string; elationId?: number },\n  options?: UsePatientBasicOptions,\n): UsePatientBasicResult {\n  const elationRow = useQuery(\n    elationPatientByIdRef as FunctionReference<\"query\">,\n    input.elationId !== undefined ? { elationId: input.elationId } : \"skip\",\n  ) as Record<string, unknown> | null | undefined;\n\n  const hintRow = useQuery(\n    hintPatientByIdRef as FunctionReference<\"query\">,\n    input.hintId !== undefined ? { hintId: input.hintId } : \"skip\",\n  ) as Record<string, unknown> | null | undefined;\n\n  useEffect(() => {\n    if (options?.skipRefresh) return;\n    if (!input.hintId && input.elationId === undefined) return;\n    const apiBaseUrl = options?.apiBaseUrl;\n    const apiKey = options?.apiKey;\n    if (!apiBaseUrl || !apiKey) return;\n\n    const controller = new AbortController();\n    void fetch(`${apiBaseUrl}/api/patients/basic/refresh`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-API-Key\": apiKey,\n      },\n      body: JSON.stringify({\n        hintId: input.hintId,\n        elationId: input.elationId,\n      }),\n      signal: controller.signal,\n    }).catch(() => {\n      /* background refresh — failures are non-fatal */\n    });\n\n    return () => controller.abort();\n  }, [\n    input.hintId,\n    input.elationId,\n    options?.apiBaseUrl,\n    options?.apiKey,\n    options?.skipRefresh,\n  ]);\n\n  // Surface the raw payload under elationPatient/hintPatient so consumers\n  // can keep using the exact Elation/Hint field names (first_name,\n  // memberships, account.past_due_in_cents) with zero mapping.\n  const elationPatient =\n    elationRow === undefined\n      ? undefined\n      : elationRow === null\n        ? null\n        : ((elationRow.raw as Record<string, unknown>) ?? null);\n  const hintPatient =\n    hintRow === undefined\n      ? undefined\n      : hintRow === null\n        ? null\n        : ((hintRow.raw as Record<string, unknown>) ?? null);\n\n  const elationLoading =\n    input.elationId !== undefined && elationRow === undefined;\n  const hintLoading = input.hintId !== undefined && hintRow === undefined;\n\n  return {\n    elationPatient,\n    hintPatient,\n    elationRow,\n    hintRow,\n    loading: elationLoading || hintLoading,\n  };\n}\n\n/**\n * Read a shared pharmacy row by NCPDP id. Backs the pharmacy card in\n * the patient panel (from Elation's preferred_pharmacy reference).\n */\nfunction usePharmacyByNcpdpId(ncpdpId: string | undefined) {\n  return useQuery(\n    pharmacyByNcpdpRef as FunctionReference<\"query\">,\n    ncpdpId ? { ncpdpId } : \"skip\",\n  );\n}\n\ninterface UsePatientPhotoOptions {\n  apiBaseUrl?: string;\n  apiKey?: string;\n  skipRefresh?: boolean;\n}\n\n/**\n * Subscribe to a patient's profile photo (s3Key + metadata). The\n * consumer constructs a download URL via the Truth attachments resource\n * (signed S3 URL). Fires a background refresh to pull the latest photo\n * binary from Elation + upload to S3.\n */\nfunction usePatientPhoto(\n  elationId: number | undefined,\n  options?: UsePatientPhotoOptions,\n) {\n  const photo = useQuery(\n    patientPhotoByIdRef as FunctionReference<\"query\">,\n    elationId !== undefined ? { elationPatientId: elationId } : \"skip\",\n  );\n\n  useEffect(() => {\n    if (options?.skipRefresh) return;\n    if (elationId === undefined) return;\n    const apiBaseUrl = options?.apiBaseUrl;\n    const apiKey = options?.apiKey;\n    if (!apiBaseUrl || !apiKey) return;\n\n    const controller = new AbortController();\n    void fetch(`${apiBaseUrl}/api/patients/photo/refresh`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        \"X-API-Key\": apiKey,\n      },\n      body: JSON.stringify({ elationId }),\n      signal: controller.signal,\n    }).catch(() => {\n      /* non-fatal */\n    });\n\n    return () => controller.abort();\n  }, [elationId, options?.apiBaseUrl, options?.apiKey, options?.skipRefresh]);\n\n  return photo;\n}\n\n// ---------------------------------------------------------------------------\n// Conversation messages (Dialpad calls + SMS merged)\n// ---------------------------------------------------------------------------\n\ninterface ConversationMessage {\n  kind: \"call\" | \"sms\";\n  id: string;\n  providerId: string;\n  state: string | null;\n  direction: string | null;\n  fromNumber: string | null;\n  toNumber: string | null;\n  voicemailLink: string | null;\n  duration: number | null;\n  text: string | null;\n  mms: boolean;\n  mmsUrl: string | null;\n  messageStatus: string | null;\n  occurredAt: string;\n  conversationId: string | null;\n  patientId: string | null;\n}\n\nconst messagesByPhonesRef = makeFunctionReference<\n  \"query\",\n  { phoneA: string; phoneB: string; limit?: number },\n  ConversationMessage[]\n>(\"conversationMessages:getByPhones\");\n\nconst messagesByConversationIdRef = makeFunctionReference<\n  \"query\",\n  { conversationId: string; limit?: number },\n  ConversationMessage[]\n>(\"conversationMessages:getByConversationId\");\n\ninterface UseConversationMessagesOptions {\n  /** Max items to return (default 200). */\n  limit?: number;\n}\n\n/**\n * Subscribe to a conversation's calls + SMS merged chronologically.\n * Pass the patient phone + the provider phone — Truth computes a\n * normalized pair key server-side so formatting differences don't\n * matter.\n *\n * Returns `undefined` while loading, then `ConversationMessage[]`\n * sorted newest-first. Updates live as new webhook events land in\n * Convex via the kinesis consumer.\n */\nfunction useConversationMessages(\n  input: { phoneA?: string; phoneB?: string; conversationId?: string },\n  options?: UseConversationMessagesOptions,\n): ConversationMessage[] | undefined {\n  const hasPair = !!input.phoneA && !!input.phoneB;\n  const byPair = useQuery(\n    messagesByPhonesRef as FunctionReference<\"query\">,\n    hasPair\n      ? {\n          phoneA: input.phoneA as string,\n          phoneB: input.phoneB as string,\n          limit: options?.limit,\n        }\n      : \"skip\",\n  ) as ConversationMessage[] | undefined;\n\n  const byConvo = useQuery(\n    messagesByConversationIdRef as FunctionReference<\"query\">,\n    !hasPair && input.conversationId\n      ? { conversationId: input.conversationId, limit: options?.limit }\n      : \"skip\",\n  ) as ConversationMessage[] | undefined;\n\n  return hasPair ? byPair : byConvo;\n}\n\nexport {\n  usePatients,\n  usePatient,\n  usePatientByElationId,\n  usePatientByHintId,\n  useAppointments,\n  useAppointment,\n  useAppointmentByElationId,\n  usePhysiciansByElationIds,\n  usePhysicianByElationId,\n  usePatientMedical,\n  usePatientBasic,\n  usePharmacyByNcpdpId,\n  usePatientPhoto,\n  useConversationMessages,\n};\nexport type { ConversationMessage, UseConversationMessagesOptions };\nexport type {\n  UsePatientListOptions,\n  UseAppointmentListOptions,\n  UsePatientMedicalOptions,\n  UsePatientBasicOptions,\n  UsePatientBasicResult,\n  UsePatientPhotoOptions,\n  Physician,\n};\n","/**\n * TruthProvider — Convex React provider pre-configured for Truth.\n *\n * Wraps children in a ConvexProvider connected to the correct\n * Truth Convex deployment for the given environment.\n *\n * @example\n * ```tsx\n * import { TruthProvider } from '@hipnation-truth/sdk/react';\n *\n * function App() {\n *   return (\n *     <TruthProvider environment=\"sandbox\">\n *       <MyApp />\n *     </TruthProvider>\n *   );\n * }\n * ```\n */\n\n\"use client\";\n\nimport { ConvexProvider, ConvexReactClient } from \"convex/react\";\nimport type { ReactNode } from \"react\";\nimport { createElement, useMemo } from \"react\";\n\n// Mirrors CONVEX_URLS in client.ts. UAT shares prod resources.\nconst CONVEX_URLS: Record<string, string> = {\n  local: \"https://courteous-duck-623.convex.cloud\",\n  staging: \"https://courteous-duck-623.convex.cloud\",\n  stg: \"https://courteous-duck-623.convex.cloud\",\n  sandbox: \"https://courteous-duck-623.convex.cloud\",\n  uat: \"https://gallant-gecko-217.convex.cloud\",\n  production: \"https://gallant-gecko-217.convex.cloud\",\n};\n\ninterface TruthProviderProps {\n  /** Truth environment — determines which Convex deployment to connect to */\n  environment?: string;\n  /** Override the Convex URL directly */\n  convexUrl?: string;\n  children: ReactNode;\n}\n\nfunction TruthProvider({\n  environment = \"sandbox\",\n  convexUrl,\n  children,\n}: TruthProviderProps) {\n  const url = convexUrl ?? CONVEX_URLS[environment] ?? CONVEX_URLS.sandbox;\n\n  const client = useMemo(() => new ConvexReactClient(url), [url]);\n\n  return createElement(ConvexProvider, { client }, children);\n}\n\nexport { TruthProvider };\nexport type { TruthProviderProps };\n","/**\n * React tracking hook — fire-and-forget event tracking from client components.\n *\n * Creates a lightweight Tracker instance scoped to the browser session\n * and exposes a useTrack() hook for emitting events to Truth's Kinesis stream.\n *\n * @example\n * ```tsx\n * import { useTruth } from '@hipnation-truth/sdk/react';\n *\n * function ConversationView({ conversationId }) {\n *   const truth = useTruth();\n *\n *   useEffect(() => {\n *     truth.track('conversation.marked_read.v1', {\n *       read_by_actor_id: userId,\n *       unread_count_before: 5,\n *       unread_count_after: 0,\n *     }, { subject: { conversation_id: conversationId } });\n *   }, [conversationId]);\n * }\n * ```\n */\n\n\"use client\";\n\nimport type { ReactNode } from \"react\";\nimport { createContext, createElement, useContext, useMemo } from \"react\";\nimport type {\n  EventPayloadMap,\n  EventType,\n  TrackOptions,\n} from \"../tracking/events\";\nimport { Tracker } from \"../tracking/tracker\";\nimport type { ActorContext } from \"../types/config\";\n\n// ---------------------------------------------------------------------------\n// Context\n// ---------------------------------------------------------------------------\n\ninterface TruthTrackingContextValue {\n  track: <T extends EventType>(\n    eventType: T,\n    payload: EventPayloadMap[T],\n    options?: TrackOptions,\n  ) => void;\n  identify: (actorId: string, actorType: ActorContext[\"actorType\"]) => void;\n}\n\nconst TruthTrackingContext = createContext<TruthTrackingContextValue | null>(\n  null,\n);\n\n// ---------------------------------------------------------------------------\n// Provider\n// ---------------------------------------------------------------------------\n\ninterface TruthTrackingProviderProps {\n  /** Truth environment — determines API URL for event delivery */\n  environment?: string;\n  /** Event source identifier */\n  source?: string;\n  /** Source version (git SHA) */\n  sourceVersion?: string;\n  /** Default tenant ID */\n  tenantId?: string;\n  /** API key for authentication */\n  apiKey?: string;\n  children: ReactNode;\n}\n\nfunction TruthTrackingProvider({\n  environment = \"sandbox\",\n  source = \"communication-hub.frontend\",\n  sourceVersion = \"unknown\",\n  tenantId = \"hipnation\",\n  apiKey = \"\",\n  children,\n}: TruthTrackingProviderProps) {\n  const value = useMemo<TruthTrackingContextValue>(() => {\n    const tracker = new Tracker({\n      apiKey,\n      environment,\n      source,\n      sourceVersion,\n      tenantId,\n      batchSize: 10,\n      flushIntervalMs: 5000,\n    });\n\n    return {\n      track: (eventType, payload, options) => {\n        tracker.track(eventType, payload, options);\n      },\n      identify: (actorId, actorType) => {\n        tracker.setActor({ actorId, actorType });\n      },\n    };\n  }, [apiKey, environment, source, sourceVersion, tenantId]);\n\n  return createElement(TruthTrackingContext.Provider, { value }, children);\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\n/**\n * Access the Truth tracking context. Must be within a TruthTrackingProvider.\n * Returns `{ track, identify }` for emitting events to Kinesis.\n */\nfunction useTruth(): TruthTrackingContextValue {\n  const ctx = useContext(TruthTrackingContext);\n  if (!ctx) {\n    throw new Error(\"useTruth must be used within a TruthTrackingProvider\");\n  }\n  return ctx;\n}\n\nexport { TruthTrackingProvider, useTruth };\nexport type { TruthTrackingProviderProps, TruthTrackingContextValue };\n","/**\n * Event tracker with batching, retry, and flush support.\n *\n * Buffers events in an internal queue and flushes them to the Truth API\n * endpoint. Flushes occur when the buffer reaches `batchSize` or every\n * `flushIntervalMs` milliseconds, whichever comes first.\n */\n\nimport type { ActorContext } from \"../types/config\";\nimport type {\n  EventEnvelope,\n  EventPayloadMap,\n  EventType,\n  TrackOptions,\n} from \"./events\";\n\n// ---------------------------------------------------------------------------\n// UUID v7 helper (no external dependency)\n// ---------------------------------------------------------------------------\n\n/**\n * Generates a UUID v7 string. Uses crypto.randomUUID where available,\n * falling back to a timestamp + random bytes implementation.\n *\n * UUID v7 layout (RFC 9562):\n *   48 bits - unix timestamp (ms)\n *   4 bits  - version (0b0111)\n *   12 bits - random\n *   2 bits  - variant (0b10)\n *   62 bits - random\n */\nfunction generateUuidV7(): string {\n  const now = Date.now();\n\n  // 6 bytes of timestamp\n  const timeBytes = new Uint8Array(6);\n  let ts = now;\n  for (let i = 5; i >= 0; i--) {\n    timeBytes[i] = ts & 0xff;\n    ts = Math.floor(ts / 256);\n  }\n\n  // 10 bytes of random\n  const randomBytes = new Uint8Array(10);\n  if (\n    typeof globalThis.crypto !== \"undefined\" &&\n    globalThis.crypto.getRandomValues\n  ) {\n    globalThis.crypto.getRandomValues(randomBytes);\n  } else {\n    for (let i = 0; i < 10; i++) {\n      randomBytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n\n  // Assemble 16 bytes\n  const bytes = new Uint8Array(16);\n  bytes.set(timeBytes, 0);\n  bytes.set(randomBytes, 6);\n\n  // Set version (bits 48-51 to 0b0111)\n  bytes[6] = (bytes[6] & 0x0f) | 0x70;\n\n  // Set variant (bits 64-65 to 0b10)\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n\n  // Format as hex string with dashes\n  const hex = Array.from(bytes)\n    .map((b) => b.toString(16).padStart(2, \"0\"))\n    .join(\"\");\n\n  return [\n    hex.slice(0, 8),\n    hex.slice(8, 12),\n    hex.slice(12, 16),\n    hex.slice(16, 20),\n    hex.slice(20, 32),\n  ].join(\"-\");\n}\n\n// ---------------------------------------------------------------------------\n// Environment-based API URL resolution\n// ---------------------------------------------------------------------------\n\n// Environment → Truth API base URL.\n//\n// Topology:\n//   local / staging / stg / sandbox → sandbox Truth (app.sandbox.*)\n//   uat / production                → production Truth (app.truth.*)\n//\n// UAT shares production resources (same Fly Postgres + Hasura + Truth +\n// Convex + EHR tokens as prod). Staging is the isolated sandbox env.\nconst API_URLS: Record<string, string> = {\n  local: \"http://localhost:3000\",\n  staging: \"https://app.sandbox.communication-hub.com\",\n  stg: \"https://app.sandbox.communication-hub.com\",\n  sandbox: \"https://app.sandbox.communication-hub.com\",\n  uat: \"https://app.truth.communication-hub.com\",\n  production: \"https://app.truth.communication-hub.com\",\n};\n\n// ---------------------------------------------------------------------------\n// Constants\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_BATCH_SIZE = 25;\nconst DEFAULT_FLUSH_INTERVAL_MS = 5_000;\nconst MAX_RETRIES = 3;\nconst BASE_RETRY_DELAY_MS = 500;\n\n// ---------------------------------------------------------------------------\n// Tracker configuration\n// ---------------------------------------------------------------------------\n\ninterface TrackerConfig {\n  apiKey: string;\n  environment: string;\n  source: string;\n  sourceVersion: string;\n  tenantId: string;\n  batchSize: number;\n  flushIntervalMs: number;\n  apiBaseUrl?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Tracker class\n// ---------------------------------------------------------------------------\n\nclass Tracker {\n  private readonly config: TrackerConfig;\n  readonly apiUrl: string;\n  private queue: EventEnvelope[] = [];\n  private flushTimer: ReturnType<typeof setInterval> | null = null;\n  private defaultActor: ActorContext | undefined;\n  private isFlushing = false;\n  private isShutdown = false;\n\n  constructor(config: TrackerConfig) {\n    this.config = config;\n    this.apiUrl =\n      config.apiBaseUrl ?? API_URLS[config.environment] ?? API_URLS.local;\n\n    this.startFlushInterval();\n    this.registerShutdownHooks();\n  }\n\n  /**\n   * Set the default actor context for subsequent events.\n   */\n  setActor(actor: ActorContext): void {\n    this.defaultActor = actor;\n  }\n\n  /**\n   * Enqueue a typed event for delivery. This is fire-and-forget from\n   * the caller's perspective -- events are buffered and flushed in batches.\n   */\n  track<T extends EventType>(\n    eventType: T,\n    payload: EventPayloadMap[T],\n    options?: TrackOptions,\n  ): void {\n    if (this.isShutdown) {\n      return;\n    }\n\n    const now = new Date().toISOString();\n\n    const envelope: EventEnvelope = {\n      event_id: generateUuidV7(),\n      event_type: eventType,\n      schema_version: 1,\n      occurred_at: options?.occurredAt ?? now,\n      received_at: now,\n      source: this.config.source,\n      source_version: this.config.sourceVersion,\n      tenant_id: options?.tenantId ?? this.config.tenantId,\n      actor:\n        options?.actor ??\n        (this.defaultActor\n          ? {\n              actor_id: this.defaultActor.actorId,\n              actor_type: this.defaultActor.actorType,\n            }\n          : undefined),\n      subject: options?.subject,\n      compliance: options?.compliance,\n      payload: payload as unknown as Record<string, unknown>,\n    };\n\n    this.queue.push(envelope);\n\n    if (this.queue.length >= this.config.batchSize) {\n      void this.flush();\n    }\n  }\n\n  /**\n   * Force an immediate flush of all buffered events.\n   * Returns a promise that resolves when the flush completes.\n   */\n  async flush(): Promise<void> {\n    if (this.queue.length === 0 || this.isFlushing) {\n      return;\n    }\n\n    this.isFlushing = true;\n    const batch = this.queue.splice(0, this.config.batchSize);\n\n    try {\n      await this.sendBatch(batch);\n    } catch {\n      // Re-queue events that failed to send (prepend to maintain ordering)\n      this.queue.unshift(...batch);\n    } finally {\n      this.isFlushing = false;\n    }\n\n    // If there are still events in the queue, flush again\n    if (this.queue.length >= this.config.batchSize) {\n      await this.flush();\n    }\n  }\n\n  /**\n   * Gracefully shut down the tracker. Flushes remaining events and\n   * clears the flush interval.\n   */\n  async shutdown(): Promise<void> {\n    this.isShutdown = true;\n    this.stopFlushInterval();\n    await this.flush();\n  }\n\n  /**\n   * Send a batch of events to the Truth API with exponential backoff retry.\n   */\n  private async sendBatch(batch: EventEnvelope[]): Promise<void> {\n    let lastError: unknown;\n\n    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {\n      try {\n        const response = await fetch(`${this.apiUrl}/api/events/ingest`, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n            \"X-API-Key\": this.config.apiKey,\n          },\n          body: JSON.stringify({ events: batch }),\n        });\n\n        if (response.ok) {\n          return;\n        }\n\n        // Don't retry 4xx client errors (except 429)\n        if (\n          response.status >= 400 &&\n          response.status < 500 &&\n          response.status !== 429\n        ) {\n          return;\n        }\n\n        lastError = new Error(\n          `HTTP ${response.status}: ${response.statusText}`,\n        );\n      } catch (error) {\n        lastError = error;\n      }\n\n      // Exponential backoff with jitter\n      if (attempt < MAX_RETRIES) {\n        const delay = BASE_RETRY_DELAY_MS * 2 ** attempt;\n        const jitter = Math.random() * delay * 0.5;\n        await sleep(delay + jitter);\n      }\n    }\n\n    throw lastError;\n  }\n\n  private startFlushInterval(): void {\n    if (this.config.flushIntervalMs > 0) {\n      this.flushTimer = setInterval(() => {\n        void this.flush();\n      }, this.config.flushIntervalMs);\n\n      // Unref the timer so it doesn't prevent Node.js from exiting\n      if (typeof this.flushTimer === \"object\" && \"unref\" in this.flushTimer) {\n        this.flushTimer.unref();\n      }\n    }\n  }\n\n  private stopFlushInterval(): void {\n    if (this.flushTimer !== null) {\n      clearInterval(this.flushTimer);\n      this.flushTimer = null;\n    }\n  }\n\n  private registerShutdownHooks(): void {\n    // Only register in Node.js environments\n    if (typeof globalThis.process !== \"undefined\" && globalThis.process.on) {\n      const shutdownHandler = () => {\n        void this.shutdown();\n      };\n\n      globalThis.process.on(\"beforeExit\", shutdownHandler);\n      globalThis.process.on(\"SIGTERM\", shutdownHandler);\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nexport {\n  Tracker,\n  generateUuidV7,\n  DEFAULT_BATCH_SIZE,\n  DEFAULT_FLUSH_INTERVAL_MS,\n};\nexport type { TrackerConfig };\n"],"mappings":"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","names":["createElement","useMemo","useMemo","createElement"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hipnation-truth/sdk",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "HIPnation Truth Platform SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",