@everfur/sdk 0.12.1 → 0.14.0

package/dist/recordsAsk.d-C5CGSi3j.d.cts

@@ -0,0 +1,14 @@
+/** The entity a pill refers to: a BE-recognized `type` and `id`, plus compact display facts the host may pass on. */
+interface RecordsAskEntityRef {
+    readonly type: string;
+    readonly id: string;
+    readonly payload?: Readonly<Record<string, string | number | boolean>>;
+}
+interface RecordsAsk {
+    readonly prompt: string;
+    readonly entityRef: RecordsAskEntityRef;
+}
+/** The host seam every Ask pill calls; pills render only when a host supplies it. */
+type RecordsAskHandler = (prompt: string, entityRef: RecordsAskEntityRef) => void;
+
+export type { RecordsAskEntityRef as R, RecordsAskHandler as a, RecordsAsk as b };

package/dist/recordsAsk.d-C5CGSi3j.d.ts

@@ -0,0 +1,14 @@
+/** The entity a pill refers to: a BE-recognized `type` and `id`, plus compact display facts the host may pass on. */
+interface RecordsAskEntityRef {
+    readonly type: string;
+    readonly id: string;
+    readonly payload?: Readonly<Record<string, string | number | boolean>>;
+}
+interface RecordsAsk {
+    readonly prompt: string;
+    readonly entityRef: RecordsAskEntityRef;
+}
+/** The host seam every Ask pill calls; pills render only when a host supplies it. */
+type RecordsAskHandler = (prompt: string, entityRef: RecordsAskEntityRef) => void;
+
+export type { RecordsAskEntityRef as R, RecordsAskHandler as a, RecordsAsk as b };

package/dist/{requestFunnel-BYzlyaC0.d.ts → requestFunnel.d-D9edIEjZ.d.ts}

@@ -1,8 +1,8 @@
-import { b as EverfurErrorCode } from './EverfurError-DeBqRpQV.js';
-import { E as ErrorPolicyPort } from './ErrorPolicyPort-C3nNSS_j.js';
-import { E as EverfurResult } from './EverfurResult-ClPTS0P2.js';
-import { d as EverfurRequest, F as Frame } from './config-C5iPNKDj.js';
-import { A as AuthContext } from './identity-BqeaN8An.js';
+import { b as EverfurErrorCode } from './EverfurError.d-8NHtlgzA.js';
+import { E as ErrorPolicyPort } from './ErrorPolicyPort.d-68yrE3BE.js';
+import { E as EverfurResult } from './EverfurResult.d-D_-254ZY.js';
+import { d as EverfurRequest, F as Frame } from './config.d-MX7IKP2f.js';
+import { A as AuthContext } from './identity.d-BePPZ7Uv.js';
 
 /** Why the funnel stopped, or kept going. Every settle and every retry names one. */
 type FunnelRetryReason = 'ok' | 'aborted' | 'terminal-code' | 'attempts-exhausted' | 'daily-quota-exhausted' | 'burst-throttle' | 'retryable-code' | 'server-reset-beyond-budget';

package/dist/{requestFunnel-DLZpiFD3.d.cts → requestFunnel.d-RZex94XX.d.cts}

@@ -1,8 +1,8 @@
-import { b as EverfurErrorCode } from './EverfurError-DeBqRpQV.cjs';
-import { E as ErrorPolicyPort } from './ErrorPolicyPort-10s3HJCt.cjs';
-import { E as EverfurResult } from './EverfurResult-COlXj1wq.cjs';
-import { d as EverfurRequest, F as Frame } from './config-C9zhanL-.cjs';
-import { A as AuthContext } from './identity-gjurBi7m.cjs';
+import { b as EverfurErrorCode } from './EverfurError.d-8NHtlgzA.cjs';
+import { E as ErrorPolicyPort } from './ErrorPolicyPort.d-DirW9hgO.cjs';
+import { E as EverfurResult } from './EverfurResult.d-BFH-3s6E.cjs';
+import { d as EverfurRequest, F as Frame } from './config.d-DJ4mvf_w.cjs';
+import { A as AuthContext } from './identity.d-CJfnWOdH.cjs';
 
 /** Why the funnel stopped, or kept going. Every settle and every retry names one. */
 type FunnelRetryReason = 'ok' | 'aborted' | 'terminal-code' | 'attempts-exhausted' | 'daily-quota-exhausted' | 'burst-throttle' | 'retryable-code' | 'server-reset-beyond-budget';

package/dist/{resolve-D4Ywz5OS.d.ts → resolve.d-CoQWUy1Y.d.cts}

@@ -2,7 +2,7 @@
  * Every entitlement key the PUBLIC contract declares. Internal packs are absent by construction (the
  * projection redacts them), so this union is exactly what a partner surface may require.
  */
-type EverfurCapabilityKey = "animations.state.read" | "chat.conversation.read" | "chat.message.create" | "partner_events.event.read" | "partner_events.inbound.create" | "pets.health.update" | "pets.profile.delete" | "pets.profile.update" | "photo.checkup.execute" | "records.clinic.create" | "records.record.create" | "records.record.export" | "records.record.read" | "records.record.share" | "records.upload.create" | "televet.visit.create" | "video.gait.execute";
+type EverfurCapabilityKey = "animations.state.read" | "chat.conversation.read" | "chat.message.create" | "partner_events.event.read" | "partner_events.inbound.create" | "pets.health.update" | "pets.profile.delete" | "pets.profile.update" | "photo.checkup.execute" | "records.clinic.create" | "records.record.create" | "records.record.export" | "records.record.read" | "records.record.share" | "records.upload.create" | "shop.catalog.update" | "shop.plan.read" | "shop.plan.update" | "sms.identity.read" | "sms.identity.update" | "sms.message.create" | "televet.visit.create" | "video.gait.execute";
 
 interface LevelGrant {
     /** capability keys this level permits */
@@ -24,7 +24,7 @@ interface ResolvedEntitlements {
  */
 declare function resolveEntitlements(levels: readonly LevelGrant[]): ResolvedEntitlements;
 /** Coarse UI capability ids. NOT valid entitlement keys; bridged to resource keys by `requires`. */
-type CapabilityName = 'chat' | 'records' | 'recordsClinic' | 'video' | 'photo' | 'animations' | 'televet';
+type CapabilityName = 'chat' | 'records' | 'recordsClinic' | 'video' | 'photo' | 'animations' | 'televet' | 'texting' | 'healthPlan';
 type DisabledLevel = 'contract' | 'partner_config' | 'user_entitlement' | 'version_floor' | 'kill_switch'
 /**
  * The SDK itself is not configured (no publishableKey, or no resolvable apiBaseUrl), so NOTHING can be

package/dist/{resolve-D4Ywz5OS.d.cts → resolve.d-CoQWUy1Y.d.ts}

@@ -2,7 +2,7 @@
  * Every entitlement key the PUBLIC contract declares. Internal packs are absent by construction (the
  * projection redacts them), so this union is exactly what a partner surface may require.
  */
-type EverfurCapabilityKey = "animations.state.read" | "chat.conversation.read" | "chat.message.create" | "partner_events.event.read" | "partner_events.inbound.create" | "pets.health.update" | "pets.profile.delete" | "pets.profile.update" | "photo.checkup.execute" | "records.clinic.create" | "records.record.create" | "records.record.export" | "records.record.read" | "records.record.share" | "records.upload.create" | "televet.visit.create" | "video.gait.execute";
+type EverfurCapabilityKey = "animations.state.read" | "chat.conversation.read" | "chat.message.create" | "partner_events.event.read" | "partner_events.inbound.create" | "pets.health.update" | "pets.profile.delete" | "pets.profile.update" | "photo.checkup.execute" | "records.clinic.create" | "records.record.create" | "records.record.export" | "records.record.read" | "records.record.share" | "records.upload.create" | "shop.catalog.update" | "shop.plan.read" | "shop.plan.update" | "sms.identity.read" | "sms.identity.update" | "sms.message.create" | "televet.visit.create" | "video.gait.execute";
 
 interface LevelGrant {
     /** capability keys this level permits */
@@ -24,7 +24,7 @@ interface ResolvedEntitlements {
  */
 declare function resolveEntitlements(levels: readonly LevelGrant[]): ResolvedEntitlements;
 /** Coarse UI capability ids. NOT valid entitlement keys; bridged to resource keys by `requires`. */
-type CapabilityName = 'chat' | 'records' | 'recordsClinic' | 'video' | 'photo' | 'animations' | 'televet';
+type CapabilityName = 'chat' | 'records' | 'recordsClinic' | 'video' | 'photo' | 'animations' | 'televet' | 'texting' | 'healthPlan';
 type DisabledLevel = 'contract' | 'partner_config' | 'user_entitlement' | 'version_floor' | 'kill_switch'
 /**
  * The SDK itself is not configured (no publishableKey, or no resolvable apiBaseUrl), so NOTHING can be

package/dist/{runtimeTypes-BxxCKMn8.d.cts → runtimeTypes.d-BYq38b17.d.ts}

@@ -1,16 +1,16 @@
-import { E as EntitlementDecision, C as CapabilityName } from './resolve-D4Ywz5OS.cjs';
-import { P as PetProfileInput, R as RegisteredPet, a as PetProfilePatch } from './petsRepository-Cqpd3hLU.cjs';
-import { E as EverfurResult } from './EverfurResult-COlXj1wq.cjs';
-import { E as EverfurThemeInput, C as ClientBranding } from './branding-BCfwLj0h.cjs';
-import { A as AuthContext, T as TokenProvider } from './identity-gjurBi7m.cjs';
-import { U as UserRef, P as PetRef, C as ConversationId } from './ids-B2GAAifq.cjs';
-import { T as TransportPort } from './config-C9zhanL-.cjs';
-import { I as ImageCachePort, K as KvPort } from './cacheEpoch-DknKn3S0.cjs';
-import { E as ErrorPolicyPort } from './ErrorPolicyPort-10s3HJCt.cjs';
-import { U as UploadPort, n as ChatController } from './ports-gJ3faaWz.cjs';
-import { C as CameraPort } from './CameraPort-Cv31Pz7g.cjs';
-import { T as TelemetryPort } from './TelemetryPort-BDNr00hu.cjs';
-import { U as UploadTransport } from './ports-BN6RHF9W.cjs';
+import { E as EntitlementDecision, C as CapabilityName } from './resolve.d-CoQWUy1Y.js';
+import { P as PetProfileInput, R as RegisteredPet, a as PetProfilePatch } from './petsRepository.d-RGwSZcYl.js';
+import { E as EverfurResult } from './EverfurResult.d-D_-254ZY.js';
+import { E as EverfurThemeInput, C as ClientBranding } from './branding.d-DxJSoFce.js';
+import { A as AuthContext, T as TokenProvider } from './identity.d-BePPZ7Uv.js';
+import { U as UserRef, P as PetRef, C as ConversationId } from './ids.d-B2GAAifq.js';
+import { T as TransportPort } from './config.d-MX7IKP2f.js';
+import { I as ImageCachePort, K as KvPort } from './cacheEpoch.d-DknKn3S0.js';
+import { E as ErrorPolicyPort } from './ErrorPolicyPort.d-68yrE3BE.js';
+import { U as UploadPort, n as ChatController } from './ports.d-D2n4HRUy.js';
+import { C as CameraPort } from './CameraPort.d-Cv31Pz7g.js';
+import { T as TelemetryPort } from './TelemetryPort.d-BDNr00hu.js';
+import { U as UploadTransport } from './ports.d-BX4f4UsB.js';
 
 /**
  * Opt-in encrypted secret storage. Backed by a Keychain / Keystore native peer through an rn-layer adapter.
@@ -219,6 +219,13 @@ interface EntitlementSnapshot {
      * a snapshot that claimed `false` for a live tenant could reach nothing but their 404.
      */
     readonly livemode?: boolean;
+    /**
+     * The tenant's public texting profile (`sms_profile_public`) from the SAME entitlements body, UNPARSED: only the
+     * texting subpath reads it (`parseTextingProfile`), so no other capability's bundle carries the parser. Absent
+     * when the body has none; the store writes the key only when the body carried one, so every other tenant's
+     * snapshot is shaped exactly as it was before this field existed.
+     */
+    readonly smsProfilePublic?: unknown;
 }
 /**
  * Framework-free entitlement store bound by `useCapability` through useSyncExternalStore. `getSnapshot`

package/dist/{runtimeTypes-Doa_xxSa.d.ts → runtimeTypes.d-LkwZaF7z.d.cts}

@@ -1,16 +1,16 @@
-import { E as EntitlementDecision, C as CapabilityName } from './resolve-D4Ywz5OS.js';
-import { P as PetProfileInput, R as RegisteredPet, a as PetProfilePatch } from './petsRepository-CoRa3C_U.js';
-import { E as EverfurResult } from './EverfurResult-ClPTS0P2.js';
-import { E as EverfurThemeInput, C as ClientBranding } from './branding-DJf4h12Q.js';
-import { A as AuthContext, T as TokenProvider } from './identity-BqeaN8An.js';
-import { U as UserRef, P as PetRef, C as ConversationId } from './ids-B2GAAifq.js';
-import { T as TransportPort } from './config-C5iPNKDj.js';
-import { I as ImageCachePort, K as KvPort } from './cacheEpoch-DknKn3S0.js';
-import { E as ErrorPolicyPort } from './ErrorPolicyPort-C3nNSS_j.js';
-import { U as UploadPort, n as ChatController } from './ports-CVi3n0re.js';
-import { C as CameraPort } from './CameraPort-Cv31Pz7g.js';
-import { T as TelemetryPort } from './TelemetryPort-BDNr00hu.js';
-import { U as UploadTransport } from './ports-BN6RHF9W.js';
+import { E as EntitlementDecision, C as CapabilityName } from './resolve.d-CoQWUy1Y.cjs';
+import { P as PetProfileInput, R as RegisteredPet, a as PetProfilePatch } from './petsRepository.d-B2TpRE7r.cjs';
+import { E as EverfurResult } from './EverfurResult.d-BFH-3s6E.cjs';
+import { E as EverfurThemeInput, C as ClientBranding } from './branding.d-CTXTUg_8.cjs';
+import { A as AuthContext, T as TokenProvider } from './identity.d-CJfnWOdH.cjs';
+import { U as UserRef, P as PetRef, C as ConversationId } from './ids.d-B2GAAifq.cjs';
+import { T as TransportPort } from './config.d-DJ4mvf_w.cjs';
+import { I as ImageCachePort, K as KvPort } from './cacheEpoch.d-DknKn3S0.cjs';
+import { E as ErrorPolicyPort } from './ErrorPolicyPort.d-DirW9hgO.cjs';
+import { U as UploadPort, n as ChatController } from './ports.d-DBA_gsq5.cjs';
+import { C as CameraPort } from './CameraPort.d-Cv31Pz7g.cjs';
+import { T as TelemetryPort } from './TelemetryPort.d-BDNr00hu.cjs';
+import { U as UploadTransport } from './ports.d-BX4f4UsB.cjs';
 
 /**
  * Opt-in encrypted secret storage. Backed by a Keychain / Keystore native peer through an rn-layer adapter.
@@ -219,6 +219,13 @@ interface EntitlementSnapshot {
      * a snapshot that claimed `false` for a live tenant could reach nothing but their 404.
      */
     readonly livemode?: boolean;
+    /**
+     * The tenant's public texting profile (`sms_profile_public`) from the SAME entitlements body, UNPARSED: only the
+     * texting subpath reads it (`parseTextingProfile`), so no other capability's bundle carries the parser. Absent
+     * when the body has none; the store writes the key only when the body carried one, so every other tenant's
+     * snapshot is shaped exactly as it was before this field existed.
+     */
+    readonly smsProfilePublic?: unknown;
 }
 /**
  * Framework-free entitlement store bound by `useCapability` through useSyncExternalStore. `getSnapshot`

package/dist/screenProps.d-BVzRzowC.d.ts

@@ -0,0 +1,159 @@
+import { P as PetRef, R as RecordsRequestId } from './ids.d-B2GAAifq.js';
+import { R as RecordsClinicBatch, a as RecordsClinicBatchClient } from './clinicBatch.d-D9Ci7IpP.js';
+import { C as CaptureRecordsSignature, R as RecordsClinicController } from './clinicRequestProps.d-CjsMg_OD.js';
+import { R as RecordsClinic, c as RecordsClinicSearchInput } from './clinicModels.d-CaS64-P-.js';
+import { a as RecordsAskHandler } from './recordsAsk.d-C5CGSi3j.js';
+
+/** One composed clinic of the batch (the consumer `ClinicRequestDraft`). */
+interface ClinicDraft {
+    /** Stable local key for list rows and removal. */
+    readonly key: string;
+    /** The directory clinic, or null for an owner-typed clinic name. */
+    readonly clinic: RecordsClinic | null;
+    /** The owner-typed clinic name when `clinic` is null. */
+    readonly freeText: string | null;
+    /** The owner-supplied address, when the clinic needs one. */
+    readonly email: string;
+    /** Minted when the draft is added; a whole-batch retry replays it. */
+    readonly idempotencyKey: string;
+}
+interface ClinicBatchBaseProps {
+    readonly petRef: PetRef;
+    /** Display name for this exact registered petRef (empty: `your pet`); the server owns the final PDF identity. */
+    readonly petName: string;
+    /** Initial value only; the owner can visibly confirm or correct it before signing. */
+    readonly ownerName: string;
+    readonly onCaptureSignature?: CaptureRecordsSignature;
+    /** Called once with the batch outcome (created and failed clinics alike). */
+    readonly onCreated?: (batch: RecordsClinicBatch) => void;
+    readonly onClose?: () => void;
+    /** Host/test seams over the same signed-user contracts. */
+    readonly controller?: RecordsClinicController;
+    readonly batchClient?: RecordsClinicBatchClient;
+}
+/**
+ * Turn the pad's inline PNG into a registered signature id, so the batch carries one small id per clinic rather
+ * than one PNG per clinic (the platform caps the inline bytes of a batch at one signature's worth, and the WAF
+ * caps the JSON body). The host supplies the byte transport; the RN and web hosts each have one.
+ */
+type RegisterSignaturePng = (signaturePngBase64: string, signal: AbortSignal) => Promise<{
+    readonly signatureId: string;
+}>;
+
+type RecordsScreen = {
+    readonly name: 'dashboard';
+} | {
+    readonly name: 'request';
+    readonly requestId: RecordsRequestId;
+} | {
+    readonly name: 'timeline';
+} | {
+    readonly name: 'record';
+} | {
+    readonly name: 'document';
+} | {
+    readonly name: 'contributions';
+    readonly docId: string;
+} | {
+    readonly name: 'clinicPicker';
+}
+/**
+ * The multi-clinic composer (`EverfurClinicRequestBatch`). The consumer opens it as a SHEET from the full
+ * record screen's header (RequestFromClinicsAction.tsx); the SDK flow has no sheet layer of its own, so it is
+ * a screen of the same stack, pushed from the same control and popped by the same back.
+ */
+ | {
+    readonly name: 'clinicBatch';
+} | {
+    readonly name: 'consent';
+    readonly clinic: ClinicDraft;
+} | {
+    readonly name: 'upload';
+}
+/**
+ * Every upload and clinic request for the pet, each with its own status: the consumer's
+ * `RecordsRequestListScreen` (everfur-mobile src/features/records/ui/RecordsRequestListScreen.tsx, the
+ * `/records/requests` route the dashboard's `RecordsRequestsStatusCard` opens). On the web it is the
+ * records page's own request list.
+ */
+ | {
+    readonly name: 'requests';
+};
+interface RecordsNavState {
+    readonly stack: readonly RecordsScreen[];
+}
+type RecordsNavAction = {
+    readonly type: 'push';
+    readonly screen: RecordsScreen;
+} | {
+    readonly type: 'pop';
+} | {
+    readonly type: 'replace';
+    readonly screen: RecordsScreen;
+} | {
+    readonly type: 'reset';
+    readonly screen: RecordsScreen;
+}
+/** The screen-declared edge: applies the consumer's push / replace / reset rule for the (from, to) pair. */
+ | {
+    readonly type: 'navigate';
+    readonly screen: RecordsScreen;
+};
+/** A one-screen stack at `initial` (the dashboard when omitted). */
+declare function initialRecordsNav(initial?: RecordsScreen): RecordsNavState;
+/** The screen on top of the stack (a stack is never empty). */
+declare function currentRecordsScreen(state: RecordsNavState): RecordsScreen;
+declare function pushRecordsNav(state: RecordsNavState, screen: RecordsScreen): RecordsNavState;
+declare function replaceRecordsNav(state: RecordsNavState, screen: RecordsScreen): RecordsNavState;
+declare function resetRecordsNav(screen: RecordsScreen): RecordsNavState;
+/**
+ * Pop the top screen. On a one-screen stack the state is returned UNCHANGED with `handled:false`, so the RN
+ * flow's back handler can return `false` and let the host navigator handle the press.
+ */
+declare function popRecordsNav(state: RecordsNavState): {
+    readonly state: RecordsNavState;
+    readonly handled: boolean;
+};
+/**
+ * The consumer's own transition rule for a screen-declared edge:
+ *   - `dashboard` is the root: reaching it resets the stack (consent success `router.replace`s the dashboard,
+ *     a published request pushes it; both end on one dashboard with nothing to pop back into);
+ *   - `upload -> request` replaces (the upload screen's "Done" is a `router.replace`);
+ *   - everything else pushes.
+ */
+declare function transitionRecordsNav(state: RecordsNavState, to: RecordsScreen): RecordsNavState;
+declare function recordsNavReducer(state: RecordsNavState, action: RecordsNavAction): RecordsNavState;
+
+type ClinicLocation = NonNullable<RecordsClinicSearchInput['location']>;
+
+/**
+ * What a URL handed to `onOpenUrl` is: a revocable share link, the full record PDF (a short-lived presigned
+ * GET), or one file the member uploaded onto a request (`request_document`, web only; also short-lived).
+ */
+type RecordsUrlKind = 'share_link' | 'record_pdf' | 'request_document';
+interface RecordsHostSeams {
+    /**
+     * Share a link, or save or preview a file, your app's way. Default, which never leaves your app: React
+     * Native shares the link through the OS share sheet (`Share.share`) and offers the PDF's short-lived link
+     * the same way (pass this seam to share the FILE, e.g. expo-file-system + expo-sharing); the web shares
+     * the link with `navigator.share`, else copies it, and saves a file in place with no new tab.
+     */
+    readonly onOpenUrl?: (url: string, kind: RecordsUrlKind) => void | Promise<void>;
+    /** Copy a share link. Web default: `navigator.clipboard.writeText`; React Native has no default (see above). */
+    readonly onCopy?: (text: string) => Promise<void>;
+    /** The Ask pills' seed prompt and entity, for a host chat. Absent: no Ask pill renders. */
+    readonly onAsk?: RecordsAskHandler;
+    /** Biases the clinic search (the same input the clinic controller takes). */
+    readonly location?: ClinicLocation;
+}
+interface RecordsScreenBaseProps extends RecordsHostSeams {
+    readonly petRef: PetRef;
+    /** The pet's display name for headers and lead copy; absent, the consumer's own `your pet` forms. */
+    readonly petName?: string;
+    /** Called with the exact screen an edge leads to (see `navigation.ts`). Absent, a control that only navigates is hidden, never inert. */
+    readonly onNavigate?: (to: RecordsScreen) => void;
+    /** The header's back control; absent, no back control renders. */
+    readonly onBack?: () => void;
+}
+
+export { type ClinicDraft as C, type RecordsHostSeams as R, type ClinicLocation as a, type RecordsScreen as b, type RecordsScreenBaseProps as c, type RecordsUrlKind as d, type ClinicBatchBaseProps as e, type RecordsNavAction as f, type RecordsNavState as g, type RegisterSignaturePng as h, currentRecordsScreen as i, initialRecordsNav as j, pushRecordsNav as k, replaceRecordsNav as l, resetRecordsNav as m, popRecordsNav as p, recordsNavReducer as r, transitionRecordsNav as t };

package/dist/screenProps.d-CQ0qZJkr.d.cts

@@ -0,0 +1,159 @@
+import { P as PetRef, R as RecordsRequestId } from './ids.d-B2GAAifq.cjs';
+import { R as RecordsClinicBatch, a as RecordsClinicBatchClient } from './clinicBatch.d-Ccmrngcu.cjs';
+import { C as CaptureRecordsSignature, R as RecordsClinicController } from './clinicRequestProps.d-1dCtouGA.cjs';
+import { R as RecordsClinic, c as RecordsClinicSearchInput } from './clinicModels.d-BXgKZqDb.cjs';
+import { a as RecordsAskHandler } from './recordsAsk.d-C5CGSi3j.cjs';
+
+/** One composed clinic of the batch (the consumer `ClinicRequestDraft`). */
+interface ClinicDraft {
+    /** Stable local key for list rows and removal. */
+    readonly key: string;
+    /** The directory clinic, or null for an owner-typed clinic name. */
+    readonly clinic: RecordsClinic | null;
+    /** The owner-typed clinic name when `clinic` is null. */
+    readonly freeText: string | null;
+    /** The owner-supplied address, when the clinic needs one. */
+    readonly email: string;
+    /** Minted when the draft is added; a whole-batch retry replays it. */
+    readonly idempotencyKey: string;
+}
+interface ClinicBatchBaseProps {
+    readonly petRef: PetRef;
+    /** Display name for this exact registered petRef (empty: `your pet`); the server owns the final PDF identity. */
+    readonly petName: string;
+    /** Initial value only; the owner can visibly confirm or correct it before signing. */
+    readonly ownerName: string;
+    readonly onCaptureSignature?: CaptureRecordsSignature;
+    /** Called once with the batch outcome (created and failed clinics alike). */
+    readonly onCreated?: (batch: RecordsClinicBatch) => void;
+    readonly onClose?: () => void;
+    /** Host/test seams over the same signed-user contracts. */
+    readonly controller?: RecordsClinicController;
+    readonly batchClient?: RecordsClinicBatchClient;
+}
+/**
+ * Turn the pad's inline PNG into a registered signature id, so the batch carries one small id per clinic rather
+ * than one PNG per clinic (the platform caps the inline bytes of a batch at one signature's worth, and the WAF
+ * caps the JSON body). The host supplies the byte transport; the RN and web hosts each have one.
+ */
+type RegisterSignaturePng = (signaturePngBase64: string, signal: AbortSignal) => Promise<{
+    readonly signatureId: string;
+}>;
+
+type RecordsScreen = {
+    readonly name: 'dashboard';
+} | {
+    readonly name: 'request';
+    readonly requestId: RecordsRequestId;
+} | {
+    readonly name: 'timeline';
+} | {
+    readonly name: 'record';
+} | {
+    readonly name: 'document';
+} | {
+    readonly name: 'contributions';
+    readonly docId: string;
+} | {
+    readonly name: 'clinicPicker';
+}
+/**
+ * The multi-clinic composer (`EverfurClinicRequestBatch`). The consumer opens it as a SHEET from the full
+ * record screen's header (RequestFromClinicsAction.tsx); the SDK flow has no sheet layer of its own, so it is
+ * a screen of the same stack, pushed from the same control and popped by the same back.
+ */
+ | {
+    readonly name: 'clinicBatch';
+} | {
+    readonly name: 'consent';
+    readonly clinic: ClinicDraft;
+} | {
+    readonly name: 'upload';
+}
+/**
+ * Every upload and clinic request for the pet, each with its own status: the consumer's
+ * `RecordsRequestListScreen` (everfur-mobile src/features/records/ui/RecordsRequestListScreen.tsx, the
+ * `/records/requests` route the dashboard's `RecordsRequestsStatusCard` opens). On the web it is the
+ * records page's own request list.
+ */
+ | {
+    readonly name: 'requests';
+};
+interface RecordsNavState {
+    readonly stack: readonly RecordsScreen[];
+}
+type RecordsNavAction = {
+    readonly type: 'push';
+    readonly screen: RecordsScreen;
+} | {
+    readonly type: 'pop';
+} | {
+    readonly type: 'replace';
+    readonly screen: RecordsScreen;
+} | {
+    readonly type: 'reset';
+    readonly screen: RecordsScreen;
+}
+/** The screen-declared edge: applies the consumer's push / replace / reset rule for the (from, to) pair. */
+ | {
+    readonly type: 'navigate';
+    readonly screen: RecordsScreen;
+};
+/** A one-screen stack at `initial` (the dashboard when omitted). */
+declare function initialRecordsNav(initial?: RecordsScreen): RecordsNavState;
+/** The screen on top of the stack (a stack is never empty). */
+declare function currentRecordsScreen(state: RecordsNavState): RecordsScreen;
+declare function pushRecordsNav(state: RecordsNavState, screen: RecordsScreen): RecordsNavState;
+declare function replaceRecordsNav(state: RecordsNavState, screen: RecordsScreen): RecordsNavState;
+declare function resetRecordsNav(screen: RecordsScreen): RecordsNavState;
+/**
+ * Pop the top screen. On a one-screen stack the state is returned UNCHANGED with `handled:false`, so the RN
+ * flow's back handler can return `false` and let the host navigator handle the press.
+ */
+declare function popRecordsNav(state: RecordsNavState): {
+    readonly state: RecordsNavState;
+    readonly handled: boolean;
+};
+/**
+ * The consumer's own transition rule for a screen-declared edge:
+ *   - `dashboard` is the root: reaching it resets the stack (consent success `router.replace`s the dashboard,
+ *     a published request pushes it; both end on one dashboard with nothing to pop back into);
+ *   - `upload -> request` replaces (the upload screen's "Done" is a `router.replace`);
+ *   - everything else pushes.
+ */
+declare function transitionRecordsNav(state: RecordsNavState, to: RecordsScreen): RecordsNavState;
+declare function recordsNavReducer(state: RecordsNavState, action: RecordsNavAction): RecordsNavState;
+
+type ClinicLocation = NonNullable<RecordsClinicSearchInput['location']>;
+
+/**
+ * What a URL handed to `onOpenUrl` is: a revocable share link, the full record PDF (a short-lived presigned
+ * GET), or one file the member uploaded onto a request (`request_document`, web only; also short-lived).
+ */
+type RecordsUrlKind = 'share_link' | 'record_pdf' | 'request_document';
+interface RecordsHostSeams {
+    /**
+     * Share a link, or save or preview a file, your app's way. Default, which never leaves your app: React
+     * Native shares the link through the OS share sheet (`Share.share`) and offers the PDF's short-lived link
+     * the same way (pass this seam to share the FILE, e.g. expo-file-system + expo-sharing); the web shares
+     * the link with `navigator.share`, else copies it, and saves a file in place with no new tab.
+     */
+    readonly onOpenUrl?: (url: string, kind: RecordsUrlKind) => void | Promise<void>;
+    /** Copy a share link. Web default: `navigator.clipboard.writeText`; React Native has no default (see above). */
+    readonly onCopy?: (text: string) => Promise<void>;
+    /** The Ask pills' seed prompt and entity, for a host chat. Absent: no Ask pill renders. */
+    readonly onAsk?: RecordsAskHandler;
+    /** Biases the clinic search (the same input the clinic controller takes). */
+    readonly location?: ClinicLocation;
+}
+interface RecordsScreenBaseProps extends RecordsHostSeams {
+    readonly petRef: PetRef;
+    /** The pet's display name for headers and lead copy; absent, the consumer's own `your pet` forms. */
+    readonly petName?: string;
+    /** Called with the exact screen an edge leads to (see `navigation.ts`). Absent, a control that only navigates is hidden, never inert. */
+    readonly onNavigate?: (to: RecordsScreen) => void;
+    /** The header's back control; absent, no back control renders. */
+    readonly onBack?: () => void;
+}
+
+export { type ClinicDraft as C, type RecordsHostSeams as R, type ClinicLocation as a, type RecordsScreen as b, type RecordsScreenBaseProps as c, type RecordsUrlKind as d, type ClinicBatchBaseProps as e, type RecordsNavAction as f, type RecordsNavState as g, type RegisterSignaturePng as h, currentRecordsScreen as i, initialRecordsNav as j, pushRecordsNav as k, replaceRecordsNav as l, resetRecordsNav as m, popRecordsNav as p, recordsNavReducer as r, transitionRecordsNav as t };