@kavchat/widget 0.0.2 → 0.0.3

package/dist/types/live-client.d.ts

@@ -0,0 +1,85 @@
+import type { LiveChat, LiveConversation } from '@kavchat/core';
+/**
+ * הרשת של צ'אט עם נציג (docs/live-chat-protocol.md, סעיפים 2 ו-3).
+ * בלי preflight: אין כותרות בכלל, וגוף ה-POST הוא מחרוזת JSON, שהדפדפן שולח כ-text/plain.
+ * הקרדנשל עובר רק בגוף הבקשה. בכתובת יש רק כרטיס הזרם החד-פעמי
+ */
+export interface LiveApi {
+    apiBase: string;
+    publicKey: string;
+}
+export interface LiveRes {
+    status: number;
+    ok: boolean;
+    data: any;
+    code: string;
+    message: string;
+}
+export declare const liveUrl: (c: LiveApi, path: string) => string;
+export declare const livePost: (c: LiveApi, path: string, body: unknown) => Promise<LiveRes>;
+export declare const liveGet: (c: LiveApi, path: string) => Promise<LiveRes>;
+/** רשת, 429 ו-5xx: מנסים שוב. 4xx אחר: לא */
+export declare const retryable: (r: LiveRes) => boolean;
+export declare const sleep: (ms: number) => Promise<unknown>;
+/** בלי שום אירוע 90 שניות: סוגרים ומתחברים מחדש. EventSource לא חושף את שורות ה-ping, ולכן זמן נדיב מה-60 שבפרוטוקול */
+export declare const LIVE_IDLE_MS = 90000;
+export interface LiveCallbacks {
+    change(chat: LiveChat): void;
+    typing(on: boolean): void;
+    /** reconnecting: החיבור נפל ומנסים שוב. replaced: לשונית או מכשיר אחר לקחו את השיחה */
+    notice(kind: 'reconnecting' | 'replaced' | null): void;
+    /** השיחה הסתיימה (או שהקרדנשל כבר לא תקף): מוחקים אותו מהאחסון */
+    ended(): void;
+}
+export declare class LiveConnection {
+    private api;
+    credential: string;
+    private cb;
+    chat: LiveChat;
+    stopped: boolean;
+    random: () => number;
+    private es;
+    private timer;
+    private idle;
+    private typingTimer;
+    private attempt;
+    /** כישלונות זרם לפני ready, כשכרטיס הזרם התקבל: כנראה פרוקסי שחוסם SSE */
+    private blocked;
+    private pollUntil;
+    private polling;
+    private typingOn;
+    private typingAt;
+    private numberTried;
+    constructor(api: LiveApi, credential: string, conversation: LiveConversation, cb: LiveCallbacks);
+    get final(): boolean;
+    private body;
+    private set;
+    /** POST /live/sync עד hasMore=false. false: נכשל */
+    sync(): Promise<boolean>;
+    /** קודים שמשנים את הזרימה (סעיף 2.5). true: טופל */
+    private fail;
+    connect(): void;
+    private openStream;
+    private touch;
+    private closeStream;
+    private bye;
+    private retry;
+    /** אחרי השהיה: סנכרון לפי lastSeq, ואז זרם חדש */
+    private schedule;
+    private onOnline;
+    /** long-poll כשאין EventSource, כשהזרם חסום, או לזמן מה אחרי live_busy */
+    private poll;
+    private showTyping;
+    /** שליחת הודעה: מוצגת מיד כ"נשלח", עם clientId שנוצר פעם אחת ומשמש לכל ניסיון חוזר */
+    send(raw: string): 'ok' | 'empty' | 'too_long' | 'closed';
+    retrySend(clientId: string): void;
+    private deliver;
+    /** "מקליד" לנציג: לכל היותר פעם ב-3 שניות, false כשהשדה התרוקן או נשלח. בלי ניסיונות חוזרים */
+    typing(on: boolean): void;
+    /** "להשאיר הודעה במקום" או "סיום השיחה". בטוח לחזור עליהן */
+    command(path: 'leave-message' | 'end'): Promise<boolean>;
+    /** מצב סופי: סוגרים את הזרם ומוחקים את הקרדנשל. אם מספר הפנייה עוד לא ידוע, סנכרון אחד אחרי 2 שניות */
+    private finish;
+    private end;
+    stop(): void;
+}

package/dist/types/live-entry.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/live-load-cdn.d.ts

@@ -0,0 +1,2 @@
+import type * as Live from './live';
+export declare const loadLive: () => Promise<typeof Live>;

package/dist/types/live-load.d.ts

@@ -0,0 +1,5 @@
+/**
+ * טעינת הצ'אט עם נציג. בחבילת npm ובבדיקות זה import רגיל.
+ * בקובץ של ה-CDN הבנייה מחליפה את הקובץ הזה ב-live-load-cdn.ts, שטוען את kavchat-live.js רק כשצריך
+ */
+export declare const loadLive: () => Promise<typeof import("./live")>;

package/dist/types/live-styles.d.ts

@@ -0,0 +1,5 @@
+/**
+ * עיצוב מסך הצ'אט עם נציג. נוסף ל-Shadow DOM רק כשהקובץ הנפרד נטען.
+ * תכונות לוגיות בלבד, כמו בשאר הווידג'ט, כדי ש-RTL יהפוך הכל לבד
+ */
+export declare const LIVE_CSS = "\n.lstatus{flex:none;padding:8px 14px;font-size:13px;line-height:1.6;color:#374151;background:#fff;border-block-end:1px solid #e3e6ea}\n.lsys{align-self:center;max-width:90%;text-align:center;font-size:12px;color:#6b7280;padding:2px 8px}\n.lsep{margin-block:6px;border-block-start:1px solid #e3e6ea;padding-block-start:8px;align-self:stretch;max-width:none}\n.lname{display:block;font-size:11px;font-weight:600;color:#6b7280}\n.lp-sending{opacity:.65}\n.lp-failed{opacity:.85;outline:1px solid #b42318}\n.lp-failed .btn{display:block;margin-block-start:6px;padding:3px 8px;font-size:12px;color:#b42318;background:#fff;border-color:#b42318}\n.ltyping{flex:none;padding:0 14px 4px;font-size:12px;color:#6b7280}\n.lerror{flex:none;padding:0 14px}\n.lerror:empty{display:none}\n.lactions{flex:none;display:flex;flex-wrap:wrap;gap:6px;padding:4px 14px 8px}\n.lactions:empty{display:none}\n.lactions .btn{padding:6px 12px;font-size:14px}\n.note{margin:0;font-size:14px;color:#4b5563}\n.composer input:disabled{opacity:.5}\n.send:disabled{opacity:.5;cursor:default}\n.launcher.kc-unread::after{content:\"\";position:absolute;inset-block-start:4px;inset-inline-end:4px;width:12px;height:12px;border-radius:50%;background:#e11d48;border:2px solid #fff}\n";

package/dist/types/live.d.ts

@@ -0,0 +1,67 @@
+import type { BotChip, BotEffect, UiTexts } from '@kavchat/core';
+import { LiveApi } from './live-client';
+/**
+ * צד המבקר בצ'אט עם נציג, בתוך חלון הווידג'ט: הכפתור "שיחה עם נציג", טופס הבקשה, מסך ההמתנה, השיחה עצמה,
+ * ושחזור אחרי טעינה מחדש. נטען רק כש-liveChat.enabled (או כשיש שיחה פתוחה שמורה), כקובץ נפרד ב-CDN,
+ * כדי שהקובץ הראשי יישאר בתקציב. המנוע (סדר, כפילויות, טקסטים) ב-@kavchat/core
+ */
+export type LiveEffect = Extract<BotEffect, {
+    type: 'contact' | 'live';
+}>;
+export interface FormPrefill {
+    note?: string;
+    name?: string;
+    email?: string;
+    phone?: string;
+    message?: string;
+}
+/**
+ * מה שהבקר צריך מהווידג'ט. KavchatWidget עצמו מועבר לכאן: השמות כאן הם השדות והמתודות (הפרטיים) שלו
+ */
+export interface LiveHost {
+    api: LiveApi;
+    /** liveChat.enabled false: הקובץ נטען רק כדי לשחזר שיחה פתוחה, בלי להציע שיחה חדשה */
+    release: {
+        liveChat?: {
+            enabled: boolean;
+        };
+    } | null;
+    locale: string;
+    t: UiTexts;
+    ui: {
+        root: ShadowRoot;
+        panel: HTMLElement;
+        chatView: HTMLElement;
+        formView: HTMLElement;
+        live: HTMLElement;
+        launcher: HTMLElement;
+    } | null;
+    opts: {
+        userToken?: string;
+        userName?: string;
+    };
+    session: {
+        id: string;
+    } | null;
+    isOpen: boolean;
+    renderChips(): void;
+    showChat(): void;
+    showForm(effect: LiveEffect, pre: FormPrefill): void;
+    emit(event: {
+        type: 'live';
+        state: string;
+        id: string;
+    }): void;
+}
+export interface LiveController {
+    /** הכפתורים עם "שיחה עם נציג" לפני "פנייה לצוות", רק כשיש נציג זמין */
+    chips(chips: BotChip[]): BotChip[];
+    /** למה אין נציג, לשורה שמעל טופס הפנייה ('' בלי הסבר) */
+    note(): string;
+    start(effect: LiveEffect): Promise<void>;
+    restore(): Promise<void>;
+    /** true כשמסך הצ'אט עם הנציג מוצג והפוקוס עבר אליו */
+    focus(): boolean;
+    destroy(): void;
+}
+export declare function createLive(host: LiveHost): LiveController;

package/dist/types/widget.d.ts

@@ -23,6 +23,12 @@ export type KavchatEvent = {
     type: 'ticket';
     id: string;
     number: number;
+}
+/** מצב הצ'אט עם נציג: queued, active, closed, ticket */
+ | {
+    type: 'live';
+    state: string;
+    id: string;
 };
 export interface ScreenDeclaration {
     id: string;
@@ -86,6 +92,7 @@ export declare class KavchatWidget {
     private destroyed;
     /** מחכים לתשובת AI: מציגים "מקליד" ומתעלמים מקלט חדש */
     private waiting;
+    private live;
     constructor(options: KavchatOptions);
     /** ה-ShadowRoot, לבדיקות ולאוטומציה באתר המארח */
     get shadowRoot(): ShadowRoot | null;
@@ -103,6 +110,11 @@ export declare class KavchatWidget {
     /** שולח את רשימת המסכים רק כשהשתנתה או פעם בשבוע. שגיאה נבלעת: ננסה שוב בטעינה הבאה */
     private registerScreens;
     private apply;
+    /**
+     * הצ'אט עם נציג נטען רק כשהוא מופעל בגרסה, או כשיש שיחה פתוחה שמורה. כל mount מקבל בקר חדש,
+     * שמשחזר את השיחה מהאחסון. כישלון בטעינה משאיר את הבוט ואת טופס הפנייה כמו שהם
+     */
+    private setupLive;
     private restoreSession;
     /**
      * התסריט נבדק בשפת הבוט (מילות עצירה וכו'), והטקסטים הקבועים של הצ'אט מוצגים בשפת הממשק.
@@ -127,6 +139,7 @@ export declare class KavchatWidget {
     private renderMessages;
     private renderChips;
     private showChat;
+    /** pre: מה שהמשתמש כבר כתב בבקשה לנציג, ולמה אין נציג (note) */
     private showForm;
     private showSent;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kavchat/widget",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Kavchat web widget: the embeddable scripted support chat for websites.",
   "license": "MIT",
   "type": "module",
@@ -25,7 +25,7 @@
     "prepublishOnly": "yarn build"
   },
   "dependencies": {
-    "@kavchat/core": "0.0.2"
+    "@kavchat/core": "0.0.3"
   },
   "devDependencies": {
     "esbuild": "^0.28.2",