@classytic/mongokit 3.4.3 → 3.4.4

package/README.md

@@ -16,8 +16,8 @@
 - **Distributed cache safety** - List cache versions stored in the adapter (Redis) for multi-pod correctness
 - **Search governance** - Text index guard (throws `400` if no index), allowlisted sort/filter fields, ReDoS protection
 - **Vector search** - MongoDB Atlas `$vectorSearch` with auto-embedding and multimodal support
-- **TypeScript first** - Full type safety with discriminated unions
-- **1090+ passing tests** - Battle-tested and production-ready
+- **TypeScript first** - Full type safety with discriminated unions, typed events, and field autocomplete
+- **1150+ passing tests** - Battle-tested and production-ready
 
 ## Installation
 
@@ -119,20 +119,34 @@ UserSchema.index({ organizationId: 1, createdAt: -1, _id: -1 });
 
 ### CRUD Operations
 
-| Method                           | Description                        |
-| -------------------------------- | ---------------------------------- |
-| `create(data, opts)`             | Create single document             |
-| `createMany(data[], opts)`       | Create multiple documents          |
-| `getById(id, opts)`              | Find by ID                         |
-| `getByQuery(query, opts)`        | Find one by query                  |
-| `getAll(params, opts)`           | Paginated list (auto-detects mode) |
-| `getOrCreate(query, data, opts)` | Find or create                     |
-| `update(id, data, opts)`         | Update document                    |
-| `delete(id, opts)`               | Delete document                    |
-| `count(query, opts)`             | Count documents                    |
-| `exists(query, opts)`            | Check existence                    |
-
-> **Note:** All read operations (`getById`, `getByQuery`, `getAll`, `count`, `exists`, `aggregate`, etc.) accept a `readPreference` option in the `opts` parameter (e.g., `readPreference: 'secondaryPreferred'`) to support scaling reads across replica sets.
+| Method                           | Options Type         | Description                        |
+| -------------------------------- | -------------------- | ---------------------------------- |
+| `create(data, opts)`             | `CreateOptions`      | Create single document             |
+| `createMany(data[], opts)`       | `CreateOptions`      | Create multiple documents          |
+| `getById(id, opts)`              | `CacheableOptions`   | Find by ID                         |
+| `getByQuery(query, opts)`        | `CacheableOptions`   | Find one by query                  |
+| `getAll(params, opts)`           | `CacheableOptions`   | Paginated list (auto-detects mode) |
+| `findAll(filters, opts)`         | `OperationOptions`   | All docs without pagination        |
+| `getOrCreate(query, data, opts)` | `SessionOptions`     | Find or create                     |
+| `update(id, data, opts)`         | `UpdateOptions`      | Update document                    |
+| `delete(id, opts)`               | `SessionOptions`     | Delete document                    |
+| `count(query, opts)`             | `ReadOptions`        | Count documents                    |
+| `exists(query, opts)`            | `ReadOptions`        | Check existence                    |
+| `aggregate(pipeline, opts)`      | `AggregateOptions`   | Run aggregation pipeline           |
+| `distinct(field, query, opts)`   | `ReadOptions`        | Get distinct values                |
+
+All option types inherit from a clean hierarchy — import only what you need:
+
+```
+SessionOptions          → { session }
+└─ ReadOptions          → + readPreference
+   ├─ OperationOptions  → + select, populate, populateOptions, lean, throwOnNotFound
+   │  ├─ CacheableOptions → + skipCache, cacheTtl
+   │  └─ UpdateOptions    → + updatePipeline, arrayFilters
+   ├─ AggregateOptions  → + allowDiskUse, collation, maxTimeMS, maxPipelineStages
+   └─ LookupPopulateOptions → + filters, lookups, sort, page, limit, collation
+└─ CreateOptions        → + ordered
+```
 
 ### Aggregation
 
@@ -895,34 +909,46 @@ class UserRepo extends Repository<IUser> {}
 const repo = new UserRepo(Model, [
   methodRegistryPlugin(),
   mongoOperationsPlugin(),
-  // ... other plugins
+  softDeletePlugin(),
 ]) as WithPlugins<IUser, UserRepo>;
 
-// Full TypeScript autocomplete!
-await repo.increment(id, "views", 1);
-await repo.restore(id);
+// Full TypeScript autocomplete — field names inferred from IUser!
+await repo.increment(id, "age", 1); // ✅ "age" autocompleted from IUser
+await repo.groupBy("status"); // ✅ "status" autocompleted
+await repo.restore(id); // ✅ Returns Promise<IUser>
+await repo.getDeleted(); // ✅ Returns OffsetPaginationResult<IUser>
 await repo.invalidateCache(id);
 ```
 
+Field params use `DocField<TDoc>` — autocomplete for known fields, still accepts arbitrary strings for nested paths like `'address.city'`.
+
 **Individual plugin types:** `MongoOperationsMethods<T>`, `BatchOperationsMethods`, `AggregateHelpersMethods`, `SubdocumentMethods<T>`, `SoftDeleteMethods<T>`, `CacheMethods`, `AuditTrailMethods`
 
 ## Event System
 
-```javascript
+Event names are typed as `RepositoryEvent` — full autocomplete in TypeScript:
+
+```typescript
+// before:* receives context directly — mutate in-place
 repo.on("before:create", async (context) => {
   context.data.processedAt = new Date();
 });
 
+// after:* receives { context, result }
 repo.on("after:create", ({ context, result }) => {
   console.log("Created:", result);
 });
 
+// error:* receives { context, error }
 repo.on("error:create", ({ context, error }) => {
   console.error("Failed:", error);
 });
+
+// Remove a listener
+repo.off("after:create", myListener);
 ```
 
-**Events:** `before:*`, `after:*`, `error:*` for `create`, `createMany`, `update`, `delete`, `deleteMany`, `updateMany`, `getById`, `getByQuery`, `getAll`, `aggregatePaginate`
+**Events:** `before:*`, `after:*`, `error:*` for `create`, `createMany`, `update`, `delete`, `deleteMany`, `updateMany`, `getById`, `getByQuery`, `getAll`, `aggregate`, `aggregatePaginate`, `lookupPopulate`, `getOrCreate`, `count`, `exists`, `distinct`, `bulkWrite`
 
 ### Microservice Integration (Kafka / RabbitMQ / Redis Pub-Sub)
 
@@ -1020,10 +1046,18 @@ const parser = new QueryParser({
   maxLimit: 100, // Prevent excessive queries
   maxFilterDepth: 5, // Prevent nested injection
   maxRegexLength: 100, // ReDoS protection
+  allowedFilterFields: ['status', 'name', 'email'], // Whitelist filter fields
+  allowedSortFields: ['createdAt', 'name'], // Whitelist sort fields
+  allowedOperators: ['eq', 'ne', 'in', 'gt', 'lt'], // Whitelist operators
 });
 
 // Parse request query
 const { filters, limit, page, sort, search } = parser.parse(req.query);
+
+// Read back configured whitelists (used by Arc MCP integration)
+parser.allowedFilterFields; // ['status', 'name', 'email'] or undefined
+parser.allowedSortFields; // ['createdAt', 'name'] or undefined
+parser.allowedOperators; // ['eq', 'ne', 'in', 'gt', 'lt'] or undefined
 ```
 
 **Supported query patterns:**
@@ -1062,6 +1096,8 @@ GET /posts?populate[author][populate][department][select]=name  # Nested
 - Blocks `$where`, `$function`, `$accumulator` operators (`$expr` allowed for `$lookup` correlation)
 - ReDoS protection for regex patterns
 - Max filter depth enforcement
+- Field allowlists for filters and sorting (`allowedFilterFields`, `allowedSortFields`)
+- Operator allowlists (`allowedOperators`)
 - Collection allowlists for lookups
 - Populate path sanitization (blocks `$where`, `__proto__`, etc.)
 - Max populate depth limit (default: 5)
@@ -1245,29 +1281,45 @@ app.post("/users", async (req, res) => {
 
 ## TypeScript
 
-```typescript
-import {
-  Repository,
-  OffsetPaginationResult,
-  KeysetPaginationResult,
-} from "@classytic/mongokit";
+`TDoc` is inferred from the Mongoose model — no manual annotation needed:
 
-interface IUser extends Document {
-  name: string;
-  email: string;
-}
+```typescript
+import { Repository } from "@classytic/mongokit";
+import type { CacheableOptions, ReadOptions } from "@classytic/mongokit";
 
-const repo = new Repository<IUser>(UserModel);
+const repo = new Repository(UserModel); // TDoc inferred from UserModel
 
-const result = await repo.getAll({ page: 1, limit: 20 });
+// All return types flow correctly
+const user = await repo.getById("123"); // IUser | null
+const users = await repo.getAll({ page: 1 }); // OffsetPaginationResult<IUser> | KeysetPaginationResult<IUser>
 
-// Discriminated union - TypeScript knows the type
-if (result.method === "offset") {
-  console.log(result.total, result.pages); // Available
+// Discriminated union — TypeScript narrows the type
+if (users.method === "offset") {
+  console.log(users.total, users.pages); // ✅ Available
 }
-if (result.method === "keyset") {
-  console.log(result.next, result.hasMore); // Available
+if (users.method === "keyset") {
+  console.log(users.next, users.hasMore); // ✅ Available
 }
+
+// Typed options — import and reuse
+const opts: CacheableOptions = { skipCache: true, lean: true };
+const fresh = await repo.getById("123", opts);
+```
+
+### Utility Types
+
+```typescript
+import type {
+  InferDocument,   // Extract TDoc from Model: InferDocument<typeof UserModel>
+  InferRawDoc,     // TDoc without Mongoose Document methods
+  CreateInput,     // Omit<TDoc, '_id' | 'createdAt' | 'updatedAt' | '__v'>
+  UpdateInput,     // Partial<Omit<TDoc, '_id' | 'createdAt' | '__v'>>
+  DocField,        // (keyof TDoc & string) | (string & {}) — autocomplete + nested paths
+  PartialBy,       // Make specific fields optional
+  RequiredBy,      // Make specific fields required
+  DeepPartial,     // Recursive partial
+  KeysOfType,      // Extract keys by value type: KeysOfType<IUser, string>
+} from "@classytic/mongokit";
 ```
 
 ## Extending Repository

package/dist/{PaginationEngine-nY04eGUM.mjs → PaginationEngine-DCs-zKwZ.mjs}

@@ -12,8 +12,10 @@ import { r as validateKeysetSort, t as getPrimaryField } from "./sort-C-BJEWUZ.m
 */
 function validateLimit(limit, config) {
 	const parsed = Number(limit);
-	if (!Number.isFinite(parsed) || parsed < 1) return config.defaultLimit || 10;
-	return Math.min(Math.floor(parsed), config.maxLimit || 100);
+	if (!Number.isFinite(parsed) || parsed < 1) return config.defaultLimit ?? 10;
+	const max = config.maxLimit ?? 100;
+	if (max === 0) return Math.floor(parsed);
+	return Math.min(Math.floor(parsed), max);
 }
 /**
 * Validates and sanitizes page number
@@ -101,12 +103,12 @@ var PaginationEngine = class {
 	constructor(Model, config = {}) {
 		this.Model = Model;
 		this.config = {
-			defaultLimit: config.defaultLimit || 10,
-			maxLimit: config.maxLimit || 100,
-			maxPage: config.maxPage || 1e4,
-			deepPageThreshold: config.deepPageThreshold || 100,
-			cursorVersion: config.cursorVersion || 1,
-			useEstimatedCount: config.useEstimatedCount || false
+			defaultLimit: config.defaultLimit ?? 10,
+			maxLimit: config.maxLimit ?? 100,
+			maxPage: config.maxPage ?? 1e4,
+			deepPageThreshold: config.deepPageThreshold ?? 100,
+			cursorVersion: config.cursorVersion ?? 1,
+			useEstimatedCount: config.useEstimatedCount ?? false
 		};
 	}
 	/**

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-DHki2IxZ.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-DxNyLB2w.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 "../chunk-CfYAbeIz.mjs";
-import { c as read_exports, h as aggregate_exports, n as update_exports, p as create_exports, u as delete_exports } from "../update-DGKMmBgG.mjs";
+import { c as read_exports, h as aggregate_exports, n as update_exports, p as create_exports, u as delete_exports } from "../update-D6FFSUUO.mjs";
 //#region src/actions/index.ts
 var actions_exports = /* @__PURE__ */ __exportAll({
 	aggregate: () => aggregate_exports,

package/dist/ai/index.d.mts

@@ -1,4 +1,4 @@
-import { J as Plugin } from "../types-nLhnjmdE.mjs";
+import { J as Plugin } from "../types-sOh6QSzc.mjs";
 import { ClientSession, PipelineStage } from "mongoose";
 
 //#region src/ai/types.d.ts

package/dist/{index-DHki2IxZ.d.mts → index-DxNyLB2w.d.mts}

@@ -1,4 +1,4 @@
-import { $ as ReadPreferenceType, At as LookupOptions, D as GroupResult, V as ObjectId, W as OperationOptions, Z as PopulateSpec, _t as UpdateOptions, a as AnyDocument, b as DeleteResult, g as CreateOptions, gt as UpdateManyResult, pt as SortSpec, st as SelectSpec, vt as UpdateWithValidationResult, z as MinMaxResult } from "./types-nLhnjmdE.mjs";
+import { $ as ReadPreferenceType, At as LookupOptions, D as GroupResult, V as ObjectId, W as OperationOptions, Z as PopulateSpec, _t as UpdateOptions, a as AnyDocument, b as DeleteResult, g as CreateOptions, gt as UpdateManyResult, pt as SortSpec, st as SelectSpec, vt as UpdateWithValidationResult, z as MinMaxResult } from "./types-sOh6QSzc.mjs";
 import { ClientSession, Model, PipelineStage } from "mongoose";
 
 //#region src/actions/aggregate.d.ts

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { $ as ReadPreferenceType, A as InferDocument, At as LookupOptions, B as NonNullableFields, C as EventPayload, Ct as WithPlugins, D as GroupResult, Dt as IRequestContext, E as FieldRules, Et as IControllerResponse, F as KeysetPaginationResult, G as PaginationConfig, H as OffsetPaginationOptions, I as Logger, J as Plugin, K as PaginationResult, L as LookupPopulateOptions, M as JsonSchema, N as KeysOfType, O as HookMode, Ot as IResponseFormatter, P as KeysetPaginationOptions, Q as ReadOptions, R as LookupPopulateResult, S as EventHandlers, St as ValidatorDefinition, T as FieldPreset, Tt as IController, U as OffsetPaginationResult, V as ObjectId, W as OperationOptions, X as PluginType, Y as PluginFunction, Z as PopulateSpec, _ as CrudSchemas, _t as UpdateOptions, a as AnyDocument, at as RequiredBy, b as DeleteResult, bt as ValidationChainOptions, c as CacheOperationOptions, ct as SessionOptions, d as CacheableOptions, dt as SoftDeleteRepository, et as RepositoryContext, f as CascadeOptions, ft as SortDirection, g as CreateOptions, gt as UpdateManyResult, h as CreateInput, ht as UpdateInput, i as AllPluginMethods, it as RepositoryOptions, j as InferRawDoc, k as HttpError, kt as LookupBuilder, l as CacheOptions, lt as SoftDeleteFilterMode, m as CollationOptions, mt as Strict, n as AggregatePaginationOptions, nt as RepositoryInstance, o as AnyModel, ot as SchemaBuilderOptions, p as CascadeRelation, pt as SortSpec, q as PartialBy, r as AggregatePaginationResult, rt as RepositoryOperation, s as CacheAdapter, st as SelectSpec, t as AggregateOptions, tt as RepositoryEvent, u as CacheStats, ut as SoftDeleteOptions, v as DecodedCursor, vt as UpdateWithValidationResult, w as EventPhase, wt as WithTransactionOptions, x as DocField, xt as ValidationResult, y as DeepPartial, yt as UserContext, z as MinMaxResult } from "./types-nLhnjmdE.mjs";
-import { t as index_d_exports } from "./index-DHki2IxZ.mjs";
+import { $ as ReadPreferenceType, A as InferDocument, At as LookupOptions, B as NonNullableFields, C as EventPayload, Ct as WithPlugins, D as GroupResult, Dt as IRequestContext, E as FieldRules, Et as IControllerResponse, F as KeysetPaginationResult, G as PaginationConfig, H as OffsetPaginationOptions, I as Logger, J as Plugin, K as PaginationResult, L as LookupPopulateOptions, M as JsonSchema, N as KeysOfType, O as HookMode, Ot as IResponseFormatter, P as KeysetPaginationOptions, Q as ReadOptions, R as LookupPopulateResult, S as EventHandlers, St as ValidatorDefinition, T as FieldPreset, Tt as IController, U as OffsetPaginationResult, V as ObjectId, W as OperationOptions, X as PluginType, Y as PluginFunction, Z as PopulateSpec, _ as CrudSchemas, _t as UpdateOptions, a as AnyDocument, at as RequiredBy, b as DeleteResult, bt as ValidationChainOptions, c as CacheOperationOptions, ct as SessionOptions, d as CacheableOptions, dt as SoftDeleteRepository, et as RepositoryContext, f as CascadeOptions, ft as SortDirection, g as CreateOptions, gt as UpdateManyResult, h as CreateInput, ht as UpdateInput, i as AllPluginMethods, it as RepositoryOptions, j as InferRawDoc, k as HttpError, kt as LookupBuilder, l as CacheOptions, lt as SoftDeleteFilterMode, m as CollationOptions, mt as Strict, n as AggregatePaginationOptions, nt as RepositoryInstance, o as AnyModel, ot as SchemaBuilderOptions, p as CascadeRelation, pt as SortSpec, q as PartialBy, r as AggregatePaginationResult, rt as RepositoryOperation, s as CacheAdapter, st as SelectSpec, t as AggregateOptions, tt as RepositoryEvent, u as CacheStats, ut as SoftDeleteOptions, v as DecodedCursor, vt as UpdateWithValidationResult, w as EventPhase, wt as WithTransactionOptions, x as DocField, xt as ValidationResult, y as DeepPartial, yt as UserContext, z as MinMaxResult } from "./types-sOh6QSzc.mjs";
+import { t as index_d_exports } from "./index-DxNyLB2w.mjs";
 import { PaginationEngine } from "./pagination/PaginationEngine.mjs";
-import { A as dateSequentialId, B as AuditEntry, C as elasticSearchPlugin, D as PrefixedIdOptions, E as IdGenerator, F as CacheMethods, G as AuditTrailOptions, H as AuditQueryOptions, I as cachePlugin, J as auditLogPlugin, K as AuditTrailQuery, L as BatchOperationsMethods, M as prefixedId, N as sequentialId, O as SequentialIdOptions, P as cascadePlugin, R as BulkWriteResult, S as ElasticSearchOptions, T as DateSequentialIdOptions, U as AuditQueryResult, V as AuditOperation, W as AuditTrailMethods, X as aggregateHelpersPlugin, Y as AggregateHelpersMethods, _ as MongoOperationsMethods, a as uniqueField, b as methodRegistryPlugin, c as SubdocumentMethods, d as softDeletePlugin, f as ObservabilityOptions, g as multiTenantPlugin, h as MultiTenantOptions, i as requireField, j as getNextSequence, k as customIdPlugin, l as subdocumentPlugin, m as observabilityPlugin, n as blockIf, o as validationChainPlugin, p as OperationMetric, q as auditTrailPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as SoftDeleteMethods, v as mongoOperationsPlugin, w as CustomIdOptions, x as fieldFilterPlugin, z as batchOperationsPlugin } from "./validation-chain.plugin-C-IGsWHn.mjs";
-import { a as isFieldUpdateAllowed, c as configureLogger, d as getFieldsForUser, f as getMongooseProjection, i as getSystemManagedFields, l as createFieldPreset, m as parseDuplicateKeyError, n as buildCrudSchemasFromMongooseSchema, o as validateUpdateBody, p as createError, r as getImmutableFields, s as createMemoryCache, t as buildCrudSchemasFromModel, u as filterResponseData } from "./mongooseToJsonSchema-MTvR0gJv.mjs";
+import { A as dateSequentialId, B as AuditEntry, C as elasticSearchPlugin, D as PrefixedIdOptions, E as IdGenerator, F as CacheMethods, G as AuditTrailOptions, H as AuditQueryOptions, I as cachePlugin, J as auditLogPlugin, K as AuditTrailQuery, L as BatchOperationsMethods, M as prefixedId, N as sequentialId, O as SequentialIdOptions, P as cascadePlugin, R as BulkWriteResult, S as ElasticSearchOptions, T as DateSequentialIdOptions, U as AuditQueryResult, V as AuditOperation, W as AuditTrailMethods, X as aggregateHelpersPlugin, Y as AggregateHelpersMethods, _ as MongoOperationsMethods, a as uniqueField, b as methodRegistryPlugin, c as SubdocumentMethods, d as softDeletePlugin, f as ObservabilityOptions, g as multiTenantPlugin, h as MultiTenantOptions, i as requireField, j as getNextSequence, k as customIdPlugin, l as subdocumentPlugin, m as observabilityPlugin, n as blockIf, o as validationChainPlugin, p as OperationMetric, q as auditTrailPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as SoftDeleteMethods, v as mongoOperationsPlugin, w as CustomIdOptions, x as fieldFilterPlugin, z as batchOperationsPlugin } from "./validation-chain.plugin-nJtqOI-E.mjs";
+import { a as isFieldUpdateAllowed, c as configureLogger, d as getFieldsForUser, f as getMongooseProjection, i as getSystemManagedFields, l as createFieldPreset, m as parseDuplicateKeyError, n as buildCrudSchemasFromMongooseSchema, o as validateUpdateBody, p as createError, r as getImmutableFields, s as createMemoryCache, t as buildCrudSchemasFromModel, u as filterResponseData } from "./mongooseToJsonSchema-C374oVAV.mjs";
 import * as _$mongoose from "mongoose";
 import { ClientSession, Expression, Model, PipelineStage, PopulateOptions } from "mongoose";
 
@@ -826,6 +826,15 @@ declare class Repository<TDoc = unknown> {
    * Get single document by query
    */
   getByQuery(query: Record<string, unknown>, options?: CacheableOptions): Promise<TDoc | null>;
+  /**
+   * Fetch ALL documents matching filters without pagination.
+   * Use for background jobs, exports, batch processing where you need every doc.
+   *
+   * @example
+   * const all = await repo.findAll({ status: 'active' });
+   * const allLean = await repo.findAll({}, { select: 'name email', lean: true });
+   */
+  findAll(filters?: Record<string, unknown>, options?: OperationOptions): Promise<TDoc[]>;
   /**
    * Unified pagination - auto-detects offset vs keyset based on params
    *
@@ -868,8 +877,9 @@ declare class Repository<TDoc = unknown> {
     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[];
-  }, options?: CacheableOptions): Promise<OffsetPaginationResult<TDoc> | KeysetPaginationResult<TDoc>>;
+    lookups?: LookupOptions[]; /** Skip pagination entirely — returns raw TDoc[] (same as findAll) */
+    noPagination?: boolean;
+  }, options?: CacheableOptions): Promise<OffsetPaginationResult<TDoc> | KeysetPaginationResult<TDoc> | TDoc[]>;
   /**
    * Get or create document
    * Routes through hook system for policy enforcement (multi-tenant, soft-delete)

package/dist/index.mjs

@@ -1,8 +1,8 @@
 import { a as warn, n as parseDuplicateKeyError, r as configureLogger, t as createError } from "./error-Bpbi_NKo.mjs";
-import { _ as LookupBuilder } from "./update-DGKMmBgG.mjs";
+import { _ as LookupBuilder } from "./update-D6FFSUUO.mjs";
 import { t as actions_exports } from "./actions/index.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-nY04eGUM.mjs";
-import { A as aggregateHelpersPlugin, C as HOOK_PRIORITY, D as AuditTrailQuery, E as batchOperationsPlugin, O as auditTrailPlugin, S as cachePlugin, T as AggregationBuilder, _ as dateSequentialId, a as uniqueField, b as sequentialId, c as subdocumentPlugin, d as multiTenantPlugin, f as mongoOperationsPlugin, g as customIdPlugin, h as elasticSearchPlugin, i as requireField, k as auditLogPlugin, l as softDeletePlugin, m as fieldFilterPlugin, n as blockIf, o as validationChainPlugin, p as methodRegistryPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as observabilityPlugin, v as getNextSequence, w as Repository, x as cascadePlugin, y as prefixedId } from "./validation-chain.plugin-Cp5X5IZu.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-DCs-zKwZ.mjs";
+import { A as aggregateHelpersPlugin, C as HOOK_PRIORITY, D as AuditTrailQuery, E as batchOperationsPlugin, O as auditTrailPlugin, S as cachePlugin, T as AggregationBuilder, _ as dateSequentialId, a as uniqueField, b as sequentialId, c as subdocumentPlugin, d as multiTenantPlugin, f as mongoOperationsPlugin, g as customIdPlugin, h as elasticSearchPlugin, i as requireField, k as auditLogPlugin, l as softDeletePlugin, m as fieldFilterPlugin, n as blockIf, o as validationChainPlugin, p as methodRegistryPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as observabilityPlugin, v as getNextSequence, w as Repository, x as cascadePlugin, y as prefixedId } from "./validation-chain.plugin-7Pa1wIsD.mjs";
 import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "./field-selection-reyDRzXf.mjs";
 import { a as isFieldUpdateAllowed, i as getSystemManagedFields, n as buildCrudSchemasFromMongooseSchema, o as validateUpdateBody, r as getImmutableFields, s as createMemoryCache, t as buildCrudSchemasFromModel } from "./mongooseToJsonSchema-B6Qyl8BK.mjs";
 import mongoose from "mongoose";

package/dist/{mongooseToJsonSchema-MTvR0gJv.d.mts → mongooseToJsonSchema-C374oVAV.d.mts}

@@ -1,4 +1,4 @@
-import { T as FieldPreset, _ as CrudSchemas, k as HttpError, ot as SchemaBuilderOptions, s as CacheAdapter, xt as ValidationResult, yt as UserContext } from "./types-nLhnjmdE.mjs";
+import { T as FieldPreset, _ as CrudSchemas, k as HttpError, ot as SchemaBuilderOptions, s as CacheAdapter, xt as ValidationResult, yt as UserContext } from "./types-sOh6QSzc.mjs";
 import mongoose, { Schema } from "mongoose";
 
 //#region src/utils/error.d.ts

package/dist/pagination/PaginationEngine.d.mts

@@ -1,4 +1,4 @@
-import { F as KeysetPaginationResult, G as PaginationConfig, H as OffsetPaginationOptions, P as KeysetPaginationOptions, U as OffsetPaginationResult, a as AnyDocument, n as AggregatePaginationOptions, r as AggregatePaginationResult } from "../types-nLhnjmdE.mjs";
+import { F as KeysetPaginationResult, G as PaginationConfig, H as OffsetPaginationOptions, P as KeysetPaginationOptions, U as OffsetPaginationResult, a as AnyDocument, n as AggregatePaginationOptions, r as AggregatePaginationResult } from "../types-sOh6QSzc.mjs";
 import { Model } from "mongoose";
 
 //#region src/pagination/PaginationEngine.d.ts

package/dist/pagination/PaginationEngine.mjs

@@ -1,2 +1,2 @@
-import { t as PaginationEngine } from "../PaginationEngine-nY04eGUM.mjs";
+import { t as PaginationEngine } from "../PaginationEngine-DCs-zKwZ.mjs";
 export { PaginationEngine };

package/dist/plugins/index.d.mts

@@ -1,2 +1,2 @@
-import { A as dateSequentialId, B as AuditEntry, C as elasticSearchPlugin, D as PrefixedIdOptions, E as IdGenerator, F as CacheMethods, G as AuditTrailOptions, H as AuditQueryOptions, I as cachePlugin, J as auditLogPlugin, K as AuditTrailQuery, L as BatchOperationsMethods, M as prefixedId, N as sequentialId, O as SequentialIdOptions, P as cascadePlugin, S as ElasticSearchOptions, T as DateSequentialIdOptions, U as AuditQueryResult, V as AuditOperation, W as AuditTrailMethods, X as aggregateHelpersPlugin, Y as AggregateHelpersMethods, _ as MongoOperationsMethods, a as uniqueField, b as methodRegistryPlugin, c as SubdocumentMethods, d as softDeletePlugin, f as ObservabilityOptions, g as multiTenantPlugin, h as MultiTenantOptions, i as requireField, j as getNextSequence, k as customIdPlugin, l as subdocumentPlugin, m as observabilityPlugin, n as blockIf, o as validationChainPlugin, p as OperationMetric, q as auditTrailPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as SoftDeleteMethods, v as mongoOperationsPlugin, w as CustomIdOptions, x as fieldFilterPlugin, y as MethodRegistryRepository, z as batchOperationsPlugin } from "../validation-chain.plugin-C-IGsWHn.mjs";
+import { A as dateSequentialId, B as AuditEntry, C as elasticSearchPlugin, D as PrefixedIdOptions, E as IdGenerator, F as CacheMethods, G as AuditTrailOptions, H as AuditQueryOptions, I as cachePlugin, J as auditLogPlugin, K as AuditTrailQuery, L as BatchOperationsMethods, M as prefixedId, N as sequentialId, O as SequentialIdOptions, P as cascadePlugin, S as ElasticSearchOptions, T as DateSequentialIdOptions, U as AuditQueryResult, V as AuditOperation, W as AuditTrailMethods, X as aggregateHelpersPlugin, Y as AggregateHelpersMethods, _ as MongoOperationsMethods, a as uniqueField, b as methodRegistryPlugin, c as SubdocumentMethods, d as softDeletePlugin, f as ObservabilityOptions, g as multiTenantPlugin, h as MultiTenantOptions, i as requireField, j as getNextSequence, k as customIdPlugin, l as subdocumentPlugin, m as observabilityPlugin, n as blockIf, o as validationChainPlugin, p as OperationMetric, q as auditTrailPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as SoftDeleteMethods, v as mongoOperationsPlugin, w as CustomIdOptions, x as fieldFilterPlugin, y as MethodRegistryRepository, z as batchOperationsPlugin } from "../validation-chain.plugin-nJtqOI-E.mjs";
 export { type AggregateHelpersMethods, type AuditEntry, type AuditOperation, type AuditQueryOptions, type AuditQueryResult, type AuditTrailMethods, type AuditTrailOptions, AuditTrailQuery, type BatchOperationsMethods, type CacheMethods, type CustomIdOptions, type DateSequentialIdOptions, type ElasticSearchOptions, type IdGenerator, type MethodRegistryRepository, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type PrefixedIdOptions, type SequentialIdOptions, type SoftDeleteMethods, type SubdocumentMethods, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/plugins/index.mjs

@@ -1,2 +1,2 @@
-import { A as aggregateHelpersPlugin, D as AuditTrailQuery, E as batchOperationsPlugin, O as auditTrailPlugin, S as cachePlugin, _ as dateSequentialId, a as uniqueField, b as sequentialId, c as subdocumentPlugin, d as multiTenantPlugin, f as mongoOperationsPlugin, g as customIdPlugin, h as elasticSearchPlugin, i as requireField, k as auditLogPlugin, l as softDeletePlugin, m as fieldFilterPlugin, n as blockIf, o as validationChainPlugin, p as methodRegistryPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as observabilityPlugin, v as getNextSequence, x as cascadePlugin, y as prefixedId } from "../validation-chain.plugin-Cp5X5IZu.mjs";
+import { A as aggregateHelpersPlugin, D as AuditTrailQuery, E as batchOperationsPlugin, O as auditTrailPlugin, S as cachePlugin, _ as dateSequentialId, a as uniqueField, b as sequentialId, c as subdocumentPlugin, d as multiTenantPlugin, f as mongoOperationsPlugin, g as customIdPlugin, h as elasticSearchPlugin, i as requireField, k as auditLogPlugin, l as softDeletePlugin, m as fieldFilterPlugin, n as blockIf, o as validationChainPlugin, p as methodRegistryPlugin, r as immutableField, s as timestampPlugin, t as autoInject, u as observabilityPlugin, v as getNextSequence, x as cascadePlugin, y as prefixedId } from "../validation-chain.plugin-7Pa1wIsD.mjs";
 export { AuditTrailQuery, aggregateHelpersPlugin, auditLogPlugin, auditTrailPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, customIdPlugin, dateSequentialId, elasticSearchPlugin, fieldFilterPlugin, getNextSequence, immutableField, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, prefixedId, requireField, sequentialId, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/{types-nLhnjmdE.d.mts → types-sOh6QSzc.d.mts}

@@ -720,7 +720,9 @@ interface WithTransactionOptions {
 }
 /** Create operation options */
 interface CreateOptions extends SessionOptions {
-  /** Keep insertion order on error (default: true) */
+  /** Keep insertion order on error (default: false).
+   * When false, all valid documents insert even if some fail (e.g. duplicates).
+   * Set to true to abort remaining inserts on first error. */
   ordered?: boolean;
 }
 /** Update operation options */
@@ -924,7 +926,7 @@ interface RepositoryInstance {
   [key: string]: unknown;
 }
 /** Repository operation names */
-type RepositoryOperation = 'create' | 'createMany' | 'update' | 'updateMany' | 'delete' | 'deleteMany' | 'getById' | 'getByQuery' | 'getAll' | 'getOrCreate' | 'count' | 'exists' | 'distinct' | 'aggregate' | 'aggregatePaginate' | 'lookupPopulate' | 'bulkWrite';
+type RepositoryOperation = 'create' | 'createMany' | 'update' | 'updateMany' | 'delete' | 'deleteMany' | 'getById' | 'getByQuery' | 'getAll' | 'findAll' | 'getOrCreate' | 'count' | 'exists' | 'distinct' | 'aggregate' | 'aggregatePaginate' | 'lookupPopulate' | 'bulkWrite';
 /** Event lifecycle phases */
 type EventPhase = 'before' | 'after' | 'error';
 /** Repository event names (generated from template literals) */

package/dist/{update-DGKMmBgG.mjs → update-D6FFSUUO.mjs}

@@ -461,7 +461,7 @@ async function create(Model, data, options = {}) {
 async function createMany(Model, dataArray, options = {}) {
 	return Model.insertMany(dataArray, {
 		session: options.session,
-		ordered: options.ordered !== false
+		ordered: options.ordered === true
 	});
 }
 /**

package/dist/utils/index.d.mts

@@ -1,5 +1,5 @@
-import { Z as PopulateSpec, pt as SortSpec, st as SelectSpec } from "../types-nLhnjmdE.mjs";
-import { a as isFieldUpdateAllowed, c as configureLogger, d as getFieldsForUser, f as getMongooseProjection, i as getSystemManagedFields, l as createFieldPreset, n as buildCrudSchemasFromMongooseSchema, o as validateUpdateBody, p as createError, r as getImmutableFields, s as createMemoryCache, t as buildCrudSchemasFromModel, u as filterResponseData } from "../mongooseToJsonSchema-MTvR0gJv.mjs";
+import { Z as PopulateSpec, pt as SortSpec, st as SelectSpec } from "../types-sOh6QSzc.mjs";
+import { a as isFieldUpdateAllowed, c as configureLogger, d as getFieldsForUser, f as getMongooseProjection, i as getSystemManagedFields, l as createFieldPreset, n as buildCrudSchemasFromMongooseSchema, o as validateUpdateBody, p as createError, r as getImmutableFields, s as createMemoryCache, t as buildCrudSchemasFromModel, u as filterResponseData } from "../mongooseToJsonSchema-C374oVAV.mjs";
 
 //#region src/utils/cache-keys.d.ts
 /**

package/dist/{validation-chain.plugin-Cp5X5IZu.mjs → validation-chain.plugin-7Pa1wIsD.mjs}

@@ -1,6 +1,6 @@
 import { a as warn, i as debug, n as parseDuplicateKeyError, t as createError } from "./error-Bpbi_NKo.mjs";
-import { _ as LookupBuilder, a as getById, d as create, f as createMany, g as distinct, i as exists, l as deleteById, m as upsert, o as getByQuery, r as count, s as getOrCreate, t as update } from "./update-DGKMmBgG.mjs";
-import { t as PaginationEngine } from "./PaginationEngine-nY04eGUM.mjs";
+import { _ as LookupBuilder, a as getById, d as create, f as createMany, g as distinct, i as exists, l as deleteById, m as upsert, o as getByQuery, r as count, s as getOrCreate, t as update } from "./update-D6FFSUUO.mjs";
+import { t as PaginationEngine } from "./PaginationEngine-DCs-zKwZ.mjs";
 import { a as byIdKey, c as listQueryKey, l as modelPattern, o as byQueryKey, r as getFieldsForUser, u as versionKey } from "./field-selection-reyDRzXf.mjs";
 import mongoose from "mongoose";
 //#region src/plugins/aggregate-helpers.plugin.ts
@@ -1302,6 +1302,10 @@ var Repository = class {
 			return cachedResult;
 		}
 		try {
+			if (typeof id === "string" && !mongoose.Types.ObjectId.isValid(id)) {
+				if (context.throwOnNotFound === false || options.throwOnNotFound === false) return null;
+				throw createError(404, "Document not found");
+			}
 			const result = await getById(this.Model, id, context);
 			await this._emitHook("after:getById", {
 				context,
@@ -1352,6 +1356,42 @@ var Repository = class {
 		}
 	}
 	/**
+	* Fetch ALL documents matching filters without pagination.
+	* Use for background jobs, exports, batch processing where you need every doc.
+	*
+	* @example
+	* const all = await repo.findAll({ status: 'active' });
+	* const allLean = await repo.findAll({}, { select: 'name email', lean: true });
+	*/
+	async findAll(filters = {}, options = {}) {
+		const context = await this._buildContext("findAll", {
+			filters,
+			...options
+		});
+		const resolvedFilters = context.filters ?? filters;
+		try {
+			const query = this.Model.find(resolvedFilters);
+			const selectSpec = context.select || options.select;
+			if (selectSpec) query.select(selectSpec);
+			if (options.populate || context.populate) query.populate(this._parsePopulate(context.populate || options.populate));
+			if (context.lean ?? options.lean ?? true) query.lean();
+			if (options.session) query.session(options.session);
+			if (options.readPreference) query.read(options.readPreference);
+			const result = await query.exec();
+			await this._emitHook("after:findAll", {
+				context,
+				result
+			});
+			return result;
+		} catch (error) {
+			await this._emitErrorHook("error:findAll", {
+				context,
+				error
+			});
+			throw this._handleError(error);
+		}
+	}
+	/**
 	* Unified pagination - auto-detects offset vs keyset based on params
 	*
 	* Auto-detection logic:
@@ -1393,6 +1433,7 @@ var Repository = class {
 			});
 			return cachedResult;
 		}
+		if (params.noPagination) return this.findAll(params.filters ?? {}, options);
 		const filters = context.filters ?? params.filters ?? {};
 		const search = context.search ?? params.search;
 		const sort = context.sort ?? params.sort ?? "-createdAt";

package/dist/{validation-chain.plugin-C-IGsWHn.d.mts → validation-chain.plugin-nJtqOI-E.d.mts}

@@ -1,4 +1,4 @@
-import { I as Logger, J as Plugin, St as ValidatorDefinition, T as FieldPreset, U as OffsetPaginationResult, V as ObjectId, Z as PopulateSpec, bt as ValidationChainOptions, et as RepositoryContext, f as CascadeOptions, l as CacheOptions, nt as RepositoryInstance, pt as SortSpec, st as SelectSpec, u as CacheStats, ut as SoftDeleteOptions } from "./types-nLhnjmdE.mjs";
+import { I as Logger, J as Plugin, St as ValidatorDefinition, T as FieldPreset, U as OffsetPaginationResult, V as ObjectId, Z as PopulateSpec, bt as ValidationChainOptions, et as RepositoryContext, f as CascadeOptions, l as CacheOptions, nt as RepositoryInstance, pt as SortSpec, st as SelectSpec, u as CacheStats, ut as SoftDeleteOptions } from "./types-sOh6QSzc.mjs";
 import mongoose, { ClientSession } from "mongoose";
 
 //#region src/plugins/aggregate-helpers.plugin.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.4.3",
+  "version": "3.4.4",
   "description": "Production-grade MongoDB repositories with zero dependencies - smart pagination, events, and plugins",
   "type": "module",
   "sideEffects": false,