@classytic/mongokit 3.21.0 → 3.22.1

package/dist/{PaginationEngine-DYpOD2wY.d.mts → PaginationEngine-CYRTLW6s.d.mts}

@@ -1,4 +1,4 @@
-import { A as KeysetPaginationOptions, U as PaginationConfig, V as OffsetPaginationOptions, i as AnyDocument, n as AggregatePaginationOptions } from "./types-DNFMofHy.mjs";
+import { A as KeysetPaginationOptions, U as PaginationConfig, V as OffsetPaginationOptions, i as AnyDocument, n as AggregatePaginationOptions } from "./types-BnRqAJVa.mjs";
 import { Model } from "mongoose";
 import { AggregatePaginationResult, KeysetPaginationResult, OffsetPaginationResult } from "@classytic/repo-core/pagination";
 //#region src/pagination/PaginationEngine.d.ts

package/dist/{Repository-dbbgOGjK.mjs → Repository-Dr1MDAen.mjs}

@@ -1743,20 +1743,6 @@ function changeEventTimestamp(change) {
 * OBSERVABILITY=300, DEFAULT=500) and the two refs are reference-equal.
 */
 const HOOK_PRIORITY$1 = HOOK_PRIORITY;
-/**
-* Production-grade repository for MongoDB.
-*
-* Extends `@classytic/repo-core/repository`'s `RepositoryBase` for the
-* driver-agnostic hook + plugin plumbing (context builder, priority-sorted
-* event engine, plugin-order validator) while layering every Mongo-specific
-* concern — populate, aggregate, lookup, keyset + cursor pagination, $near
-* rewriting — on top.
-*
-* Public surface is byte-stable with mongokit 3.9 (the `_hooks` property is
-* preserved as a live read-through getter; all CRUD, event, and plugin method
-* signatures unchanged). 3.10 is an internal re-plumbing release; consumers
-* upgrading from 3.9 need no code changes.
-*/
 var Repository = class extends RepositoryBase {
 	/**
 	* Runtime capability descriptor required by `StandardRepo<TDoc>`
@@ -2998,6 +2984,109 @@ var Repository = class extends RepositoryBase {
 		});
 	}
 	/**
+	* State-machine-backed CAS transition with status history — the
+	* canonical domain-verb shape, promoted from the identical helper
+	* every engine package hand-rolled (projects / manufacturing /
+	* assets `claimTransition`).
+	*
+	* One call does the whole liturgy:
+	*
+	*   1. **Legality pre-flight** — `machine.assertTransition(id, from,
+	*      to)` for every source state (sync, throws the DOMAIN's typed
+	*      error via the machine's `errorFactory` — mongokit never
+	*      invents its own transition-error vocabulary).
+	*   2. **Concurrency CAS** — delegates to {@link claim} (multi-source
+	*      `from` arrays compile to `$in`; `where` guards AND-merge;
+	*      tenant scope / soft-delete / cache / audit plugins all fire).
+	*   3. **History append** — `$push`es `{ status: to, occurredAt, by?,
+	*      note? }` onto the history field (default `statusHistory`),
+	*      never read-modify-write on the array. Pass `history: false`
+	*      for models without a trail.
+	*   4. **Race-loss diagnosis** — on CAS miss it re-reads the row and
+	*      throws the ACCURATE error: the machine's own error built from
+	*      the row's CURRENT state when that state makes the move illegal
+	*      (hand-rolled versions threw with the stale pre-read state), a
+	*      404-shaped error when the row vanished, or a 409
+	*      `TRANSITION_RACE_LOST` when the move is still legal from the
+	*      current state (caller may re-read and retry).
+	*
+	* The `machine` parameter is STRUCTURAL (`{ name, assertTransition }`)
+	* — `defineStateMachine()` from `@classytic/primitives/state-machine`
+	* satisfies it without mongokit taking a primitives dependency, and
+	* anything else with the same shape works too.
+	*
+	* @example The common verb tail (replaces ~40 lines of base-repo helper)
+	* ```ts
+	* const updated = await repo.applyTransition(id, WORK_ORDER_MACHINE, {
+	*   from: existing.status,
+	*   to: 'released',
+	*   set: { pendingStock: stamp },
+	*   by: ctx.actorId,
+	* }, repoOptionsFromCtx(ctx));
+	* ```
+	*
+	* @example Multi-source cancel via the machine's reverse lookup
+	* ```ts
+	* await repo.applyTransition(id, MACHINE, {
+	*   from: MACHINE.validSources('cancelled'),
+	*   to: 'cancelled',
+	*   note: reason,
+	* }, opts);
+	* ```
+	*/
+	async applyTransition(id, machine, args, options = {}) {
+		const entityId = String(id);
+		const sources = Array.isArray(args.from) ? args.from : [args.from];
+		for (const from of sources) {
+			if (from === args.to) continue;
+			machine.assertTransition(entityId, from, args.to);
+		}
+		const historyField = args.history === false ? null : args.history ?? "statusHistory";
+		const pushSpec = { ...args.push ?? {} };
+		if (historyField !== null) pushSpec[historyField] = {
+			status: args.to,
+			occurredAt: args.at ?? /* @__PURE__ */ new Date(),
+			...args.by !== void 0 ? { by: args.by } : {},
+			...args.note !== void 0 ? { note: args.note } : {}
+		};
+		const patch = {
+			...args.set !== void 0 && Object.keys(args.set).length > 0 ? { $set: args.set } : {},
+			...Object.keys(pushSpec).length > 0 ? { $push: pushSpec } : {},
+			...args.inc !== void 0 && Object.keys(args.inc).length > 0 ? { $inc: args.inc } : {},
+			...args.unset !== void 0 && Object.keys(args.unset).length > 0 ? { $unset: args.unset } : {}
+		};
+		const updated = await this.claim(id, {
+			from: Array.isArray(args.from) ? args.from : args.from,
+			to: args.to,
+			...args.field !== void 0 ? { field: args.field } : {},
+			...args.where !== void 0 ? { where: args.where } : {}
+		}, patch, options);
+		if (updated) return updated;
+		const current = await this.getById(id, {
+			...options,
+			throwOnNotFound: false
+		});
+		if (!current) throw createError(404, `${machine.name} '${entityId}' not found`, {
+			code: "TRANSITION_TARGET_MISSING",
+			meta: {
+				entityType: machine.name,
+				entityId,
+				to: args.to
+			}
+		});
+		const currentState = (args.field ?? "status").split(".").reduce((acc, key) => acc?.[key], current);
+		if (String(currentState) !== args.to) machine.assertTransition(entityId, String(currentState), args.to);
+		throw createError(409, `${machine.name} '${entityId}' lost the transition race to '${args.to}' (currently '${String(currentState)}'); re-read and retry`, {
+			code: "TRANSITION_RACE_LOST",
+			meta: {
+				entityType: machine.name,
+				entityId,
+				from: String(currentState),
+				to: args.to
+			}
+		});
+	}
+	/**
 	* Optimistic-concurrency CAS via a version stamp.
 	*
 	* Sibling to `claim()` — distinct mental model:

package/dist/actions/index.d.mts

@@ -1,2 +1,2 @@
-import { a as create_d_exports, i as delete_d_exports, n as update_d_exports, o as aggregate_d_exports, r as read_d_exports } from "../index-Cg3SWugF.mjs";
+import { a as create_d_exports, i as delete_d_exports, n as update_d_exports, o as aggregate_d_exports, r as read_d_exports } from "../index-CENL7LRb.mjs";
 export { aggregate_d_exports as aggregate, create_d_exports as create, delete_d_exports as deleteActions, read_d_exports as read, update_d_exports as update };

package/dist/ai/index.d.mts

@@ -1,4 +1,4 @@
-import { G as Plugin } from "../types-DNFMofHy.mjs";
+import { G as Plugin } from "../types-BnRqAJVa.mjs";
 import { PipelineStage } from "mongoose";
 //#region src/ai/types.d.ts
 /** Supported similarity metrics for vector search */

package/dist/better-auth/index.mjs

@@ -1,4 +1,4 @@
-import { n as Repository } from "../Repository-dbbgOGjK.mjs";
+import { n as Repository } from "../Repository-Dr1MDAen.mjs";
 import { n as createMongooseAdapter } from "../adapter-rTPLUrAV.mjs";
 import { pluralizeBetterAuthCollection, resolveBetterAuthCollections } from "@classytic/repo-core/better-auth";
 //#region src/better-auth/index.ts

package/dist/{create-repository-0TkQhcv-.d.mts → create-repository-DXa3nMG6.d.mts}

@@ -1,6 +1,6 @@
-import { B as ObjectId, Dt as LookupOptions, Et as LookupBuilder, H as OperationOptions, J as PopulateSpec, M as LookupPopulateOptions, N as LookupPopulateResult, P as Middleware, Q as RepositoryContext, U as PaginationConfig, X as ReadOptions, Y as PrioritizedHook, Z as ReadPreferenceType, _ as DeleteManyResult, at as SessionOptions, c as CacheableOptions, d as CollationOptions, ft as UpdateManyResult, it as SelectSpec, j as Logger, n as AggregatePaginationOptions, nt as RepositoryOptions, p as CreateOptions, pt as UpdateOptions, q as PluginType, st as SoftDeleteOptions, t as AggregateOptions, ut as SortSpec$1, v as DeleteResult, w as FindOneAndUpdateOptions, xt as WithTransactionOptions } from "./types-DNFMofHy.mjs";
-import { _ as RepositoryCachePluginOptions, i as CustomIdOptions, t as MultiTenantOptions, w as AuditTrailOptions } from "./multi-tenant.plugin-CTsWz0XK.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-DYpOD2wY.mjs";
+import { B as ObjectId, Dt as LookupOptions, Et as LookupBuilder, H as OperationOptions, J as PopulateSpec, M as LookupPopulateOptions, N as LookupPopulateResult, P as Middleware, Q as RepositoryContext, U as PaginationConfig, X as ReadOptions, Y as PrioritizedHook, Z as ReadPreferenceType, _ as DeleteManyResult, at as SessionOptions, c as CacheableOptions, d as CollationOptions, ft as UpdateManyResult, it as SelectSpec, j as Logger, n as AggregatePaginationOptions, nt as RepositoryOptions, p as CreateOptions, pt as UpdateOptions, q as PluginType, st as SoftDeleteOptions, t as AggregateOptions, ut as SortSpec$1, v as DeleteResult, w as FindOneAndUpdateOptions, xt as WithTransactionOptions } from "./types-BnRqAJVa.mjs";
+import { _ as RepositoryCachePluginOptions, i as CustomIdOptions, t as MultiTenantOptions, w as AuditTrailOptions } from "./multi-tenant.plugin-CFzMOuZP.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-CYRTLW6s.mjs";
 import { AggPaginationRequest, AggRequest, AggResult, ArchiveOptions, ArchiveResult, ArchiveSink, ChangeEvent, FilterInput, KeysetAggPaginationResult, QueryOptions, RepoCapabilities, RepositoryBase, TenantPurgeOptions, TenantPurgeResult, TenantPurgeStrategy, WatchOptions } from "@classytic/repo-core/repository";
 import { ClientSession, Expression, Model, PipelineStage, PopulateOptions } from "mongoose";
 import { Filter } from "@classytic/repo-core/filter";
@@ -504,6 +504,19 @@ declare const HOOK_PRIORITY: {
  * signatures unchanged). 3.10 is an internal re-plumbing release; consumers
  * upgrading from 3.9 need no code changes.
  */
+/**
+ * Structural contract {@link Repository.applyTransition} requires of a state
+ * machine. `defineStateMachine()` from
+ * `@classytic/primitives/state-machine` satisfies it as-is — mongokit
+ * deliberately does NOT import primitives; compatibility is structural,
+ * the same policy as the arc event-shape mirror. `assertTransition`
+ * MUST throw (the domain's typed error) on an illegal `from → to`.
+ */
+interface TransitionMachine {
+  /** Aggregate name — surfaces in race/missing error messages. */
+  readonly name: string;
+  assertTransition(entityId: string, from: string, to: string): void;
+}
 declare class Repository<TDoc = unknown> extends RepositoryBase {
   /**
    * Runtime capability descriptor required by `StandardRepo<TDoc>`
@@ -1200,6 +1213,84 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
     idField?: string;
     upsert?: boolean;
   }): Promise<TDoc | null>;
+  /**
+   * State-machine-backed CAS transition with status history — the
+   * canonical domain-verb shape, promoted from the identical helper
+   * every engine package hand-rolled (projects / manufacturing /
+   * assets `claimTransition`).
+   *
+   * One call does the whole liturgy:
+   *
+   *   1. **Legality pre-flight** — `machine.assertTransition(id, from,
+   *      to)` for every source state (sync, throws the DOMAIN's typed
+   *      error via the machine's `errorFactory` — mongokit never
+   *      invents its own transition-error vocabulary).
+   *   2. **Concurrency CAS** — delegates to {@link claim} (multi-source
+   *      `from` arrays compile to `$in`; `where` guards AND-merge;
+   *      tenant scope / soft-delete / cache / audit plugins all fire).
+   *   3. **History append** — `$push`es `{ status: to, occurredAt, by?,
+   *      note? }` onto the history field (default `statusHistory`),
+   *      never read-modify-write on the array. Pass `history: false`
+   *      for models without a trail.
+   *   4. **Race-loss diagnosis** — on CAS miss it re-reads the row and
+   *      throws the ACCURATE error: the machine's own error built from
+   *      the row's CURRENT state when that state makes the move illegal
+   *      (hand-rolled versions threw with the stale pre-read state), a
+   *      404-shaped error when the row vanished, or a 409
+   *      `TRANSITION_RACE_LOST` when the move is still legal from the
+   *      current state (caller may re-read and retry).
+   *
+   * The `machine` parameter is STRUCTURAL (`{ name, assertTransition }`)
+   * — `defineStateMachine()` from `@classytic/primitives/state-machine`
+   * satisfies it without mongokit taking a primitives dependency, and
+   * anything else with the same shape works too.
+   *
+   * @example The common verb tail (replaces ~40 lines of base-repo helper)
+   * ```ts
+   * const updated = await repo.applyTransition(id, WORK_ORDER_MACHINE, {
+   *   from: existing.status,
+   *   to: 'released',
+   *   set: { pendingStock: stamp },
+   *   by: ctx.actorId,
+   * }, repoOptionsFromCtx(ctx));
+   * ```
+   *
+   * @example Multi-source cancel via the machine's reverse lookup
+   * ```ts
+   * await repo.applyTransition(id, MACHINE, {
+   *   from: MACHINE.validSources('cancelled'),
+   *   to: 'cancelled',
+   *   note: reason,
+   * }, opts);
+   * ```
+   */
+  applyTransition(id: string | ObjectId, machine: TransitionMachine, args: {
+    from: string | readonly string[];
+    to: string;
+    /** State field (dotted paths supported) — default `'status'`. */
+    field?: string;
+    /** `$set` payload applied alongside the state write. */
+    set?: Record<string, unknown>;
+    /** Extra `$push` entries merged beside the history append. */
+    push?: Record<string, unknown>;
+    /** `$inc` counters applied alongside the state write. */
+    inc?: Record<string, number>;
+    /** `$unset` paths cleared alongside the state write. */
+    unset?: Record<string, unknown>;
+    /** Additional CAS guards, AND-merged into the filter. */
+    where?: Record<string, unknown>;
+    by?: string;
+    note?: string;
+    /**
+     * History field name (default `'statusHistory'`), or `false` to
+     * skip the append entirely.
+     */
+    history?: string | false;
+    /** Timestamp for the history entry — default `new Date()`. */
+    at?: Date;
+  }, options?: SessionOptions & {
+    idField?: string;
+  }): Promise<TDoc>;
   /**
    * Optimistic-concurrency CAS via a version stamp.
    *
@@ -1754,4 +1845,4 @@ interface CreateRepositoryConfig extends RepositoryOptions {
  */
 declare function createRepository<TDoc>(model: Model<TDoc, any, any, any>, config?: CreateRepositoryConfig): Repository<TDoc>;
 //#endregion
-export { Repository as a, HOOK_PRIORITY as i, CreateRepositoryConfig as n, AggregationBuilder as o, createRepository as r, AuditConfig as t };
+export { Repository as a, HOOK_PRIORITY as i, CreateRepositoryConfig as n, TransitionMachine as o, createRepository as r, AggregationBuilder as s, AuditConfig as t };

package/dist/{create-repository-CJATiAKX.mjs → create-repository-DwODY4rZ.mjs}

@@ -1,5 +1,5 @@
-import { n as Repository } from "./Repository-dbbgOGjK.mjs";
-import { a as methodRegistryPlugin, d as cachePlugin, f as batchOperationsPlugin, h as auditLogPlugin, i as multiTenantPlugin, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, t as timestampPlugin } from "./timestamp.plugin-nG9Z1JEk.mjs";
+import { n as Repository } from "./Repository-Dr1MDAen.mjs";
+import { a as methodRegistryPlugin, d as cachePlugin, f as batchOperationsPlugin, h as auditLogPlugin, i as multiTenantPlugin, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, t as timestampPlugin } from "./timestamp.plugin-Cn6LKUIZ.mjs";
 //#region src/create-repository.ts
 function isLoggerAudit(value) {
 	const v = value;

package/dist/{index-Cg3SWugF.d.mts → index-CENL7LRb.d.mts}

@@ -1,4 +1,4 @@
-import { B as ObjectId, Dt as LookupOptions, H as OperationOptions, I as MinMaxResult, J as PopulateSpec, T as GroupResult, Z as ReadPreferenceType, ft as UpdateManyResult, ht as UpdateWithValidationResult, i as AnyDocument, it as SelectSpec, p as CreateOptions, pt as UpdateOptions, ut as SortSpec, v as DeleteResult, w as FindOneAndUpdateOptions } from "./types-DNFMofHy.mjs";
+import { B as ObjectId, Dt as LookupOptions, H as OperationOptions, I as MinMaxResult, J as PopulateSpec, T as GroupResult, Z as ReadPreferenceType, ft as UpdateManyResult, ht as UpdateWithValidationResult, i as AnyDocument, it as SelectSpec, p as CreateOptions, pt as UpdateOptions, ut as SortSpec, v as DeleteResult, w as FindOneAndUpdateOptions } from "./types-BnRqAJVa.mjs";
 import { Model, PipelineStage } from "mongoose";
 declare namespace aggregate_d_exports {
   export { aggregate, aggregatePaginate, average, countBy, distinct, facet, groupBy, lookup, minMax, sum, unwind };

package/dist/index.d.mts

@@ -1,12 +1,12 @@
-import { $ as RepositoryEvent, A as KeysetPaginationOptions, B as ObjectId, C as FieldPreset, Ct as IControllerResponse, D as InferDocument, Dt as LookupOptions, E as HookMode, Et as LookupBuilder, F as MiddlewareContext, G as Plugin, H as OperationOptions, I as MinMaxResult, J as PopulateSpec, K as PluginFunction, L as MinimalRepoView, M as LookupPopulateOptions, N as LookupPopulateResult, O as InferRawDoc, P as Middleware, Q as RepositoryContext, R as MongoOperatorUpdate, S as EventPhase, St as IController, T as GroupResult, Tt as IResponseFormatter, U as PaginationConfig, V as OffsetPaginationOptions, W as PartialBy, X as ReadOptions, Y as PrioritizedHook, Z as ReadPreferenceType, _t as ValidationChainOptions, a as AnyModel, at as SessionOptions, b as EventHandlers, bt as WithPlugins, c as CacheableOptions, ct as SoftDeleteRepository, d as CollationOptions, dt as Strict, et as RepositoryInstance, f as CreateInput, ft as UpdateManyResult, g as DeepPartial, gt as UserContext, h as DecodedCursor, ht as UpdateWithValidationResult, i as AnyDocument, it as SelectSpec, j as Logger, k as KeysOfType, l as CascadeOptions, lt as SortDirection, m as CursorPayload, mt as UpdatePatch, n as AggregatePaginationOptions, nt as RepositoryOptions, o as BasePaginationOptions, ot as SoftDeleteFilterMode, p as CreateOptions, pt as UpdateOptions, q as PluginType, r as AllPluginMethods, rt as RequiredBy, s as CacheOperationOptions, st as SoftDeleteOptions, t as AggregateOptions, tt as RepositoryOperation, u as CascadeRelation, ut as SortSpec, v as DeleteResult, vt as ValidatorDefinition, w as FindOneAndUpdateOptions, wt as IRequestContext, x as EventPayload, xt as WithTransactionOptions, y as DocField, yt as ValueType, z as NonNullableFields } from "./types-DNFMofHy.mjs";
-import { t as index_d_exports } from "./index-Cg3SWugF.mjs";
-import { C as AuditTrailMethods, E as auditTrailPlugin, S as AuditQueryResult, T as AuditTrailQuery, _ as RepositoryCachePluginOptions, a as DateSequentialIdOptions, b as AuditOperation, c as SequentialIdOptions, d as getNextSequence, f as prefixedId, g as RepositoryCacheHandle, h as CacheOptions, i as CustomIdOptions, l as customIdPlugin, m as CacheAdapter, n as adminBypass, o as IdGenerator, p as sequentialId, r as multiTenantPlugin, s as PrefixedIdOptions, t as MultiTenantOptions, u as dateSequentialId, v as cachePlugin, w as AuditTrailOptions, x as AuditQueryOptions, y as AuditEntry } from "./multi-tenant.plugin-CTsWz0XK.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-DYpOD2wY.mjs";
-import { a as Repository, i as HOOK_PRIORITY, n as CreateRepositoryConfig, o as AggregationBuilder, r as createRepository, t as AuditConfig } from "./create-repository-0TkQhcv-.mjs";
-import { A as BulkWriteResult, C as LeasePluginOptions, D as elasticSearchPlugin, E as ElasticSearchOptions, M as auditLogPlugin, N as AggregateHelpersMethods, O as cascadePlugin, P as aggregateHelpersPlugin, S as LeaseMethods, T as fieldFilterPlugin, _ as observabilityPlugin, a as uniqueField, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as batchOperationsPlugin, k as BatchOperationsMethods, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin } from "./validation-chain.plugin-buy3uvyk.mjs";
+import { $ as RepositoryEvent, A as KeysetPaginationOptions, B as ObjectId, C as FieldPreset, Ct as IControllerResponse, D as InferDocument, Dt as LookupOptions, E as HookMode, Et as LookupBuilder, F as MiddlewareContext, G as Plugin, H as OperationOptions, I as MinMaxResult, J as PopulateSpec, K as PluginFunction, L as MinimalRepoView, M as LookupPopulateOptions, N as LookupPopulateResult, O as InferRawDoc, P as Middleware, Q as RepositoryContext, R as MongoOperatorUpdate, S as EventPhase, St as IController, T as GroupResult, Tt as IResponseFormatter, U as PaginationConfig, V as OffsetPaginationOptions, W as PartialBy, X as ReadOptions, Y as PrioritizedHook, Z as ReadPreferenceType, _t as ValidationChainOptions, a as AnyModel, at as SessionOptions, b as EventHandlers, bt as WithPlugins, c as CacheableOptions, ct as SoftDeleteRepository, d as CollationOptions, dt as Strict, et as RepositoryInstance, f as CreateInput, ft as UpdateManyResult, g as DeepPartial, gt as UserContext, h as DecodedCursor, ht as UpdateWithValidationResult, i as AnyDocument, it as SelectSpec, j as Logger, k as KeysOfType, l as CascadeOptions, lt as SortDirection, m as CursorPayload, mt as UpdatePatch, n as AggregatePaginationOptions, nt as RepositoryOptions, o as BasePaginationOptions, ot as SoftDeleteFilterMode, p as CreateOptions, pt as UpdateOptions, q as PluginType, r as AllPluginMethods, rt as RequiredBy, s as CacheOperationOptions, st as SoftDeleteOptions, t as AggregateOptions, tt as RepositoryOperation, u as CascadeRelation, ut as SortSpec, v as DeleteResult, vt as ValidatorDefinition, w as FindOneAndUpdateOptions, wt as IRequestContext, x as EventPayload, xt as WithTransactionOptions, y as DocField, yt as ValueType, z as NonNullableFields } from "./types-BnRqAJVa.mjs";
+import { t as index_d_exports } from "./index-CENL7LRb.mjs";
+import { C as AuditTrailMethods, E as auditTrailPlugin, S as AuditQueryResult, T as AuditTrailQuery, _ as RepositoryCachePluginOptions, a as DateSequentialIdOptions, b as AuditOperation, c as SequentialIdOptions, d as getNextSequence, f as prefixedId, g as RepositoryCacheHandle, h as CacheOptions, i as CustomIdOptions, l as customIdPlugin, m as CacheAdapter, n as adminBypass, o as IdGenerator, p as sequentialId, r as multiTenantPlugin, s as PrefixedIdOptions, t as MultiTenantOptions, u as dateSequentialId, v as cachePlugin, w as AuditTrailOptions, x as AuditQueryOptions, y as AuditEntry } from "./multi-tenant.plugin-CFzMOuZP.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-CYRTLW6s.mjs";
+import { a as Repository, i as HOOK_PRIORITY, n as CreateRepositoryConfig, o as TransitionMachine, r as createRepository, s as AggregationBuilder, t as AuditConfig } from "./create-repository-DXa3nMG6.mjs";
+import { A as elasticSearchPlugin, C as LeasePluginOptions, D as immutableStatesPlugin, E as ImmutableStatesPluginOptions, F as auditLogPlugin, I as AppendOnlyPluginOptions, L as appendOnlyPlugin, M as BatchOperationsMethods, N as BulkWriteResult, O as fieldFilterPlugin, P as batchOperationsPlugin, R as AggregateHelpersMethods, S as LeaseMethods, T as ImmutableClaimView, _ as observabilityPlugin, a as uniqueField, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as cascadePlugin, k as ElasticSearchOptions, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin, z as aggregateHelpersPlugin } from "./validation-chain.plugin-D-EjrYpR.mjs";
 import { n as SchemaPathsLike, t as FieldType$1 } from "./coercion-BjdPX3YF.mjs";
 import { n as SchemaIndexes } from "./indexes-DIjMpYES.mjs";
-import { d as filterResponseData, f as getFieldsForUser, g as parseDuplicateKeyError, h as isDuplicateKeyError, i as configureLogger, m as createError, n as buildCrudSchemasFromMongooseSchema, p as getMongooseProjection, r as createMemoryCache, s as idVariants, t as buildCrudSchemasFromModel, u as createFieldPreset } from "./mongooseToJsonSchema-D2CyAMIC.mjs";
+import { _ as parseDuplicateKeyError, a as configureLogger, c as idVariants, d as createFieldPreset, f as filterResponseData, g as isDuplicateKeyError, h as createError, i as createMemoryCache, m as getMongooseProjection, n as buildCrudSchemasFromModel, p as getFieldsForUser, r as buildCrudSchemasFromMongooseSchema, t as toPlain } from "./to-plain-qzKeAC6z.mjs";
 import { RepoCapabilities } from "@classytic/repo-core/repository";
 import { ClientSession, PipelineStage } from "mongoose";
 //#region src/actions/cascade-references.d.ts
@@ -852,4 +852,4 @@ declare function createOptionsExtractor<TCtx extends Record<string, unknown>>(fi
  */
 declare function systemContext(extra?: SessionOptions): SessionOptions;
 //#endregion
-export { ALL_OPERATIONS, type AggregateHelpersMethods, type AggregateOptions, type AggregatePaginationOptions, AggregationBuilder, type AllPluginMethods, type AnyDocument, type AnyModel, type AuditConfig, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailOptions, AuditTrailQuery, type BasePaginationOptions, type BatchOperationsMethods, type BulkWriteResult, type CacheAdapter, type CacheOperationOptions, type CacheOptions, type CacheableOptions, type CascadeOptions, type CascadePurgeReferencesOptions, type CascadeRelation, type CollationOptions, type CollectionRWLike, type CreateInput, type CreateOptions, type CreateRepositoryConfig, type CursorPayload, type CustomIdOptions, type DateSequentialIdOptions, type DecodedCursor, type DeepPartial, type DeleteResult, type DocField, type ElasticSearchOptions, type EventHandlers, type EventPayload, type EventPhase, type FieldPreset, type FieldType, type FilterQuery, type FindOneAndUpdateOptions, type GroupResult, HOOK_PRIORITY, type HookMode, type IController, type IControllerResponse, type IRequestContext, type IResponseFormatter, type IdGenerator, type InferDocument, type InferRawDoc, type KeysOfType, type KeysetPaginationOptions, type LeaseMethods, type LeasePluginOptions, type Logger, LookupBuilder, type LookupOptions, type LookupPopulateOptions, type LookupPopulateResult, MONGOKIT_CAPABILITIES, MUTATING_OPERATIONS, type Middleware, type MiddlewareContext, type MinMaxResult, type MinimalRepoView, type MongoOperationsMethods, type MongoOperatorUpdate, type MultiTenantOptions, type NonNullableFields, OP_REGISTRY, type ObjectId, type ObservabilityOptions, type OffsetPaginationOptions, type OperationDescriptor, type OperationMetric, type OperationOptions, type PaginationConfig, PaginationEngine, type ParsedQuery, type PartialBy, type Plugin, type PluginFunction, type PluginType, type PolicyKey, type PopulateOption, type PopulateSpec, type PrefixedIdOptions, type PrioritizedHook, type PurgeMode, type PurgeableRepoLike, QueryParser, type QueryParserOptions, READ_OPERATIONS, type ReadOptions, type ReadPreferenceType, type ReferencePurgeResult, type ReferenceRelation, Repository, Repository as default, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type RepositoryContext, type RepositoryEvent, type RepositoryInstance, type RepositoryOperation, type RepositoryOptions, type RequiredBy, type SchemaLike, type SearchMode, type SelectSpec, type SequentialIdOptions, type SessionOptions, type SoftDeleteFilterMode, type SoftDeleteMethods, type SoftDeleteOptions, type SoftDeleteRepository, type SortDirection, type SortSpec, type Strict, type SubdocumentMethods, type TenantContext, type TenantStore, type UpdateManyResult, type UpdateOptions, type UpdatePatch, type UpdateWithValidationResult, type UserContext, type ValidationChainOptions, type ValidatorDefinition, type ValueType, type WithPlugins, type WithTransactionOptions, index_d_exports as actions, adminBypass, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, cascadePurgeReferences, compileFilterToMongo, configureLogger, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, filterResponseData, getFieldsForUser, getMongooseProjection, getNextSequence, idVariants, immutableField, isDuplicateKeyError, isTransactionUnsupported, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, repoOptionsFromCtx, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, systemContext, timestampPlugin, uniqueField, validationChainPlugin, withTransaction };
+export { ALL_OPERATIONS, type AggregateHelpersMethods, type AggregateOptions, type AggregatePaginationOptions, AggregationBuilder, type AllPluginMethods, type AnyDocument, type AnyModel, type AppendOnlyPluginOptions, type AuditConfig, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailOptions, AuditTrailQuery, type BasePaginationOptions, type BatchOperationsMethods, type BulkWriteResult, type CacheAdapter, type CacheOperationOptions, type CacheOptions, type CacheableOptions, type CascadeOptions, type CascadePurgeReferencesOptions, type CascadeRelation, type CollationOptions, type CollectionRWLike, type CreateInput, type CreateOptions, type CreateRepositoryConfig, type CursorPayload, type CustomIdOptions, type DateSequentialIdOptions, type DecodedCursor, type DeepPartial, type DeleteResult, type DocField, type ElasticSearchOptions, type EventHandlers, type EventPayload, type EventPhase, type FieldPreset, type FieldType, type FilterQuery, type FindOneAndUpdateOptions, type GroupResult, HOOK_PRIORITY, type HookMode, type IController, type IControllerResponse, type IRequestContext, type IResponseFormatter, type IdGenerator, type ImmutableClaimView, type ImmutableStatesPluginOptions, type InferDocument, type InferRawDoc, type KeysOfType, type KeysetPaginationOptions, type LeaseMethods, type LeasePluginOptions, type Logger, LookupBuilder, type LookupOptions, type LookupPopulateOptions, type LookupPopulateResult, MONGOKIT_CAPABILITIES, MUTATING_OPERATIONS, type Middleware, type MiddlewareContext, type MinMaxResult, type MinimalRepoView, type MongoOperationsMethods, type MongoOperatorUpdate, type MultiTenantOptions, type NonNullableFields, OP_REGISTRY, type ObjectId, type ObservabilityOptions, type OffsetPaginationOptions, type OperationDescriptor, type OperationMetric, type OperationOptions, type PaginationConfig, PaginationEngine, type ParsedQuery, type PartialBy, type Plugin, type PluginFunction, type PluginType, type PolicyKey, type PopulateOption, type PopulateSpec, type PrefixedIdOptions, type PrioritizedHook, type PurgeMode, type PurgeableRepoLike, QueryParser, type QueryParserOptions, READ_OPERATIONS, type ReadOptions, type ReadPreferenceType, type ReferencePurgeResult, type ReferenceRelation, Repository, Repository as default, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type RepositoryContext, type RepositoryEvent, type RepositoryInstance, type RepositoryOperation, type RepositoryOptions, type RequiredBy, type SchemaLike, type SearchMode, type SelectSpec, type SequentialIdOptions, type SessionOptions, type SoftDeleteFilterMode, type SoftDeleteMethods, type SoftDeleteOptions, type SoftDeleteRepository, type SortDirection, type SortSpec, type Strict, type SubdocumentMethods, type TenantContext, type TenantStore, type TransitionMachine, type UpdateManyResult, type UpdateOptions, type UpdatePatch, type UpdateWithValidationResult, type UserContext, type ValidationChainOptions, type ValidatorDefinition, type ValueType, type WithPlugins, type WithTransactionOptions, index_d_exports as actions, adminBypass, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, cascadePurgeReferences, compileFilterToMongo, configureLogger, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, filterResponseData, getFieldsForUser, getMongooseProjection, getNextSequence, idVariants, immutableField, immutableStatesPlugin, isDuplicateKeyError, isTransactionUnsupported, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, repoOptionsFromCtx, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, systemContext, timestampPlugin, toPlain, uniqueField, validationChainPlugin, withTransaction };

package/dist/index.mjs

@@ -1,18 +1,18 @@
 import { n as idVariants } from "./id-resolution-P2OzcyRl.mjs";
-import { a as withTransaction, c as MUTATING_OPERATIONS, d as operationsByPolicyKey, f as MONGOKIT_CAPABILITIES, i as isTransactionUnsupported, l as OP_REGISTRY, n as Repository, o as AggregationBuilder, p as createMongoPurgePort, r as batchTransaction, s as ALL_OPERATIONS, t as HOOK_PRIORITY, u as READ_OPERATIONS } from "./Repository-dbbgOGjK.mjs";
+import { a as withTransaction, c as MUTATING_OPERATIONS, d as operationsByPolicyKey, f as MONGOKIT_CAPABILITIES, i as isTransactionUnsupported, l as OP_REGISTRY, n as Repository, o as AggregationBuilder, p as createMongoPurgePort, r as batchTransaction, s as ALL_OPERATIONS, t as HOOK_PRIORITY, u as READ_OPERATIONS } from "./Repository-Dr1MDAen.mjs";
 import { b as LookupBuilder, x as compileFilterToMongo } from "./update-1Lq9OMD2.mjs";
 import { n as warn, t as configureLogger } from "./logger-K7dPmu2U.mjs";
 import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-BuByZwKU.mjs";
 import { t as actions_exports } from "./actions/index.mjs";
-import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, h as auditLogPlugin, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, r as adminBypass, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "./timestamp.plugin-nG9Z1JEk.mjs";
+import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, h as auditLogPlugin, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, r as adminBypass, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "./timestamp.plugin-Cn6LKUIZ.mjs";
 import { t as PaginationEngine } from "./PaginationEngine-BT1ywu9k.mjs";
 import { isGeoOperator, parseGeoFilter } from "./query/primitives/geo.mjs";
-import { t as createRepository } from "./create-repository-CJATiAKX.mjs";
-import { a as uniqueField, c as subdocumentPlugin, d as leasePlugin, f as fieldFilterPlugin, h as aggregateHelpersPlugin, i as requireField, l as observabilityPlugin, m as cascadePlugin, n as blockIf, o as validationChainPlugin, p as elasticSearchPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as mongoOperationsPlugin } from "./validation-chain.plugin-Dn_wZYLA.mjs";
+import { t as createRepository } from "./create-repository-DwODY4rZ.mjs";
+import { _ as aggregateHelpersPlugin, a as uniqueField, c as subdocumentPlugin, d as leasePlugin, f as immutableStatesPlugin, g as appendOnlyPlugin, h as cascadePlugin, i as requireField, l as observabilityPlugin, m as elasticSearchPlugin, n as blockIf, o as validationChainPlugin, p as fieldFilterPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as mongoOperationsPlugin } from "./validation-chain.plugin-D6qWMH5d.mjs";
 import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "./field-selection-FSQFLpsU.mjs";
 import { buildFieldTypeMap, coerceFieldValue, coerceHeuristic } from "./query/primitives/coercion.mjs";
 import { extractSchemaIndexes } from "./query/primitives/indexes.mjs";
-import { t as createMemoryCache } from "./memory-cache-DI1jb4dz.mjs";
+import { n as createMemoryCache, t as toPlain } from "./to-plain-vksRrLtc.mjs";
 import { n as buildCrudSchemasFromMongooseSchema, t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-CVnrKFDq.mjs";
 import { runChunkedPurge } from "@classytic/repo-core/repository";
 import { isControlParam } from "@classytic/repo-core/query-parser";
@@ -1462,4 +1462,4 @@ function systemContext(extra) {
 */
 var src_default = Repository;
 //#endregion
-export { ALL_OPERATIONS, AggregationBuilder, AuditTrailQuery, HOOK_PRIORITY, LookupBuilder, MONGOKIT_CAPABILITIES, MUTATING_OPERATIONS, OP_REGISTRY, PaginationEngine, QueryParser, READ_OPERATIONS, Repository, actions_exports as actions, adminBypass, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, cascadePurgeReferences, compileFilterToMongo, configureLogger, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, src_default as default, elasticSearchPlugin, fieldFilterPlugin, filterResponseData, getFieldsForUser, getMongooseProjection, getNextSequence, idVariants, immutableField, isDuplicateKeyError, isTransactionUnsupported, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, repoOptionsFromCtx, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, systemContext, timestampPlugin, uniqueField, validationChainPlugin, withTransaction };
+export { ALL_OPERATIONS, AggregationBuilder, AuditTrailQuery, HOOK_PRIORITY, LookupBuilder, MONGOKIT_CAPABILITIES, MUTATING_OPERATIONS, OP_REGISTRY, PaginationEngine, QueryParser, READ_OPERATIONS, Repository, actions_exports as actions, adminBypass, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, cascadePurgeReferences, compileFilterToMongo, configureLogger, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, src_default as default, elasticSearchPlugin, fieldFilterPlugin, filterResponseData, getFieldsForUser, getMongooseProjection, getNextSequence, idVariants, immutableField, immutableStatesPlugin, isDuplicateKeyError, isTransactionUnsupported, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, repoOptionsFromCtx, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, systemContext, timestampPlugin, toPlain, uniqueField, validationChainPlugin, withTransaction };

package/dist/{multi-tenant.plugin-CTsWz0XK.d.mts → multi-tenant.plugin-CFzMOuZP.d.mts}

@@ -1,4 +1,4 @@
-import { B as ObjectId, G as Plugin, Q as RepositoryContext } from "./types-DNFMofHy.mjs";
+import { B as ObjectId, G as Plugin, Q as RepositoryContext } from "./types-BnRqAJVa.mjs";
 import mongoose from "mongoose";
 import { CacheAdapter as CacheAdapter$1, CacheOptions, RepositoryCacheHandle, RepositoryCachePluginOptions, cachePlugin } from "@classytic/repo-core/cache";
 import { TenantConfig } from "@classytic/repo-core/tenant";

package/dist/pagination/PaginationEngine.d.mts

@@ -1,2 +1,2 @@
-import { t as PaginationEngine } from "../PaginationEngine-DYpOD2wY.mjs";
+import { t as PaginationEngine } from "../PaginationEngine-CYRTLW6s.mjs";
 export { PaginationEngine };

package/dist/plugins/index.d.mts

@@ -1,6 +1,6 @@
-import { G as Plugin } from "../types-DNFMofHy.mjs";
-import { C as AuditTrailMethods, E as auditTrailPlugin, S as AuditQueryResult, T as AuditTrailQuery, _ as RepositoryCachePluginOptions, a as DateSequentialIdOptions, b as AuditOperation, c as SequentialIdOptions, d as getNextSequence, f as prefixedId, g as RepositoryCacheHandle, h as CacheOptions, i as CustomIdOptions, l as customIdPlugin, m as CacheAdapter, o as IdGenerator, p as sequentialId, r as multiTenantPlugin, s as PrefixedIdOptions, t as MultiTenantOptions, u as dateSequentialId, v as cachePlugin, w as AuditTrailOptions, x as AuditQueryOptions, y as AuditEntry } from "../multi-tenant.plugin-CTsWz0XK.mjs";
-import { C as LeasePluginOptions, D as elasticSearchPlugin, E as ElasticSearchOptions, M as auditLogPlugin, N as AggregateHelpersMethods, O as cascadePlugin, P as aggregateHelpersPlugin, S as LeaseMethods, T as fieldFilterPlugin, _ as observabilityPlugin, a as uniqueField, b as MethodRegistryRepository, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as batchOperationsPlugin, k as BatchOperationsMethods, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin } from "../validation-chain.plugin-buy3uvyk.mjs";
+import { G as Plugin } from "../types-BnRqAJVa.mjs";
+import { C as AuditTrailMethods, E as auditTrailPlugin, S as AuditQueryResult, T as AuditTrailQuery, _ as RepositoryCachePluginOptions, a as DateSequentialIdOptions, b as AuditOperation, c as SequentialIdOptions, d as getNextSequence, f as prefixedId, g as RepositoryCacheHandle, h as CacheOptions, i as CustomIdOptions, l as customIdPlugin, m as CacheAdapter, o as IdGenerator, p as sequentialId, r as multiTenantPlugin, s as PrefixedIdOptions, t as MultiTenantOptions, u as dateSequentialId, v as cachePlugin, w as AuditTrailOptions, x as AuditQueryOptions, y as AuditEntry } from "../multi-tenant.plugin-CFzMOuZP.mjs";
+import { A as elasticSearchPlugin, C as LeasePluginOptions, D as immutableStatesPlugin, E as ImmutableStatesPluginOptions, F as auditLogPlugin, I as AppendOnlyPluginOptions, L as appendOnlyPlugin, M as BatchOperationsMethods, O as fieldFilterPlugin, P as batchOperationsPlugin, R as AggregateHelpersMethods, S as LeaseMethods, T as ImmutableClaimView, _ as observabilityPlugin, a as uniqueField, b as MethodRegistryRepository, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as cascadePlugin, k as ElasticSearchOptions, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin, z as aggregateHelpersPlugin } from "../validation-chain.plugin-D-EjrYpR.mjs";
 import { ChangeLogStore } from "@classytic/repo-core/sync";
 //#region src/plugins/change-log.plugin.d.ts
 interface ChangeLogPluginOptions {
@@ -15,4 +15,4 @@ interface ChangeLogPluginOptions {
 }
 declare function changeLogPlugin(options: ChangeLogPluginOptions): Plugin;
 //#endregion
-export { type AggregateHelpersMethods, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailOptions, AuditTrailQuery, type BatchOperationsMethods, type CacheAdapter, type CacheOptions, type ChangeLogPluginOptions, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type IdGenerator, type LeaseMethods, type LeasePluginOptions, type MethodRegistryRepository, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, type TenantContext, type TenantStore, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+export { type AggregateHelpersMethods, type AppendOnlyPluginOptions, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailOptions, AuditTrailQuery, type BatchOperationsMethods, type CacheAdapter, type CacheOptions, type ChangeLogPluginOptions, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type IdGenerator, type ImmutableClaimView, type ImmutableStatesPluginOptions, type LeaseMethods, type LeasePluginOptions, type MethodRegistryRepository, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, type TenantContext, type TenantStore, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/plugins/index.mjs

@@ -1,5 +1,5 @@
-import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, h as auditLogPlugin, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "../timestamp.plugin-nG9Z1JEk.mjs";
-import { a as uniqueField, c as subdocumentPlugin, d as leasePlugin, f as fieldFilterPlugin, h as aggregateHelpersPlugin, i as requireField, l as observabilityPlugin, m as cascadePlugin, n as blockIf, o as validationChainPlugin, p as elasticSearchPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as mongoOperationsPlugin } from "../validation-chain.plugin-Dn_wZYLA.mjs";
+import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, h as auditLogPlugin, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "../timestamp.plugin-Cn6LKUIZ.mjs";
+import { _ as aggregateHelpersPlugin, a as uniqueField, c as subdocumentPlugin, d as leasePlugin, f as immutableStatesPlugin, g as appendOnlyPlugin, h as cascadePlugin, i as requireField, l as observabilityPlugin, m as elasticSearchPlugin, n as blockIf, o as validationChainPlugin, p as fieldFilterPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as mongoOperationsPlugin } from "../validation-chain.plugin-D6qWMH5d.mjs";
 //#region src/plugins/change-log.plugin.ts
 const PLUGIN_NAME = "changeLog";
 function isSkipped(context) {
@@ -70,4 +70,4 @@ function changeLogPlugin(options) {
 	};
 }
 //#endregion
-export { AuditTrailQuery, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+export { AuditTrailQuery, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/testkit/index.d.mts

@@ -1,4 +1,4 @@
-import { a as Repository, n as CreateRepositoryConfig } from "../create-repository-0TkQhcv-.mjs";
+import { a as Repository, n as CreateRepositoryConfig } from "../create-repository-DXa3nMG6.mjs";
 import { Connection, Model, Schema } from "mongoose";
 import { MongoMemoryReplSet, MongoMemoryServer } from "mongodb-memory-server";
 //#region src/testkit/index.d.ts

package/dist/testkit/index.mjs

@@ -1,4 +1,4 @@
-import { t as createRepository } from "../create-repository-CJATiAKX.mjs";
+import { t as createRepository } from "../create-repository-DwODY4rZ.mjs";
 import { createConnection } from "mongoose";
 //#region src/testkit/index.ts
 function idempotentStop(server) {

package/dist/{timestamp.plugin-nG9Z1JEk.mjs → timestamp.plugin-Cn6LKUIZ.mjs}

@@ -1,4 +1,4 @@
-import { l as OP_REGISTRY, s as ALL_OPERATIONS, t as HOOK_PRIORITY } from "./Repository-dbbgOGjK.mjs";
+import { l as OP_REGISTRY, s as ALL_OPERATIONS, t as HOOK_PRIORITY } from "./Repository-Dr1MDAen.mjs";
 import { n as warn } from "./logger-K7dPmu2U.mjs";
 import { t as createError } from "./error-BuByZwKU.mjs";
 import { throwIfAborted, withRetry } from "@classytic/repo-core/repository";

package/dist/{mongooseToJsonSchema-D2CyAMIC.d.mts → to-plain-qzKeAC6z.d.mts}

@@ -1,4 +1,4 @@
-import { C as FieldPreset, gt as UserContext } from "./types-DNFMofHy.mjs";
+import { C as FieldPreset, gt as UserContext } from "./types-BnRqAJVa.mjs";
 import mongoose, { Schema } from "mongoose";
 import { CacheAdapter } from "@classytic/repo-core/cache";
 import { CrudSchemas, SchemaBuilderOptions } from "@classytic/repo-core/schema";
@@ -295,4 +295,33 @@ declare function buildCrudSchemasFromMongooseSchema(mongooseSchema: Schema, opti
  */
 declare function buildCrudSchemasFromModel(mongooseModel: mongoose.Model<unknown>, options?: SchemaBuilderOptions): CrudSchemasFramework;
 //#endregion
-export { IdType as a, isObjectIdInstance as c, filterResponseData as d, getFieldsForUser as f, parseDuplicateKeyError as g, isDuplicateKeyError as h, configureLogger as i, isValidIdForType as l, createError as m, buildCrudSchemasFromMongooseSchema as n, getSchemaIdType as o, getMongooseProjection as p, createMemoryCache as r, idVariants as s, buildCrudSchemasFromModel as t, createFieldPreset as u };
+//#region src/utils/to-plain.d.ts
+/**
+ * Convert a hydrated Mongoose (sub)document to a plain object — the
+ * spread-safety primitive for domain verbs that rebuild embedded lines.
+ *
+ * **The footgun this closes:** spreading a hydrated subdocument
+ * (`{ ...line, consumedQuantity: x }`) spreads its Mongoose INTERNAL
+ * properties (`$__`, `_doc`, ...), not its schema fields. The rebuilt
+ * object then casts to garbage on write — required fields land
+ * `undefined`, and because `findOneAndUpdate` does not run validators
+ * by default, the corrupt lines persist silently. This has bitten every
+ * package that maps over embedded arrays (`components`, `operations`,
+ * `revisions`) to produce an updated copy.
+ *
+ * Rule of thumb: **any `{ ...subdoc }` in a repository verb goes
+ * through `toPlain` first.**
+ *
+ * ```ts
+ * const updated = lines.map((line) => ({
+ *   ...toPlain(line),
+ *   reservedQuantity: reserved.get(line.itemSku) ?? 0,
+ * }));
+ * ```
+ *
+ * Non-documents pass through unchanged, so it is safe to apply
+ * defensively over values that may or may not be hydrated.
+ */
+declare function toPlain<T>(value: T): T;
+//#endregion
+export { parseDuplicateKeyError as _, configureLogger as a, idVariants as c, createFieldPreset as d, filterResponseData as f, isDuplicateKeyError as g, createError as h, createMemoryCache as i, isObjectIdInstance as l, getMongooseProjection as m, buildCrudSchemasFromModel as n, IdType as o, getFieldsForUser as p, buildCrudSchemasFromMongooseSchema as r, getSchemaIdType as s, toPlain as t, isValidIdForType as u };

package/dist/{memory-cache-DI1jb4dz.mjs → to-plain-vksRrLtc.mjs}

@@ -64,4 +64,35 @@ function createMemoryCache(maxEntries = 1e3) {
 	};
 }
 //#endregion
-export { createMemoryCache as t };
+//#region src/utils/to-plain.ts
+/**
+* Convert a hydrated Mongoose (sub)document to a plain object — the
+* spread-safety primitive for domain verbs that rebuild embedded lines.
+*
+* **The footgun this closes:** spreading a hydrated subdocument
+* (`{ ...line, consumedQuantity: x }`) spreads its Mongoose INTERNAL
+* properties (`$__`, `_doc`, ...), not its schema fields. The rebuilt
+* object then casts to garbage on write — required fields land
+* `undefined`, and because `findOneAndUpdate` does not run validators
+* by default, the corrupt lines persist silently. This has bitten every
+* package that maps over embedded arrays (`components`, `operations`,
+* `revisions`) to produce an updated copy.
+*
+* Rule of thumb: **any `{ ...subdoc }` in a repository verb goes
+* through `toPlain` first.**
+*
+* ```ts
+* const updated = lines.map((line) => ({
+*   ...toPlain(line),
+*   reservedQuantity: reserved.get(line.itemSku) ?? 0,
+* }));
+* ```
+*
+* Non-documents pass through unchanged, so it is safe to apply
+* defensively over values that may or may not be hydrated.
+*/
+function toPlain(value) {
+	return value !== null && value !== void 0 && typeof value.toObject === "function" ? value.toObject() : value;
+}
+//#endregion
+export { createMemoryCache as n, toPlain as t };

package/dist/{types-DNFMofHy.d.mts → types-BnRqAJVa.d.mts}

@@ -1101,6 +1101,14 @@ interface SessionOptions {
    * ```
    */
   bypassTenant?: boolean;
+  /**
+   * Per-call escape hatch for `appendOnlyPlugin` — deliberate
+   * maintenance on an immutable-facts collection (backfill repair,
+   * migration). Audited via `after:append-only-bypass`; grep for this
+   * flag the same way you grep `bypassTenant` / `mode: 'hard'`. NOT a
+   * substitute for access control — gate it at the host layer.
+   */
+  bypassAppendOnly?: boolean;
   /** Extensible — plugins can read custom fields from options */
   [key: string]: unknown;
 }

package/dist/usage/index.d.mts

@@ -0,0 +1,23 @@
+import { Connection } from "mongoose";
+import { UsageStore } from "@classytic/repo-core/usage";
+//#region src/usage/index.d.ts
+/** Adapter-construction options. */
+interface MongoUsageStoreOptions {
+  /**
+   * Mongoose connection. Defaults to `mongoose.connection` (the
+   * default global connection). Apps using a named connection pass
+   * it explicitly.
+   */
+  connection?: Connection;
+  /** Collection name. Default `usage_counters`. */
+  collectionName?: string;
+  /** Override the Mongoose model name. Default `MongoUsageCounter`. */
+  modelName?: string;
+}
+/**
+ * Build a Mongo-backed usage store. Idempotent — the underlying model
+ * is registered once per `(connection, modelName)` pair.
+ */
+declare function createMongoUsageStore(options?: MongoUsageStoreOptions): UsageStore;
+//#endregion
+export { MongoUsageStoreOptions, createMongoUsageStore };