@coxwave/tap-kit-types 2.0.3 → 2.0.4

package/dist/index.d.ts

@@ -2371,6 +2371,76 @@ type SeekTimelineParamsType = {
     clipId: string;
     clipPlayHead: number;
 };
+/**
+ * TapKit Ready Event - Fired when iframe is initialized and ready
+ *
+ * @example
+ * ```typescript
+ * document.addEventListener('tapkit:ready', (e) => {
+ *   console.log('TapKit ready! GA ID:', e.detail.gaId);
+ * });
+ * ```
+ */
+interface TapKitReadyEvent extends CustomEvent<{
+    gaId: string;
+}> {
+}
+/**
+ * TapKit Close Event - Fired when chat is closed from within iframe
+ *
+ * @example
+ * ```typescript
+ * document.addEventListener('tapkit:close', () => {
+ *   console.log('Chat closed');
+ * });
+ * ```
+ */
+interface TapKitCloseEvent extends CustomEvent<undefined> {
+}
+/**
+ * TapKit Timeline Seek Event - Fired when user clicks timeline in chat
+ *
+ * @example
+ * ```typescript
+ * document.addEventListener('tapkit:timeline:seek', (e) => {
+ *   videoElement.currentTime = e.detail.clipPlayHead;
+ * });
+ * ```
+ */
+interface TapKitTimelineSeekEvent extends CustomEvent<{
+    clipId: string;
+    clipPlayHead: number;
+}> {
+}
+/**
+ * TapKit Material View Open Event - Fired when PDF/document viewer opens
+ *
+ * @example
+ * ```typescript
+ * document.addEventListener('tapkit:material:view:open', (e) => {
+ *   console.log('Material opened:', e.detail.materialId);
+ * });
+ * ```
+ */
+interface TapKitMaterialViewOpenEvent extends CustomEvent<{
+    materialId: string;
+    presignedUrl: string;
+    pageStart?: number;
+    pageEnd?: number;
+}> {
+}
+/**
+ * TapKit Material View Close Event - Fired when PDF/document viewer closes
+ *
+ * @example
+ * ```typescript
+ * document.addEventListener('tapkit:material:view:close', () => {
+ *   console.log('Material viewer closed');
+ * });
+ * ```
+ */
+interface TapKitMaterialViewCloseEvent extends CustomEvent<undefined> {
+}
 /**
  * Shortcut Key Configuration
  */
@@ -3342,6 +3412,28 @@ interface TapMaterialViewerAttributes {
 
 
 declare global {
+  /**
+   * TapKit CustomEvent types for document.addEventListener
+   *
+   * @example
+   * ```typescript
+   * document.addEventListener('tapkit:ready', (e) => {
+   *   console.log(e.detail.gaId); // Type-safe!
+   * });
+   *
+   * document.addEventListener('tapkit:timeline:seek', (e) => {
+   *   videoElement.currentTime = e.detail.clipPlayHead; // Type-safe!
+   * });
+   * ```
+   */
+  interface DocumentEventMap {
+    "tapkit:ready": TapKitReadyEvent;
+    "tapkit:close": TapKitCloseEvent;
+    "tapkit:timeline:seek": TapKitTimelineSeekEvent;
+    "tapkit:material:view:open": TapKitMaterialViewOpenEvent;
+    "tapkit:material:view:close": TapKitMaterialViewCloseEvent;
+  }
+
   interface Window {
     TapKit?: TapKitConstructor;
     createTapKit?: (config: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coxwave/tap-kit-types",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "type": "module",
   "description": "Shared TypeScript types for TapKit SDK packages",
   "main": "dist/index.js",