@archlast/server 0.0.1

package/dist/repository/db-set.d.ts

@@ -0,0 +1,220 @@
+/**
+ * DbSet Implementation
+ *
+ * DbSet extends MutableQueryable with EF Core-style change tracking methods.
+ * It provides:
+ * - Tracked operations: Add(), AddRange(), Remove(), Update() - track changes until SaveChangesAsync()
+ * - Immediate operations: ExecuteUpdateAsync(), ExecuteDeleteAsync() - bypass change tracking
+ * - Tracking control: AsNoTracking() - returns a queryable without change tracking
+ *
+ * @module repository/db-set
+ */
+import type { IDatabaseClient } from "../db/interfaces.js";
+import type { IMutableQueryable, IQueryable, IOrderedMutableQueryable, IAsyncEnumerable, QueryExpression, WhereInput, OrderByInput } from "./interfaces.js";
+import type { QueryProvider } from "./provider.js";
+import { ChangeTracker, EntityEntry } from "./ef-core.js";
+/**
+ * DbSet extends MutableQueryable with EF Core-style change tracking methods
+ * @template T - The full entity type from DataModel
+ * @template TCreateInput - The input type for creating entities (excludes auto-generated fields)
+ * @template TUpdateInput - The input type for updating entities (excludes read-only fields)
+ */
+export declare class DbSet<T, TCreateInput = Omit<T, "_id" | "_collection">, TUpdateInput = Partial<Omit<T, "_id" | "_collection">>> implements IMutableQueryable<T, TCreateInput> {
+    private readonly _queryable;
+    private readonly _db;
+    private readonly _collection;
+    private readonly _changeTracker;
+    private readonly _provider;
+    private readonly _sourceExpr;
+    constructor(_queryable: IMutableQueryable<T>, _db: IDatabaseClient<any>, _collection: string, _changeTracker: ChangeTracker, _provider: QueryProvider<any>, _sourceExpr: QueryExpression<T>);
+    get Provider(): any;
+    get Expression(): QueryExpression<T>;
+    get ElementType(): T;
+    Where(where: WhereInput<T>): IMutableQueryable<T>;
+    Select<TResult>(selector: (item: T) => TResult): IMutableQueryable<TResult>;
+    Include(include: any): IMutableQueryable<T>;
+    OrderBy(orderBy: OrderByInput<T>): IOrderedMutableQueryable<T>;
+    OrderByDescending(orderBy: OrderByInput<T>): IOrderedMutableQueryable<T>;
+    SelectMany<TResult>(selector: any): IMutableQueryable<TResult>;
+    GroupBy<TKey, TElement = T, TResult = any>(keySelector: any, elementSelector?: any, resultSelector?: any): any;
+    Join<TInner, TKey, TResult>(inner: any, outerKeySelector: any, innerKeySelector: any, resultSelector: any): any;
+    Take(count: number): IMutableQueryable<T>;
+    Skip(count: number): IMutableQueryable<T>;
+    Distinct<TKey>(keySelector?: any): IMutableQueryable<T>;
+    Union(other: any): IMutableQueryable<T>;
+    Intersect(other: any): IMutableQueryable<T>;
+    Except(other: any): IMutableQueryable<T>;
+    ExecuteAsync(): Promise<T[]>;
+    FirstAsync(predicate?: any): Promise<T>;
+    FirstOrDefaultAsync(predicate?: any): Promise<T | undefined>;
+    SingleAsync(predicate?: any): Promise<T>;
+    SingleOrDefaultAsync(predicate?: any): Promise<T | undefined>;
+    LastAsync(predicate?: any): Promise<T>;
+    LastOrDefaultAsync(predicate?: any): Promise<T | undefined>;
+    AnyAsync(predicate?: any): Promise<boolean>;
+    AllAsync(predicate: any): Promise<boolean>;
+    CountAsync(predicate?: any): Promise<number>;
+    LongCountAsync(predicate?: any): Promise<number>;
+    SumAsync(selector?: any): Promise<number>;
+    AverageAsync(selector?: any): Promise<number>;
+    MinAsync<TResult>(selector?: any): Promise<TResult>;
+    MaxAsync<TResult>(selector?: any): Promise<TResult>;
+    ToArrayAsync(): Promise<T[]>;
+    ToListAsync(): Promise<any>;
+    ForEachAsync(action: any): Promise<void>;
+    AggregateAsync<TAccumulate>(seed: TAccumulate, func: any): Promise<TAccumulate>;
+    ContainsAsync(item: T): Promise<boolean>;
+    ToEnumerable(): Promise<any>;
+    /**
+     * Insert a single entity immediately (bypasses change tracking)
+     * Accepts either the CreateInput type or the full entity type
+     * Auto-generates createdAt and updatedAt timestamps if not provided
+     */
+    Insert(data: TCreateInput | Omit<T, "_id" | "_collection">): Promise<string>;
+    /**
+     * Insert multiple entities immediately (bypasses change tracking)
+     * Accepts an array of CreateInput types or full entity types
+     * Auto-generates createdAt and updatedAt timestamps if not provided
+     */
+    InsertMany(data: (TCreateInput | Omit<T, "_id" | "_collection">)[]): Promise<string[]>;
+    /**
+     * Update multiple entities immediately (bypasses change tracking)
+     * Auto-updates updatedAt timestamp
+     */
+    UpdateMany(data: Partial<Omit<T, "_id" | "_collection">>): Promise<number>;
+    DeleteMany(): Promise<number>;
+    /**
+     * Helper method to track collection writes for reactivity
+     * Called by immediate operations (Insert, InsertMany, UpdateMany, DeleteMany)
+     */
+    private trackCollectionWrite;
+    RunTransaction<R>(fn: (repo: IMutableQueryable<T>) => Promise<R>): Promise<R>;
+    /**
+     * Add an entity to be tracked as Added
+     * Accepts either the full entity type or the CreateInput type
+     * Changes will be saved when SaveChangesAsync() is called
+     * Auto-generates createdAt and updatedAt timestamps if not provided
+     * @returns EntityEntry<T> for tracking the entity state
+     */
+    Add(entity: T | TCreateInput): EntityEntry<T>;
+    /**
+     * Add multiple entities to be tracked as Added
+     * Accepts an array of full entities or CreateInput types
+     * Changes will be saved when SaveChangesAsync() is called
+     * @returns Array of EntityEntry<T> for tracking the entity states
+     */
+    AddRange(entities: (T | TCreateInput)[]): EntityEntry<T>[];
+    /**
+     * Remove an entity (marks it as Deleted)
+     * Changes will be saved when SaveChangesAsync() is called
+     * @throws Error if entity has no _id (can't delete unsaved entities)
+     */
+    Remove(entity: T): EntityEntry<T> | undefined;
+    /**
+     * Update an entity (marks it as Modified)
+     * Accepts either the full entity type or the UpdateInput type
+     * Changes will be saved when SaveChangesAsync() is called
+     * Auto-updates updatedAt timestamp
+     * @throws Error if entity has no _id (can't update unsaved entities)
+     */
+    Update(entity: T | TUpdateInput): EntityEntry<T> | undefined;
+    /**
+     * Find an entity by primary key asynchronously
+     * First checks the ChangeTracker cache for performance
+     * Falls back to database query if not tracked
+     * Automatically tracks entities retrieved from database as Unchanged
+     *
+     * @param id - Primary key of the entity to find
+     * @returns The entity if found, undefined otherwise
+     *
+     * @example
+     * const task = await repository.tasks.FindAsync("task123");
+     * if (task) {
+     *   console.log(task.text);
+     * }
+     */
+    FindAsync(id: string): Promise<T | undefined>;
+    /**
+     * Find an entity by primary key synchronously (ChangeTracker only)
+     * Does NOT query the database - only checks tracked entities
+     *
+     * @param id - Primary key of the entity to find
+     * @returns The tracked entity if found, undefined otherwise
+     *
+     * @example
+     * const task = repository.tasks.Find("task123");
+     * if (task) {
+     *   // Entity is already tracked
+     *   console.log(task.text);
+     * }
+     */
+    Find(id: string): T | undefined;
+    /**
+     * Attach an existing entity to be tracked as Unchanged
+     * Useful for selective updates - attach, modify specific fields, then SaveChangesAsync
+     *
+     * @param entity - The entity to attach (must have _id)
+     * @returns EntityEntry for tracking the entity state
+     * @throws Error if entity has no _id
+     *
+     * @example
+     * const task = { _id: "task123", text: "Updated text", completed: false };
+     * repository.tasks.Attach(task);
+     * task.text = "New updated text";
+     * await repository.SaveChangesAsync();
+     * // Only UPDATE is generated, not INSERT
+     */
+    Attach(entity: T): EntityEntry<T>;
+    /**
+     * Attach multiple existing entities to be tracked as Unchanged
+     * Useful for batch selective updates
+     *
+     * @param entities - Array of entities to attach (must all have _id)
+     * @returns Array of EntityEntry for tracking entity states
+     * @throws Error if any entity has no _id
+     *
+     * @example
+     * const tasks = [
+     *   { _id: "task1", text: "Update 1" },
+     *   { _id: "task2", text: "Update 2" }
+     * ];
+     * repository.tasks.AttachRange(tasks);
+     * tasks[0].text = "Modified";
+     * await repository.SaveChangesAsync();
+     */
+    AttachRange(entities: T[]): EntityEntry<T>[];
+    /**
+     * Execute an update immediately, bypassing change tracking
+     * Accepts either the UpdateInput type or Partial<T>
+     * Uses UpdateMany for direct database update
+     * @returns Number of entities affected
+     */
+    ExecuteUpdateAsync(update: TUpdateInput | Partial<Omit<T, "_id" | "_collection">>): Promise<number>;
+    /**
+     * Execute a delete immediately, bypassing change tracking
+     * Uses DeleteMany for direct database deletion
+     * @returns Number of entities deleted
+     */
+    ExecuteDeleteAsync(): Promise<number>;
+    /**
+     * Return a queryable without change tracking
+     * Useful for read-only queries where you don't need to track changes
+     */
+    AsNoTracking(): IQueryable<T>;
+    /**
+     * Returns an IAsyncEnumerable for async streaming without loading all items into memory
+     * Delegates to the underlying queryable's AsAsyncEnumerable
+     */
+    AsAsyncEnumerable(): IAsyncEnumerable<T>;
+    /**
+     * Extract the Where clause from the current query expression
+     * Used by ExecuteUpdateAsync and ExecuteDeleteAsync
+     */
+    private extractWhereClause;
+}
+/**
+ * Factory function to create a DbSet
+ * Used by DbContext to create DbSets for each collection
+ */
+export declare function createDbSet<T, TCreateInput = Omit<T, "_id" | "_collection">, TUpdateInput = Partial<Omit<T, "_id" | "_collection">>>(db: IDatabaseClient<any>, collection: string, changeTracker: ChangeTracker, provider: QueryProvider<any>, sourceExpr: QueryExpression<T>, baseQueryable: IMutableQueryable<T, TCreateInput>): DbSet<T, TCreateInput, TUpdateInput>;
+//# sourceMappingURL=db-set.d.ts.map

package/dist/repository/db-set.d.ts.map

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