@encatch/web-sdk 0.0.35-beta.8 → 1.0.0-beta.0

package/dist/encatch.es.js

@@ -0,0 +1,2 @@
+const e="encatch-sdk-script";let n=!1,t=!1,i=null;function o(e,n){return function(...t){e.push([n,...t])}}const r=["init","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","addToResponse"];function c(){const c=[],s=[],a={_q:c,_eventSubscriptions:s,_initialized:!1,_apiKey:null,_config:{},init(o,r){a._initialized?console.warn("[Encatch] SDK already initialized. Ignoring init call."):(a._apiKey=o,a._config=r||{},a._initialized=!0,c.push(["init",o,r]),"undefined"!=typeof window&&"undefined"!=typeof document&&function(o){return t?Promise.resolve():i?Promise.reject(i):n?new Promise((e,n)=>{const o=setInterval(()=>{t?(clearInterval(o),e()):i&&(clearInterval(o),n(i))},50)}):(n=!0,new Promise((r,c)=>{if(document.getElementById(e))return n=!1,t=!0,void r();const s=(o.webHost||"https://app.encatch.com")+"/s/sdk/v1/encatch.js",a=document.createElement("script");a.id=e,a.src=s,a.type="module",a.async=!0,a.onload=()=>{n=!1,t=!0,r()},a.onerror=e=>{n=!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),c(i)};const d=document.getElementsByTagName("script")[0];d&&d.parentNode?d.parentNode.insertBefore(a,d):document.head.appendChild(a)}))}(a._config).catch(e=>{console.error("[Encatch] Failed to initialize SDK:",e)}))},on(e,n){const t={event:e,callback:n};return s.push(t),()=>{const e=s.indexOf(t);e>-1&&s.splice(e,1)}},off(e,n){const t=s.findIndex(t=>t.event===e&&t.callback===n);t>-1&&s.splice(t,1)},identifyUser:()=>{},setLocale:()=>{},setCountry:()=>{},setTheme:()=>{},trackEvent:()=>{},trackScreen:()=>{},startSession:()=>{},resetUser:()=>{},showForm:()=>{},addToResponse:()=>{}},d=r.filter(e=>"init"!==e);for(const e of d)a[e]=o(c,e);return a}const s=function(){if("undefined"!=typeof window){const e=window._encatch;if(e&&Array.isArray(e._q)){const n=c();return n._q.push(...e._q),Array.isArray(e._eventSubscriptions)&&n._eventSubscriptions.push(...e._eventSubscriptions),e._initialized&&(n._initialized=e._initialized,n._apiKey=e._apiKey,n._config=e._config||{}),window._encatch=n,n}const n=c();return window._encatch=n,n}return c()}();export{s as _encatch,s as default};
+//# sourceMappingURL=encatch.es.js.map

package/dist/encatch.es.js.map

@@ -0,0 +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/** 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\n    const webHost = config.webHost || DEFAULT_WEB_HOST;\n    const scriptUrl = webHost + SDK_SCRIPT_PATH;\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\n */\nexport function getDefaultScriptUrl(): string {\n  return DEFAULT_WEB_HOST + SDK_SCRIPT_PATH;\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  'addToResponse',\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  EventType,\n  EventCallback,\n  EventSubscription,\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  EventType,\n  EventCallback,\n  EventPayload,\n  Theme,\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 subscriptions\n  const eventSubscriptions: EventSubscription[] = [];\n\n  // Create the SDK object\n  const sdk: EncatchSDK = {\n    // Internal state\n    _q: queue,\n    _eventSubscriptions: eventSubscriptions,\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 - handled locally, persists across script load\n    on(event: EventType, callback: EventCallback): () => void {\n      const subscription: EventSubscription = { event, callback };\n      eventSubscriptions.push(subscription);\n\n      // Return unsubscribe function\n      return () => {\n        const index = eventSubscriptions.indexOf(subscription);\n        if (index > -1) {\n          eventSubscriptions.splice(index, 1);\n        }\n      };\n    },\n\n    // Event unsubscription\n    off(event: EventType, callback: EventCallback): void {\n      const index = eventSubscriptions.findIndex(\n        (sub) => sub.event === event && sub.callback === callback\n      );\n      if (index > -1) {\n        eventSubscriptions.splice(index, 1);\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    addToResponse: () => {},\n  };\n\n  // Replace stub methods with queue-based versions\n  // Skip init (handled specially above) and on/off (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 subscriptions\n      if (Array.isArray(existing._eventSubscriptions)) {\n        sdk._eventSubscriptions.push(...existing._eventSubscriptions);\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","createQueuedMethod","queue","methodName","args","push","QUEUED_METHODS","createEncatchStub","eventSubscriptions","sdk","_q","_eventSubscriptions","_initialized","_apiKey","_config","init","apiKey","config","console","warn","window","document","Promise","resolve","reject","checkInterval","setInterval","clearInterval","getElementById","scriptUrl","webHost","script","createElement","id","src","type","async","onload","onerror","event","Error","error","message","firstScript","getElementsByTagName","parentNode","insertBefore","head","appendChild","loadRemoteScript","catch","on","callback","subscription","index","indexOf","splice","off","findIndex","sub","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","addToResponse","methodsToQueue","filter","m","method","_encatch","existing","Array","isArray","initGlobal"],"mappings":"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"}

package/dist/encatch.iife.js

@@ -0,0 +1,2 @@
+!function(e){"use strict";const n="encatch-sdk-script";let t=!1,i=!1,o=null;function c(e,n){return function(...t){e.push([n,...t])}}const r=["init","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","addToResponse"];function s(){const e=[],s=[],a={_q:e,_eventSubscriptions:s,_initialized:!1,_apiKey:null,_config:{},init(c,r){a._initialized?console.warn("[Encatch] SDK already initialized. Ignoring init call."):(a._apiKey=c,a._config=r||{},a._initialized=!0,e.push(["init",c,r]),"undefined"!=typeof window&&"undefined"!=typeof document&&function(e){return i?Promise.resolve():o?Promise.reject(o):t?new Promise((e,n)=>{const t=setInterval(()=>{i?(clearInterval(t),e()):o&&(clearInterval(t),n(o))},50)}):(t=!0,new Promise((c,r)=>{if(document.getElementById(n))return t=!1,i=!0,void c();const s=(e.webHost||"https://app.encatch.com")+"/s/sdk/v1/encatch.js",a=document.createElement("script");a.id=n,a.src=s,a.type="module",a.async=!0,a.onload=()=>{t=!1,i=!0,c()},a.onerror=e=>{t=!1,o=new Error(`[Encatch] Failed to load SDK from ${s}. Please check your network connection and web host configuration.`),console.error(o.message,e),r(o)};const d=document.getElementsByTagName("script")[0];d&&d.parentNode?d.parentNode.insertBefore(a,d):document.head.appendChild(a)}))}(a._config).catch(e=>{console.error("[Encatch] Failed to initialize SDK:",e)}))},on(e,n){const t={event:e,callback:n};return s.push(t),()=>{const e=s.indexOf(t);e>-1&&s.splice(e,1)}},off(e,n){const t=s.findIndex(t=>t.event===e&&t.callback===n);t>-1&&s.splice(t,1)},identifyUser:()=>{},setLocale:()=>{},setCountry:()=>{},setTheme:()=>{},trackEvent:()=>{},trackScreen:()=>{},startSession:()=>{},resetUser:()=>{},showForm:()=>{},addToResponse:()=>{}},d=r.filter(e=>"init"!==e);for(const n of d)a[n]=c(e,n);return a}const a=function(){if("undefined"!=typeof window){const e=window._encatch;if(e&&Array.isArray(e._q)){const n=s();return n._q.push(...e._q),Array.isArray(e._eventSubscriptions)&&n._eventSubscriptions.push(...e._eventSubscriptions),e._initialized&&(n._initialized=e._initialized,n._apiKey=e._apiKey,n._config=e._config||{}),window._encatch=n,n}const n=s();return window._encatch=n,n}return s()}();e._encatch=a,e.default=a,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

@@ -0,0 +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/** 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\n    const webHost = config.webHost || DEFAULT_WEB_HOST;\n    const scriptUrl = webHost + SDK_SCRIPT_PATH;\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\n */\nexport function getDefaultScriptUrl(): string {\n  return DEFAULT_WEB_HOST + SDK_SCRIPT_PATH;\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  'addToResponse',\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  EventType,\n  EventCallback,\n  EventSubscription,\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  EventType,\n  EventCallback,\n  EventPayload,\n  Theme,\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 subscriptions\n  const eventSubscriptions: EventSubscription[] = [];\n\n  // Create the SDK object\n  const sdk: EncatchSDK = {\n    // Internal state\n    _q: queue,\n    _eventSubscriptions: eventSubscriptions,\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 - handled locally, persists across script load\n    on(event: EventType, callback: EventCallback): () => void {\n      const subscription: EventSubscription = { event, callback };\n      eventSubscriptions.push(subscription);\n\n      // Return unsubscribe function\n      return () => {\n        const index = eventSubscriptions.indexOf(subscription);\n        if (index > -1) {\n          eventSubscriptions.splice(index, 1);\n        }\n      };\n    },\n\n    // Event unsubscription\n    off(event: EventType, callback: EventCallback): void {\n      const index = eventSubscriptions.findIndex(\n        (sub) => sub.event === event && sub.callback === callback\n      );\n      if (index > -1) {\n        eventSubscriptions.splice(index, 1);\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    addToResponse: () => {},\n  };\n\n  // Replace stub methods with queue-based versions\n  // Skip init (handled specially above) and on/off (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 subscriptions\n      if (Array.isArray(existing._eventSubscriptions)) {\n        sdk._eventSubscriptions.push(...existing._eventSubscriptions);\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","createQueuedMethod","queue","methodName","args","push","QUEUED_METHODS","createEncatchStub","eventSubscriptions","sdk","_q","_eventSubscriptions","_initialized","_apiKey","_config","init","apiKey","config","console","warn","window","document","Promise","resolve","reject","checkInterval","setInterval","clearInterval","getElementById","scriptUrl","webHost","script","createElement","id","src","type","async","onload","onerror","event","Error","error","message","firstScript","getElementsByTagName","parentNode","insertBefore","head","appendChild","loadRemoteScript","catch","on","callback","subscription","index","indexOf","splice","off","findIndex","sub","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","addToResponse","methodsToQueue","filter","m","method","_encatch","existing","Array","isArray","initGlobal"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Internal command tuple type for the queue
+ */
+declare type Command = [string, ...unknown[]];
+
+declare const _encatch: EncatchSDK;
+export { _encatch }
+export default _encatch;
+
+/**
+ * Configuration options for the SDK
+ */
+export declare interface EncatchConfig {
+    /** Override the default web host for loading the SDK script */
+    webHost?: string;
+    /** Theme setting - defaults to 'system' */
+    theme?: Theme;
+    /** API base URL - defaults to 'https://app.encatch.com' */
+    apiBaseUrl?: string;
+    /** When true, displays the form inline at full height without modal overlay */
+    isFullScreen?: boolean;
+}
+
+/**
+ * The Encatch SDK interface
+ */
+export declare interface EncatchSDK {
+    /**
+     * Initialize the SDK with an API key
+     * This triggers the loading of the remote implementation script
+     * @param apiKey - Your Encatch API key
+     * @param config - Optional configuration options
+     */
+    init(apiKey: string, config?: EncatchConfig): void;
+    /**
+     * Identify the current user
+     * @param id - Unique user identifier (required)
+     * @param traits - Optional user traits with nested operations ($set, $setOnce, $increment, $decrement, $unset)
+     * @param options - Optional settings like locale, country, and secure signature
+     */
+    identifyUser(id: string, traits?: UserTraits, options?: IdentifyOptions): void;
+    /**
+     * Set the user's preferred locale
+     * @param locale - Comma-separated ISO 639-1 language codes (e.g., 'fr,en,es')
+     */
+    setLocale(locale: string): void;
+    /**
+     * Set the user's country
+     * @param country - ISO 3166 country code (e.g., 'US', 'FR')
+     */
+    setCountry(country: string): void;
+    /**
+     * Set the theme
+     * @param theme - Theme value ('light', 'dark', or 'system')
+     */
+    setTheme(theme: Theme): void;
+    /**
+     * Track a custom event
+     * @param eventName - Name of the event to track
+     */
+    trackEvent(eventName: string): void;
+    /**
+     * Track a screen view
+     * @param screenName - Name of the screen to track
+     */
+    trackScreen(screenName: string): void;
+    /**
+     * Manually start a new session
+     * Useful after user login to reset session timing
+     */
+    startSession(): void;
+    /**
+     * Reset the current user (logout)
+     * Reverts the SDK to anonymous mode
+     */
+    resetUser(): void;
+    /**
+     * Show a specific form by ID
+     * @param formId - The ID of the form to display
+     * @param force - Force show even if already shown (optional)
+     */
+    showForm(formId: string, force?: boolean): void;
+    /**
+     * Prepopulate a form response
+     * @param questionId - The ID of the question to prepopulate
+     * @param value - The value to set
+     */
+    addToResponse(questionId: string, value: unknown): void;
+    /**
+     * Subscribe to SDK events
+     * @param event - The event type to listen for
+     * @param callback - Function to call when event occurs
+     * @returns Unsubscribe function
+     */
+    on(event: EventType, callback: EventCallback): () => void;
+    /**
+     * Unsubscribe from SDK events
+     * @param event - The event type to stop listening for
+     * @param callback - The callback to remove
+     */
+    off(event: EventType, callback: EventCallback): void;
+    /** Internal: Command queue for calls made before script loads */
+    _q: Command[];
+    /** Internal: Event subscriptions */
+    _eventSubscriptions: EventSubscription[];
+    /** Internal: Whether the SDK has been initialized */
+    _initialized: boolean;
+    /** Internal: The API key */
+    _apiKey: string | null;
+    /** Internal: Configuration */
+    _config: EncatchConfig;
+}
+
+/**
+ * Event callback function type
+ */
+export declare type EventCallback = (payload: EventPayload) => void;
+
+/**
+ * Event payload structure
+ */
+export declare interface EventPayload {
+    /** The form ID related to the event */
+    formId?: string;
+    /** Timestamp of the event */
+    timestamp: number;
+    /** Additional event-specific data */
+    data?: Record<string, unknown>;
+}
+
+/**
+ * Event subscription entry
+ */
+declare interface EventSubscription {
+    event: EventType;
+    callback: EventCallback;
+}
+
+/**
+ * Event types that can be subscribed to
+ */
+export declare type EventType = 'form:show' | 'form:submit' | 'form:close' | 'form:complete' | 'form:error';
+
+/**
+ * Options for the identifyUser method
+ */
+export declare interface IdentifyOptions {
+    /** User's preferred locale (ISO 639-1 codes, comma-separated) */
+    locale?: string;
+    /** User's country (ISO 3166 country code) */
+    country?: string;
+    /** Secure identification options with signature */
+    secure?: SecureOptions;
+}
+
+/**
+ * Secure options for user identification
+ */
+declare interface SecureOptions {
+    /** User signature (required when secure is set) */
+    signature: string;
+    /** Optional datetime in UTC when the signature was generated */
+    generatedDateTimeinUTC?: string;
+}
+
+/**
+ * Theme options
+ */
+export declare type Theme = 'light' | 'dark' | 'system';
+
+/**
+ * Encatch Web SDK Type Definitions
+ */
+/**
+ * User traits for identifying users
+ * Supports nested operations: $set, $setOnce, $increment, $decrement, $unset
+ */
+export declare interface UserTraits {
+    /** Set user attributes (overwrites existing values) */
+    $set?: Record<string, any>;
+    /** Set user attributes only if they don't already exist */
+    $setOnce?: Record<string, any>;
+    /** Increment numeric user attributes */
+    $increment?: Record<string, number>;
+    /** Decrement numeric user attributes */
+    $decrement?: Record<string, number>;
+    /** Remove user attributes */
+    $unset?: string[];
+}
+
+export { }

package/package.json

@@ -1,72 +1,54 @@
 {
   "name": "@encatch/web-sdk",
-  "version": "0.0.35-beta.8",
-  "description": "A powerful, lightweight JavaScript SDK for collecting user feedback and running surveys on web applications",
+  "version": "1.0.0-beta.0",
+  "description": "A lightweight, type-safe JavaScript SDK for integrating Encatch forms and surveys",
   "type": "module",
-  "main": "dist-sdk/plugin/sdk/module.js",
-  "module": "dist-sdk/plugin/sdk/module.js",
-  "types": "index.d.ts",
+  "main": "dist/encatch.es.js",
+  "module": "dist/encatch.es.js",
+  "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist-sdk/plugin/sdk/module.js",
-      "types": "./index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/encatch.es.js",
+      "require": "./dist/encatch.iife.js"
     },
-    "./cdn": {
-      "import": "./dist-sdk/plugin/sdk/encatch-web-sdk.js"
-    },
-    "./embedded": {
-      "import": "./dist-sdk/plugin/sdk/embedded-sdk.js"
-    },
-    "./preview": {
-      "import": "./dist-sdk/plugin/sdk/preview-sdk.js"
+    "./iife": {
+      "import": "./dist/encatch.iife.js"
     }
   },
   "files": [
-    "dist-sdk",
-    "index.d.ts",
-    "src/@types",
-    "src/hooks",
-    "src/utils",
-    "src/store",
-    "src/feedback-api-types.ts",
-    "src/module.tsx",
-    "src/encatch-instance.ts",
+    "dist",
     "README.md"
   ],
+  "sideEffects": false,
   "keywords": [
-    "feedback",
-    "survey",
-    "sdk",
     "encatch",
+    "sdk",
+    "forms",
+    "surveys",
+    "feedback",
+    "analytics",
     "user-feedback",
     "web-sdk"
   ],
-  "dependencies": {
-    "@preact/signals": "^2.5.1",
-    "json-logic-js": "2.0.5",
-    "lucide-preact": "^0.555.0",
-    "path-to-regexp": "^8.3.0",
-    "preact": "^10.27.2",
-    "preact-iso": "^2.11.0",
-    "ua-parser-js": "^2.0.6",
-    "@encatch/api-sdk": "0.0.11-beta.4",
-    "@encatch/schema": "0.1.38-beta.6",
-    "@encatch/event-publisher": "0.0.2-beta.2"
-  },
   "devDependencies": {
-    "@preact/preset-vite": "^2.10.2",
-    "vite": "^7.2.4",
-    "@encatch/web-form-engine-core": "0.0.0"
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.4",
+    "terser": "^5.44.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/encatch/web-sdk"
   },
-  "eslintConfig": {
-    "extends": "preact"
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
   },
   "scripts": {
-    "dev": "vite",
-    "build": "vite build && vite build --config vite.module.config.ts",
-    "build:module": "vite build --config vite.module.config.ts",
-    "preview": "vite preview",
-    "preview:sdk": "vite preview --config vite.config.ts",
-    "clean": "rm -rf dist-sdk"
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
   }
 }