@classytic/mongokit 3.6.4 → 3.8.0

package/dist/{validation-chain.plugin-BXx6Ogpp.d.mts → validation-chain.plugin-wGF34Ym-.d.mts}

@@ -1,5 +1,6 @@
-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-BoH1qdHo.mjs";
+import { Ct as ValidatorDefinition, H as ObjectId, L as Logger, Q as PopulateSpec, T as FieldPreset, W as OffsetPaginationResult, Y as Plugin, ct as SelectSpec, dt as SoftDeleteOptions, f as CascadeOptions, l as CacheOptions, mt as SortSpec, rt as RepositoryInstance, tt as RepositoryContext, u as CacheStats, xt as ValidationChainOptions } from "./types-D57SZJeE.mjs";
 import mongoose, { ClientSession } from "mongoose";
+import { AsyncLocalStorage } from "node:async_hooks";
 
 //#region src/plugins/aggregate-helpers.plugin.d.ts
 /**
@@ -118,7 +119,7 @@ interface AuditTrailOptions {
    */
   excludeFields?: string[];
 }
-type AuditOperation = 'create' | 'update' | 'delete';
+type AuditOperation = 'create' | 'update' | 'delete' | 'findOneAndUpdate';
 interface AuditEntry {
   model: string;
   operation: AuditOperation;
@@ -1062,6 +1063,28 @@ interface SubdocumentMethods<TDoc> {
   deleteSubdocument(parentId: string | ObjectId, arrayPath: string, subId: string | ObjectId, options?: Record<string, unknown>): Promise<TDoc>;
 }
 //#endregion
+//#region src/plugins/tenant-context.d.ts
+interface TenantStore {
+  tenantId: string | undefined;
+  [key: string]: unknown;
+}
+interface TenantContext {
+  /** Run `fn` with the given tenant store active for its entire async tree. */
+  run<T>(store: TenantStore, fn: () => T): T;
+  /** Current tenant ID, or undefined if no context is active. */
+  getTenantId(): string | undefined;
+  /** Full store for the current context (use for extra per-request metadata). */
+  getStore(): TenantStore | undefined;
+  /**
+   * Assert that a tenant context is active; throw otherwise.
+   * Useful in hot paths where a missing tenant must fail loud, not silent.
+   */
+  requireTenantId(): string;
+  /** Underlying AsyncLocalStorage — escape hatch for advanced composition. */
+  readonly storage: AsyncLocalStorage<TenantStore>;
+}
+declare function createTenantContext(): TenantContext;
+//#endregion
 //#region src/plugins/timestamp.plugin.d.ts
 /**
  * Timestamp plugin that auto-injects timestamps
@@ -1072,7 +1095,7 @@ interface SubdocumentMethods<TDoc> {
 declare function timestampPlugin(): Plugin;
 //#endregion
 //#region src/plugins/validation-chain.plugin.d.ts
-type OperationType = 'create' | 'createMany' | 'update' | 'delete';
+type OperationType = 'create' | 'createMany' | 'update' | 'findOneAndUpdate' | 'delete';
 /**
  * Validation chain plugin
  *
@@ -1110,4 +1133,4 @@ declare function immutableField(field: string): ValidatorDefinition;
  */
 declare function uniqueField(field: string, errorMessage?: string): ValidatorDefinition;
 //#endregion
-export { dateSequentialId as A, AuditEntry as B, elasticSearchPlugin as C, PrefixedIdOptions as D, IdGenerator as E, CacheMethods as F, AuditTrailOptions as G, AuditQueryOptions as H, cachePlugin as I, auditLogPlugin as J, AuditTrailQuery as K, BatchOperationsMethods as L, prefixedId as M, sequentialId as N, SequentialIdOptions as O, cascadePlugin as P, BulkWriteResult as R, ElasticSearchOptions as S, DateSequentialIdOptions as T, AuditQueryResult as U, AuditOperation as V, AuditTrailMethods as W, aggregateHelpersPlugin as X, AggregateHelpersMethods as Y, MongoOperationsMethods as _, uniqueField as a, methodRegistryPlugin as b, SubdocumentMethods as c, softDeletePlugin as d, ObservabilityOptions as f, multiTenantPlugin as g, MultiTenantOptions as h, requireField as i, getNextSequence as j, customIdPlugin as k, subdocumentPlugin as l, observabilityPlugin as m, blockIf as n, validationChainPlugin as o, OperationMetric as p, auditTrailPlugin as q, immutableField as r, timestampPlugin as s, autoInject as t, SoftDeleteMethods as u, mongoOperationsPlugin as v, CustomIdOptions as w, fieldFilterPlugin as x, MethodRegistryRepository as y, batchOperationsPlugin as z };
+export { aggregateHelpersPlugin as $, PrefixedIdOptions as A, BatchOperationsMethods as B, methodRegistryPlugin as C, CustomIdOptions as D, elasticSearchPlugin as E, prefixedId as F, AuditQueryOptions as G, batchOperationsPlugin as H, sequentialId as I, AuditTrailOptions as J, AuditQueryResult as K, cascadePlugin as L, customIdPlugin as M, dateSequentialId as N, DateSequentialIdOptions as O, getNextSequence as P, AggregateHelpersMethods as Q, CacheMethods as R, MethodRegistryRepository as S, ElasticSearchOptions as T, AuditEntry as U, BulkWriteResult as V, AuditOperation as W, auditTrailPlugin as X, AuditTrailQuery as Y, auditLogPlugin as Z, observabilityPlugin as _, uniqueField as a, MongoOperationsMethods as b, TenantContext as c, SubdocumentMethods as d, subdocumentPlugin as f, OperationMetric as g, ObservabilityOptions as h, requireField as i, SequentialIdOptions as j, IdGenerator as k, TenantStore as l, softDeletePlugin as m, blockIf as n, validationChainPlugin as o, SoftDeleteMethods as p, AuditTrailMethods as q, immutableField as r, timestampPlugin as s, autoInject as t, createTenantContext as u, MultiTenantOptions as v, fieldFilterPlugin as w, mongoOperationsPlugin as x, multiTenantPlugin as y, cachePlugin as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/mongokit",
-  "version": "3.6.4",
+  "version": "3.8.0",
   "description": "Production-grade MongoDB repositories with zero dependencies - smart pagination, events, and plugins",
   "type": "module",
   "sideEffects": false,
@@ -101,8 +101,12 @@
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
+    "test": "vitest run --project unit --project integration",
+    "test:unit": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "test:e2e": "vitest run --project e2e",
+    "test:all": "vitest run --project unit --project integration --project e2e",
+    "test:watch": "vitest --project unit --project integration",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
     "lint": "biome check src/",
@@ -124,6 +128,7 @@
     "@vitest/coverage-v8": "^3.2.4",
     "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
+    "dotenv": "^17.4.2",
     "knip": "^6.3.0",
     "mongodb-memory-server": "^10.4.3",
     "mongoose": "^9.4.1",

package/dist/error-Bpbi_NKo.mjs

@@ -1,63 +0,0 @@
-//#region src/utils/logger.ts
-const noop = () => {};
-let current = {
-	warn: console.warn.bind(console),
-	debug: noop
-};
-/**
-* Configure the internal logger.
-* Pass `false` to silence all output.
-*/
-function configureLogger(config) {
-	if (config === false) current = {
-		warn: noop,
-		debug: noop
-	};
-	else current = {
-		...current,
-		...config
-	};
-}
-/** Emit a warning — security blocks, config issues, performance hints */
-function warn(message, ...args) {
-	current.warn(message, ...args);
-}
-/** Emit debug info — only visible when debug is enabled */
-function debug(message, ...args) {
-	current.debug(message, ...args);
-}
-//#endregion
-//#region src/utils/error.ts
-/**
-* Creates an error with HTTP status code
-*
-* @param status - HTTP status code
-* @param message - Error message
-* @returns Error with status property
-*
-* @example
-* throw createError(404, 'Document not found');
-* throw createError(400, 'Invalid input');
-* throw createError(403, 'Access denied');
-*/
-function createError(status, message) {
-	const error = new Error(message);
-	error.status = status;
-	return error;
-}
-/**
-* Detect and convert a MongoDB E11000 duplicate-key error into
-* a 409 HttpError with an actionable message.
-*
-* Returns `null` when the error is not a duplicate-key error.
-*/
-function parseDuplicateKeyError(error) {
-	if (!error || typeof error !== "object") return null;
-	const mongoErr = error;
-	if (mongoErr.code !== 11e3) return null;
-	const fields = mongoErr.keyPattern ? Object.keys(mongoErr.keyPattern) : [];
-	const values = mongoErr.keyValue ? Object.entries(mongoErr.keyValue).map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join(", ") : "";
-	return createError(409, fields.length ? `Duplicate value for ${fields.join(", ")}${values ? ` (${values})` : ""}` : "Duplicate key error");
-}
-//#endregion
-export { warn as a, debug as i, parseDuplicateKeyError as n, configureLogger as r, createError as t };