transloadit 4.7.4 → 4.8.0

package/dist/cli/intentCommands.js

@@ -0,0 +1,368 @@
+import { Command } from 'clipanion';
+import { getIntentPaths, getIntentResultStepName, intentCatalog } from "./intentCommandSpecs.js";
+import { createIntentOption, inferIntentExampleValue, inferIntentFieldKind, unwrapIntentSchema, } from "./intentFields.js";
+import { GeneratedBundledFileIntentCommand, GeneratedNoInputIntentCommand, GeneratedStandardFileIntentCommand, GeneratedWatchableFileIntentCommand, getIntentOptionDefinitions, } from "./intentRuntime.js";
+import { getSemanticIntentDescriptor } from "./semanticIntents/index.js";
+const hiddenFieldNames = new Set([
+    'ffmpeg_stack',
+    'force_accept',
+    'ignore_errors',
+    'imagemagick_stack',
+    'output_meta',
+    'queue',
+    'result',
+    'robot',
+    'stack',
+    'use',
+]);
+function toCamelCase(value) {
+    return value.replace(/_([a-z])/g, (_match, letter) => letter.toUpperCase());
+}
+function toKebabCase(value) {
+    return value.replaceAll('_', '-');
+}
+function toPascalCase(parts) {
+    return parts
+        .flatMap((part) => part.split('-'))
+        .map((part) => `${part[0]?.toUpperCase() ?? ''}${part.slice(1)}`)
+        .join('');
+}
+function stripTrailingPunctuation(value) {
+    return value.replace(/[.:]+$/, '').trim();
+}
+function getTypicalInputFile(meta) {
+    switch (meta.typical_file_type) {
+        case 'audio file':
+            return 'input.mp3';
+        case 'document':
+            return 'input.pdf';
+        case 'image':
+            return 'input.png';
+        case 'video':
+            return 'input.mp4';
+        default:
+            return 'input.file';
+    }
+}
+function getDefaultOutputPath(paths, outputMode) {
+    if (outputMode === 'directory') {
+        return 'output/';
+    }
+    const [group] = paths;
+    if (group === 'audio')
+        return 'output.png';
+    if (group === 'document')
+        return 'output.pdf';
+    if (group === 'image')
+        return 'output.png';
+    if (group === 'text')
+        return 'output.mp3';
+    return 'output.file';
+}
+function inferOutputPath(paths, outputMode, fieldSpecs) {
+    if (outputMode === 'directory') {
+        return 'output/';
+    }
+    const formatExample = fieldSpecs
+        .map((fieldSpec) => fieldSpec.required && fieldSpec.name === 'format' ? fieldSpec.exampleValue : null)
+        .find((value) => value != null);
+    if (fieldSpecs.some((fieldSpec) => fieldSpec.name === 'format') && formatExample != null) {
+        if (fieldSpecs.some((fieldSpec) => fieldSpec.name === 'relative_pathname')) {
+            return `archive.${formatExample}`;
+        }
+    }
+    if (formatExample != null && /^[-\w]+$/.test(formatExample)) {
+        return `output.${formatExample}`;
+    }
+    return getDefaultOutputPath(paths, outputMode);
+}
+function inferInputModeFromShape(shape) {
+    if ('prompt' in shape) {
+        return unwrapIntentSchema(shape.prompt).required ? 'none' : 'local-files';
+    }
+    return 'local-files';
+}
+function inferIntentInput(definition, shape) {
+    const inputMode = definition.inputMode ?? inferInputModeFromShape(shape);
+    if (inputMode === 'none') {
+        return { kind: 'none' };
+    }
+    const promptIsOptional = 'prompt' in shape && !unwrapIntentSchema(shape.prompt).required;
+    const inputPolicy = promptIsOptional
+        ? {
+            kind: 'optional',
+            field: 'prompt',
+            attachUseWhenInputsProvided: true,
+        }
+        : { kind: 'required' };
+    if (definition.defaultSingleAssembly) {
+        return {
+            kind: 'local-files',
+            defaultSingleAssembly: true,
+            inputPolicy,
+        };
+    }
+    return {
+        kind: 'local-files',
+        inputPolicy,
+    };
+}
+function inferFixedValues(definition, input, inputMode) {
+    if (definition.defaultSingleAssembly) {
+        return {
+            robot: definition.robot,
+            result: true,
+            use: {
+                steps: [':original'],
+                bundle_steps: true,
+            },
+        };
+    }
+    if (inputMode === 'none') {
+        return {
+            robot: definition.robot,
+            result: true,
+        };
+    }
+    if (input.kind === 'local-files' && input.inputPolicy.kind === 'required') {
+        return {
+            robot: definition.robot,
+            result: true,
+            use: ':original',
+        };
+    }
+    return {
+        robot: definition.robot,
+        result: true,
+    };
+}
+function collectSchemaFields(schemaShape, fixedValues, input) {
+    return Object.entries(schemaShape)
+        .filter(([key]) => !hiddenFieldNames.has(key) && !Object.hasOwn(fixedValues, key))
+        .flatMap(([key, fieldSchema]) => {
+        const { required: schemaRequired, schema: unwrappedSchema } = unwrapIntentSchema(fieldSchema);
+        let kind;
+        try {
+            kind = inferIntentFieldKind(unwrappedSchema);
+        }
+        catch {
+            return [];
+        }
+        return [
+            {
+                name: key,
+                propertyName: toCamelCase(key),
+                optionFlags: `--${toKebabCase(key)}`,
+                required: (input.kind === 'none' && key === 'prompt') || schemaRequired,
+                description: fieldSchema.description,
+                exampleValue: inferIntentExampleValue({
+                    kind,
+                    name: key,
+                    schema: unwrappedSchema,
+                }),
+                kind,
+            },
+        ];
+    });
+}
+function inferExamples(spec, definition) {
+    if (definition == null) {
+        if (spec.intentDefinition.execution.kind === 'dynamic-step') {
+            return spec.examples;
+        }
+        return [
+            ['Run the command', `transloadit ${spec.paths.join(' ')} --input input.mp4 --out output/`],
+        ];
+    }
+    const parts = ['transloadit', ...spec.paths];
+    const schemaShape = definition.schema.shape;
+    const inputMode = definition.inputMode ?? inferInputModeFromShape(schemaShape);
+    const fieldSpecs = spec.intentDefinition.execution.kind === 'single-step'
+        ? spec.intentDefinition.execution.fields
+        : [];
+    if (inputMode === 'local-files') {
+        parts.push('--input', getTypicalInputFile(definition.meta));
+    }
+    if (inputMode === 'none') {
+        const promptField = fieldSpecs.find((fieldSpec) => fieldSpec.name === 'prompt');
+        parts.push('--prompt', promptField?.exampleValue ?? JSON.stringify('A red bicycle in a studio'));
+    }
+    for (const fieldSpec of fieldSpecs) {
+        if (!fieldSpec.required)
+            continue;
+        if (fieldSpec.name === 'prompt' && inputMode === 'none')
+            continue;
+        parts.push(fieldSpec.optionFlags, fieldSpec.exampleValue);
+    }
+    const outputMode = spec.intentDefinition.outputMode ?? 'file';
+    parts.push('--out', inferOutputPath(spec.paths, outputMode, fieldSpecs));
+    return [['Run the command', parts.join(' ')]];
+}
+function resolveRobotIntent(definition) {
+    const paths = getIntentPaths(definition);
+    const className = `${toPascalCase(paths)}Command`;
+    const commandLabel = paths.join(' ');
+    const schema = definition.schema;
+    const schemaShape = schema.shape;
+    const inputMode = definition.inputMode ?? inferInputModeFromShape(schemaShape);
+    const input = inferIntentInput(definition, schemaShape);
+    const fixedValues = inferFixedValues(definition, input, inputMode);
+    const fieldSpecs = collectSchemaFields(schemaShape, fixedValues, input);
+    const outputMode = definition.outputMode ?? 'file';
+    const execution = {
+        kind: 'single-step',
+        schema,
+        fields: fieldSpecs,
+        fixedValues,
+        resultStepName: getIntentResultStepName(definition) ??
+            (() => {
+                throw new Error(`Could not infer result step name for "${definition.robot}"`);
+            })(),
+    };
+    const spec = {
+        className,
+        description: stripTrailingPunctuation(definition.meta.title),
+        details: getIntentDetails({
+            defaultSingleAssembly: definition.defaultSingleAssembly === true,
+            inputMode,
+            outputMode,
+            robot: definition.robot,
+        }),
+        examples: [],
+        paths,
+        runnerKind: input.kind === 'none' ? 'no-input' : input.defaultSingleAssembly ? 'bundled' : 'standard',
+        intentDefinition: input.kind === 'none'
+            ? {
+                execution,
+                outputDescription: 'Write the result to this path',
+                outputMode,
+            }
+            : {
+                commandLabel,
+                execution,
+                inputPolicy: input.inputPolicy,
+                outputDescription: outputMode === 'directory'
+                    ? 'Write the results to this directory'
+                    : 'Write the result to this path or directory',
+                outputMode,
+            },
+    };
+    return {
+        ...spec,
+        examples: inferExamples(spec, definition),
+    };
+}
+function getIntentDetails({ defaultSingleAssembly, inputMode, outputMode, robot, }) {
+    if (inputMode === 'none') {
+        return `Runs \`${robot}\` and writes the result to \`--out\`.`;
+    }
+    if (defaultSingleAssembly) {
+        return `Runs \`${robot}\` for the provided inputs and writes the result to \`--out\`.`;
+    }
+    if (outputMode === 'directory') {
+        return `Runs \`${robot}\` on each input file and writes the results to \`--out\`.`;
+    }
+    return `Runs \`${robot}\` on each input file and writes the result to \`--out\`.`;
+}
+function resolveSemanticIntent(definition) {
+    const paths = getIntentPaths(definition);
+    const descriptor = getSemanticIntentDescriptor(definition.semantic);
+    return {
+        className: `${toPascalCase(paths)}Command`,
+        description: descriptor.presentation.description,
+        details: descriptor.presentation.details,
+        examples: [...descriptor.presentation.examples],
+        paths,
+        runnerKind: descriptor.runnerKind,
+        intentDefinition: {
+            commandLabel: paths.join(' '),
+            execution: descriptor.execution,
+            inputPolicy: descriptor.inputPolicy,
+            outputDescription: descriptor.outputDescription,
+        },
+    };
+}
+function resolveTemplateIntent(definition) {
+    const outputMode = definition.outputMode ?? 'file';
+    const paths = getIntentPaths(definition);
+    const spec = {
+        className: `${toPascalCase(paths)}Command`,
+        description: `Run ${stripTrailingPunctuation(definition.templateId)}`,
+        details: `Runs the \`${definition.templateId}\` template and writes the outputs to \`--out\`.`,
+        examples: [],
+        paths,
+        runnerKind: 'standard',
+        intentDefinition: {
+            commandLabel: paths.join(' '),
+            execution: {
+                kind: 'template',
+                templateId: definition.templateId,
+            },
+            inputPolicy: { kind: 'required' },
+            outputDescription: outputMode === 'directory'
+                ? 'Write the results to this directory'
+                : 'Write the result to this path or directory',
+            outputMode,
+        },
+    };
+    return {
+        ...spec,
+        examples: inferExamples(spec),
+    };
+}
+function resolveIntent(definition) {
+    if (definition.kind === 'robot') {
+        return resolveRobotIntent(definition);
+    }
+    if (definition.kind === 'semantic') {
+        return resolveSemanticIntent(definition);
+    }
+    return resolveTemplateIntent(definition);
+}
+export function resolveIntentCommandDefinitions() {
+    return intentCatalog.map((definition) => ({
+        ...resolveIntent(definition),
+        catalogDefinition: definition,
+    }));
+}
+function getBaseClass(spec) {
+    if (spec.runnerKind === 'no-input') {
+        return GeneratedNoInputIntentCommand;
+    }
+    if (spec.runnerKind === 'bundled') {
+        return GeneratedBundledFileIntentCommand;
+    }
+    if (spec.runnerKind === 'watchable') {
+        return GeneratedWatchableFileIntentCommand;
+    }
+    return GeneratedStandardFileIntentCommand;
+}
+function createIntentCommandClass(spec) {
+    const BaseClass = getBaseClass(spec);
+    class RuntimeIntentCommand extends BaseClass {
+    }
+    Object.defineProperty(RuntimeIntentCommand, 'name', {
+        value: spec.className,
+    });
+    Object.assign(RuntimeIntentCommand, {
+        paths: [spec.paths],
+        intentDefinition: spec.intentDefinition,
+        usage: Command.Usage({
+            category: 'Intent Commands',
+            description: spec.description,
+            details: spec.details,
+            examples: spec.examples,
+        }),
+    });
+    for (const field of getIntentOptionDefinitions(spec.intentDefinition)) {
+        Object.defineProperty(RuntimeIntentCommand.prototype, field.propertyName, {
+            configurable: true,
+            enumerable: true,
+            writable: true,
+            value: createIntentOption(field),
+        });
+    }
+    return RuntimeIntentCommand;
+}
+export const intentCommands = resolveIntentCommandDefinitions().map(createIntentCommandClass);
+//# sourceMappingURL=intentCommands.js.map

package/dist/cli/intentCommands.js.map

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

package/dist/cli/intentFields.d.ts

@@ -0,0 +1,25 @@
+import type { z } from 'zod';
+export type IntentFieldKind = 'auto' | 'boolean' | 'json' | 'number' | 'string' | 'string-array';
+export interface IntentFieldSpec {
+    kind: IntentFieldKind;
+    name: string;
+}
+export interface IntentOptionLike extends IntentFieldSpec {
+    description?: string;
+    optionFlags: string;
+    required?: boolean;
+}
+export declare function unwrapIntentSchema(input: unknown): {
+    required: boolean;
+    schema: unknown;
+};
+export declare function inferIntentFieldKind(schema: unknown): IntentFieldKind;
+export declare function createIntentOption(fieldDefinition: IntentOptionLike): unknown;
+export declare function parseStringArrayValue(raw: unknown): string[];
+export declare function inferIntentExampleValue({ kind, name, schema, }: {
+    kind: IntentFieldKind;
+    name: string;
+    schema?: z.ZodTypeAny;
+}): string;
+export declare function coerceIntentFieldValue(kind: IntentFieldKind, raw: unknown, fieldSchema?: z.ZodTypeAny): unknown;
+//# sourceMappingURL=intentFields.d.ts.map

package/dist/cli/intentFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intentFields.d.ts","sourceRoot":"","sources":["../../src/cli/intentFields.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAgB5B,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,cAAc,CAAA;AAEhG,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CA8BzF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CAqDrE;AAED,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,gBAAgB,GAAG,OAAO,CA6B7E;AAyBD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAgD5D;AAmBD,wBAAgB,uBAAuB,CAAC,EACtC,IAAI,EACJ,IAAI,EACJ,MAAM,GACP,EAAE;IACD,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,CAAC,CAAC,UAAU,CAAA;CACtB,GAAG,MAAM,CAsCT;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,OAAO,EACZ,WAAW,CAAC,EAAE,CAAC,CAAC,UAAU,GACzB,OAAO,CA+GT"}