@classytic/mongokit 3.40.0 → 3.41.0

package/dist/{Repository-CR8Y9g2E.d.mts → Repository-pnLw1rG5.d.mts}

@@ -1,8 +1,8 @@
-import { _ as UpdateOptions, a as CreateOptions, b as LookupOptions, c as FindOneAndUpdateOptions, d as LookupPopulateResult, g as UpdateManyResult, h as SessionOptions, m as ReadOptions, o as DeleteManyResult, p as OperationOptions, r as CacheableOptions, s as DeleteResult, t as AggregateOptions, u as LookupPopulateOptions, v as WithTransactionOptions, y as LookupBuilder } from "./operations-CrRIoc8Z.mjs";
-import { _ as PopulateSpec, g as ObjectId, i as CountStrategy, r as CollationOptions, t as AggregatePaginationOptions, u as PaginationConfig, v as ReadPreferenceType, x as SortSpec$1, y as SelectSpec } from "./pagination-BpIv2bdS.mjs";
-import { _ as RepositoryOptions, d as PluginType, f as PrioritizedHook, o as Middleware, p as RepositoryContext } from "./repository-odl03582.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-D-P19Y9m.mjs";
-import { AggPaginationRequest, AggRequest, AggResult, ArchiveOptions, ArchiveResult, ArchiveSink, ChangeEvent, FilterInput, KeysetAggPaginationResult, QueryOptions, RepoCapabilities, RepositoryBase, TenantPurgeOptions, TenantPurgeResult, TenantPurgeStrategy, WatchOptions } from "@classytic/repo-core/repository";
+import { S as LookupOptions, _ as SessionOptions, b as WithTransactionOptions, c as DeleteResult, f as LookupPopulateOptions, g as ReadOptions, h as OperationOptions, i as CacheableOptions, l as FindOneAndUpdateOptions, n as AggregateOptions, o as CreateOptions, p as LookupPopulateResult, s as DeleteManyResult, t as AggregateCallOptions, u as GetByIdsOptions, v as UpdateManyResult, x as LookupBuilder, y as UpdateOptions } from "./operations-XiFgG5US.mjs";
+import { A as ObjectId, F as SortSpec$1, M as ReadPreferenceType, N as SelectSpec, c as MongokitPageExtras, i as CountStrategy, j as PopulateSpec, r as CollationOptions, t as AggregatePaginationOptions, u as PaginationConfig } from "./pagination-D6psses0.mjs";
+import { _ as RepositoryOptions, d as PluginType, f as PrioritizedHook, o as Middleware, p as RepositoryContext } from "./repository-DNHfjAZX.mjs";
+import { n as PaginationEngine } from "./PaginationEngine-CRHyuUtw.mjs";
+import { AggPaginationRequest, AggRequest, AggResult, ArchiveOptions, ArchiveResult, ArchiveSink, BulkUpsertOptions, BulkUpsertResult, 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";
 import { RepositoryCacheHandle } from "@classytic/repo-core/cache";
@@ -622,6 +622,8 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
    * {@link ID_ADDRESSED_OPERATIONS}.
    */
   private readonly _guardIdAddressed;
+  /** This repository's own `queryDefaults` / `aggregateDefaults` (deployment ones fill the gaps). */
+  private readonly _queryDefaults;
   constructor(Model: Model<TDoc, any, any, any>, plugins?: PluginType[], paginationConfig?: PaginationConfig, options?: RepositoryOptions);
   /**
    * Live read-through view of the hook engine's listener registry.
@@ -772,6 +774,12 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
    * `_buildContext` inputs), so every op routed through `_runOp` — and the
    * inline-try methods that call this directly — honors them uniformly.
    */
+  /** One command's time bound and concerns: per call, then this repository, then the deployment. */
+  private _opts;
+  /** How an IR request runs: per-call hints, then this repository's and the deployment's defaults. */
+  private _aggRun;
+  /** Scope every join in `pipeline` under its owning collection's policy (see `join-scope.ts`). */
+  private _scopeJoins;
   private _withResilience;
   /**
    * Create single document
@@ -805,16 +813,15 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
    * const byId = await repo.getByIds(offerIds, ctx);
    * const doc = byId.get(offerId); // O(1); undefined if not found
    *
-   * Sizing: there is no library-imposed cap — the bounds are MongoDB's (the
-   * `$in` array must fit the 16 MB query document; `$in` on an indexed field
-   * is n point-lookups). Keep batches ≤ ~10k ids per call and chunk beyond
-   * that. Don't exclude the id field via `select` — result keys derive from
-   * it.
+   * Chunking: ids are split into `$in` slices of `chunkSize` (default `DEFAULT_ID_CHUNK`), one
+   * command each — sequential inside a session (a transaction runs one operation at a time),
+   * at most `concurrency` (default 4) in flight outside one. `preserveOrder: true` returns an
+   * array aligned with `ids` (`undefined` for a miss). Don't exclude the id field via `select`.
    */
-  getByIds(ids: ReadonlyArray<string | ObjectId>, options?: OperationOptions & {
-    sort?: SortSpec$1 | string;
-    limit?: number;
-  }): Promise<Map<string, TDoc>>;
+  getByIds(ids: ReadonlyArray<string | ObjectId>, options: GetByIdsOptions & {
+    preserveOrder: true;
+  }): Promise<Array<TDoc | undefined>>;
+  getByIds(ids: ReadonlyArray<string | ObjectId>, options?: GetByIdsOptions): Promise<Map<string, TDoc>>;
   /**
    * Get single document by query
    */
@@ -844,6 +851,31 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
     sort?: SortSpec$1 | string;
     limit?: number;
   }): Promise<TDoc[]>;
+  /**
+   * The keyset cursor `getAll({ sort, filters, mode: 'keyset' })` would mint for `row`, under the
+   * same policy scope, so a page resumes AFTER it. For composing keyset walks (repo-core
+   * `mergeKeysetPages` via `keysetSource`), where the last CONSUMED row is not a page's last row.
+   */
+  keysetCursor(row: unknown, options: ReadOptions & {
+    sort: SortSpec$1 | string;
+    filters?: Record<string, unknown>;
+    collation?: CollationOptions;
+  }): Promise<string>;
+  /**
+   * Resumable keyset batches over `_id`: each batch is ONE bounded `find` (no long-lived server
+   * cursor, so no cursor timeout and no CSOT lifetime budget), memory is one batch, and every
+   * batch carries a `checkpoint`. Pass a checkpoint back as `after` to resume: rows written
+   * behind it are not revisited, rows ahead of it are reached. A checkpoint is bound to the
+   * collection, the post-policy filter (tenant included) and is refused elsewhere.
+   */
+  iterate(filter?: Record<string, unknown>, options?: ReadOptions & {
+    after?: string;
+    batchSize?: number;
+    select?: SelectSpec;
+  }): AsyncIterableIterator<{
+    docs: TDoc[];
+    checkpoint: string;
+  }>;
   /**
    * Streaming reads — async iterator over data, suitable for migrations,
    * backfills, schema audits, and any once-a-quarter "touch every row"
@@ -1562,6 +1594,13 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
   archiveByFilter(filter: Record<string, unknown> | Filter, sink: ArchiveSink<TDoc>, options?: ArchiveOptions & {
     session?: ClientSession;
   }): Promise<ArchiveResult>;
+  /**
+   * Many keyed upserts in ONE command with an exact per-row outcome (repo-core `bulkUpsert` IR).
+   * Sub-ops pass through the `before:bulkUpsert` policy hooks (tenant, soft-delete) like bulkWrite
+   * sub-ops. Refused unless a unique index is pinned by the key plus the policy scope. Needs
+   * MongoDB 8.0 (client bulkWrite with verbose results).
+   */
+  bulkUpsert(rows: readonly Record<string, unknown>[], options: BulkUpsertOptions): Promise<BulkUpsertResult>;
   /**
    * Kit-native aggregation pipeline — takes a MongoDB stage array and
    * returns the raw pipeline output. Use this for `$lookup`, `$unwind`,
@@ -1601,7 +1640,7 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
    * Policy hooks (multi-tenant, soft-delete) inject context.filters
    * which are prepended as a `$match` stage.
    */
-  aggregatePipelinePaginate(options?: AggregatePaginationOptions): Promise<AggregatePaginationResult<TDoc>>;
+  aggregatePipelinePaginate(options?: AggregatePaginationOptions): Promise<AggregatePaginationResult<TDoc, MongokitPageExtras>>;
   /**
    * Portable aggregation. Compiles the repo-core `AggRequest` IR to
    * `[{$match}, {$group}, {$addFields}, {$project}, {$match}, {$sort},
@@ -1624,7 +1663,9 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
    * `context.filter`, which is merged into the pre-aggregate `$match`
    * before compilation.
    */
-  aggregate<TRow extends Record<string, unknown> = Record<string, unknown>>(req: AggRequest, options?: QueryOptions): Promise<AggResult<TRow>>;
+  aggregate<TRow extends Record<string, unknown> = Record<string, unknown>>(req: AggRequest, options?: QueryOptions & AggregateCallOptions): Promise<AggResult<TRow> & {
+    plan?: unknown;
+  }>;
   /**
    * Invalidate every aggregate-cache entry tagged with ANY of the
    * given tags. Delegates to the unified cache plugin's handle

package/dist/actions/index.d.mts

@@ -1,2 +1,2 @@
-import { c as create_d_exports, i as delete_d_exports, n as update_d_exports, r as read_d_exports, u as aggregate_d_exports } from "../index-CmjNyulu.mjs";
+import { c as create_d_exports, i as delete_d_exports, n as update_d_exports, r as read_d_exports, u as aggregate_d_exports } from "../index-SYF8N28D.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/actions/index.mjs

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "../rolldown-runtime-D7D4PA-g.mjs";
-import { S as create_exports, i as update_exports, m as aggregate_exports, p as delete_exports, u as read_exports } from "../update-DG0fCwRJ.mjs";
+import { S as create_exports, i as update_exports, m as aggregate_exports, p as delete_exports, u as read_exports } from "../update-WgeAUJ_I.mjs";
 //#region src/actions/index.ts
 var actions_exports = /* @__PURE__ */ __exportAll({
 	aggregate: () => aggregate_exports,

package/dist/adapter/index.mjs

@@ -1,2 +1,2 @@
-import { n as createMongooseAdapter, r as isMongooseModel, t as MongooseAdapter } from "../adapter-BrVfPFSW.mjs";
+import { n as createMongooseAdapter, r as isMongooseModel, t as MongooseAdapter } from "../adapter-CkMoMF83.mjs";
 export { MongooseAdapter, createMongooseAdapter, isMongooseModel };

package/dist/{adapter-BrVfPFSW.mjs → adapter-CkMoMF83.mjs}

@@ -1,5 +1,5 @@
 import { n as warn } from "./logger-K7dPmu2U.mjs";
-import { t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-waUVQwK4.mjs";
+import { t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-C3k4ide0.mjs";
 import { matchesRecordFilter } from "@classytic/repo-core/filter";
 import { mergeFieldRuleConstraints } from "@classytic/repo-core/schema";
 import { asRepositoryLike, isRepository } from "@classytic/repo-core/adapter";

package/dist/ai/index.d.mts

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

package/dist/better-auth/index.mjs

@@ -1,5 +1,5 @@
-import { n as Repository } from "../Repository-BMgPSkqZ.mjs";
-import { n as createMongooseAdapter } from "../adapter-BrVfPFSW.mjs";
+import { n as Repository } from "../Repository-DlhPbXlG.mjs";
+import { n as createMongooseAdapter } from "../adapter-CkMoMF83.mjs";
 import { asReadOnlyRepo } from "@classytic/repo-core/repository";
 import { pluralizeBetterAuthCollection, resolveBetterAuthCollections } from "@classytic/repo-core/better-auth";
 //#region src/better-auth/index.ts

package/dist/{create-repository-CAle1MSU.d.mts → create-repository-BUx9vfG9.d.mts}

@@ -1,8 +1,8 @@
-import { u as PaginationConfig } from "./pagination-BpIv2bdS.mjs";
-import { _ as RepositoryOptions, d as PluginType } from "./repository-odl03582.mjs";
-import { D as AuditTrailOptions, i as CustomIdOptions, t as MultiTenantOptions, y as RepositoryCachePluginOptions } from "./multi-tenant.plugin-CBgCo9im.mjs";
-import { r as Repository } from "./Repository-CR8Y9g2E.mjs";
-import { i as Logger, o as SoftDeleteOptions } from "./plugin-options-Zk46lD6F.mjs";
+import { u as PaginationConfig } from "./pagination-D6psses0.mjs";
+import { _ as RepositoryOptions, d as PluginType } from "./repository-DNHfjAZX.mjs";
+import { D as AuditTrailOptions, i as CustomIdOptions, t as MultiTenantOptions, y as RepositoryCachePluginOptions } from "./multi-tenant.plugin-a3UhQARj.mjs";
+import { r as Repository } from "./Repository-pnLw1rG5.mjs";
+import { i as Logger, o as SoftDeleteOptions } from "./plugin-options-CRhIvSzx.mjs";
 import { Model } from "mongoose";
 //#region src/create-repository.d.ts
 /**

package/dist/{create-repository-BzBUMvd1.mjs → create-repository-Bg0H5rte.mjs}

@@ -1,5 +1,5 @@
-import { n as Repository } from "./Repository-BMgPSkqZ.mjs";
-import { b as auditLogPlugin, g as cachePlugin, i as multiTenantPlugin, l as customIdPlugin, n as softDeletePlugin, t as timestampPlugin, v as auditTrailPlugin } from "./timestamp.plugin-DF0gJB6p.mjs";
+import { n as Repository } from "./Repository-DlhPbXlG.mjs";
+import { b as auditLogPlugin, g as cachePlugin, i as multiTenantPlugin, l as customIdPlugin, n as softDeletePlugin, t as timestampPlugin, v as auditTrailPlugin } from "./timestamp.plugin-DvZlnKEc.mjs";
 import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "./method-registry.plugin-C63pGn1d.mjs";
 //#region src/create-repository.ts
 function isLoggerAudit(value) {

package/dist/{index-CmjNyulu.d.mts → index-SYF8N28D.d.mts}

@@ -1,5 +1,5 @@
-import { _ as UpdateOptions, a as CreateOptions, b as LookupOptions, c as FindOneAndUpdateOptions, f as MinMaxResult, g as UpdateManyResult, l as GroupResult, p as OperationOptions, s as DeleteResult } from "./operations-CrRIoc8Z.mjs";
-import { _ as PopulateSpec, g as ObjectId, p as AnyDocument, v as ReadPreferenceType, x as SortSpec, y as SelectSpec } from "./pagination-BpIv2bdS.mjs";
+import { S as LookupOptions, c as DeleteResult, d as GroupResult, h as OperationOptions, l as FindOneAndUpdateOptions, m as MinMaxResult, o as CreateOptions, v as UpdateManyResult, y as UpdateOptions } from "./operations-XiFgG5US.mjs";
+import { A as ObjectId, D as AnyDocument, F as SortSpec, N as SelectSpec, j as PopulateSpec, y as ResolvedQueryOptions } from "./pagination-D6psses0.mjs";
 import { p as UpdateWithValidationResult } from "./type-utils-CLzRFtIA.mjs";
 import { Model, PipelineStage } from "mongoose";
 declare namespace aggregate_d_exports {
@@ -79,7 +79,7 @@ declare function facet<TResult = Record<string, unknown[]>>(Model: Model<any>, f
  */
 declare function distinct<T = unknown>(Model: Model<any>, field: string, query?: Record<string, unknown>, options?: {
   session?: unknown;
-  readPreference?: string;
+  queryOptions?: ResolvedQueryOptions;
 }): Promise<T[]>;
 /**
  * Calculate sum
@@ -102,10 +102,14 @@ declare function minMax(Model: Model<any>, field: string, query?: Record<string,
 declare namespace create_d_exports {
   export { CreateManyFailure, CreateManyPartial, CreateManyPartialError, create, createDefault, createMany, isCreateManyPartialError, upsert };
 }
+/** Action options: the repository resolves the write concern once and passes it here. */
+type ActionCreateOptions = CreateOptions & {
+  queryOptions?: ResolvedQueryOptions;
+};
 /**
  * Create single document
  */
-declare function create<TDoc = AnyDocument>(Model: Model<TDoc>, data: Record<string, unknown>, options?: CreateOptions): Promise<TDoc>;
+declare function create<TDoc = AnyDocument>(Model: Model<TDoc>, data: Record<string, unknown>, options?: ActionCreateOptions): Promise<TDoc>;
 /**
  * One rejected input, keyed by its position in the array that was passed in.
  *
@@ -159,7 +163,7 @@ declare function isCreateManyPartialError<TDoc = AnyDocument>(err: unknown): err
  * `failed`, or to reconcile — and prefer a unique index or an idempotency key
  * for anything that will be retried automatically.
  */
-declare function createMany<TDoc = AnyDocument>(Model: Model<TDoc>, dataArray: Record<string, unknown>[], options?: CreateOptions): Promise<TDoc[]>;
+declare function createMany<TDoc = AnyDocument>(Model: Model<TDoc>, dataArray: Record<string, unknown>[], options?: ActionCreateOptions): Promise<TDoc[]>;
 /**
  * Create with defaults (useful for initialization)
  */
@@ -181,6 +185,7 @@ declare namespace delete_d_exports {
 declare function deleteById<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, options?: {
   session?: unknown;
   query?: Record<string, unknown>;
+  queryOptions?: ResolvedQueryOptions;
 }): Promise<DeleteResult | null>;
 /**
  * Delete many documents. Always returns a {@link DeleteResult} (never
@@ -196,6 +201,7 @@ declare function deleteMany<TDoc = AnyDocument>(Model: Model<TDoc>, query: Recor
 declare function deleteByQuery(Model: Model<any>, query: Record<string, unknown>, options?: {
   session?: unknown;
   throwOnNotFound?: boolean;
+  queryOptions?: ResolvedQueryOptions;
 }): Promise<DeleteResult | null>;
 /**
  * Soft delete (set deleted flag). Returns `null` on miss for parity with
@@ -215,6 +221,10 @@ declare function restore<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | Ob
 declare namespace read_d_exports {
   export { count, exists, getAll, getById, getByQuery, getOrCreate, tryGetByQuery };
 }
+/** Action options: the repository resolves time bound / concerns once and passes them here. */
+type ActionReadOptions = OperationOptions & {
+  queryOptions?: ResolvedQueryOptions;
+};
 /**
  * Get document by ID
  *
@@ -224,7 +234,7 @@ declare namespace read_d_exports {
  * @returns Document or null
  * @throws Error if document not found and throwOnNotFound is true
  */
-declare function getById<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, options?: OperationOptions): Promise<TDoc | null>;
+declare function getById<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, options?: ActionReadOptions): Promise<TDoc | null>;
 /**
  * Get document by query
  *
@@ -234,13 +244,13 @@ declare function getById<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | Ob
  * @returns Document or null
  * @throws Error if document not found and throwOnNotFound is true
  */
-declare function getByQuery<TDoc = AnyDocument>(Model: Model<TDoc>, query: Record<string, unknown>, options?: OperationOptions & {
+declare function getByQuery<TDoc = AnyDocument>(Model: Model<TDoc>, query: Record<string, unknown>, options?: ActionReadOptions & {
   sort?: SortSpec;
 }): Promise<TDoc | null>;
 /**
  * Get document by query without throwing (returns null if not found)
  */
-declare function tryGetByQuery<TDoc = AnyDocument>(Model: Model<TDoc>, query: Record<string, unknown>, options?: Omit<OperationOptions, 'throwOnNotFound'>): Promise<TDoc | null>;
+declare function tryGetByQuery<TDoc = AnyDocument>(Model: Model<TDoc>, query: Record<string, unknown>, options?: Omit<ActionReadOptions, 'throwOnNotFound'>): Promise<TDoc | null>;
 /**
  * Get all documents (basic query without pagination)
  * For pagination, use Repository.paginate() or Repository.stream()
@@ -253,7 +263,7 @@ declare function getAll<TDoc = AnyDocument>(Model: Model<TDoc>, query?: Record<s
   skip?: number;
   lean?: boolean;
   session?: unknown;
-  readPreference?: ReadPreferenceType;
+  queryOptions?: ResolvedQueryOptions;
 }): Promise<TDoc[]>;
 /**
  * Get or create document (atomic upsert).
@@ -282,29 +292,36 @@ declare function getOrCreate<TDoc = AnyDocument>(Model: Model<TDoc>, query: Reco
  */
 declare function count<TDoc = AnyDocument>(Model: Model<TDoc>, query?: Record<string, unknown>, options?: {
   session?: unknown;
-  readPreference?: ReadPreferenceType;
+  queryOptions?: ResolvedQueryOptions;
 }): Promise<number>;
 /**
  * Check if document exists
  */
 declare function exists<TDoc = AnyDocument>(Model: Model<TDoc>, query: Record<string, unknown>, options?: {
   session?: unknown;
-  readPreference?: ReadPreferenceType;
+  queryOptions?: ResolvedQueryOptions;
 }): Promise<{
   _id: unknown;
 } | null>;
 declare namespace update_d_exports {
   export { findOneAndUpdate, increment, pullFromArray, pushToArray, update, updateByQuery, updateMany, updateWithConstraints, updateWithValidation };
 }
+/** Action options: the repository resolves time bound / write concern once and passes them here. */
+type ActionUpdateOptions = UpdateOptions & {
+  queryOptions?: ResolvedQueryOptions;
+};
+type ActionFindOneAndUpdateOptions = FindOneAndUpdateOptions & {
+  queryOptions?: ResolvedQueryOptions;
+};
 /**
  * Update by ID
  */
-declare function update<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, data: Record<string, unknown>, options?: UpdateOptions): Promise<TDoc | null>;
+declare function update<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, data: Record<string, unknown>, options?: ActionUpdateOptions): Promise<TDoc | null>;
 /**
  * Update with query constraints (optimized)
  * Returns null if constraints not met (not an error)
  */
-declare function updateWithConstraints<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, data: Record<string, unknown>, constraints?: Record<string, unknown>, options?: UpdateOptions): Promise<TDoc | null>;
+declare function updateWithConstraints<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, data: Record<string, unknown>, constraints?: Record<string, unknown>, options?: ActionUpdateOptions): Promise<TDoc | null>;
 /**
  * Validation options for smart update
  */
@@ -323,7 +340,7 @@ interface ValidationOptions {
  * Update with validation (smart optimization)
  * 1-query on success, 2-queries for detailed errors
  */
-declare function updateWithValidation<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, data: Record<string, unknown>, validationOptions?: ValidationOptions, options?: UpdateOptions): Promise<UpdateWithValidationResult<TDoc>>;
+declare function updateWithValidation<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, data: Record<string, unknown>, validationOptions?: ValidationOptions, options?: ActionUpdateOptions): Promise<UpdateWithValidationResult<TDoc>>;
 /**
  * Update many documents
  */
@@ -331,11 +348,12 @@ declare function updateMany(Model: Model<unknown>, query: Record<string, unknown
   session?: unknown;
   updatePipeline?: boolean;
   arrayFilters?: Record<string, unknown>[];
+  queryOptions?: ResolvedQueryOptions;
 }): Promise<UpdateManyResult>;
 /**
  * Update by query
  */
-declare function updateByQuery<TDoc = AnyDocument>(Model: Model<TDoc>, query: Record<string, unknown>, data: Record<string, unknown>, options?: UpdateOptions): Promise<TDoc | null>;
+declare function updateByQuery<TDoc = AnyDocument>(Model: Model<TDoc>, query: Record<string, unknown>, data: Record<string, unknown>, options?: ActionUpdateOptions): Promise<TDoc | null>;
 /**
  * Atomic findOneAndUpdate primitive.
  *
@@ -343,19 +361,19 @@ declare function updateByQuery<TDoc = AnyDocument>(Model: Model<TDoc>, query: Re
  * matches and `upsert` is false. Used by outbox relays, distributed locks,
  * and workflow semaphores that need compare-and-set in a single round-trip.
  */
-declare function findOneAndUpdate<TDoc = AnyDocument>(Model: Model<TDoc>, filter: Record<string, unknown>, update: Record<string, unknown> | Record<string, unknown>[], options?: FindOneAndUpdateOptions): Promise<TDoc | null>;
+declare function findOneAndUpdate<TDoc = AnyDocument>(Model: Model<TDoc>, filter: Record<string, unknown>, update: Record<string, unknown> | Record<string, unknown>[], options?: ActionFindOneAndUpdateOptions): Promise<TDoc | null>;
 /**
  * Increment field
  */
-declare function increment<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, field: string, value?: number, options?: UpdateOptions): Promise<TDoc | null>;
+declare function increment<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, field: string, value?: number, options?: ActionUpdateOptions): Promise<TDoc | null>;
 /**
  * Push to array
  */
-declare function pushToArray<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, field: string, value: unknown, options?: UpdateOptions): Promise<TDoc | null>;
+declare function pushToArray<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, field: string, value: unknown, options?: ActionUpdateOptions): Promise<TDoc | null>;
 /**
  * Pull from array
  */
-declare function pullFromArray<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, field: string, value: unknown, options?: UpdateOptions): Promise<TDoc | null>;
+declare function pullFromArray<TDoc = AnyDocument>(Model: Model<TDoc>, id: string | ObjectId, field: string, value: unknown, options?: ActionUpdateOptions): Promise<TDoc | null>;
 declare namespace index_d_exports {
   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/index.d.mts

@@ -1,19 +1,21 @@
-import { _ as UpdateOptions, a as CreateOptions, b as LookupOptions, c as FindOneAndUpdateOptions, d as LookupPopulateResult, f as MinMaxResult, g as UpdateManyResult, h as SessionOptions, i as ConvenientTransactionOptions, l as GroupResult, m as ReadOptions, n as CacheOperationOptions, p as OperationOptions, r as CacheableOptions, s as DeleteResult, t as AggregateOptions, u as LookupPopulateOptions, v as WithTransactionOptions, y as LookupBuilder } from "./operations-CrRIoc8Z.mjs";
-import { _ as PopulateSpec, a as CursorPayload, b as SortDirection, c as MongokitPageExtras, d as ValueType, f as CursorSecret, g as ObjectId, i as CountStrategy, l as OffsetPaginationOptions, m as AnyModel, n as BasePaginationOptions, o as DecodedCursor, p as AnyDocument, r as CollationOptions, s as KeysetPaginationOptions, t as AggregatePaginationOptions, u as PaginationConfig, v as ReadPreferenceType, x as SortSpec$1, y as SelectSpec } from "./pagination-BpIv2bdS.mjs";
-import { a as CreateManyFailure, l as isCreateManyPartialError, o as CreateManyPartial, s as CreateManyPartialError, t as index_d_exports } from "./index-CmjNyulu.mjs";
+import { S as LookupOptions, _ as SessionOptions, a as ConvenientTransactionOptions, b as WithTransactionOptions, c as DeleteResult, d as GroupResult, f as LookupPopulateOptions, g as ReadOptions, h as OperationOptions, i as CacheableOptions, l as FindOneAndUpdateOptions, m as MinMaxResult, n as AggregateOptions, o as CreateOptions, p as LookupPopulateResult, r as CacheOperationOptions, t as AggregateCallOptions, u as GetByIdsOptions, v as UpdateManyResult, x as LookupBuilder, y as UpdateOptions } from "./operations-XiFgG5US.mjs";
+import { A as ObjectId, C as configureQueryDefaults, D as AnyDocument, E as resolveQueryOptions, F as SortSpec$1, M as ReadPreferenceType, N as SelectSpec, O as AnyModel, P as SortDirection, S as configureAggregateDefaults, T as resetQueryDefaults, _ as QueryDefaults, a as CursorPayload, b as WriteConcernSpec, c as MongokitPageExtras, d as ValueType, f as CursorSecret, g as QUERY_DEFAULTS_ERROR_CODES, h as PerCallQueryOptions, i as CountStrategy, j as PopulateSpec, l as OffsetPaginationOptions, m as CommandKind, n as BasePaginationOptions, o as DecodedCursor, p as AggregateDefaults, r as CollationOptions, s as KeysetPaginationOptions, t as AggregatePaginationOptions, u as PaginationConfig, v as ReadConcernLevel, w as getQueryDefaults, x as assertQueryDefaultsConfigured, y as ResolvedQueryOptions } from "./pagination-D6psses0.mjs";
+import { a as CreateManyFailure, l as isCreateManyPartialError, o as CreateManyPartial, s as CreateManyPartialError, t as index_d_exports } from "./index-SYF8N28D.mjs";
 import { a as InferRawDoc, c as NonNullableFields, d as Strict, f as UpdatePatch, i as InferDocument, l as PartialBy, n as DeepPartial, o as KeysOfType, p as UpdateWithValidationResult, r as DocField, s as MongoOperatorUpdate, t as CreateInput, u as RequiredBy } from "./type-utils-CLzRFtIA.mjs";
-import { S as RepositoryPluginName, _ as RepositoryOptions, a as HookMode, b as MONGOKIT_PLUGIN_NAMES, c as MinimalRepoView, d as PluginType, f as PrioritizedHook, g as RepositoryOperation, h as RepositoryInstance, i as EventPhase, l as Plugin, m as RepositoryEvent, n as EventHandlers, o as Middleware, p as RepositoryContext, r as EventPayload, s as MiddlewareContext, t as AllPluginMethods, u as PluginFunction, v as UserContext, x as MongoKitPluginName, y as WithPlugins } from "./repository-odl03582.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, d as ensureSequenceAtLeast, f as getNextSequence, g as CacheAdapter, h as sequentialId, i as CustomIdOptions, j as auditTrailPlugin, k as AuditTrailQueryOptions, l as customIdPlugin, m as readSequence, n as adminBypass, 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-CBgCo9im.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-D-P19Y9m.mjs";
-import { a as AggregationBuilder, c as ProjectionSpec, d as VectorSearchOptions, i as TransitionMachine, l as SortOrder, n as HOOK_PRIORITY, o as AggregationPlan, r as Repository, s as GroupSpec, t as GetAllParams, u as SortSpec } from "./Repository-CR8Y9g2E.mjs";
-import { a as SoftDeleteFilterMode, c as ValidationChainOptions, i as Logger, l as ValidatorDefinition, n as CascadeRelation, o as SoftDeleteOptions, r as FieldPreset, s as SoftDeleteRepository, t as CascadeOptions } from "./plugin-options-Zk46lD6F.mjs";
-import { n as CreateRepositoryConfig, r as createRepository, t as AuditConfig } from "./create-repository-CAle1MSU.mjs";
-import { A as IdempotencyStoreMethods, B as batchOperationsPlugin, C as LeaseMethods, D as ImmutableStatesPluginOptions, E as ImmutableClaimView, F as elasticSearchPlugin, G as aggregateHelpersPlugin, H as AppendOnlyPluginOptions, I as cascadePlugin, L as BatchOperationsMethods, M as idempotencyStorePlugin, N as fieldFilterPlugin, O as immutableStatesPlugin, P as ElasticSearchOptions, R as BulkWriteOptions, S as methodRegistryPlugin, T as leasePlugin, U as appendOnlyPlugin, V as auditLogPlugin, W as AggregateHelpersMethods, _ as OperationMetric, a as requireField, b as mongoOperationsPlugin, c as timestampPlugin, d as createTenantContext, f as SubdocumentMethods, g as ObservabilityOptions, h as softDeletePlugin, i as immutableField, j as IdempotencyStorePluginOptions, k as IdempotencyClaim, l as TenantContext, m as SoftDeleteMethods, n as autoInject, o as uniqueField, p as subdocumentPlugin, r as blockIf, s as validationChainPlugin, t as OperationType, u as TenantStore, v as observabilityPlugin, w as LeasePluginOptions, y as MongoOperationsMethods, z as BulkWriteResult } from "./validation-chain.plugin-DYp9E7K2.mjs";
+import { S as RepositoryPluginName, _ as RepositoryOptions, a as HookMode, b as MONGOKIT_PLUGIN_NAMES, c as MinimalRepoView, d as PluginType, f as PrioritizedHook, g as RepositoryOperation, h as RepositoryInstance, i as EventPhase, l as Plugin, m as RepositoryEvent, n as EventHandlers, o as Middleware, p as RepositoryContext, r as EventPayload, s as MiddlewareContext, t as AllPluginMethods, u as PluginFunction, v as UserContext, x as MongoKitPluginName, y as WithPlugins } from "./repository-DNHfjAZX.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, d as ensureSequenceAtLeast, f as getNextSequence, g as CacheAdapter, h as sequentialId, i as CustomIdOptions, j as auditTrailPlugin, k as AuditTrailQueryOptions, l as customIdPlugin, m as readSequence, n as adminBypass, 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-a3UhQARj.mjs";
+import { n as PaginationEngine, t as CountMemoKey } from "./PaginationEngine-CRHyuUtw.mjs";
+import { a as AggregationBuilder, c as ProjectionSpec, d as VectorSearchOptions, i as TransitionMachine, l as SortOrder, n as HOOK_PRIORITY, o as AggregationPlan, r as Repository, s as GroupSpec, t as GetAllParams, u as SortSpec } from "./Repository-pnLw1rG5.mjs";
+import { a as SoftDeleteFilterMode, c as ValidationChainOptions, i as Logger, l as ValidatorDefinition, n as CascadeRelation, o as SoftDeleteOptions, r as FieldPreset, s as SoftDeleteRepository, t as CascadeOptions } from "./plugin-options-CRhIvSzx.mjs";
+import { n as CreateRepositoryConfig, r as createRepository, t as AuditConfig } from "./create-repository-BUx9vfG9.mjs";
+import { A as IdempotencyStoreMethods, B as batchOperationsPlugin, C as LeaseMethods, D as ImmutableStatesPluginOptions, E as ImmutableClaimView, F as elasticSearchPlugin, G as aggregateHelpersPlugin, H as AppendOnlyPluginOptions, I as cascadePlugin, L as BatchOperationsMethods, M as idempotencyStorePlugin, N as fieldFilterPlugin, O as immutableStatesPlugin, P as ElasticSearchOptions, R as BulkWriteOptions, S as methodRegistryPlugin, T as leasePlugin, U as appendOnlyPlugin, V as auditLogPlugin, W as AggregateHelpersMethods, _ as OperationMetric, a as requireField, b as mongoOperationsPlugin, c as timestampPlugin, d as createTenantContext, f as SubdocumentMethods, g as ObservabilityOptions, h as softDeletePlugin, i as immutableField, j as IdempotencyStorePluginOptions, k as IdempotencyClaim, l as TenantContext, m as SoftDeleteMethods, n as autoInject, o as uniqueField, p as subdocumentPlugin, r as blockIf, s as validationChainPlugin, t as OperationType, u as TenantStore, v as observabilityPlugin, w as LeasePluginOptions, y as MongoOperationsMethods, z as BulkWriteResult } from "./validation-chain.plugin-CTcNJCmV.mjs";
 import { n as SchemaPathsLike, t as FieldType$1 } from "./coercion-BjdPX3YF.mjs";
 import { n as SchemaIndexes } from "./indexes-DIjMpYES.mjs";
-import { S as parseDuplicateKeyError, _ as getMongooseProjection, a as createMemoryCache, b as createError, g as getFieldsForUser, h as filterResponseData, i as buildCrudSchemasFromMongooseSchema, m as createFieldPreset, n as CrudSchemasFramework, o as LoggerConfig, r as buildCrudSchemasFromModel, s as configureLogger, t as toPlain, u as idVariants, v as CreateErrorOptions, x as isDuplicateKeyError, y as ParseDuplicateKeyOptions } from "./to-plain-k7SjNlSS.mjs";
+import { S as parseDuplicateKeyError, _ as getMongooseProjection, a as createMemoryCache, b as createError, g as getFieldsForUser, h as filterResponseData, i as buildCrudSchemasFromMongooseSchema, m as createFieldPreset, n as CrudSchemasFramework, o as LoggerConfig, r as buildCrudSchemasFromModel, s as configureLogger, t as toPlain, u as idVariants, v as CreateErrorOptions, x as isDuplicateKeyError, y as ParseDuplicateKeyOptions } from "./to-plain-CjgEInWV.mjs";
 import { RepoCapabilities } from "@classytic/repo-core/repository";
 import { ClientSession, Connection, Model, PipelineStage, Schema } from "mongoose";
+import { HttpError } from "@classytic/repo-core/errors";
+import { KeysetSource } from "@classytic/repo-core/pagination";
 import "@classytic/repo-core/query-parser";
 //#region src/actions/cascade-references.d.ts
 type PurgeMode = 'hard' | 'soft' | 'anonymize';
@@ -431,6 +433,10 @@ interface PaginationDefaults {
   cursorSecret?: CursorSecret;
   /** See {@link PaginationConfig.defaultMode}. */
   defaultMode?: 'offset' | 'keyset';
+  /** See {@link PaginationConfig.maxOffset}: the deployment's deep-offset guard. */
+  maxOffset?: number;
+  /** See {@link PaginationConfig.countCacheTtlMs}. */
+  countCacheTtlMs?: number;
   /**
    * See {@link PaginationConfig.maxPage}.
    *
@@ -461,6 +467,22 @@ declare function getPaginationDefaults(): Readonly<PaginationDefaults>;
 /** Back to library defaults. For tests — a global that cannot be reset is a leak between them. */
 declare function resetPaginationDefaults(): void;
 //#endregion
+//#region src/pagination/keyset-source.d.ts
+interface KeysetSourceOptions extends ReadOptions {
+  name: string;
+  sort: SortSpec$1;
+  filters?: Record<string, unknown>;
+}
+declare function keysetSource<TDoc>(repo: Repository<TDoc>, options: KeysetSourceOptions): KeysetSource<TDoc>;
+//#endregion
+//#region src/pagination/utils/guards.d.ts
+declare const PAGINATION_ERROR_CODES: {
+  readonly OFFSET_TOO_DEEP: "mongokit.pagination.offset_too_deep";
+  /** repo-core's shared cursor vocabulary (one code set across kits and merged cursors). */
+  readonly CURSOR_INVALID: "repo.cursor.invalid";
+  readonly CURSOR_SCOPE_MISMATCH: "repo.cursor.scope_mismatch";
+};
+//#endregion
 //#region src/query/parser/types.d.ts
 type SortSpec$2 = Record<string, 1 | -1>;
 type FilterQuery = Record<string, unknown>;
@@ -508,6 +530,10 @@ interface ParsedQuery {
   page?: number;
   /** Cursor for keyset pagination */
   after?: string;
+  /** Keyset cursor for the previous page (never with `after`). */
+  before?: string;
+  /** Explicit paging mode, when the caller named one. */
+  mode?: 'offset' | 'keyset';
   /** Limit */
   limit: number;
   /** Full-text search query */
@@ -713,6 +739,20 @@ declare class QueryParser {
   };
 }
 //#endregion
+//#region src/repository/join-scope.d.ts
+/** Returns the predicate a read of the owning collection carries for this call, or none. */
+type CollectionScopeRule = (context: RepositoryContext, operation: string) => Record<string, unknown> | undefined;
+declare const JOIN_ERROR_CODES: {
+  readonly UNKNOWN_COLLECTION: "mongokit.join.unknown_collection";
+  readonly UNGOVERNED_COLLECTION: "mongokit.join.ungoverned_collection";
+  readonly UNSCOPE_REFUSED: "mongokit.join.unscope_refused";
+  readonly UNRESOLVABLE_FROM: "mongokit.join.unresolvable_from";
+};
+/** Called by a policy plugin at bind: reads of this model's collection carry `rule`. */
+declare function declareCollectionScope(model: object, rule: CollectionScopeRule, meta?: {
+  tenantField?: string;
+}): void;
+//#endregion
 //#region src/transaction.d.ts
 /** Minimal shape we need from a Mongoose connection. */
 interface SessionStarter {
@@ -721,9 +761,9 @@ interface SessionStarter {
 /**
  * Run a callback inside a MongoDB transaction on the given connection.
  *
- * - Starts a session, runs `session.withTransaction(callback)` (which auto-retries
- *   on `TransientTransactionError` and `UnknownTransactionCommitResult`), and
- *   always ends the session in `finally`.
+ * - Starts a session and runs the callback in a transaction with the driver's retry rules
+ *   (`TransientTransactionError` → retry the attempt, `UnknownTransactionCommitResult` → retry
+ *   the commit), ending the session in `finally`. See {@link runTransaction}.
  * - When `allowFallback` is true and the deployment doesn't support transactions
  *   (e.g. standalone MongoDB in dev), the callback runs once without a
  *   transaction on the same session. `onFallback` is invoked with the original
@@ -742,6 +782,20 @@ interface SessionStarter {
  * ```
  */
 declare function withTransaction<T>(connection: SessionStarter, callback: (session: ClientSession) => Promise<T>, options?: WithTransactionOptions): Promise<T>;
+declare const TRANSACTION_ERROR_CODES: {
+  /** The session lacks a method the transaction loop drives (a partial or wrapped fake). */
+  readonly SESSION_INCOMPLETE: "mongokit.transaction.session_incomplete";
+};
+/**
+ * The driver's convenient-transaction algorithm (start → callback → commit, label-based retry,
+ * jittered backoff, a deadline), run here so the driver never attaches a session `timeoutContext`:
+ * with one, every legacy bulk write (`insertMany`, `bulkWrite`) in the transaction is refused once
+ * the client carries `timeoutMS` (driver <= 7.7: the bulk path re-resolves the inherited client
+ * `timeoutMS` as a per-op one). Each operation keeps its own per-op CSOT budget instead.
+ * Deadline: `transactionOptions.timeoutMS`, else the client's `timeoutMS`, else 120 s (as the driver).
+ * Pinned by `tests/integration/csot-transaction-matrix.test.ts`.
+ */
+declare function runTransaction<T>(session: ClientSession, callback: (session: ClientSession) => Promise<T>, transactionOptions?: ConvenientTransactionOptions): Promise<T>;
 /**
  * Multi-repo transactional batch — every repo in `repos` becomes a
  * session-bound proxy inside the callback. Eliminates the per-call
@@ -1062,4 +1116,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 AggregationPlan, type SortOrder as AggregationSortOrder, type SortSpec as AggregationSortSpec, type AllPluginMethods, type AnyDocument, type AnyModel, type AppendOnlyPluginOptions, type AuditConfig, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailMode, type AuditTrailOptions, AuditTrailQuery, type AuditTrailQueryOptions, type BasePaginationOptions, type BatchOperationsMethods, type BulkWriteOptions, type BulkWriteResult, type CacheAdapter, type CacheOperationOptions, type CacheOptions, type CacheableOptions, type CapabilityConnectionLike, type CapabilityProbeOptions, type CapabilityResolution, type CascadeOptions, type CascadePurgeReferencesOptions, type CascadeRelation, type CollationOptions, type CollectionRWLike, type ConvenientTransactionOptions, type CountStrategy, type CreateErrorOptions, type CreateInput, type CreateManyFailure, type CreateManyPartial, type CreateManyPartialError, type CreateOptions, type CreateRepositoryConfig, type CrudSchemasFramework, type CursorPayload, type CursorSecret, type CustomIdOptions, type DateSequentialIdOptions, type DecodedCursor, type DeepPartial, type DefineModelOptions, type DeleteResult, type DocField, type ElasticSearchOptions, type EnsureAuditTrailReadyOptions, type EventHandlers, type EventPayload, type EventPhase, type ExistingModelPolicy, type FieldPreset, type FieldType, type FilterQuery, type FindOneAndUpdateOptions, type GetAllParams, type GroupResult, type GroupSpec, HOOK_PRIORITY, type HookMode, type IdGenerator, type IdempotencyClaim, type IdempotencyStoreMethods, type IdempotencyStorePluginOptions, type ImmutableClaimView, type ImmutableStatesPluginOptions, type InferDocument, type InferRawDoc, type KeysOfType, type KeysetPaginationOptions, type LeaseMethods, type LeasePluginOptions, type Logger, type LoggerConfig, LookupBuilder, type LookupOptions, type LookupPopulateOptions, type LookupPopulateResult, MONGOKIT_CAPABILITIES, MONGOKIT_PLUGIN_NAMES, MUTATING_OPERATIONS, type Middleware, type MiddlewareContext, type MinMaxResult, type MinimalRepoView, type ModelBlueprint, ModelCollisionError, type ModelSpec, type MongoKitPluginName, type MongoOperationsMethods, type MongoOperatorUpdate, type MongoRepoCapabilities, type MongokitPageExtras, type MultiTenantOptions, type NonNullableFields, OP_REGISTRY, type ObjectId, type ObservabilityOptions, type OffsetPaginationOptions, type OperationDescriptor, type OperationMetric, type OperationOptions, type OperationType, type PaginationConfig, type PaginationDefaults, PaginationEngine, type ParseDuplicateKeyOptions, type ParsedQuery, type PartialBy, type Plugin, type PluginFunction, type PluginType, type PolicyKey, type PopulateOption, type PopulateSpec, type PrefixedIdOptions, type PrioritizedHook, type ProjectionSpec, type PurgeMode, type PurgeableRepoLike, QueryParser, type QueryParserOptions, type QuerySchema, READ_OPERATIONS, type ReadOptions, type ReadPreferenceType, type ReferencePurgeResult, type ReferenceRelation, type RepoScope, Repository, Repository as default, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type RepositoryContext, type RepositoryEvent, type RepositoryInstance, type RepositoryOperation, type RepositoryOptions, type RepositoryPluginName, type RequiredBy, type SchemaLike, type SearchMode, type SelectSpec, type SequentialIdOptions, type SessionOptions, type SessionStarter, type SoftDeleteFilterMode, type SoftDeleteMethods, type SoftDeleteOptions, type SoftDeleteRepository, type SortDirection, type SortSpec$1 as SortSpec, type Strict, type SubdocumentMethods, type TenantContext, type TenantStore, type TransactionSupport, type TransitionMachine, type UpdateManyResult, type UpdateOptions, type UpdatePatch, type UpdateWithValidationResult, type UserContext, type ValidationChainOptions, type ValidatorDefinition, type ValueType, type VectorSearchOptions, type WithPlugins, type WithTransactionOptions, index_d_exports as actions, adminBypass, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, capabilitiesForSupport, cascadePlugin, cascadePurgeReferences, classifyHelloReply, compileFilterToMongo, configureLogger, configurePaginationDefaults, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, declareTenantContextKey, defineModel, defineModels, elasticSearchPlugin, ensureAuditTrailReady, ensureSequenceAtLeast, fieldFilterPlugin, filterResponseData, forwardScope, getFieldsForUser, getMongooseProjection, getNextSequence, getPaginationDefaults, idVariants, idempotencyStorePlugin, immutableField, immutableStatesPlugin, isCreateManyPartialError, isDuplicateKeyError, isModelRegistered, isTransactionUnsupported, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, probeMongoCapabilities, readSequence, repoOptionsFromCtx, requireField, resetCapabilityProbeCache, resetPaginationDefaults, resolveMongoCapabilities, resolveTransactionSupport, sequentialId, softDeletePlugin, subdocumentPlugin, supportsTransactions, systemContext, tenantContextKeysOf, timestampPlugin, toPlain, transactionResolutionOf, uniqueField, validationChainPlugin, withTransaction };
+export { ALL_OPERATIONS, type AggregateCallOptions, type AggregateDefaults, type AggregateHelpersMethods, type AggregateOptions, type AggregatePaginationOptions, AggregationBuilder, type AggregationPlan, type SortOrder as AggregationSortOrder, type SortSpec as AggregationSortSpec, type AllPluginMethods, type AnyDocument, type AnyModel, type AppendOnlyPluginOptions, type AuditConfig, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailMode, type AuditTrailOptions, AuditTrailQuery, type AuditTrailQueryOptions, type BasePaginationOptions, type BatchOperationsMethods, type BulkWriteOptions, type BulkWriteResult, type CacheAdapter, type CacheOperationOptions, type CacheOptions, type CacheableOptions, type CapabilityConnectionLike, type CapabilityProbeOptions, type CapabilityResolution, type CascadeOptions, type CascadePurgeReferencesOptions, type CascadeRelation, type CollationOptions, type CollectionRWLike, type CollectionScopeRule, type CommandKind, type ConvenientTransactionOptions, type CountMemoKey, type CountStrategy, type CreateErrorOptions, type CreateInput, type CreateManyFailure, type CreateManyPartial, type CreateManyPartialError, type CreateOptions, type CreateRepositoryConfig, type CrudSchemasFramework, type CursorPayload, type CursorSecret, type CustomIdOptions, type DateSequentialIdOptions, type DecodedCursor, type DeepPartial, type DefineModelOptions, type DeleteResult, type DocField, type ElasticSearchOptions, type EnsureAuditTrailReadyOptions, type EventHandlers, type EventPayload, type EventPhase, type ExistingModelPolicy, type FieldPreset, type FieldType, type FilterQuery, type FindOneAndUpdateOptions, type GetAllParams, type GetByIdsOptions, type GroupResult, type GroupSpec, HOOK_PRIORITY, type HookMode, type IdGenerator, type IdempotencyClaim, type IdempotencyStoreMethods, type IdempotencyStorePluginOptions, type ImmutableClaimView, type ImmutableStatesPluginOptions, type InferDocument, type InferRawDoc, JOIN_ERROR_CODES, type KeysOfType, type KeysetPaginationOptions, type KeysetSourceOptions, type LeaseMethods, type LeasePluginOptions, type Logger, type LoggerConfig, LookupBuilder, type LookupOptions, type LookupPopulateOptions, type LookupPopulateResult, MONGOKIT_CAPABILITIES, MONGOKIT_PLUGIN_NAMES, MUTATING_OPERATIONS, type Middleware, type MiddlewareContext, type MinMaxResult, type MinimalRepoView, type ModelBlueprint, ModelCollisionError, type ModelSpec, type MongoKitPluginName, type MongoOperationsMethods, type MongoOperatorUpdate, type MongoRepoCapabilities, type MongokitPageExtras, type MultiTenantOptions, type NonNullableFields, OP_REGISTRY, type ObjectId, type ObservabilityOptions, type OffsetPaginationOptions, type OperationDescriptor, type OperationMetric, type OperationOptions, type OperationType, PAGINATION_ERROR_CODES, type PaginationConfig, type PaginationDefaults, PaginationEngine, type ParseDuplicateKeyOptions, type ParsedQuery, type PartialBy, type PerCallQueryOptions, type Plugin, type PluginFunction, type PluginType, type PolicyKey, type PopulateOption, type PopulateSpec, type PrefixedIdOptions, type PrioritizedHook, type ProjectionSpec, type PurgeMode, type PurgeableRepoLike, QUERY_DEFAULTS_ERROR_CODES, type QueryDefaults, QueryParser, type QueryParserOptions, type QuerySchema, READ_OPERATIONS, type ReadConcernLevel, type ReadOptions, type ReadPreferenceType, type ReferencePurgeResult, type ReferenceRelation, type RepoScope, Repository, Repository as default, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type RepositoryContext, type RepositoryEvent, type RepositoryInstance, type RepositoryOperation, type RepositoryOptions, type RepositoryPluginName, type RequiredBy, type ResolvedQueryOptions, type SchemaLike, type SearchMode, type SelectSpec, type SequentialIdOptions, type SessionOptions, type SessionStarter, type SoftDeleteFilterMode, type SoftDeleteMethods, type SoftDeleteOptions, type SoftDeleteRepository, type SortDirection, type SortSpec$1 as SortSpec, type Strict, type SubdocumentMethods, TRANSACTION_ERROR_CODES, type TenantContext, type TenantStore, type TransactionSupport, type TransitionMachine, type UpdateManyResult, type UpdateOptions, type UpdatePatch, type UpdateWithValidationResult, type UserContext, type ValidationChainOptions, type ValidatorDefinition, type ValueType, type VectorSearchOptions, type WithPlugins, type WithTransactionOptions, type WriteConcernSpec, index_d_exports as actions, adminBypass, aggregateHelpersPlugin, appendOnlyPlugin, assertQueryDefaultsConfigured, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, capabilitiesForSupport, cascadePlugin, cascadePurgeReferences, classifyHelloReply, compileFilterToMongo, configureAggregateDefaults, configureLogger, configurePaginationDefaults, configureQueryDefaults, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, declareCollectionScope, declareTenantContextKey, defineModel, defineModels, elasticSearchPlugin, ensureAuditTrailReady, ensureSequenceAtLeast, fieldFilterPlugin, filterResponseData, forwardScope, getFieldsForUser, getMongooseProjection, getNextSequence, getPaginationDefaults, getQueryDefaults, idVariants, idempotencyStorePlugin, immutableField, immutableStatesPlugin, isCreateManyPartialError, isDuplicateKeyError, isModelRegistered, isTransactionUnsupported, keysetSource, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, probeMongoCapabilities, readSequence, repoOptionsFromCtx, requireField, resetCapabilityProbeCache, resetPaginationDefaults, resetQueryDefaults, resolveMongoCapabilities, resolveQueryOptions, resolveTransactionSupport, runTransaction, sequentialId, softDeletePlugin, subdocumentPlugin, supportsTransactions, systemContext, tenantContextKeysOf, timestampPlugin, toPlain, transactionResolutionOf, uniqueField, validationChainPlugin, withTransaction };