@mux/ai 0.1.6 → 0.3.0

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@mux/ai",
-  "version": "0.1.6",
+  "type": "module",
+  "version": "0.3.0",
   "description": "AI library for Mux",
   "author": "Mux",
   "license": "Apache-2.0",
@@ -39,63 +40,58 @@
   "exports": {
     ".": {
       "types": {
-        "import": "./dist/index.d.mts",
-        "require": "./dist/index.d.ts"
+        "import": "./dist/index.d.ts"
       },
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
+      "import": "./dist/index.js"
     },
     "./primitives": {
       "types": {
-        "import": "./dist/primitives/index.d.mts",
-        "require": "./dist/primitives/index.d.ts"
+        "import": "./dist/primitives/index.d.ts"
       },
-      "import": "./dist/primitives/index.mjs",
-      "require": "./dist/primitives/index.js"
+      "import": "./dist/primitives/index.js"
     },
     "./workflows": {
       "types": {
-        "import": "./dist/workflows/index.d.mts",
-        "require": "./dist/workflows/index.d.ts"
+        "import": "./dist/workflows/index.d.ts"
       },
-      "import": "./dist/workflows/index.mjs",
-      "require": "./dist/workflows/index.js"
+      "import": "./dist/workflows/index.js"
     }
   },
   "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=21.0.0"
   },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:ui": "vitest --ui",
-    "test:integration": "vitest run tests/integration",
-    "test:unit": "vitest run tests/unit",
-    "test:eval": "evalite serve tests/eval",
+    "test": "DOTENV_CONFIG_PATH=.env.test vitest run",
+    "test:watch": "DOTENV_CONFIG_PATH=.env.test vitest",
+    "test:ui": "DOTENV_CONFIG_PATH=.env.test vitest --ui",
+    "test:integration": "DOTENV_CONFIG_PATH=.env.test vitest run tests/integration",
+    "test:integration-workflowdevkit": "DOTENV_CONFIG_PATH=.env.test vitest run --config vitest.workflowdevkit.config.ts",
+    "test:unit": "DOTENV_CONFIG_PATH=.env.test vitest run tests/unit",
+    "test:eval": "DOTENV_CONFIG_PATH=.env.test evalite serve tests/eval",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "typecheck": "tsc --noEmit",
-    "example:chapters": "npx ts-node --transpile-only --require tsconfig-paths/register examples/chapters/basic-example.ts",
-    "example:chapters:compare": "npx ts-node --transpile-only --require tsconfig-paths/register examples/chapters/provider-comparison.ts",
-    "example:burned-in": "npx ts-node --transpile-only --require tsconfig-paths/register examples/burned-in-captions/basic-example.ts",
-    "example:burned-in:compare": "npx ts-node --transpile-only --require tsconfig-paths/register examples/burned-in-captions/provider-comparison.ts",
-    "example:summarization": "npx ts-node --transpile-only --require tsconfig-paths/register examples/summarization/basic-example.ts",
-    "example:summarization:compare": "npx ts-node --transpile-only --require tsconfig-paths/register examples/summarization/provider-comparison.ts",
-    "example:signed-playback": "npx ts-node --transpile-only --require tsconfig-paths/register examples/signed-playback/signed-playback.ts",
-    "example:signed-playback:summarization": "npx ts-node --transpile-only --require tsconfig-paths/register examples/signed-playback/signed-summarization.ts",
-    "example:moderation": "npx ts-node --transpile-only --require tsconfig-paths/register examples/moderation/basic-example.ts",
-    "example:moderation:compare": "npx ts-node --transpile-only --require tsconfig-paths/register examples/moderation/provider-comparison.ts",
-    "example:embeddings": "npx ts-node --transpile-only --require tsconfig-paths/register examples/embeddings/basic-example.ts",
-    "example:translate-captions": "npx ts-node --transpile-only --require tsconfig-paths/register examples/translate-captions/basic-example.ts",
-    "example:translate-audio": "npx ts-node --transpile-only --require tsconfig-paths/register examples/translate-audio/basic-example.ts",
+    "example:chapters": "npx tsx examples/chapters/basic-example.ts",
+    "example:chapters:compare": "npx tsx examples/chapters/provider-comparison.ts",
+    "example:burned-in": "npx tsx examples/burned-in-captions/basic-example.ts",
+    "example:burned-in:compare": "npx tsx examples/burned-in-captions/provider-comparison.ts",
+    "example:summarization": "npx tsx examples/summarization/basic-example.ts",
+    "example:summarization:compare": "npx tsx examples/summarization/provider-comparison.ts",
+    "example:signed-playback": "npx tsx examples/signed-playback/signed-playback.ts",
+    "example:signed-playback:summarization": "npx tsx examples/signed-playback/signed-summarization.ts",
+    "example:moderation": "npx tsx examples/moderation/basic-example.ts",
+    "example:moderation:compare": "npx tsx examples/moderation/provider-comparison.ts",
+    "example:embeddings": "npx tsx examples/embeddings/basic-example.ts",
+    "example:translate-captions": "npx tsx examples/translate-captions/basic-example.ts",
+    "example:translate-audio": "npx tsx examples/translate-audio/basic-example.ts",
     "prepare": "husky"
   },
   "dependencies": {
@@ -107,6 +103,7 @@
     "@aws-sdk/s3-request-presigner": "^3.0.0",
     "@mux/mux-node": "^12.5.0",
     "ai": "^5.0.98",
+    "dedent": "^1.7.0",
     "dotenv": "^17.2.2",
     "dotenv-expand": "^12.0.3",
     "p-retry": "^7.0.0",
@@ -121,11 +118,12 @@
     "eslint-plugin-format": "^1.0.2",
     "evalite": "1.0.0-beta.2",
     "husky": "^9.1.7",
-    "jest": "^29.0.0",
+    "nitro": "^3.0.1-alpha.1",
     "ts-node": "^10.9.2",
     "tsconfig-paths": "^4.2.0",
     "tsup": "^8.5.0",
     "typescript": "^5.0.0",
-    "vitest": "^4.0.13"
+    "vitest": "^4.0.13",
+    "workflow": "^4.0.1-beta.28"
   }
 }

package/dist/index-BNnz9P_5.d.mts

@@ -1,144 +0,0 @@
-import { A as AssetTextTrack, b as MuxAsset, e as TextChunk, C as ChunkingStrategy } from './types-ktXDZ93V.mjs';
-
-/**
- * Context required to sign URLs for signed playback IDs.
- */
-interface SigningContext {
-    /** The signing key ID from Mux dashboard. */
-    keyId: string;
-    /** The base64-encoded private key from Mux dashboard. */
-    keySecret: string;
-    /** Token expiration time (e.g. '1h', '1d'). Defaults to '1h'. */
-    expiration?: string;
-}
-
-declare const DEFAULT_STORYBOARD_WIDTH = 640;
-/**
- * Generates a storyboard URL for the given playback ID.
- * If a signing context is provided, the URL will be signed with a token.
- *
- * @param playbackId - The Mux playback ID
- * @param width - Width of the storyboard in pixels (default: 640)
- * @param signingContext - Optional signing context for signed playback IDs
- * @returns Storyboard URL (signed if context provided)
- */
-declare function getStoryboardUrl(playbackId: string, width?: number, signingContext?: SigningContext): Promise<string>;
-
-/** A single cue from a VTT file with timing info. */
-interface VTTCue {
-    startTime: number;
-    endTime: number;
-    text: string;
-}
-interface TranscriptFetchOptions {
-    languageCode?: string;
-    cleanTranscript?: boolean;
-    /** Optional signing context for signed playback IDs */
-    signingContext?: SigningContext;
-}
-interface TranscriptResult {
-    transcriptText: string;
-    transcriptUrl?: string;
-    track?: AssetTextTrack;
-}
-declare function getReadyTextTracks(asset: MuxAsset): AssetTextTrack[];
-declare function findCaptionTrack(asset: MuxAsset, languageCode?: string): AssetTextTrack | undefined;
-declare function extractTextFromVTT(vttContent: string): string;
-declare function vttTimestampToSeconds(timestamp: string): number;
-declare function extractTimestampedTranscript(vttContent: string): string;
-/**
- * Parses VTT content into structured cues with timing.
- *
- * @param vttContent - Raw VTT file content
- * @returns Array of VTT cues with start/end times and text
- */
-declare function parseVTTCues(vttContent: string): VTTCue[];
-/**
- * Builds a transcript URL for the given playback ID and track ID.
- * If a signing context is provided, the URL will be signed with a token.
- *
- * @param playbackId - The Mux playback ID
- * @param trackId - The text track ID
- * @param signingContext - Optional signing context for signed playback IDs
- * @returns Transcript URL (signed if context provided)
- */
-declare function buildTranscriptUrl(playbackId: string, trackId: string, signingContext?: SigningContext): Promise<string>;
-declare function fetchTranscriptForAsset(asset: MuxAsset, playbackId: string, options?: TranscriptFetchOptions): Promise<TranscriptResult>;
-
-/**
- * Simple token counter that approximates tokens by word count.
- * For production use with OpenAI, consider using a proper tokenizer like tiktoken.
- * This approximation is generally close enough for chunking purposes (1 token ≈ 0.75 words).
- */
-declare function estimateTokenCount(text: string): number;
-/**
- * Chunks text into overlapping segments based on token count.
- *
- * @param text - The text to chunk
- * @param maxTokens - Maximum tokens per chunk
- * @param overlapTokens - Number of tokens to overlap between chunks
- * @returns Array of text chunks with metadata
- */
-declare function chunkByTokens(text: string, maxTokens: number, overlapTokens?: number): TextChunk[];
-/**
- * Chunks VTT cues into groups that respect natural cue boundaries.
- * Splits at cue boundaries rather than mid-sentence, preserving accurate timestamps.
- *
- * @param cues - Array of VTT cues to chunk
- * @param maxTokens - Maximum tokens per chunk
- * @param overlapCues - Number of cues to overlap between chunks (default: 2)
- * @returns Array of text chunks with accurate start/end times
- */
-declare function chunkVTTCues(cues: VTTCue[], maxTokens: number, overlapCues?: number): TextChunk[];
-/**
- * Chunks text according to the specified strategy.
- *
- * @param text - The text to chunk
- * @param strategy - The chunking strategy to use
- * @returns Array of text chunks
- */
-declare function chunkText(text: string, strategy: ChunkingStrategy): TextChunk[];
-
-interface ThumbnailOptions {
-    /** Interval between thumbnails in seconds (default: 10) */
-    interval?: number;
-    /** Width of the thumbnail in pixels (default: 640) */
-    width?: number;
-    /** Optional signing context for signed playback IDs */
-    signingContext?: SigningContext;
-}
-/**
- * Generates thumbnail URLs at regular intervals based on video duration.
- * If a signing context is provided, the URLs will be signed with tokens.
- *
- * @param playbackId - The Mux playback ID
- * @param duration - Video duration in seconds
- * @param options - Thumbnail generation options
- * @returns Array of thumbnail URLs (signed if context provided)
- */
-declare function getThumbnailUrls(playbackId: string, duration: number, options?: ThumbnailOptions): Promise<string[]>;
-
-declare const index_DEFAULT_STORYBOARD_WIDTH: typeof DEFAULT_STORYBOARD_WIDTH;
-type index_ThumbnailOptions = ThumbnailOptions;
-type index_TranscriptFetchOptions = TranscriptFetchOptions;
-type index_TranscriptResult = TranscriptResult;
-type index_VTTCue = VTTCue;
-declare const index_buildTranscriptUrl: typeof buildTranscriptUrl;
-declare const index_chunkByTokens: typeof chunkByTokens;
-declare const index_chunkText: typeof chunkText;
-declare const index_chunkVTTCues: typeof chunkVTTCues;
-declare const index_estimateTokenCount: typeof estimateTokenCount;
-declare const index_extractTextFromVTT: typeof extractTextFromVTT;
-declare const index_extractTimestampedTranscript: typeof extractTimestampedTranscript;
-declare const index_fetchTranscriptForAsset: typeof fetchTranscriptForAsset;
-declare const index_findCaptionTrack: typeof findCaptionTrack;
-declare const index_getReadyTextTracks: typeof getReadyTextTracks;
-declare const index_getStoryboardUrl: typeof getStoryboardUrl;
-declare const index_getThumbnailUrls: typeof getThumbnailUrls;
-declare const index_parseVTTCues: typeof parseVTTCues;
-declare const index_vttTimestampToSeconds: typeof vttTimestampToSeconds;
-declare namespace index {
-  export { index_DEFAULT_STORYBOARD_WIDTH as DEFAULT_STORYBOARD_WIDTH, type index_ThumbnailOptions as ThumbnailOptions, type index_TranscriptFetchOptions as TranscriptFetchOptions, type index_TranscriptResult as TranscriptResult, type index_VTTCue as VTTCue, index_buildTranscriptUrl as buildTranscriptUrl, index_chunkByTokens as chunkByTokens, index_chunkText as chunkText, index_chunkVTTCues as chunkVTTCues, index_estimateTokenCount as estimateTokenCount, index_extractTextFromVTT as extractTextFromVTT, index_extractTimestampedTranscript as extractTimestampedTranscript, index_fetchTranscriptForAsset as fetchTranscriptForAsset, index_findCaptionTrack as findCaptionTrack, index_getReadyTextTracks as getReadyTextTracks, index_getStoryboardUrl as getStoryboardUrl, index_getThumbnailUrls as getThumbnailUrls, index_parseVTTCues as parseVTTCues, index_vttTimestampToSeconds as vttTimestampToSeconds };
-}
-
-export { DEFAULT_STORYBOARD_WIDTH as D, type ThumbnailOptions as T, type VTTCue as V, chunkVTTCues as a, chunkText as b, chunkByTokens as c, getThumbnailUrls as d, estimateTokenCount as e, type TranscriptFetchOptions as f, getStoryboardUrl as g, type TranscriptResult as h, index as i, getReadyTextTracks as j, findCaptionTrack as k, extractTextFromVTT as l, extractTimestampedTranscript as m, buildTranscriptUrl as n, fetchTranscriptForAsset as o, parseVTTCues as p, vttTimestampToSeconds as v };