@classytic/mongokit 3.43.1 → 3.45.0

package/dist/{multi-tenant.plugin-B_q9NUHc.d.mts → multi-tenant.plugin-BTPtCLNK.d.mts}

@@ -1,9 +1,8 @@
-import { A as ObjectId } from "./pagination-D6psses0.mjs";
-import { l as Plugin, p as RepositoryContext } from "./repository-MqAP409e.mjs";
+import { A as ObjectId } from "./pagination-BAM9cA4N.mjs";
+import { l as Plugin, p as RepositoryContext } from "./repository-B0aFVgP2.mjs";
 import mongoose, { Connection } from "mongoose";
 import { CacheAdapter as CacheAdapter$1, CacheOptions, RepositoryCacheHandle as RepositoryCacheHandle$1, RepositoryCachePluginOptions, cachePlugin } from "@classytic/repo-core/cache";
 import { TenantConfig } from "@classytic/repo-core/tenant";
-//#region src/plugins/audit-trail.plugin.d.ts
 /**
  * Audit write delivery mode.
  *
@@ -262,8 +261,6 @@ interface AuditTrailMethods {
     operation?: AuditOperation;
   }): Promise<AuditQueryResult>;
 }
-//#endregion
-//#region src/plugins/custom-id.plugin.d.ts
 /**
  * Generator function that produces a unique ID.
  * Receives the full repository context for conditional logic.
@@ -277,6 +274,45 @@ interface CustomIdOptions {
   /** Only generate if the field is missing/empty (default: true) */
   generateOnlyIfEmpty?: boolean;
 }
+/** Options for {@link createSequenceCounter}. */
+interface SequenceCounterOptions {
+  /** Mongoose connection. @default the default `mongoose.connection` */
+  connection?: mongoose.Connection;
+  /**
+   * Collection holding the counters, for hosts with a collection-naming
+   * rule (e.g. an app prefix). @default `'_mongokit_counters'`
+   */
+  collection?: string;
+}
+/**
+ * The atomic counter API bound to one connection + collection. Same
+ * semantics as {@link getNextSequence} / {@link readSequence} /
+ * {@link ensureSequenceAtLeast}, with an optional session on every call.
+ */
+interface SequenceCounter {
+  /** Atomic `$inc` + upsert; returns the value after the increment. */
+  next(counterKey: string, increment?: number, session?: mongoose.ClientSession): Promise<number>;
+  /** Current value, or `null` when the counter was never created. */
+  read(counterKey: string, session?: mongoose.ClientSession): Promise<number | null>;
+  /** Raise to at least `floor` (`$max` + upsert); never lowers. Returns the value after. */
+  ensureAtLeast(counterKey: string, floor: number, session?: mongoose.ClientSession): Promise<number>;
+  /**
+   * Next value of the counter `'<baseKey><sep><civil period>'`, which resets
+   * every civil year / month / day in `timeZone`. See {@link getNextPeriodSequence}.
+   */
+  nextInPeriod(baseKey: string, options: PeriodSequenceOptions): Promise<PeriodSequenceResult>;
+}
+/**
+ * Bind the atomic counter API to a connection and, optionally, a
+ * collection other than `_mongokit_counters`.
+ *
+ * @example
+ * const counters = createSequenceCounter({ connection, collection: 'app_counters' });
+ * await withTransaction(connection, async (session) => {
+ *   const seq = await counters.next('alert.stream', 1, session);
+ * });
+ */
+declare function createSequenceCounter(options?: SequenceCounterOptions): SequenceCounter;
 /**
  * Atomically increment and return the next sequence value for a given key.
  * Uses `findOneAndUpdate` with `upsert` + `$inc` — fully atomic even under
@@ -311,7 +347,7 @@ declare function getNextSequence(counterKey: string, increment?: number, connect
  * Current value of a counter, or `null` when it has never been created.
  * `null` and `0` differ: only a missing counter needs seeding.
  */
-declare function readSequence(counterKey: string, connection?: mongoose.Connection): Promise<number | null>;
+declare function readSequence(counterKey: string, connection?: mongoose.Connection, session?: mongoose.ClientSession): Promise<number | null>;
 /**
  * Raise a counter to at least `floor` — never lowers it. Atomic (`$max` +
  * upsert), so concurrent seeders converge on the highest floor.
@@ -322,7 +358,77 @@ declare function readSequence(counterKey: string, connection?: mongoose.Connecti
  *
  * @returns The counter's value after the raise.
  */
-declare function ensureSequenceAtLeast(counterKey: string, floor: number, connection?: mongoose.Connection): Promise<number>;
+declare function ensureSequenceAtLeast(counterKey: string, floor: number, connection?: mongoose.Connection, session?: mongoose.ClientSession): Promise<number>;
+/** The civil period a period-scoped counter resets on. */
+type SequencePeriod = 'year' | 'month' | 'day';
+/**
+ * The civil period of an instant in an IANA time zone: `'2026'` (year),
+ * `'2026-03'` (month) or `'2026-03-14'` (day). The period suffix every
+ * period-scoped counter key ends with.
+ *
+ * @example
+ * civilPeriodKey(new Date('2026-12-31T21:00:00Z'), 'year', 'Asia/Riyadh'); // '2027'
+ * civilPeriodKey(new Date('2026-12-31T21:00:00Z'), 'year', 'UTC');         // '2026'
+ */
+declare function civilPeriodKey(at: Date, period: SequencePeriod, timeZone: string): string;
+/** Options for {@link periodCounterKey}, {@link getNextPeriodSequence} and `SequenceCounter.nextInPeriod`. */
+interface PeriodSequenceKeyOptions {
+  /** Civil period the counter resets on. */
+  period: SequencePeriod;
+  /** IANA time zone whose civil calendar decides the period (e.g. `'Asia/Riyadh'`, `'UTC'`). */
+  timeZone: string;
+  /**
+   * The instant whose civil date picks the period (e.g. the record's
+   * `reportedAt`, so a backdated record numbers in its own year).
+   * @default now
+   */
+  at?: Date;
+  /**
+   * Joins the base key and the period: `'<base><sep><period>'`.
+   * Pass `'.'` to keep counters an app already created as `occ.occurrence.2026`.
+   * @default ':'
+   */
+  keySeparator?: string;
+}
+/** Options for {@link getNextPeriodSequence} / `SequenceCounter.nextInPeriod`. */
+interface PeriodSequenceOptions extends PeriodSequenceKeyOptions {
+  /** @default 1 */
+  increment?: number;
+  /** Client session: the bump joins the caller's transaction. */
+  session?: mongoose.ClientSession;
+}
+/** A period-scoped counter value plus the period it was issued in. */
+interface PeriodSequenceResult {
+  /** Value after the increment; `1` for the first value of a new period. */
+  seq: number;
+  /** The civil period (`'2026'`, `'2026-03'`, `'2026-03-14'`), for formatting the id. */
+  period: string;
+  /** The counter document's key (`'<base><sep><period>'`), for `read` / `ensureAtLeast`. */
+  counterKey: string;
+}
+/**
+ * The counter key and civil period for a base key at an instant. Use it to
+ * `read` / `ensureAtLeast` the same counter `getNextPeriodSequence` bumps.
+ */
+declare function periodCounterKey(baseKey: string, options: PeriodSequenceKeyOptions): {
+  counterKey: string;
+  period: string;
+};
+/**
+ * Atomically issue the next value of a counter that resets every civil
+ * year / month / day in an IANA time zone. The period is derived from `at`
+ * (default now) in `timeZone`, so every replica agrees on it whatever its
+ * `TZ`, and DST never moves a boundary.
+ *
+ * @example Yearly reference `OC-2026-000123` in Riyadh
+ * const { seq, period } = await getNextPeriodSequence('occ.occurrence', {
+ *   period: 'year', timeZone: 'Asia/Riyadh', at: reportedAt, connection, session,
+ * });
+ * const ref = `OC-${period}-${String(seq).padStart(6, '0')}`;
+ */
+declare function getNextPeriodSequence(baseKey: string, options: PeriodSequenceOptions & {
+  connection?: mongoose.Connection;
+}): Promise<PeriodSequenceResult>;
 interface SequentialIdOptions {
   /** Prefix string (e.g., 'INV', 'ORD') */
   prefix: string;
@@ -337,6 +443,11 @@ interface SequentialIdOptions {
   separator?: string;
   /** Custom counter key override (default: model.modelName) */
   counterKey?: string;
+  /**
+   * Counter collection, same as `createSequenceCounter({ collection })`
+   * (for hosts with a collection-naming rule). @default `'_mongokit_counters'`
+   */
+  counterCollection?: string;
 }
 /**
  * Generator: Simple sequential counter.
@@ -413,6 +524,30 @@ interface DateSequentialIdOptions {
    * stays invisible until one host is configured otherwise.
    */
   timezone?: 'local' | 'utc';
+  /**
+   * IANA time zone whose civil calendar decides the period (e.g.
+   * `'Asia/Riyadh'`). Wins over `timezone`. Read through Intl, so every
+   * replica agrees on the boundary whatever its `TZ`, and DST never moves it.
+   * Invalid zones throw when the generator is built.
+   */
+  timeZone?: string;
+  /**
+   * The instant whose civil date picks the period, e.g.
+   * `(ctx) => ctx.data?.reportedAt` so a backdated record numbers in its own
+   * period. `undefined` / `null` falls back to now; any other non-Date throws.
+   * @default now
+   */
+  at?: (context: RepositoryContext) => Date | undefined | null;
+  /**
+   * Base counter key (the tenant id, under `scope: 'tenant'`, and the period
+   * are appended). @default `model.modelName`
+   */
+  counterKey?: string;
+  /**
+   * Counter collection, same as `createSequenceCounter({ collection })`
+   * (for hosts with a collection-naming rule). @default `'_mongokit_counters'`
+   */
+  counterCollection?: string;
 }
 /**
  * Generator: Date-partitioned sequential counter.
@@ -493,8 +628,6 @@ declare function prefixedId(options: PrefixedIdOptions): IdGenerator;
  * ```
  */
 declare function customIdPlugin(options: CustomIdOptions): Plugin;
-//#endregion
-//#region src/plugins/multi-tenant.plugin.d.ts
 /**
  * Static tenant fields are picked from `@classytic/repo-core/tenant` so the
  * vocabulary (`tenantField`, `contextKey`, `required`, `fieldType`) stays
@@ -653,5 +786,4 @@ declare function adminBypass(options: {
   roleField?: string;
   adminRoles: readonly string[];
 }): (context: RepositoryContext, operation: string) => boolean;
-//#endregion
-export { EnsureAuditTrailReadyOptions as A, AuditQueryOptions as C, AuditTrailOptions as D, AuditTrailMode as E, ensureAuditTrailReady as M, AuditTrailQuery as O, AuditOperation as S, AuditTrailMethods as T, CacheOptions as _, DateSequentialIdOptions as a, cachePlugin as b, SequentialIdOptions as c, ensureSequenceAtLeast as d, getNextSequence as f, CacheAdapter$1 as g, sequentialId as h, CustomIdOptions as i, auditTrailPlugin as j, AuditTrailQueryOptions as k, customIdPlugin as l, readSequence as m, adminBypass as n, IdGenerator as o, prefixedId as p, multiTenantPlugin as r, PrefixedIdOptions as s, MultiTenantOptions as t, dateSequentialId as u, RepositoryCacheHandle$1 as v, AuditQueryResult as w, AuditEntry as x, RepositoryCachePluginOptions as y };
+export { cachePlugin as A, EnsureAuditTrailReadyOptions as B, prefixedId as C, CacheOptions as D, CacheAdapter$1 as E, AuditTrailMethods as F, ensureAuditTrailReady as H, AuditTrailMode as I, AuditTrailOptions as L, AuditOperation as M, AuditQueryOptions as N, RepositoryCacheHandle$1 as O, AuditQueryResult as P, AuditTrailQuery as R, periodCounterKey as S, sequentialId as T, auditTrailPlugin as V, customIdPlugin as _, DateSequentialIdOptions as a, getNextPeriodSequence as b, PeriodSequenceOptions as c, SequenceCounter as d, SequenceCounterOptions as f, createSequenceCounter as g, civilPeriodKey as h, CustomIdOptions as i, AuditEntry as j, RepositoryCachePluginOptions as k, PeriodSequenceResult as l, SequentialIdOptions as m, adminBypass as n, IdGenerator as o, SequencePeriod as p, multiTenantPlugin as r, PeriodSequenceKeyOptions as s, MultiTenantOptions as t, PrefixedIdOptions as u, dateSequentialId as v, readSequence as w, getNextSequence as x, ensureSequenceAtLeast as y, AuditTrailQueryOptions as z };

package/dist/{operations-XiFgG5US.d.mts → operations-D6XsHx4e.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-BAM9cA4N.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 */
@@ -368,12 +378,11 @@ interface CacheOperationOptions {
   cache?: import('@classytic/repo-core/cache').CacheOptions;
 }
 /**
- * `session.withTransaction()`'s own options param — `TransactionOptions` (readConcern,
- * writeConcern, readPreference, maxCommitTimeMS) PLUS the driver's `timeoutMS`, which is
- * NOT a field on `TransactionOptions` itself (verified against the installed mongodb
- * driver's `ClientSession.withTransaction` overload, mongodb.d.ts). `timeoutMS` bounds the
- * WHOLE `withTransaction` call, including its built-in retry loop (default 120s) — distinct
- * from `maxCommitTimeMS`, which only bounds a single `commitTransaction` server call.
+ * `TransactionOptions` (readConcern, writeConcern, readPreference, maxCommitTimeMS) PLUS
+ * `timeoutMS`: the budget for the WHOLE transaction, including its retry loop (default 120 s).
+ * It is enforced by mongokit, NOT the driver (the driver's `timeoutMS` is a no-op since 7.8):
+ * every mongokit operation inside is sent with `maxTimeMS` = what remains, and the commit with
+ * `maxCommitTimeMS` = what remained when the attempt started.
  */
 type ConvenientTransactionOptions = import('mongoose').mongo.TransactionOptions & {
   timeoutMS?: number;
@@ -555,5 +564,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-DJuRmBNx.mjs";
+import { u as PaginationConfig } from "../pagination-BAM9cA4N.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-BeJfQBJV.mjs";
+import { n as Repository } from "../Repository-DheA7oW-.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-BWb-c47a.mjs";
 export { CountMemoKey, PaginationEngine };

package/dist/pagination/PaginationEngine.mjs

@@ -1 +1 @@
-export { t as PaginationEngine } from "../PaginationEngine-DZnkbSrr.mjs";
+export { t as PaginationEngine } from "../PaginationEngine-BRlLTQQz.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-BAM9cA4N.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-BAM9cA4N.d.mts}

@@ -1,5 +1,4 @@
-import { Connection, Document, Model, PipelineStage, PopulateOptions, Types } from "mongoose";
-//#region src/types/core.d.ts
+import { Document, Model, PipelineStage, PopulateOptions, Types } from "mongoose";
 /**
  * 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';
@@ -102,25 +99,21 @@ declare function getQueryDefaults(): {
 /** Back to no deployment defaults. For tests. */
 declare function resetQueryDefaults(): void;
 /**
- * Boot check (M7): throws unless the deployment sets a query `maxTimeMS`, and — when a connection
- * is passed — unless its client carries a CSOT `timeoutMS`. Returns what it verified.
+ * Boot check (M7): throws unless the deployment sets a query `maxTimeMS`. Returns what it verified.
+ * A client `timeoutMS` is not checked: the driver (7.8+) drops it from the client options and only
+ * logs a process warning, so there is nothing to read; it bounds nothing either way.
  */
-declare function assertQueryDefaultsConfigured(connection?: Connection): {
+declare function assertQueryDefaultsConfigured(): {
   maxTimeMS: number;
-  timeoutMS?: number;
 };
 declare const QUERY_DEFAULTS_ERROR_CODES: {
-  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 NOT_CONFIGURED: 'mongokit.query_defaults.not_configured';
 };
 /** 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 +149,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 +454,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-DrNGWV5b.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-BAM9cA4N.mjs";
+import { h as RepositoryInstance, p as RepositoryContext } from "./repository-B0aFVgP2.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-COYrUdd8.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-BTPtCLNK.mjs";
+import { C as RepositoryPluginName, S as MongoKitPluginName, l as Plugin, x as MONGOKIT_PLUGIN_NAMES } from "../repository-B0aFVgP2.mjs";
+import { n as RetentionPurgeEvent, r as RetentionPurgeRequest, t as RETENTION_PURGE_ERROR_CODES } from "../retention-purge-CCd_VXUf.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-DJplVJ12.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-B-IJrlYb.mjs";
+import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "../method-registry.plugin-BeJfQBJV.mjs";
+import { d as RETENTION_PURGE_ERROR_CODES, i as searchKeysPlugin } from "../Repository-DheA7oW-.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 };