@developer.notchatbot/webchat 2.0.0 → 2.2.0

package/dist/hooks/useVisitorChat.d.ts

@@ -18,7 +18,7 @@ interface PendingSend {
     currentUrl: string;
 }
 /** Owns the visitor lifecycle shared by floating and embedded chat surfaces. */
-export declare function useVisitorChat(config: WebChatConfig, isOpen: boolean): {
+export declare function useVisitorChat(config: WebChatConfig, isOpen: boolean, awaitingReplyTimeoutMs?: number): {
     react: (messageId: string, emoji: string | null) => Promise<boolean>;
     teamOnline: boolean;
     staffTypingAuthor: {
@@ -32,6 +32,7 @@ export declare function useVisitorChat(config: WebChatConfig, isOpen: boolean):
     draftRevision: number;
     messages: Message[];
     sending: boolean;
+    awaitingReply: boolean;
     error: string;
     unread: boolean;
     unreadCount: number;

package/dist/utils/shopify-attribution.d.ts

@@ -0,0 +1,12 @@
+export interface ShopifyAttributionReference {
+    conversationId: string;
+    expiresAt: number;
+}
+/** Cart API bridge. Only runs network work after engagement or for cleanup of our saved reference. */
+export declare function observeShopifyAttribution(doc: Document, readReference: () => ShopifyAttributionReference | null, storage: {
+    read(): string | null;
+    write(value: string): void;
+}, request?: typeof fetch): {
+    refresh: () => Promise<void>;
+    dispose: () => void;
+};

package/dist/utils/tiendanube-attribution.d.ts

@@ -0,0 +1,8 @@
+export interface AttributionReference {
+    token: string;
+    expiresAt: number;
+}
+/** Attach only to same-origin Tiendanube purchase forms; unrelated forms remain untouched. */
+export declare function attachTiendanubeAttribution(doc: Document, token: string): number;
+/** Owns field lifecycle across cart rendering; never intercepts payment or blocks navigation. */
+export declare function observeTiendanubeAttribution(doc: Document, reference: AttributionReference, storeId: string, readPlatform: () => unknown, onRetired?: () => void): () => void;

package/dist/utils/visitor-session.d.ts

@@ -13,6 +13,18 @@ export interface VisitorSession {
     };
 }
 export declare const visitorStorageKey: (uid: string, item: string) => string;
+export declare const ORIGIN_NOT_ALLOWED_MESSAGE = "El chat no est\u00E1 disponible en este sitio.";
+/** A distinct, identifiable failure so a catch site can surface this specific message instead of its generic one. */
+export declare class OriginNotAllowedError extends Error {
+    constructor();
+}
+/** Defensive JSON parse: a non-JSON or empty body must never crash the caller. */
+export declare function safeParseJson(response: Response): Promise<unknown>;
+/**
+ * Detects the server's origin-allowlist rejection (403 with `code: 'ORIGIN_NOT_ALLOWED'`).
+ * Logs a store-owner-actionable console error and reports the match; the caller decides how to fail.
+ */
+export declare function checkOriginNotAllowed(response: Response): Promise<boolean>;
 /** Tenant/site-scoped storage with a stable in-memory fallback for blocked browser storage. */
 export declare function readVisitorData(uid: string, item: string): string | null;
 export declare function writeVisitorData(uid: string, item: string, value: string | null): void;

package/dist/utils/vtex-attribution.d.ts

@@ -0,0 +1,13 @@
+interface Reference {
+    conversationId: string;
+    expiresAt: number;
+}
+/** Uses the store's existing vtexjs checkout transport. Configure its shared queue at integration time. */
+export declare function observeVtexAttribution(doc: Document, readReference: () => Reference | null, storage: {
+    read(): string | null;
+    write(value: string): void;
+}): {
+    refresh: () => Promise<void>;
+    dispose: () => void;
+};
+export {};