modelence 0.12.6 → 0.13.0

package/dist/{types-l1amQvLa.d.ts → types-BkwhamTw.d.ts}

@@ -1,7 +1,7 @@
 import './index-CwdohC5n.js';
-import { i as Context } from './types-Dr14pZxy.js';
+import { i as Context } from './types-D4VeJMYX.js';
 import * as mongodb from 'mongodb';
-import { WithId, IndexDescription, SearchIndexDescription, MongoClient, Collection, FilterOperators, Document, FindOptions, ObjectId, OptionalUnlessRequiredId, InsertOneResult, InsertManyResult, UpdateFilter, UpdateResult, ClientSession, DeleteResult, AggregateOptions, AggregationCursor, AnyBulkWriteOperation, BulkWriteResult } from 'mongodb';
+import { WithId, IndexDescription, SearchIndexDescription, MongoClient, Collection, FilterOperators, Document, FindOptions, ObjectId, SortDirection, OptionalUnlessRequiredId, InsertOneResult, InsertManyResult, UpdateFilter, UpdateResult, ClientSession, DeleteResult, AggregateOptions, AggregationCursor, AnyBulkWriteOperation, BulkWriteResult } from 'mongodb';
 import { z, ZodNumber, ZodArray } from 'zod';
 import { Request, Response, NextFunction } from 'express';
 
@@ -146,6 +146,26 @@ type EnhancedFilterOperators<T> = Omit<FilterOperators<T>, '$in' | '$nin'> & {
     $in?: ArrayLikeOfUnion<T>;
     $nin?: ArrayLikeOfUnion<T>;
 };
+type TypedFieldSelection<T, TValue> = {
+    [K in keyof WithId<T> & string]?: TValue;
+} & {
+    [key: `${string}.${string}`]: TValue;
+};
+type ProjectionValue = 0 | 1 | boolean | {
+    $meta: string;
+} | {
+    $slice: number | [number, number];
+} | {
+    $elemMatch: Document;
+};
+type TypedSort<T> = TypedFieldSelection<T, SortDirection>;
+type TypedProjection<T> = TypedFieldSelection<T, ProjectionValue>;
+type FetchOptions<T> = {
+    sort?: TypedSort<T>;
+    limit?: number;
+    skip?: number;
+    projection?: TypedProjection<T>;
+};
 type IndexCreationMode = 'blocking' | 'background';
 /**
  * Custom filter value type that handles array fields specially:
@@ -381,14 +401,29 @@ declare class Store<TSchema extends ModelSchema, TMethods extends Record<string,
      * Fetches multiple documents, equivalent to Node.js MongoDB driver's `find` and `toArray` methods combined.
      *
      * @param query - The query to filter documents
-     * @param options - Options
+     * @param options - Optional fetch options
+     * @param options.projection - Fields to include or exclude in the result documents
+     * @param options.sort - Sort order for matching documents
+     * @param options.limit - Maximum number of documents to return
+     * @param options.skip - Number of matching documents to skip
      * @returns The documents
+     *
+     * @example
+     * ```ts
+     * // Include only selected fields
+     * const docs = await store.fetch(
+     *   { userId: user.id },
+     *   { projection: { framework: 1, title: 1 }, sort: { createdAt: -1 }, limit: 50 }
+     * );
+     *
+     * // Exclude large fields when not needed
+     * const chunks = await store.fetch(
+     *   { documentId },
+     *   { projection: { embedding: 0 } }
+     * );
+     * ```
      */
-    fetch(query: TypedFilter<this['_type']>, options?: {
-        sort?: Document;
-        limit?: number;
-        skip?: number;
-    }): Promise<this['_doc'][]>;
+    fetch(query: TypedFilter<this['_type']>, options?: FetchOptions<this['_type']>): Promise<this['_doc'][]>;
     /**
      * Inserts a single document
      *

package/dist/{types-Dr14pZxy.d.ts → types-D4VeJMYX.d.ts}

@@ -19,7 +19,31 @@ type ConfigSchema = {
 type Configs = Record<ConfigKey, AppConfig>;
 type ValueType<T> = T extends 'number' ? number : T extends 'string' ? string : T extends 'text' ? string : T extends 'boolean' ? boolean : T extends 'secret' ? string : never;
 
-type User = Document;
+interface UserEmail {
+    address: string;
+    verified: boolean;
+}
+interface User extends Document {
+    _id: ObjectId;
+    handle: string;
+    emails?: UserEmail[];
+    status?: 'active' | 'disabled' | 'deleted';
+    createdAt: Date;
+    disabledAt?: Date;
+    deletedAt?: Date;
+    roles?: string[];
+    authMethods: {
+        password?: {
+            hash: string;
+        };
+        google?: {
+            id: string;
+        };
+        github?: {
+            id: string;
+        };
+    };
+}
 type UserInfo = {
     /** The user's unique identifier. */
     id: string;
@@ -179,4 +203,4 @@ interface WebsocketClientProvider {
     }): void;
 }
 
-export { type AuthSuccessProps as A, type ConfigSchema as C, type DefaultRoles as D, type Handler as H, type MethodDefinition as M, type Permission as P, type RoleDefinition as R, ServerChannel as S, type User as U, type WebsocketServerProvider as W, type WebsocketClientProvider as a, type ConfigKey as b, ClientChannel as c, type AuthErrorProps as d, type AppConfig as e, type Session as f, type UserInfo as g, type Role as h, type Context as i, type ClientInfo as j, type ConnectionInfo as k, type Args as l, type MethodType as m, type Method as n, type ConfigType as o, type Configs as p, type AuthProvider as q };
+export { type AuthSuccessProps as A, type ConfigSchema as C, type DefaultRoles as D, type Handler as H, type MethodDefinition as M, type Permission as P, type RoleDefinition as R, ServerChannel as S, type User as U, type WebsocketServerProvider as W, type WebsocketClientProvider as a, type ConfigKey as b, ClientChannel as c, type AuthErrorProps as d, type AppConfig as e, type Session as f, type UserInfo as g, type Role as h, type Context as i, type ClientInfo as j, type ConnectionInfo as k, type Args as l, type MethodType as m, type Method as n, type ConfigType as o, type Configs as p, type UserEmail as q, type AuthProvider as r };

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 export { A as AppServer, E as ExpressMiddleware, M as ModelenceConfig } from './index-CwdohC5n.js';
-export { e as AppConfig, l as Args, d as AuthErrorProps, q as AuthProvider, A as AuthSuccessProps, j as ClientInfo, b as ConfigKey, C as ConfigSchema, o as ConfigType, p as Configs, k as ConnectionInfo, i as Context, D as DefaultRoles, H as Handler, n as Method, M as MethodDefinition, m as MethodType, P as Permission, h as Role, R as RoleDefinition, f as Session, U as User, g as UserInfo, a as WebsocketClientProvider, W as WebsocketServerProvider } from './types-Dr14pZxy.js';
-export { B as BodyConfig, h as CronJob, C as CronJobInputParams, i as CronJobMetadata, g as EmailAttachment, c as EmailPayload, E as EmailProvider, k as ExpressHandler, H as HttpMethod, I as InferDocumentType, M as ModelSchema, a as RateLimitRule, b as RateLimitType, R as RouteDefinition, d as RouteHandler, j as RouteHandlers, e as RouteParams, f as RouteResponse, s as schema } from './types-l1amQvLa.js';
+export { e as AppConfig, l as Args, d as AuthErrorProps, r as AuthProvider, A as AuthSuccessProps, j as ClientInfo, b as ConfigKey, C as ConfigSchema, o as ConfigType, p as Configs, k as ConnectionInfo, i as Context, D as DefaultRoles, H as Handler, n as Method, M as MethodDefinition, m as MethodType, P as Permission, h as Role, R as RoleDefinition, f as Session, U as User, q as UserEmail, g as UserInfo, a as WebsocketClientProvider, W as WebsocketServerProvider } from './types-D4VeJMYX.js';
+export { B as BodyConfig, h as CronJob, C as CronJobInputParams, i as CronJobMetadata, g as EmailAttachment, c as EmailPayload, E as EmailProvider, k as ExpressHandler, H as HttpMethod, I as InferDocumentType, M as ModelSchema, a as RateLimitRule, b as RateLimitType, R as RouteDefinition, d as RouteHandler, j as RouteHandlers, e as RouteParams, f as RouteResponse, s as schema } from './types-BkwhamTw.js';
 import 'express';
 import 'http';
 import 'mongodb';

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "modelence",
-  "version": "0.12.6",
+  "version": "0.13.0",
   "description": "The Node.js Framework for Real-Time MongoDB Apps",
   "main": "dist/index.js",
   "types": "dist/global.d.ts",