@giovchat/react-native 0.0.0-stage → 0.3.0

package/dist/styleOverrides.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveStyleOverrides = resolveStyleOverrides;
+const backgroundSlots = [
+    "container", "header", "agentBubble", "visitorBubble", "composer", "button", "form",
+];
+const textSlots = [
+    "headerTitle", "headerSubtitle", "agentText", "visitorText", "input", "buttonText",
+    "formTitle", "label", "hint", "errorText",
+];
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+/** Rebuild every slot from an allowlist, including for untyped JavaScript callers. */
+function resolveStyleOverrides(value) {
+    const input = record(value);
+    const result = {};
+    for (const slot of backgroundSlots) {
+        const source = record(input[slot]);
+        result[slot] = nonEmptyString(source.backgroundColor)
+            ? { backgroundColor: source.backgroundColor }
+            : {};
+    }
+    for (const slot of textSlots) {
+        const source = record(input[slot]);
+        const style = {};
+        if (nonEmptyString(input.fontFamily))
+            style.fontFamily = input.fontFamily;
+        if (nonEmptyString(source.fontFamily))
+            style.fontFamily = source.fontFamily;
+        if (nonEmptyString(source.color))
+            style.color = source.color;
+        if (source.fontStyle === "normal" || source.fontStyle === "italic") {
+            style.fontStyle = source.fontStyle;
+        }
+        const weight = source.fontWeight;
+        if (weight === "normal" || weight === "bold" ||
+            (typeof weight === "string" && /^[1-9]00$/.test(weight)) ||
+            (typeof weight === "number" && weight >= 100 && weight <= 900 && weight % 100 === 0)) {
+            style.fontWeight = weight;
+        }
+        if (slot === "input" && nonEmptyString(source.backgroundColor)) {
+            style.backgroundColor = source.backgroundColor;
+        }
+        result[slot] = style;
+    }
+    const footer = record(input.branding);
+    const branding = {};
+    if (nonEmptyString(input.fontFamily))
+        branding.fontFamily = input.fontFamily;
+    for (const key of ["fontFamily", "color", "brandColor", "backgroundColor"]) {
+        if (nonEmptyString(footer[key]))
+            branding[key] = footer[key];
+    }
+    result.branding = branding;
+    return result;
+}
+//# sourceMappingURL=styleOverrides.js.map

package/dist/styleOverrides.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,156 @@
+import type { GiovAttachment, GiovAttachmentPolicy } from "./attachments";
+/**
+ * Fields the agent has configured as required in the pre-chat form.
+ * Mirrors the dashboard "Pre-chat form" settings.
+ */
+export interface RequestUserInfo {
+    email?: boolean;
+    phone?: boolean;
+    firstName?: boolean;
+    lastName?: boolean;
+}
+/**
+ * Contact information for the current user.
+ *
+ * Pass this to `GiovChat` via the `contact` prop to automatically identify
+ * the visitor and skip (or pre-fill) any required pre-chat fields.
+ */
+export interface GiovChatContact {
+    /**
+     * Your stable user id. On its own it is only a claim: the API stores it for
+     * agents but does not link the chat to an existing contact. Pass `userHash`
+     * as well to have it verified.
+     */
+    userId?: string;
+    /**
+     * HMAC-SHA256 of `userId` (hex) using the workspace's visitor identity
+     * secret from Settings → Chat widget → Visitor details. Compute it on YOUR backend;
+     * never ship the secret in the app.
+     */
+    userHash?: string;
+    email?: string;
+    phone?: string;
+    firstName?: string;
+    lastName?: string;
+}
+/** Private visitor credential. Never log it or share it across users. */
+export interface GiovChatSession {
+    conversationId: string;
+    sessionToken: string;
+}
+/** Optional host-owned secure persistence. The scope separates API, tenant, identity and reset key. */
+export interface GiovChatSessionStorage {
+    load(scope: string): Promise<GiovChatSession | null>;
+    save(scope: string, session: GiovChatSession): Promise<void>;
+    remove(scope: string): Promise<void>;
+}
+export type GiovChatConnectionStatus = "connecting" | "connected" | "disconnected";
+/**
+ * Widget configuration returned by `GET /widget/config`.
+ * All values are set by the agent in their dashboard.
+ */
+export interface GiovWidgetConfig {
+    /** Primary brand color (hex or CSS color). */
+    primaryColor: string;
+    /** Display name shown in the chat header. */
+    title: string;
+    /** Greeting message shown at the top of the conversation. */
+    greetingText: string;
+    /** Placeholder text for the message composer. */
+    textArea?: string;
+    /** Display name for the AI bot, when the GiovBot add-on is enabled. */
+    botName?: string;
+    /** True when GiovBot is turned on and included in the tenant's plan. */
+    botEnabled?: boolean;
+    /** The published GiovBot agent's avatar; the header shows the bot while it answers. */
+    botAvatarUrl?: string;
+    /** What visitors may attach, from the published agent's settings. Absent: images only. */
+    attachments?: GiovAttachmentPolicy;
+    /** URL of the agent/team avatar image. */
+    avatarUrl?: string;
+    /** Color theme. `"auto"` follows the device system setting. */
+    theme: "light" | "dark" | "auto";
+    /** Server-resolved plan policy. Only an explicit false removes GiovChat branding. */
+    showBranding?: boolean;
+    /** The workspace's privacy policy (https only); the header menu links to it, else to Giov's. */
+    privacyPolicyUrl?: string;
+    /** Which contact fields the agent requires before starting a chat. */
+    requestUserInfo?: RequestUserInfo;
+}
+/** A single message in a conversation. */
+export interface GiovMessage {
+    /** Unique message identifier. */
+    id: string;
+    /** Who sent the message. */
+    role: "visitor" | "agent";
+    /** Message body: Chat Markdown, as the web widget renders it. */
+    content: string;
+    /** Unix timestamp in milliseconds. */
+    createdAt: number;
+    /** `true` when this message was sent by the AI bot. */
+    isBot?: boolean;
+    /** System-generated delivery. AI replies may set both this flag and `isBot`. */
+    isAutomated?: boolean;
+    /** Display name of the human agent, when available. */
+    senderName?: string | null;
+    /** Photo of the human agent (http(s) only), when available. */
+    senderAvatar?: string | null;
+    /** Files sent with the message. */
+    attachments?: GiovAttachment[];
+    /** Local only: "sending" until the server confirms it, "failed" when it could not be delivered. */
+    status?: "sending" | "failed";
+    /** Local only: the id it was shown under before the server confirmed it (keeps list keys stable). */
+    clientMessageId?: string;
+    /** Local only: a GiovBot reply still being written. */
+    isStreaming?: boolean;
+    /** The conversation rating card this message carries (team or GiovBot "How did we do?" request). */
+    rating?: GiovRatingBlock;
+    /** The visitor's own thumb on this GiovBot answer. */
+    feedback?: "up" | "down";
+}
+/** A score from 1 (Very bad) to 5 (Great). */
+export type GiovRatingScore = 1 | 2 | 3 | 4 | 5;
+/** The `rating` block of a message (docs/protocol, "Conversation ratings"). */
+export interface GiovRatingBlock {
+    requestId: string;
+    /** When the card stops accepting answers or changes (epoch ms; the server decides). */
+    closesAt: number;
+    /** A hosted rating page, when the API sent one. The SDK always answers with the visitor token instead. */
+    url?: string;
+    score?: GiovRatingScore;
+    comment?: string;
+    /** `"replaced"`: a newer card took its place; draw nothing. */
+    state?: "replaced";
+}
+/** The rating card the visitor can answer or change right now (see `useGiovRating`). */
+export interface GiovRatingRequest {
+    requestId: string;
+    /** The message that carries the card. */
+    messageId: string;
+    closesAt: number;
+    url?: string;
+    /** True once the visitor has answered (the answer can still change until `closesAt`). */
+    answered: boolean;
+    score?: GiovRatingScore;
+    comment?: string;
+}
+/** The server's answer to a rating. */
+export interface GiovRatingResult {
+    requestId: string;
+    score: GiovRatingScore;
+    comment?: string;
+    closesAt: number;
+    ratedAt?: number;
+}
+/** The visitor's vote on a GiovBot answer. */
+export type GiovFeedbackValue = "up" | "down" | "none";
+export interface GiovAnswerFeedback {
+    messageId: string;
+    value: GiovFeedbackValue;
+    reason?: string;
+}
+/** Callback invoked for every incoming message. */
+export type MessageHandler = (message: GiovMessage) => void;
+/** Callback invoked when the WebSocket connection status changes. */
+export type StatusHandler = (connected: boolean) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1E;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,uGAAuG;AACvG,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,MAAM,MAAM,wBAAwB,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAEnF;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,qFAAqF;IACrF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,mGAAmG;IACnG,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC9B,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oGAAoG;IACpG,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1B;AAED,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEhD,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,0GAA0G;IAC1G,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,mDAAmD;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;AAE5D,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/unread.d.ts

@@ -0,0 +1,9 @@
+export declare function publishUnreadCount(owner: symbol, tenantKey: string, count: number): void;
+export declare function forgetUnreadCount(owner: symbol): void;
+export declare function readUnreadCount(tenantKey?: string): number;
+/**
+ * Agent replies the visitor has not seen because the chat was closed. Counts only while a mounted
+ * `GiovChat` stays connected when hidden (`keepConnected`); opening the chat clears it.
+ */
+export declare function useGiovChatUnreadCount(tenantKey?: string): number;
+//# sourceMappingURL=unread.d.ts.map

package/dist/unread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unread.d.ts","sourceRoot":"","sources":["../src/unread.ts"],"names":[],"mappings":"AAUA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKxF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1D;AAOD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/unread.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.publishUnreadCount = publishUnreadCount;
+exports.forgetUnreadCount = forgetUnreadCount;
+exports.readUnreadCount = readUnreadCount;
+exports.useGiovChatUnreadCount = useGiovChatUnreadCount;
+const react_1 = require("react");
+/**
+ * Unread agent replies per mounted chat, so any screen can show a badge without a provider. Each
+ * `GiovChat` publishes its own count under its tenant key; the hook sums them (normally one).
+ */
+const counts = new Map();
+const listeners = new Set();
+const notify = () => { for (const listener of listeners) {
+    try {
+        listener();
+    }
+    catch { /* Isolated. */ }
+} };
+function publishUnreadCount(owner, tenantKey, count) {
+    const current = counts.get(owner);
+    if (current && current.tenantKey === tenantKey && current.count === count)
+        return;
+    counts.set(owner, { tenantKey, count });
+    notify();
+}
+function forgetUnreadCount(owner) {
+    if (counts.delete(owner))
+        notify();
+}
+function readUnreadCount(tenantKey) {
+    let total = 0;
+    for (const entry of counts.values())
+        if (!tenantKey || entry.tenantKey === tenantKey)
+            total += entry.count;
+    return total;
+}
+function subscribe(listener) {
+    listeners.add(listener);
+    return () => { listeners.delete(listener); };
+}
+/**
+ * Agent replies the visitor has not seen because the chat was closed. Counts only while a mounted
+ * `GiovChat` stays connected when hidden (`keepConnected`); opening the chat clears it.
+ */
+function useGiovChatUnreadCount(tenantKey) {
+    return (0, react_1.useSyncExternalStore)(subscribe, () => readUnreadCount(tenantKey), () => 0);
+}
+//# sourceMappingURL=unread.js.map

package/dist/unread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unread.js","sourceRoot":"","sources":["../src/unread.ts"],"names":[],"mappings":";;AAUA,gDAKC;AAED,8CAEC;AAED,0CAIC;AAWD,wDAEC;AAtCD,iCAA6C;AAE7C;;;GAGG;AACH,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgD,CAAC;AACvE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;AACxC,MAAM,MAAM,GAAG,GAAG,EAAE,GAAG,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;IAAC,IAAI,CAAC;QAAC,QAAQ,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC;AAAC,CAAC,CAAC,CAAC,CAAC;AAE7G,SAAgB,kBAAkB,CAAC,KAAa,EAAE,SAAiB,EAAE,KAAa;IAChF,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,OAAO,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK;QAAE,OAAO;IAClF,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC;AACX,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,CAAC;AACrC,CAAC;AAED,SAAgB,eAAe,CAAC,SAAkB;IAChD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC;IAC3G,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,QAAoB;IACrC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,SAAkB;IACvD,OAAO,IAAA,4BAAoB,EAAC,SAAS,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC"}

package/dist/useChatSession.d.ts

@@ -0,0 +1,95 @@
+import { type GiovPushOptions, type GiovPushPlatform, type GiovPushRegistration } from "./client";
+import { GiovChatError } from "./errors";
+import { type OutboxEntry } from "./outbox";
+import { type GiovAttachment, type GiovChatPickedFile } from "./attachments";
+import type { GiovAnswerFeedback, GiovChatConnectionStatus, GiovChatContact, GiovChatSessionStorage, GiovFeedbackValue, GiovMessage, GiovRatingRequest, GiovRatingResult, GiovWidgetConfig, RequestUserInfo } from "./types";
+export declare function missingContactFields(fields?: RequestUserInfo, contact?: GiovChatContact): RequestUserInfo;
+/**
+ * The storage key of a visitor's session: the API, the workspace, the host's `sessionKey` and the
+ * signed-in `userId`. Contact details are not part of it, so a profile edit keeps the conversation.
+ */
+export declare function sessionScope(baseUrl: string, tenantKey: string, contact?: GiovChatContact, sessionKey?: string | number): string;
+/** The 0.2.0 key, which also held the contact details; read once so an upgrade keeps the conversation. */
+export declare function legacySessionScope(baseUrl: string, tenantKey: string, contact?: GiovChatContact, sessionKey?: string | number): string;
+/** By server id; a copy without a local key keeps the one it was shown under, so the bubble is not redrawn. */
+export declare function mergeMessages(current: GiovMessage[], incoming: GiovMessage[]): GiovMessage[];
+/** What the visitor sees: saved messages, then what is still sending, then replies being written. */
+export declare function displayMessages(saved: GiovMessage[], pending: readonly OutboxEntry[], drafts: Readonly<Record<string, {
+    content: string;
+    createdAt: number;
+}>>, describe?: (url: string) => Omit<GiovAttachment, "url">): GiovMessage[];
+type Options = {
+    tenantKey: string;
+    baseUrl: string;
+    visible: boolean;
+    contact?: GiovChatContact;
+    scope: string;
+    sessionStorage?: GiovChatSessionStorage;
+    /** The host's `sessionKey`, for reading a session stored under the 0.2.0 key. */
+    sessionKey?: string | number;
+    /** Stay connected while hidden (app in the foreground) to count unread replies. Never starts a conversation. */
+    keepConnected?: boolean;
+    /** How long the app may be in the background before the socket closes (so the server pushes replies). */
+    backgroundGraceMs?: number;
+    onError?: (error: GiovChatError) => void;
+    onConnectionStatusChange?: (status: GiovChatConnectionStatus) => void;
+    onConversationStart?: (conversationId: string) => void;
+    onUnreadCountChange?: (count: number) => void;
+    /** A rating card the visitor has not answered arrived (live or in the history). Fires once per card. */
+    onRatingRequested?: (request: GiovRatingRequest) => void;
+    /** The visitor's rating was stored. */
+    onRatingSubmitted?: (result: GiovRatingResult) => void;
+    /** The visitor's vote on a GiovBot answer was stored. */
+    onAnswerFeedback?: (feedback: GiovAnswerFeedback) => void;
+};
+/**
+ * `ready`: the chat can be used but no conversation exists yet. Per the visitor protocol a native
+ * client starts one when the visitor sends the first message (or submits the pre-chat form), so
+ * opening the screen never creates an empty conversation. `idle`: hidden with nothing to resume.
+ */
+export type ChatPhase = "idle" | "loading" | "pre-chat" | "ready" | "connecting" | "active" | "error";
+export type UploadProgress = {
+    name: string;
+    progress: number;
+};
+/** A short trip to the background (a file picker, the app switcher) keeps the socket, as in the Android SDK. */
+export declare const BACKGROUND_GRACE_MS = 5000;
+export declare function useChatSession(options: Options): {
+    phase: ChatPhase;
+    config: GiovWidgetConfig | null;
+    messages: GiovMessage[];
+    agentTyping: boolean;
+    agentTypingIsBot: boolean | undefined;
+    error: GiovChatError | null;
+    sending: boolean;
+    uploads: UploadProgress[];
+    requiredFields: RequestUserInfo;
+    hasConversation: boolean;
+    currentAgentName: string | null;
+    currentAgentAvatar: string | null;
+    unreadCount: number;
+    lastIncoming: GiovMessage | null;
+    retry: () => void;
+    reset: () => Promise<void>;
+    submitContact: (info: GiovChatContact) => void;
+    send: (text: string, files?: readonly GiovChatPickedFile[]) => Promise<boolean>;
+    retryMessage: (clientMessageId: string) => void;
+    discardMessage: (clientMessageId: string) => void;
+    notifyTyping: () => void;
+    attachmentUrl: (url: string) => string;
+    registerPushToken: (token: string, platform: GiovPushPlatform, options?: GiovPushOptions) => Promise<GiovPushRegistration>;
+    unregisterPushToken: (token: string) => Promise<boolean>;
+    ratingRequest: GiovRatingRequest | null;
+    ratingsSupported: boolean;
+    submitRating: (score: number, options?: {
+        comment?: string;
+        requestId?: string;
+    }) => Promise<GiovRatingResult>;
+    submitAnswerFeedback: (messageId: string, value: GiovFeedbackValue, options?: {
+        reason?: string;
+    }) => Promise<void>;
+    closed: boolean;
+    startNew: () => Promise<void>;
+};
+export {};
+//# sourceMappingURL=useChatSession.d.ts.map

package/dist/useChatSession.d.ts.map

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