@transloadit/zod 4.4.0 → 4.4.1

package/dist/v4/robots/transloadit-store.d.ts

@@ -0,0 +1,170 @@
+import type { RobotMetaInput } from './_instructions-primitives.ts';
+import { z } from 'zod/v4';
+export declare const meta: RobotMetaInput;
+export declare const robotTransloaditStoreInstructionsSchema: z.ZodObject<{
+    interpolate: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, boolean | "false" | "true">>, z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, boolean | "false" | "true">>>]>>;
+    output_meta: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+    result: z.ZodDefault<z.ZodBoolean>;
+    queue: z.ZodOptional<z.ZodEnum<{
+        batch: "batch";
+    }>>;
+    force_accept: z.ZodDefault<z.ZodBoolean>;
+    ignore_errors: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
+        meta: "meta";
+        execute: "execute";
+    }>>]>, z.ZodTransform<string[], boolean | ("meta" | "execute")[]>>>;
+    use: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        fields: z.ZodOptional<z.ZodString>;
+        as: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>]>, z.ZodObject<{
+        steps: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            fields: z.ZodOptional<z.ZodString>;
+            as: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>]>;
+        bundle_steps: z.ZodOptional<z.ZodBoolean>;
+        group_by_original: z.ZodOptional<z.ZodBoolean>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>]>>;
+    robot: z.ZodLiteral<"/transloadit/store">;
+    conflict_strategy: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        overwrite: "overwrite";
+        rename: "rename";
+    }>>;
+    path: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+export declare const robotTransloaditStoreInstructionsWithHiddenFieldsSchema: z.ZodObject<{
+    interpolate: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, boolean | "false" | "true">>, z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, boolean | "false" | "true">>>]>>;
+    output_meta: z.ZodOptional<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodBoolean, z.ZodArray<z.ZodString>]>>;
+    queue: z.ZodOptional<z.ZodEnum<{
+        batch: "batch";
+    }>>;
+    force_accept: z.ZodDefault<z.ZodBoolean>;
+    ignore_errors: z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
+        meta: "meta";
+        execute: "execute";
+    }>>]>, z.ZodTransform<string[], boolean | ("meta" | "execute")[]>>>;
+    use: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        fields: z.ZodOptional<z.ZodString>;
+        as: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>]>, z.ZodObject<{
+        steps: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            fields: z.ZodOptional<z.ZodString>;
+            as: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>]>;
+        bundle_steps: z.ZodOptional<z.ZodBoolean>;
+        group_by_original: z.ZodOptional<z.ZodBoolean>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>]>>;
+    robot: z.ZodLiteral<"/transloadit/store">;
+    conflict_strategy: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        overwrite: "overwrite";
+        rename: "rename";
+    }>>;
+    path: z.ZodDefault<z.ZodString>;
+    result: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"debug">, z.ZodDefault<z.ZodBoolean>]>>;
+}, z.core.$strict>;
+export type RobotTransloaditStoreInstructions = z.infer<typeof robotTransloaditStoreInstructionsSchema>;
+export type RobotTransloaditStoreInstructionsWithHiddenFields = z.infer<typeof robotTransloaditStoreInstructionsWithHiddenFieldsSchema>;
+export declare const interpolatableRobotTransloaditStoreInstructionsSchema: z.ZodObject<{
+    interpolate: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, boolean | "false" | "true">>, z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, boolean | "false" | "true">>>]>>;
+    output_meta: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodBoolean]>>, z.ZodUnion<[z.ZodString, z.ZodBoolean]>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>]>>;
+    result: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
+    queue: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEnum<{
+        batch: "batch";
+    }>]>>;
+    force_accept: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
+    ignore_errors: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
+        meta: "meta";
+        execute: "execute";
+    }>>]>, z.ZodTransform<string[], boolean | ("meta" | "execute")[]>>]>>;
+    use: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        fields: z.ZodOptional<z.ZodString>;
+        as: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>]>, z.ZodObject<{
+        steps: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            fields: z.ZodOptional<z.ZodString>;
+            as: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>]>;
+        bundle_steps: z.ZodOptional<z.ZodBoolean>;
+        group_by_original: z.ZodOptional<z.ZodBoolean>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>]>>;
+    robot: z.ZodLiteral<"/transloadit/store">;
+    conflict_strategy: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
+        error: "error";
+        overwrite: "overwrite";
+        rename: "rename";
+    }>]>>;
+    path: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+export type InterpolatableRobotTransloaditStoreInstructions = InterpolatableRobotTransloaditStoreInstructionsInput;
+export type InterpolatableRobotTransloaditStoreInstructionsInput = z.input<typeof interpolatableRobotTransloaditStoreInstructionsSchema>;
+export declare const interpolatableRobotTransloaditStoreInstructionsWithHiddenFieldsSchema: z.ZodObject<{
+    interpolate: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, boolean | "false" | "true">>, z.ZodRecord<z.ZodString, z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodEnum<{
+        false: "false";
+        true: "true";
+    }>]>, z.ZodTransform<boolean, boolean | "false" | "true">>>]>>;
+    output_meta: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodBoolean]>>, z.ZodUnion<[z.ZodString, z.ZodBoolean]>, z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString>]>]>>;
+    queue: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodEnum<{
+        batch: "batch";
+    }>]>>;
+    force_accept: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>;
+    ignore_errors: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodEnum<{
+        meta: "meta";
+        execute: "execute";
+    }>>]>, z.ZodTransform<string[], boolean | ("meta" | "execute")[]>>]>>;
+    use: z.ZodOptional<z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        fields: z.ZodOptional<z.ZodString>;
+        as: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>]>, z.ZodObject<{
+        steps: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            fields: z.ZodOptional<z.ZodString>;
+            as: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>]>;
+        bundle_steps: z.ZodOptional<z.ZodBoolean>;
+        group_by_original: z.ZodOptional<z.ZodBoolean>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>]>>;
+    robot: z.ZodLiteral<"/transloadit/store">;
+    conflict_strategy: z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodEnum<{
+        error: "error";
+        overwrite: "overwrite";
+        rename: "rename";
+    }>]>>;
+    path: z.ZodDefault<z.ZodString>;
+    result: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodUnion<[z.ZodString, z.ZodLiteral<"debug">]>, z.ZodDefault<z.ZodUnion<[z.ZodString, z.ZodBoolean]>>]>>;
+}, z.core.$strict>;
+export type InterpolatableRobotTransloaditStoreInstructionsWithHiddenFields = InterpolatableRobotTransloaditStoreInstructionsWithHiddenFieldsInput;
+export type InterpolatableRobotTransloaditStoreInstructionsWithHiddenFieldsInput = z.input<typeof interpolatableRobotTransloaditStoreInstructionsWithHiddenFieldsSchema>;
+//# sourceMappingURL=transloadit-store.d.ts.map

package/dist/v4/robots/transloadit-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transloadit-store.d.ts","sourceRoot":"","sources":["../../../src/v4/robots/transloadit-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAEnE,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAI1B,eAAO,MAAM,IAAI,EAAE,cAkClB,CAAA;AAED,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuBzC,CAAA;AAEX,eAAO,MAAM,uDAAuD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKhE,CAAA;AAEJ,MAAM,MAAM,iCAAiC,GAAG,CAAC,CAAC,KAAK,CACrD,OAAO,uCAAuC,CAC/C,CAAA;AACD,MAAM,MAAM,iDAAiD,GAAG,CAAC,CAAC,KAAK,CACrE,OAAO,uDAAuD,CAC/D,CAAA;AAED,eAAO,MAAM,qDAAqD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEjE,CAAA;AACD,MAAM,MAAM,+CAA+C,GACzD,oDAAoD,CAAA;AAEtD,MAAM,MAAM,oDAAoD,GAAG,CAAC,CAAC,KAAK,CACxE,OAAO,qDAAqD,CAC7D,CAAA;AAED,eAAO,MAAM,qEAAqE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBACP,CAAA;AAC3E,MAAM,MAAM,+DAA+D,GACzE,oEAAoE,CAAA;AACtE,MAAM,MAAM,oEAAoE,GAAG,CAAC,CAAC,KAAK,CACxF,OAAO,qEAAqE,CAC7E,CAAA"}

package/dist/v4/robots/transloadit-store.js

@@ -0,0 +1,68 @@
+import { z } from 'zod/v4';
+import { interpolateRobot, robotBase, robotUse } from "./_instructions-primitives.js";
+export const meta = {
+    bytescount: 10,
+    discount_factor: 0.1,
+    discount_pct: 90,
+    example_code: {
+        steps: {
+            stored: {
+                robot: '/transloadit/store',
+                use: ':original',
+            },
+        },
+    },
+    example_code_description: 'Store uploaded files in Transloadit Storage:',
+    has_small_icon: true,
+    isAllowedForUrlTransform: false,
+    isInternal: false,
+    minimum_charge: 0,
+    name: 'TransloaditStoreRobot',
+    output_factor: 1,
+    override_lvl1: 'File Exporting',
+    priceFactor: 10,
+    purpose_sentence: 'stores files privately in Transloadit Storage',
+    purpose_verb: 'export',
+    purpose_word: 'Transloadit Storage',
+    purpose_words: 'Store files in Transloadit Storage',
+    queueSlotCount: 2,
+    removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
+    service_slug: 'file-exporting',
+    slot_count: 2,
+    stage: 'beta',
+    title: 'Store files in Transloadit Storage',
+    trackOutputFileSize: true,
+    typical_file_size_mb: 1.2,
+    typical_file_type: 'file',
+};
+export const robotTransloaditStoreInstructionsSchema = robotBase
+    .merge(robotUse)
+    .extend({
+    robot: z.literal('/transloadit/store').describe(`
+Stores each input privately in Transloadit Storage.
+`),
+    conflict_strategy: z
+        .enum(['error', 'overwrite', 'rename'])
+        .default('error')
+        .describe(`
+Chooses how to handle an existing destination. By default, an occupied path fails. Select
+\`rename\` to allocate a different filename, or \`overwrite\` to create a new version of the
+existing asset. Always save the returned asset identity, version and final path.
+`),
+    path: z
+        .string()
+        .default('${file.url_name}')
+        .describe(`
+Sets the destination path inside your Transloadit Storage workspace, relative to its root: a
+filename, or folders and a filename such as \`website/hero.jpg\`. Folders that do not exist yet
+are created.
+`),
+})
+    .strict();
+export const robotTransloaditStoreInstructionsWithHiddenFieldsSchema = robotTransloaditStoreInstructionsSchema.extend({
+    result: z
+        .union([z.literal('debug'), robotTransloaditStoreInstructionsSchema.shape.result])
+        .optional(),
+});
+export const interpolatableRobotTransloaditStoreInstructionsSchema = interpolateRobot(robotTransloaditStoreInstructionsSchema);
+export const interpolatableRobotTransloaditStoreInstructionsWithHiddenFieldsSchema = interpolateRobot(robotTransloaditStoreInstructionsWithHiddenFieldsSchema);

package/dist/v4/storageAsset.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod/v4';
+/** Maximum normalized Storage path length supported by the catalog schema. */
+export declare const damPathMaxCodePoints = 512;
+/** Canonical path and JSON representation of a 128-bit Storage identifier. */
+export declare const damIdPattern: RegExp;
+/** Canonical public Storage asset, version and folder identifier. */
+export declare const damIdSchema: z.ZodString;
+/** A retained version of a live Workspace asset, independent of its mutable location. */
+export declare const storedAssetSchema: z.ZodObject<{
+    workspace: z.ZodString;
+    asset_id: z.ZodString;
+    version_id: z.ZodString;
+    path: z.ZodString;
+    size: z.ZodNumber;
+    mime: z.ZodNullable<z.ZodString>;
+    md5hash: z.ZodOptional<z.ZodString>;
+    sha256: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/** Store, read and recovery share this shape; image clients may enrich it with placeholders. */
+export type StoredAsset = z.infer<typeof storedAssetSchema>;
+/** Bounded metadata paging; cursors are the last returned, case-sensitive asset path. */
+export declare const damAssetsListOptionsSchema: z.ZodObject<{
+    prefix: z.ZodDefault<z.ZodString>;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/** An omitted version selects the current version; an explicit version never falls back. */
+export declare const damAssetGetOptionsSchema: z.ZodObject<{
+    version_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Omit the destination to rename in place; null moves to the Workspace root. */
+export declare const damAssetMoveOptionsSchema: z.ZodObject<{
+    destination_folder_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    filename: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MoveStoredAssetOptions = z.input<typeof damAssetMoveOptionsSchema>;
+/** Native metadata is the same version-pinned shape returned by storing a file. */
+export declare const damAssetFoundResponseSchema: z.ZodObject<{
+    message: z.ZodString;
+    ok: z.ZodLiteral<"DAM_ASSET_FOUND">;
+    asset: z.ZodObject<{
+        workspace: z.ZodString;
+        asset_id: z.ZodString;
+        version_id: z.ZodString;
+        path: z.ZodString;
+        size: z.ZodNumber;
+        mime: z.ZodNullable<z.ZodString>;
+        md5hash: z.ZodOptional<z.ZodString>;
+        sha256: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strict>;
+/** A bounded catalog page; null means there is no next page, even in an empty Workspace. */
+export declare const damAssetsListedResponseSchema: z.ZodObject<{
+    workspace: z.ZodString;
+    message: z.ZodString;
+    ok: z.ZodLiteral<"DAM_ASSETS_LISTED">;
+    assets: z.ZodArray<z.ZodObject<{
+        workspace: z.ZodString;
+        asset_id: z.ZodString;
+        version_id: z.ZodString;
+        path: z.ZodString;
+        size: z.ZodNumber;
+        mime: z.ZodNullable<z.ZodString>;
+        md5hash: z.ZodOptional<z.ZodString>;
+        sha256: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    next_cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type StoredAssetsPage = z.infer<typeof damAssetsListedResponseSchema>;
+export type ListStoredAssetsOptions = z.input<typeof damAssetsListOptionsSchema>;
+export type GetStoredAssetOptions = z.input<typeof damAssetGetOptionsSchema>;
+//# sourceMappingURL=storageAsset.d.ts.map

package/dist/v4/storageAsset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageAsset.d.ts","sourceRoot":"","sources":["../../src/v4/storageAsset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAKvC,8EAA8E;AAC9E,eAAO,MAAM,YAAY,QAA+B,CAAA;AAExD,qEAAqE;AACrE,eAAO,MAAM,WAAW,aAG2D,CAAA;AAEnF,yFAAyF;AACzF,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAiB5B,CAAA;AAEF,gGAAgG;AAChG,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,yFAAyF;AACzF,eAAO,MAAM,0BAA0B;;;;iBAIrC,CAAA;AAEF,4FAA4F;AAC5F,eAAO,MAAM,wBAAwB;;iBAAmD,CAAA;AAExF,iFAAiF;AACjF,eAAO,MAAM,yBAAyB;;;iBAUpC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE9E,mFAAmF;AACnF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;kBAM7B,CAAA;AAEX,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;kBAQ/B,CAAA;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAC5E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAChF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/dist/v4/storageAsset.js

@@ -0,0 +1,66 @@
+import { z } from 'zod/v4';
+/** Maximum normalized Storage path length supported by the catalog schema. */
+export const damPathMaxCodePoints = 512;
+// A Unicode regexp counts code points and stays portable across the published Zod 3/4 schemas.
+const boundedPathSchema = z.string().regex(new RegExp(`^[\\s\\S]{0,${damPathMaxCodePoints}}$`, 'u'));
+/** Canonical path and JSON representation of a 128-bit Storage identifier. */
+export const damIdPattern = /^[A-Za-z0-9_-]{21}[AQgw]$/u;
+/** Canonical public Storage asset, version and folder identifier. */
+export const damIdSchema = z
+    .string()
+    .regex(damIdPattern)
+    .describe('Case-sensitive, canonical 22-character Base64URL Storage identifier.');
+/** A retained version of a live Workspace asset, independent of its mutable location. */
+export const storedAssetSchema = z.object({
+    workspace: z.string().min(1),
+    asset_id: damIdSchema,
+    version_id: damIdSchema,
+    path: z.string().min(1),
+    size: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER),
+    mime: z.string().nullable(),
+    md5hash: z
+        .string()
+        .regex(/^[a-f0-9]{32}$/u)
+        .optional(),
+    sha256: z
+        .string()
+        .regex(/^[a-f0-9]{64}$/u)
+        .optional(),
+    width: z.number().int().positive().max(Number.MAX_SAFE_INTEGER).optional(),
+    height: z.number().int().positive().max(Number.MAX_SAFE_INTEGER).optional(),
+});
+/** Bounded metadata paging; cursors are the last returned, case-sensitive asset path. */
+export const damAssetsListOptionsSchema = z.object({
+    prefix: boundedPathSchema.default(''),
+    cursor: boundedPathSchema.min(1).optional(),
+    limit: z.number().int().min(1).max(500).default(100),
+});
+/** An omitted version selects the current version; an explicit version never falls back. */
+export const damAssetGetOptionsSchema = z.object({ version_id: damIdSchema.optional() });
+/** Omit the destination to rename in place; null moves to the Workspace root. */
+export const damAssetMoveOptionsSchema = z.object({
+    destination_folder_id: damIdSchema.nullable().optional(),
+    filename: z
+        .string()
+        .regex(/^[^/\\\p{Cc}]{1,255}$/u)
+        .refine((name) => name.trim() === name && name !== '.' && name !== '..', 'Use a filename, not a path')
+        .optional(),
+});
+/** Native metadata is the same version-pinned shape returned by storing a file. */
+export const damAssetFoundResponseSchema = z
+    .object({
+    message: z.string().min(1),
+    ok: z.literal('DAM_ASSET_FOUND'),
+    asset: storedAssetSchema,
+})
+    .strict();
+/** A bounded catalog page; null means there is no next page, even in an empty Workspace. */
+export const damAssetsListedResponseSchema = z
+    .object({
+    workspace: storedAssetSchema.shape.workspace,
+    message: z.string().min(1),
+    ok: z.literal('DAM_ASSETS_LISTED'),
+    assets: z.array(storedAssetSchema),
+    next_cursor: z.string().nullable(),
+})
+    .strict();

package/dist/v4/template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/v4/template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/v4/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAM1B,OAAO,KAAK,EACV,YAAY,EACZ,6BAA6B,EAC9B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAGpE,MAAM,MAAM,IAAI,GAAG,YAAY,CAAA;AAC/B,MAAM,MAAM,SAAS,GAAG,IAAI,CAAA;AAC5B,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAA;AACnD,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AACxC,MAAM,MAAM,UAAU,GAAG,KAAK,CAAA;AAE9B,eAAO,MAAM,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAQQ,CAAA;AAC/C,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CACK,CAAA;AAC9C,eAAO,MAAM,mBAAmB,oFAAyB,CAAA;AAEzD,MAAM,MAAM,oBAAoB,GAAG,6BAA6B,CAAA;AAChE,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,CAAA;AAC5D,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;AACxE,MAAM,MAAM,0BAA0B,GAAG,qBAAqB,CAAA;AAE9D,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAQxB,CAAA;AAC/C,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAC3B,CAAA;AAC9C,QAAA,MAAM,mCAAmC,oHAAyC,CAAA;AAElF,eAAO,MAAM,YAAY,mDAItB,CAAA;AAEH,eAAO,MAAM,eAAe,2CAMzB,CAAA;AAEH,MAAM,MAAM,yBAAyB,GACjC,0BAA0B,GAC1B,iBAAiB,GACjB,0BAA0B,GAC1B,iBAAiB,CAAA;AAErB,eAAO,MAAM,+BAA+B,yGAKa,CAAA;AAEzD,eAAO,MAAM,yBAAyB;;;;;IAKnC,CAAA;AAEH,eAAO,MAAM,gBAAgB,4BAK1B,CAAA;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;iBAsDzC,CAAA;AAuBF,eAAO,MAAM,0BAA0B;;;;;;;;;;;WAJP,OAAO,mBAAmB;;;;;;;;;;;iBAOxD,CAAA;AAEF,eAAO,MAAM,0CAA0C;;;;;;;;;;;WATvB,OAAO,mBAAmB;;;;;;;;;;;iBAYxD,CAAA;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAC7E,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAClF,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAA;AAC1F,MAAM,MAAM,oCAAoC,GAAG,OAAO,CACxD,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAC/C,CAAA;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;kBA4BtB,CAAA;AAEX,eAAO,MAAM,uBAAuB;;;;;;;;;;kBAIzB,CAAA;AAEX,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmD1B,CAAA;AAQX,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;WACD,OAAO,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;iBAoCxF,CAAA;AAEF,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oCAAoC,CAAC,CAAA;AACjG,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,oCAAoC,CAC5C,CAAA"}

package/dist/v4/template.js

@@ -1,5 +1,6 @@
 import { z } from 'zod/v4';
 import { robotsSchema, robotsWithHiddenBotsAndFieldsSchema, } from "./robots/_index.js";
+import { refineTransloaditImportSelector } from "./robots/transloadit-import.js";
 export const stepSchema = z
     .object({
     // This is a hack to get nicer robot hover messages in editors.
@@ -7,7 +8,8 @@ export const stepSchema = z
         .string()
         .describe('Identifier of the [robot](https://transloadit.com/docs/robots/) to execute'),
 })
-    .and(robotsSchema);
+    .and(robotsSchema)
+    .superRefine(refineTransloaditImportSelector);
 export const stepsSchema = z.record(z.string(), stepSchema)
     .describe('Contains Assembly Instructions.');
 export const optionalStepsSchema = stepsSchema.optional();
@@ -18,7 +20,8 @@ export const stepSchemaWithHiddenFields = z
         .string()
         .describe('Identifier of the [robot](https://transloadit.com/docs/robots/) to execute'),
 })
-    .and(robotsWithHiddenBotsAndFieldsSchema);
+    .and(robotsWithHiddenBotsAndFieldsSchema)
+    .superRefine(refineTransloaditImportSelector);
 export const stepsSchemaWithHiddenFields = z.record(z.string(), stepSchemaWithHiddenFields)
     .describe('Contains Assembly Instructions.');
 const optionalStepsWithHiddenFieldsSchema = stepsSchemaWithHiddenFields.optional();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@transloadit/zod",
-  "version": "4.4.0",
+  "version": "4.4.1",
   "description": "Transloadit Zod schemas",
   "type": "module",
   "license": "MIT",
@@ -51,7 +51,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@transloadit/types": "^4.4.0",
+    "@transloadit/types": "^4.4.1",
     "@types/node": "^25.8.0"
   }
 }