prosupportai-widget 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @prosupportai/widget
+ *
+ * Thin npm wrapper for the ProSupportAI browser widget.
+ *
+ * Usage:
+ *   import ProSupportAI from "@prosupportai/widget";
+ *   ProSupportAI.init({ app_id: "YOUR_APP_ID", supabase_url: "https://xyz.supabase.co" });
+ *
+ * The package dynamically injects the widget runtime script on first init() call,
+ * then delegates all API calls to window.ProSupportAI.  The browser global path
+ * (plain <script> tag install) continues to work completely unchanged.
+ */
+/** Configuration accepted by ProSupportAI.init(). */
+export interface ProSupportAIConfig {
+    /** Public app identifier — the preferred single-key install method. */
+    app_id?: string;
+    /**
+     * URL of the hosted widget.js script.
+     * Defaults to "https://prosupportai.com/widget.js".
+     * Override for self-hosted / staging deployments.
+     */
+    widget_url?: string;
+    /**
+     * Supabase project base URL (e.g. "https://xyz.supabase.co").
+     * Required when using app_id so the widget can call widget-resolve.
+     * Maps to the data-supabase-url attribute on the injected script tag.
+     */
+    supabase_url?: string;
+    user_id?: string;
+    name?: string;
+    email?: string;
+    created_at?: string;
+    theme?: "system" | "light" | "dark";
+    primary_color?: string;
+    launcher_position?: "left" | "right";
+    side_spacing?: number;
+    bottom_spacing?: number;
+    match_site_style?: boolean;
+    botId?: string;
+    token?: string;
+    endpoint?: string;
+    widgetHost?: string;
+    debug?: boolean;
+    debugWidget?: boolean;
+    [key: string]: unknown;
+}
+type QueueEntry = [string, unknown];
+interface ProSupportAIGlobal {
+    _q?: QueueEntry[];
+    init(config: ProSupportAIConfig): void;
+    update(config: Partial<ProSupportAIConfig>): void;
+    show(): void;
+    hide(): void;
+    shutdown(): void;
+}
+declare global {
+    interface Window {
+        ProSupportAI?: ProSupportAIGlobal;
+    }
+}
+declare const ProSupportAI: {
+    /**
+     * Initialize the widget. Injects widget.js on first call if not already
+     * present, then delegates to window.ProSupportAI.init().
+     *
+     * @example
+     * ProSupportAI.init({ app_id: "YOUR_APP_ID", supabase_url: "https://xyz.supabase.co" });
+     */
+    init(config?: ProSupportAIConfig): void;
+    /**
+     * Send a config update to the running widget (forwarded via postMessage).
+     */
+    update(config: Partial<ProSupportAIConfig>): void;
+    /** Expand / reveal the widget panel. */
+    show(): void;
+    /** Collapse / hide the widget panel. */
+    hide(): void;
+    /** Destroy the iframe and remove the widget container from the DOM. */
+    shutdown(): void;
+};
+export default ProSupportAI;
+export { ProSupportAI };

package/dist/index.js

@@ -0,0 +1,125 @@
+/**
+ * @prosupportai/widget
+ *
+ * Thin npm wrapper for the ProSupportAI browser widget.
+ *
+ * Usage:
+ *   import ProSupportAI from "@prosupportai/widget";
+ *   ProSupportAI.init({ app_id: "YOUR_APP_ID", supabase_url: "https://xyz.supabase.co" });
+ *
+ * The package dynamically injects the widget runtime script on first init() call,
+ * then delegates all API calls to window.ProSupportAI.  The browser global path
+ * (plain <script> tag install) continues to work completely unchanged.
+ */
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const DEFAULT_WIDGET_URL = "https://prosupportai.com/widget.js";
+const SCRIPT_ID = "prosupportai-widget-sdk";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Ensure window.ProSupportAI exists with a pre-load queue so calls made
+ * before the script finishes loading are buffered and replayed.
+ * The real widget.js drains window.ProSupportAI._q on load.
+ */
+function ensureQueue() {
+    if (typeof window === "undefined")
+        return;
+    if (window.ProSupportAI)
+        return;
+    const q = [];
+    window.ProSupportAI = {
+        _q: q,
+        init: (c) => { q.push(["init", c]); },
+        update: (c) => { q.push(["update", c]); },
+        show: () => { q.push(["show", undefined]); },
+        hide: () => { q.push(["hide", undefined]); },
+        shutdown: () => { q.push(["shutdown", undefined]); },
+    };
+}
+/** Inject the widget.js script tag once. No-op if already present. */
+function injectScript(widgetUrl, supabaseUrl) {
+    if (typeof document === "undefined")
+        return;
+    if (document.getElementById(SCRIPT_ID))
+        return;
+    const script = document.createElement("script");
+    script.id = SCRIPT_ID;
+    script.src = widgetUrl;
+    script.async = true;
+    if (supabaseUrl)
+        script.setAttribute("data-supabase-url", supabaseUrl);
+    document.head.appendChild(script);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+const ProSupportAI = {
+    /**
+     * Initialize the widget. Injects widget.js on first call if not already
+     * present, then delegates to window.ProSupportAI.init().
+     *
+     * @example
+     * ProSupportAI.init({ app_id: "YOUR_APP_ID", supabase_url: "https://xyz.supabase.co" });
+     */
+    init(config = {}) {
+        var _a;
+        if (typeof window === "undefined")
+            return; // SSR guard
+        const widgetUrl = (_a = config.widget_url) !== null && _a !== void 0 ? _a : DEFAULT_WIDGET_URL;
+        const supabaseUrl = config.supabase_url;
+        // Strip sdk-only fields before forwarding to the runtime
+        const { widget_url: _w, supabase_url: _s } = config, runtimeConfig = __rest(config, ["widget_url", "supabase_url"]);
+        ensureQueue();
+        injectScript(widgetUrl, supabaseUrl);
+        // At this point window.ProSupportAI is either the real API (if widget.js
+        // was already loaded) or the queue stub above.  Either way, calling .init()
+        // does the right thing.
+        window.ProSupportAI.init(runtimeConfig);
+    },
+    /**
+     * Send a config update to the running widget (forwarded via postMessage).
+     */
+    update(config) {
+        var _a;
+        if (typeof window === "undefined")
+            return;
+        (_a = window.ProSupportAI) === null || _a === void 0 ? void 0 : _a.update(config);
+    },
+    /** Expand / reveal the widget panel. */
+    show() {
+        var _a;
+        if (typeof window === "undefined")
+            return;
+        (_a = window.ProSupportAI) === null || _a === void 0 ? void 0 : _a.show();
+    },
+    /** Collapse / hide the widget panel. */
+    hide() {
+        var _a;
+        if (typeof window === "undefined")
+            return;
+        (_a = window.ProSupportAI) === null || _a === void 0 ? void 0 : _a.hide();
+    },
+    /** Destroy the iframe and remove the widget container from the DOM. */
+    shutdown() {
+        var _a;
+        if (typeof window === "undefined")
+            return;
+        (_a = window.ProSupportAI) === null || _a === void 0 ? void 0 : _a.shutdown();
+    },
+};
+export default ProSupportAI;
+export { ProSupportAI };

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "prosupportai-widget",
+  "version": "1.0.0",
+  "description": "ProSupportAI browser chat widget — npm install wrapper",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "chat",
+    "widget",
+    "prosupportai",
+    "customer-support",
+    "live-chat"
+  ],
+  "license": "MIT",
+  "sideEffects": false,
+  "author": "ProSupportAI"
+}