@classytic/mongokit 3.1.6 → 3.2.1

package/dist/{mongooseToJsonSchema-Cc5AwuDu.d.ts → mongooseToJsonSchema-CaRF_bCN.d.ts}

@@ -1,4 +1,4 @@
-import { U as UserContext, F as FieldPreset, H as HttpError, C as CacheAdapter, g as SchemaBuilderOptions, h as CrudSchemas, V as ValidationResult } from './types-B5Uv6Ak7.js';
+import { z as UserContext, Q as FieldPreset, H as HttpError, a7 as CacheAdapter, X as SchemaBuilderOptions, Z as CrudSchemas, V as ValidationResult } from './types-Jni1KgkP.js';
 import mongoose__default, { Schema } from 'mongoose';
 
 /**
@@ -109,6 +109,37 @@ declare function createFieldPreset(config: Partial<FieldPreset>): FieldPreset;
  */
 declare function createError(status: number, message: string): HttpError;
 
+/**
+ * Internal Logger
+ *
+ * Centralizes all console output behind configurable functions.
+ * Users can silence, redirect, or replace the logger entirely.
+ *
+ * @example
+ * ```typescript
+ * import { configureLogger } from '@classytic/mongokit';
+ *
+ * // Silence all warnings
+ * configureLogger({ warn: () => {} });
+ *
+ * // Send to your logging system
+ * configureLogger({ warn: (msg) => myLogger.warn(msg) });
+ *
+ * // Silence everything
+ * configureLogger(false);
+ * ```
+ */
+type LogFn = (message: string, ...args: unknown[]) => void;
+interface LoggerConfig {
+    warn: LogFn;
+    debug: LogFn;
+}
+/**
+ * Configure the internal logger.
+ * Pass `false` to silence all output.
+ */
+declare function configureLogger(config: Partial<LoggerConfig> | false): void;
+
 /**
  * In-Memory Cache Adapter
  *
@@ -197,4 +228,4 @@ declare function isFieldUpdateAllowed(fieldName: string, options?: SchemaBuilder
  */
 declare function validateUpdateBody(body?: Record<string, unknown>, options?: SchemaBuilderOptions): ValidationResult;
 
-export { getMongooseProjection as a, buildCrudSchemasFromMongooseSchema as b, createFieldPreset as c, buildCrudSchemasFromModel as d, getImmutableFields as e, filterResponseData as f, getFieldsForUser as g, getSystemManagedFields as h, isFieldUpdateAllowed as i, createError as j, createMemoryCache as k, validateUpdateBody as v };
+export { getMongooseProjection as a, buildCrudSchemasFromMongooseSchema as b, createFieldPreset as c, buildCrudSchemasFromModel as d, getImmutableFields as e, filterResponseData as f, getFieldsForUser as g, getSystemManagedFields as h, isFieldUpdateAllowed as i, createError as j, configureLogger as k, createMemoryCache as l, validateUpdateBody as v };

package/dist/pagination/PaginationEngine.d.ts

@@ -1,5 +1,5 @@
 import { Model } from 'mongoose';
-import { A as AnyDocument, P as PaginationConfig, O as OffsetPaginationOptions, a as OffsetPaginationResult, K as KeysetPaginationOptions, b as KeysetPaginationResult, c as AggregatePaginationOptions, d as AggregatePaginationResult } from '../types-B5Uv6Ak7.js';
+import { A as AnyDocument, P as PaginationConfig, O as OffsetPaginationOptions, a as OffsetPaginationResult, K as KeysetPaginationOptions, b as KeysetPaginationResult, c as AggregatePaginationOptions, d as AggregatePaginationResult } from '../types-Jni1KgkP.js';
 
 /**
  * Pagination Engine

package/dist/pagination/PaginationEngine.js

@@ -1,2 +1,3 @@
-export { PaginationEngine } from '../chunks/chunk-M2XHQGZB.js';
-import '../chunks/chunk-VJXDGP3C.js';
+export { PaginationEngine } from '../chunks/chunk-44KXLGPO.js';
+import '../chunks/chunk-JWUAVZ3L.js';
+import '../chunks/chunk-WSFCRVEQ.js';

package/dist/plugins/index.d.ts

@@ -1,4 +1,4 @@
-import { F as FieldPreset, G as Plugin, a2 as Logger, a3 as SoftDeleteOptions, k as ObjectId, f as SortSpec, S as SelectSpec, e as PopulateSpec, a as OffsetPaginationResult, L as RepositoryInstance, a0 as ValidatorDefinition, a1 as ValidationChainOptions, m as RepositoryContext, a8 as CacheOptions, aa as CacheStats, ac as CascadeOptions } from '../types-B5Uv6Ak7.js';
+import { Q as FieldPreset, g as Plugin, a1 as Logger, a2 as SoftDeleteOptions, j as ObjectId, f as SortSpec, S as SelectSpec, e as PopulateSpec, a as OffsetPaginationResult, E as RepositoryInstance, $ as ValidatorDefinition, a0 as ValidationChainOptions, k as RepositoryContext, a8 as CacheOptions, aa as CacheStats, ac as CascadeOptions } from '../types-Jni1KgkP.js';
 import { ClientSession } from 'mongoose';
 
 /**
@@ -796,4 +796,127 @@ interface CacheMethods {
  */
 declare function cascadePlugin(options: CascadeOptions): Plugin;
 
-export { type AggregateHelpersMethods, type BatchOperationsMethods, type CacheMethods, type MethodRegistryRepository, type MongoOperationsMethods, type SoftDeleteMethods, type SubdocumentMethods, aggregateHelpersPlugin, auditLogPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, fieldFilterPlugin, immutableField, methodRegistryPlugin, mongoOperationsPlugin, requireField, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };
+/**
+ * Multi-Tenant Plugin
+ *
+ * Automatically injects tenant isolation filters into all queries.
+ * Ensures data isolation by adding organizationId (or custom tenant field)
+ * to every read and write operation.
+ *
+ * @example
+ * ```typescript
+ * // Basic — scopes every operation by organizationId from context
+ * const repo = new Repository(Invoice, [
+ *   multiTenantPlugin({ tenantField: 'organizationId' }),
+ * ]);
+ *
+ * const invoices = await repo.getAll(
+ *   { filters: { status: 'paid' } },
+ *   { organizationId: 'org_123' }
+ * );
+ * // Actual query: { status: 'paid', organizationId: 'org_123' }
+ *
+ * // Super admin bypass — skip scoping based on context
+ * const repo = new Repository(Invoice, [
+ *   multiTenantPlugin({
+ *     tenantField: 'organizationId',
+ *     skipWhen: (context) => context.role === 'superadmin',
+ *   }),
+ * ]);
+ *
+ * // Admin sees all orgs
+ * await repo.getAll({ page: 1, limit: 10 }, { role: 'superadmin' });
+ *
+ * // Automatic context — resolve tenant from AsyncLocalStorage
+ * const repo = new Repository(Invoice, [
+ *   multiTenantPlugin({
+ *     tenantField: 'organizationId',
+ *     resolveContext: () => asyncLocalStorage.getStore()?.tenantId,
+ *   }),
+ * ]);
+ * ```
+ */
+
+interface MultiTenantOptions {
+    /** Field name used for tenant isolation (default: 'organizationId') */
+    tenantField?: string;
+    /** Context key to read tenant ID from (default: 'organizationId') */
+    contextKey?: string;
+    /** Throw if tenant ID is missing from context (default: true) */
+    required?: boolean;
+    /** Operations to skip tenant injection (e.g., for admin/system queries) */
+    skipOperations?: string[];
+    /**
+     * Dynamic skip — receives the context and operation name, returns true to
+     * bypass tenant scoping for this call. Use for role-based bypass (e.g.,
+     * super admin) without needing a separate repo instance.
+     *
+     * @example
+     * ```typescript
+     * skipWhen: (context) => context.role === 'superadmin'
+     * ```
+     */
+    skipWhen?: (context: RepositoryContext, operation: string) => boolean;
+    /**
+     * Resolve tenant ID from external source (e.g., AsyncLocalStorage, CLS).
+     * Called when tenant ID is not found in context. If it returns a value,
+     * that value is used as the tenant ID without requiring it in context.
+     *
+     * @example
+     * ```typescript
+     * resolveContext: () => asyncLocalStorage.getStore()?.tenantId
+     * ```
+     */
+    resolveContext?: () => string | undefined;
+}
+declare function multiTenantPlugin(options?: MultiTenantOptions): Plugin;
+
+/**
+ * Observability Plugin
+ *
+ * Adds operation timing, structured metrics, and APM hook points.
+ * Works with any monitoring system — just provide an onMetric callback.
+ *
+ * @example
+ * ```typescript
+ * const repo = new Repository(User, [
+ *   observabilityPlugin({
+ *     onMetric: (metric) => {
+ *       // Send to DataDog, New Relic, OpenTelemetry, or console
+ *       console.log(`${metric.operation} took ${metric.durationMs}ms`);
+ *       statsd.histogram('mongokit.operation', metric.durationMs, { op: metric.operation });
+ *     },
+ *   }),
+ * ]);
+ * ```
+ */
+
+interface OperationMetric {
+    /** Operation name (e.g., 'create', 'getAll', 'update') */
+    operation: string;
+    /** Model/collection name */
+    model: string;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Timestamp when the operation started */
+    startedAt: Date;
+    /** User ID if available */
+    userId?: string;
+    /** Organization ID if available */
+    organizationId?: string;
+}
+interface ObservabilityOptions {
+    /** Callback invoked after every operation with timing data */
+    onMetric: (metric: OperationMetric) => void;
+    /** Operations to track (default: all) */
+    operations?: string[];
+    /** Threshold in ms — only report operations slower than this */
+    slowThresholdMs?: number;
+}
+declare function observabilityPlugin(options: ObservabilityOptions): Plugin;
+
+export { type AggregateHelpersMethods, type BatchOperationsMethods, type CacheMethods, type MethodRegistryRepository, type MongoOperationsMethods, type MultiTenantOptions, type ObservabilityOptions, type OperationMetric, type SoftDeleteMethods, type SubdocumentMethods, aggregateHelpersPlugin, auditLogPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, fieldFilterPlugin, immutableField, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, requireField, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin };

package/dist/plugins/index.js

@@ -1,4 +1,6 @@
-export { aggregateHelpersPlugin, auditLogPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, fieldFilterPlugin, immutableField, methodRegistryPlugin, mongoOperationsPlugin, requireField, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin } from '../chunks/chunk-CSLJ2PL2.js';
-import '../chunks/chunk-CF6FLC2G.js';
+export { aggregateHelpersPlugin, auditLogPlugin, autoInject, batchOperationsPlugin, blockIf, cachePlugin, cascadePlugin, fieldFilterPlugin, immutableField, methodRegistryPlugin, mongoOperationsPlugin, multiTenantPlugin, observabilityPlugin, requireField, softDeletePlugin, subdocumentPlugin, timestampPlugin, uniqueField, validationChainPlugin } from '../chunks/chunk-B64F5ZWE.js';
+import '../chunks/chunk-GZBKEPVE.js';
 import '../chunks/chunk-2ZN65ZOP.js';
-import '../chunks/chunk-VJXDGP3C.js';
+import '../chunks/chunk-URLJFIR7.js';
+import '../chunks/chunk-JWUAVZ3L.js';
+import '../chunks/chunk-WSFCRVEQ.js';

package/dist/{types-B5Uv6Ak7.d.ts → types-Jni1KgkP.d.ts}

@@ -1,13 +1,6 @@
+import * as mongoose from 'mongoose';
 import { Document, PopulateOptions, ClientSession, PipelineStage, Model, Types } from 'mongoose';
 
-/**
- * MongoKit Type Definitions
- *
- * Production-grade types for MongoDB repository pattern with TypeScript
- *
- * @module @classytic/mongokit
- */
-
 /** Re-export mongoose ObjectId */
 type ObjectId = Types.ObjectId;
 /** Generic document type */
@@ -220,6 +213,8 @@ interface WithTransactionOptions {
     allowFallback?: boolean;
     /** Optional hook to observe fallback triggers */
     onFallback?: (error: Error) => void;
+    /** MongoDB transaction options (readConcern, writeConcern, readPreference, maxCommitTimeMS) */
+    transactionOptions?: mongoose.mongo.TransactionOptions;
 }
 /** Create operation options */
 interface CreateOptions {
@@ -308,6 +303,8 @@ interface RepositoryContext {
     limit?: number;
     /** Cursor for next page (keyset pagination) */
     after?: string;
+    /** Search query string */
+    search?: string;
     /** Whether this is a soft delete operation (set by softDeletePlugin) */
     softDeleted?: boolean;
     /** Include soft-deleted documents in queries */
@@ -344,6 +341,8 @@ interface RepositoryInstance {
     _pagination: unknown;
     use(plugin: PluginType): this;
     on(event: string, listener: (data: any) => void | Promise<void>): this;
+    off(event: string, listener: (data: any) => void | Promise<void>): this;
+    removeAllListeners(event?: string): this;
     emit(event: string, data: unknown): void;
     emitAsync(event: string, data: unknown): Promise<void>;
     registerMethod?(name: string, fn: Function): void;
@@ -356,9 +355,17 @@ type RepositoryOperation = 'create' | 'createMany' | 'update' | 'updateMany' | '
 type EventPhase = 'before' | 'after' | 'error';
 /** Repository event names (generated from template literals) */
 type RepositoryEvent = `${EventPhase}:${RepositoryOperation}` | 'method:registered' | 'error:hook';
-/** Type-safe event handler map */
+/**
+ * Type-safe event handler map
+ *
+ * Hook signature contract:
+ * - `before:*` — receives `context: RepositoryContext` directly (not wrapped).
+ *   Plugins mutate context in-place to inject filters, data, etc.
+ * - `after:*`  — receives `{ context, result }` where result is the operation output.
+ * - `error:*`  — receives `{ context, error }` where error is the caught Error.
+ */
 type EventHandlers<TDoc = unknown> = {
-    [K in RepositoryEvent]?: K extends `after:${string}` ? (payload: {
+    [K in RepositoryEvent]?: K extends `before:${string}` ? (context: RepositoryContext) => void | Promise<void> : K extends `after:${string}` ? (payload: {
         context: RepositoryContext;
         result: TDoc | TDoc[];
     }) => void | Promise<void> : K extends `error:${string}` ? (payload: {
@@ -770,4 +777,4 @@ type AllPluginMethods<TDoc> = {
  */
 type WithPlugins<TDoc, TRepo extends RepositoryInstance = RepositoryInstance> = TRepo & AllPluginMethods<TDoc>;
 
-export type { DecodedCursor as $, AnyDocument as A, UpdateManyResult as B, CacheAdapter as C, DeepPartial as D, UpdateWithValidationResult as E, FieldPreset as F, Plugin as G, HttpError as H, InferDocument as I, PluginFunction as J, KeysetPaginationOptions as K, RepositoryInstance as L, RepositoryOperation as M, NonNullableFields as N, OffsetPaginationOptions as O, PaginationConfig as P, EventPhase as Q, RepositoryOptions as R, SelectSpec as S, RepositoryEvent as T, UserContext as U, ValidationResult as V, WithTransactionOptions as W, EventHandlers as X, EventPayload as Y, FieldRules as Z, JsonSchema as _, OffsetPaginationResult as a, ValidatorDefinition as a0, ValidationChainOptions as a1, Logger as a2, SoftDeleteOptions as a3, SoftDeleteFilterMode as a4, SoftDeleteRepository as a5, GroupResult as a6, MinMaxResult as a7, CacheOptions as a8, CacheOperationOptions as a9, CacheStats as aa, CascadeRelation as ab, CascadeOptions as ac, AllPluginMethods as ad, WithPlugins as ae, KeysetPaginationResult as b, AggregatePaginationOptions as c, AggregatePaginationResult as d, PopulateSpec as e, SortSpec as f, SchemaBuilderOptions as g, CrudSchemas as h, PaginationResult as i, PluginType as j, ObjectId as k, UpdateOptions as l, RepositoryContext as m, AnyModel as n, SortDirection as o, HookMode as p, InferRawDoc as q, PartialBy as r, RequiredBy as s, KeysOfType as t, Strict as u, CreateInput as v, UpdateInput as w, OperationOptions as x, CreateOptions as y, DeleteResult as z };
+export type { ValidatorDefinition as $, AnyDocument as A, PluginFunction as B, CreateInput as C, DeepPartial as D, RepositoryInstance as E, RepositoryOperation as F, EventPhase as G, HttpError as H, InferDocument as I, RepositoryEvent as J, KeysetPaginationOptions as K, EventHandlers as L, EventPayload as M, NonNullableFields as N, OffsetPaginationOptions as O, PaginationConfig as P, FieldPreset as Q, RepositoryOptions as R, SelectSpec as S, FieldRules as T, UpdateOptions as U, ValidationResult as V, WithTransactionOptions as W, SchemaBuilderOptions as X, JsonSchema as Y, CrudSchemas as Z, DecodedCursor as _, OffsetPaginationResult as a, ValidationChainOptions as a0, Logger as a1, SoftDeleteOptions as a2, SoftDeleteFilterMode as a3, SoftDeleteRepository as a4, GroupResult as a5, MinMaxResult as a6, CacheAdapter as a7, CacheOptions as a8, CacheOperationOptions as a9, CacheStats as aa, CascadeRelation as ab, CascadeOptions as ac, AllPluginMethods as ad, WithPlugins as ae, KeysetPaginationResult as b, AggregatePaginationOptions as c, AggregatePaginationResult as d, PopulateSpec as e, SortSpec as f, Plugin as g, PaginationResult as h, PluginType as i, ObjectId as j, RepositoryContext as k, AnyModel as l, SortDirection as m, HookMode as n, InferRawDoc as o, PartialBy as p, RequiredBy as q, KeysOfType as r, Strict as s, UpdateInput as t, OperationOptions as u, CreateOptions as v, DeleteResult as w, UpdateManyResult as x, UpdateWithValidationResult as y, UserContext as z };

package/dist/utils/index.d.ts

@@ -1,5 +1,5 @@
-export { d as buildCrudSchemasFromModel, b as buildCrudSchemasFromMongooseSchema, j as createError, c as createFieldPreset, k as createMemoryCache, f as filterResponseData, g as getFieldsForUser, e as getImmutableFields, a as getMongooseProjection, h as getSystemManagedFields, i as isFieldUpdateAllowed, v as validateUpdateBody } from '../mongooseToJsonSchema-Cc5AwuDu.js';
-import { S as SelectSpec, e as PopulateSpec, f as SortSpec } from '../types-B5Uv6Ak7.js';
+export { d as buildCrudSchemasFromModel, b as buildCrudSchemasFromMongooseSchema, k as configureLogger, j as createError, c as createFieldPreset, l as createMemoryCache, f as filterResponseData, g as getFieldsForUser, e as getImmutableFields, a as getMongooseProjection, h as getSystemManagedFields, i as isFieldUpdateAllowed, v as validateUpdateBody } from '../mongooseToJsonSchema-CaRF_bCN.js';
+import { S as SelectSpec, e as PopulateSpec, f as SortSpec } from '../types-Jni1KgkP.js';
 import 'mongoose';
 
 /**

package/dist/utils/index.js

@@ -1,3 +1,5 @@
-export { buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, createMemoryCache, getImmutableFields, getSystemManagedFields, isFieldUpdateAllowed, validateUpdateBody } from '../chunks/chunk-IT7DCOKR.js';
+export { buildCrudSchemasFromModel, buildCrudSchemasFromMongooseSchema, createMemoryCache, getImmutableFields, getSystemManagedFields, isFieldUpdateAllowed, validateUpdateBody } from '../chunks/chunk-UE2IEXZJ.js';
 export { byIdKey, byQueryKey, createFieldPreset, filterResponseData, getFieldsForUser, getMongooseProjection, listPattern, listQueryKey, modelPattern, versionKey } from '../chunks/chunk-2ZN65ZOP.js';
-export { createError } from '../chunks/chunk-VJXDGP3C.js';
+export { configureLogger } from '../chunks/chunk-URLJFIR7.js';
+export { createError } from '../chunks/chunk-JWUAVZ3L.js';
+import '../chunks/chunk-WSFCRVEQ.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.1.6",
+  "version": "3.2.1",
   "description": "Production-grade MongoDB repositories with zero dependencies - smart pagination, events, and plugins",
   "type": "module",
   "sideEffects": false,
@@ -27,6 +27,10 @@
     "./actions": {
       "types": "./dist/actions/index.d.ts",
       "default": "./dist/actions/index.js"
+    },
+    "./ai": {
+      "types": "./dist/ai/index.d.ts",
+      "default": "./dist/ai/index.js"
     }
   },
   "files": [
@@ -50,6 +54,10 @@
     "cache",
     "multi-tenant",
     "multi-tenancy",
+    "vector-search",
+    "embeddings",
+    "atlas-search",
+    "observability",
     "event-driven",
     "plugin-based",
     "zero-dependencies",
@@ -73,7 +81,7 @@
   },
   "homepage": "https://github.com/classytic/mongokit#readme",
   "peerDependencies": {
-    "mongoose": "^8.0.0 || ^9.0.0"
+    "mongoose": "^9.0.0"
   },
   "engines": {
     "node": ">=18"

package/dist/chunks/chunk-VJXDGP3C.js

@@ -1,14 +0,0 @@
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-// src/utils/error.ts
-function createError(status, message) {
-  const error = new Error(message);
-  error.status = status;
-  return error;
-}
-
-export { __export, createError };