transloadit 4.14.0 → 5.0.1

package/dist/alphalib/types/robots/youtube-store.js

@@ -1,45 +1,49 @@
 import { z } from 'zod';
-import { interpolateRobot, robotBase, robotUse } from "./_instructions-primitives.js";
+import { zodCodePointLength, zodWithJsonInputSchema } from "../../lib/zodInputSemantics.js";
+import { createProcessingExample, defineRobot, robotBase, robotStoreMeta, robotUse, } from "./_instructions-primitives.js";
+const youtubeCategories = [
+    'autos & vehicles',
+    'comedy',
+    'education',
+    'entertainment',
+    'film & animation',
+    'gaming',
+    'howto & style',
+    'music',
+    'news & politics',
+    'people & blogs',
+    'pets & animals',
+    'science & technology',
+    'sports',
+    'travel & events',
+];
+function asciiCaseInsensitiveLiteral(value) {
+    return [...value]
+        .map((character) => character >= 'a' && character <= 'z' ? `[${character}${character.toUpperCase()}]` : character)
+        .join('');
+}
+const youtubeCategoryValueSchema = z.enum(youtubeCategories);
+const youtubeCategoryInputSchema = z
+    .string()
+    .regex(new RegExp(`^(?:${youtubeCategories.map(asciiCaseInsensitiveLiteral).join('|')})$`, 'u'));
+const youtubeCategorySchema = zodWithJsonInputSchema(z.preprocess((value) => (typeof value === 'string' ? value.toLowerCase() : value), youtubeCategoryValueSchema), youtubeCategoryInputSchema);
 export const meta = {
-    bytescount: 6,
-    discount_factor: 0.15000150001500018,
-    discount_pct: 84.99984999849998,
+    ...robotStoreMeta,
     hideCredentialsWarning: true,
-    example_code: {
-        steps: {
-            exported: {
-                robot: '/youtube/store',
-                use: ':original',
-                credentials: 'YOUR_YOUTUBE_CREDENTIALS',
-                title: 'Transloadit: Video Example',
-                description: 'Some nice description',
-                category: 'science & technology',
-                keywords: 'transloadit, robots, botty',
-                visibility: 'private',
-            },
-        },
-    },
+    example_code: createProcessingExample('exported', '/youtube/store', {
+        credentials: 'YOUR_YOUTUBE_CREDENTIALS',
+        title: 'Transloadit: Video Example',
+        description: 'Some nice description',
+        category: 'science & technology',
+        keywords: 'transloadit, robots, botty',
+        visibility: 'private',
+    }),
     example_code_description: 'Export an uploaded video to YouTube and set some basic parameters:',
-    minimum_charge: 0,
-    output_factor: 1,
-    override_lvl1: 'File Exporting',
     purpose_sentence: 'exports encoding results to YouTube',
-    purpose_verb: 'export',
     purpose_word: 'YouTube',
     purpose_words: 'Export files to YouTube',
-    service_slug: 'file-exporting',
-    slot_count: 10,
     title: 'Export files to YouTube',
-    typical_file_size_mb: 1.2,
-    typical_file_type: 'file',
     name: 'YoutubeStoreRobot',
-    priceFactor: 6.6666,
-    queueSlotCount: 10,
-    isAllowedForUrlTransform: true,
-    trackOutputFileSize: false,
-    isInternal: false,
-    removeJobResultFilesFromDiskRightAfterStoringOnS3: false,
-    stage: 'ga',
 };
 export const robotYoutubeStoreInstructionsSchema = robotBase
     .merge(robotUse)
@@ -67,15 +71,12 @@ You can add a custom thumbnail to your video on YouTube by using our \`"as"\` sy
 },
 \`\`\`
 
-If you encounter an error such as "The authenticated user doesnʼt have permissions to upload and set custom video thumbnails", you should go to your YouTube account and try adding a custom thumbnail to one of your existing videos. Youʼll be prompted to add your phone number. Once youʼve added it, the error should go away.
+If you encounter an error such as "The authenticated user doesn’t have permissions to upload and set custom video thumbnails", you should go to your YouTube account and try adding a custom thumbnail to one of your existing videos. You’ll be prompted to add your phone number. Once you’ve added it, the error should go away.
 `),
     credentials: z.string().describe(`
 The authentication Template credentials used for your YouTube account. You can generate them on the [Template Credentials page](/c/template-credentials/). Simply add the name of your YouTube channel, and you will be redirected to a Google verification page. Accept the presented permissions and you will be good to go.
 `),
-    title: z
-        .string()
-        .max(80)
-        .describe(`
+    title: zodCodePointLength(z.string(), { max: 80 }).describe(`
 The title of the video to be displayed on YouTube.
 
 Note that since the YouTube API requires titles to be within 80 characters, longer titles may be truncated.
@@ -83,24 +84,7 @@ Note that since the YouTube API requires titles to be within 80 characters, long
     description: z.string().describe(`
 The description of the video to be displayed on YouTube. This can be up to 5000 characters, including \`\\n\` for new-lines.
 `),
-    category: z
-        .preprocess((val) => (typeof val === 'string' ? val.toLowerCase() : val), z.enum([
-        'autos & vehicles',
-        'comedy',
-        'education',
-        'entertainment',
-        'film & animation',
-        'gaming',
-        'howto & style',
-        'music',
-        'news & politics',
-        'people & blogs',
-        'pets & animals',
-        'science & technology',
-        'sports',
-        'travel & events',
-    ]))
-        .describe(`
+    category: youtubeCategorySchema.describe(`
 The category to which this video will be assigned.
 `),
     keywords: z.string().describe(`
@@ -111,11 +95,6 @@ Defines the visibility of the uploaded video.
 `),
 })
     .strict();
-export const robotYoutubeStoreInstructionsWithHiddenFieldsSchema = robotYoutubeStoreInstructionsSchema.extend({
-    result: z
-        .union([z.literal('debug'), robotYoutubeStoreInstructionsSchema.shape.result])
-        .optional(),
-});
-export const interpolatableRobotYoutubeStoreInstructionsSchema = interpolateRobot(robotYoutubeStoreInstructionsSchema);
-export const interpolatableRobotYoutubeStoreInstructionsWithHiddenFieldsSchema = interpolateRobot(robotYoutubeStoreInstructionsWithHiddenFieldsSchema);
+export const robotDefinition = defineRobot(meta, robotYoutubeStoreInstructionsSchema);
+export const { withHiddenFields: robotYoutubeStoreInstructionsWithHiddenFieldsSchema, interpolatable: interpolatableRobotYoutubeStoreInstructionsSchema, interpolatableWithHiddenFields: interpolatableRobotYoutubeStoreInstructionsWithHiddenFieldsSchema, } = robotDefinition;
 //# sourceMappingURL=youtube-store.js.map

package/dist/alphalib/types/robots/youtube-store.js.map

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

package/dist/alphalib/types/stackVersions.d.ts

@@ -1,6 +1,45 @@
+/** Runtime stack selection, ordered oldest to newest; stack IDs are not tool version numbers. */
+export declare const runtimeStackVersions: {
+    readonly exiftool: {
+        readonly default: "v13.36";
+        readonly valid: readonly ["v13.36"];
+    };
+    readonly mplayer: {
+        readonly default: "v1.5.0";
+        readonly valid: readonly ["v1.5.0"];
+    };
+    readonly mediainfo: {
+        readonly default: "v23.10";
+        readonly valid: readonly ["v23.10"];
+    };
+    readonly imagemagick: {
+        readonly default: "v2.0.10";
+        readonly deprecated: {
+            readonly 'v2.0.9': "v2.0.10";
+            readonly 'v3.0.0': "v3.0.1";
+        };
+        readonly valid: readonly ["v2.0.10", "v3.0.1"];
+    };
+    readonly ffmpeg: {
+        readonly default: "v6.0.0";
+        readonly deprecated: {
+            readonly 'v5.0.0': "v6.0.0";
+        };
+        readonly autoUpgradeAfter: {
+            readonly 'v5.0.0': "2026-04-30T00:00:00.000Z";
+        };
+        readonly valid: readonly ["v6.0.0", "v7.0.0", "v8.0.0"];
+        readonly highest: "v8.0.0";
+    };
+    readonly file: {
+        readonly default: "v5.46";
+        readonly valid: readonly ["v5.46"];
+    };
+};
+/** Public authoring recommendations, deliberately distinct from applied runtime defaults. */
 export declare const stackVersions: {
     ffmpeg: {
-        recommendedVersion: "v6";
+        recommendedVersion: "v7";
         test: RegExp;
         suggestedValues: readonly ["v6", "v7", "v8"];
     };

package/dist/alphalib/types/stackVersions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stackVersions.d.ts","sourceRoot":"","sources":["../../../src/alphalib/types/stackVersions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;;;;;;;;;;;CAWzB,CAAA"}
+{"version":3,"file":"stackVersions.d.ts","sourceRoot":"","sources":["../../../src/alphalib/types/stackVersions.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmBvB,CAAA;AAEV,6FAA6F;AAC7F,eAAO,MAAM,aAAa;;;;;;;;;;;CAWzB,CAAA"}

package/dist/alphalib/types/stackVersions.js

@@ -1,12 +1,34 @@
+/** Runtime stack selection, ordered oldest to newest; stack IDs are not tool version numbers. */
+export const runtimeStackVersions = {
+    exiftool: { default: 'v13.36', valid: ['v13.36'] },
+    mplayer: { default: 'v1.5.0', valid: ['v1.5.0'] },
+    mediainfo: { default: 'v23.10', valid: ['v23.10'] },
+    imagemagick: {
+        default: 'v2.0.10',
+        // Normalizers upgrade these versions; AssemblyValidator supplies deprecation warnings.
+        deprecated: { 'v2.0.9': 'v2.0.10', 'v3.0.0': 'v3.0.1' },
+        valid: ['v2.0.10', 'v3.0.1'],
+    },
+    ffmpeg: {
+        default: 'v6.0.0',
+        // v5 remains accepted input but its binary has been retired after this cutoff.
+        deprecated: { 'v5.0.0': 'v6.0.0' },
+        autoUpgradeAfter: { 'v5.0.0': '2026-04-30T00:00:00.000Z' },
+        valid: ['v6.0.0', 'v7.0.0', 'v8.0.0'],
+        highest: 'v8.0.0',
+    },
+    file: { default: 'v5.46', valid: ['v5.46'] },
+};
+/** Public authoring recommendations, deliberately distinct from applied runtime defaults. */
 export const stackVersions = {
     ffmpeg: {
-        recommendedVersion: 'v6',
-        test: /^v?[5-8](\.\d+)?(\.\d+)?$/,
+        recommendedVersion: 'v7',
+        test: /^v?[5-8](\.[0-9]+)?(\.[0-9]+)?$/u,
         suggestedValues: ['v6', 'v7', 'v8'],
     },
     imagemagick: {
         recommendedVersion: 'v3',
-        test: /^v?[23](\.\d+)?(\.\d+)?$/,
+        test: /^v?[23](\.[0-9]+)?(\.[0-9]+)?$/u,
         suggestedValues: ['v2', 'v3'],
     },
 };

package/dist/alphalib/types/stackVersions.js.map

@@ -1 +1 @@
-{"version":3,"file":"stackVersions.js","sourceRoot":"","sources":["../../../src/alphalib/types/stackVersions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE;QACN,kBAAkB,EAAE,IAAa;QACjC,IAAI,EAAE,2BAA2B;QACjC,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU;KAC7C;IACD,WAAW,EAAE;QACX,kBAAkB,EAAE,IAAa;QACjC,IAAI,EAAE,0BAA0B;QAChC,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,CAAU;KACvC;CACF,CAAA"}
+{"version":3,"file":"stackVersions.js","sourceRoot":"","sources":["../../../src/alphalib/types/stackVersions.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE;IAClD,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE;IACjD,SAAS,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE;IACnD,WAAW,EAAE;QACX,OAAO,EAAE,SAAS;QAClB,uFAAuF;QACvF,UAAU,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;QACvD,KAAK,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;KAC7B;IACD,MAAM,EAAE;QACN,OAAO,EAAE,QAAQ;QACjB,+EAA+E;QAC/E,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAClC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,0BAA0B,EAAE;QAC1D,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;QACrC,OAAO,EAAE,QAAQ;KAClB;IACD,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE;CACpC,CAAA;AAEV,6FAA6F;AAC7F,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE;QACN,kBAAkB,EAAE,IAAa;QACjC,IAAI,EAAE,kCAAkC;QACxC,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU;KAC7C;IACD,WAAW,EAAE;QACX,kBAAkB,EAAE,IAAa;QACjC,IAAI,EAAE,iCAAiC;QACvC,eAAe,EAAE,CAAC,IAAI,EAAE,IAAI,CAAU;KACvC;CACF,CAAA"}

package/dist/alphalib/types/storageAsset.d.ts

@@ -26,10 +26,10 @@ export declare const storedAssetSchema: z.ZodObject<{
     asset_id: string;
     version_id: string;
     mime: string | null;
+    md5hash?: string | undefined;
+    sha256?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    sha256?: string | undefined;
-    md5hash?: string | undefined;
     thumbhash?: string | undefined;
     has_alpha?: boolean | undefined;
 }, {
@@ -39,15 +39,21 @@ export declare const storedAssetSchema: z.ZodObject<{
     asset_id: string;
     version_id: string;
     mime: string | null;
+    md5hash?: string | undefined;
+    sha256?: string | undefined;
     width?: number | undefined;
     height?: number | undefined;
-    sha256?: string | undefined;
-    md5hash?: string | undefined;
     thumbhash?: string | undefined;
     has_alpha?: boolean | undefined;
 }>;
 /** Store, read and recovery share this version-pinned shape, including optional placeholders. */
 export type StoredAsset = z.infer<typeof storedAssetSchema>;
+/** Shared explanations for portable client options and normalized API request fields. */
+export declare const damAssetsListDescriptions: {
+    readonly prefix: "Only list current asset paths starting with this case-sensitive prefix. The empty default includes the whole Workspace; include a trailing slash to select a directory boundary.";
+    readonly cursor: "Opaque continuation value from next_cursor in the previous response. Keep the same prefix while paging. Omit for the first page.";
+    readonly limit: "Maximum number of assets per page. Defaults to 100 and accepts up to 500; follow next_cursor until null.";
+};
 /** Bounded metadata paging; cursors are the last returned, case-sensitive asset path. */
 export declare const damAssetsListOptionsSchema: z.ZodObject<{
     prefix: z.ZodDefault<z.ZodString>;
@@ -75,11 +81,11 @@ export declare const damAssetMoveOptionsSchema: z.ZodObject<{
     destination_folder_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     filename: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
 }, "strip", z.ZodTypeAny, {
-    filename?: string | undefined;
     destination_folder_id?: string | null | undefined;
-}, {
     filename?: string | undefined;
+}, {
     destination_folder_id?: string | null | undefined;
+    filename?: string | undefined;
 }>;
 export type MoveStoredAssetOptions = z.input<typeof damAssetMoveOptionsSchema>;
 /** Native metadata is the same version-pinned shape returned by storing a file. */
@@ -106,10 +112,10 @@ export declare const damAssetFoundResponseSchema: z.ZodObject<{
         asset_id: string;
         version_id: string;
         mime: string | null;
+        md5hash?: string | undefined;
+        sha256?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
-        sha256?: string | undefined;
-        md5hash?: string | undefined;
         thumbhash?: string | undefined;
         has_alpha?: boolean | undefined;
     }, {
@@ -119,10 +125,10 @@ export declare const damAssetFoundResponseSchema: z.ZodObject<{
         asset_id: string;
         version_id: string;
         mime: string | null;
+        md5hash?: string | undefined;
+        sha256?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
-        sha256?: string | undefined;
-        md5hash?: string | undefined;
         thumbhash?: string | undefined;
         has_alpha?: boolean | undefined;
     }>;
@@ -136,10 +142,10 @@ export declare const damAssetFoundResponseSchema: z.ZodObject<{
         asset_id: string;
         version_id: string;
         mime: string | null;
+        md5hash?: string | undefined;
+        sha256?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
-        sha256?: string | undefined;
-        md5hash?: string | undefined;
         thumbhash?: string | undefined;
         has_alpha?: boolean | undefined;
     };
@@ -153,10 +159,10 @@ export declare const damAssetFoundResponseSchema: z.ZodObject<{
         asset_id: string;
         version_id: string;
         mime: string | null;
+        md5hash?: string | undefined;
+        sha256?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
-        sha256?: string | undefined;
-        md5hash?: string | undefined;
         thumbhash?: string | undefined;
         has_alpha?: boolean | undefined;
     };
@@ -186,10 +192,10 @@ export declare const damAssetsListedResponseSchema: z.ZodObject<{
         asset_id: string;
         version_id: string;
         mime: string | null;
+        md5hash?: string | undefined;
+        sha256?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
-        sha256?: string | undefined;
-        md5hash?: string | undefined;
         thumbhash?: string | undefined;
         has_alpha?: boolean | undefined;
     }, {
@@ -199,10 +205,10 @@ export declare const damAssetsListedResponseSchema: z.ZodObject<{
         asset_id: string;
         version_id: string;
         mime: string | null;
+        md5hash?: string | undefined;
+        sha256?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
-        sha256?: string | undefined;
-        md5hash?: string | undefined;
         thumbhash?: string | undefined;
         has_alpha?: boolean | undefined;
     }>, "many">;
@@ -218,10 +224,10 @@ export declare const damAssetsListedResponseSchema: z.ZodObject<{
         asset_id: string;
         version_id: string;
         mime: string | null;
+        md5hash?: string | undefined;
+        sha256?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
-        sha256?: string | undefined;
-        md5hash?: string | undefined;
         thumbhash?: string | undefined;
         has_alpha?: boolean | undefined;
     }[];
@@ -237,10 +243,10 @@ export declare const damAssetsListedResponseSchema: z.ZodObject<{
         asset_id: string;
         version_id: string;
         mime: string | null;
+        md5hash?: string | undefined;
+        sha256?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
-        sha256?: string | undefined;
-        md5hash?: string | undefined;
         thumbhash?: string | undefined;
         has_alpha?: boolean | undefined;
     }[];

package/dist/alphalib/types/storageAsset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storageAsset.d.ts","sourceRoot":"","sources":["../../../src/alphalib/types/storageAsset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyB5B,CAAA;AAEF,iGAAiG;AACjG,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,yFAAyF;AACzF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAA;AAEF,4FAA4F;AAC5F,eAAO,MAAM,wBAAwB;;;;;;EAAmD,CAAA;AAExF,iFAAiF;AACjF,eAAO,MAAM,yBAAyB;;;;;;;;;EAUpC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE9E,mFAAmF;AACnF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM7B,CAAA;AAEX,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ/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"}
+{"version":3,"file":"storageAsset.d.ts","sourceRoot":"","sources":["../../../src/alphalib/types/storageAsset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAKvC,8EAA8E;AAC9E,eAAO,MAAM,YAAY,QAA+B,CAAA;AAExD,qEAAqE;AACrE,eAAO,MAAM,WAAW,aAIvB,CAAA;AAED,yFAAyF;AACzF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgD7B,CAAA;AAED,iGAAiG;AACjG,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,yFAAyF;AACzF,eAAO,MAAM,yBAAyB;;;;CAO5B,CAAA;AAEV,yFAAyF;AACzF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAUtC,CAAA;AAED,4FAA4F;AAC5F,eAAO,MAAM,wBAAwB;;;;;;EAMnC,CAAA;AAEF,iFAAiF;AACjF,eAAO,MAAM,yBAAyB;;;;;;;;;EAUpC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE9E,mFAAmF;AACnF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM7B,CAAA;AAEX,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ/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/alphalib/types/storageAsset.js

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { describeApiParameter, describeApiParameterFields } from "./apiParameterDescription.js";
 /** 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.
@@ -6,12 +7,9 @@ const boundedPathSchema = z.string().regex(new RegExp(`^[\\s\\S]{0,${damPathMaxC
 /** 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.');
+export const damIdSchema = describeApiParameter('damId', z.string().regex(damIdPattern), 'Case-sensitive, canonical 22-character Base64URL DAM identifier.');
 /** A retained version of a live Workspace asset, independent of its mutable location. */
-export const storedAssetSchema = z.object({
+export const storedAssetSchema = z.object(describeApiParameterFields('storedAsset', {
     workspace: z.string().min(1),
     asset_id: damIdSchema,
     version_id: damIdSchema,
@@ -31,18 +29,38 @@ export const storedAssetSchema = z.object({
     thumbhash: z
         .string()
         .regex(/^(?:[A-Za-z0-9+/]{4}){1,15}(?:[A-Za-z0-9+/]{4}|[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)$/u)
-        .optional()
-        .describe('Base64-encoded ThumbHash of this version’s displayed pixels, when requested with output_meta.thumbhash on its producing Step. This is image data: apply the same access controls as the original.'),
-    has_alpha: z.boolean().optional().describe('Whether the image has an alpha channel, even if all its pixels are opaque. Present when ThumbHash extraction succeeds; absence means unknown.'),
-});
+        .optional(),
+    has_alpha: z.boolean().optional(),
+}, {
+    workspace: 'Workspace slug that owns this asset. Authenticate for the same Workspace when reading or managing it.',
+    asset_id: 'Stable asset ID. It survives native moves and renames; use it without a version to select the current bytes.',
+    version_id: 'Exact immutable version of this asset. Pair with asset_id to select retained bytes; a missing version never falls back to the current version.',
+    path: 'Current mutable location relative to the Workspace. A rename makes the previous path stale; overwriting can change the bytes at this path.',
+    size: 'Size of the stored file in bytes.',
+    mime: 'MIME type of the stored bytes, or null when unknown.',
+    md5hash: 'Lowercase MD5 checksum of the stored bytes, when available.',
+    sha256: 'Lowercase SHA-256 checksum of the stored bytes, when available.',
+    width: 'Display width in pixels, after applying EXIF orientation, when known.',
+    height: 'Display height in pixels, after applying EXIF orientation, when known.',
+    thumbhash: 'Base64-encoded ThumbHash of this version’s displayed pixels, when requested with output_meta.thumbhash on its producing Step. This is image data: apply the same access controls as the original.',
+    has_alpha: 'Whether the image has an alpha channel, even if all its pixels are opaque. Present when ThumbHash extraction succeeds; absence means unknown.',
+}));
+/** Shared explanations for portable client options and normalized API request fields. */
+export const damAssetsListDescriptions = {
+    prefix: 'Only list current asset paths starting with this case-sensitive prefix. The empty default includes the whole Workspace; include a trailing slash to select a directory boundary.',
+    cursor: 'Opaque continuation value from next_cursor in the previous response. Keep the same prefix while paging. Omit for the first page.',
+    limit: 'Maximum number of assets per page. Defaults to 100 and accepts up to 500; follow next_cursor until null.',
+};
 /** Bounded metadata paging; cursors are the last returned, case-sensitive asset path. */
-export const damAssetsListOptionsSchema = z.object({
+export const damAssetsListOptionsSchema = z.object(describeApiParameterFields('storedAssetsList', {
     prefix: boundedPathSchema.default(''),
     cursor: boundedPathSchema.min(1).optional(),
     limit: z.number().int().min(1).max(500).default(100),
-});
+}, damAssetsListDescriptions));
 /** An omitted version selects the current version; an explicit version never falls back. */
-export const damAssetGetOptionsSchema = z.object({ version_id: damIdSchema.optional() });
+export const damAssetGetOptionsSchema = z.object({
+    version_id: describeApiParameter('storedAssetGetVersionId', damIdSchema.optional(), 'Optional retained version of the selected asset. Omit for the current version. A missing or deleted version returns an error and never falls back to current bytes.'),
+});
 /** Omit the destination to rename in place; null moves to the Workspace root. */
 export const damAssetMoveOptionsSchema = z.object({
     destination_folder_id: damIdSchema.nullable().optional(),

package/dist/alphalib/types/storageAsset.js.map

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

package/dist/alphalib/types/storageResults.d.ts

@@ -0,0 +1,29 @@
+import type { StoredAsset } from './storageAsset.ts';
+import { z } from 'zod';
+/** Server-owned Assembly identity and expected Workspace, never untrusted notification fields. */
+export declare const storedAssemblyResultsOptionsSchema: z.ZodObject<{
+    assemblyId: z.ZodString;
+    workspace: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workspace: string;
+    assemblyId: string;
+}, {
+    workspace: string;
+    assemblyId: string;
+}>;
+export type GetStoredAssemblyResultsOptions = z.infer<typeof storedAssemblyResultsOptionsSchema>;
+/** Canonical retained receipt and producing result provenance, for idempotent registration. */
+export interface StoredAssemblyResult {
+    assembly_id: string;
+    step: string;
+    result_id: string;
+    original_id?: string | (string | null)[];
+    asset: StoredAsset;
+}
+/**
+ * Pure extraction from a fetched/verified Assembly bound to an authorized app upload. Validates
+ * every retained result atomically; temporary outputs are ignored, partial receipts are rejected.
+ * This does not authenticate notifications or check application permissions.
+ */
+export declare function extractStoredAssemblyResults(input: unknown, options: GetStoredAssemblyResultsOptions): StoredAssemblyResult[];
+//# sourceMappingURL=storageResults.d.ts.map

package/dist/alphalib/types/storageResults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageResults.d.ts","sourceRoot":"","sources":["../../../src/alphalib/types/storageResults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB,kGAAkG;AAClG,eAAO,MAAM,kCAAkC;;;;;;;;;EAG7C,CAAA;AAEF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAA;AAEhG,+FAA+F;AAC/F,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;IACxC,KAAK,EAAE,WAAW,CAAA;CACnB;AAaD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,+BAA+B,GACvC,oBAAoB,EAAE,CA6BxB"}

package/dist/alphalib/types/storageResults.js

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+import { storedAssetSchema } from "./storageAsset.js";
+// SDK-owned extraction is outside alphalib-sync's explicit node-sdk syncIncludes. Co-location
+// reuses canonical schemas and their Types/Zod generation without adding a runtime package.
+/** Server-owned Assembly identity and expected Workspace, never untrusted notification fields. */
+export const storedAssemblyResultsOptionsSchema = z.object({
+    assemblyId: z.string().regex(/^[A-Za-z0-9_-]+$/),
+    workspace: z.string().min(1),
+});
+const resultSchema = storedAssetSchema.extend({
+    id: z.string().min(1),
+    original_id: z.union([z.string(), z.array(z.string().nullable())]).optional(),
+});
+const assemblySchema = z.object({
+    assembly_id: z.string(),
+    ok: z.string().nullable().optional(),
+    error: z.string().optional(),
+    results: z.record(z.array(z.record(z.unknown()))).optional(),
+});
+/**
+ * Pure extraction from a fetched/verified Assembly bound to an authorized app upload. Validates
+ * every retained result atomically; temporary outputs are ignored, partial receipts are rejected.
+ * This does not authenticate notifications or check application permissions.
+ */
+export function extractStoredAssemblyResults(input, options) {
+    const { assemblyId, workspace } = storedAssemblyResultsOptionsSchema.parse(options);
+    const assembly = assemblySchema.parse(input);
+    if (assembly.assembly_id !== assemblyId)
+        throw new Error('The response did not match the requested Assembly');
+    if (assembly.error !== undefined || assembly.ok !== 'ASSEMBLY_COMPLETED')
+        throw new Error(`The Storage Assembly is not complete (${assembly.error ?? assembly.ok})`);
+    if (assembly.results === undefined)
+        throw new Error('The completed Assembly did not contain results');
+    const results = [];
+    for (const [step, files] of Object.entries(assembly.results)) {
+        for (const file of files) {
+            if (file.asset_id === undefined &&
+                file.version_id === undefined &&
+                file.workspace === undefined)
+                continue;
+            const parsed = resultSchema.safeParse(file);
+            if (!parsed.success || parsed.data.workspace !== workspace) {
+                throw new Error('The Assembly returned an invalid or cross-Workspace Storage result', {
+                    cause: { assemblyId, step },
+                });
+            }
+            const { id, original_id, ...asset } = parsed.data;
+            results.push({ assembly_id: assemblyId, step, result_id: id, original_id, asset });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=storageResults.js.map

package/dist/alphalib/types/storageResults.js.map

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