@ezychat/web 0.0.0-stage → 0.1.39

package/dist-lib/types/admin/line-diff.d.ts

@@ -0,0 +1,26 @@
+export type DiffLine = {
+    type: 'same' | 'add' | 'del';
+    text: string;
+};
+/** Unchanged lines folded away in a review ("⋯ 12 unchanged lines"). */
+export type DiffSkip = {
+    type: 'skip';
+    count: number;
+};
+/**
+ * A review-sized diff: each change keeps `context` unchanged lines around it; longer unchanged runs
+ * fold into one skip entry. A single unchanged line is shown rather than folded.
+ */
+export declare function collapseDiff(lines: DiffLine[], context?: number): Array<DiffLine | DiffSkip>;
+/**
+ * Most line pairs compared one by one (the comparison table holds one number per pair, so this
+ * bounds it at ~8 MB). Larger changed middles show as one block out, then one block in.
+ */
+export declare const DIFF_MAX_LINE_PAIRS = 1000000;
+/**
+ * A line diff of `before` → `after`: shared first and last lines are kept as they are, and the
+ * changed middle is compared line by line (longest common subsequence) when small enough. In each
+ * changed block the removed lines come before the added ones, so a rewritten line reads "old, then
+ * new".
+ */
+export declare function lineDiff(before: string, after: string): DiffLine[];

package/dist-lib/types/admin/use-chatgpt-sign-in.d.ts

@@ -0,0 +1,14 @@
+import { type AiMemberStatus } from '@ezychat/shared';
+import type { useAiMemberAction } from '../api/ai';
+type AiAction = ReturnType<typeof useAiMemberAction>;
+/**
+ * EXPERIMENTAL one-click ChatGPT sign-in, shared by Settings → AI and the quick connect block:
+ * save ChatGPT mode if needed, start sign-in, then open the official sign-in page in a new tab.
+ * Errors surface through `action.error`.
+ */
+export declare function useChatgptSignIn(action: AiAction): {
+    signIn: (status: AiMemberStatus, model?: string) => Promise<void>;
+    popupBlocked: boolean;
+    resetPopup: () => void;
+};
+export {};

package/dist-lib/types/api/ai.d.ts

@@ -0,0 +1,174 @@
+import { type AiMemberBody, type AiConnectionBody, type AiContextPatchBody, type AiContextTextBody, type AiEditBody } from '@ezychat/shared';
+export declare const aiMemberKey: readonly ["ai-member"];
+export declare function useAiMember(): import("@tanstack/react-query").UseQueryResult<{
+    member: {
+        id: number;
+        username: string;
+        displayName: string;
+        role: "admin" | "agent";
+        mustChangePassword: boolean;
+        disabled: boolean;
+        createdAt: number;
+        locale: "en" | "ms" | "zh-CN" | null;
+        kind?: "human" | "ai" | undefined;
+        aiRole?: "sales" | undefined;
+    } | null;
+    settings: {
+        displayName: string;
+        mode: "api" | "chatgpt";
+        enabled: boolean;
+        model: string;
+        instructions: string;
+        handoffRules?: string | undefined;
+    };
+    hasApiKey: boolean;
+    connection: {
+        state: "unavailable" | "connected" | "error" | "expired" | "signed_out" | "signing_in";
+        loginUrl: string | null;
+        error: string | null;
+        email?: string | null | undefined;
+    };
+    documents: {
+        id: number;
+        name: string;
+        kind: "text" | "file";
+        size: number;
+        characters: number;
+        createdAt: number;
+        updatedAt: number;
+    }[];
+}, Error>;
+/** One Business context item with its text (full for text items, a preview for files). */
+export declare function useAiDocument(id: number | null): import("@tanstack/react-query").UseQueryResult<{
+    id: number;
+    name: string;
+    kind: "text" | "file";
+    size: number;
+    characters: number;
+    createdAt: number;
+    updatedAt: number;
+    text: string;
+    truncated: boolean;
+}, Error>;
+/** EXPERIMENTAL direct ChatGPT sign-in: live models for the signed-in account (or a fallback). */
+export declare function useAiModels(enabled: boolean, connected: boolean): import("@tanstack/react-query").UseQueryResult<{
+    models: {
+        id: string;
+        label: string;
+    }[];
+    source: "fallback" | "live";
+}, Error>;
+export declare function useAiTest(): import("@tanstack/react-query").UseMutationResult<{
+    ok: boolean;
+    model: string | null;
+    reply: string | null;
+    error: string | null;
+}, Error, void, unknown>;
+/** Try it: answers from the page's current knowledge; never touches chats or WhatsApp. */
+export declare function useAiTry(): import("@tanstack/react-query").UseMutationResult<{
+    ok: boolean;
+    reply: string | null;
+    action: "answer" | "ask_resolution" | "resolve" | "handoff" | null;
+    model: string | null;
+    error: string | null;
+    handoffReason?: "asked_for_human" | "missing_facts" | "sensitive" | "needs_action" | "business_rule" | "unsupported_message" | "ai_unavailable" | "lookup_failed" | null | undefined;
+    lookups?: {
+        title: string;
+        sourceLabel: string;
+        tool: string;
+        source: string;
+        ok: boolean;
+        ms: number;
+    }[] | undefined;
+}, Error, {
+    question: string;
+    knowledge: {
+        displayName: string;
+        instructions: string;
+        handoffRules?: string | undefined;
+    };
+}, unknown>;
+/** Edit with AI: a suggested rewrite of one box; nothing is saved (the page's Save does that). */
+/** Edit with AI. Pass a signal so closing the popup stops the (paid) model call. */
+export declare function useAiEdit(): import("@tanstack/react-query").UseMutationResult<{
+    ok: boolean;
+    text: string | null;
+    error: string | null;
+}, Error, {
+    body: AiEditBody;
+    signal: AbortSignal;
+}, unknown>;
+export type AiMemberAction = {
+    kind: 'save';
+    settings: AiMemberBody;
+} | {
+    kind: 'connection';
+    settings: AiConnectionBody;
+} | {
+    kind: 'upload';
+    file: File;
+} | {
+    kind: 'remove';
+    id: number;
+} | {
+    kind: 'removeMany';
+    ids: number[];
+} | {
+    kind: 'addText';
+    body: AiContextTextBody;
+} | {
+    kind: 'updateText';
+    id: number;
+    body: AiContextPatchBody;
+} | {
+    kind: 'login';
+} | {
+    kind: 'logout';
+} | {
+    kind: 'callback';
+    url: string;
+};
+/** Some items of a batch delete failed (not 404); `failedIds` are the ones to retry. */
+export declare class BatchDeleteError extends Error {
+    readonly failedIds: number[];
+    readonly firstError: unknown;
+    constructor(failedIds: number[], firstError: unknown);
+}
+export declare function useAiMemberAction(): import("@tanstack/react-query").UseMutationResult<{
+    member: {
+        id: number;
+        username: string;
+        displayName: string;
+        role: "admin" | "agent";
+        mustChangePassword: boolean;
+        disabled: boolean;
+        createdAt: number;
+        locale: "en" | "ms" | "zh-CN" | null;
+        kind?: "human" | "ai" | undefined;
+        aiRole?: "sales" | undefined;
+    } | null;
+    settings: {
+        displayName: string;
+        mode: "api" | "chatgpt";
+        enabled: boolean;
+        model: string;
+        instructions: string;
+        handoffRules?: string | undefined;
+    };
+    hasApiKey: boolean;
+    connection: {
+        state: "unavailable" | "connected" | "error" | "expired" | "signed_out" | "signing_in";
+        loginUrl: string | null;
+        error: string | null;
+        email?: string | null | undefined;
+    };
+    documents: {
+        id: number;
+        name: string;
+        kind: "text" | "file";
+        size: number;
+        characters: number;
+        createdAt: number;
+        updatedAt: number;
+    }[];
+}, Error, AiMemberAction, unknown>;

package/dist-lib/types/api/client.d.ts

@@ -0,0 +1,22 @@
+import type { z } from 'zod';
+export declare const UNAUTHORIZED_EVENT = "wati:unauthorized";
+export declare class ApiError extends Error {
+    status: number;
+    code: string;
+    constructor(status: number, code: string, message: string);
+}
+export interface ApiInit<T> {
+    method?: string;
+    body?: unknown;
+    form?: FormData;
+    schema?: z.ZodType<T>;
+    signal?: AbortSignal;
+}
+/**
+ * Fetch `/api${path}` with same-origin cookies. JSON in / JSON out.
+ * Non-2xx → ApiError (code/message from the server's `{ error: { code, message } }` body).
+ * 401 additionally dispatches a `wati:unauthorized` window event.
+ */
+export declare function api<T = unknown>(path: string, init?: ApiInit<T>): Promise<T>;
+/** Friendly, translated message for any thrown error. */
+export declare function errorMessage(e: unknown): string;

package/dist-lib/types/api/enrichment.d.ts

@@ -0,0 +1,8 @@
+export declare function useEnrichment(): import("@tanstack/react-query").UseQueryResult<{
+    enabled: boolean;
+    connected: boolean;
+}, Error>;
+export declare function useSaveEnrichment(): import("@tanstack/react-query").UseMutationResult<{
+    enabled: boolean;
+    connected: boolean;
+}, Error, boolean, unknown>;