@gialicus/smart-object 1.0.0 → 2.0.1

package/dist/types.d.ts

@@ -2,9 +2,9 @@ import type { Operation } from "fast-json-patch";
 import type { z } from "zod";
 export type { Operation };
 /**
- * Schemas accepted by SmartObject: plain objects or unions of objects at root.
+ * Schemas accepted by SmartObject: plain objects, unions of objects, intersections, or lazy wrappers at root.
  */
-export type SmartObjectSchema = z.ZodObject | z.ZodDiscriminatedUnion | z.ZodUnion;
+export type SmartObjectSchema = z.ZodObject | z.ZodDiscriminatedUnion | z.ZodUnion | z.ZodIntersection | z.ZodLazy;
 /**
  * Compile-time map of `set*` methods for each schema key.
  *
@@ -26,6 +26,30 @@ export type AllKeys<T> = T extends unknown ? keyof T : never;
 export type SetMethodsUnion<T> = {
     [K in AllKeys<T> as `set${Capitalize<string & K>}`]: (value: T extends unknown ? (K extends keyof T ? T[K] : never) : never) => void;
 };
+type UnionToIntersection<U> = (U extends unknown ? (value: U) => void : never) extends (value: infer I) => void ? I : never;
+type OmitDiscriminator<T, D extends PropertyKey> = Omit<T, D & keyof T>;
+type PerVariantSwitchMethod<T, D extends PropertyKey> = T extends Record<D, infer Tag extends string> ? Tag extends string ? {
+    [K in `switchTo${Capitalize<Tag>}`]: (value: OmitDiscriminator<T, D>) => void;
+} : never : never;
+/**
+ * Variant switching for union root schemas.
+ */
+export type VariantSwitchMethods<T> = {
+    switchVariant(value: T): void;
+};
+export type DiscriminatedVariantSwitchMethods<T, D extends PropertyKey> = VariantSwitchMethods<T> & UnionToIntersection<PerVariantSwitchMethod<T, D>>;
+type EntryValue<T> = T extends Record<string, infer V> ? V : T extends Map<string, infer V> ? V : never;
+type IsEntryField<T> = NonNullable<T> extends Record<string, unknown> ? true : NonNullable<T> extends Map<string, infer _V> ? true : false;
+/**
+ * Dynamic entry accessors for `z.record` and string-key `z.map` fields.
+ */
+export type RecordFieldMethods<T> = {
+    [K in keyof T as IsEntryField<T[K]> extends true ? `get${Capitalize<string & K>}Entry` : never]: (key: string) => EntryValue<NonNullable<T[K]>> | undefined;
+} & {
+    [K in keyof T as IsEntryField<T[K]> extends true ? `set${Capitalize<string & K>}Entry` : never]: (key: string, value: EntryValue<NonNullable<T[K]>>) => void;
+} & {
+    [K in keyof T as IsEntryField<T[K]> extends true ? `delete${Capitalize<string & K>}Entry` : never]: (key: string) => void;
+};
 /**
  * Read/write surface and audit trail are separate concerns in the public API.
  *
@@ -38,18 +62,27 @@ export type OperationsAccessor = {
     /** Drops accumulated patches after persist/sync without rolling back state */
     clearOperations(): void;
 };
+/**
+ * Snapshot serialization — returns a deep clone safe for JSON.stringify.
+ */
+export type SnapshotAccessor<T extends SmartObjectSchema> = {
+    toJSON(): z.infer<T>;
+};
 /**
  * Flattened data shape for union roots — exposes all variant keys on one surface.
  */
 export type UnionDataShape<U> = {
     [K in AllKeys<U>]: U extends unknown ? (K extends keyof U ? U[K] : never) : never;
 };
+type ObjectLikeSchema<T extends SmartObjectSchema> = T extends z.ZodObject | z.ZodIntersection | z.ZodLazy ? z.infer<T> : never;
+type UnionRootExtras<T extends SmartObjectSchema> = T extends z.ZodDiscriminatedUnion<infer _Options, infer Discriminator extends string> ? DiscriminatedVariantSwitchMethods<z.infer<T>, Discriminator> : T extends z.ZodUnion ? VariantSwitchMethods<z.infer<T>> : Record<string, never>;
+type ObjectRootExtras<T extends SmartObjectSchema> = T extends z.ZodObject ? RecordFieldMethods<z.infer<T>> : T extends z.ZodIntersection | z.ZodLazy ? RecordFieldMethods<ObjectLikeSchema<T>> : Record<string, never>;
 /**
  * Full instance contract: validated data shape, typed mutators, and patch log.
  *
  * Intersection types merge these concerns into one consumable surface for callers.
  */
-export type SmartObjectInstance<T extends SmartObjectSchema> = (T extends z.ZodObject ? z.infer<T> : UnionDataShape<z.infer<T>>) & (T extends z.ZodObject ? SetMethods<z.infer<T>> : SetMethodsUnion<z.infer<T>>) & OperationsAccessor;
+export type SmartObjectInstance<T extends SmartObjectSchema> = (T extends z.ZodObject ? z.infer<T> : T extends z.ZodIntersection | z.ZodLazy ? z.infer<T> : UnionDataShape<z.infer<T>>) & (T extends z.ZodObject | z.ZodIntersection | z.ZodLazy ? SetMethods<z.infer<T>> : SetMethodsUnion<z.infer<T>>) & ObjectRootExtras<T> & UnionRootExtras<T> & OperationsAccessor & SnapshotAccessor<T>;
 /**
  * Constructor type for a SmartObject class, including replay as a first-class capability.
  *

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,qBAAqB,GAAG,CAAC,CAAC,QAAQ,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;KACzB,CAAC,IAAI,MAAM,CAAC,IAAI,MAAM,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;CACxE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;KAC9B,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,GAAG,CACnD,KAAK,EAAE,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,KAClE,IAAI;CACV,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,8EAA8E;IAC9E,eAAe,IAAI,IAAI,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;KAC7B,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK;CAClF,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,GACjF,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GACV,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAC7B,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAC9E,kBAAkB,CAAC;AAErB;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,iBAAiB,IAAI;IAChE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACnD,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;CAClG,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/zod-introspect.d.ts

@@ -0,0 +1,50 @@
+import type { z } from "zod";
+import type { SmartObjectSchema } from "./types.js";
+export type ZodObjectLike = z.ZodObject;
+export type ZodUnionRootLike = z.ZodUnion;
+export type ZodDiscriminatedUnionLike = z.ZodDiscriminatedUnion;
+export type ZodIntersectionLike = z.ZodIntersection;
+export type ZodLazyLike = z.ZodLazy;
+export type DiscriminatedVariantInfo = {
+    tag: string | number | boolean;
+    schema: ZodObjectLike;
+    methodName: string;
+};
+export type RecordFieldInfo = {
+    fieldName: string;
+    fieldSchema: z.ZodType;
+    valueSchema: z.ZodType;
+    storage: "record" | "map";
+};
+export declare function isZodObject(schema: unknown): schema is ZodObjectLike;
+export declare function isZodUnionRoot(schema: SmartObjectSchema): schema is ZodUnionRootLike;
+export declare function isZodDiscriminatedUnion(schema: ZodUnionRootLike): schema is ZodDiscriminatedUnionLike;
+export declare function isZodUnionOfObjects(schema: ZodUnionRootLike): boolean;
+export declare function getObjectShapeKeys(schema: ZodObjectLike): string[];
+export declare function getUnionObjectKeys(schema: ZodUnionRootLike): string[];
+export declare function getDiscriminator(schema: ZodDiscriminatedUnionLike): string;
+export declare function toSetterMethodName(key: string): string;
+export declare function toVariantSwitchMethodName(tag: string | number | boolean): string;
+export declare function toRecordEntryMethodPrefix(fieldName: string): string;
+export declare function getLiteralValue(schema: unknown): string | number | boolean | undefined;
+export declare function getDiscriminatedVariants(schema: ZodDiscriminatedUnionLike): DiscriminatedVariantInfo[];
+export declare function isZodRecord(schema: unknown): schema is z.ZodRecord;
+export declare function isZodDate(schema: unknown): boolean;
+export declare function isZodMap(schema: unknown): schema is z.ZodMap;
+export declare function isZodSet(schema: unknown): schema is z.ZodSet;
+export declare function isZodBigInt(schema: unknown): boolean;
+export declare function isStringKeyMap(schema: unknown): schema is z.ZodMap;
+export declare function unwrapFieldSchema(schema: z.ZodType): z.ZodType;
+/** @deprecated Use unwrapFieldSchema */
+export declare function unwrapOptionalNullable(schema: z.ZodType): z.ZodType;
+export declare function isZodIntersection(schema: SmartObjectSchema): schema is ZodIntersectionLike;
+export declare function isZodLazy(schema: SmartObjectSchema): schema is ZodLazyLike;
+export declare function resolveLazySchema(schema: SmartObjectSchema): SmartObjectSchema;
+export declare function getRecordFields(schema: ZodObjectLike): RecordFieldInfo[];
+export declare function getRecordFieldsFromSchema(schema: SmartObjectSchema): RecordFieldInfo[];
+export declare function getMergedObjectShape(schema: SmartObjectSchema): Record<string, z.ZodType>;
+export declare function getSchemaShapeKeys(schema: SmartObjectSchema): string[];
+export declare function getFieldSchema(schema: SmartObjectSchema, key: string): z.ZodType | undefined;
+export declare function getObjectSchemaForFields(schema: SmartObjectSchema): ZodObjectLike | undefined;
+export declare function isObjectLikeRoot(schema: SmartObjectSchema): boolean;
+//# sourceMappingURL=zod-introspect.d.ts.map

package/dist/zod-introspect.d.ts.map

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

package/dist/zod-introspect.js

@@ -0,0 +1,252 @@
+export function isZodObject(schema) {
+    return (typeof schema === "object" &&
+        schema !== null &&
+        "_zod" in schema &&
+        schema._zod.def.type === "object");
+}
+export function isZodUnionRoot(schema) {
+    return schema._zod.def.type === "union";
+}
+export function isZodDiscriminatedUnion(schema) {
+    return "discriminator" in schema._zod.def;
+}
+export function isZodUnionOfObjects(schema) {
+    return schema.options.length > 0 && schema.options.every(isZodObject);
+}
+export function getObjectShapeKeys(schema) {
+    return Object.keys(schema.shape);
+}
+export function getUnionObjectKeys(schema) {
+    const keys = new Set();
+    for (const option of schema.options) {
+        if (!isZodObject(option)) {
+            continue;
+        }
+        for (const key of Object.keys(option.shape)) {
+            keys.add(key);
+        }
+    }
+    return [...keys];
+}
+export function getDiscriminator(schema) {
+    return schema._zod.def.discriminator;
+}
+export function toSetterMethodName(key) {
+    return `set${key.charAt(0).toUpperCase()}${key.slice(1)}`;
+}
+export function toVariantSwitchMethodName(tag) {
+    const label = typeof tag === "string" ? tag : String(tag);
+    return `switchTo${label.charAt(0).toUpperCase()}${label.slice(1)}`;
+}
+export function toRecordEntryMethodPrefix(fieldName) {
+    return fieldName.charAt(0).toUpperCase() + fieldName.slice(1);
+}
+export function getLiteralValue(schema) {
+    if (typeof schema !== "object" || schema === null || !("_zod" in schema)) {
+        return undefined;
+    }
+    const def = schema._zod.def;
+    if (def.type === "literal" && Array.isArray(def.values) && def.values.length === 1) {
+        const value = def.values[0];
+        if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+            return value;
+        }
+    }
+    return undefined;
+}
+export function getDiscriminatedVariants(schema) {
+    const discriminator = getDiscriminator(schema);
+    const variants = [];
+    for (const option of schema.options) {
+        if (!isZodObject(option)) {
+            continue;
+        }
+        const tagSchema = option.shape[discriminator];
+        const tag = getLiteralValue(tagSchema);
+        if (tag === undefined) {
+            continue;
+        }
+        variants.push({
+            tag,
+            schema: option,
+            methodName: toVariantSwitchMethodName(tag),
+        });
+    }
+    return variants;
+}
+export function isZodRecord(schema) {
+    return (typeof schema === "object" &&
+        schema !== null &&
+        "_zod" in schema &&
+        schema._zod.def.type === "record");
+}
+export function isZodDate(schema) {
+    if (typeof schema !== "object" || schema === null || !("_zod" in schema)) {
+        return false;
+    }
+    const def = schema._zod.def;
+    return def.type === "date";
+}
+export function isZodMap(schema) {
+    return (typeof schema === "object" &&
+        schema !== null &&
+        "_zod" in schema &&
+        schema._zod.def.type === "map");
+}
+export function isZodSet(schema) {
+    return (typeof schema === "object" &&
+        schema !== null &&
+        "_zod" in schema &&
+        schema._zod.def.type === "set");
+}
+export function isZodBigInt(schema) {
+    if (typeof schema !== "object" || schema === null || !("_zod" in schema)) {
+        return false;
+    }
+    return schema._zod.def.type === "bigint";
+}
+export function isStringKeyMap(schema) {
+    if (!isZodMap(schema)) {
+        return false;
+    }
+    const keyType = unwrapFieldSchema(schema._zod.def.keyType);
+    return keyType._zod.def.type === "string";
+}
+export function unwrapFieldSchema(schema) {
+    const def = schema._zod.def;
+    if (def.type === "optional" || def.type === "nullable" || def.type === "default") {
+        return unwrapFieldSchema(def.innerType);
+    }
+    if (def.type === "lazy") {
+        return unwrapFieldSchema(def.getter?.());
+    }
+    if (def.type === "pipe") {
+        const outType = def.out?._zod.def.type;
+        if (outType === "transform") {
+            return unwrapFieldSchema(def.in);
+        }
+        return unwrapFieldSchema(def.out);
+    }
+    return schema;
+}
+/** @deprecated Use unwrapFieldSchema */
+export function unwrapOptionalNullable(schema) {
+    return unwrapFieldSchema(schema);
+}
+export function isZodIntersection(schema) {
+    return schema._zod.def.type === "intersection";
+}
+export function isZodLazy(schema) {
+    return schema._zod.def.type === "lazy";
+}
+export function resolveLazySchema(schema) {
+    if (isZodLazy(schema)) {
+        return resolveLazySchema(schema._zod.def.getter());
+    }
+    return schema;
+}
+function collectEntryField(fieldName, fieldSchema, unwrapped) {
+    if (isZodRecord(unwrapped)) {
+        return {
+            fieldName,
+            fieldSchema,
+            valueSchema: unwrapped._zod.def.valueType,
+            storage: "record",
+        };
+    }
+    if (isStringKeyMap(unwrapped)) {
+        return {
+            fieldName,
+            fieldSchema,
+            valueSchema: unwrapped._zod.def.valueType,
+            storage: "map",
+        };
+    }
+    return undefined;
+}
+export function getRecordFields(schema) {
+    const fields = [];
+    for (const [fieldName, fieldSchema] of Object.entries(schema.shape)) {
+        const unwrapped = unwrapFieldSchema(fieldSchema);
+        const entryField = collectEntryField(fieldName, fieldSchema, unwrapped);
+        if (entryField) {
+            fields.push(entryField);
+        }
+    }
+    return fields;
+}
+export function getRecordFieldsFromSchema(schema) {
+    const resolved = resolveLazySchema(schema);
+    if (isZodObject(resolved)) {
+        return getRecordFields(resolved);
+    }
+    if (isZodIntersection(resolved)) {
+        const left = resolved._zod.def.left;
+        const right = resolved._zod.def.right;
+        return [...getRecordFieldsFromSchema(left), ...getRecordFieldsFromSchema(right)];
+    }
+    return [];
+}
+export function getMergedObjectShape(schema) {
+    const resolved = resolveLazySchema(schema);
+    if (isZodObject(resolved)) {
+        return resolved.shape;
+    }
+    if (isZodIntersection(resolved)) {
+        const left = resolved._zod.def.left;
+        const right = resolved._zod.def.right;
+        return {
+            ...getMergedObjectShape(left),
+            ...getMergedObjectShape(right),
+        };
+    }
+    return {};
+}
+export function getSchemaShapeKeys(schema) {
+    const resolved = resolveLazySchema(schema);
+    if (isZodObject(resolved)) {
+        return getObjectShapeKeys(resolved);
+    }
+    if (isZodUnionRoot(resolved)) {
+        return getUnionObjectKeys(resolved);
+    }
+    if (isZodIntersection(resolved)) {
+        const left = resolved._zod.def.left;
+        const right = resolved._zod.def.right;
+        return [...new Set([...getSchemaShapeKeys(left), ...getSchemaShapeKeys(right)])];
+    }
+    return [];
+}
+export function getFieldSchema(schema, key) {
+    const resolved = resolveLazySchema(schema);
+    if (isZodObject(resolved)) {
+        return resolved.shape[key];
+    }
+    if (isZodIntersection(resolved)) {
+        const left = resolved._zod.def.left;
+        const right = resolved._zod.def.right;
+        return getFieldSchema(left, key) ?? getFieldSchema(right, key);
+    }
+    return undefined;
+}
+export function getObjectSchemaForFields(schema) {
+    const resolved = resolveLazySchema(schema);
+    if (isZodObject(resolved)) {
+        return resolved;
+    }
+    if (isZodIntersection(resolved)) {
+        const left = resolved._zod.def.left;
+        const right = resolved._zod.def.right;
+        const leftObject = getObjectSchemaForFields(left);
+        const rightObject = getObjectSchemaForFields(right);
+        if (leftObject && rightObject) {
+            return leftObject;
+        }
+        return leftObject ?? rightObject;
+    }
+    return undefined;
+}
+export function isObjectLikeRoot(schema) {
+    const resolved = resolveLazySchema(schema);
+    return isZodObject(resolved) || isZodIntersection(resolved);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gialicus/smart-object",
-  "version": "1.0.0",
+  "version": "2.0.1",
   "description": "Oggetti TypeScript generati da schemi Zod con getter, set* tipizzati e operazioni JSON Patch",
   "type": "module",
   "main": "./dist/index.js",

package/dist/smart-object.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"smart-object.d.ts","sourceRoot":"","sources":["../src/smart-object.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,sBAAsB,EAA0C,MAAM,YAAY,CAAC;AAsMjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC;AAC5F,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,qBAAqB,EAC3D,SAAS,EAAE,CAAC,GACX,sBAAsB,CAAC,CAAC,CAAC,CAAC;AAC7B,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAAC"}

package/dist/smart-object.js

@@ -1,157 +0,0 @@
-import jsonPatch from "fast-json-patch";
-const { applyPatch, compare, deepClone } = jsonPatch;
-function isZodObject(schema) {
-    return (typeof schema === "object" &&
-        schema !== null &&
-        "_zod" in schema &&
-        schema._zod.def.type === "object");
-}
-function isZodUnionRoot(schema) {
-    return schema._zod.def.type === "union";
-}
-function isZodDiscriminatedUnion(schema) {
-    return "discriminator" in schema._zod.def;
-}
-function isZodUnionOfObjects(schema) {
-    return schema.options.length > 0 && schema.options.every(isZodObject);
-}
-function getObjectShapeKeys(schema) {
-    return Object.keys(schema.shape);
-}
-function getUnionObjectKeys(schema) {
-    const keys = new Set();
-    for (const option of schema.options) {
-        if (!isZodObject(option)) {
-            continue;
-        }
-        for (const key of Object.keys(option.shape)) {
-            keys.add(key);
-        }
-    }
-    return [...keys];
-}
-function buildSmartObjectClass(zodSchema) {
-    const keys = isZodObject(zodSchema)
-        ? getObjectShapeKeys(zodSchema)
-        : getUnionObjectKeys(zodSchema);
-    class SmartObjectClass {
-        #data;
-        #operations = [];
-        static fromOperations(initial, operations) {
-            const instance = new SmartObjectClass(initial);
-            instance.#applyOperations(operations);
-            return instance;
-        }
-        #applyOperations(operations) {
-            if (operations.length === 0) {
-                return;
-            }
-            applyPatch(this.#data, operations, false, true);
-            this.#operations.push(...operations);
-        }
-        get operations() {
-            return this.#operations;
-        }
-        clearOperations() {
-            this.#operations.length = 0;
-        }
-        constructor(initial) {
-            for (const key of keys) {
-                const setMethodName = `set${key.charAt(0).toUpperCase()}${key.slice(1)}`;
-                Object.defineProperty(this, key, {
-                    get: () => this.#data[key],
-                    enumerable: true,
-                    configurable: true,
-                });
-                Object.defineProperty(this, setMethodName, {
-                    value: isZodObject(zodSchema)
-                        ? this.#createObjectFieldSetter(zodSchema, key)
-                        : this.#createUnionFieldSetter(zodSchema, key),
-                    enumerable: false,
-                    configurable: true,
-                    writable: true,
-                });
-            }
-            this.#data = zodSchema.parse(initial ?? {});
-        }
-        #createObjectFieldSetter(schema, key) {
-            const fieldSchema = schema.shape[key];
-            return (value) => {
-                const parsed = fieldSchema.parse(value);
-                const beforeData = deepClone(this.#data);
-                const afterData = { ...deepClone(this.#data), [key]: parsed };
-                const patch = compare(beforeData, afterData);
-                if (patch.length === 0) {
-                    return;
-                }
-                applyPatch(this.#data, patch, false, true);
-                this.#operations.push(...patch);
-            };
-        }
-        #getActiveVariantViaDiscriminator(schema, data) {
-            const discriminator = schema._zod.def.discriminator;
-            const tag = data[discriminator];
-            for (const option of schema.options) {
-                if (!isZodObject(option)) {
-                    continue;
-                }
-                const tagSchema = option.shape[discriminator];
-                if (tagSchema?.safeParse(tag).success) {
-                    return option;
-                }
-            }
-            return undefined;
-        }
-        #getMatchingVariantObjects(schema) {
-            if (isZodDiscriminatedUnion(schema)) {
-                const activeVariant = this.#getActiveVariantViaDiscriminator(schema, this.#data);
-                return activeVariant ? [activeVariant] : [];
-            }
-            return schema.options
-                .filter(isZodObject)
-                .filter((option) => option.safeParse(this.#data).success);
-        }
-        #assertKeyAllowedOnMatchingVariants(matchingVariants, key) {
-            if (matchingVariants.length === 0) {
-                throw new Error("Cannot set field on invalid union state");
-            }
-            if (matchingVariants.length === 1) {
-                if (!(key in matchingVariants[0].shape)) {
-                    throw new Error(`Cannot set "${key}" on the active union variant`);
-                }
-                return;
-            }
-            if (!matchingVariants.some((variant) => key in variant.shape)) {
-                throw new Error(`Cannot set "${key}" on the active union variant`);
-            }
-        }
-        #createUnionFieldSetter(schema, key) {
-            return (value) => {
-                const matchingVariants = this.#getMatchingVariantObjects(schema);
-                this.#assertKeyAllowedOnMatchingVariants(matchingVariants, key);
-                const beforeData = deepClone(this.#data);
-                const candidate = { ...deepClone(this.#data), [key]: value };
-                const parsed = schema.parse(candidate);
-                const patch = compare(beforeData, parsed);
-                if (patch.length === 0) {
-                    return;
-                }
-                this.#data = parsed;
-                this.#operations.push(...patch);
-            };
-        }
-    }
-    return SmartObjectClass;
-}
-export function SmartObject(zodSchema) {
-    if (isZodObject(zodSchema)) {
-        return buildSmartObjectClass(zodSchema);
-    }
-    if (isZodUnionRoot(zodSchema)) {
-        if (!isZodUnionOfObjects(zodSchema)) {
-            throw new TypeError("SmartObject union root requires all options to be z.object(...)");
-        }
-        return buildSmartObjectClass(zodSchema);
-    }
-    throw new TypeError("SmartObject requires a z.object(...), z.union([...]), or z.discriminatedUnion(...) schema");
-}