@classytic/mongokit 3.38.1 → 3.40.0

package/dist/{timestamp.plugin-CBQukQzV.mjs → timestamp.plugin-DF0gJB6p.mjs}

@@ -1,4 +1,4 @@
-import { c as ALL_OPERATIONS, t as HOOK_PRIORITY, u as OP_REGISTRY } from "./Repository-Ck5x43wF.mjs";
+import { i as ALL_OPERATIONS, o as OP_REGISTRY, t as HOOK_PRIORITY } from "./Repository-BMgPSkqZ.mjs";
 import { n as warn } from "./logger-K7dPmu2U.mjs";
 import { throwIfAborted, withRetry } from "@classytic/repo-core/repository";
 import mongoose from "mongoose";
@@ -754,6 +754,33 @@ async function getNextSequence(counterKey, increment = 1, connection, session) {
 	return result.seq;
 }
 /**
+* Current value of a counter, or `null` when it has never been created.
+* `null` and `0` differ: only a missing counter needs seeding.
+*/
+async function readSequence(counterKey, connection) {
+	const doc = await getCounterModel(connection).findById(counterKey).lean();
+	return doc ? doc.seq : null;
+}
+/**
+* Raise a counter to at least `floor` — never lowers it. Atomic (`$max` +
+* upsert), so concurrent seeders converge on the highest floor.
+*
+* Use before a counter's first increment when ids were already issued under
+* another key (e.g. moving from a global to a per-tenant sequence); otherwise
+* the new counter restarts at 1 and re-issues taken ids.
+*
+* @returns The counter's value after the raise.
+*/
+async function ensureSequenceAtLeast(counterKey, floor, connection) {
+	if (!Number.isSafeInteger(floor) || floor < 0) throw new Error(`ensureSequenceAtLeast: floor must be a non-negative integer, got ${floor}`);
+	const result = await getCounterModel(connection).findOneAndUpdate({ _id: counterKey }, { $max: { seq: floor } }, {
+		upsert: true,
+		returnDocument: "after"
+	});
+	if (!result) throw new Error(`Failed to seed counter '${counterKey}'`);
+	return result.seq;
+}
+/**
 * Generator: Simple sequential counter.
 * Produces IDs like `INV-0001`, `INV-0002`, etc.
 *
@@ -795,30 +822,53 @@ function sequentialId(options) {
 *   }),
 * })
 * ```
+*
+* @example Per-tenant numbering in a shared database
+* ```typescript
+* customIdPlugin({
+*   field: 'orderNumber',
+*   generator: dateSequentialId({ prefix: 'ORD', model: OrderModel, scope: 'tenant' }),
+* })
+* // org-a: ORD-2026-02-0001, ORD-2026-02-0002 …   org-b: ORD-2026-02-0001 …
+* ```
 */
 function dateSequentialId(options) {
-	const { prefix, model, partition = "monthly", padding = 4, separator = "-" } = options;
+	const { prefix, model, partition = "monthly", padding = 4, separator = "-", scope = "global", tenantKey = "organizationId", timezone = "local" } = options;
+	/** Per-generator, not module-level — two generators warn independently. */
+	const overflowWarned = /* @__PURE__ */ new Set();
+	const paddingCeiling = 10 ** padding;
 	return async (context) => {
 		const now = /* @__PURE__ */ new Date();
-		const year = String(now.getFullYear());
-		const month = String(now.getMonth() + 1).padStart(2, "0");
-		const day = String(now.getDate()).padStart(2, "0");
+		const utc = timezone === "utc";
+		const year = String(utc ? now.getUTCFullYear() : now.getFullYear());
+		const month = String((utc ? now.getUTCMonth() : now.getMonth()) + 1).padStart(2, "0");
+		const day = String(utc ? now.getUTCDate() : now.getDate()).padStart(2, "0");
+		let keyBase = model.modelName;
+		if (scope === "tenant") {
+			const tenantId = context[tenantKey];
+			if (tenantId === void 0 || tenantId === null || tenantId === "") throw new Error(`[mongokit] dateSequentialId: scope 'tenant' requires '${tenantKey}' in context for '${model.modelName}' create, but none was provided. Pass it per call (repo.create(data, { ${tenantKey}: '<id>' })) or resolve it ambiently; the generator never falls back to the global counter.`);
+			keyBase = `${model.modelName}:${String(tenantId)}`;
+		}
 		let datePart;
 		let counterKey;
 		switch (partition) {
 			case "yearly":
 				datePart = year;
-				counterKey = `${model.modelName}:${year}`;
+				counterKey = `${keyBase}:${year}`;
 				break;
 			case "daily":
 				datePart = `${year}${separator}${month}${separator}${day}`;
-				counterKey = `${model.modelName}:${year}-${month}-${day}`;
+				counterKey = `${keyBase}:${year}-${month}-${day}`;
 				break;
 			default:
 				datePart = `${year}${separator}${month}`;
-				counterKey = `${model.modelName}:${year}-${month}`;
+				counterKey = `${keyBase}:${year}-${month}`;
 		}
 		const seq = await getNextSequence(counterKey, 1, context._counterConnection, context.session);
+		if (seq >= paddingCeiling && !overflowWarned.has(counterKey)) {
+			overflowWarned.add(counterKey);
+			warn(`[mongokit] dateSequentialId: '${model.modelName}' sequence ${seq} exceeds padding ${padding} (max ${paddingCeiling - 1}) for period '${counterKey}'. Ids remain unique but no longer sort lexically — raise \`padding\` for new periods, or use a finer \`partition\`.`);
+		}
 		return `${prefix}${separator}${datePart}${separator}${String(seq).padStart(padding, "0")}`;
 	};
 }
@@ -907,6 +957,62 @@ function customIdPlugin(options) {
 	};
 }
 //#endregion
+//#region src/utils/scope.ts
+/** Tenant context keys forwarded even when no tenant plugin declared one. */
+const CONVENTIONAL_TENANT_KEYS = ["organizationId", "tenantId"];
+const ATTRIBUTION_KEYS = [
+	"session",
+	"user",
+	"userId",
+	"requestId"
+];
+/** Where a repository records the tenant context keys its plugins read. */
+const TENANT_KEYS = Symbol.for("@classytic/mongokit/tenant-context-keys");
+/**
+* Record that `repo` resolves its tenant from `contextKey`. Called by
+* `multiTenantPlugin` at bind, so forwarding knows a custom key (`branchId`)
+* without the host restating it.
+*/
+function declareTenantContextKey(repo, contextKey) {
+	const holder = repo;
+	if (!holder[TENANT_KEYS]) Object.defineProperty(holder, TENANT_KEYS, {
+		value: /* @__PURE__ */ new Set(),
+		enumerable: false
+	});
+	holder[TENANT_KEYS]?.add(contextKey);
+}
+/** Every tenant context key relevant to a call spanning these repositories. */
+function tenantContextKeysOf(...repos) {
+	const keys = new Set(CONVENTIONAL_TENANT_KEYS);
+	for (const repo of repos) for (const key of repo?.[TENANT_KEYS] ?? []) keys.add(key);
+	return [...keys];
+}
+/**
+* The scope to hand a second repository call made on behalf of `source`
+* (a hook's `RepositoryContext`, or a host's request context).
+*
+* Absent values are omitted, never written as `undefined`, so spreading the
+* result into an options bag cannot erase a value set there.
+*/
+function forwardScope(source, tenantKeys = CONVENTIONAL_TENANT_KEYS) {
+	if (!source) return {};
+	const out = {};
+	let hasTenant = false;
+	for (const key of tenantKeys) {
+		const value = source[key];
+		if (value === void 0) continue;
+		out[key] = value;
+		if (value !== null && value !== "") hasTenant = true;
+	}
+	if (!hasTenant && source.bypassTenant === true) out.bypassTenant = true;
+	for (const key of ATTRIBUTION_KEYS) if (source[key] !== void 0) out[key] = source[key];
+	return out;
+}
+/** Every key `forwardScope` governs. Other forwarding helpers must not copy these themselves. */
+function isScopeKey(key, tenantKeys = CONVENTIONAL_TENANT_KEYS) {
+	return key === "bypassTenant" || tenantKeys.includes(key) || ATTRIBUTION_KEYS.includes(key);
+}
+//#endregion
 //#region src/plugins/multi-tenant.plugin.ts
 /**
 * Multi-Tenant Plugin
@@ -960,6 +1066,7 @@ function multiTenantPlugin(options = {}) {
 	return {
 		name: "multi-tenant",
 		apply(repo) {
+			declareTenantContextKey(repo, contextKey);
 			const allOps = [...ALL_OPERATIONS.map((op) => ({
 				op,
 				policyKey: OP_REGISTRY[op].policyKey
@@ -1477,4 +1584,4 @@ function timestampPlugin() {
 	};
 }
 //#endregion
-export { customIdPlugin as a, prefixedId as c, AuditTrailQuery as d, auditTrailPlugin as f, multiTenantPlugin as i, sequentialId as l, auditLogPlugin as m, softDeletePlugin as n, dateSequentialId as o, ensureAuditTrailReady as p, adminBypass$1 as r, getNextSequence as s, timestampPlugin as t, cachePlugin as u };
+export { AuditTrailQuery as _, declareTenantContextKey as a, auditLogPlugin as b, tenantContextKeysOf as c, ensureSequenceAtLeast as d, getNextSequence as f, cachePlugin as g, sequentialId as h, multiTenantPlugin as i, customIdPlugin as l, readSequence as m, softDeletePlugin as n, forwardScope as o, prefixedId as p, adminBypass$1 as r, isScopeKey as s, timestampPlugin as t, dateSequentialId as u, auditTrailPlugin as v, ensureAuditTrailReady as y };

package/dist/{to-plain-Dyz_qvuo.d.mts → to-plain-k7SjNlSS.d.mts}

@@ -1,5 +1,5 @@
-import { v as UserContext } from "./repository-H_ffGgpE.mjs";
-import { r as FieldPreset } from "./plugin-options-DXnlKM3B.mjs";
+import { v as UserContext } from "./repository-odl03582.mjs";
+import { r as FieldPreset } from "./plugin-options-Zk46lD6F.mjs";
 import mongoose, { Schema } from "mongoose";
 import { CacheAdapter } from "@classytic/repo-core/cache";
 import { HttpError } from "@classytic/repo-core/errors";