@classytic/mongokit 3.0.6 → 3.1.1

package/dist/{types-DDDYo18H.d.ts → types-DA0rs2Jh.d.ts}

@@ -16,14 +16,70 @@ 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[];
 /** Select specification */
 type SelectSpec = string | string[] | Record<string, 0 | 1>;
 /** Filter query type for MongoDB queries (compatible with Mongoose 8 & 9) */
-type FilterQuery<T> = Record<string, unknown>;
+type FilterQuery<_T = unknown> = Record<string, unknown>;
+/**
+ * Infer document type from a Mongoose Model
+ * @example
+ * type UserDoc = InferDocument<typeof UserModel>;
+ */
+type InferDocument<TModel> = TModel extends Model<infer TDoc> ? TDoc : never;
+/**
+ * Infer raw document shape (without Mongoose Document methods)
+ * @example
+ * type User = InferRawDoc<typeof UserModel>;
+ */
+type InferRawDoc<TModel> = TModel extends Model<infer TDoc> ? TDoc extends Document ? Omit<TDoc, keyof Document> : TDoc : never;
+/**
+ * Make specific fields optional
+ * @example
+ * type CreateUser = PartialBy<User, 'createdAt' | 'updatedAt'>;
+ */
+type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Make specific fields required
+ * @example
+ * type UserWithId = RequiredBy<User, '_id'>;
+ */
+type RequiredBy<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+/**
+ * Extract keys of type T that have values of type V
+ * @example
+ * type StringFields = KeysOfType<User, string>; // 'name' | 'email'
+ */
+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;
+/**
+ * Strict object type - prevents excess properties
+ * Use with `satisfies` for compile-time validation
+ */
+type Strict<T> = T & {
+    [K in Exclude<string, keyof T>]?: never;
+};
+/**
+ * NonNullable fields extractor
+ */
+type NonNullableFields<T> = {
+    [K in keyof T]: NonNullable<T[K]>;
+};
+/**
+ * Create/Update input types from document
+ */
+type CreateInput<TDoc> = Omit<TDoc, '_id' | 'createdAt' | 'updatedAt' | '__v'>;
+type UpdateInput<TDoc> = Partial<Omit<TDoc, '_id' | 'createdAt' | '__v'>>;
 /** Hook execution mode */
 type HookMode = 'sync' | 'async';
 /** Repository options */
@@ -242,8 +298,30 @@ interface RepositoryContext {
     lean?: boolean;
     /** MongoDB session */
     session?: ClientSession;
-    /** Include soft-deleted documents */
+    /** Pagination filters */
+    filters?: Record<string, unknown>;
+    /** Sort specification */
+    sort?: SortSpec;
+    /** Page number (offset pagination) */
+    page?: number;
+    /** Items per page */
+    limit?: number;
+    /** Cursor for next page (keyset pagination) */
+    after?: string;
+    /** Whether this is a soft delete operation (set by softDeletePlugin) */
+    softDeleted?: boolean;
+    /** Include soft-deleted documents in queries */
     includeDeleted?: boolean;
+    /** Skip cache for this operation */
+    skipCache?: boolean;
+    /** Custom TTL for this operation (seconds) */
+    cacheTtl?: number;
+    /** Whether result was served from cache (internal) */
+    _cacheHit?: boolean;
+    /** Cached result (internal) */
+    _cachedResult?: unknown;
+    /** IDs to cascade delete (internal) */
+    _cascadeIds?: unknown[];
     /** Custom context data from plugins */
     [key: string]: unknown;
 }
@@ -272,8 +350,24 @@ interface RepositoryInstance {
     hasMethod?(name: string): boolean;
     [key: string]: unknown;
 }
-/** Repository event names */
-type RepositoryEvent = 'before:create' | 'after:create' | 'error:create' | 'before:createMany' | 'after:createMany' | 'error:createMany' | 'before:update' | 'after:update' | 'error:update' | 'before:updateMany' | 'after:updateMany' | 'error:updateMany' | 'before:delete' | 'after:delete' | 'error:delete' | 'before:deleteMany' | 'after:deleteMany' | 'error:deleteMany' | 'before:getById' | 'after:getById' | 'before:getByQuery' | 'after:getByQuery' | 'before:getAll' | 'after:getAll' | 'before:aggregatePaginate' | 'method:registered' | 'error:hook';
+/** Repository operation names */
+type RepositoryOperation = 'create' | 'createMany' | 'update' | 'updateMany' | 'delete' | 'deleteMany' | 'getById' | 'getByQuery' | 'getAll' | 'aggregatePaginate' | 'lookupPopulate';
+/** Event lifecycle phases */
+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 EventHandlers<TDoc = unknown> = {
+    [K in RepositoryEvent]?: K extends `after:${string}` ? (payload: {
+        context: RepositoryContext;
+        result: TDoc | TDoc[];
+    }) => void | Promise<void> : K extends `error:${string}` ? (payload: {
+        context: RepositoryContext;
+        error: Error;
+    }) => void | Promise<void> : (payload: {
+        context: RepositoryContext;
+    }) => void | Promise<void>;
+};
 /** Event payload */
 interface EventPayload {
     context: RepositoryContext;
@@ -289,16 +383,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]: {
@@ -335,6 +419,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?: {
@@ -354,6 +440,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 {
@@ -454,25 +546,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;
@@ -573,4 +647,4 @@ interface HttpError extends Error {
     }>;
 }
 
-export type { CacheOperationOptions 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, WithTransactionOptions as W, GroupResult as X, MinMaxResult as Y, CacheAdapter as Z, CacheOptions as _, OffsetPaginationResult as a, CacheStats as a0, CascadeRelation as a1, CascadeOptions as a2, 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 { 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, 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 };

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-Do3SgsyJ.js';
-import { S as SelectSpec, e as PopulateSpec, f as SortSpec } from '../types-DDDYo18H.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-BKMxPbPp.js';
+import { S as SelectSpec, e as PopulateSpec, f as SortSpec } from '../types-DA0rs2Jh.js';
 import 'mongoose';
 
 /**