express-file-cluster 0.3.5 → 0.3.6

package/dist/{types-BvnDTNNb.d.ts → types-Df0jLGwr.d.ts}

@@ -23,6 +23,10 @@ interface EFCConfig {
     databaseUrl?: string;
     authStrategy?: AuthStrategy;
     jwtSecret?: string;
+    /** JWT lifetime, e.g. '15m', '1h', '7d'. Default: '7d'. */
+    jwtExpiresIn?: string;
+    /** Cookie domain for the 'http-only' auth strategy. Default: unset (host-only cookie). */
+    cookieDomain?: string;
     cluster?: boolean;
     workers?: number;
     tasks?: TaskConfig | false;
@@ -70,19 +74,36 @@ interface TaskDefinition<TPayload = unknown> {
     name: string;
     filePath?: string;
 }
+/** Primitive field types usable directly, or as the item type of an `array` field via `of`. */
+type PrimitiveFieldType = 'string' | 'number' | 'boolean' | 'date' | 'object' | 'objectId';
 interface FieldDefinition {
-    type: 'string' | 'number' | 'boolean' | 'date' | 'object' | 'array';
+    type: PrimitiveFieldType | 'array';
     required?: boolean;
     unique?: boolean;
     default?: unknown;
+    /** Restricts the field to a fixed set of values. Valid on `string` and `number` types. */
+    enum?: readonly (string | number)[];
+    /** Mongoose model name to reference. Valid on `objectId` types (bare or as an array's `of`). */
+    ref?: string;
+    /** Item type for `array` fields, e.g. `{ type: 'array', of: 'string' }`. Omit for an untyped array. */
+    of?: PrimitiveFieldType;
+}
+/**
+ * A schema field is either a `FieldDefinition`, or a one-element tuple holding a nested
+ * `ModelSchema` — the latter defines an array of embedded sub-documents, e.g.:
+ * `route_progress: [{ route_id: { type: 'string' } }]`
+ */
+type ModelSchema = Record<string, FieldDefinition | [ModelSchema]>;
+interface ModelQueryOptions {
+    /** Mongoose `.populate()` path(s) to resolve on `objectId`/ref fields. */
+    populate?: string | string[];
 }
-type ModelSchema = Record<string, FieldDefinition>;
 interface ModelCRUD<T extends Record<string, any>> {
-    find(filter?: Partial<T>): Promise<T[]>;
-    findById(id: string): Promise<(T & {
+    find(filter?: Partial<T>, options?: ModelQueryOptions): Promise<T[]>;
+    findById(id: string, options?: ModelQueryOptions): Promise<(T & {
         id: string;
     }) | null>;
-    findOne(filter: Partial<T>): Promise<(T & {
+    findOne(filter: Partial<T>, options?: ModelQueryOptions): Promise<(T & {
         id: string;
     }) | null>;
     create(data: Partial<T>): Promise<T & {
@@ -95,4 +116,4 @@ interface ModelCRUD<T extends Record<string, any>> {
     count(filter?: Partial<T>): Promise<number>;
 }
 
-export type { AuthStrategy as A, CorsConfig as C, DatabaseEngine as D, EFCConfig as E, ModelSchema as M, RouteEntry as R, TaskDefinition as T, TaskOptions as a, ModelCRUD as b, RouteMeta as c, RouteMethodMeta as d };
+export type { AuthStrategy as A, CorsConfig as C, DatabaseEngine as D, EFCConfig as E, FieldDefinition as F, ModelSchema as M, RouteEntry as R, TaskDefinition as T, TaskOptions as a, ModelCRUD as b, ModelQueryOptions as c, RouteMeta as d, RouteMethodMeta as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "express-file-cluster",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "Enterprise-grade, zero-boilerplate backend framework with file-based routing and multi-core clustering",
   "license": "MIT",
   "type": "module",