cogsbox-shape 0.5.212 → 0.5.214

package/cogsbox-shape-state/dist/plugin.d.ts

@@ -37,6 +37,7 @@ type FormUpdateParams = {
     path: string[];
     event: {
         activityType: string;
+        details?: Record<string, unknown>;
     };
     getState: () => unknown;
     addZodErrors: (errors: Array<{
@@ -44,12 +45,29 @@ type FormUpdateParams = {
         message: string;
         code?: string;
     }>) => void;
-    clearZodErrors: (paths: string[][]) => void;
+    clearZodErrors?: (paths: string[][]) => void;
+};
+type UpdateParams = {
+    stateKey: string;
+    update: {
+        path: string[];
+        updateType: string;
+        oldValue: unknown;
+        newValue: unknown;
+    };
+    getState: () => unknown;
+    addZodErrors: (errors: Array<{
+        path: string[];
+        message: string;
+        code?: string;
+    }>) => void;
+    clearZodErrors?: (paths: string[][]) => void;
 };
 export declare function wireShapeValidationOptions(box: ShapeSchemaBox, params: TransformStateParams): void;
 /** Cross-field refine errors only — field rules are handled by state via setOptions. */
 export declare function validateShapeRefines(box: ShapeSchemaBox, params: FormUpdateParams): void;
+export declare function validateShapeRefinesOnUpdate(box: ShapeSchemaBox, params: UpdateParams): void;
 export declare function createShapePlugin<const TBox extends ShapeSchemaBox>(box: TBox): import("cogsbox-state").CogsPluginBuilder<"shape", {
     logs: boolean | undefined;
-}, unknown, unknown, never, {}, true, false, true, false, false, true, InferShapeBoxState<TBox>>;
+}, unknown, unknown, never, {}, true, true, true, false, false, true, InferShapeBoxState<TBox>>;
 export {};

package/cogsbox-shape-state/dist/plugin.js

@@ -1,4 +1,4 @@
-import { createPluginContext } from "cogsbox-state";
+import { createPluginContext, getGlobalStore } from "cogsbox-state";
 import { z } from "zod";
 function pathKey(path) {
     return path.join("\0");
@@ -14,6 +14,100 @@ function mapZodIssues(issues) {
         code: issue.code,
     }));
 }
+function cloneStateForInputEvent(state, path, value) {
+    if (path.length === 0)
+        return value;
+    if (state === null || typeof state !== "object")
+        return state;
+    const root = Array.isArray(state)
+        ? [...state]
+        : { ...state };
+    let cursor = root;
+    for (let index = 0; index < path.length - 1; index++) {
+        const segment = path[index];
+        if (Array.isArray(cursor)) {
+            const arrayIndex = Number(segment);
+            if (!Number.isInteger(arrayIndex))
+                return root;
+            const next = cursor[arrayIndex];
+            const cloned = next && typeof next === "object"
+                ? Array.isArray(next)
+                    ? [...next]
+                    : { ...next }
+                : {};
+            cursor[arrayIndex] = cloned;
+            cursor = cloned;
+        }
+        else {
+            const next = cursor[segment];
+            const cloned = next && typeof next === "object"
+                ? Array.isArray(next)
+                    ? [...next]
+                    : { ...next }
+                : {};
+            cursor[segment] = cloned;
+            cursor = cloned;
+        }
+    }
+    const leaf = path[path.length - 1];
+    if (Array.isArray(cursor)) {
+        const arrayIndex = Number(leaf);
+        if (Number.isInteger(arrayIndex))
+            cursor[arrayIndex] = value;
+    }
+    else {
+        cursor[leaf] = value;
+    }
+    return root;
+}
+function getStateForValidation(params) {
+    const state = params.getState();
+    if (params.event.activityType !== "input" ||
+        !("details" in params.event) ||
+        !params.event.details ||
+        typeof params.event.details !== "object" ||
+        !("value" in params.event.details)) {
+        return state;
+    }
+    return cloneStateForInputEvent(state, params.path, params.event.details.value);
+}
+function notifyValidationPaths(stateKey, paths) {
+    const store = getGlobalStore.getState();
+    for (const path of paths) {
+        store.notifyPathSubscribers([stateKey, ...path].join("."), {
+            type: "VALIDATION_UPDATE",
+        });
+    }
+}
+function clearValidationPaths(params, paths) {
+    if (paths.length === 0)
+        return;
+    if (params.clearZodErrors) {
+        params.clearZodErrors(paths);
+        notifyValidationPaths(params.stateKey, paths);
+        return;
+    }
+    const store = getGlobalStore.getState();
+    for (const path of paths) {
+        const currentMeta = store.getShadowMetadata(params.stateKey, path) || {};
+        store.setShadowMetadata(params.stateKey, path, {
+            ...currentMeta,
+            validation: {
+                status: "NOT_VALIDATED",
+                errors: [],
+                lastValidated: Date.now(),
+                validatedValue: undefined,
+            },
+        });
+    }
+    notifyValidationPaths(params.stateKey, paths);
+}
+function addValidationIssues(params, issues) {
+    if (issues.length === 0)
+        return;
+    params.addZodErrors(issues);
+    notifyValidationPaths(params.stateKey, issues.map((issue) => issue.path));
+}
 function getRelatedFields(entry, field) {
     const groupIndexes = entry.refineInfo?.fieldToGroup[field];
     if (!groupIndexes?.length)
@@ -32,14 +126,90 @@ function issueMatchesRelatedFields(issue, relatedFields) {
     const leaf = String(issue.path.at(-1) ?? "");
     return relatedFields.has(leaf);
 }
-export function wireShapeValidationOptions(box, params) { }
+function getChangedObjectFields(oldValue, newValue) {
+    if (oldValue === null ||
+        newValue === null ||
+        typeof oldValue !== "object" ||
+        typeof newValue !== "object" ||
+        Array.isArray(oldValue) ||
+        Array.isArray(newValue)) {
+        return null;
+    }
+    const fields = new Set();
+    const oldRecord = oldValue;
+    const newRecord = newValue;
+    for (const key of new Set([...Object.keys(oldRecord), ...Object.keys(newRecord)])) {
+        if (!Object.is(oldRecord[key], newRecord[key]))
+            fields.add(key);
+    }
+    return fields;
+}
+function resolveUpdateRefineTarget(entry, updatePath, oldValue, newValue) {
+    const changedObjectFields = getChangedObjectFields(oldValue, newValue);
+    if (changedObjectFields) {
+        const parentPath = updatePath;
+        const relatedFields = new Set();
+        for (const field of changedObjectFields) {
+            const groupFields = getRelatedFields(entry, field);
+            if (!groupFields)
+                continue;
+            for (const related of groupFields)
+                relatedFields.add(related);
+        }
+        if (relatedFields.size === 0)
+            return null;
+        return {
+            relatedFields,
+            relatedPaths: [...relatedFields].map((field) => [...parentPath, field]),
+        };
+    }
+    const field = updatePath.at(-1);
+    if (!field)
+        return null;
+    const relatedFields = getRelatedFields(entry, field);
+    if (!relatedFields)
+        return null;
+    return {
+        relatedFields,
+        relatedPaths: resolveRelatedPaths(updatePath, relatedFields),
+    };
+}
+function applyRefineValidation(box, params, target, state) {
+    const entry = box[params.stateKey];
+    const clientSchema = entry?.validators?.client ?? entry?.schemas.client;
+    if (!entry || !clientSchema)
+        return;
+    const result = clientSchema.safeParse(state);
+    if (result.success) {
+        clearValidationPaths(params, target.relatedPaths);
+        return;
+    }
+    const issues = result.error.issues.filter((issue) => issueMatchesRelatedFields(issue, target.relatedFields));
+    const mapped = mapZodIssues(issues);
+    const activeKeys = new Set(mapped.map((entry) => pathKey(entry.path)));
+    const stalePaths = target.relatedPaths.filter((targetPath) => !activeKeys.has(pathKey(targetPath)));
+    clearValidationPaths(params, stalePaths);
+    addValidationIssues(params, mapped);
+}
+export function wireShapeValidationOptions(box, params) {
+    const entry = box[params.stateKey];
+    if (!entry)
+        return;
+    params.setOptions({
+        validation: {
+            zodSchemaV4: entry.validators?.client ?? entry.schemas.client,
+            onBlur: "error",
+        },
+    });
+}
 /** Cross-field refine errors only — field rules are handled by state via setOptions. */
 export function validateShapeRefines(box, params) {
-    if (params.event.activityType !== "blur")
+    if (params.event.activityType !== "blur" &&
+        params.event.activityType !== "input") {
         return;
+    }
     const entry = box[params.stateKey];
-    const clientSchema = entry?.validators?.client ?? entry?.schemas.client;
-    if (!entry || !clientSchema)
+    if (!entry)
         return;
     const field = params.path.at(-1);
     if (!field)
@@ -47,22 +217,21 @@ export function validateShapeRefines(box, params) {
     const relatedFields = getRelatedFields(entry, field);
     if (!relatedFields)
         return;
-    const relatedPaths = resolveRelatedPaths(params.path, relatedFields);
-    const result = clientSchema.safeParse(params.getState());
-    if (result.success) {
-        params.clearZodErrors(relatedPaths);
+    applyRefineValidation(box, params, {
+        relatedFields,
+        relatedPaths: resolveRelatedPaths(params.path, relatedFields),
+    }, getStateForValidation(params));
+}
+export function validateShapeRefinesOnUpdate(box, params) {
+    if (params.update.updateType !== "update")
         return;
-    }
-    const issues = result.error.issues.filter((issue) => issueMatchesRelatedFields(issue, relatedFields));
-    const mapped = mapZodIssues(issues);
-    const activeKeys = new Set(mapped.map((entry) => pathKey(entry.path)));
-    const stalePaths = relatedPaths.filter((targetPath) => !activeKeys.has(pathKey(targetPath)));
-    if (stalePaths.length > 0) {
-        params.clearZodErrors(stalePaths);
-    }
-    if (mapped.length > 0) {
-        params.addZodErrors(mapped);
-    }
+    const entry = box[params.stateKey];
+    if (!entry)
+        return;
+    const target = resolveUpdateRefineTarget(entry, params.update.path, params.update.oldValue, params.update.newValue);
+    if (!target)
+        return;
+    applyRefineValidation(box, params, target, params.getState());
 }
 function buildInitialState(box) {
     const state = {};
@@ -84,20 +253,15 @@ export function createShapePlugin(box) {
     return createPlugin("shape")
         .initialState(() => buildInitialState(box))
         .transformState((params) => {
-        const entry = box[params.stateKey];
-        if (!entry)
-            return;
-        params.setOptions({
-            validation: {
-                zodSchemaV4: entry.validators?.client ?? entry.schemas.client,
-                onBlur: "error",
-            },
-        });
+        wireShapeValidationOptions(box, params);
     })
         .onFormUpdate((params) => {
         if (params.options?.logs) {
             console.log("[shape]", params.stateKey, params.path, params.event.activityType);
         }
         validateShapeRefines(box, params);
+    })
+        .onUpdate((params) => {
+        validateShapeRefinesOnUpdate(box, params);
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cogsbox-shape",
-  "version": "0.5.212",
+  "version": "0.5.214",
   "description": "A TypeScript library for creating type-safe database schemas with Zod validation, SQL type definitions, and automatic client/server transformations. Unifies client, server, and database types through a single schema definition, with built-in support for relationships and serialization.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",