@bedolla/enrivision 0.1.5 → 0.1.6

package/dist/tools/AnalyzeMediaResumableUploader.js

@@ -0,0 +1,549 @@
+/**
+ * ANALYZE MEDIA RESUMABLE UPLOADER
+ *
+ * Streams local bytes to EnriProxy through resumable upload sessions with
+ * offset resync and bounded retries. Upload progress is reported to stderr
+ * at most once per 10% step (plus completion) so multi-hundred-chunk
+ * uploads do not flood the operator log.
+ *
+ * @module tools/AnalyzeMediaResumableUploader
+ */
+import { open } from "node:fs/promises";
+import { EnriProxyHttpError, } from "../client/EnriProxyClient.js";
+import { ANALYZE_MEDIA_LIMITS } from "./AnalyzeMediaContract.js";
+/**
+ * Hard cap for the overall upload deadline (mirrors EnriCode 20 min).
+ */
+const MAX_UPLOAD_DEADLINE_MS = 20 * 60 * 1000;
+/**
+ * Headroom added to the size-derived overall upload deadline.
+ */
+const UPLOAD_DEADLINE_HEADROOM_MS = 60_000;
+/**
+ * Worst-case upload throughput for deadline sizing (~1 Mbps, mirrors EnriCode).
+ */
+const UPLOAD_DEADLINE_BYTES_PER_SECOND = 125_000;
+/**
+ * File-identity re-check cadence in chunks (mirrors EnriCode 16).
+ */
+export const IDENTITY_CHECK_EVERY_CHUNKS = 16;
+/**
+ * File-identity re-check cadence in milliseconds (mirrors EnriCode 5 s).
+ */
+export const IDENTITY_CHECK_EVERY_MS = 5_000;
+/**
+ * Consecutive upload iterations without offset advance before the upload is
+ * declared stuck (mirrors the single-file same-offset 409 guard).
+ *
+ * @remarks
+ * A 2xx chunk response that reports the pre-chunk offset advances nothing:
+ * retrying the same bytes forever would spin to the 20 min deadline, so the
+ * third consecutive no-advance iteration fails fast with the inconsistent-
+ * protocol error instead.
+ */
+export const MAX_CONSECUTIVE_NO_ADVANCE = 3;
+/**
+ * Uploads local bytes through resumable EnriProxy sessions.
+ */
+export class AnalyzeMediaResumableUploader {
+    /**
+     * Uploads a file to EnriProxy in resumable chunks.
+     *
+     * @param client - EnriProxy client.
+     * @param filePath - Local file path.
+     * @param fileSize - Total file size in bytes.
+     * @param session - Server-created session.
+     * @param timeoutMs - Request timeout in milliseconds.
+     * @param signal - Optional cancellation signal.
+     * @param expectedIdentity - Resolve-time file identity compared at open (`fstat`); same-size swaps fail loudly.
+     * @returns Final offset.
+     * @throws Error with an Spanish-first bilingual message when the upload stalls, is cancelled, or stays incomplete.
+     */
+    async uploadFileResumable(client, filePath, fileSize, session, timeoutMs, signal, expectedIdentity) {
+        const chunkSize = effectiveChunkSizeBytes(session.chunk_size_bytes);
+        // One scratch for the whole upload, bounded by the actual file size so a
+        // 1-byte file never pins the full 16 MiB ceiling (mirrors EnriCode
+        // `max(1, min(effectiveChunkSize, totalBytes))`). Every iteration reads
+        // into a subarray view instead of allocating per chunk. Safe because each
+        // chunk is fully consumed (retries included) before the next read, and an
+        // offset resync discards the chunk before re-reading at the new offset.
+        const scratch = Buffer.allocUnsafe(resolveScratchSize(chunkSize, fileSize));
+        const progress = new UploadProgressLogger(fileSize);
+        const uploadStartedAt = Date.now();
+        const uploadDeadlineMs = resolveUploadDeadlineMs(fileSize);
+        const handle = await open(filePath, "r");
+        try {
+            // Staged resolve-time identity first (same-size replacement
+            // between resolve and upload), then the size gate: either mismatch
+            // fails loudly instead of shipping the wrong content.
+            const openedStat = await handle.stat();
+            const initialIdentity = describeFileIdentity(openedStat);
+            if (typeof expectedIdentity === "string" && initialIdentity !== expectedIdentity) {
+                throw new Error(`El archivo cambió entre la resolución y la subida (${filePath}); reintente la llamada con el archivo estable. / File changed between resolve and upload (${filePath}); retry the call with a stable file.`);
+            }
+            if (openedStat.size !== fileSize) {
+                throw new Error(`El archivo cambió antes de la subida (${filePath}); reintente la llamada. / File changed before upload (${filePath}); retry the call.`);
+            }
+            let offset = await withResumableRetry(() => client.getUploadOffset(session.upload_id, signal), signal);
+            if (!Number.isFinite(offset) || offset < 0 || offset > fileSize) {
+                throw new Error(`Offset del servidor inválido para la subida: ${String(offset)} (tamaño del archivo: ${String(fileSize)}). / Invalid server offset for the upload: ${String(offset)} (file size: ${String(fileSize)}).`);
+            }
+            let chunksSinceIdentityCheck = 0;
+            let lastIdentityCheckAt = 0;
+            let consecutiveNoAdvance = 0;
+            while (offset < fileSize) {
+                this.throwIfCancelled(signal);
+                if (Date.now() - uploadStartedAt > uploadDeadlineMs) {
+                    await deleteUploadSessionBestEffort(client, session.upload_id);
+                    throw new Error(`La subida excedió el tiempo máximo (${String(Math.round(uploadDeadlineMs / 1000))} s para ${String(fileSize)} bytes); reintente con un archivo más pequeño o una conexión más rápida. / Upload exceeded the maximum time (${String(Math.round(uploadDeadlineMs / 1000))} s for ${String(fileSize)} bytes); retry with a smaller file or a faster connection.`);
+                }
+                if (shouldRecheckIdentity(chunksSinceIdentityCheck, Date.now(), lastIdentityCheckAt)) {
+                    // fstat on the OPEN handle (never a path re-stat): a rename-swap
+                    // keeps this fd on the original bytes, so path-stat would judge a
+                    // file we are no longer reading. Comparing the handle identity
+                    // catches in-place same-size writes; truncation is caught by size.
+                    const current = await handle.stat();
+                    if (describeFileIdentity(current) !== initialIdentity) {
+                        await deleteUploadSessionBestEffort(client, session.upload_id);
+                        throw new Error(`El archivo cambió mientras se subía (${filePath}); reintente la llamada con el archivo estable. / File changed while uploading (${filePath}); retry the call with a stable file.`);
+                    }
+                    if (current.size < fileSize) {
+                        await deleteUploadSessionBestEffort(client, session.upload_id);
+                        throw new Error(`El archivo se truncó mientras se subía (${filePath}); reintente la llamada con el archivo estable. / File was truncated while uploading (${filePath}); retry the call with a stable file.`);
+                    }
+                    chunksSinceIdentityCheck = 0;
+                    lastIdentityCheckAt = Date.now();
+                }
+                const remaining = fileSize - offset;
+                const nextSize = Math.min(chunkSize, remaining);
+                const view = scratch.subarray(0, nextSize);
+                const read = await handle.read(view, 0, nextSize, offset);
+                if (read.bytesRead <= 0) {
+                    break;
+                }
+                const chunk = read.bytesRead === view.length ? view : view.subarray(0, read.bytesRead);
+                const expectedOffset = offset;
+                const nextOffset = await this.uploadChunkWithRetry(client, session.upload_id, expectedOffset, chunk, resolveChunkTimeoutMs(chunk.length, timeoutMs), signal);
+                assertNoForwardGap(nextOffset, expectedOffset, chunk.length);
+                if (nextOffset === expectedOffset) {
+                    consecutiveNoAdvance += 1;
+                    if (consecutiveNoAdvance >= MAX_CONSECUTIVE_NO_ADVANCE) {
+                        await deleteUploadSessionBestEffort(client, session.upload_id);
+                        throw new Error(`El servidor rechazó el fragmento sin avanzar el offset (protocolo de subida inconsistente); reintente la llamada. / The server rejected the chunk without advancing the offset (inconsistent upload protocol); retry the call.`);
+                    }
+                }
+                else {
+                    consecutiveNoAdvance = 0;
+                }
+                offset = nextOffset;
+                chunksSinceIdentityCheck += 1;
+                progress.report(offset);
+            }
+            return offset;
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    /**
+     * Uploads a single chunk with retry and offset resync.
+     *
+     * @param client - EnriProxy client.
+     * @param uploadId - Upload id.
+     * @param offset - Expected offset.
+     * @param chunk - Chunk bytes.
+     * @param timeoutMs - Timeout in milliseconds.
+     * @param signal - Optional cancellation signal.
+     * @returns New offset (possibly resynced by the server on 409).
+     * @throws Error with an Spanish-first bilingual message when the chunk is rejected or cancelled.
+     */
+    async uploadChunkWithRetry(client, uploadId, offset, chunk, timeoutMs, signal) {
+        // 3 attempts per chunk (initial try plus 2 retries, mirrors EnriCode
+        // `MAX_CHUNK_ATTEMPTS`): terminal statuses fail fast instead of burning
+        // attempts and masking auth/quota as a generic failure.
+        const maxAttempts = 3;
+        for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+            this.throwIfCancelled(signal);
+            try {
+                return await client.appendUploadChunk({ uploadId, offset, chunk, timeoutMs, signal });
+            }
+            catch (error) {
+                this.throwIfCancelled(signal);
+                const message = error instanceof Error ? error.message : String(error);
+                if (error instanceof EnriProxyHttpError) {
+                    // Offset mismatch: resync once and let the caller re-read at the
+                    // correct offset. A same-offset 409 means the server rejected the
+                    // bytes without advancing: fail fast instead of probing again
+                    // (a second immediate probe returns the same offset) or burning
+                    // all retry attempts.
+                    if (error.status === 409) {
+                        const actual = await withResumableRetry(() => client.getUploadOffset(uploadId, signal), signal);
+                        if (actual !== offset) {
+                            if (!isProgressQuiet()) {
+                                console.error(`enrivision: offset resync (${offset} -> ${actual})`);
+                            }
+                            return actual;
+                        }
+                        throw new Error(`El servidor rechazó el fragmento sin avanzar el offset (protocolo de subida inconsistente); reintente la llamada. / The server rejected the chunk without advancing the offset (inconsistent upload protocol); retry the call.`);
+                    }
+                    // Do not retry on client errors (except 409 which is handled above).
+                    if (error.status === 400 ||
+                        error.status === 401 ||
+                        error.status === 403 ||
+                        error.status === 404 ||
+                        error.status === 410 ||
+                        error.status === 413) {
+                        throw error;
+                    }
+                }
+                if (attempt === maxAttempts) {
+                    throw error;
+                }
+                const retryAfterMs = retryAfterDelayMs(error);
+                const backoffMs = retryAfterMs ?? Math.min(1000 * Math.pow(2, attempt - 1), 10000);
+                if (!isProgressQuiet()) {
+                    console.error(`enrivision: retry ${attempt}/${maxAttempts} after ${backoffMs}ms (${message})`);
+                }
+                await sleepAbortably(backoffMs, signal);
+            }
+        }
+        throw new Error("La subida falló tras los reintentos. / Upload failed after retries.");
+    }
+    /**
+     * Throws a Spanish cancellation error when the signal fired.
+     *
+     * @param signal - Optional cancellation signal.
+     * @throws Error with an Spanish-first bilingual message when cancelled.
+     */
+    throwIfCancelled(signal) {
+        if (signal?.aborted) {
+            throw new Error("La solicitud fue cancelada por el cliente. / Request cancelled by the client.");
+        }
+    }
+}
+/**
+ * Reports upload progress to stderr at most once per 10% step.
+ *
+ * @remarks
+ * Shared by single-file and tar-set uploads so both planes log the same
+ * `enrivision: upload NN%` lines (suppressible with `ENRIVISION_QUIET=1`).
+ */
+export class UploadProgressLogger {
+    /**
+     * Total bytes to send.
+     */
+    totalBytes;
+    /**
+     * Last reported 10% step (-1 before the first report).
+     */
+    lastReportedStep = -1;
+    /**
+     * Creates one throttled progress logger.
+     *
+     * @param totalBytes - Total bytes to send.
+     */
+    constructor(totalBytes) {
+        this.totalBytes = totalBytes;
+    }
+    /**
+     * Reports progress when a new 10% step (or completion) is reached.
+     *
+     * @param sentBytes - Bytes sent so far.
+     */
+    report(sentBytes) {
+        if (this.totalBytes <= 0 || isProgressQuiet()) {
+            return;
+        }
+        const step = sentBytes >= this.totalBytes ? 10 : Math.floor((sentBytes / this.totalBytes) * 10);
+        if (step <= this.lastReportedStep) {
+            return;
+        }
+        this.lastReportedStep = step;
+        const progress = Math.floor((sentBytes / this.totalBytes) * 100);
+        console.error(`enrivision: upload ${progress}% (${sentBytes}/${this.totalBytes} bytes)`);
+    }
+}
+/**
+ * Reports whether upload progress/retry logs are suppressed.
+ *
+ * @remarks
+ * Scripted stdio hosts set `ENRIVISION_QUIET=1` to silence stderr progress
+ * lines; transport framing always stays on stdout, so this only mutes noise.
+ *
+ * @returns True when `ENRIVISION_QUIET` is exactly `"1"`.
+ */
+export function isProgressQuiet() {
+    return process.env["ENRIVISION_QUIET"] === "1";
+}
+/**
+ * Reads a server-requested retry delay from an HTTP error.
+ *
+ * @remarks
+ * Only 408 (timeout) and 429 (rate limit) honor `Retry-After`: other
+ * statuses either fail fast (4xx) or use exponential backoff (5xx). The
+ * delay accepts delta-seconds or an HTTP date, clamped to 0..30 s so a
+ * hostile header can never stall the upload plane for hours.
+ *
+ * @param error - Error thrown by the failed attempt.
+ * @returns Retry delay in milliseconds, or null when no retry delay applies.
+ */
+export function retryAfterDelayMs(error) {
+    if (!(error instanceof EnriProxyHttpError)) {
+        return null;
+    }
+    if (error.status !== 408 && error.status !== 429) {
+        return null;
+    }
+    const raw = findHeaderValue(error.headers, "retry-after");
+    const first = Array.isArray(raw) ? raw[0] : raw;
+    if (typeof first !== "string" || !first.trim()) {
+        return null;
+    }
+    const trimmed = first.trim();
+    if (/^\d+$/u.test(trimmed)) {
+        return Math.min(30_000, Math.max(0, Number.parseInt(trimmed, 10) * 1000));
+    }
+    const at = Date.parse(trimmed);
+    if (!Number.isFinite(at)) {
+        return null;
+    }
+    return Math.min(30_000, Math.max(0, at - Date.now()));
+}
+/**
+ * Runs one resumable-plane operation with bounded backoff.
+ *
+ * @remarks
+ * Covers session creation and offset probes (single-shot before): up to 3
+ * attempts with exponential backoff plus jitter. `408`/`429` are retried
+ * honoring the server `Retry-After` header; other 4xx fail fast.
+ * Cancellation always throws immediately; the last error is rethrown in
+ * Spanish as received.
+ *
+ * @param operation - Thunk performing the HTTP operation.
+ * @param signal - Optional cancellation signal.
+ * @returns Operation result.
+ * @throws Error from the last attempt when all attempts fail.
+ */
+export async function withResumableRetry(operation, signal) {
+    const maxAttempts = 3;
+    let lastError = null;
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        if (signal?.aborted) {
+            throw new Error("La solicitud fue cancelada por el cliente. / Request cancelled by the client.");
+        }
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            if (signal?.aborted) {
+                throw new Error("La solicitud fue cancelada por el cliente. / Request cancelled by the client.");
+            }
+            if (error instanceof EnriProxyHttpError &&
+                error.status >= 400 &&
+                error.status < 500 &&
+                error.status !== 408 &&
+                error.status !== 429) {
+                throw error;
+            }
+            if (attempt === maxAttempts) {
+                break;
+            }
+            const retryAfterMs = retryAfterDelayMs(error);
+            const backoffMs = retryAfterMs ??
+                (Math.min(1000 * Math.pow(2, attempt - 1), 8000) + Math.floor(Math.random() * 250));
+            if (!isProgressQuiet()) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(`enrivision: retry ${attempt}/${maxAttempts} after ${backoffMs}ms (${message})`);
+            }
+            await sleepAbortably(backoffMs, signal);
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+/**
+ * Finds one HTTP error header value without regard to capitalization.
+ *
+ * @remarks
+ * Servers send `Retry-After`, `retry-after`, or any other casing; checking
+ * only two spellings drops the rest. Mirrors the case-insensitive lookup
+ * used by the client (`getHeaderValue`).
+ *
+ * @param headers - Response headers.
+ * @param name - Header name (any casing).
+ * @returns Header value when present, otherwise undefined.
+ */
+function findHeaderValue(headers, name) {
+    const target = name.toLowerCase();
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() === target) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/**
+ * Sleeps abortably for the given delay.
+ *
+ * @param delayMs - Delay in milliseconds.
+ * @param signal - Optional cancellation signal.
+ * @throws Error with an Spanish-first bilingual message when cancelled while sleeping.
+ */
+function sleepAbortably(delayMs, signal) {
+    if (signal?.aborted) {
+        return Promise.reject(new Error("La solicitud fue cancelada por el cliente. / Request cancelled by the client."));
+    }
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, Math.max(0, delayMs));
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new Error("La solicitud fue cancelada por el cliente. / Request cancelled by the client."));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+/**
+ * Default chunk size when the server advertisement is missing or invalid.
+ *
+ * @remarks
+ * Mirrors EnriCode `VisionAnalyzeMediaUploadCoordinator.DEFAULT_CHUNK_SIZE_BYTES`.
+ */
+export const DEFAULT_CHUNK_BYTES = 256 * 1024;
+/**
+ * Caps a server-advertised chunk size to the local 16 MiB ceiling.
+ *
+ * @remarks
+ * A compromised proxy must never trick the client into a 1 GiB
+ * `Buffer.allocUnsafe` (OOM); the cap keeps every allocation bounded.
+ * Missing or invalid advertisements fall back to the 256 KiB default
+ * (mirrors EnriCode): falling back to the 16 MiB ceiling instead would
+ * force every misbehaving-proxy upload through maximum-size allocations.
+ *
+ * @param serverChunkSizeBytes - Chunk size advertised by the server.
+ * @returns Effective chunk size in bytes (4 KiB..16 MiB, default 256 KiB).
+ */
+export function effectiveChunkSizeBytes(serverChunkSizeBytes) {
+    if (!Number.isFinite(serverChunkSizeBytes) || serverChunkSizeBytes <= 0) {
+        return DEFAULT_CHUNK_BYTES;
+    }
+    return Math.min(ANALYZE_MEDIA_LIMITS.maxChunkBytes, Math.max(4096, Math.floor(serverChunkSizeBytes)));
+}
+/**
+ * Derives the global upload deadline for a payload size.
+ *
+ * @remarks
+ * Mirrors EnriCode `VisionAnalyzeMediaUploadCoordinator`: size-derived at
+ * ~1 Mbps plus 60 s headroom, capped at 20 min, so a trickling connection
+ * can never run for hours past every analysis budget.
+ *
+ * @param totalBytes - Total payload bytes.
+ * @returns Deadline in milliseconds.
+ */
+export function resolveUploadDeadlineMs(totalBytes) {
+    const sized = Math.ceil(Math.max(0, totalBytes) / UPLOAD_DEADLINE_BYTES_PER_SECOND) * 1000
+        + UPLOAD_DEADLINE_HEADROOM_MS;
+    return Math.min(MAX_UPLOAD_DEADLINE_MS, sized);
+}
+/**
+ * Describes a stable file identity for TOCTOU detection.
+ *
+ * @remarks
+ * Size alone misses same-size replacements: inode, mtime, birthtime, and
+ * link count join the identity, mirroring EnriCode `describeFileIdentity`.
+ *
+ * @param stats - File stats.
+ * @returns Stable identity string (ino:size:mtime:birthtime:nlink).
+ */
+export function describeFileIdentity(stats) {
+    const birthtimeMs = typeof stats.birthtimeMs === "number" ? stats.birthtimeMs : 0;
+    const nlink = typeof stats.nlink === "number" ? stats.nlink : 0;
+    return `${String(stats.ino)}:${String(stats.size)}:${String(stats.mtimeMs)}:${String(birthtimeMs)}:${String(nlink)}`;
+}
+/**
+ * Deletes an upload session without ever throwing.
+ *
+ * @param client - EnriProxy client.
+ * @param uploadId - Upload id to release.
+ */
+async function deleteUploadSessionBestEffort(client, uploadId) {
+    try {
+        await client.deleteUploadSession(uploadId, AbortSignal.timeout(15_000));
+    }
+    catch {
+        // Best-effort: the original deadline/identity error always wins.
+    }
+}
+/**
+ * Rejects a server offset that jumped past the bytes just sent.
+ *
+ * @remarks
+ * A forward jump (`nextOffset > expectedOffset + sentBytes`) means the
+ * server skipped bytes that were never sent: resuming there would ship a
+ * file with a hole. Backward jumps are legitimate 409 resyncs handled by
+ * the caller; only forward jumps fail here.
+ *
+ * @param nextOffset - Server-reported offset after the chunk.
+ * @param expectedOffset - Offset the chunk was sent at.
+ * @param sentBytes - Chunk length in bytes.
+ * @throws Error with an Spanish-first bilingual message when the server skipped unsent bytes.
+ */
+export function assertNoForwardGap(nextOffset, expectedOffset, sentBytes) {
+    if (nextOffset > expectedOffset + sentBytes) {
+        throw new Error(`El servidor reportó un offset adelantado (${String(nextOffset)} > ${String(expectedOffset + sentBytes)}); hay bytes sin enviar y la subida no puede continuar sin huecos. Reintente la llamada. / The server reported a forward-skipped offset (${String(nextOffset)} > ${String(expectedOffset + sentBytes)}); some bytes were never sent and the upload cannot continue without gaps. Retry the call.`);
+    }
+}
+/**
+ * Derives the per-upload scratch size, bounded by the actual file size.
+ *
+ * @remarks
+ * Mirrors EnriCode `max(1, min(effectiveChunkSize, totalBytes))`: tiny files
+ * must not pin the full 16 MiB ceiling per concurrent upload session.
+ *
+ * @param chunkSize - Negotiated chunk size in bytes.
+ * @param fileSize - Total file size in bytes.
+ * @returns Scratch size in bytes (always at least 1).
+ */
+export function resolveScratchSize(chunkSize, fileSize) {
+    return Math.max(1, Math.min(chunkSize, fileSize));
+}
+/**
+ * Reports whether the periodic file-identity re-check is due.
+ *
+ * @remarks
+ * Shared by the single-file and tar upload loops so both planes re-check on
+ * the same cadence: every 16 chunks or every 5 s (mirrors EnriCode).
+ *
+ * @param chunksSinceCheck - Chunks uploaded since the last check.
+ * @param nowMs - Current time in milliseconds.
+ * @param lastCheckMs - Time of the last check in milliseconds.
+ * @returns True when the identity re-check must run now.
+ */
+export function shouldRecheckIdentity(chunksSinceCheck, nowMs, lastCheckMs) {
+    return chunksSinceCheck >= IDENTITY_CHECK_EVERY_CHUNKS || nowMs - lastCheckMs >= IDENTITY_CHECK_EVERY_MS;
+}
+/**
+ * Derives a per-chunk timeout from the chunk size and the call timeout.
+ *
+ * @remarks
+ * Assumes ~125 KB/s worst case (mirrors EnriCode `CHUNK_TIMEOUT_BYTES_PER_SECOND`), clamped to
+ * 30 s..300 s so one chunk can never hang the upload for hours (the old
+ * fixed 30 min per chunk did). The operator budget caps the derived value
+ * via `Math.min`, but the 30 s floor always wins: a tighter operator budget
+ * must not force single-chunk budgets that fail on slow links where EnriCode
+ * still uses the 30 s floor.
+ *
+ * @param chunkBytes - Chunk size in bytes.
+ * @param callTimeoutMs - Configured call timeout in milliseconds.
+ * @returns Effective chunk timeout in milliseconds (never below 30 s).
+ */
+export function resolveChunkTimeoutMs(chunkBytes, callTimeoutMs) {
+    const derived = Math.min(300000, Math.max(30000, Math.ceil(Math.max(1, chunkBytes) / 125000) * 1000));
+    if (Number.isFinite(callTimeoutMs) && callTimeoutMs > 0) {
+        return Math.max(30000, Math.min(callTimeoutMs, derived));
+    }
+    return derived;
+}
+//# sourceMappingURL=AnalyzeMediaResumableUploader.js.map

package/dist/tools/AnalyzeMediaResumableUploader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyzeMediaResumableUploader.js","sourceRoot":"","sources":["../../src/tools/AnalyzeMediaResumableUploader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EACL,kBAAkB,GAGnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;GAEG;AACH,MAAM,sBAAsB,GAAW,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,2BAA2B,GAAW,MAAM,CAAC;AAEnD;;GAEG;AACH,MAAM,gCAAgC,GAAW,OAAO,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAW,EAAE,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAW,KAAK,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAW,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,OAAO,6BAA6B;IACxC;;;;;;;;;;;;OAYG;IACI,KAAK,CAAC,mBAAmB,CAC9B,MAAuB,EACvB,QAAgB,EAChB,QAAgB,EAChB,OAAoC,EACpC,SAAiB,EACjB,MAAoB,EACpB,gBAAyB;QAEzB,MAAM,SAAS,GAAW,uBAAuB,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC5E,yEAAyE;QACzE,mEAAmE;QACnE,wEAAwE;QACxE,0EAA0E;QAC1E,0EAA0E;QAC1E,wEAAwE;QACxE,MAAM,OAAO,GAAW,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QACpF,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACpD,MAAM,eAAe,GAAW,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3C,MAAM,gBAAgB,GAAW,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAEzC,IAAI,CAAC;YACH,4DAA4D;YAC5D,mEAAmE;YACnE,sDAAsD;YACtD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACvC,MAAM,eAAe,GAAW,oBAAoB,CAAC,UAAU,CAAC,CAAC;YACjE,IAAI,OAAO,gBAAgB,KAAK,QAAQ,IAAI,eAAe,KAAK,gBAAgB,EAAE,CAAC;gBACjF,MAAM,IAAI,KAAK,CACb,sDAAsD,QAAQ,8FAA8F,QAAQ,uCAAuC,CAC5M,CAAC;YACJ,CAAC;YACD,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,0DAA0D,QAAQ,oBAAoB,CACxI,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,GAAW,MAAM,kBAAkB,CAC3C,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,EACvD,MAAM,CACP,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;gBAChE,MAAM,IAAI,KAAK,CACb,gDAAgD,MAAM,CAAC,MAAM,CAAC,yBAAyB,MAAM,CAAC,QAAQ,CAAC,8CAA8C,MAAM,CAAC,MAAM,CAAC,gBAAgB,MAAM,CAAC,QAAQ,CAAC,IAAI,CACxM,CAAC;YACJ,CAAC;YAED,IAAI,wBAAwB,GAAW,CAAC,CAAC;YACzC,IAAI,mBAAmB,GAAW,CAAC,CAAC;YACpC,IAAI,oBAAoB,GAAW,CAAC,CAAC;YACrC,OAAO,MAAM,GAAG,QAAQ,EAAE,CAAC;gBACzB,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBAC9B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,eAAe,GAAG,gBAAgB,EAAE,CAAC;oBACpD,MAAM,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;oBAC/D,MAAM,IAAI,KAAK,CACb,uCAAuC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,WAAW,MAAM,CAAC,QAAQ,CAAC,gHAAgH,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,UAAU,MAAM,CAAC,QAAQ,CAAC,4DAA4D,CAC/V,CAAC;gBACJ,CAAC;gBACD,IAAI,qBAAqB,CAAC,wBAAwB,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC,EAAE,CAAC;oBACrF,iEAAiE;oBACjE,kEAAkE;oBAClE,+DAA+D;oBAC/D,mEAAmE;oBACnE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;oBACpC,IAAI,oBAAoB,CAAC,OAAO,CAAC,KAAK,eAAe,EAAE,CAAC;wBACtD,MAAM,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;wBAC/D,MAAM,IAAI,KAAK,CACb,wCAAwC,QAAQ,mFAAmF,QAAQ,uCAAuC,CACnL,CAAC;oBACJ,CAAC;oBACD,IAAI,OAAO,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;wBAC5B,MAAM,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;wBAC/D,MAAM,IAAI,KAAK,CACb,2CAA2C,QAAQ,yFAAyF,QAAQ,uCAAuC,CAC5L,CAAC;oBACJ,CAAC;oBACD,wBAAwB,GAAG,CAAC,CAAC;oBAC7B,mBAAmB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACnC,CAAC;gBACD,MAAM,SAAS,GAAW,QAAQ,GAAG,MAAM,CAAC;gBAC5C,MAAM,QAAQ,GAAW,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;gBAExD,MAAM,IAAI,GAAW,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;gBACnD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC1D,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;oBACxB,MAAM;gBACR,CAAC;gBAED,MAAM,KAAK,GACT,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;gBAE3E,MAAM,cAAc,GAAW,MAAM,CAAC;gBACtC,MAAM,UAAU,GAAW,MAAM,IAAI,CAAC,oBAAoB,CACxD,MAAM,EACN,OAAO,CAAC,SAAS,EACjB,cAAc,EACd,KAAK,EACL,qBAAqB,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,EAC9C,MAAM,CACP,CAAC;gBACF,kBAAkB,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC7D,IAAI,UAAU,KAAK,cAAc,EAAE,CAAC;oBAClC,oBAAoB,IAAI,CAAC,CAAC;oBAC1B,IAAI,oBAAoB,IAAI,0BAA0B,EAAE,CAAC;wBACvD,MAAM,6BAA6B,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;wBAC/D,MAAM,IAAI,KAAK,CACb,gOAAgO,CACjO,CAAC;oBACJ,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,oBAAoB,GAAG,CAAC,CAAC;gBAC3B,CAAC;gBACD,MAAM,GAAG,UAAU,CAAC;gBACpB,wBAAwB,IAAI,CAAC,CAAC;gBAC9B,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACI,KAAK,CAAC,oBAAoB,CAC/B,MAAuB,EACvB,QAAgB,EAChB,MAAc,EACd,KAAa,EACb,SAAiB,EACjB,MAAoB;QAEpB,qEAAqE;QACrE,wEAAwE;QACxE,wDAAwD;QACxD,MAAM,WAAW,GAAG,CAAC,CAAC;QAEtB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC9B,IAAI,CAAC;gBACH,OAAO,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YACxF,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBAC9B,MAAM,OAAO,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAE/E,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;oBACxC,iEAAiE;oBACjE,kEAAkE;oBAClE,8DAA8D;oBAC9D,gEAAgE;oBAChE,sBAAsB;oBACtB,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;wBACzB,MAAM,MAAM,GAAW,MAAM,kBAAkB,CAC7C,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,EAC9C,MAAM,CACP,CAAC;wBACF,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;4BACtB,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;gCACvB,OAAO,CAAC,KAAK,CAAC,8BAA8B,MAAM,OAAO,MAAM,GAAG,CAAC,CAAC;4BACtE,CAAC;4BACD,OAAO,MAAM,CAAC;wBAChB,CAAC;wBACD,MAAM,IAAI,KAAK,CACb,gOAAgO,CACjO,CAAC;oBACJ,CAAC;oBAED,qEAAqE;oBACrE,IACE,KAAK,CAAC,MAAM,KAAK,GAAG;wBACpB,KAAK,CAAC,MAAM,KAAK,GAAG;wBACpB,KAAK,CAAC,MAAM,KAAK,GAAG;wBACpB,KAAK,CAAC,MAAM,KAAK,GAAG;wBACpB,KAAK,CAAC,MAAM,KAAK,GAAG;wBACpB,KAAK,CAAC,MAAM,KAAK,GAAG,EACpB,CAAC;wBACD,MAAM,KAAK,CAAC;oBACd,CAAC;gBACH,CAAC;gBAED,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;oBAC5B,MAAM,KAAK,CAAC;gBACd,CAAC;gBAED,MAAM,YAAY,GAAkB,iBAAiB,CAAC,KAAK,CAAC,CAAC;gBAC7D,MAAM,SAAS,GACb,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBACnE,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;oBACvB,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,IAAI,WAAW,UAAU,SAAS,OAAO,OAAO,GAAG,CAAC,CAAC;gBACjG,CAAC;gBACD,MAAM,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;IACzF,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,MAA+B;QACtD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;QACnG,CAAC;IACH,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;OAEG;IACc,UAAU,CAAS;IAEpC;;OAEG;IACK,gBAAgB,GAAW,CAAC,CAAC,CAAC;IAEtC;;;;OAIG;IACH,YAAmB,UAAkB;QACnC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,SAAiB;QAC7B,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,eAAe,EAAE,EAAE,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GACR,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;QACrF,IAAI,IAAI,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,MAAM,QAAQ,GAAW,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC;QACzE,OAAO,CAAC,KAAK,CAAC,sBAAsB,QAAQ,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,SAAS,CAAC,CAAC;IAC3F,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,GAAG,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC,CAAC,KAAK,YAAY,kBAAkB,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAkC,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACzF,MAAM,KAAK,GAAuB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACpE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAW,KAAK,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,EAAE,GAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAA2B,EAC3B,MAAoB;IAEpB,MAAM,WAAW,GAAG,CAAC,CAAC;IACtB,IAAI,SAAS,GAAY,IAAI,CAAC;IAC9B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC3D,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;QACnG,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,SAAS,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;YACnG,CAAC;YACD,IACE,KAAK,YAAY,kBAAkB;gBACnC,KAAK,CAAC,MAAM,IAAI,GAAG;gBACnB,KAAK,CAAC,MAAM,GAAG,GAAG;gBAClB,KAAK,CAAC,MAAM,KAAK,GAAG;gBACpB,KAAK,CAAC,MAAM,KAAK,GAAG,EACpB,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;gBAC5B,MAAM;YACR,CAAC;YACD,MAAM,YAAY,GAAkB,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC7D,MAAM,SAAS,GACb,YAAY;gBACZ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;YACtF,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;gBACvB,MAAM,OAAO,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/E,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,IAAI,WAAW,UAAU,SAAS,OAAO,OAAO,GAAG,CAAC,CAAC;YACjG,CAAC;YACD,MAAM,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,MAAM,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,eAAe,CACtB,OAAsD,EACtD,IAAY;IAEZ,MAAM,MAAM,GAAW,IAAI,CAAC,WAAW,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,OAAe,EAAE,MAAoB;IAC3D,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC,CAAC;IACpH,CAAC;IACD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAkC,UAAU,CAAC,GAAG,EAAE;YAC3D,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACzB,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC,CAAC;QACrG,CAAC,CAAC;QACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAW,GAAG,GAAG,IAAI,CAAC;AAEtD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB,CAAC,oBAA4B;IAClE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,oBAAoB,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;AACxG,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,MAAM,KAAK,GACT,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,gCAAgC,CAAC,GAAG,IAAI;UAC1E,2BAA2B,CAAC;IAChC,OAAO,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAMpC;IACC,MAAM,WAAW,GAAW,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,KAAK,GAAW,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACvH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,6BAA6B,CAC1C,MAAuB,EACvB,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,cAAsB,EAAE,SAAiB;IAC9F,IAAI,UAAU,GAAG,cAAc,GAAG,SAAS,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CACb,6CAA6C,MAAM,CAAC,UAAU,CAAC,MAAM,MAAM,CAAC,cAAc,GAAG,SAAS,CAAC,4IAA4I,MAAM,CAAC,UAAU,CAAC,MAAM,MAAM,CAAC,cAAc,GAAG,SAAS,CAAC,4FAA4F,CAC1Y,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAgB;IACpE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,gBAAwB,EACxB,KAAa,EACb,WAAmB;IAEnB,OAAO,gBAAgB,IAAI,2BAA2B,IAAI,KAAK,GAAG,WAAW,IAAI,uBAAuB,CAAC;AAC3G,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,aAAqB;IAC7E,MAAM,OAAO,GAAW,IAAI,CAAC,GAAG,CAC9B,MAAM,EACN,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,CAAC,CACpE,CAAC;IACF,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/tools/AnalyzeMediaTarPackager.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ANALYZE MEDIA TAR PACKAGER
+ *
+ * Packages multiple local images into a single EnriVision media-set tar
+ * archive and uploads it through a resumable EnriProxy session. A single
+ * archive avoids creating many concurrent upload sessions (capped per API
+ * key) and enables server-side batching plus reduce for large screenshot
+ * sets.
+ *
+ * @module tools/AnalyzeMediaTarPackager
+ */
+import type { EnriProxyClient } from "../client/EnriProxyClient.js";
+import type { ResolvedMediaInput } from "./AnalyzeMediaInputResolver.js";
+import { type AnalyzeMediaResumableUploader } from "./AnalyzeMediaResumableUploader.js";
+/**
+ * Packages and uploads multi-image sets as one media-set tar archive.
+ */
+export declare class AnalyzeMediaTarPackager {
+    /**
+     * Chunk uploader used for the tar byte stream.
+     */
+    private readonly uploader;
+    /**
+     * Creates a new {@link AnalyzeMediaTarPackager}.
+     *
+     * @param uploader - Resumable chunk uploader.
+     */
+    constructor(uploader: AnalyzeMediaResumableUploader);
+    /**
+     * Uploads multiple local images as a single media-set tar archive.
+     *
+     * @param client - EnriProxy client.
+     * @param inputs - Resolved media inputs (URLs already materialized).
+     * @param timeoutMs - Request timeout per HTTP request.
+     * @param clientTraceId - Client trace id for correlation.
+     * @param signal - Optional cancellation signal.
+     * @returns Upload id for the created tar session.
+     * @throws Error with an Spanish-first bilingual message when inputs are not images or the upload stalls.
+     */
+    uploadImageSetAsMediaSetTar(client: EnriProxyClient, inputs: readonly ResolvedMediaInput[], timeoutMs: number, clientTraceId: string, signal?: AbortSignal): Promise<string>;
+}
+//# sourceMappingURL=AnalyzeMediaTarPackager.d.ts.map

package/dist/tools/AnalyzeMediaTarPackager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyzeMediaTarPackager.d.ts","sourceRoot":"","sources":["../../src/tools/AnalyzeMediaTarPackager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAUL,KAAK,6BAA6B,EACnC,MAAM,oCAAoC,CAAC;AAoD5C;;GAEG;AACH,qBAAa,uBAAuB;IAClC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IAEzD;;;;OAIG;gBACgB,QAAQ,EAAE,6BAA6B;IAI1D;;;;;;;;;;OAUG;IACU,2BAA2B,CACtC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,SAAS,kBAAkB,EAAE,EACrC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC;CA6OnB"}