@repzo/widget-react-native 1.0.0

package/lib/typescript/commonjs/ui/styles/theme.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Maps the widget's `GET /config` theming fields onto React Native styles.
+ *
+ * The palette mirrors the web widget so a workspace looks the same on both
+ * surfaces; type scales are nudged up because 13px body copy is unreadable on
+ * a phone (minimum readable body size is 15–16px).
+ */
+import type { WidgetConfig } from '../../types';
+export declare const palette: {
+    readonly white: "#ffffff";
+    readonly ink: "#1a1a1a";
+    readonly text: "#111827";
+    readonly textMuted: "#6b7280";
+    readonly textSubtle: "#9ca3af";
+    readonly textFaint: "#b0b0b0";
+    readonly border: "#e5e7eb";
+    readonly borderSoft: "#f3f4f6";
+    readonly surface: "#f9fafb";
+    readonly surfaceAlt: "#f3f4f6";
+    readonly danger: "#ef4444";
+    readonly warningBg: "#fef3c7";
+    readonly warningBorder: "#fde68a";
+    readonly warningText: "#92400e";
+    readonly warningIcon: "#d97706";
+    readonly online: "#22c55e";
+    readonly disabled: "#d1d5db";
+};
+export declare const radius: {
+    readonly sm: 8;
+    readonly md: 10;
+    readonly lg: 12;
+    readonly xl: 14;
+    readonly pill: 999;
+};
+export declare const spacing: {
+    readonly xs: 4;
+    readonly sm: 8;
+    readonly md: 12;
+    readonly lg: 16;
+    readonly xl: 20;
+    readonly xxl: 24;
+};
+/** Mobile type scale — one step larger than the web widget's. */
+export declare const fontSize: {
+    readonly micro: 10;
+    readonly caption: 12;
+    readonly meta: 13;
+    readonly body: 15;
+    readonly input: 16;
+    readonly title: 17;
+    readonly heading: 22;
+    readonly display: 28;
+};
+export interface WidgetTheme {
+    primaryColor: string;
+    position: 'left' | 'right';
+    isOnline: boolean;
+    /** Only set when the widget is outside business hours and has a message. */
+    offlineMessage?: string;
+    startConversationLabel: string;
+    replyTimeLabel: string;
+    allowNewConversations: boolean;
+    showPreviousConversations: boolean;
+    attachmentsEnabled: boolean;
+    preChatEnabled: boolean;
+}
+export declare const DEFAULT_PRIMARY_COLOR = "#0d9488";
+/**
+ * `override` supplies a translation for the active locale when one exists.
+ * Without it the workspace's single-language config fields are used, which is
+ * correct for the default locale and wrong for every other one.
+ */
+export declare function buildTheme(config: WidgetConfig | null): WidgetTheme;
+/** `#rrggbb` → `rgba(r, g, b, alpha)`; passes non-hex colors straight through. */
+export declare function withAlpha(color: string, alpha: number): string;
+export declare function hexToRgb(color: string): [number, number, number] | null;
+/** Linear blend between two hex colors, used to fake gradients without a native lib. */
+export declare function mixHex(from: string, to: string, ratio: number): string;
+/** Pick readable foreground text for an arbitrary brand color. */
+export declare function contrastingTextColor(background: string): string;
+export declare const shadows: {
+    readonly card: {
+        readonly shadowColor: "#0f172a";
+        readonly shadowOffset: {
+            readonly width: 0;
+            readonly height: 4;
+        };
+        readonly shadowOpacity: 0.08;
+        readonly shadowRadius: 14;
+        readonly elevation: 3;
+    };
+    readonly floating: {
+        readonly shadowColor: "#000000";
+        readonly shadowOffset: {
+            readonly width: 0;
+            readonly height: 4;
+        };
+        readonly shadowOpacity: 0.15;
+        readonly shadowRadius: 12;
+        readonly elevation: 6;
+    };
+};
+//# sourceMappingURL=theme.d.ts.map

package/lib/typescript/commonjs/ui/styles/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../../../src/ui/styles/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;CAkBV,CAAC;AAEX,eAAO,MAAM,MAAM;;;;;;CAMT,CAAC;AAEX,eAAO,MAAM,OAAO;;;;;;;CAOV,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,QAAQ;;;;;;;;;CASX,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,yBAAyB,EAAE,OAAO,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,qBAAqB,YAAY,CAAC;AAE/C;;;;GAIG;AAGH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,WAAW,CAgBnE;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAYvE;AAED,wFAAwF;AACxF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;CAeV,CAAC"}

package/lib/typescript/commonjs/ui/utils/conversations.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Conversation selectors and formatting shared by the Home and Messages
+ * spaces, so the two can never disagree about ordering or wording.
+ * Pure and free of React so they stay trivial to test.
+ */
+import type { Conversation } from '../../types';
+export interface TeamAgent {
+    name: string | null;
+    avatar: string | null;
+}
+/**
+ * Newest first. The store patches a conversation in place when a message
+ * arrives and never reorders the array, so position is not recency — every
+ * surface that lists conversations has to sort for itself.
+ */
+export declare function sortByRecency(conversations: Conversation[]): Conversation[];
+export declare function pickRecentConversations(conversations: Conversation[], limit?: number): Conversation[];
+/** Distinct agents the visitor has spoken to, most recent conversation first. */
+export declare function pickTeamAgents(conversations: Conversation[], limit?: number): TeamAgent[];
+/** Every unit is a translated template, so `2h` can become `منذ ساعتين`. */
+export interface RelativeTimeLabels {
+    justNow: string;
+    minutes: string;
+    hours: string;
+    days: string;
+    months: string;
+    years: string;
+}
+export declare function formatRelativeTime(dateStr: string, labels: RelativeTimeLabels): string;
+export declare function isSameDay(a: string, b: string): boolean;
+/**
+ * Clock time beside a message. Intl ships with Hermes but is guarded anyway —
+ * a missing implementation should not blank out every timestamp in the thread.
+ */
+export declare function formatClockTime(dateStr: string, locale: string): string;
+/** "Today", "Yesterday", then a real date once it is older than that. */
+export declare function formatDayLabel(dateStr: string, locale: string, labels: {
+    today: string;
+    yesterday: string;
+}): string;
+//# sourceMappingURL=conversations.d.ts.map

package/lib/typescript/commonjs/ui/utils/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/conversations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAOD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAE3E;AAED,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,KAAK,SAAI,GAAG,YAAY,EAAE,CAEhG;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,aAAa,EAAE,YAAY,EAAE,EAAE,KAAK,SAAI,GAAG,SAAS,EAAE,CAepF;AAED,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,MAAM,CActF;AAKD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQvE;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3C,MAAM,CAmBR"}

package/lib/typescript/commonjs/ui/utils/html.d.ts

@@ -0,0 +1,10 @@
+/**
+ * HTML → text helpers. The CRM stores message bodies as HTML and campaign
+ * payloads as rich text; React Native has no DOMParser, so these are the
+ * regex equivalents of the web widget's `stripHtml` / `htmlToText`.
+ */
+/** Block-level tags become newlines so paragraphs survive the strip. */
+export declare function stripHtml(html: string): string;
+/** Single-line flattening used for campaign cards and list snippets. */
+export declare function htmlToText(html: string): string;
+//# sourceMappingURL=html.d.ts.map

package/lib/typescript/commonjs/ui/utils/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW9C;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAU/C"}

package/lib/typescript/commonjs/ui/utils/native-gradient.d.ts

@@ -0,0 +1,61 @@
+/**
+ * A real gradient when the host app happens to ship one, stacked bands when it
+ * does not.
+ *
+ * Stacked bands can only ever approximate a ramp: each strip is a solid fill,
+ * and once the strips are thin enough to hide the colour steps their heights
+ * start landing on fractional pixels, which shows up as faint seams. A native
+ * gradient has neither problem, so we use one where it exists — the same
+ * "borrow it from the host" approach as `safe-area.ts` and `storage.ts`.
+ *
+ * Resolution happens once at module load so component identity stays stable
+ * across renders.
+ */
+import type { ComponentType, ReactNode } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+export interface NativeGradientProps {
+    colors: string[];
+    /** Stop positions in 0..1, matching `colors` one for one. */
+    locations?: number[];
+    start?: {
+        x: number;
+        y: number;
+    };
+    end?: {
+        x: number;
+        y: number;
+    };
+    style?: StyleProp<ViewStyle>;
+    pointerEvents?: 'none' | 'auto' | 'box-none' | 'box-only';
+    children?: ReactNode;
+}
+/** Null when the host installed no gradient library; callers fall back to bands. */
+export declare function getNativeGradient(): ComponentType<NativeGradientProps> | null;
+/** Top-to-bottom. The only direction the band fallback can draw. */
+export declare const VERTICAL: {
+    readonly start: {
+        readonly x: 0.5;
+        readonly y: 0;
+    };
+    readonly end: {
+        readonly x: 0.5;
+        readonly y: 1;
+    };
+};
+/**
+ * Top-left to bottom-right, the same way round in every language. A brand
+ * ramp is a visual, not a sentence, so it does not mirror with the reading
+ * direction. Needs a native gradient: stacked bands are horizontal strips and
+ * can only ever run top to bottom.
+ */
+export declare const DIAGONAL: {
+    readonly start: {
+        readonly x: 0;
+        readonly y: 0;
+    };
+    readonly end: {
+        readonly x: 1;
+        readonly y: 1;
+    };
+};
+//# sourceMappingURL=native-gradient.d.ts.map

package/lib/typescript/commonjs/ui/utils/native-gradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-gradient.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/native-gradient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,GAAG,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IAC1D,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAaD,oFAAoF;AACpF,wBAAgB,iBAAiB,IAAI,aAAa,CAAC,mBAAmB,CAAC,GAAG,IAAI,CAE7E;AAED,oEAAoE;AACpE,eAAO,MAAM,QAAQ;;;;;;;;;CAGX,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;CAGX,CAAC"}

package/lib/typescript/commonjs/ui/utils/rtl.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Right-to-left helpers.
+ *
+ * Yoga mirrors `flexDirection: 'row'`, `flex-start`/`flex-end` and the
+ * `start`/`end` style props on its own once the host app has turned RTL on.
+ * What it cannot mirror is meaning: an arrow that points "forward" is drawn
+ * rightwards in English and leftwards in Arabic, and a bubble's tail corner
+ * swaps sides with it. Those decisions live here.
+ */
+/**
+ * Text alignment follows the LAYOUT's direction, not the script's. Left to
+ * itself, a Latin string inside an Arabic screen renders hard against the
+ * left edge while everything around it is anchored right, which reads as a
+ * broken row rather than as mixed content.
+ *
+ * Read once at module load: switching direction requires an app restart.
+ */
+export declare const START_ALIGN: 'left' | 'right';
+export declare function isRTL(): boolean;
+/** Deeper into the app: a disclosure chevron, a "continue" arrow. */
+export declare function forwardDirection(): 'left' | 'right';
+/** Back out of the current screen. */
+export declare function backDirection(): 'left' | 'right';
+/**
+ * Mirrors a glyph that is drawn pointing right. Cheaper and less error-prone
+ * than maintaining a second set of geometry for every directional icon.
+ */
+export declare function flipForRTL(): {
+    transform: [{
+        scaleX: number;
+    }];
+} | undefined;
+//# sourceMappingURL=rtl.d.ts.map

package/lib/typescript/commonjs/ui/utils/rtl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtl.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/rtl.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,GAAG,OAA8C,CAAC;AAElF,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,OAAO,CAEnD;AAED,sCAAsC;AACtC,wBAAgB,aAAa,IAAI,MAAM,GAAG,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI;IAAE,SAAS,EAAE,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,SAAS,CAE5E"}

package/lib/typescript/commonjs/ui/utils/safe-url.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The one gate every widget link goes through before `Linking.openURL`.
+ *
+ * Agent and AI replies, campaign CTAs and attachment URLs are remote content.
+ * Opened blindly they could fire the host app's own deep links
+ * (`myapp://transfer?…`), Android `intent:` URLs, `sms:` or `file:` URIs. Only
+ * web, mail and phone links open by default; the host can route anything else
+ * itself through `boot({ onOpenUrl })`.
+ */
+type OpenUrlHandler = (url: string) => boolean | Promise<boolean>;
+/** Set from `boot({ onOpenUrl })`; `null` restores the default policy. */
+export declare function setOpenUrlHandler(handler: OpenUrlHandler | null): void;
+/** Lower-cased scheme including the colon (`'https:'`), or null when relative. */
+export declare function urlScheme(url: string): string | null;
+/** Absolute `http(s)://host…` — the only shape media URLs may take. */
+export declare function isHttpUrl(url: string): boolean;
+export declare function isSafeExternalUrl(url: string): boolean;
+/** Host handler first, then the allow-list. Never throws. */
+export declare function openExternalUrl(url: string | null | undefined): Promise<void>;
+export {};
+//# sourceMappingURL=safe-url.d.ts.map

package/lib/typescript/commonjs/ui/utils/safe-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-url.d.ts","sourceRoot":"","sources":["../../../../../src/ui/utils/safe-url.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,KAAK,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AASlE,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAEtE;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGpD;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAKtD;AAED,6DAA6D;AAC7D,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBnF"}

package/lib/typescript/module/agent-ui-blocks.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Structural parsing for agent-authored UI blocks.
+ *
+ * The CRM validates these with zod (`shared/agent-ui-blocks.ts`) before
+ * broadcasting, so this side only needs to reject malformed payloads rather
+ * than re-implement the schema — which keeps the SDK dependency-free. Action
+ * message formatting is copied verbatim so the transcript reads the same on
+ * web and mobile.
+ */
+import type { AgentUiAction, AgentUiBlock, AgentProcedureForm } from './types';
+/**
+ * Drops blocks this SDK version does not know how to render, or whose fields
+ * don't match what the renderer reads. Optional lists the server may omit
+ * come back as empty arrays.
+ */
+export declare function parseAgentUiBlocks(value: unknown): AgentUiBlock[];
+export declare function getAgentUiBlocks(metadata: Record<string, unknown> | null | undefined): AgentUiBlock[];
+export declare function getProcedureForm(metadata: Record<string, unknown> | null | undefined): AgentProcedureForm | null;
+export declare function formatAgentUiActionMessage(action: AgentUiAction): string;
+//# sourceMappingURL=agent-ui-blocks.d.ts.map

package/lib/typescript/module/agent-ui-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-ui-blocks.d.ts","sourceRoot":"","sources":["../../../src/agent-ui-blocks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAgM/E;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,CAmBjE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,kBAGpF;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACnD,kBAAkB,GAAG,IAAI,CAiB3B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA+CxE"}

package/lib/typescript/module/api/client.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Fetch client for `/api/widget/*`.
+ *
+ * Ported from the web widget's `client/src/widget/lib/api.ts`, with
+ * localStorage swapped for the storage adapter and EventSource moved to
+ * `api/realtime.ts`. Visitor tokens live up to 14 days with no refresh, so a
+ * 401 triggers one silent re-init + retry (single-flight, owned by the store).
+ * The token itself lives in `SecureStorage`.
+ */
+import type { AgentUiAction, Conversation, InitResponse, Message, OutboundMessage, RepzoWidgetErrorCode, WidgetAttachment, WidgetConfig, WidgetUser } from '../types';
+export declare function isTerminalErrorCode(code: string | null | undefined): boolean;
+export declare class RepzoWidgetError extends Error {
+    readonly status: number;
+    readonly code: RepzoWidgetErrorCode;
+    constructor(message: string, status: number, code?: RepzoWidgetErrorCode);
+    /** Builds the error for a non-2xx `{ message, code }` body. */
+    static fromResponse(status: number, body: unknown): RepzoWidgetError;
+}
+export declare class WidgetApiClient {
+    private baseUrl;
+    private channelAccountId;
+    private token;
+    private tokenLoaded;
+    /**
+     * Set by the store: given the token that just got a 401, returns a valid
+     * token (fresh, or one another caller already minted), or null.
+     */
+    reauthorize: ((failedToken: string | null) => Promise<string | null>) | null;
+    /** Set by the store: a 403 with a terminal `code` came back from any endpoint. */
+    onTerminalError: ((error: RepzoWidgetError) => void) | null;
+    configure(baseUrl: string, channelAccountId: string): void;
+    getBaseUrl(): string;
+    getChannelAccountId(): string;
+    getToken(): Promise<string | null>;
+    setToken(token: string): Promise<void>;
+    clearToken(): Promise<void>;
+    /**
+     * Absolute URL for a server media path (avatars, attachments). Only ever
+     * returns `http(s)` — relative paths resolve against `baseUrl`; any other
+     * scheme (`file:`, `data:`, `intent:`, host deep links…) yields null.
+     */
+    resolveUrl(url: string | null | undefined): string | null;
+    private request;
+    /** Public config. `platform` makes the server apply the Mobile SDKs overrides. */
+    getConfig(platform?: 'ios' | 'android' | 'web'): Promise<WidgetConfig>;
+    getOutboundMessage(): Promise<{
+        message: OutboundMessage | null;
+    }>;
+    /**
+     * Does NOT store the returned token — the store persists it only once it
+     * knows the identity op that asked for it is still current.
+     */
+    init(params: {
+        user?: WidgetUser;
+        trackingVisitorId?: string;
+        platform?: string;
+        sdkVersion?: string;
+        /** False for fresh sessions — never resume another identity's token. */
+        resumeToken?: boolean;
+    }): Promise<InitResponse>;
+    /** Revokes `token` server-side. A 401 means it was already dead — fine. */
+    logout(token: string): Promise<void>;
+    sendMessage(data: {
+        conversationId?: string;
+        forceNewConversation?: boolean;
+        body: string;
+        attachments?: WidgetAttachment[];
+        visitorName?: string;
+        visitorEmail?: string;
+        agentUiAction?: AgentUiAction;
+    }): Promise<{
+        messageId: string;
+        conversationId: string;
+        isNewConversation: boolean;
+    }>;
+    listConversations(): Promise<{
+        data: Conversation[];
+    }>;
+    listMessages(conversationId: string, cursor?: string | null): Promise<{
+        data: Message[];
+        meta: {
+            hasMore: boolean;
+            nextCursor: string | null;
+        };
+    }>;
+    /**
+     * Advances the visitor's read cursor for a thread they're watching live.
+     * Best effort and `skipReauth`: a burst of live replies must never turn an
+     * expired token into a burst of re-inits.
+     */
+    markConversationRead(conversationId: string): Promise<void>;
+    identify(data: {
+        email?: string;
+        name?: string;
+        phone?: string;
+        customAttributes?: Record<string, string | number | boolean>;
+    }): Promise<void>;
+    sendTyping(conversationId: string, isTyping: boolean): Promise<void>;
+    trackEvent(data: {
+        event: string;
+        visitorId?: string | null;
+        metadata?: Record<string, unknown>;
+    }): Promise<void>;
+    registerPushToken(data: {
+        token: string;
+        platform: string;
+        bundleId?: string;
+    }): Promise<void>;
+    /** Logout passes the session's token explicitly and `skipReauth`. */
+    removePushToken(token: string, auth?: {
+        authToken?: string | null;
+        skipReauth?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/lib/typescript/module/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/api/client.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/api/realtime.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SSE transport over `GET /api/widget/sse`, authenticated with an
+ * `Authorization: Bearer` header (never the query string, which ends up in
+ * proxy and server access logs).
+ *
+ * Uses React Native's streaming XMLHttpRequest and handles both network
+ * failures and successful stream EOF with exponential reconnect backoff.
+ * Auth failures never retry here: 401 hands over to the store's re-init,
+ * while 403 is terminal.
+ */
+import type { WidgetRealtimeEvent } from '../types';
+import { RepzoWidgetError } from './client';
+export type RealtimeHandler = (event: WidgetRealtimeEvent, data: any) => void;
+export interface RealtimeAuthHooks {
+    /** 401: the token expired or was revoked. The stream stays closed. */
+    onUnauthorized(token: string): void;
+    /** 403 (e.g. `messenger_api_disabled`): terminal, the stream stays closed. */
+    onForbidden(error: RepzoWidgetError): void;
+}
+export declare class WidgetRealtime {
+    private source;
+    private connected;
+    private reconnectTimer;
+    private attempt;
+    private closedByUs;
+    private url;
+    private token;
+    private handler;
+    private authHooks;
+    private authErrorTimer;
+    connect(baseUrl: string, token: string, handler: RealtimeHandler, authHooks?: RealtimeAuthHooks): void;
+    private open;
+    private handleAuthError;
+    private scheduleReconnect;
+    private teardownSource;
+    get isConnected(): boolean;
+    close(): void;
+}
+//# sourceMappingURL=realtime.d.ts.map

package/lib/typescript/module/api/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../../../../src/api/realtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAsB5C,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC;AAE9E,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,8EAA8E;IAC9E,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC5C;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAA+B;IAE7C,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO,CAAC,cAAc,CAA8C;IAEpE,OAAO,CAAC,OAAO,CAAK;IAEpB,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,GAAG,CAAuB;IAElC,OAAO,CAAC,KAAK,CAAuB;IAEpC,OAAO,CAAC,OAAO,CAAgC;IAE/C,OAAO,CAAC,SAAS,CAAkC;IAEnD,OAAO,CAAC,cAAc,CAA8C;IAEpE,OAAO,CACL,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,eAAe,EACxB,SAAS,CAAC,EAAE,iBAAiB,GAC5B,IAAI;IAUP,OAAO,CAAC,IAAI;IAyEZ,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,cAAc;IAiBtB,IAAI,WAAW,IAAI,OAAO,CAIzB;IAED,KAAK,IAAI,IAAI;CAad"}

package/lib/typescript/module/api/sse-parser.d.ts

@@ -0,0 +1,13 @@
+/** Incremental SSE framing. A blank line dispatches an event; EOF alone does not. */
+export declare class SseParser {
+    private readonly dispatch;
+    private line;
+    private event;
+    private data;
+    private afterCR;
+    private atStart;
+    constructor(dispatch: (event: string, data: string) => void);
+    push(chunk: string): void;
+    private readLine;
+}
+//# sourceMappingURL=sse-parser.d.ts.map

package/lib/typescript/module/api/sse-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-parser.d.ts","sourceRoot":"","sources":["../../../../src/api/sse-parser.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,qBAAa,SAAS;IAOR,OAAO,CAAC,QAAQ,CAAC,QAAQ;IANrC,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAQ;gBAEM,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI;IAE5E,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAqBzB,OAAO,CAAC,QAAQ;CAmBjB"}

package/lib/typescript/module/controller.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Process-wide singleton that owns the store (and therefore the session, the
+ * SSE stream and the unread count). Imperative API calls land here whether or
+ * not `<RepzoWidgetProvider>` is mounted; the provider is a pure subscriber, so
+ * commands issued before boot finishes simply land in state and render once the
+ * provider mounts.
+ */
+import { WidgetStore } from './state/widget-store';
+declare class RepzoWidgetController {
+    readonly store: WidgetStore;
+    get events(): import("./events").EventEmitter;
+}
+export declare const controller: RepzoWidgetController;
+export type { RepzoWidgetController };
+//# sourceMappingURL=controller.d.ts.map

package/lib/typescript/module/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/controller.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,cAAM,qBAAqB;IACzB,QAAQ,CAAC,KAAK,cAAqB;IAEnC,IAAI,MAAM,oCAET;CACF;AAED,eAAO,MAAM,UAAU,uBAA8B,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,CAAC"}

package/lib/typescript/module/device-id.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Per-install id sent as `trackingVisitorId`. This is the mobile equivalent of
+ * the web widget's `repzo_vid` cookie: it lets the CRM stitch an anonymous
+ * visitor back together if the session token is ever lost. Stable until
+ * `logout()`, which rotates it.
+ */
+export declare function getDeviceId(): Promise<string>;
+/** Only used by tests and `rotateDeviceId()`. */
+export declare function resetDeviceIdCache(): void;
+/**
+ * Called by `logout()`: the id stitches anonymous sessions together, so on a
+ * shared device the next visitor must not inherit the previous user's.
+ */
+export declare function rotateDeviceId(): Promise<void>;
+//# sourceMappingURL=device-id.d.ts.map

package/lib/typescript/module/device-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-id.d.ts","sourceRoot":"","sources":["../../../src/device-id.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsCH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAanD;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpD"}

package/lib/typescript/module/events.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Tiny typed event emitter. Pure JS — no NativeEventEmitter, so listeners work
+ * identically on iOS, Android and in tests.
+ */
+import type { Conversation, Message } from './types';
+export declare const RepzoWidgetEvents: {
+    readonly UnreadCountDidChange: "repzoWidget.unreadCountDidChange";
+    readonly MessageDidArrive: "repzoWidget.messageDidArrive";
+    /** The visitor opened a thread — hosts use it to dismiss that conversation's push notification. */
+    readonly ConversationDidRead: "repzoWidget.conversationDidRead";
+    readonly WindowDidShow: "repzoWidget.windowDidShow";
+    readonly WindowDidHide: "repzoWidget.windowDidHide";
+};
+export type RepzoWidgetEvent = (typeof RepzoWidgetEvents)[keyof typeof RepzoWidgetEvents];
+export interface MessageDidArrivePayload {
+    conversationId: string;
+    message: Message;
+    /** Null when the reply lands before this device has listed the thread. */
+    conversation: Conversation | null;
+}
+export interface RepzoWidgetEventPayloads {
+    [RepzoWidgetEvents.UnreadCountDidChange]: {
+        count: number;
+    };
+    [RepzoWidgetEvents.MessageDidArrive]: MessageDidArrivePayload;
+    [RepzoWidgetEvents.ConversationDidRead]: {
+        conversationId: string;
+    };
+    [RepzoWidgetEvents.WindowDidShow]: undefined;
+    [RepzoWidgetEvents.WindowDidHide]: undefined;
+}
+export interface EventSubscription {
+    remove(): void;
+}
+export declare class EventEmitter {
+    private listeners;
+    addListener<E extends RepzoWidgetEvent>(event: E, listener: (payload: RepzoWidgetEventPayloads[E]) => void): EventSubscription;
+    emit<E extends RepzoWidgetEvent>(event: E, payload: RepzoWidgetEventPayloads[E]): void;
+    removeAllListeners(): void;
+}
+//# sourceMappingURL=events.d.ts.map

package/lib/typescript/module/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAErD,eAAO,MAAM,iBAAiB;;;IAG5B,mGAAmG;;;;CAI3F,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAE1F,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC9D,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IAC7C,CAAC,iBAAiB,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;CAC9C;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,IAAI,IAAI,CAAC;CAChB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAoC;IAErD,WAAW,CAAC,CAAC,SAAS,gBAAgB,EACpC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC,KAAK,IAAI,GACvD,iBAAiB;IAYpB,IAAI,CAAC,CAAC,SAAS,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG,IAAI;IAatF,kBAAkB,IAAI,IAAI;CAG3B"}