@mux/ai 0.1.2 → 0.1.3

package/dist/primitives/index.mjs

@@ -0,0 +1,358 @@
+// src/lib/url-signing.ts
+import Mux from "@mux/mux-node";
+
+// src/env.ts
+import path from "path";
+import { config } from "dotenv";
+import { expand } from "dotenv-expand";
+import { z } from "zod";
+expand(config({
+  path: path.resolve(
+    process.cwd(),
+    process.env.NODE_ENV === "test" ? ".env.test" : ".env"
+  )
+}));
+function optionalString(description, message) {
+  return z.preprocess(
+    (value) => typeof value === "string" && value.trim().length === 0 ? void 0 : value,
+    z.string().trim().min(1, message).optional()
+  ).describe(description);
+}
+function requiredString(description, message) {
+  return z.preprocess(
+    (value) => typeof value === "string" ? value.trim().length > 0 ? value.trim() : void 0 : value,
+    z.string().trim().min(1, message)
+  ).describe(description);
+}
+var EnvSchema = z.object({
+  NODE_ENV: z.string().default("development").describe("Runtime environment."),
+  MUX_TOKEN_ID: requiredString("Mux access token ID.", "Required to access Mux APIs"),
+  MUX_TOKEN_SECRET: requiredString("Mux access token secret.", "Required to access Mux APIs"),
+  MUX_SIGNING_KEY: optionalString("Mux signing key ID for signed playback URLs.", "Used to sign playback URLs"),
+  MUX_PRIVATE_KEY: optionalString("Mux signing private key for signed playback URLs.", "Used to sign playback URLs"),
+  OPENAI_API_KEY: optionalString("OpenAI API key for OpenAI-backed workflows.", "OpenAI API key"),
+  ANTHROPIC_API_KEY: optionalString("Anthropic API key for Claude-backed workflows.", "Anthropic API key"),
+  GOOGLE_GENERATIVE_AI_API_KEY: optionalString("Google Generative AI API key for Gemini-backed workflows.", "Google Generative AI API key"),
+  ELEVENLABS_API_KEY: optionalString("ElevenLabs API key for audio translation.", "ElevenLabs API key"),
+  HIVE_API_KEY: optionalString("Hive Visual Moderation API key.", "Hive API key"),
+  S3_ENDPOINT: optionalString("S3-compatible endpoint for uploads.", "S3 endpoint"),
+  S3_REGION: optionalString("S3 region (defaults to 'auto' when omitted)."),
+  S3_BUCKET: optionalString("Bucket used for caption and audio uploads.", "S3 bucket"),
+  S3_ACCESS_KEY_ID: optionalString("Access key ID for S3-compatible uploads.", "S3 access key id"),
+  S3_SECRET_ACCESS_KEY: optionalString("Secret access key for S3-compatible uploads.", "S3 secret access key")
+});
+function parseEnv() {
+  const parsedEnv = EnvSchema.safeParse(process.env);
+  if (!parsedEnv.success) {
+    console.error("\u274C Invalid env:");
+    console.error(JSON.stringify(parsedEnv.error.flatten().fieldErrors, null, 2));
+    process.exit(1);
+  }
+  return parsedEnv.data;
+}
+var env = parseEnv();
+var env_default = env;
+
+// src/lib/url-signing.ts
+function createSigningClient(context) {
+  return new Mux({
+    // These are not needed for signing, but the SDK requires them
+    // Using empty strings as we only need the jwt functionality
+    tokenId: env_default.MUX_TOKEN_ID || "",
+    tokenSecret: env_default.MUX_TOKEN_SECRET || "",
+    jwtSigningKey: context.keyId,
+    jwtPrivateKey: context.keySecret
+  });
+}
+async function signPlaybackId(playbackId, context, type = "video", params) {
+  const client = createSigningClient(context);
+  const stringParams = params ? Object.fromEntries(
+    Object.entries(params).map(([key, value]) => [key, String(value)])
+  ) : void 0;
+  return client.jwt.signPlaybackId(playbackId, {
+    type,
+    expiration: context.expiration || "1h",
+    params: stringParams
+  });
+}
+async function signUrl(url, playbackId, context, type = "video", params) {
+  const token = await signPlaybackId(playbackId, context, type, params);
+  const separator = url.includes("?") ? "&" : "?";
+  return `${url}${separator}token=${token}`;
+}
+
+// src/primitives/storyboards.ts
+var DEFAULT_STORYBOARD_WIDTH = 640;
+async function getStoryboardUrl(playbackId, width = DEFAULT_STORYBOARD_WIDTH, signingContext) {
+  const baseUrl = `https://image.mux.com/${playbackId}/storyboard.png`;
+  if (signingContext) {
+    return signUrl(baseUrl, playbackId, signingContext, "storyboard", { width });
+  }
+  return `${baseUrl}?width=${width}`;
+}
+
+// src/primitives/text-chunking.ts
+function estimateTokenCount(text) {
+  const words = text.trim().split(/\s+/).length;
+  return Math.ceil(words / 0.75);
+}
+function chunkByTokens(text, maxTokens, overlapTokens = 0) {
+  if (!text.trim()) {
+    return [];
+  }
+  const chunks = [];
+  const words = text.trim().split(/\s+/);
+  const wordsPerChunk = Math.floor(maxTokens * 0.75);
+  const overlapWords = Math.floor(overlapTokens * 0.75);
+  let chunkIndex = 0;
+  let currentPosition = 0;
+  while (currentPosition < words.length) {
+    const chunkWords = words.slice(
+      currentPosition,
+      currentPosition + wordsPerChunk
+    );
+    const chunkText2 = chunkWords.join(" ");
+    const tokenCount = estimateTokenCount(chunkText2);
+    chunks.push({
+      id: `chunk-${chunkIndex}`,
+      text: chunkText2,
+      tokenCount
+    });
+    currentPosition += wordsPerChunk - overlapWords;
+    chunkIndex++;
+    if (currentPosition <= (chunkIndex - 1) * (wordsPerChunk - overlapWords)) {
+      break;
+    }
+  }
+  return chunks;
+}
+function createChunkFromCues(cues, index) {
+  const text = cues.map((c) => c.text).join(" ");
+  return {
+    id: `chunk-${index}`,
+    text,
+    tokenCount: estimateTokenCount(text),
+    startTime: cues[0].startTime,
+    endTime: cues[cues.length - 1].endTime
+  };
+}
+function chunkVTTCues(cues, maxTokens, overlapCues = 2) {
+  if (cues.length === 0)
+    return [];
+  const chunks = [];
+  let currentCues = [];
+  let currentTokens = 0;
+  let chunkIndex = 0;
+  for (let i = 0; i < cues.length; i++) {
+    const cue = cues[i];
+    const cueTokens = estimateTokenCount(cue.text);
+    if (currentTokens + cueTokens > maxTokens && currentCues.length > 0) {
+      chunks.push(createChunkFromCues(currentCues, chunkIndex));
+      chunkIndex++;
+      const overlapStart = Math.max(0, currentCues.length - overlapCues);
+      currentCues = currentCues.slice(overlapStart);
+      currentTokens = currentCues.reduce(
+        (sum, c) => sum + estimateTokenCount(c.text),
+        0
+      );
+    }
+    currentCues.push(cue);
+    currentTokens += cueTokens;
+  }
+  if (currentCues.length > 0) {
+    chunks.push(createChunkFromCues(currentCues, chunkIndex));
+  }
+  return chunks;
+}
+function chunkText(text, strategy) {
+  switch (strategy.type) {
+    case "token": {
+      return chunkByTokens(text, strategy.maxTokens, strategy.overlap ?? 0);
+    }
+    default: {
+      const exhaustiveCheck = strategy;
+      throw new Error(`Unsupported chunking strategy: ${exhaustiveCheck}`);
+    }
+  }
+}
+
+// src/primitives/thumbnails.ts
+async function getThumbnailUrls(playbackId, duration, options = {}) {
+  const { interval = 10, width = 640, signingContext } = options;
+  const timestamps = [];
+  if (duration <= 50) {
+    const spacing = duration / 6;
+    for (let i = 1; i <= 5; i++) {
+      timestamps.push(Math.round(i * spacing));
+    }
+  } else {
+    for (let time = 0; time < duration; time += interval) {
+      timestamps.push(time);
+    }
+  }
+  const baseUrl = `https://image.mux.com/${playbackId}/thumbnail.png`;
+  const urlPromises = timestamps.map(async (time) => {
+    if (signingContext) {
+      return signUrl(baseUrl, playbackId, signingContext, "thumbnail", { time, width });
+    }
+    return `${baseUrl}?time=${time}&width=${width}`;
+  });
+  return Promise.all(urlPromises);
+}
+
+// src/primitives/transcripts.ts
+function getReadyTextTracks(asset) {
+  return (asset.tracks || []).filter(
+    (track) => track.type === "text" && track.status === "ready"
+  );
+}
+function findCaptionTrack(asset, languageCode) {
+  const tracks = getReadyTextTracks(asset);
+  if (!tracks.length)
+    return void 0;
+  if (!languageCode) {
+    return tracks[0];
+  }
+  return tracks.find(
+    (track) => track.text_type === "subtitles" && track.language_code === languageCode
+  );
+}
+function extractTextFromVTT(vttContent) {
+  if (!vttContent.trim()) {
+    return "";
+  }
+  const lines = vttContent.split("\n");
+  const textLines = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (!line)
+      continue;
+    if (line === "WEBVTT")
+      continue;
+    if (line.startsWith("NOTE "))
+      continue;
+    if (line.includes("-->"))
+      continue;
+    if (/^[\w-]+$/.test(line) && !line.includes(" "))
+      continue;
+    if (line.startsWith("STYLE") || line.startsWith("REGION"))
+      continue;
+    const cleanLine = line.replace(/<[^>]*>/g, "").trim();
+    if (cleanLine) {
+      textLines.push(cleanLine);
+    }
+  }
+  return textLines.join(" ").replace(/\s+/g, " ").trim();
+}
+function vttTimestampToSeconds(timestamp) {
+  const parts = timestamp.split(":");
+  if (parts.length !== 3)
+    return 0;
+  const hours = Number.parseInt(parts[0], 10) || 0;
+  const minutes = Number.parseInt(parts[1], 10) || 0;
+  const seconds = Number.parseFloat(parts[2]) || 0;
+  return hours * 3600 + minutes * 60 + seconds;
+}
+function extractTimestampedTranscript(vttContent) {
+  if (!vttContent.trim()) {
+    return "";
+  }
+  const lines = vttContent.split("\n");
+  const segments = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (line.includes("-->")) {
+      const startTime = line.split(" --> ")[0].trim();
+      const timeInSeconds = vttTimestampToSeconds(startTime);
+      let j = i + 1;
+      while (j < lines.length && !lines[j].trim()) {
+        j++;
+      }
+      if (j < lines.length) {
+        const text = lines[j].trim().replace(/<[^>]*>/g, "");
+        if (text) {
+          segments.push({ time: timeInSeconds, text });
+        }
+      }
+    }
+  }
+  return segments.map((segment) => `[${Math.floor(segment.time)}s] ${segment.text}`).join("\n");
+}
+function parseVTTCues(vttContent) {
+  if (!vttContent.trim())
+    return [];
+  const lines = vttContent.split("\n");
+  const cues = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (line.includes("-->")) {
+      const [startStr, endStr] = line.split(" --> ").map((s) => s.trim());
+      const startTime = vttTimestampToSeconds(startStr);
+      const endTime = vttTimestampToSeconds(endStr.split(" ")[0]);
+      const textLines = [];
+      let j = i + 1;
+      while (j < lines.length && lines[j].trim() && !lines[j].includes("-->")) {
+        const cleanLine = lines[j].trim().replace(/<[^>]*>/g, "");
+        if (cleanLine)
+          textLines.push(cleanLine);
+        j++;
+      }
+      if (textLines.length > 0) {
+        cues.push({
+          startTime,
+          endTime,
+          text: textLines.join(" ")
+        });
+      }
+    }
+  }
+  return cues;
+}
+async function buildTranscriptUrl(playbackId, trackId, signingContext) {
+  const baseUrl = `https://stream.mux.com/${playbackId}/text/${trackId}.vtt`;
+  if (signingContext) {
+    return signUrl(baseUrl, playbackId, signingContext, "video");
+  }
+  return baseUrl;
+}
+async function fetchTranscriptForAsset(asset, playbackId, options = {}) {
+  const { languageCode, cleanTranscript = true, signingContext } = options;
+  const track = findCaptionTrack(asset, languageCode);
+  if (!track) {
+    return { transcriptText: "" };
+  }
+  if (!track.id) {
+    return { transcriptText: "", track };
+  }
+  const transcriptUrl = await buildTranscriptUrl(playbackId, track.id, signingContext);
+  try {
+    const response = await fetch(transcriptUrl);
+    if (!response.ok) {
+      return { transcriptText: "", transcriptUrl, track };
+    }
+    const rawVtt = await response.text();
+    const transcriptText = cleanTranscript ? extractTextFromVTT(rawVtt) : rawVtt;
+    return { transcriptText, transcriptUrl, track };
+  } catch (error) {
+    console.warn("Failed to fetch transcript:", error);
+    return { transcriptText: "", transcriptUrl, track };
+  }
+}
+export {
+  DEFAULT_STORYBOARD_WIDTH,
+  buildTranscriptUrl,
+  chunkByTokens,
+  chunkText,
+  chunkVTTCues,
+  estimateTokenCount,
+  extractTextFromVTT,
+  extractTimestampedTranscript,
+  fetchTranscriptForAsset,
+  findCaptionTrack,
+  getReadyTextTracks,
+  getStoryboardUrl,
+  getThumbnailUrls,
+  parseVTTCues,
+  vttTimestampToSeconds
+};
+//# sourceMappingURL=index.mjs.map

package/dist/primitives/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/url-signing.ts","../../src/env.ts","../../src/primitives/storyboards.ts","../../src/primitives/text-chunking.ts","../../src/primitives/thumbnails.ts","../../src/primitives/transcripts.ts"],"sourcesContent":["import Mux from \"@mux/mux-node\";\n\nimport env from \"../env\";\nimport type { MuxAIConfig } from \"../types\";\n\n/**\n * Context required to sign URLs for signed playback IDs.\n */\nexport interface SigningContext {\n  /** The signing key ID from Mux dashboard. */\n  keyId: string;\n  /** The base64-encoded private key from Mux dashboard. */\n  keySecret: string;\n  /** Token expiration time (e.g. '1h', '1d'). Defaults to '1h'. */\n  expiration?: string;\n}\n\n/**\n * Token type determines which Mux service the token is valid for.\n */\nexport type TokenType = \"video\" | \"thumbnail\" | \"storyboard\" | \"gif\";\n\n/**\n * Resolves signing context from config or environment variables.\n * Returns undefined if signing keys are not configured.\n */\nexport function resolveSigningContext(config: MuxAIConfig): SigningContext | undefined {\n  const keyId = config.muxSigningKey ?? env.MUX_SIGNING_KEY;\n  const keySecret = config.muxPrivateKey ?? env.MUX_PRIVATE_KEY;\n\n  if (!keyId || !keySecret) {\n    return undefined;\n  }\n\n  return { keyId, keySecret };\n}\n\n/**\n * Creates a Mux client configured for JWT signing.\n * This client is used internally for signing operations.\n */\nfunction createSigningClient(context: SigningContext): Mux {\n  return new Mux({\n    // These are not needed for signing, but the SDK requires them\n    // Using empty strings as we only need the jwt functionality\n    tokenId: env.MUX_TOKEN_ID || \"\",\n    tokenSecret: env.MUX_TOKEN_SECRET || \"\",\n    jwtSigningKey: context.keyId,\n    jwtPrivateKey: context.keySecret,\n  });\n}\n\n/**\n * Generates a signed token for a playback ID using the Mux SDK.\n *\n * @param playbackId - The Mux playback ID to sign\n * @param context - Signing context with key credentials\n * @param type - Token type (video, thumbnail, storyboard, gif)\n * @param params - Additional parameters for thumbnail/storyboard tokens (values will be stringified)\n * @returns Signed JWT token\n */\nexport async function signPlaybackId(\n  playbackId: string,\n  context: SigningContext,\n  type: TokenType = \"video\",\n  params?: Record<string, string | number>,\n): Promise<string> {\n  const client = createSigningClient(context);\n\n  // Convert params to Record<string, string> as required by the SDK\n  const stringParams = params ?\n      Object.fromEntries(\n        Object.entries(params).map(([key, value]) => [key, String(value)]),\n      ) :\n    undefined;\n\n  return client.jwt.signPlaybackId(playbackId, {\n    type,\n    expiration: context.expiration || \"1h\",\n    params: stringParams,\n  });\n}\n\n/**\n * Appends a signed token to a Mux URL.\n *\n * @param url - The base Mux URL (e.g. https://image.mux.com/{playbackId}/thumbnail.png)\n * @param playbackId - The Mux playback ID\n * @param context - Signing context with key credentials\n * @param type - Token type for the URL\n * @param params - Additional parameters for the token\n * @returns URL with token query parameter appended\n */\nexport async function signUrl(\n  url: string,\n  playbackId: string,\n  context: SigningContext,\n  type: TokenType = \"video\",\n  params?: Record<string, string | number>,\n): Promise<string> {\n  const token = await signPlaybackId(playbackId, context, type, params);\n  const separator = url.includes(\"?\") ? \"&\" : \"?\";\n  return `${url}${separator}token=${token}`;\n}\n","/* eslint-disable node/no-process-env */\nimport path from \"node:path\";\n\nimport { config } from \"dotenv\";\nimport { expand } from \"dotenv-expand\";\nimport { z } from \"zod\";\n\nexpand(config({\n  path: path.resolve(\n    process.cwd(),\n    process.env.NODE_ENV === \"test\" ? \".env.test\" : \".env\",\n  ),\n}));\n\nfunction optionalString(description: string, message?: string) {\n  return z.preprocess(\n    value => typeof value === \"string\" && value.trim().length === 0 ? undefined : value,\n    z.string().trim().min(1, message).optional(),\n  ).describe(description);\n}\n\nfunction requiredString(description: string, message?: string) {\n  return z.preprocess(\n    value => typeof value === \"string\" ? value.trim().length > 0 ? value.trim() : undefined : value,\n    z.string().trim().min(1, message),\n  ).describe(description);\n}\n\nconst EnvSchema = z.object({\n  NODE_ENV: z.string().default(\"development\").describe(\"Runtime environment.\"),\n\n  MUX_TOKEN_ID: requiredString(\"Mux access token ID.\", \"Required to access Mux APIs\"),\n  MUX_TOKEN_SECRET: requiredString(\"Mux access token secret.\", \"Required to access Mux APIs\"),\n\n  MUX_SIGNING_KEY: optionalString(\"Mux signing key ID for signed playback URLs.\", \"Used to sign playback URLs\"),\n  MUX_PRIVATE_KEY: optionalString(\"Mux signing private key for signed playback URLs.\", \"Used to sign playback URLs\"),\n\n  OPENAI_API_KEY: optionalString(\"OpenAI API key for OpenAI-backed workflows.\", \"OpenAI API key\"),\n  ANTHROPIC_API_KEY: optionalString(\"Anthropic API key for Claude-backed workflows.\", \"Anthropic API key\"),\n  GOOGLE_GENERATIVE_AI_API_KEY: optionalString(\"Google Generative AI API key for Gemini-backed workflows.\", \"Google Generative AI API key\"),\n\n  ELEVENLABS_API_KEY: optionalString(\"ElevenLabs API key for audio translation.\", \"ElevenLabs API key\"),\n  HIVE_API_KEY: optionalString(\"Hive Visual Moderation API key.\", \"Hive API key\"),\n\n  S3_ENDPOINT: optionalString(\"S3-compatible endpoint for uploads.\", \"S3 endpoint\"),\n  S3_REGION: optionalString(\"S3 region (defaults to 'auto' when omitted).\"),\n  S3_BUCKET: optionalString(\"Bucket used for caption and audio uploads.\", \"S3 bucket\"),\n  S3_ACCESS_KEY_ID: optionalString(\"Access key ID for S3-compatible uploads.\", \"S3 access key id\"),\n  S3_SECRET_ACCESS_KEY: optionalString(\"Secret access key for S3-compatible uploads.\", \"S3 secret access key\"),\n});\n\nexport type Env = z.infer<typeof EnvSchema>;\n\nfunction parseEnv(): Env {\n  const parsedEnv = EnvSchema.safeParse(process.env);\n\n  if (!parsedEnv.success) {\n    console.error(\"❌ Invalid env:\");\n    console.error(JSON.stringify(parsedEnv.error.flatten().fieldErrors, null, 2));\n    process.exit(1);\n  }\n\n  return parsedEnv.data;\n}\n\nconst env: Env = parseEnv();\n\nexport function reloadEnv(): Env {\n  const parsed = parseEnv();\n  Object.assign(env, parsed);\n  return env;\n}\n\nexport { env };\nexport default env;\n","import type { SigningContext } from \"../lib/url-signing\";\nimport { signUrl } from \"../lib/url-signing\";\n\nexport const DEFAULT_STORYBOARD_WIDTH = 640;\n\n/**\n * Generates a storyboard URL for the given playback ID.\n * If a signing context is provided, the URL will be signed with a token.\n *\n * @param playbackId - The Mux playback ID\n * @param width - Width of the storyboard in pixels (default: 640)\n * @param signingContext - Optional signing context for signed playback IDs\n * @returns Storyboard URL (signed if context provided)\n */\nexport async function getStoryboardUrl(\n  playbackId: string,\n  width: number = DEFAULT_STORYBOARD_WIDTH,\n  signingContext?: SigningContext,\n): Promise<string> {\n  const baseUrl = `https://image.mux.com/${playbackId}/storyboard.png`;\n\n  if (signingContext) {\n    return signUrl(baseUrl, playbackId, signingContext, \"storyboard\", { width });\n  }\n\n  return `${baseUrl}?width=${width}`;\n}\n","import type { ChunkingStrategy, TextChunk } from \"../types\";\n\nimport type { VTTCue } from \"./transcripts\";\n\n/**\n * Simple token counter that approximates tokens by word count.\n * For production use with OpenAI, consider using a proper tokenizer like tiktoken.\n * This approximation is generally close enough for chunking purposes (1 token ≈ 0.75 words).\n */\nexport function estimateTokenCount(text: string): number {\n  const words = text.trim().split(/\\s+/).length;\n  return Math.ceil(words / 0.75);\n}\n\n/**\n * Chunks text into overlapping segments based on token count.\n *\n * @param text - The text to chunk\n * @param maxTokens - Maximum tokens per chunk\n * @param overlapTokens - Number of tokens to overlap between chunks\n * @returns Array of text chunks with metadata\n */\nexport function chunkByTokens(\n  text: string,\n  maxTokens: number,\n  overlapTokens: number = 0,\n): TextChunk[] {\n  if (!text.trim()) {\n    return [];\n  }\n\n  const chunks: TextChunk[] = [];\n  const words = text.trim().split(/\\s+/);\n\n  // Convert tokens to approximate word count\n  const wordsPerChunk = Math.floor(maxTokens * 0.75);\n  const overlapWords = Math.floor(overlapTokens * 0.75);\n\n  let chunkIndex = 0;\n  let currentPosition = 0;\n\n  while (currentPosition < words.length) {\n    const chunkWords = words.slice(\n      currentPosition,\n      currentPosition + wordsPerChunk,\n    );\n    const chunkText = chunkWords.join(\" \");\n    const tokenCount = estimateTokenCount(chunkText);\n\n    chunks.push({\n      id: `chunk-${chunkIndex}`,\n      text: chunkText,\n      tokenCount,\n    });\n\n    // Move forward by chunk size minus overlap\n    currentPosition += wordsPerChunk - overlapWords;\n    chunkIndex++;\n\n    // Prevent infinite loop if overlap is too large\n    if (currentPosition <= (chunkIndex - 1) * (wordsPerChunk - overlapWords)) {\n      break;\n    }\n  }\n\n  return chunks;\n}\n\n/**\n * Creates a TextChunk from a group of VTT cues.\n */\nfunction createChunkFromCues(cues: VTTCue[], index: number): TextChunk {\n  const text = cues.map(c => c.text).join(\" \");\n  return {\n    id: `chunk-${index}`,\n    text,\n    tokenCount: estimateTokenCount(text),\n    startTime: cues[0].startTime,\n    endTime: cues[cues.length - 1].endTime,\n  };\n}\n\n/**\n * Chunks VTT cues into groups that respect natural cue boundaries.\n * Splits at cue boundaries rather than mid-sentence, preserving accurate timestamps.\n *\n * @param cues - Array of VTT cues to chunk\n * @param maxTokens - Maximum tokens per chunk\n * @param overlapCues - Number of cues to overlap between chunks (default: 2)\n * @returns Array of text chunks with accurate start/end times\n */\nexport function chunkVTTCues(\n  cues: VTTCue[],\n  maxTokens: number,\n  overlapCues: number = 2,\n): TextChunk[] {\n  if (cues.length === 0)\n    return [];\n\n  const chunks: TextChunk[] = [];\n  let currentCues: VTTCue[] = [];\n  let currentTokens = 0;\n  let chunkIndex = 0;\n\n  for (let i = 0; i < cues.length; i++) {\n    const cue = cues[i];\n    const cueTokens = estimateTokenCount(cue.text);\n\n    // If adding this cue would exceed limit, finalize current chunk\n    if (currentTokens + cueTokens > maxTokens && currentCues.length > 0) {\n      chunks.push(createChunkFromCues(currentCues, chunkIndex));\n      chunkIndex++;\n\n      // Start new chunk with overlap from end of previous\n      const overlapStart = Math.max(0, currentCues.length - overlapCues);\n      currentCues = currentCues.slice(overlapStart);\n      currentTokens = currentCues.reduce(\n        (sum, c) => sum + estimateTokenCount(c.text),\n        0,\n      );\n    }\n\n    currentCues.push(cue);\n    currentTokens += cueTokens;\n  }\n\n  // Don't forget the last chunk\n  if (currentCues.length > 0) {\n    chunks.push(createChunkFromCues(currentCues, chunkIndex));\n  }\n\n  return chunks;\n}\n\n/**\n * Chunks text according to the specified strategy.\n *\n * @param text - The text to chunk\n * @param strategy - The chunking strategy to use\n * @returns Array of text chunks\n */\nexport function chunkText(text: string, strategy: ChunkingStrategy): TextChunk[] {\n  switch (strategy.type) {\n    case \"token\": {\n      return chunkByTokens(text, strategy.maxTokens, strategy.overlap ?? 0);\n    }\n    default: {\n      const exhaustiveCheck: never = strategy as never;\n      throw new Error(`Unsupported chunking strategy: ${exhaustiveCheck}`);\n    }\n  }\n}\n","import type { SigningContext } from \"../lib/url-signing\";\nimport { signUrl } from \"../lib/url-signing\";\n\nexport interface ThumbnailOptions {\n  /** Interval between thumbnails in seconds (default: 10) */\n  interval?: number;\n  /** Width of the thumbnail in pixels (default: 640) */\n  width?: number;\n  /** Optional signing context for signed playback IDs */\n  signingContext?: SigningContext;\n}\n\n/**\n * Generates thumbnail URLs at regular intervals based on video duration.\n * If a signing context is provided, the URLs will be signed with tokens.\n *\n * @param playbackId - The Mux playback ID\n * @param duration - Video duration in seconds\n * @param options - Thumbnail generation options\n * @returns Array of thumbnail URLs (signed if context provided)\n */\nexport async function getThumbnailUrls(\n  playbackId: string,\n  duration: number,\n  options: ThumbnailOptions = {},\n): Promise<string[]> {\n  const { interval = 10, width = 640, signingContext } = options;\n  const timestamps: number[] = [];\n\n  if (duration <= 50) {\n    const spacing = duration / 6;\n    for (let i = 1; i <= 5; i++) {\n      timestamps.push(Math.round(i * spacing));\n    }\n  } else {\n    for (let time = 0; time < duration; time += interval) {\n      timestamps.push(time);\n    }\n  }\n\n  const baseUrl = `https://image.mux.com/${playbackId}/thumbnail.png`;\n\n  const urlPromises = timestamps.map(async (time) => {\n    if (signingContext) {\n      return signUrl(baseUrl, playbackId, signingContext, \"thumbnail\", { time, width });\n    }\n\n    return `${baseUrl}?time=${time}&width=${width}`;\n  });\n\n  return Promise.all(urlPromises);\n}\n","import type { SigningContext } from \"../lib/url-signing\";\nimport { signUrl } from \"../lib/url-signing\";\nimport type { AssetTextTrack, MuxAsset } from \"../types\";\n\n/** A single cue from a VTT file with timing info. */\nexport interface VTTCue {\n  startTime: number;\n  endTime: number;\n  text: string;\n}\n\nexport interface TranscriptFetchOptions {\n  languageCode?: string;\n  cleanTranscript?: boolean;\n  /** Optional signing context for signed playback IDs */\n  signingContext?: SigningContext;\n}\n\nexport interface TranscriptResult {\n  transcriptText: string;\n  transcriptUrl?: string;\n  track?: AssetTextTrack;\n}\n\nexport function getReadyTextTracks(asset: MuxAsset): AssetTextTrack[] {\n  return (asset.tracks || []).filter(\n    track => track.type === \"text\" && track.status === \"ready\",\n  );\n}\n\nexport function findCaptionTrack(asset: MuxAsset, languageCode?: string): AssetTextTrack | undefined {\n  const tracks = getReadyTextTracks(asset);\n  if (!tracks.length)\n    return undefined;\n\n  if (!languageCode) {\n    return tracks[0];\n  }\n\n  return tracks.find(\n    track =>\n      track.text_type === \"subtitles\" &&\n      track.language_code === languageCode,\n  );\n}\n\nexport function extractTextFromVTT(vttContent: string): string {\n  if (!vttContent.trim()) {\n    return \"\";\n  }\n\n  const lines = vttContent.split(\"\\n\");\n  const textLines: string[] = [];\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i].trim();\n\n    if (!line)\n      continue;\n    if (line === \"WEBVTT\")\n      continue;\n    if (line.startsWith(\"NOTE \"))\n      continue;\n    if (line.includes(\"-->\"))\n      continue;\n    if (/^[\\w-]+$/.test(line) && !line.includes(\" \"))\n      continue;\n    if (line.startsWith(\"STYLE\") || line.startsWith(\"REGION\"))\n      continue;\n\n    const cleanLine = line.replace(/<[^>]*>/g, \"\").trim();\n\n    if (cleanLine) {\n      textLines.push(cleanLine);\n    }\n  }\n\n  return textLines.join(\" \").replace(/\\s+/g, \" \").trim();\n}\n\nexport function vttTimestampToSeconds(timestamp: string): number {\n  const parts = timestamp.split(\":\");\n  if (parts.length !== 3)\n    return 0;\n\n  const hours = Number.parseInt(parts[0], 10) || 0;\n  const minutes = Number.parseInt(parts[1], 10) || 0;\n  const seconds = Number.parseFloat(parts[2]) || 0;\n\n  return hours * 3600 + minutes * 60 + seconds;\n}\n\nexport function extractTimestampedTranscript(vttContent: string): string {\n  if (!vttContent.trim()) {\n    return \"\";\n  }\n\n  const lines = vttContent.split(\"\\n\");\n  const segments: Array<{ time: number; text: string }> = [];\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i].trim();\n\n    if (line.includes(\"-->\")) {\n      const startTime = line.split(\" --> \")[0].trim();\n      const timeInSeconds = vttTimestampToSeconds(startTime);\n\n      let j = i + 1;\n      while (j < lines.length && !lines[j].trim()) {\n        j++;\n      }\n\n      if (j < lines.length) {\n        const text = lines[j].trim().replace(/<[^>]*>/g, \"\");\n        if (text) {\n          segments.push({ time: timeInSeconds, text });\n        }\n      }\n    }\n  }\n\n  return segments\n    .map(segment => `[${Math.floor(segment.time)}s] ${segment.text}`)\n    .join(\"\\n\");\n}\n\n/**\n * Parses VTT content into structured cues with timing.\n *\n * @param vttContent - Raw VTT file content\n * @returns Array of VTT cues with start/end times and text\n */\nexport function parseVTTCues(vttContent: string): VTTCue[] {\n  if (!vttContent.trim())\n    return [];\n\n  const lines = vttContent.split(\"\\n\");\n  const cues: VTTCue[] = [];\n\n  for (let i = 0; i < lines.length; i++) {\n    const line = lines[i].trim();\n\n    if (line.includes(\"-->\")) {\n      const [startStr, endStr] = line.split(\" --> \").map(s => s.trim());\n      const startTime = vttTimestampToSeconds(startStr);\n      const endTime = vttTimestampToSeconds(endStr.split(\" \")[0]); // Handle cue settings\n\n      // Collect text lines until empty line or next timestamp\n      const textLines: string[] = [];\n      let j = i + 1;\n      while (j < lines.length && lines[j].trim() && !lines[j].includes(\"-->\")) {\n        const cleanLine = lines[j].trim().replace(/<[^>]*>/g, \"\");\n        if (cleanLine)\n          textLines.push(cleanLine);\n        j++;\n      }\n\n      if (textLines.length > 0) {\n        cues.push({\n          startTime,\n          endTime,\n          text: textLines.join(\" \"),\n        });\n      }\n    }\n  }\n\n  return cues;\n}\n\n/**\n * Builds a transcript URL for the given playback ID and track ID.\n * If a signing context is provided, the URL will be signed with a token.\n *\n * @param playbackId - The Mux playback ID\n * @param trackId - The text track ID\n * @param signingContext - Optional signing context for signed playback IDs\n * @returns Transcript URL (signed if context provided)\n */\nexport async function buildTranscriptUrl(\n  playbackId: string,\n  trackId: string,\n  signingContext?: SigningContext,\n): Promise<string> {\n  const baseUrl = `https://stream.mux.com/${playbackId}/text/${trackId}.vtt`;\n\n  if (signingContext) {\n    return signUrl(baseUrl, playbackId, signingContext, \"video\");\n  }\n\n  return baseUrl;\n}\n\nexport async function fetchTranscriptForAsset(\n  asset: MuxAsset,\n  playbackId: string,\n  options: TranscriptFetchOptions = {},\n): Promise<TranscriptResult> {\n  const { languageCode, cleanTranscript = true, signingContext } = options;\n  const track = findCaptionTrack(asset, languageCode);\n\n  if (!track) {\n    return { transcriptText: \"\" };\n  }\n\n  if (!track.id) {\n    return { transcriptText: \"\", track };\n  }\n\n  const transcriptUrl = await buildTranscriptUrl(playbackId, track.id, signingContext);\n\n  try {\n    const response = await fetch(transcriptUrl);\n    if (!response.ok) {\n      return { transcriptText: \"\", transcriptUrl, track };\n    }\n\n    const rawVtt = await response.text();\n    const transcriptText = cleanTranscript ? extractTextFromVTT(rawVtt) : rawVtt;\n\n    return { transcriptText, transcriptUrl, track };\n  } catch (error) {\n    console.warn(\"Failed to fetch transcript:\", error);\n    return { transcriptText: \"\", transcriptUrl, track };\n  }\n}\n"],"mappings":";AAAA,OAAO,SAAS;;;ACChB,OAAO,UAAU;AAEjB,SAAS,cAAc;AACvB,SAAS,cAAc;AACvB,SAAS,SAAS;AAElB,OAAO,OAAO;AAAA,EACZ,MAAM,KAAK;AAAA,IACT,QAAQ,IAAI;AAAA,IACZ,QAAQ,IAAI,aAAa,SAAS,cAAc;AAAA,EAClD;AACF,CAAC,CAAC;AAEF,SAAS,eAAe,aAAqB,SAAkB;AAC7D,SAAO,EAAE;AAAA,IACP,WAAS,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,WAAW,IAAI,SAAY;AAAA,IAC9E,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,EAAE,SAAS;AAAA,EAC7C,EAAE,SAAS,WAAW;AACxB;AAEA,SAAS,eAAe,aAAqB,SAAkB;AAC7D,SAAO,EAAE;AAAA,IACP,WAAS,OAAO,UAAU,WAAW,MAAM,KAAK,EAAE,SAAS,IAAI,MAAM,KAAK,IAAI,SAAY;AAAA,IAC1F,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO;AAAA,EAClC,EAAE,SAAS,WAAW;AACxB;AAEA,IAAM,YAAY,EAAE,OAAO;AAAA,EACzB,UAAU,EAAE,OAAO,EAAE,QAAQ,aAAa,EAAE,SAAS,sBAAsB;AAAA,EAE3E,cAAc,eAAe,wBAAwB,6BAA6B;AAAA,EAClF,kBAAkB,eAAe,4BAA4B,6BAA6B;AAAA,EAE1F,iBAAiB,eAAe,gDAAgD,4BAA4B;AAAA,EAC5G,iBAAiB,eAAe,qDAAqD,4BAA4B;AAAA,EAEjH,gBAAgB,eAAe,+CAA+C,gBAAgB;AAAA,EAC9F,mBAAmB,eAAe,kDAAkD,mBAAmB;AAAA,EACvG,8BAA8B,eAAe,6DAA6D,8BAA8B;AAAA,EAExI,oBAAoB,eAAe,6CAA6C,oBAAoB;AAAA,EACpG,cAAc,eAAe,mCAAmC,cAAc;AAAA,EAE9E,aAAa,eAAe,uCAAuC,aAAa;AAAA,EAChF,WAAW,eAAe,8CAA8C;AAAA,EACxE,WAAW,eAAe,8CAA8C,WAAW;AAAA,EACnF,kBAAkB,eAAe,4CAA4C,kBAAkB;AAAA,EAC/F,sBAAsB,eAAe,gDAAgD,sBAAsB;AAC7G,CAAC;AAID,SAAS,WAAgB;AACvB,QAAM,YAAY,UAAU,UAAU,QAAQ,GAAG;AAEjD,MAAI,CAAC,UAAU,SAAS;AACtB,YAAQ,MAAM,qBAAgB;AAC9B,YAAQ,MAAM,KAAK,UAAU,UAAU,MAAM,QAAQ,EAAE,aAAa,MAAM,CAAC,CAAC;AAC5E,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,SAAO,UAAU;AACnB;AAEA,IAAM,MAAW,SAAS;AAS1B,IAAO,cAAQ;;;ADjCf,SAAS,oBAAoB,SAA8B;AACzD,SAAO,IAAI,IAAI;AAAA;AAAA;AAAA,IAGb,SAAS,YAAI,gBAAgB;AAAA,IAC7B,aAAa,YAAI,oBAAoB;AAAA,IACrC,eAAe,QAAQ;AAAA,IACvB,eAAe,QAAQ;AAAA,EACzB,CAAC;AACH;AAWA,eAAsB,eACpB,YACA,SACA,OAAkB,SAClB,QACiB;AACjB,QAAM,SAAS,oBAAoB,OAAO;AAG1C,QAAM,eAAe,SACjB,OAAO;AAAA,IACL,OAAO,QAAQ,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,OAAO,KAAK,CAAC,CAAC;AAAA,EACnE,IACF;AAEF,SAAO,OAAO,IAAI,eAAe,YAAY;AAAA,IAC3C;AAAA,IACA,YAAY,QAAQ,cAAc;AAAA,IAClC,QAAQ;AAAA,EACV,CAAC;AACH;AAYA,eAAsB,QACpB,KACA,YACA,SACA,OAAkB,SAClB,QACiB;AACjB,QAAM,QAAQ,MAAM,eAAe,YAAY,SAAS,MAAM,MAAM;AACpE,QAAM,YAAY,IAAI,SAAS,GAAG,IAAI,MAAM;AAC5C,SAAO,GAAG,GAAG,GAAG,SAAS,SAAS,KAAK;AACzC;;;AEpGO,IAAM,2BAA2B;AAWxC,eAAsB,iBACpB,YACA,QAAgB,0BAChB,gBACiB;AACjB,QAAM,UAAU,yBAAyB,UAAU;AAEnD,MAAI,gBAAgB;AAClB,WAAO,QAAQ,SAAS,YAAY,gBAAgB,cAAc,EAAE,MAAM,CAAC;AAAA,EAC7E;AAEA,SAAO,GAAG,OAAO,UAAU,KAAK;AAClC;;;ACjBO,SAAS,mBAAmB,MAAsB;AACvD,QAAM,QAAQ,KAAK,KAAK,EAAE,MAAM,KAAK,EAAE;AACvC,SAAO,KAAK,KAAK,QAAQ,IAAI;AAC/B;AAUO,SAAS,cACd,MACA,WACA,gBAAwB,GACX;AACb,MAAI,CAAC,KAAK,KAAK,GAAG;AAChB,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,SAAsB,CAAC;AAC7B,QAAM,QAAQ,KAAK,KAAK,EAAE,MAAM,KAAK;AAGrC,QAAM,gBAAgB,KAAK,MAAM,YAAY,IAAI;AACjD,QAAM,eAAe,KAAK,MAAM,gBAAgB,IAAI;AAEpD,MAAI,aAAa;AACjB,MAAI,kBAAkB;AAEtB,SAAO,kBAAkB,MAAM,QAAQ;AACrC,UAAM,aAAa,MAAM;AAAA,MACvB;AAAA,MACA,kBAAkB;AAAA,IACpB;AACA,UAAMA,aAAY,WAAW,KAAK,GAAG;AACrC,UAAM,aAAa,mBAAmBA,UAAS;AAE/C,WAAO,KAAK;AAAA,MACV,IAAI,SAAS,UAAU;AAAA,MACvB,MAAMA;AAAA,MACN;AAAA,IACF,CAAC;AAGD,uBAAmB,gBAAgB;AACnC;AAGA,QAAI,oBAAoB,aAAa,MAAM,gBAAgB,eAAe;AACxE;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAKA,SAAS,oBAAoB,MAAgB,OAA0B;AACrE,QAAM,OAAO,KAAK,IAAI,OAAK,EAAE,IAAI,EAAE,KAAK,GAAG;AAC3C,SAAO;AAAA,IACL,IAAI,SAAS,KAAK;AAAA,IAClB;AAAA,IACA,YAAY,mBAAmB,IAAI;AAAA,IACnC,WAAW,KAAK,CAAC,EAAE;AAAA,IACnB,SAAS,KAAK,KAAK,SAAS,CAAC,EAAE;AAAA,EACjC;AACF;AAWO,SAAS,aACd,MACA,WACA,cAAsB,GACT;AACb,MAAI,KAAK,WAAW;AAClB,WAAO,CAAC;AAEV,QAAM,SAAsB,CAAC;AAC7B,MAAI,cAAwB,CAAC;AAC7B,MAAI,gBAAgB;AACpB,MAAI,aAAa;AAEjB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAClB,UAAM,YAAY,mBAAmB,IAAI,IAAI;AAG7C,QAAI,gBAAgB,YAAY,aAAa,YAAY,SAAS,GAAG;AACnE,aAAO,KAAK,oBAAoB,aAAa,UAAU,CAAC;AACxD;AAGA,YAAM,eAAe,KAAK,IAAI,GAAG,YAAY,SAAS,WAAW;AACjE,oBAAc,YAAY,MAAM,YAAY;AAC5C,sBAAgB,YAAY;AAAA,QAC1B,CAAC,KAAK,MAAM,MAAM,mBAAmB,EAAE,IAAI;AAAA,QAC3C;AAAA,MACF;AAAA,IACF;AAEA,gBAAY,KAAK,GAAG;AACpB,qBAAiB;AAAA,EACnB;AAGA,MAAI,YAAY,SAAS,GAAG;AAC1B,WAAO,KAAK,oBAAoB,aAAa,UAAU,CAAC;AAAA,EAC1D;AAEA,SAAO;AACT;AASO,SAAS,UAAU,MAAc,UAAyC;AAC/E,UAAQ,SAAS,MAAM;AAAA,IACrB,KAAK,SAAS;AACZ,aAAO,cAAc,MAAM,SAAS,WAAW,SAAS,WAAW,CAAC;AAAA,IACtE;AAAA,IACA,SAAS;AACP,YAAM,kBAAyB;AAC/B,YAAM,IAAI,MAAM,kCAAkC,eAAe,EAAE;AAAA,IACrE;AAAA,EACF;AACF;;;AClIA,eAAsB,iBACpB,YACA,UACA,UAA4B,CAAC,GACV;AACnB,QAAM,EAAE,WAAW,IAAI,QAAQ,KAAK,eAAe,IAAI;AACvD,QAAM,aAAuB,CAAC;AAE9B,MAAI,YAAY,IAAI;AAClB,UAAM,UAAU,WAAW;AAC3B,aAAS,IAAI,GAAG,KAAK,GAAG,KAAK;AAC3B,iBAAW,KAAK,KAAK,MAAM,IAAI,OAAO,CAAC;AAAA,IACzC;AAAA,EACF,OAAO;AACL,aAAS,OAAO,GAAG,OAAO,UAAU,QAAQ,UAAU;AACpD,iBAAW,KAAK,IAAI;AAAA,IACtB;AAAA,EACF;AAEA,QAAM,UAAU,yBAAyB,UAAU;AAEnD,QAAM,cAAc,WAAW,IAAI,OAAO,SAAS;AACjD,QAAI,gBAAgB;AAClB,aAAO,QAAQ,SAAS,YAAY,gBAAgB,aAAa,EAAE,MAAM,MAAM,CAAC;AAAA,IAClF;AAEA,WAAO,GAAG,OAAO,SAAS,IAAI,UAAU,KAAK;AAAA,EAC/C,CAAC;AAED,SAAO,QAAQ,IAAI,WAAW;AAChC;;;AC3BO,SAAS,mBAAmB,OAAmC;AACpE,UAAQ,MAAM,UAAU,CAAC,GAAG;AAAA,IAC1B,WAAS,MAAM,SAAS,UAAU,MAAM,WAAW;AAAA,EACrD;AACF;AAEO,SAAS,iBAAiB,OAAiB,cAAmD;AACnG,QAAM,SAAS,mBAAmB,KAAK;AACvC,MAAI,CAAC,OAAO;AACV,WAAO;AAET,MAAI,CAAC,cAAc;AACjB,WAAO,OAAO,CAAC;AAAA,EACjB;AAEA,SAAO,OAAO;AAAA,IACZ,WACE,MAAM,cAAc,eACpB,MAAM,kBAAkB;AAAA,EAC5B;AACF;AAEO,SAAS,mBAAmB,YAA4B;AAC7D,MAAI,CAAC,WAAW,KAAK,GAAG;AACtB,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,WAAW,MAAM,IAAI;AACnC,QAAM,YAAsB,CAAC;AAE7B,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,UAAM,OAAO,MAAM,CAAC,EAAE,KAAK;AAE3B,QAAI,CAAC;AACH;AACF,QAAI,SAAS;AACX;AACF,QAAI,KAAK,WAAW,OAAO;AACzB;AACF,QAAI,KAAK,SAAS,KAAK;AACrB;AACF,QAAI,WAAW,KAAK,IAAI,KAAK,CAAC,KAAK,SAAS,GAAG;AAC7C;AACF,QAAI,KAAK,WAAW,OAAO,KAAK,KAAK,WAAW,QAAQ;AACtD;AAEF,UAAM,YAAY,KAAK,QAAQ,YAAY,EAAE,EAAE,KAAK;AAEpD,QAAI,WAAW;AACb,gBAAU,KAAK,SAAS;AAAA,IAC1B;AAAA,EACF;AAEA,SAAO,UAAU,KAAK,GAAG,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAK;AACvD;AAEO,SAAS,sBAAsB,WAA2B;AAC/D,QAAM,QAAQ,UAAU,MAAM,GAAG;AACjC,MAAI,MAAM,WAAW;AACnB,WAAO;AAET,QAAM,QAAQ,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE,KAAK;AAC/C,QAAM,UAAU,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE,KAAK;AACjD,QAAM,UAAU,OAAO,WAAW,MAAM,CAAC,CAAC,KAAK;AAE/C,SAAO,QAAQ,OAAO,UAAU,KAAK;AACvC;AAEO,SAAS,6BAA6B,YAA4B;AACvE,MAAI,CAAC,WAAW,KAAK,GAAG;AACtB,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,WAAW,MAAM,IAAI;AACnC,QAAM,WAAkD,CAAC;AAEzD,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,UAAM,OAAO,MAAM,CAAC,EAAE,KAAK;AAE3B,QAAI,KAAK,SAAS,KAAK,GAAG;AACxB,YAAM,YAAY,KAAK,MAAM,OAAO,EAAE,CAAC,EAAE,KAAK;AAC9C,YAAM,gBAAgB,sBAAsB,SAAS;AAErD,UAAI,IAAI,IAAI;AACZ,aAAO,IAAI,MAAM,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG;AAC3C;AAAA,MACF;AAEA,UAAI,IAAI,MAAM,QAAQ;AACpB,cAAM,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,YAAY,EAAE;AACnD,YAAI,MAAM;AACR,mBAAS,KAAK,EAAE,MAAM,eAAe,KAAK,CAAC;AAAA,QAC7C;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO,SACJ,IAAI,aAAW,IAAI,KAAK,MAAM,QAAQ,IAAI,CAAC,MAAM,QAAQ,IAAI,EAAE,EAC/D,KAAK,IAAI;AACd;AAQO,SAAS,aAAa,YAA8B;AACzD,MAAI,CAAC,WAAW,KAAK;AACnB,WAAO,CAAC;AAEV,QAAM,QAAQ,WAAW,MAAM,IAAI;AACnC,QAAM,OAAiB,CAAC;AAExB,WAAS,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;AACrC,UAAM,OAAO,MAAM,CAAC,EAAE,KAAK;AAE3B,QAAI,KAAK,SAAS,KAAK,GAAG;AACxB,YAAM,CAAC,UAAU,MAAM,IAAI,KAAK,MAAM,OAAO,EAAE,IAAI,OAAK,EAAE,KAAK,CAAC;AAChE,YAAM,YAAY,sBAAsB,QAAQ;AAChD,YAAM,UAAU,sBAAsB,OAAO,MAAM,GAAG,EAAE,CAAC,CAAC;AAG1D,YAAM,YAAsB,CAAC;AAC7B,UAAI,IAAI,IAAI;AACZ,aAAO,IAAI,MAAM,UAAU,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,GAAG;AACvE,cAAM,YAAY,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,YAAY,EAAE;AACxD,YAAI;AACF,oBAAU,KAAK,SAAS;AAC1B;AAAA,MACF;AAEA,UAAI,UAAU,SAAS,GAAG;AACxB,aAAK,KAAK;AAAA,UACR;AAAA,UACA;AAAA,UACA,MAAM,UAAU,KAAK,GAAG;AAAA,QAC1B,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAWA,eAAsB,mBACpB,YACA,SACA,gBACiB;AACjB,QAAM,UAAU,0BAA0B,UAAU,SAAS,OAAO;AAEpE,MAAI,gBAAgB;AAClB,WAAO,QAAQ,SAAS,YAAY,gBAAgB,OAAO;AAAA,EAC7D;AAEA,SAAO;AACT;AAEA,eAAsB,wBACpB,OACA,YACA,UAAkC,CAAC,GACR;AAC3B,QAAM,EAAE,cAAc,kBAAkB,MAAM,eAAe,IAAI;AACjE,QAAM,QAAQ,iBAAiB,OAAO,YAAY;AAElD,MAAI,CAAC,OAAO;AACV,WAAO,EAAE,gBAAgB,GAAG;AAAA,EAC9B;AAEA,MAAI,CAAC,MAAM,IAAI;AACb,WAAO,EAAE,gBAAgB,IAAI,MAAM;AAAA,EACrC;AAEA,QAAM,gBAAgB,MAAM,mBAAmB,YAAY,MAAM,IAAI,cAAc;AAEnF,MAAI;AACF,UAAM,WAAW,MAAM,MAAM,aAAa;AAC1C,QAAI,CAAC,SAAS,IAAI;AAChB,aAAO,EAAE,gBAAgB,IAAI,eAAe,MAAM;AAAA,IACpD;AAEA,UAAM,SAAS,MAAM,SAAS,KAAK;AACnC,UAAM,iBAAiB,kBAAkB,mBAAmB,MAAM,IAAI;AAEtE,WAAO,EAAE,gBAAgB,eAAe,MAAM;AAAA,EAChD,SAAS,OAAO;AACd,YAAQ,KAAK,+BAA+B,KAAK;AACjD,WAAO,EAAE,gBAAgB,IAAI,eAAe,MAAM;AAAA,EACpD;AACF;","names":["chunkText"]}

package/dist/types-ktXDZ93V.d.mts

@@ -0,0 +1,137 @@
+import Mux from '@mux/mux-node';
+
+/**
+ * Shared credential bag for every workflow. Each property falls back to the
+ * corresponding environment variable when omitted.
+ */
+interface MuxAIConfig {
+    /** Override for the MUX_TOKEN_ID environment variable. */
+    muxTokenId?: string;
+    /** Override for the MUX_TOKEN_SECRET environment variable. */
+    muxTokenSecret?: string;
+    /** Mux signing key ID for signed playback IDs (defaults to the MUX_SIGNING_KEY environment variable). */
+    muxSigningKey?: string;
+    /** Mux signing key private key for signed playback IDs (defaults to the MUX_PRIVATE_KEY environment variable). */
+    muxPrivateKey?: string;
+    /** OpenAI API key (defaults to the OPENAI_API_KEY environment variable). */
+    openaiApiKey?: string;
+    /** Anthropic API key (defaults to the ANTHROPIC_API_KEY environment variable). */
+    anthropicApiKey?: string;
+    /** Google Generative AI API key (defaults to the GOOGLE_GENERATIVE_AI_API_KEY environment variable). */
+    googleApiKey?: string;
+    /** Hive Visual Moderation API key (defaults to the HIVE_API_KEY environment variable). */
+    hiveApiKey?: string;
+}
+/**
+ * Base options mixed into every higher-level workflow configuration.
+ */
+interface MuxAIOptions extends MuxAIConfig {
+    /** Optional timeout (ms) for helper utilities that support request limits. */
+    timeout?: number;
+    /**
+     * Optional cancellation signal passed through to underlying AI SDK calls.
+     * When aborted, in-flight model requests will be
+     * cancelled where supported.
+     */
+    abortSignal?: AbortSignal;
+}
+/** Tone controls for the summarization helper. */
+type ToneType = "normal" | "sassy" | "professional";
+/** Common transport for image-based workflows. */
+type ImageSubmissionMode = "url" | "base64";
+/** Result of calling mux-node's asset retrieval helper. */
+type MuxAsset = Awaited<ReturnType<Mux["video"]["assets"]["retrieve"]>>;
+/** Single ready track extracted from a Mux asset. */
+type AssetTextTrack = NonNullable<MuxAsset["tracks"]>[number];
+/** Playback policy type for Mux assets. */
+type PlaybackPolicy = "public" | "signed";
+/** Convenience bundle returned by `getPlaybackIdForAsset`. */
+interface PlaybackAsset {
+    asset: MuxAsset;
+    playbackId: string;
+    /** The policy type of the playback ID ('public' or 'signed'). */
+    policy: PlaybackPolicy;
+}
+/** Configuration for token-based chunking. */
+interface TokenChunkingConfig {
+    type: "token";
+    /** Maximum tokens per chunk. */
+    maxTokens: number;
+    /** Number of overlapping tokens between chunks. */
+    overlap?: number;
+}
+/** Configuration for VTT-aware chunking that respects cue boundaries. */
+interface VTTChunkingConfig {
+    type: "vtt";
+    /** Maximum tokens per chunk. */
+    maxTokens: number;
+    /** Number of cues to overlap between chunks (default: 2). */
+    overlapCues?: number;
+}
+/** Union type for all chunking strategy configurations. */
+type ChunkingStrategy = TokenChunkingConfig | VTTChunkingConfig;
+/** A single chunk of text extracted from a transcript. */
+interface TextChunk {
+    /** Unique identifier for this chunk. */
+    id: string;
+    /** The text content of the chunk. */
+    text: string;
+    /** Number of tokens in this chunk. */
+    tokenCount: number;
+    /** Start time in seconds (if available from timestamped transcript). */
+    startTime?: number;
+    /** End time in seconds (if available from timestamped transcript). */
+    endTime?: number;
+}
+/** A chunk with its embedding vector. */
+interface ChunkEmbedding {
+    /** Reference to the chunk ID. */
+    chunkId: string;
+    /** The embedding vector. */
+    embedding: number[];
+    /** Optional metadata for this chunk. */
+    metadata: {
+        startTime?: number;
+        endTime?: number;
+        tokenCount: number;
+    };
+}
+/** Result of generating embeddings for a video asset. */
+interface VideoEmbeddingsResult {
+    /** The Mux asset ID. */
+    assetId: string;
+    /** Individual chunk embeddings. */
+    chunks: ChunkEmbedding[];
+    /** Averaged embedding across all chunks. */
+    averagedEmbedding: number[];
+    /** AI provider used. */
+    provider: string;
+    /** Model used for embedding generation. */
+    model: string;
+    /** Additional metadata about the generation. */
+    metadata: {
+        totalChunks: number;
+        totalTokens: number;
+        chunkingStrategy: string;
+        embeddingDimensions: number;
+        generatedAt: string;
+    };
+}
+/**
+ * Token usage breakdown returned by AI SDK providers.
+ * Used for efficiency and cost analysis.
+ */
+interface TokenUsage {
+    /** Number of tokens in the input prompt (text + image). */
+    inputTokens?: number;
+    /** Number of tokens generated in the output. */
+    outputTokens?: number;
+    /** Total tokens consumed (input + output). */
+    totalTokens?: number;
+    /** Tokens used for chain-of-thought reasoning (if applicable). */
+    reasoningTokens?: number;
+    /** Input tokens served from cache (reduces cost). */
+    cachedInputTokens?: number;
+}
+
+export type { AssetTextTrack as A, ChunkingStrategy as C, ImageSubmissionMode as I, MuxAIConfig as M, PlaybackPolicy as P, ToneType as T, VTTChunkingConfig as V, MuxAIOptions as a, MuxAsset as b, PlaybackAsset as c, TokenChunkingConfig as d, TextChunk as e, ChunkEmbedding as f, VideoEmbeddingsResult as g, TokenUsage as h };