@justscale/core 0.1.0

package/dist/models/symbols.js

@@ -0,0 +1,97 @@
+/**
+ * Symbols for internal metadata on models.
+ *
+ * Most use plain Symbol() to avoid cross-version collisions - each
+ * package version has its own symbols, so mismatched metadata shapes
+ * never cause silent data corruption. Cross-module symbols that must
+ * survive HMR use Symbol.for() instead.
+ */
+// ============================================
+// Observable & Model symbols (from @justscale/observable)
+// ============================================
+/** Symbol to access model internals (schema, dirty tracking, etc.) */
+export const MODEL_INTERNALS = Symbol('model_internals');
+/** Symbol to access observable internals (dirty tracking, etc.) */
+export const OBSERVABLE_META = Symbol('observable_meta');
+// ============================================
+// Reference symbols (for Promise-like refs)
+// ============================================
+/** Symbol to mark an object as a Reference */
+export const REFERENCE = Symbol('models:reference');
+/** Symbol to mark an object as a References collection */
+export const REFERENCES = Symbol('models:references');
+/** Symbol for internal reference ID storage */
+export const REF_ID = Symbol('models:ref:id');
+/** Symbol for internal reference IDs storage (plural) */
+export const REF_IDS = Symbol('models:refs:ids');
+/** Symbol for cached resolved value */
+export const REF_VALUE = Symbol('models:ref:value');
+/** Symbol for cached resolved values (plural) */
+export const REF_VALUES = Symbol('models:refs:values');
+/** Symbol for resolver function */
+export const REF_RESOLVER = Symbol('models:ref:resolver');
+/** Symbol-keyed method to attach resolver (internal use) */
+export const SET_RESOLVER = Symbol('models:ref:setResolver');
+/** Symbol-keyed method to hydrate a reference with a pre-loaded value (internal use) */
+export const HYDRATE = Symbol('models:ref:hydrate');
+// ============================================
+// Transient Reference symbols (for unsaved entities)
+// ============================================
+/** Symbol to mark an object as a TransientRef */
+export const TRANSIENT_REF = Symbol('models:transientRef');
+/** Symbol for internal transient target storage */
+export const TRANSIENT_TARGET = Symbol('models:transientRef:target');
+// ============================================
+// Instance State symbols (for runtime type safety)
+// ============================================
+/** Symbol to mark an instance as persisted (stored by an adapter) */
+export const PERSISTENT = Symbol('models:persistent');
+/** Symbol for adapter-stored key on a persistent entity (non-enumerable) */
+export const ADAPTER_KEY = Symbol('models:adapterKey');
+/** Symbol to mark an instance as transient (not yet saved) */
+export const TRANSIENT = Symbol('models:transient');
+/** Symbol to mark an instance as locked (for safe mutations) */
+export const LOCK = Symbol('models:lock');
+// ============================================
+// Internal Storage symbols (for field values on instances)
+// ============================================
+/** Symbol for internal field storage on model instances */
+export const FIELD_STORAGE = Symbol('models:fieldStorage');
+/** Symbol for model context (registry, resolvers, etc.) */
+export const MODEL_CONTEXT = Symbol('models:modelContext');
+/** Symbol for model methods (type-level only, for extraction by Persistent/Transient) */
+export const MODEL_METHODS = Symbol('models:modelMethods');
+// ============================================
+// ModelRepository Token symbols (for DI)
+// ============================================
+/** Symbol to store the base model on a repository token */
+export const MODEL_REPO_MODEL = Symbol('models:modelRepoModel');
+/** Symbol for custom repository that links to base ModelRepository token */
+export const MODEL_REPO_BASE_TOKEN = Symbol('models:modelRepoBaseToken');
+/** Symbol for storage model factory (creates repository from deps) */
+export const CREATE_MODEL_REPO = Symbol('models:createModelRepo');
+/** Symbol to store custom repository contract type on a model */
+export const MODEL_REPO_CONTRACT = Symbol('models:modelRepoContract');
+// ============================================
+// Access Control symbols
+// ============================================
+/** Symbol to store field-level access rules on a model class */
+export const ACCESS_RULES = Symbol('models:accessRules');
+/** Symbol to store the raw permission defs record on a model class (for access rule evaluation) */
+export const PERMISSION_DEFS = Symbol('models:permissionDefs');
+// ============================================
+// Model DI Injection symbols
+// ============================================
+/**
+ * Symbol to store inject config on a model class.
+ * Contains the raw { key: ServiceToken } map from defineModel({ inject }).
+ * Symbol.for() for cross-module matching.
+ */
+export const MODEL_INJECT = Symbol.for('@justscale/core/models:modelInject');
+/**
+ * Symbol to store the resolved model service on a model class.
+ * The model service is Object.create(ModelClass.prototype) with resolved inject deps.
+ * Set during boot by Container.wireModelPrototypes().
+ */
+export const MODEL_SERVICE = Symbol.for('@justscale/core/models:modelService');
+//# sourceMappingURL=symbols.js.map

package/dist/models/symbols.js.map

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

package/dist/models/types.d.ts

@@ -0,0 +1,291 @@
+import type { z } from 'zod';
+import type { MODEL_INTERNALS, OBSERVABLE_META, MODEL_METHODS } from './symbols.js';
+import { PERSISTENT, TRANSIENT, LOCK } from './symbols.js';
+import { MODEL_DATA, MODEL_DEFAULTS } from './define-model.js';
+import type { Lock, LockMetadata } from '../features/lock/types.js';
+import type { Reference } from './reference/reference.js';
+import type { Decimal } from './field.js';
+/**
+ * Internal state for a model.
+ */
+export interface ModelInternals<T, S extends z.ZodTypeAny = z.ZodTypeAny> {
+    schema: S;
+    dirty: Set<string>;
+    original: T;
+    markClean(): void;
+    isDirty(): boolean;
+    getDirtyPaths(): string[];
+    getDirtyData(): Partial<T>;
+}
+/**
+ * A model with attached internals for dirty tracking.
+ */
+export type Model<T> = T & {
+    [MODEL_INTERNALS]: ModelInternals<T>;
+};
+/**
+ * Internal state for an observable.
+ */
+export interface ObservableInternals {
+    dirty: Set<string>;
+    markClean(): void;
+    isDirty(): boolean;
+    getDirtyPaths(): string[];
+}
+/**
+ * An observable wrapper that tracks mutations.
+ */
+export type Observable<T> = T & {
+    [OBSERVABLE_META]: ObservableInternals;
+};
+/**
+ * Reference to a parent proxy.
+ */
+export interface ParentRef {
+    ref: WeakRef<ProxyMeta>;
+    key: string;
+}
+/**
+ * Internal metadata for tracked proxies.
+ */
+export interface ProxyMeta {
+    path: string[];
+    dirtySets: Set<Set<string>>;
+    parents: Set<ParentRef>;
+    children: Map<string | symbol, ProxyMeta>;
+    target: object;
+    proxy: object;
+}
+/**
+ * Base entity type - anything with an id.
+ */
+export interface Entity<TId = string> {
+    id: TId;
+}
+/**
+ * System fields added by the persistence layer.
+ *
+ * These are ADAPTER concerns - they do NOT appear on Persistent<T>.
+ * Adapters store these internally via non-enumerable symbols.
+ * Domain code never sees or accesses system fields directly.
+ *
+ * @deprecated Import from your adapter package instead (e.g. @justscale/postgres).
+ * Kept temporarily for migration - will be removed from core.
+ */
+export interface SystemFields {
+    /** Unique identifier assigned by storage */
+    readonly id: string;
+    /** Creation timestamp */
+    readonly createdAt: Date;
+    /** Last update timestamp */
+    readonly updatedAt: Date;
+    /** Version for optimistic concurrency */
+    readonly version: number;
+}
+/**
+ * Keys of system fields (for type-level exclusion).
+ *
+ * @deprecated Adapter concern - will be removed from core.
+ */
+export type SystemFieldKeys = keyof SystemFields;
+/**
+ * Extract domain fields, excluding system fields and internal symbols.
+ *
+ * @deprecated No longer needed - Persistent<T> is already pure domain fields.
+ */
+export type DomainFields<T> = Omit<T, SystemFieldKeys | typeof PERSISTENT | typeof LOCK>;
+/**
+ * Resolve T to its model data type if T is a model class, otherwise use T directly.
+ */
+type ResolveModelType<T> = T extends abstract new (...args: any[]) => {
+    readonly [MODEL_DATA]: infer D;
+} ? D : T extends {
+    readonly [MODEL_DATA]: infer D;
+} ? D : T;
+/** Domain fields: the model's data type. No system fields to exclude anymore. */
+type DomainOf<T> = ResolveModelType<T>;
+/**
+ * Extract the set of field names that have defaults from a model class.
+ * Returns `never` if T is not a model class.
+ */
+type ResolveDefaultKeys<T> = T extends abstract new (...args: any[]) => {
+    readonly [MODEL_DEFAULTS]: infer D;
+} ? D extends string ? D : never : T extends {
+    readonly [MODEL_DEFAULTS]: infer D;
+} ? D extends string ? D : never : never;
+/** Keys of T whose type includes undefined */
+type UndefinedKeys<T> = {
+    [K in keyof T]: undefined extends T[K] ? K : never;
+}[keyof T];
+/**
+ * Strip the internal `Decimal` brand recursively so callers can pass plain
+ * strings for nested-object decimal fields too. Leaves non-decimal types
+ * untouched.
+ */
+type StripDecimal<V> = [
+    NonNullable<V>
+] extends [Decimal] ? string | (undefined extends V ? undefined : never) : V extends readonly (infer E)[] ? StripDecimal<E>[] : V extends Record<string, unknown> ? {
+    [K in keyof V]: StripDecimal<V[K]>;
+} : V;
+/** Widen Reference<X> fields to also accept Persistent<X> (i.e. Ref<X>) */
+type AcceptRef<V> = [
+    NonNullable<V>
+] extends [Reference<infer X>] ? Reference<X> | Persistent<X> | Lock<Persistent<X>> | (undefined extends V ? undefined : never) : StripDecimal<V>;
+/**
+ * Insert data type - domain fields only.
+ *
+ * Handles both model classes (`InsertData<typeof User>`) and plain types.
+ * Fields that are optional (undefined) or have defaults become optional keys.
+ * Reference fields accept Ref<T> (Reference, Persistent, or Lock).
+ */
+export type InsertData<T> = {
+    -readonly [K in keyof DomainOf<T> as K extends (UndefinedKeys<DomainOf<T>> | ResolveDefaultKeys<T>) ? never : K]: AcceptRef<DomainOf<T>[K]>;
+} & {
+    -readonly [K in keyof DomainOf<T> as K extends (UndefinedKeys<DomainOf<T>> | ResolveDefaultKeys<T>) ? K : never]?: AcceptRef<DomainOf<T>[K]>;
+};
+/**
+ * Update data type - partial domain fields.
+ *
+ * Handles both model classes (`UpdateData<typeof User>`) and plain types.
+ */
+export type UpdateData<T> = {
+    -readonly [K in keyof DomainOf<T>]?: AcceptRef<DomainOf<T>[K]>;
+};
+/**
+ * Make all fields mutable.
+ * Used by Lock<T> to enable writes on locked entities.
+ */
+export type Mutable<T> = {
+    -readonly [K in keyof T]: T[K];
+};
+/**
+ * @deprecated Use SystemFields instead. Alias for backwards compatibility.
+ */
+export type StorageMeta = SystemFields;
+/**
+ * Extract the instance type from a ModelClass or use T directly.
+ * This allows `Persistent<typeof User>` where User is the defineModel result.
+ *
+ * For model constructors, extracts the instance type (which includes methods).
+ * For plain types, uses the type directly.
+ */
+export type ExtractModelType<T> = T extends abstract new (...args: any[]) => infer Instance ? Instance : T;
+/**
+ * Extract the data type for Reference compatibility.
+ * Used by repository.get() to accept references created by Model.ref.
+ *
+ * Handles three cases:
+ * 1. Instance type with [MODEL_DATA] (User) - extract from the symbol
+ * 2. Constructor type (typeof User) - extract from constructor parameter
+ * 3. Plain type - use as-is
+ */
+export type ReferenceData<T> = T extends {
+    readonly [MODEL_DATA]: infer D;
+} ? D : T extends abstract new (data: infer D) => unknown ? D : T;
+/**
+ * Simplify a type by forcing TypeScript to resolve all mapped types.
+ * This produces cleaner type emissions in .d.ts files.
+ *
+ * Instead of: `Persistent<InferModelType<{email: FieldBuilder<string>}>>`
+ * Produces:   `{id: string; email: string; ...}`
+ */
+export type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/**
+ * Extract methods from a ModelClass.
+ * Returns the properly typed methods (with `this` bound to model data) or empty object.
+ */
+type ExtractModelMethods<T> = T extends {
+    readonly [MODEL_METHODS]?: infer M;
+} ? M extends undefined ? {} : M : {};
+/**
+ * A persisted model instance - pure domain data + methods.
+ *
+ * No system fields (id, createdAt, etc.) - those are adapter concerns,
+ * stored internally via non-enumerable symbols. Domain code never sees them.
+ *
+ * To reference a persistent entity, use `Model.ref(entity)` or pass
+ * the entity directly where a `Reference<T>` is expected.
+ */
+export type Persistent<T> = ExtractModelType<T> & ExtractModelMethods<T> & Disposable & {
+    readonly [PERSISTENT]: true;
+};
+/**
+ * A transient (not yet persisted) model instance.
+ *
+ * Used for creating new models before they have storage metadata.
+ * Methods defined on the model are preserved on transient instances.
+ */
+export type Transient<T> = ExtractModelType<T> & ExtractModelMethods<T> & {
+    readonly [TRANSIENT]: true;
+};
+/**
+ * Anything that refers to an entity of type T.
+ *
+ * Use `Ref<T>` in method signatures that accept "something pointing at a T":
+ * a Reference, a persistent entity, or a locked entity.
+ *
+ * @example
+ * ```typescript
+ * async transfer(from: Ref<Account>, to: Ref<Account>, amount: number) { ... }
+ * async update(ref: Ref<User>, data: UpdateData<User>) { ... }
+ * ```
+ */
+export type Ref<T> = Reference<T> | Persistent<T> | Lock<Persistent<T>>;
+/**
+ * Proves exclusive access to a persisted entity. Required for mutations.
+ *
+ * Use in service signatures to communicate "this method mutates":
+ * ```typescript
+ * async assignTicket(ticket: Locked<Ticket>, agent: Ref<Agent>) { ... }
+ * ```
+ *
+ * Acquire via repository:
+ * ```typescript
+ * using ticket = await tickets.lock(params.ticket);
+ * ```
+ */
+export type Locked<T> = Lock<Persistent<T>>;
+/**
+ * Disposable interface for resources that need cleanup.
+ */
+export interface Disposable {
+    /** Dispose of the resource (release lock, cleanup, etc.) */
+    [Symbol.dispose](): void;
+}
+/**
+ * Check if an object is a persisted entity.
+ *
+ * @example
+ * ```typescript
+ * if (isPersistent(user)) {
+ *   console.log(user.id); // TypeScript knows id exists
+ * }
+ * ```
+ */
+export declare function isPersistent<T>(obj: unknown): obj is Persistent<T>;
+/**
+ * Check if an object is a transient (not yet persisted) entity.
+ *
+ * @example
+ * ```typescript
+ * if (isTransient(user)) {
+ *   console.log('User not yet saved');
+ * }
+ * ```
+ */
+export declare function isTransient<T>(obj: unknown): obj is Transient<T>;
+/**
+ * Check if an object is a locked entity.
+ *
+ * @example
+ * ```typescript
+ * if (isLocked(user)) {
+ *   console.log(user.__lock.lockedAt); // Access lock metadata
+ * }
+ * ```
+ */
+export declare function isLocked<T>(obj: unknown): obj is Lock<T>;
+export type { Lock, LockMetadata };
+//# sourceMappingURL=types.d.ts.map

package/dist/models/types.d.ts.map

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

package/dist/models/types.js

@@ -0,0 +1,50 @@
+import { PERSISTENT, TRANSIENT } from './symbols.js';
+import { MODEL_DATA, MODEL_DEFAULTS } from './define-model.js'; // MODEL_DEFAULTS for InsertData
+// Lock<T> and LockMetadata are defined in features/lock/types.ts
+// Import from '@justscale/core' to use them
+// ============================================
+// Type Guards
+// ============================================
+/**
+ * Check if an object is a persisted entity.
+ *
+ * @example
+ * ```typescript
+ * if (isPersistent(user)) {
+ *   console.log(user.id); // TypeScript knows id exists
+ * }
+ * ```
+ */
+export function isPersistent(obj) {
+    return obj !== null && typeof obj === 'object' && PERSISTENT in obj;
+}
+/**
+ * Check if an object is a transient (not yet persisted) entity.
+ *
+ * @example
+ * ```typescript
+ * if (isTransient(user)) {
+ *   console.log('User not yet saved');
+ * }
+ * ```
+ */
+export function isTransient(obj) {
+    return obj !== null && typeof obj === 'object' && TRANSIENT in obj;
+}
+/**
+ * Check if an object is a locked entity.
+ *
+ * @example
+ * ```typescript
+ * if (isLocked(user)) {
+ *   console.log(user.__lock.lockedAt); // Access lock metadata
+ * }
+ * ```
+ */
+export function isLocked(obj) {
+    return (obj !== null &&
+        typeof obj === 'object' &&
+        '__lock' in obj &&
+        Symbol.dispose in obj);
+}
+//# sourceMappingURL=types.js.map

package/dist/models/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/models/types.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAQ,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC,CAAC,gCAAgC;AAoUhG,iEAAiE;AACjE,4CAA4C;AAE5C,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAE/C;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAI,GAAY;IAC1C,OAAO,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,UAAU,IAAI,GAAG,CAAC;AACtE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAI,GAAY;IACzC,OAAO,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG,CAAC;AACrE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAI,GAAY;IACtC,OAAO,CACL,GAAG,KAAK,IAAI;QACZ,OAAO,GAAG,KAAK,QAAQ;QACvB,QAAQ,IAAI,GAAG;QACf,MAAM,CAAC,OAAO,IAAI,GAAG,CACtB,CAAC;AACJ,CAAC"}

package/dist/models/watch.d.ts

@@ -0,0 +1,27 @@
+import type { Model, Observable } from './types.js';
+/**
+ * Internal: notify all watchers for a dirty set
+ */
+export declare function notifyWatchers(dirtySet: Set<string>): void;
+export interface WatchHandle {
+    unsubscribe: () => void;
+}
+export interface WatchAsyncIteratorOptions {
+    /**
+     * If true, coalesce multiple changes into one if consumer is slow.
+     * Default: true
+     */
+    coalesce?: boolean;
+}
+export type Watcher = AsyncGenerator<string[], void, unknown> & Disposable & AsyncDisposable & {
+    unsubscribe: () => void;
+};
+/**
+ * Watch an observable or model for changes.
+ *
+ * With callback: invokes callback with dirty paths on each change, returns { unsubscribe }
+ * Without callback: returns async generator that yields dirty paths, with unsubscribe() method
+ */
+export declare function watch<T extends object>(target: Observable<T> | Model<T>, callback: (paths: string[]) => void): WatchHandle;
+export declare function watch<T extends object>(target: Observable<T> | Model<T>, options?: WatchAsyncIteratorOptions): Watcher;
+//# sourceMappingURL=watch.d.ts.map

package/dist/models/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/models/watch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAOpD;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAQ1D;AAgCD,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,GAC3D,UAAU,GACV,eAAe,GAAG;IAChB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAEJ;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EACpC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,GAClC,WAAW,CAAC;AACf,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,EACpC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAChC,OAAO,CAAC,EAAE,yBAAyB,GAClC,OAAO,CAAC"}

package/dist/models/watch.js

@@ -0,0 +1,124 @@
+import { MODEL_INTERNALS, OBSERVABLE_META } from './symbols.js';
+// Registry: dirty set -> Set of callbacks
+const watcherRegistry = new WeakMap();
+/**
+ * Internal: notify all watchers for a dirty set
+ */
+export function notifyWatchers(dirtySet) {
+    const watchers = watcherRegistry.get(dirtySet);
+    if (!watchers || watchers.size === 0)
+        return;
+    const paths = [...dirtySet];
+    for (const callback of watchers) {
+        callback(paths);
+    }
+}
+/**
+ * Internal: register a watcher for a dirty set
+ */
+function registerWatcher(dirtySet, callback) {
+    let watchers = watcherRegistry.get(dirtySet);
+    if (!watchers) {
+        watchers = new Set();
+        watcherRegistry.set(dirtySet, watchers);
+    }
+    watchers.add(callback);
+    // Return unsubscribe function
+    return () => {
+        watchers?.delete(callback);
+    };
+}
+/**
+ * Get the dirty set from an observable or model
+ */
+function getDirtySet(target) {
+    if (OBSERVABLE_META in target) {
+        return target[OBSERVABLE_META].dirty;
+    }
+    if (MODEL_INTERNALS in target) {
+        return target[MODEL_INTERNALS].dirty;
+    }
+    throw new Error('Target is not an observable or model');
+}
+export function watch(target, callbackOrOptions) {
+    // Callback mode
+    if (typeof callbackOrOptions === 'function') {
+        const dirtySet = getDirtySet(target);
+        const unsubscribe = registerWatcher(dirtySet, callbackOrOptions);
+        return { unsubscribe };
+    }
+    // Async generator mode
+    const options = callbackOrOptions ?? {};
+    const { coalesce = true } = options;
+    const dirtySet = getDirtySet(target);
+    let pendingResolve = null;
+    let pendingPaths = null;
+    let stopped = false;
+    let unsubscribeFn = null;
+    const callback = (paths) => {
+        if (stopped)
+            return;
+        if (pendingResolve) {
+            // Consumer is waiting, resolve immediately
+            pendingResolve({ value: paths, done: false });
+            pendingResolve = null;
+        }
+        else if (coalesce) {
+            // Not waiting, coalesce - just keep latest
+            pendingPaths = paths;
+        }
+        else {
+            pendingPaths = paths;
+        }
+    };
+    unsubscribeFn = registerWatcher(dirtySet, callback);
+    const doUnsubscribe = () => {
+        stopped = true;
+        if (unsubscribeFn) {
+            unsubscribeFn();
+            unsubscribeFn = null;
+        }
+        if (pendingResolve) {
+            pendingResolve({ value: undefined, done: true });
+            pendingResolve = null;
+        }
+    };
+    const watcher = {
+        async next() {
+            if (stopped) {
+                return { value: undefined, done: true };
+            }
+            // If we have pending paths from while consumer was busy, return them
+            if (pendingPaths !== null) {
+                const paths = pendingPaths;
+                pendingPaths = null;
+                return { value: paths, done: false };
+            }
+            // Wait for next change
+            return new Promise((resolve) => {
+                pendingResolve = resolve;
+            });
+        },
+        async return() {
+            doUnsubscribe();
+            return { value: undefined, done: true };
+        },
+        async throw(error) {
+            doUnsubscribe();
+            throw error;
+        },
+        unsubscribe: doUnsubscribe,
+        [Symbol.asyncIterator]() {
+            return this;
+        },
+        [Symbol.dispose]() {
+            doUnsubscribe();
+        },
+        [Symbol.asyncDispose]() {
+            doUnsubscribe();
+            return Promise.resolve();
+        },
+    };
+    return watcher;
+}
+//# sourceMappingURL=watch.js.map

package/dist/models/watch.js.map

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

package/dist/models/zod-ref.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Extends Zod with z.ref() for type-safe Ref<T> validation.
+ *
+ * Usage:
+ * ```typescript
+ * import { z } from '@justscale/core/models'
+ *
+ * const EventSchema = z.object({
+ *   user: z.ref(User),
+ * })
+ * ```
+ */
+import { z as _z } from 'zod';
+import { type Ref } from './types.js';
+declare function ref<T>(_model: {
+    new (...args: any[]): T;
+    ref(id: string): unknown;
+}): _z.ZodType<Ref<T>>;
+/**
+ * Extended Zod with z.ref() for JustScale Ref<T> validation.
+ * Drop-in replacement for `import { z } from 'zod'`.
+ */
+export declare const z: typeof _z & {
+    ref: typeof ref;
+};
+/** Standalone export for direct usage */
+export { ref as zRef };
+/**
+ * Module augmentation - makes z.ref() visible in TypeScript
+ * even when importing from 'zod' directly. At runtime, only
+ * the z exported from '@justscale/core/models' has .ref().
+ */
+declare module 'zod' {
+    namespace z {
+        /**
+         * Create a Zod schema that validates a Ref<T>.
+         * Accepts Reference<T>, Persistent<T>, or Lock<Persistent<T>>.
+         *
+         * Note: import z from '@justscale/core/models' for runtime support.
+         */
+        function ref<T>(_model: {
+            new (...args: any[]): T;
+        }): _z.ZodType<Ref<T>>;
+    }
+}
+//# sourceMappingURL=zod-ref.d.ts.map