transloadit 4.3.0 → 4.6.0

package/dist/cli/commands/upload.js

@@ -0,0 +1,95 @@
+import fs from 'node:fs';
+import { Command, Option } from 'clipanion';
+import { sendTusRequest } from "../../tus.js";
+import { UnauthenticatedCommand } from "./BaseCommand.js";
+const deriveEndpointFromUploadUrl = (uploadUrl) => {
+    const url = new URL(uploadUrl);
+    url.pathname = url.pathname.replace(/\/[^/]*$/, '/');
+    return url.toString();
+};
+async function upload(output, { file, createUploadEndpoint, resumeUploadEndpoint, assemblyUrl, field = ':original', }) {
+    const tusEndpoint = createUploadEndpoint ??
+        (resumeUploadEndpoint ? deriveEndpointFromUploadUrl(resumeUploadEndpoint) : undefined);
+    if (!tusEndpoint) {
+        throw new Error('Provide --create-upload-endpoint or --resume-upload-endpoint.');
+    }
+    const stream = fs.createReadStream(file);
+    const streamsMap = {
+        [field]: { path: file, stream },
+    };
+    const assembly = {
+        tus_url: tusEndpoint,
+        assembly_ssl_url: assemblyUrl,
+    };
+    const { uploadUrls } = await sendTusRequest({
+        streamsMap,
+        assembly,
+        requestedChunkSize: Number.POSITIVE_INFINITY,
+        uploadConcurrency: 1,
+        onProgress: () => { },
+        uploadUrls: resumeUploadEndpoint ? { [field]: resumeUploadEndpoint } : undefined,
+    });
+    const uploadUrl = uploadUrls[field];
+    output.print(`Uploaded ${file}`, {
+        status: 'ok',
+        file,
+        field,
+        assembly_url: assemblyUrl,
+        tus_endpoint: tusEndpoint,
+        resume_upload_endpoint: resumeUploadEndpoint,
+        upload_url: uploadUrl,
+    });
+}
+export class UploadCommand extends UnauthenticatedCommand {
+    static paths = [['upload']];
+    static usage = Command.Usage({
+        category: 'Uploads',
+        description: 'Upload a local file to a tus endpoint for an Assembly',
+        details: `
+      Upload a local file to a tus endpoint and attach it to an existing Assembly.
+      Use --create-upload-endpoint for new uploads or --resume-upload-endpoint to resume.
+    `,
+        examples: [
+            [
+                'Upload a file to an Assembly',
+                'transloadit upload ./video.mp4 --create-upload-endpoint https://api2.transloadit.com/resumable/files/ --assembly https://api2.transloadit.com/assemblies/ASSEMBLY_ID',
+            ],
+            [
+                'Resume a file upload',
+                'transloadit upload ./video.mp4 --resume-upload-endpoint https://api2.transloadit.com/resumable/files/UPLOAD_ID --assembly https://api2.transloadit.com/assemblies/ASSEMBLY_ID',
+            ],
+        ],
+    });
+    file = Option.String({ required: true });
+    tusEndpoint = Option.String({ required: false });
+    assemblyUrl = Option.String('--assembly', {
+        description: 'Assembly URL to attach this upload to',
+        required: true,
+    });
+    createUploadEndpoint = Option.String('--create-upload-endpoint', {
+        description: 'Tus create endpoint (e.g. https://api2.transloadit.com/resumable/files/)',
+    });
+    resumeUploadEndpoint = Option.String('--resume-upload-endpoint', {
+        description: 'Tus upload URL to resume (e.g. https://.../resumable/files/<id>)',
+    });
+    field = Option.String('--field', {
+        description: 'Field name for the upload (default: :original)',
+    });
+    async run() {
+        try {
+            await upload(this.output, {
+                file: this.file,
+                createUploadEndpoint: this.createUploadEndpoint ?? this.tusEndpoint,
+                resumeUploadEndpoint: this.resumeUploadEndpoint,
+                assemblyUrl: this.assemblyUrl,
+                field: this.field,
+            });
+            return undefined;
+        }
+        catch (err) {
+            this.output.error(err instanceof Error ? err.message : String(err));
+            return 1;
+        }
+    }
+}
+//# sourceMappingURL=upload.js.map

package/dist/cli/commands/upload.js.map

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

package/dist/cli/template-last-modified.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-last-modified.d.ts","sourceRoot":"","sources":["../../src/cli/template-last-modified.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAQpD,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,CAAA;AAyC/D,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,SAAS,CAAkC;gBAEvC,MAAM,EAAE,WAAW,EAAE,QAAQ,SAAK;IA8B9C,OAAO,CAAC,OAAO;IAcf,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,IAAI;CA2DhD"}
+{"version":3,"file":"template-last-modified.d.ts","sourceRoot":"","sources":["../../src/cli/template-last-modified.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAQpD,KAAK,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,CAAA;AAyC/D,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,SAAS,CAAkC;gBAEvC,MAAM,EAAE,WAAW,EAAE,QAAQ,SAAK;IA+B9C,OAAO,CAAC,OAAO;IAcf,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,IAAI;CA2DhD"}

package/dist/cli/template-last-modified.js

@@ -52,7 +52,8 @@ export default class ModifiedLookup {
                 for (let i = 0; i < result.items.length; i++) {
                     const item = result.items[i];
                     if (item) {
-                        items[i] = { id: item.id, modified: item.modified };
+                        const modified = typeof item.modified === 'string' ? item.modified : '';
+                        items[i] = { id: item.id, modified };
                     }
                 }
                 cb(null, items);

package/dist/cli/template-last-modified.js.map

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

package/dist/inputFiles.d.ts

@@ -0,0 +1,41 @@
+import type { Readable } from 'node:stream';
+import type { Input as IntoStreamInput } from 'into-stream';
+import type { CreateAssemblyParams } from './apiTypes.ts';
+export type InputFile = {
+    kind: 'path';
+    field: string;
+    path: string;
+} | {
+    kind: 'base64';
+    field: string;
+    base64: string;
+    filename: string;
+    contentType?: string;
+} | {
+    kind: 'url';
+    field: string;
+    url: string;
+    filename?: string;
+    contentType?: string;
+};
+export type UploadInput = Readable | IntoStreamInput;
+export type Base64Strategy = 'buffer' | 'tempfile';
+export type UrlStrategy = 'import' | 'download' | 'import-if-present';
+export type PrepareInputFilesOptions = {
+    inputFiles?: InputFile[];
+    params?: CreateAssemblyParams;
+    fields?: Record<string, unknown>;
+    base64Strategy?: Base64Strategy;
+    urlStrategy?: UrlStrategy;
+    maxBase64Bytes?: number;
+    allowPrivateUrls?: boolean;
+    tempDir?: string;
+};
+export type PrepareInputFilesResult = {
+    params: CreateAssemblyParams;
+    files: Record<string, string>;
+    uploads: Record<string, UploadInput>;
+    cleanup: Array<() => Promise<void>>;
+};
+export declare const prepareInputFiles: (options?: PrepareInputFilesOptions) => Promise<PrepareInputFilesResult>;
+//# sourceMappingURL=inputFiles.d.ts.map

package/dist/inputFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputFiles.d.ts","sourceRoot":"","sources":["../src/inputFiles.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,KAAK,EAAE,KAAK,IAAI,eAAe,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD,MAAM,MAAM,SAAS,GACjB;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb,GACD;IACE,IAAI,EAAE,QAAQ,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GACD;IACE,IAAI,EAAE,KAAK,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAEL,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,eAAe,CAAA;AAEpD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,UAAU,CAAA;AAClD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,mBAAmB,CAAA;AAErE,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAA;IACxB,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,oBAAoB,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACpC,OAAO,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;CACpC,CAAA;AA6FD,eAAO,MAAM,iBAAiB,GAC5B,UAAS,wBAA6B,KACrC,OAAO,CAAC,uBAAuB,CAiIjC,CAAA"}

package/dist/inputFiles.js

@@ -0,0 +1,214 @@
+import { createWriteStream } from 'node:fs';
+import { mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { isIP } from 'node:net';
+import { tmpdir } from 'node:os';
+import { basename, join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import got from 'got';
+const isRecord = (value) => typeof value === 'object' && value !== null;
+const ensureUnique = (field, used) => {
+    if (used.has(field)) {
+        throw new Error(`Duplicate file field: ${field}`);
+    }
+    used.add(field);
+};
+const ensureUniqueStepName = (baseName, used) => {
+    let name = baseName;
+    let counter = 1;
+    while (used.has(name)) {
+        name = `${baseName}_${counter}`;
+        counter += 1;
+    }
+    used.add(name);
+    return name;
+};
+const decodeBase64 = (value) => Buffer.from(value, 'base64');
+const estimateBase64DecodedBytes = (value) => {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return 0;
+    let padding = 0;
+    if (trimmed.endsWith('=='))
+        padding = 2;
+    else if (trimmed.endsWith('='))
+        padding = 1;
+    return Math.floor((trimmed.length * 3) / 4) - padding;
+};
+const getFilenameFromUrl = (value) => {
+    try {
+        const pathname = new URL(value).pathname;
+        const base = basename(pathname);
+        if (base && base !== '/' && base !== '.')
+            return base;
+    }
+    catch {
+        return null;
+    }
+    return null;
+};
+const isHttpImportStep = (value) => isRecord(value) && value.robot === '/http/import';
+const findImportStepName = (field, steps) => {
+    if (isHttpImportStep(steps[field]))
+        return field;
+    const matches = Object.entries(steps).filter(([, step]) => isHttpImportStep(step));
+    if (matches.length === 1)
+        return matches[0]?.[0] ?? null;
+    return null;
+};
+const downloadUrlToFile = async (url, filePath) => {
+    await pipeline(got.stream(url), createWriteStream(filePath));
+};
+const isPrivateIp = (address) => {
+    if (address === 'localhost')
+        return true;
+    const family = isIP(address);
+    if (family === 4) {
+        const parts = address.split('.').map((chunk) => Number(chunk));
+        const [a, b] = parts;
+        if (a === 10)
+            return true;
+        if (a === 127)
+            return true;
+        if (a === 0)
+            return true;
+        if (a === 169 && b === 254)
+            return true;
+        if (a === 172 && b >= 16 && b <= 31)
+            return true;
+        if (a === 192 && b === 168)
+            return true;
+        return false;
+    }
+    if (family === 6) {
+        const normalized = address.toLowerCase();
+        if (normalized === '::1')
+            return true;
+        if (normalized.startsWith('fe80:'))
+            return true;
+        if (normalized.startsWith('fc') || normalized.startsWith('fd'))
+            return true;
+        return false;
+    }
+    return false;
+};
+const assertPublicDownloadUrl = (value) => {
+    const parsed = new URL(value);
+    if (!['http:', 'https:'].includes(parsed.protocol)) {
+        throw new Error(`URL downloads are limited to http/https: ${value}`);
+    }
+    if (isPrivateIp(parsed.hostname)) {
+        throw new Error(`URL downloads are limited to public hosts: ${value}`);
+    }
+};
+export const prepareInputFiles = async (options = {}) => {
+    const { inputFiles = [], params = {}, fields, base64Strategy = 'buffer', urlStrategy = 'import', maxBase64Bytes, allowPrivateUrls = true, tempDir, } = options;
+    let nextParams = { ...params };
+    const files = {};
+    const uploads = {};
+    const cleanup = [];
+    if (fields && Object.keys(fields).length > 0) {
+        nextParams = {
+            ...nextParams,
+            fields: {
+                ...(isRecord(nextParams.fields) ? nextParams.fields : {}),
+                ...fields,
+            },
+        };
+    }
+    const steps = isRecord(nextParams.steps) ? { ...nextParams.steps } : {};
+    const usedSteps = new Set(Object.keys(steps));
+    const usedFields = new Set();
+    const importUrlsByStep = new Map();
+    const importStepNames = Object.keys(steps).filter((name) => isHttpImportStep(steps[name]));
+    const sharedImportStep = importStepNames.length === 1 ? importStepNames[0] : null;
+    let tempRoot = null;
+    const ensureTempRoot = async () => {
+        if (!tempRoot) {
+            const root = await mkdtemp(join(tempDir ?? tmpdir(), 'transloadit-input-'));
+            tempRoot = root;
+            cleanup.push(() => rm(root, { recursive: true, force: true }));
+        }
+        return tempRoot;
+    };
+    try {
+        for (const file of inputFiles) {
+            ensureUnique(file.field, usedFields);
+            if (file.kind === 'path') {
+                files[file.field] = file.path;
+                continue;
+            }
+            if (file.kind === 'base64') {
+                if (maxBase64Bytes) {
+                    const estimated = estimateBase64DecodedBytes(file.base64);
+                    if (estimated > maxBase64Bytes) {
+                        throw new Error(`Base64 payload exceeds ${maxBase64Bytes} bytes.`);
+                    }
+                }
+                const buffer = decodeBase64(file.base64);
+                if (maxBase64Bytes && buffer.length > maxBase64Bytes) {
+                    throw new Error(`Base64 payload exceeds ${maxBase64Bytes} bytes.`);
+                }
+                if (base64Strategy === 'tempfile') {
+                    const root = await ensureTempRoot();
+                    const filename = file.filename ? basename(file.filename) : `${file.field}.bin`;
+                    const filePath = join(root, filename);
+                    await writeFile(filePath, buffer);
+                    files[file.field] = filePath;
+                }
+                else {
+                    uploads[file.field] = buffer;
+                }
+                continue;
+            }
+            if (file.kind === 'url') {
+                const matchedStep = findImportStepName(file.field, steps);
+                const targetStep = matchedStep ?? sharedImportStep;
+                const shouldImport = urlStrategy === 'import' || (urlStrategy === 'import-if-present' && targetStep);
+                if (shouldImport) {
+                    const stepName = targetStep ?? ensureUniqueStepName(file.field, usedSteps);
+                    const urls = importUrlsByStep.get(stepName) ?? [];
+                    urls.push(file.url);
+                    importUrlsByStep.set(stepName, urls);
+                    continue;
+                }
+                const root = await ensureTempRoot();
+                const filename = (file.filename ? basename(file.filename) : null) ??
+                    getFilenameFromUrl(file.url) ??
+                    `${file.field}.bin`;
+                const filePath = join(root, filename);
+                if (!allowPrivateUrls) {
+                    assertPublicDownloadUrl(file.url);
+                }
+                await downloadUrlToFile(file.url, filePath);
+                files[file.field] = filePath;
+            }
+        }
+    }
+    catch (error) {
+        await Promise.all(cleanup.map((fn) => fn()));
+        throw error;
+    }
+    if (Object.keys(steps).length > 0 || importUrlsByStep.size > 0) {
+        if (importUrlsByStep.size > 0) {
+            for (const [stepName, urls] of importUrlsByStep.entries()) {
+                const existing = isRecord(steps[stepName]) ? steps[stepName] : {};
+                steps[stepName] = {
+                    ...existing,
+                    robot: '/http/import',
+                    url: urls.length === 1 ? urls[0] : urls,
+                };
+            }
+        }
+        nextParams = {
+            ...nextParams,
+            steps,
+        };
+    }
+    return {
+        params: nextParams,
+        files,
+        uploads,
+        cleanup,
+    };
+};
+//# sourceMappingURL=inputFiles.js.map

package/dist/inputFiles.js.map

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

package/dist/robots.d.ts

@@ -0,0 +1,39 @@
+export type RobotListOptions = {
+    category?: string;
+    search?: string;
+    limit?: number;
+    cursor?: string;
+};
+export type RobotListItem = {
+    name: string;
+    title?: string;
+    summary: string;
+    category?: string;
+};
+export type RobotListResult = {
+    robots: RobotListItem[];
+    nextCursor?: string;
+};
+export type RobotParamHelp = {
+    name: string;
+    type: string;
+    description?: string;
+};
+export type RobotHelp = {
+    name: string;
+    summary: string;
+    requiredParams: RobotParamHelp[];
+    optionalParams: RobotParamHelp[];
+    examples?: Array<{
+        description: string;
+        snippet: Record<string, unknown>;
+    }>;
+};
+export type RobotHelpOptions = {
+    robotName: string;
+    detailLevel?: 'summary' | 'params' | 'examples' | 'full';
+};
+export declare const listRobots: (options?: RobotListOptions) => RobotListResult;
+export declare const getRobotHelp: (options: RobotHelpOptions) => RobotHelp;
+export declare const isKnownRobot: (robotName: string) => boolean;
+//# sourceMappingURL=robots.d.ts.map

package/dist/robots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.d.ts","sourceRoot":"","sources":["../src/robots.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,cAAc,EAAE,CAAA;IAChC,cAAc,EAAE,cAAc,EAAE,CAAA;IAChC,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAA;CAC5E,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAA;CACzD,CAAA;AAoND,eAAO,MAAM,UAAU,GAAI,UAAS,gBAAqB,KAAG,eAkC3D,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,SAAS,gBAAgB,KAAG,SA6BxD,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,OAMhD,CAAA"}