@everfur/sdk 0.1.1 → 0.4.0

package/dist/web/records/index.d.cts

@@ -0,0 +1,285 @@
+import { R as RecordsController } from '../../view-DyitEO0m.cjs';
+export { C as ClinicCall, F as FactOverlay, a as REQUEST_TIMELINE_TITLES, b as RecordSharesStatus, c as RecordsDashboardState, d as RecordsDashboardView, e as RecordsEmptyVariant, f as RecordsStatus, g as RequestTimelineEvent, h as RequestTimelineEventKey, i as RequestTimelineEventState, S as ShareRowView, U as UploadDocumentInput, j as UploadQueueItem, k as UploadSkipReason, l as UseEverfurRecordsState, m as UseRecordFactEditState, n as UseRecordPdfLinkState, o as UseRecordSharesState, p as UseRecordsMarkersState, q as applyFactOverlay, r as buildRequestTimeline, s as deriveRecordsDashboardState, t as isFactEditable, u as pickPetRecordsRequest, v as selectClinicCall, w as selectDashboardView, x as selectPrimaryLabel, y as selectRequestList, z as selectRequestTitle, A as useEverfurRecords, B as useEverfurRecordsClinic, D as useEverfurRecordsClinicBatch, E as useRecordFactEdit, G as useRecordPdfLink, H as useRecordShares, I as useRecordsMarkers } from '../../view-DyitEO0m.cjs';
+import { CSSProperties, ReactNode, PointerEvent } from 'react';
+import { P as PetRef, R as RecordsRequestId } from '../../ids-B2GAAifq.cjs';
+export { B as Brand, D as DocumentId, _ as __brand } from '../../ids-B2GAAifq.cjs';
+import { d as RecordsHostSeams, i as RecordsClinicController, j as CaptureRecordsSignature, e as RecordsScreen, f as RecordsScreenBaseProps, C as ClinicDraft, k as ClinicRequestBaseProps, l as ClinicBatchBaseProps } from '../../useRecordsDepth-C6rjEaLn.cjs';
+export { m as CapturedRecordsSignature, a as ClinicLocation, n as RecordsAsk, R as RecordsAskEntityRef, b as RecordsAskHandler, c as RecordsDepthStatus, o as RecordsNavAction, p as RecordsNavState, q as RecordsSignatureContext, g as RecordsUrlKind, r as RegisterSignaturePng, s as currentRecordsScreen, t as initialRecordsNav, v as popRecordsNav, w as pushRecordsNav, x as recordsNavReducer, y as replaceRecordsNav, z as resetRecordsNav, A as transitionRecordsNav } from '../../useRecordsDepth-C6rjEaLn.cjs';
+import { d as RecordsRequestView } from '../../models-D2EUxPZY.cjs';
+export { h as ConsentState, C as CreateUploadRequestInput, G as GrantConsentInput, j as RECORDS_TERMINAL, R as RecordDocumentMeta, a as RecordEntity, k as RecordForwardItem, l as RecordIdentityField, b as RecordOrigin, m as RecordSeries, n as RecordSeriesPoint, i as RecordsDenialReason, f as RecordsRequestGroupView, c as RecordsRequestStatus, e as RecordsSimpleStatus, g as RecordsView, U as UploadedDocument, o as isTerminalStatus, r as recordsDenialReasonOf } from '../../models-D2EUxPZY.cjs';
+import { E as EverfurError } from '../../EverfurResult-DN9pL2Ab.cjs';
+export { a as EverfurErrorCategory, b as EverfurErrorCode, c as EverfurResult } from '../../EverfurResult-DN9pL2Ab.cjs';
+export { C as CreateClinicRequestBatchInput, aa as CreateClinicRequestInput, x as FactFieldValue, A as RECORDS_CLINIC_BATCH_MAX, R as RecordClinicianNote, a as RecordClinicianNoteSection, b as RecordCompleteness, c as RecordConflict, d as RecordConflictCandidate, e as RecordDepthView, f as RecordDocumentContributionsView, g as RecordEncounter, h as RecordExamSystem, B as RecordFactEditInput, D as RecordFactRemoveInput, i as RecordLabMarker, j as RecordLabPoint, E as RecordMarker, G as RecordMarkerLatest, I as RecordMarkerPoint, J as RecordMarkerSummary, K as RecordMarkersView, L as RecordPdfLink, k as RecordPhysicalExam, M as RecordShare, N as RecordShareLink, a9 as RecordsAuthorizationCopy, O as RecordsAuthorizationSignature, l as RecordsClinic, P as RecordsClinicBatch, Q as RecordsClinicBatchClient, S as RecordsClinicBatchItem, T as RecordsClinicBatchResult, a6 as RecordsClinicSearchInput, a7 as RecordsClinicSearchPage, U as RecordsClinicTarget, m as RecordsDepthClient, a8 as RecordsRecentClinicsInput, n as RecordsRequestDocument, V as RecordsSignatureSuggestion, ab as RecordsSignatureUploadPolicy, o as RecordsTimelineMedication, p as RecordsTimelineVaccine, q as RecordsTimelineView, r as RecordsTimelineVisit, s as RecordsTimelineWeight } from '../../depth-D5HwcvKC.cjs';
+export { a as EverfurDocumentContributionsProps, c as EverfurRecordsDepthProps } from '../../DepthViews-CL75jyRA.cjs';
+import { U as UploadTransport, F as FileHandle } from '../../ports-BN6RHF9W.cjs';
+export { a as UploadPolicyWire } from '../../ports-BN6RHF9W.cjs';
+import '../../requestFunnel-BjDpqqvm.cjs';
+import '../../ErrorPolicyPort-CNf4uQZP.cjs';
+import '../../config--Wu1Umhd.cjs';
+import '../../identity-C2-08BZW.cjs';
+
+type RecordsHistoryMode = 'memory' | 'browser';
+interface EverfurRecordsProps 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;
+    /** Host/test seam: inject a records controller instead of acquiring one from the runtime. */
+    readonly controller?: RecordsController;
+    /** Host/test seam over the clinic controller. */
+    readonly clinicController?: RecordsClinicController;
+    /** The consent-text version the content-exposure grant records (host/product owned). */
+    readonly consentVersion?: string;
+    /** The owner's name the clinic authorization is signed with (the owner can correct it before signing). */
+    readonly ownerName?: string;
+    /** A host signature component for the clinic authorization, instead of the built-in canvas. */
+    readonly onCaptureSignature?: CaptureRecordsSignature;
+    /** The screen the flow starts on; the dashboard when omitted. */
+    readonly initialScreen?: RecordsScreen;
+    /** `memory` (default) keeps the stack in state; `browser` mirrors it onto the history stack. */
+    readonly historyMode?: RecordsHistoryMode;
+    /** The root screen's back control; absent, the root draws none. */
+    readonly onExit?: () => void;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    /** Your own placeholder while the entitlement verdict is pending on a cold mount. */
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsFlow(props: EverfurRecordsProps): ReactNode;
+/** The public prebuilt records surface: the flow, starting at the dashboard. */
+declare const EverfurRecords: typeof EverfurRecordsFlow;
+
+interface EverfurRecordsPageProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    /**
+     * The heading level this page's title claims. Defaults to 2.
+     *
+     * THIS PAGE AND THE BOOKING FLOW USED TO DISAGREE, and that is why the prop exists. The page hardcoded
+     * `<h2>` and the televet booking chrome hardcoded `<h1>`, so a partner mounting both in one document got two
+     * competing top levels. A drop-in widget does not own the host page's `<h1>`: the shared default is 2 and a
+     * host whose page IS this surface passes 1. `src/web/headingLevel.ts` carries the full argument.
+     */
+    readonly headingLevel?: number;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+/**
+ * The records surface as a PAGE, mirroring the consumer web app.
+ *
+ * Use this when records are a page in your own web app. Use `EverfurRecords` (the flow) when they
+ * are a stack of screens, which is what a phone-width or framed embed wants.
+ */
+declare function EverfurRecordsPage(props: EverfurRecordsPageProps): ReactNode;
+
+interface EverfurRecordsDashboardProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsDashboard(props: EverfurRecordsDashboardProps): ReactNode;
+
+interface EverfurRecordsRequestProps extends RecordsScreenBaseProps {
+    readonly requestId: RecordsRequestId;
+    readonly controller?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+    readonly nowMs?: number;
+}
+declare function EverfurRecordsRequest(props: EverfurRecordsRequestProps): ReactNode;
+
+interface EverfurRecordDetailProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordDetail(props: EverfurRecordDetailProps): ReactNode;
+
+interface EverfurRecordDocumentProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordDocument(props: EverfurRecordDocumentProps): ReactNode;
+
+interface EverfurRecordsConsentProps extends RecordsScreenBaseProps {
+    readonly clinic: ClinicDraft;
+    readonly ownerName?: string;
+    readonly onCaptureSignature?: CaptureRecordsSignature;
+    readonly onCreated?: (request: RecordsRequestView) => void;
+    readonly controller?: RecordsClinicController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurRecordsConsent(props: EverfurRecordsConsentProps): ReactNode;
+
+interface EverfurClinicPickerProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsClinicController;
+    readonly recordsController?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurClinicPicker(props: EverfurClinicPickerProps): ReactNode;
+
+interface EverfurRecordsUploadProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsUpload(props: EverfurRecordsUploadProps): ReactNode;
+
+interface RequestDocumentsListProps {
+    readonly requestId: string;
+    /**
+     * The surface's own open state. False costs no network and asks for no signed URL it will not
+     * show; true starts the read. Defaults to true for a caller that is always visible.
+     */
+    readonly open?: boolean;
+    readonly testID?: string;
+}
+declare function RequestDocumentsList({ requestId, open, testID, }: RequestDocumentsListProps): ReactNode;
+
+/** One uploaded file, resolved to exactly what the list renders. */
+interface RequestDocumentRow {
+    /** Stable list key: the document's own wire id. */
+    readonly key: string;
+    readonly title: string;
+    /** Format, size and date, whichever the row has, joined with a middle dot. Null when none apply. */
+    readonly meta: string | null;
+    readonly downloadUrl: string;
+}
+/** The wire rows as the list renders them, order preserved (the server sends oldest first). */
+declare function requestDocumentRows(items: readonly {
+    readonly sourceDocId: string;
+    readonly fileName: string | null;
+    readonly docFormat: string | null;
+    readonly byteSize: number | null;
+    readonly receivedAt: string | null;
+    readonly downloadUrl: string;
+}[]): readonly RequestDocumentRow[];
+
+type RequestDocumentsStatus = 'loading' | 'empty' | 'error' | 'populated';
+interface UseRequestDocumentsState {
+    readonly status: RequestDocumentsStatus;
+    /** The rows as the list renders them, oldest first (the server's order, preserved). */
+    readonly rows: readonly RequestDocumentRow[];
+    readonly error: EverfurError | null;
+    /** Read again, which mints fresh signed links. The error state's retry control calls this. */
+    readonly refresh: () => void;
+}
+/**
+ * One documents read for one request, run when `enabled` turns true and on `refresh`.
+ *
+ * `enabled:false` settles to `empty` with no error and never touches the network, so a closed sheet
+ * or a collapsed row costs nothing and asks for no signed URLs it will not show.
+ */
+declare function useRequestDocuments(requestId: string, opts?: {
+    readonly enabled?: boolean;
+}): UseRequestDocumentsState;
+
+interface EverfurClinicRequestProps extends ClinicRequestBaseProps {
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+/** Opt-in clinic release flow, reusing the consumer picker/scope/signature mechanics. */
+declare function EverfurClinicRequest(props: EverfurClinicRequestProps): ReactNode;
+
+interface EverfurClinicRequestBatchProps extends ClinicBatchBaseProps {
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurClinicRequestBatch(props: EverfurClinicRequestBatchProps): ReactNode;
+
+interface WebRecordsUploadTransportOptions {
+    /**
+     * Test seam: the XMLHttpRequest constructor to use. Defaults to the global one. A host has no reason to
+     * set it.
+     */
+    readonly xhr?: () => XMLHttpRequest;
+}
+/**
+ * Create the browser records upload transport. Pass it as `uploadTransport` on the web `EverfurConfig`:
+ *
+ * ```tsx
+ * <EverfurProvider config={{ publishableKey, apiBaseUrl, uploadTransport: createWebRecordsUploadTransport() }} ...>
+ * ```
+ *
+ * It needs the picked file's bytes on `FileHandle.blob` (see `fileToHandle`). A handle with no blob rejects
+ * before any request is made.
+ */
+declare function createWebRecordsUploadTransport(options?: WebRecordsUploadTransportOptions): UploadTransport;
+
+/** The `accept` hint for the picker. A hint only: the signature check above is what decides. */
+declare const RECORDS_DOCUMENT_ACCEPT = "application/pdf,.pdf";
+/** True when the blob starts with the PDF signature. An unreadable blob is not a PDF. */
+declare function isPdfBlob(blob: Blob): Promise<boolean>;
+/**
+ * Build the records `FileHandle` for a browser `File` (or any Blob). `mimeType` is `application/pdf` only when
+ * the bytes carry the PDF signature; `sizeBytes` is the real size, so an oversize file is refused by the
+ * controller before initiate as well.
+ */
+declare function fileToHandle(file: Blob): Promise<FileHandle>;
+/**
+ * The same gate the controller applies before initiate (PDF, 0 < size <= 25 MiB), for a surface that must
+ * decide BEFORE it creates a request: a refused file should not leave an empty request behind.
+ */
+declare function isUploadableHandle(handle: FileHandle): boolean;
+/**
+ * Open the browser's file chooser for one document and resolve its handle, or null when the user picks
+ * nothing. For a host that builds its own records UI on `useEverfurRecords`; the prebuilt surface renders its
+ * own input instead. Must be called from a user gesture (a click handler), or the browser blocks the chooser.
+ *
+ * The input is attached to the document while the chooser is open (Safari does not open a detached input)
+ * and removed once it settles. A browser that never fires `cancel` leaves the promise pending when the user
+ * dismisses the chooser; nothing is held but the closure.
+ */
+declare function pickDocument(doc?: Document): Promise<FileHandle | null>;
+
+interface SignatureCanvasState {
+    readonly canvas: React.RefObject<HTMLCanvasElement>;
+    readonly mode: 'draw' | 'type';
+    readonly typed: string;
+    readonly signed: boolean;
+    readonly setTyped: (value: string) => void;
+    readonly toggle: () => void;
+    readonly clear: () => void;
+    readonly onPointerDown: (event: PointerEvent<HTMLCanvasElement>) => void;
+    readonly onPointerMove: (event: PointerEvent<HTMLCanvasElement>) => void;
+    readonly onPointerUp: () => void;
+    /** The consumer's initiate / direct S3 / complete chain over the current canvas; throws on failure. */
+    readonly register: (controller: RecordsClinicController, signal: AbortSignal) => Promise<{
+        readonly signatureId: string;
+    }>;
+}
+declare function useSignatureCanvas(onEdit?: () => void): SignatureCanvasState;
+/**
+ * The pad, and the ONE place the draw-or-type decision is rendered.
+ *
+ * THE WAY OUT SITS ABOVE THE CANVAS, which is the consumer web app's decision and not a preference.
+ * everfur-frontend RequestRecordsDialog.tsx:658-663 records why, and it records it as something mobile
+ * learned the hard way: with the alternative under the pad, a person who cannot draw has to scroll past the
+ * thing they are stuck on to discover that they do not have to. The rn sibling (src/rn/records/ConsentScreen
+ * .tsx:156-161) still draws its toggle below its `SignaturePad`, so this is one of the places where mirroring
+ * rn would have been the wrong app.
+ *
+ * AND IT IS RENDERED HERE, ONCE, BECAUSE THIS COMPONENT IS THE PAD. Requesting records is the only path by
+ * which a clinic's records enter the product, so the typed alternative is what keeps that path reachable for a
+ * keyboard-only or motor-impaired owner: not degraded, unreachable. Owning the label and the toggle next to
+ * the canvas whose mode they describe is what stops a caller from drawing a SECOND toggle against its own copy
+ * of the mode, which is exactly the defect this replaced (two identical toggles, and the caller's label going
+ * stale the moment the pad's own toggle was the one pressed).
+ */
+declare function SignatureCanvas({ pad, disabled }: {
+    readonly pad: SignatureCanvasState;
+    readonly disabled: boolean;
+}): ReactNode;
+
+export { CaptureRecordsSignature, ClinicBatchBaseProps, ClinicDraft, ClinicRequestBaseProps, EverfurClinicPicker, type EverfurClinicPickerProps, EverfurClinicRequest, EverfurClinicRequestBatch, type EverfurClinicRequestBatchProps, type EverfurClinicRequestProps, EverfurError, EverfurRecordDetail, type EverfurRecordDetailProps, EverfurRecordDocument, type EverfurRecordDocumentProps, EverfurRecords, EverfurRecordsConsent, type EverfurRecordsConsentProps, EverfurRecordsDashboard, type EverfurRecordsDashboardProps, EverfurRecordsFlow, EverfurRecordsPage, type EverfurRecordsPageProps, type EverfurRecordsProps, EverfurRecordsRequest, type EverfurRecordsRequestProps, EverfurRecordsUpload, type EverfurRecordsUploadProps, FileHandle, PetRef, RECORDS_DOCUMENT_ACCEPT, RecordsClinicController, RecordsController, type RecordsHistoryMode, RecordsHostSeams, RecordsRequestId, RecordsRequestView, RecordsScreen, RecordsScreenBaseProps, type RequestDocumentRow, RequestDocumentsList, type RequestDocumentsListProps, type RequestDocumentsStatus, SignatureCanvas, type SignatureCanvasState, UploadTransport, type UseRequestDocumentsState, type WebRecordsUploadTransportOptions, createWebRecordsUploadTransport, fileToHandle, isPdfBlob, isUploadableHandle, pickDocument, requestDocumentRows, useRequestDocuments, useSignatureCanvas };

package/dist/web/records/index.d.ts

@@ -0,0 +1,285 @@
+import { R as RecordsController } from '../../view-Bxwxp4xD.js';
+export { C as ClinicCall, F as FactOverlay, a as REQUEST_TIMELINE_TITLES, b as RecordSharesStatus, c as RecordsDashboardState, d as RecordsDashboardView, e as RecordsEmptyVariant, f as RecordsStatus, g as RequestTimelineEvent, h as RequestTimelineEventKey, i as RequestTimelineEventState, S as ShareRowView, U as UploadDocumentInput, j as UploadQueueItem, k as UploadSkipReason, l as UseEverfurRecordsState, m as UseRecordFactEditState, n as UseRecordPdfLinkState, o as UseRecordSharesState, p as UseRecordsMarkersState, q as applyFactOverlay, r as buildRequestTimeline, s as deriveRecordsDashboardState, t as isFactEditable, u as pickPetRecordsRequest, v as selectClinicCall, w as selectDashboardView, x as selectPrimaryLabel, y as selectRequestList, z as selectRequestTitle, A as useEverfurRecords, B as useEverfurRecordsClinic, D as useEverfurRecordsClinicBatch, E as useRecordFactEdit, G as useRecordPdfLink, H as useRecordShares, I as useRecordsMarkers } from '../../view-Bxwxp4xD.js';
+import { CSSProperties, ReactNode, PointerEvent } from 'react';
+import { P as PetRef, R as RecordsRequestId } from '../../ids-B2GAAifq.js';
+export { B as Brand, D as DocumentId, _ as __brand } from '../../ids-B2GAAifq.js';
+import { d as RecordsHostSeams, i as RecordsClinicController, j as CaptureRecordsSignature, e as RecordsScreen, f as RecordsScreenBaseProps, C as ClinicDraft, k as ClinicRequestBaseProps, l as ClinicBatchBaseProps } from '../../useRecordsDepth-crhBllQK.js';
+export { m as CapturedRecordsSignature, a as ClinicLocation, n as RecordsAsk, R as RecordsAskEntityRef, b as RecordsAskHandler, c as RecordsDepthStatus, o as RecordsNavAction, p as RecordsNavState, q as RecordsSignatureContext, g as RecordsUrlKind, r as RegisterSignaturePng, s as currentRecordsScreen, t as initialRecordsNav, v as popRecordsNav, w as pushRecordsNav, x as recordsNavReducer, y as replaceRecordsNav, z as resetRecordsNav, A as transitionRecordsNav } from '../../useRecordsDepth-crhBllQK.js';
+import { d as RecordsRequestView } from '../../models-B-Uh2LTf.js';
+export { h as ConsentState, C as CreateUploadRequestInput, G as GrantConsentInput, j as RECORDS_TERMINAL, R as RecordDocumentMeta, a as RecordEntity, k as RecordForwardItem, l as RecordIdentityField, b as RecordOrigin, m as RecordSeries, n as RecordSeriesPoint, i as RecordsDenialReason, f as RecordsRequestGroupView, c as RecordsRequestStatus, e as RecordsSimpleStatus, g as RecordsView, U as UploadedDocument, o as isTerminalStatus, r as recordsDenialReasonOf } from '../../models-B-Uh2LTf.js';
+import { E as EverfurError } from '../../EverfurResult-DN9pL2Ab.js';
+export { a as EverfurErrorCategory, b as EverfurErrorCode, c as EverfurResult } from '../../EverfurResult-DN9pL2Ab.js';
+export { C as CreateClinicRequestBatchInput, aa as CreateClinicRequestInput, x as FactFieldValue, A as RECORDS_CLINIC_BATCH_MAX, R as RecordClinicianNote, a as RecordClinicianNoteSection, b as RecordCompleteness, c as RecordConflict, d as RecordConflictCandidate, e as RecordDepthView, f as RecordDocumentContributionsView, g as RecordEncounter, h as RecordExamSystem, B as RecordFactEditInput, D as RecordFactRemoveInput, i as RecordLabMarker, j as RecordLabPoint, E as RecordMarker, G as RecordMarkerLatest, I as RecordMarkerPoint, J as RecordMarkerSummary, K as RecordMarkersView, L as RecordPdfLink, k as RecordPhysicalExam, M as RecordShare, N as RecordShareLink, a9 as RecordsAuthorizationCopy, O as RecordsAuthorizationSignature, l as RecordsClinic, P as RecordsClinicBatch, Q as RecordsClinicBatchClient, S as RecordsClinicBatchItem, T as RecordsClinicBatchResult, a6 as RecordsClinicSearchInput, a7 as RecordsClinicSearchPage, U as RecordsClinicTarget, m as RecordsDepthClient, a8 as RecordsRecentClinicsInput, n as RecordsRequestDocument, V as RecordsSignatureSuggestion, ab as RecordsSignatureUploadPolicy, o as RecordsTimelineMedication, p as RecordsTimelineVaccine, q as RecordsTimelineView, r as RecordsTimelineVisit, s as RecordsTimelineWeight } from '../../depth-DvPwPuT_.js';
+export { a as EverfurDocumentContributionsProps, c as EverfurRecordsDepthProps } from '../../DepthViews-BG3E25MD.js';
+import { U as UploadTransport, F as FileHandle } from '../../ports-BN6RHF9W.js';
+export { a as UploadPolicyWire } from '../../ports-BN6RHF9W.js';
+import '../../requestFunnel-DFMGcluw.js';
+import '../../ErrorPolicyPort-CwbfmxzJ.js';
+import '../../config-C7eb_IMD.js';
+import '../../identity-CEi9GRFZ.js';
+
+type RecordsHistoryMode = 'memory' | 'browser';
+interface EverfurRecordsProps 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;
+    /** Host/test seam: inject a records controller instead of acquiring one from the runtime. */
+    readonly controller?: RecordsController;
+    /** Host/test seam over the clinic controller. */
+    readonly clinicController?: RecordsClinicController;
+    /** The consent-text version the content-exposure grant records (host/product owned). */
+    readonly consentVersion?: string;
+    /** The owner's name the clinic authorization is signed with (the owner can correct it before signing). */
+    readonly ownerName?: string;
+    /** A host signature component for the clinic authorization, instead of the built-in canvas. */
+    readonly onCaptureSignature?: CaptureRecordsSignature;
+    /** The screen the flow starts on; the dashboard when omitted. */
+    readonly initialScreen?: RecordsScreen;
+    /** `memory` (default) keeps the stack in state; `browser` mirrors it onto the history stack. */
+    readonly historyMode?: RecordsHistoryMode;
+    /** The root screen's back control; absent, the root draws none. */
+    readonly onExit?: () => void;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    /** Your own placeholder while the entitlement verdict is pending on a cold mount. */
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsFlow(props: EverfurRecordsProps): ReactNode;
+/** The public prebuilt records surface: the flow, starting at the dashboard. */
+declare const EverfurRecords: typeof EverfurRecordsFlow;
+
+interface EverfurRecordsPageProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    /**
+     * The heading level this page's title claims. Defaults to 2.
+     *
+     * THIS PAGE AND THE BOOKING FLOW USED TO DISAGREE, and that is why the prop exists. The page hardcoded
+     * `<h2>` and the televet booking chrome hardcoded `<h1>`, so a partner mounting both in one document got two
+     * competing top levels. A drop-in widget does not own the host page's `<h1>`: the shared default is 2 and a
+     * host whose page IS this surface passes 1. `src/web/headingLevel.ts` carries the full argument.
+     */
+    readonly headingLevel?: number;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+/**
+ * The records surface as a PAGE, mirroring the consumer web app.
+ *
+ * Use this when records are a page in your own web app. Use `EverfurRecords` (the flow) when they
+ * are a stack of screens, which is what a phone-width or framed embed wants.
+ */
+declare function EverfurRecordsPage(props: EverfurRecordsPageProps): ReactNode;
+
+interface EverfurRecordsDashboardProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsDashboard(props: EverfurRecordsDashboardProps): ReactNode;
+
+interface EverfurRecordsRequestProps extends RecordsScreenBaseProps {
+    readonly requestId: RecordsRequestId;
+    readonly controller?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+    readonly nowMs?: number;
+}
+declare function EverfurRecordsRequest(props: EverfurRecordsRequestProps): ReactNode;
+
+interface EverfurRecordDetailProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordDetail(props: EverfurRecordDetailProps): ReactNode;
+
+interface EverfurRecordDocumentProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly consentVersion?: string;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordDocument(props: EverfurRecordDocumentProps): ReactNode;
+
+interface EverfurRecordsConsentProps extends RecordsScreenBaseProps {
+    readonly clinic: ClinicDraft;
+    readonly ownerName?: string;
+    readonly onCaptureSignature?: CaptureRecordsSignature;
+    readonly onCreated?: (request: RecordsRequestView) => void;
+    readonly controller?: RecordsClinicController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurRecordsConsent(props: EverfurRecordsConsentProps): ReactNode;
+
+interface EverfurClinicPickerProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsClinicController;
+    readonly recordsController?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurClinicPicker(props: EverfurClinicPickerProps): ReactNode;
+
+interface EverfurRecordsUploadProps extends RecordsScreenBaseProps {
+    readonly controller?: RecordsController;
+    readonly style?: CSSProperties;
+    readonly className?: string;
+    readonly renderPending?: () => ReactNode;
+}
+declare function EverfurRecordsUpload(props: EverfurRecordsUploadProps): ReactNode;
+
+interface RequestDocumentsListProps {
+    readonly requestId: string;
+    /**
+     * The surface's own open state. False costs no network and asks for no signed URL it will not
+     * show; true starts the read. Defaults to true for a caller that is always visible.
+     */
+    readonly open?: boolean;
+    readonly testID?: string;
+}
+declare function RequestDocumentsList({ requestId, open, testID, }: RequestDocumentsListProps): ReactNode;
+
+/** One uploaded file, resolved to exactly what the list renders. */
+interface RequestDocumentRow {
+    /** Stable list key: the document's own wire id. */
+    readonly key: string;
+    readonly title: string;
+    /** Format, size and date, whichever the row has, joined with a middle dot. Null when none apply. */
+    readonly meta: string | null;
+    readonly downloadUrl: string;
+}
+/** The wire rows as the list renders them, order preserved (the server sends oldest first). */
+declare function requestDocumentRows(items: readonly {
+    readonly sourceDocId: string;
+    readonly fileName: string | null;
+    readonly docFormat: string | null;
+    readonly byteSize: number | null;
+    readonly receivedAt: string | null;
+    readonly downloadUrl: string;
+}[]): readonly RequestDocumentRow[];
+
+type RequestDocumentsStatus = 'loading' | 'empty' | 'error' | 'populated';
+interface UseRequestDocumentsState {
+    readonly status: RequestDocumentsStatus;
+    /** The rows as the list renders them, oldest first (the server's order, preserved). */
+    readonly rows: readonly RequestDocumentRow[];
+    readonly error: EverfurError | null;
+    /** Read again, which mints fresh signed links. The error state's retry control calls this. */
+    readonly refresh: () => void;
+}
+/**
+ * One documents read for one request, run when `enabled` turns true and on `refresh`.
+ *
+ * `enabled:false` settles to `empty` with no error and never touches the network, so a closed sheet
+ * or a collapsed row costs nothing and asks for no signed URLs it will not show.
+ */
+declare function useRequestDocuments(requestId: string, opts?: {
+    readonly enabled?: boolean;
+}): UseRequestDocumentsState;
+
+interface EverfurClinicRequestProps extends ClinicRequestBaseProps {
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+/** Opt-in clinic release flow, reusing the consumer picker/scope/signature mechanics. */
+declare function EverfurClinicRequest(props: EverfurClinicRequestProps): ReactNode;
+
+interface EverfurClinicRequestBatchProps extends ClinicBatchBaseProps {
+    readonly style?: CSSProperties;
+    readonly className?: string;
+}
+declare function EverfurClinicRequestBatch(props: EverfurClinicRequestBatchProps): ReactNode;
+
+interface WebRecordsUploadTransportOptions {
+    /**
+     * Test seam: the XMLHttpRequest constructor to use. Defaults to the global one. A host has no reason to
+     * set it.
+     */
+    readonly xhr?: () => XMLHttpRequest;
+}
+/**
+ * Create the browser records upload transport. Pass it as `uploadTransport` on the web `EverfurConfig`:
+ *
+ * ```tsx
+ * <EverfurProvider config={{ publishableKey, apiBaseUrl, uploadTransport: createWebRecordsUploadTransport() }} ...>
+ * ```
+ *
+ * It needs the picked file's bytes on `FileHandle.blob` (see `fileToHandle`). A handle with no blob rejects
+ * before any request is made.
+ */
+declare function createWebRecordsUploadTransport(options?: WebRecordsUploadTransportOptions): UploadTransport;
+
+/** The `accept` hint for the picker. A hint only: the signature check above is what decides. */
+declare const RECORDS_DOCUMENT_ACCEPT = "application/pdf,.pdf";
+/** True when the blob starts with the PDF signature. An unreadable blob is not a PDF. */
+declare function isPdfBlob(blob: Blob): Promise<boolean>;
+/**
+ * Build the records `FileHandle` for a browser `File` (or any Blob). `mimeType` is `application/pdf` only when
+ * the bytes carry the PDF signature; `sizeBytes` is the real size, so an oversize file is refused by the
+ * controller before initiate as well.
+ */
+declare function fileToHandle(file: Blob): Promise<FileHandle>;
+/**
+ * The same gate the controller applies before initiate (PDF, 0 < size <= 25 MiB), for a surface that must
+ * decide BEFORE it creates a request: a refused file should not leave an empty request behind.
+ */
+declare function isUploadableHandle(handle: FileHandle): boolean;
+/**
+ * Open the browser's file chooser for one document and resolve its handle, or null when the user picks
+ * nothing. For a host that builds its own records UI on `useEverfurRecords`; the prebuilt surface renders its
+ * own input instead. Must be called from a user gesture (a click handler), or the browser blocks the chooser.
+ *
+ * The input is attached to the document while the chooser is open (Safari does not open a detached input)
+ * and removed once it settles. A browser that never fires `cancel` leaves the promise pending when the user
+ * dismisses the chooser; nothing is held but the closure.
+ */
+declare function pickDocument(doc?: Document): Promise<FileHandle | null>;
+
+interface SignatureCanvasState {
+    readonly canvas: React.RefObject<HTMLCanvasElement>;
+    readonly mode: 'draw' | 'type';
+    readonly typed: string;
+    readonly signed: boolean;
+    readonly setTyped: (value: string) => void;
+    readonly toggle: () => void;
+    readonly clear: () => void;
+    readonly onPointerDown: (event: PointerEvent<HTMLCanvasElement>) => void;
+    readonly onPointerMove: (event: PointerEvent<HTMLCanvasElement>) => void;
+    readonly onPointerUp: () => void;
+    /** The consumer's initiate / direct S3 / complete chain over the current canvas; throws on failure. */
+    readonly register: (controller: RecordsClinicController, signal: AbortSignal) => Promise<{
+        readonly signatureId: string;
+    }>;
+}
+declare function useSignatureCanvas(onEdit?: () => void): SignatureCanvasState;
+/**
+ * The pad, and the ONE place the draw-or-type decision is rendered.
+ *
+ * THE WAY OUT SITS ABOVE THE CANVAS, which is the consumer web app's decision and not a preference.
+ * everfur-frontend RequestRecordsDialog.tsx:658-663 records why, and it records it as something mobile
+ * learned the hard way: with the alternative under the pad, a person who cannot draw has to scroll past the
+ * thing they are stuck on to discover that they do not have to. The rn sibling (src/rn/records/ConsentScreen
+ * .tsx:156-161) still draws its toggle below its `SignaturePad`, so this is one of the places where mirroring
+ * rn would have been the wrong app.
+ *
+ * AND IT IS RENDERED HERE, ONCE, BECAUSE THIS COMPONENT IS THE PAD. Requesting records is the only path by
+ * which a clinic's records enter the product, so the typed alternative is what keeps that path reachable for a
+ * keyboard-only or motor-impaired owner: not degraded, unreachable. Owning the label and the toggle next to
+ * the canvas whose mode they describe is what stops a caller from drawing a SECOND toggle against its own copy
+ * of the mode, which is exactly the defect this replaced (two identical toggles, and the caller's label going
+ * stale the moment the pad's own toggle was the one pressed).
+ */
+declare function SignatureCanvas({ pad, disabled }: {
+    readonly pad: SignatureCanvasState;
+    readonly disabled: boolean;
+}): ReactNode;
+
+export { CaptureRecordsSignature, ClinicBatchBaseProps, ClinicDraft, ClinicRequestBaseProps, EverfurClinicPicker, type EverfurClinicPickerProps, EverfurClinicRequest, EverfurClinicRequestBatch, type EverfurClinicRequestBatchProps, type EverfurClinicRequestProps, EverfurError, EverfurRecordDetail, type EverfurRecordDetailProps, EverfurRecordDocument, type EverfurRecordDocumentProps, EverfurRecords, EverfurRecordsConsent, type EverfurRecordsConsentProps, EverfurRecordsDashboard, type EverfurRecordsDashboardProps, EverfurRecordsFlow, EverfurRecordsPage, type EverfurRecordsPageProps, type EverfurRecordsProps, EverfurRecordsRequest, type EverfurRecordsRequestProps, EverfurRecordsUpload, type EverfurRecordsUploadProps, FileHandle, PetRef, RECORDS_DOCUMENT_ACCEPT, RecordsClinicController, RecordsController, type RecordsHistoryMode, RecordsHostSeams, RecordsRequestId, RecordsRequestView, RecordsScreen, RecordsScreenBaseProps, type RequestDocumentRow, RequestDocumentsList, type RequestDocumentsListProps, type RequestDocumentsStatus, SignatureCanvas, type SignatureCanvasState, UploadTransport, type UseRequestDocumentsState, type WebRecordsUploadTransportOptions, createWebRecordsUploadTransport, fileToHandle, isPdfBlob, isUploadableHandle, pickDocument, requestDocumentRows, useRequestDocuments, useSignatureCanvas };