@classytic/mongokit 3.25.0 → 3.28.0

package/README.md

@@ -2,6 +2,7 @@
 
 [![npm version](https://badge.fury.io/js/@classytic%2Fmongokit.svg)](https://www.npmjs.com/package/@classytic/mongokit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Sponsor](https://img.shields.io/github/sponsors/classytic?style=flat-square&label=Sponsor&logo=GitHub&color=EA4AAA)](https://github.com/sponsors/classytic)
 
 Production-ready repository layer for Mongoose apps: tenant-safe CRUD, soft delete, pagination, hooks, retries, transactions, change streams, and plugins.
 

package/dist/{Repository-KKR8jxfD.mjs → Repository-BFBTAMlA.mjs}

@@ -16,20 +16,56 @@ import { decodeAggCursor, encodeAggCursor, isKeysetMode, normalizeGroupBy, valid
 * predicate the purge targets.
 */
 function createMongoPurgePort(repo, field, value, session) {
-	const filter = { [field]: value };
+	return createKeysetPurgePort(repo, { [field]: value }, session);
+}
+/**
+* Build a `PurgePort` bound to a repository + a pre-compiled Mongo filter
+* (the repository compiles Filter IR via `compileFilterToMongo` before
+* calling this) — the range/filter-scoped sibling of
+* {@link createMongoPurgePort}.
+*
+* The per-strategy chunk logic is IDENTICAL to the equality-bound port; the
+* only difference is the base predicate — an arbitrary compiled filter (a
+* `civilDate` window, a retention cutoff, a compound cohort) instead of
+* `{ [field]: value }`. The narrowed write is re-asserted on
+* `{ _id: { $in: ids }, ...filter }`, the same defense the equality port
+* uses, so a row that leaves the matching set between the id select and the
+* write is never touched.
+*
+* Mirrors `createMongoArchivePort`, which likewise binds a pre-compiled
+* filter rather than a `field/value` pair.
+*/
+function createMongoPurgePortFromFilter(repo, filter, session) {
+	return createKeysetPurgePort(repo, filter, session);
+}
+/**
+* Shared keyset-progressed port both public factories delegate to. The
+* closure's `cursor` is the port's single-run progression state.
+*/
+function createKeysetPurgePort(repo, baseFilter, session) {
 	const baseOpts = {
 		session,
 		bypassTenant: true
 	};
+	let cursor = null;
+	const selectFilter = () => cursor == null ? baseFilter : {
+		...baseFilter,
+		_id: { $gt: cursor }
+	};
 	return { async purgeChunk(strategy, limit) {
 		if (strategy.type === "anonymize") {
-			if (Object.values(strategy.fields).some((v) => typeof v === "function")) return purgeAnonymizeFunctional(repo, filter, strategy.fields, limit, session);
+			if (Object.values(strategy.fields).some((v) => typeof v === "function")) {
+				const { processed, lastId } = await purgeAnonymizeFunctional(repo, selectFilter(), strategy.fields, limit, session);
+				if (lastId != null) cursor = lastId;
+				return processed;
+			}
 		}
-		const idDocs = await repo.Model.find(filter, { _id: 1 }).limit(limit).session(session ?? null).lean().exec();
+		const idDocs = await repo.Model.find(selectFilter(), { _id: 1 }).sort({ _id: 1 }).limit(limit).session(session ?? null).lean().exec();
 		if (idDocs.length === 0) return 0;
+		const ids = idDocs.map((d) => d._id);
 		const chunkFilter = {
-			_id: { $in: idDocs.map((d) => d._id) },
-			[field]: value
+			...baseFilter,
+			_id: { $in: ids }
 		};
 		switch (strategy.type) {
 			case "hard":
@@ -37,17 +73,19 @@ function createMongoPurgePort(repo, field, value, session) {
 					...baseOpts,
 					mode: "hard"
 				});
-				return idDocs.length;
+				break;
 			case "soft":
 				await repo.updateMany(chunkFilter, { $set: {
 					[strategy.deletedField ?? "deleted"]: true,
 					[strategy.deletedAtField ?? "deletedAt"]: /* @__PURE__ */ new Date()
 				} }, baseOpts);
-				return idDocs.length;
+				break;
 			case "anonymize":
 				await repo.updateMany(chunkFilter, { $set: strategy.fields }, baseOpts);
-				return idDocs.length;
+				break;
 		}
+		cursor = ids[ids.length - 1];
+		return idDocs.length;
 	} };
 }
 /**
@@ -56,13 +94,20 @@ function createMongoPurgePort(repo, field, value, session) {
 * heterogeneous `updateOne` ops. Two round-trips per chunk regardless
 * of N — vs the N+1 of per-doc `update()` fan-out.
 *
+* Selection is `_id`-ascending against the caller's keyset-narrowed
+* filter; returns the chunk's last `_id` so the port can advance its
+* cursor after the write commits.
+*
 * Mongo's `bulkWrite` is ordered: false → independent failures don't
 * abort the batch. For idempotent anonymize (same row anonymized twice
 * is the same write), this matches the at-least-once contract.
 */
-async function purgeAnonymizeFunctional(repo, filter, fields, limit, session) {
-	const docs = await repo.Model.find(filter).limit(limit).session(session ?? null).lean().exec();
-	if (docs.length === 0) return 0;
+async function purgeAnonymizeFunctional(repo, selectFilter, fields, limit, session) {
+	const docs = await repo.Model.find(selectFilter).sort({ _id: 1 }).limit(limit).session(session ?? null).lean().exec();
+	if (docs.length === 0) return {
+		processed: 0,
+		lastId: null
+	};
 	const operations = docs.map((doc) => {
 		const set = {};
 		for (const [k, v] of Object.entries(fields)) set[k] = typeof v === "function" ? v(doc) : v;
@@ -75,7 +120,10 @@ async function purgeAnonymizeFunctional(repo, filter, fields, limit, session) {
 		ordered: false,
 		session: session ?? void 0
 	});
-	return docs.length;
+	return {
+		processed: docs.length,
+		lastId: docs[docs.length - 1]?._id ?? null
+	};
 }
 //#endregion
 //#region src/capabilities.ts
@@ -97,6 +145,7 @@ const MONGOKIT_CAPABILITIES = {
 	getOrCreate: true,
 	countAndExists: true,
 	purgeByField: true,
+	purgeByFilter: true,
 	archiveByFilter: true,
 	arrayOperators: true,
 	regexFilter: true,
@@ -1731,6 +1780,33 @@ function isTransactionUnsupported(error) {
 	const message = (error.message || "").toLowerCase();
 	return message.includes("transaction numbers are only allowed on a replica set member") || message.includes("transaction is not supported") || message.includes("does not support retryable writes");
 }
+/**
+* PROACTIVELY report whether a connection's deployment supports multi-document
+* transactions — the read-side companion to {@link isTransactionUnsupported}
+* (which classifies a FAILED attempt). Single source of truth for the topology
+* check so callers don't hand-roll `client.topology.description.type` probing.
+*
+* Returns `false` ONLY when the topology is positively a standalone (`'Single'`)
+* server; an unknown/undefined topology (not yet connected, non-standard
+* connection object) returns `true` — optimistic, because a genuine failure is
+* still caught reactively by `isTransactionUnsupported`. Lets a caller skip a
+* doomed transaction attempt on standalone dev Mongo rather than starting one
+* just to catch the error.
+*
+* Accepts a Mongoose `Connection` (or anything exposing `getClient()`/`client`
+* with a driver `topology`), so it stays decoupled from mongoose types.
+*/
+function supportsTransactions(connection) {
+	const probe = connection;
+	if (!probe) return true;
+	let client;
+	try {
+		client = probe.getClient?.() ?? probe.client ?? void 0;
+	} catch {
+		return true;
+	}
+	return client?.topology?.description?.type !== "Single";
+}
 //#endregion
 //#region src/Repository.ts
 /**
@@ -3441,6 +3517,24 @@ var Repository = class extends RepositoryBase {
 		return runChunkedPurge(strategy, options, createMongoPurgePort(this, field, value, options.session));
 	}
 	/**
+	* Range/filter-scoped purge — see `StandardRepo.purgeByFilter` for the
+	* cross-kit contract. The compliance primitive for "purge/anonymize a
+	* slice across a RANGE while retaining measures" (redact a PII dimension
+	* across a `civilDate` window, hard-delete past a retention cutoff): the
+	* base predicate is an arbitrary compiled filter, not `field = value`.
+	*
+	* Composes the kit-agnostic `runChunkedPurge` orchestrator (loop, signal,
+	* progress, result envelope) with `createMongoPurgePortFromFilter` (the
+	* filter-bound sibling of `createMongoPurgePort`). Accepts Filter IR or a
+	* Mongo-shaped filter record — compiled once via `compileFilterToMongo`,
+	* the same dual-dialect rule as `archiveByFilter` and every other verb.
+	* See [actions/purge.ts](./actions/purge.ts) for the port.
+	*/
+	async purgeByFilter(filter, strategy, options = {}) {
+		const compiled = compileFilterToMongo(filter);
+		return runChunkedPurge(strategy, options, createMongoPurgePortFromFilter(this, compiled, options.session));
+	}
+	/**
 	* Chunked cold-storage extraction — see `StandardRepo.archiveByFilter`
 	* for the cross-kit contract (write-before-delete, at-least-once,
 	* duplicate-tolerant sinks). Mongokit composes the kit-agnostic
@@ -4209,4 +4303,4 @@ var Repository = class extends RepositoryBase {
 	}
 };
 //#endregion
-export { withTransaction as a, MUTATING_OPERATIONS as c, operationsByPolicyKey as d, MONGOKIT_CAPABILITIES as f, isTransactionUnsupported as i, OP_REGISTRY as l, Repository as n, AggregationBuilder as o, createMongoPurgePort as p, batchTransaction as r, ALL_OPERATIONS as s, HOOK_PRIORITY$1 as t, READ_OPERATIONS as u };
+export { supportsTransactions as a, ALL_OPERATIONS as c, READ_OPERATIONS as d, operationsByPolicyKey as f, isTransactionUnsupported as i, MUTATING_OPERATIONS as l, createMongoPurgePort as m, Repository as n, withTransaction as o, MONGOKIT_CAPABILITIES as p, batchTransaction as r, AggregationBuilder as s, HOOK_PRIORITY$1 as t, OP_REGISTRY as u };

package/dist/better-auth/index.mjs

@@ -1,4 +1,4 @@
-import { n as Repository } from "../Repository-KKR8jxfD.mjs";
+import { n as Repository } from "../Repository-BFBTAMlA.mjs";
 import { n as createMongooseAdapter } from "../adapter-CLvUHiTW.mjs";
 import { pluralizeBetterAuthCollection, resolveBetterAuthCollections } from "@classytic/repo-core/better-auth";
 //#region src/better-auth/index.ts

package/dist/{create-repository-DA5VJh-3.mjs → create-repository-2DMwkYVz.mjs}

@@ -1,5 +1,5 @@
-import { n as Repository } from "./Repository-KKR8jxfD.mjs";
-import { a as methodRegistryPlugin, d as cachePlugin, f as batchOperationsPlugin, g as auditLogPlugin, i as multiTenantPlugin, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, t as timestampPlugin } from "./timestamp.plugin-B8252GuQ.mjs";
+import { n as Repository } from "./Repository-BFBTAMlA.mjs";
+import { a as methodRegistryPlugin, d as cachePlugin, f as batchOperationsPlugin, g as auditLogPlugin, i as multiTenantPlugin, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, t as timestampPlugin } from "./timestamp.plugin-ennbatTW.mjs";
 //#region src/create-repository.ts
 function isLoggerAudit(value) {
 	const v = value;

package/dist/{create-repository-HjMD9h9_.d.mts → create-repository-D4ZU94b3.d.mts}

@@ -1462,6 +1462,21 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
    * the port implementation.
    */
   purgeByField(field: string, value: unknown, strategy: TenantPurgeStrategy, options?: TenantPurgeOptions): Promise<TenantPurgeResult>;
+  /**
+   * Range/filter-scoped purge — see `StandardRepo.purgeByFilter` for the
+   * cross-kit contract. The compliance primitive for "purge/anonymize a
+   * slice across a RANGE while retaining measures" (redact a PII dimension
+   * across a `civilDate` window, hard-delete past a retention cutoff): the
+   * base predicate is an arbitrary compiled filter, not `field = value`.
+   *
+   * Composes the kit-agnostic `runChunkedPurge` orchestrator (loop, signal,
+   * progress, result envelope) with `createMongoPurgePortFromFilter` (the
+   * filter-bound sibling of `createMongoPurgePort`). Accepts Filter IR or a
+   * Mongo-shaped filter record — compiled once via `compileFilterToMongo`,
+   * the same dual-dialect rule as `archiveByFilter` and every other verb.
+   * See [actions/purge.ts](./actions/purge.ts) for the port.
+   */
+  purgeByFilter(filter: Record<string, unknown> | Filter, strategy: TenantPurgeStrategy, options?: TenantPurgeOptions): Promise<TenantPurgeResult>;
   /**
    * Chunked cold-storage extraction — see `StandardRepo.archiveByFilter`
    * for the cross-kit contract (write-before-delete, at-least-once,

package/dist/index.d.mts

@@ -6,9 +6,9 @@ import { a as InferRawDoc, c as NonNullableFields, d as Strict, f as UpdatePatch
 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-DCHRWRXw.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-DVyVGREb.mjs";
 import { t as PaginationEngine } from "./PaginationEngine-CBS1XGzp.mjs";
-import { a as Repository, i as HOOK_PRIORITY, n as CreateRepositoryConfig, o as TransitionMachine, r as createRepository, s as AggregationBuilder, t as AuditConfig } from "./create-repository-HjMD9h9_.mjs";
+import { a as Repository, i as HOOK_PRIORITY, n as CreateRepositoryConfig, o as TransitionMachine, r as createRepository, s as AggregationBuilder, t as AuditConfig } from "./create-repository-D4ZU94b3.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-vFufQZMZ.mjs";
-import { A as elasticSearchPlugin, C as LeasePluginOptions, D as immutableStatesPlugin, E as ImmutableStatesPluginOptions, F as auditLogPlugin, I as AppendOnlyPluginOptions, L as appendOnlyPlugin, M as BatchOperationsMethods, N as BulkWriteResult, O as fieldFilterPlugin, P as batchOperationsPlugin, R as AggregateHelpersMethods, S as LeaseMethods, T as ImmutableClaimView, _ as observabilityPlugin, a as uniqueField, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as cascadePlugin, k as ElasticSearchOptions, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin, z as aggregateHelpersPlugin } from "./validation-chain.plugin-DxD15h-2.mjs";
+import { A as ImmutableStatesPluginOptions, B as AppendOnlyPluginOptions, C as LeasePluginOptions, D as IdempotencyStorePluginOptions, E as IdempotencyStoreMethods, F as cascadePlugin, H as AggregateHelpersMethods, I as BatchOperationsMethods, L as BulkWriteResult, M as fieldFilterPlugin, N as ElasticSearchOptions, O as idempotencyStorePlugin, P as elasticSearchPlugin, R as batchOperationsPlugin, S as LeaseMethods, T as IdempotencyClaim, U as aggregateHelpersPlugin, V as appendOnlyPlugin, _ as observabilityPlugin, a as uniqueField, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as immutableStatesPlugin, k as ImmutableClaimView, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin, z as auditLogPlugin } from "./validation-chain.plugin-Cm0Ttnd8.mjs";
 import { n as SchemaPathsLike, t as FieldType$1 } from "./coercion-BjdPX3YF.mjs";
 import { n as SchemaIndexes } from "./indexes-DIjMpYES.mjs";
 import { _ as isDuplicateKeyError, a as configureLogger, c as idVariants, f as createFieldPreset, g as createError, h as getMongooseProjection, i as createMemoryCache, m as getFieldsForUser, n as buildCrudSchemasFromModel, p as filterResponseData, r as buildCrudSchemasFromMongooseSchema, t as toPlain, v as parseDuplicateKeyError } from "./to-plain-DkF5px0R.mjs";
@@ -492,6 +492,23 @@ declare function batchTransaction<TRepos extends Record<string, object>, TResult
  * problem is the same, and the fallback semantics are correct either way.
  */
 declare function isTransactionUnsupported(error: Error): boolean;
+/**
+ * PROACTIVELY report whether a connection's deployment supports multi-document
+ * transactions — the read-side companion to {@link isTransactionUnsupported}
+ * (which classifies a FAILED attempt). Single source of truth for the topology
+ * check so callers don't hand-roll `client.topology.description.type` probing.
+ *
+ * Returns `false` ONLY when the topology is positively a standalone (`'Single'`)
+ * server; an unknown/undefined topology (not yet connected, non-standard
+ * connection object) returns `true` — optimistic, because a genuine failure is
+ * still caught reactively by `isTransactionUnsupported`. Lets a caller skip a
+ * doomed transaction attempt on standalone dev Mongo rather than starting one
+ * just to catch the error.
+ *
+ * Accepts a Mongoose `Connection` (or anything exposing `getClient()`/`client`
+ * with a driver `topology`), so it stays decoupled from mongoose types.
+ */
+declare function supportsTransactions(connection: unknown): boolean;
 //#endregion
 //#region src/utils/repo-options.d.ts
 /**
@@ -692,4 +709,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 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 CascadeOptions, type CascadePurgeReferencesOptions, type CascadeRelation, type CollationOptions, type CollectionRWLike, type CreateInput, type CreateOptions, type CreateRepositoryConfig, type CursorPayload, type CustomIdOptions, type DateSequentialIdOptions, type DecodedCursor, type DeepPartial, type DeleteResult, type DocField, type ElasticSearchOptions, type EnsureAuditTrailReadyOptions, type EventHandlers, type EventPayload, type EventPhase, type FieldPreset, type FieldType, type FilterQuery, type FindOneAndUpdateOptions, type GroupResult, HOOK_PRIORITY, type HookMode, type IdGenerator, type ImmutableClaimView, type ImmutableStatesPluginOptions, type InferDocument, type InferRawDoc, type KeysOfType, type KeysetPaginationOptions, type LeaseMethods, type LeasePluginOptions, type Logger, LookupBuilder, type LookupOptions, type LookupPopulateOptions, type LookupPopulateResult, MONGOKIT_CAPABILITIES, MONGOKIT_PLUGIN_NAMES, MUTATING_OPERATIONS, type Middleware, type MiddlewareContext, type MinMaxResult, type MinimalRepoView, type MongoKitPluginName, type MongoOperationsMethods, type MongoOperatorUpdate, type MultiTenantOptions, type NonNullableFields, OP_REGISTRY, type ObjectId, type ObservabilityOptions, type OffsetPaginationOptions, type OperationDescriptor, type OperationMetric, type OperationOptions, type PaginationConfig, PaginationEngine, type ParsedQuery, type PartialBy, type Plugin, type PluginFunction, type PluginType, type PolicyKey, type PopulateOption, type PopulateSpec, type PrefixedIdOptions, type PrioritizedHook, type PurgeMode, type PurgeableRepoLike, QueryParser, type QueryParserOptions, 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 SoftDeleteFilterMode, type SoftDeleteMethods, type SoftDeleteOptions, type SoftDeleteRepository, type SortDirection, type SortSpec, type Strict, type SubdocumentMethods, type TenantContext, type TenantStore, type TransitionMachine, type UpdateManyResult, type UpdateOptions, type UpdatePatch, type UpdateWithValidationResult, type UserContext, type ValidationChainOptions, type ValidatorDefinition, type ValueType, type WithPlugins, type WithTransactionOptions, index_d_exports as actions, adminBypass, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, cascadePurgeReferences, compileFilterToMongo, configureLogger, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, filterResponseData, getFieldsForUser, getMongooseProjection, getNextSequence, idVariants, immutableField, immutableStatesPlugin, isDuplicateKeyError, isTransactionUnsupported, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, repoOptionsFromCtx, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, systemContext, timestampPlugin, toPlain, uniqueField, validationChainPlugin, withTransaction };
+export { ALL_OPERATIONS, type AggregateHelpersMethods, type AggregateOptions, type AggregatePaginationOptions, AggregationBuilder, 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 CascadeOptions, type CascadePurgeReferencesOptions, type CascadeRelation, type CollationOptions, type CollectionRWLike, type CreateInput, type CreateOptions, type CreateRepositoryConfig, type CursorPayload, type CustomIdOptions, type DateSequentialIdOptions, type DecodedCursor, type DeepPartial, type DeleteResult, type DocField, type ElasticSearchOptions, type EnsureAuditTrailReadyOptions, type EventHandlers, type EventPayload, type EventPhase, type FieldPreset, type FieldType, type FilterQuery, type FindOneAndUpdateOptions, type GroupResult, 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, LookupBuilder, type LookupOptions, type LookupPopulateOptions, type LookupPopulateResult, MONGOKIT_CAPABILITIES, MONGOKIT_PLUGIN_NAMES, MUTATING_OPERATIONS, type Middleware, type MiddlewareContext, type MinMaxResult, type MinimalRepoView, type MongoKitPluginName, type MongoOperationsMethods, type MongoOperatorUpdate, type MultiTenantOptions, type NonNullableFields, OP_REGISTRY, type ObjectId, type ObservabilityOptions, type OffsetPaginationOptions, type OperationDescriptor, type OperationMetric, type OperationOptions, type PaginationConfig, PaginationEngine, type ParsedQuery, type PartialBy, type Plugin, type PluginFunction, type PluginType, type PolicyKey, type PopulateOption, type PopulateSpec, type PrefixedIdOptions, type PrioritizedHook, type PurgeMode, type PurgeableRepoLike, QueryParser, type QueryParserOptions, 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 SoftDeleteFilterMode, type SoftDeleteMethods, type SoftDeleteOptions, type SoftDeleteRepository, type SortDirection, type SortSpec, type Strict, type SubdocumentMethods, type TenantContext, type TenantStore, type TransitionMachine, type UpdateManyResult, type UpdateOptions, type UpdatePatch, type UpdateWithValidationResult, type UserContext, type ValidationChainOptions, type ValidatorDefinition, type ValueType, type WithPlugins, type WithTransactionOptions, index_d_exports as actions, adminBypass, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, cascadePurgeReferences, compileFilterToMongo, configureLogger, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, filterResponseData, getFieldsForUser, getMongooseProjection, getNextSequence, idVariants, idempotencyStorePlugin, immutableField, immutableStatesPlugin, isDuplicateKeyError, isTransactionUnsupported, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, repoOptionsFromCtx, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, supportsTransactions, systemContext, timestampPlugin, toPlain, uniqueField, validationChainPlugin, withTransaction };

package/dist/index.mjs

@@ -1,14 +1,14 @@
 import { n as idVariants } from "./id-resolution-BqDrk0S2.mjs";
-import { a as withTransaction, c as MUTATING_OPERATIONS, d as operationsByPolicyKey, f as MONGOKIT_CAPABILITIES, i as isTransactionUnsupported, l as OP_REGISTRY, n as Repository, o as AggregationBuilder, p as createMongoPurgePort, r as batchTransaction, s as ALL_OPERATIONS, t as HOOK_PRIORITY, u as READ_OPERATIONS } from "./Repository-KKR8jxfD.mjs";
+import { a as supportsTransactions, c as ALL_OPERATIONS, d as READ_OPERATIONS, f as operationsByPolicyKey, i as isTransactionUnsupported, l as MUTATING_OPERATIONS, m as createMongoPurgePort, n as Repository, o as withTransaction, p as MONGOKIT_CAPABILITIES, r as batchTransaction, s as AggregationBuilder, t as HOOK_PRIORITY, u as OP_REGISTRY } from "./Repository-BFBTAMlA.mjs";
 import { b as LookupBuilder, x as compileFilterToMongo } from "./update-1Lq9OMD2.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 { t as actions_exports } from "./actions/index.mjs";
-import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, g as auditLogPlugin, h as ensureAuditTrailReady, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, r as adminBypass, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "./timestamp.plugin-B8252GuQ.mjs";
+import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, g as auditLogPlugin, h as ensureAuditTrailReady, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, r as adminBypass, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "./timestamp.plugin-ennbatTW.mjs";
 import { t as PaginationEngine } from "./PaginationEngine-CczbvCAq.mjs";
 import { isGeoOperator, parseGeoFilter } from "./query/primitives/geo.mjs";
-import { t as createRepository } from "./create-repository-DA5VJh-3.mjs";
-import { _ as appendOnlyPlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as cascadePlugin, h as elasticSearchPlugin, i as requireField, l as observabilityPlugin, m as fieldFilterPlugin, 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 aggregateHelpersPlugin } from "./validation-chain.plugin-C3Vwp-Rk.mjs";
+import { t as createRepository } from "./create-repository-2DMwkYVz.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 immutableStatesPlugin, n as blockIf, o as validationChainPlugin, p as idempotencyStorePlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "./validation-chain.plugin-k9joH2qw.mjs";
 import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "./field-selection-FSQFLpsU.mjs";
 import { buildFieldTypeMap, coerceFieldValue, coerceHeuristic } from "./query/primitives/coercion.mjs";
 import { extractSchemaIndexes } from "./query/primitives/indexes.mjs";
@@ -1611,4 +1611,4 @@ function systemContext(extra) {
 */
 var src_default = Repository;
 //#endregion
-export { ALL_OPERATIONS, AggregationBuilder, AuditTrailQuery, HOOK_PRIORITY, LookupBuilder, MONGOKIT_CAPABILITIES, MONGOKIT_PLUGIN_NAMES, MUTATING_OPERATIONS, OP_REGISTRY, PaginationEngine, QueryParser, READ_OPERATIONS, Repository, actions_exports as actions, adminBypass, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, cascadePurgeReferences, compileFilterToMongo, configureLogger, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, src_default as default, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, filterResponseData, getFieldsForUser, getMongooseProjection, getNextSequence, idVariants, immutableField, immutableStatesPlugin, isDuplicateKeyError, isTransactionUnsupported, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, repoOptionsFromCtx, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, systemContext, timestampPlugin, toPlain, uniqueField, validationChainPlugin, withTransaction };
+export { ALL_OPERATIONS, AggregationBuilder, AuditTrailQuery, HOOK_PRIORITY, LookupBuilder, MONGOKIT_CAPABILITIES, MONGOKIT_PLUGIN_NAMES, MUTATING_OPERATIONS, OP_REGISTRY, PaginationEngine, QueryParser, READ_OPERATIONS, Repository, actions_exports as actions, adminBypass, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, cascadePurgeReferences, compileFilterToMongo, configureLogger, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, src_default as default, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, filterResponseData, getFieldsForUser, getMongooseProjection, getNextSequence, idVariants, idempotencyStorePlugin, immutableField, immutableStatesPlugin, isDuplicateKeyError, isTransactionUnsupported, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, repoOptionsFromCtx, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, supportsTransactions, systemContext, timestampPlugin, toPlain, uniqueField, validationChainPlugin, withTransaction };

package/dist/plugins/index.d.mts

@@ -1,6 +1,6 @@
 import { S as RepositoryPluginName, b as MONGOKIT_PLUGIN_NAMES, l as Plugin, x as MongoKitPluginName } from "../repository-DCHRWRXw.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, 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-DVyVGREb.mjs";
-import { A as elasticSearchPlugin, C as LeasePluginOptions, D as immutableStatesPlugin, E as ImmutableStatesPluginOptions, F as auditLogPlugin, I as AppendOnlyPluginOptions, L as appendOnlyPlugin, M as BatchOperationsMethods, O as fieldFilterPlugin, P as batchOperationsPlugin, R as AggregateHelpersMethods, S as LeaseMethods, T as ImmutableClaimView, _ as observabilityPlugin, a as uniqueField, b as MethodRegistryRepository, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as cascadePlugin, k as ElasticSearchOptions, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin, z as aggregateHelpersPlugin } from "../validation-chain.plugin-DxD15h-2.mjs";
+import { A as ImmutableStatesPluginOptions, B as AppendOnlyPluginOptions, C as LeasePluginOptions, D as IdempotencyStorePluginOptions, E as IdempotencyStoreMethods, F as cascadePlugin, H as AggregateHelpersMethods, I as BatchOperationsMethods, M as fieldFilterPlugin, N as ElasticSearchOptions, O as idempotencyStorePlugin, P as elasticSearchPlugin, R as batchOperationsPlugin, S as LeaseMethods, T as IdempotencyClaim, U as aggregateHelpersPlugin, V as appendOnlyPlugin, _ as observabilityPlugin, a as uniqueField, b as MethodRegistryRepository, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as immutableStatesPlugin, k as ImmutableClaimView, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin, z as auditLogPlugin } from "../validation-chain.plugin-Cm0Ttnd8.mjs";
 import { ChangeLogStore } from "@classytic/repo-core/sync";
 //#region src/plugins/change-log.plugin.d.ts
 interface ChangeLogPluginOptions {
@@ -15,4 +15,4 @@ interface ChangeLogPluginOptions {
 }
 declare function changeLogPlugin(options: ChangeLogPluginOptions): Plugin;
 //#endregion
-export { type AggregateHelpersMethods, type AppendOnlyPluginOptions, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailMode, type AuditTrailOptions, AuditTrailQuery, type AuditTrailQueryOptions, type BatchOperationsMethods, type CacheAdapter, type CacheOptions, type ChangeLogPluginOptions, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type EnsureAuditTrailReadyOptions, type IdGenerator, type ImmutableClaimView, type ImmutableStatesPluginOptions, type LeaseMethods, type LeasePluginOptions, MONGOKIT_PLUGIN_NAMES, type MethodRegistryRepository, type MongoKitPluginName, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type RepositoryPluginName, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, type TenantContext, type TenantStore, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, getNextSequence, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+export { type AggregateHelpersMethods, type AppendOnlyPluginOptions, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailMode, type AuditTrailOptions, AuditTrailQuery, type AuditTrailQueryOptions, type BatchOperationsMethods, type CacheAdapter, type CacheOptions, type ChangeLogPluginOptions, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type EnsureAuditTrailReadyOptions, type IdGenerator, type IdempotencyClaim, type IdempotencyStoreMethods, type IdempotencyStorePluginOptions, type ImmutableClaimView, type ImmutableStatesPluginOptions, type LeaseMethods, type LeasePluginOptions, MONGOKIT_PLUGIN_NAMES, type MethodRegistryRepository, type MongoKitPluginName, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type RepositoryCacheHandle, type RepositoryCachePluginOptions, type RepositoryPluginName, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, type TenantContext, type TenantStore, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, getNextSequence, idempotencyStorePlugin, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/plugins/index.mjs

@@ -1,5 +1,5 @@
-import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, g as auditLogPlugin, h as ensureAuditTrailReady, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "../timestamp.plugin-B8252GuQ.mjs";
-import { _ as appendOnlyPlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as cascadePlugin, h as elasticSearchPlugin, i as requireField, l as observabilityPlugin, m as fieldFilterPlugin, 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 aggregateHelpersPlugin } from "../validation-chain.plugin-C3Vwp-Rk.mjs";
+import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, g as auditLogPlugin, h as ensureAuditTrailReady, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "../timestamp.plugin-ennbatTW.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 immutableStatesPlugin, n as blockIf, o as validationChainPlugin, p as idempotencyStorePlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "../validation-chain.plugin-k9joH2qw.mjs";
 //#region src/plugins/change-log.plugin.ts
 const PLUGIN_NAME = "changeLog";
 function isSkipped(context) {
@@ -70,4 +70,4 @@ function changeLogPlugin(options) {
 	};
 }
 //#endregion
-export { AuditTrailQuery, MONGOKIT_PLUGIN_NAMES, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, getNextSequence, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+export { AuditTrailQuery, MONGOKIT_PLUGIN_NAMES, aggregateHelpersPlugin, appendOnlyPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, changeLogPlugin, createTenantContext, customIdPlugin, dateSequentialId, elasticSearchPlugin, ensureAuditTrailReady, fieldFilterPlugin, getNextSequence, idempotencyStorePlugin, immutableField, immutableStatesPlugin, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/testkit/index.d.mts

@@ -1,4 +1,4 @@
-import { a as Repository, n as CreateRepositoryConfig } from "../create-repository-HjMD9h9_.mjs";
+import { a as Repository, n as CreateRepositoryConfig } from "../create-repository-D4ZU94b3.mjs";
 import { Connection, Model, Schema } from "mongoose";
 import { MongoMemoryReplSet, MongoMemoryServer } from "mongodb-memory-server";
 //#region src/testkit/index.d.ts

package/dist/testkit/index.mjs

@@ -1,4 +1,4 @@
-import { t as createRepository } from "../create-repository-DA5VJh-3.mjs";
+import { t as createRepository } from "../create-repository-2DMwkYVz.mjs";
 import { createConnection } from "mongoose";
 //#region src/testkit/index.ts
 function idempotentStop(server) {

package/dist/{timestamp.plugin-B8252GuQ.mjs → timestamp.plugin-ennbatTW.mjs}

@@ -1,4 +1,4 @@
-import { l as OP_REGISTRY, s as ALL_OPERATIONS, t as HOOK_PRIORITY } from "./Repository-KKR8jxfD.mjs";
+import { c as ALL_OPERATIONS, t as HOOK_PRIORITY, u as OP_REGISTRY } from "./Repository-BFBTAMlA.mjs";
 import { n as warn } from "./logger-K7dPmu2U.mjs";
 import { t as createError } from "./error-BuByZwKU.mjs";
 import { throwIfAborted, withRetry } from "@classytic/repo-core/repository";

package/dist/{validation-chain.plugin-DxD15h-2.d.mts → validation-chain.plugin-Cm0Ttnd8.d.mts}

@@ -226,6 +226,142 @@ interface ImmutableStatesPluginOptions {
 }
 declare function immutableStatesPlugin(options: ImmutableStatesPluginOptions): Plugin;
 //#endregion
+//#region src/plugins/idempotency-store.plugin.d.ts
+interface IdempotencyStorePluginOptions {
+  /** Field carrying the deterministic operation key. @default `'key'` */
+  keyField?: string;
+  /** Field carrying the row's claim status. @default `'status'` */
+  statusField?: string;
+  /** Field carrying the current holder's lease token. @default `'leaseToken'` */
+  leaseTokenField?: string;
+  /** Field carrying the lease expiry timestamp. @default `'leaseExpiresAt'` */
+  leaseExpiresAtField?: string;
+  /** Field counting claim acquisitions (1 = first). @default `'attempts'` */
+  attemptsField?: string;
+  /** Field carrying saga resume data (Mixed). @default `'progress'` */
+  progressField?: string;
+  /** Field carrying the replayable success outcome (Mixed). @default `'result'` */
+  resultField?: string;
+  /** Field carrying the terminal failure code. @default `'failureCode'` */
+  failureCodeField?: string;
+  /** Field carrying the last error message (diagnostics). @default `'lastError'` */
+  lastErrorField?: string;
+  /** Status value of an in-flight claim. @default `'in_flight'` */
+  inFlightStatus?: string;
+  /** Terminal success status. @default `'succeeded'` */
+  succeededStatus?: string;
+  /** Terminal failure status. @default `'failed'` */
+  failedStatus?: string;
+  /** Claim lease (ms) — must outlive the longest guarded execution. @default 60_000 */
+  defaultLeaseMs?: number;
+  /**
+   * Re-acquisition ceiling. When > 0, an expired in-flight claim whose
+   * `attempts` already reached this value returns `exhausted` instead of
+   * re-acquiring — the bounded-retry escalation valve for operations whose
+   * external side effect is idempotent but may be wedged. 0 = unbounded
+   * (flow/order semantics: recovery always re-claims). @default 0
+   */
+  maxAttempts?: number;
+}
+/** Outcome of `claimKey()` — the claim decision matrix. */
+type IdempotencyClaim<TProgress = Record<string, unknown>, TResult = unknown> =
+/**
+ * This caller owns the lease — execute. `progress` present ⇒ a stale-lease
+ * re-acquire after a previous attempt persisted resume data (crash
+ * recovery): resume from it instead of re-running completed pivots.
+ * `attempt` is 1 on a fresh claim.
+ */
+{
+  kind: 'acquired';
+  leaseToken: string;
+  attempt: number;
+  progress?: TProgress;
+} |
+/** A previous execution succeeded — replay its stored outcome. */
+{
+  kind: 'completed';
+  result?: TResult;
+} |
+/** A previous execution failed terminally — replay the recorded code. */
+{
+  kind: 'failed';
+  failureCode?: string;
+  error?: string;
+} |
+/** Another caller holds a live lease. `progress` (when persisted) lets a
+ *  domain layer act on completed pivots without owning the lease — e.g.
+ *  finish an idempotent post-pivot sync while the holder is wedged. */
+{
+  kind: 'busy';
+  progress?: TProgress;
+  leaseToken?: string;
+} |
+/** `maxAttempts` re-acquisitions exhausted — escalate to a human. */
+{
+  kind: 'exhausted';
+  attempts: number;
+  progress?: TProgress;
+};
+/**
+ * Methods contributed by `idempotencyStorePlugin()`. Use as a type assertion
+ * when constructing the repo (same convention as `LeaseMethods`).
+ */
+interface IdempotencyStoreMethods<TProgress = Record<string, unknown>, TResult = unknown> {
+  /**
+   * Atomically claim `key`. Exactly one concurrent caller acquires; the rest
+   * branch on the row's durable state — see {@link IdempotencyClaim}.
+   *
+   * `seed` merges extra fields into the row on FIRST insert only (domain
+   * columns, tenant stamp). It never mutates an existing row.
+   */
+  claimKey(key: string, opts?: {
+    leaseMs?: number;
+    seed?: Record<string, unknown>;
+  }): Promise<IdempotencyClaim<TProgress, TResult>>;
+  /**
+   * Persist saga resume data (post-pivot, pre-complete). Lease-token-guarded —
+   * a stale crashed holder can't clobber a re-acquirer's record. Optional
+   * `where` adds domain guards to the CAS filter.
+   */
+  saveClaimProgress(key: string, leaseToken: string, progress: TProgress, opts?: {
+    where?: Record<string, unknown>;
+  }): Promise<boolean>;
+  /**
+   * CAS the claim to the terminal SUCCESS status, storing `result` for
+   * replay. Loses cleanly (returns false) when the lease was re-acquired.
+   */
+  completeClaim(key: string, leaseToken: string, result?: TResult, opts?: {
+    where?: Record<string, unknown>;
+  }): Promise<boolean>;
+  /**
+   * CAS the claim to the terminal FAILURE status. Later claims replay
+   * `failureCode` instead of re-executing. Use ONLY for definitive failures
+   * where the external side effect is known NOT to have happened.
+   */
+  failClaim(key: string, leaseToken: string, failure: {
+    code: string;
+    error?: string;
+  }, opts?: {
+    where?: Record<string, unknown>;
+  }): Promise<boolean>;
+  /**
+   * Delete the caller's own in-flight row on definitive PRE-side-effect
+   * failure so a retry re-executes cleanly. Never deletes a terminal row or
+   * a re-acquired lease.
+   */
+  releaseClaim(key: string, leaseToken: string): Promise<boolean>;
+  /**
+   * Record an AMBIGUOUS error and lapse the lease immediately (keeps the row
+   * in-flight) so a recovery sweep re-claims without waiting out the lease.
+   * The bridge between "this attempt is giving up" and "the operation is not
+   * over" — e.g. a network error mid-external-call.
+   */
+  expireClaim(key: string, leaseToken: string, opts?: {
+    error?: string;
+  }): Promise<boolean>;
+}
+declare function idempotencyStorePlugin(options?: IdempotencyStorePluginOptions): Plugin;
+//#endregion
 //#region src/plugins/lease.plugin.d.ts
 interface LeasePluginOptions {
   /** Field carrying the row's status. @default `'status'` */
@@ -822,4 +958,4 @@ declare function immutableField(field: string): ValidatorDefinition;
  */
 declare function uniqueField(field: string, errorMessage?: string): ValidatorDefinition;
 //#endregion
-export { elasticSearchPlugin as A, LeasePluginOptions as C, immutableStatesPlugin as D, ImmutableStatesPluginOptions as E, auditLogPlugin as F, AppendOnlyPluginOptions as I, appendOnlyPlugin as L, BatchOperationsMethods as M, BulkWriteResult as N, fieldFilterPlugin as O, batchOperationsPlugin as P, AggregateHelpersMethods as R, LeaseMethods as S, ImmutableClaimView as T, observabilityPlugin as _, uniqueField as a, MethodRegistryRepository as b, TenantContext as c, SubdocumentMethods as d, subdocumentPlugin as f, OperationMetric as g, ObservabilityOptions as h, requireField as i, cascadePlugin as j, ElasticSearchOptions as k, TenantStore as l, softDeletePlugin as m, blockIf as n, validationChainPlugin as o, SoftDeleteMethods as p, immutableField as r, timestampPlugin as s, autoInject as t, createTenantContext as u, MongoOperationsMethods as v, leasePlugin as w, methodRegistryPlugin as x, mongoOperationsPlugin as y, aggregateHelpersPlugin as z };
+export { ImmutableStatesPluginOptions as A, AppendOnlyPluginOptions as B, LeasePluginOptions as C, IdempotencyStorePluginOptions as D, IdempotencyStoreMethods as E, cascadePlugin as F, AggregateHelpersMethods as H, BatchOperationsMethods as I, BulkWriteResult as L, fieldFilterPlugin as M, ElasticSearchOptions as N, idempotencyStorePlugin as O, elasticSearchPlugin as P, batchOperationsPlugin as R, LeaseMethods as S, IdempotencyClaim as T, aggregateHelpersPlugin as U, appendOnlyPlugin as V, observabilityPlugin as _, uniqueField as a, MethodRegistryRepository as b, TenantContext as c, SubdocumentMethods as d, subdocumentPlugin as f, OperationMetric as g, ObservabilityOptions as h, requireField as i, immutableStatesPlugin as j, ImmutableClaimView as k, TenantStore as l, softDeletePlugin as m, blockIf as n, validationChainPlugin as o, SoftDeleteMethods as p, immutableField as r, timestampPlugin as s, autoInject as t, createTenantContext as u, MongoOperationsMethods as v, leasePlugin as w, methodRegistryPlugin as x, mongoOperationsPlugin as y, auditLogPlugin as z };

package/dist/{validation-chain.plugin-C3Vwp-Rk.mjs → validation-chain.plugin-k9joH2qw.mjs}

@@ -1,4 +1,4 @@
-import { l as OP_REGISTRY, s as ALL_OPERATIONS } from "./Repository-KKR8jxfD.mjs";
+import { c as ALL_OPERATIONS, u as OP_REGISTRY } from "./Repository-BFBTAMlA.mjs";
 import { _ as upsert } from "./update-1Lq9OMD2.mjs";
 import { n as warn } from "./logger-K7dPmu2U.mjs";
 import { t as createError } from "./error-BuByZwKU.mjs";
@@ -610,6 +610,153 @@ function immutableStatesPlugin(options) {
 	};
 }
 //#endregion
+//#region src/plugins/idempotency-store.plugin.ts
+function randomToken() {
+	const bytes = /* @__PURE__ */ new Uint8Array(16);
+	globalThis.crypto.getRandomValues(bytes);
+	return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+function idempotencyStorePlugin(options = {}) {
+	const keyField = options.keyField ?? "key";
+	const statusField = options.statusField ?? "status";
+	const leaseTokenField = options.leaseTokenField ?? "leaseToken";
+	const leaseExpiresAtField = options.leaseExpiresAtField ?? "leaseExpiresAt";
+	const attemptsField = options.attemptsField ?? "attempts";
+	const progressField = options.progressField ?? "progress";
+	const resultField = options.resultField ?? "result";
+	const failureCodeField = options.failureCodeField ?? "failureCode";
+	const lastErrorField = options.lastErrorField ?? "lastError";
+	const inFlightStatus = options.inFlightStatus ?? "in_flight";
+	const succeededStatus = options.succeededStatus ?? "succeeded";
+	const failedStatus = options.failedStatus ?? "failed";
+	const defaultLeaseMs = options.defaultLeaseMs ?? 6e4;
+	const maxAttempts = options.maxAttempts ?? 0;
+	return {
+		name: "idempotencyStore",
+		apply(repo) {
+			if (!repo.registerMethod) throw new Error("idempotencyStorePlugin requires methodRegistryPlugin. Add methodRegistryPlugin() before idempotencyStorePlugin().");
+			const asDoc = (d) => d;
+			repo.registerMethod("claimKey", async function(key, opts = {}) {
+				if (typeof key !== "string" || key.length === 0) throw createError(400, "idempotencyStorePlugin.claimKey: key must be a non-empty string");
+				const leaseMs = opts.leaseMs ?? defaultLeaseMs;
+				const now = /* @__PURE__ */ new Date();
+				const leaseToken = randomToken();
+				const { doc, created } = await this.getOrCreate({ [keyField]: key }, {
+					...opts.seed ?? {},
+					[keyField]: key,
+					[statusField]: inFlightStatus,
+					[leaseTokenField]: leaseToken,
+					[leaseExpiresAtField]: new Date(now.getTime() + leaseMs),
+					[attemptsField]: 1
+				});
+				if (created) return {
+					kind: "acquired",
+					leaseToken,
+					attempt: 1
+				};
+				const row = asDoc(doc);
+				if (row[statusField] === succeededStatus) return {
+					kind: "completed",
+					result: row[resultField]
+				};
+				if (row[statusField] === failedStatus) return {
+					kind: "failed",
+					failureCode: row[failureCodeField],
+					error: row[lastErrorField]
+				};
+				const leaseExpiresAt = row[leaseExpiresAtField];
+				const progress = row[progressField];
+				if (leaseExpiresAt && leaseExpiresAt > now) return {
+					kind: "busy",
+					...progress !== void 0 ? { progress } : {},
+					...row[leaseTokenField] !== void 0 ? { leaseToken: row[leaseTokenField] } : {}
+				};
+				const attempts = row[attemptsField] ?? 1;
+				if (maxAttempts > 0 && attempts >= maxAttempts) return {
+					kind: "exhausted",
+					attempts,
+					...progress !== void 0 ? { progress } : {}
+				};
+				const reclaimed = await this.findOneAndUpdate({
+					[keyField]: key,
+					[statusField]: inFlightStatus,
+					[leaseExpiresAtField]: { $lte: now }
+				}, {
+					$set: {
+						[leaseTokenField]: leaseToken,
+						[leaseExpiresAtField]: new Date(now.getTime() + leaseMs)
+					},
+					$inc: { [attemptsField]: 1 }
+				}, { returnDocument: "after" });
+				if (reclaimed) {
+					const rec = asDoc(reclaimed);
+					const recProgress = rec[progressField];
+					return {
+						kind: "acquired",
+						leaseToken,
+						attempt: rec[attemptsField] ?? attempts + 1,
+						...recProgress !== void 0 ? { progress: recProgress } : {}
+					};
+				}
+				return {
+					kind: "busy",
+					...progress !== void 0 ? { progress } : {}
+				};
+			});
+			repo.registerMethod("saveClaimProgress", async function(key, leaseToken, progress, opts = {}) {
+				return await this.findOneAndUpdate({
+					...opts.where ?? {},
+					[keyField]: key,
+					[leaseTokenField]: leaseToken,
+					[statusField]: inFlightStatus
+				}, { $set: { [progressField]: progress } }, { returnDocument: "after" }) !== null;
+			});
+			repo.registerMethod("completeClaim", async function(key, leaseToken, result, opts = {}) {
+				return await this.findOneAndUpdate({
+					...opts.where ?? {},
+					[keyField]: key,
+					[leaseTokenField]: leaseToken,
+					[statusField]: inFlightStatus
+				}, { $set: {
+					[statusField]: succeededStatus,
+					...result !== void 0 ? { [resultField]: result } : {}
+				} }, { returnDocument: "after" }) !== null;
+			});
+			repo.registerMethod("failClaim", async function(key, leaseToken, failure, opts = {}) {
+				if (!failure || typeof failure.code !== "string" || failure.code.length === 0) throw createError(400, "idempotencyStorePlugin.failClaim: failure.code must be a non-empty string");
+				return await this.findOneAndUpdate({
+					...opts.where ?? {},
+					[keyField]: key,
+					[leaseTokenField]: leaseToken,
+					[statusField]: inFlightStatus
+				}, { $set: {
+					[statusField]: failedStatus,
+					[failureCodeField]: failure.code,
+					...failure.error !== void 0 ? { [lastErrorField]: failure.error } : {}
+				} }, { returnDocument: "after" }) !== null;
+			});
+			repo.registerMethod("releaseClaim", async function(key, leaseToken) {
+				const res = await this.deleteMany({
+					[keyField]: key,
+					[leaseTokenField]: leaseToken,
+					[statusField]: inFlightStatus
+				});
+				return (typeof res === "number" ? res : res?.deletedCount ?? 0) > 0;
+			});
+			repo.registerMethod("expireClaim", async function(key, leaseToken, opts = {}) {
+				return await this.findOneAndUpdate({
+					[keyField]: key,
+					[leaseTokenField]: leaseToken,
+					[statusField]: inFlightStatus
+				}, { $set: {
+					[leaseExpiresAtField]: /* @__PURE__ */ new Date(),
+					...opts.error !== void 0 ? { [lastErrorField]: opts.error } : {}
+				} }, { returnDocument: "after" }) !== null;
+			});
+		}
+	};
+}
+//#endregion
 //#region src/plugins/lease.plugin.ts
 function leasePlugin(options = {}) {
 	const statusField = options.statusField ?? "status";
@@ -1304,4 +1451,4 @@ function uniqueField(field, errorMessage) {
 	};
 }
 //#endregion
-export { appendOnlyPlugin as _, uniqueField as a, subdocumentPlugin as c, mongoOperationsPlugin as d, leasePlugin as f, cascadePlugin as g, elasticSearchPlugin as h, requireField as i, observabilityPlugin as l, fieldFilterPlugin as m, blockIf as n, validationChainPlugin as o, immutableStatesPlugin as p, immutableField as r, createTenantContext as s, autoInject as t, MONGOKIT_PLUGIN_NAMES as u, aggregateHelpersPlugin as v };
+export { cascadePlugin as _, uniqueField as a, subdocumentPlugin as c, mongoOperationsPlugin as d, leasePlugin as f, elasticSearchPlugin as g, fieldFilterPlugin as h, requireField as i, observabilityPlugin as l, immutableStatesPlugin as m, blockIf as n, validationChainPlugin as o, idempotencyStorePlugin as p, immutableField as r, createTenantContext as s, autoInject as t, MONGOKIT_PLUGIN_NAMES as u, appendOnlyPlugin as v, aggregateHelpersPlugin as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.25.0",
+  "version": "3.28.0",
   "description": "Production-grade MongoDB repositories - smart pagination, events, and plugins. Built on @classytic/repo-core.",
   "type": "module",
   "sideEffects": false,
@@ -113,7 +113,7 @@
   },
   "homepage": "https://github.com/classytic/mongokit#readme",
   "peerDependencies": {
-    "@classytic/repo-core": ">=0.14.0",
+    "@classytic/repo-core": ">=0.17.0",
     "mongoose": ">=9.4.1"
   },
   "engines": {
@@ -157,7 +157,7 @@
     "@better-auth/mongo-adapter": "^1.6.22",
     "@biomejs/biome": "^2.4.10",
     "@classytic/dev-tools": "^0.2.0",
-    "@classytic/repo-core": "^0.14.0",
+    "@classytic/repo-core": "^0.17.0",
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^4.1.4",
     "ajv": "^8.18.0",