@transloadit/node 4.7.7 → 4.8.0

package/dist/cli/semanticIntents/imageGenerate.d.ts

@@ -0,0 +1,94 @@
+import type { PreparedIntentInputs } from '../intentRuntime.ts';
+declare function createImageGenerateStep(rawValues: Record<string, unknown>, context: {
+    hasInputs: boolean;
+}): Record<string, unknown>;
+export declare const imageGenerateSemanticIntentDescriptor: {
+    readonly createStep: typeof createImageGenerateStep;
+    readonly execution: {
+        readonly kind: "dynamic-step";
+        readonly handler: "image-generate";
+        readonly resultStepName: "generate";
+        readonly fields: readonly [{
+            readonly name: "prompt";
+            readonly kind: "string";
+            readonly propertyName: "prompt";
+            readonly optionFlags: "--prompt";
+            readonly description: "The prompt describing the desired image content.";
+            readonly required: true;
+            readonly exampleValue: string;
+        }, {
+            readonly name: "model";
+            readonly kind: "string";
+            readonly propertyName: "model";
+            readonly optionFlags: "--model";
+            readonly description: "The AI model to use for image generation. Defaults to google/nano-banana-2.";
+            readonly required: false;
+            readonly exampleValue: "google/nano-banana-2";
+        }, {
+            readonly name: "format";
+            readonly kind: "string";
+            readonly propertyName: "format";
+            readonly optionFlags: "--format";
+            readonly description: "Format of the generated image.";
+            readonly required: false;
+            readonly exampleValue: "jpg";
+        }, {
+            readonly name: "seed";
+            readonly kind: "number";
+            readonly propertyName: "seed";
+            readonly optionFlags: "--seed";
+            readonly description: "Seed for the random number generator.";
+            readonly required: false;
+        }, {
+            readonly name: "aspectRatio";
+            readonly kind: "string";
+            readonly propertyName: "aspectRatio";
+            readonly optionFlags: "--aspect-ratio";
+            readonly description: "Aspect ratio of the generated image.";
+            readonly required: false;
+        }, {
+            readonly name: "height";
+            readonly kind: "number";
+            readonly propertyName: "height";
+            readonly optionFlags: "--height";
+            readonly description: "Height of the generated image.";
+            readonly required: false;
+        }, {
+            readonly name: "width";
+            readonly kind: "number";
+            readonly propertyName: "width";
+            readonly optionFlags: "--width";
+            readonly description: "Width of the generated image.";
+            readonly required: false;
+        }, {
+            readonly name: "style";
+            readonly kind: "string";
+            readonly propertyName: "style";
+            readonly optionFlags: "--style";
+            readonly description: "Style of the generated image.";
+            readonly required: false;
+        }, {
+            readonly name: "numOutputs";
+            readonly kind: "number";
+            readonly propertyName: "numOutputs";
+            readonly optionFlags: "--num-outputs";
+            readonly description: "Number of image variants to generate.";
+            readonly required: false;
+        }];
+    };
+    readonly inputPolicy: {
+        readonly kind: "optional";
+        readonly field: "prompt";
+        readonly attachUseWhenInputsProvided: false;
+    };
+    readonly outputDescription: "Write the result to this path";
+    readonly prepareInputs: (preparedInputs: PreparedIntentInputs) => Promise<PreparedIntentInputs>;
+    readonly presentation: {
+        readonly description: "Generate images from text prompts";
+        readonly details: "Runs `/image/generate`. Without inputs, this is text-to-image. With one or more `--input` files, the inputs are bundled into a single assembly so the prompt can refer to them by filename.";
+        readonly examples: Array<[string, string]>;
+    };
+    readonly runnerKind: "bundled";
+};
+export {};
+//# sourceMappingURL=imageGenerate.d.ts.map

package/dist/cli/semanticIntents/imageGenerate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageGenerate.d.ts","sourceRoot":"","sources":["../../../src/cli/semanticIntents/imageGenerate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA0B,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAuJvF,iBAAS,uBAAuB,CAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2DzB;AAoBD,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAnI3C,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;;CAsJe,CAAA"}

package/dist/cli/semanticIntents/imageGenerate.js

@@ -0,0 +1,215 @@
+import { basename } from 'node:path';
+import { parseOptionalEnumValue } from "./parsing.js";
+const defaultImageGenerateModel = 'google/nano-banana-2';
+const imageGenerateFormats = ['jpeg', 'jpg', 'png', 'gif', 'webp', 'svg'];
+const imageGenerateOptionDefinitions = [
+    {
+        name: 'prompt',
+        kind: 'string',
+        propertyName: 'prompt',
+        optionFlags: '--prompt',
+        description: 'The prompt describing the desired image content.',
+        required: true,
+        exampleValue: JSON.stringify('A red bicycle in a studio'),
+    },
+    {
+        name: 'model',
+        kind: 'string',
+        propertyName: 'model',
+        optionFlags: '--model',
+        description: `The AI model to use for image generation. Defaults to ${defaultImageGenerateModel}.`,
+        required: false,
+        exampleValue: defaultImageGenerateModel,
+    },
+    {
+        name: 'format',
+        kind: 'string',
+        propertyName: 'format',
+        optionFlags: '--format',
+        description: 'Format of the generated image.',
+        required: false,
+        exampleValue: 'jpg',
+    },
+    {
+        name: 'seed',
+        kind: 'number',
+        propertyName: 'seed',
+        optionFlags: '--seed',
+        description: 'Seed for the random number generator.',
+        required: false,
+    },
+    {
+        name: 'aspectRatio',
+        kind: 'string',
+        propertyName: 'aspectRatio',
+        optionFlags: '--aspect-ratio',
+        description: 'Aspect ratio of the generated image.',
+        required: false,
+    },
+    {
+        name: 'height',
+        kind: 'number',
+        propertyName: 'height',
+        optionFlags: '--height',
+        description: 'Height of the generated image.',
+        required: false,
+    },
+    {
+        name: 'width',
+        kind: 'number',
+        propertyName: 'width',
+        optionFlags: '--width',
+        description: 'Width of the generated image.',
+        required: false,
+    },
+    {
+        name: 'style',
+        kind: 'string',
+        propertyName: 'style',
+        optionFlags: '--style',
+        description: 'Style of the generated image.',
+        required: false,
+    },
+    {
+        name: 'numOutputs',
+        kind: 'number',
+        propertyName: 'numOutputs',
+        optionFlags: '--num-outputs',
+        description: 'Number of image variants to generate.',
+        required: false,
+    },
+];
+const imageGenerateCommandPresentation = {
+    description: 'Generate images from text prompts',
+    details: 'Runs `/image/generate`. Without inputs, this is text-to-image. With one or more `--input` files, the inputs are bundled into a single assembly so the prompt can refer to them by filename.',
+    examples: [
+        [
+            'Generate an image from text',
+            'transloadit image generate --prompt "A red bicycle in a studio" --out output.png',
+        ],
+        [
+            'Guide generation with one input image',
+            'transloadit image generate --input subject.jpg --prompt "Place subject.jpg on a magazine cover" --out output.png',
+        ],
+        [
+            'Guide generation with multiple input images',
+            'transloadit image generate --input person1.jpg --input person2.jpg --input background.jpg --prompt "Place person1.jpg feeding person2.jpg in front of background.jpg" --out output.png',
+        ],
+    ],
+};
+function parseOptionalFormat(value) {
+    return parseOptionalEnumValue({
+        flagName: '--format',
+        supportedValues: imageGenerateFormats,
+        value,
+    });
+}
+function parseRequiredPrompt(value) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new Error('image generate requires --prompt');
+    }
+    return value;
+}
+function parseOptionalNumber(flagName, value) {
+    if (value == null || value === '') {
+        return undefined;
+    }
+    const numericValue = typeof value === 'number' ? value : Number(String(value).trim());
+    if (Number.isNaN(numericValue)) {
+        throw new Error(`${flagName} must be a number`);
+    }
+    return numericValue;
+}
+function parseOptionalIntegerRange(flagName, value, { max, min }) {
+    const numericValue = parseOptionalNumber(flagName, value);
+    if (numericValue == null) {
+        return undefined;
+    }
+    if (!Number.isInteger(numericValue) || numericValue < min || numericValue > max) {
+        throw new Error(`${flagName} must be an integer between ${min} and ${max}`);
+    }
+    return numericValue;
+}
+function createImageGenerateStep(rawValues, context) {
+    const step = {
+        robot: '/image/generate',
+        result: true,
+        model: defaultImageGenerateModel,
+        prompt: parseRequiredPrompt(rawValues.prompt),
+    };
+    if (context.hasInputs) {
+        step.use = {
+            steps: [':original'],
+            bundle_steps: true,
+        };
+    }
+    const model = rawValues.model;
+    if (typeof model === 'string' && model.trim() !== '') {
+        step.model = model;
+    }
+    const format = parseOptionalFormat(rawValues.format);
+    if (format != null) {
+        step.format = format;
+    }
+    const seed = parseOptionalNumber('--seed', rawValues.seed);
+    if (seed != null) {
+        step.seed = seed;
+    }
+    const aspectRatio = rawValues.aspectRatio;
+    if (typeof aspectRatio === 'string' && aspectRatio.trim() !== '') {
+        step.aspect_ratio = aspectRatio;
+    }
+    const height = parseOptionalNumber('--height', rawValues.height);
+    if (height != null) {
+        step.height = height;
+    }
+    const width = parseOptionalNumber('--width', rawValues.width);
+    if (width != null) {
+        step.width = width;
+    }
+    const style = rawValues.style;
+    if (typeof style === 'string' && style.trim() !== '') {
+        step.style = style;
+    }
+    const numOutputs = parseOptionalIntegerRange('--num-outputs', rawValues.numOutputs, {
+        min: 1,
+        max: 10,
+    });
+    if (numOutputs != null) {
+        step.num_outputs = numOutputs;
+    }
+    return step;
+}
+function ensureUniqueInputBasenames(preparedInputs) {
+    const seenBasenames = new Map();
+    for (const input of preparedInputs.inputs) {
+        const inputBasename = basename(input);
+        const previousInput = seenBasenames.get(inputBasename);
+        if (previousInput != null) {
+            throw new Error(`image generate requires unique input basenames when prompts refer to files; found duplicate ${inputBasename} in ${previousInput} and ${input}`);
+        }
+        seenBasenames.set(inputBasename, input);
+    }
+    return preparedInputs;
+}
+export const imageGenerateSemanticIntentDescriptor = {
+    createStep: createImageGenerateStep,
+    execution: {
+        kind: 'dynamic-step',
+        handler: 'image-generate',
+        resultStepName: 'generate',
+        fields: imageGenerateOptionDefinitions,
+    },
+    inputPolicy: {
+        kind: 'optional',
+        field: 'prompt',
+        attachUseWhenInputsProvided: false,
+    },
+    outputDescription: 'Write the result to this path',
+    async prepareInputs(preparedInputs) {
+        return await Promise.resolve(ensureUniqueInputBasenames(preparedInputs));
+    },
+    presentation: imageGenerateCommandPresentation,
+    runnerKind: 'bundled',
+};
+//# sourceMappingURL=imageGenerate.js.map

package/dist/cli/semanticIntents/imageGenerate.js.map

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

package/dist/cli/semanticIntents/index.d.ts

@@ -6,7 +6,9 @@ export interface SemanticIntentPresentation {
     examples: Array<[string, string]>;
 }
 export interface SemanticIntentDescriptor {
-    createStep: (rawValues: Record<string, unknown>) => Record<string, unknown>;
+    createStep: (rawValues: Record<string, unknown>, context: {
+        hasInputs: boolean;
+    }) => Record<string, unknown>;
     execution: IntentDynamicStepExecutionDefinition;
     inputPolicy: IntentInputPolicy;
     outputDescription: string;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/semanticIntents/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EACV,oCAAoC,EACpC,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,qBAAqB,CAAA;AAO5B,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3E,SAAS,EAAE,oCAAoC,CAAA;IAC/C,WAAW,EAAE,iBAAiB,CAAA;IAC9B,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,CACd,cAAc,EAAE,oBAAoB,EACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAClC,YAAY,EAAE,0BAA0B,CAAA;IACxC,UAAU,EAAE,gBAAgB,CAAA;CAC7B;AAYD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAMlF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/semanticIntents/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,KAAK,EACV,oCAAoC,EACpC,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,qBAAqB,CAAA;AAQ5B,MAAM,WAAW,0BAA0B;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,CACV,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,KAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5B,SAAS,EAAE,oCAAoC,CAAA;IAC/C,WAAW,EAAE,iBAAiB,CAAA;IAC9B,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,CACd,cAAc,EAAE,oBAAoB,EACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,OAAO,CAAC,oBAAoB,CAAC,CAAA;IAClC,YAAY,EAAE,0BAA0B,CAAA;IACxC,UAAU,EAAE,gBAAgB,CAAA;CAC7B;AAaD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAMlF"}

package/dist/cli/semanticIntents/index.js

@@ -1,7 +1,9 @@
 import { imageDescribeSemanticIntentDescriptor } from "./imageDescribe.js";
+import { imageGenerateSemanticIntentDescriptor } from "./imageGenerate.js";
 import { markdownDocxSemanticIntentDescriptor, markdownPdfSemanticIntentDescriptor, } from "./markdownPdf.js";
 const semanticIntentDescriptors = {
     'image-describe': imageDescribeSemanticIntentDescriptor,
+    'image-generate': imageGenerateSemanticIntentDescriptor,
     'markdown-pdf': {
         ...markdownPdfSemanticIntentDescriptor,
     },

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/semanticIntents/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qCAAqC,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EACL,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,kBAAkB,CAAA;AAqBzB,MAAM,yBAAyB,GAA6C;IAC1E,gBAAgB,EAAE,qCAAqC;IACvD,cAAc,EAAE;QACd,GAAG,mCAAmC;KACvC;IACD,eAAe,EAAE;QACf,GAAG,oCAAoC;KACxC;CACF,CAAA;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,IAAI,CAAC,CAAC,IAAI,IAAI,yBAAyB,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,kDAAkD,IAAI,GAAG,CAAC,CAAA;IAC5E,CAAC;IAED,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAA;AACxC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/semanticIntents/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,qCAAqC,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EAAE,qCAAqC,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,EACL,oCAAoC,EACpC,mCAAmC,GACpC,MAAM,kBAAkB,CAAA;AAwBzB,MAAM,yBAAyB,GAA6C;IAC1E,gBAAgB,EAAE,qCAAqC;IACvD,gBAAgB,EAAE,qCAAqC;IACvD,cAAc,EAAE;QACd,GAAG,mCAAmC;KACvC;IACD,eAAe,EAAE;QACf,GAAG,oCAAoC;KACxC;CACF,CAAA;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAY;IACtD,IAAI,CAAC,CAAC,IAAI,IAAI,yBAAyB,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,kDAAkD,IAAI,GAAG,CAAC,CAAA;IAC5E,CAAC;IAED,OAAO,yBAAyB,CAAC,IAAI,CAAC,CAAA;AACxC,CAAC"}

package/dist/cli/semanticIntents/markdownPdf.js

@@ -52,7 +52,7 @@ function createMarkdownConvertSemanticIntent({ description, details, exampleOutp
         ],
     };
     return {
-        createStep(rawValues) {
+        createStep(rawValues, _context) {
             return {
                 robot: '/document/convert',
                 use: ':original',

package/dist/cli/semanticIntents/markdownPdf.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdownPdf.js","sourceRoot":"","sources":["../../../src/cli/semanticIntents/markdownPdf.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAErD,MAAM,qBAAqB,GAAG,KAAK,CAAA;AACnC,MAAM,oBAAoB,GAAG,QAAQ,CAAA;AACrC,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,KAAK,CAAU,CAAA;AACtD,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAA;AAElD,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,CACL,sBAAsB,CAAC;QACrB,QAAQ,EAAE,mBAAmB;QAC7B,eAAe,EAAE,eAAe;QAChC,KAAK;KACN,CAAC,IAAI,qBAAqB,CAC5B,CAAA;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,CACL,sBAAsB,CAAC;QACrB,QAAQ,EAAE,kBAAkB;QAC5B,eAAe,EAAE,cAAc;QAC/B,KAAK;KACN,CAAC,IAAI,oBAAoB,CAC3B,CAAA;AACH,CAAC;AAED,MAAM,yBAAyB,GAAG;IAChC;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,qDAAqD;QAClE,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,eAAe;QAC7B,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,iDAAiD;QAC9D,QAAQ,EAAE,KAAK;KAChB;CACmD,CAAA;AAEtD,SAAS,mCAAmC,CAAC,EAC3C,WAAW,EACX,OAAO,EACP,aAAa,EACb,MAAM,EACN,OAAO,GAOR;IACC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;IACxC,MAAM,YAAY,GAAG;QACnB,WAAW;QACX,OAAO;QACP,QAAQ,EAAE;YACR;gBACE,+BAA+B,WAAW,OAAO;gBACjD,wBAAwB,MAAM,4BAA4B,aAAa,EAAE;aAC1E;YACD;gBACE,0DAA0D;gBAC1D,wBAAwB,MAAM,iCAAiC;aAChE;SACF;KACmC,CAAA;IAEtC,OAAO;QACL,UAAU,CAAC,SAAS;YAClB,OAAO;gBACL,KAAK,EAAE,mBAAmB;gBAC1B,GAAG,EAAE,WAAW;gBAChB,MAAM,EAAE,IAAI;gBACZ,MAAM;gBACN,eAAe,EAAE,qBAAqB,CAAC,SAAS,CAAC,cAAc,CAAC;gBAChE,cAAc,EAAE,oBAAoB,CAAC,SAAS,CAAC,aAAa,CAAC;gBAC7D,8FAA8F;gBAC9F,wEAAwE;aACzE,CAAA;QACH,CAAC;QACD,SAAS,EAAE;YACT,IAAI,EAAE,cAAc;YACpB,OAAO;YACP,cAAc,EAAE,SAAS;YACzB,MAAM,EAAE,yBAAyB;SAClC;QACD,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QACjC,iBAAiB,EAAE,sBAAsB,WAAW,4BAA4B;QAChF,YAAY;QACZ,UAAU,EAAE,WAAW;KACxB,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mCAAmC,GAAG,mCAAmC,CAAC;IACrF,WAAW,EAAE,+BAA+B;IAC5C,OAAO,EACL,6JAA6J;IAC/J,aAAa,EAAE,YAAY;IAC3B,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,cAAc;CACxB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,oCAAoC,GAAG,mCAAmC,CAAC;IACtF,WAAW,EAAE,yCAAyC;IACtD,OAAO,EACL,wHAAwH;IAC1H,aAAa,EAAE,aAAa;IAC5B,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,eAAe;CACzB,CAAC,CAAA"}
+{"version":3,"file":"markdownPdf.js","sourceRoot":"","sources":["../../../src/cli/semanticIntents/markdownPdf.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAErD,MAAM,qBAAqB,GAAG,KAAK,CAAA;AACnC,MAAM,oBAAoB,GAAG,QAAQ,CAAA;AACrC,MAAM,eAAe,GAAG,CAAC,YAAY,EAAE,KAAK,CAAU,CAAA;AACtD,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAU,CAAA;AAElD,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,CACL,sBAAsB,CAAC;QACrB,QAAQ,EAAE,mBAAmB;QAC7B,eAAe,EAAE,eAAe;QAChC,KAAK;KACN,CAAC,IAAI,qBAAqB,CAC5B,CAAA;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC1C,OAAO,CACL,sBAAsB,CAAC;QACrB,QAAQ,EAAE,kBAAkB;QAC5B,eAAe,EAAE,cAAc;QAC/B,KAAK;KACN,CAAC,IAAI,oBAAoB,CAC3B,CAAA;AACH,CAAC;AAED,MAAM,yBAAyB,GAAG;IAChC;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,qDAAqD;QAClE,QAAQ,EAAE,KAAK;KAChB;IACD;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,eAAe;QAC7B,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,iDAAiD;QAC9D,QAAQ,EAAE,KAAK;KAChB;CACmD,CAAA;AAEtD,SAAS,mCAAmC,CAAC,EAC3C,WAAW,EACX,OAAO,EACP,aAAa,EACb,MAAM,EACN,OAAO,GAOR;IACC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;IACxC,MAAM,YAAY,GAAG;QACnB,WAAW;QACX,OAAO;QACP,QAAQ,EAAE;YACR;gBACE,+BAA+B,WAAW,OAAO;gBACjD,wBAAwB,MAAM,4BAA4B,aAAa,EAAE;aAC1E;YACD;gBACE,0DAA0D;gBAC1D,wBAAwB,MAAM,iCAAiC;aAChE;SACF;KACmC,CAAA;IAEtC,OAAO;QACL,UAAU,CAAC,SAAS,EAAE,QAAQ;YAC5B,OAAO;gBACL,KAAK,EAAE,mBAAmB;gBAC1B,GAAG,EAAE,WAAW;gBAChB,MAAM,EAAE,IAAI;gBACZ,MAAM;gBACN,eAAe,EAAE,qBAAqB,CAAC,SAAS,CAAC,cAAc,CAAC;gBAChE,cAAc,EAAE,oBAAoB,CAAC,SAAS,CAAC,aAAa,CAAC;gBAC7D,8FAA8F;gBAC9F,wEAAwE;aACzE,CAAA;QACH,CAAC;QACD,SAAS,EAAE;YACT,IAAI,EAAE,cAAc;YACpB,OAAO;YACP,cAAc,EAAE,SAAS;YACzB,MAAM,EAAE,yBAAyB;SAClC;QACD,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QACjC,iBAAiB,EAAE,sBAAsB,WAAW,4BAA4B;QAChF,YAAY;QACZ,UAAU,EAAE,WAAW;KACxB,CAAA;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mCAAmC,GAAG,mCAAmC,CAAC;IACrF,WAAW,EAAE,+BAA+B;IAC5C,OAAO,EACL,6JAA6J;IAC/J,aAAa,EAAE,YAAY;IAC3B,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,cAAc;CACxB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,oCAAoC,GAAG,mCAAmC,CAAC;IACtF,WAAW,EAAE,yCAAyC;IACtD,OAAO,EACL,wHAAwH;IAC1H,aAAa,EAAE,aAAa;IAC5B,MAAM,EAAE,MAAM;IACd,OAAO,EAAE,eAAe;CACzB,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@transloadit/node",
-  "version": "4.7.7",
+  "version": "4.8.0",
   "description": "Node.js SDK for Transloadit",
   "homepage": "https://github.com/transloadit/node-sdk/tree/main/packages/node",
   "bugs": {

package/src/cli/generateIntentDocs.ts

@@ -1,5 +1,6 @@
 import { mkdir, readFile, writeFile } from 'node:fs/promises'
 import { dirname } from 'node:path'
+import { pathToFileURL } from 'node:url'
 import {
   getConcurrencyOptionDocumentation,
   getDeleteAfterProcessingOptionDocumentation,
@@ -127,7 +128,14 @@ function getBackendSummary(catalogDefinition: IntentDefinition): string {
 function getUsage(definition: ResolvedIntentCommandDefinition): string {
   const parts = ['npx transloadit', ...definition.paths]
   if (definition.runnerKind !== 'no-input') {
-    parts.push('--input', '<path|dir|url|->')
+    if (
+      'inputPolicy' in definition.intentDefinition &&
+      definition.intentDefinition.inputPolicy.kind === 'optional'
+    ) {
+      parts.push('[--input', '<path|dir|url|->]')
+    } else {
+      parts.push('--input', '<path|dir|url|->')
+    }
   }
   parts.push('[options]')
   return parts.join(' ')
@@ -322,7 +330,7 @@ function renderAtAGlanceTable(definitions: ResolvedIntentCommandDefinition[]): s
   )
 }
 
-function renderIntentDocsBody({
+export function renderIntentDocsBody({
   definitions,
   headingLevel,
 }: {
@@ -359,6 +367,15 @@ function renderIntentDocsBody({
   return lines.join('\n').trim()
 }
 
+function isEntrypoint(): boolean {
+  const entrypoint = process.argv[1]
+  if (entrypoint == null) {
+    return false
+  }
+
+  return import.meta.url === pathToFileURL(entrypoint).href
+}
+
 function replaceGeneratedBlock({
   endMarker,
   markdown,
@@ -410,10 +427,12 @@ async function main(): Promise<void> {
   await writeFile(readmeUrl, `${nextReadme}\n`)
 }
 
-main().catch((error) => {
-  if (!(error instanceof Error)) {
-    throw new Error(`Was thrown a non-error: ${String(error)}`)
-  }
-  console.error(error)
-  process.exit(1)
-})
+if (isEntrypoint()) {
+  main().catch((error) => {
+    if (!(error instanceof Error)) {
+      throw new Error(`Was thrown a non-error: ${String(error)}`)
+    }
+    console.error(error)
+    process.exit(1)
+  })
+}

package/src/cli/intentCommandSpecs.ts

@@ -37,10 +37,6 @@ import {
   robotImageBgremoveInstructionsSchema,
   meta as robotImageBgremoveMeta,
 } from '../alphalib/types/robots/image-bgremove.ts'
-import {
-  robotImageGenerateInstructionsSchema,
-  meta as robotImageGenerateMeta,
-} from '../alphalib/types/robots/image-generate.ts'
 import {
   robotImageOptimizeInstructionsSchema,
   meta as robotImageOptimizeMeta,
@@ -169,11 +165,10 @@ export function findIntentDefinitionByPaths(
 }
 
 export const intentCatalog = [
-  defineRobotIntent({
-    kind: 'robot',
-    robot: '/image/generate',
-    meta: robotImageGenerateMeta,
-    schema: robotImageGenerateInstructionsSchema,
+  defineSemanticIntent({
+    kind: 'semantic',
+    paths: ['image', 'generate'],
+    semantic: 'image-generate',
   }),
   defineRobotIntent({
     kind: 'robot',

package/src/cli/intentRuntime.ts

@@ -318,8 +318,9 @@ function createSingleStep(
 function createDynamicIntentStep(
   execution: IntentDynamicStepExecutionDefinition,
   rawValues: Record<string, unknown>,
+  hasInputs: boolean,
 ): Record<string, unknown> {
-  return getSemanticIntentDescriptor(execution.handler).createStep(rawValues)
+  return getSemanticIntentDescriptor(execution.handler).createStep(rawValues, { hasInputs })
 }
 
 function requiresLocalInput(
@@ -367,7 +368,11 @@ async function executeIntentCommand({
                     rawValues,
                     createOptions.inputs.length > 0,
                   )
-                : createDynamicIntentStep(definition.execution, rawValues),
+                : createDynamicIntentStep(
+                    definition.execution,
+                    rawValues,
+                    createOptions.inputs.length > 0,
+                  ),
           } as AssembliesCreateOptions['stepsData'],
         }
 
@@ -563,7 +568,7 @@ abstract class GeneratedFileIntentCommandBase extends GeneratedIntentCommandBase
 
     const execution = this.getIntentDefinition().execution
     if (execution.kind === 'dynamic-step') {
-      createDynamicIntentStep(execution, rawValues)
+      createDynamicIntentStep(execution, rawValues, this.getProvidedInputCount() > 0)
     }
 
     return undefined

package/src/cli/semanticIntents/imageDescribe.ts

@@ -212,7 +212,10 @@ function buildDescribeAiChatMessages({
   }
 }
 
-function createImageDescribeStep(rawValues: Record<string, unknown>): Record<string, unknown> {
+function createImageDescribeStep(
+  rawValues: Record<string, unknown>,
+  _context: { hasInputs: boolean },
+): Record<string, unknown> {
   const { fields, profile } = resolveImageDescribeRequest(rawValues)
   if (fields.length === 1 && fields[0] === 'labels') {
     return {