@humanfirst-chat/js 0.1.6 → 0.2.0

package/dist/index.d.mts

@@ -58,6 +58,10 @@ type HFChatGlobal = HFChatAPI & {
      */
     init(opts?: HFChatLoaderConfig): Promise<HFChatAPI>;
 };
+type QueuedCall = {
+    method: keyof HFChatAPI;
+    args: unknown[];
+};
 declare global {
     interface Window {
         HFChat?: HFChatAPI;
@@ -65,8 +69,13 @@ declare global {
             init: (opts: unknown) => HFChatAPI;
         };
         __HFCHAT_DISABLE_AUTO_INIT?: boolean;
+        __HFCHAT_QUEUE__?: QueuedCall[];
+        __HFCHAT_REAL__?: HFChatAPI;
     }
 }
-declare const HFChat: HFChatGlobal;
+declare const HFChat: HFChatGlobal & {
+    __HFCHAT_STUB__?: true;
+    __real?: HFChatAPI;
+};
 
 export { HFChat, type HFChatAPI, type HFChatConfig, type HFChatGlobal, type HFChatIdentifyMeta, type HFChatLoaderConfig, type HFChatLogLevel, type HFChatOpenOptions, type HFChatWidgetSettings, HFChat as default };

package/dist/index.d.ts

@@ -58,6 +58,10 @@ type HFChatGlobal = HFChatAPI & {
      */
     init(opts?: HFChatLoaderConfig): Promise<HFChatAPI>;
 };
+type QueuedCall = {
+    method: keyof HFChatAPI;
+    args: unknown[];
+};
 declare global {
     interface Window {
         HFChat?: HFChatAPI;
@@ -65,8 +69,13 @@ declare global {
             init: (opts: unknown) => HFChatAPI;
         };
         __HFCHAT_DISABLE_AUTO_INIT?: boolean;
+        __HFCHAT_QUEUE__?: QueuedCall[];
+        __HFCHAT_REAL__?: HFChatAPI;
     }
 }
-declare const HFChat: HFChatGlobal;
+declare const HFChat: HFChatGlobal & {
+    __HFCHAT_STUB__?: true;
+    __real?: HFChatAPI;
+};
 
 export { HFChat, type HFChatAPI, type HFChatConfig, type HFChatGlobal, type HFChatIdentifyMeta, type HFChatLoaderConfig, type HFChatLogLevel, type HFChatOpenOptions, type HFChatWidgetSettings, HFChat as default };

package/dist/index.js

@@ -41,14 +41,44 @@ function logError(message, ...args) {
 }
 var loaderPromise = null;
 var lastInitOpts;
-function getRealApi(selfProxy) {
+function getQueue() {
+  if (typeof window === "undefined") return [];
+  if (!window.__HFCHAT_QUEUE__) {
+    window.__HFCHAT_QUEUE__ = [];
+  }
+  return window.__HFCHAT_QUEUE__;
+}
+function enqueue(method, args) {
+  if (typeof window === "undefined") return;
+  getQueue().push({ method, args });
+}
+function getRealApi() {
   if (typeof window === "undefined") return null;
+  const globalReal = window.__HFCHAT_REAL__;
+  if (globalReal && globalReal.__HFCHAT_INSTANCE__ === true) {
+    return globalReal;
+  }
   const candidate = window.HFChat;
-  if (!candidate) return null;
-  if (candidate === selfProxy) return null;
-  if (candidate.__HFCHAT_INSTANCE__ === true) return candidate;
+  if (candidate && candidate.__HFCHAT_INSTANCE__ === true) {
+    return candidate;
+  }
+  if (candidate && candidate.__real && candidate.__real.__HFCHAT_INSTANCE__ === true) {
+    return candidate.__real;
+  }
   return null;
 }
+function callOrQueue(method, args) {
+  if (typeof window === "undefined") return;
+  const api = getRealApi();
+  const fn = api ? api[method] : null;
+  if (api && typeof fn === "function") {
+    logFull(`Calling '${String(method)}' on real API`);
+    fn.apply(api, args);
+    return;
+  }
+  logFull(`Queueing '${String(method)}' until real API is ready`);
+  enqueue(method, args);
+}
 function injectScript(src) {
   return new Promise((resolve, reject) => {
     if (typeof document === "undefined") return resolve();
@@ -111,8 +141,9 @@ async function loadWidget(opts = {}) {
     baseURL: opts.baseURL,
     host: opts.host
   });
-  logFull("HumanFirstChat.init() returned:", { hasInstance: api?.__HFCHAT_INSTANCE__ });
-  return api;
+  const realApi = getRealApi();
+  logFull("HumanFirstChat.init() returned:", { hasInstance: realApi?.__HFCHAT_INSTANCE__ });
+  return realApi ?? api;
 }
 async function init(opts = {}) {
   if (opts.logs) {
@@ -120,7 +151,7 @@ async function init(opts = {}) {
   }
   lastInitOpts = { ...lastInitOpts, ...opts };
   log("init() called with options:", { siteId: opts.siteId, logs: opts.logs });
-  const existingApi = getRealApi(HFChat);
+  const existingApi = getRealApi();
   if (existingApi) {
     log("Returning existing real API");
     return existingApi;
@@ -133,84 +164,46 @@ async function init(opts = {}) {
   loaderPromise = loadWidget(lastInitOpts);
   return loaderPromise;
 }
-async function waitForMethod(methodName) {
-  logFull(`waitForMethod('${methodName}') starting...`);
-  await init();
-  logFull(`init() completed, checking for '${methodName}'`);
-  const existing = getRealApi(HFChat);
-  logFull("getRealApi returned:", existing ? "real API found" : "null");
-  if (existing && typeof existing[methodName] === "function") {
-    log(`Method '${methodName}' available immediately`);
-    return existing;
-  }
-  logFull(`Polling for '${methodName}'...`);
-  return new Promise((resolve, reject) => {
-    let attempts = 0;
-    const maxAttempts = 50;
-    const checkMethod = () => {
-      const api = getRealApi(HFChat);
-      const fn = api ? api[methodName] : null;
-      if (attempts % 10 === 0 && attempts > 0) {
-        logFull(`Polling attempt ${attempts}/50 for '${methodName}':`, {
-          hasApi: !!api,
-          hasMethod: !!fn,
-          windowHFChat: typeof window.HFChat,
-          isProxy: window.HFChat === HFChat
-        });
+var HFChat = {
+  init,
+  show: () => callOrQueue("show", []),
+  hide: () => callOrQueue("hide", []),
+  open: (options) => callOrQueue("open", [options]),
+  close: () => callOrQueue("close", []),
+  toggle: () => callOrQueue("toggle", []),
+  isOpen: () => {
+    const api = getRealApi();
+    return api?.isOpen?.() ?? false;
+  },
+  identify: (meta) => callOrQueue("identify", [meta]),
+  configure: (settings) => callOrQueue("configure", [settings]),
+  onReady: (callback) => {
+    if (typeof callback !== "function") return;
+    const api = getRealApi();
+    if (api?.ready) {
+      try {
+        callback();
+      } catch (error) {
+        console.error("[HFChat SDK] Error in onReady callback:", error);
       }
-      if (api && typeof fn === "function") {
-        log(`Method '${methodName}' found after ${attempts} attempts`);
-        resolve(api);
-        return;
-      }
-      if (attempts < maxAttempts) {
-        attempts += 1;
-        setTimeout(checkMethod, 100);
-        return;
-      }
-      logError(`Timeout: '${methodName}' not available after 5 seconds`);
-      reject(new Error(`HFChat method '${methodName}' not available after 5 seconds`));
-    };
-    setTimeout(checkMethod, 100);
-  });
-}
-var HFChat = new Proxy(
-  {},
-  {
-    get(_target, prop) {
-      if (prop === "init") return init;
-      if (typeof window === "undefined") return () => {
-      };
-      if (prop === "__HFCHAT_INSTANCE__") return void 0;
-      if (prop === "then") return void 0;
-      if (prop === "ready") {
-        const api = getRealApi(HFChat);
-        return !!api?.ready;
-      }
-      if (prop === "isOpen") {
-        return () => {
-          const api = getRealApi(HFChat);
-          return api?.isOpen?.() ?? false;
-        };
-      }
-      return (...args) => {
-        const methodName = String(prop);
-        logFull(`Proxy: '${methodName}' called, forwarding to waitForMethod`);
-        waitForMethod(methodName).then((api) => {
-          const fn = api[methodName];
-          if (typeof fn === "function") {
-            logFull(`Proxy: executing '${methodName}' on real API`);
-            fn.apply(api, args);
-          } else {
-            logError(`Method '${methodName}' not found on real API`);
-          }
-        }).catch((error) => {
-          logError(error instanceof Error ? error.message : String(error));
-        });
-      };
+      return;
     }
+    callOrQueue("onReady", [callback]);
+  },
+  onOpen: (callback) => {
+    if (typeof callback !== "function") return;
+    callOrQueue("onOpen", [callback]);
+  },
+  onClose: (callback) => {
+    if (typeof callback !== "function") return;
+    callOrQueue("onClose", [callback]);
+  },
+  get ready() {
+    const api = getRealApi();
+    return api?.ready ?? false;
   }
-);
+};
+HFChat.__HFCHAT_STUB__ = true;
 if (typeof window !== "undefined") {
   if (!window.HFChat) {
     window.HFChat = HFChat;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Re-export public types for consumers\nexport type {\n  HFChatLogLevel,\n  HFChatConfig,\n  HFChatWidgetSettings,\n  HFChatIdentifyMeta,\n  HFChatOpenOptions,\n  HFChatAPI,\n} from './types'\n\nimport type { HFChatConfig, HFChatAPI, HFChatLogLevel } from './types'\n\n// Extended config for the JS SDK loader (adds scriptSrc option)\nexport type HFChatLoaderConfig = HFChatConfig & {\n  /** Override widget script source (for self-hosting / testing) */\n  scriptSrc?: string\n}\n\nexport type HFChatGlobal = HFChatAPI & {\n  /**\n   * Load the widget script and initialize the widget.\n   */\n  init(opts?: HFChatLoaderConfig): Promise<HFChatAPI>\n}\n\ndeclare global {\n  interface Window {\n    HFChat?: HFChatAPI\n    HumanFirstChat?: {\n      init: (opts: unknown) => HFChatAPI\n    }\n    __HFCHAT_DISABLE_AUTO_INIT?: boolean\n  }\n}\n\nconst DEFAULT_SCRIPT_SRC = 'https://humanfirst.chat/widget.js'\nconst SCRIPT_DATA_ATTR = 'data-hfchat-widget'\n\n// Logging configuration\nlet logLevel: HFChatLogLevel = 'none'\n\nfunction log(message: string, ...args: unknown[]) {\n  if (logLevel === 'none') return\n  console.log(`[HFChat SDK] ${message}`, ...args)\n}\n\nfunction logFull(message: string, ...args: unknown[]) {\n  if (logLevel !== 'full') return\n  console.log(`[HFChat SDK] ${message}`, ...args)\n}\n\nfunction logError(message: string, ...args: unknown[]) {\n  if (logLevel === 'none') return\n  console.error(`[HFChat SDK] ${message}`, ...args)\n}\n\nlet loaderPromise: Promise<HFChatAPI> | null = null\nlet lastInitOpts: HFChatLoaderConfig | undefined\n\nfunction getRealApi(selfProxy: HFChatGlobal): HFChatAPI | null {\n  if (typeof window === 'undefined') return null\n  const candidate = window.HFChat\n  if (!candidate) return null\n  // Check if candidate is the proxy (same reference) - if so, real API not yet available\n  if (candidate === selfProxy) return null\n  // Check if candidate has the real instance marker\n  if ((candidate as any).__HFCHAT_INSTANCE__ === true) return candidate\n  return null\n}\n\nfunction injectScript(src: string): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (typeof document === 'undefined') return resolve()\n    if (window.HumanFirstChat) {\n      logFull('HumanFirstChat already exists, skipping script injection')\n      return resolve()\n    }\n\n    const existing = document.querySelector(\n      `script[${SCRIPT_DATA_ATTR}=\"1\"]`\n    ) as HTMLScriptElement | null\n    if (existing) {\n      logFull('Widget script already in DOM, waiting for load')\n      existing.addEventListener('load', () => resolve(), { once: true })\n      existing.addEventListener(\n        'error',\n        () => reject(new Error('Failed to load widget script')),\n        { once: true }\n      )\n      return\n    }\n\n    log('Injecting widget script:', src)\n    window.__HFCHAT_DISABLE_AUTO_INIT = true\n    const script = document.createElement('script')\n    script.async = true\n    script.src = src\n    script.setAttribute(SCRIPT_DATA_ATTR, '1')\n    script.setAttribute('data-auto-init', 'false')\n    script.onerror = () => {\n      logError('Failed to load widget script:', src)\n      reject(new Error(`Failed to load widget script: ${src}`))\n    }\n    script.onload = () => {\n      setTimeout(() => {\n        if (window.HumanFirstChat) {\n          log('Widget script loaded successfully')\n          resolve()\n        } else {\n          logError('Widget script loaded but HumanFirstChat not found')\n          reject(new Error('Widget did not attach to window.HumanFirstChat'))\n        }\n      }, 0)\n    }\n    document.head.appendChild(script)\n  })\n}\n\nasync function loadWidget(opts: HFChatLoaderConfig = {}): Promise<HFChatAPI> {\n  if (typeof window === 'undefined') return {} as HFChatAPI\n\n  const scriptSrc = opts.scriptSrc ?? DEFAULT_SCRIPT_SRC\n  logFull('loadWidget starting with options:', { siteId: opts.siteId, scriptSrc })\n\n  await injectScript(scriptSrc)\n\n  if (!window.HumanFirstChat?.init) {\n    throw new Error('HumanFirstChat.init is not available after script load')\n  }\n\n  log('Calling HumanFirstChat.init()')\n  const api = window.HumanFirstChat.init({\n    siteId: opts.siteId,\n    hidden: opts.hidden,\n    hideOnClose: opts.hideOnClose,\n    logs: opts.logs,\n    baseURL: opts.baseURL,\n    host: opts.host,\n  })\n\n  logFull('HumanFirstChat.init() returned:', { hasInstance: (api as any)?.__HFCHAT_INSTANCE__ })\n  return api\n}\n\nasync function init(opts: HFChatLoaderConfig = {}): Promise<HFChatAPI> {\n  // Update log level from options\n  if (opts.logs) {\n    logLevel = opts.logs\n  }\n\n  lastInitOpts = { ...lastInitOpts, ...opts }\n  log('init() called with options:', { siteId: opts.siteId, logs: opts.logs })\n\n  const existingApi = getRealApi(HFChat)\n  if (existingApi) {\n    log('Returning existing real API')\n    return existingApi\n  }\n\n  if (loaderPromise) {\n    logFull('Returning existing loader promise')\n    return loaderPromise\n  }\n\n  log('Starting widget load...')\n  loaderPromise = loadWidget(lastInitOpts)\n  return loaderPromise\n}\n\nasync function waitForMethod(methodName: string): Promise<HFChatAPI> {\n  logFull(`waitForMethod('${methodName}') starting...`)\n\n  // Ensure init is called (may already be in progress)\n  await init()\n  logFull(`init() completed, checking for '${methodName}'`)\n\n  // Check if real API is already available\n  const existing = getRealApi(HFChat)\n  logFull('getRealApi returned:', existing ? 'real API found' : 'null')\n\n  if (existing && typeof (existing as any)[methodName] === 'function') {\n    log(`Method '${methodName}' available immediately`)\n    return existing\n  }\n\n  // Poll for the real API to become available\n  logFull(`Polling for '${methodName}'...`)\n  return new Promise((resolve, reject) => {\n    let attempts = 0\n    const maxAttempts = 50 // 5 seconds total\n\n    const checkMethod = () => {\n      const api = getRealApi(HFChat)\n      const fn = api ? (api as any)[methodName] : null\n\n      // Log every 10 attempts (1 second)\n      if (attempts % 10 === 0 && attempts > 0) {\n        logFull(`Polling attempt ${attempts}/50 for '${methodName}':`, {\n          hasApi: !!api,\n          hasMethod: !!fn,\n          windowHFChat: typeof window.HFChat,\n          isProxy: window.HFChat === HFChat\n        })\n      }\n\n      if (api && typeof fn === 'function') {\n        log(`Method '${methodName}' found after ${attempts} attempts`)\n        resolve(api)\n        return\n      }\n\n      if (attempts < maxAttempts) {\n        attempts += 1\n        setTimeout(checkMethod, 100)\n        return\n      }\n\n      logError(`Timeout: '${methodName}' not available after 5 seconds`)\n      reject(new Error(`HFChat method '${methodName}' not available after 5 seconds`))\n    }\n\n    setTimeout(checkMethod, 100)\n  })\n}\n\nexport const HFChat: HFChatGlobal = new Proxy(\n  {},\n  {\n    get(_target, prop) {\n      // Handle init specially - it's the entry point\n      if (prop === 'init') return init\n\n      // Server-side rendering guard\n      if (typeof window === 'undefined') return () => {}\n\n      // Handle __HFCHAT_INSTANCE__ check - return undefined so proxy isn't mistaken for real instance\n      if (prop === '__HFCHAT_INSTANCE__') return undefined\n\n      // Handle 'then' - return undefined so proxy isn't treated as a thenable/Promise\n      // This is critical because await/Promise.resolve() check for .then()\n      if (prop === 'then') return undefined\n\n      // Handle ready property\n      if (prop === 'ready') {\n        const api = getRealApi(HFChat)\n        return !!api?.ready\n      }\n\n      // Handle isOpen method\n      if (prop === 'isOpen') {\n        return () => {\n          const api = getRealApi(HFChat)\n          return api?.isOpen?.() ?? false\n        }\n      }\n\n      // For all other methods, queue them until the real API is ready\n      return (...args: unknown[]) => {\n        const methodName = String(prop)\n        logFull(`Proxy: '${methodName}' called, forwarding to waitForMethod`)\n\n        waitForMethod(methodName)\n          .then((api) => {\n            const fn = (api as any)[methodName]\n            if (typeof fn === 'function') {\n              logFull(`Proxy: executing '${methodName}' on real API`)\n              fn.apply(api, args)\n            } else {\n              logError(`Method '${methodName}' not found on real API`)\n            }\n          })\n          .catch((error) => {\n            logError(error instanceof Error ? error.message : String(error))\n          })\n      }\n    },\n  }\n) as HFChatGlobal\n\nif (typeof window !== 'undefined') {\n  // Expose a stable global singleton, without breaking when the real widget assigns window.HFChat\n  if (!window.HFChat) {\n    window.HFChat = HFChat\n  }\n}\n\nexport default HFChat\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Re-export public types for consumers\nexport type {\n  HFChatLogLevel,\n  HFChatConfig,\n  HFChatWidgetSettings,\n  HFChatIdentifyMeta,\n  HFChatOpenOptions,\n  HFChatAPI,\n} from './types'\n\nimport type { HFChatConfig, HFChatAPI, HFChatLogLevel } from './types'\n\n// Extended config for the JS SDK loader (adds scriptSrc option)\nexport type HFChatLoaderConfig = HFChatConfig & {\n  /** Override widget script source (for self-hosting / testing) */\n  scriptSrc?: string\n}\n\nexport type HFChatGlobal = HFChatAPI & {\n  /**\n   * Load the widget script and initialize the widget.\n   */\n  init(opts?: HFChatLoaderConfig): Promise<HFChatAPI>\n}\n\ntype QueuedCall = {\n  method: keyof HFChatAPI\n  args: unknown[]\n}\n\ndeclare global {\n  interface Window {\n    HFChat?: HFChatAPI\n    HumanFirstChat?: {\n      init: (opts: unknown) => HFChatAPI\n    }\n    __HFCHAT_DISABLE_AUTO_INIT?: boolean\n    __HFCHAT_QUEUE__?: QueuedCall[]\n    __HFCHAT_REAL__?: HFChatAPI\n  }\n}\n\nconst DEFAULT_SCRIPT_SRC = 'https://humanfirst.chat/widget.js'\nconst SCRIPT_DATA_ATTR = 'data-hfchat-widget'\n\n// Logging configuration\nlet logLevel: HFChatLogLevel = 'none'\n\nfunction log(message: string, ...args: unknown[]) {\n  if (logLevel === 'none') return\n  console.log(`[HFChat SDK] ${message}`, ...args)\n}\n\nfunction logFull(message: string, ...args: unknown[]) {\n  if (logLevel !== 'full') return\n  console.log(`[HFChat SDK] ${message}`, ...args)\n}\n\nfunction logError(message: string, ...args: unknown[]) {\n  if (logLevel === 'none') return\n  console.error(`[HFChat SDK] ${message}`, ...args)\n}\n\nlet loaderPromise: Promise<HFChatAPI> | null = null\nlet lastInitOpts: HFChatLoaderConfig | undefined\n\nfunction getQueue(): QueuedCall[] {\n  if (typeof window === 'undefined') return []\n  if (!window.__HFCHAT_QUEUE__) {\n    window.__HFCHAT_QUEUE__ = []\n  }\n  return window.__HFCHAT_QUEUE__\n}\n\nfunction enqueue(method: keyof HFChatAPI, args: unknown[]) {\n  if (typeof window === 'undefined') return\n  getQueue().push({ method, args })\n}\n\nfunction getRealApi(): HFChatAPI | null {\n  if (typeof window === 'undefined') return null\n\n  const globalReal = window.__HFCHAT_REAL__\n  if (globalReal && (globalReal as any).__HFCHAT_INSTANCE__ === true) {\n    return globalReal\n  }\n\n  const candidate = window.HFChat as any\n  if (candidate && candidate.__HFCHAT_INSTANCE__ === true) {\n    return candidate as HFChatAPI\n  }\n\n  if (candidate && candidate.__real && candidate.__real.__HFCHAT_INSTANCE__ === true) {\n    return candidate.__real as HFChatAPI\n  }\n\n  return null\n}\n\nfunction callOrQueue(method: keyof HFChatAPI, args: unknown[]) {\n  if (typeof window === 'undefined') return\n  const api = getRealApi()\n  const fn = api ? (api as any)[method] : null\n\n  if (api && typeof fn === 'function') {\n    logFull(`Calling '${String(method)}' on real API`)\n    fn.apply(api, args)\n    return\n  }\n\n  logFull(`Queueing '${String(method)}' until real API is ready`)\n  enqueue(method, args)\n}\n\nfunction injectScript(src: string): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (typeof document === 'undefined') return resolve()\n    if (window.HumanFirstChat) {\n      logFull('HumanFirstChat already exists, skipping script injection')\n      return resolve()\n    }\n\n    const existing = document.querySelector(\n      `script[${SCRIPT_DATA_ATTR}=\"1\"]`\n    ) as HTMLScriptElement | null\n    if (existing) {\n      logFull('Widget script already in DOM, waiting for load')\n      existing.addEventListener('load', () => resolve(), { once: true })\n      existing.addEventListener(\n        'error',\n        () => reject(new Error('Failed to load widget script')),\n        { once: true }\n      )\n      return\n    }\n\n    log('Injecting widget script:', src)\n    window.__HFCHAT_DISABLE_AUTO_INIT = true\n    const script = document.createElement('script')\n    script.async = true\n    script.src = src\n    script.setAttribute(SCRIPT_DATA_ATTR, '1')\n    script.setAttribute('data-auto-init', 'false')\n    script.onerror = () => {\n      logError('Failed to load widget script:', src)\n      reject(new Error(`Failed to load widget script: ${src}`))\n    }\n    script.onload = () => {\n      setTimeout(() => {\n        if (window.HumanFirstChat) {\n          log('Widget script loaded successfully')\n          resolve()\n        } else {\n          logError('Widget script loaded but HumanFirstChat not found')\n          reject(new Error('Widget did not attach to window.HumanFirstChat'))\n        }\n      }, 0)\n    }\n    document.head.appendChild(script)\n  })\n}\n\nasync function loadWidget(opts: HFChatLoaderConfig = {}): Promise<HFChatAPI> {\n  if (typeof window === 'undefined') return {} as HFChatAPI\n\n  const scriptSrc = opts.scriptSrc ?? DEFAULT_SCRIPT_SRC\n  logFull('loadWidget starting with options:', { siteId: opts.siteId, scriptSrc })\n\n  await injectScript(scriptSrc)\n\n  if (!window.HumanFirstChat?.init) {\n    throw new Error('HumanFirstChat.init is not available after script load')\n  }\n\n  log('Calling HumanFirstChat.init()')\n  const api = window.HumanFirstChat.init({\n    siteId: opts.siteId,\n    hidden: opts.hidden,\n    hideOnClose: opts.hideOnClose,\n    logs: opts.logs,\n    baseURL: opts.baseURL,\n    host: opts.host,\n  })\n\n  const realApi = getRealApi()\n  logFull('HumanFirstChat.init() returned:', { hasInstance: (realApi as any)?.__HFCHAT_INSTANCE__ })\n  return realApi ?? api\n}\n\nasync function init(opts: HFChatLoaderConfig = {}): Promise<HFChatAPI> {\n  if (opts.logs) {\n    logLevel = opts.logs\n  }\n\n  lastInitOpts = { ...lastInitOpts, ...opts }\n  log('init() called with options:', { siteId: opts.siteId, logs: opts.logs })\n\n  const existingApi = getRealApi()\n  if (existingApi) {\n    log('Returning existing real API')\n    return existingApi\n  }\n\n  if (loaderPromise) {\n    logFull('Returning existing loader promise')\n    return loaderPromise\n  }\n\n  log('Starting widget load...')\n  loaderPromise = loadWidget(lastInitOpts)\n  return loaderPromise\n}\n\nconst HFChat: HFChatGlobal & { __HFCHAT_STUB__?: true; __real?: HFChatAPI } = {\n  init,\n\n  show: () => callOrQueue('show', []),\n  hide: () => callOrQueue('hide', []),\n  open: (options) => callOrQueue('open', [options]),\n  close: () => callOrQueue('close', []),\n  toggle: () => callOrQueue('toggle', []),\n  isOpen: () => {\n    const api = getRealApi()\n    return api?.isOpen?.() ?? false\n  },\n  identify: (meta) => callOrQueue('identify', [meta]),\n  configure: (settings) => callOrQueue('configure', [settings]),\n  onReady: (callback) => {\n    if (typeof callback !== 'function') return\n    const api = getRealApi()\n    if (api?.ready) {\n      try {\n        callback()\n      } catch (error) {\n        console.error('[HFChat SDK] Error in onReady callback:', error)\n      }\n      return\n    }\n    callOrQueue('onReady', [callback])\n  },\n  onOpen: (callback) => {\n    if (typeof callback !== 'function') return\n    callOrQueue('onOpen', [callback])\n  },\n  onClose: (callback) => {\n    if (typeof callback !== 'function') return\n    callOrQueue('onClose', [callback])\n  },\n  get ready() {\n    const api = getRealApi()\n    return api?.ready ?? false\n  },\n}\n\nHFChat.__HFCHAT_STUB__ = true\n\nif (typeof window !== 'undefined') {\n  // Expose a stable global singleton, without breaking when the real widget assigns window.HFChat\n  if (!window.HFChat) {\n    window.HFChat = HFChat\n  }\n}\n\nexport { HFChat }\nexport default HFChat\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -16,14 +16,44 @@ function logError(message, ...args) {
 }
 var loaderPromise = null;
 var lastInitOpts;
-function getRealApi(selfProxy) {
+function getQueue() {
+  if (typeof window === "undefined") return [];
+  if (!window.__HFCHAT_QUEUE__) {
+    window.__HFCHAT_QUEUE__ = [];
+  }
+  return window.__HFCHAT_QUEUE__;
+}
+function enqueue(method, args) {
+  if (typeof window === "undefined") return;
+  getQueue().push({ method, args });
+}
+function getRealApi() {
   if (typeof window === "undefined") return null;
+  const globalReal = window.__HFCHAT_REAL__;
+  if (globalReal && globalReal.__HFCHAT_INSTANCE__ === true) {
+    return globalReal;
+  }
   const candidate = window.HFChat;
-  if (!candidate) return null;
-  if (candidate === selfProxy) return null;
-  if (candidate.__HFCHAT_INSTANCE__ === true) return candidate;
+  if (candidate && candidate.__HFCHAT_INSTANCE__ === true) {
+    return candidate;
+  }
+  if (candidate && candidate.__real && candidate.__real.__HFCHAT_INSTANCE__ === true) {
+    return candidate.__real;
+  }
   return null;
 }
+function callOrQueue(method, args) {
+  if (typeof window === "undefined") return;
+  const api = getRealApi();
+  const fn = api ? api[method] : null;
+  if (api && typeof fn === "function") {
+    logFull(`Calling '${String(method)}' on real API`);
+    fn.apply(api, args);
+    return;
+  }
+  logFull(`Queueing '${String(method)}' until real API is ready`);
+  enqueue(method, args);
+}
 function injectScript(src) {
   return new Promise((resolve, reject) => {
     if (typeof document === "undefined") return resolve();
@@ -86,8 +116,9 @@ async function loadWidget(opts = {}) {
     baseURL: opts.baseURL,
     host: opts.host
   });
-  logFull("HumanFirstChat.init() returned:", { hasInstance: api?.__HFCHAT_INSTANCE__ });
-  return api;
+  const realApi = getRealApi();
+  logFull("HumanFirstChat.init() returned:", { hasInstance: realApi?.__HFCHAT_INSTANCE__ });
+  return realApi ?? api;
 }
 async function init(opts = {}) {
   if (opts.logs) {
@@ -95,7 +126,7 @@ async function init(opts = {}) {
   }
   lastInitOpts = { ...lastInitOpts, ...opts };
   log("init() called with options:", { siteId: opts.siteId, logs: opts.logs });
-  const existingApi = getRealApi(HFChat);
+  const existingApi = getRealApi();
   if (existingApi) {
     log("Returning existing real API");
     return existingApi;
@@ -108,84 +139,46 @@ async function init(opts = {}) {
   loaderPromise = loadWidget(lastInitOpts);
   return loaderPromise;
 }
-async function waitForMethod(methodName) {
-  logFull(`waitForMethod('${methodName}') starting...`);
-  await init();
-  logFull(`init() completed, checking for '${methodName}'`);
-  const existing = getRealApi(HFChat);
-  logFull("getRealApi returned:", existing ? "real API found" : "null");
-  if (existing && typeof existing[methodName] === "function") {
-    log(`Method '${methodName}' available immediately`);
-    return existing;
-  }
-  logFull(`Polling for '${methodName}'...`);
-  return new Promise((resolve, reject) => {
-    let attempts = 0;
-    const maxAttempts = 50;
-    const checkMethod = () => {
-      const api = getRealApi(HFChat);
-      const fn = api ? api[methodName] : null;
-      if (attempts % 10 === 0 && attempts > 0) {
-        logFull(`Polling attempt ${attempts}/50 for '${methodName}':`, {
-          hasApi: !!api,
-          hasMethod: !!fn,
-          windowHFChat: typeof window.HFChat,
-          isProxy: window.HFChat === HFChat
-        });
+var HFChat = {
+  init,
+  show: () => callOrQueue("show", []),
+  hide: () => callOrQueue("hide", []),
+  open: (options) => callOrQueue("open", [options]),
+  close: () => callOrQueue("close", []),
+  toggle: () => callOrQueue("toggle", []),
+  isOpen: () => {
+    const api = getRealApi();
+    return api?.isOpen?.() ?? false;
+  },
+  identify: (meta) => callOrQueue("identify", [meta]),
+  configure: (settings) => callOrQueue("configure", [settings]),
+  onReady: (callback) => {
+    if (typeof callback !== "function") return;
+    const api = getRealApi();
+    if (api?.ready) {
+      try {
+        callback();
+      } catch (error) {
+        console.error("[HFChat SDK] Error in onReady callback:", error);
       }
-      if (api && typeof fn === "function") {
-        log(`Method '${methodName}' found after ${attempts} attempts`);
-        resolve(api);
-        return;
-      }
-      if (attempts < maxAttempts) {
-        attempts += 1;
-        setTimeout(checkMethod, 100);
-        return;
-      }
-      logError(`Timeout: '${methodName}' not available after 5 seconds`);
-      reject(new Error(`HFChat method '${methodName}' not available after 5 seconds`));
-    };
-    setTimeout(checkMethod, 100);
-  });
-}
-var HFChat = new Proxy(
-  {},
-  {
-    get(_target, prop) {
-      if (prop === "init") return init;
-      if (typeof window === "undefined") return () => {
-      };
-      if (prop === "__HFCHAT_INSTANCE__") return void 0;
-      if (prop === "then") return void 0;
-      if (prop === "ready") {
-        const api = getRealApi(HFChat);
-        return !!api?.ready;
-      }
-      if (prop === "isOpen") {
-        return () => {
-          const api = getRealApi(HFChat);
-          return api?.isOpen?.() ?? false;
-        };
-      }
-      return (...args) => {
-        const methodName = String(prop);
-        logFull(`Proxy: '${methodName}' called, forwarding to waitForMethod`);
-        waitForMethod(methodName).then((api) => {
-          const fn = api[methodName];
-          if (typeof fn === "function") {
-            logFull(`Proxy: executing '${methodName}' on real API`);
-            fn.apply(api, args);
-          } else {
-            logError(`Method '${methodName}' not found on real API`);
-          }
-        }).catch((error) => {
-          logError(error instanceof Error ? error.message : String(error));
-        });
-      };
+      return;
     }
+    callOrQueue("onReady", [callback]);
+  },
+  onOpen: (callback) => {
+    if (typeof callback !== "function") return;
+    callOrQueue("onOpen", [callback]);
+  },
+  onClose: (callback) => {
+    if (typeof callback !== "function") return;
+    callOrQueue("onClose", [callback]);
+  },
+  get ready() {
+    const api = getRealApi();
+    return api?.ready ?? false;
   }
-);
+};
+HFChat.__HFCHAT_STUB__ = true;
 if (typeof window !== "undefined") {
   if (!window.HFChat) {
     window.HFChat = HFChat;

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Re-export public types for consumers\nexport type {\n  HFChatLogLevel,\n  HFChatConfig,\n  HFChatWidgetSettings,\n  HFChatIdentifyMeta,\n  HFChatOpenOptions,\n  HFChatAPI,\n} from './types'\n\nimport type { HFChatConfig, HFChatAPI, HFChatLogLevel } from './types'\n\n// Extended config for the JS SDK loader (adds scriptSrc option)\nexport type HFChatLoaderConfig = HFChatConfig & {\n  /** Override widget script source (for self-hosting / testing) */\n  scriptSrc?: string\n}\n\nexport type HFChatGlobal = HFChatAPI & {\n  /**\n   * Load the widget script and initialize the widget.\n   */\n  init(opts?: HFChatLoaderConfig): Promise<HFChatAPI>\n}\n\ndeclare global {\n  interface Window {\n    HFChat?: HFChatAPI\n    HumanFirstChat?: {\n      init: (opts: unknown) => HFChatAPI\n    }\n    __HFCHAT_DISABLE_AUTO_INIT?: boolean\n  }\n}\n\nconst DEFAULT_SCRIPT_SRC = 'https://humanfirst.chat/widget.js'\nconst SCRIPT_DATA_ATTR = 'data-hfchat-widget'\n\n// Logging configuration\nlet logLevel: HFChatLogLevel = 'none'\n\nfunction log(message: string, ...args: unknown[]) {\n  if (logLevel === 'none') return\n  console.log(`[HFChat SDK] ${message}`, ...args)\n}\n\nfunction logFull(message: string, ...args: unknown[]) {\n  if (logLevel !== 'full') return\n  console.log(`[HFChat SDK] ${message}`, ...args)\n}\n\nfunction logError(message: string, ...args: unknown[]) {\n  if (logLevel === 'none') return\n  console.error(`[HFChat SDK] ${message}`, ...args)\n}\n\nlet loaderPromise: Promise<HFChatAPI> | null = null\nlet lastInitOpts: HFChatLoaderConfig | undefined\n\nfunction getRealApi(selfProxy: HFChatGlobal): HFChatAPI | null {\n  if (typeof window === 'undefined') return null\n  const candidate = window.HFChat\n  if (!candidate) return null\n  // Check if candidate is the proxy (same reference) - if so, real API not yet available\n  if (candidate === selfProxy) return null\n  // Check if candidate has the real instance marker\n  if ((candidate as any).__HFCHAT_INSTANCE__ === true) return candidate\n  return null\n}\n\nfunction injectScript(src: string): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (typeof document === 'undefined') return resolve()\n    if (window.HumanFirstChat) {\n      logFull('HumanFirstChat already exists, skipping script injection')\n      return resolve()\n    }\n\n    const existing = document.querySelector(\n      `script[${SCRIPT_DATA_ATTR}=\"1\"]`\n    ) as HTMLScriptElement | null\n    if (existing) {\n      logFull('Widget script already in DOM, waiting for load')\n      existing.addEventListener('load', () => resolve(), { once: true })\n      existing.addEventListener(\n        'error',\n        () => reject(new Error('Failed to load widget script')),\n        { once: true }\n      )\n      return\n    }\n\n    log('Injecting widget script:', src)\n    window.__HFCHAT_DISABLE_AUTO_INIT = true\n    const script = document.createElement('script')\n    script.async = true\n    script.src = src\n    script.setAttribute(SCRIPT_DATA_ATTR, '1')\n    script.setAttribute('data-auto-init', 'false')\n    script.onerror = () => {\n      logError('Failed to load widget script:', src)\n      reject(new Error(`Failed to load widget script: ${src}`))\n    }\n    script.onload = () => {\n      setTimeout(() => {\n        if (window.HumanFirstChat) {\n          log('Widget script loaded successfully')\n          resolve()\n        } else {\n          logError('Widget script loaded but HumanFirstChat not found')\n          reject(new Error('Widget did not attach to window.HumanFirstChat'))\n        }\n      }, 0)\n    }\n    document.head.appendChild(script)\n  })\n}\n\nasync function loadWidget(opts: HFChatLoaderConfig = {}): Promise<HFChatAPI> {\n  if (typeof window === 'undefined') return {} as HFChatAPI\n\n  const scriptSrc = opts.scriptSrc ?? DEFAULT_SCRIPT_SRC\n  logFull('loadWidget starting with options:', { siteId: opts.siteId, scriptSrc })\n\n  await injectScript(scriptSrc)\n\n  if (!window.HumanFirstChat?.init) {\n    throw new Error('HumanFirstChat.init is not available after script load')\n  }\n\n  log('Calling HumanFirstChat.init()')\n  const api = window.HumanFirstChat.init({\n    siteId: opts.siteId,\n    hidden: opts.hidden,\n    hideOnClose: opts.hideOnClose,\n    logs: opts.logs,\n    baseURL: opts.baseURL,\n    host: opts.host,\n  })\n\n  logFull('HumanFirstChat.init() returned:', { hasInstance: (api as any)?.__HFCHAT_INSTANCE__ })\n  return api\n}\n\nasync function init(opts: HFChatLoaderConfig = {}): Promise<HFChatAPI> {\n  // Update log level from options\n  if (opts.logs) {\n    logLevel = opts.logs\n  }\n\n  lastInitOpts = { ...lastInitOpts, ...opts }\n  log('init() called with options:', { siteId: opts.siteId, logs: opts.logs })\n\n  const existingApi = getRealApi(HFChat)\n  if (existingApi) {\n    log('Returning existing real API')\n    return existingApi\n  }\n\n  if (loaderPromise) {\n    logFull('Returning existing loader promise')\n    return loaderPromise\n  }\n\n  log('Starting widget load...')\n  loaderPromise = loadWidget(lastInitOpts)\n  return loaderPromise\n}\n\nasync function waitForMethod(methodName: string): Promise<HFChatAPI> {\n  logFull(`waitForMethod('${methodName}') starting...`)\n\n  // Ensure init is called (may already be in progress)\n  await init()\n  logFull(`init() completed, checking for '${methodName}'`)\n\n  // Check if real API is already available\n  const existing = getRealApi(HFChat)\n  logFull('getRealApi returned:', existing ? 'real API found' : 'null')\n\n  if (existing && typeof (existing as any)[methodName] === 'function') {\n    log(`Method '${methodName}' available immediately`)\n    return existing\n  }\n\n  // Poll for the real API to become available\n  logFull(`Polling for '${methodName}'...`)\n  return new Promise((resolve, reject) => {\n    let attempts = 0\n    const maxAttempts = 50 // 5 seconds total\n\n    const checkMethod = () => {\n      const api = getRealApi(HFChat)\n      const fn = api ? (api as any)[methodName] : null\n\n      // Log every 10 attempts (1 second)\n      if (attempts % 10 === 0 && attempts > 0) {\n        logFull(`Polling attempt ${attempts}/50 for '${methodName}':`, {\n          hasApi: !!api,\n          hasMethod: !!fn,\n          windowHFChat: typeof window.HFChat,\n          isProxy: window.HFChat === HFChat\n        })\n      }\n\n      if (api && typeof fn === 'function') {\n        log(`Method '${methodName}' found after ${attempts} attempts`)\n        resolve(api)\n        return\n      }\n\n      if (attempts < maxAttempts) {\n        attempts += 1\n        setTimeout(checkMethod, 100)\n        return\n      }\n\n      logError(`Timeout: '${methodName}' not available after 5 seconds`)\n      reject(new Error(`HFChat method '${methodName}' not available after 5 seconds`))\n    }\n\n    setTimeout(checkMethod, 100)\n  })\n}\n\nexport const HFChat: HFChatGlobal = new Proxy(\n  {},\n  {\n    get(_target, prop) {\n      // Handle init specially - it's the entry point\n      if (prop === 'init') return init\n\n      // Server-side rendering guard\n      if (typeof window === 'undefined') return () => {}\n\n      // Handle __HFCHAT_INSTANCE__ check - return undefined so proxy isn't mistaken for real instance\n      if (prop === '__HFCHAT_INSTANCE__') return undefined\n\n      // Handle 'then' - return undefined so proxy isn't treated as a thenable/Promise\n      // This is critical because await/Promise.resolve() check for .then()\n      if (prop === 'then') return undefined\n\n      // Handle ready property\n      if (prop === 'ready') {\n        const api = getRealApi(HFChat)\n        return !!api?.ready\n      }\n\n      // Handle isOpen method\n      if (prop === 'isOpen') {\n        return () => {\n          const api = getRealApi(HFChat)\n          return api?.isOpen?.() ?? false\n        }\n      }\n\n      // For all other methods, queue them until the real API is ready\n      return (...args: unknown[]) => {\n        const methodName = String(prop)\n        logFull(`Proxy: '${methodName}' called, forwarding to waitForMethod`)\n\n        waitForMethod(methodName)\n          .then((api) => {\n            const fn = (api as any)[methodName]\n            if (typeof fn === 'function') {\n              logFull(`Proxy: executing '${methodName}' on real API`)\n              fn.apply(api, args)\n            } else {\n              logError(`Method '${methodName}' not found on real API`)\n            }\n          })\n          .catch((error) => {\n            logError(error instanceof Error ? error.message : String(error))\n          })\n      }\n    },\n  }\n) as HFChatGlobal\n\nif (typeof window !== 'undefined') {\n  // Expose a stable global singleton, without breaking when the real widget assigns window.HFChat\n  if (!window.HFChat) {\n    window.HFChat = HFChat\n  }\n}\n\nexport default HFChat\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Re-export public types for consumers\nexport type {\n  HFChatLogLevel,\n  HFChatConfig,\n  HFChatWidgetSettings,\n  HFChatIdentifyMeta,\n  HFChatOpenOptions,\n  HFChatAPI,\n} from './types'\n\nimport type { HFChatConfig, HFChatAPI, HFChatLogLevel } from './types'\n\n// Extended config for the JS SDK loader (adds scriptSrc option)\nexport type HFChatLoaderConfig = HFChatConfig & {\n  /** Override widget script source (for self-hosting / testing) */\n  scriptSrc?: string\n}\n\nexport type HFChatGlobal = HFChatAPI & {\n  /**\n   * Load the widget script and initialize the widget.\n   */\n  init(opts?: HFChatLoaderConfig): Promise<HFChatAPI>\n}\n\ntype QueuedCall = {\n  method: keyof HFChatAPI\n  args: unknown[]\n}\n\ndeclare global {\n  interface Window {\n    HFChat?: HFChatAPI\n    HumanFirstChat?: {\n      init: (opts: unknown) => HFChatAPI\n    }\n    __HFCHAT_DISABLE_AUTO_INIT?: boolean\n    __HFCHAT_QUEUE__?: QueuedCall[]\n    __HFCHAT_REAL__?: HFChatAPI\n  }\n}\n\nconst DEFAULT_SCRIPT_SRC = 'https://humanfirst.chat/widget.js'\nconst SCRIPT_DATA_ATTR = 'data-hfchat-widget'\n\n// Logging configuration\nlet logLevel: HFChatLogLevel = 'none'\n\nfunction log(message: string, ...args: unknown[]) {\n  if (logLevel === 'none') return\n  console.log(`[HFChat SDK] ${message}`, ...args)\n}\n\nfunction logFull(message: string, ...args: unknown[]) {\n  if (logLevel !== 'full') return\n  console.log(`[HFChat SDK] ${message}`, ...args)\n}\n\nfunction logError(message: string, ...args: unknown[]) {\n  if (logLevel === 'none') return\n  console.error(`[HFChat SDK] ${message}`, ...args)\n}\n\nlet loaderPromise: Promise<HFChatAPI> | null = null\nlet lastInitOpts: HFChatLoaderConfig | undefined\n\nfunction getQueue(): QueuedCall[] {\n  if (typeof window === 'undefined') return []\n  if (!window.__HFCHAT_QUEUE__) {\n    window.__HFCHAT_QUEUE__ = []\n  }\n  return window.__HFCHAT_QUEUE__\n}\n\nfunction enqueue(method: keyof HFChatAPI, args: unknown[]) {\n  if (typeof window === 'undefined') return\n  getQueue().push({ method, args })\n}\n\nfunction getRealApi(): HFChatAPI | null {\n  if (typeof window === 'undefined') return null\n\n  const globalReal = window.__HFCHAT_REAL__\n  if (globalReal && (globalReal as any).__HFCHAT_INSTANCE__ === true) {\n    return globalReal\n  }\n\n  const candidate = window.HFChat as any\n  if (candidate && candidate.__HFCHAT_INSTANCE__ === true) {\n    return candidate as HFChatAPI\n  }\n\n  if (candidate && candidate.__real && candidate.__real.__HFCHAT_INSTANCE__ === true) {\n    return candidate.__real as HFChatAPI\n  }\n\n  return null\n}\n\nfunction callOrQueue(method: keyof HFChatAPI, args: unknown[]) {\n  if (typeof window === 'undefined') return\n  const api = getRealApi()\n  const fn = api ? (api as any)[method] : null\n\n  if (api && typeof fn === 'function') {\n    logFull(`Calling '${String(method)}' on real API`)\n    fn.apply(api, args)\n    return\n  }\n\n  logFull(`Queueing '${String(method)}' until real API is ready`)\n  enqueue(method, args)\n}\n\nfunction injectScript(src: string): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (typeof document === 'undefined') return resolve()\n    if (window.HumanFirstChat) {\n      logFull('HumanFirstChat already exists, skipping script injection')\n      return resolve()\n    }\n\n    const existing = document.querySelector(\n      `script[${SCRIPT_DATA_ATTR}=\"1\"]`\n    ) as HTMLScriptElement | null\n    if (existing) {\n      logFull('Widget script already in DOM, waiting for load')\n      existing.addEventListener('load', () => resolve(), { once: true })\n      existing.addEventListener(\n        'error',\n        () => reject(new Error('Failed to load widget script')),\n        { once: true }\n      )\n      return\n    }\n\n    log('Injecting widget script:', src)\n    window.__HFCHAT_DISABLE_AUTO_INIT = true\n    const script = document.createElement('script')\n    script.async = true\n    script.src = src\n    script.setAttribute(SCRIPT_DATA_ATTR, '1')\n    script.setAttribute('data-auto-init', 'false')\n    script.onerror = () => {\n      logError('Failed to load widget script:', src)\n      reject(new Error(`Failed to load widget script: ${src}`))\n    }\n    script.onload = () => {\n      setTimeout(() => {\n        if (window.HumanFirstChat) {\n          log('Widget script loaded successfully')\n          resolve()\n        } else {\n          logError('Widget script loaded but HumanFirstChat not found')\n          reject(new Error('Widget did not attach to window.HumanFirstChat'))\n        }\n      }, 0)\n    }\n    document.head.appendChild(script)\n  })\n}\n\nasync function loadWidget(opts: HFChatLoaderConfig = {}): Promise<HFChatAPI> {\n  if (typeof window === 'undefined') return {} as HFChatAPI\n\n  const scriptSrc = opts.scriptSrc ?? DEFAULT_SCRIPT_SRC\n  logFull('loadWidget starting with options:', { siteId: opts.siteId, scriptSrc })\n\n  await injectScript(scriptSrc)\n\n  if (!window.HumanFirstChat?.init) {\n    throw new Error('HumanFirstChat.init is not available after script load')\n  }\n\n  log('Calling HumanFirstChat.init()')\n  const api = window.HumanFirstChat.init({\n    siteId: opts.siteId,\n    hidden: opts.hidden,\n    hideOnClose: opts.hideOnClose,\n    logs: opts.logs,\n    baseURL: opts.baseURL,\n    host: opts.host,\n  })\n\n  const realApi = getRealApi()\n  logFull('HumanFirstChat.init() returned:', { hasInstance: (realApi as any)?.__HFCHAT_INSTANCE__ })\n  return realApi ?? api\n}\n\nasync function init(opts: HFChatLoaderConfig = {}): Promise<HFChatAPI> {\n  if (opts.logs) {\n    logLevel = opts.logs\n  }\n\n  lastInitOpts = { ...lastInitOpts, ...opts }\n  log('init() called with options:', { siteId: opts.siteId, logs: opts.logs })\n\n  const existingApi = getRealApi()\n  if (existingApi) {\n    log('Returning existing real API')\n    return existingApi\n  }\n\n  if (loaderPromise) {\n    logFull('Returning existing loader promise')\n    return loaderPromise\n  }\n\n  log('Starting widget load...')\n  loaderPromise = loadWidget(lastInitOpts)\n  return loaderPromise\n}\n\nconst HFChat: HFChatGlobal & { __HFCHAT_STUB__?: true; __real?: HFChatAPI } = {\n  init,\n\n  show: () => callOrQueue('show', []),\n  hide: () => callOrQueue('hide', []),\n  open: (options) => callOrQueue('open', [options]),\n  close: () => callOrQueue('close', []),\n  toggle: () => callOrQueue('toggle', []),\n  isOpen: () => {\n    const api = getRealApi()\n    return api?.isOpen?.() ?? false\n  },\n  identify: (meta) => callOrQueue('identify', [meta]),\n  configure: (settings) => callOrQueue('configure', [settings]),\n  onReady: (callback) => {\n    if (typeof callback !== 'function') return\n    const api = getRealApi()\n    if (api?.ready) {\n      try {\n        callback()\n      } catch (error) {\n        console.error('[HFChat SDK] Error in onReady callback:', error)\n      }\n      return\n    }\n    callOrQueue('onReady', [callback])\n  },\n  onOpen: (callback) => {\n    if (typeof callback !== 'function') return\n    callOrQueue('onOpen', [callback])\n  },\n  onClose: (callback) => {\n    if (typeof callback !== 'function') return\n    callOrQueue('onClose', [callback])\n  },\n  get ready() {\n    const api = getRealApi()\n    return api?.ready ?? false\n  },\n}\n\nHFChat.__HFCHAT_STUB__ = true\n\nif (typeof window !== 'undefined') {\n  // Expose a stable global singleton, without breaking when the real widget assigns window.HFChat\n  if (!window.HFChat) {\n    window.HFChat = HFChat\n  }\n}\n\nexport { HFChat }\nexport default HFChat\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,27 +1,27 @@
 {
-	"name": "@humanfirst-chat/js",
-"version": "0.1.6",
-	"private": false,
-	"description": "HumanFirst.chat JavaScript SDK",
-	"main": "./dist/index.js",
-	"module": "./dist/index.mjs",
-	"types": "./dist/index.d.ts",
-	"type": "commonjs",
-	"files": [
-		"dist",
-		"README.md"
-	],
-	"scripts": {
-		"build": "tsup",
-		"prepublishOnly": "pnpm build",
-		"type-check": "tsc --noEmit"
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"devDependencies": {
-		"@types/node": "^25.0.8",
-		"tsup": "^8.5.1",
-		"typescript": "^5.9.3"
-	}
+  "name": "@humanfirst-chat/js",
+  "version": "0.2.0",
+  "private": false,
+  "description": "HumanFirst.chat JavaScript SDK",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "type": "commonjs",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "pnpm build",
+    "type-check": "tsc --noEmit"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.8",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
 }