@classytic/mongokit 3.30.0 → 3.31.1

package/dist/{PaginationEngine-CczbvCAq.mjs → PaginationEngine-CuONvwCM.mjs}

@@ -636,7 +636,27 @@ var PaginationEngine = class {
 			hasNext = data.length > sanitizedLimit;
 			if (hasNext) data.pop();
 		} else hasNext = sanitizedPage < totalPages;
-		const warning = shouldWarnDeepPagination(sanitizedPage, this.config.deepPageThreshold) ? `Deep pagination (page ${sanitizedPage}). Consider getAll({ after, sort, limit }) for better performance.` : void 0;
+		/**
+		* A CLAMPED limit is reported, not swallowed.
+		*
+		* `validateLimit` caps silently by design — an over-ask is benign and rejecting it
+		* would be worse (that contradiction cost a day: the querystring schema's `maximum`
+		* made the parser's documented clamp unreachable, so `?limit=200` 400'd and two UI
+		* callers rendered the failure as an empty list).
+		*
+		* But clamping quietly has its own cost. A caller asking for 1000 and receiving 100
+		* gets an arbitrary slice with no signal — which is exactly how a bank-account
+		* picker rendered "No accounts found" against 696 accounts, because the rows it
+		* wanted were outside the first page. `limit` in the response already carries the
+		* effective value; nobody compares it. A warning is the channel that is actually
+		* read.
+		*
+		* Deep-pagination takes precedence when both apply: it is the more actionable of
+		* the two, and stacking warnings turns a signal into noise.
+		*/
+		const requestedLimit = Number(limit);
+		const wasClamped = Number.isFinite(requestedLimit) && requestedLimit > sanitizedLimit;
+		const warning = shouldWarnDeepPagination(sanitizedPage, this.config.deepPageThreshold) ? `Deep pagination (page ${sanitizedPage}). Consider getAll({ after, sort, limit }) for better performance.` : wasClamped ? `Requested limit ${Math.floor(requestedLimit)} exceeds this repository's cap; returning ${sanitizedLimit}. Filter server-side or sort deterministically — the returned page is otherwise an arbitrary slice.` : void 0;
 		return {
 			method: "offset",
 			data,

package/dist/{Repository-BXHkUtLk.d.mts → Repository-BAzymuOz.d.mts}

@@ -1,4 +1,4 @@
-import { _ as WithTransactionOptions, a as DeleteManyResult, f as OperationOptions, g as UpdateOptions, h as UpdateManyResult, i as CreateOptions, l as LookupPopulateOptions, m as SessionOptions, o as DeleteResult, p as ReadOptions, r as CacheableOptions, s as FindOneAndUpdateOptions, t as AggregateOptions, u as LookupPopulateResult, v as LookupBuilder, y as LookupOptions } from "./operations-C8IcCHF9.mjs";
+import { _ as WithTransactionOptions, a as DeleteManyResult, f as OperationOptions, g as UpdateOptions, h as UpdateManyResult, i as CreateOptions, l as LookupPopulateOptions, m as SessionOptions, o as DeleteResult, p as ReadOptions, r as CacheableOptions, s as FindOneAndUpdateOptions, t as AggregateOptions, u as LookupPopulateResult, v as LookupBuilder, y as LookupOptions } from "./operations-CuzX9m2Z.mjs";
 import { a as PopulateSpec, i as ObjectId, l as SortSpec$1, o as ReadPreferenceType, s as SelectSpec } from "./core-62oo3N1C.mjs";
 import { c as PaginationConfig, r as CollationOptions, t as AggregatePaginationOptions } from "./pagination-jSUdrACK.mjs";
 import { _ as RepositoryOptions, d as PluginType, f as PrioritizedHook, o as Middleware, p as RepositoryContext } from "./repository-Q16ErTu8.mjs";

package/dist/{Repository-X7U2d0kU.mjs → Repository-Cx7BwvDA.mjs}

@@ -1,8 +1,8 @@
 import { i as isValidIdForType, t as getSchemaIdType } from "./id-resolution-BqDrk0S2.mjs";
-import { a as count, b as LookupBuilder, c as getByQuery, d as deleteById, f as deleteByQuery, h as createMany, l as getOrCreate, m as create, n as update, o as exists, r as updateByQuery, s as getById, t as findOneAndUpdate, x as compileFilterToMongo, y as distinct } from "./update-DHdXdOk_.mjs";
+import { a as count, b as LookupBuilder, c as getByQuery, d as deleteById, f as deleteByQuery, h as createMany, l as getOrCreate, m as create, n as update, o as exists, r as updateByQuery, s as getById, t as findOneAndUpdate, x as compileFilterToMongo, y as distinct } from "./update-w5i-pa_c.mjs";
 import { n as warn } from "./logger-K7dPmu2U.mjs";
 import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-BuByZwKU.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-CczbvCAq.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-CuONvwCM.mjs";
 import { hasNearOperator, rewriteNearForCount } from "./query/primitives/geo.mjs";
 import { RepositoryBase, runChunkedArchive, runChunkedPurge, throwIfAborted, validatePluginOrder, withRetry } from "@classytic/repo-core/repository";
 import mongoose from "mongoose";
@@ -159,6 +159,7 @@ const MONGOKIT_CAPABILITIES = Object.freeze({
 		percentile: true,
 		stddev: true,
 		topN: true,
+		dateBucketTimezone: true,
 		customDateBuckets: true,
 		dateBucketSubMinute: true,
 		cache: true
@@ -173,6 +174,7 @@ const MONGOKIT_CAPABILITIES = Object.freeze({
 	changeStreams: true,
 	lean: true,
 	lookupPopulate: true,
+	lookupCoerce: true,
 	streaming: true
 });
 /**
@@ -666,8 +668,48 @@ function validateMeasures$1(measures) {
 *   2. Inside `$project` to flatten `_id.<alias>` into a top-level
 *      column on the output row — matches the cross-kit shape.
 */
+/**
+* Reject an unknown IANA zone HERE, not at the server.
+*
+* `@classytic/primitives` owns the canonical `isValidTimeZone`, but this is a
+* storage kit and must not take a domain dependency for one validator — so it
+* mirrors the primitive's implementation exactly: construct an `Intl` formatter
+* for the zone and treat the `RangeError` as the answer. ICU is the same source
+* of truth either way, so the two cannot disagree about which zones exist.
+*
+* Without this, a typo (`Asia/Dahka`) travels all the way to Mongo and comes
+* back as a server-side "unrecognized time zone identifier" attached to whatever
+* query happened to run — at request time, far from the aggregation that set
+* it. Failing at compile time names the field and the value.
+*/
+const validatedZones = /* @__PURE__ */ new Set(["UTC"]);
+function assertValidTimeZone(zone) {
+	if (validatedZones.has(zone)) return;
+	try {
+		new Intl.DateTimeFormat("en-US", { timeZone: zone });
+	} catch {
+		throw new Error(`mongokit/aggregate: dateBucket.timezone is not a valid IANA zone — got ${JSON.stringify(zone)}. Use a name like "Asia/Dhaka" or "America/New_York"; omit the field for UTC.`);
+	}
+	validatedZones.add(zone);
+}
 function compileDateBucket(bucket) {
 	const dateExpr = { $toDate: `$${bucket.field}` };
+	/**
+	* Bucket boundaries are drawn in `bucket.timezone`, defaulting to UTC.
+	*
+	* Every branch below used to hardcode `'UTC'`, which made the portable IR
+	* unusable for any business-day rollup: in a UTC+6 deployment the 18:00–
+	* midnight rows land on the previous day and, at month-end, in the previous
+	* month — silently. Consumers therefore abandoned the IR and hand-rolled
+	* `$dateToString` pipelines, where the zone became optional and was
+	* forgotten (see the daily profit rollup that bucketed on UTC days).
+	*
+	* Mongo takes an IANA zone natively on both operators, so honouring it here
+	* costs nothing and makes the correct thing expressible. Gated by the
+	* `dateBucketTimezone` capability for kits that cannot do it.
+	*/
+	const timezone = bucket.timezone ?? "UTC";
+	assertValidTimeZone(timezone);
 	if (typeof bucket.interval === "object") {
 		const { every, unit } = bucket.interval;
 		if (!Number.isInteger(every) || every <= 0) throw new Error(`mongokit/aggregate: dateBucket.interval.every must be a positive integer — got ${String(every)}`);
@@ -675,56 +717,56 @@ function compileDateBucket(bucket) {
 			date: dateExpr,
 			unit,
 			binSize: every,
-			timezone: "UTC"
+			timezone
 		} };
 		return { $dateToString: {
 			format: formatForUnit(unit),
 			date: truncated,
-			timezone: "UTC"
+			timezone
 		} };
 	}
 	switch (bucket.interval) {
 		case "minute": return { $dateToString: {
 			format: "%Y-%m-%dT%H:%M",
 			date: dateExpr,
-			timezone: "UTC"
+			timezone
 		} };
 		case "hour": return { $dateToString: {
 			format: "%Y-%m-%dT%H:00",
 			date: dateExpr,
-			timezone: "UTC"
+			timezone
 		} };
 		case "day": return { $dateToString: {
 			format: "%Y-%m-%d",
 			date: dateExpr,
-			timezone: "UTC"
+			timezone
 		} };
 		case "week": return { $dateToString: {
 			format: "%G-W%V",
 			date: dateExpr,
-			timezone: "UTC"
+			timezone
 		} };
 		case "month": return { $dateToString: {
 			format: "%Y-%m",
 			date: dateExpr,
-			timezone: "UTC"
+			timezone
 		} };
 		case "quarter": return { $concat: [
 			{ $dateToString: {
 				format: "%Y",
 				date: dateExpr,
-				timezone: "UTC"
+				timezone
 			} },
 			"-Q",
 			{ $toString: { $ceil: { $divide: [{ $month: {
 				date: dateExpr,
-				timezone: "UTC"
+				timezone
 			} }, 3] } } }
 		] };
 		case "year": return { $dateToString: {
 			format: "%Y",
 			date: dateExpr,
-			timezone: "UTC"
+			timezone
 		} };
 	}
 }
@@ -4268,9 +4310,9 @@ var Repository = class extends RepositoryBase {
 				const appendLookupStages$2 = (pipeline) => appendLookupStages(pipeline, lookups, projection, isKeyset && sort ? this._parseSort(sort) : void 0);
 				if (isKeyset && sort) {
 					const parsedSort = this._parseSort(sort);
-					const { validateKeysetSort } = await import("./PaginationEngine-CczbvCAq.mjs").then((n) => n.n);
-					const { encodeCursor, resolveCursorFilter } = await import("./PaginationEngine-CczbvCAq.mjs").then((n) => n.r);
-					const { getPrimaryField } = await import("./PaginationEngine-CczbvCAq.mjs").then((n) => n.n);
+					const { validateKeysetSort } = await import("./PaginationEngine-CuONvwCM.mjs").then((n) => n.n);
+					const { encodeCursor, resolveCursorFilter } = await import("./PaginationEngine-CuONvwCM.mjs").then((n) => n.r);
+					const { getPrimaryField } = await import("./PaginationEngine-CuONvwCM.mjs").then((n) => n.n);
 					const normalizedSort = validateKeysetSort(parsedSort, this._pagination.config.strictKeysetSortFields);
 					const cursorVersion = this._pagination.config.cursorVersion ?? 1;
 					const minCursorVersion = this._pagination.config.minCursorVersion ?? 1;

package/dist/actions/index.d.mts

@@ -1,2 +1,2 @@
-import { a as create_d_exports, i as delete_d_exports, n as update_d_exports, o as aggregate_d_exports, r as read_d_exports } from "../index-DceInCTX.mjs";
+import { a as create_d_exports, i as delete_d_exports, n as update_d_exports, o as aggregate_d_exports, r as read_d_exports } from "../index-Beyr1r4d.mjs";
 export { aggregate_d_exports as aggregate, create_d_exports as create, delete_d_exports as deleteActions, read_d_exports as read, update_d_exports as update };

package/dist/actions/index.mjs

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "../rolldown-runtime-D7D4PA-g.mjs";
-import { g as create_exports, i as update_exports, p as delete_exports, u as read_exports, v as aggregate_exports } from "../update-DHdXdOk_.mjs";
+import { g as create_exports, i as update_exports, p as delete_exports, u as read_exports, v as aggregate_exports } from "../update-w5i-pa_c.mjs";
 //#region src/actions/index.ts
 var actions_exports = /* @__PURE__ */ __exportAll({
 	aggregate: () => aggregate_exports,

package/dist/better-auth/index.mjs

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

package/dist/{create-repository-DYe5YEie.mjs → create-repository-EWKzpsyM.mjs}

@@ -1,5 +1,5 @@
-import { n as Repository } from "./Repository-X7U2d0kU.mjs";
-import { a as customIdPlugin, f as auditTrailPlugin, i as multiTenantPlugin, m as auditLogPlugin, n as softDeletePlugin, t as timestampPlugin, u as cachePlugin } from "./timestamp.plugin-ChFRcLRJ.mjs";
+import { n as Repository } from "./Repository-Cx7BwvDA.mjs";
+import { a as customIdPlugin, f as auditTrailPlugin, i as multiTenantPlugin, m as auditLogPlugin, n as softDeletePlugin, t as timestampPlugin, u as cachePlugin } from "./timestamp.plugin-CX_kw6TN.mjs";
 import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "./method-registry.plugin-DblM7V6j.mjs";
 //#region src/create-repository.ts
 function isLoggerAudit(value) {

package/dist/{create-repository-CvD4wzuN.d.mts → create-repository-mEdfH9sz.d.mts}

@@ -1,7 +1,7 @@
 import { c as PaginationConfig } from "./pagination-jSUdrACK.mjs";
 import { _ as RepositoryOptions, d as PluginType } from "./repository-Q16ErTu8.mjs";
 import { T as AuditTrailOptions, _ as RepositoryCachePluginOptions, i as CustomIdOptions, t as MultiTenantOptions } from "./multi-tenant.plugin-2VtSSm1Y.mjs";
-import { n as Repository } from "./Repository-BXHkUtLk.mjs";
+import { n as Repository } from "./Repository-BAzymuOz.mjs";
 import { i as Logger, o as SoftDeleteOptions } from "./plugin-options-BsFH0sTi.mjs";
 import { Model } from "mongoose";
 //#region src/create-repository.d.ts

package/dist/{index-DceInCTX.d.mts → index-Beyr1r4d.d.mts}

@@ -1,4 +1,4 @@
-import { c as GroupResult, d as MinMaxResult, f as OperationOptions, g as UpdateOptions, h as UpdateManyResult, i as CreateOptions, o as DeleteResult, s as FindOneAndUpdateOptions, y as LookupOptions } from "./operations-C8IcCHF9.mjs";
+import { c as GroupResult, d as MinMaxResult, f as OperationOptions, g as UpdateOptions, h as UpdateManyResult, i as CreateOptions, o as DeleteResult, s as FindOneAndUpdateOptions, y as LookupOptions } from "./operations-CuzX9m2Z.mjs";
 import { a as PopulateSpec, i as ObjectId, l as SortSpec, o as ReadPreferenceType, s as SelectSpec, t as AnyDocument } from "./core-62oo3N1C.mjs";
 import { p as UpdateWithValidationResult } from "./type-utils-CLzRFtIA.mjs";
 import { Model, PipelineStage } from "mongoose";

package/dist/index.d.mts

@@ -1,14 +1,14 @@
-import { _ as WithTransactionOptions, c as GroupResult, d as MinMaxResult, f as OperationOptions, g as UpdateOptions, h as UpdateManyResult, i as CreateOptions, l as LookupPopulateOptions, m as SessionOptions, n as CacheOperationOptions, o as DeleteResult, p as ReadOptions, r as CacheableOptions, s as FindOneAndUpdateOptions, t as AggregateOptions, u as LookupPopulateResult, v as LookupBuilder, y as LookupOptions } from "./operations-C8IcCHF9.mjs";
+import { _ as WithTransactionOptions, c as GroupResult, d as MinMaxResult, f as OperationOptions, g as UpdateOptions, h as UpdateManyResult, i as CreateOptions, l as LookupPopulateOptions, m as SessionOptions, n as CacheOperationOptions, o as DeleteResult, p as ReadOptions, r as CacheableOptions, s as FindOneAndUpdateOptions, t as AggregateOptions, u as LookupPopulateResult, v as LookupBuilder, y as LookupOptions } from "./operations-CuzX9m2Z.mjs";
 import { a as PopulateSpec, c as SortDirection, i as ObjectId, l as SortSpec$1, n as AnyModel, o as ReadPreferenceType, s as SelectSpec, t as AnyDocument } from "./core-62oo3N1C.mjs";
 import { a as DecodedCursor, c as PaginationConfig, i as CursorPayload, l as ValueType, n as BasePaginationOptions, o as KeysetPaginationOptions, r as CollationOptions, s as OffsetPaginationOptions, t as AggregatePaginationOptions } from "./pagination-jSUdrACK.mjs";
-import { t as index_d_exports } from "./index-DceInCTX.mjs";
+import { t as index_d_exports } from "./index-Beyr1r4d.mjs";
 import { a as InferRawDoc, c as NonNullableFields, d as Strict, f as UpdatePatch, i as InferDocument, l as PartialBy, n as DeepPartial, o as KeysOfType, p as UpdateWithValidationResult, r as DocField, s as MongoOperatorUpdate, t as CreateInput, u as RequiredBy } from "./type-utils-CLzRFtIA.mjs";
 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-Q16ErTu8.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-2VtSSm1Y.mjs";
 import { t as PaginationEngine } from "./PaginationEngine-CBS1XGzp.mjs";
-import { a as AggregationPlan, c as SortOrder, i as AggregationBuilder, l as SortSpec, n as Repository, o as GroupSpec, r as TransitionMachine, s as ProjectionSpec, t as HOOK_PRIORITY, u as VectorSearchOptions } from "./Repository-BXHkUtLk.mjs";
+import { a as AggregationPlan, c as SortOrder, i as AggregationBuilder, l as SortSpec, n as Repository, o as GroupSpec, r as TransitionMachine, s as ProjectionSpec, t as HOOK_PRIORITY, u as VectorSearchOptions } from "./Repository-BAzymuOz.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-BsFH0sTi.mjs";
-import { n as CreateRepositoryConfig, r as createRepository, t as AuditConfig } from "./create-repository-CvD4wzuN.mjs";
+import { n as CreateRepositoryConfig, r as createRepository, t as AuditConfig } from "./create-repository-mEdfH9sz.mjs";
 import { A as IdempotencyStoreMethods, B as auditLogPlugin, C as LeaseMethods, D as ImmutableStatesPluginOptions, E as ImmutableClaimView, F as elasticSearchPlugin, H as appendOnlyPlugin, I as cascadePlugin, L as BatchOperationsMethods, M as idempotencyStorePlugin, N as fieldFilterPlugin, O as immutableStatesPlugin, P as ElasticSearchOptions, R as BulkWriteResult, S as methodRegistryPlugin, T as leasePlugin, U as AggregateHelpersMethods, V as AppendOnlyPluginOptions, W as aggregateHelpersPlugin, _ as OperationMetric, a as requireField, b as mongoOperationsPlugin, c as timestampPlugin, d as createTenantContext, f as SubdocumentMethods, g as ObservabilityOptions, h as softDeletePlugin, i as immutableField, j as IdempotencyStorePluginOptions, k as IdempotencyClaim, l as TenantContext, m as SoftDeleteMethods, n as autoInject, o as uniqueField, p as subdocumentPlugin, r as blockIf, s as validationChainPlugin, t as OperationType, u as TenantStore, v as observabilityPlugin, w as LeasePluginOptions, y as MongoOperationsMethods, z as batchOperationsPlugin } from "./validation-chain.plugin-BSshLJTA.mjs";
 import { n as SchemaPathsLike, t as FieldType$1 } from "./coercion-BjdPX3YF.mjs";
 import { n as SchemaIndexes } from "./indexes-DIjMpYES.mjs";
@@ -118,6 +118,21 @@ type CapabilityResolution = 'declared' | 'observed' | 'unknown';
  */
 interface MongoRepoCapabilities extends RepoCapabilities {
   readonly transactionsResolution: CapabilityResolution;
+  /**
+   * `LookupOptions.coerce` — join a STRING reference against an `ObjectId` key.
+   *
+   * Declared HERE and not on repo-core's portable `RepoCapabilities` on
+   * purpose: `coerce` is a mongokit-only `LookupOptions` field with no
+   * counterpart on repo-core's `LookupSpec`, so a cross-kit caller cannot
+   * express it. A portable capability flag for a non-portable option would be
+   * decoration — and it would force a repo-core release plus a peer-floor bump
+   * on every kit for a field only one of them can honour.
+   *
+   * It is worth declaring at all because the unsupported case is INVISIBLE: a
+   * `$lookup` comparing `string` to `ObjectId` matches nothing and raises no
+   * error, so a host cannot tell "not supported here" from "no matches".
+   */
+  readonly lookupCoerce: boolean;
 }
 /**
  * Read the provenance of a capability descriptor's `transactions` flag.
@@ -585,6 +600,19 @@ declare class QueryParser {
    * Returns `undefined` if no whitelist is set (all fields allowed).
    */
   get allowedSortFields(): string[] | undefined;
+  /**
+   * The configured page-size cap — EXPOSED so a caller does not apply a second one.
+   *
+   * A resource that constructs `new QueryParser({ maxLimit: 1000 })` has answered the
+   * question "how large may a page be?". Without a way to read it back, every layer
+   * downstream applies its own default and the LOWEST silently wins — which is exactly
+   * what happened: a resource asked for 1000, a repository was configured for 1000, and
+   * arc's `QueryResolver` capped at its own default of 100. Three caps, one winner, no
+   * signal, and an account picker that showed 100 of 696 rows.
+   *
+   * Read this instead of defaulting when a parser is supplied.
+   */
+  get maxLimit(): number;
   /**
    * Get the configured allowed operators.
    * Returns `undefined` if no whitelist is set (all built-in operators allowed).

package/dist/index.mjs

@@ -1,16 +1,16 @@
 import { n as idVariants } from "./id-resolution-BqDrk0S2.mjs";
-import { _ as resetCapabilityProbeCache, a as supportsTransactions, b as transactionResolutionOf, c as ALL_OPERATIONS, d as READ_OPERATIONS, f as operationsByPolicyKey, g as probeMongoCapabilities, h as classifyHelloReply, i as isTransactionUnsupported, l as MUTATING_OPERATIONS, m as capabilitiesForSupport, n as Repository, o as withTransaction, p as MONGOKIT_CAPABILITIES, r as batchTransaction, s as AggregationBuilder, t as HOOK_PRIORITY, u as OP_REGISTRY, v as resolveMongoCapabilities, x as createMongoPurgePort, y as resolveTransactionSupport } from "./Repository-X7U2d0kU.mjs";
-import { b as LookupBuilder, x as compileFilterToMongo } from "./update-DHdXdOk_.mjs";
+import { _ as resetCapabilityProbeCache, a as supportsTransactions, b as transactionResolutionOf, c as ALL_OPERATIONS, d as READ_OPERATIONS, f as operationsByPolicyKey, g as probeMongoCapabilities, h as classifyHelloReply, i as isTransactionUnsupported, l as MUTATING_OPERATIONS, m as capabilitiesForSupport, n as Repository, o as withTransaction, p as MONGOKIT_CAPABILITIES, r as batchTransaction, s as AggregationBuilder, t as HOOK_PRIORITY, u as OP_REGISTRY, v as resolveMongoCapabilities, x as createMongoPurgePort, y as resolveTransactionSupport } from "./Repository-Cx7BwvDA.mjs";
+import { b as LookupBuilder, x as compileFilterToMongo } from "./update-w5i-pa_c.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 customIdPlugin, c as prefixedId, d as AuditTrailQuery, f as auditTrailPlugin, i as multiTenantPlugin, l as sequentialId, m as auditLogPlugin, n as softDeletePlugin, o as dateSequentialId, p as ensureAuditTrailReady, r as adminBypass, s as getNextSequence, t as timestampPlugin, u as cachePlugin } from "./timestamp.plugin-ChFRcLRJ.mjs";
+import { a as customIdPlugin, c as prefixedId, d as AuditTrailQuery, f as auditTrailPlugin, i as multiTenantPlugin, l as sequentialId, m as auditLogPlugin, n as softDeletePlugin, o as dateSequentialId, p as ensureAuditTrailReady, r as adminBypass, s as getNextSequence, t as timestampPlugin, u as cachePlugin } from "./timestamp.plugin-CX_kw6TN.mjs";
 import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "./method-registry.plugin-DblM7V6j.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-CczbvCAq.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-CuONvwCM.mjs";
 import { isGeoOperator, parseGeoFilter } from "./query/primitives/geo.mjs";
-import { t as createRepository } from "./create-repository-DYe5YEie.mjs";
+import { t as createRepository } from "./create-repository-EWKzpsyM.mjs";
 import { n as defineModel, r as isModelRegistered, t as ModelCollisionError } from "./model-registry-ClKtWiHa.mjs";
-import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "./validation-chain.plugin-BxTl_dYR.mjs";
+import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "./validation-chain.plugin-DbcBOWi3.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";
@@ -1109,10 +1109,29 @@ function buildQuerySchema(rt) {
 		},
 		limit: {
 			type: "integer",
-			description: "Number of items per page",
+			/**
+			* The cap is DOCUMENTED, not enforced here — deliberately.
+			*
+			* `QueryParser.parse` clamps an over-large limit to `maxLimit` and says so in
+			* its own comment: "Exceeding maxLimit is CLAMPED, not rejected — capping is not
+			* invalid." Emitting `maximum` into the JSON Schema contradicted that: Fastify
+			* validates the querystring BEFORE the parser runs, so the clamp was unreachable
+			* and `?limit=200` became a hard 400.
+			*
+			* That combination is worse than either policy alone. A caller asking for more
+			* rows than allowed is a benign over-ask with an obvious correct answer (give
+			* them the maximum); turning it into a validation failure meant a UI that passed
+			* a generous page size got NOTHING, and — because the two components doing so
+			* never read the query error — rendered it as an empty list rather than a
+			* failure. A 400 disguised as "no results" is the hardest kind to find.
+			*
+			* If a deployment genuinely wants rejection rather than clamping, that belongs
+			* in the parser's fail-closed policy where both halves can agree, not in a schema
+			* that silently outranks it.
+			*/
+			description: `Number of items per page (values above ${rt.options.maxLimit} are capped to ${rt.options.maxLimit})`,
 			default: 20,
-			minimum: 1,
-			maximum: rt.options.maxLimit
+			minimum: 1
 		},
 		sort: {
 			type: "string",
@@ -1338,6 +1357,21 @@ var QueryParser = class {
 		return this.rt.options.allowedSortFields;
 	}
 	/**
+	* The configured page-size cap — EXPOSED so a caller does not apply a second one.
+	*
+	* A resource that constructs `new QueryParser({ maxLimit: 1000 })` has answered the
+	* question "how large may a page be?". Without a way to read it back, every layer
+	* downstream applies its own default and the LOWEST silently wins — which is exactly
+	* what happened: a resource asked for 1000, a repository was configured for 1000, and
+	* arc's `QueryResolver` capped at its own default of 100. Three caps, one winner, no
+	* signal, and an account picker that showed 100 of 696 rows.
+	*
+	* Read this instead of defaulting when a parser is supplied.
+	*/
+	get maxLimit() {
+		return this.rt.options.maxLimit;
+	}
+	/**
 	* Get the configured allowed operators.
 	* Returns `undefined` if no whitelist is set (all built-in operators allowed).
 	*/

package/dist/{operations-C8IcCHF9.d.mts → operations-CuzX9m2Z.d.mts}

@@ -26,8 +26,39 @@ interface LookupOptions {
   select?: string | readonly string[] | Record<string, 0 | 1>;
   /** Additional pipeline to run on the joined collection */
   pipeline?: PipelineStage[];
-  /** Optional let variables for pipeline */
-  let?: Record<string, string>;
+  /**
+   * Let variables for the pipeline form.
+   *
+   * Values are aggregation EXPRESSIONS, not just field paths — `'$skuRef'` and
+   * `{ $toObjectId: '$skuRef' }` are both valid. This was typed
+   * `Record<string, string>`, which made every cross-type correlation
+   * inexpressible through the typed API and pushed callers to hand-write raw
+   * pipelines or give up on the join entirely.
+   */
+  let?: Record<string, unknown>;
+  /**
+   * Coerce `localField` before comparing it to `foreignField`.
+   *
+   * ## Why this exists
+   *
+   * A `$lookup` compares values with STRICT BSON type equality. A `string`
+   * holding `"6a43c8fd…"` never equals an `ObjectId("6a43c8fd…")`, so the join
+   * matches nothing — and a `$lookup` that matches nothing is not an error, it
+   * is an empty array. The row renders without its joined data and every count
+   * downstream is plausibly, silently wrong.
+   *
+   * That is not hypothetical: flow stores `skuRef` as an opaque `string` (it
+   * must also admit non-ObjectId SKU codes) while `catalog_products._id` is an
+   * `ObjectId`. The naive form returned 0 matches for every row; the coerced
+   * form returned all of them. The workaround was a second round-trip resolver
+   * per request.
+   *
+   * `'objectId'` compiles to a `$convert` with `onError: null` — NOT
+   * `$toObjectId`, which THROWS on the first unconvertible value and would take
+   * down the whole query for one legacy SKU code. A row whose ref cannot be an
+   * ObjectId simply does not join, which is the same outcome as a genuine miss.
+   */
+  coerce?: 'objectId';
   /** Query filter to apply before join (legacy, for aggregate.ts compatibility) */
   query?: Record<string, unknown>;
   /** Query options (legacy, for aggregate.ts compatibility) */
@@ -75,6 +106,14 @@ declare class LookupBuilder {
    * Defaults to the collection name if not specified
    */
   as(fieldName: string): this;
+  /**
+   * Coerce the local field before comparing it to the foreign field.
+   *
+   * Use when the two sides are stored as different BSON types — most commonly a
+   * `string` reference against an `ObjectId` `_id`. Without it the join matches
+   * nothing and reports no error. See {@link LookupOptions.coerce}.
+   */
+  coerce(kind: NonNullable<LookupOptions['coerce']>): this;
   /**
    * Mark this lookup as returning a single document
    * Automatically unwraps the array result to a single object or null
@@ -98,7 +137,7 @@ declare class LookupBuilder {
    * Set let variables for use in pipeline
    * Allows referencing local document fields in the pipeline
    */
-  let(variables: Record<string, string>): this;
+  let(variables: Record<string, unknown>): this;
   /**
    * Control pipeline sanitization (default: true)
    * Set to false for auto-generated pipelines that are known safe

package/dist/outbox/index.d.mts

@@ -1,4 +1,4 @@
-import { n as Repository } from "../Repository-BXHkUtLk.mjs";
+import { n as Repository } from "../Repository-BAzymuOz.mjs";
 import { Connection, Model } from "mongoose";
 //#region src/outbox/index.d.ts
 /** Delivery states. `dead_letter` is terminal and operator-visible. */

package/dist/outbox/index.mjs

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

package/dist/pagination/PaginationEngine.mjs

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

package/dist/plugins/index.mjs

@@ -1,6 +1,6 @@
-import { a as customIdPlugin, c as prefixedId, d as AuditTrailQuery, f as auditTrailPlugin, i as multiTenantPlugin, l as sequentialId, m as auditLogPlugin, n as softDeletePlugin, o as dateSequentialId, p as ensureAuditTrailReady, s as getNextSequence, t as timestampPlugin, u as cachePlugin } from "../timestamp.plugin-ChFRcLRJ.mjs";
+import { a as customIdPlugin, c as prefixedId, d as AuditTrailQuery, f as auditTrailPlugin, i as multiTenantPlugin, l as sequentialId, m as auditLogPlugin, n as softDeletePlugin, o as dateSequentialId, p as ensureAuditTrailReady, s as getNextSequence, t as timestampPlugin, u as cachePlugin } from "../timestamp.plugin-CX_kw6TN.mjs";
 import { n as batchOperationsPlugin, t as methodRegistryPlugin } from "../method-registry.plugin-DblM7V6j.mjs";
-import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "../validation-chain.plugin-BxTl_dYR.mjs";
+import { _ as cascadePlugin, a as uniqueField, c as subdocumentPlugin, d as mongoOperationsPlugin, f as leasePlugin, g as elasticSearchPlugin, h as fieldFilterPlugin, i as requireField, l as observabilityPlugin, m as idempotencyStorePlugin, n as blockIf, o as validationChainPlugin, p as immutableStatesPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as MONGOKIT_PLUGIN_NAMES, v as appendOnlyPlugin, y as aggregateHelpersPlugin } from "../validation-chain.plugin-DbcBOWi3.mjs";
 //#region src/plugins/change-log.plugin.ts
 const PLUGIN_NAME = "changeLog";
 function isSkipped(context) {

package/dist/testkit/index.d.mts

@@ -1,5 +1,5 @@
-import { n as Repository } from "../Repository-BXHkUtLk.mjs";
-import { n as CreateRepositoryConfig } from "../create-repository-CvD4wzuN.mjs";
+import { n as Repository } from "../Repository-BAzymuOz.mjs";
+import { n as CreateRepositoryConfig } from "../create-repository-mEdfH9sz.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-DYe5YEie.mjs";
+import { t as createRepository } from "../create-repository-EWKzpsyM.mjs";
 import { createConnection } from "mongoose";
 //#region src/testkit/index.ts
 function idempotentStop(server) {

package/dist/{timestamp.plugin-ChFRcLRJ.mjs → timestamp.plugin-CX_kw6TN.mjs}

@@ -1,4 +1,4 @@
-import { c as ALL_OPERATIONS, t as HOOK_PRIORITY, u as OP_REGISTRY } from "./Repository-X7U2d0kU.mjs";
+import { c as ALL_OPERATIONS, t as HOOK_PRIORITY, u as OP_REGISTRY } from "./Repository-Cx7BwvDA.mjs";
 import { n as warn } from "./logger-K7dPmu2U.mjs";
 import { throwIfAborted, withRetry } from "@classytic/repo-core/repository";
 import mongoose from "mongoose";

package/dist/{update-DHdXdOk_.mjs → update-w5i-pa_c.mjs}

@@ -201,6 +201,25 @@ const DANGEROUS_OPERATORS = [
 	"$accumulator"
 ];
 /**
+* The local side of a join correlation, coerced when the two sides are stored
+* as different BSON types.
+*
+* `$convert` with `onError`/`onNull` rather than `$toObjectId`: the latter
+* throws on the first unconvertible value, which would fail the entire
+* aggregation because ONE row held a legacy non-ObjectId reference. Returning
+* null makes that row miss the join, exactly as a genuine non-match would.
+*/
+function localCorrelation(localField, coerce) {
+	const path = `$${localField}`;
+	if (coerce !== "objectId") return path;
+	return { $convert: {
+		input: path,
+		to: "objectId",
+		onError: null,
+		onNull: null
+	} };
+}
+/**
 * Fluent builder for MongoDB $lookup aggregation stage
 * Optimized for custom field joins at scale
 */
@@ -241,6 +260,17 @@ var LookupBuilder = class LookupBuilder {
 		return this;
 	}
 	/**
+	* Coerce the local field before comparing it to the foreign field.
+	*
+	* Use when the two sides are stored as different BSON types — most commonly a
+	* `string` reference against an `ObjectId` `_id`. Without it the join matches
+	* nothing and reports no error. See {@link LookupOptions.coerce}.
+	*/
+	coerce(kind) {
+		this.options.coerce = kind;
+		return this;
+	}
+	/**
 	* Mark this lookup as returning a single document
 	* Automatically unwraps the array result to a single object or null
 	*/
@@ -293,11 +323,12 @@ var LookupBuilder = class LookupBuilder {
 	* Otherwise, we use the simpler localField/foreignField form.
 	*/
 	build() {
-		const { from, localField, foreignField, as, single, pipeline, let: letVars } = this.options;
+		const { from, localField, foreignField, as, single, pipeline, let: letVars, coerce } = this.options;
 		if (!from) throw new Error("LookupBuilder: \"from\" collection is required");
+		if (coerce && (!localField || !foreignField)) throw new Error("LookupBuilder: \"coerce\" needs both localField and foreignField — it describes how to compare them. Without both there is no comparison to coerce.");
 		const outputField = as || from;
 		const stages = [];
-		const usePipelineForm = pipeline || letVars;
+		const usePipelineForm = pipeline || letVars || coerce;
 		let lookupStage;
 		if (usePipelineForm) if (!pipeline || pipeline.length === 0) {
 			if (!localField || !foreignField) throw new Error("LookupBuilder: When using pipeline form without a custom pipeline, both localField and foreignField are required to auto-generate the pipeline");
@@ -305,7 +336,7 @@ var LookupBuilder = class LookupBuilder {
 			lookupStage = { $lookup: {
 				from,
 				let: {
-					[localField]: `$${localField}`,
+					[localField]: localCorrelation(localField, coerce),
 					...letVars || {}
 				},
 				pipeline: autoPipeline,
@@ -316,7 +347,7 @@ var LookupBuilder = class LookupBuilder {
 			let effectiveLet = letVars;
 			let effectivePipeline = safePipeline;
 			if (localField && foreignField && !letVars) {
-				effectiveLet = { lookupJoinVal: `$${localField}` };
+				effectiveLet = { lookupJoinVal: localCorrelation(localField, coerce) };
 				effectivePipeline = [{ $match: { $expr: { $eq: [`$${foreignField}`, "$$lookupJoinVal"] } } }, ...safePipeline];
 			}
 			lookupStage = { $lookup: {
@@ -371,6 +402,17 @@ var LookupBuilder = class LookupBuilder {
 			const builder = new LookupBuilder(lookup.from).localField(lookup.localField).foreignField(lookup.foreignField);
 			if (lookup.as) builder.as(lookup.as);
 			if (lookup.single) builder.single(lookup.single);
+			/**
+			* Coercion, for the SIMPLE branch below (no select / pipeline / where):
+			* there `build()` auto-generates the correlation and reads this flag.
+			*
+			* The pipeline branch sets its own `let` explicitly and therefore coerces
+			* at THAT assignment instead — see `lookupJoinVal` further down. Both
+			* exist because `multiple()` hand-assembles stages rather than deferring
+			* to `build()`, so each of its two paths must be covered separately; a
+			* fix to one silently leaves the other matching nothing.
+			*/
+			if (lookup.coerce) builder.coerce(lookup.coerce);
 			const stages = [];
 			const appendCallerStages = (raw) => {
 				if (raw.length === 0) return;
@@ -385,7 +427,7 @@ var LookupBuilder = class LookupBuilder {
 				if (lookup.select) stages.push({ $project: compileSelectToProjection(lookup.select) });
 				builder.pipeline(stages);
 				builder.let({
-					lookupJoinVal: `$${lookup.localField}`,
+					lookupJoinVal: localCorrelation(lookup.localField, lookup.coerce),
 					...lookup.let || {}
 				});
 				builder.sanitize(false);
@@ -413,6 +455,7 @@ var LookupBuilder = class LookupBuilder {
 			if (lookup.single !== void 0) builder.single(lookup.single);
 			if (lookup.pipeline) builder.pipeline(lookup.pipeline);
 			if (lookup.let) builder.let(lookup.let);
+			if (lookup.coerce) builder.coerce(lookup.coerce);
 			return builder.build();
 		});
 	}

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

@@ -1,5 +1,5 @@
-import { c as ALL_OPERATIONS, u as OP_REGISTRY } from "./Repository-X7U2d0kU.mjs";
-import { _ as upsert } from "./update-DHdXdOk_.mjs";
+import { c as ALL_OPERATIONS, u as OP_REGISTRY } from "./Repository-Cx7BwvDA.mjs";
+import { _ as upsert } from "./update-w5i-pa_c.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";

package/package.json

@@ -1,193 +1,193 @@
-{
-  "name": "@classytic/mongokit",
-  "version": "3.30.0",
-  "description": "Production-grade MongoDB repositories - smart pagination, events, and plugins. Built on @classytic/repo-core.",
-  "type": "module",
-  "sideEffects": false,
-  "main": "./dist/index.mjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.mts",
-      "default": "./dist/index.mjs"
-    },
-    "./pagination": {
-      "types": "./dist/pagination/PaginationEngine.d.mts",
-      "default": "./dist/pagination/PaginationEngine.mjs"
-    },
-    "./plugins": {
-      "types": "./dist/plugins/index.d.mts",
-      "default": "./dist/plugins/index.mjs"
-    },
-    "./utils": {
-      "types": "./dist/utils/index.d.mts",
-      "default": "./dist/utils/index.mjs"
-    },
-    "./actions": {
-      "types": "./dist/actions/index.d.mts",
-      "default": "./dist/actions/index.mjs"
-    },
-    "./ai": {
-      "types": "./dist/ai/index.d.mts",
-      "default": "./dist/ai/index.mjs"
-    },
-    "./adapter": {
-      "types": "./dist/adapter/index.d.mts",
-      "default": "./dist/adapter/index.mjs"
-    },
-    "./better-auth": {
-      "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"
-    },
-    "./usage": {
-      "types": "./dist/usage/index.d.mts",
-      "default": "./dist/usage/index.mjs"
-    },
-    "./query/primitives/geo": {
-      "types": "./dist/query/primitives/geo.d.mts",
-      "default": "./dist/query/primitives/geo.mjs"
-    },
-    "./query/primitives/coercion": {
-      "types": "./dist/query/primitives/coercion.d.mts",
-      "default": "./dist/query/primitives/coercion.mjs"
-    },
-    "./query/primitives/indexes": {
-      "types": "./dist/query/primitives/indexes.d.mts",
-      "default": "./dist/query/primitives/indexes.mjs"
-    },
-    "./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",
-    "TRADEMARK.md"
-  ],
-  "keywords": [
-    "mongodb",
-    "mongoose",
-    "repository",
-    "repository-pattern",
-    "data-access",
-    "pagination",
-    "cursor-pagination",
-    "infinite-scroll",
-    "offset-pagination",
-    "keyset-pagination",
-    "caching",
-    "redis",
-    "cache",
-    "multi-tenant",
-    "multi-tenancy",
-    "vector-search",
-    "embeddings",
-    "atlas-search",
-    "observability",
-    "event-driven",
-    "plugin-based",
-    "zero-dependencies",
-    "express",
-    "fastify",
-    "nestjs",
-    "nextjs",
-    "typescript"
-  ],
-  "author": "Classytic <classytic.dev@gmail.com> (https://github.com/classytic)",
-  "contributors": [
-    "Sadman Chowdhury (https://github.com/siam923)"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/classytic/mongokit.git"
-  },
-  "bugs": {
-    "url": "https://github.com/classytic/mongokit/issues"
-  },
-  "homepage": "https://github.com/classytic/mongokit#readme",
-  "peerDependencies": {
-    "@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"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "test": "vitest run --project unit --project integration",
-    "test:unit": "vitest run --project unit",
-    "test:integration": "vitest run --project integration",
-    "test:e2e": "vitest run --project e2e",
-    "test:all": "vitest run --project unit --project integration --project e2e",
-    "test:watch": "vitest --project unit --project integration",
-    "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit",
-    "typecheck:tests": "tsc --noEmit -p tsconfig.tests.json",
-    "lint": "biome check src/",
-    "lint:fix": "biome check src/ --write",
-    "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 run check:forgotten-exports && npm test",
-    "push": "classytic-push",
-    "prepublishOnly": "npm run ci",
-    "publish:dry": "npm publish --dry-run --access public",
-    "publish:npm": "npm publish --access public",
-    "release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
-    "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",
-    "check:forgotten-exports": "node scripts/check-forgotten-exports.mjs"
-  },
-  "devDependencies": {
-    "@arethetypeswrong/cli": "^0.18.2",
-    "@better-auth/api-key": "^1.6.22",
-    "@better-auth/mongo-adapter": "^1.6.22",
-    "@biomejs/biome": "^2.4.10",
-    "@classytic/dev-tools": "^0.2.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.31.0",
-    "mongodb": "^7.5.0",
-    "mongodb-memory-server": "^10.4.3",
-    "mongoose": "^9.9.1",
-    "publint": "^0.3.18",
-    "tsdown": "^0.22.14",
-    "typescript": "~5.9.0",
-    "vitest": "^4.1.4"
-  }
-}
+{
+  "name": "@classytic/mongokit",
+  "version": "3.31.1",
+  "description": "Production-grade MongoDB repositories - smart pagination, events, and plugins. Built on @classytic/repo-core.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./pagination": {
+      "types": "./dist/pagination/PaginationEngine.d.mts",
+      "default": "./dist/pagination/PaginationEngine.mjs"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.mts",
+      "default": "./dist/plugins/index.mjs"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.mts",
+      "default": "./dist/utils/index.mjs"
+    },
+    "./actions": {
+      "types": "./dist/actions/index.d.mts",
+      "default": "./dist/actions/index.mjs"
+    },
+    "./ai": {
+      "types": "./dist/ai/index.d.mts",
+      "default": "./dist/ai/index.mjs"
+    },
+    "./adapter": {
+      "types": "./dist/adapter/index.d.mts",
+      "default": "./dist/adapter/index.mjs"
+    },
+    "./better-auth": {
+      "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"
+    },
+    "./usage": {
+      "types": "./dist/usage/index.d.mts",
+      "default": "./dist/usage/index.mjs"
+    },
+    "./query/primitives/geo": {
+      "types": "./dist/query/primitives/geo.d.mts",
+      "default": "./dist/query/primitives/geo.mjs"
+    },
+    "./query/primitives/coercion": {
+      "types": "./dist/query/primitives/coercion.d.mts",
+      "default": "./dist/query/primitives/coercion.mjs"
+    },
+    "./query/primitives/indexes": {
+      "types": "./dist/query/primitives/indexes.d.mts",
+      "default": "./dist/query/primitives/indexes.mjs"
+    },
+    "./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",
+    "TRADEMARK.md"
+  ],
+  "keywords": [
+    "mongodb",
+    "mongoose",
+    "repository",
+    "repository-pattern",
+    "data-access",
+    "pagination",
+    "cursor-pagination",
+    "infinite-scroll",
+    "offset-pagination",
+    "keyset-pagination",
+    "caching",
+    "redis",
+    "cache",
+    "multi-tenant",
+    "multi-tenancy",
+    "vector-search",
+    "embeddings",
+    "atlas-search",
+    "observability",
+    "event-driven",
+    "plugin-based",
+    "zero-dependencies",
+    "express",
+    "fastify",
+    "nestjs",
+    "nextjs",
+    "typescript"
+  ],
+  "author": "Classytic <classytic.dev@gmail.com> (https://github.com/classytic)",
+  "contributors": [
+    "Sadman Chowdhury (https://github.com/siam923)"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/classytic/mongokit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/classytic/mongokit/issues"
+  },
+  "homepage": "https://github.com/classytic/mongokit#readme",
+  "peerDependencies": {
+    "@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"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run --project unit --project integration",
+    "test:unit": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "test:e2e": "vitest run --project e2e",
+    "test:all": "vitest run --project unit --project integration --project e2e",
+    "test:watch": "vitest --project unit --project integration",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "typecheck:tests": "tsc --noEmit -p tsconfig.tests.json",
+    "lint": "biome check src/",
+    "lint:fix": "biome check src/ --write",
+    "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 run check:forgotten-exports && npm test",
+    "push": "classytic-push",
+    "prepublishOnly": "npm run ci",
+    "publish:dry": "npm publish --dry-run --access public",
+    "publish:npm": "npm publish --access public",
+    "release:tag": "node -e \"require('child_process').execSync('npm run push -- v'+require('./package.json').version,{stdio:'inherit'})\"",
+    "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",
+    "check:forgotten-exports": "node scripts/check-forgotten-exports.mjs"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@better-auth/api-key": "^1.6.22",
+    "@better-auth/mongo-adapter": "^1.6.22",
+    "@biomejs/biome": "^2.4.10",
+    "@classytic/dev-tools": "^0.2.0",
+    "@classytic/repo-core": "^0.21.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.31.0",
+    "mongodb": "^7.5.0",
+    "mongodb-memory-server": "^10.4.3",
+    "mongoose": "^9.9.1",
+    "publint": "^0.3.18",
+    "tsdown": "^0.22.14",
+    "typescript": "~5.9.0",
+    "vitest": "^4.1.4"
+  }
+}