@classytic/mongokit 3.19.0 → 3.20.0

package/dist/{create-repository-K0yft2ht.d.mts → create-repository-0TkQhcv-.d.mts}

@@ -1,13 +1,12 @@
-import { B as ObjectId, Dt as LookupOptions, Et as LookupBuilder, H as OperationOptions, J as PopulateSpec, M as LookupPopulateOptions, N as LookupPopulateResult, P as Middleware, Q as RepositoryContext, U as PaginationConfig, X as ReadOptions, Y as PrioritizedHook, Z as ReadPreferenceType, _ as DeleteManyResult, at as SessionOptions, c as CacheableOptions, d as CollationOptions, ft as UpdateManyResult, it as SelectSpec, j as Logger, n as AggregatePaginationOptions, nt as RepositoryOptions, p as CreateOptions, pt as UpdateOptions, q as PluginType, st as SoftDeleteOptions, t as AggregateOptions, ut as SortSpec$1, v as DeleteResult, w as FindOneAndUpdateOptions, xt as WithTransactionOptions } from "./types-BA8oXjFe.mjs";
-import { _ as RepositoryCachePluginOptions, i as CustomIdOptions, t as MultiTenantOptions, w as AuditTrailOptions } from "./multi-tenant.plugin-D6lw3BsI.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-4SjzfBQE.mjs";
-import { AggPaginationRequest, AggRequest, AggResult, ChangeEvent, FilterInput, KeysetAggPaginationResult, QueryOptions, RepoCapabilities, RepositoryBase, TenantPurgeOptions, TenantPurgeResult, TenantPurgeStrategy, WatchOptions } from "@classytic/repo-core/repository";
-import * as _$mongoose from "mongoose";
-import { Expression, Model, PipelineStage, PopulateOptions } from "mongoose";
+import { B as ObjectId, Dt as LookupOptions, Et as LookupBuilder, H as OperationOptions, J as PopulateSpec, M as LookupPopulateOptions, N as LookupPopulateResult, P as Middleware, Q as RepositoryContext, U as PaginationConfig, X as ReadOptions, Y as PrioritizedHook, Z as ReadPreferenceType, _ as DeleteManyResult, at as SessionOptions, c as CacheableOptions, d as CollationOptions, ft as UpdateManyResult, it as SelectSpec, j as Logger, n as AggregatePaginationOptions, nt as RepositoryOptions, p as CreateOptions, pt as UpdateOptions, q as PluginType, st as SoftDeleteOptions, t as AggregateOptions, ut as SortSpec$1, v as DeleteResult, w as FindOneAndUpdateOptions, xt as WithTransactionOptions } from "./types-DNFMofHy.mjs";
+import { _ as RepositoryCachePluginOptions, i as CustomIdOptions, t as MultiTenantOptions, w as AuditTrailOptions } from "./multi-tenant.plugin-CTsWz0XK.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-DYpOD2wY.mjs";
+import { AggPaginationRequest, AggRequest, AggResult, ArchiveOptions, ArchiveResult, ArchiveSink, ChangeEvent, FilterInput, KeysetAggPaginationResult, QueryOptions, RepoCapabilities, RepositoryBase, TenantPurgeOptions, TenantPurgeResult, TenantPurgeStrategy, WatchOptions } from "@classytic/repo-core/repository";
+import { ClientSession, Expression, Model, PipelineStage, PopulateOptions } from "mongoose";
+import { Filter } from "@classytic/repo-core/filter";
 import { UpdateInput } from "@classytic/repo-core/update";
 import { AggregatePaginationResult, KeysetPaginationResult, OffsetPaginationResult, OffsetPaginationResultCore } from "@classytic/repo-core/pagination";
 import { HttpError } from "@classytic/repo-core/errors";
-
 //#region src/query/AggregationBuilder.d.ts
 /** Options for $vectorSearch stage (Atlas only) */
 interface VectorSearchOptions {
@@ -68,7 +67,7 @@ declare class AggregationBuilder {
    *   .exec(MyModel);
    * ```
    */
-  exec<T = unknown>(model: Model<any>, session?: _$mongoose.ClientSession): Promise<T[]>;
+  exec<T = unknown>(model: Model<any>, session?: import('mongoose').ClientSession): Promise<T[]>;
   /**
    * Reset the pipeline
    */
@@ -428,6 +427,52 @@ declare class AggregationBuilder {
    */
   static startWith(query: Record<string, unknown>): AggregationBuilder;
 }
+/**
+ * Optimized Aggregation Patterns for Scale
+ *
+ * 1. **Early Filtering** - Always place $match as early as possible:
+ *    ```typescript
+ *    new AggregationBuilder()
+ *      .match({ status: 'active' })  // ✅ Filter first
+ *      .lookup(...)                  // Then join
+ *      .sort(...)
+ *    ```
+ *
+ * 2. **Index Usage** - Ensure indexes on:
+ *    - Fields in $match
+ *    - Fields in $sort (especially with $limit)
+ *    - Fields in $lookup (both local and foreign)
+ *
+ * 3. **Projection** - Remove unnecessary fields early:
+ *    ```typescript
+ *    .project({ password: 0, internalNotes: 0 })  // Remove before joins
+ *    .lookup(...)
+ *    ```
+ *
+ * 4. **Faceted Pagination** - Get count and data in one query:
+ *    ```typescript
+ *    .facet({
+ *      metadata: [{ $count: 'total' }],
+ *      data: [{ $skip: skip }, { $limit: limit }]
+ *    })
+ *    ```
+ *
+ * 5. **allowDiskUse** - For large datasets:
+ *    ```typescript
+ *    new AggregationBuilder()
+ *      .match({ status: 'active' })
+ *      .allowDiskUse()
+ *      .exec(Model)
+ *    ```
+ *
+ * 6. **Vector Search** - Semantic similarity (Atlas only):
+ *    ```typescript
+ *    new AggregationBuilder()
+ *      .vectorSearch({ index: 'vec_idx', path: 'embedding', queryVector: vec, limit: 10 })
+ *      .withVectorScore()
+ *      .exec(Model)
+ *    ```
+ */
 //#endregion
 //#region src/Repository.d.ts
 /**
@@ -649,6 +694,36 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
    * Get document by ID
    */
   getById(id: string | ObjectId, options?: CacheableOptions): Promise<TDoc | null>;
+  /**
+   * Batch point-read — the `$in` counterpart to {@link getById}. Fetches every
+   * doc whose id (the repo's `idField`, default `_id`) is in `ids` in ONE query,
+   * routed through `findAll` so tenant + soft-delete scoping and hooks apply
+   * exactly as a single read would. Returns a Map keyed by the stringified id;
+   * ids are de-duplicated and ids with no matching doc are simply absent (no
+   * throw — mirrors `getById(..., { throwOnNotFound: false })`). Structurally
+   * INVALID ids (wrong ObjectId shape, non-numeric for a Number id field, ...)
+   * are dropped the same way — an id that cannot exist in the collection is
+   * unambiguously a miss, and one malformed id must never poison the rest of
+   * the batch. Lean by default (findAll semantics) — pass `{ lean: false }`
+   * for hydrated docs.
+   *
+   * The N+1 killer for hosts that resolve many ids in one tick (order-line
+   * snapshotting, availability matrices, dashboard row enrichment):
+   *
+   * @example
+   * const byId = await repo.getByIds(offerIds, ctx);
+   * const doc = byId.get(offerId); // O(1); undefined if not found
+   *
+   * Sizing: there is no library-imposed cap — the bounds are MongoDB's (the
+   * `$in` array must fit the 16 MB query document; `$in` on an indexed field
+   * is n point-lookups). Keep batches ≤ ~10k ids per call and chunk beyond
+   * that. Don't exclude the id field via `select` — result keys derive from
+   * it.
+   */
+  getByIds(ids: ReadonlyArray<string | ObjectId>, options?: OperationOptions & {
+    sort?: SortSpec$1 | string;
+    limit?: number;
+  }): Promise<Map<string, TDoc>>;
   /**
    * Get single document by query
    */
@@ -793,10 +868,14 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
     hint?: string | Record<string, 1 | -1>;
     maxTimeMS?: number;
     countStrategy?: 'exact' | 'estimated' | 'none';
-    readPreference?: ReadPreferenceType; /** Advanced populate options (from QueryParser or Arc's BaseController) */
-    populateOptions?: PopulateOptions[]; /** Collation for locale-aware string comparison */
-    collation?: CollationOptions; /** Lookup configurations for $lookup joins (from QueryParser or manual) */
-    lookups?: LookupOptions[]; /** Skip pagination entirely — returns raw TDoc[] (same as findAll) */
+    readPreference?: ReadPreferenceType;
+    /** Advanced populate options (from QueryParser or Arc's BaseController) */
+    populateOptions?: PopulateOptions[];
+    /** Collation for locale-aware string comparison */
+    collation?: CollationOptions;
+    /** Lookup configurations for $lookup joins (from QueryParser or manual) */
+    lookups?: LookupOptions[];
+    /** Skip pagination entirely — returns raw TDoc[] (same as findAll) */
     noPagination?: boolean;
   }, options?: CacheableOptions): Promise<OffsetPaginationResult<TDoc> | KeysetPaginationResult<TDoc> | TDoc[]>;
   /**
@@ -1233,7 +1312,8 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
    */
   delete(id: string | ObjectId, options?: SessionOptions & {
     idField?: string;
-    mode?: 'hard' | 'soft'; /** Legacy opt-in: throw a 404 error on miss instead of returning `null`. */
+    mode?: 'hard' | 'soft';
+    /** Legacy opt-in: throw a 404 error on miss instead of returning `null`. */
     throwOnNotFound?: boolean;
   }): Promise<DeleteResult | null>;
   /**
@@ -1287,6 +1367,20 @@ declare class Repository<TDoc = unknown> extends RepositoryBase {
    * the port implementation.
    */
   purgeByField(field: string, value: unknown, strategy: TenantPurgeStrategy, options?: TenantPurgeOptions): Promise<TenantPurgeResult>;
+  /**
+   * Chunked cold-storage extraction — see `StandardRepo.archiveByFilter`
+   * for the cross-kit contract (write-before-delete, at-least-once,
+   * duplicate-tolerant sinks). Mongokit composes the kit-agnostic
+   * `runChunkedArchive` orchestrator with `createMongoArchivePort`
+   * (`_id`-ordered lean reads + plugin-routed deleteMany removal). See
+   * [actions/archive.ts](./actions/archive.ts) for the port.
+   *
+   * Accepts Filter IR or a Mongo-shaped filter record — compiled once via
+   * `compileFilterToMongo`, same dual-dialect rule as every other verb.
+   */
+  archiveByFilter(filter: Record<string, unknown> | Filter, sink: ArchiveSink<TDoc>, options?: ArchiveOptions & {
+    session?: ClientSession;
+  }): Promise<ArchiveResult>;
   /**
    * Kit-native aggregation pipeline — takes a MongoDB stage array and
    * returns the raw pipeline output. Use this for `$lookup`, `$unwind`,

package/dist/{create-repository-D5YX0wGs.mjs → create-repository-CJATiAKX.mjs}

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

package/dist/{id-resolution-CnN0YA8t.mjs → id-resolution-P2OzcyRl.mjs}

@@ -25,9 +25,10 @@ function isObjectIdInstance(instance) {
 }
 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 /**
-* Detect the _id path type from a Mongoose schema.
+* Detect an id path's type from a Mongoose schema. Defaults to the `_id`
+* path; pass `field` to resolve a custom id field (Repository's `idField`).
 *
-* Returns 'objectid' as the safe default when:
+* For `_id`, returns 'objectid' as the safe default when:
 *   - No schema is provided (mock models, test harnesses)
 *   - The schema has no `paths._id` (auto-generated ObjectId)
 *   - The instance string is unrecognized
@@ -35,10 +36,14 @@ const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/
 * This safe-default means existing callers that don't set _id explicitly
 * get the same ObjectId validation they always had — the behavioral change
 * is strictly opt-in via schema declaration.
+*
+* For a custom `field` with no resolvable path, returns 'unknown' instead —
+* custom id fields carry no ObjectId convention, so validation stays
+* permissive and the DB remains the authority.
 */
-function getSchemaIdType(schema) {
-	const instance = schema?.paths?._id?.instance;
-	if (!instance) return "objectid";
+function getSchemaIdType(schema, field = "_id") {
+	const instance = schema?.paths?.[field]?.instance;
+	if (!instance) return field === "_id" ? "objectid" : "unknown";
 	if (isObjectIdInstance(instance)) return "objectid";
 	switch (instance) {
 		case "String": return "string";

package/dist/{index-BgSBwlWu.d.mts → index-Cg3SWugF.d.mts}

@@ -1,7 +1,5 @@
-import { B as ObjectId, Dt as LookupOptions, H as OperationOptions, I as MinMaxResult, J as PopulateSpec, T as GroupResult, Z as ReadPreferenceType, ft as UpdateManyResult, ht as UpdateWithValidationResult, i as AnyDocument, it as SelectSpec, p as CreateOptions, pt as UpdateOptions, ut as SortSpec, v as DeleteResult, w as FindOneAndUpdateOptions } from "./types-BA8oXjFe.mjs";
+import { B as ObjectId, Dt as LookupOptions, H as OperationOptions, I as MinMaxResult, J as PopulateSpec, T as GroupResult, Z as ReadPreferenceType, ft as UpdateManyResult, ht as UpdateWithValidationResult, i as AnyDocument, it as SelectSpec, p as CreateOptions, pt as UpdateOptions, ut as SortSpec, v as DeleteResult, w as FindOneAndUpdateOptions } from "./types-DNFMofHy.mjs";
 import { Model, PipelineStage } from "mongoose";
-
-//#region src/actions/aggregate.d.ts
 declare namespace aggregate_d_exports {
   export { aggregate, aggregatePaginate, average, countBy, distinct, facet, groupBy, lookup, minMax, sum, unwind };
 }

package/dist/index.d.mts

@@ -1,15 +1,14 @@
-import { $ as RepositoryEvent, A as KeysetPaginationOptions, B as ObjectId, C as FieldPreset, Ct as IControllerResponse, D as InferDocument, Dt as LookupOptions, E as HookMode, Et as LookupBuilder, F as MiddlewareContext, G as Plugin, H as OperationOptions, I as MinMaxResult, J as PopulateSpec, K as PluginFunction, L as MinimalRepoView, M as LookupPopulateOptions, N as LookupPopulateResult, O as InferRawDoc, P as Middleware, Q as RepositoryContext, R as MongoOperatorUpdate, S as EventPhase, St as IController, T as GroupResult, Tt as IResponseFormatter, U as PaginationConfig, V as OffsetPaginationOptions, W as PartialBy, X as ReadOptions, Y as PrioritizedHook, Z as ReadPreferenceType, _t as ValidationChainOptions, a as AnyModel, at as SessionOptions, b as EventHandlers, bt as WithPlugins, c as CacheableOptions, ct as SoftDeleteRepository, d as CollationOptions, dt as Strict, et as RepositoryInstance, f as CreateInput, ft as UpdateManyResult, g as DeepPartial, gt as UserContext, h as DecodedCursor, ht as UpdateWithValidationResult, i as AnyDocument, it as SelectSpec, j as Logger, k as KeysOfType, l as CascadeOptions, lt as SortDirection, m as CursorPayload, mt as UpdatePatch, n as AggregatePaginationOptions, nt as RepositoryOptions, o as BasePaginationOptions, ot as SoftDeleteFilterMode, p as CreateOptions, pt as UpdateOptions, q as PluginType, r as AllPluginMethods, rt as RequiredBy, s as CacheOperationOptions, st as SoftDeleteOptions, t as AggregateOptions, tt as RepositoryOperation, u as CascadeRelation, ut as SortSpec, v as DeleteResult, vt as ValidatorDefinition, w as FindOneAndUpdateOptions, wt as IRequestContext, x as EventPayload, xt as WithTransactionOptions, y as DocField, yt as ValueType, z as NonNullableFields } from "./types-BA8oXjFe.mjs";
-import { t as index_d_exports } from "./index-BgSBwlWu.mjs";
-import { C as AuditTrailMethods, E as auditTrailPlugin, S as AuditQueryResult, T as AuditTrailQuery, _ 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, 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 AuditTrailOptions, x as AuditQueryOptions, y as AuditEntry } from "./multi-tenant.plugin-D6lw3BsI.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-4SjzfBQE.mjs";
-import { a as Repository, i as HOOK_PRIORITY, n as CreateRepositoryConfig, o as AggregationBuilder, r as createRepository, t as AuditConfig } from "./create-repository-K0yft2ht.mjs";
-import { A as BulkWriteResult, C as LeasePluginOptions, D as elasticSearchPlugin, E as ElasticSearchOptions, M as auditLogPlugin, N as AggregateHelpersMethods, O as cascadePlugin, P as aggregateHelpersPlugin, S as LeaseMethods, T as fieldFilterPlugin, _ as observabilityPlugin, a as uniqueField, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as batchOperationsPlugin, k as BatchOperationsMethods, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin } from "./validation-chain.plugin-CYOPfFGF.mjs";
-import { n as SchemaPathsLike, t as FieldType$1 } from "./coercion-BxxHyLjP.mjs";
-import { n as SchemaIndexes } from "./indexes-3eHBWNZ2.mjs";
-import { d as filterResponseData, f as getFieldsForUser, g as parseDuplicateKeyError, h as isDuplicateKeyError, i as configureLogger, m as createError, n as buildCrudSchemasFromMongooseSchema, p as getMongooseProjection, r as createMemoryCache, s as idVariants, t as buildCrudSchemasFromModel, u as createFieldPreset } from "./mongooseToJsonSchema-Bz47aMfH.mjs";
+import { $ as RepositoryEvent, A as KeysetPaginationOptions, B as ObjectId, C as FieldPreset, Ct as IControllerResponse, D as InferDocument, Dt as LookupOptions, E as HookMode, Et as LookupBuilder, F as MiddlewareContext, G as Plugin, H as OperationOptions, I as MinMaxResult, J as PopulateSpec, K as PluginFunction, L as MinimalRepoView, M as LookupPopulateOptions, N as LookupPopulateResult, O as InferRawDoc, P as Middleware, Q as RepositoryContext, R as MongoOperatorUpdate, S as EventPhase, St as IController, T as GroupResult, Tt as IResponseFormatter, U as PaginationConfig, V as OffsetPaginationOptions, W as PartialBy, X as ReadOptions, Y as PrioritizedHook, Z as ReadPreferenceType, _t as ValidationChainOptions, a as AnyModel, at as SessionOptions, b as EventHandlers, bt as WithPlugins, c as CacheableOptions, ct as SoftDeleteRepository, d as CollationOptions, dt as Strict, et as RepositoryInstance, f as CreateInput, ft as UpdateManyResult, g as DeepPartial, gt as UserContext, h as DecodedCursor, ht as UpdateWithValidationResult, i as AnyDocument, it as SelectSpec, j as Logger, k as KeysOfType, l as CascadeOptions, lt as SortDirection, m as CursorPayload, mt as UpdatePatch, n as AggregatePaginationOptions, nt as RepositoryOptions, o as BasePaginationOptions, ot as SoftDeleteFilterMode, p as CreateOptions, pt as UpdateOptions, q as PluginType, r as AllPluginMethods, rt as RequiredBy, s as CacheOperationOptions, st as SoftDeleteOptions, t as AggregateOptions, tt as RepositoryOperation, u as CascadeRelation, ut as SortSpec, v as DeleteResult, vt as ValidatorDefinition, w as FindOneAndUpdateOptions, wt as IRequestContext, x as EventPayload, xt as WithTransactionOptions, y as DocField, yt as ValueType, z as NonNullableFields } from "./types-DNFMofHy.mjs";
+import { t as index_d_exports } from "./index-Cg3SWugF.mjs";
+import { C as AuditTrailMethods, E as auditTrailPlugin, S as AuditQueryResult, T as AuditTrailQuery, _ 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, 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 AuditTrailOptions, x as AuditQueryOptions, y as AuditEntry } from "./multi-tenant.plugin-CTsWz0XK.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-DYpOD2wY.mjs";
+import { a as Repository, i as HOOK_PRIORITY, n as CreateRepositoryConfig, o as AggregationBuilder, r as createRepository, t as AuditConfig } from "./create-repository-0TkQhcv-.mjs";
+import { A as BulkWriteResult, C as LeasePluginOptions, D as elasticSearchPlugin, E as ElasticSearchOptions, M as auditLogPlugin, N as AggregateHelpersMethods, O as cascadePlugin, P as aggregateHelpersPlugin, S as LeaseMethods, T as fieldFilterPlugin, _ as observabilityPlugin, a as uniqueField, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as batchOperationsPlugin, k as BatchOperationsMethods, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin } from "./validation-chain.plugin-buy3uvyk.mjs";
+import { n as SchemaPathsLike, t as FieldType$1 } from "./coercion-BjdPX3YF.mjs";
+import { n as SchemaIndexes } from "./indexes-DIjMpYES.mjs";
+import { d as filterResponseData, f as getFieldsForUser, g as parseDuplicateKeyError, h as isDuplicateKeyError, i as configureLogger, m as createError, n as buildCrudSchemasFromMongooseSchema, p as getMongooseProjection, r as createMemoryCache, s as idVariants, t as buildCrudSchemasFromModel, u as createFieldPreset } from "./mongooseToJsonSchema-D2CyAMIC.mjs";
 import { RepoCapabilities } from "@classytic/repo-core/repository";
 import { ClientSession, PipelineStage } from "mongoose";
-
 //#region src/actions/cascade-references.d.ts
 type PurgeMode = 'hard' | 'soft' | 'anonymize';
 /** Raw collection surface — a native MongoDB `Collection` or a Mongoose `Model`. */

package/dist/index.mjs

@@ -1,18 +1,18 @@
-import { n as idVariants } from "./id-resolution-CnN0YA8t.mjs";
-import { a as withTransaction, c as MUTATING_OPERATIONS, d as operationsByPolicyKey, f as MONGOKIT_CAPABILITIES, i as isTransactionUnsupported, l as OP_REGISTRY, n as Repository, o as AggregationBuilder, p as createMongoPurgePort, r as batchTransaction, s as ALL_OPERATIONS, t as HOOK_PRIORITY, u as READ_OPERATIONS } from "./Repository-B01VW_fU.mjs";
-import { b as LookupBuilder, x as compileFilterToMongo } from "./update-CvCMv5Cl.mjs";
-import { n as warn, t as configureLogger } from "./logger-B8wf-Mtb.mjs";
-import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-BTeepSNL.mjs";
+import { n as idVariants } from "./id-resolution-P2OzcyRl.mjs";
+import { a as withTransaction, c as MUTATING_OPERATIONS, d as operationsByPolicyKey, f as MONGOKIT_CAPABILITIES, i as isTransactionUnsupported, l as OP_REGISTRY, n as Repository, o as AggregationBuilder, p as createMongoPurgePort, r as batchTransaction, s as ALL_OPERATIONS, t as HOOK_PRIORITY, u as READ_OPERATIONS } from "./Repository-dbbgOGjK.mjs";
+import { b as LookupBuilder, x as compileFilterToMongo } from "./update-1Lq9OMD2.mjs";
+import { n as warn, t as configureLogger } from "./logger-K7dPmu2U.mjs";
+import { n as isDuplicateKeyError, r as parseDuplicateKeyError, t as createError } from "./error-BuByZwKU.mjs";
 import { t as actions_exports } from "./actions/index.mjs";
-import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, h as auditLogPlugin, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, r as adminBypass, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "./timestamp.plugin-B1A9U-P7.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-BcvaXBQ-.mjs";
+import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, h as auditLogPlugin, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, r as adminBypass, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "./timestamp.plugin-nG9Z1JEk.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-BT1ywu9k.mjs";
 import { isGeoOperator, parseGeoFilter } from "./query/primitives/geo.mjs";
-import { t as createRepository } from "./create-repository-D5YX0wGs.mjs";
-import { a as uniqueField, c as subdocumentPlugin, d as leasePlugin, f as fieldFilterPlugin, h as aggregateHelpersPlugin, i as requireField, l as observabilityPlugin, m as cascadePlugin, n as blockIf, o as validationChainPlugin, p as elasticSearchPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as mongoOperationsPlugin } from "./validation-chain.plugin-DHZbpb4t.mjs";
-import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "./field-selection-d1qdRiMr.mjs";
+import { t as createRepository } from "./create-repository-CJATiAKX.mjs";
+import { a as uniqueField, c as subdocumentPlugin, d as leasePlugin, f as fieldFilterPlugin, h as aggregateHelpersPlugin, i as requireField, l as observabilityPlugin, m as cascadePlugin, n as blockIf, o as validationChainPlugin, p as elasticSearchPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as mongoOperationsPlugin } from "./validation-chain.plugin-Dn_wZYLA.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";
-import { n as buildCrudSchemasFromMongooseSchema, r as createMemoryCache, t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-ChtXSrLT.mjs";
+import { n as buildCrudSchemasFromMongooseSchema, r as createMemoryCache, t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-khdzVo8x.mjs";
 import { runChunkedPurge } from "@classytic/repo-core/repository";
 import { isControlParam } from "@classytic/repo-core/query-parser";
 //#region src/actions/cascade-references.ts
@@ -226,7 +226,7 @@ async function cascadePurgeReferences(options) {
 * without this guard. Kept as a Set for O(1) lookup; values mirror the
 * reserved-key list at the top of `_parseFilters`.
 */
-const RESERVED_PAGINATION_KEYS = new Set([
+const RESERVED_PAGINATION_KEYS = /* @__PURE__ */ new Set([
 	"page",
 	"limit",
 	"sort",
@@ -1043,7 +1043,7 @@ var QueryParser = class {
 			return {};
 		}
 		const sanitized = {};
-		const logicalArrayOps = new Set([
+		const logicalArrayOps = /* @__PURE__ */ new Set([
 			"$or",
 			"$and",
 			"$nor"
@@ -1421,6 +1421,44 @@ function systemContext(extra) {
 }
 //#endregion
 //#region src/index.ts
+/**
+* MongoKit - Event-driven repository pattern for MongoDB
+*
+* Production-grade MongoDB repositories with zero dependencies -
+* smart pagination, events, and plugins.
+*
+* @module @classytic/mongokit
+* @author Classytic (https://github.com/classytic)
+* @license MIT
+*
+* @example
+* ```typescript
+* import { createRepository } from '@classytic/mongokit';
+*
+* // Create repository with declarative config (plugins composed in the
+* // canonical safe order automatically)
+* const userRepo = createRepository(UserModel, {
+*   timestamps: true,
+*   softDelete: true,
+* });
+*
+* // Create
+* const user = await userRepo.create({ name: 'John', email: 'john@example.com' });
+*
+* // Read with pagination (auto-detects offset vs keyset)
+* const users = await userRepo.getAll({ page: 1, limit: 20 });
+*
+* // Keyset pagination for infinite scroll
+* const stream = await userRepo.getAll({ sort: { createdAt: -1 }, limit: 50 });
+* const nextStream = await userRepo.getAll({ after: stream.next, sort: { createdAt: -1 } });
+*
+* // Update
+* await userRepo.update(user._id, { name: 'John Doe' });
+*
+* // Delete
+* await userRepo.delete(user._id);
+* ```
+*/
 var src_default = Repository;
 //#endregion
 export { ALL_OPERATIONS, AggregationBuilder, AuditTrailQuery, HOOK_PRIORITY, LookupBuilder, MONGOKIT_CAPABILITIES, MUTATING_OPERATIONS, OP_REGISTRY, PaginationEngine, QueryParser, READ_OPERATIONS, Repository, actions_exports as actions, adminBypass, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, batchTransaction, blockIf, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, cachePlugin, cascadePlugin, cascadePurgeReferences, compileFilterToMongo, configureLogger, createError, createFieldPreset, createMemoryCache, createOptionsExtractor, createRepository, createTenantContext, customIdPlugin, dateSequentialId, src_default as default, elasticSearchPlugin, fieldFilterPlugin, filterResponseData, getFieldsForUser, getMongooseProjection, getNextSequence, idVariants, immutableField, isDuplicateKeyError, isTransactionUnsupported, leasePlugin, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, operationsByPolicyKey, parseDuplicateKeyError, prefixedId, repoOptionsFromCtx, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, systemContext, timestampPlugin, uniqueField, validationChainPlugin, withTransaction };

package/dist/lock/index.d.mts

@@ -1,6 +1,5 @@
 import { Connection } from "mongoose";
 import { BaseLockAdapterOptions, LockAdapter } from "@classytic/repo-core/lock";
-
 //#region src/lock/index.d.ts
 /** Adapter-construction options. */
 interface MongoLockAdapterOptions extends BaseLockAdapterOptions {

package/dist/{mongooseToJsonSchema-Bz47aMfH.d.mts → mongooseToJsonSchema-D2CyAMIC.d.mts}

@@ -1,9 +1,8 @@
-import { C as FieldPreset, gt as UserContext } from "./types-BA8oXjFe.mjs";
+import { C as FieldPreset, gt as UserContext } from "./types-DNFMofHy.mjs";
 import mongoose, { Schema } from "mongoose";
 import { CacheAdapter } from "@classytic/repo-core/cache";
 import { CrudSchemas, SchemaBuilderOptions } from "@classytic/repo-core/schema";
 import { HttpError } from "@classytic/repo-core/errors";
-
 //#region src/utils/error.d.ts
 /** Optional structured fields for createError. */
 interface CreateErrorOptions {
@@ -170,9 +169,10 @@ interface SchemaLike {
   }>;
 }
 /**
- * Detect the _id path type from a Mongoose schema.
+ * Detect an id path's type from a Mongoose schema. Defaults to the `_id`
+ * path; pass `field` to resolve a custom id field (Repository's `idField`).
  *
- * Returns 'objectid' as the safe default when:
+ * For `_id`, returns 'objectid' as the safe default when:
  *   - No schema is provided (mock models, test harnesses)
  *   - The schema has no `paths._id` (auto-generated ObjectId)
  *   - The instance string is unrecognized
@@ -180,8 +180,12 @@ interface SchemaLike {
  * This safe-default means existing callers that don't set _id explicitly
  * get the same ObjectId validation they always had — the behavioral change
  * is strictly opt-in via schema declaration.
+ *
+ * For a custom `field` with no resolvable path, returns 'unknown' instead —
+ * custom id fields carry no ObjectId convention, so validation stays
+ * permissive and the DB remains the authority.
  */
-declare function getSchemaIdType(schema?: SchemaLike | null): IdType;
+declare function getSchemaIdType(schema?: SchemaLike | null, field?: string): IdType;
 /**
  * Validate an id value against a known _id type — WITHOUT hitting the DB.
  *

package/dist/{mongooseToJsonSchema-ChtXSrLT.mjs → mongooseToJsonSchema-khdzVo8x.mjs}

@@ -1,4 +1,4 @@
-import { r as isObjectIdInstance } from "./id-resolution-CnN0YA8t.mjs";
+import { r as isObjectIdInstance } from "./id-resolution-P2OzcyRl.mjs";
 import mongoose from "mongoose";
 import { applyFieldRules, collectFieldsToOmit } from "@classytic/repo-core/schema";
 //#region src/utils/memory-cache.ts

package/dist/{multi-tenant.plugin-D6lw3BsI.d.mts → multi-tenant.plugin-CTsWz0XK.d.mts}

@@ -1,8 +1,7 @@
-import { B as ObjectId, G as Plugin, Q as RepositoryContext } from "./types-BA8oXjFe.mjs";
+import { B as ObjectId, G as Plugin, Q as RepositoryContext } from "./types-DNFMofHy.mjs";
 import mongoose from "mongoose";
 import { CacheAdapter as CacheAdapter$1, CacheOptions, RepositoryCacheHandle, RepositoryCachePluginOptions, cachePlugin } from "@classytic/repo-core/cache";
 import { TenantConfig } from "@classytic/repo-core/tenant";
-
 //#region src/plugins/audit-trail.plugin.d.ts
 interface AuditTrailOptions {
   /** Operations to track (default: ['create', 'update', 'delete']) */

package/dist/pagination/PaginationEngine.d.mts

@@ -1,2 +1,2 @@
-import { t as PaginationEngine } from "../PaginationEngine-4SjzfBQE.mjs";
+import { t as PaginationEngine } from "../PaginationEngine-DYpOD2wY.mjs";
 export { PaginationEngine };

package/dist/pagination/PaginationEngine.mjs

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

package/dist/plugins/index.d.mts

@@ -1,8 +1,7 @@
-import { G as Plugin } from "../types-BA8oXjFe.mjs";
-import { C as AuditTrailMethods, E as auditTrailPlugin, S as AuditQueryResult, T as AuditTrailQuery, _ 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, l as customIdPlugin, m as CacheAdapter, o as IdGenerator, p as sequentialId, r as multiTenantPlugin, s as PrefixedIdOptions, t as MultiTenantOptions, u as dateSequentialId, v as cachePlugin, w as AuditTrailOptions, x as AuditQueryOptions, y as AuditEntry } from "../multi-tenant.plugin-D6lw3BsI.mjs";
-import { C as LeasePluginOptions, D as elasticSearchPlugin, E as ElasticSearchOptions, M as auditLogPlugin, N as AggregateHelpersMethods, O as cascadePlugin, P as aggregateHelpersPlugin, S as LeaseMethods, T as fieldFilterPlugin, _ as observabilityPlugin, a as uniqueField, b as MethodRegistryRepository, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as batchOperationsPlugin, k as BatchOperationsMethods, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin } from "../validation-chain.plugin-CYOPfFGF.mjs";
+import { G as Plugin } from "../types-DNFMofHy.mjs";
+import { C as AuditTrailMethods, E as auditTrailPlugin, S as AuditQueryResult, T as AuditTrailQuery, _ 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, l as customIdPlugin, m as CacheAdapter, o as IdGenerator, p as sequentialId, r as multiTenantPlugin, s as PrefixedIdOptions, t as MultiTenantOptions, u as dateSequentialId, v as cachePlugin, w as AuditTrailOptions, x as AuditQueryOptions, y as AuditEntry } from "../multi-tenant.plugin-CTsWz0XK.mjs";
+import { C as LeasePluginOptions, D as elasticSearchPlugin, E as ElasticSearchOptions, M as auditLogPlugin, N as AggregateHelpersMethods, O as cascadePlugin, P as aggregateHelpersPlugin, S as LeaseMethods, T as fieldFilterPlugin, _ as observabilityPlugin, a as uniqueField, b as MethodRegistryRepository, c as TenantContext, d as SubdocumentMethods, f as subdocumentPlugin, g as OperationMetric, h as ObservabilityOptions, i as requireField, j as batchOperationsPlugin, k as BatchOperationsMethods, l as TenantStore, m as softDeletePlugin, n as blockIf, o as validationChainPlugin, p as SoftDeleteMethods, r as immutableField, s as timestampPlugin, t as autoInject, u as createTenantContext, v as MongoOperationsMethods, w as leasePlugin, x as methodRegistryPlugin, y as mongoOperationsPlugin } from "../validation-chain.plugin-buy3uvyk.mjs";
 import { ChangeLogStore } from "@classytic/repo-core/sync";
-
 //#region src/plugins/change-log.plugin.d.ts
 interface ChangeLogPluginOptions {
   /** Durable feed implementing the repo-core/sync contract. */

package/dist/plugins/index.mjs

@@ -1,5 +1,5 @@
-import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, h as auditLogPlugin, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "../timestamp.plugin-B1A9U-P7.mjs";
-import { a as uniqueField, c as subdocumentPlugin, d as leasePlugin, f as fieldFilterPlugin, h as aggregateHelpersPlugin, i as requireField, l as observabilityPlugin, m as cascadePlugin, n as blockIf, o as validationChainPlugin, p as elasticSearchPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as mongoOperationsPlugin } from "../validation-chain.plugin-DHZbpb4t.mjs";
+import { a as methodRegistryPlugin, c as getNextSequence, d as cachePlugin, f as batchOperationsPlugin, h as auditLogPlugin, i as multiTenantPlugin, l as prefixedId, m as auditTrailPlugin, n as softDeletePlugin, o as customIdPlugin, p as AuditTrailQuery, s as dateSequentialId, t as timestampPlugin, u as sequentialId } from "../timestamp.plugin-nG9Z1JEk.mjs";
+import { a as uniqueField, c as subdocumentPlugin, d as leasePlugin, f as fieldFilterPlugin, h as aggregateHelpersPlugin, i as requireField, l as observabilityPlugin, m as cascadePlugin, n as blockIf, o as validationChainPlugin, p as elasticSearchPlugin, r as immutableField, s as createTenantContext, t as autoInject, u as mongoOperationsPlugin } from "../validation-chain.plugin-Dn_wZYLA.mjs";
 //#region src/plugins/change-log.plugin.ts
 const PLUGIN_NAME = "changeLog";
 function isSkipped(context) {

package/dist/query/primitives/coercion.d.mts

@@ -1,2 +1,2 @@
-import { a as coerceHeuristic, i as coerceFieldValue, n as SchemaPathsLike, o as coerceToType, r as buildFieldTypeMap, s as normalizeMongooseType, t as FieldType } from "../../coercion-BxxHyLjP.mjs";
+import { a as coerceHeuristic, i as coerceFieldValue, n as SchemaPathsLike, o as coerceToType, r as buildFieldTypeMap, s as normalizeMongooseType, t as FieldType } from "../../coercion-BjdPX3YF.mjs";
 export { FieldType, SchemaPathsLike, buildFieldTypeMap, coerceFieldValue, coerceHeuristic, coerceToType, normalizeMongooseType };

package/dist/query/primitives/coercion.mjs

@@ -1,4 +1,4 @@
-import { r as isObjectIdInstance } from "../../id-resolution-CnN0YA8t.mjs";
+import { r as isObjectIdInstance } from "../../id-resolution-P2OzcyRl.mjs";
 import mongoose from "mongoose";
 //#region src/query/primitives/coercion.ts
 /**

package/dist/query/primitives/geo.d.mts

@@ -14,7 +14,7 @@
  * `[nearSphere]`, or `[geoWithin]` operator on a field.
  */
 /** Geo operators recognized by the parser */
-declare const GEO_OPERATORS: readonly ["near", "nearSphere", "geoWithin", "withinRadius"];
+declare const GEO_OPERATORS: readonly ['near', 'nearSphere', 'geoWithin', 'withinRadius'];
 type GeoOperator = (typeof GEO_OPERATORS)[number];
 /**
  * True iff `operator` is one of the geo operators we handle.

package/dist/query/primitives/indexes.d.mts

@@ -1,2 +1,2 @@
-import { n as SchemaIndexes, r as extractSchemaIndexes, t as IndexableSchema } from "../../indexes-3eHBWNZ2.mjs";
+import { n as SchemaIndexes, r as extractSchemaIndexes, t as IndexableSchema } from "../../indexes-DIjMpYES.mjs";
 export { IndexableSchema, SchemaIndexes, extractSchemaIndexes };

package/dist/testkit/index.d.mts

@@ -1,7 +1,6 @@
-import { a as Repository, n as CreateRepositoryConfig } from "../create-repository-K0yft2ht.mjs";
+import { a as Repository, n as CreateRepositoryConfig } from "../create-repository-0TkQhcv-.mjs";
 import { Connection, Model, Schema } from "mongoose";
 import { MongoMemoryReplSet, MongoMemoryServer } from "mongodb-memory-server";
-
 //#region src/testkit/index.d.ts
 interface MongoMemoryOptions {
   /**

package/dist/testkit/index.mjs

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

package/dist/{timestamp.plugin-B1A9U-P7.mjs → timestamp.plugin-nG9Z1JEk.mjs}

@@ -1,6 +1,6 @@
-import { l as OP_REGISTRY, s as ALL_OPERATIONS, t as HOOK_PRIORITY } from "./Repository-B01VW_fU.mjs";
-import { n as warn } from "./logger-B8wf-Mtb.mjs";
-import { t as createError } from "./error-BTeepSNL.mjs";
+import { l as OP_REGISTRY, s as ALL_OPERATIONS, t as HOOK_PRIORITY } from "./Repository-dbbgOGjK.mjs";
+import { n as warn } from "./logger-K7dPmu2U.mjs";
+import { t as createError } from "./error-BuByZwKU.mjs";
 import { throwIfAborted, withRetry } from "@classytic/repo-core/repository";
 import mongoose from "mongoose";
 import { cachePlugin } from "@classytic/repo-core/cache";
@@ -1233,7 +1233,7 @@ function softDeletePlugin(options = {}) {
 					};
 				}
 			};
-			const SOFT_DELETE_SPECIAL = new Set([
+			const SOFT_DELETE_SPECIAL = /* @__PURE__ */ new Set([
 				"updateMany",
 				"deleteMany",
 				"bulkWrite"