@steipete/summarize-core 0.11.1 → 0.13.0

package/dist/esm/transcription/whisper/remote-provider-attempts.js

@@ -0,0 +1,189 @@
+import { transcribeWithAssemblyAi, transcribeFileWithAssemblyAi } from "./assemblyai.js";
+import { MAX_OPENAI_UPLOAD_BYTES } from "./constants.js";
+import { transcribeWithFal } from "./fal.js";
+import { isFfmpegAvailable, transcodeBytesToMp3 } from "./ffmpeg.js";
+import { transcribeFileWithGemini, transcribeWithGemini } from "./gemini.js";
+import { shouldRetryOpenAiViaFfmpeg, transcribeWithOpenAi } from "./openai.js";
+import { formatBytes, wrapError } from "./utils.js";
+export async function attemptRemoteBytesProvider(args) {
+    const executor = BYTE_PROVIDER_EXECUTORS[args.provider];
+    return executor(args);
+}
+export async function attemptRemoteFileProvider(args) {
+    if (args.provider === "assemblyai") {
+        try {
+            const text = await transcribeFileWithAssemblyAi({
+                filePath: args.filePath,
+                mediaType: args.mediaType,
+                apiKey: args.assemblyaiApiKey,
+            });
+            if (text)
+                return { kind: "result", result: { text, provider: "assemblyai", error: null, notes: [] } };
+            return { kind: "error", error: new Error("AssemblyAI transcription returned empty text") };
+        }
+        catch (caught) {
+            return {
+                kind: "error",
+                error: caught instanceof Error ? caught : wrapError("AssemblyAI transcription failed", caught),
+            };
+        }
+    }
+    if (args.provider === "gemini") {
+        try {
+            const text = await transcribeFileWithGemini({
+                filePath: args.filePath,
+                mediaType: args.mediaType,
+                filename: args.filename,
+                apiKey: args.geminiApiKey,
+                env: args.env,
+            });
+            if (text)
+                return { kind: "result", result: { text, provider: "gemini", error: null, notes: [] } };
+            return { kind: "error", error: new Error("Gemini transcription returned empty text") };
+        }
+        catch (caught) {
+            return {
+                kind: "error",
+                error: wrapError("Gemini transcription failed", caught),
+            };
+        }
+    }
+    return { kind: "delegate-to-bytes" };
+}
+const BYTE_PROVIDER_EXECUTORS = {
+    assemblyai: async ({ state, assemblyaiApiKey }) => {
+        try {
+            const text = await transcribeWithAssemblyAi(state.bytes, state.mediaType, assemblyaiApiKey);
+            if (text) {
+                return {
+                    state,
+                    result: { text, provider: "assemblyai", error: null, notes: [] },
+                    error: null,
+                };
+            }
+            return {
+                state,
+                result: null,
+                error: new Error("AssemblyAI transcription returned empty text"),
+            };
+        }
+        catch (caught) {
+            return {
+                state,
+                result: null,
+                error: caught instanceof Error ? caught : wrapError("AssemblyAI transcription failed", caught),
+            };
+        }
+    },
+    gemini: async ({ state, geminiApiKey, env }) => {
+        try {
+            const text = await transcribeWithGemini(state.bytes, state.mediaType, state.filename, geminiApiKey, { env });
+            if (text) {
+                return {
+                    state,
+                    result: { text, provider: "gemini", error: null, notes: [] },
+                    error: null,
+                };
+            }
+            return { state, result: null, error: new Error("Gemini transcription returned empty text") };
+        }
+        catch (caught) {
+            return {
+                state,
+                result: null,
+                error: wrapError("Gemini transcription failed", caught),
+            };
+        }
+    },
+    openai: async ({ state, openaiApiKey, env, notes, onProgress, transcribeOversizedBytesWithChunking, }) => {
+        let nextState = state;
+        if (nextState.bytes.byteLength > MAX_OPENAI_UPLOAD_BYTES &&
+            transcribeOversizedBytesWithChunking &&
+            openaiApiKey) {
+            const canChunk = await isFfmpegAvailable();
+            if (canChunk) {
+                return {
+                    state: nextState,
+                    result: await transcribeOversizedBytesWithChunking({
+                        bytes: nextState.bytes,
+                        mediaType: nextState.mediaType,
+                        filename: nextState.filename,
+                        onProgress,
+                    }),
+                    error: null,
+                };
+            }
+            notes.push(`Media too large for Whisper upload (${formatBytes(nextState.bytes.byteLength)}); transcribing first ${formatBytes(MAX_OPENAI_UPLOAD_BYTES)} only (install ffmpeg for full transcription)`);
+            nextState = {
+                ...nextState,
+                bytes: nextState.bytes.slice(0, MAX_OPENAI_UPLOAD_BYTES),
+            };
+        }
+        let error = null;
+        try {
+            const text = await transcribeWithOpenAi(nextState.bytes, nextState.mediaType, nextState.filename, openaiApiKey, { env });
+            if (text) {
+                return {
+                    state: nextState,
+                    result: { text, provider: "openai", error: null, notes: [] },
+                    error: null,
+                };
+            }
+            error = new Error("OpenAI transcription returned empty text");
+        }
+        catch (caught) {
+            error = wrapError("OpenAI transcription failed", caught);
+        }
+        if (error && shouldRetryOpenAiViaFfmpeg(error)) {
+            const canTranscode = await isFfmpegAvailable();
+            if (canTranscode) {
+                try {
+                    notes.push("OpenAI could not decode media; transcoding via ffmpeg and retrying");
+                    const mp3Bytes = await transcodeBytesToMp3(nextState.bytes);
+                    const retried = await transcribeWithOpenAi(mp3Bytes, "audio/mpeg", "audio.mp3", openaiApiKey, { env });
+                    if (retried) {
+                        return {
+                            state: { bytes: mp3Bytes, mediaType: "audio/mpeg", filename: "audio.mp3" },
+                            result: { text: retried, provider: "openai", error: null, notes: [] },
+                            error: null,
+                        };
+                    }
+                    error = new Error("OpenAI transcription returned empty text after ffmpeg transcode");
+                    nextState = { bytes: mp3Bytes, mediaType: "audio/mpeg", filename: "audio.mp3" };
+                }
+                catch (caught) {
+                    notes.push(`ffmpeg transcode failed; cannot retry OpenAI decode error: ${caught instanceof Error ? caught.message : String(caught)}`);
+                }
+            }
+            else {
+                notes.push("OpenAI could not decode media; install ffmpeg to enable transcoding retry");
+            }
+        }
+        return { state: nextState, result: null, error };
+    },
+    fal: async ({ state, falApiKey, notes }) => {
+        if (!state.mediaType.toLowerCase().startsWith("audio/")) {
+            notes.push(`Skipping FAL transcription: unsupported mediaType ${state.mediaType}`);
+            return { state, result: null, error: null, skipped: true };
+        }
+        try {
+            const text = await transcribeWithFal(state.bytes, state.mediaType, falApiKey);
+            if (text) {
+                return {
+                    state,
+                    result: { text, provider: "fal", error: null, notes: [] },
+                    error: null,
+                };
+            }
+            return { state, result: null, error: new Error("FAL transcription returned empty text") };
+        }
+        catch (caught) {
+            return {
+                state,
+                result: null,
+                error: wrapError("FAL transcription failed", caught),
+            };
+        }
+    },
+};
+//# sourceMappingURL=remote-provider-attempts.js.map

package/dist/esm/transcription/whisper/remote-provider-attempts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-provider-attempts.js","sourceRoot":"","sources":["../../../../src/transcription/whisper/remote-provider-attempts.ts"],"names":[],"mappings":"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"}

package/dist/esm/transcription/whisper/remote.js

@@ -0,0 +1,220 @@
+import { randomUUID } from "node:crypto";
+import { promises as fs } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { cloudProviderLabel, formatCloudFallbackTargets, resolveCloudProviderOrder, } from "./cloud-providers.js";
+import { DEFAULT_SEGMENT_SECONDS, MAX_OPENAI_UPLOAD_BYTES } from "./constants.js";
+import { isFfmpegAvailable } from "./ffmpeg.js";
+import { buildMissingTranscriptionProviderMessage } from "./provider-setup.js";
+import { attemptRemoteBytesProvider, attemptRemoteFileProvider, } from "./remote-provider-attempts.js";
+import { formatBytes, readFirstBytes } from "./utils.js";
+function withMergedNotes(result, notes) {
+    if (result.notes.length === 0)
+        return { ...result, notes };
+    return { ...result, notes: [...notes, ...result.notes] };
+}
+function buildNoProviderResult({ notes, groqApiKey, groqError, }) {
+    if (groqApiKey) {
+        return {
+            text: null,
+            provider: "groq",
+            error: groqError ?? new Error("No transcription providers available"),
+            notes,
+        };
+    }
+    return {
+        text: null,
+        provider: null,
+        error: new Error(buildMissingTranscriptionProviderMessage()),
+        notes,
+    };
+}
+async function transcribeBytesAcrossProviders({ providerOrder, bytes, mediaType, filename, notes, groqApiKey, groqError = null, assemblyaiApiKey, geminiApiKey, openaiApiKey, falApiKey, env, onProgress, transcribeOversizedBytesWithChunking, }) {
+    if (providerOrder.length === 0) {
+        return buildNoProviderResult({ notes, groqApiKey, groqError });
+    }
+    let currentBytes = bytes;
+    let currentMediaType = mediaType;
+    let currentFilename = filename;
+    let lastFailure = null;
+    for (const [index, provider] of providerOrder.entries()) {
+        const attempt = await attemptRemoteBytesProvider({
+            provider,
+            state: {
+                bytes: currentBytes,
+                mediaType: currentMediaType,
+                filename: currentFilename,
+            },
+            assemblyaiApiKey,
+            geminiApiKey,
+            openaiApiKey,
+            falApiKey,
+            env,
+            notes,
+            onProgress,
+            transcribeOversizedBytesWithChunking,
+        });
+        currentBytes = attempt.state.bytes;
+        currentMediaType = attempt.state.mediaType;
+        currentFilename = attempt.state.filename;
+        if (attempt.result)
+            return withMergedNotes(attempt.result, notes);
+        if (!attempt.error)
+            continue;
+        lastFailure = { provider, error: attempt.error };
+        const remaining = providerOrder.slice(index + 1).filter((candidate) => {
+            if (candidate !== "fal")
+                return true;
+            return currentMediaType.toLowerCase().startsWith("audio/");
+        });
+        if (remaining.length > 0) {
+            notes.push(`${cloudProviderLabel(provider, false)} transcription failed; falling back to ${formatCloudFallbackTargets(remaining)}: ${attempt.error.message}`);
+        }
+    }
+    if (lastFailure) {
+        return {
+            text: null,
+            provider: lastFailure.provider,
+            error: lastFailure.error,
+            notes,
+        };
+    }
+    return buildNoProviderResult({ notes, groqApiKey, groqError });
+}
+export async function transcribeBytesWithRemoteFallbacks({ bytes, mediaType, filename, notes, groqApiKey, groqError = null, assemblyaiApiKey, geminiApiKey, openaiApiKey, falApiKey, env, onProgress, transcribeOversizedBytesWithChunking, }) {
+    return await transcribeBytesAcrossProviders({
+        providerOrder: resolveCloudProviderOrder({
+            assemblyaiApiKey,
+            geminiApiKey,
+            openaiApiKey,
+            falApiKey,
+        }),
+        bytes,
+        mediaType,
+        filename,
+        notes,
+        groqApiKey,
+        groqError,
+        assemblyaiApiKey,
+        geminiApiKey,
+        openaiApiKey,
+        falApiKey,
+        env,
+        onProgress,
+        transcribeOversizedBytesWithChunking,
+    });
+}
+export async function transcribeFileWithRemoteFallbacks({ filePath, mediaType, filename, notes, groqApiKey, groqError = null, assemblyaiApiKey, geminiApiKey, openaiApiKey, falApiKey, env, totalDurationSeconds, onProgress, transcribeChunkedFile, }) {
+    const providerOrder = resolveCloudProviderOrder({
+        assemblyaiApiKey,
+        geminiApiKey,
+        openaiApiKey,
+        falApiKey,
+    });
+    if (providerOrder.length === 0) {
+        return buildNoProviderResult({ notes, groqApiKey, groqError });
+    }
+    const stat = await fs.stat(filePath);
+    onProgress?.({
+        partIndex: null,
+        parts: null,
+        processedDurationSeconds: null,
+        totalDurationSeconds,
+    });
+    let cachedBytes = null;
+    const readFileBytes = async () => {
+        if (cachedBytes)
+            return cachedBytes;
+        cachedBytes = new Uint8Array(await fs.readFile(filePath));
+        return cachedBytes;
+    };
+    let lastFailure = null;
+    for (const [index, provider] of providerOrder.entries()) {
+        const fileAttempt = await attemptRemoteFileProvider({
+            provider,
+            filePath,
+            mediaType,
+            filename,
+            assemblyaiApiKey,
+            geminiApiKey,
+            env,
+        });
+        if (fileAttempt.kind === "result")
+            return withMergedNotes(fileAttempt.result, notes);
+        if (fileAttempt.kind === "delegate-to-bytes") {
+            if (provider === "openai" && stat.size > MAX_OPENAI_UPLOAD_BYTES) {
+                const canChunk = await isFfmpegAvailable();
+                if (canChunk) {
+                    return withMergedNotes(await transcribeChunkedFile({
+                        filePath,
+                        segmentSeconds: DEFAULT_SEGMENT_SECONDS,
+                        totalDurationSeconds,
+                        onProgress,
+                    }), notes);
+                }
+                notes.push(`Media too large for Whisper upload (${formatBytes(stat.size)}); install ffmpeg to enable chunked transcription`);
+                const head = await readFirstBytes(filePath, MAX_OPENAI_UPLOAD_BYTES);
+                return withMergedNotes(await transcribeBytesAcrossProviders({
+                    providerOrder: providerOrder.slice(index),
+                    bytes: head,
+                    mediaType,
+                    filename,
+                    notes: [],
+                    groqApiKey,
+                    groqError,
+                    assemblyaiApiKey,
+                    geminiApiKey,
+                    openaiApiKey,
+                    falApiKey,
+                    env,
+                    onProgress,
+                }), notes);
+            }
+            return withMergedNotes(await transcribeBytesAcrossProviders({
+                providerOrder: providerOrder.slice(index),
+                bytes: await readFileBytes(),
+                mediaType,
+                filename,
+                notes: [],
+                groqApiKey,
+                groqError,
+                assemblyaiApiKey,
+                geminiApiKey,
+                openaiApiKey,
+                falApiKey,
+                env,
+                onProgress,
+            }), notes);
+        }
+        lastFailure = { provider, error: fileAttempt.error };
+        const remaining = providerOrder.slice(index + 1);
+        if (remaining.length > 0) {
+            notes.push(`${cloudProviderLabel(provider, false)} transcription failed; falling back to ${formatCloudFallbackTargets(remaining)}: ${fileAttempt.error.message}`);
+        }
+    }
+    if (lastFailure) {
+        return {
+            text: null,
+            provider: lastFailure.provider,
+            error: lastFailure.error,
+            notes,
+        };
+    }
+    return buildNoProviderResult({ notes, groqApiKey, groqError });
+}
+export async function transcribeOversizedBytesViaTempFile({ bytes, mediaType, filename, onProgress, transcribeFile, }) {
+    const tempFile = join(tmpdir(), `summarize-whisper-${randomUUID()}`);
+    try {
+        await fs.writeFile(tempFile, bytes);
+        return await transcribeFile({
+            filePath: tempFile,
+            mediaType,
+            filename,
+            onProgress,
+        });
+    }
+    finally {
+        await fs.unlink(tempFile).catch(() => { });
+    }
+}
+//# sourceMappingURL=remote.js.map

package/dist/esm/transcription/whisper/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../../../src/transcription/whisper/remote.ts"],"names":[],"mappings":"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"}

package/dist/esm/transcription/whisper/whisper-cpp.js

@@ -6,21 +6,21 @@ import { spawnTracked } from "../../processes.js";
 import { DISABLE_LOCAL_WHISPER_CPP_ENV, WHISPER_CPP_BINARY_ENV, WHISPER_CPP_MODEL_PATH_ENV, } from "./constants.js";
 import { isFfmpegAvailable, runFfmpegTranscodeToMp3, runFfmpegTranscodeToMp3Lenient, } from "./ffmpeg.js";
 import { wrapError } from "./utils.js";
-export async function isWhisperCppReady() {
-    if (!isWhisperCppEnabled())
+export async function isWhisperCppReady(env) {
+    if (!isWhisperCppEnabled(env))
         return false;
-    if (!(await isWhisperCliAvailable()))
+    if (!(await isWhisperCliAvailable(env)))
         return false;
-    const model = await resolveWhisperCppModelPath();
+    const model = await resolveWhisperCppModelPath(env);
     return Boolean(model);
 }
-export async function resolveWhisperCppModelNameForDisplay() {
-    const modelPath = await resolveWhisperCppModelPath();
+export async function resolveWhisperCppModelNameForDisplay(env) {
+    const modelPath = await resolveWhisperCppModelPath(env);
     return modelPath ? resolveWhisperCppModelLabelFromPath(modelPath) : null;
 }
-export async function transcribeWithWhisperCppFile({ filePath, mediaType, totalDurationSeconds, onProgress, }) {
+export async function transcribeWithWhisperCppFile({ filePath, mediaType, totalDurationSeconds, onProgress, env, }) {
     const notes = [];
-    const modelPath = await resolveWhisperCppModelPath();
+    const modelPath = await resolveWhisperCppModelPath(env);
     if (!modelPath) {
         return {
             text: null,
@@ -92,7 +92,7 @@ export async function transcribeWithWhisperCppFile({ filePath, mediaType, totalD
         ];
         try {
             await new Promise((resolve, reject) => {
-                const { proc, handle } = spawnTracked(resolveWhisperCppBinary(), args, {
+                const { proc, handle } = spawnTracked(resolveWhisperCppBinary(env), args, {
                     stdio: ["ignore", "ignore", "pipe"],
                     label: "whisper.cpp",
                     kind: "whisper.cpp",
@@ -166,11 +166,12 @@ export async function transcribeWithWhisperCppFile({ filePath, mediaType, totalD
         await effectivePath.cleanup?.().catch(() => { });
     }
 }
-function isWhisperCppEnabled() {
-    return (process.env[DISABLE_LOCAL_WHISPER_CPP_ENV] ?? "").trim() !== "1";
+function isWhisperCppEnabled(env) {
+    const source = env ?? process.env;
+    return (source[DISABLE_LOCAL_WHISPER_CPP_ENV] ?? "").trim() !== "1";
 }
-async function isWhisperCliAvailable() {
-    const bin = resolveWhisperCppBinary();
+async function isWhisperCliAvailable(env) {
+    const bin = resolveWhisperCppBinary(env);
     return new Promise((resolve) => {
         const { proc } = spawnTracked(bin, ["--help"], {
             stdio: ["ignore", "ignore", "ignore"],
@@ -182,12 +183,14 @@ async function isWhisperCliAvailable() {
         proc.on("close", (code) => resolve(code === 0));
     });
 }
-function resolveWhisperCppBinary() {
-    const override = (process.env[WHISPER_CPP_BINARY_ENV] ?? "").trim();
+function resolveWhisperCppBinary(env) {
+    const source = env ?? process.env;
+    const override = (source[WHISPER_CPP_BINARY_ENV] ?? "").trim();
     return override.length > 0 ? override : "whisper-cli";
 }
-async function resolveWhisperCppModelPath() {
-    const override = (process.env[WHISPER_CPP_MODEL_PATH_ENV] ?? "").trim();
+async function resolveWhisperCppModelPath(env) {
+    const source = env ?? process.env;
+    const override = (source[WHISPER_CPP_MODEL_PATH_ENV] ?? "").trim();
     if (override) {
         try {
             const stat = await fs.stat(override);
@@ -197,7 +200,7 @@ async function resolveWhisperCppModelPath() {
             return null;
         }
     }
-    const home = (process.env.HOME ?? process.env.USERPROFILE ?? "").trim();
+    const home = (source.HOME ?? source.USERPROFILE ?? "").trim();
     const cacheCandidate = home
         ? join(home, ".summarize", "cache", "whisper-cpp", "models", "ggml-base.bin")
         : null;

package/dist/esm/transcription/whisper/whisper-cpp.js.map

@@ -1 +1 @@
-{"version":3,"file":"whisper-cpp.js","sourceRoot":"","sources":["../../../../src/transcription/whisper/whisper-cpp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"whisper-cpp.js","sourceRoot":"","sources":["../../../../src/transcription/whisper/whisper-cpp.ts"],"names":[],"mappings":"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"}

package/dist/types/content/bun.d.ts

@@ -0,0 +1,6 @@
+type RequestHeaders = Record<string, string>;
+export declare function isBunRuntime(): boolean;
+export declare function withBunCompressionHeaders(headers: RequestHeaders): RequestHeaders;
+export declare function withBunIdentityEncoding(headers: RequestHeaders): RequestHeaders;
+export declare function isBunCompressedResponseError(error: unknown): boolean;
+export {};

package/dist/types/content/direct-media.d.ts

@@ -0,0 +1,9 @@
+export type DirectMediaKind = "video" | "audio";
+export declare const DIRECT_MEDIA_EXTENSIONS: readonly ["mp4", "mov", "m4v", "mkv", "webm", "mpeg", "mpg", "avi", "wmv", "flv", "m3u8", "mp3", "m4a", "wav", "flac", "aac", "ogg", "opus", "aiff", "wma"];
+export declare function normalizePathForExtension(value: string): string;
+export declare function resolveDirectMediaExtension(value: string): string | null;
+export declare function isDirectMediaUrl(url: string): boolean;
+export declare function isDirectMediaExtension(ext: string): boolean;
+export declare function inferDirectMediaKind(value: string): DirectMediaKind | null;
+export declare function isDirectVideoInput(value: string): boolean;
+export declare function resolveDirectMediaType(value: string, kindHint?: DirectMediaKind | null): string | null;

package/dist/types/content/index.d.ts

@@ -1,7 +1,8 @@
 export type { MediaCache, MediaCacheEntry, TranscriptCache, TranscriptCacheGetResult, TranscriptCacheSetArgs, } from "./cache/types.js";
+export { NEGATIVE_TTL_MS } from "./transcript/cache.js";
 export { createLinkPreviewClient, type LinkPreviewClient, type LinkPreviewClientOptions, } from "./link-preview/client.js";
 export { DEFAULT_CACHE_MODE, DEFAULT_MAX_CONTENT_CHARACTERS, DEFAULT_TIMEOUT_MS, type ExtractedLinkContent, type FetchLinkContentOptions, } from "./link-preview/content/types.js";
 export type { ConvertHtmlToMarkdown, FirecrawlScrapeResult, LinkPreviewDeps, LinkPreviewProgressEvent, ReadTweetWithBird, ScrapeWithFirecrawl, } from "./link-preview/deps.js";
 export { ProgressKind } from "./link-preview/deps.js";
 export { CACHE_MODES, type CacheMode, type CacheStatus, type TranscriptSource, } from "./link-preview/types.js";
-export { DIRECT_MEDIA_EXTENSIONS, extractYouTubeVideoId, isDirectMediaExtension, isDirectMediaUrl, isPodcastHost, isTwitterBroadcastUrl, isTwitterStatusUrl, isYouTubeUrl, isYouTubeVideoUrl, shouldPreferUrlMode, } from "./url.js";
+export { DIRECT_MEDIA_EXTENSIONS, extractYouTubeVideoId, inferDirectMediaKind, isDirectMediaExtension, isDirectMediaUrl, isDirectVideoInput, isPodcastHost, isTwitterBroadcastUrl, isTwitterStatusUrl, isYouTubeUrl, isYouTubeVideoUrl, shouldPreferUrlMode, } from "./url.js";

package/dist/types/content/link-preview/client.d.ts

@@ -1,7 +1,7 @@
 import type { MediaCache, TranscriptCache } from "../cache/types.js";
+import { type TranscriptionConfig } from "../transcript/transcription-config.js";
 import type { ExtractedLinkContent, FetchLinkContentOptions } from "./content/types.js";
 import type { ConvertHtmlToMarkdown, LinkPreviewDeps, LinkPreviewProgressEvent, ResolveTwitterCookies, ScrapeWithFirecrawl } from "./deps.js";
-import { type TranscriptionConfig } from "../transcript/transcription-config.js";
 /** Public client used by external consumers to fetch link content. */
 export interface LinkPreviewClient {
     fetchLinkContent(url: string, options?: FetchLinkContentOptions): Promise<ExtractedLinkContent>;
@@ -16,6 +16,8 @@ export interface LinkPreviewClientOptions {
     transcription?: Partial<TranscriptionConfig> | null;
     falApiKey?: string | null;
     groqApiKey?: string | null;
+    assemblyaiApiKey?: string | null;
+    geminiApiKey?: string | null;
     openaiApiKey?: string | null;
     convertHtmlToMarkdown?: ConvertHtmlToMarkdown | null;
     transcriptCache?: TranscriptCache | null;

package/dist/types/content/link-preview/content/fetcher.d.ts

@@ -8,7 +8,7 @@ export interface HtmlDocumentFetchResult {
     html: string;
     finalUrl: string;
 }
-export declare function fetchHtmlDocument(fetchImpl: typeof fetch, url: string, { timeoutMs, onProgress, }?: {
+export declare function fetchHtmlDocument(fetchImpl: typeof fetch, url: string, options?: {
     timeoutMs?: number;
     onProgress?: ((event: LinkPreviewProgressEvent) => void) | null;
 }): Promise<HtmlDocumentFetchResult>;

package/dist/types/content/link-preview/content/html.d.ts

@@ -1,7 +1,7 @@
 import type { LinkPreviewDeps } from "../deps.js";
 import type { FirecrawlDiagnostics } from "../types.js";
-import type { ExtractedLinkContent, FetchLinkContentOptions, MarkdownMode } from "./types.js";
 import { extractReadabilityFromHtml } from "./readability.js";
+import type { ExtractedLinkContent, FetchLinkContentOptions, MarkdownMode } from "./types.js";
 export declare function buildResultFromHtmlDocument({ url, html, cacheMode, maxCharacters, youtubeTranscriptMode, mediaTranscriptMode, transcriptTimestamps, firecrawlDiagnostics, markdownRequested, markdownMode, timeoutMs, deps, readabilityCandidate, }: {
     url: string;
     html: string;