@encatch/web-sdk 1.2.0 → 1.2.1-beta.0

package/dist/encatch.es.js

@@ -1,2 +1,2 @@
-const e="encatch-sdk-script";let t=!1,n=!1,i=null;function r(r){return n?Promise.resolve():i?Promise.reject(i):t?new Promise((e,t)=>{const r=setInterval(()=>{n?(clearInterval(r),e()):i&&(clearInterval(r),t(i))},50)}):(t=!0,new Promise((o,a)=>{if(document.getElementById(e))return t=!1,n=!0,void o();const s=(r.webHost||"https://app.encatch.com")+"/s/sdk/v1/encatch.js?dt="+function(){const e=/* @__PURE__ */new Date,t=String(e.getUTCFullYear()).slice(-2),n=String(e.getUTCMonth()+1).padStart(2,"0"),i=String(e.getUTCDate()).padStart(2,"0"),r=String(e.getUTCHours()).padStart(2,"0"),o=30*Math.floor(e.getUTCMinutes()/30);return`${t}${n}${i}${r}${String(o).padStart(2,"0")}`}(),c=document.createElement("script");c.id=e,c.src=s,c.type="module",c.async=!0,c.onload=()=>{t=!1,n=!0,o()},c.onerror=e=>{t=!1,i=new Error(`[Encatch] Failed to load SDK from ${s}. Please check your network connection and web host configuration.`),console.error(i.message,e),a(i)};const d=document.getElementsByTagName("script")[0];d&&d.parentNode?d.parentNode.insertBefore(c,d):document.head.appendChild(c)}))}function o(e,t){return function(...n){e.push([t,...n])}}const a=["init","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","dismissForm","addToResponse","submitForm","emitEvent","clearAll","addSourceTracking"];function s(){const e=[],t=[],n={_q:e,_eventCallbacks:t,_initialized:!1,_apiKey:null,_config:{},init(t,i){n._initialized?console.warn("[Encatch] SDK already initialized. Ignoring init call."):(n._apiKey=t,n._config=i||{},n._initialized=!0,e.push(["init",t,i]),"undefined"!=typeof window&&"undefined"!=typeof document&&r(n._config).catch(e=>{console.error("[Encatch] Failed to initialize SDK:",e)}))},on:e=>(t.push(e),()=>{const n=t.indexOf(e);n>-1&&t.splice(n,1)}),identifyUser:()=>{},setLocale:()=>{},setCountry:()=>{},setTheme:()=>{},trackEvent:()=>{},trackScreen:()=>{},startSession:()=>{},resetUser:()=>{},showForm:()=>{},dismissForm:()=>{},addToResponse:()=>{},submitForm:()=>{},emitEvent:()=>{},refineText:()=>Promise.resolve({}),clearAll:()=>{},addSourceTracking:()=>{}},i=a.filter(e=>"init"!==e);for(const r of i)n[r]=o(e,r);return n}const c=function(){if("undefined"!=typeof window){const e=window._encatch;if(e&&Array.isArray(e._q)){const t=s();return t._q.push(...e._q),Array.isArray(e._eventCallbacks)&&t._eventCallbacks.push(...e._eventCallbacks),e._initialized&&(t._initialized=e._initialized,t._apiKey=e._apiKey,t._config=e._config||{}),window._encatch=t,t}const t=s();return window._encatch=t,t}return s()}();export{c as _encatch,c as default};
+const e="encatch-sdk-script";let t=!1,n=!1,i=null;function r(r){return n?Promise.resolve():i?Promise.reject(i):t?new Promise((e,t)=>{const r=setInterval(()=>{n?(clearInterval(r),e()):i&&(clearInterval(r),t(i))},50)}):(t=!0,new Promise((o,a)=>{if(document.getElementById(e))return t=!1,n=!0,void o();const s=(r.webHost||"https://app.encatch.com")+"/s/sdk/v1/encatch.js?dt="+function(){const e=/* @__PURE__ */new Date,t=String(e.getUTCFullYear()).slice(-2),n=String(e.getUTCMonth()+1).padStart(2,"0"),i=String(e.getUTCDate()).padStart(2,"0"),r=String(e.getUTCHours()).padStart(2,"0"),o=30*Math.floor(e.getUTCMinutes()/30);return`${t}${n}${i}${r}${String(o).padStart(2,"0")}`}(),c=document.createElement("script");c.id=e,c.src=s,c.type="module",c.async=!0,c.onload=()=>{t=!1,n=!0,o()},c.onerror=e=>{t=!1,i=new Error(`[Encatch] Failed to load SDK from ${s}. Please check your network connection and web host configuration.`),console.error(i.message,e),a(i)};const l=document.getElementsByTagName("script")[0];l&&l.parentNode?l.parentNode.insertBefore(c,l):document.head.appendChild(c)}))}function o(e,t){return function(...n){e.push([t,...n])}}const a=["init","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","dismissForm","addToResponse","submitForm","emitEvent","clearAll","addSourceTracking"];function s(){const e=[],t=[],n={_q:e,_eventCallbacks:t,_initialized:!1,_apiKey:null,_config:{},init(t,i){n._initialized?console.warn("[Encatch] SDK already initialized. Ignoring init call."):(n._apiKey=t,n._config=i||{},n._initialized=!0,e.push(["init",t,i]),"undefined"!=typeof window&&"undefined"!=typeof document&&r(n._config).catch(e=>{console.error("[Encatch] Failed to initialize SDK:",e)}))},on:e=>(t.push(e),()=>{const n=t.indexOf(e);n>-1&&t.splice(n,1)}),identifyUser:()=>{},setLocale:()=>{},setCountry:()=>{},setTheme:()=>{},trackEvent:()=>{},trackScreen:()=>{},startSession:()=>{},resetUser:()=>{},showForm:()=>{},dismissForm:()=>{},addToResponse:()=>{},submitForm:()=>{},emitEvent:()=>{},refineText:()=>Promise.resolve({}),qnaWithAi:()=>Promise.resolve({answer:""}),uploadFile:()=>Promise.reject(new Error("[Encatch] uploadFile is not available before SDK initialization")),clearAll:()=>{},addSourceTracking:()=>{}},i=a.filter(e=>"init"!==e);for(const r of i)n[r]=o(e,r);return n}const c=function(){if("undefined"!=typeof window){const e=window._encatch;if(e&&Array.isArray(e._q)){const t=s();return t._q.push(...e._q),Array.isArray(e._eventCallbacks)&&t._eventCallbacks.push(...e._eventCallbacks),e._initialized&&(t._initialized=e._initialized,t._apiKey=e._apiKey,t._config=e._config||{}),window._encatch=t,t}const t=s();return window._encatch=t,t}return s()}();export{c as _encatch,c as default};
 //# sourceMappingURL=encatch.es.js.map

package/dist/encatch.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"encatch.es.js","sources":["../src/loader.ts","../src/queue.ts","../src/index.ts"],"sourcesContent":["/**\n * Script Loader Utility\n * \n * Handles the dynamic loading of the remote SDK implementation script.\n * Provides error handling and prevents duplicate script injection.\n */\n\nimport type { EncatchConfig } from './types';\n\n/** Default web host for the remote implementation script */\nconst DEFAULT_WEB_HOST = 'https://app.encatch.com';\n\n/** Fixed path for the SDK script */\nconst SDK_SCRIPT_PATH = '/s/sdk/v1/encatch.js';\n\n/** Script element ID to prevent duplicate injections */\nconst SCRIPT_ID = 'encatch-sdk-script';\n\n/**\n * Returns a cache-bust string that changes at most every 30 minutes (YYMMDDHHmm, mm is 00 or 30).\n * Allows the script to be cached for up to 30 minutes before a new URL triggers a fresh fetch.\n */\nfunction getCacheBustParam(): string {\n  const d = new Date();\n  const yy = String(d.getUTCFullYear()).slice(-2);\n  const mm = String(d.getUTCMonth() + 1).padStart(2, '0');\n  const dd = String(d.getUTCDate()).padStart(2, '0');\n  const hh = String(d.getUTCHours()).padStart(2, '0');\n  const min30 = Math.floor(d.getUTCMinutes() / 30) * 30;\n  const minStr = String(min30).padStart(2, '0');\n  return `${yy}${mm}${dd}${hh}${minStr}`;\n}\n\n/** Track loading state */\nlet isLoading = false;\nlet isLoaded = false;\nlet loadError: Error | null = null;\n\n/**\n * Load the remote SDK implementation script\n * \n * @param config - Configuration containing optional custom web host\n * @returns Promise that resolves when script loads, rejects on error\n */\nexport function loadRemoteScript(config: EncatchConfig): Promise<void> {\n  // Return early if already loaded\n  if (isLoaded) {\n    return Promise.resolve();\n  }\n\n  // Return error if previous load failed\n  if (loadError) {\n    return Promise.reject(loadError);\n  }\n\n  // Return existing promise if already loading\n  if (isLoading) {\n    return new Promise((resolve, reject) => {\n      const checkInterval = setInterval(() => {\n        if (isLoaded) {\n          clearInterval(checkInterval);\n          resolve();\n        } else if (loadError) {\n          clearInterval(checkInterval);\n          reject(loadError);\n        }\n      }, 50);\n    });\n  }\n\n  isLoading = true;\n\n  return new Promise((resolve, reject) => {\n    // Check if script already exists in DOM\n    const existingScript = document.getElementById(SCRIPT_ID);\n    if (existingScript) {\n      isLoading = false;\n      isLoaded = true;\n      resolve();\n      return;\n    }\n\n    // Determine script URL from webHost (with 30-min cache-bust so script is cached at most 30 min)\n    const webHost = config.webHost || DEFAULT_WEB_HOST;\n    const scriptUrl = webHost + SDK_SCRIPT_PATH + '?dt=' + getCacheBustParam();\n\n    // Create and configure script element\n    const script = document.createElement('script');\n    script.id = SCRIPT_ID;\n    script.src = scriptUrl;\n    script.type = 'module';\n    script.async = true;\n\n    // Handle successful load\n    script.onload = () => {\n      isLoading = false;\n      isLoaded = true;\n      resolve();\n    };\n\n    // Handle load error\n    script.onerror = (event) => {\n      isLoading = false;\n      loadError = new Error(\n        `[Encatch] Failed to load SDK from ${scriptUrl}. ` +\n        `Please check your network connection and web host configuration.`\n      );\n      console.error(loadError.message, event);\n      reject(loadError);\n    };\n\n    // Inject script into document head\n    const firstScript = document.getElementsByTagName('script')[0];\n    if (firstScript && firstScript.parentNode) {\n      firstScript.parentNode.insertBefore(script, firstScript);\n    } else {\n      document.head.appendChild(script);\n    }\n  });\n}\n\n/**\n * Check if the remote script has been loaded\n */\nexport function isScriptLoaded(): boolean {\n  return isLoaded;\n}\n\n/**\n * Reset loader state (useful for testing)\n */\nexport function resetLoaderState(): void {\n  isLoading = false;\n  isLoaded = false;\n  loadError = null;\n}\n\n/**\n * Get the default script URL (includes current 30-min cache-bust param)\n */\nexport function getDefaultScriptUrl(): string {\n  return DEFAULT_WEB_HOST + SDK_SCRIPT_PATH + '?dt=' + getCacheBustParam();\n}\n","/**\n * Command Queue Implementation\n * \n * Manages the queue of SDK method calls that occur before the remote\n * implementation script has loaded. Commands are stored as tuples\n * and processed FIFO when the remote script becomes available.\n */\n\nimport type { Command, EncatchSDK } from './types';\n\n/**\n * Process all queued commands by calling the corresponding methods\n * on the SDK instance. This is called by the remote script once loaded.\n * \n * @param sdk - The SDK instance with real implementations\n * @param queue - Array of queued commands to process\n */\nexport function processQueue(sdk: EncatchSDK, queue: Command[]): void {\n  while (queue.length > 0) {\n    const command = queue.shift();\n    if (!command) continue;\n\n    const [method, ...args] = command;\n    \n    // Skip internal properties\n    if (method.startsWith('_')) continue;\n\n    // Get the method from the SDK\n    const fn = sdk[method as keyof EncatchSDK];\n    \n    if (typeof fn === 'function') {\n      try {\n        (fn as (...args: unknown[]) => void).apply(sdk, args);\n      } catch (error) {\n        console.error(`[Encatch] Error processing queued command \"${method}\":`, error);\n      }\n    } else {\n      console.warn(`[Encatch] Unknown method in queue: \"${method}\"`);\n    }\n  }\n}\n\n/**\n * Creates a stub method that queues calls for later processing\n * \n * @param queue - The command queue array\n * @param methodName - Name of the method being stubbed\n * @returns A function that pushes calls to the queue\n */\nexport function createQueuedMethod(\n  queue: Command[],\n  methodName: string\n): (...args: unknown[]) => void {\n  return function (...args: unknown[]): void {\n    queue.push([methodName, ...args]);\n  };\n}\n\n/**\n * List of SDK methods that should be queued before initialization\n */\nexport const QUEUED_METHODS = [\n  'init',\n  'identifyUser',\n  'setLocale',\n  'setCountry',\n  'setTheme',\n  'trackEvent',\n  'trackScreen',\n  'startSession',\n  'resetUser',\n  'showForm',\n  'dismissForm',\n  'addToResponse',\n  'submitForm',\n  'emitEvent',\n  'clearAll',\n  'addSourceTracking',\n] as const;\n\nexport type QueuedMethodName = typeof QUEUED_METHODS[number];\n","/**\n * Encatch Web SDK\n * \n * A lightweight, type-safe SDK for integrating Encatch forms and surveys.\n * This module creates the _encatch global object that queues commands\n * until the remote implementation script loads.\n */\n\nimport type {\n  EncatchSDK,\n  EncatchConfig,\n  UserTraits,\n  IdentifyOptions,\n  EventCallback,\n  Command,\n} from './types';\nimport { loadRemoteScript } from './loader';\nimport { createQueuedMethod, QUEUED_METHODS } from './queue';\n\n// Re-export types for consumers\nexport type {\n  EncatchSDK,\n  EncatchConfig,\n  UserTraits,\n  IdentifyOptions,\n  StartSessionOptions,\n  EventType,\n  EventCallback,\n  EventPayload,\n  Theme,\n  ResetMode,\n  ShowFormOptions,\n  ShowFormInterceptorPayload,\n  SubmitFormRequest,\n  FormDetails,\n  QuestionResponse,\n  QuestionAnswer,\n  RefineTextRequest,\n  RefineTextResponse,\n} from './types';\n\n/**\n * Creates the Encatch SDK stub instance\n * All method calls are queued until setProject() is called and the\n * remote implementation script loads.\n */\nfunction createEncatchStub(): EncatchSDK {\n  // Command queue for calls made before remote script loads\n  const queue: Command[] = [];\n  \n  // Event callbacks - all callbacks receive all form events\n  const eventCallbacks: EventCallback[] = [];\n\n  // Create the SDK object\n  const sdk: EncatchSDK = {\n    // Internal state\n    _q: queue,\n    _eventCallbacks: eventCallbacks,\n    _initialized: false,\n    _apiKey: null,\n    _config: {},\n\n    // init is special - it triggers script loading\n    init(apiKey: string, config?: EncatchConfig): void {\n      if (sdk._initialized) {\n        console.warn('[Encatch] SDK already initialized. Ignoring init call.');\n        return;\n      }\n\n      sdk._apiKey = apiKey;\n      sdk._config = config || {};\n      sdk._initialized = true;\n\n      // Queue this call for the remote implementation\n      queue.push(['init', apiKey, config]);\n\n      // Load the remote script\n      if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n        loadRemoteScript(sdk._config).catch((error) => {\n          console.error('[Encatch] Failed to initialize SDK:', error);\n        });\n      }\n    },\n\n    // Event subscription - receives all form events\n    on(callback: EventCallback): () => void {\n      eventCallbacks.push(callback);\n\n      // Return unsubscribe function\n      return () => {\n        const index = eventCallbacks.indexOf(callback);\n        if (index > -1) {\n          eventCallbacks.splice(index, 1);\n        }\n      };\n    },\n\n    // Stub implementations - will be replaced by remote script\n    identifyUser: () => {},\n    setLocale: () => {},\n    setCountry: () => {},\n    setTheme: () => {},\n    trackEvent: () => {},\n    trackScreen: () => {},\n    startSession: () => {},\n    resetUser: () => {},\n    showForm: () => {},\n    dismissForm: () => {},\n    addToResponse: () => {},\n    submitForm: () => {},\n    emitEvent: () => {},\n    refineText: () => Promise.resolve({}),\n    clearAll: () => {},\n    addSourceTracking: () => {},\n  };\n\n  // Replace stub methods with queue-based versions\n  // Skip init (handled specially above) and on (handled locally)\n  const methodsToQueue = QUEUED_METHODS.filter(m => m !== 'init');\n  \n  for (const method of methodsToQueue) {\n    // Use type assertion to assign queued methods\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (sdk as any)[method] = createQueuedMethod(queue, method);\n  }\n\n  return sdk;\n}\n\n/**\n * Initialize the global _encatch object\n * This runs immediately when the script loads\n */\nfunction initGlobal(): EncatchSDK {\n  // Check for existing instance (may have been created by snippet)\n  if (typeof window !== 'undefined') {\n    // If _encatch already exists with a queue, preserve it\n    const existing = window._encatch;\n    if (existing && Array.isArray(existing._q)) {\n      // Merge existing queue into new instance\n      const sdk = createEncatchStub();\n      sdk._q.push(...existing._q);\n      \n      // Copy over any existing callbacks\n      if (Array.isArray(existing._eventCallbacks)) {\n        sdk._eventCallbacks.push(...existing._eventCallbacks);\n      }\n      \n      // Copy initialization state\n      if (existing._initialized) {\n        sdk._initialized = existing._initialized;\n        sdk._apiKey = existing._apiKey;\n        sdk._config = existing._config || {};\n      }\n      \n      window._encatch = sdk;\n      return sdk;\n    }\n\n    // Create fresh instance\n    const sdk = createEncatchStub();\n    window._encatch = sdk;\n    return sdk;\n  }\n\n  // Non-browser environment\n  return createEncatchStub();\n}\n\n// Initialize and export\nexport const _encatch = initGlobal();\n\n// Default export for convenience\nexport default _encatch;\n"],"names":["SCRIPT_ID","isLoading","isLoaded","loadError","loadRemoteScript","config","Promise","resolve","reject","checkInterval","setInterval","clearInterval","document","getElementById","scriptUrl","webHost","d","Date","yy","String","getUTCFullYear","slice","mm","getUTCMonth","padStart","dd","getUTCDate","hh","getUTCHours","min30","Math","floor","getUTCMinutes","getCacheBustParam","script","createElement","id","src","type","async","onload","onerror","event","Error","console","error","message","firstScript","getElementsByTagName","parentNode","insertBefore","head","appendChild","createQueuedMethod","queue","methodName","args","push","QUEUED_METHODS","createEncatchStub","eventCallbacks","sdk","_q","_eventCallbacks","_initialized","_apiKey","_config","init","apiKey","warn","window","catch","on","callback","index","indexOf","splice","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","dismissForm","addToResponse","submitForm","emitEvent","refineText","clearAll","addSourceTracking","methodsToQueue","filter","m","method","_encatch","existing","Array","isArray","initGlobal"],"mappings":"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"}
+{"version":3,"file":"encatch.es.js","sources":["../src/loader.ts","../src/queue.ts","../src/index.ts"],"sourcesContent":["/**\n * Script Loader Utility\n * \n * Handles the dynamic loading of the remote SDK implementation script.\n * Provides error handling and prevents duplicate script injection.\n */\n\nimport type { EncatchConfig } from './types';\n\n/** Default web host for the remote implementation script */\nconst DEFAULT_WEB_HOST = 'https://app.encatch.com';\n\n/** Fixed path for the SDK script */\nconst SDK_SCRIPT_PATH = '/s/sdk/v1/encatch.js';\n\n/** Script element ID to prevent duplicate injections */\nconst SCRIPT_ID = 'encatch-sdk-script';\n\n/**\n * Returns a cache-bust string that changes at most every 30 minutes (YYMMDDHHmm, mm is 00 or 30).\n * Allows the script to be cached for up to 30 minutes before a new URL triggers a fresh fetch.\n */\nfunction getCacheBustParam(): string {\n  const d = new Date();\n  const yy = String(d.getUTCFullYear()).slice(-2);\n  const mm = String(d.getUTCMonth() + 1).padStart(2, '0');\n  const dd = String(d.getUTCDate()).padStart(2, '0');\n  const hh = String(d.getUTCHours()).padStart(2, '0');\n  const min30 = Math.floor(d.getUTCMinutes() / 30) * 30;\n  const minStr = String(min30).padStart(2, '0');\n  return `${yy}${mm}${dd}${hh}${minStr}`;\n}\n\n/** Track loading state */\nlet isLoading = false;\nlet isLoaded = false;\nlet loadError: Error | null = null;\n\n/**\n * Load the remote SDK implementation script\n * \n * @param config - Configuration containing optional custom web host\n * @returns Promise that resolves when script loads, rejects on error\n */\nexport function loadRemoteScript(config: EncatchConfig): Promise<void> {\n  // Return early if already loaded\n  if (isLoaded) {\n    return Promise.resolve();\n  }\n\n  // Return error if previous load failed\n  if (loadError) {\n    return Promise.reject(loadError);\n  }\n\n  // Return existing promise if already loading\n  if (isLoading) {\n    return new Promise((resolve, reject) => {\n      const checkInterval = setInterval(() => {\n        if (isLoaded) {\n          clearInterval(checkInterval);\n          resolve();\n        } else if (loadError) {\n          clearInterval(checkInterval);\n          reject(loadError);\n        }\n      }, 50);\n    });\n  }\n\n  isLoading = true;\n\n  return new Promise((resolve, reject) => {\n    // Check if script already exists in DOM\n    const existingScript = document.getElementById(SCRIPT_ID);\n    if (existingScript) {\n      isLoading = false;\n      isLoaded = true;\n      resolve();\n      return;\n    }\n\n    // Determine script URL from webHost (with 30-min cache-bust so script is cached at most 30 min)\n    const webHost = config.webHost || DEFAULT_WEB_HOST;\n    const scriptUrl = webHost + SDK_SCRIPT_PATH + '?dt=' + getCacheBustParam();\n\n    // Create and configure script element\n    const script = document.createElement('script');\n    script.id = SCRIPT_ID;\n    script.src = scriptUrl;\n    script.type = 'module';\n    script.async = true;\n\n    // Handle successful load\n    script.onload = () => {\n      isLoading = false;\n      isLoaded = true;\n      resolve();\n    };\n\n    // Handle load error\n    script.onerror = (event) => {\n      isLoading = false;\n      loadError = new Error(\n        `[Encatch] Failed to load SDK from ${scriptUrl}. ` +\n        `Please check your network connection and web host configuration.`\n      );\n      console.error(loadError.message, event);\n      reject(loadError);\n    };\n\n    // Inject script into document head\n    const firstScript = document.getElementsByTagName('script')[0];\n    if (firstScript && firstScript.parentNode) {\n      firstScript.parentNode.insertBefore(script, firstScript);\n    } else {\n      document.head.appendChild(script);\n    }\n  });\n}\n\n/**\n * Check if the remote script has been loaded\n */\nexport function isScriptLoaded(): boolean {\n  return isLoaded;\n}\n\n/**\n * Reset loader state (useful for testing)\n */\nexport function resetLoaderState(): void {\n  isLoading = false;\n  isLoaded = false;\n  loadError = null;\n}\n\n/**\n * Get the default script URL (includes current 30-min cache-bust param)\n */\nexport function getDefaultScriptUrl(): string {\n  return DEFAULT_WEB_HOST + SDK_SCRIPT_PATH + '?dt=' + getCacheBustParam();\n}\n","/**\n * Command Queue Implementation\n * \n * Manages the queue of SDK method calls that occur before the remote\n * implementation script has loaded. Commands are stored as tuples\n * and processed FIFO when the remote script becomes available.\n */\n\nimport type { Command, EncatchSDK } from './types';\n\n/**\n * Process all queued commands by calling the corresponding methods\n * on the SDK instance. This is called by the remote script once loaded.\n * \n * @param sdk - The SDK instance with real implementations\n * @param queue - Array of queued commands to process\n */\nexport function processQueue(sdk: EncatchSDK, queue: Command[]): void {\n  while (queue.length > 0) {\n    const command = queue.shift();\n    if (!command) continue;\n\n    const [method, ...args] = command;\n    \n    // Skip internal properties\n    if (method.startsWith('_')) continue;\n\n    // Get the method from the SDK\n    const fn = sdk[method as keyof EncatchSDK];\n    \n    if (typeof fn === 'function') {\n      try {\n        (fn as (...args: unknown[]) => void).apply(sdk, args);\n      } catch (error) {\n        console.error(`[Encatch] Error processing queued command \"${method}\":`, error);\n      }\n    } else {\n      console.warn(`[Encatch] Unknown method in queue: \"${method}\"`);\n    }\n  }\n}\n\n/**\n * Creates a stub method that queues calls for later processing\n * \n * @param queue - The command queue array\n * @param methodName - Name of the method being stubbed\n * @returns A function that pushes calls to the queue\n */\nexport function createQueuedMethod(\n  queue: Command[],\n  methodName: string\n): (...args: unknown[]) => void {\n  return function (...args: unknown[]): void {\n    queue.push([methodName, ...args]);\n  };\n}\n\n/**\n * List of SDK methods that should be queued before initialization\n */\nexport const QUEUED_METHODS = [\n  'init',\n  'identifyUser',\n  'setLocale',\n  'setCountry',\n  'setTheme',\n  'trackEvent',\n  'trackScreen',\n  'startSession',\n  'resetUser',\n  'showForm',\n  'dismissForm',\n  'addToResponse',\n  'submitForm',\n  'emitEvent',\n  'clearAll',\n  'addSourceTracking',\n] as const;\n\nexport type QueuedMethodName = typeof QUEUED_METHODS[number];\n","/**\n * Encatch Web SDK\n * \n * A lightweight, type-safe SDK for integrating Encatch forms and surveys.\n * This module creates the _encatch global object that queues commands\n * until the remote implementation script loads.\n */\n\nimport type {\n  EncatchSDK,\n  EncatchConfig,\n  UserTraits,\n  IdentifyOptions,\n  EventCallback,\n  Command,\n} from './types';\nimport { loadRemoteScript } from './loader';\nimport { createQueuedMethod, QUEUED_METHODS } from './queue';\n\n// Re-export types for consumers\nexport type {\n  EncatchSDK,\n  EncatchConfig,\n  UserTraits,\n  IdentifyOptions,\n  StartSessionOptions,\n  EventType,\n  EventCallback,\n  EventPayload,\n  Theme,\n  ResetMode,\n  ShowFormOptions,\n  ShowFormInterceptorPayload,\n  SubmitFormRequest,\n  FormDetails,\n  QuestionResponse,\n  QuestionAnswer,\n  RefineTextRequest,\n  RefineTextResponse,\n  QnaWithAiConversationTurn,\n  QnaWithAiRequest,\n  QnaWithAiResponse,\n  UploadFileRequest,\n  UploadFileResponse,\n} from './types';\n\n/**\n * Creates the Encatch SDK stub instance\n * All method calls are queued until setProject() is called and the\n * remote implementation script loads.\n */\nfunction createEncatchStub(): EncatchSDK {\n  // Command queue for calls made before remote script loads\n  const queue: Command[] = [];\n  \n  // Event callbacks - all callbacks receive all form events\n  const eventCallbacks: EventCallback[] = [];\n\n  // Create the SDK object\n  const sdk: EncatchSDK = {\n    // Internal state\n    _q: queue,\n    _eventCallbacks: eventCallbacks,\n    _initialized: false,\n    _apiKey: null,\n    _config: {},\n\n    // init is special - it triggers script loading\n    init(apiKey: string, config?: EncatchConfig): void {\n      if (sdk._initialized) {\n        console.warn('[Encatch] SDK already initialized. Ignoring init call.');\n        return;\n      }\n\n      sdk._apiKey = apiKey;\n      sdk._config = config || {};\n      sdk._initialized = true;\n\n      // Queue this call for the remote implementation\n      queue.push(['init', apiKey, config]);\n\n      // Load the remote script\n      if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n        loadRemoteScript(sdk._config).catch((error) => {\n          console.error('[Encatch] Failed to initialize SDK:', error);\n        });\n      }\n    },\n\n    // Event subscription - receives all form events\n    on(callback: EventCallback): () => void {\n      eventCallbacks.push(callback);\n\n      // Return unsubscribe function\n      return () => {\n        const index = eventCallbacks.indexOf(callback);\n        if (index > -1) {\n          eventCallbacks.splice(index, 1);\n        }\n      };\n    },\n\n    // Stub implementations - will be replaced by remote script\n    identifyUser: () => {},\n    setLocale: () => {},\n    setCountry: () => {},\n    setTheme: () => {},\n    trackEvent: () => {},\n    trackScreen: () => {},\n    startSession: () => {},\n    resetUser: () => {},\n    showForm: () => {},\n    dismissForm: () => {},\n    addToResponse: () => {},\n    submitForm: () => {},\n    emitEvent: () => {},\n    refineText: () => Promise.resolve({}),\n    qnaWithAi: () => Promise.resolve({ answer: '' }),\n    uploadFile: () => Promise.reject(new Error('[Encatch] uploadFile is not available before SDK initialization')),\n    clearAll: () => {},\n    addSourceTracking: () => {},\n  };\n\n  // Replace stub methods with queue-based versions\n  // Skip init (handled specially above) and on (handled locally)\n  const methodsToQueue = QUEUED_METHODS.filter(m => m !== 'init');\n  \n  for (const method of methodsToQueue) {\n    // Use type assertion to assign queued methods\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (sdk as any)[method] = createQueuedMethod(queue, method);\n  }\n\n  return sdk;\n}\n\n/**\n * Initialize the global _encatch object\n * This runs immediately when the script loads\n */\nfunction initGlobal(): EncatchSDK {\n  // Check for existing instance (may have been created by snippet)\n  if (typeof window !== 'undefined') {\n    // If _encatch already exists with a queue, preserve it\n    const existing = window._encatch;\n    if (existing && Array.isArray(existing._q)) {\n      // Merge existing queue into new instance\n      const sdk = createEncatchStub();\n      sdk._q.push(...existing._q);\n      \n      // Copy over any existing callbacks\n      if (Array.isArray(existing._eventCallbacks)) {\n        sdk._eventCallbacks.push(...existing._eventCallbacks);\n      }\n      \n      // Copy initialization state\n      if (existing._initialized) {\n        sdk._initialized = existing._initialized;\n        sdk._apiKey = existing._apiKey;\n        sdk._config = existing._config || {};\n      }\n      \n      window._encatch = sdk;\n      return sdk;\n    }\n\n    // Create fresh instance\n    const sdk = createEncatchStub();\n    window._encatch = sdk;\n    return sdk;\n  }\n\n  // Non-browser environment\n  return createEncatchStub();\n}\n\n// Initialize and export\nexport const _encatch = initGlobal();\n\n// Default export for convenience\nexport default _encatch;\n"],"names":["SCRIPT_ID","isLoading","isLoaded","loadError","loadRemoteScript","config","Promise","resolve","reject","checkInterval","setInterval","clearInterval","document","getElementById","scriptUrl","webHost","d","Date","yy","String","getUTCFullYear","slice","mm","getUTCMonth","padStart","dd","getUTCDate","hh","getUTCHours","min30","Math","floor","getUTCMinutes","getCacheBustParam","script","createElement","id","src","type","async","onload","onerror","event","Error","console","error","message","firstScript","getElementsByTagName","parentNode","insertBefore","head","appendChild","createQueuedMethod","queue","methodName","args","push","QUEUED_METHODS","createEncatchStub","eventCallbacks","sdk","_q","_eventCallbacks","_initialized","_apiKey","_config","init","apiKey","warn","window","catch","on","callback","index","indexOf","splice","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","dismissForm","addToResponse","submitForm","emitEvent","refineText","qnaWithAi","answer","uploadFile","clearAll","addSourceTracking","methodsToQueue","filter","m","method","_encatch","existing","Array","isArray","initGlobal"],"mappings":"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"}

package/dist/encatch.iife.js

@@ -1,2 +1,2 @@
-!function(e){"use strict";const t="encatch-sdk-script";let n=!1,i=!1,r=null;function o(e){return i?Promise.resolve():r?Promise.reject(r):n?new Promise((e,t)=>{const n=setInterval(()=>{i?(clearInterval(n),e()):r&&(clearInterval(n),t(r))},50)}):(n=!0,new Promise((o,c)=>{if(document.getElementById(t))return n=!1,i=!0,void o();const a=(e.webHost||"https://app.encatch.com")+"/s/sdk/v1/encatch.js?dt="+function(){const e=new Date,t=String(e.getUTCFullYear()).slice(-2),n=String(e.getUTCMonth()+1).padStart(2,"0"),i=String(e.getUTCDate()).padStart(2,"0"),r=String(e.getUTCHours()).padStart(2,"0"),o=30*Math.floor(e.getUTCMinutes()/30);return`${t}${n}${i}${r}${String(o).padStart(2,"0")}`}(),s=document.createElement("script");s.id=t,s.src=a,s.type="module",s.async=!0,s.onload=()=>{n=!1,i=!0,o()},s.onerror=e=>{n=!1,r=new Error(`[Encatch] Failed to load SDK from ${a}. Please check your network connection and web host configuration.`),console.error(r.message,e),c(r)};const l=document.getElementsByTagName("script")[0];l&&l.parentNode?l.parentNode.insertBefore(s,l):document.head.appendChild(s)}))}function c(e,t){return function(...n){e.push([t,...n])}}const a=["init","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","dismissForm","addToResponse","submitForm","emitEvent","clearAll","addSourceTracking"];function s(){const e=[],t=[],n={_q:e,_eventCallbacks:t,_initialized:!1,_apiKey:null,_config:{},init(t,i){n._initialized?console.warn("[Encatch] SDK already initialized. Ignoring init call."):(n._apiKey=t,n._config=i||{},n._initialized=!0,e.push(["init",t,i]),"undefined"!=typeof window&&"undefined"!=typeof document&&o(n._config).catch(e=>{console.error("[Encatch] Failed to initialize SDK:",e)}))},on:e=>(t.push(e),()=>{const n=t.indexOf(e);n>-1&&t.splice(n,1)}),identifyUser:()=>{},setLocale:()=>{},setCountry:()=>{},setTheme:()=>{},trackEvent:()=>{},trackScreen:()=>{},startSession:()=>{},resetUser:()=>{},showForm:()=>{},dismissForm:()=>{},addToResponse:()=>{},submitForm:()=>{},emitEvent:()=>{},refineText:()=>Promise.resolve({}),clearAll:()=>{},addSourceTracking:()=>{}},i=a.filter(e=>"init"!==e);for(const r of i)n[r]=c(e,r);return n}const l=function(){if("undefined"!=typeof window){const e=window._encatch;if(e&&Array.isArray(e._q)){const t=s();return t._q.push(...e._q),Array.isArray(e._eventCallbacks)&&t._eventCallbacks.push(...e._eventCallbacks),e._initialized&&(t._initialized=e._initialized,t._apiKey=e._apiKey,t._config=e._config||{}),window._encatch=t,t}const t=s();return window._encatch=t,t}return s()}();e._encatch=l,e.default=l,Object.defineProperties(e,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})}(this._encatch=this._encatch||{});
+!function(e){"use strict";const t="encatch-sdk-script";let n=!1,i=!1,r=null;function o(e){return i?Promise.resolve():r?Promise.reject(r):n?new Promise((e,t)=>{const n=setInterval(()=>{i?(clearInterval(n),e()):r&&(clearInterval(n),t(r))},50)}):(n=!0,new Promise((o,a)=>{if(document.getElementById(t))return n=!1,i=!0,void o();const c=(e.webHost||"https://app.encatch.com")+"/s/sdk/v1/encatch.js?dt="+function(){const e=new Date,t=String(e.getUTCFullYear()).slice(-2),n=String(e.getUTCMonth()+1).padStart(2,"0"),i=String(e.getUTCDate()).padStart(2,"0"),r=String(e.getUTCHours()).padStart(2,"0"),o=30*Math.floor(e.getUTCMinutes()/30);return`${t}${n}${i}${r}${String(o).padStart(2,"0")}`}(),s=document.createElement("script");s.id=t,s.src=c,s.type="module",s.async=!0,s.onload=()=>{n=!1,i=!0,o()},s.onerror=e=>{n=!1,r=new Error(`[Encatch] Failed to load SDK from ${c}. Please check your network connection and web host configuration.`),console.error(r.message,e),a(r)};const l=document.getElementsByTagName("script")[0];l&&l.parentNode?l.parentNode.insertBefore(s,l):document.head.appendChild(s)}))}function a(e,t){return function(...n){e.push([t,...n])}}const c=["init","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","dismissForm","addToResponse","submitForm","emitEvent","clearAll","addSourceTracking"];function s(){const e=[],t=[],n={_q:e,_eventCallbacks:t,_initialized:!1,_apiKey:null,_config:{},init(t,i){n._initialized?console.warn("[Encatch] SDK already initialized. Ignoring init call."):(n._apiKey=t,n._config=i||{},n._initialized=!0,e.push(["init",t,i]),"undefined"!=typeof window&&"undefined"!=typeof document&&o(n._config).catch(e=>{console.error("[Encatch] Failed to initialize SDK:",e)}))},on:e=>(t.push(e),()=>{const n=t.indexOf(e);n>-1&&t.splice(n,1)}),identifyUser:()=>{},setLocale:()=>{},setCountry:()=>{},setTheme:()=>{},trackEvent:()=>{},trackScreen:()=>{},startSession:()=>{},resetUser:()=>{},showForm:()=>{},dismissForm:()=>{},addToResponse:()=>{},submitForm:()=>{},emitEvent:()=>{},refineText:()=>Promise.resolve({}),qnaWithAi:()=>Promise.resolve({answer:""}),uploadFile:()=>Promise.reject(new Error("[Encatch] uploadFile is not available before SDK initialization")),clearAll:()=>{},addSourceTracking:()=>{}},i=c.filter(e=>"init"!==e);for(const r of i)n[r]=a(e,r);return n}const l=function(){if("undefined"!=typeof window){const e=window._encatch;if(e&&Array.isArray(e._q)){const t=s();return t._q.push(...e._q),Array.isArray(e._eventCallbacks)&&t._eventCallbacks.push(...e._eventCallbacks),e._initialized&&(t._initialized=e._initialized,t._apiKey=e._apiKey,t._config=e._config||{}),window._encatch=t,t}const t=s();return window._encatch=t,t}return s()}();e._encatch=l,e.default=l,Object.defineProperties(e,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})}(this._encatch=this._encatch||{});
 //# sourceMappingURL=encatch.iife.js.map

package/dist/encatch.iife.js.map

@@ -1 +1 @@
-{"version":3,"file":"encatch.iife.js","sources":["../src/loader.ts","../src/queue.ts","../src/index.ts"],"sourcesContent":["/**\n * Script Loader Utility\n * \n * Handles the dynamic loading of the remote SDK implementation script.\n * Provides error handling and prevents duplicate script injection.\n */\n\nimport type { EncatchConfig } from './types';\n\n/** Default web host for the remote implementation script */\nconst DEFAULT_WEB_HOST = 'https://app.encatch.com';\n\n/** Fixed path for the SDK script */\nconst SDK_SCRIPT_PATH = '/s/sdk/v1/encatch.js';\n\n/** Script element ID to prevent duplicate injections */\nconst SCRIPT_ID = 'encatch-sdk-script';\n\n/**\n * Returns a cache-bust string that changes at most every 30 minutes (YYMMDDHHmm, mm is 00 or 30).\n * Allows the script to be cached for up to 30 minutes before a new URL triggers a fresh fetch.\n */\nfunction getCacheBustParam(): string {\n  const d = new Date();\n  const yy = String(d.getUTCFullYear()).slice(-2);\n  const mm = String(d.getUTCMonth() + 1).padStart(2, '0');\n  const dd = String(d.getUTCDate()).padStart(2, '0');\n  const hh = String(d.getUTCHours()).padStart(2, '0');\n  const min30 = Math.floor(d.getUTCMinutes() / 30) * 30;\n  const minStr = String(min30).padStart(2, '0');\n  return `${yy}${mm}${dd}${hh}${minStr}`;\n}\n\n/** Track loading state */\nlet isLoading = false;\nlet isLoaded = false;\nlet loadError: Error | null = null;\n\n/**\n * Load the remote SDK implementation script\n * \n * @param config - Configuration containing optional custom web host\n * @returns Promise that resolves when script loads, rejects on error\n */\nexport function loadRemoteScript(config: EncatchConfig): Promise<void> {\n  // Return early if already loaded\n  if (isLoaded) {\n    return Promise.resolve();\n  }\n\n  // Return error if previous load failed\n  if (loadError) {\n    return Promise.reject(loadError);\n  }\n\n  // Return existing promise if already loading\n  if (isLoading) {\n    return new Promise((resolve, reject) => {\n      const checkInterval = setInterval(() => {\n        if (isLoaded) {\n          clearInterval(checkInterval);\n          resolve();\n        } else if (loadError) {\n          clearInterval(checkInterval);\n          reject(loadError);\n        }\n      }, 50);\n    });\n  }\n\n  isLoading = true;\n\n  return new Promise((resolve, reject) => {\n    // Check if script already exists in DOM\n    const existingScript = document.getElementById(SCRIPT_ID);\n    if (existingScript) {\n      isLoading = false;\n      isLoaded = true;\n      resolve();\n      return;\n    }\n\n    // Determine script URL from webHost (with 30-min cache-bust so script is cached at most 30 min)\n    const webHost = config.webHost || DEFAULT_WEB_HOST;\n    const scriptUrl = webHost + SDK_SCRIPT_PATH + '?dt=' + getCacheBustParam();\n\n    // Create and configure script element\n    const script = document.createElement('script');\n    script.id = SCRIPT_ID;\n    script.src = scriptUrl;\n    script.type = 'module';\n    script.async = true;\n\n    // Handle successful load\n    script.onload = () => {\n      isLoading = false;\n      isLoaded = true;\n      resolve();\n    };\n\n    // Handle load error\n    script.onerror = (event) => {\n      isLoading = false;\n      loadError = new Error(\n        `[Encatch] Failed to load SDK from ${scriptUrl}. ` +\n        `Please check your network connection and web host configuration.`\n      );\n      console.error(loadError.message, event);\n      reject(loadError);\n    };\n\n    // Inject script into document head\n    const firstScript = document.getElementsByTagName('script')[0];\n    if (firstScript && firstScript.parentNode) {\n      firstScript.parentNode.insertBefore(script, firstScript);\n    } else {\n      document.head.appendChild(script);\n    }\n  });\n}\n\n/**\n * Check if the remote script has been loaded\n */\nexport function isScriptLoaded(): boolean {\n  return isLoaded;\n}\n\n/**\n * Reset loader state (useful for testing)\n */\nexport function resetLoaderState(): void {\n  isLoading = false;\n  isLoaded = false;\n  loadError = null;\n}\n\n/**\n * Get the default script URL (includes current 30-min cache-bust param)\n */\nexport function getDefaultScriptUrl(): string {\n  return DEFAULT_WEB_HOST + SDK_SCRIPT_PATH + '?dt=' + getCacheBustParam();\n}\n","/**\n * Command Queue Implementation\n * \n * Manages the queue of SDK method calls that occur before the remote\n * implementation script has loaded. Commands are stored as tuples\n * and processed FIFO when the remote script becomes available.\n */\n\nimport type { Command, EncatchSDK } from './types';\n\n/**\n * Process all queued commands by calling the corresponding methods\n * on the SDK instance. This is called by the remote script once loaded.\n * \n * @param sdk - The SDK instance with real implementations\n * @param queue - Array of queued commands to process\n */\nexport function processQueue(sdk: EncatchSDK, queue: Command[]): void {\n  while (queue.length > 0) {\n    const command = queue.shift();\n    if (!command) continue;\n\n    const [method, ...args] = command;\n    \n    // Skip internal properties\n    if (method.startsWith('_')) continue;\n\n    // Get the method from the SDK\n    const fn = sdk[method as keyof EncatchSDK];\n    \n    if (typeof fn === 'function') {\n      try {\n        (fn as (...args: unknown[]) => void).apply(sdk, args);\n      } catch (error) {\n        console.error(`[Encatch] Error processing queued command \"${method}\":`, error);\n      }\n    } else {\n      console.warn(`[Encatch] Unknown method in queue: \"${method}\"`);\n    }\n  }\n}\n\n/**\n * Creates a stub method that queues calls for later processing\n * \n * @param queue - The command queue array\n * @param methodName - Name of the method being stubbed\n * @returns A function that pushes calls to the queue\n */\nexport function createQueuedMethod(\n  queue: Command[],\n  methodName: string\n): (...args: unknown[]) => void {\n  return function (...args: unknown[]): void {\n    queue.push([methodName, ...args]);\n  };\n}\n\n/**\n * List of SDK methods that should be queued before initialization\n */\nexport const QUEUED_METHODS = [\n  'init',\n  'identifyUser',\n  'setLocale',\n  'setCountry',\n  'setTheme',\n  'trackEvent',\n  'trackScreen',\n  'startSession',\n  'resetUser',\n  'showForm',\n  'dismissForm',\n  'addToResponse',\n  'submitForm',\n  'emitEvent',\n  'clearAll',\n  'addSourceTracking',\n] as const;\n\nexport type QueuedMethodName = typeof QUEUED_METHODS[number];\n","/**\n * Encatch Web SDK\n * \n * A lightweight, type-safe SDK for integrating Encatch forms and surveys.\n * This module creates the _encatch global object that queues commands\n * until the remote implementation script loads.\n */\n\nimport type {\n  EncatchSDK,\n  EncatchConfig,\n  UserTraits,\n  IdentifyOptions,\n  EventCallback,\n  Command,\n} from './types';\nimport { loadRemoteScript } from './loader';\nimport { createQueuedMethod, QUEUED_METHODS } from './queue';\n\n// Re-export types for consumers\nexport type {\n  EncatchSDK,\n  EncatchConfig,\n  UserTraits,\n  IdentifyOptions,\n  StartSessionOptions,\n  EventType,\n  EventCallback,\n  EventPayload,\n  Theme,\n  ResetMode,\n  ShowFormOptions,\n  ShowFormInterceptorPayload,\n  SubmitFormRequest,\n  FormDetails,\n  QuestionResponse,\n  QuestionAnswer,\n  RefineTextRequest,\n  RefineTextResponse,\n} from './types';\n\n/**\n * Creates the Encatch SDK stub instance\n * All method calls are queued until setProject() is called and the\n * remote implementation script loads.\n */\nfunction createEncatchStub(): EncatchSDK {\n  // Command queue for calls made before remote script loads\n  const queue: Command[] = [];\n  \n  // Event callbacks - all callbacks receive all form events\n  const eventCallbacks: EventCallback[] = [];\n\n  // Create the SDK object\n  const sdk: EncatchSDK = {\n    // Internal state\n    _q: queue,\n    _eventCallbacks: eventCallbacks,\n    _initialized: false,\n    _apiKey: null,\n    _config: {},\n\n    // init is special - it triggers script loading\n    init(apiKey: string, config?: EncatchConfig): void {\n      if (sdk._initialized) {\n        console.warn('[Encatch] SDK already initialized. Ignoring init call.');\n        return;\n      }\n\n      sdk._apiKey = apiKey;\n      sdk._config = config || {};\n      sdk._initialized = true;\n\n      // Queue this call for the remote implementation\n      queue.push(['init', apiKey, config]);\n\n      // Load the remote script\n      if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n        loadRemoteScript(sdk._config).catch((error) => {\n          console.error('[Encatch] Failed to initialize SDK:', error);\n        });\n      }\n    },\n\n    // Event subscription - receives all form events\n    on(callback: EventCallback): () => void {\n      eventCallbacks.push(callback);\n\n      // Return unsubscribe function\n      return () => {\n        const index = eventCallbacks.indexOf(callback);\n        if (index > -1) {\n          eventCallbacks.splice(index, 1);\n        }\n      };\n    },\n\n    // Stub implementations - will be replaced by remote script\n    identifyUser: () => {},\n    setLocale: () => {},\n    setCountry: () => {},\n    setTheme: () => {},\n    trackEvent: () => {},\n    trackScreen: () => {},\n    startSession: () => {},\n    resetUser: () => {},\n    showForm: () => {},\n    dismissForm: () => {},\n    addToResponse: () => {},\n    submitForm: () => {},\n    emitEvent: () => {},\n    refineText: () => Promise.resolve({}),\n    clearAll: () => {},\n    addSourceTracking: () => {},\n  };\n\n  // Replace stub methods with queue-based versions\n  // Skip init (handled specially above) and on (handled locally)\n  const methodsToQueue = QUEUED_METHODS.filter(m => m !== 'init');\n  \n  for (const method of methodsToQueue) {\n    // Use type assertion to assign queued methods\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (sdk as any)[method] = createQueuedMethod(queue, method);\n  }\n\n  return sdk;\n}\n\n/**\n * Initialize the global _encatch object\n * This runs immediately when the script loads\n */\nfunction initGlobal(): EncatchSDK {\n  // Check for existing instance (may have been created by snippet)\n  if (typeof window !== 'undefined') {\n    // If _encatch already exists with a queue, preserve it\n    const existing = window._encatch;\n    if (existing && Array.isArray(existing._q)) {\n      // Merge existing queue into new instance\n      const sdk = createEncatchStub();\n      sdk._q.push(...existing._q);\n      \n      // Copy over any existing callbacks\n      if (Array.isArray(existing._eventCallbacks)) {\n        sdk._eventCallbacks.push(...existing._eventCallbacks);\n      }\n      \n      // Copy initialization state\n      if (existing._initialized) {\n        sdk._initialized = existing._initialized;\n        sdk._apiKey = existing._apiKey;\n        sdk._config = existing._config || {};\n      }\n      \n      window._encatch = sdk;\n      return sdk;\n    }\n\n    // Create fresh instance\n    const sdk = createEncatchStub();\n    window._encatch = sdk;\n    return sdk;\n  }\n\n  // Non-browser environment\n  return createEncatchStub();\n}\n\n// Initialize and export\nexport const _encatch = initGlobal();\n\n// Default export for convenience\nexport default _encatch;\n"],"names":["SCRIPT_ID","isLoading","isLoaded","loadError","loadRemoteScript","config","Promise","resolve","reject","checkInterval","setInterval","clearInterval","document","getElementById","scriptUrl","webHost","d","Date","yy","String","getUTCFullYear","slice","mm","getUTCMonth","padStart","dd","getUTCDate","hh","getUTCHours","min30","Math","floor","getUTCMinutes","getCacheBustParam","script","createElement","id","src","type","async","onload","onerror","event","Error","console","error","message","firstScript","getElementsByTagName","parentNode","insertBefore","head","appendChild","createQueuedMethod","queue","methodName","args","push","QUEUED_METHODS","createEncatchStub","eventCallbacks","sdk","_q","_eventCallbacks","_initialized","_apiKey","_config","init","apiKey","warn","window","catch","on","callback","index","indexOf","splice","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","dismissForm","addToResponse","submitForm","emitEvent","refineText","clearAll","addSourceTracking","methodsToQueue","filter","m","method","_encatch","existing","Array","isArray","initGlobal"],"mappings":"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"}
+{"version":3,"file":"encatch.iife.js","sources":["../src/loader.ts","../src/queue.ts","../src/index.ts"],"sourcesContent":["/**\n * Script Loader Utility\n * \n * Handles the dynamic loading of the remote SDK implementation script.\n * Provides error handling and prevents duplicate script injection.\n */\n\nimport type { EncatchConfig } from './types';\n\n/** Default web host for the remote implementation script */\nconst DEFAULT_WEB_HOST = 'https://app.encatch.com';\n\n/** Fixed path for the SDK script */\nconst SDK_SCRIPT_PATH = '/s/sdk/v1/encatch.js';\n\n/** Script element ID to prevent duplicate injections */\nconst SCRIPT_ID = 'encatch-sdk-script';\n\n/**\n * Returns a cache-bust string that changes at most every 30 minutes (YYMMDDHHmm, mm is 00 or 30).\n * Allows the script to be cached for up to 30 minutes before a new URL triggers a fresh fetch.\n */\nfunction getCacheBustParam(): string {\n  const d = new Date();\n  const yy = String(d.getUTCFullYear()).slice(-2);\n  const mm = String(d.getUTCMonth() + 1).padStart(2, '0');\n  const dd = String(d.getUTCDate()).padStart(2, '0');\n  const hh = String(d.getUTCHours()).padStart(2, '0');\n  const min30 = Math.floor(d.getUTCMinutes() / 30) * 30;\n  const minStr = String(min30).padStart(2, '0');\n  return `${yy}${mm}${dd}${hh}${minStr}`;\n}\n\n/** Track loading state */\nlet isLoading = false;\nlet isLoaded = false;\nlet loadError: Error | null = null;\n\n/**\n * Load the remote SDK implementation script\n * \n * @param config - Configuration containing optional custom web host\n * @returns Promise that resolves when script loads, rejects on error\n */\nexport function loadRemoteScript(config: EncatchConfig): Promise<void> {\n  // Return early if already loaded\n  if (isLoaded) {\n    return Promise.resolve();\n  }\n\n  // Return error if previous load failed\n  if (loadError) {\n    return Promise.reject(loadError);\n  }\n\n  // Return existing promise if already loading\n  if (isLoading) {\n    return new Promise((resolve, reject) => {\n      const checkInterval = setInterval(() => {\n        if (isLoaded) {\n          clearInterval(checkInterval);\n          resolve();\n        } else if (loadError) {\n          clearInterval(checkInterval);\n          reject(loadError);\n        }\n      }, 50);\n    });\n  }\n\n  isLoading = true;\n\n  return new Promise((resolve, reject) => {\n    // Check if script already exists in DOM\n    const existingScript = document.getElementById(SCRIPT_ID);\n    if (existingScript) {\n      isLoading = false;\n      isLoaded = true;\n      resolve();\n      return;\n    }\n\n    // Determine script URL from webHost (with 30-min cache-bust so script is cached at most 30 min)\n    const webHost = config.webHost || DEFAULT_WEB_HOST;\n    const scriptUrl = webHost + SDK_SCRIPT_PATH + '?dt=' + getCacheBustParam();\n\n    // Create and configure script element\n    const script = document.createElement('script');\n    script.id = SCRIPT_ID;\n    script.src = scriptUrl;\n    script.type = 'module';\n    script.async = true;\n\n    // Handle successful load\n    script.onload = () => {\n      isLoading = false;\n      isLoaded = true;\n      resolve();\n    };\n\n    // Handle load error\n    script.onerror = (event) => {\n      isLoading = false;\n      loadError = new Error(\n        `[Encatch] Failed to load SDK from ${scriptUrl}. ` +\n        `Please check your network connection and web host configuration.`\n      );\n      console.error(loadError.message, event);\n      reject(loadError);\n    };\n\n    // Inject script into document head\n    const firstScript = document.getElementsByTagName('script')[0];\n    if (firstScript && firstScript.parentNode) {\n      firstScript.parentNode.insertBefore(script, firstScript);\n    } else {\n      document.head.appendChild(script);\n    }\n  });\n}\n\n/**\n * Check if the remote script has been loaded\n */\nexport function isScriptLoaded(): boolean {\n  return isLoaded;\n}\n\n/**\n * Reset loader state (useful for testing)\n */\nexport function resetLoaderState(): void {\n  isLoading = false;\n  isLoaded = false;\n  loadError = null;\n}\n\n/**\n * Get the default script URL (includes current 30-min cache-bust param)\n */\nexport function getDefaultScriptUrl(): string {\n  return DEFAULT_WEB_HOST + SDK_SCRIPT_PATH + '?dt=' + getCacheBustParam();\n}\n","/**\n * Command Queue Implementation\n * \n * Manages the queue of SDK method calls that occur before the remote\n * implementation script has loaded. Commands are stored as tuples\n * and processed FIFO when the remote script becomes available.\n */\n\nimport type { Command, EncatchSDK } from './types';\n\n/**\n * Process all queued commands by calling the corresponding methods\n * on the SDK instance. This is called by the remote script once loaded.\n * \n * @param sdk - The SDK instance with real implementations\n * @param queue - Array of queued commands to process\n */\nexport function processQueue(sdk: EncatchSDK, queue: Command[]): void {\n  while (queue.length > 0) {\n    const command = queue.shift();\n    if (!command) continue;\n\n    const [method, ...args] = command;\n    \n    // Skip internal properties\n    if (method.startsWith('_')) continue;\n\n    // Get the method from the SDK\n    const fn = sdk[method as keyof EncatchSDK];\n    \n    if (typeof fn === 'function') {\n      try {\n        (fn as (...args: unknown[]) => void).apply(sdk, args);\n      } catch (error) {\n        console.error(`[Encatch] Error processing queued command \"${method}\":`, error);\n      }\n    } else {\n      console.warn(`[Encatch] Unknown method in queue: \"${method}\"`);\n    }\n  }\n}\n\n/**\n * Creates a stub method that queues calls for later processing\n * \n * @param queue - The command queue array\n * @param methodName - Name of the method being stubbed\n * @returns A function that pushes calls to the queue\n */\nexport function createQueuedMethod(\n  queue: Command[],\n  methodName: string\n): (...args: unknown[]) => void {\n  return function (...args: unknown[]): void {\n    queue.push([methodName, ...args]);\n  };\n}\n\n/**\n * List of SDK methods that should be queued before initialization\n */\nexport const QUEUED_METHODS = [\n  'init',\n  'identifyUser',\n  'setLocale',\n  'setCountry',\n  'setTheme',\n  'trackEvent',\n  'trackScreen',\n  'startSession',\n  'resetUser',\n  'showForm',\n  'dismissForm',\n  'addToResponse',\n  'submitForm',\n  'emitEvent',\n  'clearAll',\n  'addSourceTracking',\n] as const;\n\nexport type QueuedMethodName = typeof QUEUED_METHODS[number];\n","/**\n * Encatch Web SDK\n * \n * A lightweight, type-safe SDK for integrating Encatch forms and surveys.\n * This module creates the _encatch global object that queues commands\n * until the remote implementation script loads.\n */\n\nimport type {\n  EncatchSDK,\n  EncatchConfig,\n  UserTraits,\n  IdentifyOptions,\n  EventCallback,\n  Command,\n} from './types';\nimport { loadRemoteScript } from './loader';\nimport { createQueuedMethod, QUEUED_METHODS } from './queue';\n\n// Re-export types for consumers\nexport type {\n  EncatchSDK,\n  EncatchConfig,\n  UserTraits,\n  IdentifyOptions,\n  StartSessionOptions,\n  EventType,\n  EventCallback,\n  EventPayload,\n  Theme,\n  ResetMode,\n  ShowFormOptions,\n  ShowFormInterceptorPayload,\n  SubmitFormRequest,\n  FormDetails,\n  QuestionResponse,\n  QuestionAnswer,\n  RefineTextRequest,\n  RefineTextResponse,\n  QnaWithAiConversationTurn,\n  QnaWithAiRequest,\n  QnaWithAiResponse,\n  UploadFileRequest,\n  UploadFileResponse,\n} from './types';\n\n/**\n * Creates the Encatch SDK stub instance\n * All method calls are queued until setProject() is called and the\n * remote implementation script loads.\n */\nfunction createEncatchStub(): EncatchSDK {\n  // Command queue for calls made before remote script loads\n  const queue: Command[] = [];\n  \n  // Event callbacks - all callbacks receive all form events\n  const eventCallbacks: EventCallback[] = [];\n\n  // Create the SDK object\n  const sdk: EncatchSDK = {\n    // Internal state\n    _q: queue,\n    _eventCallbacks: eventCallbacks,\n    _initialized: false,\n    _apiKey: null,\n    _config: {},\n\n    // init is special - it triggers script loading\n    init(apiKey: string, config?: EncatchConfig): void {\n      if (sdk._initialized) {\n        console.warn('[Encatch] SDK already initialized. Ignoring init call.');\n        return;\n      }\n\n      sdk._apiKey = apiKey;\n      sdk._config = config || {};\n      sdk._initialized = true;\n\n      // Queue this call for the remote implementation\n      queue.push(['init', apiKey, config]);\n\n      // Load the remote script\n      if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n        loadRemoteScript(sdk._config).catch((error) => {\n          console.error('[Encatch] Failed to initialize SDK:', error);\n        });\n      }\n    },\n\n    // Event subscription - receives all form events\n    on(callback: EventCallback): () => void {\n      eventCallbacks.push(callback);\n\n      // Return unsubscribe function\n      return () => {\n        const index = eventCallbacks.indexOf(callback);\n        if (index > -1) {\n          eventCallbacks.splice(index, 1);\n        }\n      };\n    },\n\n    // Stub implementations - will be replaced by remote script\n    identifyUser: () => {},\n    setLocale: () => {},\n    setCountry: () => {},\n    setTheme: () => {},\n    trackEvent: () => {},\n    trackScreen: () => {},\n    startSession: () => {},\n    resetUser: () => {},\n    showForm: () => {},\n    dismissForm: () => {},\n    addToResponse: () => {},\n    submitForm: () => {},\n    emitEvent: () => {},\n    refineText: () => Promise.resolve({}),\n    qnaWithAi: () => Promise.resolve({ answer: '' }),\n    uploadFile: () => Promise.reject(new Error('[Encatch] uploadFile is not available before SDK initialization')),\n    clearAll: () => {},\n    addSourceTracking: () => {},\n  };\n\n  // Replace stub methods with queue-based versions\n  // Skip init (handled specially above) and on (handled locally)\n  const methodsToQueue = QUEUED_METHODS.filter(m => m !== 'init');\n  \n  for (const method of methodsToQueue) {\n    // Use type assertion to assign queued methods\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (sdk as any)[method] = createQueuedMethod(queue, method);\n  }\n\n  return sdk;\n}\n\n/**\n * Initialize the global _encatch object\n * This runs immediately when the script loads\n */\nfunction initGlobal(): EncatchSDK {\n  // Check for existing instance (may have been created by snippet)\n  if (typeof window !== 'undefined') {\n    // If _encatch already exists with a queue, preserve it\n    const existing = window._encatch;\n    if (existing && Array.isArray(existing._q)) {\n      // Merge existing queue into new instance\n      const sdk = createEncatchStub();\n      sdk._q.push(...existing._q);\n      \n      // Copy over any existing callbacks\n      if (Array.isArray(existing._eventCallbacks)) {\n        sdk._eventCallbacks.push(...existing._eventCallbacks);\n      }\n      \n      // Copy initialization state\n      if (existing._initialized) {\n        sdk._initialized = existing._initialized;\n        sdk._apiKey = existing._apiKey;\n        sdk._config = existing._config || {};\n      }\n      \n      window._encatch = sdk;\n      return sdk;\n    }\n\n    // Create fresh instance\n    const sdk = createEncatchStub();\n    window._encatch = sdk;\n    return sdk;\n  }\n\n  // Non-browser environment\n  return createEncatchStub();\n}\n\n// Initialize and export\nexport const _encatch = initGlobal();\n\n// Default export for convenience\nexport default _encatch;\n"],"names":["SCRIPT_ID","isLoading","isLoaded","loadError","loadRemoteScript","config","Promise","resolve","reject","checkInterval","setInterval","clearInterval","document","getElementById","scriptUrl","webHost","d","Date","yy","String","getUTCFullYear","slice","mm","getUTCMonth","padStart","dd","getUTCDate","hh","getUTCHours","min30","Math","floor","getUTCMinutes","getCacheBustParam","script","createElement","id","src","type","async","onload","onerror","event","Error","console","error","message","firstScript","getElementsByTagName","parentNode","insertBefore","head","appendChild","createQueuedMethod","queue","methodName","args","push","QUEUED_METHODS","createEncatchStub","eventCallbacks","sdk","_q","_eventCallbacks","_initialized","_apiKey","_config","init","apiKey","warn","window","catch","on","callback","index","indexOf","splice","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","dismissForm","addToResponse","submitForm","emitEvent","refineText","qnaWithAi","answer","uploadFile","clearAll","addSourceTracking","methodsToQueue","filter","m","method","_encatch","existing","Array","isArray","initGlobal"],"mappings":"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"}

package/dist/index.d.ts

@@ -132,6 +132,23 @@ export declare interface EncatchSDK {
      * @returns Promise resolving to the refined text response
      */
     refineText(params: RefineTextRequest): Promise<RefineTextResponse>;
+    /**
+     * Call the Q&A with AI endpoint for a qna_with_ai question.
+     * Sends the full conversation history (including the current unanswered turn) and
+     * returns the AI-generated answer.
+     * @param params - feedbackConfigurationId, questionId, and full conversation array
+     * @returns Promise resolving to { answer: string }
+     */
+    qnaWithAi(params: QnaWithAiRequest): Promise<QnaWithAiResponse>;
+    /**
+     * Upload a file to the Encatch file storage.
+     * Use this when onBeforeShowForm returns false and your custom UI contains a
+     * file, image, signature, or media question — call uploadFile for each selected
+     * file and store the returned fileUrl in your answer payload.
+     * @param params - feedbackConfigurationId, questionId, file, optional fileName and onProgress
+     * @returns Promise resolving to { fileUrl: string }
+     */
+    uploadFile(params: UploadFileRequest): Promise<UploadFileResponse>;
     /**
      * Subscribe to all form events
      * The callback receives all form events (show, submit, close, complete, error)
@@ -224,6 +241,33 @@ export declare interface IdentifyOptions {
     secure?: SecureOptions;
 }
 
+/**
+ * A single turn in a Q&A with AI conversation
+ */
+export declare interface QnaWithAiConversationTurn {
+    /** The question asked by the respondent */
+    question: string;
+    /** The AI's answer; empty string for the current unanswered turn */
+    answer: string;
+}
+
+/**
+ * Parameters for the qnaWithAi endpoint
+ */
+export declare interface QnaWithAiRequest {
+    feedbackConfigurationId: string;
+    questionId: string;
+    /** Full conversation including the current unanswered turn as the last entry */
+    conversation: QnaWithAiConversationTurn[];
+}
+
+/**
+ * Response from the qnaWithAi endpoint
+ */
+export declare interface QnaWithAiResponse {
+    answer: string;
+}
+
 /**
  * An individual question answer within a form submission
  */
@@ -353,6 +397,36 @@ export declare interface SubmitFormRequest {
  */
 export declare type Theme = 'light' | 'dark' | 'system';
 
+/**
+ * Parameters for the uploadFile method
+ */
+export declare interface UploadFileRequest {
+    /** The form's server-issued configuration ID */
+    feedbackConfigurationId: string;
+    /** The question ID the file belongs to */
+    questionId: string;
+    /** The file or blob to upload */
+    file: File | Blob;
+    /**
+     * File name to send to the server (e.g. "signature.png").
+     * Defaults to "upload" when omitted.
+     */
+    fileName?: string;
+    /**
+     * Optional progress callback — receives upload percentage (0–100).
+     * Useful for driving a progress bar in custom UIs.
+     */
+    onProgress?: (percent: number) => void;
+}
+
+/**
+ * Response from the uploadFile endpoint
+ */
+export declare interface UploadFileResponse {
+    /** Permanent URL of the uploaded file */
+    fileUrl: string;
+}
+
 /**
  * Encatch Web SDK Type Definitions
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@encatch/web-sdk",
-  "version": "1.2.0",
+  "version": "1.2.1-beta.0",
   "description": "A lightweight, type-safe JavaScript SDK for integrating Encatch forms and surveys",
   "type": "module",
   "main": "dist/encatch.es.js",