@apify/actor-utils 0.1.9-beta.0 → 0.1.9-beta.2

package/dist/src/zod/index.d.ts

@@ -0,0 +1,3 @@
+export { partialSafeParse, PartialSafeParseResult, RecursivePartial } from './partial-safe-parse.js';
+export { StringyIntegerSchema } from './stringy-integer-schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/zod/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/zod/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/src/zod/index.js

@@ -0,0 +1,3 @@
+export { partialSafeParse } from './partial-safe-parse.js';
+export { StringyIntegerSchema } from './stringy-integer-schema.js';
+//# sourceMappingURL=index.js.map

package/dist/src/zod/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/zod/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA4C,MAAM,yBAAyB,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/src/zod/partial-safe-parse.d.ts

@@ -0,0 +1,25 @@
+import z, { ZodError } from 'zod';
+export type RecursivePartial<T> = T extends object ? {
+    [P in keyof T]?: RecursivePartial<T[P]>;
+} : T;
+export type PartialSafeParseResult<Schema extends z.ZodType> = {
+    success: true;
+    data: z.infer<Schema>;
+    error: never;
+} | {
+    success: false;
+    data: RecursivePartial<z.infer<Schema>> | undefined;
+    error: ZodError;
+};
+/**
+ * Performs a recursive partial safe parse on the provided data using the given Zod schema.
+ * - This makes sure that all nested objects are parsed as deeply as possible, returning any successfully parsed data
+ *      along with detailed errors for any failures.
+ *
+ * Parsing cases:
+ * - For objects, returns any fields containing at least partially parsed data with nested structures preserved.
+ * - For arrays, returns items containing at least partially parsed data.
+ * - For primitives, simply returns the error if parsing fails.
+ */
+export declare function partialSafeParse<Schema extends z.ZodType>(schema: Schema, data: unknown): PartialSafeParseResult<Schema>;
+//# sourceMappingURL=partial-safe-parse.d.ts.map

package/dist/src/zod/partial-safe-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partial-safe-parse.d.ts","sourceRoot":"","sources":["../../../src/zod/partial-safe-parse.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAGlC,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,CAAC,CAAC;AAErG,MAAM,MAAM,sBAAsB,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,IACrD;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACtD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAE/F;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,EACrD,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GACd,sBAAsB,CAAC,MAAM,CAAC,CAIhC"}

package/dist/src/zod/partial-safe-parse.js

@@ -0,0 +1,120 @@
+import z, { ZodError } from 'zod';
+/**
+ * Performs a recursive partial safe parse on the provided data using the given Zod schema.
+ * - This makes sure that all nested objects are parsed as deeply as possible, returning any successfully parsed data
+ *      along with detailed errors for any failures.
+ *
+ * Parsing cases:
+ * - For objects, returns any fields containing at least partially parsed data with nested structures preserved.
+ * - For arrays, returns items containing at least partially parsed data.
+ * - For primitives, simply returns the error if parsing fails.
+ */
+export function partialSafeParse(schema, data) {
+    const basePath = [];
+    return partialSafeParseInternal(schema, data, basePath);
+}
+/**
+ * Implementation of the recursive partial safe parse logic.
+ * - Due to typescripts and zod's type limitations around generics, we cannot type the full function properly
+ *      - So it's easier to just type cast it instead of doing it the proper way.
+ * - Wrappers are unwrapped through `def.innerType` rather than by naming wrapper classes, which covers chains such
+ *      as `.nullish()` and wrappers we have not thought of
+ *      - Wrappers that accept the value (an absent `.optional()`, an applied `.default()`, any `.catch()`) return at
+ *          the success check first, so they are never unwrapped
+ */
+function partialSafeParseInternal(schema, data, path) {
+    const result = z.safeParse(schema, data);
+    if (result.success)
+        return result;
+    if (schema instanceof z.ZodObject && isRecord(data)) {
+        return partialSafeParseObject(schema, data, path);
+    }
+    const isArrayLikeSchema = schema instanceof z.ZodArray || schema instanceof z.ZodTuple;
+    if (isArrayLikeSchema && Array.isArray(data)) {
+        return partialSafeParseArrayLike(schema, data, path);
+    }
+    // Wrapper schema - re-enter with the inner type so the checks above get a chance at it
+    const innerType = getWrappedInnerType(schema);
+    if (innerType) {
+        return partialSafeParseInternal(innerType, data, path);
+    }
+    // Primitive failure
+    const errorWithPath = mergeZodErrorWithPath(result.error, path);
+    return { error: errorWithPath, success: false };
+}
+/**
+ * Performs a recursive partial safe parse on an object schema, processing each field individually.
+ * At least partially parsed fields are collected in `partialData`, while errors for failed fields are aggregated.
+ */
+function partialSafeParseObject(schema, data, path) {
+    const partialData = {};
+    const errors = [];
+    for (const key of Object.keys(schema.shape)) {
+        const keySchema = schema.shape[key];
+        const fieldResult = partialSafeParseInternal(keySchema, data[key], [...path, key]);
+        if (fieldResult.success) {
+            partialData[key] = fieldResult.data;
+            continue;
+        }
+        if ('data' in fieldResult) {
+            partialData[key] = fieldResult.data;
+        }
+        errors.push(fieldResult.error);
+    }
+    const error = new ZodError(errors.flatMap((err) => err.issues));
+    return { data: partialData, error, success: false };
+}
+/**
+ * Performs a recursive partial safe parse on array-like schemas (arrays and tuples), processing each item individually.
+ * - All at least partially parsed items are collected in `partialData`, while errors for failed items are aggregated.
+ */
+function partialSafeParseArrayLike(schema, data, path) {
+    const partialData = [];
+    const errors = [];
+    for (const [index, item] of data.entries()) {
+        const itemSchema = getArrayLikeItemSchema(schema, index);
+        if ('skipRemainingItems' in itemSchema)
+            break;
+        const itemResult = partialSafeParseInternal(itemSchema, item, [...path, index]);
+        if (itemResult.success) {
+            partialData.push(itemResult.data);
+            continue;
+        }
+        if ('data' in itemResult) {
+            partialData.push(itemResult.data);
+        }
+        errors.push(itemResult.error);
+    }
+    const error = new ZodError(errors.flatMap((err) => err.issues));
+    return { data: partialData, error, success: false };
+}
+/**
+ * Gets the item schema for the given item index in the array like structure.
+ * - For regular arrays the schema is the same for all items
+ * - For tuples, we have to get the schema for each element separately. If we run out of items we continue onto the rest
+ *      attribute, if available, otherwise we skip the remaining items.
+ */
+function getArrayLikeItemSchema(schema, index) {
+    if (schema instanceof z.ZodArray) {
+        return schema.element;
+    }
+    return schema.def.items[index] ?? schema.def.rest ?? { skipRemainingItems: true };
+}
+function getWrappedInnerType(schema) {
+    if (!(schema instanceof z.ZodType))
+        return undefined;
+    const { def } = schema;
+    if (!('innerType' in def))
+        return undefined;
+    return def.innerType instanceof z.ZodType ? def.innerType : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function mergeZodErrorWithPath(error, path) {
+    return new ZodError(error.issues.map((issue) => ({
+        ...issue,
+        path: [...path, ...issue.path],
+    })));
+}
+//# sourceMappingURL=partial-safe-parse.js.map

package/dist/src/zod/partial-safe-parse.js.map

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

package/dist/src/zod/stringy-integer-schema.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+/**
+ * This validates the string is a plain non-negative integer and converts it to a `number`.
+ * - Also rejects values that would lose precision past `Number.MAX_SAFE_INTEGER`
+ */
+export declare const StringyIntegerSchema: z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>;
+//# sourceMappingURL=stringy-integer-schema.d.ts.map

package/dist/src/zod/stringy-integer-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringy-integer-schema.d.ts","sourceRoot":"","sources":["../../../src/zod/stringy-integer-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,oBAAoB,wDAgB3B,CAAC"}

package/dist/src/zod/stringy-integer-schema.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+/**
+ * This validates the string is a plain non-negative integer and converts it to a `number`.
+ * - Also rejects values that would lose precision past `Number.MAX_SAFE_INTEGER`
+ */
+export const StringyIntegerSchema = z
+    .string()
+    .regex(/^\d+$/, {
+    error: (issue) => `Invalid input: expected numeric string, received ${JSON.stringify(issue.input)}`,
+})
+    .transform((value, ctx) => {
+    const number = Number(value);
+    if (Number.isSafeInteger(number))
+        return number;
+    ctx.addIssue({
+        code: 'custom',
+        message: `Invalid input: stringy integer "${value}" exceeds Number.MAX_SAFE_INTEGER and would lose precision` +
+            ' - use z.string() for this field instead',
+    });
+    return z.NEVER;
+});
+//# sourceMappingURL=stringy-integer-schema.js.map

package/dist/src/zod/stringy-integer-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringy-integer-schema.js","sourceRoot":"","sources":["../../../src/zod/stringy-integer-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAChC,MAAM,EAAE;KACR,KAAK,CAAC,OAAO,EAAE;IACZ,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,oDAAoD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;CACtG,CAAC;KACD,SAAS,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACtB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAEhD,GAAG,CAAC,QAAQ,CAAC;QACT,IAAI,EAAE,QAAQ;QACd,OAAO,EACH,mCAAmC,KAAK,4DAA4D;YACpG,0CAA0C;KACjD,CAAC,CAAC;IACH,OAAO,CAAC,CAAC,KAAK,CAAC;AACnB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apify/actor-utils",
-  "version": "0.1.9-beta.0",
+  "version": "0.1.9-beta.2",
   "type": "module",
   "description": "Wrapper around Actor.pushData that survives dataset schema-validation failures by stripping offending fields and retrying. Callers pass the actual push function as pushFn.",
   "repository": {
@@ -32,6 +32,10 @@
     "./gteam-internal": {
       "types": "./dist/src/gteam-internal/index.d.ts",
       "default": "./dist/src/gteam-internal/index.js"
+    },
+    "./zod": {
+      "types": "./dist/src/zod/index.d.ts",
+      "default": "./dist/src/zod/index.js"
     }
   },
   "files": [
@@ -51,6 +55,9 @@
       ],
       "gteam-internal": [
         "dist/src/gteam-internal/index.d.ts"
+      ],
+      "zod": [
+        "dist/src/zod/index.d.ts"
       ]
     }
   },
@@ -89,13 +96,15 @@
     "prettier": "^3.9.4",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.62.1",
-    "vitest": "^4.0.18"
+    "vitest": "^4.0.18",
+    "zod": "^4.6.2"
   },
   "license": "ISC",
   "peerDependencies": {
     "@apify/log": "^2",
     "apify": "^3",
-    "apify-client": "^2"
+    "apify-client": "^2",
+    "zod": "^4"
   },
   "peerDependenciesMeta": {
     "apify": {
@@ -103,6 +112,9 @@
     },
     "apify-client": {
       "optional": true
+    },
+    "zod": {
+      "optional": true
     }
   }
 }