@everfur/sdk 0.12.0 → 0.13.0

package/dist/{ports-BN6RHF9W.d.cts → ports.d-BX4f4UsB.d.ts}

@@ -32,6 +32,19 @@ interface UploadPolicyWire {
     readonly expires_in_seconds: number;
     readonly max_content_length: number;
 }
+interface RecordsRecordWire {
+    readonly withheld?: boolean;
+    readonly pet_ref?: string;
+    readonly schema_version?: string;
+    readonly is_empty?: boolean;
+    readonly generated_at?: string | null;
+    readonly disclaimer?: string;
+    readonly identity?: unknown;
+    readonly entities?: unknown;
+    readonly entity_series?: unknown;
+    readonly forward_looking?: unknown;
+    readonly documents?: unknown;
+}
 /**
  * Platform-specific: the rn adapter binds `expo-file-system` (uploadAsync) behind `optionalModule`; the
  * controller stays platform-neutral and never sees a native module. Resolves on S3's 204; rejects on a
@@ -45,4 +58,4 @@ interface UploadTransport {
     }): Promise<void>;
 }
 
-export type { FileHandle as F, UploadTransport as U, UploadPolicyWire as a, FilePort as b };
+export type { FileHandle as F, RecordsRecordWire as R, UploadTransport as U, UploadPolicyWire as a, FilePort as b };

package/dist/{ports-RuNJmBA-.d.cts → ports.d-CEROoqnA.d.cts}

@@ -1,13 +1,13 @@
-import { C as CheckinAnswer, a as CheckinOutcome } from './casesRepository-CGdhvzTu.cjs';
-import { A as AuthContext } from './identity-DFVGYn1o.cjs';
-import { E as EverfurError } from './EverfurError-DeBqRpQV.cjs';
-import { E as EverfurResult } from './EverfurResult-COlXj1wq.cjs';
-import { R as RequestFunnel } from './requestFunnel-BBjNNwc9.cjs';
-import { P as PetRef, C as ConversationId, b as ResponseId } from './ids-B2GAAifq.cjs';
-import { i as UrgencyLevel, F as Frame } from './config-B0p6Lygh.cjs';
-import { E as ErrorPolicyPort } from './ErrorPolicyPort-10s3HJCt.cjs';
-import { T as TelemetryPort } from './TelemetryPort-BDNr00hu.cjs';
-import { F as FileHandle } from './ports-BN6RHF9W.cjs';
+import { C as CheckinAnswer, a as CheckinOutcome } from './casesRepository.d-CT2LTicS.cjs';
+import { A as AuthContext } from './identity.d-60LeJt_s.cjs';
+import { E as EverfurError } from './EverfurError.d-8NHtlgzA.cjs';
+import { E as EverfurResult } from './EverfurResult.d-BFH-3s6E.cjs';
+import { R as RequestFunnel } from './requestFunnel.d-DWQQpjFR.cjs';
+import { P as PetRef, C as ConversationId, b as ResponseId } from './ids.d-B2GAAifq.cjs';
+import { i as UrgencyLevel, F as Frame } from './config.d-BR3DT9ho.cjs';
+import { E as ErrorPolicyPort } from './ErrorPolicyPort.d-DirW9hgO.cjs';
+import { T as TelemetryPort } from './TelemetryPort.d-BDNr00hu.cjs';
+import { F as FileHandle } from './ports.d-BX4f4UsB.cjs';
 
 /** Injectable timers so the watchdog + deadlines are testable with a fake clock (no direct setTimeout). */
 interface Timers$1 {
@@ -27,6 +27,12 @@ interface ChatConversation {
      * did not carry it, which means the server does not speak unread, never "all read".
      */
     readonly unreadCount: number | null;
+    /**
+     * The last assistant message of the thread as plain text, at most 140 characters (`preview`). Absent when the
+     * thread has no reply yet or the server does not send previews; a value of the wrong type is ignored, never an
+     * error, so an older server degrades to no preview.
+     */
+    readonly preview?: string;
 }
 interface ChatHistoryOptions {
     readonly cursor?: string;

package/dist/{ports-DmQeMArX.d.ts → ports.d-COIyN624.d.ts}

@@ -1,13 +1,13 @@
-import { C as CheckinAnswer, a as CheckinOutcome } from './casesRepository-ZG9Sg0e4.js';
-import { A as AuthContext } from './identity-Cw07BKZp.js';
-import { E as EverfurError } from './EverfurError-DeBqRpQV.js';
-import { E as EverfurResult } from './EverfurResult-ClPTS0P2.js';
-import { R as RequestFunnel } from './requestFunnel-B9fdXMi5.js';
-import { P as PetRef, C as ConversationId, b as ResponseId } from './ids-B2GAAifq.js';
-import { i as UrgencyLevel, F as Frame } from './config-DmFAZJOx.js';
-import { E as ErrorPolicyPort } from './ErrorPolicyPort-C3nNSS_j.js';
-import { T as TelemetryPort } from './TelemetryPort-BDNr00hu.js';
-import { F as FileHandle } from './ports-BN6RHF9W.js';
+import { C as CheckinAnswer, a as CheckinOutcome } from './casesRepository.d-UsWOz9bv.js';
+import { A as AuthContext } from './identity.d-DzTijonw.js';
+import { E as EverfurError } from './EverfurError.d-8NHtlgzA.js';
+import { E as EverfurResult } from './EverfurResult.d-D_-254ZY.js';
+import { R as RequestFunnel } from './requestFunnel.d-CXUMPw1K.js';
+import { P as PetRef, C as ConversationId, b as ResponseId } from './ids.d-B2GAAifq.js';
+import { i as UrgencyLevel, F as Frame } from './config.d-Dy6igYlH.js';
+import { E as ErrorPolicyPort } from './ErrorPolicyPort.d-68yrE3BE.js';
+import { T as TelemetryPort } from './TelemetryPort.d-BDNr00hu.js';
+import { F as FileHandle } from './ports.d-BX4f4UsB.js';
 
 /** Injectable timers so the watchdog + deadlines are testable with a fake clock (no direct setTimeout). */
 interface Timers$1 {
@@ -27,6 +27,12 @@ interface ChatConversation {
      * did not carry it, which means the server does not speak unread, never "all read".
      */
     readonly unreadCount: number | null;
+    /**
+     * The last assistant message of the thread as plain text, at most 140 characters (`preview`). Absent when the
+     * thread has no reply yet or the server does not send previews; a value of the wrong type is ignored, never an
+     * error, so an older server degrades to no preview.
+     */
+    readonly preview?: string;
 }
 interface ChatHistoryOptions {
     readonly cursor?: string;

package/dist/presentation.d-DMbdad7G.d.cts

@@ -0,0 +1,90 @@
+/** Where the chat draws an assistant answer: in a bubble, or as Raph's open answer with cards (default). */
+type EverfurChatAnswerStyle = 'bubbles' | 'cards';
+/** How the chat lists past conversations: the side drawer, or a bottom sheet with previews (default). */
+type EverfurChatHistoryStyle = 'drawer' | 'sheet';
+/** The card above the chat's empty state: none, or the focus card ("Her focus", default; drawn only when there is a focus). */
+type EverfurChatTopCardSetting = 'none' | 'focus';
+/** Where the chat's safety disclaimer sits: under the composer (default) or at the foot of the answers. */
+type EverfurSafetyDisclaimerPlacement = 'composer' | 'answer_footer';
+/** The Health Plan tab layout: the standard list, or the focus plan (Raph v3, default). */
+type EverfurHealthPlanLayout = 'standard' | 'focus_plan';
+/** The chat composer: the standard bar, or Raph's compact 50px bar with an up-arrow send (default). */
+type EverfurChatComposerStyle = 'standard' | 'compact';
+/** The composer placeholder: the generic text, or one that names the active pet (default; generic with no name). */
+type EverfurChatComposerPlaceholder = 'generic' | 'pet_name';
+/** The past-chats bar: pinned above the thread, or scrolling with it (default). */
+type EverfurChatHistoryBarSetting = 'pinned' | 'scroll';
+/** The chat's send button while the box is empty: drawn dark (default) or dimmed until there is text (the older look). */
+type EverfurChatSendButtonSetting = 'always_dark' | 'dim_when_empty';
+/** The resolved presentation settings (every field set). camelCase of the wire names. */
+interface EverfurPresentation {
+    readonly chatAnswerStyle: EverfurChatAnswerStyle;
+    readonly chatHistoryStyle: EverfurChatHistoryStyle;
+    readonly chatTopCard: EverfurChatTopCardSetting;
+    /** How many follow-up questions to offer under an answer, 0..3. */
+    readonly chatFollowUpCount: number;
+    /** true leaves the televet (book a vet) follow-ups out. */
+    readonly chatFollowUpsExcludeTelevet: boolean;
+    /** false hides the composer's dictation (mic) button. */
+    readonly chatComposerMic: boolean;
+    /** false hides the composer's photo upload button. */
+    readonly chatComposerUpload: boolean;
+    readonly safetyDisclaimerPlacement: EverfurSafetyDisclaimerPlacement;
+    readonly healthPlanLayout: EverfurHealthPlanLayout;
+    /** true shows the top risk line above the records. */
+    readonly recordsTopRiskLine: boolean;
+    /** true offers the "clear results" filter on the records. */
+    readonly recordsClearResultsFilter: boolean;
+    readonly chatComposerStyle: EverfurChatComposerStyle;
+    /** 'pet_name' names the active pet; with no pet it falls back to the generic text. */
+    readonly chatComposerPlaceholder: EverfurChatComposerPlaceholder;
+    readonly chatHistoryBar: EverfurChatHistoryBarSetting;
+    /**
+     * false hides only the general ("Good to know") banner. Urgent and safety banners always show; there is no
+     * setting that hides them.
+     */
+    readonly chatGeneralBanner: boolean;
+    /**
+     * The send button while the box is empty. `always_dark` (the default, also when the console sets nothing) draws it
+     * at full strength; `dim_when_empty` dims it until there is text. Either way an empty box sends nothing.
+     */
+    readonly chatSendButton: EverfurChatSendButtonSetting;
+}
+/** A partial presentation: what the console sets, or what a partner passes as a prop. */
+type EverfurPresentationInput = Partial<EverfurPresentation>;
+type EverfurPresentationField = keyof EverfurPresentation;
+/**
+ * What every partner that sets nothing renders: Raph's v3 design (owner decision 2026-10-21, STATE-MATRIX (b)1).
+ * Each v3 choice draws nothing extra when its data is missing: the focus card and the records top risk line need the
+ * plan page's `focus`, the pet-name placeholder falls back to the generic text with no pet name. The older look is
+ * one setting away per field (`bubbles`, `drawer`, `none`, `standard`, `generic`, `pinned`, false).
+ */
+declare const DEFAULT_PRESENTATION: EverfurPresentation;
+/** The wire name of each field (EFBackend's final names). */
+declare const PRESENTATION_WIRE_NAMES: Readonly<Record<EverfurPresentationField, string>>;
+/** The `locked_fields` name that locks every presentation field. */
+declare const PRESENTATION_LOCK = "presentation";
+/** The `locked_fields` prefix that locks one presentation field (`presentation.<wire field>`). */
+declare const PRESENTATION_LOCK_PREFIX = "presentation.";
+/** true for `presentation` or `presentation.<known wire field>`. */
+declare function isPresentationLockName(name: string): boolean;
+/**
+ * Parse an untrusted presentation object (the wire's snake_case, or camelCase from a prop). Keeps only the
+ * fields that pass the same checks EFBackend applies (enum, real boolean, whole number 0..3); a bad field is
+ * dropped alone. Not an object, or nothing valid -> null. Never throws.
+ */
+declare function parsePresentation(raw: unknown): EverfurPresentationInput | null;
+/** true when `locked_fields` keeps this presentation field server-wins. */
+declare function isPresentationFieldLocked(field: EverfurPresentationField, locked: Iterable<string> | null | undefined): boolean;
+/**
+ * Resolve the presentation per field: a locked field takes the server value (or the default); any other field
+ * takes the client value, then the server value, then the default. The client input is parsed through the same
+ * checks, so a bad prop value is ignored rather than rendered. PURE and TOTAL: never throws, always complete.
+ */
+declare function resolvePresentation(input?: {
+    readonly server?: EverfurPresentationInput | null;
+    readonly locked?: Iterable<string> | null;
+    readonly client?: EverfurPresentationInput | null;
+}): EverfurPresentation;
+
+export { DEFAULT_PRESENTATION as D, type EverfurChatAnswerStyle as E, PRESENTATION_LOCK as P, type EverfurChatComposerPlaceholder as a, type EverfurChatComposerStyle as b, type EverfurChatHistoryBarSetting as c, type EverfurChatHistoryStyle as d, type EverfurChatSendButtonSetting as e, type EverfurChatTopCardSetting as f, type EverfurHealthPlanLayout as g, type EverfurPresentation as h, type EverfurPresentationInput as i, type EverfurSafetyDisclaimerPlacement as j, PRESENTATION_LOCK_PREFIX as k, type EverfurPresentationField as l, PRESENTATION_WIRE_NAMES as m, isPresentationFieldLocked as n, isPresentationLockName as o, parsePresentation as p, resolvePresentation as r };

package/dist/presentation.d-DMbdad7G.d.ts

@@ -0,0 +1,90 @@
+/** Where the chat draws an assistant answer: in a bubble, or as Raph's open answer with cards (default). */
+type EverfurChatAnswerStyle = 'bubbles' | 'cards';
+/** How the chat lists past conversations: the side drawer, or a bottom sheet with previews (default). */
+type EverfurChatHistoryStyle = 'drawer' | 'sheet';
+/** The card above the chat's empty state: none, or the focus card ("Her focus", default; drawn only when there is a focus). */
+type EverfurChatTopCardSetting = 'none' | 'focus';
+/** Where the chat's safety disclaimer sits: under the composer (default) or at the foot of the answers. */
+type EverfurSafetyDisclaimerPlacement = 'composer' | 'answer_footer';
+/** The Health Plan tab layout: the standard list, or the focus plan (Raph v3, default). */
+type EverfurHealthPlanLayout = 'standard' | 'focus_plan';
+/** The chat composer: the standard bar, or Raph's compact 50px bar with an up-arrow send (default). */
+type EverfurChatComposerStyle = 'standard' | 'compact';
+/** The composer placeholder: the generic text, or one that names the active pet (default; generic with no name). */
+type EverfurChatComposerPlaceholder = 'generic' | 'pet_name';
+/** The past-chats bar: pinned above the thread, or scrolling with it (default). */
+type EverfurChatHistoryBarSetting = 'pinned' | 'scroll';
+/** The chat's send button while the box is empty: drawn dark (default) or dimmed until there is text (the older look). */
+type EverfurChatSendButtonSetting = 'always_dark' | 'dim_when_empty';
+/** The resolved presentation settings (every field set). camelCase of the wire names. */
+interface EverfurPresentation {
+    readonly chatAnswerStyle: EverfurChatAnswerStyle;
+    readonly chatHistoryStyle: EverfurChatHistoryStyle;
+    readonly chatTopCard: EverfurChatTopCardSetting;
+    /** How many follow-up questions to offer under an answer, 0..3. */
+    readonly chatFollowUpCount: number;
+    /** true leaves the televet (book a vet) follow-ups out. */
+    readonly chatFollowUpsExcludeTelevet: boolean;
+    /** false hides the composer's dictation (mic) button. */
+    readonly chatComposerMic: boolean;
+    /** false hides the composer's photo upload button. */
+    readonly chatComposerUpload: boolean;
+    readonly safetyDisclaimerPlacement: EverfurSafetyDisclaimerPlacement;
+    readonly healthPlanLayout: EverfurHealthPlanLayout;
+    /** true shows the top risk line above the records. */
+    readonly recordsTopRiskLine: boolean;
+    /** true offers the "clear results" filter on the records. */
+    readonly recordsClearResultsFilter: boolean;
+    readonly chatComposerStyle: EverfurChatComposerStyle;
+    /** 'pet_name' names the active pet; with no pet it falls back to the generic text. */
+    readonly chatComposerPlaceholder: EverfurChatComposerPlaceholder;
+    readonly chatHistoryBar: EverfurChatHistoryBarSetting;
+    /**
+     * false hides only the general ("Good to know") banner. Urgent and safety banners always show; there is no
+     * setting that hides them.
+     */
+    readonly chatGeneralBanner: boolean;
+    /**
+     * The send button while the box is empty. `always_dark` (the default, also when the console sets nothing) draws it
+     * at full strength; `dim_when_empty` dims it until there is text. Either way an empty box sends nothing.
+     */
+    readonly chatSendButton: EverfurChatSendButtonSetting;
+}
+/** A partial presentation: what the console sets, or what a partner passes as a prop. */
+type EverfurPresentationInput = Partial<EverfurPresentation>;
+type EverfurPresentationField = keyof EverfurPresentation;
+/**
+ * What every partner that sets nothing renders: Raph's v3 design (owner decision 2026-10-21, STATE-MATRIX (b)1).
+ * Each v3 choice draws nothing extra when its data is missing: the focus card and the records top risk line need the
+ * plan page's `focus`, the pet-name placeholder falls back to the generic text with no pet name. The older look is
+ * one setting away per field (`bubbles`, `drawer`, `none`, `standard`, `generic`, `pinned`, false).
+ */
+declare const DEFAULT_PRESENTATION: EverfurPresentation;
+/** The wire name of each field (EFBackend's final names). */
+declare const PRESENTATION_WIRE_NAMES: Readonly<Record<EverfurPresentationField, string>>;
+/** The `locked_fields` name that locks every presentation field. */
+declare const PRESENTATION_LOCK = "presentation";
+/** The `locked_fields` prefix that locks one presentation field (`presentation.<wire field>`). */
+declare const PRESENTATION_LOCK_PREFIX = "presentation.";
+/** true for `presentation` or `presentation.<known wire field>`. */
+declare function isPresentationLockName(name: string): boolean;
+/**
+ * Parse an untrusted presentation object (the wire's snake_case, or camelCase from a prop). Keeps only the
+ * fields that pass the same checks EFBackend applies (enum, real boolean, whole number 0..3); a bad field is
+ * dropped alone. Not an object, or nothing valid -> null. Never throws.
+ */
+declare function parsePresentation(raw: unknown): EverfurPresentationInput | null;
+/** true when `locked_fields` keeps this presentation field server-wins. */
+declare function isPresentationFieldLocked(field: EverfurPresentationField, locked: Iterable<string> | null | undefined): boolean;
+/**
+ * Resolve the presentation per field: a locked field takes the server value (or the default); any other field
+ * takes the client value, then the server value, then the default. The client input is parsed through the same
+ * checks, so a bad prop value is ignored rather than rendered. PURE and TOTAL: never throws, always complete.
+ */
+declare function resolvePresentation(input?: {
+    readonly server?: EverfurPresentationInput | null;
+    readonly locked?: Iterable<string> | null;
+    readonly client?: EverfurPresentationInput | null;
+}): EverfurPresentation;
+
+export { DEFAULT_PRESENTATION as D, type EverfurChatAnswerStyle as E, PRESENTATION_LOCK as P, type EverfurChatComposerPlaceholder as a, type EverfurChatComposerStyle as b, type EverfurChatHistoryBarSetting as c, type EverfurChatHistoryStyle as d, type EverfurChatSendButtonSetting as e, type EverfurChatTopCardSetting as f, type EverfurHealthPlanLayout as g, type EverfurPresentation as h, type EverfurPresentationInput as i, type EverfurSafetyDisclaimerPlacement as j, PRESENTATION_LOCK_PREFIX as k, type EverfurPresentationField as l, PRESENTATION_WIRE_NAMES as m, isPresentationFieldLocked as n, isPresentationLockName as o, parsePresentation as p, resolvePresentation as r };