@classytic/mongokit 3.39.0 → 3.40.1

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,22 @@
-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-ZbLtL7Nk.mjs";
-import { A as ensureAuditTrailReady, C as AuditTrailMethods, D as AuditTrailQueryOptions, E as AuditTrailQuery, O as EnsureAuditTrailReadyOptions, S as AuditQueryResult, T as AuditTrailOptions, _ as RepositoryCachePluginOptions, a as DateSequentialIdOptions, b as AuditOperation, c as SequentialIdOptions, d as getNextSequence, f as prefixedId, g as RepositoryCacheHandle, h as CacheOptions, i as CustomIdOptions, k as auditTrailPlugin, l as customIdPlugin, m as CacheAdapter, n as adminBypass, o as IdGenerator, p as sequentialId, r as multiTenantPlugin, s as PrefixedIdOptions, t as MultiTenantOptions, u as dateSequentialId, v as cachePlugin, w as AuditTrailMode, x as AuditQueryOptions, y as AuditEntry } from "./multi-tenant.plugin-B-tzNeYL.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-D-P19Y9m.mjs";
-import { a as AggregationPlan, c as SortOrder, i as AggregationBuilder, l as SortSpec, n as Repository, o as GroupSpec, r as TransitionMachine, s as ProjectionSpec, t as HOOK_PRIORITY, u as VectorSearchOptions } from "./Repository-IxI983_m.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-BuvtOSZf.mjs";
-import { n as CreateRepositoryConfig, r as createRepository, t as AuditConfig } from "./create-repository-CRXjDa3N.mjs";
-import { A as IdempotencyStoreMethods, B as auditLogPlugin, C as LeaseMethods, D as ImmutableStatesPluginOptions, E as ImmutableClaimView, F as elasticSearchPlugin, H as appendOnlyPlugin, I as cascadePlugin, L as BatchOperationsMethods, M as idempotencyStorePlugin, N as fieldFilterPlugin, O as immutableStatesPlugin, P as ElasticSearchOptions, R as BulkWriteResult, S as methodRegistryPlugin, T as leasePlugin, U as AggregateHelpersMethods, V as AppendOnlyPluginOptions, W as aggregateHelpersPlugin, _ 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 batchOperationsPlugin } from "./validation-chain.plugin-DvrLJIbJ.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-B8ufk3Qz.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';
 /** Raw collection surface — a native MongoDB `Collection` or a Mongoose `Model`. */
@@ -430,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}.
    *
@@ -460,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>;
@@ -507,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 */
@@ -712,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 {
@@ -720,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
@@ -837,6 +878,35 @@ declare function isTransactionUnsupported(error: Error): boolean;
  */
 declare function supportsTransactions(connection: unknown): boolean;
 //#endregion
+//#region src/utils/scope.d.ts
+/** The fields that decide whose rows an operation touches, and inside which transaction. */
+interface RepoScope {
+  /** Platform-admin escape hatch. Present only when the source carried no tenant. */
+  bypassTenant?: true;
+  session?: ClientSession;
+  user?: unknown;
+  userId?: unknown;
+  requestId?: unknown;
+  /** Tenant values, keyed by each declared tenant context key (`organizationId`, …). */
+  [tenantKey: string]: unknown;
+}
+/**
+ * Record that `repo` resolves its tenant from `contextKey`. Called by
+ * `multiTenantPlugin` at bind, so forwarding knows a custom key (`branchId`)
+ * without the host restating it.
+ */
+declare function declareTenantContextKey(repo: object, contextKey: string): void;
+/** Every tenant context key relevant to a call spanning these repositories. */
+declare function tenantContextKeysOf(...repos: ReadonlyArray<object | undefined>): string[];
+/**
+ * The scope to hand a second repository call made on behalf of `source`
+ * (a hook's `RepositoryContext`, or a host's request context).
+ *
+ * Absent values are omitted, never written as `undefined`, so spreading the
+ * result into an options bag cannot erase a value set there.
+ */
+declare function forwardScope(source: Record<string, unknown> | null | undefined, tenantKeys?: readonly string[]): RepoScope;
+//#endregion
 //#region src/utils/repo-options.d.ts
 /**
  * Forward request-scoped context fields into a mongokit options bag.
@@ -883,23 +953,20 @@ declare function supportsTransactions(connection: unknown): boolean;
  * });
  * ```
  *
- * The fields read (all optional — extracted only when present and not
- * `undefined`):
- *
- * - `organizationId` — multi-tenant scope key. The
- *   `multiTenantPlugin` casts to `ObjectId` automatically when
- *   configured with `fieldType: 'objectId'`; do NOT pre-cast.
- * - `userId` / `user` — audit attribution (audit-log + audit-trail
- *   plugins read these for the `who` column).
- * - `session` — mongoose `ClientSession` for transaction threading.
- * - `requestId` — observability correlation id.
- *
- * Fields beyond this set should be added inline at the call site —
- * `repoOptionsFromCtx` deliberately stays narrow so adding a new
- * convention to the canonical set is a deliberate API decision, not
- * a quiet drift.
+ * It is `forwardScope` (see `./scope.ts`), the same rule every internal
+ * hop uses, so a request context and a cascade forward identically:
+ *
+ * - the tenant (`organizationId`, `tenantId`) — `multiTenantPlugin` casts
+ *   to `ObjectId` itself when configured with `fieldType: 'objectId'`;
+ *   do NOT pre-cast;
+ * - `bypassTenant`, only when literally `true` AND no tenant is present
+ *   (the tenant plugin honours a bypass before a tenant, so carrying both
+ *   would widen a scoped call to every tenant);
+ * - `session`, and `user` / `userId` / `requestId` for attribution.
+ *
+ * Domain fields beyond this set belong to `createOptionsExtractor`.
  */
-declare function repoOptionsFromCtx<TCtx extends Record<string, unknown>>(ctx: TCtx | undefined | null): Record<string, unknown>;
+declare function repoOptionsFromCtx<TCtx extends Record<string, unknown>>(ctx: TCtx | undefined | null): RepoScope;
 /**
  * Build a typed extractor for **consumer-defined** ctx → options
  * forwarding. Same conceptual shape as `repoOptionsFromCtx`, but the
@@ -920,12 +987,11 @@ declare function repoOptionsFromCtx<TCtx extends Record<string, unknown>>(ctx: T
  * output keys are inferred from the input field tuple — you can
  * destructure with full autocomplete.
  *
- * **Difference from `repoOptionsFromCtx`.** That helper hardcodes the
- * fields **mongokit's bundled plugins** read (`organizationId`,
- * `userId`, `user`, `session`, `requestId`). Use it when those are
- * sufficient. Reach for `createOptionsExtractor` when your domain has
- * its own canonical fields (`actorRef`, `actorKind`, `correlationId`,
- * `idempotencyKey`, `sagaRunId`, ...) that should also forward.
+ * **Scope is always included, and never from `fields`.** The extractor
+ * returns `forwardScope(ctx)` plus the declared DOMAIN fields. Listing a
+ * scope key (`organizationId`, `bypassTenant`, `session`, …) in `fields`
+ * changes nothing: those follow the one scope rule, so an extractor cannot
+ * forget the bypass, or carry a bypass beside a tenant.
  *
  * @example Per-package canonical extractor
  * ```ts
@@ -940,12 +1006,12 @@ declare function repoOptionsFromCtx<TCtx extends Record<string, unknown>>(ctx: T
  *   idempotencyKey?: string;
  * };
  *
+ * // Domain fields only: the scope (organizationId, session, bypass) is
+ * // always included by the one scope rule.
  * export const repoOptionsFromCtx = createOptionsExtractor<CommissionCtx>([
- *   'organizationId',
  *   'actorRef',
  *   'actorKind',
  *   'correlationId',
- *   'session',
  *   'idempotencyKey',
  * ]);
  *
@@ -1036,4 +1102,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 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 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, 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, defineModel, defineModels, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, filterResponseData, getFieldsForUser, getMongooseProjection, getNextSequence, getPaginationDefaults, idVariants, idempotencyStorePlugin, immutableField, immutableStatesPlugin, isCreateManyPartialError, isDuplicateKeyError, isModelRegistered, isTransactionUnsupported, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, probeMongoCapabilities, repoOptionsFromCtx, requireField, resetCapabilityProbeCache, resetPaginationDefaults, resolveMongoCapabilities, resolveTransactionSupport, sequentialId, softDeletePlugin, subdocumentPlugin, supportsTransactions, systemContext, 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, 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, sequentialId, softDeletePlugin, subdocumentPlugin, supportsTransactions, systemContext, tenantContextKeysOf, timestampPlugin, toPlain, transactionResolutionOf, uniqueField, validationChainPlugin, withTransaction };