@everfur/sdk 0.8.0 → 0.9.0

package/dist/{branding-BwEu68C8.d.cts → branding-ctD0B2Th.d.cts}

@@ -1,4 +1,4 @@
-import { p as EverfurThemeSlotName, a as EverfurFontFaceKey, q as EverfurThemeSlots } from './tokens-Tzo1KBND.cjs';
+import { d as EverfurFontWeight, q as EverfurThemeSlotName, a as EverfurFontFaceKey, r as EverfurThemeSlots, c as EverfurFontSource } from './tokens-RAKZj7M8.cjs';
 
 /** The presets an appearance may start from. `everfur` is the compiled default. */
 declare const APPEARANCE_PRESET_NAMES: readonly ["everfur", "minimal", "night"];
@@ -13,6 +13,12 @@ type EverfurAppearancePreset = (typeof APPEARANCE_PRESET_NAMES)[number];
  *   - `borderRadius` -> `border_radius` (px, 0 to 32; the medium corner, default 14)
  *   - `spacingUnit` -> `spacing_unit` (px, 3 to 6; the smallest step, default 4)
  *   - `colorScheme` -> `color_scheme` (`light`, `dark` or `auto`)
+ *   - `colorSuccess` / `colorWarning` / `colorInfo` -> `success_color` / `warning_color` / `info_color` (the `_dark`
+ *     twins under a dark scheme, as `colorDanger`)
+ *   - `fontFamilyHeading` -> `heading_font_family`
+ *   - `fontWeightBody` / `fontWeightHeading` -> `font_weight_body` / `font_weight_heading` (100 to 900 in hundreds)
+ *   - `lineHeight` -> `line_height` (1.0 to 2.0, a multiple of the font size; default 1.4)
+ *   - `logoUrl` -> `logo_url`, `assistantAvatarUrl` -> `assistant_avatar_url` (https only)
  */
 interface EverfurAppearanceVariables {
     readonly colorPrimary?: string | number;
@@ -25,17 +31,42 @@ interface EverfurAppearanceVariables {
     readonly borderRadius?: number | string;
     readonly spacingUnit?: number | string;
     readonly colorScheme?: 'light' | 'dark' | 'auto' | string;
+    readonly colorSuccess?: string | number;
+    readonly colorWarning?: string | number;
+    readonly colorInfo?: string | number;
+    readonly fontFamilyHeading?: string;
+    readonly fontWeightBody?: EverfurFontWeight | number;
+    readonly fontWeightHeading?: EverfurFontWeight | number;
+    readonly lineHeight?: number | string;
+    readonly logoUrl?: string;
+    readonly assistantAvatarUrl?: string;
 }
 /**
- * Per-component rules: the nine paint slots, each with the slot paint keys (camelCase or the wire's snake_case).
+ * One font the web host loads (Stripe's `CustomFontSource` / `CssFontSource`): `family` and exactly one of `src`
+ * (an https font file) or `cssSrc` (an https stylesheet). React Native never fetches a font: register it with
+ * expo-font and name the family in `fontFamily` / `fontFamilyHeading`.
+ */
+interface EverfurAppearanceFont {
+    readonly family: string;
+    readonly src?: string;
+    readonly cssSrc?: string;
+    readonly weight?: EverfurFontWeight | number;
+    readonly style?: 'normal' | 'italic';
+}
+/**
+ * Per-component rules: the paint slots, each with the slot paint keys (camelCase or the wire's snake_case).
  * Stripe's `.Class` selectors (`.Input`, `.Tab:hover`) are not slots and are ignored.
  */
 type EverfurAppearanceRules = Readonly<Partial<Record<EverfurThemeSlotName, EverfurThemeSlotInput>>>;
-/** The Stripe-shaped appearance object: a preset, global variables, and per-slot rules. Every key optional. */
+/**
+ * The Stripe-shaped appearance object: a preset, global variables, per-slot rules, and the fonts the web host loads
+ * (at most four). Every key optional.
+ */
 interface EverfurAppearance {
     readonly theme?: EverfurAppearancePreset | string;
     readonly variables?: EverfurAppearanceVariables;
     readonly rules?: EverfurAppearanceRules;
+    readonly fonts?: readonly EverfurAppearanceFont[];
 }
 /**
  * What each preset sets, as variables. Pinned by `contract/appearance/appearance_v1.json`, which EFBackend runs too,
@@ -90,7 +121,7 @@ interface EverfurThemeSlotInput {
     readonly textColor?: string | number;
     readonly text_color?: string | number;
 }
-/** The `slots` map on the `theme` prop: any subset of the nine slot names. */
+/** The `slots` map on the `theme` prop: any subset of the slot names (`THEME_SLOT_NAMES`). */
 type EverfurThemeSlotsInput = Readonly<Partial<Record<EverfurThemeSlotName, EverfurThemeSlotInput>>>;
 /**
  * The faces a theme names: the three text weights and the three mono weights (`EverfurFontFaceKey` on the tokens).
@@ -207,6 +238,39 @@ interface EverfurThemeInput {
     /** The smallest spacing step in px, 3 to 6 (clamped); every step scales from it. Default 4. */
     readonly spacing_unit?: number | string;
     readonly spacingUnit?: number | string;
+    /** Positive status (`Ready to view`, a success notice) on the light palette; the dark twin is derived when unset. */
+    readonly success_color?: string | number;
+    readonly successColor?: string | number;
+    readonly success_color_dark?: string | number;
+    readonly successColorDark?: string | number;
+    /** Caution (`Vet care suggested soon`) on the light palette; the dark twin is derived when unset. */
+    readonly warning_color?: string | number;
+    readonly warningColor?: string | number;
+    readonly warning_color_dark?: string | number;
+    readonly warningColorDark?: string | number;
+    /** Information (`Good to know`, `Monitor at home`) on the light palette; the dark twin is derived when unset. */
+    readonly info_color?: string | number;
+    readonly infoColor?: string | number;
+    readonly info_color_dark?: string | number;
+    readonly infoColorDark?: string | number;
+    /** The family of the headings (registered by the host, or loaded through `appearance.fonts` on the web). */
+    readonly heading_font_family?: string;
+    readonly headingFontFamily?: string;
+    /** The weight of body text, 100 to 900 in hundreds. Default 400. */
+    readonly font_weight_body?: number | string;
+    readonly fontWeightBody?: number | string;
+    /** The weight of the headings, 100 to 900 in hundreds. Default: each heading's own (mostly 700). */
+    readonly font_weight_heading?: number | string;
+    readonly fontWeightHeading?: number | string;
+    /** The body line height as a multiple of the size, 1.0 to 2.0 (clamped). Default 1.4; every line height scales by it. */
+    readonly line_height?: number | string;
+    readonly lineHeight?: number | string;
+    /** The fonts the web host loads, at most four (`appearance.fonts` is the same list). Ignored on React Native. */
+    readonly font_sources?: readonly EverfurAppearanceFont[];
+    readonly fontSources?: readonly EverfurAppearanceFont[];
+    /** The image beside an assistant message in place of the default mark (https only). */
+    readonly assistant_avatar_url?: string;
+    readonly assistantAvatarUrl?: string;
     /** Tolerated for any other key; ignored by the resolver. */
     readonly [key: string]: unknown;
 }
@@ -298,6 +362,33 @@ interface ClientBranding {
      * not a positive integer. A version this SDK does not know (`THEME_SCHEMA_VERSIONS`) drops the server branding.
      */
     readonly schemaVersion?: number | null;
+    /**
+     * success_color / warning_color / info_color: the status colours of the LIGHT palette (positive status such as
+     * `Ready to view`; the caution banner `Vet care suggested soon`; the informational banners `Good to know` and
+     * `Monitor at home`). Each re-derives its ink, wash and edge, guarded like every other colour. The dark palette
+     * derives its variant when the `_dark` twin is absent, as `danger_color` does.
+     */
+    readonly successColor?: string | null;
+    readonly successColorDark?: string | null;
+    readonly warningColor?: string | null;
+    readonly warningColorDark?: string | null;
+    readonly infoColor?: string | null;
+    readonly infoColorDark?: string | null;
+    /** heading_font_family: the family of the headings; absent/null keeps each heading's own face. */
+    readonly headingFontFamily?: string | null;
+    /** font_weight_body: the weight of body text, 100..900 in hundreds; absent/null keeps 400. */
+    readonly fontWeightBody?: EverfurFontWeight | null;
+    /** font_weight_heading: the weight of the headings, 100..900 in hundreds; absent/null keeps each heading's own. */
+    readonly fontWeightHeading?: EverfurFontWeight | null;
+    /** line_height: the body line height as a multiple of the size, 1.0..2.0 (clamped); every line height scales by it. */
+    readonly lineHeight?: number | null;
+    /**
+     * font_sources: the fonts the web host loads (`appearance.fonts`), at most four; absent/null loads none. React
+     * Native ignores it. A `font_family` or `heading_font_family` lock also holds it (EFBackend WIRE_LOCK_NAMES).
+     */
+    readonly fontSources?: readonly EverfurFontSource[] | null;
+    /** assistant_avatar_url: the image beside an assistant message (https only downstream); absent/null keeps the mark. */
+    readonly assistantAvatarUrl?: string | null;
 }
 /** The compiled surface a branding may pick for the chat ground (`surface_style`). */
 type SurfaceStyle = 'white' | 'cream' | 'subtle';
@@ -307,7 +398,7 @@ type RadiusScale = 'sharp' | 'default' | 'round';
  * The wire names a tenant may list in `locked_fields` (every cosmetic field). `hide_powered_by` is not listed:
  * it is server-wins unconditionally, so locking it is meaningless.
  */
-declare const LOCKABLE_THEME_FIELDS: readonly ["display_name", "logo_url", "logo_url_dark", "primary_color", "accent_color", "primary_color_dark", "accent_color_dark", "brightness", "color_scheme", "font_family", "font_url", "fonts", "font_urls", "chat_placeholder", "surface_style", "radius_scale", "accessibility_max_font_scale", "slots", "background_color", "background_color_dark", "text_color", "text_color_dark", "danger_color", "danger_color_dark", "font_size_base", "border_radius", "spacing_unit"];
+declare const LOCKABLE_THEME_FIELDS: readonly ["display_name", "logo_url", "logo_url_dark", "primary_color", "accent_color", "primary_color_dark", "accent_color_dark", "brightness", "color_scheme", "font_family", "font_url", "fonts", "font_urls", "chat_placeholder", "surface_style", "radius_scale", "accessibility_max_font_scale", "slots", "background_color", "background_color_dark", "text_color", "text_color_dark", "danger_color", "danger_color_dark", "font_size_base", "border_radius", "spacing_unit", "success_color", "success_color_dark", "warning_color", "warning_color_dark", "info_color", "info_color_dark", "heading_font_family", "font_weight_body", "font_weight_heading", "line_height", "assistant_avatar_url", "font_sources"];
 type LockableThemeField = (typeof LOCKABLE_THEME_FIELDS)[number];
 /** The `locked_fields` key that locks one slot (`slots.<name>`), as EFBackend branding_slots.py emits it. */
 declare const SLOT_LOCK_PREFIX = "slots.";
@@ -340,5 +431,7 @@ declare const MAX_FONT_SCALE_CEILING = 3.1;
  * constructor so it is portable + total on React Native (whose URL global is incomplete) and never throws.
  */
 declare function hardenHttpsUrl(url: string | null): string | null;
+/** The URL when it is an Everfur brand asset (see above), else null. Total; never throws. */
+declare function hardenBrandAssetUrl(url: string | null): string | null;
 
-export { APPEARANCE_PRESETS as A, type ClientBranding as C, type EverfurThemeInput as E, LOCKABLE_THEME_FIELDS as L, MAX_FONT_SCALE_CEILING as M, type RadiusScale as R, type SurfaceStyle as S, THEME_SCHEMA_VERSIONS as T, APPEARANCE_PRESET_NAMES as a, APPEARANCE_SIZE_RANGES as b, type EverfurAppearance as c, type EverfurAppearancePreset as d, type EverfurAppearanceRules as e, type EverfurAppearanceVariables as f, type EverfurThemeFontFaceKey as g, type EverfurThemeFontUrlsInput as h, type EverfurThemeFontsInput as i, type EverfurThemeSlotInput as j, type EverfurThemeSlotsInput as k, expandAppearance as l, type LockableThemeField as m, SLOT_LOCK_PREFIX as n, type SlotLockName as o, type ThemeLockName as p, hardenHttpsUrl as q, isEmptyBranding as r, isKnownBrandingSchema as s, lockedFieldsOf as t, parseClientBranding as u, parsePx as v };
+export { APPEARANCE_PRESETS as A, type ClientBranding as C, type EverfurThemeInput as E, LOCKABLE_THEME_FIELDS as L, MAX_FONT_SCALE_CEILING as M, type RadiusScale as R, type SurfaceStyle as S, THEME_SCHEMA_VERSIONS as T, APPEARANCE_PRESET_NAMES as a, APPEARANCE_SIZE_RANGES as b, type EverfurAppearance as c, type EverfurAppearanceFont as d, type EverfurAppearancePreset as e, type EverfurAppearanceRules as f, type EverfurAppearanceVariables as g, type EverfurThemeFontFaceKey as h, type EverfurThemeFontUrlsInput as i, type EverfurThemeFontsInput as j, type EverfurThemeSlotInput as k, type EverfurThemeSlotsInput as l, expandAppearance as m, type LockableThemeField as n, SLOT_LOCK_PREFIX as o, type SlotLockName as p, type ThemeLockName as q, hardenBrandAssetUrl as r, hardenHttpsUrl as s, isEmptyBranding as t, isKnownBrandingSchema as u, lockedFieldsOf as v, parseClientBranding as w, parsePx as x };

package/dist/{casesRepository-B6Z0XBIb.d.cts → casesRepository-Bzs7aw4t.d.cts}

@@ -1,5 +1,5 @@
 import { E as EverfurResult } from './EverfurResult-dtl8ERAw.cjs';
-import { A as AuthContext } from './identity-BHaMJ3KK.cjs';
+import { A as AuthContext } from './identity-75whJXyP.cjs';
 import { P as PetRef } from './ids-B2GAAifq.cjs';
 
 /** The owner's answer to a check-in, the wire values of the consumer `CheckinResponse` enum. */

package/dist/{casesRepository-SI0zp5YH.d.ts → casesRepository-CywqL6mj.d.ts}

@@ -1,5 +1,5 @@
 import { E as EverfurResult } from './EverfurResult-sKkoXew0.js';
-import { A as AuthContext } from './identity-B8GkH53J.js';
+import { A as AuthContext } from './identity-BiyMDMrR.js';
 import { P as PetRef } from './ids-B2GAAifq.js';
 
 /** The owner's answer to a check-in, the wire values of the consumer `CheckinResponse` enum. */