@transloadit/node 4.3.0 → 4.4.0

package/dist/alphalib/goldenTemplates.js

@@ -0,0 +1,46 @@
+export const goldenTemplates = {
+    '~transloadit/encode-hls-video@0.0.1': {
+        slug: '~transloadit/encode-hls-video@0.0.1',
+        version: '0.0.1',
+        description: 'Encode an input video into HLS renditions (270p, 360p, 540p) with an adaptive playlist.',
+        steps: {
+            ':original': {
+                robot: '/upload/handle',
+            },
+            low: {
+                robot: '/video/encode',
+                use: ':original',
+                ffmpeg_stack: 'v7.0.0',
+                preset: 'hls-270p',
+                result: true,
+                turbo: true,
+            },
+            mid: {
+                robot: '/video/encode',
+                use: ':original',
+                ffmpeg_stack: 'v7.0.0',
+                preset: 'hls-360p',
+                result: true,
+                turbo: true,
+            },
+            high: {
+                robot: '/video/encode',
+                use: ':original',
+                ffmpeg_stack: 'v7.0.0',
+                preset: 'hls-540p',
+                result: true,
+                turbo: true,
+            },
+            adaptive: {
+                robot: '/video/adaptive',
+                use: {
+                    steps: ['low', 'mid', 'high'],
+                    bundle_steps: true,
+                },
+                technique: 'hls',
+                playlist_name: 'my_playlist.m3u8',
+            },
+        },
+    },
+};
+//# sourceMappingURL=goldenTemplates.js.map

package/dist/alphalib/goldenTemplates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goldenTemplates.js","sourceRoot":"","sources":["../../src/alphalib/goldenTemplates.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,qCAAqC,EAAE;QACrC,IAAI,EAAE,qCAAqC;QAC3C,OAAO,EAAE,OAAO;QAChB,WAAW,EACT,yFAAyF;QAC3F,KAAK,EAAE;YACL,WAAW,EAAE;gBACX,KAAK,EAAE,gBAAgB;aACxB;YACD,GAAG,EAAE;gBACH,KAAK,EAAE,eAAe;gBACtB,GAAG,EAAE,WAAW;gBAChB,YAAY,EAAE,QAAQ;gBACtB,MAAM,EAAE,UAAU;gBAClB,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;aACZ;YACD,GAAG,EAAE;gBACH,KAAK,EAAE,eAAe;gBACtB,GAAG,EAAE,WAAW;gBAChB,YAAY,EAAE,QAAQ;gBACtB,MAAM,EAAE,UAAU;gBAClB,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;aACZ;YACD,IAAI,EAAE;gBACJ,KAAK,EAAE,eAAe;gBACtB,GAAG,EAAE,WAAW;gBAChB,YAAY,EAAE,QAAQ;gBACtB,MAAM,EAAE,UAAU;gBAClB,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;aACZ;YACD,QAAQ,EAAE;gBACR,KAAK,EAAE,iBAAiB;gBACxB,GAAG,EAAE;oBACH,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC;oBAC7B,YAAY,EAAE,IAAI;iBACnB;gBACD,SAAS,EAAE,KAAK;gBAChB,aAAa,EAAE,kBAAkB;aAClC;SACF;KACF;CACuC,CAAA"}

package/dist/cli/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,GAAG,EAAE,MAAM,WAAW,CAAA;AA4BzC,wBAAgB,SAAS,IAAI,GAAG,CAsC/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,GAAG,EAAE,MAAM,WAAW,CAAA;AA6BzC,wBAAgB,SAAS,IAAI,GAAG,CAyC/B"}

package/dist/cli/commands/index.js

@@ -5,6 +5,7 @@ import { SignatureCommand, SmartCdnSignatureCommand } from "./auth.js";
 import { BillsGetCommand } from "./bills.js";
 import { NotificationsReplayCommand } from "./notifications.js";
 import { TemplatesCreateCommand, TemplatesDeleteCommand, TemplatesGetCommand, TemplatesListCommand, TemplatesModifyCommand, TemplatesSyncCommand, } from "./templates.js";
+import { UploadCommand } from "./upload.js";
 export function createCli() {
     const cli = new Cli({
         binaryLabel: 'Transloadit CLI',
@@ -35,6 +36,8 @@ export function createCli() {
     cli.register(BillsGetCommand);
     // Notifications commands
     cli.register(NotificationsReplayCommand);
+    // Uploads commands
+    cli.register(UploadCommand);
     return cli;
 }
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,WAAW,MAAM,uBAAuB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAErE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAEtE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA;AAE/D,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;QAClB,WAAW,EAAE,iBAAiB;QAC9B,UAAU,EAAE,aAAa;QACzB,aAAa,EAAE,WAAW,CAAC,OAAO;KACnC,CAAC,CAAA;IAEF,oBAAoB;IACpB,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IAClC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;IAErC,uCAAuC;IACvC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IAC9B,GAAG,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAA;IAEtC,sBAAsB;IACtB,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAA;IACrC,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAA;IACnC,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IAClC,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAA;IACrC,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAA;IACrC,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAA;IAEnC,qBAAqB;IACrB,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAA;IACpC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IACjC,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAA;IACpC,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAA;IACpC,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IAClC,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IAElC,iBAAiB;IACjB,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAA;IAE7B,yBAAyB;IACzB,GAAG,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAA;IAExC,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAEzC,OAAO,WAAW,MAAM,uBAAuB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAErE,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AAEtE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA;AAE/D,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;QAClB,WAAW,EAAE,iBAAiB;QAC9B,UAAU,EAAE,aAAa;QACzB,aAAa,EAAE,WAAW,CAAC,OAAO;KACnC,CAAC,CAAA;IAEF,oBAAoB;IACpB,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;IAClC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAA;IAErC,uCAAuC;IACvC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAA;IAC9B,GAAG,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAA;IAEtC,sBAAsB;IACtB,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAA;IACrC,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAA;IACnC,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IAClC,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAA;IACrC,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAA;IACrC,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAA;IAEnC,qBAAqB;IACrB,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAA;IACpC,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IACjC,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAA;IACpC,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAA;IACpC,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IAClC,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAA;IAElC,iBAAiB;IACjB,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAA;IAE7B,yBAAyB;IACzB,GAAG,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAA;IAExC,mBAAmB;IACnB,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAA;IAE3B,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/cli/commands/upload.d.ts

@@ -0,0 +1,22 @@
+import type { IOutputCtl } from '../OutputCtl.ts';
+import { UnauthenticatedCommand } from './BaseCommand.ts';
+export interface UploadOptions {
+    file: string;
+    createUploadEndpoint?: string;
+    resumeUploadEndpoint?: string;
+    assemblyUrl: string;
+    field?: string;
+}
+export declare function upload(output: IOutputCtl, { file, createUploadEndpoint, resumeUploadEndpoint, assemblyUrl, field, }: UploadOptions): Promise<void>;
+export declare class UploadCommand extends UnauthenticatedCommand {
+    static paths: string[][];
+    static usage: import("clipanion").Usage;
+    file: string;
+    tusEndpoint: string | undefined;
+    assemblyUrl: string;
+    createUploadEndpoint: string | undefined;
+    resumeUploadEndpoint: string | undefined;
+    field: string | undefined;
+    protected run(): Promise<number | undefined>;
+}
+//# sourceMappingURL=upload.d.ts.map

package/dist/cli/commands/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/upload.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAQD,wBAAsB,MAAM,CAC1B,MAAM,EAAE,UAAU,EAClB,EACE,IAAI,EACJ,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,KAAmB,GACpB,EAAE,aAAa,GACf,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED,qBAAa,aAAc,SAAQ,sBAAsB;IACvD,OAAgB,KAAK,aAAe;IAEpC,OAAgB,KAAK,4BAiBnB;IAEF,IAAI,SAAoC;IACxC,WAAW,qBAAqC;IAEhD,WAAW,SAGT;IAEF,oBAAoB,qBAElB;IAEF,oBAAoB,qBAElB;IAEF,KAAK,qBAEH;cAEc,GAAG,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAenD"}

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();
+};
+export 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/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,38 @@
+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';
+};
+export declare const listRobots: (options?: RobotListOptions) => RobotListResult;
+export declare const getRobotHelp: (options: RobotHelpOptions) => RobotHelp;
+//# 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,CAAA;CAChD,CAAA;AAoND,eAAO,MAAM,UAAU,GAAI,UAAS,gBAAqB,KAAG,eAkC3D,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,SAAS,gBAAgB,KAAG,SA6BxD,CAAA"}