@avclabs.ai/media-mcp 0.2.0 → 0.3.0

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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"}

package/dist/upload.d.ts

@@ -0,0 +1,79 @@
+import FormData from 'form-data';
+import type { Readable } from 'stream';
+/**
+ * Upload module: take local media and return a `file_id`.
+ *
+ * What the two media hosts disagree about -- signature endpoint, response code convention,
+ * where the object key comes from -- lives behind a SignatureAdapter. Everything they agree
+ * on lives here: storage-form field canonicalisation, `file_id` derivation, error detail
+ * formatting, and the storage POST itself.
+ */
+export interface SignatureTransport {
+    /** POST a JSON payload to the host, returning the decoded response body. */
+    post(requestPath: string, payload: unknown): Promise<unknown>;
+}
+export interface SignatureTransportConfig {
+    baseUrl: string;
+    apiKey: string;
+    auth: 'bearer' | 'x-api-key';
+}
+export declare function createAxiosSignatureTransport(config: SignatureTransportConfig): SignatureTransport;
+export interface StorageTransport {
+    /** POST the signed form to storage. Throws `TOS upload failed: …` on any non-success. */
+    submit(uploadUrl: string, form: FormData): Promise<void>;
+}
+export declare function createAxiosStorageTransport(): StorageTransport;
+export interface StorageForm {
+    /** Absolute storage URL that receives the form. */
+    uploadUrl: string;
+    /** Pre-signed fields, `key` included, ready to append as-is. */
+    formFields: Record<string, string>;
+}
+export interface SignatureAdapter {
+    prepareUpload(fileName: string): Promise<StorageForm>;
+}
+/**
+ * The enhancement host serves images and videos from one signature endpoint; only `file_type`
+ * separates them.
+ */
+export declare function createEnhanceSignatureAdapter(deps: {
+    transport: SignatureTransport;
+    fileType: 'image' | 'video';
+}): SignatureAdapter;
+/** The SAM3 host always sends images. Only the failure message convention differs from enhance. */
+export declare function createSam3SignatureAdapter(deps: {
+    transport: SignatureTransport;
+}): SignatureAdapter;
+export interface UploadDeps {
+    adapter: SignatureAdapter;
+    storage: StorageTransport;
+    body: Buffer | Readable;
+    fileName: string;
+}
+export declare function uploadObject(deps: UploadDeps): Promise<{
+    fileId: string;
+    uploadUrl: string;
+}>;
+/** Pre-binds a signature adapter and the storage transport into the shape the tools call. */
+export type MediaUploader = (body: Buffer | Readable, fileName: string) => Promise<{
+    fileId: string;
+}>;
+export declare function createMediaUploader(deps: {
+    adapter: SignatureAdapter;
+    storage: StorageTransport;
+}): MediaUploader;
+/**
+ * Canonicalise a signature response into storage-form fields.
+ *
+ * Never returns `key`: each host derives the object key differently, so the adapter supplies
+ * it. Tolerates both hosts' naming conventions, so a response that arrives in the other
+ * convention still yields a usable form.
+ */
+export declare function normalizeSignatureFields(response: Record<string, unknown>): Record<string, string>;
+/** Last path segment of the upload URL, percent-decoded. */
+export declare function parseFileIdFromUrl(uploadUrl: string): string;
+export declare function checkLocalFile(filePath: string): {
+    filePath: string;
+    fileName: string;
+};
+//# sourceMappingURL=upload.d.ts.map

package/dist/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAGA,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAEvC;;;;;;;GAOG;AAIH,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;CAC9B;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,wBAAwB,GAAG,kBAAkB,CAwBlG;AAID,MAAM,WAAW,gBAAgB;IAC/B,yFAAyF;IACzF,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED,wBAAgB,2BAA2B,IAAI,gBAAgB,CAiB9D;AAID,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACvD;AAKD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,SAAS,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;CAC7B,GAAG,gBAAgB,CAmBnB;AAED,mGAAmG;AACnG,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAAE,SAAS,EAAE,kBAAkB,CAAA;CAAE,GAAG,gBAAgB,CAuBpG;AAID,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAYnG;AAED,6FAA6F;AAC7F,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEvG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;CAC3B,GAAG,aAAa,CAKhB;AAeD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBlG;AAWD,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAG5D;AA4BD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAUvF"}

package/dist/upload.js

@@ -0,0 +1,190 @@
+import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+import FormData from 'form-data';
+export function createAxiosSignatureTransport(config) {
+    const client = axios.create({
+        baseURL: config.baseUrl.replace(/\/$/, ''),
+        headers: config.auth === 'bearer'
+            ? { Authorization: `Bearer ${config.apiKey}`, 'Content-Type': 'application/json' }
+            : { 'X-API-Key': config.apiKey, 'Content-Type': 'application/json' },
+        timeout: 60000,
+    });
+    return {
+        async post(requestPath, payload) {
+            try {
+                const response = await client.post(requestPath, payload);
+                return response.data;
+            }
+            catch (error) {
+                // Surface the host's own diagnostics, not axios's one-liner.
+                const detail = error.response
+                    ? `status=${error.response.status} data=${JSON.stringify(error.response.data)}`
+                    : error.message;
+                throw new Error(detail);
+            }
+        },
+    };
+}
+export function createAxiosStorageTransport() {
+    return {
+        async submit(uploadUrl, form) {
+            try {
+                await axios.post(uploadUrl, form, {
+                    headers: form.getHeaders(),
+                    maxBodyLength: Infinity,
+                    maxContentLength: Infinity,
+                });
+            }
+            catch (error) {
+                const detail = error.response
+                    ? `status=${error.response.status} statusText=${error.response.statusText} data=${JSON.stringify(error.response.data)} url=${uploadUrl.substring(0, 80)}...`
+                    : error.message;
+                throw new Error(`TOS upload failed: ${detail}`);
+            }
+        },
+    };
+}
+const ENHANCE_SIGNATURE_PATH = '/api/v3/contents/generations/tos-signature';
+const SAM3_SIGNATURE_PATH = '/get_postsignature_url';
+/**
+ * The enhancement host serves images and videos from one signature endpoint; only `file_type`
+ * separates them.
+ */
+export function createEnhanceSignatureAdapter(deps) {
+    return {
+        async prepareUpload(fileName) {
+            const body = await deps.transport.post(ENHANCE_SIGNATURE_PATH, {
+                file_type: deps.fileType,
+                file_name: fileName,
+            });
+            if (body.code !== 0 && body.code !== 200) {
+                throw new Error(body.message || 'Failed to get TOS signature');
+            }
+            const signature = body.data;
+            return {
+                uploadUrl: signature.url,
+                formFields: { key: keyFromUploadUrl(signature.url), ...normalizeSignatureFields(signature) },
+            };
+        },
+    };
+}
+/** The SAM3 host always sends images. Only the failure message convention differs from enhance. */
+export function createSam3SignatureAdapter(deps) {
+    return {
+        async prepareUpload(fileName) {
+            const body = await deps.transport.post(SAM3_SIGNATURE_PATH, {
+                file_type: 'image',
+                file_name: fileName,
+            });
+            if (body.code !== 0 && body.code !== 200) {
+                throw new Error(`get_postsignature_url error: ${body.message || 'unknown error'}`);
+            }
+            const signature = body.data;
+            if (!signature?.url) {
+                throw new Error('Missing upload URL in post signature response');
+            }
+            return {
+                uploadUrl: signature.url,
+                formFields: { key: keyFromPolicyOrUploadUrl(signature), ...normalizeSignatureFields(signature) },
+            };
+        },
+    };
+}
+export async function uploadObject(deps) {
+    const form = await deps.adapter.prepareUpload(deps.fileName);
+    const payload = new FormData();
+    for (const [name, value] of Object.entries(form.formFields)) {
+        payload.append(name, value);
+    }
+    payload.append('file', deps.body, deps.fileName);
+    await deps.storage.submit(form.uploadUrl, payload);
+    return { fileId: parseFileIdFromUrl(form.uploadUrl), uploadUrl: form.uploadUrl };
+}
+export function createMediaUploader(deps) {
+    return async (body, fileName) => {
+        const { fileId } = await uploadObject({ ...deps, body, fileName });
+        return { fileId };
+    };
+}
+// ── shared, host-agnostic helpers ─────────────────────────────────────────────
+/** Fields that describe the authorization itself rather than the storage form. */
+const NOT_FORM_FIELDS = new Set(['url', 'file_id', 'key']);
+/** Bare names the hosts hand back, and the `x-tos-` name storage actually wants. */
+const TOS_FIELD_ALIASES = {
+    algorithm: 'x-tos-algorithm',
+    credential: 'x-tos-credential',
+    date: 'x-tos-date',
+    signature: 'x-tos-signature',
+};
+/**
+ * Canonicalise a signature response into storage-form fields.
+ *
+ * Never returns `key`: each host derives the object key differently, so the adapter supplies
+ * it. Tolerates both hosts' naming conventions, so a response that arrives in the other
+ * convention still yields a usable form.
+ */
+export function normalizeSignatureFields(response) {
+    const hasPolicy = Object.prototype.hasOwnProperty.call(response, 'policy');
+    const fields = {};
+    for (const [name, raw] of Object.entries(response)) {
+        if (NOT_FORM_FIELDS.has(name))
+            continue;
+        if (name === 'origin_policy') {
+            // The policy in its original JSON form. Only needed when the host did not already hand
+            // back a ready-to-post `policy`; taking both would duplicate the field.
+            if (!hasPolicy)
+                fields.policy = encodePolicy(raw);
+            continue;
+        }
+        fields[TOS_FIELD_ALIASES[name] ?? name] = String(raw);
+    }
+    return fields;
+}
+/**
+ * Storage accepts the policy either Base64-encoded or as raw JSON; volcengine-tos SDK versions
+ * differ in which one they hand back. Normalise to Base64.
+ */
+function encodePolicy(raw) {
+    const value = String(raw);
+    return value.trim().startsWith('{') ? Buffer.from(value, 'utf-8').toString('base64') : value;
+}
+/** Last path segment of the upload URL, percent-decoded. */
+export function parseFileIdFromUrl(uploadUrl) {
+    const segments = new URL(uploadUrl).pathname.split('/');
+    return decodeURIComponent(segments.pop() || '');
+}
+function keyFromUploadUrl(uploadUrl) {
+    return decodeURIComponent(new URL(uploadUrl).pathname.slice(1));
+}
+/**
+ * The object key the SAM3 host authorises lives inside its policy conditions. If the policy is
+ * opaque (Base64, or missing entirely) the upload URL carries the same key.
+ */
+function keyFromPolicyOrUploadUrl(signature) {
+    const raw = signature.origin_policy ?? signature.policy;
+    if (typeof raw === 'string') {
+        try {
+            const parsed = JSON.parse(raw);
+            const entry = parsed?.conditions?.find((c) => c && typeof c === 'object' && 'key' in c);
+            if (entry?.key)
+                return String(entry.key);
+        }
+        catch {
+            // Opaque policy; the upload URL below carries the same key.
+        }
+    }
+    return keyFromUploadUrl(signature.url);
+}
+export function checkLocalFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`File does not exist: ${filePath}`);
+    }
+    const stats = fs.statSync(filePath);
+    const maxSize = 100 * 1024 * 1024;
+    if (stats.size > maxSize) {
+        throw new Error('File size exceeds 100MB limit');
+    }
+    return { filePath, fileName: path.basename(filePath) };
+}
+//# sourceMappingURL=upload.js.map

package/dist/upload.js.map

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

package/dist/video-enhancement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"video-enhancement.d.ts","sourceRoot":"","sources":["../src/video-enhancement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0BpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAoGnG"}
+{"version":3,"file":"video-enhancement.d.ts","sourceRoot":"","sources":["../src/video-enhancement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmCpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAkEnG"}