@classytic/mongokit 3.43.0 → 3.44.0

package/dist/{validation-chain.plugin-DRApTmkN.mjs → validation-chain.plugin-DNY6MIF6.mjs}

@@ -1,14 +1,14 @@
-import { n as collectIds, r as idChunks, t as DEFAULT_ID_CHUNK } from "./id-chunks-BmAwsqNk.mjs";
-import { a as ALL_OPERATIONS, s as OP_REGISTRY } from "./Repository-Dj6xqPxJ.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-DpOWavVI.mjs";
-import { r as getFieldsForUser } from "./field-selection-FSQFLpsU.mjs";
+import { t as createError } from "./error-DjdmPLWO.mjs";
+import { a as ALL_OPERATIONS, f as readRetentionPurge, p as retentionPurgeEvent, s as OP_REGISTRY } from "./Repository-eMRYZ_2Y.mjs";
+import { n as collectIds, r as idChunks, t as DEFAULT_ID_CHUNK } from "./id-chunks-DH-RAZWG.mjs";
+import { w as upsert } from "./update-DcfmNbJe.mjs";
+import { n as warn } from "./logger-hbWOlj_X.mjs";
+import { c as tenantContextKeysOf, o as forwardScope } from "./timestamp.plugin-Bz_zL9PX.mjs";
+import { r as getFieldsForUser } from "./field-selection-DPFaFw9Y.mjs";
 import mongoose from "mongoose";
 import { HOOK_PRIORITY } from "@classytic/repo-core/hooks";
 import { AsyncLocalStorage } from "node:async_hooks";
-//#region src/plugins/aggregate-helpers.plugin.ts
+// src/plugins/aggregate-helpers.plugin.ts
 /**
 * Aggregate helpers plugin
 *
@@ -71,8 +71,7 @@ function aggregateHelpersPlugin() {
 		}
 	};
 }
-//#endregion
-//#region src/plugins/append-only.plugin.ts
+// src/plugins/append-only.plugin.ts
 /**
 * Append-Only Plugin
 *
@@ -114,6 +113,19 @@ function aggregateHelpersPlugin() {
 *     maintenance (backfill repair, migration), grep-auditable at the
 *     call site.
 *
+* **Retention purge** (`allowPurge: true`): the one public path for a
+* retention job to physically remove rows. Pass
+* `retentionPurge: { reason, actor? }` with `mode: 'hard'` on `delete` /
+* `deleteMany`, or run `purgeByFilter(filter, { type: 'hard' },
+* { retentionPurge })` / `purgeByField(...)`, which forward it to every
+* chunk. Each successful call emits `after:append-only-purge`
+* ({@link AppendOnlyPurgeEvent}) with the reason, actor, target and
+* `deletedCount`. Without `allowPurge`, a missing reason or `mode: 'hard'`
+* the call is refused; on any other op the option is ignored (the fence
+* applies). The same option is honoured by `immutableStatesPlugin`, so a
+* repository with both plugins purges through one call. Prefer it over
+* `bypassAppendOnly` for retention: it is delete-only and carries a reason.
+*
 * `skipPlugins` is deliberately IGNORED — same policy as tenant scope
 * and soft delete: integrity fences don't have a convenience bypass.
 *
@@ -125,7 +137,14 @@ function aggregateHelpersPlugin() {
 * await events.create({ ... });            // OK
 * await events.update(id, { ... });        // throws 405 APPEND_ONLY_VIOLATION
 * await events.deleteMany({ ... }, { bypassAppendOnly: true }); // audited bypass
+*
+* @example Retention purge (construct with `appendOnlyPlugin({ allowPurge: true })`)
+* events.on('after:append-only-purge', (e) => audit('retention.purge', e));
+* await events.purgeByFilter({ at: { $lt: cutoff } }, { type: 'hard' }, {
+*   retentionPurge: { reason: 'retention: 1095 days', actor: 'job:retention' },
+* });
 */
+const PURGE_OPS = /* @__PURE__ */ new Set(["delete", "deleteMany"]);
 const ALWAYS_ALLOWED = /* @__PURE__ */ new Set(["create", "createMany"]);
 function appendOnlyPlugin(options = {}) {
 	const allowed = /* @__PURE__ */ new Set([...ALWAYS_ALLOWED, ...options.allow ?? []]);
@@ -133,9 +152,21 @@ function appendOnlyPlugin(options = {}) {
 		name: "appendOnly",
 		apply(repo) {
 			const modelName = repo.Model?.modelName ?? "model";
+			const purgeGuard = {
+				plugin: "appendOnlyPlugin",
+				allowPurge: options.allowPurge === true
+			};
+			const priority = options.priority ?? HOOK_PRIORITY.POLICY;
 			for (const [op, meta] of Object.entries(OP_REGISTRY)) {
-				if (!meta.mutates || allowed.has(op)) continue;
+				if (!meta.mutates) continue;
+				if (allowed.has(op)) {
+					if (PURGE_OPS.has(op)) repo.on(`before:${op}`, (context) => {
+						readRetentionPurge(context, op, purgeGuard);
+					}, { priority });
+					continue;
+				}
 				repo.on(`before:${op}`, (context) => {
+					if (PURGE_OPS.has(op) && readRetentionPurge(context, op, purgeGuard)) return;
 					if (context.bypassAppendOnly === true) {
 						repo.emit("after:append-only-bypass", {
 							operation: op,
@@ -150,13 +181,16 @@ function appendOnlyPlugin(options = {}) {
 							model: modelName
 						}
 					});
-				}, { priority: options.priority ?? HOOK_PRIORITY.POLICY });
+				}, { priority });
 			}
+			if (options.allowPurge) for (const op of ["delete", "deleteMany"]) repo.on(`after:${op}`, async (payload) => {
+				const event = retentionPurgeEvent(op, payload.context, payload.result);
+				if (event) await repo.emitAsync("after:append-only-purge", event);
+			});
 		}
 	};
 }
-//#endregion
-//#region src/plugins/cascade.plugin.ts
+// src/plugins/cascade.plugin.ts
 /**
 * Cascade Delete Plugin
 *
@@ -477,8 +511,7 @@ async function runCascades(relations, fn, parallel, session) {
 		}
 	} else for (const relation of relations) await fn(relation);
 }
-//#endregion
-//#region src/plugins/elastic.plugin.ts
+// src/plugins/elastic.plugin.ts
 function elasticSearchPlugin(options) {
 	return {
 		name: "elastic-search",
@@ -549,8 +582,7 @@ function elasticSearchPlugin(options) {
 		}
 	};
 }
-//#endregion
-//#region src/plugins/field-filter.plugin.ts
+// src/plugins/field-filter.plugin.ts
 /**
 * Field filter plugin that restricts fields based on user context
 *
@@ -582,8 +614,7 @@ function fieldFilterPlugin(fieldPreset) {
 		}
 	};
 }
-//#endregion
-//#region src/plugins/idempotency-store.plugin.ts
+// src/plugins/idempotency-store.plugin.ts
 function randomToken() {
 	const bytes = /* @__PURE__ */ new Uint8Array(16);
 	globalThis.crypto.getRandomValues(bytes);
@@ -735,8 +766,7 @@ function idempotencyStorePlugin(options = {}) {
 		}
 	};
 }
-//#endregion
-//#region src/plugins/immutable-states.plugin.ts
+// src/plugins/immutable-states.plugin.ts
 /** Ops this plugin has an explicit strategy for (see module doc). */
 const STRATEGY_OPS = /* @__PURE__ */ new Set([
 	"create",
@@ -778,10 +808,12 @@ function immutableStatesPlugin(options) {
 				if (options.tenantField && ctx.query && options.tenantField in ctx.query) q[options.tenantField] = ctx.query[options.tenantField];
 				return q;
 			};
+			/** The call's session: every guard read runs in it, so a row frozen earlier in the same transaction counts. */
+			const sessionOf = (ctx) => ctx.session ?? null;
 			/** Raw-Model read — never re-enters the repo hook pipeline. */
 			const readStateById = async (ctx) => {
 				if (ctx.id === void 0 || ctx.id === null) return void 0;
-				const doc = await Model.findOne(scoped({ _id: ctx.id }, ctx)).select({ [field]: 1 }).lean();
+				const doc = await Model.findOne(scoped({ _id: ctx.id }, ctx)).select({ [field]: 1 }).session(sessionOf(ctx)).lean();
 				return doc ? getState(doc) : void 0;
 			};
 			const guardById = (op) => async (ctx) => {
@@ -793,19 +825,41 @@ function immutableStatesPlugin(options) {
 					state
 				});
 			};
+			const purgeGuard = {
+				plugin: "immutableStatesPlugin",
+				allowPurge: options.allowPurge === true
+			};
+			const purgeRequest = (op, ctx) => readRetentionPurge(ctx, op, purgeGuard);
 			for (const op of [
 				"update",
-				"delete",
 				"claimVersion",
 				"restore"
 			]) repo.on(`before:${op}`, guardById(op));
+			const guardDelete = guardById("delete");
+			repo.on("before:delete", async (ctx) => {
+				if (ctx[internalFlag]) return;
+				if (purgeRequest("delete", ctx)) return;
+				await guardDelete(ctx);
+			});
+			const emitPurge = async (operation, context, result) => {
+				if (!options.allowPurge || context[internalFlag]) return;
+				const base = retentionPurgeEvent(operation, context, result);
+				if (!base) return;
+				const event = {
+					...base,
+					states: [...frozen]
+				};
+				await repo.emitAsync("after:immutable-states-purge", event);
+			};
+			repo.on("after:delete", (payload) => emitPurge("delete", payload.context, payload.result));
+			repo.on("after:deleteMany", (payload) => emitPurge("deleteMany", payload.context, payload.result));
 			repo.on("before:findOneAndUpdate", async (ctx) => {
 				if (ctx[internalFlag]) return;
 				const filter = ctx.query ?? {};
 				const doc = await Model.findOne(filter).select({
 					[field]: 1,
 					_id: 1
-				}).lean();
+				}).session(sessionOf(ctx)).lean();
 				if (!doc) return;
 				const state = getState(doc);
 				if (state !== void 0 && frozen.has(state)) throwViolation({
@@ -817,7 +871,7 @@ function immutableStatesPlugin(options) {
 			const guardMany = (op) => async (ctx) => {
 				if (ctx[internalFlag]) return;
 				const filter = ctx.query ?? {};
-				const hit = await Model.exists({ $and: [filter, { [field]: { $in: [...frozen] } }] });
+				const hit = await Model.exists({ $and: [filter, { [field]: { $in: [...frozen] } }] }).session(sessionOf(ctx));
 				if (hit) throwViolation({
 					id: hit._id,
 					operation: op,
@@ -825,7 +879,12 @@ function immutableStatesPlugin(options) {
 				});
 			};
 			repo.on("before:updateMany", guardMany("updateMany"));
-			repo.on("before:deleteMany", guardMany("deleteMany"));
+			const guardDeleteMany = guardMany("deleteMany");
+			repo.on("before:deleteMany", async (ctx) => {
+				if (ctx[internalFlag]) return;
+				if (purgeRequest("deleteMany", ctx)) return;
+				await guardDeleteMany(ctx);
+			});
 			repo.on("before:bulkUpsert", async (ctx) => {
 				if (ctx[internalFlag]) return;
 				const filters = (ctx.operations ?? []).flatMap((op) => op.updateOne?.filter ? [op.updateOne.filter] : []);
@@ -881,8 +940,10 @@ function immutableStatesPlugin(options) {
 		}
 	};
 }
-//#endregion
-//#region src/plugins/lease.plugin.ts
+// src/plugins/lease.plugin.ts
+function isNonEmpty(obj) {
+	return obj !== void 0 && obj !== null && Object.keys(obj).length > 0;
+}
 function leasePlugin(options = {}) {
 	const statusField = options.statusField ?? "status";
 	const leasedByField = options.leasedByField ?? "leasedBy";
@@ -891,6 +952,57 @@ function leasePlugin(options = {}) {
 	const processingStatus = options.processingStatus ?? "processing";
 	const doneStatus = options.doneStatus ?? "done";
 	const sort = options.sort ?? { createdAt: 1 };
+	const nowFn = options.nowFn ?? (() => /* @__PURE__ */ new Date());
+	const deadLeaseStatuses = options.deadLeaseStatuses ?? [processingStatus];
+	const attemptsField = options.attemptsField;
+	const maxAttempts = options.maxAttempts;
+	if (deadLeaseStatuses.length === 0) throw new Error("leasePlugin: deadLeaseStatuses must name at least one status");
+	if (maxAttempts !== void 0) {
+		if (attemptsField === void 0) throw new Error("leasePlugin: maxAttempts requires attemptsField");
+		if (!Number.isInteger(maxAttempts) || maxAttempts < 1) throw new Error("leasePlugin: maxAttempts must be a positive integer");
+	}
+	const exhaustedStatus = options.exhaustedStatus;
+	const exhaustedAtField = options.exhaustedAtField;
+	const assertTerminal = (where, status) => {
+		if (status === pendingStatus || status === processingStatus || deadLeaseStatuses.includes(status)) throw new Error(`leasePlugin: ${where} "${status}" must differ from the pending, processing and dead-lease statuses`);
+	};
+	if (exhaustedStatus !== void 0) {
+		if (maxAttempts === void 0) throw new Error("leasePlugin: exhaustedStatus requires maxAttempts");
+		assertTerminal("exhaustedStatus", exhaustedStatus);
+	}
+	if (exhaustedAtField !== void 0 && maxAttempts === void 0) throw new Error("leasePlugin: exhaustedAtField requires maxAttempts");
+	/**
+	* The claim condition: pending (narrowed by `pendingFilter`) OR a dead
+	* lease, a row still in a dead-lease status whose `leaseExpiresAt <
+	* now` (worker crashed mid-lease). The status guard on the dead arm
+	* keeps a cancelled / terminal row with a stale expiry from being
+	* revived. `lease()` adds "under the attempts cap"; `reapExhausted()`
+	* adds "at or over it".
+	*/
+	const claimable = (now, pendingSource) => {
+		const pendingFilter = typeof pendingSource === "function" ? pendingSource(now) : pendingSource;
+		return { $or: [isNonEmpty(pendingFilter) ? { $and: [{ [statusField]: pendingStatus }, pendingFilter] } : { [statusField]: pendingStatus }, {
+			[statusField]: deadLeaseStatuses.length === 1 ? deadLeaseStatuses[0] : { $in: deadLeaseStatuses },
+			[leaseExpiresAtField]: { $lt: now }
+		}] };
+	};
+	/** The caller's filter as given, with `conditions` ANDed beside it. */
+	const withConditions = (method, baseFilter, conditions) => {
+		if (baseFilter.$and !== void 0 && !Array.isArray(baseFilter.$and)) throw createError(400, `leasePlugin.${method}: filter.$and must be an array`);
+		const callerAnd = baseFilter.$and ?? [];
+		return {
+			...baseFilter,
+			$and: [...callerAnd, ...conditions]
+		};
+	};
+	const resolveNow = (method, perCall) => {
+		const now = perCall ?? nowFn();
+		if (!(now instanceof Date) || Number.isNaN(now.getTime())) throw createError(400, `leasePlugin.${method}: now must be a valid Date`);
+		return now;
+	};
+	const assertLeasedBy = (method, leasedBy) => {
+		if (typeof leasedBy !== "string" || leasedBy.length === 0) throw createError(400, `leasePlugin.${method}: leasedBy must be a non-empty string`);
+	};
 	return {
 		name: "lease",
 		apply(repo) {
@@ -904,18 +1016,20 @@ function leasePlugin(options = {}) {
 			*/
 			repo.registerMethod("lease", async function(opts) {
 				if (typeof opts?.leaseFor !== "number" || opts.leaseFor <= 0) throw createError(400, "leasePlugin.lease: leaseFor must be a positive number (ms)");
-				if (typeof opts.leasedBy !== "string" || opts.leasedBy.length === 0) throw createError(400, "leasePlugin.lease: leasedBy must be a non-empty string");
-				const now = /* @__PURE__ */ new Date();
+				assertLeasedBy("lease", opts.leasedBy);
+				const now = resolveNow("lease", opts.now);
 				const leaseUntil = new Date(now.getTime() + opts.leaseFor);
-				const claimFilter = {
-					...opts.filter ?? {},
-					$or: [{ [statusField]: pendingStatus }, { [leaseExpiresAtField]: { $lt: now } }]
-				};
-				return this.findOneAndUpdate(claimFilter, { $set: {
-					[statusField]: processingStatus,
-					[leasedByField]: opts.leasedBy,
-					[leaseExpiresAtField]: leaseUntil
-				} }, {
+				const conditions = [claimable(now, opts.pendingFilter ?? options.pendingFilter)];
+				if (attemptsField !== void 0 && maxAttempts !== void 0) conditions.push({ [attemptsField]: { $not: { $gte: maxAttempts } } });
+				const claimFilter = withConditions("lease", opts.filter ?? {}, conditions);
+				return this.findOneAndUpdate(claimFilter, {
+					$set: {
+						[statusField]: processingStatus,
+						[leasedByField]: opts.leasedBy,
+						[leaseExpiresAtField]: leaseUntil
+					},
+					...attemptsField !== void 0 ? { $inc: { [attemptsField]: 1 } } : {}
+				}, {
 					...opts.options ?? {},
 					sort,
 					returnDocument: "after"
@@ -923,11 +1037,13 @@ function leasePlugin(options = {}) {
 			});
 			repo.registerMethod("extend", async function(id, opts) {
 				if (typeof opts?.leaseFor !== "number" || opts.leaseFor <= 0) throw createError(400, "leasePlugin.extend: leaseFor must be a positive number (ms)");
-				const now = /* @__PURE__ */ new Date();
+				assertLeasedBy("extend", opts.leasedBy);
+				const now = resolveNow("extend", opts.now);
 				const leaseUntil = new Date(now.getTime() + opts.leaseFor);
 				const idField = this.idField || "_id";
 				return this.findOneAndUpdate({
 					[idField]: id,
+					[statusField]: processingStatus,
 					[leasedByField]: opts.leasedBy,
 					[leaseExpiresAtField]: { $gt: now }
 				}, { $set: { [leaseExpiresAtField]: leaseUntil } }, {
@@ -938,10 +1054,11 @@ function leasePlugin(options = {}) {
 			repo.registerMethod("release", async function(id, opts) {
 				if (typeof opts?.leasedBy !== "string" || opts.leasedBy.length === 0) throw createError(400, "leasePlugin.release: leasedBy must be a non-empty string (the holder finalising the lease)");
 				const finalStatus = opts.finalStatus ?? doneStatus;
-				const now = /* @__PURE__ */ new Date();
+				const now = resolveNow("release", opts.now);
 				const idField = this.idField || "_id";
 				return this.findOneAndUpdate({
 					[idField]: id,
+					[statusField]: processingStatus,
 					[leasedByField]: opts.leasedBy,
 					[leaseExpiresAtField]: { $gt: now }
 				}, {
@@ -955,11 +1072,52 @@ function leasePlugin(options = {}) {
 					returnDocument: "after"
 				});
 			});
+			repo.registerMethod("reapExhausted", async function(opts = {}) {
+				if (attemptsField === void 0 || maxAttempts === void 0) throw createError(400, "leasePlugin.reapExhausted: requires maxAttempts");
+				const status = opts.status ?? exhaustedStatus;
+				if (typeof status !== "string" || status.length === 0) throw createError(400, "leasePlugin.reapExhausted: pass a status, or configure exhaustedStatus");
+				if (opts.status !== void 0) try {
+					assertTerminal("reapExhausted status", status);
+				} catch (err) {
+					throw createError(400, err.message);
+				}
+				const limit = opts.limit ?? 100;
+				if (!Number.isInteger(limit) || limit < 1) throw createError(400, "leasePlugin.reapExhausted: limit must be a positive integer");
+				const now = resolveNow("reapExhausted", opts.now);
+				const exhausted = withConditions("reapExhausted", opts.filter ?? {}, [claimable(now, opts.pendingFilter ?? options.pendingFilter), { [attemptsField]: { $gte: maxAttempts } }]);
+				const idField = this.idField || "_id";
+				const candidates = await this.findAll.call(this, exhausted, {
+					...opts.options ?? {},
+					sort,
+					limit,
+					lean: true
+				});
+				const reaped = [];
+				for (const row of candidates) {
+					const moved = await this.findOneAndUpdate({
+						...exhausted,
+						[idField]: row[idField]
+					}, {
+						$set: {
+							[statusField]: status,
+							...exhaustedAtField !== void 0 ? { [exhaustedAtField]: now } : {}
+						},
+						$unset: {
+							[leasedByField]: "",
+							[leaseExpiresAtField]: ""
+						}
+					}, {
+						...opts.options ?? {},
+						returnDocument: "after"
+					});
+					if (moved) reaped.push(moved);
+				}
+				return reaped;
+			});
 		}
 	};
 }
-//#endregion
-//#region src/plugins/mongo-operations.plugin.ts
+// src/plugins/mongo-operations.plugin.ts
 /**
 * MongoDB Operations Plugin
 *
@@ -1196,8 +1354,7 @@ function mongoOperationsPlugin() {
 		}
 	};
 }
-//#endregion
-//#region src/plugins/names.ts
+// src/plugins/names.ts
 /**
 * Canonical identifiers exposed by mongokit's bundled plugins.
 *
@@ -1229,8 +1386,7 @@ const MONGOKIT_PLUGIN_NAMES = {
 	timestamp: "timestamp",
 	validationChain: "validation-chain"
 };
-//#endregion
-//#region src/plugins/observability.plugin.ts
+// src/plugins/observability.plugin.ts
 /**
 * Observability Plugin
 *
@@ -1305,8 +1461,7 @@ function observabilityPlugin(options) {
 		}
 	};
 }
-//#endregion
-//#region src/plugins/subdocument.plugin.ts
+// src/plugins/subdocument.plugin.ts
 /**
 * Subdocument plugin for managing nested arrays
 *
@@ -1375,8 +1530,7 @@ function subdocumentPlugin() {
 		}
 	};
 }
-//#endregion
-//#region src/plugins/tenant-context.ts
+// src/plugins/tenant-context.ts
 /**
 * Request-scoped tenant context via AsyncLocalStorage.
 *
@@ -1426,8 +1580,7 @@ function createTenantContext() {
 		}
 	};
 }
-//#endregion
-//#region src/plugins/validation-chain.plugin.ts
+// src/plugins/validation-chain.plugin.ts
 /**
 * Validation chain plugin
 *
@@ -1576,5 +1729,4 @@ function uniqueField(field, errorMessage) {
 		}
 	};
 }
-//#endregion
 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, idempotencyStorePlugin 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, appendOnlyPlugin as v, aggregateHelpersPlugin as y };

package/llms.txt

@@ -0,0 +1,33 @@
+# @classytic/mongokit
+
+Mongoose 9 repositories implementing repo-core StandardRepo. Skill: skills/mongokit/SKILL.md. Peers: @classytic/repo-core, mongoose.
+
+| Need | Use |
+|---|---|
+| Register a model once, safely | `defineModel`, `defineModels` |
+| Repository with tenant, soft delete, timestamps, cache, audit | `createRepository` |
+| List page (offset or keyset) | `repo.getAll({ mode, page, after, sort })`, rows in `data` |
+| HTTP query string to repo params | `QueryParser` |
+| Status change with history and race diagnosis | `repo.applyTransition` with a `TransitionMachine` |
+| Optimistic lock | `repo.claimVersion` |
+| Atomic multi-write | `withTransaction`, `batchTransaction` |
+| Duplicate key error | `isDuplicateKeyError` |
+| Search as you type | `searchMode: 'prefix'`, `searchKeysPath`, `rebuildSearchKeys` |
+| Outbox table | `createOutboxRepository` from `@classytic/mongokit/outbox` |
+| Idempotency claims | `createIdempotencyStore` from `@classytic/mongokit/idempotency` |
+| Cross-process lock | `createMongoLockAdapter` from `@classytic/mongokit/lock` |
+| Once-per-day job ledger for the arc daily gate | `createMongoDailyLedger` from `@classytic/mongokit/lock` |
+| Atomic counter in your own collection | `createSequenceCounter` |
+| Counter that resets per civil year in a time zone | `getNextPeriodSequence` |
+| Worker lease with clock and attempts cap | `leasePlugin` |
+| Check declared vs built indexes | `verifyIndexes` from `@classytic/mongokit/indexes` |
+| Tenant-led indexes on a schema | `injectTenantField` from `@classytic/mongokit/tenant` |
+| Query timeout, read concern, profiler comment | `configureQueryDefaults` |
+| Drop the per-page count | `configurePaginationDefaults` |
+| Tenant bypass for jobs | `systemContext` |
+| Forward request scope | `repoOptionsFromCtx` |
+| arc adapter | `createMongooseAdapter` from `@classytic/mongokit/adapter` |
+| Test database | `createTestRepository` from `@classytic/mongokit/testkit` |
+
+Read first: SKILL.md. Details: references/repository-api.md, pagination-search.md, plugins-tenancy.md, transactions-outbox.md.
+Envelope and error types: skill repo-core.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.43.0",
+  "version": "3.44.0",
   "description": "Production-grade MongoDB repositories - smart pagination, events, and plugins. Built on @classytic/repo-core.",
   "type": "module",
   "sideEffects": false,
@@ -105,7 +105,9 @@
     "dist",
     "README.md",
     "LICENSE",
-    "TRADEMARK.md"
+    "TRADEMARK.md",
+    "llms.txt",
+    "skills/**/*.md"
   ],
   "keywords": [
     "mongodb",
@@ -150,9 +152,9 @@
   },
   "homepage": "https://github.com/classytic/mongokit#readme",
   "peerDependencies": {
-    "@classytic/repo-core": ">=0.31.0",
-    "mongodb-memory-server": ">=10.4.3",
-    "mongoose": ">=9.11.0"
+    "@classytic/repo-core": ">=0.37.0",
+    "mongodb-memory-server": ">=11.3.0",
+    "mongoose": ">=9.11.4"
   },
   "peerDependenciesMeta": {
     "mongodb-memory-server": {
@@ -185,7 +187,7 @@
     "check": "biome ci src/ --diagnostic-level=error",
     "check:dead-code": "knip",
     "check:peer-skew": "node scripts/check-peer-skew.mjs",
-    "ci": "npm run check:peer-skew && npm run check && npm run typecheck && npm run typecheck:tests && npm run build && npm run lint:package && npm run check:dead-code && npm run check:forgotten-exports && npm test",
+    "ci": "npm run check:peer-skew && npm run check && npm run typecheck && npm run typecheck:tests && npm run build && npm run lint:package && npm run check:dead-code && npm run check:forgotten-exports && npm run check:skills && npm test",
     "push": "classytic-push",
     "prepublishOnly": "npm run ci",
     "publish:dry": "npm publish --dry-run --access public",
@@ -195,29 +197,31 @@
     "release:patch": "npm version patch && npm run release",
     "release:minor": "npm version minor && npm run release",
     "release:major": "npm version major && npm run release",
-    "check:forgotten-exports": "node scripts/check-forgotten-exports.mjs"
+    "check:forgotten-exports": "node scripts/check-forgotten-exports.mjs",
+    "check:skills": "node scripts/check-skills.mjs"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
-    "@better-auth/api-key": "^1.6.29",
-    "@better-auth/mongo-adapter": "^1.6.29",
-    "@biomejs/biome": "^2.5.8",
-    "@classytic/dev-tools": "^0.2.0",
-    "@classytic/repo-core": "^0.31.1",
-    "@types/node": "^26.2.0",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@better-auth/api-key": "^1.7.15",
+    "@better-auth/mongo-adapter": "^1.7.15",
+    "@biomejs/biome": "^2.6.4",
+    "@classytic/dev-tools": "^0.2.1",
+    "@classytic/repo-core": "^0.37.0",
+    "@types/node": "^26.6.6",
+    "@vitest/coverage-v8": "^5.1.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
-    "better-auth": "^1.6.29",
-    "dotenv": "^17.4.2",
-    "fast-check": "^4.7.0",
-    "knip": "^6.32.2",
-    "mongodb": "^7.5.0",
-    "mongodb-memory-server": "^11.2.0",
-    "mongoose": "^9.11.1",
-    "publint": "^0.3.23",
-    "tsdown": "^0.22.14",
-    "typescript": "~5.9.3",
-    "vitest": "^4.1.10"
+    "better-auth": "^1.7.15",
+    "dotenv": "^18.0.9",
+    "fast-check": "^4.10.2",
+    "knip": "^6.44.1",
+    "mongodb": "~7.7.0",
+    "mongodb-memory-server": "^11.3.0",
+    "mongoose": "^9.11.4",
+    "publint": "^0.3.25",
+    "ts-api": "npm:typescript@~5.9.3",
+    "tsdown": "^0.23.4",
+    "typescript": "~7.0.2",
+    "vitest": "^5.1.0"
   }
 }