npm - @coxwave/tap-kit - Versions diffs - 1.0.0 - Mend

@coxwave/tap-kit 1.0.0

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.

Files changed (14) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,205 @@
+# @coxwave/tap-kit
+> EduTAP AI 튜터를 웹사이트에 통합하기 위한 공식 SDK
+## 특징
+- ✅ **React 우선 지원** - `useTapKit` hook으로 간편한 통합
+- ✅ **타입 안전** - 완전한 TypeScript 지원
+- ✅ **경량** - 스마트한 CDN 로딩
+- ✅ **쉬운 마이그레이션** - tap-sdk와 100% API 호환
+## 설치
+```bash
+npm install @coxwave/tap-kit
+```
+## React에서 사용하기 (권장)
+`useTapKit` hook과 `<tap-button>` 웹 컴포넌트를 사용하면 React 앱에 TapKit을 쉽게 통합할 수 있습니다:
+```tsx
+import { useEffect } from 'react';
+import { useTapKit } from '@coxwave/tap-kit/react';
+function App() {
+  const { kit, isReady, error, init } = useTapKit({
+    apiKey: 'your-api-key',
+  });
+  useEffect(() => {
+    if (isReady) {
+      init({
+        course: {
+          userId: 'user-123',
+          courseId: 'course-456',
+          clipId: 'clip-789',
+        },
+      });
+    }
+  }, [isReady, init]);
+  if (error) {
+    return <div>에러 발생: {error.message}</div>;
+  }
+  if (!isReady) {
+    return <div>TapKit 로딩 중...</div>;
+  }
+  return <tap-button />;
+}
+```
+> **💡 Tip**: `<tap-button>`은 자체 스타일이 적용된 웹 컴포넌트입니다. `position`, `size` 등의 속성으로 커스터마이징할 수 있습니다.
+>
+> ```tsx
+> <tap-button position="bottom-left" size="large" />
+> ```
+## Vanilla JS에서 사용하기
+먼저 HTML에 `<tap-button>` 웹 컴포넌트를 추가하세요:
+```html
+<!DOCTYPE html>
+<html>
+<body>
+  <!-- TapKit 버튼 -->
+  <tap-button></tap-button>
+  <script type="module">
+    import TapKit from '@coxwave/tap-kit';
+    const kit = new TapKit({
+      apiKey: 'your-api-key',
+    });
+    await kit.init({
+      course: {
+        userId: 'user-123',
+        courseId: 'course-456',
+        clipId: 'clip-789',
+      },
+    });
+  </script>
+</body>
+</html>
+```
+## CDN에서 사용하기
+```html
+<!DOCTYPE html>
+<html>
+<body>
+  <!-- TapKit 버튼 -->
+  <tap-button></tap-button>
+  <script type="module">
+    import TapKit from 'https://cdn.jsdelivr.net/npm/@coxwave/tap-kit/+esm';
+    const kit = new TapKit({ apiKey: 'your-api-key' });
+    await kit.init({
+      course: {
+        userId: 'user-123',
+        courseId: 'course-456',
+        clipId: 'clip-789',
+      },
+    });
+  </script>
+</body>
+</html>
+```
+## 커스텀 버튼 사용하기
+`<tap-button>` 대신 직접 만든 버튼을 사용하려면 `buttonId` 옵션을 사용하세요:
+```tsx
+// React
+function App() {
+  const { init, isReady } = useTapKit({ apiKey: 'your-api-key' });
+  useEffect(() => {
+    if (isReady) {
+      init({
+        buttonId: 'my-custom-button', // 커스텀 버튼 ID
+        course: { ... },
+      });
+    }
+  }, [isReady, init]);
+  return <button id="my-custom-button">AI 튜터 열기</button>;
+}
+```
+```javascript
+// Vanilla JS
+await kit.init({
+  buttonId: 'my-custom-button',
+  course: { ... },
+});
+```
+## API Reference
+### useTapKit(config)
+TapKit 인스턴스를 생성하고 관리하는 React Hook입니다.
+**Parameters:**
+- `config: TapKitConfig` - API 키 등 설정 객체
+**Returns:**
+- `kit: TapKitInstance | null` - TapKit 인스턴스
+- `isReady: boolean` - 로딩 완료 여부
+- `error: Error | null` - 에러 객체
+- `init: (params) => Promise<() => void>` - 초기화 함수
+### TapKitProvider (선택적)
+여러 컴포넌트에서 같은 TapKit 인스턴스를 공유하려면 Context Provider를 사용하세요:
+```tsx
+import { TapKitProvider, useTapKitContext } from '@coxwave/tap-kit/react';
+function App() {
+  return (
+    <TapKitProvider config={{ apiKey: 'your-key' }}>
+      <YourApp />
+    </TapKitProvider>
+  );
+}
+function ChildComponent() {
+  const { kit, isReady } = useTapKitContext();
+  // ...
+}
+```
+## 문서
+- [전체 문서](https://edutap-ai-docs.vercel.app)
+- [React 가이드](https://edutap-ai-docs.vercel.app/docs/guides/react)
+- [API Reference](https://edutap-ai-docs.vercel.app/docs/api-reference)
+- [tap-sdk 마이그레이션](https://edutap-ai-docs.vercel.app/docs/migration/tap-sdk-to-tap-kit)
+## tap-sdk에서 마이그레이션
+기존 `@coxwave/tap-sdk`를 사용 중이라면:
+```diff
+- import TapSDK from '@coxwave/tap-sdk';
++ import TapKit from '@coxwave/tap-kit';
+- const sdk = new TapSDK({ apiKey: '...' });
++ const kit = new TapKit({ apiKey: '...' });
+```
+API는 100% 호환됩니다! 자세한 내용은 [마이그레이션 가이드](https://edutap-ai-docs.vercel.app/docs/migration/tap-sdk-to-tap-kit)를 참고하세요.
+## License
+MIT

package/dist/index.d.cts ADDED Viewed

@@ -0,0 +1,55 @@
+import * as _coxwave_tap_kit_types from '@coxwave/tap-kit-types';
+import { TapKitInstance, TapKitConfig, TapKitInitParams, TAPKIT_CONFIG_SYMBOL as TAPKIT_CONFIG_SYMBOL$1, TapKitConfigOptions } from '@coxwave/tap-kit-types';
+export { AlarmMessageInstanceType, AlarmType, ContainerConfig, ContainerMode, Course, ITapButtonElement, PositionType, SeekTimelineParamsType, TapButtonAttributes, TapKitConfig, TapKitConfigOptions, TapKitConstructor, TapKitInitParams, TapKitInstance } from '@coxwave/tap-kit-types';
+/** @internal Symbol for internal configuration method */
+declare const TAPKIT_CONFIG_SYMBOL: typeof TAPKIT_CONFIG_SYMBOL$1;
+/**
+ * TapKit - Official TapKit Web SDK
+ *
+ * @example
+ * ```typescript
+ * import TapKit from "@coxwave/tap-kit";
+ *
+ * const kit = new TapKit({ apiKey: 'your-api-key' });
+ *
+ * await kit.init({
+ *   buttonId: 'tap-button',
+ *   course: {
+ *     userId: 'user-123',
+ *     courseId: 'course-456',
+ *     clipId: 'clip-789',
+ *   },
+ *   container: {
+ *     position: { top: '64px', right: '32px' },
+ *     width: '360px',
+ *     height: 'calc(100% - 128px)',
+ *   },
+ * });
+ * ```
+ */
+declare class TapKit implements TapKitInstance {
+    #private;
+    private instance;
+    private pendingConfig?;
+    constructor(config: TapKitConfig);
+    private load;
+    get ready(): Promise<void>;
+    get events(): {
+        seekTimeline: (params: _coxwave_tap_kit_types.SeekTimelineParamsType) => void;
+        onTimelineSeek: (callback: (clipPlayHead: number, clipId: string) => void) => () => void;
+        onAlarmFadeIn: (handler: (messageInfo: _coxwave_tap_kit_types.AlarmMessageInstanceType) => void) => () => void;
+    };
+    get isOpen(): boolean;
+    get isInitialized(): boolean;
+    get video(): {
+        bind: (config: _coxwave_tap_kit_types.VideoPlayerConfig, clipId: string) => void;
+        unbind: () => void;
+    };
+    init(params: TapKitInitParams): Promise<() => void>;
+    destroy(): void;
+    [TAPKIT_CONFIG_SYMBOL](options: TapKitConfigOptions): void;
+    get [Symbol.toStringTag](): string;
+}
+export { TAPKIT_CONFIG_SYMBOL, TapKit as default };

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,55 @@
+import * as _coxwave_tap_kit_types from '@coxwave/tap-kit-types';
+import { TapKitInstance, TapKitConfig, TapKitInitParams, TAPKIT_CONFIG_SYMBOL as TAPKIT_CONFIG_SYMBOL$1, TapKitConfigOptions } from '@coxwave/tap-kit-types';
+export { AlarmMessageInstanceType, AlarmType, ContainerConfig, ContainerMode, Course, ITapButtonElement, PositionType, SeekTimelineParamsType, TapButtonAttributes, TapKitConfig, TapKitConfigOptions, TapKitConstructor, TapKitInitParams, TapKitInstance } from '@coxwave/tap-kit-types';
+/** @internal Symbol for internal configuration method */
+declare const TAPKIT_CONFIG_SYMBOL: typeof TAPKIT_CONFIG_SYMBOL$1;
+/**
+ * TapKit - Official TapKit Web SDK
+ *
+ * @example
+ * ```typescript
+ * import TapKit from "@coxwave/tap-kit";
+ *
+ * const kit = new TapKit({ apiKey: 'your-api-key' });
+ *
+ * await kit.init({
+ *   buttonId: 'tap-button',
+ *   course: {
+ *     userId: 'user-123',
+ *     courseId: 'course-456',
+ *     clipId: 'clip-789',
+ *   },
+ *   container: {
+ *     position: { top: '64px', right: '32px' },
+ *     width: '360px',
+ *     height: 'calc(100% - 128px)',
+ *   },
+ * });
+ * ```
+ */
+declare class TapKit implements TapKitInstance {
+    #private;
+    private instance;
+    private pendingConfig?;
+    constructor(config: TapKitConfig);
+    private load;
+    get ready(): Promise<void>;
+    get events(): {
+        seekTimeline: (params: _coxwave_tap_kit_types.SeekTimelineParamsType) => void;
+        onTimelineSeek: (callback: (clipPlayHead: number, clipId: string) => void) => () => void;
+        onAlarmFadeIn: (handler: (messageInfo: _coxwave_tap_kit_types.AlarmMessageInstanceType) => void) => () => void;
+    };
+    get isOpen(): boolean;
+    get isInitialized(): boolean;
+    get video(): {
+        bind: (config: _coxwave_tap_kit_types.VideoPlayerConfig, clipId: string) => void;
+        unbind: () => void;
+    };
+    init(params: TapKitInitParams): Promise<() => void>;
+    destroy(): void;
+    [TAPKIT_CONFIG_SYMBOL](options: TapKitConfigOptions): void;
+    get [Symbol.toStringTag](): string;
+}
+export { TAPKIT_CONFIG_SYMBOL, TapKit as default };

package/dist/index.js ADDED Viewed

@@ -0,0 +1,3 @@
+'use strict';Object.defineProperty(exports,'__esModule',{value:true});var h=Object.defineProperty;var A=e=>{throw TypeError(e)};var I=(e,n,t)=>n in e?h(e,n,{enumerable:true,configurable:true,writable:true,value:t}):e[n]=t;var f=(e,n,t)=>I(e,typeof n!="symbol"?n+"":n,t),K=(e,n,t)=>n.has(e)||A("Cannot "+t);var r=(e,n,t)=>(K(e,n,"read from private field"),t?t.call(e):n.get(e)),l=(e,n,t)=>n.has(e)?A("Cannot add the same private member more than once"):n instanceof WeakSet?n.add(e):n.set(e,t),p=(e,n,t,i)=>(K(e,n,"write to private field"),n.set(e,t),t);var O="https://files.edutap.ai/tap-sdk/loader.js";function g(){return window?.__TAP_KIT_LOADER_URL__?window.__TAP_KIT_LOADER_URL__:O}function C(){return typeof window<"u"&&!!window.__TAP_KIT_CORE_URL__}function m(){return window.__TAP_KIT_CORE_URL__||""}function D(e,n,t){let i=Date.now(),o=()=>{if(window.TapKit&&window.TapKitLoaded===true){window.__TAP_KIT_LOADER_LOADED__=true,window.__TAP_KIT_LOADER_LOADING__=void 0,e();return}if(Date.now()-i>t){window.__TAP_KIT_LOADER_LOADING__=void 0,n(new Error(`TapKit loader timeout: SDK not available after ${t}ms`));return}typeof requestIdleCallback<"u"?requestIdleCallback(o,{timeout:500}):setTimeout(o,500);};return o}function E(e=4e3){if(window.__TAP_KIT_LOADER_LOADED__&&window.TapKit)return Promise.resolve();if(window.__TAP_KIT_LOADER_LOADING__)return window.__TAP_KIT_LOADER_LOADING__;let n=new Promise((t,i)=>{if(typeof document>"u"){i(new Error("TapKit requires browser environment (document is undefined)"));return}if(C()){let T=m(),d=document.createElement("script");d.src=T,d.async=true,d.onload=()=>{window.TapKit?(window.TapKitLoaded=true,window.__TAP_KIT_LOADER_LOADED__=true,window.__TAP_KIT_LOADER_LOADING__=void 0,t()):(window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error("TapKit not available after loading local core")));},d.onerror=()=>{window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error(`Failed to load local TapKit core: ${T}`));},document.head.appendChild(d);return}let o=g(),_=document.createElement("script");_.src=o,_.async=true,_.onload=()=>{D(t,i,e)();},_.onerror=()=>{window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error(`Failed to load TapKit CDN loader: ${o}`));};let w=document.querySelector(`script[src="${o}"]`);w?(w.addEventListener("load",()=>{D(t,i,e)();}),w.addEventListener("error",()=>i(new Error(`Failed to load TapKit CDN loader: ${o}`)))):document.head.appendChild(_);});return window.__TAP_KIT_LOADER_LOADING__=n,n}var u=Symbol.for("tapkit.config"),s,c,a,L=class{constructor(n){f(this,"instance",null);l(this,s);l(this,c);l(this,a,null);f(this,"pendingConfig");p(this,c,n),p(this,s,this.load());}async load(){try{if(await E(),!window.TapKit)throw new Error("TapKit not available after loading CDN loader");this.instance=new window.TapKit(r(this,c)),this.pendingConfig&&(this.instance[u]?.(this.pendingConfig),this.pendingConfig=void 0);}catch(n){throw p(this,a,n instanceof Error?n:new Error(String(n))),r(this,a)}}get ready(){return r(this,s).then(()=>{if(r(this,a))throw r(this,a);if(!this.instance)throw new Error("TapKit instance not initialized. Check console for errors.");return this.instance.ready})}get events(){return new Proxy({},{get:(n,t)=>(...i)=>this.ready.then(()=>{let o=(this.instance?.events)[t];return typeof o=="function"?o(...i):o})})}get isOpen(){return this.instance?.isOpen??false}get isInitialized(){return this.instance?.isInitialized??false}get video(){return new Proxy({},{get:(n,t)=>(...i)=>this.ready.then(()=>{let o=(this.instance?.video)[t];return typeof o=="function"?o(...i):o})})}async init(n){if(await r(this,s),!this.instance)throw new Error("TapKit instance not available after loading");return await this.instance.init(n)}destroy(){this.instance&&(this.instance.destroy(),this.instance=null);}[u](n){if(!this.instance){this.pendingConfig=n;return}this.instance[u]?.(n);}get[Symbol.toStringTag](){return "TapKit"}};s=new WeakMap,c=new WeakMap,a=new WeakMap;
+exports.TAPKIT_CONFIG_SYMBOL=u;exports.default=L;//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +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","TapKit","config","__publicField","__privateAdd","__privateSet","__privateGet","err","_target","prop","args","method","params","options"],"mappings":"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","file":"index.js","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__ ? window.__TAP_KIT_LOADER_URL__ : 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(new Error(`TapKit loader timeout: SDK not available after ${timeoutMs}ms`));\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(timeoutMs: number = DEFAULT_TIMEOUT_MS): 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(new Error(\"TapKit requires browser environment (document is undefined)\"));\n return;\n }\n\n // Local core mode: Load IIFE directly\n if (isLocalCoreMode()) {\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 */\n// biome-ignore lint/suspicious/noExplicitAny: Symbol type casting required for compatibility\nconst TAPKIT_CONFIG_SYMBOL: typeof TAPKIT_CONFIG_SYMBOL_TYPE = 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\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 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(\"TapKit instance not initialized. Check console for errors.\");\n }\n return this.instance.ready;\n });\n }\n\n get events() {\n // Proxy pattern: automatically wait for ready when calling methods\n return 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\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 // Proxy pattern: automatically wait for ready when calling methods\n return 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\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"]}

package/dist/index.mjs ADDED Viewed

@@ -0,0 +1,3 @@
+var h=Object.defineProperty;var A=e=>{throw TypeError(e)};var I=(e,n,t)=>n in e?h(e,n,{enumerable:true,configurable:true,writable:true,value:t}):e[n]=t;var f=(e,n,t)=>I(e,typeof n!="symbol"?n+"":n,t),K=(e,n,t)=>n.has(e)||A("Cannot "+t);var r=(e,n,t)=>(K(e,n,"read from private field"),t?t.call(e):n.get(e)),l=(e,n,t)=>n.has(e)?A("Cannot add the same private member more than once"):n instanceof WeakSet?n.add(e):n.set(e,t),p=(e,n,t,i)=>(K(e,n,"write to private field"),n.set(e,t),t);var O="https://files.edutap.ai/tap-sdk/loader.js";function g(){return window?.__TAP_KIT_LOADER_URL__?window.__TAP_KIT_LOADER_URL__:O}function C(){return typeof window<"u"&&!!window.__TAP_KIT_CORE_URL__}function m(){return window.__TAP_KIT_CORE_URL__||""}function D(e,n,t){let i=Date.now(),o=()=>{if(window.TapKit&&window.TapKitLoaded===true){window.__TAP_KIT_LOADER_LOADED__=true,window.__TAP_KIT_LOADER_LOADING__=void 0,e();return}if(Date.now()-i>t){window.__TAP_KIT_LOADER_LOADING__=void 0,n(new Error(`TapKit loader timeout: SDK not available after ${t}ms`));return}typeof requestIdleCallback<"u"?requestIdleCallback(o,{timeout:500}):setTimeout(o,500);};return o}function E(e=4e3){if(window.__TAP_KIT_LOADER_LOADED__&&window.TapKit)return Promise.resolve();if(window.__TAP_KIT_LOADER_LOADING__)return window.__TAP_KIT_LOADER_LOADING__;let n=new Promise((t,i)=>{if(typeof document>"u"){i(new Error("TapKit requires browser environment (document is undefined)"));return}if(C()){let T=m(),d=document.createElement("script");d.src=T,d.async=true,d.onload=()=>{window.TapKit?(window.TapKitLoaded=true,window.__TAP_KIT_LOADER_LOADED__=true,window.__TAP_KIT_LOADER_LOADING__=void 0,t()):(window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error("TapKit not available after loading local core")));},d.onerror=()=>{window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error(`Failed to load local TapKit core: ${T}`));},document.head.appendChild(d);return}let o=g(),_=document.createElement("script");_.src=o,_.async=true,_.onload=()=>{D(t,i,e)();},_.onerror=()=>{window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error(`Failed to load TapKit CDN loader: ${o}`));};let w=document.querySelector(`script[src="${o}"]`);w?(w.addEventListener("load",()=>{D(t,i,e)();}),w.addEventListener("error",()=>i(new Error(`Failed to load TapKit CDN loader: ${o}`)))):document.head.appendChild(_);});return window.__TAP_KIT_LOADER_LOADING__=n,n}var u=Symbol.for("tapkit.config"),s,c,a,L=class{constructor(n){f(this,"instance",null);l(this,s);l(this,c);l(this,a,null);f(this,"pendingConfig");p(this,c,n),p(this,s,this.load());}async load(){try{if(await E(),!window.TapKit)throw new Error("TapKit not available after loading CDN loader");this.instance=new window.TapKit(r(this,c)),this.pendingConfig&&(this.instance[u]?.(this.pendingConfig),this.pendingConfig=void 0);}catch(n){throw p(this,a,n instanceof Error?n:new Error(String(n))),r(this,a)}}get ready(){return r(this,s).then(()=>{if(r(this,a))throw r(this,a);if(!this.instance)throw new Error("TapKit instance not initialized. Check console for errors.");return this.instance.ready})}get events(){return new Proxy({},{get:(n,t)=>(...i)=>this.ready.then(()=>{let o=(this.instance?.events)[t];return typeof o=="function"?o(...i):o})})}get isOpen(){return this.instance?.isOpen??false}get isInitialized(){return this.instance?.isInitialized??false}get video(){return new Proxy({},{get:(n,t)=>(...i)=>this.ready.then(()=>{let o=(this.instance?.video)[t];return typeof o=="function"?o(...i):o})})}async init(n){if(await r(this,s),!this.instance)throw new Error("TapKit instance not available after loading");return await this.instance.init(n)}destroy(){this.instance&&(this.instance.destroy(),this.instance=null);}[u](n){if(!this.instance){this.pendingConfig=n;return}this.instance[u]?.(n);}get[Symbol.toStringTag](){return "TapKit"}};s=new WeakMap,c=new WeakMap,a=new WeakMap;
+export{u as TAPKIT_CONFIG_SYMBOL,L as default};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map ADDED Viewed

@@ -0,0 +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","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__ ? window.__TAP_KIT_LOADER_URL__ : 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(new Error(`TapKit loader timeout: SDK not available after ${timeoutMs}ms`));\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(timeoutMs: number = DEFAULT_TIMEOUT_MS): 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(new Error(\"TapKit requires browser environment (document is undefined)\"));\n return;\n }\n\n // Local core mode: Load IIFE directly\n if (isLocalCoreMode()) {\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 */\n// biome-ignore lint/suspicious/noExplicitAny: Symbol type casting required for compatibility\nconst TAPKIT_CONFIG_SYMBOL: typeof TAPKIT_CONFIG_SYMBOL_TYPE = 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\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 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(\"TapKit instance not initialized. Check console for errors.\");\n }\n return this.instance.ready;\n });\n }\n\n get events() {\n // Proxy pattern: automatically wait for ready when calling methods\n return 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\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 // Proxy pattern: automatically wait for ready when calling methods\n return 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\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"]}

package/dist/react.d.cts ADDED Viewed

@@ -0,0 +1,116 @@
+import { TapKitConfig, TapKitInstance, TapKitInitParams } from '@coxwave/tap-kit-types';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } 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
+ *
+ * useSyncExternalStore를 활용하여 TapKit 인스턴스를 관리합니다.
+ * 같은 apiKey로 여러 컴포넌트에서 호출해도 동일한 인스턴스를 공유합니다.
+ *
+ * @param config - TapKit 설정 (apiKey 등)
+ * @returns TapKit 인스턴스, 로딩 상태, 에러 정보, 설정 함수
+ *
+ * @example
+ * ```tsx
+ * import { useEffect } from 'react';
+ * import { useTapKit } from '@coxwave/tap-kit/react';
+ *
+ * function MyComponent() {
+ *   const { kit, isReady, error, setup } = useTapKit({
+ *     apiKey: 'your-api-key',
+ *   });
+ *
+ *   useEffect(() => {
+ *     if (isReady) {
+ *       setup({
+ *         buttonId: 'tap-button',
+ *         course: {
+ *           userId: 'user-123',
+ *           courseId: 'course-456',
+ *           clipId: 'clip-789',
+ *         },
+ *       });
+ *     }
+ *   }, [isReady, setup]);
+ *
+ *   if (error) {
+ *     return <div>에러 발생: {error.message}</div>;
+ *   }
+ *
+ *   if (!isReady) {
+ *     return <div>TapKit 로딩 중...</div>;
+ *   }
+ *
+ *   return <div id="tap-button">AI 튜터</div>;
+ * }
+ * ```
+ */
+declare function useTapKit(config: TapKitConfig): UseTapKitReturn;
+interface TapKitContextValue extends UseTapKitReturn {
+}
+interface TapKitProviderProps {
+    /** TapKit configuration */
+    config: TapKitConfig;
+    /** React children */
+    children: ReactNode;
+}
+/**
+ * TapKit Context Provider
+ *
+ * 여러 컴포넌트에서 같은 TapKit 인스턴스를 공유하려면 이 Provider를 사용하세요.
+ * Provider 하위의 모든 컴포넌트에서 useTapKitContext()로 접근할 수 있습니다.
+ *
+ * @param props - Provider props
+ * @param props.config - TapKit 설정 (apiKey 등)
+ * @param props.children - React children
+ *
+ * @example
+ * ```tsx
+ * import { TapKitProvider } from '@coxwave/tap-kit/react';
+ *
+ * function App() {
+ *   return (
+ *     <TapKitProvider config={{ apiKey: 'your-key' }}>
+ *       <YourApp />
+ *     </TapKitProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function TapKitProvider({ config, children }: TapKitProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * TapKit Context에 접근하는 Hook
+ *
+ * TapKitProvider 하위에서만 사용할 수 있습니다.
+ * Provider 없이 사용하면 에러가 발생합니다.
+ *
+ * @returns TapKit context value (kit, isReady, error, init)
+ * @throws {Error} TapKitProvider 외부에서 사용한 경우
+ *
+ * @example
+ * ```tsx
+ * import { useTapKitContext } from '@coxwave/tap-kit/react';
+ *
+ * function MyComponent() {
+ *   const { kit, isReady, init } = useTapKitContext();
+ *
+ *   // ...
+ * }
+ * ```
+ */
+declare function useTapKitContext(): TapKitContextValue;
+export { type TapKitContextValue, TapKitProvider, type TapKitProviderProps, type UseTapKitReturn, useTapKit, useTapKitContext };

package/dist/react.d.ts ADDED Viewed

@@ -0,0 +1,116 @@
+import { TapKitConfig, TapKitInstance, TapKitInitParams } from '@coxwave/tap-kit-types';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } 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
+ *
+ * useSyncExternalStore를 활용하여 TapKit 인스턴스를 관리합니다.
+ * 같은 apiKey로 여러 컴포넌트에서 호출해도 동일한 인스턴스를 공유합니다.
+ *
+ * @param config - TapKit 설정 (apiKey 등)
+ * @returns TapKit 인스턴스, 로딩 상태, 에러 정보, 설정 함수
+ *
+ * @example
+ * ```tsx
+ * import { useEffect } from 'react';
+ * import { useTapKit } from '@coxwave/tap-kit/react';
+ *
+ * function MyComponent() {
+ *   const { kit, isReady, error, setup } = useTapKit({
+ *     apiKey: 'your-api-key',
+ *   });
+ *
+ *   useEffect(() => {
+ *     if (isReady) {
+ *       setup({
+ *         buttonId: 'tap-button',
+ *         course: {
+ *           userId: 'user-123',
+ *           courseId: 'course-456',
+ *           clipId: 'clip-789',
+ *         },
+ *       });
+ *     }
+ *   }, [isReady, setup]);
+ *
+ *   if (error) {
+ *     return <div>에러 발생: {error.message}</div>;
+ *   }
+ *
+ *   if (!isReady) {
+ *     return <div>TapKit 로딩 중...</div>;
+ *   }
+ *
+ *   return <div id="tap-button">AI 튜터</div>;
+ * }
+ * ```
+ */
+declare function useTapKit(config: TapKitConfig): UseTapKitReturn;
+interface TapKitContextValue extends UseTapKitReturn {
+}
+interface TapKitProviderProps {
+    /** TapKit configuration */
+    config: TapKitConfig;
+    /** React children */
+    children: ReactNode;
+}
+/**
+ * TapKit Context Provider
+ *
+ * 여러 컴포넌트에서 같은 TapKit 인스턴스를 공유하려면 이 Provider를 사용하세요.
+ * Provider 하위의 모든 컴포넌트에서 useTapKitContext()로 접근할 수 있습니다.
+ *
+ * @param props - Provider props
+ * @param props.config - TapKit 설정 (apiKey 등)
+ * @param props.children - React children
+ *
+ * @example
+ * ```tsx
+ * import { TapKitProvider } from '@coxwave/tap-kit/react';
+ *
+ * function App() {
+ *   return (
+ *     <TapKitProvider config={{ apiKey: 'your-key' }}>
+ *       <YourApp />
+ *     </TapKitProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function TapKitProvider({ config, children }: TapKitProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * TapKit Context에 접근하는 Hook
+ *
+ * TapKitProvider 하위에서만 사용할 수 있습니다.
+ * Provider 없이 사용하면 에러가 발생합니다.
+ *
+ * @returns TapKit context value (kit, isReady, error, init)
+ * @throws {Error} TapKitProvider 외부에서 사용한 경우
+ *
+ * @example
+ * ```tsx
+ * import { useTapKitContext } from '@coxwave/tap-kit/react';
+ *
+ * function MyComponent() {
+ *   const { kit, isReady, init } = useTapKitContext();
+ *
+ *   // ...
+ * }
+ * ```
+ */
+declare function useTapKitContext(): TapKitContextValue;
+export { type TapKitContextValue, TapKitProvider, type TapKitProviderProps, type UseTapKitReturn, useTapKit, useTapKitContext };

package/dist/react.js ADDED Viewed

@@ -0,0 +1,3 @@
+'use strict';var react=require('react'),jsxRuntime=require('react/jsx-runtime');var x=Object.defineProperty;var y=e=>{throw TypeError(e)};var S=(e,t,n)=>t in e?x(e,t,{enumerable:true,configurable:true,writable:true,value:n}):e[t]=n;var L=(e,t,n)=>S(e,typeof t!="symbol"?t+"":t,n),A=(e,t,n)=>t.has(e)||y("Cannot "+n);var a=(e,t,n)=>(A(e,t,"read from private field"),n?n.call(e):t.get(e)),T=(e,t,n)=>t.has(e)?y("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(e):t.set(e,n),f=(e,t,n,i)=>(A(e,t,"write to private field"),t.set(e,n),n);var N=typeof __DEFAULT_CDN_LOADER_URL__<"u"?__DEFAULT_CDN_LOADER_URL__:"https://files.edutap.ai/tap-sdk/loader.js",U=4e3,D=500;function b(){return window?.__TAP_KIT_LOADER_URL__?window.__TAP_KIT_LOADER_URL__:N}function k(){return typeof window<"u"&&!!window.__TAP_KIT_CORE_URL__}function G(){return window.__TAP_KIT_CORE_URL__||""}function C(e,t,n){let i=Date.now(),r=()=>{if(window.TapKit&&window.TapKitLoaded===true){window.__TAP_KIT_LOADER_LOADED__=true,window.__TAP_KIT_LOADER_LOADING__=void 0,e();return}if(Date.now()-i>n){window.__TAP_KIT_LOADER_LOADING__=void 0,t(new Error(`TapKit loader timeout: SDK not available after ${n}ms`));return}typeof requestIdleCallback<"u"?requestIdleCallback(r,{timeout:D}):setTimeout(r,D);};return r}function I(e=U){if(window.__TAP_KIT_LOADER_LOADED__&&window.TapKit)return Promise.resolve();if(window.__TAP_KIT_LOADER_LOADING__)return window.__TAP_KIT_LOADER_LOADING__;let t=new Promise((n,i)=>{if(typeof document>"u"){i(new Error("TapKit requires browser environment (document is undefined)"));return}if(k()){let l=G(),_=document.createElement("script");_.src=l,_.async=true,_.onload=()=>{window.TapKit?(window.TapKitLoaded=true,window.__TAP_KIT_LOADER_LOADED__=true,window.__TAP_KIT_LOADER_LOADING__=void 0,n()):(window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error("TapKit not available after loading local core")));},_.onerror=()=>{window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error(`Failed to load local TapKit core: ${l}`));},document.head.appendChild(_);return}let r=b(),o=document.createElement("script");o.src=r,o.async=true,o.onload=()=>{C(n,i,e)();},o.onerror=()=>{window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error(`Failed to load TapKit CDN loader: ${r}`));};let d=document.querySelector(`script[src="${r}"]`);d?(d.addEventListener("load",()=>{C(n,i,e)();}),d.addEventListener("error",()=>i(new Error(`Failed to load TapKit CDN loader: ${r}`)))):document.head.appendChild(o);});return window.__TAP_KIT_LOADER_LOADING__=t,t}var m=Symbol.for("tapkit.config"),p,u,s,K=class{constructor(t){L(this,"instance",null);T(this,p);T(this,u);T(this,s,null);L(this,"pendingConfig");f(this,u,t),f(this,p,this.load());}async load(){try{if(await I(),!window.TapKit)throw new Error("TapKit not available after loading CDN loader");this.instance=new window.TapKit(a(this,u)),this.pendingConfig&&(this.instance[m]?.(this.pendingConfig),this.pendingConfig=void 0);}catch(t){throw f(this,s,t instanceof Error?t:new Error(String(t))),a(this,s)}}get ready(){return a(this,p).then(()=>{if(a(this,s))throw a(this,s);if(!this.instance)throw new Error("TapKit instance not initialized. Check console for errors.");return this.instance.ready})}get events(){return new Proxy({},{get:(t,n)=>(...i)=>this.ready.then(()=>{let r=(this.instance?.events)[n];return typeof r=="function"?r(...i):r})})}get isOpen(){return this.instance?.isOpen??false}get isInitialized(){return this.instance?.isInitialized??false}get video(){return new Proxy({},{get:(t,n)=>(...i)=>this.ready.then(()=>{let r=(this.instance?.video)[n];return typeof r=="function"?r(...i):r})})}async init(t){if(await a(this,p),!this.instance)throw new Error("TapKit instance not available after loading");return await this.instance.init(t)}destroy(){this.instance&&(this.instance.destroy(),this.instance=null);}[m](t){if(!this.instance){this.pendingConfig=t;return}this.instance[m]?.(t);}get[Symbol.toStringTag](){return "TapKit"}};p=new WeakMap,u=new WeakMap,s=new WeakMap;var c=new Map;function v(e){let{apiKey:t}=e;if(!c.has(t)){let i=new K(e),r={state:{instance:i,isReady:false,error:null},listeners:new Set};c.set(t,r),i.ready.then(()=>{r.state.isReady=true,r.state.error=null,P(t);}).catch(o=>{r.state.error=o instanceof Error?o:new Error(String(o)),r.state.isReady=false,P(t);});}let n=c.get(t);if(!n)throw new Error(`Store for apiKey "${t}" should exist but was not found`);return n}function R(e,t){let n=c.get(e);return n?(n.listeners.add(t),()=>{n.listeners.delete(t);}):()=>{}}function h(e){let t=c.get(e);return t?t.state:null}function P(e){let t=c.get(e);if(t)for(let n of t.listeners)n();}function g(e){let{apiKey:t}=e,n=react.useRef(null);react.useEffect(()=>{v(e);},[e]);let i=react.useSyncExternalStore(react.useCallback(o=>R(t,o),[t]),react.useCallback(()=>h(t),[t]),react.useCallback(()=>h(t),[t])),r=react.useCallback(async o=>{if(!i?.instance)throw new Error("TapKit instance not initialized");let d=await i.instance.init(o);return n.current=d,d},[i?.instance]);return react.useEffect(()=>()=>{n.current?.();},[]),{kit:i?.instance??null,isReady:i?.isReady??false,error:i?.error??null,setup:r}}var E=react.createContext(null);function $({config:e,children:t}){let n=g(e);return jsxRuntime.jsx(E.Provider,{value:n,children:t})}function q(){let e=react.useContext(E);if(!e)throw new Error("useTapKitContext must be used within a TapKitProvider. Wrap your component tree with <TapKitProvider config={...}>");return e}
+exports.TapKitProvider=$;exports.useTapKit=g;exports.useTapKitContext=q;//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/loader.ts","../src/kit.ts","../src/react/store.ts","../src/react/useTapKit.ts","../src/react/TapKitProvider.tsx","../src/react/useTapKitContext.ts"],"names":["DEFAULT_CDN_LOADER_URL","DEFAULT_TIMEOUT_MS","IDLE_CALLBACK_TIMEOUT_MS","getLoaderURL","isLocalCoreMode","getLocalCoreURL","createSDKChecker","resolve","reject","timeoutMs","startTime","checkSDK","loadCDNLoader","loadingPromise","coreURL","script","loaderURL","existingScript","TAPKIT_CONFIG_SYMBOL","_loading","_config","_loadError","TapKit","config","__publicField","__privateAdd","__privateSet","__privateGet","err","_target","prop","args","method","params","options","stores","getTapKitStore","apiKey","instance","store","notifyListeners","subscribe","callback","getSnapshot","listener","useTapKit","cleanupRef","useRef","useEffect","state","useSyncExternalStore","useCallback","setup","cleanup","TapKitContext","createContext","TapKitProvider","children","tapKit","jsx","useTapKitContext","context","useContext"],"mappings":"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","file":"react.js","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__ ? window.__TAP_KIT_LOADER_URL__ : 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(new Error(`TapKit loader timeout: SDK not available after ${timeoutMs}ms`));\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(timeoutMs: number = DEFAULT_TIMEOUT_MS): 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(new Error(\"TapKit requires browser environment (document is undefined)\"));\n return;\n }\n\n // Local core mode: Load IIFE directly\n if (isLocalCoreMode()) {\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 */\n// biome-ignore lint/suspicious/noExplicitAny: Symbol type casting required for compatibility\nconst TAPKIT_CONFIG_SYMBOL: typeof TAPKIT_CONFIG_SYMBOL_TYPE = 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\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 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(\"TapKit instance not initialized. Check console for errors.\");\n }\n return this.instance.ready;\n });\n }\n\n get events() {\n // Proxy pattern: automatically wait for ready when calling methods\n return 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\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 // Proxy pattern: automatically wait for ready when calling methods\n return 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\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","/**\n * TapKit Instance Store\n *\n * useSyncExternalStore를 활용하여 apiKey별 인스턴스를 관리합니다.\n * Zustand와 유사한 방식으로 Context 없이도 여러 컴포넌트에서 같은 인스턴스를 공유할 수 있습니다.\n */\n\nimport type { TapKitConfig } from \"@coxwave/tap-kit-types\";\nimport { TapKit } from \"../kit.js\";\n\ninterface StoreState {\n instance: TapKit;\n isReady: boolean;\n error: Error | null;\n}\n\ntype Listener = () => void;\n\n/**\n * apiKey별 store를 관리하는 Map\n */\nconst stores = new Map<\n string,\n {\n state: StoreState;\n listeners: Set<Listener>;\n }\n>();\n\n/**\n * apiKey에 해당하는 TapKit store를 가져오거나 생성합니다.\n *\n * @param config - TapKit 설정\n * @returns Store object with state and subscription methods\n */\nexport function getTapKitStore(config: TapKitConfig) {\n const { apiKey } = config;\n\n if (!stores.has(apiKey)) {\n const instance = new TapKit(config);\n const store = {\n state: {\n instance,\n isReady: false,\n error: null as Error | null,\n },\n listeners: new Set<Listener>(),\n };\n\n stores.set(apiKey, store);\n\n // Initialize and update ready state\n instance.ready\n .then(() => {\n store.state.isReady = true;\n store.state.error = null;\n notifyListeners(apiKey);\n })\n .catch((err) => {\n store.state.error = err instanceof Error ? err : new Error(String(err));\n store.state.isReady = false;\n notifyListeners(apiKey);\n });\n }\n\n const store = stores.get(apiKey);\n if (!store) {\n throw new Error(`Store for apiKey \"${apiKey}\" should exist but was not found`);\n }\n return store;\n}\n\n/**\n * Subscribe to store changes for useSyncExternalStore\n */\nexport function subscribe(apiKey: string, callback: Listener): () => void {\n const store = stores.get(apiKey);\n if (!store) {\n return () => {};\n }\n\n store.listeners.add(callback);\n return () => {\n store.listeners.delete(callback);\n };\n}\n\n/**\n * Get current snapshot for useSyncExternalStore\n */\nexport function getSnapshot(apiKey: string): StoreState | null {\n const store = stores.get(apiKey);\n return store ? store.state : null;\n}\n\n/**\n * Notify all listeners of a store\n */\nfunction notifyListeners(apiKey: string): void {\n const store = stores.get(apiKey);\n if (!store) return;\n\n for (const listener of store.listeners) {\n listener();\n }\n}\n\n/**\n * 특정 apiKey의 인스턴스를 제거합니다.\n * 주로 테스트나 cleanup에 사용됩니다.\n *\n * @param apiKey - 제거할 인스턴스의 apiKey\n */\nexport function clearTapKitInstance(apiKey: string): void {\n const store = stores.get(apiKey);\n if (store) {\n store.state.instance.destroy?.();\n store.listeners.clear();\n stores.delete(apiKey);\n }\n}\n\n/**\n * 모든 캐시된 인스턴스를 제거합니다.\n * 주로 테스트 cleanup에 사용됩니다.\n */\nexport function clearAllTapKitInstances(): void {\n for (const [_apiKey, store] of stores.entries()) {\n store.state.instance.destroy?.();\n store.listeners.clear();\n }\n stores.clear();\n}\n","import { useCallback, useEffect, useRef, useSyncExternalStore } from \"react\";\nimport type { TapKitConfig, TapKitInstance, TapKitInitParams } from \"../types\";\nimport { getSnapshot, getTapKitStore, subscribe } from \"./store.js\";\n\nexport interface UseTapKitReturn {\n /** TapKit instance */\n kit: TapKitInstance | null;\n /** Whether TapKit is ready to use */\n isReady: boolean;\n /** Error that occurred during loading */\n error: Error | null;\n /** Setup TapKit with given parameters (button, course info, etc.) */\n setup: (params: TapKitInitParams) => Promise<() => void>;\n}\n\n/**\n * 🌟 TapKit을 React에서 사용하기 위한 핵심 Hook\n *\n * useSyncExternalStore를 활용하여 TapKit 인스턴스를 관리합니다.\n * 같은 apiKey로 여러 컴포넌트에서 호출해도 동일한 인스턴스를 공유합니다.\n *\n * @param config - TapKit 설정 (apiKey 등)\n * @returns TapKit 인스턴스, 로딩 상태, 에러 정보, 설정 함수\n *\n * @example\n * ```tsx\n * import { useEffect } from 'react';\n * import { useTapKit } from '@coxwave/tap-kit/react';\n *\n * function MyComponent() {\n * const { kit, isReady, error, setup } = useTapKit({\n * apiKey: 'your-api-key',\n * });\n *\n * useEffect(() => {\n * if (isReady) {\n * setup({\n * buttonId: 'tap-button',\n * course: {\n * userId: 'user-123',\n * courseId: 'course-456',\n * clipId: 'clip-789',\n * },\n * });\n * }\n * }, [isReady, setup]);\n *\n * if (error) {\n * return <div>에러 발생: {error.message}</div>;\n * }\n *\n * if (!isReady) {\n * return <div>TapKit 로딩 중...</div>;\n * }\n *\n * return <div id=\"tap-button\">AI 튜터</div>;\n * }\n * ```\n */\nexport function useTapKit(config: TapKitConfig): UseTapKitReturn {\n const { apiKey } = config;\n const cleanupRef = useRef<(() => void) | null>(null);\n\n // Store 초기화\n useEffect(() => {\n getTapKitStore(config);\n }, [config]);\n\n // useSyncExternalStore로 상태 구독\n const state = useSyncExternalStore(\n useCallback((callback) => subscribe(apiKey, callback), [apiKey]),\n useCallback(() => getSnapshot(apiKey), [apiKey]),\n useCallback(() => getSnapshot(apiKey), [apiKey]) // Server snapshot (same as client)\n );\n\n const setup = useCallback(\n async (params: TapKitInitParams): Promise<() => void> => {\n if (!state?.instance) {\n throw new Error(\"TapKit instance not initialized\");\n }\n const cleanup = await state.instance.init(params);\n cleanupRef.current = cleanup;\n return cleanup;\n },\n [state?.instance]\n );\n\n // Cleanup on unmount\n useEffect(() => {\n return () => {\n cleanupRef.current?.();\n };\n }, []);\n\n return {\n kit: state?.instance ?? null,\n isReady: state?.isReady ?? false,\n error: state?.error ?? null,\n setup,\n };\n}\n","import { createContext, type ReactNode } from \"react\";\nimport { useTapKit, type UseTapKitReturn } from \"./useTapKit\";\nimport type { TapKitConfig } from \"../types\";\n\nexport interface TapKitContextValue extends UseTapKitReturn {}\n\nexport const TapKitContext = createContext<TapKitContextValue | null>(null);\n\nexport interface TapKitProviderProps {\n /** TapKit configuration */\n config: TapKitConfig;\n /** React children */\n children: ReactNode;\n}\n\n/**\n * TapKit Context Provider\n *\n * 여러 컴포넌트에서 같은 TapKit 인스턴스를 공유하려면 이 Provider를 사용하세요.\n * Provider 하위의 모든 컴포넌트에서 useTapKitContext()로 접근할 수 있습니다.\n *\n * @param props - Provider props\n * @param props.config - TapKit 설정 (apiKey 등)\n * @param props.children - React children\n *\n * @example\n * ```tsx\n * import { TapKitProvider } from '@coxwave/tap-kit/react';\n *\n * function App() {\n * return (\n * <TapKitProvider config={{ apiKey: 'your-key' }}>\n * <YourApp />\n * </TapKitProvider>\n * );\n * }\n * ```\n */\nexport function TapKitProvider({ config, children }: TapKitProviderProps) {\n const tapKit = useTapKit(config);\n\n return <TapKitContext.Provider value={tapKit}>{children}</TapKitContext.Provider>;\n}\n","import { useContext } from \"react\";\nimport { TapKitContext, type TapKitContextValue } from \"./TapKitProvider\";\n\n/**\n * TapKit Context에 접근하는 Hook\n *\n * TapKitProvider 하위에서만 사용할 수 있습니다.\n * Provider 없이 사용하면 에러가 발생합니다.\n *\n * @returns TapKit context value (kit, isReady, error, init)\n * @throws {Error} TapKitProvider 외부에서 사용한 경우\n *\n * @example\n * ```tsx\n * import { useTapKitContext } from '@coxwave/tap-kit/react';\n *\n * function MyComponent() {\n * const { kit, isReady, init } = useTapKitContext();\n *\n * // ...\n * }\n * ```\n */\nexport function useTapKitContext(): TapKitContextValue {\n const context = useContext(TapKitContext);\n\n if (!context) {\n throw new Error(\n \"useTapKitContext must be used within a TapKitProvider. \" +\n \"Wrap your component tree with <TapKitProvider config={...}>\"\n );\n }\n\n return context;\n}\n"]}

package/dist/react.mjs ADDED Viewed

@@ -0,0 +1,3 @@
+import {createContext,useRef,useEffect,useSyncExternalStore,useCallback,useContext}from'react';import {jsx}from'react/jsx-runtime';var x=Object.defineProperty;var y=e=>{throw TypeError(e)};var S=(e,t,n)=>t in e?x(e,t,{enumerable:true,configurable:true,writable:true,value:n}):e[t]=n;var L=(e,t,n)=>S(e,typeof t!="symbol"?t+"":t,n),A=(e,t,n)=>t.has(e)||y("Cannot "+n);var a=(e,t,n)=>(A(e,t,"read from private field"),n?n.call(e):t.get(e)),T=(e,t,n)=>t.has(e)?y("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(e):t.set(e,n),f=(e,t,n,i)=>(A(e,t,"write to private field"),t.set(e,n),n);var N=typeof __DEFAULT_CDN_LOADER_URL__<"u"?__DEFAULT_CDN_LOADER_URL__:"https://files.edutap.ai/tap-sdk/loader.js",U=4e3,D=500;function b(){return window?.__TAP_KIT_LOADER_URL__?window.__TAP_KIT_LOADER_URL__:N}function k(){return typeof window<"u"&&!!window.__TAP_KIT_CORE_URL__}function G(){return window.__TAP_KIT_CORE_URL__||""}function C(e,t,n){let i=Date.now(),r=()=>{if(window.TapKit&&window.TapKitLoaded===true){window.__TAP_KIT_LOADER_LOADED__=true,window.__TAP_KIT_LOADER_LOADING__=void 0,e();return}if(Date.now()-i>n){window.__TAP_KIT_LOADER_LOADING__=void 0,t(new Error(`TapKit loader timeout: SDK not available after ${n}ms`));return}typeof requestIdleCallback<"u"?requestIdleCallback(r,{timeout:D}):setTimeout(r,D);};return r}function I(e=U){if(window.__TAP_KIT_LOADER_LOADED__&&window.TapKit)return Promise.resolve();if(window.__TAP_KIT_LOADER_LOADING__)return window.__TAP_KIT_LOADER_LOADING__;let t=new Promise((n,i)=>{if(typeof document>"u"){i(new Error("TapKit requires browser environment (document is undefined)"));return}if(k()){let l=G(),_=document.createElement("script");_.src=l,_.async=true,_.onload=()=>{window.TapKit?(window.TapKitLoaded=true,window.__TAP_KIT_LOADER_LOADED__=true,window.__TAP_KIT_LOADER_LOADING__=void 0,n()):(window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error("TapKit not available after loading local core")));},_.onerror=()=>{window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error(`Failed to load local TapKit core: ${l}`));},document.head.appendChild(_);return}let r=b(),o=document.createElement("script");o.src=r,o.async=true,o.onload=()=>{C(n,i,e)();},o.onerror=()=>{window.__TAP_KIT_LOADER_LOADING__=void 0,i(new Error(`Failed to load TapKit CDN loader: ${r}`));};let d=document.querySelector(`script[src="${r}"]`);d?(d.addEventListener("load",()=>{C(n,i,e)();}),d.addEventListener("error",()=>i(new Error(`Failed to load TapKit CDN loader: ${r}`)))):document.head.appendChild(o);});return window.__TAP_KIT_LOADER_LOADING__=t,t}var m=Symbol.for("tapkit.config"),p,u,s,K=class{constructor(t){L(this,"instance",null);T(this,p);T(this,u);T(this,s,null);L(this,"pendingConfig");f(this,u,t),f(this,p,this.load());}async load(){try{if(await I(),!window.TapKit)throw new Error("TapKit not available after loading CDN loader");this.instance=new window.TapKit(a(this,u)),this.pendingConfig&&(this.instance[m]?.(this.pendingConfig),this.pendingConfig=void 0);}catch(t){throw f(this,s,t instanceof Error?t:new Error(String(t))),a(this,s)}}get ready(){return a(this,p).then(()=>{if(a(this,s))throw a(this,s);if(!this.instance)throw new Error("TapKit instance not initialized. Check console for errors.");return this.instance.ready})}get events(){return new Proxy({},{get:(t,n)=>(...i)=>this.ready.then(()=>{let r=(this.instance?.events)[n];return typeof r=="function"?r(...i):r})})}get isOpen(){return this.instance?.isOpen??false}get isInitialized(){return this.instance?.isInitialized??false}get video(){return new Proxy({},{get:(t,n)=>(...i)=>this.ready.then(()=>{let r=(this.instance?.video)[n];return typeof r=="function"?r(...i):r})})}async init(t){if(await a(this,p),!this.instance)throw new Error("TapKit instance not available after loading");return await this.instance.init(t)}destroy(){this.instance&&(this.instance.destroy(),this.instance=null);}[m](t){if(!this.instance){this.pendingConfig=t;return}this.instance[m]?.(t);}get[Symbol.toStringTag](){return "TapKit"}};p=new WeakMap,u=new WeakMap,s=new WeakMap;var c=new Map;function v(e){let{apiKey:t}=e;if(!c.has(t)){let i=new K(e),r={state:{instance:i,isReady:false,error:null},listeners:new Set};c.set(t,r),i.ready.then(()=>{r.state.isReady=true,r.state.error=null,P(t);}).catch(o=>{r.state.error=o instanceof Error?o:new Error(String(o)),r.state.isReady=false,P(t);});}let n=c.get(t);if(!n)throw new Error(`Store for apiKey "${t}" should exist but was not found`);return n}function R(e,t){let n=c.get(e);return n?(n.listeners.add(t),()=>{n.listeners.delete(t);}):()=>{}}function h(e){let t=c.get(e);return t?t.state:null}function P(e){let t=c.get(e);if(t)for(let n of t.listeners)n();}function g(e){let{apiKey:t}=e,n=useRef(null);useEffect(()=>{v(e);},[e]);let i=useSyncExternalStore(useCallback(o=>R(t,o),[t]),useCallback(()=>h(t),[t]),useCallback(()=>h(t),[t])),r=useCallback(async o=>{if(!i?.instance)throw new Error("TapKit instance not initialized");let d=await i.instance.init(o);return n.current=d,d},[i?.instance]);return useEffect(()=>()=>{n.current?.();},[]),{kit:i?.instance??null,isReady:i?.isReady??false,error:i?.error??null,setup:r}}var E=createContext(null);function $({config:e,children:t}){let n=g(e);return jsx(E.Provider,{value:n,children:t})}function q(){let e=useContext(E);if(!e)throw new Error("useTapKitContext must be used within a TapKitProvider. Wrap your component tree with <TapKitProvider config={...}>");return e}
+export{$ as TapKitProvider,g as useTapKit,q as useTapKitContext};//# sourceMappingURL=react.mjs.map
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/loader.ts","../src/kit.ts","../src/react/store.ts","../src/react/useTapKit.ts","../src/react/TapKitProvider.tsx","../src/react/useTapKitContext.ts"],"names":["DEFAULT_CDN_LOADER_URL","DEFAULT_TIMEOUT_MS","IDLE_CALLBACK_TIMEOUT_MS","getLoaderURL","isLocalCoreMode","getLocalCoreURL","createSDKChecker","resolve","reject","timeoutMs","startTime","checkSDK","loadCDNLoader","loadingPromise","coreURL","script","loaderURL","existingScript","TAPKIT_CONFIG_SYMBOL","_loading","_config","_loadError","TapKit","config","__publicField","__privateAdd","__privateSet","__privateGet","err","_target","prop","args","method","params","options","stores","getTapKitStore","apiKey","instance","store","notifyListeners","subscribe","callback","getSnapshot","listener","useTapKit","cleanupRef","useRef","useEffect","state","useSyncExternalStore","useCallback","setup","cleanup","TapKitContext","createContext","TapKitProvider","children","tapKit","jsx","useTapKitContext","context","useContext"],"mappings":"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","file":"react.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__ ? window.__TAP_KIT_LOADER_URL__ : 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(new Error(`TapKit loader timeout: SDK not available after ${timeoutMs}ms`));\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(timeoutMs: number = DEFAULT_TIMEOUT_MS): 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(new Error(\"TapKit requires browser environment (document is undefined)\"));\n return;\n }\n\n // Local core mode: Load IIFE directly\n if (isLocalCoreMode()) {\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 */\n// biome-ignore lint/suspicious/noExplicitAny: Symbol type casting required for compatibility\nconst TAPKIT_CONFIG_SYMBOL: typeof TAPKIT_CONFIG_SYMBOL_TYPE = 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\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 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(\"TapKit instance not initialized. Check console for errors.\");\n }\n return this.instance.ready;\n });\n }\n\n get events() {\n // Proxy pattern: automatically wait for ready when calling methods\n return 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\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 // Proxy pattern: automatically wait for ready when calling methods\n return 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\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","/**\n * TapKit Instance Store\n *\n * useSyncExternalStore를 활용하여 apiKey별 인스턴스를 관리합니다.\n * Zustand와 유사한 방식으로 Context 없이도 여러 컴포넌트에서 같은 인스턴스를 공유할 수 있습니다.\n */\n\nimport type { TapKitConfig } from \"@coxwave/tap-kit-types\";\nimport { TapKit } from \"../kit.js\";\n\ninterface StoreState {\n instance: TapKit;\n isReady: boolean;\n error: Error | null;\n}\n\ntype Listener = () => void;\n\n/**\n * apiKey별 store를 관리하는 Map\n */\nconst stores = new Map<\n string,\n {\n state: StoreState;\n listeners: Set<Listener>;\n }\n>();\n\n/**\n * apiKey에 해당하는 TapKit store를 가져오거나 생성합니다.\n *\n * @param config - TapKit 설정\n * @returns Store object with state and subscription methods\n */\nexport function getTapKitStore(config: TapKitConfig) {\n const { apiKey } = config;\n\n if (!stores.has(apiKey)) {\n const instance = new TapKit(config);\n const store = {\n state: {\n instance,\n isReady: false,\n error: null as Error | null,\n },\n listeners: new Set<Listener>(),\n };\n\n stores.set(apiKey, store);\n\n // Initialize and update ready state\n instance.ready\n .then(() => {\n store.state.isReady = true;\n store.state.error = null;\n notifyListeners(apiKey);\n })\n .catch((err) => {\n store.state.error = err instanceof Error ? err : new Error(String(err));\n store.state.isReady = false;\n notifyListeners(apiKey);\n });\n }\n\n const store = stores.get(apiKey);\n if (!store) {\n throw new Error(`Store for apiKey \"${apiKey}\" should exist but was not found`);\n }\n return store;\n}\n\n/**\n * Subscribe to store changes for useSyncExternalStore\n */\nexport function subscribe(apiKey: string, callback: Listener): () => void {\n const store = stores.get(apiKey);\n if (!store) {\n return () => {};\n }\n\n store.listeners.add(callback);\n return () => {\n store.listeners.delete(callback);\n };\n}\n\n/**\n * Get current snapshot for useSyncExternalStore\n */\nexport function getSnapshot(apiKey: string): StoreState | null {\n const store = stores.get(apiKey);\n return store ? store.state : null;\n}\n\n/**\n * Notify all listeners of a store\n */\nfunction notifyListeners(apiKey: string): void {\n const store = stores.get(apiKey);\n if (!store) return;\n\n for (const listener of store.listeners) {\n listener();\n }\n}\n\n/**\n * 특정 apiKey의 인스턴스를 제거합니다.\n * 주로 테스트나 cleanup에 사용됩니다.\n *\n * @param apiKey - 제거할 인스턴스의 apiKey\n */\nexport function clearTapKitInstance(apiKey: string): void {\n const store = stores.get(apiKey);\n if (store) {\n store.state.instance.destroy?.();\n store.listeners.clear();\n stores.delete(apiKey);\n }\n}\n\n/**\n * 모든 캐시된 인스턴스를 제거합니다.\n * 주로 테스트 cleanup에 사용됩니다.\n */\nexport function clearAllTapKitInstances(): void {\n for (const [_apiKey, store] of stores.entries()) {\n store.state.instance.destroy?.();\n store.listeners.clear();\n }\n stores.clear();\n}\n","import { useCallback, useEffect, useRef, useSyncExternalStore } from \"react\";\nimport type { TapKitConfig, TapKitInstance, TapKitInitParams } from \"../types\";\nimport { getSnapshot, getTapKitStore, subscribe } from \"./store.js\";\n\nexport interface UseTapKitReturn {\n /** TapKit instance */\n kit: TapKitInstance | null;\n /** Whether TapKit is ready to use */\n isReady: boolean;\n /** Error that occurred during loading */\n error: Error | null;\n /** Setup TapKit with given parameters (button, course info, etc.) */\n setup: (params: TapKitInitParams) => Promise<() => void>;\n}\n\n/**\n * 🌟 TapKit을 React에서 사용하기 위한 핵심 Hook\n *\n * useSyncExternalStore를 활용하여 TapKit 인스턴스를 관리합니다.\n * 같은 apiKey로 여러 컴포넌트에서 호출해도 동일한 인스턴스를 공유합니다.\n *\n * @param config - TapKit 설정 (apiKey 등)\n * @returns TapKit 인스턴스, 로딩 상태, 에러 정보, 설정 함수\n *\n * @example\n * ```tsx\n * import { useEffect } from 'react';\n * import { useTapKit } from '@coxwave/tap-kit/react';\n *\n * function MyComponent() {\n * const { kit, isReady, error, setup } = useTapKit({\n * apiKey: 'your-api-key',\n * });\n *\n * useEffect(() => {\n * if (isReady) {\n * setup({\n * buttonId: 'tap-button',\n * course: {\n * userId: 'user-123',\n * courseId: 'course-456',\n * clipId: 'clip-789',\n * },\n * });\n * }\n * }, [isReady, setup]);\n *\n * if (error) {\n * return <div>에러 발생: {error.message}</div>;\n * }\n *\n * if (!isReady) {\n * return <div>TapKit 로딩 중...</div>;\n * }\n *\n * return <div id=\"tap-button\">AI 튜터</div>;\n * }\n * ```\n */\nexport function useTapKit(config: TapKitConfig): UseTapKitReturn {\n const { apiKey } = config;\n const cleanupRef = useRef<(() => void) | null>(null);\n\n // Store 초기화\n useEffect(() => {\n getTapKitStore(config);\n }, [config]);\n\n // useSyncExternalStore로 상태 구독\n const state = useSyncExternalStore(\n useCallback((callback) => subscribe(apiKey, callback), [apiKey]),\n useCallback(() => getSnapshot(apiKey), [apiKey]),\n useCallback(() => getSnapshot(apiKey), [apiKey]) // Server snapshot (same as client)\n );\n\n const setup = useCallback(\n async (params: TapKitInitParams): Promise<() => void> => {\n if (!state?.instance) {\n throw new Error(\"TapKit instance not initialized\");\n }\n const cleanup = await state.instance.init(params);\n cleanupRef.current = cleanup;\n return cleanup;\n },\n [state?.instance]\n );\n\n // Cleanup on unmount\n useEffect(() => {\n return () => {\n cleanupRef.current?.();\n };\n }, []);\n\n return {\n kit: state?.instance ?? null,\n isReady: state?.isReady ?? false,\n error: state?.error ?? null,\n setup,\n };\n}\n","import { createContext, type ReactNode } from \"react\";\nimport { useTapKit, type UseTapKitReturn } from \"./useTapKit\";\nimport type { TapKitConfig } from \"../types\";\n\nexport interface TapKitContextValue extends UseTapKitReturn {}\n\nexport const TapKitContext = createContext<TapKitContextValue | null>(null);\n\nexport interface TapKitProviderProps {\n /** TapKit configuration */\n config: TapKitConfig;\n /** React children */\n children: ReactNode;\n}\n\n/**\n * TapKit Context Provider\n *\n * 여러 컴포넌트에서 같은 TapKit 인스턴스를 공유하려면 이 Provider를 사용하세요.\n * Provider 하위의 모든 컴포넌트에서 useTapKitContext()로 접근할 수 있습니다.\n *\n * @param props - Provider props\n * @param props.config - TapKit 설정 (apiKey 등)\n * @param props.children - React children\n *\n * @example\n * ```tsx\n * import { TapKitProvider } from '@coxwave/tap-kit/react';\n *\n * function App() {\n * return (\n * <TapKitProvider config={{ apiKey: 'your-key' }}>\n * <YourApp />\n * </TapKitProvider>\n * );\n * }\n * ```\n */\nexport function TapKitProvider({ config, children }: TapKitProviderProps) {\n const tapKit = useTapKit(config);\n\n return <TapKitContext.Provider value={tapKit}>{children}</TapKitContext.Provider>;\n}\n","import { useContext } from \"react\";\nimport { TapKitContext, type TapKitContextValue } from \"./TapKitProvider\";\n\n/**\n * TapKit Context에 접근하는 Hook\n *\n * TapKitProvider 하위에서만 사용할 수 있습니다.\n * Provider 없이 사용하면 에러가 발생합니다.\n *\n * @returns TapKit context value (kit, isReady, error, init)\n * @throws {Error} TapKitProvider 외부에서 사용한 경우\n *\n * @example\n * ```tsx\n * import { useTapKitContext } from '@coxwave/tap-kit/react';\n *\n * function MyComponent() {\n * const { kit, isReady, init } = useTapKitContext();\n *\n * // ...\n * }\n * ```\n */\nexport function useTapKitContext(): TapKitContextValue {\n const context = useContext(TapKitContext);\n\n if (!context) {\n throw new Error(\n \"useTapKitContext must be used within a TapKitProvider. \" +\n \"Wrap your component tree with <TapKitProvider config={...}>\"\n );\n }\n\n return context;\n}\n"]}

package/package.json ADDED Viewed

@@ -0,0 +1,67 @@
+{
+  "name": "@coxwave/tap-kit",
+  "version": "1.0.0",
+  "description": "EduTAP SDK with React support",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.mjs",
+      "require": "./dist/react.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "publish:npm": "./scripts/publish.sh"
+  },
+  "dependencies": {
+    "@coxwave/tap-kit-types": "workspace:*"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@coxwave/config-typescript": "workspace:*",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "edutap",
+    "tap",
+    "sdk",
+    "ai",
+    "tutor",
+    "react",
+    "education"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/coxwave/ax-tap-fe",
+    "directory": "packages/tap-kit"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}