@avclabs.ai/media-mcp 0.2.1 → 0.3.0

package/dist/service-config.js

@@ -0,0 +1,58 @@
+// Media host configuration: one deep module owning precedence, validation,
+// and derivation for everything the enhancement and SAM3 hosts need. Adapters
+// consume the resolved MediaHostConfig; callers never merge layers themselves
+// and never need to know variable initialization order.
+export const SAM3_POLL_INTERVAL_MS_BOUNDS = { min: 500, max: 60000 };
+export const SAM3_POLL_MAX_ATTEMPTS_BOUNDS = { min: 1, max: 1000 };
+const DEFAULT_ENHANCEMENT_API_BASE_URL = 'https://mcp.avc.ai/enhance';
+const DEFAULT_SAM3_API_BASE_URL = 'https://mcp.avc.ai/sam';
+const DEFAULT_SAM3_POLL_INTERVAL_MS = 2000;
+const DEFAULT_SAM3_POLL_MAX_ATTEMPTS = 25;
+export class ConfigError extends Error {
+}
+// Blank values are "not provided" at every layer, so a resolved address is
+// never empty and a blank override cannot mask a valid lower layer.
+function highestPrecedence(...values) {
+    for (const value of values) {
+        if (value !== undefined && value.trim() !== '')
+            return value;
+    }
+    return undefined;
+}
+export function parseSam3WaitInt(raw, name, bounds, fallback) {
+    if (raw === undefined)
+        return fallback;
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed < bounds.min || parsed > bounds.max) {
+        throw new ConfigError(`Invalid ${name} "${raw}": expected an integer between ${bounds.min} and ${bounds.max}`);
+    }
+    return parsed;
+}
+/**
+ * Resolves the final Media host configuration.
+ *
+ * Precedence per key: CLI override > environment > file config > built-in
+ * default. The image API base URL is derived only after the merge: an unset
+ * image base falls back to the resolved enhancement base, no matter which
+ * layer provided it. All validation happens here, before any tool is created
+ * or request is made; error messages never echo secret values.
+ */
+export function resolveMediaHostConfig(options) {
+    const cli = options.cli ?? {};
+    const env = options.env ?? {};
+    const file = options.file ?? {};
+    const enhancementApiBaseUrl = highestPrecedence(cli.baseUrl, env.HTTP_API_BASE_URL, file.baseUrl) ?? DEFAULT_ENHANCEMENT_API_BASE_URL;
+    const sam3ApiBaseUrl = highestPrecedence(cli.sam3BaseUrl, env.SAM3_API_BASE_URL, file.sam3BaseUrl) ?? DEFAULT_SAM3_API_BASE_URL;
+    const imageApiBaseUrl = highestPrecedence(cli.imageBaseUrl, env.IMAGE_API_BASE_URL, file.imageBaseUrl) ?? enhancementApiBaseUrl;
+    const apiKey = highestPrecedence(cli.apiKey, env.API_KEY);
+    if (!apiKey) {
+        throw new ConfigError('API key is required: pass --api-key or set the API_KEY environment variable');
+    }
+    // SAM3_POLL_INTERVAL_MS is the canonical name; SAM3_POLL_INTERVAL is kept as
+    // a deprecated alias. Both are milliseconds (unlike the per-tool
+    // poll_interval argument, which is seconds).
+    const sam3PollIntervalMs = parseSam3WaitInt(highestPrecedence(cli.sam3PollIntervalMs, env.SAM3_POLL_INTERVAL_MS, env.SAM3_POLL_INTERVAL), 'SAM3_POLL_INTERVAL_MS', SAM3_POLL_INTERVAL_MS_BOUNDS, DEFAULT_SAM3_POLL_INTERVAL_MS);
+    const sam3PollMaxAttempts = parseSam3WaitInt(highestPrecedence(cli.sam3PollMaxAttempts, env.SAM3_POLL_MAX_ATTEMPTS), 'SAM3_POLL_MAX_ATTEMPTS', SAM3_POLL_MAX_ATTEMPTS_BOUNDS, DEFAULT_SAM3_POLL_MAX_ATTEMPTS);
+    return { enhancementApiBaseUrl, imageApiBaseUrl, sam3ApiBaseUrl, apiKey, sam3PollIntervalMs, sam3PollMaxAttempts };
+}
+//# sourceMappingURL=service-config.js.map

package/dist/service-config.js.map

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

package/dist/tooling.d.ts

@@ -0,0 +1,42 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+export declare function registerTool(server: McpServer, name: string, description: string, schema: z.ZodRawShape, handler: (args: any) => Promise<unknown>): void;
+export declare const POLL_REQUEST_TIMEOUT_MS = 10000;
+export declare const MAX_CONSECUTIVE_POLL_FAILURES = 3;
+export declare const MAX_UNKNOWN_STATUS_SIGHTINGS = 3;
+export declare function sleep(ms: number): Promise<void>;
+export declare function clampNumber(value: number, min: number, max: number, fallback: number): number;
+export declare function remainingSleepMs(intervalMs: number, deadline: number, now?: number): number;
+export declare function requestBudgetMs(deadline: number, now?: number): number;
+export type StatusKind = 'ok' | 'failed' | 'processing' | 'unknown';
+export declare function classifyStatus(status: unknown): StatusKind;
+export interface PollFetchResult {
+    status: unknown;
+    payload: Record<string, any>;
+}
+export interface PollParams {
+    taskId: string;
+    timeoutSeconds: number;
+    pollIntervalSeconds: number;
+    fetchStatus: (signal: AbortSignal) => Promise<PollFetchResult>;
+    continueHint: string;
+    /**
+     * Independent query-count limit: the first query counts, and the wait is
+     * truncated as soon as this many queries have been made while the task is
+     * still processing (no trailing sleep). Time and count limits run in
+     * parallel; whichever is exhausted first ends the wait.
+     */
+    maxAttempts?: number;
+    /** Injectable clock and delay for deterministic tests; defaults to real time. */
+    now?: () => number;
+    delay?: (ms: number) => Promise<void>;
+}
+/**
+ * Deadline- and attempt-aware polling: never sleeps past the deadline, aborts
+ * each status request at the remaining wait budget, tolerates transient
+ * network failures, treats unknown statuses as errors after a few sightings,
+ * and always keeps task_id in the response so the task is never lost.
+ * A cancellation fired at the budget edge is not counted as a query failure.
+ */
+export declare function pollUntilTerminal(params: PollParams): Promise<Record<string, any>>;
+//# sourceMappingURL=tooling.d.ts.map

package/dist/tooling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tooling.d.ts","sourceRoot":"","sources":["../src/tooling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,CAAC,CAAC,WAAW,EACrB,OAAO,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,GACvC,IAAI,CAeN;AAMD,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAC7C,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7F;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAEvG;AAID,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAElF;AAMD,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;AAEpE,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAM1D;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAQD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CA2FxF"}

package/dist/tooling.js

@@ -0,0 +1,153 @@
+// ---------------------------------------------------------------------------
+// Tool registration wrapper: business failures surface as MCP isError results
+// ---------------------------------------------------------------------------
+export function registerTool(server, name, description, schema, handler) {
+    server.tool(name, description, schema, async (args) => {
+        try {
+            const result = await handler(args);
+            const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+            const failed = typeof result === 'object' && result !== null && result.success === false;
+            return { content: [{ type: 'text', text }], ...(failed ? { isError: true } : {}) };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: message }, null, 2) }],
+                isError: true,
+            };
+        }
+    });
+}
+// ---------------------------------------------------------------------------
+// Polling primitives
+// ---------------------------------------------------------------------------
+export const POLL_REQUEST_TIMEOUT_MS = 10000;
+export const MAX_CONSECUTIVE_POLL_FAILURES = 3;
+export const MAX_UNKNOWN_STATUS_SIGHTINGS = 3;
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, Math.max(0, ms)));
+}
+export function clampNumber(value, min, max, fallback) {
+    if (!Number.isFinite(value))
+        return fallback;
+    return Math.min(max, Math.max(min, value));
+}
+export function remainingSleepMs(intervalMs, deadline, now = Date.now()) {
+    return Math.max(0, Math.min(intervalMs, deadline - now));
+}
+// A single status request never outlives the remaining wait budget (and never
+// runs with timeout 0, which axios treats as "no timeout").
+export function requestBudgetMs(deadline, now = Date.now()) {
+    return Math.max(250, Math.min(POLL_REQUEST_TIMEOUT_MS, deadline - now));
+}
+const TERMINAL_OK_STATUSES = new Set(['completed', 'succeeded', 'success']);
+const TERMINAL_FAIL_STATUSES = new Set(['failed', 'canceled', 'cancelled', 'expired', 'rejected']);
+const TRANSIENT_STATUSES = new Set(['processing', 'pending', 'running', 'queued']);
+export function classifyStatus(status) {
+    const normalized = typeof status === 'string' ? status.toLowerCase() : '';
+    if (TERMINAL_OK_STATUSES.has(normalized))
+        return 'ok';
+    if (TERMINAL_FAIL_STATUSES.has(normalized))
+        return 'failed';
+    if (TRANSIENT_STATUSES.has(normalized))
+        return 'processing';
+    return 'unknown';
+}
+function formatElapsedSeconds(ms) {
+    const seconds = ms / 1000;
+    if (seconds >= 10)
+        return `${Math.round(seconds)} seconds`;
+    return `${(Math.round(seconds * 10) / 10).toFixed(1)} seconds`;
+}
+/**
+ * Deadline- and attempt-aware polling: never sleeps past the deadline, aborts
+ * each status request at the remaining wait budget, tolerates transient
+ * network failures, treats unknown statuses as errors after a few sightings,
+ * and always keeps task_id in the response so the task is never lost.
+ * A cancellation fired at the budget edge is not counted as a query failure.
+ */
+export async function pollUntilTerminal(params) {
+    const now = params.now ?? Date.now;
+    const delay = params.delay ?? sleep;
+    // Budget bounds are the caller's contract (tool schemas validate before task
+    // submission); a non-finite or sub-second budget falls back to the historical
+    // 45 s default rather than being silently rewritten to some other cap.
+    const timeoutSeconds = Number.isFinite(params.timeoutSeconds) && params.timeoutSeconds >= 1 ? params.timeoutSeconds : 45;
+    const intervalMs = Number.isFinite(params.pollIntervalSeconds) && params.pollIntervalSeconds >= 0.5
+        ? params.pollIntervalSeconds * 1000
+        : 5000;
+    const maxAttempts = params.maxAttempts === undefined ? Number.POSITIVE_INFINITY : Math.floor(params.maxAttempts);
+    const startedAt = now();
+    const deadline = startedAt + timeoutSeconds * 1000;
+    let consecutiveFailures = 0;
+    let unknownSightings = 0;
+    let attempts = 0;
+    while (attempts < maxAttempts && now() < deadline) {
+        attempts++;
+        const requestBudget = requestBudgetMs(deadline, now());
+        const controller = new AbortController();
+        const abortTimer = setTimeout(() => controller.abort(), requestBudget);
+        const budgetExceeded = new Promise((_, reject) => {
+            controller.signal.addEventListener('abort', () => reject(new Error(`Status request aborted at the wait budget edge (capped at ${requestBudget} ms)`)), { once: true });
+        });
+        let fetched;
+        try {
+            fetched = await Promise.race([params.fetchStatus(controller.signal), budgetExceeded]);
+            consecutiveFailures = 0;
+        }
+        catch (error) {
+            if (now() >= deadline) {
+                // The request was cancelled by the wait budget, not by a query error.
+                break;
+            }
+            consecutiveFailures++;
+            if (consecutiveFailures >= MAX_CONSECUTIVE_POLL_FAILURES) {
+                return {
+                    success: false,
+                    task_id: params.taskId,
+                    status: 'unknown',
+                    error: `Status polling failed ${consecutiveFailures} times in a row: ${error instanceof Error ? error.message : String(error)}`,
+                    note: `The task has been created and may still be running. Use ${params.continueHint} with this task_id to follow up.`,
+                };
+            }
+            await delay(remainingSleepMs(intervalMs, deadline, now()));
+            continue;
+        }
+        finally {
+            clearTimeout(abortTimer);
+        }
+        const kind = classifyStatus(fetched.status);
+        if (kind === 'ok') {
+            return { success: true, task_id: params.taskId, status: fetched.status, ...fetched.payload };
+        }
+        if (kind === 'failed') {
+            return { success: false, task_id: params.taskId, status: fetched.status, ...fetched.payload };
+        }
+        if (kind === 'unknown') {
+            unknownSightings++;
+            if (unknownSightings >= MAX_UNKNOWN_STATUS_SIGHTINGS) {
+                return {
+                    success: false,
+                    task_id: params.taskId,
+                    status: fetched.status ?? 'unknown',
+                    error: `Unrecognized task status: ${JSON.stringify(fetched.status)}`,
+                    note: `The backend reported an unknown status. Use ${params.continueHint} with this task_id to follow up manually.`,
+                };
+            }
+        }
+        // Still processing: stop before exceeding either limit; no trailing sleep.
+        if (attempts >= maxAttempts || now() >= deadline) {
+            break;
+        }
+        await delay(remainingSleepMs(intervalMs, deadline, now()));
+    }
+    const queryText = attempts === 1 ? '1 status query' : `${attempts} status queries`;
+    return {
+        success: true,
+        status: 'processing',
+        task_id: params.taskId,
+        message: `Task is still processing (waited ${formatElapsedSeconds(now() - startedAt)}, ${queryText}). Please use ${params.continueHint} to continue polling.`,
+        note: 'The synchronous wait for this long-running task has been truncated. Switch to task status polling.',
+    };
+}
+//# sourceMappingURL=tooling.js.map

package/dist/tooling.js.map

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

package/dist/tos.d.ts

@@ -0,0 +1,35 @@
+import { AxiosResponse } from 'axios';
+import * as fs from 'fs';
+export declare const MAX_FILE_SIZE_BYTES: number;
+export declare const TOS_UPLOAD_TIMEOUT_MS = 120000;
+export declare const DOWNLOAD_TIMEOUT_MS = 15000;
+export type MediaKind = 'image' | 'video';
+export declare function checkLocalFile(filePath: string, kind: MediaKind): {
+    filePath: string;
+    fileName: string;
+};
+export declare function decodeBase64Image(input: string): {
+    buffer: Buffer;
+    fileName: string;
+};
+export declare function isPrivateIp(ip: string): boolean;
+export declare function assertPublicHttpUrl(rawUrl: string): Promise<URL>;
+export declare function downloadToBuffer(rawUrl: string): Promise<Buffer>;
+export type UnwrapResult = {
+    ok: true;
+    data: any;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function unwrapEnvelope(response: Pick<AxiosResponse, 'data' | 'status'>, successCodes?: Set<number>): UnwrapResult;
+export declare function formatRequestError(error: any, rawUrl?: string): string;
+export interface TosUploadTarget {
+    url: string;
+    fileId: string;
+    objectKey: string;
+    fields: Record<string, string>;
+}
+export declare function parseTosSignature(signatureData: any): TosUploadTarget;
+export declare function uploadToTos(target: TosUploadTarget, data: fs.ReadStream | Buffer, fileName: string): Promise<void>;
+//# sourceMappingURL=tos.d.ts.map

package/dist/tos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tos.d.ts","sourceRoot":"","sources":["../src/tos.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAKzB,eAAO,MAAM,mBAAmB,QAAoB,CAAC;AACrD,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAC5C,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAMzC,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AA+B1C,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAqBxG;AAeD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAarF;AAMD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAsB/C;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAsBtE;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBtE;AAMD,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAIlF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,CAAC,EAAE,YAAY,GAAE,GAAG,CAAC,MAAM,CAAyB,GAAG,YAAY,CAehJ;AAgBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAatE;AAMD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AA2BD,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,GAAG,GAAG,eAAe,CA6CrE;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxH"}

package/dist/tos.js

@@ -0,0 +1,281 @@
+import axios from 'axios';
+import * as dns from 'dns/promises';
+import * as fs from 'fs';
+import * as net from 'net';
+import * as path from 'path';
+import FormData from 'form-data';
+export const MAX_FILE_SIZE_BYTES = 100 * 1024 * 1024;
+export const TOS_UPLOAD_TIMEOUT_MS = 120000;
+export const DOWNLOAD_TIMEOUT_MS = 15000;
+const IMAGE_EXTENSIONS = new Set(['.png', '.jpg', '.jpeg', '.bmp', '.webp']);
+const VIDEO_EXTENSIONS = new Set(['.mp4', '.mov', '.m4v', '.avi', '.mkv', '.webm']);
+const MAGIC_SIGNATURES = [
+    { extensions: ['.png'], matches: (h) => h.length >= 4 && h[0] === 0x89 && h[1] === 0x50 && h[2] === 0x4e && h[3] === 0x47 },
+    { extensions: ['.jpg', '.jpeg'], matches: (h) => h.length >= 3 && h[0] === 0xff && h[1] === 0xd8 && h[2] === 0xff },
+    { extensions: ['.bmp'], matches: (h) => h.length >= 2 && h[0] === 0x42 && h[1] === 0x4d },
+    { extensions: ['.webp'], matches: (h) => h.length >= 12 && h.toString('ascii', 0, 4) === 'RIFF' && h.toString('ascii', 8, 12) === 'WEBP' },
+    { extensions: ['.mp4', '.mov', '.m4v'], matches: (h) => h.length >= 8 && h.toString('ascii', 4, 8) === 'ftyp' },
+    { extensions: ['.avi'], matches: (h) => h.length >= 12 && h.toString('ascii', 0, 4) === 'RIFF' && h.toString('ascii', 8, 12) === 'AVI ' },
+    { extensions: ['.mkv', '.webm'], matches: (h) => h.length >= 4 && h[0] === 0x1a && h[1] === 0x45 && h[2] === 0xdf && h[3] === 0xa3 },
+];
+function readFileHeader(filePath, length) {
+    const fd = fs.openSync(filePath, 'r');
+    try {
+        const header = Buffer.alloc(length);
+        const bytesRead = fs.readSync(fd, header, 0, length, 0);
+        return header.subarray(0, bytesRead);
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+export function checkLocalFile(filePath, kind) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`File does not exist: ${filePath}`);
+    }
+    const stats = fs.statSync(filePath);
+    if (!stats.isFile()) {
+        throw new Error(`Not a regular file: ${filePath}`);
+    }
+    if (stats.size > MAX_FILE_SIZE_BYTES) {
+        throw new Error('File size exceeds 100MB limit');
+    }
+    const extension = path.extname(filePath).toLowerCase();
+    const allowed = kind === 'image' ? IMAGE_EXTENSIONS : VIDEO_EXTENSIONS;
+    if (!allowed.has(extension)) {
+        throw new Error(`Unsupported ${kind} file extension "${extension}"; allowed: ${[...allowed].join(', ')}`);
+    }
+    const signature = MAGIC_SIGNATURES.find((entry) => entry.extensions.includes(extension));
+    if (signature && !signature.matches(readFileHeader(filePath, 12))) {
+        throw new Error(`File content does not match its "${extension}" extension (magic number check failed): ${filePath}`);
+    }
+    return { filePath, fileName: path.basename(filePath) };
+}
+// ---------------------------------------------------------------------------
+// Base64 image input
+// ---------------------------------------------------------------------------
+const MIME_EXTENSION = {
+    'image/png': 'png',
+    'image/jpeg': 'jpg',
+    'image/bmp': 'bmp',
+    'image/webp': 'webp',
+};
+const DATA_URL_PATTERN = /^data:([^;,]+);base64,(.*)$/s;
+export function decodeBase64Image(input) {
+    const trimmed = input.trim();
+    const match = DATA_URL_PATTERN.exec(trimmed);
+    const extension = match ? MIME_EXTENSION[match[1].toLowerCase()] ?? 'png' : 'png';
+    const base64 = match ? match[2] : trimmed;
+    const buffer = Buffer.from(base64, 'base64');
+    if (buffer.length === 0) {
+        throw new Error('imageBase64 decoded to empty content');
+    }
+    if (buffer.length > MAX_FILE_SIZE_BYTES) {
+        throw new Error('Image size exceeds 100MB limit');
+    }
+    return { buffer, fileName: `image.${extension}` };
+}
+// ---------------------------------------------------------------------------
+// SSRF guard for remote fetches
+// ---------------------------------------------------------------------------
+export function isPrivateIp(ip) {
+    if (net.isIPv4(ip)) {
+        const [a, b] = ip.split('.').map(Number);
+        return (a === 0 ||
+            a === 10 ||
+            a === 127 ||
+            (a === 100 && b >= 64 && b <= 127) || // CGNAT 100.64.0.0/10 (cloud metadata, e.g. 100.100.100.200)
+            (a === 172 && b >= 16 && b <= 31) ||
+            (a === 192 && b === 168) ||
+            (a === 169 && b === 254) ||
+            (a === 198 && (b === 18 || b === 19)) || // benchmarking 198.18.0.0/15
+            a >= 224);
+    }
+    if (net.isIPv6(ip)) {
+        const lower = ip.toLowerCase();
+        if (lower === '::1' || lower === '::')
+            return true;
+        if (lower.startsWith('fe80') || lower.startsWith('fc') || lower.startsWith('fd'))
+            return true;
+        if (lower.startsWith('::ffff:'))
+            return isPrivateIp(lower.slice(7));
+    }
+    return false;
+}
+export async function assertPublicHttpUrl(rawUrl) {
+    let url;
+    try {
+        url = new URL(rawUrl);
+    }
+    catch {
+        throw new Error(`Invalid URL: ${rawUrl}`);
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new Error(`Only http(s) URLs are allowed: ${rawUrl}`);
+    }
+    const hostname = url.hostname;
+    if (net.isIP(hostname)) {
+        if (isPrivateIp(hostname)) {
+            throw new Error(`Refusing to fetch from a private or reserved address: ${hostname}`);
+        }
+    }
+    else {
+        const { address } = await dns.lookup(hostname);
+        if (isPrivateIp(address)) {
+            throw new Error(`Refusing to fetch ${hostname}: resolves to private or reserved address ${address}`);
+        }
+    }
+    return url;
+}
+export async function downloadToBuffer(rawUrl) {
+    await assertPublicHttpUrl(rawUrl);
+    const response = await axios.get(rawUrl, {
+        responseType: 'arraybuffer',
+        timeout: DOWNLOAD_TIMEOUT_MS,
+        maxContentLength: MAX_FILE_SIZE_BYTES,
+        maxRedirects: 3,
+        beforeRedirect: (options) => {
+            const host = String(options.hostname ?? options.host ?? '');
+            if (net.isIP(host) && isPrivateIp(host)) {
+                throw new Error(`Refusing redirect to a private or reserved address: ${host}`);
+            }
+        },
+    });
+    const buffer = Buffer.from(response.data);
+    if (buffer.length > MAX_FILE_SIZE_BYTES) {
+        throw new Error('Downloaded content exceeds 100MB limit');
+    }
+    return buffer;
+}
+const DEFAULT_SUCCESS_CODES = new Set([0, 200]);
+export function unwrapEnvelope(response, successCodes = DEFAULT_SUCCESS_CODES) {
+    const body = response.data;
+    if (body && typeof body === 'object' && !Array.isArray(body) && !Buffer.isBuffer(body)) {
+        const code = body.code;
+        if (successCodes.has(code)) {
+            return { ok: true, data: body.data };
+        }
+        const message = body.message ?? body.error;
+        if (message !== undefined && message !== null && message !== '') {
+            return { ok: false, error: String(message) };
+        }
+        return { ok: false, error: `API returned code=${code === undefined ? 'missing' : code} (HTTP ${response.status})` };
+    }
+    const preview = String(body).slice(0, 200).replace(/\s+/g, ' ');
+    return { ok: false, error: `Non-JSON response (HTTP ${response.status}): ${preview}` };
+}
+// ---------------------------------------------------------------------------
+// Error formatting (never leaks presigned URL query strings / credentials)
+// ---------------------------------------------------------------------------
+function safeUrlLocation(rawUrl) {
+    if (!rawUrl)
+        return '';
+    try {
+        const url = new URL(rawUrl);
+        return ` url=${url.host}${url.pathname}`;
+    }
+    catch {
+        return '';
+    }
+}
+export function formatRequestError(error, rawUrl) {
+    const location = safeUrlLocation(rawUrl);
+    if (error?.response) {
+        const data = error.response.data;
+        let bodyPreview = '';
+        if (typeof data === 'string') {
+            bodyPreview = ` data=${data.slice(0, 200).replace(/\s+/g, ' ')}`;
+        }
+        else if (data) {
+            bodyPreview = ` data=${JSON.stringify(data).slice(0, 200)}`;
+        }
+        return `status=${error.response.status} statusText=${error.response.statusText}${bodyPreview}${location}`;
+    }
+    return `${error?.message ?? String(error)}${location}`;
+}
+// Whitelist: only these signature fields are ever forwarded as TOS form fields.
+const TOS_FIELD_MAPPING = {
+    algorithm: 'x-tos-algorithm',
+    credential: 'x-tos-credential',
+    date: 'x-tos-date',
+    signature: 'x-tos-signature',
+};
+function decodePolicyJson(policyValue) {
+    let text = policyValue.trim();
+    if (!text.startsWith('{')) {
+        try {
+            text = Buffer.from(text, 'base64').toString('utf-8');
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (!text.startsWith('{'))
+        return undefined;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function parseTosSignature(signatureData) {
+    if (!signatureData || typeof signatureData !== 'object') {
+        throw new Error('Invalid TOS signature response');
+    }
+    const url = signatureData.url;
+    if (typeof url !== 'string' || !url) {
+        throw new Error('Missing upload URL in TOS signature response');
+    }
+    const pathname = new URL(url).pathname;
+    const segments = pathname.split('/');
+    const fileId = decodeURIComponent(segments[segments.length - 1] || '');
+    if (!fileId) {
+        throw new Error('Could not extract file_id from upload URL');
+    }
+    const fields = {};
+    for (const [sourceKey, formKey] of Object.entries(TOS_FIELD_MAPPING)) {
+        const value = signatureData[sourceKey];
+        if (value !== undefined && value !== null) {
+            fields[formKey] = String(value);
+        }
+    }
+    const policyValue = signatureData.origin_policy ?? signatureData.policy;
+    let objectKey = decodeURIComponent(pathname.slice(1));
+    if (policyValue !== undefined && policyValue !== null) {
+        let policyText = String(policyValue);
+        // Different volcengine-tos SDK versions return the policy as plain JSON or
+        // Base64; TOS expects Base64, so normalize here.
+        if (policyText.trim().startsWith('{')) {
+            policyText = Buffer.from(policyText, 'utf-8').toString('base64');
+        }
+        fields['policy'] = policyText;
+        // Prefer the key declared in the policy conditions when available.
+        const policyJson = decodePolicyJson(String(policyValue));
+        const keyCondition = policyJson?.conditions?.find((condition) => condition && typeof condition === 'object' && typeof condition.key === 'string');
+        if (keyCondition) {
+            objectKey = keyCondition.key;
+        }
+    }
+    return { url, fileId, objectKey, fields };
+}
+export async function uploadToTos(target, data, fileName) {
+    const formData = new FormData();
+    formData.append('key', target.objectKey);
+    for (const [key, value] of Object.entries(target.fields)) {
+        formData.append(key, value);
+    }
+    formData.append('file', data, fileName);
+    try {
+        await axios.post(target.url, formData, {
+            headers: formData.getHeaders(),
+            maxBodyLength: Infinity,
+            maxContentLength: Infinity,
+            timeout: TOS_UPLOAD_TIMEOUT_MS,
+        });
+    }
+    catch (error) {
+        throw new Error(`TOS upload failed: ${formatRequestError(error, target.url)}`);
+    }
+}
+//# sourceMappingURL=tos.js.map

package/dist/tos.js.map

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