@fuzdev/fuz_app 0.136.0 → 0.138.0

package/dist/zod.js

@@ -0,0 +1,171 @@
+/**
+ * Zod schema introspection utilities.
+ *
+ * Generic helpers for walking, unwrapping, and extracting field info from Zod schemas.
+ * Used by adversarial input testing, test-data generation, action codegen, and
+ * auth-shape checks.
+ *
+ * @module
+ */
+//
+// Schema Introspection
+//
+/**
+ * Unwrap nested schema types (optional, default, nullable, etc).
+ *
+ * @returns inner schema if wrapped, undefined otherwise
+ */
+const zod_to_subschema = (def) => {
+    if ('innerType' in def) {
+        return def.innerType;
+    }
+    else if ('in' in def) {
+        return def.in;
+    }
+    else if ('schema' in def) {
+        return def.schema;
+    }
+    return undefined;
+};
+/** Zod wrapper type names that `zod_unwrap_def` traverses through. */
+const ZOD_WRAPPER_TYPES = new Set([
+    'optional',
+    'nullable',
+    'default',
+    'transform',
+    'pipe',
+    'prefault'
+]);
+/**
+ * Unwrap Zod wrappers (optional, default, nullable, pipe, transform)
+ * to get the base type definition.
+ *
+ * @returns the innermost non-wrapper type definition
+ */
+export const zod_unwrap_def = (schema) => {
+    const { def } = schema;
+    if (ZOD_WRAPPER_TYPES.has(def.type)) {
+        const sub = zod_to_subschema(def);
+        if (sub)
+            return zod_unwrap_def(sub);
+    }
+    return def;
+};
+/**
+ * Get the base type name for a Zod schema, unwrapping all wrappers.
+ *
+ * @returns base type name (e.g. `'string'`, `'object'`, `'uuid'`)
+ */
+export const zod_get_base_type = (schema) => zod_unwrap_def(schema).type;
+/**
+ * Check if a schema is optional at the outermost level.
+ */
+const zod_is_optional = (schema) => schema.def.type === 'optional';
+/**
+ * Check if a schema accepts null at any wrapping level.
+ */
+const zod_is_nullable = (schema) => {
+    const { def } = schema;
+    if (def.type === 'nullable')
+        return true;
+    if (ZOD_WRAPPER_TYPES.has(def.type)) {
+        const sub = zod_to_subschema(def);
+        if (sub)
+            return zod_is_nullable(sub);
+    }
+    return false;
+};
+/**
+ * Check if a schema has a default value at any wrapping level.
+ * Distinguishes "no default" from "default is undefined".
+ */
+const zod_has_default = (schema) => {
+    const { def } = schema;
+    if ('defaultValue' in def)
+        return true;
+    const sub = zod_to_subschema(def);
+    if (sub)
+        return zod_has_default(sub);
+    return false;
+};
+/**
+ * Unwrap a schema through every wrapper type (optional, nullable, default,
+ * transform, pipe, prefault) to reach the innermost schema. Like `zod_unwrap_def`
+ * but returns the schema (so callers can `.shape`, `instanceof`-check, etc.)
+ * instead of the def.
+ *
+ * @returns the innermost non-wrapper schema
+ */
+export const zod_get_innermost_type = (schema) => {
+    if (ZOD_WRAPPER_TYPES.has(schema.def.type)) {
+        const sub = zod_to_subschema(schema.def);
+        if (sub)
+            return zod_get_innermost_type(sub);
+    }
+    return schema;
+};
+/**
+ * Get all property keys from an object schema, unwrapping wrappers.
+ * Returns an empty array if the innermost type is not an object.
+ *
+ * @param schema - Zod schema (typically a `ZodObject` with possible wrappers)
+ */
+export const zod_get_schema_keys = (schema) => {
+    const obj = zod_unwrap_to_object(schema);
+    return obj ? Object.keys(obj.shape) : [];
+};
+/**
+ * Get the field schema for a key in an object schema, returning `undefined` if
+ * the schema is not an object or the key is missing.
+ *
+ * @param schema - Zod schema (typically a `ZodObject` with possible wrappers)
+ * @param key - the property name
+ * @returns the field's schema, or `undefined`
+ */
+const zod_maybe_get_field_schema = (schema, key) => zod_unwrap_to_object(schema)?.shape[key];
+/**
+ * Get the field schema for a key in an object schema.
+ *
+ * @param schema - Zod schema (typically a `ZodObject` with possible wrappers)
+ * @throws Error if the schema is not an object or the key is missing
+ */
+export const zod_get_field_schema = (schema, key) => {
+    const field = zod_maybe_get_field_schema(schema, key);
+    if (!field)
+        throw new Error(`Field "${key}" not found in schema`);
+    return field;
+};
+/**
+ * Unwrap a schema to find the inner `ZodObject`, or `null` if not an object schema.
+ * Handles wrappers like `z.strictObject({...}).default({...})`.
+ */
+export const zod_unwrap_to_object = (schema) => {
+    const def = zod_unwrap_def(schema);
+    if (def.type !== 'object')
+        return null;
+    let s = schema;
+    while (s.def.type !== 'object') {
+        const sub = zod_to_subschema(s.def);
+        if (!sub)
+            return null;
+        s = sub;
+    }
+    return s;
+};
+/**
+ * Extract field metadata from a Zod object schema.
+ */
+export const zod_extract_fields = (schema) => {
+    const fields = [];
+    for (const [name, field_schema] of Object.entries(schema.shape)) {
+        const field = field_schema;
+        fields.push({
+            name,
+            base_type: zod_get_base_type(field),
+            required: !zod_is_optional(field),
+            has_default: zod_has_default(field),
+            nullable: zod_is_nullable(field)
+        });
+    }
+    return fields;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_app",
-  "version": "0.136.0",
+  "version": "0.138.0",
   "description": "fullstack app library",
   "glyph": "🗝",
   "logo": "logo.svg",
@@ -34,7 +34,8 @@
     "@electric-sql/pglite": ">=0.4",
     "@fuzdev/blake3-wasm": ">=0.2.0",
     "@fuzdev/fuz_css": ">=0.65.0",
-    "@fuzdev/fuz_util": ">=0.70.0",
+    "@fuzdev/fuz_schema": "^0.2.2",
+    "@fuzdev/fuz_util": ">=0.75.0",
     "@fuzdev/pglet-wasm": ">=0.1.1",
     "@hono/bun": ">=1",
     "@hono/deno": ">=1",
@@ -92,9 +93,10 @@
     "@fuzdev/blake3-wasm": "^0.2.0",
     "@fuzdev/fuz_code": "^0.52.1",
     "@fuzdev/fuz_css": "^0.66.1",
+    "@fuzdev/fuz_schema": "^0.2.2",
     "@fuzdev/fuz_ui": "^0.213.0",
-    "@fuzdev/fuz_util": "^0.72.0",
-    "@fuzdev/gro": "^0.216.0",
+    "@fuzdev/fuz_util": "^0.75.0",
+    "@fuzdev/gro": "^0.218.0",
     "@fuzdev/mdz": "^0.4.0",
     "@fuzdev/pglet-wasm": "^0.1.1",
     "@hono/bun": "^1.0.1",
@@ -130,7 +132,7 @@
     "vitest": "^5.0.0",
     "ws": "^8.20.1",
     "zimmerframe": "^1.1.4",
-    "zod": "^4.3.6"
+    "zod": "^4.6.7"
   },
   "sideEffects": [
     "**/*.css"