@classytic/mongokit 3.28.0 → 3.30.0

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

@@ -1,5 +1,5 @@
-import { c as ALL_OPERATIONS, u as OP_REGISTRY } from "./Repository-BFBTAMlA.mjs";
-import { _ as upsert } from "./update-1Lq9OMD2.mjs";
+import { c as ALL_OPERATIONS, u as OP_REGISTRY } from "./Repository-X7U2d0kU.mjs";
+import { _ as upsert } from "./update-DHdXdOk_.mjs";
 import { n as warn } from "./logger-K7dPmu2U.mjs";
 import { t as createError } from "./error-BuByZwKU.mjs";
 import { r as getFieldsForUser } from "./field-selection-FSQFLpsU.mjs";
@@ -463,7 +463,8 @@ function fieldFilterPlugin(fieldPreset) {
 		apply(repo) {
 			const applyFieldFiltering = (context) => {
 				if (!fieldPreset) return;
-				const presetSelect = getFieldsForUser(context.context?.user || context.user, fieldPreset).join(" ");
+				const user = context.context?.user || context.user;
+				const presetSelect = getFieldsForUser(user, fieldPreset).join(" ");
 				if (context.select) context.select = `${presetSelect} ${context.select}`;
 				else context.select = presetSelect;
 			};
@@ -476,140 +477,6 @@ function fieldFilterPlugin(fieldPreset) {
 	};
 }
 //#endregion
-//#region src/plugins/immutable-states.plugin.ts
-/** Ops this plugin has an explicit strategy for (see module doc). */
-const STRATEGY_OPS = /* @__PURE__ */ new Set([
-	"create",
-	"createMany",
-	"update",
-	"delete",
-	"claimVersion",
-	"restore",
-	"findOneAndUpdate",
-	"updateMany",
-	"deleteMany",
-	"bulkWrite",
-	"claim"
-]);
-function immutableStatesPlugin(options) {
-	const field = options.field ?? "state";
-	const internalFlag = options.internalFlag ?? "_immutableInternal";
-	const frozen = new Set(options.states);
-	const throwViolation = (ctx) => {
-		if (options.errorFactory) throw options.errorFactory(ctx);
-		throw createError(403, `Document ${String(ctx.id)} is in immutable state${ctx.state !== void 0 ? ` '${ctx.state}'` : ""} — '${ctx.operation}' is not permitted. Frozen rows change only through the owning engine's transition verbs.`, {
-			code: "IMMUTABLE_STATE_VIOLATION",
-			meta: { ...ctx }
-		});
-	};
-	return {
-		name: "immutableStates",
-		apply(repo) {
-			const unhandled = Object.entries(OP_REGISTRY).filter(([op, meta]) => meta.mutates && !STRATEGY_OPS.has(op)).map(([op]) => op);
-			if (unhandled.length > 0) throw createError(500, `immutableStatesPlugin has no strategy for mutating op(s): ${unhandled.join(", ")}. Mongokit added write ops this plugin predates — extend the plugin before using it.`, {
-				code: "IMMUTABLE_STATES_UNHANDLED_OPS",
-				meta: { unhandled }
-			});
-			const Model = repo.Model;
-			const getState = (doc) => field.split(".").reduce((acc, key) => acc?.[key], doc);
-			const scoped = (base, ctx) => {
-				const q = { ...base };
-				if (options.tenantField && ctx.query && options.tenantField in ctx.query) q[options.tenantField] = ctx.query[options.tenantField];
-				return q;
-			};
-			/** 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();
-				return doc ? getState(doc) : void 0;
-			};
-			const guardById = (op) => async (ctx) => {
-				if (ctx[internalFlag]) return;
-				const state = await readStateById(ctx);
-				if (state !== void 0 && frozen.has(state)) throwViolation({
-					id: ctx.id,
-					operation: op,
-					state
-				});
-			};
-			for (const op of [
-				"update",
-				"delete",
-				"claimVersion",
-				"restore"
-			]) repo.on(`before:${op}`, guardById(op));
-			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();
-				if (!doc) return;
-				const state = getState(doc);
-				if (state !== void 0 && frozen.has(state)) throwViolation({
-					id: doc._id,
-					operation: "findOneAndUpdate",
-					state
-				});
-			});
-			const guardMany = (op) => async (ctx) => {
-				if (ctx[internalFlag]) return;
-				const filter = ctx.query ?? {};
-				const hit = await Model.exists({ $and: [filter, { [field]: { $in: [...frozen] } }] });
-				if (hit) throwViolation({
-					id: hit._id,
-					operation: op,
-					state: void 0
-				});
-			};
-			repo.on("before:updateMany", guardMany("updateMany"));
-			repo.on("before:deleteMany", guardMany("deleteMany"));
-			repo.on("before:bulkWrite", (ctx) => {
-				if (ctx[internalFlag]) return;
-				throwViolation({
-					id: void 0,
-					operation: "bulkWrite",
-					state: void 0
-				});
-			});
-			repo.on("before:claim", async (rawCtx) => {
-				const ctx = rawCtx;
-				if (ctx[internalFlag]) return;
-				const t = ctx.transition;
-				if (!t) return;
-				if ((t.field ?? "status") === field) {
-					const fromSpec = t.from;
-					if (!(Array.isArray(fromSpec) ? fromSpec.some((f) => frozen.has(String(f))) : frozen.has(String(fromSpec)))) return;
-					if (options.allowClaim?.({
-						id: ctx.id,
-						transition: t,
-						data: ctx.data
-					})) return;
-					throwViolation({
-						id: ctx.id,
-						operation: "claim",
-						state: void 0
-					});
-				}
-				const state = await readStateById(ctx);
-				if (state !== void 0 && frozen.has(state)) {
-					if (options.allowClaim?.({
-						id: ctx.id,
-						transition: t,
-						data: ctx.data
-					})) return;
-					throwViolation({
-						id: ctx.id,
-						operation: "claim",
-						state
-					});
-				}
-			});
-		}
-	};
-}
-//#endregion
 //#region src/plugins/idempotency-store.plugin.ts
 function randomToken() {
 	const bytes = /* @__PURE__ */ new Uint8Array(16);
@@ -757,6 +624,140 @@ function idempotencyStorePlugin(options = {}) {
 	};
 }
 //#endregion
+//#region src/plugins/immutable-states.plugin.ts
+/** Ops this plugin has an explicit strategy for (see module doc). */
+const STRATEGY_OPS = /* @__PURE__ */ new Set([
+	"create",
+	"createMany",
+	"update",
+	"delete",
+	"claimVersion",
+	"restore",
+	"findOneAndUpdate",
+	"updateMany",
+	"deleteMany",
+	"bulkWrite",
+	"claim"
+]);
+function immutableStatesPlugin(options) {
+	const field = options.field ?? "state";
+	const internalFlag = options.internalFlag ?? "_immutableInternal";
+	const frozen = new Set(options.states);
+	const throwViolation = (ctx) => {
+		if (options.errorFactory) throw options.errorFactory(ctx);
+		throw createError(403, `Document ${String(ctx.id)} is in immutable state${ctx.state !== void 0 ? ` '${ctx.state}'` : ""} — '${ctx.operation}' is not permitted. Frozen rows change only through the owning engine's transition verbs.`, {
+			code: "IMMUTABLE_STATE_VIOLATION",
+			meta: { ...ctx }
+		});
+	};
+	return {
+		name: "immutableStates",
+		apply(repo) {
+			const unhandled = Object.entries(OP_REGISTRY).filter(([op, meta]) => meta.mutates && !STRATEGY_OPS.has(op)).map(([op]) => op);
+			if (unhandled.length > 0) throw createError(500, `immutableStatesPlugin has no strategy for mutating op(s): ${unhandled.join(", ")}. Mongokit added write ops this plugin predates — extend the plugin before using it.`, {
+				code: "IMMUTABLE_STATES_UNHANDLED_OPS",
+				meta: { unhandled }
+			});
+			const Model = repo.Model;
+			const getState = (doc) => field.split(".").reduce((acc, key) => acc?.[key], doc);
+			const scoped = (base, ctx) => {
+				const q = { ...base };
+				if (options.tenantField && ctx.query && options.tenantField in ctx.query) q[options.tenantField] = ctx.query[options.tenantField];
+				return q;
+			};
+			/** 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();
+				return doc ? getState(doc) : void 0;
+			};
+			const guardById = (op) => async (ctx) => {
+				if (ctx[internalFlag]) return;
+				const state = await readStateById(ctx);
+				if (state !== void 0 && frozen.has(state)) throwViolation({
+					id: ctx.id,
+					operation: op,
+					state
+				});
+			};
+			for (const op of [
+				"update",
+				"delete",
+				"claimVersion",
+				"restore"
+			]) repo.on(`before:${op}`, guardById(op));
+			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();
+				if (!doc) return;
+				const state = getState(doc);
+				if (state !== void 0 && frozen.has(state)) throwViolation({
+					id: doc._id,
+					operation: "findOneAndUpdate",
+					state
+				});
+			});
+			const guardMany = (op) => async (ctx) => {
+				if (ctx[internalFlag]) return;
+				const filter = ctx.query ?? {};
+				const hit = await Model.exists({ $and: [filter, { [field]: { $in: [...frozen] } }] });
+				if (hit) throwViolation({
+					id: hit._id,
+					operation: op,
+					state: void 0
+				});
+			};
+			repo.on("before:updateMany", guardMany("updateMany"));
+			repo.on("before:deleteMany", guardMany("deleteMany"));
+			repo.on("before:bulkWrite", (ctx) => {
+				if (ctx[internalFlag]) return;
+				throwViolation({
+					id: void 0,
+					operation: "bulkWrite",
+					state: void 0
+				});
+			});
+			repo.on("before:claim", async (rawCtx) => {
+				const ctx = rawCtx;
+				if (ctx[internalFlag]) return;
+				const t = ctx.transition;
+				if (!t) return;
+				if ((t.field ?? "status") === field) {
+					const fromSpec = t.from;
+					if (!(Array.isArray(fromSpec) ? fromSpec.some((f) => frozen.has(String(f))) : frozen.has(String(fromSpec)))) return;
+					if (options.allowClaim?.({
+						id: ctx.id,
+						transition: t,
+						data: ctx.data
+					})) return;
+					throwViolation({
+						id: ctx.id,
+						operation: "claim",
+						state: void 0
+					});
+				}
+				const state = await readStateById(ctx);
+				if (state !== void 0 && frozen.has(state)) {
+					if (options.allowClaim?.({
+						id: ctx.id,
+						transition: t,
+						data: ctx.data
+					})) return;
+					throwViolation({
+						id: ctx.id,
+						operation: "claim",
+						state
+					});
+				}
+			});
+		}
+	};
+}
+//#endregion
 //#region src/plugins/lease.plugin.ts
 function leasePlugin(options = {}) {
 	const statusField = options.statusField ?? "status";
@@ -1451,4 +1452,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, 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 };
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.28.0",
+  "version": "3.30.0",
   "description": "Production-grade MongoDB repositories - smart pagination, events, and plugins. Built on @classytic/repo-core.",
   "type": "module",
   "sideEffects": false,
@@ -40,6 +40,10 @@
       "types": "./dist/better-auth/index.d.mts",
       "default": "./dist/better-auth/index.mjs"
     },
+    "./outbox": {
+      "types": "./dist/outbox/index.d.mts",
+      "default": "./dist/outbox/index.mjs"
+    },
     "./lock": {
       "types": "./dist/lock/index.d.mts",
       "default": "./dist/lock/index.mjs"
@@ -63,12 +67,17 @@
     "./testkit": {
       "types": "./dist/testkit/index.d.mts",
       "default": "./dist/testkit/index.mjs"
+    },
+    "./kernel-conformance": {
+      "types": "./dist/kernel-conformance/index.d.mts",
+      "default": "./dist/kernel-conformance/index.mjs"
     }
   },
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "TRADEMARK.md"
   ],
   "keywords": [
     "mongodb",
@@ -113,9 +122,15 @@
   },
   "homepage": "https://github.com/classytic/mongokit#readme",
   "peerDependencies": {
-    "@classytic/repo-core": ">=0.17.0",
+    "@classytic/repo-core": ">=0.20.0",
+    "mongodb-memory-server": ">=10.4.3",
     "mongoose": ">=9.4.1"
   },
+  "peerDependenciesMeta": {
+    "mongodb-memory-server": {
+      "optional": true
+    }
+  },
   "engines": {
     "node": ">=22"
   },
@@ -136,11 +151,12 @@
     "typecheck:tests": "tsc --noEmit -p tsconfig.tests.json",
     "lint": "biome check src/",
     "lint:fix": "biome check src/ --write",
-    "lint:package": "publint && attw --pack . --profile esm-only",
+    "check:exports": "node scripts/check-exports.mjs",
+    "lint:package": "npm run check:exports && publint && attw --pack . --profile esm-only",
     "format": "biome format src/ --write",
     "check": "biome ci src/ --diagnostic-level=error",
     "check:dead-code": "knip",
-    "ci": "npm run check && npm run typecheck && npm run typecheck:tests && npm run build && npm run lint:package && npm run check:dead-code && npm test",
+    "ci": "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",
     "push": "classytic-push",
     "prepublishOnly": "npm run ci",
     "publish:dry": "npm publish --dry-run --access public",
@@ -149,7 +165,8 @@
     "release": "npm run push -- main && npm run release:tag && npm publish --access public",
     "release:patch": "npm version patch && npm run release",
     "release:minor": "npm version minor && npm run release",
-    "release:major": "npm version major && npm run release"
+    "release:major": "npm version major && npm run release",
+    "check:forgotten-exports": "node scripts/check-forgotten-exports.mjs"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
@@ -157,24 +174,20 @@
     "@better-auth/mongo-adapter": "^1.6.22",
     "@biomejs/biome": "^2.4.10",
     "@classytic/dev-tools": "^0.2.0",
-    "@classytic/repo-core": "^0.17.0",
+    "@classytic/repo-core": "^0.20.0",
     "@types/node": "^22.0.0",
     "@vitest/coverage-v8": "^4.1.4",
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
     "better-auth": "^1.6.23",
     "dotenv": "^17.4.2",
-    "knip": "^6.3.0",
-    "mongodb": "7.2.0",
+    "knip": "^6.31.0",
+    "mongodb": "^7.5.0",
     "mongodb-memory-server": "^10.4.3",
-    "mongoose": "^9.4.1",
+    "mongoose": "^9.9.1",
     "publint": "^0.3.18",
-    "tsdown": "^0.22.5",
+    "tsdown": "^0.22.14",
     "typescript": "~5.9.0",
     "vitest": "^4.1.4"
-  },
-  "overrides": {
-    "mongodb": "7.2.0",
-    "bson": "7.2.0"
   }
 }