@classytic/mongokit 3.40.1 → 3.42.0

package/dist/{PaginationEngine-CfT2Cxkj.mjs → PaginationEngine-DZnkbSrr.mjs}

@@ -1049,11 +1049,11 @@ var PaginationEngine = class {
 		const sanitizedLimit = validateLimit(limit, this.config);
 		const skip = calculateSkip(sanitizedPage, sanitizedLimit);
 		assertOffsetWithinCap(skip, this.config.maxOffset);
-		let query = this.Model.find(filters);
+		let query = this.Model.find(filters).lean(lean);
 		if (select) query = query.select(select);
 		if (populate && (Array.isArray(populate) ? populate.length : populate)) query = query.populate(populate);
 		if (sort) query = query.sort(withIdTiebreak(sort));
-		query = query.skip(skip).limit(sanitizedLimit + 1).lean(lean);
+		query = query.skip(skip).limit(sanitizedLimit + 1);
 		if (collation) query = query.collation(collation);
 		if (session) query = query.session(session);
 		if (hint) query = query.hint(hint);
@@ -1206,10 +1206,10 @@ var PaginationEngine = class {
 		const scope = cursorScope(this.Model.collection.collectionName, filters, collation);
 		if (cursor) query = resolveCursorFilter(cursor, normalizedSort, this.config.cursorVersion, query, this.config.minCursorVersion, querySort, scope, this.config.cursorSecret);
 		const effectiveSelect = ensureKeysetSelectIncludesCursorFields(select, normalizedSort);
-		let mongoQuery = this.Model.find(query);
+		let mongoQuery = this.Model.find(query).lean(lean);
 		if (effectiveSelect) mongoQuery = mongoQuery.select(effectiveSelect);
 		if (populate && (Array.isArray(populate) ? populate.length : populate)) mongoQuery = mongoQuery.populate(populate);
-		mongoQuery = mongoQuery.sort(querySort).limit(sanitizedLimit + 1).lean(lean);
+		mongoQuery = mongoQuery.sort(querySort).limit(sanitizedLimit + 1);
 		if (collation) mongoQuery = mongoQuery.collation(collation);
 		if (session) mongoQuery = mongoQuery.session(session);
 		if (hint) mongoQuery = mongoQuery.hint(hint);

package/dist/{Repository-CYhSC9ut.mjs → Repository-DlhPbXlG.mjs}

@@ -4,8 +4,8 @@ import { _ as SHORTHAND_OPS, a as count, b as create, c as getByQuery, d as dele
 import { n as warn } from "./logger-K7dPmu2U.mjs";
 import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-BuByZwKU.mjs";
 import { i as applyToQuery, n as applyCursorTimeoutMode, r as applyToAggregate, u as resolveQueryOptions } from "./query-defaults-BxUcSOoF.mjs";
-import { a as createTxBoundRepo, d as resolveMongoCapabilities, i as withTransaction } from "./transaction-BrRYtH_b.mjs";
-import { _ as resolveCursorSecrets, d as withGroupTiebreak, f as withIdTiebreak, g as attachSignature, i as validateKeysetSort, l as assertOffsetWithinCap, n as getPrimaryField, o as encodeCursor, s as resolveCursorFilter, t as PaginationEngine, u as cursorScope, v as verifySignature } from "./PaginationEngine-CfT2Cxkj.mjs";
+import { o as withTransaction, p as resolveMongoCapabilities, s as createTxBoundRepo } from "./transaction-DmiB4k2P.mjs";
+import { _ as resolveCursorSecrets, d as withGroupTiebreak, f as withIdTiebreak, g as attachSignature, i as validateKeysetSort, l as assertOffsetWithinCap, n as getPrimaryField, o as encodeCursor, s as resolveCursorFilter, t as PaginationEngine, u as cursorScope, v as verifySignature } from "./PaginationEngine-DZnkbSrr.mjs";
 import { calculateTotalPages } from "./pagination/utils/limits.mjs";
 import { hasNearOperator, rewriteNearForCount } from "./query/primitives/geo.mjs";
 import { a as scopeJoins, r as markGoverned } from "./join-scope-DSAznE8E.mjs";
@@ -4711,9 +4711,9 @@ var Repository = class extends RepositoryBase {
 				const appendLookupStages$2 = (pipeline) => appendLookupStages(pipeline, lookups, projection, isKeyset && sort ? this._parseSort(sort) : void 0);
 				if (isKeyset && sort) {
 					const parsedSort = this._parseSort(sort);
-					const { validateKeysetSort } = await import("./PaginationEngine-CfT2Cxkj.mjs").then((n) => n.r);
-					const { encodeCursor, resolveCursorFilter } = await import("./PaginationEngine-CfT2Cxkj.mjs").then((n) => n.a);
-					const { getPrimaryField } = await import("./PaginationEngine-CfT2Cxkj.mjs").then((n) => n.r);
+					const { validateKeysetSort } = await import("./PaginationEngine-DZnkbSrr.mjs").then((n) => n.r);
+					const { encodeCursor, resolveCursorFilter } = await import("./PaginationEngine-DZnkbSrr.mjs").then((n) => n.a);
+					const { getPrimaryField } = await import("./PaginationEngine-DZnkbSrr.mjs").then((n) => n.r);
 					const normalizedSort = validateKeysetSort(parsedSort, this._pagination.config.strictKeysetSortFields);
 					const cursorVersion = this._pagination.config.cursorVersion ?? 1;
 					const minCursorVersion = this._pagination.config.minCursorVersion ?? 1;

package/dist/better-auth/index.mjs

@@ -1,4 +1,4 @@
-import { n as Repository } from "../Repository-CYhSC9ut.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";

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

@@ -1,5 +1,5 @@
-import { n as Repository } from "./Repository-CYhSC9ut.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-zfdLYZiO.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.d.mts

@@ -782,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
@@ -1102,4 +1116,4 @@ declare function createOptionsExtractor<TCtx extends Record<string, unknown>>(fi
  */
 declare function systemContext(extra?: SessionOptions): SessionOptions;
 //#endregion
-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 };
+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 };

package/dist/index.mjs

@@ -1,19 +1,19 @@
 import { n as idVariants } from "./id-resolution-BqDrk0S2.mjs";
-import { a as MUTATING_OPERATIONS, c as operationsByPolicyKey, i as ALL_OPERATIONS, l as createMongoPurgePort, n as Repository, o as OP_REGISTRY, r as AggregationBuilder, s as READ_OPERATIONS, t as HOOK_PRIORITY } from "./Repository-CYhSC9ut.mjs";
+import { a as MUTATING_OPERATIONS, c as operationsByPolicyKey, i as ALL_OPERATIONS, l as createMongoPurgePort, n as Repository, o as OP_REGISTRY, r as AggregationBuilder, s as READ_OPERATIONS, t as HOOK_PRIORITY } from "./Repository-DlhPbXlG.mjs";
 import { C as isCreateManyPartialError, g as LookupBuilder, v as compileFilterToMongo } from "./update-WgeAUJ_I.mjs";
 import { n as warn, t as configureLogger } from "./logger-K7dPmu2U.mjs";
 import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-BuByZwKU.mjs";
 import { a as assertQueryDefaultsConfigured, c as getQueryDefaults, l as resetQueryDefaults, o as configureAggregateDefaults, s as configureQueryDefaults, t as QUERY_DEFAULTS_ERROR_CODES, u as resolveQueryOptions } from "./query-defaults-BxUcSOoF.mjs";
 import { t as actions_exports } from "./actions/index.mjs";
-import { c as classifyHelloReply, d as resolveMongoCapabilities, f as resolveTransactionSupport, i as withTransaction, l as probeMongoCapabilities, n as isTransactionUnsupported, o as MONGOKIT_CAPABILITIES, p as transactionResolutionOf, r as supportsTransactions, s as capabilitiesForSupport, t as batchTransaction, u as resetCapabilityProbeCache } from "./transaction-BrRYtH_b.mjs";
-import { _ as AuditTrailQuery, a as declareTenantContextKey, b as auditLogPlugin, c as tenantContextKeysOf, d as ensureSequenceAtLeast, f as getNextSequence, g as cachePlugin, h as sequentialId, i as multiTenantPlugin, l as customIdPlugin, m as readSequence, n as softDeletePlugin, o as forwardScope, p as prefixedId, r as adminBypass, s as isScopeKey, t as timestampPlugin, u as dateSequentialId, v as auditTrailPlugin, y as ensureAuditTrailReady } from "./timestamp.plugin-zfdLYZiO.mjs";
+import { a as supportsTransactions, c as MONGOKIT_CAPABILITIES, d as probeMongoCapabilities, f as resetCapabilityProbeCache, h as transactionResolutionOf, i as runTransaction, l as capabilitiesForSupport, m as resolveTransactionSupport, n as batchTransaction, o as withTransaction, p as resolveMongoCapabilities, r as isTransactionUnsupported, t as TRANSACTION_ERROR_CODES, u as classifyHelloReply } from "./transaction-DmiB4k2P.mjs";
+import { _ as AuditTrailQuery, a as declareTenantContextKey, b as auditLogPlugin, c as tenantContextKeysOf, d as ensureSequenceAtLeast, f as getNextSequence, g as cachePlugin, h as sequentialId, i as multiTenantPlugin, l as customIdPlugin, m as readSequence, n as softDeletePlugin, o as forwardScope, p as prefixedId, r as adminBypass, s as isScopeKey, t as timestampPlugin, u as dateSequentialId, v as auditTrailPlugin, y as ensureAuditTrailReady } from "./timestamp.plugin-DvZlnKEc.mjs";
 import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "./method-registry.plugin-C63pGn1d.mjs";
-import { c as PAGINATION_ERROR_CODES, h as resetPaginationDefaults, m as getPaginationDefaults, p as configurePaginationDefaults, t as PaginationEngine } from "./PaginationEngine-CfT2Cxkj.mjs";
+import { c as PAGINATION_ERROR_CODES, h as resetPaginationDefaults, m as getPaginationDefaults, p as configurePaginationDefaults, t as PaginationEngine } from "./PaginationEngine-DZnkbSrr.mjs";
 import { GEO_OPERATORS, parseGeoFilter } from "./query/primitives/geo.mjs";
 import { n as declareCollectionScope, t as JOIN_ERROR_CODES } from "./join-scope-DSAznE8E.mjs";
-import { t as createRepository } from "./create-repository-BYyWzLbt.mjs";
+import { t as createRepository } from "./create-repository-Bg0H5rte.mjs";
 import { n as defineModel, r as isModelRegistered, t as ModelCollisionError } from "./model-registry-ClKtWiHa.mjs";
-import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "./validation-chain.plugin-CHUHWMtk.mjs";
+import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "./validation-chain.plugin-D1WsGCYr.mjs";
 import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "./field-selection-FSQFLpsU.mjs";
 import { buildFieldTypeMap, coerceHeuristic } from "./query/primitives/coercion.mjs";
 import { extractSchemaIndexes } from "./query/primitives/indexes.mjs";
@@ -1437,4 +1437,4 @@ function systemContext(extra) {
 */
 var src_default = Repository;
 //#endregion
-export { ALL_OPERATIONS, AggregationBuilder, AuditTrailQuery, HOOK_PRIORITY, JOIN_ERROR_CODES, LookupBuilder, MONGOKIT_CAPABILITIES, MONGOKIT_PLUGIN_NAMES, MUTATING_OPERATIONS, ModelCollisionError, OP_REGISTRY, PAGINATION_ERROR_CODES, PaginationEngine, QUERY_DEFAULTS_ERROR_CODES, QueryParser, READ_OPERATIONS, Repository, actions_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, src_default as default, 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 };
+export { ALL_OPERATIONS, AggregationBuilder, AuditTrailQuery, HOOK_PRIORITY, JOIN_ERROR_CODES, LookupBuilder, MONGOKIT_CAPABILITIES, MONGOKIT_PLUGIN_NAMES, MUTATING_OPERATIONS, ModelCollisionError, OP_REGISTRY, PAGINATION_ERROR_CODES, PaginationEngine, QUERY_DEFAULTS_ERROR_CODES, QueryParser, READ_OPERATIONS, Repository, TRANSACTION_ERROR_CODES, actions_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, src_default as default, 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 };

package/dist/outbox/index.mjs

@@ -1,4 +1,4 @@
-import { n as Repository } from "../Repository-CYhSC9ut.mjs";
+import { n as Repository } from "../Repository-DlhPbXlG.mjs";
 import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "../method-registry.plugin-C63pGn1d.mjs";
 import { Schema } from "mongoose";
 //#region src/outbox/index.ts

package/dist/pagination/PaginationEngine.mjs

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

package/dist/plugins/index.mjs

@@ -1,12 +1,14 @@
-import { _ as AuditTrailQuery, b as auditLogPlugin, f as getNextSequence, g as cachePlugin, h as sequentialId, i as multiTenantPlugin, l as customIdPlugin, n as softDeletePlugin, p as prefixedId, t as timestampPlugin, u as dateSequentialId, v as auditTrailPlugin, y as ensureAuditTrailReady } from "../timestamp.plugin-zfdLYZiO.mjs";
+import { _ as AuditTrailQuery, b as auditLogPlugin, f as getNextSequence, g as cachePlugin, h as sequentialId, i as multiTenantPlugin, l as customIdPlugin, n as softDeletePlugin, p as prefixedId, t as timestampPlugin, u as dateSequentialId, v as auditTrailPlugin, y as ensureAuditTrailReady } from "../timestamp.plugin-DvZlnKEc.mjs";
 import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "../method-registry.plugin-C63pGn1d.mjs";
-import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "../validation-chain.plugin-CHUHWMtk.mjs";
+import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "../validation-chain.plugin-D1WsGCYr.mjs";
 //#region src/plugins/change-log.plugin.ts
 const PLUGIN_NAME = "changeLog";
 /** Marks a repository already captured: the store and scope it writes to. */
 const CAPTURED = Symbol.for("mongokit.changeLog.capture");
 /** Where `before:updateMany` / `before:deleteMany` leave the ids they matched for the after hook. */
 const MATCHED_IDS = Symbol("changeLog.matchedIds");
+/** Ids per `$in` when a many-document write is read back. */
+const READ_BACK_CHUNK = 5e3;
 function isSkipped(context) {
 	const list = context.skipPlugins;
 	return Array.isArray(list) && list.includes(PLUGIN_NAME);
@@ -29,29 +31,34 @@ function changeLogPlugin(options) {
 		return raw === void 0 || raw === null ? void 0 : String(raw);
 	};
 	const appendOptions = (context) => context.session !== void 0 ? { session: context.session } : void 0;
+	/** `stage` when the store offers it (no cursor wait under deferred sequencing); the contract's `append` otherwise. */
+	const recordChange = (entry, context) => {
+		const staging = store.stage;
+		return staging ? staging.call(store, entry, appendOptions(context)) : store.append(entry, appendOptions(context));
+	};
 	const upsert = async (doc, context) => {
 		const record = toRecord(doc);
 		if (!record || record._id === void 0) return;
 		const tenantId = tenantOf(record, context);
-		await store.append({
+		await recordChange({
 			scope,
 			docId: String(record._id),
 			op: "upsert",
 			version: versionOf(record),
 			doc: project ? project(record) : record,
 			...tenantId !== void 0 ? { tenantId } : {}
-		}, appendOptions(context));
+		}, context);
 	};
 	const tombstone = async (docId, context) => {
 		if (docId === void 0 || docId === null) return;
 		const tenantId = tenantOf(null, context);
-		await store.append({
+		await recordChange({
 			scope,
 			docId: String(docId),
 			op: "delete",
 			version: 0,
 			...tenantId !== void 0 ? { tenantId } : {}
-		}, appendOptions(context));
+		}, context);
 	};
 	return {
 		name: PLUGIN_NAME,
@@ -72,6 +79,22 @@ function changeLogPlugin(options) {
 				if (context.session !== void 0) query.session(context.session);
 				return query.exec();
 			};
+			/** A write's result is the feed row only when it is the whole post-image, as a plain object. */
+			const isWholePostImage = (result, context) => {
+				if (!result || typeof result !== "object") return false;
+				if (typeof result.toObject === "function") return false;
+				const c = context;
+				return !c.select && !c.projection && !c.populate && c.returnDocument !== "before";
+			};
+			/** `upsert` from the result the write returned; a narrowed result is re-read by id (one read, that verb only). */
+			const captureResult = async (result, context) => {
+				const id = toRecord(result)?._id;
+				if (id === void 0) return;
+				if (isWholePostImage(result, context)) return upsert(result, context);
+				const doc = await reread(id, context);
+				if (doc) await upsert(doc, context);
+				else await tombstone(id, context);
+			};
 			const matchingIds = async (context, filter) => {
 				const query = repo.Model.find(filter ?? {}).select({ _id: 1 }).lean();
 				if (context.session !== void 0) query.session(context.session);
@@ -85,29 +108,37 @@ function changeLogPlugin(options) {
 				for (const doc of result) await upsert(doc, context);
 			});
 			repo.on("after:update", async ({ context, result }) => {
-				if (!isSkipped(context) && result) await upsert(result, context);
+				if (isSkipped(context) || !result) return;
+				const c = context;
+				if (c.select || c.projection || c.populate) await captureResult(result, context);
+				else await upsert(result, context);
+			});
+			repo.on("after:getOrCreate", async ({ context, result }) => {
+				const doc = result?.doc;
+				if (!isSkipped(context) && doc) await upsert(doc, context);
 			});
 			for (const op of [
 				"claim",
 				"claimVersion",
 				"findOneAndUpdate",
-				"getOrCreate",
 				"restore"
 			]) repo.on(`after:${op}`, async ({ context, result }) => {
-				if (isSkipped(context)) return;
-				const id = toRecord(result)?._id;
-				if (id === void 0) return;
-				const doc = await reread(id, context);
-				if (doc) await upsert(doc, context);
-				else await tombstone(id, context);
+				if (!isSkipped(context)) await captureResult(result, context);
 			});
 			for (const op of ["updateMany", "deleteMany"]) repo.on(`before:${op}`, async (context) => {
 				if (!isSkipped(context)) context[MATCHED_IDS] = await matchingIds(context, context.query);
 			});
-			/** Each re-read document as an upsert, or a tombstone where it is gone. */
+			/** Each target as an upsert, or a tombstone where it is gone — read back in batches, not one query per id. */
 			const capture = async (ids, context) => {
-				for (const id of ids) {
-					const doc = await reread(id, context);
+				const wanted = ids.filter((id) => id !== void 0 && id !== null);
+				const found = /* @__PURE__ */ new Map();
+				for (let i = 0; i < wanted.length; i += READ_BACK_CHUNK) {
+					const query = repo.Model.find({ _id: { $in: wanted.slice(i, i + READ_BACK_CHUNK) } }).lean();
+					if (context.session !== void 0) query.session(context.session);
+					for (const doc of await query.exec()) found.set(String(doc._id), doc);
+				}
+				for (const id of wanted) {
+					const doc = found.get(String(id));
 					if (doc) await upsert(doc, context);
 					else await tombstone(id, context);
 				}

package/dist/sync/index.d.mts

@@ -1,15 +1,26 @@
 import { ClientSession, Connection, Model } from "mongoose";
-import { ChangeLogStore, CommandStreamStore, CommandStreamTx } from "@classytic/repo-core/sync";
+import { ChangeLogAppendOptions, ChangeLogStore, CommandStreamStore, CommandStreamTx } from "@classytic/repo-core/sync";
 //#region src/sync/index.d.ts
 interface ChangeLogModelOptions {
   /** Entries collection. Default `sync_changes`; its counter lives in `<collection>_counter`. */
   collection?: string;
   /** Mongoose model name prefix. Default `SyncChange`. Must be unique per connection. */
   modelName?: string;
+  /**
+   * When an entry gets its cursor. `'in-transaction'` (default): from the counter, inside the writer's transaction —
+   * every writer serialises on that one document and overlapping transactions abort and retry. `'deferred'`: the
+   * writer stages the entry (`<collection>_pending`, no counter); a single leased sequencer numbers COMMITTED
+   * entries before every read. A cursor is only ever given to a committed entry and is above every cursor given
+   * before, so no reader can checkpoint past an entry that appears later.
+   */
+  sequencing?: 'in-transaction' | 'deferred';
 }
 interface ChangeLogModels {
   entries: Model<Record<string, unknown>>;
   counter: Model<Record<string, unknown>>;
+  /** Staged, not-yet-numbered entries — present only under `sequencing: 'deferred'`. */
+  pending?: Model<Record<string, unknown>>;
+  sequencing: 'in-transaction' | 'deferred';
   /** The counter document's id (one feed per entries collection). */
   feed: string;
 }
@@ -26,6 +37,16 @@ interface MongoChangeLogStore extends ChangeLogStore {
   }): Promise<{
     removed: number;
   }>;
+  /**
+   * Number every staged entry (deferred sequencing; a no-op otherwise). Reads call it first; a scheduler may too.
+   * Returns how many it numbered, or `null` when another sequencer holds the lease.
+   */
+  sequencePending(): Promise<number | null>;
+  /**
+   * Record a change WITHOUT waiting for its cursor (deferred sequencing): the next read numbers it. For writers that
+   * never use the cursor (`changeLogPlugin`). Under in-transaction sequencing it is `append`.
+   */
+  stage(entry: Parameters<ChangeLogStore['append']>[0], options?: ChangeLogAppendOptions): Promise<void>;
 }
 declare function createChangeLogStore(models: ChangeLogModels): MongoChangeLogStore;
 interface CommandStreamModelOptions {

package/dist/sync/index.mjs

@@ -1,77 +1,133 @@
-import { i as withTransaction } from "../transaction-BrRYtH_b.mjs";
-import { Schema } from "mongoose";
+import { o as withTransaction } from "../transaction-DmiB4k2P.mjs";
+import { Schema, Types } from "mongoose";
 //#region src/sync/index.ts
 function createChangeLogModels(connection, options = {}) {
-	const { collection = "sync_changes", modelName = "SyncChange" } = options;
+	const { collection = "sync_changes", modelName = "SyncChange", sequencing = "in-transaction" } = options;
 	const entriesName = modelName;
 	const counterName = `${modelName}Counter`;
-	return {
-		entries: connection.models[entriesName] ?? connection.model(entriesName, (() => {
-			const schema = new Schema({
-				seq: {
-					type: Number,
-					required: true
-				},
-				scope: {
-					type: String,
-					required: true
-				},
-				docId: {
-					type: String,
-					required: true
-				},
-				op: {
-					type: String,
-					enum: ["upsert", "delete"],
-					required: true
-				},
-				version: {
-					type: Number,
-					required: true
-				},
-				doc: { type: Schema.Types.Mixed },
-				tenantId: { type: String },
-				at: {
-					type: Date,
-					required: true
-				}
-			}, {
-				collection,
-				versionKey: false,
-				minimize: false
-			});
-			schema.index({ seq: 1 }, {
-				unique: true,
-				name: "feed_order"
-			});
-			schema.index({
-				tenantId: 1,
-				scope: 1,
-				seq: 1
-			}, { name: "tenant_scope_feed" });
-			schema.index({
-				scope: 1,
-				docId: 1,
-				seq: 1
-			}, { name: "doc_versions" });
-			return schema;
-		})()),
-		counter: connection.models[counterName] ?? connection.model(counterName, new Schema({
-			_id: {
+	const entries = connection.models[entriesName] ?? connection.model(entriesName, (() => {
+		const schema = new Schema({
+			seq: {
+				type: Number,
+				required: true
+			},
+			scope: {
 				type: String,
 				required: true
 			},
-			seq: {
+			docId: {
+				type: String,
+				required: true
+			},
+			op: {
+				type: String,
+				enum: ["upsert", "delete"],
+				required: true
+			},
+			version: {
 				type: Number,
 				required: true
-			}
+			},
+			doc: { type: Schema.Types.Mixed },
+			tenantId: { type: String },
+			at: {
+				type: Date,
+				required: true
+			},
+			/** The staged row this entry was numbered from (deferred sequencing) — the sequencer's idempotency key. */
+			pendingId: { type: String }
 		}, {
-			collection: `${collection}_counter`,
-			versionKey: false
-		})),
+			collection,
+			versionKey: false,
+			minimize: false
+		});
+		schema.index({ seq: 1 }, {
+			unique: true,
+			name: "feed_order"
+		});
+		schema.index({ pendingId: 1 }, {
+			unique: true,
+			name: "sequenced_from",
+			partialFilterExpression: { pendingId: { $gte: "" } }
+		});
+		schema.index({
+			tenantId: 1,
+			scope: 1,
+			seq: 1
+		}, { name: "tenant_scope_feed" });
+		schema.index({
+			scope: 1,
+			docId: 1,
+			seq: 1
+		}, { name: "doc_versions" });
+		return schema;
+	})());
+	const counter = connection.models[counterName] ?? connection.model(counterName, new Schema({
+		_id: {
+			type: String,
+			required: true
+		},
+		seq: {
+			type: Number,
+			required: true
+		},
+		/** The deferred sequencer's lease. */
+		lockUntil: { type: Date },
+		lockBy: { type: String }
+	}, {
+		collection: `${collection}_counter`,
+		versionKey: false
+	}));
+	const pendingName = `${modelName}Pending`;
+	const pending = sequencing === "deferred" ? connection.models[pendingName] ?? connection.model(pendingName, new Schema({
+		scope: {
+			type: String,
+			required: true
+		},
+		docId: {
+			type: String,
+			required: true
+		},
+		op: {
+			type: String,
+			enum: ["upsert", "delete"],
+			required: true
+		},
+		version: {
+			type: Number,
+			required: true
+		},
+		doc: { type: Schema.Types.Mixed },
+		tenantId: { type: String },
+		at: {
+			type: Date,
+			required: true
+		}
+	}, {
+		collection: `${collection}_pending`,
+		versionKey: false,
+		minimize: false
+	})) : void 0;
+	return {
+		entries,
+		counter,
+		...pending ? { pending } : {},
+		sequencing,
 		feed: collection
 	};
 }
+/** A change as staged under deferred sequencing — the feed row without its `seq`. */
+function stagedRow(entry, at) {
+	return {
+		scope: entry.scope,
+		docId: entry.docId,
+		op: entry.op,
+		version: entry.version,
+		...entry.op === "upsert" && entry.doc !== void 0 ? { doc: entry.doc } : {},
+		...entry.tenantId !== void 0 ? { tenantId: entry.tenantId } : {},
+		at
+	};
+}
 /** Fixed-width, so the opaque cursor also sorts as text. */
 const toCursor = (seq) => String(seq).padStart(16, "0");
 const fromCursor = (cursor) => {
@@ -81,8 +137,96 @@ const fromCursor = (cursor) => {
 	return seq;
 };
 const DEFAULT_LIMIT = 500;
+/** How long one sequencer holds the lease — far above one batch, so a live holder never loses it mid-batch. */
+const SEQUENCER_LEASE_MS = 3e4;
+const SEQUENCER_BATCH = 500;
 function createChangeLogStore(models) {
-	const { entries, counter, feed } = models;
+	const { entries, counter, feed, pending } = models;
+	const deferred = models.sequencing === "deferred" && pending !== void 0;
+	/**
+	* One pass under the lease: committed staged rows → the feed, in staging order, numbered above everything.
+	* Nothing staged costs ONE read. A crash mid-pass is converged by the next one: an entry already in the feed is
+	* recognised by its unique `pendingId`, and a stale counter is caught by the unique `seq` index.
+	*/
+	const sequencePending = async () => {
+		if (!deferred || !pending) return 0;
+		if (!await pending.exists({}).exec()) return 0;
+		const token = new Types.ObjectId().toString();
+		const unlocked = {
+			_id: feed,
+			$or: [
+				{ lockUntil: { $exists: false } },
+				{ lockUntil: null },
+				{ lockUntil: { $lt: /* @__PURE__ */ new Date() } }
+			]
+		};
+		const takeLease = () => counter.findOneAndUpdate(unlocked, { $set: {
+			lockUntil: new Date(Date.now() + SEQUENCER_LEASE_MS),
+			lockBy: token
+		} }, {
+			returnDocument: "after",
+			lean: true
+		}).exec();
+		let lease = await takeLease();
+		if (!lease) {
+			if (await counter.exists({ _id: feed }).exec()) return null;
+			await counter.create([{
+				_id: feed,
+				seq: 0
+			}]).catch((err) => {
+				if (err.code !== 11e3) throw err;
+			});
+			lease = await takeLease();
+			if (!lease) return null;
+		}
+		let seq = lease.seq ?? 0;
+		let numbered = 0;
+		try {
+			for (;;) {
+				const rows = await pending.find({}).sort({ _id: 1 }).limit(SEQUENCER_BATCH).lean().exec();
+				if (rows.length === 0) break;
+				const build = (from, list) => list.map((r, i) => {
+					const { _id, ...rest } = r;
+					return {
+						...rest,
+						seq: from + i + 1,
+						pendingId: String(_id)
+					};
+				});
+				try {
+					await entries.insertMany(build(seq, rows), { ordered: true });
+					seq += rows.length;
+					numbered += rows.length;
+				} catch (err) {
+					if (err.code !== 11e3) throw err;
+					const placed = new Set((await entries.find({ pendingId: { $in: rows.map((r) => String(r._id)) } }).select({ pendingId: 1 }).lean().exec()).map((e) => e.pendingId));
+					const fresh = rows.filter((r) => !placed.has(String(r._id)));
+					const top = await entries.findOne({}).sort({ seq: -1 }).select({ seq: 1 }).lean().exec();
+					seq = Math.max(seq, top?.seq ?? 0);
+					if (fresh.length > 0) {
+						await entries.insertMany(build(seq, fresh), { ordered: true });
+						seq += fresh.length;
+						numbered += fresh.length;
+					}
+				}
+				await counter.updateOne({
+					_id: feed,
+					lockBy: token
+				}, { $max: { seq } }).exec();
+				await pending.deleteMany({ _id: { $in: rows.map((r) => r._id) } }).exec();
+				if (rows.length < SEQUENCER_BATCH) break;
+			}
+		} finally {
+			await counter.updateOne({
+				_id: feed,
+				lockBy: token
+			}, { $set: {
+				lockUntil: null,
+				lockBy: null
+			} }).exec();
+		}
+		return numbered;
+	};
 	const sessionOf = (options) => options?.session ? { session: options.session } : {};
 	const filterOf = (after, options = {}) => {
 		const { tenantId, scopes, sharedScopes } = options;
@@ -104,8 +248,37 @@ function createChangeLogStore(models) {
 		cursor: toCursor(row.seq)
 	});
 	return {
+		sequencePending,
+		async stage(entry, options) {
+			if (!deferred || !pending) {
+				await this.append(entry, options);
+				return;
+			}
+			await pending.create([stagedRow(entry, /* @__PURE__ */ new Date())], sessionOf(options));
+		},
 		async append(entry, options) {
 			const session = sessionOf(options);
+			if (deferred && pending) {
+				const at = /* @__PURE__ */ new Date();
+				const [staged] = await pending.create([stagedRow(entry, at)], session);
+				if (options?.session) return {
+					...entry,
+					at,
+					cursor: ""
+				};
+				const stagedId = String(staged?._id);
+				for (let attempt = 0; attempt < 50; attempt++) {
+					await sequencePending();
+					const at2 = await entries.findOne({ pendingId: stagedId }).select({ seq: 1 }).lean().exec();
+					if (typeof at2?.seq === "number") return {
+						...entry,
+						at,
+						cursor: toCursor(at2.seq)
+					};
+					await new Promise((r) => setTimeout(r, 20));
+				}
+				throw new Error(`[mongokit:sync] staged entry ${stagedId} was not sequenced — a sequencer lease is stuck`);
+			}
 			const seq = (await counter.findOneAndUpdate({ _id: feed }, { $inc: { seq: 1 } }, {
 				upsert: true,
 				returnDocument: "after",
@@ -130,6 +303,7 @@ function createChangeLogStore(models) {
 			};
 		},
 		async since(cursor, options = {}) {
+			if (deferred) await sequencePending();
 			const limit = options.limit ?? DEFAULT_LIMIT;
 			const rows = await entries.find(filterOf(fromCursor(cursor), options)).sort({ seq: 1 }).limit(limit + 1).lean().exec();
 			const page = rows.slice(0, limit).map(toEntry);
@@ -141,6 +315,7 @@ function createChangeLogStore(models) {
 			};
 		},
 		async latestCursor(options = {}) {
+			if (deferred) await sequencePending();
 			const row = await entries.findOne(filterOf(0, options)).sort({ seq: -1 }).select({ seq: 1 }).lean().exec();
 			return row?.seq ? toCursor(row.seq) : "";
 		},

package/dist/testkit/index.mjs

@@ -1,4 +1,4 @@
-import { t as createRepository } from "../create-repository-BYyWzLbt.mjs";
+import { t as createRepository } from "../create-repository-Bg0H5rte.mjs";
 import { createConnection } from "mongoose";
 //#region src/testkit/query-plan.ts
 const PLANNABLE = /* @__PURE__ */ new Set([

package/dist/{timestamp.plugin-zfdLYZiO.mjs → timestamp.plugin-DvZlnKEc.mjs}

@@ -1,4 +1,4 @@
-import { i as ALL_OPERATIONS, o as OP_REGISTRY, t as HOOK_PRIORITY } from "./Repository-CYhSC9ut.mjs";
+import { i as ALL_OPERATIONS, o as OP_REGISTRY, t as HOOK_PRIORITY } from "./Repository-DlhPbXlG.mjs";
 import { n as warn } from "./logger-K7dPmu2U.mjs";
 import { n as declareCollectionScope } from "./join-scope-DSAznE8E.mjs";
 import { throwIfAborted, withRetry } from "@classytic/repo-core/repository";

package/dist/{transaction-BrRYtH_b.mjs → transaction-DmiB4k2P.mjs}

@@ -1,3 +1,4 @@
+import { t as createError } from "./error-BuByZwKU.mjs";
 import { d as setTransactionDeadline } from "./query-defaults-BxUcSOoF.mjs";
 import mongoose from "mongoose";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
@@ -436,6 +437,12 @@ function createTxBoundRepo(outer, session) {
 */
 async function withTransaction(connection, callback, options = {}) {
 	const session = await connection.startSession();
+	try {
+		assertSessionSurface(session, [...DRIVEN, "endSession"]);
+	} catch (err) {
+		if (typeof session.endSession === "function") await session.endSession();
+		throw err;
+	}
 	try {
 		return await runTransaction(session, callback, options.transactionOptions);
 	} catch (error) {
@@ -449,6 +456,25 @@ async function withTransaction(connection, callback, options = {}) {
 		await session.endSession();
 	}
 }
+const TRANSACTION_ERROR_CODES = { 
+/** The session lacks a method the transaction loop drives (a partial or wrapped fake). */
+SESSION_INCOMPLETE: "mongokit.transaction.session_incomplete" };
+const DRIVEN = [
+	"startTransaction",
+	"commitTransaction",
+	"abortTransaction",
+	"inTransaction"
+];
+/** Refuse, with the missing names, a session that cannot be driven, before calling anything on it. */
+function assertSessionSurface(session, required) {
+	const s = session ?? {};
+	const missing = required.filter((name) => typeof s[name] !== "function");
+	if (missing.length === 0) return;
+	throw createError(500, `[mongokit] the transaction session lacks ${missing.join(", ")}; pass a driver ClientSession`, {
+		code: TRANSACTION_ERROR_CODES.SESSION_INCOMPLETE,
+		meta: { missing }
+	});
+}
 const MAX_TRANSACTION_TIMEOUT_MS = 12e4;
 const BACKOFF_INITIAL_MS = 5;
 const BACKOFF_MAX_MS = 500;
@@ -478,6 +504,7 @@ function timeoutError(cause, csot) {
 * Pinned by `tests/integration/csot-transaction-matrix.test.ts`.
 */
 async function runTransaction(session, callback, transactionOptions = {}) {
+	assertSessionSurface(session, DRIVEN);
 	const { timeoutMS: explicitTimeout, ...startOptions } = transactionOptions;
 	const clientTimeout = session.timeoutMS;
 	const timeoutMS = explicitTimeout ?? clientTimeout;
@@ -652,4 +679,4 @@ function supportsTransactions(connection) {
 	return resolveTransactionSupport(connection) !== "no";
 }
 //#endregion
-export { createTxBoundRepo as a, classifyHelloReply as c, resolveMongoCapabilities as d, resolveTransactionSupport as f, withTransaction as i, probeMongoCapabilities as l, isTransactionUnsupported as n, MONGOKIT_CAPABILITIES as o, transactionResolutionOf as p, supportsTransactions as r, capabilitiesForSupport as s, batchTransaction as t, resetCapabilityProbeCache as u };
+export { supportsTransactions as a, MONGOKIT_CAPABILITIES as c, probeMongoCapabilities as d, resetCapabilityProbeCache as f, transactionResolutionOf as h, runTransaction as i, capabilitiesForSupport as l, resolveTransactionSupport as m, batchTransaction as n, withTransaction as o, resolveMongoCapabilities as p, isTransactionUnsupported as r, createTxBoundRepo as s, TRANSACTION_ERROR_CODES as t, classifyHelloReply as u };

package/dist/{validation-chain.plugin-CHUHWMtk.mjs → validation-chain.plugin-D1WsGCYr.mjs}

@@ -1,9 +1,9 @@
 import { n as collectIds, r as idChunks, t as DEFAULT_ID_CHUNK } from "./id-chunks-BmAwsqNk.mjs";
-import { i as ALL_OPERATIONS, o as OP_REGISTRY } from "./Repository-CYhSC9ut.mjs";
+import { i as ALL_OPERATIONS, o as OP_REGISTRY } from "./Repository-DlhPbXlG.mjs";
 import { w as upsert } from "./update-WgeAUJ_I.mjs";
 import { n as warn } from "./logger-K7dPmu2U.mjs";
 import { t as createError } from "./error-BuByZwKU.mjs";
-import { c as tenantContextKeysOf, o as forwardScope } from "./timestamp.plugin-zfdLYZiO.mjs";
+import { c as tenantContextKeysOf, o as forwardScope } from "./timestamp.plugin-DvZlnKEc.mjs";
 import { r as getFieldsForUser } from "./field-selection-FSQFLpsU.mjs";
 import mongoose from "mongoose";
 import { HOOK_PRIORITY } from "@classytic/repo-core/hooks";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.40.1",
+  "version": "3.42.0",
   "description": "Production-grade MongoDB repositories - smart pagination, events, and plugins. Built on @classytic/repo-core.",
   "type": "module",
   "sideEffects": false,
@@ -148,7 +148,7 @@
   "peerDependencies": {
     "@classytic/repo-core": ">=0.31.0",
     "mongodb-memory-server": ">=10.4.3",
-    "mongoose": ">=9.4.1"
+    "mongoose": ">=9.11.0"
   },
   "peerDependenciesMeta": {
     "mongodb-memory-server": {
@@ -199,7 +199,7 @@
     "@better-auth/mongo-adapter": "^1.6.29",
     "@biomejs/biome": "^2.5.8",
     "@classytic/dev-tools": "^0.2.0",
-    "@classytic/repo-core": "^0.31.0",
+    "@classytic/repo-core": "^0.31.1",
     "@types/node": "^26.2.0",
     "@vitest/coverage-v8": "^4.1.10",
     "ajv": "^8.20.0",
@@ -210,7 +210,7 @@
     "knip": "^6.32.2",
     "mongodb": "^7.5.0",
     "mongodb-memory-server": "^11.2.0",
-    "mongoose": "^9.9.2",
+    "mongoose": "^9.11.1",
     "publint": "^0.3.23",
     "tsdown": "^0.22.14",
     "typescript": "~5.9.3",