@coxwave/tap-kit 1.0.6 → 2.0.1

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/loader.ts","../src/kit.ts"],"names":["DEFAULT_CDN_LOADER_URL","getLoaderURL","isLocalCoreMode","getLocalCoreURL","createSDKChecker","resolve","reject","timeoutMs","startTime","checkSDK","loadCDNLoader","loadingPromise","coreURL","script","loaderURL","existingScript","TAPKIT_CONFIG_SYMBOL","_loading","_config","_loadError","_eventsProxy","_videoProxy","TapKit","config","__publicField","__privateAdd","__privateSet","__privateGet","err","_target","prop","args","method","params","options"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * CDN loader for TapKit\n * Dynamically loads the TapKit SDK from CDN\n *\n * For local testing, you can override the loader URL:\n * window.__TAP_KIT_LOADER_URL__ = '/tap-kit-core/loader.js';\n *\n * For local development (bypass loader, load IIFE directly):\n * window.__TAP_KIT_CORE_URL__ = '/packages/tap-kit-core/dist/index.global.js';\n */\n\n// Build-time constant injected by tsup define\ndeclare const __DEFAULT_CDN_LOADER_URL__: string;\n\nconst DEFAULT_CDN_LOADER_URL =\n  typeof __DEFAULT_CDN_LOADER_URL__ !== \"undefined\"\n    ? __DEFAULT_CDN_LOADER_URL__\n    : \"https://files.edutap.ai/tap-sdk/loader.js\";\nconst DEFAULT_TIMEOUT_MS = 4000; // 4 seconds total timeout\nconst IDLE_CALLBACK_TIMEOUT_MS = 500; // 500ms for requestIdleCallback\n\n/**\n * Get the loader URL from window override or default CDN\n */\nfunction getLoaderURL(): string {\n  return window?.__TAP_KIT_LOADER_URL__\n    ? window.__TAP_KIT_LOADER_URL__\n    : DEFAULT_CDN_LOADER_URL;\n}\n\n/**\n * Check if local core mode is enabled\n * When __TAP_KIT_CORE_URL__ is set, directly load the IIFE bundle\n * This bypasses the loader.js and loads tap-kit-core directly\n */\nfunction isLocalCoreMode(): boolean {\n  return typeof window !== \"undefined\" && !!window.__TAP_KIT_CORE_URL__;\n}\n\n/**\n * Get the local core URL\n */\nfunction getLocalCoreURL(): string {\n  return window.__TAP_KIT_CORE_URL__ || \"\";\n}\n\n/**\n * Creates a SDK checker function with timeout and retry logic\n * Uses requestIdleCallback to avoid blocking browser rendering\n * @param resolve - Promise resolve function\n * @param reject - Promise reject function\n * @param timeoutMs - Maximum time to wait for SDK to load (milliseconds)\n * @returns Checker function to be called repeatedly\n */\nfunction createSDKChecker(\n  resolve: (value: void | PromiseLike<void>) => void,\n  reject: (reason?: unknown) => void,\n  timeoutMs: number,\n): () => void {\n  const startTime = Date.now();\n\n  const checkSDK = (): void => {\n    // Check if real TapKit is loaded (not just stub)\n    // Stub has TapKitLoaded flag set to true by loader.js after real SDK loads\n    if (window.TapKit && window.TapKitLoaded === true) {\n      window.__TAP_KIT_LOADER_LOADED__ = true;\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      resolve();\n      return;\n    }\n\n    const elapsed = Date.now() - startTime;\n\n    // Check if exceeded timeout\n    if (elapsed > timeoutMs) {\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      reject(\n        new Error(\n          `TapKit loader timeout: SDK not available after ${timeoutMs}ms`,\n        ),\n      );\n      return;\n    }\n\n    // Use requestIdleCallback for better performance\n    // Falls back to setTimeout if not available\n    if (typeof requestIdleCallback !== \"undefined\") {\n      requestIdleCallback(checkSDK, { timeout: IDLE_CALLBACK_TIMEOUT_MS });\n    } else {\n      setTimeout(checkSDK, IDLE_CALLBACK_TIMEOUT_MS);\n    }\n  };\n\n  return checkSDK;\n}\n\n/**\n * Loads the CDN loader script\n * The loader will then fetch versions.json and load the appropriate SDK version\n *\n * If __TAP_KIT_CORE_URL__ is set, bypasses loader and loads IIFE directly\n *\n * @param timeoutMs - Maximum time to wait for SDK to load (default: 4000ms)\n * @returns Promise that resolves when SDK is loaded\n * @throws {Error} If loader fails to load or times out\n */\nexport function loadCDNLoader(\n  timeoutMs: number = DEFAULT_TIMEOUT_MS,\n): Promise<void> {\n  // If already loaded, return immediately\n  if (window.__TAP_KIT_LOADER_LOADED__ && window.TapKit) {\n    return Promise.resolve();\n  }\n\n  // If currently loading, return the existing promise\n  if (window.__TAP_KIT_LOADER_LOADING__) {\n    return window.__TAP_KIT_LOADER_LOADING__;\n  }\n\n  // Create loading promise\n  const loadingPromise = new Promise<void>((resolve, reject) => {\n    if (typeof document === \"undefined\") {\n      reject(\n        new Error(\n          \"TapKit requires browser environment (document is undefined)\",\n        ),\n      );\n      return;\n    }\n\n    // Local core mode: Load IIFE directly\n    if (isLocalCoreMode()) {\n      // Check if TapKit is already loaded (from other pages in playground)\n      if (window.TapKit && window.TapKitLoaded === true) {\n        window.__TAP_KIT_LOADER_LOADED__ = true;\n        window.__TAP_KIT_LOADER_LOADING__ = undefined;\n        resolve();\n        return;\n      }\n\n      const coreURL = getLocalCoreURL();\n\n      const script = document.createElement(\"script\");\n      script.src = coreURL;\n      script.async = true;\n\n      script.onload = () => {\n        // IIFE directly sets window.TapKit\n        // Set the loaded flag manually since we bypass loader.js\n        if (window.TapKit) {\n          window.TapKitLoaded = true;\n          window.__TAP_KIT_LOADER_LOADED__ = true;\n          window.__TAP_KIT_LOADER_LOADING__ = undefined;\n          resolve();\n        } else {\n          window.__TAP_KIT_LOADER_LOADING__ = undefined;\n          reject(new Error(\"TapKit not available after loading local core\"));\n        }\n      };\n\n      script.onerror = () => {\n        window.__TAP_KIT_LOADER_LOADING__ = undefined;\n        reject(new Error(`Failed to load local TapKit core: ${coreURL}`));\n      };\n\n      document.head.appendChild(script);\n      return;\n    }\n\n    // CDN mode: Load loader.js\n    const loaderURL = getLoaderURL();\n    const script = document.createElement(\"script\");\n    script.src = loaderURL;\n    script.async = true;\n\n    script.onload = () => {\n      // The loader script will load the actual SDK\n      // We need to wait a bit for the loader to fetch and load the SDK\n      const checkSDK = createSDKChecker(resolve, reject, timeoutMs);\n      checkSDK();\n    };\n\n    script.onerror = () => {\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      reject(new Error(`Failed to load TapKit CDN loader: ${loaderURL}`));\n    };\n\n    // Check if script already exists\n    const existingScript = document.querySelector(`script[src=\"${loaderURL}\"]`);\n\n    if (existingScript) {\n      // Script already added but not yet loaded\n      existingScript.addEventListener(\"load\", () => {\n        const checkSDK = createSDKChecker(resolve, reject, timeoutMs);\n        checkSDK();\n      });\n      existingScript.addEventListener(\"error\", () =>\n        reject(new Error(`Failed to load TapKit CDN loader: ${loaderURL}`)),\n      );\n    } else {\n      document.head.appendChild(script);\n    }\n  });\n\n  window.__TAP_KIT_LOADER_LOADING__ = loadingPromise;\n  return loadingPromise;\n}\n","import type {\n  TAPKIT_CONFIG_SYMBOL as TAPKIT_CONFIG_SYMBOL_TYPE,\n  TapKitConfig,\n  TapKitConfigOptions,\n  TapKitInitParams,\n  TapKitInstance,\n} from \"@coxwave/tap-kit-types\";\nimport { loadCDNLoader } from \"./loader\";\n\n/** @internal Symbol for internal configuration method */\nconst TAPKIT_CONFIG_SYMBOL: typeof TAPKIT_CONFIG_SYMBOL_TYPE =\n  // biome-ignore lint/suspicious/noExplicitAny: Symbol type casting required for compatibility\n  Symbol.for(\"tapkit.config\") as any;\n\n/**\n * TapKit - Official TapKit Web SDK\n *\n * @example\n * ```typescript\n * import TapKit from \"@coxwave/tap-kit\";\n *\n * const kit = new TapKit({ apiKey: 'your-api-key' });\n *\n * await kit.init({\n *   buttonId: 'tap-button',\n *   course: {\n *     userId: 'user-123',\n *     courseId: 'course-456',\n *     clipId: 'clip-789',\n *   },\n *   container: {\n *     position: { top: '64px', right: '32px' },\n *     width: '360px',\n *     height: 'calc(100% - 128px)',\n *   },\n * });\n * ```\n */\nexport class TapKit implements TapKitInstance {\n  private instance: TapKitInstance | null = null;\n  #loading: Promise<void>;\n  #config: TapKitConfig;\n  #loadError: Error | null = null;\n  private pendingConfig?: TapKitConfigOptions; // Queue config until instance is ready\n  #eventsProxy?: TapKitInstance[\"events\"]; // Cached proxy for events API\n  #videoProxy?: TapKitInstance[\"video\"]; // Cached proxy for video API\n\n  constructor(config: TapKitConfig) {\n    this.#config = config;\n    this.#loading = this.load();\n  }\n\n  private async load(): Promise<void> {\n    try {\n      await loadCDNLoader();\n\n      if (!window.TapKit) {\n        throw new Error(\"TapKit not available after loading CDN loader\");\n      }\n\n      this.instance = new window.TapKit(this.#config);\n\n      // Apply pending config if any\n      if (this.pendingConfig) {\n        this.instance[TAPKIT_CONFIG_SYMBOL]?.(this.pendingConfig);\n        this.pendingConfig = undefined;\n      }\n    } catch (err) {\n      this.#loadError = err instanceof Error ? err : new Error(String(err));\n      throw this.#loadError;\n    }\n  }\n\n  /**\n   * Promise that resolves when CDN is loaded and instance is created\n   * (ready to call init())\n   */\n  get loaded(): Promise<void> {\n    return this.#loading.then(() => {\n      if (this.#loadError) {\n        throw this.#loadError;\n      }\n      if (!this.instance) {\n        throw new Error(\n          `TapKit instance not initialized after loading. This may indicate a CDN loading failure for apiKey: ${this.#config.apiKey}`,\n        );\n      }\n    });\n  }\n\n  /**\n   * Promise that resolves when SDK is fully initialized\n   * (after init() is called and iframe is ready)\n   */\n  get ready(): Promise<void> {\n    return this.#loading.then(() => {\n      if (this.#loadError) {\n        throw this.#loadError;\n      }\n      if (!this.instance) {\n        throw new Error(\n          `TapKit instance not initialized after loading. This may indicate a CDN loading failure for apiKey: ${this.#config.apiKey}`,\n        );\n      }\n      return this.instance.ready;\n    });\n  }\n\n  get events() {\n    // Cache proxy to avoid creating new Proxy object on every access\n    if (!this.#eventsProxy) {\n      // Proxy pattern: automatically wait for ready when calling methods\n      this.#eventsProxy = new Proxy({} as TapKitInstance[\"events\"], {\n        get: (_target, prop: string) => {\n          // biome-ignore lint/suspicious/noExplicitAny: Dynamic method signature unknown at compile time\n          return (...args: any[]) => {\n            return this.ready.then(() => {\n              // biome-ignore lint/suspicious/noExplicitAny: Dynamic property access requires any\n              const method = (this.instance?.events as any)[prop];\n              if (typeof method === \"function\") {\n                return method(...args);\n              }\n              return method;\n            });\n          };\n        },\n      });\n    }\n    return this.#eventsProxy;\n  }\n\n  get isOpen(): boolean {\n    return this.instance?.isOpen ?? false;\n  }\n\n  get isInitialized(): boolean {\n    return this.instance?.isInitialized ?? false;\n  }\n\n  get video() {\n    // Cache proxy to avoid creating new Proxy object on every access\n    if (!this.#videoProxy) {\n      // Proxy pattern: automatically wait for ready when calling methods\n      this.#videoProxy = new Proxy({} as TapKitInstance[\"video\"], {\n        get: (_target, prop: string) => {\n          // biome-ignore lint/suspicious/noExplicitAny: Dynamic method signature unknown at compile time\n          return (...args: any[]) => {\n            return this.ready.then(() => {\n              // biome-ignore lint/suspicious/noExplicitAny: Dynamic property access requires any\n              const method = (this.instance?.video as any)[prop];\n              if (typeof method === \"function\") {\n                return method(...args);\n              }\n              return method;\n            });\n          };\n        },\n      });\n    }\n    return this.#videoProxy;\n  }\n\n  async init(params: TapKitInitParams): Promise<() => void> {\n    await this.#loading;\n    if (!this.instance) {\n      throw new Error(\"TapKit instance not available after loading\");\n    }\n    return await this.instance.init(params);\n  }\n\n  destroy(): void {\n    if (this.instance) {\n      this.instance.destroy();\n      this.instance = null;\n    }\n  }\n\n  [TAPKIT_CONFIG_SYMBOL](options: TapKitConfigOptions): void {\n    if (!this.instance) {\n      // Queue config until instance is ready\n      this.pendingConfig = options;\n      return;\n    }\n    this.instance[TAPKIT_CONFIG_SYMBOL]?.(options);\n  }\n\n  get [Symbol.toStringTag]() {\n    return \"TapKit\";\n  }\n}\n\n// Export the symbol for type compatibility\nexport { TAPKIT_CONFIG_SYMBOL };\n"]}
+{"version":3,"sources":["../src/loader.ts","../src/kit.ts"],"names":["DEFAULT_CDN_LOADER_URL","getLoaderURL","isLocalCoreMode","getLocalCoreURL","createSDKChecker","resolve","reject","timeoutMs","startTime","checkSDK","loadCDNLoader","loadingPromise","coreURL","script","loaderURL","existingScript","_loading","_config","_loadError","_eventsProxy","_videoProxy","TapKit","config","__publicField","__privateAdd","__privateSet","__privateGet","err","propertyName","_target","prop","args","method","params"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * CDN loader for TapKit\n * Dynamically loads the TapKit SDK from CDN\n *\n * For local testing, you can override the loader URL:\n * window.__TAP_KIT_LOADER_URL__ = '/tap-kit-core/loader.js';\n *\n * For local development (bypass loader, load IIFE directly):\n * window.__TAP_KIT_CORE_URL__ = '/packages/tap-kit-core/dist/index.global.js';\n */\n\n// Build-time constant injected by tsup define\ndeclare const __DEFAULT_CDN_LOADER_URL__: string;\n\nconst DEFAULT_CDN_LOADER_URL =\n  typeof __DEFAULT_CDN_LOADER_URL__ !== \"undefined\"\n    ? __DEFAULT_CDN_LOADER_URL__\n    : \"https://files.edutap.ai/tap-sdk/loader.js\";\nconst DEFAULT_TIMEOUT_MS = 4000; // 4 seconds total timeout\nconst IDLE_CALLBACK_TIMEOUT_MS = 500; // 500ms for requestIdleCallback\n\n/**\n * Get the loader URL from window override or default CDN\n */\nfunction getLoaderURL(): string {\n  return window?.__TAP_KIT_LOADER_URL__\n    ? window.__TAP_KIT_LOADER_URL__\n    : DEFAULT_CDN_LOADER_URL;\n}\n\n/**\n * Check if local core mode is enabled\n * When __TAP_KIT_CORE_URL__ is set, directly load the IIFE bundle\n * This bypasses the loader.js and loads tap-kit-core directly\n */\nfunction isLocalCoreMode(): boolean {\n  return typeof window !== \"undefined\" && !!window.__TAP_KIT_CORE_URL__;\n}\n\n/**\n * Get the local core URL\n */\nfunction getLocalCoreURL(): string {\n  return window.__TAP_KIT_CORE_URL__ || \"\";\n}\n\n/**\n * Creates a SDK checker function with timeout and retry logic\n * Uses requestIdleCallback to avoid blocking browser rendering\n * @param resolve - Promise resolve function\n * @param reject - Promise reject function\n * @param timeoutMs - Maximum time to wait for SDK to load (milliseconds)\n * @returns Checker function to be called repeatedly\n */\nfunction createSDKChecker(\n  resolve: (value: void | PromiseLike<void>) => void,\n  reject: (reason?: unknown) => void,\n  timeoutMs: number,\n): () => void {\n  const startTime = Date.now();\n\n  const checkSDK = (): void => {\n    // Check if real TapKit is loaded (not just stub)\n    // Stub has TapKitLoaded flag set to true by loader.js after real SDK loads\n    if (window.TapKit && window.TapKitLoaded === true) {\n      window.__TAP_KIT_LOADER_LOADED__ = true;\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      resolve();\n      return;\n    }\n\n    const elapsed = Date.now() - startTime;\n\n    // Check if exceeded timeout\n    if (elapsed > timeoutMs) {\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      reject(\n        new Error(\n          `TapKit loader timeout: SDK not available after ${timeoutMs}ms`,\n        ),\n      );\n      return;\n    }\n\n    // Use requestIdleCallback for better performance\n    // Falls back to setTimeout if not available\n    if (typeof requestIdleCallback !== \"undefined\") {\n      requestIdleCallback(checkSDK, { timeout: IDLE_CALLBACK_TIMEOUT_MS });\n    } else {\n      setTimeout(checkSDK, IDLE_CALLBACK_TIMEOUT_MS);\n    }\n  };\n\n  return checkSDK;\n}\n\n/**\n * Loads the CDN loader script\n * The loader will then fetch versions.json and load the appropriate SDK version\n *\n * If __TAP_KIT_CORE_URL__ is set, bypasses loader and loads IIFE directly\n *\n * @param timeoutMs - Maximum time to wait for SDK to load (default: 4000ms)\n * @returns Promise that resolves when SDK is loaded\n * @throws {Error} If loader fails to load or times out\n */\nexport function loadCDNLoader(\n  timeoutMs: number = DEFAULT_TIMEOUT_MS,\n): Promise<void> {\n  // If already loaded, return immediately\n  if (window.__TAP_KIT_LOADER_LOADED__ && window.TapKit) {\n    return Promise.resolve();\n  }\n\n  // If currently loading, return the existing promise\n  if (window.__TAP_KIT_LOADER_LOADING__) {\n    return window.__TAP_KIT_LOADER_LOADING__;\n  }\n\n  // Create loading promise\n  const loadingPromise = new Promise<void>((resolve, reject) => {\n    if (typeof document === \"undefined\") {\n      reject(\n        new Error(\n          \"TapKit requires browser environment (document is undefined)\",\n        ),\n      );\n      return;\n    }\n\n    // Local core mode: Load IIFE directly\n    if (isLocalCoreMode()) {\n      // Check if TapKit is already loaded (from other pages in playground)\n      if (window.TapKit && window.TapKitLoaded === true) {\n        window.__TAP_KIT_LOADER_LOADED__ = true;\n        window.__TAP_KIT_LOADER_LOADING__ = undefined;\n        resolve();\n        return;\n      }\n\n      const coreURL = getLocalCoreURL();\n\n      const script = document.createElement(\"script\");\n      script.src = coreURL;\n      script.async = true;\n\n      script.onload = () => {\n        // IIFE directly sets window.TapKit\n        // Set the loaded flag manually since we bypass loader.js\n        if (window.TapKit) {\n          window.TapKitLoaded = true;\n          window.__TAP_KIT_LOADER_LOADED__ = true;\n          window.__TAP_KIT_LOADER_LOADING__ = undefined;\n          resolve();\n        } else {\n          window.__TAP_KIT_LOADER_LOADING__ = undefined;\n          reject(new Error(\"TapKit not available after loading local core\"));\n        }\n      };\n\n      script.onerror = () => {\n        window.__TAP_KIT_LOADER_LOADING__ = undefined;\n        reject(new Error(`Failed to load local TapKit core: ${coreURL}`));\n      };\n\n      document.head.appendChild(script);\n      return;\n    }\n\n    // CDN mode: Load loader.js\n    const loaderURL = getLoaderURL();\n    const script = document.createElement(\"script\");\n    script.src = loaderURL;\n    script.async = true;\n\n    script.onload = () => {\n      // The loader script will load the actual SDK\n      // We need to wait a bit for the loader to fetch and load the SDK\n      const checkSDK = createSDKChecker(resolve, reject, timeoutMs);\n      checkSDK();\n    };\n\n    script.onerror = () => {\n      window.__TAP_KIT_LOADER_LOADING__ = undefined;\n      reject(new Error(`Failed to load TapKit CDN loader: ${loaderURL}`));\n    };\n\n    // Check if script already exists\n    const existingScript = document.querySelector(`script[src=\"${loaderURL}\"]`);\n\n    if (existingScript) {\n      // Script already added but not yet loaded\n      existingScript.addEventListener(\"load\", () => {\n        const checkSDK = createSDKChecker(resolve, reject, timeoutMs);\n        checkSDK();\n      });\n      existingScript.addEventListener(\"error\", () =>\n        reject(new Error(`Failed to load TapKit CDN loader: ${loaderURL}`)),\n      );\n    } else {\n      document.head.appendChild(script);\n    }\n  });\n\n  window.__TAP_KIT_LOADER_LOADING__ = loadingPromise;\n  return loadingPromise;\n}\n","import type {\n  TapKitConfig,\n  TapKitInitParams,\n  TapKitInstance,\n} from \"@coxwave/tap-kit-types\";\nimport { loadCDNLoader } from \"./loader\";\n\n/**\n * TapKit - Official TapKit Web SDK\n *\n * @example\n * ```typescript\n * import TapKit from \"@coxwave/tap-kit\";\n *\n * const kit = new TapKit({ apiKey: 'your-api-key' });\n *\n * await kit.init({\n *   buttonId: 'tap-button',\n *   course: {\n *     userId: 'user-123',\n *     courseId: 'course-456',\n *     clipId: 'clip-789',\n *   },\n *   container: {\n *     position: { top: '64px', right: '32px' },\n *     width: '360px',\n *     height: 'calc(100% - 128px)',\n *   },\n * });\n * ```\n */\nexport class TapKit implements TapKitInstance {\n  private instance: TapKitInstance | null = null;\n  #loading: Promise<void>;\n  #config: TapKitConfig;\n  #loadError: Error | null = null;\n  #eventsProxy?: TapKitInstance[\"events\"]; // Cached proxy for events API\n  #videoProxy?: TapKitInstance[\"video\"]; // Cached proxy for video API\n\n  constructor(config: TapKitConfig) {\n    this.#config = config;\n    this.#loading = this.load();\n  }\n\n  private async load(): Promise<void> {\n    try {\n      await loadCDNLoader();\n\n      if (!window.TapKit) {\n        throw new Error(\"TapKit not available after loading CDN loader\");\n      }\n\n      this.instance = new window.TapKit(this.#config);\n    } catch (err) {\n      this.#loadError = err instanceof Error ? err : new Error(String(err));\n      throw this.#loadError;\n    }\n  }\n\n  /**\n   * Promise that resolves when CDN is loaded and TapKit instance is available\n   * (ready to call init())\n   *\n   * @example\n   * ```typescript\n   * const kit = new TapKit({ apiKey });\n   * await kit.loaded; // CDN downloaded, window.TapKit available\n   * await kit.init({...}); // Now safe to call init()\n   * ```\n   *\n   * @see ready - For waiting until AFTER init() completes (iframe initialized)\n   */\n  get loaded(): Promise<void> {\n    return this.#loading.then(() => {\n      if (this.#loadError) {\n        throw this.#loadError;\n      }\n      if (!this.instance) {\n        throw new Error(\n          `TapKit instance not initialized after loading. This may indicate a CDN loading failure for apiKey: ${this.#config.apiKey}`,\n        );\n      }\n    });\n  }\n\n  /**\n   * Promise that resolves when SDK is fully initialized\n   * (after init() is called and iframe is ready)\n   *\n   * @example\n   * ```typescript\n   * const kit = new TapKit({ apiKey });\n   * await kit.init({...});\n   * await kit.ready; // iframe is fully initialized\n   * ```\n   *\n   * @see loaded - For waiting until CDN load completes (before init)\n   */\n  get ready(): Promise<void> {\n    return this.#loading.then(() => {\n      if (this.#loadError) {\n        throw this.#loadError;\n      }\n      if (!this.instance) {\n        throw new Error(\n          `TapKit instance not initialized after loading. This may indicate a CDN loading failure for apiKey: ${this.#config.apiKey}`,\n        );\n      }\n      return this.instance.ready;\n    });\n  }\n\n  /**\n   * Create a proxy that automatically waits for the instance to be ready\n   * before delegating to the actual property\n   */\n  private createReadyProxy<T extends object>(\n    propertyName: \"events\" | \"video\",\n  ): T {\n    return new Proxy({} as T, {\n      get: (_target, prop: string) => {\n        // biome-ignore lint/suspicious/noExplicitAny: Dynamic method signature unknown at compile time\n        return (...args: any[]) => {\n          return this.ready.then(() => {\n            // biome-ignore lint/suspicious/noExplicitAny: Dynamic property access requires any\n            const method = (this.instance?.[propertyName] as any)?.[prop];\n            if (typeof method === \"function\") {\n              return method(...args);\n            }\n            return method;\n          });\n        };\n      },\n    }) as T;\n  }\n\n  get events() {\n    // Cache proxy to avoid creating new Proxy object on every access\n    if (!this.#eventsProxy) {\n      this.#eventsProxy =\n        this.createReadyProxy<TapKitInstance[\"events\"]>(\"events\");\n    }\n    return this.#eventsProxy;\n  }\n\n  get isOpen(): boolean {\n    return this.instance?.isOpen ?? false;\n  }\n\n  get isInitialized(): boolean {\n    return this.instance?.isInitialized ?? false;\n  }\n\n  get video() {\n    // Cache proxy to avoid creating new Proxy object on every access\n    if (!this.#videoProxy) {\n      this.#videoProxy =\n        this.createReadyProxy<TapKitInstance[\"video\"]>(\"video\");\n    }\n    return this.#videoProxy;\n  }\n\n  async init(params: TapKitInitParams): Promise<() => void> {\n    await this.#loading;\n    if (!this.instance) {\n      throw new Error(\"TapKit instance not available after loading\");\n    }\n    return await this.instance.init(params);\n  }\n\n  destroy(): void {\n    if (this.instance) {\n      this.instance.destroy();\n      this.instance = null;\n    }\n    // Clear proxy references to prevent memory leaks\n    this.#eventsProxy = undefined;\n    this.#videoProxy = undefined;\n  }\n\n  show(): void {\n    if (this.instance) {\n      this.instance.show();\n    }\n  }\n\n  hide(): void {\n    if (this.instance) {\n      this.instance.hide();\n    }\n  }\n\n  get [Symbol.toStringTag]() {\n    return \"TapKit\";\n  }\n}\n"]}

package/dist/react.d.cts

@@ -1,87 +1,277 @@
-import { TapKitInstance, TapKitInitParams, TapKitConfig, TapButtonAttributes } from '@coxwave/tap-kit-types';
+import { TapKitElement, TapKitConfig } from '@coxwave/tap-kit-types';
+import React$1 from 'react';
 
-interface UseTapKitReturn {
-    /** TapKit instance */
-    kit: TapKitInstance | null;
-    /** Whether TapKit is ready to use */
-    isReady: boolean;
-    /** Error that occurred during loading */
-    error: Error | null;
-    /** Setup TapKit with given parameters (button, course info, etc.) */
-    setup: (params: TapKitInitParams) => Promise<() => void>;
-}
 /**
- * 🌟 TapKit을 React에서 사용하기 위한 핵심 Hook
+ * React-specific type definitions for TapKit
  *
- * useSyncExternalStore를 활용하여 TapKit 인스턴스를 관리합니다.
- * 같은 apiKey로 여러 컴포넌트에서 호출해도 동일한 인스턴스를 공유합니다.
+ * Defines event handler types and control patterns for React integration.
+ */
+
+/**
+ * Event handler type definitions for TapKit Web Component
  *
- * **Note for Next.js App Router users:**
- * Make sure to add 'use client' at the top of your component file when using this hook.
+ * Maps CustomEvent types to React callback signatures.
+ */
+interface TapKitEventHandlers {
+    /**
+     * Called when TapKit SDK is ready
+     * @example onReady={() => console.log('TapKit ready!')}
+     */
+    onReady?: () => void;
+    /**
+     * Called when initialization or runtime error occurs
+     * @example onError={(error) => console.error('TapKit error:', error)}
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Called when timeline seek event occurs
+     * @example onTimelineSeek={(clipPlayHead, clipId) => console.log('Seek:', clipPlayHead)}
+     */
+    onTimelineSeek?: (clipPlayHead: number, clipId: string) => void;
+    /**
+     * Called when alarm fade-in occurs
+     * @example onAlarmFadeIn={(messageInfo) => console.log('Alarm:', messageInfo)}
+     */
+    onAlarmFadeIn?: (messageInfo: unknown) => void;
+}
+/**
+ * Control object pattern for managing TapKit instance
  *
- * @param config - TapKit 설정 (apiKey 등)
- * @returns TapKit 인스턴스, 로딩 상태, 에러 정보, 설정 함수
+ * Separates instance management (setInstance) from configuration (options)
+ * and event handling (handlers). Inspired by ChatKit's control pattern.
  *
  * @example
  * ```tsx
- * 'use client'; // Add this for Next.js App Router
- *
- * import { useEffect } from 'react';
- * import { useTapKit } from '@coxwave/tap-kit/react';
+ * const tapkit = useTapKit({ apiKey: 'key', onReady: () => {} });
+ * <TapKit control={tapkit.control} />
+ * ```
+ */
+interface TapKitControl<T> {
+    /**
+     * Set the TapKit element instance reference
+     *
+     * Called by TapKit component to register the element instance.
+     * Enables imperative control via useTapKit methods.
+     */
+    setInstance: (instance: TapKitElement | null) => void;
+    /**
+     * Configuration options (non-function values)
+     *
+     * All options except event handlers.
+     */
+    options: T;
+    /**
+     * Event handler callbacks (function values)
+     *
+     * Separated from options for easier event listener management.
+     */
+    handlers: TapKitEventHandlers;
+}
+
+/**
+ * TapKit React Component
  *
- * function MyComponent() {
- *   const { kit, isReady, error, setup } = useTapKit({
- *     apiKey: 'your-api-key',
- *   });
+ * Declarative React wrapper for <tap-kit> Web Component.
+ * Use this with useTapKit hook for a clean separation of control and rendering.
  *
- *   useEffect(() => {
- *     if (isReady) {
- *       setup({
- *         buttonId: 'tap-button',
- *         course: {
- *           userId: 'user-123',
- *           courseId: 'course-456',
- *           clipId: 'clip-789',
- *         },
- *       });
- *     }
- *   }, [isReady, setup]);
+ * @example
+ * ```tsx
+ * 'use client';
  *
- *   if (error) {
- *     return <div>에러 발생: {error.message}</div>;
- *   }
+ * import { TapKit, useTapKit } from '@coxwave/tap-kit/react';
  *
- *   if (!isReady) {
- *     return <div>TapKit 로딩 중...</div>;
- *   }
+ * function MyApp() {
+ *   const tapkit = useTapKit({
+ *     apiKey: 'your-key',
+ *     userId: 'user-123',
+ *     courseId: 'course-456',
+ *     clipId: 'clip-789',
+ *     onReady: () => console.log('TapKit ready!'),
+ *     onError: (error) => console.error('Error:', error),
+ *   });
  *
- *   return <div id="tap-button">AI 튜터</div>;
+ *   return (
+ *     <div>
+ *       <button onClick={tapkit.show} disabled={!tapkit.isReady}>
+ *         Show Chat
+ *       </button>
+ *       <TapKit control={tapkit.control} style={{ height: '600px' }} />
+ *     </div>
+ *   );
  * }
  * ```
- */
-declare function useTapKit(config: TapKitConfig): UseTapKitReturn;
-
-/**
- * TapKit React Integration
- *
- * React 앱에서 TapKit을 쉽게 사용할 수 있는 Hook을 제공합니다.
- *
- * useTapKit은 useSyncExternalStore를 활용하여 전역 store를 관리합니다.
- * 같은 apiKey로 여러 컴포넌트에서 호출하면 자동으로 같은 인스턴스를 공유합니다.
  *
  * **Note for Next.js App Router users:**
- * If you're using this in a Next.js App Router project with Server Components,
- * make sure to add 'use client' at the top of your component file that imports this hook.
+ * Make sure to add 'use client' at the top of your component file.
  *
  * @see https://edutap-ai-docs.vercel.app/docs/guides/react
  */
 
+/**
+ * Props for TapKit React component
+ */
+interface TapKitProps extends Omit<React$1.HTMLAttributes<TapKitElement>, "children" | "dangerouslySetInnerHTML"> {
+    /**
+     * Control object from useTapKit hook
+     *
+     * Provides instance management, configuration, and event handlers.
+     */
+    control: TapKitControl<any>;
+    /**
+     * Custom container element ID (optional)
+     *
+     * If provided, TapKit will use this element as container.
+     */
+    containerId?: string;
+}
 declare global {
     namespace JSX {
         interface IntrinsicElements {
-            "tap-button": TapButtonAttributes;
+            "tap-kit": React$1.DetailedHTMLProps<React$1.HTMLAttributes<TapKitElement>, TapKitElement> & {
+                "api-key"?: string;
+                "user-id"?: string;
+                "course-id"?: string;
+                "clip-id"?: string;
+                "clip-play-head"?: number;
+                language?: "ko" | "en";
+                "button-id"?: string;
+                "container-id"?: string;
+                mode?: "inline" | "floating" | "sidebar";
+                debug?: boolean;
+                "tap-url"?: string;
+                "api-url"?: string;
+                environment?: "dev" | "prod" | "staging" | "demo";
+            };
         }
     }
 }
+/**
+ * TapKit React Component
+ *
+ * Renders <tap-kit> Web Component with React integration.
+ * Automatically manages instance lifecycle and event listeners.
+ *
+ * **Ref Access**: The forwarded ref provides direct access to the TapKitElement:
+ * ```tsx
+ * const tapkitRef = useRef<TapKitElement>(null);
+ * <TapKit ref={tapkitRef} control={...} />
+ * // tapkitRef.current?.show()
+ * ```
+ */
+declare const TapKit: React$1.ForwardRefExoticComponent<TapKitProps & React$1.RefAttributes<TapKitElement>>;
+
+/**
+ * useTapKit Hook - Advanced imperative control of TapKit Web Component
+ *
+ * This hook provides direct access to the TapKitElement instance and full
+ * control over its lifecycle. Use this when you need:
+ * - Direct element manipulation
+ * - Custom rendering logic
+ * - Imperative control over Web Component behavior
+ *
+ * For most use cases, prefer the `<TapKit />` component which provides a
+ * simpler declarative API.
+ *
+ * @param options - TapKit configuration
+ * @returns Object with element reference, state, and control methods
+ *
+ * @example Advanced control with custom rendering
+ * ```tsx
+ * 'use client';
+ *
+ * import { useTapKit } from '@coxwave/tap-kit/react';
+ *
+ * function MyComponent() {
+ *   const { element, elementRef, show, hide, isReady, error } = useTapKit({
+ *     apiKey: 'your-key',
+ *     userId: 'user-123',
+ *     courseId: 'course-456',
+ *     clipId: 'clip-789',
+ *   });
+ *
+ *   // Direct element access for advanced operations
+ *   useEffect(() => {
+ *     if (element) {
+ *       // Direct manipulation of TapKitElement
+ *       console.log('Element mounted:', element);
+ *     }
+ *   }, [element]);
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={show} disabled={!isReady}>Show Chat</button>
+ *       <button onClick={hide}>Hide Chat</button>
+ *       {error && <p>Error: {error.message}</p>}
+ *       <div ref={elementRef} /> // Container for Web Component
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @see TapKit - Use this component for simpler declarative API
+ */
+
+interface UseTapKitOptions extends TapKitConfig, TapKitEventHandlers {
+    /** User ID */
+    userId?: string;
+    /** Course ID */
+    courseId?: string;
+    /** Clip ID */
+    clipId?: string;
+    /** Clip playhead position */
+    clipPlayHead?: number;
+    /** Language */
+    language?: "ko" | "en";
+    /** Custom button element ID */
+    buttonId?: string;
+    /** Display mode */
+    mode?: "inline" | "floating" | "sidebar";
+    /** Debug mode */
+    debug?: boolean;
+    /** TAP Frontend URL */
+    tapUrl?: string;
+    /** API Backend URL */
+    apiUrl?: string;
+    /** Environment */
+    environment?: "dev" | "prod" | "staging" | "demo";
+}
+/**
+ * Configuration options type (non-function values)
+ */
+type TapKitOptions = Omit<UseTapKitOptions, keyof TapKitEventHandlers>;
+interface UseTapKitReturn {
+    /** Web Component element reference */
+    element: TapKitElement | null;
+    /** Ref object for direct element access */
+    ref: React.RefObject<TapKitElement | null>;
+    /** Container ref to attach element */
+    elementRef: React.RefCallback<HTMLDivElement>;
+    /** Control object for TapKit component */
+    control: TapKitControl<TapKitOptions>;
+    /** Whether TapKit is ready */
+    isReady: boolean;
+    /** Error during initialization */
+    error: Error | null;
+    /** Show chat interface */
+    show: () => void;
+    /** Hide chat interface */
+    hide: () => void;
+    /** Set course information */
+    setCourse: (course: {
+        courseId: string;
+        clipId: string;
+        userId?: string;
+        clipPlayHead?: number;
+    }) => void;
+}
+/**
+ * Hook for managing TapKit Web Component
+ *
+ * Automatically loads CDN, creates Web Component, and provides control methods.
+ *
+ * @param options - TapKit configuration with event handlers
+ * @returns Methods to control TapKit instance and control object
+ */
+declare function useTapKit(options: UseTapKitOptions): UseTapKitReturn;
 
-export { type UseTapKitReturn, useTapKit };
+export { TapKit, type TapKitControl, type TapKitEventHandlers, type TapKitProps, type UseTapKitOptions, type UseTapKitReturn, useTapKit };