@form-engine-ts/zod 2.3.0 → 2.5.1

package/README.md

@@ -32,3 +32,15 @@ const firstPageResult = createZodFormSchema(schema, { pageIndex: 0 }).safeParse(
 
 Zod is a `^4.0.0` peer dependency. Schema metadata is checked by Core before validator creation, and parsed answer
 objects retain passthrough values. Required, choice, visibility, and page-scoped issue codes match Core validation.
+
+Use `createZodFormCodec(schema, options)` for a validation-and-normalization pipeline. It can trim strings, remove answers
+for currently hidden fields, and strip fields that are not defined by the schema:
+
+```ts
+const codec = createZodFormCodec(schema, {
+  trimStrings: true,
+  stripHiddenFields: true,
+  stripUnknownFields: true
+});
+const normalized = codec.parse(values);
+```

package/dist/index.cjs

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  createZodFormCodec: () => createZodFormCodec,
   createZodFormSchema: () => createZodFormSchema
 });
 module.exports = __toCommonJS(index_exports);
@@ -74,7 +75,38 @@ function createZodFormSchema(schema, options = {}) {
     }
   });
 }
+function normalizeCodecValue(value) {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length === 0 ? void 0 : trimmed;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => typeof item === "string" ? item.trim() : item).filter((item) => item !== "");
+  }
+  return value;
+}
+function createZodFormCodec(schema, options = {}) {
+  (0, import_core.assertValidFormSchema)(schema);
+  const stableSchema = cloneSchema(schema);
+  const fieldIds = new Set(stableSchema.fields.map((field) => field.id));
+  const recognizedExtensionKeys = /* @__PURE__ */ new Set(["metadata", "translationMetadata"]);
+  return import_zod.z.preprocess((input) => {
+    if (typeof input !== "object" || input === null || Array.isArray(input)) return input;
+    const entries = Object.entries(input);
+    const normalized = Object.fromEntries(
+      entries.filter(([key]) => options.stripUnknownFields !== true || fieldIds.has(key) || recognizedExtensionKeys.has(key)).map(([key, value]) => [key, options.trimStrings === true ? normalizeCodecValue(value) : value])
+    );
+    if (options.stripHiddenFields === true) {
+      const visibility = (0, import_core.calculateFieldVisibility)(stableSchema, normalized);
+      for (const field of stableSchema.fields) {
+        if (visibility[field.id] !== true) delete normalized[field.id];
+      }
+    }
+    return normalized;
+  }, createZodFormSchema(stableSchema));
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  createZodFormCodec,
   createZodFormSchema
 });

package/dist/index.d.cts

@@ -5,5 +5,11 @@ interface CreateZodFormSchemaOptions {
     readonly pageIndex?: number;
 }
 declare function createZodFormSchema(schema: FormSchema, options?: CreateZodFormSchemaOptions): z.ZodType<Record<string, unknown>>;
+interface ZodTransformOptions {
+    readonly stripHiddenFields?: boolean;
+    readonly stripUnknownFields?: boolean;
+    readonly trimStrings?: boolean;
+}
+declare function createZodFormCodec(schema: FormSchema, options?: ZodTransformOptions): z.ZodPreprocess<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
 
-export { type CreateZodFormSchemaOptions, createZodFormSchema };
+export { type CreateZodFormSchemaOptions, type ZodTransformOptions, createZodFormCodec, createZodFormSchema };

package/dist/index.d.ts

@@ -5,5 +5,11 @@ interface CreateZodFormSchemaOptions {
     readonly pageIndex?: number;
 }
 declare function createZodFormSchema(schema: FormSchema, options?: CreateZodFormSchemaOptions): z.ZodType<Record<string, unknown>>;
+interface ZodTransformOptions {
+    readonly stripHiddenFields?: boolean;
+    readonly stripUnknownFields?: boolean;
+    readonly trimStrings?: boolean;
+}
+declare function createZodFormCodec(schema: FormSchema, options?: ZodTransformOptions): z.ZodPreprocess<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
 
-export { type CreateZodFormSchemaOptions, createZodFormSchema };
+export { type CreateZodFormSchemaOptions, type ZodTransformOptions, createZodFormCodec, createZodFormSchema };

package/dist/index.js

@@ -1,6 +1,7 @@
 // src/index.ts
 import {
   assertValidFormSchema,
+  calculateFieldVisibility,
   validateAnswers,
   validatePageAnswers
 } from "@form-engine-ts/core";
@@ -54,6 +55,37 @@ function createZodFormSchema(schema, options = {}) {
     }
   });
 }
+function normalizeCodecValue(value) {
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    return trimmed.length === 0 ? void 0 : trimmed;
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => typeof item === "string" ? item.trim() : item).filter((item) => item !== "");
+  }
+  return value;
+}
+function createZodFormCodec(schema, options = {}) {
+  assertValidFormSchema(schema);
+  const stableSchema = cloneSchema(schema);
+  const fieldIds = new Set(stableSchema.fields.map((field) => field.id));
+  const recognizedExtensionKeys = /* @__PURE__ */ new Set(["metadata", "translationMetadata"]);
+  return z.preprocess((input) => {
+    if (typeof input !== "object" || input === null || Array.isArray(input)) return input;
+    const entries = Object.entries(input);
+    const normalized = Object.fromEntries(
+      entries.filter(([key]) => options.stripUnknownFields !== true || fieldIds.has(key) || recognizedExtensionKeys.has(key)).map(([key, value]) => [key, options.trimStrings === true ? normalizeCodecValue(value) : value])
+    );
+    if (options.stripHiddenFields === true) {
+      const visibility = calculateFieldVisibility(stableSchema, normalized);
+      for (const field of stableSchema.fields) {
+        if (visibility[field.id] !== true) delete normalized[field.id];
+      }
+    }
+    return normalized;
+  }, createZodFormSchema(stableSchema));
+}
 export {
+  createZodFormCodec,
   createZodFormSchema
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/zod",
-  "version": "2.3.0",
+  "version": "2.5.1",
   "publishConfig": {
     "access": "public"
   },
@@ -39,7 +39,7 @@
     "typescript"
   ],
   "dependencies": {
-    "@form-engine-ts/core": "2.3.0"
+    "@form-engine-ts/core": "2.5.1"
   },
   "peerDependencies": {
     "zod": "^4.0.0"