@everfur/sdk 0.12.0 → 0.13.0

package/dist/useRecords.d-Cb-36SF5.d.cts

@@ -0,0 +1,121 @@
+import { E as EverfurError } from './EverfurError.d-8NHtlgzA.cjs';
+import { E as EverfurResult } from './EverfurResult.d-BFH-3s6E.cjs';
+import { R as RecordsRequestId, P as PetRef } from './ids.d-B2GAAifq.cjs';
+import { F as FileHandle, U as UploadTransport } from './ports.d-BX4f4UsB.cjs';
+import { a as RecordsFeatures, b as RecordsUploadContentType } from './features.d-fNsGcg0R.cjs';
+import { C as CreateUploadRequestInput, d as RecordsRequestView, U as UploadedDocument, e as RecordsView, f as ConsentState, G as GrantConsentInput, g as RecordsDenialReason } from './models.d-BnLm3VAA.cjs';
+
+interface UploadDocumentInput {
+    readonly requestId: RecordsRequestId;
+    readonly file: FileHandle;
+    readonly onProgress?: (fraction: number) => void;
+    readonly signal?: AbortSignal;
+}
+interface RecordsController {
+    /** Create the self-upload request. Idempotent on `idempotencyKey`. Lands `awaiting_upload`. */
+    createUploadRequest(input: CreateUploadRequestInput): Promise<EverfurResult<RecordsRequestView>>;
+    /** Two-phase presigned upload of ONE document (§3.2). Bytes go DIRECT to S3. Resolves at `received`. */
+    uploadDocument(input: UploadDocumentInput): Promise<EverfurResult<UploadedDocument>>;
+    /** Poll one request's parse lifecycle. */
+    getRequest(id: RecordsRequestId): Promise<EverfurResult<RecordsRequestView>>;
+    /** All of this user's requests, newest-first (server-ordered). */
+    listRequests(): Promise<EverfurResult<readonly RecordsRequestView[]>>;
+    /** The parsed, partner-redacted record. Consent-gated + redaction-fail-closed. */
+    getRecord(pet: PetRef): Promise<EverfurResult<RecordsView>>;
+    /** Consent read-back. Never a hard failure for an absent row, which the server answers as the default grant. */
+    getConsent(pet: PetRef): Promise<EverfurResult<ConsentState>>;
+    /** Grant content-exposure consent. Fail-closed audited server-side. Idempotent. */
+    grantConsent(input: GrantConsentInput): Promise<EverfurResult<ConsentState>>;
+    /** Revoke consent (prospective). Drops any cached record for the pet from memory. Idempotent. */
+    revokeConsent(pet: PetRef): Promise<EverfurResult<ConsentState>>;
+    /** The last record read for a pet, held in memory only; cleared on revoke. Null when none. */
+    peekCachedRecord(pet: PetRef): RecordsView | null;
+    /** Emit `records.capability.denied` (the rn CapabilityGate disabled surface calls this once, R12). */
+    reportCapabilityDenied(pet: PetRef | null): void;
+    /**
+     * `GET /widget/v1/records/features`: which records features are live, and the upload types while photo
+     * upload is armed. NEVER rejects: a failed or malformed read is `RECORDS_FEATURES_PDF_ONLY`. The answer is
+     * also what `uploadDocument`'s client-side gate accepts from then on, so a photo is refused before initiate
+     * until a read has armed it (and again after a read that comes back dark).
+     *
+     * OPTIONAL so a host's own controller still satisfies this interface; a surface given one without it offers
+     * PDF upload only, exactly as before the read existed.
+     */
+    readFeatures?(): Promise<RecordsFeatures>;
+}
+
+type RecordsStatus = 'loading' | 'empty' | 'error' | 'populated';
+/** Why a picked file was not uploaded (the consumer picker's `PickSkipReason`): decided BEFORE any request is made. */
+type UploadSkipReason = 'too_large' | 'unsupported';
+/** One file of an upload batch, with its own lifecycle and progress (the consumer `UploadItem`). */
+interface UploadQueueItem {
+    /** Stable row key within the batch. */
+    readonly key: string;
+    /** The host's file name when it gave one; rendered locally, never sent. */
+    readonly name: string | null;
+    readonly status: 'queued' | 'uploading' | 'done' | 'failed' | 'skipped';
+    /** 0..1, monotonic while uploading; 1 once done. */
+    readonly progress: number;
+    readonly skipReason: UploadSkipReason | null;
+    readonly error: EverfurError | null;
+}
+interface UseEverfurRecordsState {
+    readonly status: RecordsStatus;
+    readonly record: RecordsView | null;
+    readonly requests: readonly RecordsRequestView[];
+    /** the most-recent request, whose timeline the populated state renders. */
+    readonly activeRequest: RecordsRequestView | null;
+    readonly consent: ConsentState | null;
+    readonly error: EverfurError | null;
+    /** drives the recovery affordance: consent CTA / establish-session CTA / disabled. */
+    readonly denialReason: RecordsDenialReason | null;
+    /** §5.1 fail-closed suppression: render the withheld notice, never empty, never raw. */
+    readonly withheld: boolean;
+    readonly isUploading: boolean;
+    readonly uploadProgress: number | null;
+    /** The files of the last pick, one row each, with per-file status and progress. Empty until a pick. */
+    readonly uploadQueue: readonly UploadQueueItem[];
+    /**
+     * What an upload may be: `['application/pdf']`, plus the photo types while the records features read says
+     * photo upload is live. Read only for a hook opened with `readUploadFeatures: true`; PDF only otherwise, until
+     * the read lands, and whenever it fails. `acceptsPhotos(uploadContentTypes)` is the "photos live" test.
+     */
+    readonly uploadContentTypes: readonly RecordsUploadContentType[];
+    /** Create a self-upload request the user attaches documents to. */
+    createRequest(idempotencyKey: string): Promise<EverfurResult<RecordsRequestView>>;
+    /** Two-phase presigned upload of one document to the active request. */
+    uploadDocument(requestId: RecordsRequestView['id'], file: FileHandle): Promise<EverfurResult<UploadedDocument>>;
+    /**
+     * Several documents in one pick: uploaded ONE AT A TIME (kinder to slow links), a live row per file, one failed
+     * file never aborts the rest (continue-on-error), and a non-PDF or oversize file is skipped with a reason before
+     * any request is created, so no quota is charged for it. Resolves with the settled rows.
+     */
+    uploadDocuments(requestId: RecordsRequestView['id'], files: readonly FileHandle[]): Promise<readonly UploadQueueItem[]>;
+    /** Grant content-exposure consent, then fetch the record. */
+    grantConsent(consentVersion: string, idempotencyKey: string): Promise<EverfurResult<ConsentState>>;
+    /** Revoke consent (prospective); drops the record from view. */
+    revokeConsent(): Promise<EverfurResult<ConsentState>>;
+    /**
+     * Re-run the surface fetch (error retry, pull to refresh). Settles once the reads it started have landed, so a
+     * pull-to-refresh spinner can stay up until then; a caller that does not need that can ignore the promise.
+     */
+    refresh(): Promise<void>;
+}
+declare function useEverfurRecords(opts: {
+    readonly petRef: PetRef;
+    /** Host/test seam: inject a controller directly instead of acquiring one from the runtime. */
+    readonly controller?: RecordsController;
+    /**
+     * The upload transport for this surface, overriding `EverfurConfig.uploadTransport`. The latest value is used
+     * at upload time, so a transport created inline on each render does not rebuild the controller.
+     */
+    readonly uploadTransport?: UploadTransport;
+    /**
+     * Read `GET /widget/v1/records/features` on mount, so `uploadContentTypes` (and the upload gate) carry the
+     * photo types while photo upload is live. Set by the surfaces that offer an upload; a surface that offers
+     * none leaves it off and issues no read.
+     */
+    readonly readUploadFeatures?: boolean;
+}): UseEverfurRecordsState;
+
+export { type RecordsController as R, type UseEverfurRecordsState as U, type RecordsStatus as a, type UploadDocumentInput as b, type UploadQueueItem as c, type UploadSkipReason as d, useEverfurRecords as u };

package/dist/useRecords.d-aQTzQZoV.d.ts

@@ -0,0 +1,121 @@
+import { E as EverfurError } from './EverfurError.d-8NHtlgzA.js';
+import { E as EverfurResult } from './EverfurResult.d-D_-254ZY.js';
+import { R as RecordsRequestId, P as PetRef } from './ids.d-B2GAAifq.js';
+import { F as FileHandle, U as UploadTransport } from './ports.d-BX4f4UsB.js';
+import { a as RecordsFeatures, b as RecordsUploadContentType } from './features.d-fNsGcg0R.js';
+import { C as CreateUploadRequestInput, d as RecordsRequestView, U as UploadedDocument, e as RecordsView, f as ConsentState, G as GrantConsentInput, g as RecordsDenialReason } from './models.d-BagXhafD.js';
+
+interface UploadDocumentInput {
+    readonly requestId: RecordsRequestId;
+    readonly file: FileHandle;
+    readonly onProgress?: (fraction: number) => void;
+    readonly signal?: AbortSignal;
+}
+interface RecordsController {
+    /** Create the self-upload request. Idempotent on `idempotencyKey`. Lands `awaiting_upload`. */
+    createUploadRequest(input: CreateUploadRequestInput): Promise<EverfurResult<RecordsRequestView>>;
+    /** Two-phase presigned upload of ONE document (§3.2). Bytes go DIRECT to S3. Resolves at `received`. */
+    uploadDocument(input: UploadDocumentInput): Promise<EverfurResult<UploadedDocument>>;
+    /** Poll one request's parse lifecycle. */
+    getRequest(id: RecordsRequestId): Promise<EverfurResult<RecordsRequestView>>;
+    /** All of this user's requests, newest-first (server-ordered). */
+    listRequests(): Promise<EverfurResult<readonly RecordsRequestView[]>>;
+    /** The parsed, partner-redacted record. Consent-gated + redaction-fail-closed. */
+    getRecord(pet: PetRef): Promise<EverfurResult<RecordsView>>;
+    /** Consent read-back. Never a hard failure for an absent row, which the server answers as the default grant. */
+    getConsent(pet: PetRef): Promise<EverfurResult<ConsentState>>;
+    /** Grant content-exposure consent. Fail-closed audited server-side. Idempotent. */
+    grantConsent(input: GrantConsentInput): Promise<EverfurResult<ConsentState>>;
+    /** Revoke consent (prospective). Drops any cached record for the pet from memory. Idempotent. */
+    revokeConsent(pet: PetRef): Promise<EverfurResult<ConsentState>>;
+    /** The last record read for a pet, held in memory only; cleared on revoke. Null when none. */
+    peekCachedRecord(pet: PetRef): RecordsView | null;
+    /** Emit `records.capability.denied` (the rn CapabilityGate disabled surface calls this once, R12). */
+    reportCapabilityDenied(pet: PetRef | null): void;
+    /**
+     * `GET /widget/v1/records/features`: which records features are live, and the upload types while photo
+     * upload is armed. NEVER rejects: a failed or malformed read is `RECORDS_FEATURES_PDF_ONLY`. The answer is
+     * also what `uploadDocument`'s client-side gate accepts from then on, so a photo is refused before initiate
+     * until a read has armed it (and again after a read that comes back dark).
+     *
+     * OPTIONAL so a host's own controller still satisfies this interface; a surface given one without it offers
+     * PDF upload only, exactly as before the read existed.
+     */
+    readFeatures?(): Promise<RecordsFeatures>;
+}
+
+type RecordsStatus = 'loading' | 'empty' | 'error' | 'populated';
+/** Why a picked file was not uploaded (the consumer picker's `PickSkipReason`): decided BEFORE any request is made. */
+type UploadSkipReason = 'too_large' | 'unsupported';
+/** One file of an upload batch, with its own lifecycle and progress (the consumer `UploadItem`). */
+interface UploadQueueItem {
+    /** Stable row key within the batch. */
+    readonly key: string;
+    /** The host's file name when it gave one; rendered locally, never sent. */
+    readonly name: string | null;
+    readonly status: 'queued' | 'uploading' | 'done' | 'failed' | 'skipped';
+    /** 0..1, monotonic while uploading; 1 once done. */
+    readonly progress: number;
+    readonly skipReason: UploadSkipReason | null;
+    readonly error: EverfurError | null;
+}
+interface UseEverfurRecordsState {
+    readonly status: RecordsStatus;
+    readonly record: RecordsView | null;
+    readonly requests: readonly RecordsRequestView[];
+    /** the most-recent request, whose timeline the populated state renders. */
+    readonly activeRequest: RecordsRequestView | null;
+    readonly consent: ConsentState | null;
+    readonly error: EverfurError | null;
+    /** drives the recovery affordance: consent CTA / establish-session CTA / disabled. */
+    readonly denialReason: RecordsDenialReason | null;
+    /** §5.1 fail-closed suppression: render the withheld notice, never empty, never raw. */
+    readonly withheld: boolean;
+    readonly isUploading: boolean;
+    readonly uploadProgress: number | null;
+    /** The files of the last pick, one row each, with per-file status and progress. Empty until a pick. */
+    readonly uploadQueue: readonly UploadQueueItem[];
+    /**
+     * What an upload may be: `['application/pdf']`, plus the photo types while the records features read says
+     * photo upload is live. Read only for a hook opened with `readUploadFeatures: true`; PDF only otherwise, until
+     * the read lands, and whenever it fails. `acceptsPhotos(uploadContentTypes)` is the "photos live" test.
+     */
+    readonly uploadContentTypes: readonly RecordsUploadContentType[];
+    /** Create a self-upload request the user attaches documents to. */
+    createRequest(idempotencyKey: string): Promise<EverfurResult<RecordsRequestView>>;
+    /** Two-phase presigned upload of one document to the active request. */
+    uploadDocument(requestId: RecordsRequestView['id'], file: FileHandle): Promise<EverfurResult<UploadedDocument>>;
+    /**
+     * Several documents in one pick: uploaded ONE AT A TIME (kinder to slow links), a live row per file, one failed
+     * file never aborts the rest (continue-on-error), and a non-PDF or oversize file is skipped with a reason before
+     * any request is created, so no quota is charged for it. Resolves with the settled rows.
+     */
+    uploadDocuments(requestId: RecordsRequestView['id'], files: readonly FileHandle[]): Promise<readonly UploadQueueItem[]>;
+    /** Grant content-exposure consent, then fetch the record. */
+    grantConsent(consentVersion: string, idempotencyKey: string): Promise<EverfurResult<ConsentState>>;
+    /** Revoke consent (prospective); drops the record from view. */
+    revokeConsent(): Promise<EverfurResult<ConsentState>>;
+    /**
+     * Re-run the surface fetch (error retry, pull to refresh). Settles once the reads it started have landed, so a
+     * pull-to-refresh spinner can stay up until then; a caller that does not need that can ignore the promise.
+     */
+    refresh(): Promise<void>;
+}
+declare function useEverfurRecords(opts: {
+    readonly petRef: PetRef;
+    /** Host/test seam: inject a controller directly instead of acquiring one from the runtime. */
+    readonly controller?: RecordsController;
+    /**
+     * The upload transport for this surface, overriding `EverfurConfig.uploadTransport`. The latest value is used
+     * at upload time, so a transport created inline on each render does not rebuild the controller.
+     */
+    readonly uploadTransport?: UploadTransport;
+    /**
+     * Read `GET /widget/v1/records/features` on mount, so `uploadContentTypes` (and the upload gate) carry the
+     * photo types while photo upload is live. Set by the surfaces that offer an upload; a surface that offers
+     * none leaves it off and issues no read.
+     */
+    readonly readUploadFeatures?: boolean;
+}): UseEverfurRecordsState;
+
+export { type RecordsController as R, type UseEverfurRecordsState as U, type RecordsStatus as a, type UploadDocumentInput as b, type UploadQueueItem as c, type UploadSkipReason as d, useEverfurRecords as u };

package/dist/{useRecordsDepth-Bp6L4M5P.d.ts → useRecordsDepth.d-DFcCfiXm.d.ts}

@@ -1,8 +1,9 @@
-import { R as RecordsRequestId, P as PetRef } from './ids-B2GAAifq.js';
-import { ag as RecordsClinicSearchInput, ah as RecordsClinicSearchPage, ai as RecordsRecentClinicsInput, aj as RecordsAuthorizationCopy, ak as CreateClinicRequestInput, al as RecordsSignatureUploadPolicy, m as RecordsClinic, W as RecordsClinicBatch, X as RecordsClinicBatchClient, n as RecordsDepthClient } from './depth-COz-sSG5.js';
-import { E as EverfurResult } from './EverfurResult-ClPTS0P2.js';
-import { f as RecordsRequestGroupView, d as RecordsRequestView } from './models-CnXY5LuO.js';
-import { E as EverfurError } from './EverfurError-DeBqRpQV.js';
+import { R as RecordsRequestId, P as PetRef } from './ids.d-B2GAAifq.js';
+import { $ as RecordsClinicSearchInput, a0 as RecordsClinicSearchPage, a1 as RecordsRecentClinicsInput, a2 as RecordsAuthorizationCopy, a3 as CreateClinicRequestInput, a4 as RecordsSignatureUploadPolicy, l as RecordsClinic, M as RecordsClinicBatch, N as RecordsClinicBatchClient, m as RecordsDepthClient } from './depth.d-OSALbYM7.js';
+import { E as EverfurResult } from './EverfurResult.d-D_-254ZY.js';
+import { j as RecordsRequestGroupView, d as RecordsRequestView } from './models.d-BagXhafD.js';
+import { a as RecordsAskHandler } from './recordsAsk.d-C5CGSi3j.js';
+import { E as EverfurError } from './EverfurError.d-8NHtlgzA.js';
 
 interface RecordsClinicController {
     searchClinics(input?: RecordsClinicSearchInput): Promise<EverfurResult<RecordsClinicSearchPage>>;
@@ -78,7 +79,7 @@ interface ClinicDraft {
 }
 interface ClinicBatchBaseProps {
     readonly petRef: PetRef;
-    /** Display name for this exact registered petRef; the server owns the final PDF identity. */
+    /** 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;
@@ -183,19 +184,6 @@ declare function popRecordsNav(state: RecordsNavState): {
 declare function transitionRecordsNav(state: RecordsNavState, to: RecordsScreen): RecordsNavState;
 declare function recordsNavReducer(state: RecordsNavState, action: RecordsNavAction): RecordsNavState;
 
-/** 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;
-
 type ClinicLocation = NonNullable<RecordsClinicSearchInput['location']>;
 
 /**
@@ -254,4 +242,4 @@ declare function useRecordsDepthRead<T extends {
     readonly withheld: boolean;
 }>(petRef: PetRef, read: (client: RecordsDepthClient, petRef: PetRef) => Promise<EverfurResult<T>>, isEmpty: (value: T) => boolean, extraKey?: string): UseRecordsDepthState<T>;
 
-export { transitionRecordsNav as A, type ClinicDraft as C, type RecordsAskEntityRef as R, type UseRecordsDepthState as U, type ClinicLocation as a, type RecordsAskHandler as b, type RecordsDepthStatus as c, type RecordsHostSeams as d, type RecordsScreen as e, type RecordsScreenBaseProps as f, type RecordsUrlKind as g, useRecordsDepthRead as h, type RecordsClinicController as i, type CaptureRecordsSignature as j, type ClinicRequestBaseProps as k, type ClinicBatchBaseProps as l, type CapturedRecordsSignature as m, type RecordsAsk as n, type RecordsNavAction as o, type RecordsNavState as p, type RecordsSignatureContext as q, type RegisterSignaturePng as r, currentRecordsScreen as s, initialRecordsNav as t, useEverfurRecordsDepthClient as u, popRecordsNav as v, pushRecordsNav as w, recordsNavReducer as x, replaceRecordsNav as y, resetRecordsNav as z };
+export { type ClinicDraft as C, type RecordsDepthStatus as R, type UseRecordsDepthState as U, type ClinicLocation as a, type RecordsHostSeams as b, type RecordsScreen as c, type RecordsScreenBaseProps as d, type RecordsUrlKind as e, useRecordsDepthRead as f, type RecordsClinicController as g, type CaptureRecordsSignature as h, type ClinicRequestBaseProps as i, type ClinicBatchBaseProps as j, type CapturedRecordsSignature as k, type RecordsNavAction as l, type RecordsNavState as m, type RecordsSignatureContext as n, type RegisterSignaturePng as o, currentRecordsScreen as p, initialRecordsNav as q, popRecordsNav as r, pushRecordsNav as s, recordsNavReducer as t, useEverfurRecordsDepthClient as u, replaceRecordsNav as v, resetRecordsNav as w, transitionRecordsNav as x };

package/dist/{useRecordsDepth-DPdAK_81.d.cts → useRecordsDepth.d-sAq2Qkhr.d.cts}

@@ -1,8 +1,9 @@
-import { R as RecordsRequestId, P as PetRef } from './ids-B2GAAifq.cjs';
-import { ag as RecordsClinicSearchInput, ah as RecordsClinicSearchPage, ai as RecordsRecentClinicsInput, aj as RecordsAuthorizationCopy, ak as CreateClinicRequestInput, al as RecordsSignatureUploadPolicy, m as RecordsClinic, W as RecordsClinicBatch, X as RecordsClinicBatchClient, n as RecordsDepthClient } from './depth-BYb3RXoA.cjs';
-import { E as EverfurResult } from './EverfurResult-COlXj1wq.cjs';
-import { f as RecordsRequestGroupView, d as RecordsRequestView } from './models-A4A5S7AG.cjs';
-import { E as EverfurError } from './EverfurError-DeBqRpQV.cjs';
+import { R as RecordsRequestId, P as PetRef } from './ids.d-B2GAAifq.cjs';
+import { $ as RecordsClinicSearchInput, a0 as RecordsClinicSearchPage, a1 as RecordsRecentClinicsInput, a2 as RecordsAuthorizationCopy, a3 as CreateClinicRequestInput, a4 as RecordsSignatureUploadPolicy, l as RecordsClinic, M as RecordsClinicBatch, N as RecordsClinicBatchClient, m as RecordsDepthClient } from './depth.d-CjPGVPDL.cjs';
+import { E as EverfurResult } from './EverfurResult.d-BFH-3s6E.cjs';
+import { j as RecordsRequestGroupView, d as RecordsRequestView } from './models.d-BnLm3VAA.cjs';
+import { a as RecordsAskHandler } from './recordsAsk.d-C5CGSi3j.cjs';
+import { E as EverfurError } from './EverfurError.d-8NHtlgzA.cjs';
 
 interface RecordsClinicController {
     searchClinics(input?: RecordsClinicSearchInput): Promise<EverfurResult<RecordsClinicSearchPage>>;
@@ -78,7 +79,7 @@ interface ClinicDraft {
 }
 interface ClinicBatchBaseProps {
     readonly petRef: PetRef;
-    /** Display name for this exact registered petRef; the server owns the final PDF identity. */
+    /** 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;
@@ -183,19 +184,6 @@ declare function popRecordsNav(state: RecordsNavState): {
 declare function transitionRecordsNav(state: RecordsNavState, to: RecordsScreen): RecordsNavState;
 declare function recordsNavReducer(state: RecordsNavState, action: RecordsNavAction): RecordsNavState;
 
-/** 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;
-
 type ClinicLocation = NonNullable<RecordsClinicSearchInput['location']>;
 
 /**
@@ -254,4 +242,4 @@ declare function useRecordsDepthRead<T extends {
     readonly withheld: boolean;
 }>(petRef: PetRef, read: (client: RecordsDepthClient, petRef: PetRef) => Promise<EverfurResult<T>>, isEmpty: (value: T) => boolean, extraKey?: string): UseRecordsDepthState<T>;
 
-export { transitionRecordsNav as A, type ClinicDraft as C, type RecordsAskEntityRef as R, type UseRecordsDepthState as U, type ClinicLocation as a, type RecordsAskHandler as b, type RecordsDepthStatus as c, type RecordsHostSeams as d, type RecordsScreen as e, type RecordsScreenBaseProps as f, type RecordsUrlKind as g, useRecordsDepthRead as h, type RecordsClinicController as i, type CaptureRecordsSignature as j, type ClinicRequestBaseProps as k, type ClinicBatchBaseProps as l, type CapturedRecordsSignature as m, type RecordsAsk as n, type RecordsNavAction as o, type RecordsNavState as p, type RecordsSignatureContext as q, type RegisterSignaturePng as r, currentRecordsScreen as s, initialRecordsNav as t, useEverfurRecordsDepthClient as u, popRecordsNav as v, pushRecordsNav as w, recordsNavReducer as x, replaceRecordsNav as y, resetRecordsNav as z };
+export { type ClinicDraft as C, type RecordsDepthStatus as R, type UseRecordsDepthState as U, type ClinicLocation as a, type RecordsHostSeams as b, type RecordsScreen as c, type RecordsScreenBaseProps as d, type RecordsUrlKind as e, useRecordsDepthRead as f, type RecordsClinicController as g, type CaptureRecordsSignature as h, type ClinicRequestBaseProps as i, type ClinicBatchBaseProps as j, type CapturedRecordsSignature as k, type RecordsNavAction as l, type RecordsNavState as m, type RecordsSignatureContext as n, type RegisterSignaturePng as o, currentRecordsScreen as p, initialRecordsNav as q, popRecordsNav as r, pushRecordsNav as s, recordsNavReducer as t, useEverfurRecordsDepthClient as u, replaceRecordsNav as v, resetRecordsNav as w, transitionRecordsNav as x };

package/dist/{useVetVisit-DmWa7lt1.d.ts → useVetVisit.d-BtdwhmgD.d.cts}

@@ -1,7 +1,7 @@
-import { E as EverfurError } from './EverfurError-DeBqRpQV.js';
-import { P as PetRef } from './ids-B2GAAifq.js';
-import { E as EverfurResult } from './EverfurResult-ClPTS0P2.js';
-import { V as VetVisitIntent } from './visitIntent-D7_yVp1I.js';
+import { E as EverfurError } from './EverfurError.d-8NHtlgzA.cjs';
+import { P as PetRef } from './ids.d-B2GAAifq.cjs';
+import { E as EverfurResult } from './EverfurResult.d-BFH-3s6E.cjs';
+import { V as VetVisitIntent } from './visitIntent.d-D7_yVp1I.cjs';
 
 /** What the hosted page will open for a handoff minted with `visitRef`: the platform's own echo. */
 interface VetVisitHandoffVisit {
@@ -197,6 +197,17 @@ interface UseVetVisitState {
      * shares the single-flight rule with `open`.
      */
     openVisit(visitRef: string, intent?: VetVisitIntent | null): Promise<VetVisitOpenResult>;
+    /**
+     * Join a visit this member already has, by its consult id (`TelevetConsult.consultId`, as
+     * `useUpcomingTelevetVisit` returns it), instead of the `visitRef` a reminder carries.
+     *
+     * In-app, the request carries `consultId` to your presenter or to the SDK-owned experience, which opens on
+     * the member's visits and goes straight to that visit's join (the recording notice first) when it is inside
+     * its join window; outside it, the visit's row says when it opens. With `prefer: 'redirect'` there is no
+     * consult-level hosted route (a hosted handoff names a visit only by its `visitRef`), so it opens the hosted
+     * visit exactly as `open()` does.
+     */
+    joinVisit(consultId: string): Promise<VetVisitOpenResult>;
 }
 
 export { type UseVetVisitOptions as U, type VetVisitEntry as V, type UseVetVisitState as a, type VetVisitErrorReason as b, type VetVisitController as c, type VetVisitAvailability as d, type VetVisitHandoff as e, type VetVisitHandoffOptions as f, type VetVisitHandoffVisit as g, type VetVisitOpenResult as h, type VetVisitReturn as i, type VetVisitStatus as j, parseVetVisitReturn as p, vetVisitErrorReasonOf as v };

package/dist/{useVetVisit-PtBjNwZr.d.cts → useVetVisit.d-DoYQimyt.d.ts}

@@ -1,7 +1,7 @@
-import { E as EverfurError } from './EverfurError-DeBqRpQV.cjs';
-import { P as PetRef } from './ids-B2GAAifq.cjs';
-import { E as EverfurResult } from './EverfurResult-COlXj1wq.cjs';
-import { V as VetVisitIntent } from './visitIntent-D7_yVp1I.cjs';
+import { E as EverfurError } from './EverfurError.d-8NHtlgzA.js';
+import { P as PetRef } from './ids.d-B2GAAifq.js';
+import { E as EverfurResult } from './EverfurResult.d-D_-254ZY.js';
+import { V as VetVisitIntent } from './visitIntent.d-D7_yVp1I.js';
 
 /** What the hosted page will open for a handoff minted with `visitRef`: the platform's own echo. */
 interface VetVisitHandoffVisit {
@@ -197,6 +197,17 @@ interface UseVetVisitState {
      * shares the single-flight rule with `open`.
      */
     openVisit(visitRef: string, intent?: VetVisitIntent | null): Promise<VetVisitOpenResult>;
+    /**
+     * Join a visit this member already has, by its consult id (`TelevetConsult.consultId`, as
+     * `useUpcomingTelevetVisit` returns it), instead of the `visitRef` a reminder carries.
+     *
+     * In-app, the request carries `consultId` to your presenter or to the SDK-owned experience, which opens on
+     * the member's visits and goes straight to that visit's join (the recording notice first) when it is inside
+     * its join window; outside it, the visit's row says when it opens. With `prefer: 'redirect'` there is no
+     * consult-level hosted route (a hosted handoff names a visit only by its `visitRef`), so it opens the hosted
+     * visit exactly as `open()` does.
+     */
+    joinVisit(consultId: string): Promise<VetVisitOpenResult>;
 }
 
 export { type UseVetVisitOptions as U, type VetVisitEntry as V, type UseVetVisitState as a, type VetVisitErrorReason as b, type VetVisitController as c, type VetVisitAvailability as d, type VetVisitHandoff as e, type VetVisitHandoffOptions as f, type VetVisitHandoffVisit as g, type VetVisitOpenResult as h, type VetVisitReturn as i, type VetVisitStatus as j, parseVetVisitReturn as p, vetVisitErrorReasonOf as v };