@gialicus/smart-object 1.0.0 → 2.0.0

package/CHANGELOG.md

@@ -5,14 +5,39 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.0] - 2026-06-27
+
+### Breaking
+
+- Getters for object and array fields always return deep clones; in-place mutation no longer affects internal state
+- Removed `SmartObjectOptions` and the `immutableReads` factory option
+- `operations` getter returns a defensive copy instead of the internal array reference
+
+### Added
+
+- `toJSON()` instance method for deep-cloned, JSON-safe snapshots (also used by `JSON.stringify`)
+- `SmartObjectError` with structured `code`, optional `field`, and `cause` for programmatic error handling
+- Zod schema introspection isolated in `src/zod-introspect.ts`
+- CI matrix job testing Zod peer compatibility (`4.0.0` and `latest`)
+
+### Changed
+
+- Getter and setter methods are defined on the class prototype (one definition per schema, not per instance)
+- Object field setters use a single `deepClone` per write instead of two
+- `fromOperations` re-validates state with Zod after applying patches; invalid replay throws `SmartObjectError` and rolls back
+- Setter and union validation errors throw `SmartObjectError` instead of generic `Error`
+- Unsupported schema at factory time throws `SmartObjectError` with code `UnsupportedSchema`
+
 ## [1.0.0] - 2026-06-27
 
 ### Added
 
 - `SmartObject(schema)` factory: typed getters and `set*` methods generated from a Zod object schema
+- Support for `z.union([...])` and `z.discriminatedUnion(...)` at schema root
 - RFC 6902 operation log (`operations`) for every validated change
 - `clearOperations()` to reset the audit trail without rolling back state
 - `fromOperations(initial, operations)` static method for deterministic replay
-- Exported types: `Operation`, `SetMethods`, `OperationsAccessor`, `SmartObjectConstructor`, `SmartObjectInstance`
+- Exported types: `Operation`, `SetMethods`, `SetMethodsUnion`, `AllKeys`, `UnionDataShape`, `OperationsAccessor`, `SmartObjectConstructor`, `SmartObjectInstance`
 
+[2.0.0]: https://github.com/gialicus/smart-object/compare/v1.0.0...v2.0.0
 [1.0.0]: https://github.com/gialicus/smart-object/releases/tag/v1.0.0

package/README.md

@@ -23,7 +23,7 @@ const Person = SmartObject(z.object({
 
 const person = new Person({ name: "Mario", age: 30 });
 
-// Reads expose validated state without side effects
+// Reads expose validated state
 console.log(person.name); // "Mario"
 
 // Writes validate first, then append patches to person.operations
@@ -40,6 +40,9 @@ person.setName("Luigi"); // Unchanged value — no operation added (keeps sync p
 
 person.clearOperations(); // Drops the audit trail after persist/sync; state is unchanged
 
+// Snapshot for serialization — deep clone, safe for JSON.stringify
+console.log(person.toJSON());
+
 // Initial construction is the replay baseline — it never emits operations
 console.log(new Person({ name: "Mario", age: 30 }).operations); // []
 
@@ -48,37 +51,66 @@ const initial = { name: "Mario", age: 30 };
 const person2 = Person.fromOperations(initial, [...person.operations]);
 ```
 
+### Union root schemas
+
+`SmartObject` also accepts `z.discriminatedUnion(...)` and `z.union([...])` when every option is a `z.object(...)`:
+
+```typescript
+const Event = SmartObject(z.discriminatedUnion("type", [
+    z.object({ type: z.literal("click"), x: z.number(), y: z.number() }),
+    z.object({ type: z.literal("scroll"), delta: z.number() }),
+]));
+
+const event = new Event({ type: "click", x: 10, y: 20 });
+event.setX(15);
+```
+
+See [`examples/event.ts`](examples/event.ts) and [`examples/profile.ts`](examples/profile.ts) for full demos.
+
+Object and array getters always return deep clones — in-place mutation does not affect internal state or the operation log. Only `set*` methods generate RFC 6902 operations.
+
 ## API
 
 ### `SmartObject(schema)`
 
-Factory that accepts a `z.object(...)` and returns an instantiable class.
+Factory that accepts a Zod schema and returns an instantiable class.
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `schema` | `z.ZodObject` | Zod schema defining the object shape |
+| `schema` | `z.ZodObject` \| `z.ZodUnion` \| `z.ZodDiscriminatedUnion` | Zod schema defining the object shape |
 
 **Members generated for each schema field `foo`:**
 
 | Member | Type | Description |
 |--------|------|-------------|
-| `foo` | getter | Exposes the current validated field value |
+| `foo` | getter | Exposes the current validated field value (deep clone for objects and arrays) |
 | `setFoo(value)` | `(value: T) => void` | Validates, updates state, and records patches only when the value actually changes |
 
+`set*` method names follow camelCase with the field name capitalized (`name` → `setName`, `userId` → `setUserId`).
+
 **Instance members:**
 
 | Member | Type | Description |
 |--------|------|-------------|
-| `operations` | `readonly Operation[]` | Chronological RFC 6902 patch log |
+| `operations` | `readonly Operation[]` | Chronological RFC 6902 patch log (defensive copy) |
 | `clearOperations()` | `() => void` | Clears the patch log without rolling back state |
-
-`set*` method names follow camelCase with the field name capitalized (`name` → `setName`, `address` → `setAddress`).
+| `toJSON()` | `() => T` | Deep clone of current state, safe for `JSON.stringify` |
 
 **Static members:**
 
 | Member | Type | Description |
 |--------|------|-------------|
-| `fromOperations(initial, operations)` | `(initial, Operation[]) => Instance` | Builds an instance from a baseline, replays operations, and copies them into the accumulator |
+| `fromOperations(initial, operations)` | `(initial, Operation[]) => Instance` | Builds an instance from a baseline, replays and validates operations, and copies them into the accumulator |
+
+### `SmartObjectError`
+
+Structured error thrown on validation failures, invalid union field access, and failed replay:
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `code` | `"InvalidValue"` \| `"InvalidUnionField"` \| `"InvalidReplay"` \| `"UnsupportedSchema"` | Error category |
+| `field` | `string` \| `undefined` | Schema field path when applicable |
+| `cause` | `unknown` | Original error (e.g. `ZodError`) |
 
 ### `Operation`
 
@@ -93,8 +125,19 @@ RFC 6902 operation emitted by [fast-json-patch](https://github.com/Starcounter-J
 
 - `Operation` — JSON Patch operation (re-export from `fast-json-patch`)
 - `SetMethods<T>` — mapped type of inferred `set*` methods for shape `T`
+- `SetMethodsUnion<T>` — `set*` methods for union root schemas
+- `AllKeys<T>` — all keys across union members
+- `UnionDataShape<U>` — flattened data shape for union roots
 - `OperationsAccessor` — `operations` and `clearOperations()`
+- `SnapshotAccessor<T>` — `toJSON()`
 - `SmartObjectConstructor<T>` — constructor type including `fromOperations`
+- `SmartObjectInstance<T>` — full instance type (getters + set* + operations + toJSON)
+
+## Limitations
+
+- **Partial variant switch** — Changing a discriminated union discriminator alone (e.g. `setType("scroll")` without providing `delta`) is not supported and throws `SmartObjectError`.
+- **Union field on wrong variant** — Setting a field that does not exist on the active variant throws `SmartObjectError`.
+- **JSON-only values** — RFC 6902 patches work on JSON-serializable data. `Date`, `Map`, and other non-JSON types are not supported.
 
 ## Design rationale
 
@@ -103,25 +146,60 @@ RFC 6902 operation emitted by [fast-json-patch](https://github.com/Starcounter-J
 3. **No-op writes** — Identical values are skipped to keep the patch log minimal and suitable for network sync.
 4. **Patch-based updates** — Changes are expressed as RFC 6902 operations so deltas are standard, composable, and replayable.
 5. **Operation accumulation** — Patches from `compare` are appended in order, preserving causality for audit and replay.
-6. **Replay** — `fromOperations(initial, operations)` requires the same baseline used when the operations were produced, enabling deterministic reconstruction on another client or after persistence.
-
-- `SmartObjectInstance<T>` — full instance type (getters + set* + operations)
+6. **Replay** — `fromOperations(initial, operations)` replays patches, re-validates with Zod, and requires the same baseline used when the operations were produced.
 
-## Full example
+## Examples
 
-See [`examples/person.ts`](examples/person.ts) for a demo with primitives, nested objects, and arrays.
+- [`examples/person.ts`](examples/person.ts) — primitives, nested objects, and arrays
+- [`examples/event.ts`](examples/event.ts) — discriminated union root
+- [`examples/profile.ts`](examples/profile.ts) — generic union root
 
 ## Project structure
 
 ```
 smart-object/
 ├── src/
-│   ├── index.ts          # Public API barrel export
-│   ├── smart-object.ts   # SmartObject factory
-│   └── types.ts          # Operation and inferred types
+│   ├── index.ts              # Public API barrel export
+│   ├── types.ts              # Operation and inferred types
+│   ├── errors.ts             # SmartObjectError
+│   ├── zod-introspect.ts     # Zod schema introspection
+│   └── smart-object/
+│       ├── index.ts          # Re-export SmartObject
+│       ├── factory.ts        # Public SmartObject() factory
+│       ├── build-class.ts    # Class generation orchestration
+│       ├── instance-state.ts # WeakMap-backed instance storage
+│       ├── read-field.ts     # Defensive getter reads
+│       ├── json-patch.ts     # fast-json-patch wrapper
+│       ├── apply-operations.ts # Replay and rollback
+│       ├── union-variant.ts  # Union variant matching
+│       ├── define-prototype.ts # Getter/setter prototype setup
+│       └── setters/
+│           ├── object-field.ts
+│           └── union-field.ts
 ├── examples/
-│   └── person.ts         # Usage demo
+│   ├── person.ts
+│   ├── event.ts
+│   └── profile.ts
 ├── tests/
-│   └── smart-object.test.ts
-└── dist/                 # Build output (generated)
+│   ├── fixtures/
+│   │   ├── person.ts
+│   │   ├── entity.ts
+│   │   ├── event.ts
+│   │   └── profile.ts
+│   ├── smart-object/
+│   │   ├── construction.test.ts
+│   │   ├── getters.test.ts
+│   │   ├── setters.test.ts
+│   │   ├── clear-operations.test.ts
+│   │   ├── from-operations.test.ts
+│   │   ├── union-fields.test.ts
+│   │   ├── discriminated-union-root.test.ts
+│   │   ├── generic-union-root.test.ts
+│   │   ├── robustness.test.ts
+│   │   ├── setter-naming.test.ts
+│   │   ├── to-json.test.ts
+│   │   ├── schema-variants.test.ts
+│   │   └── types.test.ts
+│   └── zod-introspect.test.ts
+└── dist/                     # Build output (generated)
 ```

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+export type SmartObjectErrorCode = "InvalidValue" | "InvalidUnionField" | "InvalidReplay" | "UnsupportedSchema";
+/**
+ * Structured error for SmartObject operations — enables programmatic handling
+ * without parsing generic Error messages.
+ */
+export declare class SmartObjectError extends Error {
+    readonly code: SmartObjectErrorCode;
+    readonly field?: string;
+    readonly cause?: unknown;
+    constructor(code: SmartObjectErrorCode, message: string, options?: {
+        field?: string;
+        cause?: unknown;
+    });
+    static invalidValue(field: string, cause: unknown): SmartObjectError;
+    static invalidUnionField(field: string, message?: string): SmartObjectError;
+    static invalidUnionState(): SmartObjectError;
+    static invalidReplay(cause: unknown): SmartObjectError;
+    static unsupportedSchema(message: string): SmartObjectError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,mBAAmB,GACnB,eAAe,GACf,mBAAmB,CAAC;AAExB;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAGvB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;IAS/C,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,gBAAgB;IAapE,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB;IAQ3E,MAAM,CAAC,iBAAiB,IAAI,gBAAgB;IAI5C,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB;IAStD,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;CAG5D"}

package/dist/errors.js

@@ -0,0 +1,40 @@
+/**
+ * Structured error for SmartObject operations — enables programmatic handling
+ * without parsing generic Error messages.
+ */
+export class SmartObjectError extends Error {
+    code;
+    field;
+    cause;
+    constructor(code, message, options) {
+        super(message);
+        this.name = "SmartObjectError";
+        this.code = code;
+        this.field = options?.field;
+        this.cause = options?.cause;
+    }
+    static invalidValue(field, cause) {
+        if (cause instanceof SmartObjectError) {
+            return cause;
+        }
+        const message = cause instanceof Error && "issues" in cause
+            ? `Invalid value for "${field}": ${cause.issues.map((i) => i.message).join(", ")}`
+            : `Invalid value for "${field}"`;
+        return new SmartObjectError("InvalidValue", message, { field, cause });
+    }
+    static invalidUnionField(field, message) {
+        return new SmartObjectError("InvalidUnionField", message ?? `Cannot set "${field}" on the active union variant`, { field });
+    }
+    static invalidUnionState() {
+        return new SmartObjectError("InvalidUnionField", "Cannot set field on invalid union state");
+    }
+    static invalidReplay(cause) {
+        const message = cause instanceof Error
+            ? `Operation replay failed: ${cause.message}`
+            : "Operation replay failed";
+        return new SmartObjectError("InvalidReplay", message, { cause });
+    }
+    static unsupportedSchema(message) {
+        return new SmartObjectError("UnsupportedSchema", message);
+    }
+}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
-export { SmartObject } from "./smart-object.js";
-export type { AllKeys, Operation, OperationsAccessor, SetMethods, SetMethodsUnion, SmartObjectConstructor, SmartObjectInstance, SmartObjectSchema, UnionDataShape, } from "./types.js";
+export type { SmartObjectErrorCode } from "./errors.js";
+export { SmartObjectError } from "./errors.js";
+export { SmartObject } from "./smart-object/index.js";
+export type { AllKeys, Operation, OperationsAccessor, SetMethods, SetMethodsUnion, SmartObjectConstructor, SmartObjectInstance, SmartObjectSchema, SnapshotAccessor, UnionDataShape, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,OAAO,EACP,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,YAAY,EACV,OAAO,EACP,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1 +1,2 @@
-export { SmartObject } from "./smart-object.js";
+export { SmartObjectError } from "./errors.js";
+export { SmartObject } from "./smart-object/index.js";

package/dist/smart-object/apply-operations.d.ts

@@ -0,0 +1,5 @@
+import type { Operation } from "fast-json-patch";
+import type { SmartObjectSchema } from "../types.js";
+import type { InstanceState } from "./instance-state.js";
+export declare function applyOperations<T>(state: InstanceState<T>, zodSchema: SmartObjectSchema, instance: object, operations: Operation[]): void;
+//# sourceMappingURL=apply-operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply-operations.d.ts","sourceRoot":"","sources":["../../src/smart-object/apply-operations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,wBAAgB,eAAe,CAAC,CAAC,EAC/B,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,SAAS,EAAE,iBAAiB,EAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,SAAS,EAAE,GACtB,IAAI,CAiBN"}

package/dist/smart-object/apply-operations.js

@@ -0,0 +1,19 @@
+import { SmartObjectError } from "../errors.js";
+import { applyPatch, deepClone } from "./json-patch.js";
+export function applyOperations(state, zodSchema, instance, operations) {
+    if (operations.length === 0) {
+        return;
+    }
+    const data = state.getData(instance);
+    const snapshot = deepClone(data);
+    try {
+        applyPatch(data, operations, false, true);
+        const validated = zodSchema.parse(data);
+        state.setData(instance, validated);
+        state.getOperations(instance).push(...operations);
+    }
+    catch (cause) {
+        state.setData(instance, snapshot);
+        throw SmartObjectError.invalidReplay(cause);
+    }
+}

package/dist/smart-object/build-class.d.ts

@@ -0,0 +1,3 @@
+import type { SmartObjectConstructor, SmartObjectSchema } from "../types.js";
+export declare function buildSmartObjectClass<T extends SmartObjectSchema>(zodSchema: T): SmartObjectConstructor<T>;
+//# sourceMappingURL=build-class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build-class.d.ts","sourceRoot":"","sources":["../../src/smart-object/build-class.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAuB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOlG,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,iBAAiB,EAC/D,SAAS,EAAE,CAAC,GACX,sBAAsB,CAAC,CAAC,CAAC,CAuC3B"}

package/dist/smart-object/build-class.js

@@ -0,0 +1,33 @@
+import { getObjectShapeKeys, getUnionObjectKeys, isZodObject } from "../zod-introspect.js";
+import { applyOperations } from "./apply-operations.js";
+import { definePrototype } from "./define-prototype.js";
+import { createInstanceState } from "./instance-state.js";
+import { deepClone } from "./json-patch.js";
+export function buildSmartObjectClass(zodSchema) {
+    const keys = isZodObject(zodSchema)
+        ? getObjectShapeKeys(zodSchema)
+        : getUnionObjectKeys(zodSchema);
+    const state = createInstanceState();
+    class SmartObjectClass {
+        static fromOperations(initial, operations) {
+            const instance = new SmartObjectClass(initial);
+            applyOperations(state, zodSchema, instance, operations);
+            return instance;
+        }
+        get operations() {
+            return [...state.getOperations(this)];
+        }
+        clearOperations() {
+            state.getOperations(this).length = 0;
+        }
+        toJSON() {
+            return deepClone(state.getData(this));
+        }
+        constructor(initial) {
+            state.setData(this, zodSchema.parse(initial ?? {}));
+            state.initOperations(this);
+        }
+    }
+    definePrototype(SmartObjectClass.prototype, state, zodSchema, keys);
+    return SmartObjectClass;
+}

package/dist/smart-object/define-prototype.d.ts

@@ -0,0 +1,4 @@
+import type { SmartObjectSchema } from "../types.js";
+import type { InstanceState } from "./instance-state.js";
+export declare function definePrototype<T>(prototype: object, state: InstanceState<T>, zodSchema: SmartObjectSchema, keys: string[]): void;
+//# sourceMappingURL=define-prototype.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-prototype.d.ts","sourceRoot":"","sources":["../../src/smart-object/define-prototype.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKzD,wBAAgB,eAAe,CAAC,CAAC,EAC/B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,SAAS,EAAE,iBAAiB,EAC5B,IAAI,EAAE,MAAM,EAAE,GACb,IAAI,CAqBN"}

package/dist/smart-object/define-prototype.js

@@ -0,0 +1,24 @@
+import { isZodObject, toSetterMethodName, } from "../zod-introspect.js";
+import { readFieldValue } from "./read-field.js";
+import { createObjectFieldSetter } from "./setters/object-field.js";
+import { createUnionFieldSetter } from "./setters/union-field.js";
+export function definePrototype(prototype, state, zodSchema, keys) {
+    for (const key of keys) {
+        const setMethodName = toSetterMethodName(key);
+        Object.defineProperty(prototype, key, {
+            get() {
+                return readFieldValue(state.getData(this)[key]);
+            },
+            enumerable: true,
+            configurable: true,
+        });
+        Object.defineProperty(prototype, setMethodName, {
+            value: isZodObject(zodSchema)
+                ? createObjectFieldSetter(state, zodSchema, key)
+                : createUnionFieldSetter(state, zodSchema, key),
+            enumerable: false,
+            configurable: true,
+            writable: true,
+        });
+    }
+}

package/dist/{smart-object.d.ts → smart-object/factory.d.ts}

@@ -1,5 +1,5 @@
 import type { z } from "zod";
-import type { SmartObjectConstructor } from "./types.js";
+import type { SmartObjectConstructor } from "../types.js";
 /**
  * Builds a typed SmartObject class from a Zod schema.
  *
@@ -33,4 +33,4 @@ import type { SmartObjectConstructor } from "./types.js";
 export declare function SmartObject<T extends z.ZodObject>(zodSchema: T): SmartObjectConstructor<T>;
 export declare function SmartObject<T extends z.ZodDiscriminatedUnion>(zodSchema: T): SmartObjectConstructor<T>;
 export declare function SmartObject<T extends z.ZodUnion>(zodSchema: T): SmartObjectConstructor<T>;
-//# sourceMappingURL=smart-object.d.ts.map
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/smart-object/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,sBAAsB,EAAqB,MAAM,aAAa,CAAC;AAI7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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/factory.js

@@ -0,0 +1,15 @@
+import { SmartObjectError } from "../errors.js";
+import { isZodObject, isZodUnionOfObjects, isZodUnionRoot } from "../zod-introspect.js";
+import { buildSmartObjectClass } from "./build-class.js";
+export function SmartObject(zodSchema) {
+    if (isZodObject(zodSchema)) {
+        return buildSmartObjectClass(zodSchema);
+    }
+    if (isZodUnionRoot(zodSchema)) {
+        if (!isZodUnionOfObjects(zodSchema)) {
+            throw SmartObjectError.unsupportedSchema("SmartObject union root requires all options to be z.object(...)");
+        }
+        return buildSmartObjectClass(zodSchema);
+    }
+    throw SmartObjectError.unsupportedSchema("SmartObject requires a z.object(...), z.union([...]), or z.discriminatedUnion(...) schema");
+}

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

@@ -0,0 +1,2 @@
+export { SmartObject } from "./factory.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/smart-object/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/smart-object/index.js

@@ -0,0 +1 @@
+export { SmartObject } from "./factory.js";

package/dist/smart-object/instance-state.d.ts

@@ -0,0 +1,9 @@
+import type { Operation } from "fast-json-patch";
+export type InstanceState<T> = {
+    getData(instance: object): T;
+    setData(instance: object, data: T): void;
+    getOperations(instance: object): Operation[];
+    initOperations(instance: object): void;
+};
+export declare function createInstanceState<T>(): InstanceState<T>;
+//# sourceMappingURL=instance-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instance-state.d.ts","sourceRoot":"","sources":["../../src/smart-object/instance-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAC7B,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACzC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAC7C,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,CA0BzD"}

package/dist/smart-object/instance-state.js

@@ -0,0 +1,23 @@
+export function createInstanceState() {
+    const instanceData = new WeakMap();
+    const instanceOperations = new WeakMap();
+    return {
+        getData(instance) {
+            return instanceData.get(instance);
+        },
+        setData(instance, data) {
+            instanceData.set(instance, data);
+        },
+        getOperations(instance) {
+            let operations = instanceOperations.get(instance);
+            if (!operations) {
+                operations = [];
+                instanceOperations.set(instance, operations);
+            }
+            return operations;
+        },
+        initOperations(instance) {
+            instanceOperations.set(instance, []);
+        },
+    };
+}

package/dist/smart-object/json-patch.d.ts

@@ -0,0 +1,3 @@
+import jsonPatch from "fast-json-patch";
+export declare const applyPatch: typeof jsonPatch.applyPatch, compare: typeof jsonPatch.compare, deepClone: typeof jsonPatch.deepClone;
+//# sourceMappingURL=json-patch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json-patch.d.ts","sourceRoot":"","sources":["../../src/smart-object/json-patch.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,iBAAiB,CAAC;AAExC,eAAO,MAAQ,UAAU,+BAAE,OAAO,4BAAE,SAAS,4BAAc,CAAC"}

package/dist/smart-object/json-patch.js

@@ -0,0 +1,2 @@
+import jsonPatch from "fast-json-patch";
+export const { applyPatch, compare, deepClone } = jsonPatch;

package/dist/smart-object/read-field.d.ts

@@ -0,0 +1,2 @@
+export declare function readFieldValue(value: unknown): unknown;
+//# sourceMappingURL=read-field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-field.d.ts","sourceRoot":"","sources":["../../src/smart-object/read-field.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMtD"}

package/dist/smart-object/read-field.js

@@ -0,0 +1,7 @@
+import { deepClone } from "./json-patch.js";
+export function readFieldValue(value) {
+    if (typeof value === "object" && value !== null) {
+        return deepClone(value);
+    }
+    return value;
+}

package/dist/smart-object/setters/object-field.d.ts

@@ -0,0 +1,4 @@
+import type { ZodObjectLike } from "../../zod-introspect.js";
+import type { InstanceState } from "../instance-state.js";
+export declare function createObjectFieldSetter<T>(state: InstanceState<T>, schema: ZodObjectLike, key: string): (this: object, value: unknown) => void;
+//# sourceMappingURL=object-field.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"object-field.d.ts","sourceRoot":"","sources":["../../../src/smart-object/setters/object-field.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,MAAM,IAIM,MAAM,MAAM,EAAE,OAAO,OAAO,UAsB9C"}

package/dist/smart-object/setters/object-field.js

@@ -0,0 +1,24 @@
+import { SmartObjectError } from "../../errors.js";
+import { applyPatch, compare, deepClone } from "../json-patch.js";
+export function createObjectFieldSetter(state, schema, key) {
+    const fieldSchema = schema.shape[key];
+    return function (value) {
+        let parsed;
+        try {
+            parsed = fieldSchema.parse(value);
+        }
+        catch (cause) {
+            throw SmartObjectError.invalidValue(key, cause);
+        }
+        const data = state.getData(this);
+        const beforeData = deepClone(data);
+        const afterData = deepClone(data);
+        afterData[key] = parsed;
+        const patch = compare(beforeData, afterData);
+        if (patch.length === 0) {
+            return;
+        }
+        applyPatch(data, patch, false, true);
+        state.getOperations(this).push(...patch);
+    };
+}

package/dist/smart-object/setters/union-field.d.ts

@@ -0,0 +1,4 @@
+import type { ZodUnionRootLike } from "../../zod-introspect.js";
+import type { InstanceState } from "../instance-state.js";
+export declare function createUnionFieldSetter<T>(state: InstanceState<T>, schema: ZodUnionRootLike, key: string): (this: object, value: unknown) => void;
+//# sourceMappingURL=union-field.d.ts.map

package/dist/smart-object/setters/union-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"union-field.d.ts","sourceRoot":"","sources":["../../../src/smart-object/setters/union-field.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,MAAM,IAEM,MAAM,MAAM,EAAE,OAAO,OAAO,UAyB9C"}

package/dist/smart-object/setters/union-field.js

@@ -0,0 +1,25 @@
+import { SmartObjectError } from "../../errors.js";
+import { compare, deepClone } from "../json-patch.js";
+import { assertKeyAllowedOnMatchingVariants, getMatchingVariantObjects } from "../union-variant.js";
+export function createUnionFieldSetter(state, schema, key) {
+    return function (value) {
+        const matchingVariants = getMatchingVariantObjects(state, this, schema);
+        assertKeyAllowedOnMatchingVariants(matchingVariants, key);
+        const data = state.getData(this);
+        const beforeData = deepClone(data);
+        const candidate = { ...deepClone(data), [key]: value };
+        let parsed;
+        try {
+            parsed = schema.parse(candidate);
+        }
+        catch (cause) {
+            throw SmartObjectError.invalidValue(key, cause);
+        }
+        const patch = compare(beforeData, parsed);
+        if (patch.length === 0) {
+            return;
+        }
+        state.setData(this, parsed);
+        state.getOperations(this).push(...patch);
+    };
+}

package/dist/smart-object/union-variant.d.ts

@@ -0,0 +1,5 @@
+import { type ZodObjectLike, type ZodUnionRootLike } from "../zod-introspect.js";
+import type { InstanceState } from "./instance-state.js";
+export declare function getMatchingVariantObjects<T>(state: InstanceState<T>, instance: object, schema: ZodUnionRootLike): ZodObjectLike[];
+export declare function assertKeyAllowedOnMatchingVariants(matchingVariants: ZodObjectLike[], key: string): void;
+//# sourceMappingURL=union-variant.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"union-variant.d.ts","sourceRoot":"","sources":["../../src/smart-object/union-variant.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAuBzD,wBAAgB,yBAAyB,CAAC,CAAC,EACzC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,GACvB,aAAa,EAAE,CASjB;AAED,wBAAgB,kCAAkC,CAChD,gBAAgB,EAAE,aAAa,EAAE,EACjC,GAAG,EAAE,MAAM,GACV,IAAI,CAeN"}

package/dist/smart-object/union-variant.js

@@ -0,0 +1,38 @@
+import { SmartObjectError } from "../errors.js";
+import { getDiscriminator, isZodDiscriminatedUnion, isZodObject, } from "../zod-introspect.js";
+function getActiveVariantViaDiscriminator(schema, data) {
+    const discriminator = getDiscriminator(schema);
+    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;
+}
+export function getMatchingVariantObjects(state, instance, schema) {
+    const data = state.getData(instance);
+    if (isZodDiscriminatedUnion(schema)) {
+        const activeVariant = getActiveVariantViaDiscriminator(schema, data);
+        return activeVariant ? [activeVariant] : [];
+    }
+    return schema.options.filter(isZodObject).filter((option) => option.safeParse(data).success);
+}
+export function assertKeyAllowedOnMatchingVariants(matchingVariants, key) {
+    if (matchingVariants.length === 0) {
+        throw SmartObjectError.invalidUnionState();
+    }
+    if (matchingVariants.length === 1) {
+        if (!(key in matchingVariants[0].shape)) {
+            throw SmartObjectError.invalidUnionField(key);
+        }
+        return;
+    }
+    if (!matchingVariants.some((variant) => key in variant.shape)) {
+        throw SmartObjectError.invalidUnionField(key);
+    }
+}

package/dist/types.d.ts

@@ -38,6 +38,12 @@ 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.
  */
@@ -49,7 +55,7 @@ export type UnionDataShape<U> = {
  *
  * 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> : UnionDataShape<z.infer<T>>) & (T extends z.ZodObject ? SetMethods<z.infer<T>> : SetMethodsUnion<z.infer<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":"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,gBAAgB,CAAC,CAAC,SAAS,iBAAiB,IAAI;IAC1D,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CACtB,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,GAClB,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAEtB;;;;;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"}

package/dist/zod-introspect.d.ts

@@ -0,0 +1,14 @@
+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 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;
+//# 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":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,SAAS,CAAC;AACxC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,QAAQ,CAAC;AAC1C,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,qBAAqB,CAAC;AAEhE,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAOpE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,IAAI,gBAAgB,CAEpF;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,GACvB,MAAM,IAAI,yBAAyB,CAErC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAErE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAElE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAcrE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAE1E;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/zod-introspect.js

@@ -0,0 +1,36 @@
+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)}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gialicus/smart-object",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "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");
-}