@classytic/mongokit 3.0.5 → 3.1.0

package/dist/{queryParser-CxzCjzXd.d.ts → mongooseToJsonSchema-CUQma8QK.d.ts}

@@ -1,4 +1,4 @@
-import { q as UserContext, F as FieldPreset, H as HttpError, Y as CacheAdapter, y as SchemaBuilderOptions, z as CrudSchemas, V as ValidationResult, v as ParsedQuery } from './types-CHIDluaP.js';
+import { U as UserContext, F as FieldPreset, H as HttpError, C as CacheAdapter, g as SchemaBuilderOptions, h as CrudSchemas, V as ValidationResult } from './types-CrSoCuWu.js';
 import mongoose__default, { Schema } from 'mongoose';
 
 /**
@@ -154,6 +154,8 @@ declare function createMemoryCache(maxEntries?: number): CacheAdapter;
  * Additional Options:
  * - strictAdditionalProperties: Set to true to add "additionalProperties: false" to schemas
  *   This makes Fastify reject unknown fields at validation level (default: false for backward compatibility)
+ * - update.requireAtLeastOne: Set to true to add "minProperties: 1" to update schema
+ *   This prevents empty update payloads (default: false)
  *
  * @example
  * buildCrudSchemasFromModel(Model, {
@@ -163,7 +165,10 @@ declare function createMemoryCache(maxEntries?: number): CacheAdapter;
  *     status: { systemManaged: true },
  *   },
  *   create: { omitFields: ['verifiedAt'] },
- *   update: { omitFields: ['customerId'] }
+ *   update: {
+ *     omitFields: ['customerId'],
+ *     requireAtLeastOne: true // Reject empty updates
+ *   }
  * })
  */
 
@@ -192,112 +197,4 @@ declare function isFieldUpdateAllowed(fieldName: string, options?: SchemaBuilder
  */
 declare function validateUpdateBody(body?: Record<string, unknown>, options?: SchemaBuilderOptions): ValidationResult;
 
-/**
- * Query Parser
- *
- * Parses HTTP query parameters into MongoDB-compatible query objects.
- * Supports operators, pagination, sorting, and filtering.
- */
-
-/** Operator mapping from query syntax to MongoDB operators */
-type OperatorMap = Record<string, string>;
-/** Possible values in filter parameters */
-type FilterValue = string | number | boolean | null | undefined | Record<string, unknown> | unknown[];
-/** Configuration options for QueryParser */
-interface QueryParserOptions {
-    /** Maximum allowed regex pattern length (default: 500) */
-    maxRegexLength?: number;
-    /** Maximum allowed text search query length (default: 200) */
-    maxSearchLength?: number;
-    /** Maximum allowed filter depth (default: 10) */
-    maxFilterDepth?: number;
-    /** Additional operators to block */
-    additionalDangerousOperators?: string[];
-}
-/**
- * Query Parser Class
- *
- * Parses HTTP query parameters into MongoDB-compatible query objects.
- * Includes security measures against NoSQL injection and ReDoS attacks.
- *
- * @example
- * ```typescript
- * import { QueryParser } from '@classytic/mongokit';
- *
- * const parser = new QueryParser({ maxRegexLength: 100 });
- * const query = parser.parseQuery(req.query);
- * ```
- */
-declare class QueryParser {
-    private readonly options;
-    private readonly operators;
-    /**
-     * Dangerous MongoDB operators that should never be accepted from user input
-     * Security: Prevent NoSQL injection attacks
-     */
-    private readonly dangerousOperators;
-    /**
-     * Regex pattern characters that can cause catastrophic backtracking (ReDoS)
-     */
-    private readonly dangerousRegexPatterns;
-    constructor(options?: QueryParserOptions);
-    /**
-     * Parse query parameters into MongoDB query format
-     */
-    parseQuery(query: Record<string, unknown> | null | undefined): ParsedQuery;
-    /**
-     * Parse sort parameter
-     * Converts string like '-createdAt' to { createdAt: -1 }
-     * Handles multiple sorts: '-createdAt,name' → { createdAt: -1, name: 1 }
-     */
-    private _parseSort;
-    /**
-     * Parse standard filter parameter (filter[field]=value)
-     */
-    private _parseFilters;
-    /**
-     * Handle operator syntax: field[operator]=value
-     */
-    private _handleOperatorSyntax;
-    /**
-     * Handle bracket syntax with object value
-     */
-    private _handleBracketSyntax;
-    /**
-     * Convert operator to MongoDB format
-     */
-    private _toMongoOperator;
-    /**
-     * Create a safe regex pattern with protection against ReDoS attacks
-     * @param pattern - The pattern string from user input
-     * @param flags - Regex flags (default: 'i' for case-insensitive)
-     * @returns A safe RegExp or null if pattern is invalid/dangerous
-     */
-    private _createSafeRegex;
-    /**
-     * Escape special regex characters for literal matching
-     */
-    private _escapeRegex;
-    /**
-     * Sanitize text search query for MongoDB $text search
-     * @param search - Raw search input from user
-     * @returns Sanitized search string or undefined
-     */
-    private _sanitizeSearch;
-    /**
-     * Convert values based on operator type
-     */
-    private _convertValue;
-    /**
-     * Parse $or conditions
-     */
-    private _parseOr;
-    /**
-     * Enhance filters with between operator
-     */
-    private _enhanceWithBetween;
-}
-/** Default query parser instance with standard options */
-declare const defaultQueryParser: QueryParser;
-
-export { type FilterValue as F, type OperatorMap as O, QueryParser as Q, getMongooseProjection as a, type QueryParserOptions as b, createFieldPreset as c, defaultQueryParser as d, buildCrudSchemasFromMongooseSchema as e, filterResponseData as f, getFieldsForUser as g, buildCrudSchemasFromModel as h, getImmutableFields as i, getSystemManagedFields as j, isFieldUpdateAllowed as k, createError as l, createMemoryCache as m, 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, createMemoryCache as k, 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-CHIDluaP.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-CrSoCuWu.js';
 
 /**
  * Pagination Engine

package/dist/plugins/index.d.ts

@@ -1,4 +1,4 @@
-import { F as FieldPreset, r as Plugin, L as Logger, M as SoftDeleteOptions, t as RepositoryInstance, G as ValidatorDefinition, I as ValidationChainOptions, i as RepositoryContext, Z as CacheOptions, a1 as CascadeOptions } from '../types-CHIDluaP.js';
+import { F as FieldPreset, u as Plugin, L as Logger, I as SoftDeleteOptions, w as RepositoryInstance, B as ValidatorDefinition, G as ValidationChainOptions, m as RepositoryContext, X as CacheOptions, $ as CascadeOptions } from '../types-CrSoCuWu.js';
 import 'mongoose';
 
 /**

package/dist/{types-CHIDluaP.d.ts → types-CrSoCuWu.d.ts}

@@ -16,7 +16,7 @@ type AnyDocument = Document & Record<string, unknown>;
 type AnyModel = Model<AnyDocument>;
 /** Sort direction */
 type SortDirection = 1 | -1;
-/** Sort specification */
+/** Sort specification for MongoDB queries */
 type SortSpec = Record<string, SortDirection>;
 /** Populate specification */
 type PopulateSpec = string | string[] | PopulateOptions | PopulateOptions[];
@@ -158,6 +158,13 @@ interface OperationOptions {
     /** Additional query filters (e.g., for soft delete) */
     query?: Record<string, unknown>;
 }
+/** withTransaction options */
+interface WithTransactionOptions {
+    /** Allow non-transactional fallback when transactions are unsupported */
+    allowFallback?: boolean;
+    /** Optional hook to observe fallback triggers */
+    onFallback?: (error: Error) => void;
+}
 /** Create operation options */
 interface CreateOptions {
     /** MongoDB session for transactions */
@@ -282,16 +289,6 @@ interface FieldPreset {
     /** Additional fields for admins */
     admin?: string[];
 }
-/** Parsed query result */
-interface ParsedQuery {
-    filters: FilterQuery<AnyDocument>;
-    limit: number;
-    sort: SortSpec | undefined;
-    populate: string | undefined;
-    search: string | undefined;
-    page?: number;
-    after?: string;
-}
 /** Field rules for schema building */
 interface FieldRules {
     [fieldName: string]: {
@@ -328,6 +325,8 @@ interface SchemaBuilderOptions {
     update?: {
         /** Fields to omit from update schema */
         omitFields?: string[];
+        /** Require at least one field to be provided (default: false) */
+        requireAtLeastOne?: boolean;
     };
     /** Query schema options */
     query?: {
@@ -347,6 +346,12 @@ interface JsonSchema {
     enum?: string[];
     format?: string;
     pattern?: string;
+    minProperties?: number;
+    maxProperties?: number;
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
 }
 /** CRUD schemas result - framework-agnostic JSON schemas */
 interface CrudSchemas {
@@ -447,25 +452,7 @@ interface SoftDeleteRepository {
         session?: ClientSession;
     }): Promise<OffsetPaginationResult<unknown>>;
 }
-/** Lookup options for aggregate */
-interface LookupOptions {
-    /** Collection to join */
-    from: string;
-    /** Local field to match */
-    localField: string;
-    /** Foreign field to match */
-    foreignField: string;
-    /** Output array field name */
-    as: string;
-    /** Additional pipeline stages */
-    pipeline?: PipelineStage[];
-    /** Initial match query */
-    query?: FilterQuery<AnyDocument>;
-    /** Operation options */
-    options?: {
-        session?: ClientSession;
-    };
-}
+
 /** Group result */
 interface GroupResult {
     _id: unknown;
@@ -566,4 +553,4 @@ interface HttpError extends Error {
     }>;
 }
 
-export type { CacheStats as $, AnyDocument as A, DecodedCursor as B, CreateOptions as C, DeleteResult as D, EventPayload as E, FieldPreset as F, ValidatorDefinition as G, HttpError as H, ValidationChainOptions as I, JsonSchema as J, KeysetPaginationOptions as K, Logger as L, SoftDeleteOptions as M, SoftDeleteFilterMode as N, OffsetPaginationOptions as O, PaginationConfig as P, SoftDeleteRepository as Q, RepositoryOptions as R, SelectSpec as S, LookupOptions as T, UpdateOptions as U, ValidationResult as V, GroupResult as W, MinMaxResult as X, CacheAdapter as Y, CacheOptions as Z, CacheOperationOptions as _, OffsetPaginationResult as a, CascadeRelation as a0, CascadeOptions as a1, KeysetPaginationResult as b, AggregatePaginationOptions as c, AggregatePaginationResult as d, PopulateSpec as e, SortSpec as f, PluginType as g, ObjectId as h, RepositoryContext as i, AnyModel as j, SortDirection as k, HookMode as l, PaginationResult as m, OperationOptions as n, UpdateManyResult as o, UpdateWithValidationResult as p, UserContext as q, Plugin as r, PluginFunction as s, RepositoryInstance as t, RepositoryEvent as u, ParsedQuery as v, FilterQuery as w, FieldRules as x, SchemaBuilderOptions as y, CrudSchemas as z };
+export type { CascadeOptions as $, AnyDocument as A, ValidatorDefinition as B, CacheAdapter as C, DeleteResult as D, EventPayload as E, FieldPreset as F, ValidationChainOptions as G, HttpError as H, SoftDeleteOptions as I, JsonSchema as J, KeysetPaginationOptions as K, Logger as L, SoftDeleteFilterMode as M, SoftDeleteRepository as N, OffsetPaginationOptions as O, PaginationConfig as P, GroupResult as Q, RepositoryOptions as R, SelectSpec as S, MinMaxResult as T, UserContext as U, ValidationResult as V, WithTransactionOptions as W, CacheOptions as X, CacheOperationOptions as Y, CacheStats as Z, CascadeRelation as _, OffsetPaginationResult as a, 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, OperationOptions as q, CreateOptions as r, UpdateManyResult as s, UpdateWithValidationResult as t, Plugin as u, PluginFunction as v, RepositoryInstance as w, RepositoryEvent as x, FieldRules as y, DecodedCursor as z };

package/dist/utils/index.d.ts

@@ -1,5 +1,5 @@
-export { F as FilterValue, O as OperatorMap, Q as QueryParser, b as QueryParserOptions, h as buildCrudSchemasFromModel, e as buildCrudSchemasFromMongooseSchema, l as createError, c as createFieldPreset, m as createMemoryCache, f as filterResponseData, g as getFieldsForUser, i as getImmutableFields, a as getMongooseProjection, j as getSystemManagedFields, k as isFieldUpdateAllowed, d as queryParser, v as validateUpdateBody } from '../queryParser-CxzCjzXd.js';
-import { S as SelectSpec, e as PopulateSpec, f as SortSpec } from '../types-CHIDluaP.js';
+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-CUQma8QK.js';
+import { S as SelectSpec, e as PopulateSpec, f as SortSpec } from '../types-CrSoCuWu.js';
 import 'mongoose';
 
 /**