@classytic/mongokit 3.18.0 → 3.20.0

package/dist/{types-CU3SEDbD.d.mts → types-DNFMofHy.d.mts}

@@ -1,16 +1,9 @@
-import * as _$_classytic_repo_core_repository0 from "@classytic/repo-core/repository";
 import { DeleteManyResult, DeleteResult, LookupPopulateResult, RepositoryBase, UpdateManyResult } from "@classytic/repo-core/repository";
-import * as _$mongoose from "mongoose";
 import { Document, Model, PipelineStage, PopulateOptions, Types } from "mongoose";
-import * as _$_classytic_repo_core_filter0 from "@classytic/repo-core/filter";
 import { Filter } from "@classytic/repo-core/filter";
-import * as _$_classytic_repo_core_cache0 from "@classytic/repo-core/cache";
-import * as _$_classytic_repo_core_schema0 from "@classytic/repo-core/schema";
 import { ValidationResult } from "@classytic/repo-core/schema";
-import * as _$_classytic_repo_core_events0 from "@classytic/repo-core/events";
 import { AnyPaginationResult, OffsetPaginationResult } from "@classytic/repo-core/pagination";
 import { HttpError } from "@classytic/repo-core/errors";
-
 //#region src/query/LookupBuilder.d.ts
 interface LookupOptions {
   /** Collection to join with */
@@ -172,6 +165,42 @@ declare class LookupBuilder {
    */
   private static _sanitizeDeep;
 }
+/**
+ * Performance Guidelines for $lookup at Scale:
+ *
+ * 1. **Index Requirements** (Critical for millions of records):
+ *    - localField should be indexed on source collection
+ *    - foreignField should be indexed on target collection (unique index preferred)
+ *
+ *    Example:
+ *    ```typescript
+ *    // Employee collection
+ *    employeeSchema.index({ departmentSlug: 1 });
+ *
+ *    // Department collection
+ *    departmentSchema.index({ slug: 1 }, { unique: true });
+ *    ```
+ *
+ * 2. **Query Performance**:
+ *    - With proper indexes: O(log n) per lookup
+ *    - Without indexes: O(n * m) - AVOID THIS!
+ *    - Use explain() to verify index usage: IXSCAN (good) vs COLLSCAN (bad)
+ *
+ * 3. **Pipeline Optimization**:
+ *    - Place $match stages as early as possible
+ *    - Use $project to reduce field size before lookups
+ *    - Limit joined results with pipeline: [{ $match: {...} }, { $limit: n }]
+ *
+ * 4. **Memory Considerations**:
+ *    - Each lookup creates a new field in memory
+ *    - Use $project after lookup to remove unnecessary fields
+ *    - Consider allowDiskUse: true for very large datasets
+ *
+ * 5. **Alternative Approaches**:
+ *    - For 1:1 relationships with high read frequency: Consider storing ObjectId + slug
+ *    - For read-heavy workloads: Consider caching or materialized views
+ *    - For real-time dashboards: Consider separate aggregation collections
+ */
 //#endregion
 //#region src/types/controller.types.d.ts
 /**
@@ -561,20 +590,20 @@ type RequiredBy<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
  * @example
  * type StringFields = KeysOfType<User, string>; // 'name' | 'email'
  */
-type KeysOfType<T, V> = { [K in keyof T]: T[K] extends V ? K : never }[keyof T];
+type KeysOfType<T, V> = { [K in keyof T]: T[K] extends V ? K : never; }[keyof T];
 /**
  * Deep partial - makes all nested properties optional
  */
-type DeepPartial<T> = T extends object ? { [P in keyof T]?: DeepPartial<T[P]> } : T;
+type DeepPartial<T> = T extends object ? { [P in keyof T]?: DeepPartial<T[P]>; } : T;
 /**
  * Strict object type - prevents excess properties
  * Use with `satisfies` for compile-time validation
  */
-type Strict<T> = T & { [K in Exclude<string, keyof T>]?: never };
+type Strict<T> = T & { [K in Exclude<string, keyof T>]?: never; };
 /**
  * NonNullable fields extractor
  */
-type NonNullableFields<T> = { [K in keyof T]: NonNullable<T[K]> };
+type NonNullableFields<T> = { [K in keyof T]: NonNullable<T[K]>; };
 /**
  * Create/Update input types from document
  */
@@ -869,20 +898,20 @@ interface RepositoryOptions {
    * structured `validationErrors`. Validator output replaces the
    * payload, so schema-declared coercions/defaults flow into the write.
    */
-  schema?: _$_classytic_repo_core_schema0.StandardSchemaV1;
+  schema?: import('@classytic/repo-core/schema').StandardSchemaV1;
   /**
    * Standard Schema validator for `update` payloads. Separate slot
    * because updates are partial — derive one explicitly (e.g.
    * `schema.partial()` in Zod).
    */
-  updateSchema?: _$_classytic_repo_core_schema0.StandardSchemaV1;
+  updateSchema?: import('@classytic/repo-core/schema').StandardSchemaV1;
   /**
    * Domain-event emission. Pass any arc / `@classytic/primitives`-
    * compatible transport and every mutating op publishes
    * `<resource>.<verb>` events (`user.created`, `user.updated`, ...).
    * Omit and the wiring is inert. See `@classytic/repo-core/events`.
    */
-  events?: _$_classytic_repo_core_events0.RepositoryEventsOptions;
+  events?: import('@classytic/repo-core/events').RepositoryEventsOptions;
 }
 /** Pagination configuration */
 interface PaginationConfig {
@@ -1105,7 +1134,7 @@ interface OperationOptions extends ReadOptions {
  */
 interface CacheableOptions extends OperationOptions {
   /** Per-call cache override forwarded to the unified cache plugin. */
-  cache?: _$_classytic_repo_core_cache0.CacheOptions;
+  cache?: import('@classytic/repo-core/cache').CacheOptions;
 }
 /** withTransaction options */
 interface WithTransactionOptions {
@@ -1114,7 +1143,7 @@ interface WithTransactionOptions {
   /** Optional hook to observe fallback triggers */
   onFallback?: (error: Error) => void;
   /** MongoDB transaction options (readConcern, writeConcern, readPreference, maxCommitTimeMS) */
-  transactionOptions?: _$mongoose.mongo.TransactionOptions;
+  transactionOptions?: import('mongoose').mongo.TransactionOptions;
 }
 /** Create operation options */
 interface CreateOptions extends SessionOptions {
@@ -1200,13 +1229,13 @@ interface LookupPopulateOptions<TBase = unknown> {
    * controllers produce when typed against `StandardRepo<TDoc>`), or
    * a plain `Record<string, unknown>` for ad-hoc callers.
    */
-  filters?: _$_classytic_repo_core_filter0.Filter | (Partial<TBase> & Record<string, unknown>) | Record<string, unknown>;
+  filters?: import('@classytic/repo-core/filter').Filter | (Partial<TBase> & Record<string, unknown>) | Record<string, unknown>;
   /**
    * Portable `LookupSpec[]` (cross-kit) or mongokit-native
    * `LookupOptions[]` (with `pipeline` / `let` / `sanitize`). The
    * portable shape is a structural subset, so callers can mix.
    */
-  lookups: readonly _$_classytic_repo_core_repository0.LookupSpec[] | LookupOptions[];
+  lookups: readonly import('@classytic/repo-core/repository').LookupSpec[] | LookupOptions[];
   /** Sort specification */
   sort?: SortSpec | string;
   /** Page number (offset mode, 1-indexed) */
@@ -1338,7 +1367,7 @@ interface RepositoryContext {
    * `options.cache` onto the context so the plugin's `before:<op>`
    * hook can read it.
    */
-  cache?: _$_classytic_repo_core_cache0.CacheOptions;
+  cache?: import('@classytic/repo-core/cache').CacheOptions;
   /** Whether result was served from cache (internal — set by cache plugin) */
   _cacheHit?: boolean;
   /** Cached result (internal — set by cache plugin) */
@@ -1440,7 +1469,7 @@ type EventHandlers<TDoc = unknown> = { [K in RepositoryEvent]?: K extends `befor
   error: Error;
 }) => void | Promise<void> : (payload: {
   context: RepositoryContext;
-}) => void | Promise<void> };
+}) => void | Promise<void>; };
 /** Event payload */
 interface EventPayload {
   context: RepositoryContext;
@@ -1584,7 +1613,7 @@ interface MinMaxResult {
  */
 interface CacheOperationOptions {
   /** Per-call cache override forwarded to the unified cache plugin. */
-  cache?: _$_classytic_repo_core_cache0.CacheOptions;
+  cache?: import('@classytic/repo-core/cache').CacheOptions;
 }
 /** Cascade relation definition */
 interface CascadeRelation {
@@ -1721,7 +1750,7 @@ type AllPluginMethods<TDoc> = {
    * `CacheEngine` plus convenience invalidation helpers. `undefined` when
    * no cache plugin is wired.
    */
-  cache?: _$_classytic_repo_core_cache0.RepositoryCacheHandle;
+  cache?: import('@classytic/repo-core/cache').RepositoryCacheHandle;
 };
 /**
  * Helper type to add all plugin methods to a repository class

package/dist/{update-CvCMv5Cl.mjs → update-1Lq9OMD2.mjs}

@@ -1,6 +1,6 @@
-import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-import { n as warn } from "./logger-B8wf-Mtb.mjs";
-import { t as createError } from "./error-BTeepSNL.mjs";
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { n as warn } from "./logger-K7dPmu2U.mjs";
+import { t as createError } from "./error-BuByZwKU.mjs";
 import { isFilter } from "@classytic/repo-core/filter";
 //#region src/filter/compile.ts
 /**
@@ -21,7 +21,7 @@ import { isFilter } from "@classytic/repo-core/filter";
 * handles them"). This set covers every operator the arc aggregation
 * guard accepts in `parseDateRange` and `hasFilterOnField`.
 */
-const SHORTHAND_OPS = new Set([
+const SHORTHAND_OPS = /* @__PURE__ */ new Set([
 	"eq",
 	"ne",
 	"gt",
@@ -35,7 +35,7 @@ const SHORTHAND_OPS = new Set([
 	"mod"
 ]);
 /** Range operators whose string values should be coerced to Date. */
-const RANGE_OPS = new Set([
+const RANGE_OPS = /* @__PURE__ */ new Set([
 	"gt",
 	"gte",
 	"lt",

package/dist/utils/index.d.mts

@@ -1,2 +1,2 @@
-import { a as IdType, c as isObjectIdInstance, d as filterResponseData, f as getFieldsForUser, i as configureLogger, l as isValidIdForType, m as createError, n as buildCrudSchemasFromMongooseSchema, o as getSchemaIdType, p as getMongooseProjection, r as createMemoryCache, t as buildCrudSchemasFromModel, u as createFieldPreset } from "../mongooseToJsonSchema-BdQJU39w.mjs";
+import { a as IdType, c as isObjectIdInstance, d as filterResponseData, f as getFieldsForUser, i as configureLogger, l as isValidIdForType, m as createError, n as buildCrudSchemasFromMongooseSchema, o as getSchemaIdType, p as getMongooseProjection, r as createMemoryCache, t as buildCrudSchemasFromModel, u as createFieldPreset } from "../mongooseToJsonSchema-D2CyAMIC.mjs";
 export { type IdType, buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, configureLogger, createError, createFieldPreset, createMemoryCache, filterResponseData, getFieldsForUser, getMongooseProjection, getSchemaIdType, isObjectIdInstance, isValidIdForType };

package/dist/utils/index.mjs

@@ -1,6 +1,6 @@
-import { i as isValidIdForType, r as isObjectIdInstance, t as getSchemaIdType } from "../id-resolution-CnN0YA8t.mjs";
-import { t as configureLogger } from "../logger-B8wf-Mtb.mjs";
-import { t as createError } from "../error-BTeepSNL.mjs";
-import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "../field-selection-CQW3WBiK.mjs";
-import { n as buildCrudSchemasFromMongooseSchema, r as createMemoryCache, t as buildCrudSchemasFromModel } from "../mongooseToJsonSchema-CBEQmeEa.mjs";
+import { i as isValidIdForType, r as isObjectIdInstance, t as getSchemaIdType } from "../id-resolution-P2OzcyRl.mjs";
+import { t as configureLogger } from "../logger-K7dPmu2U.mjs";
+import { t as createError } from "../error-BuByZwKU.mjs";
+import { i as getMongooseProjection, n as filterResponseData, r as getFieldsForUser, t as createFieldPreset } from "../field-selection-FSQFLpsU.mjs";
+import { n as buildCrudSchemasFromMongooseSchema, r as createMemoryCache, t as buildCrudSchemasFromModel } from "../mongooseToJsonSchema-khdzVo8x.mjs";
 export { buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, configureLogger, createError, createFieldPreset, createMemoryCache, filterResponseData, getFieldsForUser, getMongooseProjection, getSchemaIdType, isObjectIdInstance, isValidIdForType };