@encatch/web-sdk 1.0.0-beta.1 → 1.0.0-beta.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/encatch.es.js +1 -1
- package/dist/encatch.es.js.map +1 -1
- package/dist/encatch.iife.js +1 -1
- package/dist/encatch.iife.js.map +1 -1
- package/package.json +1 -1
package/dist/encatch.es.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
const e="encatch-sdk-script";let
|
|
1
|
+
const e="encatch-sdk-script";let t=!1,n=!1,i=null;function o(o){return n?Promise.resolve():i?Promise.reject(i):t?new Promise((e,t)=>{const o=setInterval(()=>{n?(clearInterval(o),e()):i&&(clearInterval(o),t(i))},50)}):(t=!0,new Promise((r,a)=>{if(document.getElementById(e))return t=!1,n=!0,void r();const c=(o.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"),o=String(e.getUTCHours()).padStart(2,"0"),r=30*Math.floor(e.getUTCMinutes()/30);return`${t}${n}${i}${o}${String(r).padStart(2,"0")}`}(),s=document.createElement("script");s.id=e,s.src=c,s.type="module",s.async=!0,s.onload=()=>{t=!1,n=!0,r()},s.onerror=e=>{t=!1,i=new Error(`[Encatch] Failed to load SDK from ${c}. 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(s,d):document.head.appendChild(s)}))}function r(e,t){return function(...n){e.push([t,...n])}}const a=["init","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","addToResponse"];function c(){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:()=>{},addToResponse:()=>{}},i=a.filter(e=>"init"!==e);for(const o of i)n[o]=r(e,o);return n}const s=function(){if("undefined"!=typeof window){const e=window._encatch;if(e&&Array.isArray(e._q)){const t=c();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=c();return window._encatch=t,t}return c()}();export{s as _encatch,s as default};
|
|
2
2
|
//# sourceMappingURL=encatch.es.js.map
|
package/dist/encatch.es.js.map
CHANGED
|
@@ -1 +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/** 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 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 EventType,\n EventCallback,\n EventPayload,\n Theme,\n ResetMode,\n ShowFormOptions,\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 addToResponse: () => {},\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","createQueuedMethod","queue","methodName","args","push","QUEUED_METHODS","createEncatchStub","eventCallbacks","sdk","_q","_eventCallbacks","_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","index","indexOf","splice","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","addToResponse","methodsToQueue","filter","m","method","_encatch","existing","Array","isArray","initGlobal"],"mappings":"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"}
|
|
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 '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 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 EventType,\n EventCallback,\n EventPayload,\n Theme,\n ResetMode,\n ShowFormOptions,\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 addToResponse: () => {},\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","addToResponse","methodsToQueue","filter","m","method","_encatch","existing","Array","isArray","initGlobal"],"mappings":"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"}
|
package/dist/encatch.iife.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
!function(e){"use strict";const
|
|
1
|
+
!function(e){"use strict";const t="encatch-sdk-script";let n=!1,i=!1,o=null;function r(e){return i?Promise.resolve():o?Promise.reject(o):n?new Promise((e,t)=>{const n=setInterval(()=>{i?(clearInterval(n),e()):o&&(clearInterval(n),t(o))},50)}):(n=!0,new Promise((r,c)=>{if(document.getElementById(t))return n=!1,i=!0,void r();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"),o=String(e.getUTCHours()).padStart(2,"0"),r=30*Math.floor(e.getUTCMinutes()/30);return`${t}${n}${i}${o}${String(r).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,r()},s.onerror=e=>{n=!1,o=new Error(`[Encatch] Failed to load SDK from ${a}. Please check your network connection and web host configuration.`),console.error(o.message,e),c(o)};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","addToResponse"];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:()=>{},addToResponse:()=>{}},i=a.filter(e=>"init"!==e);for(const o of i)n[o]=c(e,o);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||{});
|
|
2
2
|
//# sourceMappingURL=encatch.iife.js.map
|
package/dist/encatch.iife.js.map
CHANGED
|
@@ -1 +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/** 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 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 EventType,\n EventCallback,\n EventPayload,\n Theme,\n ResetMode,\n ShowFormOptions,\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 addToResponse: () => {},\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","createQueuedMethod","queue","methodName","args","push","QUEUED_METHODS","createEncatchStub","eventCallbacks","sdk","_q","_eventCallbacks","_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","index","indexOf","splice","identifyUser","setLocale","setCountry","setTheme","trackEvent","trackScreen","startSession","resetUser","showForm","addToResponse","methodsToQueue","filter","m","method","_encatch","existing","Array","isArray","initGlobal"],"mappings":"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"}
|
|
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 '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 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 EventType,\n EventCallback,\n EventPayload,\n Theme,\n ResetMode,\n ShowFormOptions,\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 addToResponse: () => {},\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","addToResponse","methodsToQueue","filter","m","method","_encatch","existing","Array","isArray","initGlobal"],"mappings":"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"}
|
package/package.json
CHANGED