@justscale/core 0.1.0

package/dist/models/index.js

@@ -0,0 +1,86 @@
+/**
+ * @justscale/core/models
+ *
+ * Model definition and observable tracking for justscale.
+ *
+ * Provides:
+ * - defineModel() - Define typed models with field schemas
+ * - field - Field builders for model definitions
+ * - Reference/References - Promise-like references to other models
+ * - Persistent - Type helper for persisted models with storage fields
+ * - createObservable() - Creates standalone observable with dirty tracking
+ * - watch() - Watch for changes with callback or async iterator
+ */
+// Symbols
+export { 
+// Legacy observable symbols (kept for compatibility)
+MODEL_INTERNALS, OBSERVABLE_META, 
+// Reference symbols (SET_RESOLVER exported from reference/reference.js)
+REFERENCE, REFERENCES, REF_ID, REF_IDS, REF_VALUE, REF_VALUES, REF_RESOLVER, 
+// Transient reference symbols
+TRANSIENT_REF, TRANSIENT_TARGET, 
+// Instance state symbols (runtime type safety)
+PERSISTENT, ADAPTER_KEY, LOCK, 
+// Internal storage symbols
+FIELD_STORAGE, MODEL_CONTEXT, 
+// ModelRepository token symbols
+MODEL_REPO_MODEL, MODEL_REPO_BASE_TOKEN, CREATE_MODEL_REPO, MODEL_REPO_CONTRACT, ACCESS_RULES, } from './symbols.js';
+export { filterByAccess, getAccessRules } from './access.js';
+// Re-export REPO_TOKEN from repository for convenience
+export { REPO_TOKEN } from './repository.js';
+// Model definition symbols
+export { MODEL_DEF, MODEL_FIELDS, MODEL_NAME, MODEL_DATA, MODEL_METHODS, MODEL_INJECT, MODEL_SERVICE } from './define-model.js';
+// Type guards for runtime checks
+export { isPersistent, isLocked, isTransient } from './types.js';
+// ============================================================================
+// Model Definition (defineModel)
+// ============================================================================
+// Define models with typed fields
+export { BaseModel, defineModel, isModelClass, getModelFields, getModelName, registerModelForInjection, getModelsWithInject, } from './define-model.js';
+export { registerModelByName, getModelByName, getModelNameRegistry, } from './model-name-registry.js';
+export { applyTypesConfig, registerModelRefResolver } from './apply-types-config.js';
+// Field builders
+export { field, isFieldDef, FIELD_DEF, } from './field.js';
+// Stream fields
+export { STREAM, SET_STREAM_CHANNEL, SET_STREAM_SIGNAL_EMITTER, StreamImpl, isStream } from './stream.js';
+// Reference system
+export { Reference, References, isReference, isReferences, SET_RESOLVER, HYDRATE } from './reference/reference.js';
+// Transient references (for unsaved entities)
+export { TransientRef, isTransientRef } from './reference/transient-ref.js';
+// Zod with z.ref() for Ref<T> validation
+export { z, zRef } from './zod-ref.js';
+// ============================================================================
+// Observable & Model Instance (legacy)
+// ============================================================================
+// Model instance creation (internal - for defining models, use @justscale/live-model)
+export { getModelInternals, isModel } from './model.js';
+// Observable creation (from @justscale/observable)
+export { createObservable, getObservableInternals, isObservable } from './observable.js';
+// Proxy utilities (for advanced use/testing)
+export { createTrackedProxy, getProxyMeta, isTrackedProxy } from './proxy.js';
+// Watch functionality (from @justscale/observable)
+export { watch, } from './watch.js';
+// ============================================================================
+// Query System
+// ============================================================================
+// Query helpers namespace
+export { q, CONDITION, AGGREGATION, isCondition, isAggregation, createFieldExpr, refId } from './query.js';
+// Field expression classes
+export { StringFieldExpr, NumberFieldExpr, BigIntFieldExpr, DecimalFieldExpr, BooleanFieldExpr, TimestampFieldExpr, UuidFieldExpr, EnumFieldExpr, RefFieldExpr, RefsFieldExpr, ArrayFieldExpr, JsonFieldExpr, ObjectFieldExpr, } from './query.js';
+// Order by helpers
+export { ORDER_BY, isOrderByItem } from './query.js';
+// Ref traversal (permission multi-hop)
+export { isRefTraversal } from './query.js';
+// ============================================================================
+// ModelRepository
+// ============================================================================
+export { ModelRepository, isModelRepositoryToken } from './model.repository.js';
+// ============================================================================
+// In-Memory Adapter
+// ============================================================================
+export { InMemoryRepository, InMemoryScheduledTaskRepository, createInMemoryModel, createInMemoryRepository, } from './in-memory/index.js';
+// ============================================================================
+// Scheduled Tasks
+// ============================================================================
+export { ScheduledTask, ScheduledTaskStatus, ScheduledTaskRepository, } from './scheduled-task/index.js';
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

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

package/dist/models/model-name-registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Core model name registry.
+ *
+ * Maps model names to model classes. Used by the Reference deserializer
+ * to recreate typed refs via Model.ref(id) during process state restoration.
+ *
+ * Populated by adapters (createPgModel, createInMemoryModel) at registration time.
+ */
+import type { Reference } from './reference/reference.js';
+export interface RegisteredModel {
+    ref: (id: string) => Reference<unknown>;
+}
+export declare function registerModelByName(name: string, model: RegisteredModel): void;
+export declare function getModelByName(name: string): RegisteredModel | undefined;
+export declare function getModelNameRegistry(): ReadonlyMap<string, RegisteredModel>;
+//# sourceMappingURL=model-name-registry.d.ts.map

package/dist/models/model-name-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-name-registry.d.ts","sourceRoot":"","sources":["../../src/models/model-name-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC;CACzC;AAID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAE9E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAExE;AAED,wBAAgB,oBAAoB,IAAI,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAE3E"}

package/dist/models/model-name-registry.js

@@ -0,0 +1,19 @@
+/**
+ * Core model name registry.
+ *
+ * Maps model names to model classes. Used by the Reference deserializer
+ * to recreate typed refs via Model.ref(id) during process state restoration.
+ *
+ * Populated by adapters (createPgModel, createInMemoryModel) at registration time.
+ */
+const registry = new Map();
+export function registerModelByName(name, model) {
+    registry.set(name, model);
+}
+export function getModelByName(name) {
+    return registry.get(name);
+}
+export function getModelNameRegistry() {
+    return registry;
+}
+//# sourceMappingURL=model-name-registry.js.map

package/dist/models/model-name-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-name-registry.js","sourceRoot":"","sources":["../../src/models/model-name-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAC;AAEpD,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,KAAsB;IACtE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/models/model.d.ts

@@ -0,0 +1,15 @@
+import type { z } from 'zod';
+import type { Model, ModelInternals } from './types.js';
+/**
+ * Create a model instance with schema validation and dirty tracking.
+ */
+export declare function createModelInstance<S extends z.ZodTypeAny>(schema: S, input?: z.input<S>): Model<z.output<S>>;
+/**
+ * Helper to get model internals
+ */
+export declare function getModelInternals<T>(model: Model<T>): ModelInternals<T>;
+/**
+ * Type guard to check if a value is a model
+ */
+export declare function isModel<T>(value: unknown): value is Model<T>;
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/models/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA0DxD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACxD,MAAM,EAAE,CAAC,EACT,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GACjB,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAuDpB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAEvE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAE5D"}

package/dist/models/model.js

@@ -0,0 +1,114 @@
+import { createTrackedProxy } from './proxy.js';
+import { MODEL_INTERNALS } from './symbols.js';
+// Deep traverse to ensure all nested objects are proxied and parent refs registered
+function deepTraverse(obj, visited = new WeakSet()) {
+    if (obj === null || typeof obj !== 'object')
+        return;
+    if (visited.has(obj))
+        return; // Prevent infinite loops on circular refs
+    visited.add(obj);
+    if (Array.isArray(obj)) {
+        for (let i = 0; i < obj.length; i++) {
+            deepTraverse(obj[i], visited);
+        }
+    }
+    else {
+        for (const key of Object.keys(obj)) {
+            deepTraverse(obj[key], visited);
+        }
+    }
+}
+// Safe deep clone that handles proxies (skips them as they can't be cloned)
+function safeDeepClone(obj) {
+    try {
+        return structuredClone(obj);
+    }
+    catch {
+        // If structuredClone fails (e.g., proxies), do manual clone
+        return manualDeepClone(obj);
+    }
+}
+function manualDeepClone(obj, visited = new WeakMap()) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    // Handle circular refs
+    if (visited.has(obj)) {
+        return visited.get(obj);
+    }
+    // For proxies, extract the underlying values
+    if (Array.isArray(obj)) {
+        const clone = [];
+        visited.set(obj, clone);
+        for (let i = 0; i < obj.length; i++) {
+            clone[i] = manualDeepClone(obj[i], visited);
+        }
+        return clone;
+    }
+    const clone = {};
+    visited.set(obj, clone);
+    for (const key of Object.keys(obj)) {
+        clone[key] = manualDeepClone(obj[key], visited);
+    }
+    return clone;
+}
+/**
+ * Create a model instance with schema validation and dirty tracking.
+ */
+export function createModelInstance(schema, input) {
+    // Parse with defaults
+    const parsed = schema.parse(input ?? {});
+    const original = safeDeepClone(parsed);
+    const dirty = new Set();
+    // Create the root proxy
+    const proxy = createTrackedProxy(parsed, [], dirty);
+    // Traverse entire structure to ensure all proxies are created upfront
+    // This registers all parent refs for shared objects
+    deepTraverse(proxy);
+    const internals = {
+        schema,
+        dirty,
+        original,
+        markClean() {
+            dirty.clear();
+        },
+        isDirty() {
+            return dirty.size > 0;
+        },
+        getDirtyPaths() {
+            return [...dirty];
+        },
+        getDirtyData() {
+            const result = {};
+            for (const path of dirty) {
+                // Get top-level keys only for signal merging
+                const topKey = path.split('.')[0];
+                if (topKey && !(topKey in result)) {
+                    result[topKey] = proxy[topKey];
+                }
+            }
+            return result;
+        },
+    };
+    // Attach internals directly to the underlying object (not via proxy)
+    Object.defineProperty(parsed, MODEL_INTERNALS, {
+        value: internals,
+        enumerable: false,
+        writable: false,
+        configurable: false,
+    });
+    return proxy;
+}
+/**
+ * Helper to get model internals
+ */
+export function getModelInternals(model) {
+    return model[MODEL_INTERNALS];
+}
+/**
+ * Type guard to check if a value is a model
+ */
+export function isModel(value) {
+    return value !== null && typeof value === 'object' && MODEL_INTERNALS in value;
+}
+//# sourceMappingURL=model.js.map

package/dist/models/model.js.map

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

package/dist/models/model.repository.d.ts

@@ -0,0 +1,318 @@
+/**
+ * ModelRepository - Abstract Repository with Token System
+ *
+ * Base class for data access that works with the query system.
+ * Implementations (Postgres, SQLite, Memory) extend this.
+ *
+ * Key features:
+ * - ModelRepository<T> is the abstract contract for CRUD operations
+ * - ModelRepository.of(Model) creates a DI token for injection
+ *
+ * @example
+ * ```typescript
+ * // Get a token for dependency injection
+ * const userRepoToken = ModelRepository.of(User);
+ *
+ * // Domain service depends on the token
+ * const UserService = defineService({
+ *   inject: { users: ModelRepository.of(User) },
+ *   factory: ({ users }) => ({
+ *     async findByEmail(email: string) {
+ *       return users.findOne(User.fields.email.eq(email));
+ *     },
+ *   }),
+ * });
+ * ```
+ */
+import type { Condition, FindOptions, Aggregation, OrderBy } from './query.js';
+import type { Persistent, Locked, Ref, Transient, SystemFields, InsertData, UpdateData } from './types.js';
+import type { LockOptions } from '../features/lock/types.js';
+import type { DurableQueryIterable } from '../process/primitives.js';
+import { BaseModel, type Model, type RepositoryContract } from './define-model.js';
+import { Repository } from './repository.js';
+import type { RepositoryToken } from './repository.js';
+import { MODEL_REPO_MODEL, MODEL_REPO_CONTRACT } from './symbols.js';
+type AnyModel = abstract new (...args: any[]) => BaseModel<any, any, any>;
+export { MODEL_REPO_MODEL, MODEL_REPO_CONTRACT };
+/**
+ * Extract repository contract from a model class.
+ */
+export type ExtractContract<M> = M extends Model<any, any, infer C> ? C extends RepositoryContract<any> ? C : {} : {};
+/**
+ * Extract the instance type from a model class.
+ * Since models are proper classes, we can use InstanceType directly.
+ */
+export type ModelInstanceType<M> = M extends abstract new (...args: any[]) => infer T ? T : never;
+/**
+ * A ModelRepository token for dependency injection.
+ *
+ * Extends the generic RepositoryToken from core with model-specific metadata.
+ * Created via ModelRepository.of(Model).
+ *
+ * If the model has a repository contract (via .withRepository()), the token
+ * type includes those methods in addition to the base ModelRepository methods.
+ */
+export interface ModelRepositoryToken<T, C extends RepositoryContract<T> = {}> extends RepositoryToken<T, ModelRepository<T> & C> {
+    /** The model this token is for */
+    readonly [MODEL_REPO_MODEL]: Model<T>;
+    /** The contract type (type-level only) */
+    readonly [MODEL_REPO_CONTRACT]?: C;
+}
+export type { SystemFields, InsertData, UpdateData };
+/**
+ * Abstract repository for model data access.
+ *
+ * Extends the generic Repository from core with model-specific operations
+ * like find, get, insert, update, delete, and query support.
+ *
+ * Implementations can be created for PostgreSQL, SQLite, in-memory, etc.
+ *
+ * @typeParam T - The entity type this repository manages
+ */
+export declare abstract class ModelRepository<T> extends Repository<T> {
+    /**
+     * Find all entities matching the given options.
+     *
+     * @example
+     * ```typescript
+     * // Find all active users, ordered by creation date
+     * const users = await userRepo.find({
+     *   where: User.fields.status.eq('active'),
+     *   orderBy: [User.fields.createdAt.desc()],
+     *   limit: 10,
+     * });
+     * ```
+     */
+    abstract find(options?: FindOptions<T>): Promise<Persistent<T>[]>;
+    /**
+     * Get an entity by its reference.
+     * This is the type-safe way to look up entities - you can't accidentally
+     * pass a User reference to a PostRepository.
+     *
+     * @example
+     * ```typescript
+     * const user = await users.get(User.ref`${userId}`)  // Type-safe!
+     * ```
+     */
+    abstract get(ref: Ref<T>): Promise<Persistent<T> | undefined>;
+    /**
+     * Get multiple entities by their references.
+     * Batches into a single query where possible.
+     *
+     * @example
+     * ```typescript
+     * const users = await users.getMany([User.ref`1`, User.ref`2`])
+     * ```
+     */
+    abstract getMany(refs: Ref<T>[]): Promise<Persistent<T>[]>;
+    /**
+     * Find a single entity matching the condition.
+     * Returns undefined if not found.
+     *
+     * @example
+     * ```typescript
+     * const user = await userRepo.findOne(User.fields.email.eq('alice@example.com'));
+     * ```
+     */
+    abstract findOne(where: Condition): Promise<Persistent<T> | undefined>;
+    /**
+     * Count entities matching the given condition.
+     */
+    abstract count(where?: Condition): Promise<number>;
+    /**
+     * Check if any entity matches the condition.
+     */
+    exists(where: Condition): Promise<boolean>;
+    /**
+     * Run an aggregation query (sum, avg, min, max, count).
+     *
+     * @example
+     * ```typescript
+     * const totalViews = await postRepo.aggregate(
+     *   q.sum('views'),
+     *   Post.fields.published.eq(true),
+     * );
+     * ```
+     */
+    abstract aggregate(agg: Aggregation, where?: Condition): Promise<number | null>;
+    /**
+     * Insert a new entity.
+     *
+     * @example
+     * ```typescript
+     * const user = await userRepo.insert({
+     *   email: 'alice@example.com',
+     *   name: 'Alice',
+     * });
+     * // user is Persistent<User> with id, createdAt, etc.
+     * ```
+     */
+    abstract insert(data: InsertData<T>): Promise<Persistent<T>>;
+    /**
+     * Insert multiple entities.
+     */
+    abstract insertMany(data: InsertData<T>[]): Promise<Persistent<T>[]>;
+    /**
+     * Acquire an exclusive lock on an entity and re-read it from storage.
+     *
+     * Concurrent acquirers (in this process or across cluster instances
+     * when wired with PostgresLockProvider/RedisLockProvider) BLOCK until
+     * the holder releases. The lock is released on `Symbol.asyncDispose`
+     * (preferred — `await using`) or sync `Symbol.dispose` (fire-and-forget).
+     *
+     * Re-reads under the lock so callers see committed state. Returns null
+     * if the row was deleted before/during the acquire.
+     *
+     * Mutators (`update`, `delete`, `save(Locked<T>)`) require the
+     * `__active` flag to still be true; using a `Locked<T>` after its
+     * `using` block exited throws `LockReleasedError`.
+     *
+     * Same async context re-acquiring the same row throws
+     * `DoubleLockError` (when wrapped in `runWithLockTracking`) — this
+     * would deadlock otherwise.
+     *
+     * @returns Locked entity, or null if not found
+     *
+     * @example
+     * ```typescript
+     * await using user = await users.lock(params.user);
+     * if (!user) return res.status(404).json({ error: 'Not found' });
+     * await service.updateProfile(user, data);
+     * // mutex released, lock invalidated when scope exits
+     * ```
+     */
+    abstract lock(entity: Ref<T> | Promise<Persistent<T> | null | undefined>, options?: LockOptions): Promise<Locked<T> | null>;
+    /**
+     * Update a locked entity with partial data.
+     *
+     * Requires a lock - the lock IS your concurrency control.
+     */
+    abstract update(entity: Locked<T>, data: UpdateData<T>): Promise<Persistent<T>>;
+    /**
+     * Save an entity (insert or update).
+     *
+     * - New entity (`T` / `Transient<T>`) → insert
+     * - Locked entity (`Locked<T>`) → update
+     */
+    abstract save(entity: T | Transient<T>): Promise<Persistent<T>>;
+    abstract save(entity: Locked<T>): Promise<Persistent<T>>;
+    abstract save(entity: T | Transient<T> | Locked<T>): Promise<Persistent<T>>;
+    /**
+     * Delete a locked entity.
+     *
+     * Requires a lock to ensure no concurrent mutations during deletion.
+     *
+     * @returns true if deleted, false if not found
+     */
+    abstract delete(entity: Locked<T>): Promise<boolean>;
+    /**
+     * Delete entities matching a condition.
+     *
+     * @returns Number of deleted entities
+     */
+    abstract deleteWhere(where: Condition): Promise<number>;
+    /**
+     * Create a durable iterator for use in process for-of loops.
+     * Uses keyset pagination to support suspend/resume across process restarts.
+     *
+     * `orderBy` is required - durable iteration needs deterministic ordering
+     * for keyset pagination to work correctly.
+     *
+     * @example
+     * ```typescript
+     * for (const order of orders.iterate({
+     *   where: Order.fields.status.eq('pending'),
+     *   orderBy: { createdAt: 'asc' },
+     * })) {
+     *   await signal(fulfillment.shipped)
+     * }
+     * ```
+     */
+    abstract iterate(options: FindOptions<T> & {
+        orderBy: OrderBy<T>;
+    }): DurableQueryIterable<Persistent<T>>;
+    /**
+     * Stream entities matching the condition.
+     * Yields one entity at a time for memory-efficient processing.
+     *
+     * @example
+     * ```typescript
+     * for await (const user of userRepo.stream({ where: status.eq('active') })) {
+     *   await processUser(user);
+     * }
+     * ```
+     */
+    abstract stream(options?: FindOptions<T>): AsyncIterable<Persistent<T>>;
+    /**
+     * Stream entities in batches.
+     * More efficient than streaming one at a time for bulk operations.
+     *
+     * @example
+     * ```typescript
+     * for await (const batch of userRepo.streamBatches({ batchSize: 100 })) {
+     *   await processBatch(batch);
+     * }
+     * ```
+     */
+    abstract streamBatches(options?: FindOptions<T> & {
+        batchSize?: number;
+    }): AsyncIterable<Persistent<T>[]>;
+    /**
+     * Observe changes to an entity.
+     *
+     * Returns an async iterable that yields whenever the entity is updated
+     * from any instance (including other nodes in the cluster).
+     *
+     * The entity object is mutated in-place via the identity map, so you
+     * can also just access the original reference after yielding.
+     *
+     * @example
+     * ```typescript
+     * const user = await userRepo.get(User.ref`123`);
+     *
+     * // Observe changes from anywhere
+     * for await (const _ of userRepo.observe(user)) {
+     *   console.log('User updated:', user.name); // same object, mutated
+     * }
+     *
+     * // Also works with references
+     * for await (const author of userRepo.observe(post.author)) {
+     *   console.log('Author updated:', author.name);
+     * }
+     * ```
+     */
+    abstract observe(entity: Ref<T>): AsyncIterable<Persistent<T>>;
+    /**
+     * Get a DI token for a model's repository.
+     *
+     * Tokens are memoized - same model always returns same token object.
+     * This enables object identity comparison for DI container lookups.
+     *
+     * If the model has a repository contract (via .withRepository()), the token
+     * type includes those custom methods.
+     *
+     * @example
+     * ```typescript
+     * const token = ModelRepository.of(User);
+     *
+     * // Same model = same token (object identity)
+     * ModelRepository.of(User) === ModelRepository.of(User)  // true
+     *
+     * // Different models = different tokens
+     * ModelRepository.of(User) === ModelRepository.of(Post)  // false
+     *
+     * // With custom contract
+     * const UserWithRepo = User.withRepository<{
+     *   findByEmail(email: string): Promise<User | null>;
+     * }>();
+     * const token = ModelRepository.of(UserWithRepo);
+     * // token type includes findByEmail method
+     * ```
+     */
+    static of<M extends AnyModel>(model: M): ModelRepositoryToken<ModelInstanceType<M>, ExtractContract<M>>;
+}
+/**
+ * Check if a value is a ModelRepository token.
+ */
+export declare function isModelRepositoryToken(value: unknown): value is ModelRepositoryToken<unknown>;
+//# sourceMappingURL=model.repository.d.ts.map

package/dist/models/model.repository.d.ts.map

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