modelence 0.6.18 → 0.6.20

package/dist/telemetry.js

@@ -1,2 +1,2 @@
-export{l as captureError,h as logDebug,j as logError,i as logInfo,k as startTransaction}from'./chunk-EY7KRL57.js';//# sourceMappingURL=telemetry.js.map
+export{l as captureError,h as logDebug,j as logError,i as logInfo,k as startTransaction}from'./chunk-CDNHR3S5.js';//# sourceMappingURL=telemetry.js.map
 //# sourceMappingURL=telemetry.js.map

package/dist/types-D6nwUab6.d.ts

@@ -0,0 +1,543 @@
+import './index-CwdohC5n.js';
+import { P as Permission, d as Session, e as UserInfo } from './types-Ds1ESQSs.js';
+import * as mongodb from 'mongodb';
+import { WithId, IndexDescription, SearchIndexDescription, MongoClient, Collection, Filter, FindOptions, ObjectId, Document, 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';
+
+type EmailAttachment = {
+    filename: string;
+    content: Buffer | string;
+    contentType: string;
+};
+type EmailPayload = {
+    from: string;
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    replyTo?: string | string[];
+    headers?: Record<string, string>;
+    attachments?: EmailAttachment[];
+} & ({
+    html: string;
+} | {
+    text: string;
+});
+interface EmailProvider {
+    sendEmail(data: EmailPayload): Promise<void>;
+}
+
+type ClientInfo = {
+    screenWidth: number;
+    screenHeight: number;
+    windowWidth: number;
+    windowHeight: number;
+    pixelRatio: number;
+    orientation: string | null;
+};
+type ConnectionInfo = {
+    ip?: string;
+    userAgent?: string;
+    acceptLanguage?: string;
+    referrer?: string;
+    baseUrl?: string;
+};
+type Context = {
+    session: Session | null;
+    user: UserInfo | null;
+    roles: string[];
+    clientInfo: ClientInfo;
+    connectionInfo: ConnectionInfo;
+};
+type Args = Record<string, unknown>;
+type Handler<T = unknown> = (args: Args, context: Context) => Promise<T> | T;
+type MethodType = 'query' | 'mutation';
+type MethodDefinition<T = unknown> = {
+    permissions?: Permission[];
+    handler: Handler<T>;
+} | Handler<T>;
+type Method<T = unknown> = {
+    type: MethodType;
+    name: string;
+    permissions: Permission[];
+    handler: Handler<T>;
+};
+
+type RateLimitType = 'ip' | 'user';
+type RateLimitRule = {
+    /** Logical action being limited, e.g. "signup" */
+    bucket: string;
+    /** Identifier type of the actor this rule applies to */
+    type: RateLimitType;
+    /** Time window size in milliseconds */
+    window: number;
+    /** Maximum allowed hits within the window */
+    limit: number;
+};
+
+type CronJobHandler = () => Promise<void>;
+type CronJob = {
+    alias: string;
+    params: {
+        description: string;
+        interval: number;
+        timeout: number;
+    };
+    handler: CronJobHandler;
+    state: {
+        startTs?: number;
+        scheduledRunTs?: number;
+        isRunning: boolean;
+    };
+};
+type CronJobInputParams = {
+    description?: string;
+    interval: number;
+    timeout?: number;
+    handler: CronJobHandler;
+};
+type CronJobMetadata = {
+    alias: string;
+    description: string;
+    interval: number;
+    timeout: number;
+};
+
+interface SerializedModelSchema {
+    [key: string]: SerializedSchema | (SerializedSchema | SerializedModelSchema)[] | SerializedModelSchema | 'v2';
+}
+type BaseSerializedSchema = {
+    type: 'string';
+} | {
+    type: 'number';
+} | {
+    type: 'boolean';
+} | {
+    type: 'date';
+} | {
+    type: 'array';
+    items: SerializedSchema;
+} | {
+    type: 'object';
+    items: Record<string, SerializedSchema>;
+} | {
+    type: 'enum';
+    items: readonly string[];
+} | {
+    type: 'union';
+    items: SerializedSchema[];
+} | {
+    type: 'custom';
+    typeName: string;
+};
+type SerializedSchema = BaseSerializedSchema | (BaseSerializedSchema & {
+    optional: true;
+});
+
+/**
+ * Helper type to preserve method types when extending a store.
+ * Maps each method to work with the extended schema while preserving signatures.
+ * @internal
+ */
+type PreserveMethodsForExtendedSchema<TBaseMethods extends Record<string, (...args: never[]) => unknown>, TExtendedSchema extends ModelSchema> = {
+    [K in keyof TBaseMethods]: TBaseMethods[K] extends (this: any, ...args: infer Args) => infer Return ? (this: WithId<InferDocumentType<TExtendedSchema>> & any, ...args: Args) => Return : never;
+};
+/**
+ * The Store class provides a type-safe interface for MongoDB collections with built-in schema validation and helper methods.
+ *
+ * @category Store
+ * @typeParam TSchema - The document schema type
+ * @typeParam TMethods - Custom methods that will be added to documents
+ *
+ * @example
+ * ```ts
+ * const dbTodos = new Store('todos', {
+ *   schema: {
+ *     title: schema.string(),
+ *     completed: schema.boolean(),
+ *     dueDate: schema.date().optional(),
+ *     userId: schema.userId(),
+ *   },
+ *   methods: {
+ *     isOverdue() {
+ *       return this.dueDate < new Date();
+ *     }
+ *   }
+ * });
+ * ```
+ */
+declare class Store<TSchema extends ModelSchema, TMethods extends Record<string, (this: WithId<InferDocumentType<TSchema>> & TMethods, ...args: any[]) => any>> {
+    /** @internal */
+    readonly _type: InferDocumentType<TSchema>;
+    /** @internal */
+    readonly _rawDoc: WithId<this['_type']>;
+    /** @internal */
+    readonly _doc: this['_rawDoc'] & TMethods;
+    readonly Doc: this['_doc'];
+    private name;
+    private readonly schema;
+    private readonly methods?;
+    private readonly indexes;
+    private readonly searchIndexes;
+    private collection?;
+    private client?;
+    /**
+     * Creates a new Store instance
+     *
+     * @param name - The collection name in MongoDB
+     * @param options - Store configuration
+     */
+    constructor(name: string, options: {
+        /** Document schema using Modelence schema types */
+        schema: TSchema;
+        /** Custom methods to add to documents */
+        methods?: TMethods;
+        /** MongoDB indexes to create */
+        indexes: IndexDescription[];
+        /** MongoDB Atlas Search */
+        searchIndexes?: SearchIndexDescription[];
+    });
+    getName(): string;
+    /** @internal */
+    getSchema(): TSchema;
+    /** @internal */
+    getSerializedSchema(): SerializedModelSchema;
+    /**
+     * Extends the store with additional schema fields, indexes, methods, and search indexes.
+     * Returns a new Store instance with the extended schema and updated types.
+     * Methods from the original store are preserved with updated type signatures.
+     *
+     * @param config - Additional schema fields, indexes, methods, and search indexes to add
+     * @returns A new Store instance with the extended schema
+     *
+     * @example
+     * ```ts
+     * // Extend the users collection
+     * export const dbUsers = baseUsersCollection.extend({
+     *   schema: {
+     *     firstName: schema.string(),
+     *     lastName: schema.string(),
+     *     companyId: schema.objectId().optional(),
+     *   },
+     *   indexes: [
+     *     { key: { companyId: 1 } },
+     *     { key: { lastName: 1, firstName: 1 } },
+     *   ],
+     *   methods: {
+     *     getFullName() {
+     *       return `${this.firstName} ${this.lastName}`;
+     *     }
+     *   }
+     * });
+     *
+     * // Now fully typed with new fields
+     * const user = await dbUsers.findOne({ firstName: 'John' });
+     * console.log(user?.getFullName());
+     * ```
+     */
+    extend<TExtendedSchema extends ModelSchema, TExtendedMethods extends Record<string, (this: WithId<InferDocumentType<TSchema & TExtendedSchema>> & any, ...args: any[]) => any> = Record<string, never>>(config: {
+        schema?: TExtendedSchema;
+        indexes?: IndexDescription[];
+        methods?: TExtendedMethods;
+        searchIndexes?: SearchIndexDescription[];
+    }): Store<TSchema & TExtendedSchema, PreserveMethodsForExtendedSchema<TMethods, TSchema & TExtendedSchema> & TExtendedMethods>;
+    /** @internal */
+    init(client: MongoClient): void;
+    /** @internal */
+    createIndexes(): Promise<void>;
+    private wrapDocument;
+    /**
+     * For convenience, to also allow directy passing a string or ObjectId as the selector
+     */
+    private getSelector;
+    /** @internal */
+    requireCollection(): Collection<this["_type"]>;
+    /** @internal */
+    requireClient(): MongoClient;
+    findOne(query: Filter<this['_type']>, options?: FindOptions): Promise<this["_doc"] | null>;
+    requireOne(query: Filter<this['_type']>, options?: FindOptions, errorHandler?: () => Error): Promise<this['_doc']>;
+    private find;
+    /**
+     * Fetches a single document by its ID
+     *
+     * @param id - The ID of the document to find
+     * @returns The document, or null if not found
+     */
+    findById(id: string | ObjectId): Promise<this['_doc'] | null>;
+    /**
+     * Fetches a single document by its ID, or throws an error if not found
+     *
+     * @param id - The ID of the document to find
+     * @param errorHandler - Optional error handler to return a custom error if the document is not found
+     * @returns The document
+     */
+    requireById(id: string | ObjectId, errorHandler?: () => Error): Promise<this['_doc']>;
+    /**
+     * Counts the number of documents that match a query
+     *
+     * @param query - The query to filter documents
+     * @returns The number of documents that match the query
+     */
+    countDocuments(query: Filter<this['_type']>): Promise<number>;
+    /**
+     * 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
+     * @returns The documents
+     */
+    fetch(query: Filter<this['_type']>, options?: {
+        sort?: Document;
+        limit?: number;
+        skip?: number;
+    }): Promise<this['_doc'][]>;
+    /**
+     * Inserts a single document
+     *
+     * @param document - The document to insert
+     * @returns The result of the insert operation
+     */
+    insertOne(document: OptionalUnlessRequiredId<InferDocumentType<TSchema>>): Promise<InsertOneResult>;
+    /**
+     * Inserts multiple documents
+     *
+     * @param documents - The documents to insert
+     * @returns The result of the insert operation
+     */
+    insertMany(documents: OptionalUnlessRequiredId<InferDocumentType<TSchema>>[]): Promise<InsertManyResult>;
+    /**
+     * Updates a single document
+     *
+     * @param selector - The selector to find the document to update
+     * @param update - The update to apply to the document
+     * @returns The result of the update operation
+     */
+    updateOne(selector: Filter<this['_type']> | string | ObjectId, update: UpdateFilter<this['_type']>): Promise<UpdateResult>;
+    /**
+     * Updates a single document, or inserts it if it doesn't exist
+     *
+     * @param selector - The selector to find the document to update
+     * @param update - The MongoDB modifier to apply to the document
+     * @returns The result of the update operation
+     */
+    upsertOne(selector: Filter<this['_type']> | string | ObjectId, update: UpdateFilter<this['_type']>): Promise<UpdateResult>;
+    /**
+     * Updates multiple documents
+     *
+     * @param selector - The selector to find the documents to update
+     * @param update - The MongoDB modifier to apply to the documents
+     * @returns The result of the update operation
+     */
+    updateMany(selector: Filter<this['_type']>, update: UpdateFilter<this['_type']>, options?: {
+        session?: ClientSession;
+    }): Promise<UpdateResult>;
+    /**
+     * Updates multiple documents, or inserts them if they don't exist
+     *
+     * @param selector - The selector to find the documents to update
+     * @param update - The MongoDB modifier to apply to the documents
+     * @returns The result of the update operation
+     */
+    upsertMany(selector: Filter<this['_type']>, update: UpdateFilter<this['_type']>): Promise<UpdateResult>;
+    /**
+     * Deletes a single document
+     *
+     * @param selector - The selector to find the document to delete
+     * @returns The result of the delete operation
+     */
+    deleteOne(selector: Filter<this['_type']>): Promise<DeleteResult>;
+    /**
+     * Deletes multiple documents
+     *
+     * @param selector - The selector to find the documents to delete
+     * @returns The result of the delete operation
+     */
+    deleteMany(selector: Filter<this['_type']>): Promise<DeleteResult>;
+    /**
+     * Aggregates documents using MongoDB's aggregation framework
+     *
+     * @param pipeline - The aggregation pipeline
+     * @param options - Optional options
+     * @returns The aggregation cursor
+     */
+    aggregate(pipeline: Document[], options?: AggregateOptions): AggregationCursor<Document>;
+    /**
+     * Performs a bulk write operation on the collection
+     *
+     * @param operations - The operations to perform
+     * @returns The result of the bulk write operation
+     */
+    bulkWrite(operations: AnyBulkWriteOperation<this['_type']>[]): Promise<BulkWriteResult>;
+    /**
+     * Returns the raw MongoDB database instance for advanced operations
+     * @returns The MongoDB database instance
+     * @throws Error if the store is not provisioned
+     */
+    getDatabase(): mongodb.Db;
+    /**
+     * Returns the raw MongoDB collection instance for advanced operations
+     * @returns The MongoDB collection instance
+     * @throws Error if the store is not provisioned
+     */
+    rawCollection(): Collection<this["_type"]>;
+    /**
+     * Renames an existing collection to this store's name, used for migrations
+     * @param oldName - The previous name of the collection
+     * @throws Error if the old collection doesn't exist or if this store's collection already exists
+     */
+    renameFrom(oldName: string, options?: {
+        session?: ClientSession;
+    }): Promise<void>;
+    /**
+     * Performs a vector similarity search using MongoDB Atlas Vector Search
+     *
+     * @param params - Vector search parameters
+     * @param params.field - The field name containing the vector embeddings
+     * @param params.embedding - The query vector to search for
+     * @param params.numCandidates - Number of nearest neighbors to consider (default: 100)
+     * @param params.limit - Maximum number of results to return (default: 10)
+     * @param params.projection - Additional fields to include in the results
+     * @param params.indexName - Name of index (default: field + VectorSearch)
+     * @returns An aggregation cursor with search results and scores
+     *
+     * @example
+     * ```ts
+     * const results = await store.vectorSearch({
+     *   field: 'embedding',
+     *   embedding: [0.1, 0.2, 0.3, ...],
+     *   numCandidates: 100,
+     *   limit: 10,
+     *   projection: { title: 1, description: 1 }
+     * });
+     * ```
+     */
+    vectorSearch({ field, embedding, numCandidates, limit, projection, indexName, }: {
+        field: string;
+        embedding: number[];
+        numCandidates?: number;
+        limit?: number;
+        projection?: Document;
+        indexName?: string;
+    }): Promise<AggregationCursor<Document>>;
+    /**
+     * Creates a MongoDB Atlas Vector Search index definition
+     *
+     * @param params - Vector index parameters
+     * @param params.field - The field name to create the vector index on
+     * @param params.dimensions - The number of dimensions in the vector embeddings
+     * @param params.similarity - The similarity metric to use (default: 'cosine')
+     * @param params.indexName - Name of index (default: field + VectorSearch)
+     * @returns A search index description object
+     *
+     * @example
+     * ```ts
+     * const store = new Store('documents', {
+     *   schema: {
+     *     title: schema.string(),
+     *     embedding: schema.array(schema.number()),
+     *   },
+     *   indexes: [],
+     *   searchIndexes: [
+     *     Store.vectorIndex({
+     *       field: 'embedding',
+     *       dimensions: 1536,
+     *       similarity: 'cosine'
+     *     })
+     *   ]
+     * });
+     * ```
+     */
+    static vectorIndex({ field, dimensions, similarity, indexName, }: {
+        field: string;
+        dimensions: number;
+        similarity?: 'cosine' | 'euclidean' | 'dotProduct';
+        indexName?: string;
+    }): {
+        type: string;
+        name: string;
+        definition: {
+            fields: {
+                type: string;
+                path: string;
+                numDimensions: number;
+                similarity: "cosine" | "euclidean" | "dotProduct";
+            }[];
+        };
+    };
+}
+
+type ObjectTypeDefinition = {
+    [key: string]: SchemaTypeDefinition;
+};
+type SingularSchemaTypeDefinition = z.ZodType | ObjectTypeDefinition;
+type SchemaTypeDefinition = SingularSchemaTypeDefinition | Array<SingularSchemaTypeDefinition>;
+type ModelSchema = {
+    [key: string]: SchemaTypeDefinition;
+};
+type InferDocumentType<T extends SchemaTypeDefinition> = {
+    [K in keyof T as T[K] extends z.ZodOptional<z.ZodTypeAny> ? K : never]?: T[K] extends z.ZodType ? z.infer<T[K]> : never;
+} & {
+    [K in keyof T as T[K] extends z.ZodOptional<z.ZodTypeAny> ? never : K]: T[K] extends z.ZodType ? z.infer<T[K]> : T[K] extends Array<infer ElementType extends SchemaTypeDefinition> ? Array<InferDocumentType<ElementType>> : T[K] extends ObjectTypeDefinition ? InferDocumentType<T[K]> : never;
+};
+declare const schema: {
+    readonly string: (params?: z.RawCreateParams & {
+        coerce?: true;
+    }) => z.ZodString;
+    readonly number: (params?: z.RawCreateParams & {
+        coerce?: boolean;
+    }) => ZodNumber;
+    readonly date: (params?: z.RawCreateParams & {
+        coerce?: boolean;
+    }) => z.ZodDate;
+    readonly boolean: (params?: z.RawCreateParams & {
+        coerce?: boolean;
+    }) => z.ZodBoolean;
+    readonly array: <El extends z.ZodTypeAny>(schema: El, params?: z.RawCreateParams) => ZodArray<El>;
+    readonly object: <Shape extends z.ZodRawShape>(shape: Shape, params?: z.RawCreateParams) => z.ZodObject<Shape, "strip", z.ZodTypeAny, z.objectOutputType<Shape, z.ZodTypeAny, "strip">, z.objectInputType<Shape, z.ZodTypeAny, "strip">>;
+    readonly enum: {
+        <U extends string, T extends Readonly<[U, ...U[]]>>(values: T, params?: z.RawCreateParams): z.ZodEnum<z.Writeable<T>>;
+        <U extends string, T extends [U, ...U[]]>(values: T, params?: z.RawCreateParams): z.ZodEnum<T>;
+    };
+    readonly embedding: () => ZodArray<ZodNumber>;
+    readonly objectId: () => z.ZodType<ObjectId>;
+    readonly userId: () => z.ZodType<ObjectId>;
+    readonly ref: <T extends ModelSchema>(_collection: string | Store<T, InferDocumentType<T>>) => z.ZodType<ObjectId>;
+    readonly union: <Options extends Readonly<[z.ZodTypeAny, z.ZodTypeAny, ...z.ZodTypeAny[]]>>(types: Options, params?: z.RawCreateParams) => z.ZodUnion<Options>;
+    readonly infer: <T extends SchemaTypeDefinition>(_schema: T) => InferDocumentType<T>;
+};
+declare namespace schema {
+    type infer<T extends SchemaTypeDefinition> = InferDocumentType<T>;
+}
+
+type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch' | 'options' | 'head' | 'all' | 'use';
+type RouteParams<T = unknown> = {
+    query: Record<string, string>;
+    body: T;
+    params: Record<string, string>;
+    headers: Record<string, string>;
+    cookies: Record<string, string>;
+    req: Request;
+    res: Response;
+    next: NextFunction;
+};
+type RouteResponse<T = unknown> = {
+    data?: T;
+    status?: number;
+    headers?: Record<string, string>;
+    redirect?: string;
+} | null;
+type RouteHandler<T = unknown> = (params: RouteParams, context: Pick<Context, 'session' | 'user'>) => Promise<RouteResponse<T>> | RouteResponse<T>;
+type RouteHandlers = {
+    [key in HttpMethod]?: RouteHandler;
+};
+type RouteDefinition = {
+    path: string;
+    handlers: RouteHandlers;
+    errorHandler?: RouteHandler;
+};
+type ExpressHandler = (req: Request, res: Response) => Promise<void> | void;
+
+export { type Args as A, type CronJobInputParams as C, type EmailProvider as E, type HttpMethod as H, type InferDocumentType as I, type MethodDefinition as M, type RouteDefinition as R, Store as S, type RateLimitRule as a, type ConnectionInfo as b, type RateLimitType as c, type EmailPayload as d, type RouteHandler as e, type RouteParams as f, type RouteResponse as g, type EmailAttachment as h, type ClientInfo as i, type Context as j, type Handler as k, type MethodType as l, type Method as m, type CronJob as n, type CronJobMetadata as o, type ModelSchema as p, type RouteHandlers as q, type ExpressHandler as r, schema as s };

package/dist/{types-CmI2APz9.d.ts → types-Ds1ESQSs.d.ts}

@@ -16,6 +16,7 @@ type AppConfig = {
 type ConfigSchema = {
     [key: string]: ConfigParams;
 };
+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;
@@ -27,6 +28,7 @@ type UserInfo = {
     requireRole: (role: string) => void;
 };
 type Role = string;
+type DefaultRoles = Record<'authenticated' | 'unauthenticated', Role | null>;
 type Session = {
     authToken: string;
     expiresAt: Date;
@@ -101,4 +103,4 @@ interface WebsocketClientProvider {
     }): void;
 }
 
-export { type AppConfig as A, type ConfigSchema as C, type Permission as P, type RoleDefinition as R, type Session as S, type UserInfo as U, type WebsocketServerProvider as W, type WebsocketClientProvider as a, type ConfigKey as b, ClientChannel as c, ServerChannel as d, type User as e, type Role as f };
+export { type AppConfig as A, type ConfigSchema as C, type DefaultRoles as D, 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 Session as d, type UserInfo as e, type Role as f, type ConfigType as g, type Configs as h };

package/dist/types.d.ts

@@ -1,29 +1,7 @@
 export { A as AppServer, E as ExpressMiddleware, M as ModelenceConfig } from './index-CwdohC5n.js';
+export { A as Args, i as ClientInfo, b as ConnectionInfo, j as Context, n as CronJob, C as CronJobInputParams, o as CronJobMetadata, h as EmailAttachment, d as EmailPayload, E as EmailProvider, r as ExpressHandler, k as Handler, H as HttpMethod, I as InferDocumentType, m as Method, M as MethodDefinition, l as MethodType, p as ModelSchema, a as RateLimitRule, c as RateLimitType, R as RouteDefinition, e as RouteHandler, q as RouteHandlers, f as RouteParams, g as RouteResponse, s as schema } from './types-D6nwUab6.js';
+export { A as AppConfig, b as ConfigKey, C as ConfigSchema, g as ConfigType, h as Configs, D as DefaultRoles, P as Permission, f as Role, R as RoleDefinition, d as Session, U as User, e as UserInfo, a as WebsocketClientProvider, W as WebsocketServerProvider } from './types-Ds1ESQSs.js';
 import 'express';
-
-type EmailAttachment = {
-    filename: string;
-    content: Buffer | string;
-    contentType: string;
-};
-type EmailPayload = {
-    from: string;
-    to: string | string[];
-    subject: string;
-    html?: string;
-    text?: string;
-    cc?: string | string[];
-    bcc?: string | string[];
-    replyTo?: string | string[];
-    headers?: Record<string, string>;
-    attachments?: EmailAttachment[];
-} & ({
-    html: string;
-} | {
-    text: string;
-});
-interface EmailProvider {
-    sendEmail(data: EmailPayload): Promise<void>;
-}
-
-export type { EmailAttachment, EmailPayload, EmailProvider };
+import 'mongodb';
+import 'zod';
+import 'http';

package/package.json

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

package/dist/chunk-EY7KRL57.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/config/server.ts","../src/app/loggerProcess.ts","../src/app/state.ts","../src/app/metrics.ts","../src/telemetry/index.ts"],"names":["configSchema","config","isInitialized","getConfig","key","getPublicConfigs","_","schema","loadConfigs","configs","type","value","setSchema","isPublic","buffer","sequenceId","startLoggerProcess","_elasticCloudId","_elasticApiKey","originalStdoutWrite","process","originalStderrWrite","chunk","args","addToBuffer","loopSendLogs","timestamp","i","current","sendLogs","stdoutLogs","stderrLogs","log","logInfo","logError","metadata","markAppStarted","setMetadata","_metadata","getEnvironmentId","getAppAlias","getEnvironmentAlias","getTelemetryServiceName","isTelemetryEnabled","apm","logger","initMetrics","initElasticApm","elasticApmEndpoint","elasticCloudId","elasticApiKey","appAlias","environmentAlias","environmentId","serviceName","elasticApm","esTransport","ElasticsearchTransport","error","winston","getApm","getLogger","getLogLevel","logDebug","message","startTransaction","name","context","transaction","result","endTime","captureError"],"mappings":"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","file":"chunk-EY7KRL57.js","sourcesContent":["import { AppConfig, ConfigKey, ConfigSchema } from './types';\n\nlet configSchema: ConfigSchema = {};\nlet config: Record<ConfigKey, AppConfig> = {};\nlet isInitialized = false;\n\n/**\n * @sidebarTitle getConfig (server)\n *\n * Retrieves a configuration value by key. Configuration values can be set via environment variables\n * or managed through the Modelence Cloud Backend.\n *\n * @param key - The configuration key to retrieve\n * @returns The configuration value (string, number, or boolean)\n *\n * @example\n * ```ts\n * import { getConfig } from 'modelence/server';\n *\n * // Get the site URL\n * const siteUrl = getConfig('_system.site.url');\n * ```\n *\n * Set via environment variable:\n * ```bash\n * MODELENCE_SITE_URL=https://myapp.com\n * ```\n *\n * @example\n * ```ts\n * import { getConfig } from 'modelence/server';\n *\n * // Get the current environment (e.g., 'development', 'staging', 'production')\n * const env = getConfig('_system.env');\n *\n * if (env === 'production') {\n *   // Enable production features\n * }\n * ```\n *\n * Set via environment variable:\n * ```bash\n * MODELENCE_SITE_ENV=production\n * ```\n */\nexport function getConfig(key: ConfigKey) {\n  return config[key]?.value;\n}\n\nexport function getPublicConfigs() {\n  if (!isInitialized) {\n    throw new Error(\n      'Config is not initialized: an attempt was made to access configs before they were loaded'\n    );\n  }\n\n  return Object.fromEntries(\n    Object.entries(configSchema)\n      .filter(([_, schema]) => schema.isPublic)\n      .map(([key, schema]) => {\n        return [\n          key,\n          {\n            key,\n            type: schema.type,\n            value: config[key]?.value ?? schema.default,\n          },\n        ];\n      })\n  );\n}\n\nexport function loadConfigs(configs: AppConfig[]) {\n  configs.forEach(({ key, type, value }) => {\n    const isSystemConfig = key.toLowerCase().startsWith('_system.');\n\n    if (!isSystemConfig && !configSchema[key]) {\n      // Ignore unknown configs\n      return;\n    }\n\n    config[key] = {\n      key,\n      type,\n      value,\n    };\n  });\n\n  isInitialized = true;\n}\n\nexport function setSchema(schema: ConfigSchema) {\n  // TODO: more validation on the schema structure\n  Object.entries(schema).forEach(([key, value]) => {\n    const { type, isPublic } = value;\n\n    if (type === 'secret' && isPublic) {\n      throw new Error(`Config ${key} with type \"secret\" cannot be public`);\n    }\n  });\n\n  configSchema = schema;\n}\n","// import { spawn } from 'child_process';\n// import { fileURLToPath } from 'url';\n// import { dirname, join } from 'path';\nimport { logInfo, logError } from '@/telemetry';\nimport process from 'process';\n\ntype LogEntry = { log: string; timestamp: Date | null; sequenceId?: number };\ntype LogBuffer = LogEntry[];\n\nconst buffer: { stdout: LogBuffer; stderr: LogBuffer } = {\n  stdout: [{ log: '', timestamp: null }],\n  stderr: [{ log: '', timestamp: null }],\n};\n\nlet sequenceId = 1;\n\nexport function startLoggerProcess({\n  elasticCloudId: _elasticCloudId,\n  elasticApiKey: _elasticApiKey,\n}: {\n  elasticCloudId: string;\n  elasticApiKey: string;\n}) {\n  const originalStdoutWrite = process.stdout.write;\n  const originalStderrWrite = process.stderr.write;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  process.stdout.write = function (chunk: string | Uint8Array, ...args: any[]) {\n    addToBuffer(chunk.toString(), buffer.stdout);\n    return originalStdoutWrite.call(process.stdout, chunk, ...args);\n  };\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  process.stderr.write = function (chunk: string | Uint8Array, ...args: any[]) {\n    addToBuffer(chunk.toString(), buffer.stderr);\n    return originalStderrWrite.call(process.stderr, chunk, ...args);\n  };\n\n  loopSendLogs();\n\n  // const currentFilePath = fileURLToPath(import.meta.url);\n  // const projectRoot = dirname(dirname(currentFilePath));\n  // const loggerPath = join(projectRoot, 'bin', 'modelence-logger', 'index.js');\n  // const logger = spawn(process.execPath, [loggerPath], {\n  //   env: {\n  //     NODE_ENV: process.env.NODE_ENV,\n  //     ELASTIC_CLOUD_ID: elasticCloudId,\n  //     ELASTIC_API_KEY: elasticApiKey\n  //   },\n  //   stdio: ['pipe', 'inherit', 'inherit'],\n  //   detached: true\n  // });\n\n  // const originalStdoutWrite = process.stdout.write;\n  // const originalStderrWrite = process.stderr.write;\n\n  // process.stdout.write = function(chunk: any, ...args: any[]) {\n  //   logger.stdin.write(chunk);\n  //   return originalStdoutWrite.apply(process.stdout, [chunk, ...args]);\n  // };\n\n  // process.stderr.write = function(chunk: any, ...args: any[]) {\n  //   logger.stdin.write(chunk);\n  //   return originalStderrWrite.apply(process.stderr, [chunk, ...args]);\n  // };\n\n  // process.on('exit', () => {\n  //   process.stdout.write = originalStdoutWrite;\n  //   process.stderr.write = originalStderrWrite;\n  // });\n\n  // logger.unref();\n}\n\nfunction addToBuffer(chunk: string, buffer: LogBuffer) {\n  if (chunk.length === 0) {\n    return;\n  }\n\n  const timestamp = new Date();\n\n  for (let i = 0; i < chunk.length; i++) {\n    const current = buffer[buffer.length - 1];\n    if (!current.timestamp) {\n      current.timestamp = timestamp;\n      current.sequenceId = sequenceId++;\n    }\n\n    if (chunk[i] === '\\n') {\n      buffer.push({ log: '', timestamp: null });\n    } else {\n      current.log += chunk[i];\n    }\n  }\n}\n\nasync function sendLogs() {\n  const stdoutLogs = buffer.stdout.slice(0, -1);\n  buffer.stdout = [buffer.stdout[buffer.stdout.length - 1]];\n\n  const stderrLogs = buffer.stderr.slice(0, -1);\n  buffer.stderr = [buffer.stderr[buffer.stderr.length - 1]];\n\n  stdoutLogs.forEach(({ log, timestamp, sequenceId }: LogEntry) => {\n    logInfo(log, { timestamp, source: 'console', sequenceId });\n  });\n  stderrLogs.forEach(({ log, timestamp, sequenceId }: LogEntry) => {\n    logError(log, { timestamp, source: 'console', sequenceId });\n  });\n}\n\nfunction loopSendLogs() {\n  setTimeout(() => {\n    sendLogs();\n    loopSendLogs();\n  }, 1000);\n}\n","type AppMetadata = {\n  environmentId: string;\n  appAlias: string;\n  environmentAlias: string;\n  telemetry: {\n    isEnabled: boolean;\n    serviceName: string;\n  };\n};\n\nlet appStarted = false;\nlet metadata: AppMetadata | null = null;\n\nexport function markAppStarted() {\n  appStarted = true;\n}\n\nexport function isAppStarted() {\n  return appStarted;\n}\n\nexport function setMetadata(_metadata: AppMetadata) {\n  metadata = Object.assign({}, metadata, _metadata);\n}\n\nexport function getEnvironmentId() {\n  return metadata?.environmentId;\n}\n\nexport function getAppAlias() {\n  return metadata?.appAlias;\n}\n\nexport function getEnvironmentAlias() {\n  return metadata?.environmentAlias;\n}\n\nexport function getTelemetryServiceName() {\n  return metadata?.telemetry?.serviceName;\n}\n\nexport function isTelemetryEnabled() {\n  return Boolean(metadata?.telemetry?.isEnabled);\n}\n","import elasticApm from 'elastic-apm-node';\nimport winston from 'winston';\nimport { ElasticsearchTransport } from 'winston-elasticsearch';\n\nimport { getConfig } from '../config/server';\nimport { startLoggerProcess } from './loggerProcess';\nimport {\n  getAppAlias,\n  getEnvironmentAlias,\n  getEnvironmentId,\n  getTelemetryServiceName,\n  isTelemetryEnabled,\n} from './state';\n\nlet isInitialized = false;\nlet apm: typeof elasticApm | null = null;\nlet logger: winston.Logger | null = null;\n\nexport const initMetrics = async () => {\n  if (isInitialized) {\n    throw new Error('Metrics are already initialized, duplicate \"initMetrics\" call received');\n  }\n\n  isInitialized = true;\n\n  if (isTelemetryEnabled()) {\n    await initElasticApm();\n  }\n};\n\nasync function initElasticApm() {\n  const elasticApmEndpoint = getConfig('_system.elastic.apmEndpoint') as string;\n  const elasticCloudId = getConfig('_system.elastic.cloudId') as string;\n  const elasticApiKey = getConfig('_system.elastic.apiKey') as string;\n\n  const appAlias = getAppAlias() ?? 'unknown';\n  const environmentAlias = getEnvironmentAlias() ?? 'unknown';\n  const environmentId = getEnvironmentId() ?? 'unknown';\n  const serviceName = getTelemetryServiceName();\n\n  apm = elasticApm.start({\n    serviceName,\n    apiKey: elasticApiKey,\n    serverUrl: elasticApmEndpoint,\n    // environment: 'dev',\n    transactionSampleRate: 1.0,\n    centralConfig: false,\n    globalLabels: {\n      modelenceEnv: 'dev',\n      appEnv: 'dev',\n      environmentId,\n      appAlias,\n      environmentAlias,\n    },\n    // logLevel: 'debug'\n  });\n\n  const esTransport = new ElasticsearchTransport({\n    apm,\n    level: 'debug',\n    clientOpts: {\n      cloud: {\n        id: elasticCloudId,\n      },\n      auth: {\n        apiKey: elasticApiKey,\n      },\n      requestTimeout: 10000,\n      tls: {\n        rejectUnauthorized: false,\n      },\n    },\n    bufferLimit: 1000,\n    silent: false,\n  });\n\n  esTransport.on('error', (error) => {\n    console.error('Elasticsearch Transport Error:', error);\n  });\n\n  logger = winston.createLogger({\n    level: 'debug',\n    defaultMeta: {\n      serviceName,\n    },\n    format: winston.format.combine(winston.format.json()),\n    transports: [\n      // new winston.transports.Console(), // TODO: remove, just for debugging\n      esTransport,\n    ],\n  });\n\n  startLoggerProcess({\n    elasticCloudId,\n    elasticApiKey,\n  });\n}\n\nexport function getApm() {\n  if (!apm) {\n    throw new Error('APM is not initialized');\n  }\n  return apm;\n}\n\nexport function getLogger() {\n  if (!logger) {\n    throw new Error('Logger is not initialized');\n  }\n  return logger;\n}\n","import { getLogger, getApm } from '@/app/metrics';\nimport { isTelemetryEnabled } from '@/app/state';\nimport { getConfig } from '@/config/server';\n\nfunction getLogLevel() {\n  return getConfig('_system.log.level') as 'debug' | 'info' | 'error';\n}\n\nexport function logDebug(message: string, args: object) {\n  if (getLogLevel() === 'debug') {\n    if (isTelemetryEnabled()) {\n      getLogger().debug(message, args);\n    } else {\n      console.debug(message, args);\n    }\n  }\n}\n\nexport function logInfo(message: string, args: object) {\n  if (['debug', 'info'].includes(getLogLevel())) {\n    if (isTelemetryEnabled()) {\n      getLogger().info(message, args);\n    } else {\n      console.info(message, args);\n    }\n  }\n}\n\nexport function logError(message: string, args: object) {\n  if (isTelemetryEnabled()) {\n    getLogger().error(message, args);\n  } else {\n    console.error(message, args);\n  }\n}\n\ninterface WrappedTransaction {\n  end(result?: string, context?: Record<string, unknown>): void;\n  setContext(context: Record<string, unknown>): void;\n}\n\nexport function startTransaction(\n  type: 'method' | 'cron' | 'ai' | 'custom' | 'route',\n  name: string,\n  context?: Record<string, unknown>\n): WrappedTransaction {\n  if (!isTelemetryEnabled()) {\n    return {\n      end: () => {\n        // do nothing\n      },\n      setContext: () => {\n        // do nothing\n      },\n    };\n  }\n\n  const apm = getApm();\n  const transaction = apm.startTransaction(name, type);\n  if (context) {\n    apm.setCustomContext(context);\n  }\n\n  return {\n    end: (\n      result?: string,\n      { endTime, context }: { endTime?: number; context?: Record<string, unknown> } = {}\n    ) => {\n      if (context) {\n        apm.setCustomContext(context);\n      }\n      transaction.end(result, endTime);\n    },\n    setContext: (context: Record<string, unknown>) => {\n      apm.setCustomContext(context);\n    },\n  };\n}\n\nexport function captureError(error: Error) {\n  if (!isTelemetryEnabled()) {\n    console.error(error);\n    return;\n  }\n\n  getApm().captureError(error);\n}\n"]}