@transloadit/zod 5.0.0 → 5.0.1

package/dist/v3/index.d.ts

@@ -13,6 +13,7 @@ export * from './robots/_index.ts';
 export * from './skillFrontmatter.ts';
 export * from './stackVersions.ts';
 export * from './storageAsset.ts';
+export * from './storageResults.ts';
 export * from './template.ts';
 export * from './templateCredential.ts';
 export * from './utility.ts';

package/dist/v3/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v3/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v3/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA"}

package/dist/v3/index.js

@@ -13,6 +13,7 @@ export * from "./robots/_index.js";
 export * from "./skillFrontmatter.js";
 export * from "./stackVersions.js";
 export * from "./storageAsset.js";
+export * from "./storageResults.js";
 export * from "./template.js";
 export * from "./templateCredential.js";
 export * from "./utility.js";

package/dist/v3/storageResults.d.ts

@@ -0,0 +1,29 @@
+import type { StoredAsset } from './storageAsset.ts';
+import { z } from 'zod/v3';
+/** 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/v3/storageResults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageResults.d.ts","sourceRoot":"","sources":["../../src/v3/storageResults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAO1B,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/v3/storageResults.js

@@ -0,0 +1,52 @@
+import { z } from 'zod/v3';
+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;
+}

package/dist/v4/index.d.ts

@@ -13,6 +13,7 @@ export * from './robots/_index.ts';
 export * from './skillFrontmatter.ts';
 export * from './stackVersions.ts';
 export * from './storageAsset.ts';
+export * from './storageResults.ts';
 export * from './template.ts';
 export * from './templateCredential.ts';
 export * from './utility.ts';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v4/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v4/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,WAAW,CAAA;AACzB,cAAc,uBAAuB,CAAA;AACrC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,yBAAyB,CAAA;AACvC,cAAc,cAAc,CAAA"}

package/dist/v4/index.js

@@ -13,6 +13,7 @@ export * from "./robots/_index.js";
 export * from "./skillFrontmatter.js";
 export * from "./stackVersions.js";
 export * from "./storageAsset.js";
+export * from "./storageResults.js";
 export * from "./template.js";
 export * from "./templateCredential.js";
 export * from "./utility.js";

package/dist/v4/storageResults.d.ts

@@ -0,0 +1,23 @@
+import type { StoredAsset } from './storageAsset.ts';
+import { z } from 'zod/v4';
+/** Server-owned Assembly identity and expected Workspace, never untrusted notification fields. */
+export declare const storedAssemblyResultsOptionsSchema: z.ZodObject<{
+    assemblyId: z.ZodString;
+    workspace: z.ZodString;
+}, z.core.$strip>;
+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/v4/storageResults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageResults.d.ts","sourceRoot":"","sources":["../../src/v4/storageResults.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAO1B,kGAAkG;AAClG,eAAO,MAAM,kCAAkC;;;iBAG7C,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/v4/storageResults.js

@@ -0,0 +1,53 @@
+import { optionalWithV3Semantics } from "./lib/sdkZodOptional.js";
+import { z } from 'zod/v4';
+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: optionalWithV3Semantics(z.union([z.string(), z.array(z.string().nullable())])),
+});
+const assemblySchema = z.object({
+    assembly_id: z.string(),
+    ok: optionalWithV3Semantics(z.string().nullable()),
+    error: optionalWithV3Semantics(z.string()),
+    results: optionalWithV3Semantics(z.record(z.string(), z.array(z.record(z.string(), z.unknown())))),
+});
+/**
+ * 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;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@transloadit/zod",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "description": "Transloadit Zod schemas",
   "type": "module",
   "license": "MIT",
@@ -41,7 +41,7 @@
     "sync": "yarn sync:v3 && yarn sync:v4",
     "lint:ts": "yarn sync && ../../node_modules/.bin/tsc --build tsconfig.build.json",
     "test:types": "yarn sync && ../../node_modules/.bin/tsc --noEmit --project tsconfig.test.json",
-    "test:unit": "yarn sync && node test/scripts-config.test.ts && node test/patch-ai-chat-schema.test.ts && node test/exports-sync.test.ts && node test/runtime-parity.test.ts",
+    "test:unit": "yarn sync && node test/scripts-config.test.ts && node test/patch-ai-chat-schema.test.ts && node test/exports-sync.test.ts && node test/runtime-parity.test.ts && node test/storage-results.test.ts",
     "build": "yarn sync && ../../node_modules/.bin/tsc --build tsconfig.build.json",
     "prepack": "yarn build",
     "check": "yarn sync && ../../node_modules/.bin/tsc --build tsconfig.build.json && ../../node_modules/.bin/tsc --noEmit --project tsconfig.test.json && yarn test:unit"
@@ -50,7 +50,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@transloadit/types": "^5.0.0",
+    "@transloadit/types": "^5.0.1",
     "@types/node": "^25.8.0"
   }
 }