@classytic/mongokit 3.43.0 → 3.44.0

package/dist/{operations-XiFgG5US.d.mts → operations-Dw9OFV0V.d.mts}

@@ -1,8 +1,7 @@
-import { A as ObjectId, F as SortSpec, M as ReadPreferenceType, N as SelectSpec, b as WriteConcernSpec, i as CountStrategy, j as PopulateSpec, r as CollationOptions, v as ReadConcernLevel } from "./pagination-D6psses0.mjs";
+import { A as ObjectId, F as SortSpec, M as ReadPreferenceType, N as SelectSpec, b as WriteConcernSpec, i as CountStrategy, j as PopulateSpec, r as CollationOptions, v as ReadConcernLevel } from "./pagination-DAUg5zOY.mjs";
 import { DeleteManyResult, DeleteResult, LookupPopulateResult, UpdateManyResult } from "@classytic/repo-core/repository";
 import { PipelineStage, PopulateOptions } from "mongoose";
 import { Filter } from "@classytic/repo-core/filter";
-//#region src/query/LookupBuilder.d.ts
 interface LookupOptions {
   /** Collection to join with */
   from: string;
@@ -238,8 +237,6 @@ declare class LookupBuilder {
  *    - For read-heavy workloads: Consider caching or materialized views
  *    - For real-time dashboards: Consider separate aggregation collections
  */
-//#endregion
-//#region src/types/operations.d.ts
 /** Session-only options — shared base for lightweight operations */
 interface SessionOptions {
   /** MongoDB session for transactions */
@@ -312,6 +309,19 @@ interface SessionOptions {
    * substitute for access control — gate it at the host layer.
    */
   bypassAppendOnly?: boolean;
+  /**
+   * Audited retention purge, the one public path past the integrity fences:
+   * on `delete` / `deleteMany` with `mode: 'hard'`, `appendOnlyPlugin` and
+   * `immutableStatesPlugin` built with `allowPurge: true` let this call
+   * through and emit `after:append-only-purge` /
+   * `after:immutable-states-purge`. `reason` is required. Ignored by every
+   * other op (rows never become editable through it). `purgeByFilter` /
+   * `purgeByField` take the same option and forward it to each chunk.
+   */
+  retentionPurge?: {
+    reason: string;
+    actor?: string | undefined;
+  };
   /** Write concern for this call; beats `queryDefaults.writeConcern`. Ignored by reads. */
   writeConcern?: WriteConcernSpec;
   /** Extensible — plugins can read custom fields from options */
@@ -555,5 +565,4 @@ interface GetByIdsOptions extends OperationOptions {
   /** Return `Array<TDoc | undefined>` aligned with the input ids instead of a Map. */
   preserveOrder?: boolean;
 }
-//#endregion
 export { LookupOptions as S, SessionOptions as _, ConvenientTransactionOptions as a, WithTransactionOptions as b, DeleteResult as c, GroupResult as d, LookupPopulateOptions as f, ReadOptions as g, OperationOptions as h, CacheableOptions as i, FindOneAndUpdateOptions as l, MinMaxResult as m, AggregateOptions as n, CreateOptions as o, LookupPopulateResult as p, CacheOperationOptions as r, DeleteManyResult as s, AggregateCallOptions as t, GetByIdsOptions as u, UpdateManyResult as v, LookupBuilder as x, UpdateOptions as y };

package/dist/outbox/index.d.mts

@@ -1,9 +1,9 @@
-import { r as Repository } from "../Repository-DnL4xk5w.mjs";
+import { r as Repository } from "../Repository-B6oL6OMv.mjs";
+import { u as PaginationConfig } from "../pagination-DAUg5zOY.mjs";
 import { Connection, Model } from "mongoose";
-//#region src/outbox/index.d.ts
 /** Delivery states. `dead_letter` is terminal and operator-visible. */
-declare const OUTBOX_STATUSES: readonly ["pending", "delivered", "dead_letter"];
-interface OutboxModelOptions {
+export declare const OUTBOX_STATUSES: readonly ['pending', 'delivered', 'dead_letter'];
+export interface OutboxModelOptions {
   /** Collection name. Default `event_outbox`. */
   collection?: string;
   /** Mongoose model name. Default `EventOutbox`. Must be unique per connection. */
@@ -31,7 +31,7 @@ interface OutboxModelOptions {
  * Idempotent per connection: calling twice returns the same model rather than throwing
  * `OverwriteModelError`, so a host may build it lazily from several call sites.
  */
-declare function createOutboxModel(connection: Connection, options?: OutboxModelOptions): Model<Record<string, unknown>>;
+export declare function createOutboxModel(connection: Connection, options?: OutboxModelOptions): Model<Record<string, unknown>>;
 /**
  * The repository `repositoryAsOutboxStore` needs, with the plugin set it actually calls.
  *
@@ -55,9 +55,24 @@ declare function createOutboxModel(connection: Connection, options?: OutboxModel
  *
  * `plugins` appends to the required set rather than replacing it — for an observability or
  * cache plugin a deployment wants on this table too.
+ *
+ * **The caller's `limit` is the bound.** The adapter reads its claim window with
+ * `getAll({ limit: batchSize })`. A repository built with the generic pagination default
+ * (`maxLimit: 100`) clamps that read silently, so a relay configured for 500 claims 100, sees
+ * "fewer than batchSize" and stops its multi-pass drain after one pass. This table is never
+ * listed to an HTTP client, and every read the adapter makes names its own limit (the relay's
+ * `batchSize`, an admin route's already-bounded `limit`), so the repository defaults to
+ * `maxLimit: 0` (no cap). A read with no limit still gets `defaultLimit`. Pass `pagination` to
+ * set a ceiling anyway.
  */
-declare function createOutboxRepository(connection: Connection, options?: OutboxModelOptions & {
+export declare function createOutboxRepository(connection: Connection, options?: OutboxRepositoryOptions): Repository<Record<string, unknown>>;
+export interface OutboxRepositoryOptions extends OutboxModelOptions {
+  /** Appended to the required plugin set (`methodRegistryPlugin`, `batchOperationsPlugin`). */
   plugins?: readonly unknown[];
-}): Repository<Record<string, unknown>>;
-//#endregion
-export { OUTBOX_STATUSES, OutboxModelOptions, createOutboxModel, createOutboxRepository };
+  /**
+   * Pagination config for the repository. Default `{ maxLimit: 0 }`: a read returns as many
+   * rows as its `limit` asks for. Set `maxLimit` to cap every read; the relay's `batchSize`
+   * must then stay at or below it, or each pass is clamped to the cap.
+   */
+  pagination?: PaginationConfig;
+}

package/dist/outbox/index.mjs

@@ -1,7 +1,7 @@
-import { n as Repository } from "../Repository-Dj6xqPxJ.mjs";
-import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "../method-registry.plugin-C63pGn1d.mjs";
+import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "../method-registry.plugin-CGAepsBU.mjs";
+import { n as Repository } from "../Repository-eMRYZ_2Y.mjs";
 import { Schema } from "mongoose";
-//#region src/outbox/index.ts
+// src/outbox/index.ts
 /**
 * The mongo-backed OUTBOX table — schema, indexes and repository.
 *
@@ -228,14 +228,25 @@ function createOutboxModel(connection, options = {}) {
 *
 * `plugins` appends to the required set rather than replacing it — for an observability or
 * cache plugin a deployment wants on this table too.
+*
+* **The caller's `limit` is the bound.** The adapter reads its claim window with
+* `getAll({ limit: batchSize })`. A repository built with the generic pagination default
+* (`maxLimit: 100`) clamps that read silently, so a relay configured for 500 claims 100, sees
+* "fewer than batchSize" and stops its multi-pass drain after one pass. This table is never
+* listed to an HTTP client, and every read the adapter makes names its own limit (the relay's
+* `batchSize`, an admin route's already-bounded `limit`), so the repository defaults to
+* `maxLimit: 0` (no cap). A read with no limit still gets `defaultLimit`. Pass `pagination` to
+* set a ceiling anyway.
 */
 function createOutboxRepository(connection, options = {}) {
-	const { plugins = [], ...modelOptions } = options;
+	const { plugins = [], pagination, ...modelOptions } = options;
 	return new Repository(createOutboxModel(connection, modelOptions), [
 		methodRegistryPlugin(),
 		batchOperationsPlugin(),
 		...plugins
-	]);
+	], {
+		maxLimit: 0,
+		...pagination
+	});
 }
-//#endregion
 export { OUTBOX_STATUSES, createOutboxModel, createOutboxRepository };

package/dist/pagination/PaginationEngine.d.mts

@@ -1,2 +1,2 @@
-import { n as PaginationEngine, t as CountMemoKey } from "../PaginationEngine-CRHyuUtw.mjs";
+import { n as PaginationEngine, t as CountMemoKey } from "../PaginationEngine-D17AthKw.mjs";
 export { CountMemoKey, PaginationEngine };

package/dist/pagination/PaginationEngine.mjs

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

package/dist/pagination/utils/limits.d.mts

@@ -1,5 +1,4 @@
-import { u as PaginationConfig } from "../../pagination-D6psses0.mjs";
-//#region src/pagination/utils/limits.d.ts
+import { u as PaginationConfig } from "../../pagination-DAUg5zOY.mjs";
 /**
  * Validates and sanitizes limit value
  * Parses strings to numbers and prevents NaN bugs
@@ -8,7 +7,7 @@ import { u as PaginationConfig } from "../../pagination-D6psses0.mjs";
  * @param config - Pagination configuration
  * @returns Sanitized limit between 1 and maxLimit
  */
-declare function validateLimit(limit: number | string, config: PaginationConfig): number;
+export declare function validateLimit(limit: number | string, config: PaginationConfig): number;
 /**
  * Validates and sanitizes page number
  * Parses strings to numbers and prevents NaN bugs
@@ -18,7 +17,7 @@ declare function validateLimit(limit: number | string, config: PaginationConfig)
  * @returns Sanitized page number >= 1
  * @throws Error if page exceeds maxPage
  */
-declare function validatePage(page: number | string, config: PaginationConfig): number;
+export declare function validatePage(page: number | string, config: PaginationConfig): number;
 /**
  * Checks if page number should trigger deep pagination warning
  *
@@ -26,7 +25,7 @@ declare function validatePage(page: number | string, config: PaginationConfig):
  * @param threshold - Warning threshold
  * @returns True if warning should be shown
  */
-declare function shouldWarnDeepPagination(page: number, threshold: number): boolean;
+export declare function shouldWarnDeepPagination(page: number, threshold: number): boolean;
 /**
  * Calculates number of documents to skip for offset pagination
  *
@@ -34,7 +33,7 @@ declare function shouldWarnDeepPagination(page: number, threshold: number): bool
  * @param limit - Documents per page
  * @returns Number of documents to skip
  */
-declare function calculateSkip(page: number, limit: number): number;
+export declare function calculateSkip(page: number, limit: number): number;
 /**
  * Calculates total number of pages
  *
@@ -42,6 +41,4 @@ declare function calculateSkip(page: number, limit: number): number;
  * @param limit - Documents per page
  * @returns Total number of pages
  */
-declare function calculateTotalPages(total: number, limit: number): number;
-//#endregion
-export { calculateSkip, calculateTotalPages, shouldWarnDeepPagination, validateLimit, validatePage };
+export declare function calculateTotalPages(total: number, limit: number): number;

package/dist/pagination/utils/limits.mjs

@@ -1,5 +1,5 @@
-import { t as createError } from "../../error-BuByZwKU.mjs";
-//#region src/pagination/utils/limits.ts
+import { t as createError } from "../../error-DjdmPLWO.mjs";
+// src/pagination/utils/limits.ts
 /**
 * Validates and sanitizes limit value
 * Parses strings to numbers and prevents NaN bugs
@@ -81,5 +81,4 @@ function calculateSkip(page, limit) {
 function calculateTotalPages(total, limit) {
 	return Math.ceil(total / limit);
 }
-//#endregion
 export { calculateSkip, calculateTotalPages, shouldWarnDeepPagination, validateLimit, validatePage };

package/dist/{pagination-D6psses0.d.mts → pagination-DAUg5zOY.d.mts}

@@ -1,5 +1,4 @@
 import { Connection, Document, Model, PipelineStage, PopulateOptions, Types } from "mongoose";
-//#region src/types/core.d.ts
 /**
  * Core query/document primitives shared across every mongokit module —
  * sort/select/populate/filter specs and the mongoose-facing aliases.
@@ -46,8 +45,6 @@ type PopulateSpec = string | string[] | PopulateOptions | PopulateOptions[];
 type SelectSpec = string | readonly string[] | Record<string, 0 | 1>;
 /** Filter query type for MongoDB queries (compatible with Mongoose 8 & 9) */
 type FilterQuery<_T = unknown> = Record<string, unknown>;
-//#endregion
-//#region src/repository/query-defaults.d.ts
 type ReadConcernLevel = 'local' | 'available' | 'majority' | 'linearizable' | 'snapshot';
 interface WriteConcernSpec {
   w?: number | 'majority';
@@ -110,17 +107,15 @@ declare function assertQueryDefaultsConfigured(connection?: Connection): {
   timeoutMS?: number;
 };
 declare const QUERY_DEFAULTS_ERROR_CODES: {
-  readonly NOT_CONFIGURED: "mongokit.query_defaults.not_configured";
+  readonly NOT_CONFIGURED: 'mongokit.query_defaults.not_configured';
   /** A per-call bound inside a transaction that carries its own CSOT budget (the driver forbids both). */
-  readonly TIMEOUT_IN_TRANSACTION: "mongokit.query_defaults.timeout_in_transaction";
+  readonly TIMEOUT_IN_TRANSACTION: 'mongokit.query_defaults.timeout_in_transaction';
 };
 /** Resolve the options one command runs with. `repo` is the repository's own defaults. */
 declare function resolveQueryOptions(kind: CommandKind, perCall: PerCallQueryOptions, repo?: {
   query?: QueryDefaults;
   aggregate?: AggregateDefaults;
 }): ResolvedQueryOptions;
-//#endregion
-//#region src/pagination/utils/cursor-signing.d.ts
 /**
  * HMAC signing for pagination cursors.
  *
@@ -156,8 +151,6 @@ declare function resolveQueryOptions(kind: CommandKind, perCall: PerCallQueryOpt
  */
 /** One key, or several during a rotation (the FIRST signs; all verify). */
 type CursorSecret = string | readonly string[];
-//#endregion
-//#region src/types/pagination.d.ts
 /**
  * How an offset page learns how many rows sit behind it.
  *
@@ -463,5 +456,4 @@ interface DecodedCursor {
   /** Scope fingerprint the cursor was minted under. */
   scope: string;
 }
-//#endregion
 export { ObjectId as A, configureQueryDefaults as C, AnyDocument as D, resolveQueryOptions as E, SortSpec as F, ReadPreferenceType as M, SelectSpec as N, AnyModel as O, SortDirection as P, configureAggregateDefaults as S, resetQueryDefaults as T, QueryDefaults as _, CursorPayload as a, WriteConcernSpec as b, MongokitPageExtras as c, ValueType as d, CursorSecret as f, QUERY_DEFAULTS_ERROR_CODES as g, PerCallQueryOptions as h, CountStrategy as i, PopulateSpec as j, FilterQuery as k, OffsetPaginationOptions as l, CommandKind as m, BasePaginationOptions as n, DecodedCursor as o, AggregateDefaults as p, CollationOptions as r, KeysetPaginationOptions as s, AggregatePaginationOptions as t, PaginationConfig as u, ReadConcernLevel as v, getQueryDefaults as w, assertQueryDefaultsConfigured as x, ResolvedQueryOptions as y };

package/dist/{plugin-options-Cirmb4Kp.d.mts → plugin-options-Bpcuz9kS.d.mts}

@@ -1,7 +1,6 @@
-import { A as ObjectId, F as SortSpec, N as SelectSpec, j as PopulateSpec } from "./pagination-D6psses0.mjs";
-import { h as RepositoryInstance, p as RepositoryContext } from "./repository-MqAP409e.mjs";
+import { A as ObjectId, F as SortSpec, N as SelectSpec, j as PopulateSpec } from "./pagination-DAUg5zOY.mjs";
+import { h as RepositoryInstance, p as RepositoryContext } from "./repository-DzVIwhU2.mjs";
 import { OffsetPaginationResult } from "@classytic/repo-core/pagination";
-//#region src/types/plugin-options.d.ts
 /** Field preset configuration (field-filter plugin) */
 interface FieldPreset {
   /** Fields visible to everyone */
@@ -165,5 +164,4 @@ interface CascadeOptions {
   /** Logger for cascade operations */
   logger?: Logger;
 }
-//#endregion
 export { SoftDeleteFilterMode as a, ValidationChainOptions as c, Logger as i, ValidatorDefinition as l, CascadeRelation as n, SoftDeleteOptions as o, FieldPreset as r, SoftDeleteRepository as s, CascadeOptions as t };

package/dist/plugins/index.d.mts

@@ -1,8 +1,8 @@
-import { C as RepositoryPluginName, S as MongoKitPluginName, l as Plugin, x as MONGOKIT_PLUGIN_NAMES } from "../repository-MqAP409e.mjs";
-import { A as EnsureAuditTrailReadyOptions, C as AuditQueryOptions, D as AuditTrailOptions, E as AuditTrailMode, M as ensureAuditTrailReady, O as AuditTrailQuery, S as AuditOperation, T as AuditTrailMethods, _ as CacheOptions, a as DateSequentialIdOptions, b as cachePlugin, c as SequentialIdOptions, f as getNextSequence, g as CacheAdapter, h as sequentialId, i as CustomIdOptions, j as auditTrailPlugin, k as AuditTrailQueryOptions, l as customIdPlugin, o as IdGenerator, p as prefixedId, r as multiTenantPlugin, s as PrefixedIdOptions, t as MultiTenantOptions, u as dateSequentialId, v as RepositoryCacheHandle, w as AuditQueryResult, x as AuditEntry, y as RepositoryCachePluginOptions } from "../multi-tenant.plugin-B_q9NUHc.mjs";
-import { A as immutableStatesPlugin, C as MethodRegistryRepository, D as leasePlugin, E as LeasePluginOptions, F as fieldFilterPlugin, G as appendOnlyPlugin, H as batchOperationsPlugin, I as ElasticSearchOptions, K as AggregateHelpersMethods, L as elasticSearchPlugin, M as IdempotencyStoreMethods, N as IdempotencyStorePluginOptions, O as ImmutableClaimView, P as idempotencyStorePlugin, R as cascadePlugin, S as mongoOperationsPlugin, T as LeaseMethods, U as auditLogPlugin, W as AppendOnlyPluginOptions, _ as searchKeysPlugin, a as requireField, b as observabilityPlugin, c as timestampPlugin, d as createTenantContext, f as SubdocumentMethods, g as SearchKeysPluginOptions, h as softDeletePlugin, i as immutableField, j as IdempotencyClaim, k as ImmutableStatesPluginOptions, l as TenantContext, m as SoftDeleteMethods, n as autoInject, o as uniqueField, p as subdocumentPlugin, q as aggregateHelpersPlugin, r as blockIf, s as validationChainPlugin, t as OperationType, u as TenantStore, v as ObservabilityOptions, w as methodRegistryPlugin, x as MongoOperationsMethods, y as OperationMetric, z as BatchOperationsMethods } from "../validation-chain.plugin-BAeC5eVT.mjs";
+import { A as ImmutablePurgeEvent, B as elasticSearchPlugin, C as MethodRegistryRepository, D as LeasePluginOptions, E as LeasePendingFilter, F as IdempotencyStoreMethods, G as batchOperationsPlugin, H as BatchOperationsMethods, I as IdempotencyStorePluginOptions, J as AppendOnlyPurgeEvent, K as auditLogPlugin, L as idempotencyStorePlugin, M as ImmutableStatesPluginOptions, N as immutableStatesPlugin, O as leasePlugin, P as IdempotencyClaim, R as fieldFilterPlugin, S as mongoOperationsPlugin, T as LeaseMethods, V as cascadePlugin, X as AggregateHelpersMethods, Y as appendOnlyPlugin, Z as aggregateHelpersPlugin, _ as searchKeysPlugin, a as requireField, b as observabilityPlugin, c as timestampPlugin, d as createTenantContext, f as SubdocumentMethods, g as SearchKeysPluginOptions, h as softDeletePlugin, i as immutableField, j as ImmutablePurgeRequest, k as ImmutableClaimView, l as TenantContext, m as SoftDeleteMethods, n as autoInject, o as uniqueField, p as subdocumentPlugin, q as AppendOnlyPluginOptions, r as blockIf, s as validationChainPlugin, t as OperationType, u as TenantStore, v as ObservabilityOptions, w as methodRegistryPlugin, x as MongoOperationsMethods, y as OperationMetric, z as ElasticSearchOptions } from "../validation-chain.plugin-B3gZCZj4.mjs";
+import { A as cachePlugin, B as EnsureAuditTrailReadyOptions, C as prefixedId, D as CacheOptions, E as CacheAdapter, F as AuditTrailMethods, H as ensureAuditTrailReady, I as AuditTrailMode, L as AuditTrailOptions, M as AuditOperation, N as AuditQueryOptions, O as RepositoryCacheHandle, P as AuditQueryResult, R as AuditTrailQuery, T as sequentialId, V as auditTrailPlugin, _ as customIdPlugin, a as DateSequentialIdOptions, b as getNextPeriodSequence, i as CustomIdOptions, j as AuditEntry, k as RepositoryCachePluginOptions, m as SequentialIdOptions, o as IdGenerator, r as multiTenantPlugin, t as MultiTenantOptions, u as PrefixedIdOptions, v as dateSequentialId, x as getNextSequence, z as AuditTrailQueryOptions } from "../multi-tenant.plugin-DfeDMiI8.mjs";
+import { C as RepositoryPluginName, S as MongoKitPluginName, l as Plugin, x as MONGOKIT_PLUGIN_NAMES } from "../repository-DzVIwhU2.mjs";
+import { n as RetentionPurgeEvent, r as RetentionPurgeRequest, t as RETENTION_PURGE_ERROR_CODES } from "../retention-purge-DqcYvRnG.mjs";
 import { ChangeLogStore } from "@classytic/repo-core/sync";
-//#region src/plugins/change-log.plugin.d.ts
 interface ChangeLogPluginOptions {
   /** Durable feed implementing the repo-core/sync contract. */
   store: ChangeLogStore;
@@ -18,6 +18,5 @@ interface ChangeLogPluginOptions {
    */
   project?: (doc: Record<string, unknown>) => Record<string, unknown>;
 }
-declare function changeLogPlugin(options: ChangeLogPluginOptions): Plugin;
-//#endregion
-export { type AggregateHelpersMethods, type AppendOnlyPluginOptions, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailMode, type AuditTrailOptions, AuditTrailQuery, type AuditTrailQueryOptions, type BatchOperationsMethods, type CacheAdapter, type CacheOptions, type ChangeLogPluginOptions, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type EnsureAuditTrailReadyOptions, type IdGenerator, type IdempotencyClaim, type IdempotencyStoreMethods, type IdempotencyStorePluginOptions, type ImmutableClaimView, type ImmutableStatesPluginOptions, type LeaseMethods, type LeasePluginOptions, MONGOKIT_PLUGIN_NAMES, type MethodRegistryRepository, type MongoKitPluginName, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type OperationType, type PrefixedIdOptions, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type RepositoryPluginName, type SearchKeysPluginOptions, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, type TenantContext, type TenantStore, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, getNextSequence, idempotencyStorePlugin, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, searchKeysPlugin, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+export declare function changeLogPlugin(options: ChangeLogPluginOptions): Plugin;
+export { type AggregateHelpersMethods, type AppendOnlyPluginOptions, type AppendOnlyPurgeEvent, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailMode, type AuditTrailOptions, AuditTrailQuery, type AuditTrailQueryOptions, type BatchOperationsMethods, type CacheAdapter, type CacheOptions, type ChangeLogPluginOptions, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type EnsureAuditTrailReadyOptions, type IdGenerator, type IdempotencyClaim, type IdempotencyStoreMethods, type IdempotencyStorePluginOptions, type ImmutableClaimView, type ImmutablePurgeEvent, type ImmutablePurgeRequest, type ImmutableStatesPluginOptions, type LeaseMethods, type LeasePendingFilter, type LeasePluginOptions, MONGOKIT_PLUGIN_NAMES, type MethodRegistryRepository, type MongoKitPluginName, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type OperationType, type PrefixedIdOptions, RETENTION_PURGE_ERROR_CODES, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type RepositoryPluginName, type RetentionPurgeEvent, type RetentionPurgeRequest, type SearchKeysPluginOptions, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, type TenantContext, type TenantStore, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, getNextPeriodSequence, getNextSequence, idempotencyStorePlugin, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, searchKeysPlugin, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/plugins/index.mjs

@@ -1,8 +1,8 @@
-import { i as searchKeysPlugin } from "../Repository-Dj6xqPxJ.mjs";
-import { _ as AuditTrailQuery, b as auditLogPlugin, f as getNextSequence, g as cachePlugin, h as sequentialId, i as multiTenantPlugin, l as customIdPlugin, n as softDeletePlugin, p as prefixedId, t as timestampPlugin, u as dateSequentialId, v as auditTrailPlugin, y as ensureAuditTrailReady } from "../timestamp.plugin-DpOWavVI.mjs";
-import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "../method-registry.plugin-C63pGn1d.mjs";
-import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "../validation-chain.plugin-DRApTmkN.mjs";
-//#region src/plugins/change-log.plugin.ts
+import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "../validation-chain.plugin-DNY6MIF6.mjs";
+import { C as ensureAuditTrailReady, S as auditTrailPlugin, _ as prefixedId, b as cachePlugin, d as customIdPlugin, f as dateSequentialId, h as getNextSequence, i as multiTenantPlugin, m as getNextPeriodSequence, n as softDeletePlugin, t as timestampPlugin, w as auditLogPlugin, x as AuditTrailQuery, y as sequentialId } from "../timestamp.plugin-Bz_zL9PX.mjs";
+import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "../method-registry.plugin-CGAepsBU.mjs";
+import { d as RETENTION_PURGE_ERROR_CODES, i as searchKeysPlugin } from "../Repository-eMRYZ_2Y.mjs";
+// src/plugins/change-log.plugin.ts
 const PLUGIN_NAME = "changeLog";
 /** Marks a repository already captured: the store and scope it writes to. */
 const CAPTURED = Symbol.for("mongokit.changeLog.capture");
@@ -175,5 +175,4 @@ function changeLogPlugin(options) {
 		}
 	};
 }
-//#endregion
-export { AuditTrailQuery, MONGOKIT_PLUGIN_NAMES, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, getNextSequence, idempotencyStorePlugin, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, searchKeysPlugin, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+export { AuditTrailQuery, MONGOKIT_PLUGIN_NAMES, RETENTION_PURGE_ERROR_CODES, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, getNextPeriodSequence, getNextSequence, idempotencyStorePlugin, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, searchKeysPlugin, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/query/primitives/coercion.d.mts

@@ -1,2 +1,2 @@
-import { a as coerceHeuristic, i as coerceFieldValue, n as SchemaPathsLike, o as coerceToType, r as buildFieldTypeMap, s as normalizeMongooseType, t as FieldType } from "../../coercion-BjdPX3YF.mjs";
+import { a as coerceHeuristic, i as coerceFieldValue, n as SchemaPathsLike, o as coerceToType, r as buildFieldTypeMap, s as normalizeMongooseType, t as FieldType } from "../../coercion-COp9DRNw.mjs";
 export { FieldType, SchemaPathsLike, buildFieldTypeMap, coerceFieldValue, coerceHeuristic, coerceToType, normalizeMongooseType };

package/dist/query/primitives/coercion.mjs

@@ -1,6 +1,6 @@
-import { r as isObjectIdInstance } from "../../id-resolution-BqDrk0S2.mjs";
+import { r as isObjectIdInstance } from "../../id-resolution-Cqh49d9J.mjs";
 import mongoose from "mongoose";
-//#region src/query/primitives/coercion.ts
+// src/query/primitives/coercion.ts
 /**
 * Value coercion primitives
 *
@@ -144,5 +144,4 @@ function coerceFieldValue(field, value, types) {
 	if (!type) return coerceHeuristic(value);
 	return coerceToType(value, type);
 }
-//#endregion
 export { buildFieldTypeMap, coerceFieldValue, coerceHeuristic, coerceToType, normalizeMongooseType };

package/dist/query/primitives/geo.d.mts

@@ -1,4 +1,3 @@
-//#region src/query/primitives/geo.d.ts
 /**
  * Geo query primitives
  *
@@ -14,21 +13,21 @@
  * `[nearSphere]`, or `[geoWithin]` operator on a field.
  */
 /** Geo operators recognized by the parser */
-declare const GEO_OPERATORS: readonly ["near", "nearSphere", "geoWithin", "withinRadius"];
-type GeoOperator = (typeof GEO_OPERATORS)[number];
+export declare const GEO_OPERATORS: readonly ['near', 'nearSphere', 'geoWithin', 'withinRadius'];
+export type GeoOperator = (typeof GEO_OPERATORS)[number];
 /**
  * True iff `operator` is one of the geo operators we handle.
  * Used by the operator router in QueryParser to short-circuit before the
  * generic numeric/string operator handling kicks in.
  */
-declare function isGeoOperator(operator: string): operator is GeoOperator;
+export declare function isGeoOperator(operator: string): operator is GeoOperator;
 /**
  * Parse a comma-separated coordinate list into numbers, validating each value
  * is a finite number. Returns null on any parse failure — callers must treat
  * null as "drop this filter entirely" rather than substituting defaults
  * (which would silently widen the query).
  */
-declare function parseCoordinateList(raw: unknown): number[] | null;
+export declare function parseCoordinateList(raw: unknown): number[] | null;
 /**
  * Validate a [lng, lat] pair against MongoDB's accepted ranges.
  * Longitude: [-180, 180]. Latitude: [-90, 90]. Out-of-range coordinates
@@ -36,7 +35,7 @@ declare function parseCoordinateList(raw: unknown): number[] | null;
  * with `coordinates: [999, 40]` would either error inside Mongo or worse,
  * silently behave unexpectedly.
  */
-declare function isValidLngLat(lng: number, lat: number): boolean;
+export declare function isValidLngLat(lng: number, lat: number): boolean;
 /**
  * Build a `$near` or `$nearSphere` filter for a single field from a coordinate
  * list. Accepts:
@@ -45,7 +44,7 @@ declare function isValidLngLat(lng: number, lat: number): boolean;
  *
  * Returns null on any validation failure (drop the filter).
  */
-declare function buildNearFilter(variant: 'near' | 'nearSphere', coords: number[]): Record<string, unknown> | null;
+export declare function buildNearFilter(variant: 'near' | 'nearSphere', coords: number[]): Record<string, unknown> | null;
 /**
  * Build a `$geoWithin: $centerSphere` filter from [lng, lat, radiusMeters].
  *
@@ -62,14 +61,14 @@ declare function buildNearFilter(variant: 'near' | 'nearSphere', coords: number[
  * `$centerSphere` takes the radius in radians, so we convert from the
  * caller-friendly meters using Earth's equatorial radius.
  */
-declare function buildWithinRadiusFilter(coords: number[]): Record<string, unknown> | null;
+export declare function buildWithinRadiusFilter(coords: number[]): Record<string, unknown> | null;
 /**
  * Build a `$geoWithin: $box` filter from a 4-element coordinate list:
  *   [minLng, minLat, maxLng, maxLat]
  *
  * Returns null on any validation failure (drop the filter).
  */
-declare function buildGeoWithinBoxFilter(coords: number[]): Record<string, unknown> | null;
+export declare function buildGeoWithinBoxFilter(coords: number[]): Record<string, unknown> | null;
 /**
  * Rewrite a filter object that contains `$near` / `$nearSphere` into an
  * equivalent count-compatible filter using `$geoWithin: $centerSphere`.
@@ -91,7 +90,7 @@ declare function buildGeoWithinBoxFilter(coords: number[]): Record<string, unkno
  *     rewritten to a bounded `$centerSphere`; caller should fall back to
  *     `countStrategy: 'none'`)
  */
-declare function rewriteNearForCount(filters: unknown): Record<string, unknown> | null;
+export declare function rewriteNearForCount(filters: unknown): Record<string, unknown> | null;
 /**
  * Detect whether a Mongo filter object contains a `$near` or `$nearSphere`
  * operator on any field at the top level. These are SORT operators in
@@ -104,13 +103,11 @@ declare function rewriteNearForCount(filters: unknown): Record<string, unknown>
  *
  * Returns false for falsy / non-object inputs.
  */
-declare function hasNearOperator(filters: unknown): boolean;
+export declare function hasNearOperator(filters: unknown): boolean;
 /**
  * High-level entry point: given an operator name and the raw value from the
  * URL, return the MongoDB filter for that field — or null if the operator is
  * not a geo operator (caller should fall through to normal handling) or the
  * value is invalid (caller should drop the filter).
  */
-declare function parseGeoFilter(operator: string, raw: unknown): Record<string, unknown> | null;
-//#endregion
-export { GEO_OPERATORS, GeoOperator, buildGeoWithinBoxFilter, buildNearFilter, buildWithinRadiusFilter, hasNearOperator, isGeoOperator, isValidLngLat, parseCoordinateList, parseGeoFilter, rewriteNearForCount };
+export declare function parseGeoFilter(operator: string, raw: unknown): Record<string, unknown> | null;

package/dist/query/primitives/geo.mjs

@@ -1,4 +1,4 @@
-//#region src/query/primitives/geo.ts
+// src/query/primitives/geo.ts
 /**
 * Geo query primitives
 *
@@ -207,5 +207,4 @@ function parseGeoFilter(operator, raw) {
 	if (operator === "withinRadius") return buildWithinRadiusFilter(coords);
 	return null;
 }
-//#endregion
 export { GEO_OPERATORS, buildGeoWithinBoxFilter, buildNearFilter, buildWithinRadiusFilter, hasNearOperator, isGeoOperator, isValidLngLat, parseCoordinateList, parseGeoFilter, rewriteNearForCount };

package/dist/query/primitives/indexes.d.mts

@@ -1,2 +1,2 @@
-import { n as SchemaIndexes, r as extractSchemaIndexes, t as IndexableSchema } from "../../indexes-DIjMpYES.mjs";
+import { n as SchemaIndexes, r as extractSchemaIndexes, t as IndexableSchema } from "../../indexes-FfyOuhDK.mjs";
 export { IndexableSchema, SchemaIndexes, extractSchemaIndexes };

package/dist/query/primitives/indexes.mjs

@@ -1,4 +1,4 @@
-//#region src/query/primitives/indexes.ts
+// src/query/primitives/indexes.ts
 const EMPTY = {
 	geoFields: [],
 	textFields: [],
@@ -42,5 +42,4 @@ function extractSchemaIndexes(schema) {
 		other
 	};
 }
-//#endregion
 export { extractSchemaIndexes };

package/dist/{query-defaults-BxUcSOoF.mjs → query-defaults-aUoKlEbh.mjs}

@@ -1,6 +1,6 @@
-import { t as createError } from "./error-BuByZwKU.mjs";
+import { t as createError } from "./error-DjdmPLWO.mjs";
 import mongoose from "mongoose";
-//#region src/repository/query-defaults.ts
+// src/repository/query-defaults.ts
 /**
 * Query defaults — the time bound and read/write concerns every repository command carries.
 *
@@ -204,5 +204,4 @@ function applyToAggregate(aggregation, o) {
 	if (o.allowDiskUse !== void 0) aggregation.allowDiskUse(o.allowDiskUse);
 	if (o.hint !== void 0) aggregation.hint(o.hint);
 }
-//#endregion
 export { assertQueryDefaultsConfigured as a, getQueryDefaults as c, setTransactionDeadline as d, applyToQuery as i, resetQueryDefaults as l, applyCursorTimeoutMode as n, configureAggregateDefaults as o, applyToAggregate as r, configureQueryDefaults as s, QUERY_DEFAULTS_ERROR_CODES as t, resolveQueryOptions as u };

package/dist/read-model/index.d.mts

@@ -1,18 +1,17 @@
-import { r as Repository } from "../Repository-DnL4xk5w.mjs";
+import { r as Repository } from "../Repository-B6oL6OMv.mjs";
 import { BulkUpsertResult } from "@classytic/repo-core/repository";
-//#region src/read-model/index.d.ts
-declare const READ_MODEL_ERROR_CODES: {
-  readonly MERGE_IN_TRANSACTION: "mongokit.read_model.merge_in_transaction";
-  readonly ON_NOT_UNIQUE: "mongokit.read_model.on_not_unique";
-  readonly ON_MISSING_SCOPE: "mongokit.read_model.on_missing_scope";
-  readonly DEDUPE_NEEDS_TRANSACTION: "mongokit.read_model.dedupe_needs_transaction";
-  readonly DEDUPE_KEY_MISSING: "mongokit.read_model.dedupe_key_missing";
-  readonly INCREMENT_FAILED: "mongokit.read_model.increment_failed";
-  readonly TOO_LARGE: "mongokit.read_model.too_large";
+export declare const READ_MODEL_ERROR_CODES: {
+  readonly MERGE_IN_TRANSACTION: 'mongokit.read_model.merge_in_transaction';
+  readonly ON_NOT_UNIQUE: 'mongokit.read_model.on_not_unique';
+  readonly ON_MISSING_SCOPE: 'mongokit.read_model.on_missing_scope';
+  readonly DEDUPE_NEEDS_TRANSACTION: 'mongokit.read_model.dedupe_needs_transaction';
+  readonly DEDUPE_KEY_MISSING: 'mongokit.read_model.dedupe_key_missing';
+  readonly INCREMENT_FAILED: 'mongokit.read_model.increment_failed';
+  readonly TOO_LARGE: 'mongokit.read_model.too_large';
 };
 /** Caller scope forwarded to every repository call (tenant, bypass, attribution). */
-type ReadModelScope = Record<string, unknown>;
-interface IncrementGrain {
+export type ReadModelScope = Record<string, unknown>;
+export interface IncrementGrain {
   /** The read-model key (without the policy scope, which the repository adds). */
   key: Record<string, unknown>;
   inc: Record<string, number>;
@@ -21,12 +20,12 @@ interface IncrementGrain {
   dedupeKey?: string;
 }
 /** Sum grains per key, apply them in one upsert; with a ledger, count each dedupeKey once. */
-declare function applyIncrements<TDoc>(target: Repository<TDoc>, grains: readonly IncrementGrain[], options?: ReadModelScope & {
+export declare function applyIncrements<TDoc>(target: Repository<TDoc>, grains: readonly IncrementGrain[], options?: ReadModelScope & {
   session?: unknown;
   /** Repository over a collection unique on (scope, `dedupeKey`). */
   ledger?: Repository<unknown>;
 }): Promise<BulkUpsertResult>;
-interface RebuildOptions {
+export interface RebuildOptions {
   /** Source stages producing one row per read-model grain (with every `on` field except scope fields). */
   pipeline: readonly unknown[];
   /** Fields identifying a grain; must equal a unique index of the target and include its tenant field. */
@@ -37,11 +36,11 @@ interface RebuildOptions {
   session?: unknown;
 }
 /** Rebuild the scope's slice of `target` from `source` with one `$merge`, then drop stale grains. */
-declare function rebuildInto<TSrc, TDoc>(source: Repository<TSrc>, target: Repository<TDoc>, options: RebuildOptions): Promise<{
+export declare function rebuildInto<TSrc, TDoc>(source: Repository<TSrc>, target: Repository<TDoc>, options: RebuildOptions): Promise<{
   rebuildId: string;
   removed: number;
 }>;
-interface ReconcileOptions {
+export interface ReconcileOptions {
   pipeline: readonly unknown[];
   on: readonly string[];
   /** Fields compared between the recomputed and the stored row. */
@@ -50,7 +49,7 @@ interface ReconcileOptions {
   /** Refuse past this many rows on either side (both are held in memory). Default 100,000. */
   maxRows?: number;
 }
-interface DriftRow {
+export interface DriftRow {
   key: Record<string, unknown>;
   /** Recomputed measures, `null` when the source produces no such grain. */
   expected: Record<string, unknown> | null;
@@ -58,9 +57,7 @@ interface DriftRow {
   actual: Record<string, unknown> | null;
 }
 /** Recompute the scope's grains from `source` and report every one that differs in `target`. */
-declare function reconcile<TSrc, TDoc>(source: Repository<TSrc>, target: Repository<TDoc>, options: ReconcileOptions): Promise<{
+export declare function reconcile<TSrc, TDoc>(source: Repository<TSrc>, target: Repository<TDoc>, options: ReconcileOptions): Promise<{
   drift: DriftRow[];
   compared: number;
-}>;
-//#endregion
-export { DriftRow, IncrementGrain, READ_MODEL_ERROR_CODES, ReadModelScope, RebuildOptions, ReconcileOptions, applyIncrements, rebuildInto, reconcile };
+}>;

package/dist/read-model/index.mjs

@@ -1,7 +1,7 @@
-import { t as createError } from "../error-BuByZwKU.mjs";
-import { i as scopeForCollection, o as tenantFieldsOf } from "../join-scope-DSAznE8E.mjs";
+import { i as scopeForCollection, o as tenantFieldsOf } from "../join-scope-C1gOtZ59.mjs";
+import { t as createError } from "../error-DjdmPLWO.mjs";
 import { randomUUID } from "node:crypto";
-//#region src/read-model/index.ts
+// src/read-model/index.ts
 /**
 * `@classytic/mongokit/read-model` — maintain and verify a derived (read) collection.
 *
@@ -189,5 +189,4 @@ async function reconcile(source, target, options) {
 		compared: expectedRows.length
 	};
 }
-//#endregion
 export { READ_MODEL_ERROR_CODES, applyIncrements, rebuildInto, reconcile };