@ezychat/web 0.0.0-stage → 0.1.39

package/dist-lib/types/lib/jid.d.ts

@@ -0,0 +1,15 @@
+/** Helpers for WhatsApp JIDs (e.g. `60123456789@s.whatsapp.net`, `12345-678@g.us`). */
+import type { Chat } from '@ezychat/shared';
+export declare function isGroupJid(jid: string): boolean;
+/** The user part before `@` and before any `:device` suffix. */
+export declare function jidUser(jid: string): string;
+/**
+ * Human-readable phone (`+60123456789`) for phone-number JIDs; '' for a WhatsApp ID (`@lid`),
+ * whose digits are never shown; 'Group' for groups; the raw user part for anything else.
+ */
+export declare function formatJid(jid: string): string;
+/** `+<digits>` when WhatsApp has told us the chat's phone number, else null (WhatsApp ID only). */
+export declare function formatPhone(chat: Pick<Chat, 'phone'>): string | null;
+/** For use in route paths: `/chats/${encodeJid(jid)}`. */
+export declare function encodeJid(jid: string): string;
+export declare function decodeJid(param: string): string;

package/dist-lib/types/lib/links.d.ts

@@ -0,0 +1,40 @@
+/** External links used for attribution and support across the app. */
+export declare const ANCHOR_SPRINT_URL = "https://www.anchorsprint.com";
+export declare const EZYCHAT_WEBSITE_URL = "https://ezychat.ai/";
+export declare const GITHUB_REPO_URL = "https://github.com/ossmalaysia/ezychat-lite";
+export declare const GITHUB_ISSUES_URL = "https://github.com/ossmalaysia/ezychat-lite/issues/new/choose";
+/** The website feedback form in the app's language, with the running version filled in. */
+export declare function feedbackUrl(locale: string, version: string | null): string;
+/** Contact Anchor Sprint for custom features. */
+export declare const CUSTOM_FEATURE_URL = "https://www.anchorsprint.com";
+/**
+ * The outside links the UI shows (About, Report an issue, release notes, feedback, support).
+ * Another product build overrides them through `createInboxApp({ links })`; `null` hides a link.
+ */
+export interface AppLinks {
+    /** Product website (About, and the share link when there is no source code link). */
+    website: string;
+    /** "Report an issue" page; when null, an email link to `supportEmail` is shown instead. */
+    reportIssue: string | null;
+    /** Public source code ("View on GitHub" in About). */
+    sourceCode: string | null;
+    /**
+     * Release notes for one version, shown by the desktop update panel. Lite opens its GitHub
+     * release through the desktop bridge; another value is opened as a plain link.
+     */
+    releaseNotes: ((version: string) => string | null) | null;
+    /** The feedback / feature request form in the app's language. */
+    feedback: (locale: string, version: string | null) => string;
+    /** Support email address (mailto link where there is no report-issue page). */
+    supportEmail: string | null;
+}
+/** Lite's links: GitHub repository and issues, feedback on ezychat.ai. */
+export declare const LITE_APP_LINKS: Readonly<AppLinks>;
+/** Lite's links with the given overrides (an explicit `null` hides that link). */
+export declare function resolveAppLinks(overrides?: Partial<AppLinks>): AppLinks;
+/** True when the release notes are Lite's own GitHub releases (opened via the desktop bridge). */
+export declare function isLiteReleaseNotes(links: AppLinks): boolean;
+/** Where "Report an issue" points: the page, else an email to support, else nothing. */
+export declare function reportIssueHref(links: AppLinks): string | null;
+/** The link the share-the-app actions share: the source code page, else the website. */
+export declare function shareAppUrl(links: AppLinks): string;

package/dist-lib/types/lib/share-app.d.ts

@@ -0,0 +1,18 @@
+/** Only this public project URL is shared, never the private inbox address. */
+export declare const SHARE_APP_URL = "https://github.com/ossmalaysia/ezychat-lite";
+export declare const SHARE_APP_CAPTION = "I'm using EzyChat Lite \u2014 a free WhatsApp team inbox that runs on my own computer. One number, a shared inbox for my team, and I own my data.";
+/** Social share pages for a link (another product shares its own website). */
+export declare function socialShareLinks(url: string): {
+    linkedin: string;
+    facebook: string;
+};
+export declare const SOCIAL_SHARE_LINKS: {
+    linkedin: string;
+    facebook: string;
+};
+export declare function shareAppMessage(caption: string, url?: string): string;
+export declare function copyShareText(text: string): Promise<void>;
+/** Native share failures fall back to copying. Closing the share sheet is quiet. */
+export declare function shareApp(caption: string, url?: string): Promise<'shared' | 'cancelled' | 'copied'>;
+/** Rasterize the static brand card locally; no inbox content enters the image. */
+export declare function downloadShareCard(): Promise<void>;

package/dist-lib/types/lib/theme.d.ts

@@ -0,0 +1,29 @@
+export type ThemePreference = 'system' | 'light' | 'dark';
+export type ResolvedTheme = 'light' | 'dark';
+export declare const THEME_STORAGE_KEY = "wati.theme";
+/** `labelKey` is a translation key (`common:theme.*`). */
+export declare const THEME_OPTIONS: readonly [{
+    readonly value: "system";
+    readonly labelKey: "theme.system";
+}, {
+    readonly value: "light";
+    readonly labelKey: "theme.light";
+}, {
+    readonly value: "dark";
+    readonly labelKey: "theme.dark";
+}];
+/** Device preference, independent of server settings and shared with other tabs. */
+export declare function createThemeStore(target?: Window): {
+    getSnapshot: () => {
+        theme: ThemePreference;
+        resolvedTheme: ResolvedTheme;
+    };
+    subscribe(listener: () => void): () => boolean;
+    setTheme(value: string): void;
+    dispose(): void;
+};
+export declare function useTheme(): {
+    setTheme: (value: string) => void;
+    theme: ThemePreference;
+    resolvedTheme: ResolvedTheme;
+};

package/dist-lib/types/lib/use-media-query.d.ts

@@ -0,0 +1,2 @@
+/** Subscribes to a CSS media query. Returns false where matchMedia is unavailable (tests/SSR). */
+export declare function useMediaQuery(query: string): boolean;

package/dist-lib/types/lib/utils.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;

package/dist-lib/types/lib/version.d.ts

@@ -0,0 +1,12 @@
+/** Shape of GET /api/health (only the fields the UI needs). */
+export interface HealthInfo {
+    app: string;
+    version: string;
+    mode: string;
+}
+export declare const healthQueryKey: readonly ["health"];
+/** Version baked into the web bundle at build time (root package.json), or null if not defined. */
+export declare const BUILD_VERSION: string | null;
+export declare function useAppVersion(): string | null;
+/** The server's run mode from GET /api/health ('dev' for local and test servers), or null while unknown. */
+export declare function useServerMode(): string | null;

package/dist-lib/types/lib/voice-recorder.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Records a WhatsApp voice note: microphone → Ogg/Opus (mono, 48 kHz, voice mode), encoded in a
+ * worker by opus-recorder's bundled WebAssembly encoder, so every browser (Safari included) yields
+ * the format WhatsApp expects. The encoder is loaded only when a recording starts.
+ */
+/** Longest recording; the server refuses longer voice notes. */
+export declare const VOICE_NOTE_MAX_SECONDS = 300;
+export type VoiceSupport = 'ok' | 'insecure' | 'unsupported';
+/** Why a recording could not start. */
+export type VoiceStartError = 'blocked' | 'no-microphone' | 'failed';
+export interface VoiceRecording {
+    /** Current input level, 0 (silence) to 1. */
+    level(): number;
+    /** Ends the recording and returns the Ogg/Opus file. */
+    stop(): Promise<Blob>;
+    /** Ends the recording and discards it. */
+    cancel(): void;
+}
+/** Browsers allow the microphone only on secure pages (https, localhost, the desktop app). */
+export declare function voiceSupport(): VoiceSupport;
+export declare class VoiceStartFailure extends Error {
+    readonly reason: VoiceStartError;
+    constructor(reason: VoiceStartError);
+}
+/** Must be called from a click or tap: browsers only start audio from a user action. */
+export declare function startVoiceRecording(): Promise<VoiceRecording>;

package/dist-lib/types/pwa/InstallHint.d.ts

@@ -0,0 +1,9 @@
+/**
+ * iOS Safari only delivers notifications to Home Screen web apps.
+ * Renders nothing elsewhere (or when `force` is false and already installed).
+ */
+export declare function InstallHint({ className, force }: {
+    className?: string;
+    force?: boolean;
+}): import("react").JSX.Element | null;
+export default InstallHint;

package/dist-lib/types/pwa/PushToggle.d.ts

@@ -0,0 +1,20 @@
+import type React from 'react';
+/** The two parts of the toggle for a settings row: the switch, and what goes under the row. */
+export interface PushToggleParts {
+    /** Just the switch (null when this device cannot turn notifications on). */
+    control: React.ReactNode;
+    /** Hints and problems, shown under the whole row. */
+    notes: React.ReactNode;
+}
+/**
+ * Push-notification opt-in for the current device (place it in the user menu).
+ * `compact` renders a single row suitable for menus / side bars. With `children`, it renders
+ * nothing itself and hands the switch and its notes to a settings row (`labelledBy` names it).
+ */
+export declare function PushToggle({ compact, className, labelledBy, children, }: {
+    compact?: boolean;
+    className?: string;
+    labelledBy?: string;
+    children?: (parts: PushToggleParts) => React.ReactNode;
+}): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
+export default PushToggle;

package/dist-lib/types/pwa/desktop-notifications.d.ts

@@ -0,0 +1,18 @@
+import { NotificationPayload } from '@ezychat/shared';
+interface DesktopNotifications {
+    isSupported(): Promise<boolean>;
+    show(notification: NotificationPayload): Promise<boolean>;
+    clear(): Promise<void>;
+}
+declare global {
+    interface Window {
+        watiNotifications?: DesktopNotifications;
+    }
+}
+export declare function isDesktopNotifications(): boolean;
+export declare function desktopNotificationsEnabled(): boolean;
+export declare function setDesktopNotifications(enabledNext: boolean): Promise<void>;
+/** Only called for authenticated, targeted live events; history messages never enter this path. */
+export declare function showDesktopNotification(value: NotificationPayload): Promise<void>;
+export declare function clearDesktopNotifications(): void;
+export {};

package/dist-lib/types/pwa/push.d.ts

@@ -0,0 +1,13 @@
+export declare function isPushSupported(): boolean;
+export declare function isIOS(): boolean;
+export declare function isStandalone(): boolean;
+/** iOS only delivers web push to Home Screen web apps. */
+export declare function needsInstallForPush(): boolean;
+export declare function urlBase64ToUint8Array(base64: string): Uint8Array<ArrayBuffer>;
+export declare function fetchVapidKey(): Promise<string>;
+/** Current service worker registration (waits for it to become ready, max `timeoutMs`). */
+export declare function getSWRegistration(timeoutMs?: number): Promise<ServiceWorkerRegistration | null>;
+export declare function getCurrentSubscription(): Promise<PushSubscription | null>;
+/** Ask permission, subscribe with the server's VAPID key and register the subscription. */
+export declare function subscribePush(): Promise<PushSubscription | null>;
+export declare function unsubscribePush(): Promise<void>;

package/dist-lib/types/setup/AiAssistantStep.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Setup step 3 (skippable): describe the business, connect the AI, optionally turn it on.
+ * Finish creates the Sales Agent with the recommended instructions and hand-off rules, saves the
+ * text as one Business context item and turns the agent on when chosen.
+ */
+export declare function AiAssistantStep({ businessName, onDone, }: {
+    businessName: string;
+    onDone: (aiOn: boolean) => void;
+}): import("react").JSX.Element;

package/dist-lib/types/setup/SetupWizard.d.ts

@@ -0,0 +1,3 @@
+/** First-run wizard: account → link WhatsApp → AI assistant (skippable) → ready. */
+export declare function SetupWizard(): import("react").JSX.Element;
+export default SetupWizard;

package/dist-lib/types/setup/WaLinkStep.d.ts

@@ -0,0 +1,8 @@
+import type React from 'react';
+export interface WaLinkStepProps {
+    onContinue?: () => void;
+    onSkip?: () => void;
+}
+/** Shows the pairing QR (from wa status) until the number is linked. */
+export declare function WaLinkStep({ onContinue, onSkip }: WaLinkStepProps): React.JSX.Element;
+export default WaLinkStep;

package/dist-lib/types/setup/agent-name.d.ts

@@ -0,0 +1,8 @@
+/** The longest Sales Agent name the server accepts (AiMemberBody.displayName). */
+export declare const AGENT_NAME_MAX = 64;
+/**
+ * The Sales Agent name for a business, e.g. "Kedai Aisyah AI". A long business name is shortened at
+ * a word boundary so the whole name, the " AI" part included, fits in AGENT_NAME_MAX characters.
+ * `format` is the translated template (the business name may come first or last).
+ */
+export declare function agentNameFor(business: string, format: (business: string) => string): string;

package/dist-lib/types/setup/connected-label.d.ts

@@ -0,0 +1,7 @@
+import type { TFunction } from 'i18next';
+import type { WaStatus } from '@ezychat/shared';
+/**
+ * "Connected as …" for the linked account. A WhatsApp ID (`@lid`) own JID has no printable number,
+ * so fall back to the account name, else the plain "Connected." — never an empty number.
+ */
+export declare function connectedAsLabel(me: WaStatus['me'], t: TFunction<'auth'>): string;

package/dist-lib/types/setup/username.d.ts

@@ -0,0 +1,9 @@
+/** The username offered when "Your name" gives too few usable characters (e.g. a name in Chinese). */
+export declare const USERNAME_FALLBACK = "admin";
+/** "Aisyah Rahman" → "aisyah.rahman"; characters a username cannot hold are dropped (may be short). */
+export declare function usernameFromName(name: string): string;
+/**
+ * The username prefilled from "Your name": always a valid username once a name is typed, so the
+ * owner never has to type one. Falls back to "admin" when the name gives fewer than 3 characters.
+ */
+export declare function usernameFrom(name: string): string;

package/dist-lib/types/wa/PhoneLink.d.ts

@@ -0,0 +1,4 @@
+/** "ABCD1234" → "ABCD-1234", the way WhatsApp displays pairing codes. */
+export declare function formatPairingCode(code: string): string;
+/** Link WhatsApp with a phone number + 8-character pairing code instead of scanning a QR. */
+export declare function PhoneLink(): import("react").JSX.Element;

package/package.json

@@ -1,6 +1,83 @@
 {
   "name": "@ezychat/web",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.39",
+  "type": "module",
+  "description": "EzyChat core: the team inbox web app (React) as a library, with createInboxApp and its extension API.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ossmalaysia/ezychat-lite.git",
+    "directory": "apps/web"
+  },
+  "homepage": "https://ezychat.ai/",
+  "exports": {
+    ".": {
+      "ezychat-source": "./src/index.ts",
+      "types": "./dist-lib/types/index.d.ts",
+      "default": "./dist-lib/index.js"
+    },
+    "./style.css": "./dist-lib/ezychat-web.css",
+    "./sw.ts": "./dist-lib/sw.ts",
+    "./public/*": {
+      "ezychat-source": "./public/*",
+      "default": "./dist-lib/public/*"
+    },
+    "./package.json": "./package.json"
+  },
+  "types": "./dist-lib/types/index.d.ts",
+  "files": [
+    "dist-lib"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build && node ../../scripts/precompress-web.mjs",
+    "preview": "vite preview",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "build:lib": "node ../../scripts/build-web-lib.mjs"
+  },
+  "dependencies": {
+    "@ezychat/shared": "0.1.39",
+    "@fontsource-variable/inter": "^5.3.0",
+    "@tanstack/react-query": "^5.104.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "cmdk": "^1.1.1",
+    "cn": "^0.4.0",
+    "date-fns": "^4.4.0",
+    "i18next": "^26.4.2",
+    "lucide-react": "^1.50.0",
+    "next-themes": "^0.4.6",
+    "opus-recorder": "8.0.5",
+    "qrcode.react": "^4.2.0",
+    "radix-ui": "^1.6.7",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "react-i18next": "^17.0.15",
+    "react-router-dom": "^7.18.4",
+    "socket.io-client": "^4.8.4",
+    "sonner": "^2.0.8",
+    "tailwind-merge": "^3.7.0",
+    "tw-animate-css": "^1.4.0",
+    "vaul": "^1.1.2"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.3.3",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.3",
+    "@testing-library/user-event": "^14.6.7",
+    "@vitejs/plugin-react": "^6.1.1",
+    "jsdom": "^30.1.1",
+    "tailwindcss": "^4.3.3",
+    "vite": "^8.3.2",
+    "vite-plugin-pwa": "^1.3.0",
+    "workbox-precaching": "^7.4.1",
+    "workbox-window": "^7.4.1"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.