@mrxsys/mrx-core 2.8.0 → 2.9.0

package/dist/modules/logger/{strategies → sinks}/index.js

@@ -1,6 +1,6 @@
 // @bun
-// source/modules/logger/strategies/consoleLogger.ts
-class ConsoleLoggerStrategy {
+// source/modules/logger/sinks/console-logger.ts
+class ConsoleLoggerSink {
   _colorize;
   constructor(colorize = false) {
     this._colorize = colorize;
@@ -22,10 +22,10 @@ class ConsoleLoggerStrategy {
     console[level.toLowerCase()](message);
   }
 }
-// source/modules/logger/strategies/fileLogger.ts
+// source/modules/logger/sinks/file-logger.ts
 import { appendFile } from "fs/promises";
 
-class FileLoggerStrategy {
+class FileLoggerSink {
   _path;
   constructor(path) {
     this._path = path;
@@ -39,6 +39,6 @@ class FileLoggerStrategy {
   }
 }
 export {
-  FileLoggerStrategy,
-  ConsoleLoggerStrategy
+  FileLoggerSink,
+  ConsoleLoggerSink
 };

package/dist/modules/logger/types/bodies-intersection.d.ts

@@ -0,0 +1,2 @@
+import type { SinkBody } from './sink-body';
+export type BodiesIntersection<TSinks, K extends keyof TSinks> = (K extends unknown ? (object: SinkBody<TSinks, K>) => void : never) extends (object: infer I) => void ? I : never;

package/dist/modules/logger/types/index.d.ts

@@ -1,6 +1,6 @@
-export type { BodiesIntersection } from './bodiesIntersection.ts';
-export type { LoggerStrategy } from './loggerStrategy.ts';
-export type { LogLevels } from './logLevels.ts';
-export type { LogStreamChunk } from './logStreamChunk.ts';
-export type { StrategyBody } from './strategyBody.ts';
-export type { StrategyMap } from './strategyMap.ts';
+export type { BodiesIntersection } from './bodies-intersection.ts';
+export type { LogLevels } from './log-levels.ts';
+export type { LogStreamChunk } from './log-stream-chunk.ts';
+export type { LoggerSink } from './logger-sink.ts';
+export type { SinkBody } from './sink-body.ts';
+export type { SinkMap } from './sink-map.ts';

package/dist/modules/logger/types/log-stream-chunk.d.ts

@@ -0,0 +1,15 @@
+import type { LogLevels } from './log-levels';
+import type { SinkMap } from './sink-map';
+/**
+ * Internal log stream object for the queue.
+ */
+export interface LogStreamChunk<TLogObject, TSinks extends SinkMap> {
+    /** ISO date string of the log event. */
+    date: string;
+    /** Log level. */
+    level: LogLevels;
+    /** The object to log. */
+    object: TLogObject;
+    /** Names of sinks to use. */
+    sinksNames: (keyof TSinks)[];
+}

package/dist/modules/logger/types/{loggerStrategy.d.ts → logger-sink.d.ts}

@@ -1,7 +1,7 @@
-import type { LogLevels } from './logLevels';
-export interface LoggerStrategy<TLogObject = unknown> {
+import type { LogLevels } from './log-levels';
+export interface LoggerSink<TLogObject = unknown> {
     /**
-     * Logs a message with the strategy's implementation.
+     * Logs a message with the sink's implementation.
      *
      * @param level - The log level at which the message should be logged.
      * @param date - The date at which the message was logged.

package/dist/modules/logger/types/sink-body.d.ts

@@ -0,0 +1,2 @@
+import type { LoggerSink } from './logger-sink';
+export type SinkBody<TSink, Key extends keyof TSink> = TSink[Key] extends LoggerSink<infer TBody> ? TBody : never;

package/dist/modules/logger/types/sink-map.d.ts

@@ -0,0 +1,2 @@
+import type { LoggerSink } from './logger-sink';
+export type SinkMap = Record<string, LoggerSink>;

package/dist/modules/mailer/enums/index.d.ts

@@ -1 +1 @@
-export { MAILER_ERROR_KEYS } from './mailerErrorKeys';
+export { MAILER_ERROR_KEYS } from './mailer-error-keys';

package/dist/modules/mailer/enums/index.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   MAILER_ERROR_KEYS
-} from "../../../chunk-45gt9273.js";
+} from "../../../chunk-5pwb7peq.js";
 export {
   MAILER_ERROR_KEYS
 };

package/dist/modules/mailer/index.js

@@ -1,10 +1,10 @@
 // @bun
 import {
   MAILER_ERROR_KEYS
-} from "../../chunk-45gt9273.js";
+} from "../../chunk-5pwb7peq.js";
 import {
   BaseError
-} from "../../chunk-vknq69e0.js";
+} from "../../chunk-9cgzhc50.js";
 
 // source/modules/mailer/smtp.ts
 import { createTransport } from "nodemailer";
@@ -20,7 +20,7 @@ class SMTP {
   }
   async connect() {
     if (this._transporter)
-      throw new BaseError({ message: MAILER_ERROR_KEYS.SMTP_ALREADY_CONNECTED });
+      throw new BaseError(MAILER_ERROR_KEYS.SMTP_ALREADY_CONNECTED);
     this._transporter = createTransport({
       host: this._config.host,
       port: this._config.port,
@@ -35,10 +35,7 @@ class SMTP {
     try {
       await this._transporter.verify();
     } catch (error) {
-      throw new BaseError({
-        message: MAILER_ERROR_KEYS.SMTP_CONNECTION_ERROR,
-        cause: error
-      });
+      throw new BaseError(MAILER_ERROR_KEYS.SMTP_CONNECTION_ERROR, error);
     }
   }
   disconnect() {
@@ -49,7 +46,7 @@ class SMTP {
   }
   async sendMail(options) {
     if (!this._transporter)
-      throw new BaseError({ message: MAILER_ERROR_KEYS.SMTP_NOT_CONNECTED });
+      throw new BaseError(MAILER_ERROR_KEYS.SMTP_NOT_CONNECTED);
     return this._transporter.sendMail(options);
   }
 }

package/dist/modules/mailer/smtp.d.ts

@@ -1,5 +1,5 @@
 import { type SendMailOptions } from 'nodemailer';
-import type { SMTPOptions } from './types/smtpOptions';
+import type { SMTPOptions } from './types/smtp-options';
 /**
  * The `SMTP` class manages the connection and operations with an SMTP server.
  *

package/dist/modules/mailer/types/index.d.ts

@@ -1,3 +1,3 @@
-export type { SMTPCredentials } from './smtpCredentials';
-export type { SMTPOptions } from './smtpOptions';
-export type { SMTPPoolOptions } from './smtpPoolOptions';
+export type { SMTPCredentials } from './smtp-credentials';
+export type { SMTPOptions } from './smtp-options';
+export type { SMTPPoolOptions } from './smtp-pool-options';

package/dist/modules/mailer/types/{smtpOptions.d.ts → smtp-options.d.ts}

@@ -1,5 +1,5 @@
-import type { SMTPCredentials } from './smtpCredentials';
-import type { SMTPPoolOptions } from './smtpPoolOptions';
+import type { SMTPCredentials } from './smtp-credentials';
+import type { SMTPPoolOptions } from './smtp-pool-options';
 export interface SMTPOptions {
     /**
      * The hostname or IP address of the SMTP server.

package/dist/modules/repository/index.js

@@ -1,12 +1,12 @@
 // @bun
 import {
   Repository
-} from "../../chunk-syhskygx.js";
-import"../../chunk-5qtpggzv.js";
-import"../../chunk-zaje5tv4.js";
-import"../../chunk-683sda6e.js";
-import"../../chunk-9nw6qekv.js";
-import"../../chunk-vknq69e0.js";
+} from "../../chunk-6g29g0tk.js";
+import"../../chunk-grfyngq0.js";
+import"../../chunk-c9vjf06h.js";
+import"../../chunk-00s6t4tw.js";
+import"../../chunk-h9t48r9q.js";
+import"../../chunk-9cgzhc50.js";
 export {
   Repository
 };

package/dist/modules/repository/repository.d.ts

@@ -1,11 +1,11 @@
 import type { Knex } from 'knex';
 import type { Table } from '../../modules/database/table';
-import type { StreamWithAsyncIterable } from '../../utils/types/streamWithAsyncIterable';
+import type { StreamWithAsyncIterable } from '../../shared/types/stream-with-async-iterable';
 import type { Filter } from './types/filter';
-import type { OrderByItem } from './types/orderByItem';
-import type { QueryOptions } from './types/queryOptions';
-import type { QueryOptionsExtendPagination } from './types/queryOptionsExtendPagination';
-import type { QueryOptionsExtendStream } from './types/queryOptionsExtendStream';
+import type { OrderByItem } from './types/order-by-item';
+import type { QueryOptions } from './types/query-options';
+import type { QueryOptionsExtendPagination } from './types/query-options-extend-pagination';
+import type { QueryOptionsExtendStream } from './types/query-options-extend-stream';
 /**
  * Repository allowing interaction with a database table using Knex.js fully typed.
  *

package/dist/modules/repository/types/filter.d.ts

@@ -1,5 +1,5 @@
-import type { AdaptiveWhereClause } from './adaptiveWhereClause';
-import type { SelectedFields } from './selectedFields';
+import type { AdaptiveWhereClause } from './adaptive-where-clause';
+import type { SelectedFields } from './selected-fields';
 /**
  * Defines an filter model using either plain partials of the model TModel or a {@link AdaptiveWhereClause} filter for more dynamic querying.
  *

package/dist/modules/repository/types/index.d.ts

@@ -1,8 +1,8 @@
-export type { AdaptiveWhereClause } from './adaptiveWhereClause';
+export type { AdaptiveWhereClause } from './adaptive-where-clause';
 export type { Filter } from './filter';
-export type { OrderByItem } from './orderByItem';
-export type { QueryOptions } from './queryOptions';
-export type { QueryOptionsExtendPagination } from './queryOptionsExtendPagination';
-export type { QueryOptionsExtendStream } from './queryOptionsExtendStream';
-export type { SelectedFields } from './selectedFields';
+export type { OrderByItem } from './order-by-item';
+export type { QueryOptions } from './query-options';
+export type { QueryOptionsExtendPagination } from './query-options-extend-pagination';
+export type { QueryOptionsExtendStream } from './query-options-extend-stream';
+export type { SelectedFields } from './selected-fields';
 export type { Transaction } from './transaction';

package/dist/modules/repository/types/{queryOptionsExtendPagination.d.ts → query-options-extend-pagination.d.ts}

@@ -1,4 +1,4 @@
-import type { QueryOptions } from './queryOptions';
+import type { QueryOptions } from './query-options';
 /**
  * Extends {@link QueryOptions} to add pagination capabilities for queries.
  *

package/dist/modules/repository/types/{queryOptionsExtendStream.d.ts → query-options-extend-stream.d.ts}

@@ -1,4 +1,4 @@
-import type { QueryOptions } from './queryOptions';
+import type { QueryOptions } from './query-options';
 /**
  * Interface Option query with stream option inherited from {@link QueryOptions}
  *

package/dist/modules/repository/types/{queryOptions.d.ts → query-options.d.ts}

@@ -1,7 +1,7 @@
-import type { HTTP_ERROR_STATUS_CODES } from '../../../errors/enums/httpErrorStatusCodes';
+import type { HTTP_ERROR_STATUS_CODES } from '../../../errors/enums/http-status-codes';
 import type { Filter } from './filter';
-import type { OrderByItem } from './orderByItem';
-import type { SelectedFields } from './selectedFields';
+import type { OrderByItem } from './order-by-item';
+import type { SelectedFields } from './selected-fields';
 import type { Transaction } from './transaction';
 /**
  * This interface defines the basic options for a repository query.
@@ -31,7 +31,7 @@ export interface QueryOptions<TModel> {
      */
     readonly throwIfNoResult?: boolean | {
         message?: string;
-        code?: keyof typeof HTTP_ERROR_STATUS_CODES | typeof HTTP_ERROR_STATUS_CODES[keyof typeof HTTP_ERROR_STATUS_CODES];
+        httpStatusCode?: keyof typeof HTTP_ERROR_STATUS_CODES | typeof HTTP_ERROR_STATUS_CODES[keyof typeof HTTP_ERROR_STATUS_CODES];
     };
     /**
      * The transaction context for the query. ({@link Transaction})

package/dist/modules/singleton-manager/enums/index.d.ts

@@ -0,0 +1 @@
+export { SINGLETON_MANAGER_ERROR_KEYS } from './singleton-manager-error-keys';

package/dist/modules/{singletonManager → singleton-manager}/enums/index.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   SINGLETON_MANAGER_ERROR_KEYS
-} from "../../../chunk-hcc6g1fd.js";
+} from "../../../chunk-b6f6ez2w.js";
 export {
   SINGLETON_MANAGER_ERROR_KEYS
 };

package/dist/modules/singleton-manager/enums/singleton-manager-error-keys.d.ts

@@ -0,0 +1,4 @@
+export declare const SINGLETON_MANAGER_ERROR_KEYS: {
+    readonly CLASS_INSTANCE_ALREADY_REGISTERED: "singletonManager.error.class_instance_already_registered";
+    readonly CLASS_INSTANCE_NOT_REGISTERED: "singletonManager.error.class_instance_not_registered";
+};

package/dist/modules/singleton-manager/index.d.ts

@@ -0,0 +1 @@
+export { SingletonManager } from './singleton-manager';

package/dist/modules/singleton-manager/index.js

@@ -0,0 +1,9 @@
+// @bun
+import {
+  SingletonManager
+} from "../../chunk-ngrxhdkb.js";
+import"../../chunk-b6f6ez2w.js";
+import"../../chunk-9cgzhc50.js";
+export {
+  SingletonManager
+};

package/dist/modules/{singletonManager/singletonManager.d.ts → singleton-manager/singleton-manager.d.ts}

@@ -1,6 +1,6 @@
 /**
 * SingletonManager is a static class that manages the singletons in the application.
-* When a class is registered, the SingletonManager creates a new instance of the class when it is requested.
+* When a class instance is registered, the SingletonManager stores it and returns the same instance when requested.
 *
 * @example
 * ```ts
@@ -19,9 +19,9 @@
 *    }
 * }
 *
-* SingletonManager.register('ExampleSingleton', ExampleSingleton);
+* SingletonManager.register('ExampleSingleton', new ExampleSingleton());
 *
-* SingletonManager.get<ExampleSingleton>('ExampleSingleton').sayHello(); // Output: ExampleSingleton created with ID: 1 /n Hello from instance 1!
+* SingletonManager.get<ExampleSingleton>('ExampleSingleton').sayHello(); // Output: Hello from instance 1!
 * SingletonManager.get<ExampleSingleton>('ExampleSingleton').sayHello(); // Output: Hello from instance 1!
 * ```
 */
@@ -32,24 +32,22 @@ export declare class SingletonManager {
     */
     private static readonly _registry;
     /**
-    * Registers a class constructor in the SingletonManager.
+    * Registers a class instance in the SingletonManager.
     *
-    * @template TClass - The type of the class.
-    * @template TArgs - The tuple type of the constructor arguments.
+    * @template TClass - The type of the class instance.
     *
     * @param name - The name of the class.
-    * @param constructor - The constructor of the class.
-    * @param args - The arguments to pass to the constructor of the class.
+    * @param instance - The instance of the class to register as singleton.
     *
-    * @throws ({@link BaseError}) - If the class constructor is already registered, it throws an error.
+    * @throws ({@link BaseError}) If the name is already registered, it throws an error.
     */
-    static register<TClass extends object, TArgs extends unknown[]>(name: string, constructor: new (...args: TArgs) => TClass, ...args: TArgs): void;
+    static register<TClass extends object>(name: string, instance: TClass): void;
     /**
     * Unregisters a class from the SingletonManager.
     *
     * @param name - The name of the class to unregister.
     *
-    * @throws ({@link BaseError}) If the class constructor is not registered, it throws an error.
+    * @throws ({@link BaseError}) If the name is not registered, it throws an error.
     */
     static unregister(name: string): void;
     /**

package/dist/modules/totp/enums/index.d.ts

@@ -1 +1 @@
-export { TOTP_ERROR_KEYS } from './totpErrorKeys';
+export { TOTP_ERROR_KEYS } from './totp-error-keys';

package/dist/modules/totp/enums/index.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   TOTP_ERROR_KEYS
-} from "../../../chunk-snqdnkk7.js";
+} from "../../../chunk-z9a175mk.js";
 export {
   TOTP_ERROR_KEYS
 };

package/dist/modules/totp/hotp.d.ts

@@ -1,4 +1,4 @@
-import type { TotpOptions } from './types/totpOptions';
+import type { TotpOptions } from './types/totp-options';
 /**
  * HMAC-based One-Time Password (HOTP) implementation
  *

package/dist/modules/totp/index.d.ts

@@ -1,3 +1,3 @@
 export { hotp } from './hotp';
-export { buildOtpAuthUri, parseOtpAuthUri } from './otpAuthUri';
+export { buildOtpAuthUri, parseOtpAuthUri } from './otp-auth-uri';
 export { totp, verifyTotp } from './totp';

package/dist/modules/totp/index.js

@@ -3,13 +3,13 @@ import {
   createCounterBuffer,
   dynamicTruncation,
   generateHmac
-} from "../../chunk-4mt568fz.js";
+} from "../../chunk-m3grz32t.js";
 import {
   TOTP_ERROR_KEYS
-} from "../../chunk-snqdnkk7.js";
+} from "../../chunk-z9a175mk.js";
 import {
   BaseError
-} from "../../chunk-vknq69e0.js";
+} from "../../chunk-9cgzhc50.js";
 
 // source/modules/totp/hotp.ts
 import { webcrypto } from "crypto";
@@ -22,7 +22,7 @@ var hotp = async (secret, counter, {
   const hmacArray = await generateHmac(key, counterBuffer);
   return dynamicTruncation(hmacArray, digits);
 };
-// source/modules/totp/otpAuthUri.ts
+// source/modules/totp/otp-auth-uri.ts
 var buildOtpAuthUri = ({
   secretBase32,
   label,
@@ -47,19 +47,13 @@ var buildOtpAuthUri = ({
 var parseOtpAuthUri = (uri) => {
   const url = new URL(uri);
   if (url.protocol !== "otpauth:")
-    throw new BaseError({
-      message: TOTP_ERROR_KEYS.INVALID_OTP_AUTH_URI
-    });
+    throw new BaseError(TOTP_ERROR_KEYS.INVALID_OTP_AUTH_URI);
   if (url.hostname !== "totp")
-    throw new BaseError({
-      message: TOTP_ERROR_KEYS.INVALID_OTP_AUTH_URI
-    });
+    throw new BaseError(TOTP_ERROR_KEYS.INVALID_OTP_AUTH_URI);
   const label = decodeURIComponent(url.pathname.slice(1));
   const secretBase32 = url.searchParams.get("secret");
   if (!secretBase32)
-    throw new BaseError({
-      message: TOTP_ERROR_KEYS.MISSING_SECRET
-    });
+    throw new BaseError(TOTP_ERROR_KEYS.MISSING_SECRET);
   const issuerParam = url.searchParams.get("issuer");
   const issuer = issuerParam ? decodeURIComponent(issuerParam) : undefined;
   const algorithm = url.searchParams.get("algorithm") || "SHA-1";

package/dist/modules/totp/{otpAuthUri.d.ts → otp-auth-uri.d.ts}

@@ -1,4 +1,4 @@
-import type { OtpAuthUri } from './types/otpAuthUri';
+import type { OtpAuthUri } from './types/otp-auth-uri';
 /**
  * Build an OTPAuth URI for QR code generation
  *

package/dist/modules/totp/totp.d.ts

@@ -1,5 +1,5 @@
-import type { TotpOptions } from './types/totpOptions';
-import type { VerifyOptions } from './types/verifyOptions';
+import type { TotpOptions } from './types/totp-options';
+import type { VerifyOptions } from './types/verify-options';
 /**
  * Time-based One-Time Password (TOTP) implementation
  *

package/dist/modules/totp/types/index.d.ts

@@ -1,3 +1,3 @@
-export type { OtpAuthUri } from './otpAuthUri';
-export type { TotpOptions } from './totpOptions';
-export type { VerifyOptions } from './verifyOptions';
+export type { OtpAuthUri } from './otp-auth-uri';
+export type { TotpOptions } from './totp-options';
+export type { VerifyOptions } from './verify-options';

package/dist/modules/totp/types/{verifyOptions.d.ts → verify-options.d.ts}

@@ -1,4 +1,4 @@
-import type { TotpOptions } from './totpOptions';
+import type { TotpOptions } from './totp-options';
 /**
  * Options for TOTP verification
  */

package/dist/modules/totp/utils/index.d.ts

@@ -1,6 +1,6 @@
 export { base32Decode, base32Encode } from './base32';
-export { createCounterBuffer } from './createCounterBuffer';
-export { dynamicTruncation } from './dynamicTruncation';
-export { generateHmac } from './generateHmac';
-export { generateSecretBytes } from './generateSecretBytes';
-export { timeRemaining } from './timeRemaining';
+export { createCounterBuffer } from './create-counter-buffer';
+export { dynamicTruncation } from './dynamic-truncation';
+export { generateHmac } from './generate-hmac';
+export { generateSecretBytes } from './generate-secret-bytes';
+export { timeRemaining } from './time-remaining';

package/dist/modules/totp/utils/index.js

@@ -3,13 +3,13 @@ import {
   createCounterBuffer,
   dynamicTruncation,
   generateHmac
-} from "../../../chunk-4mt568fz.js";
+} from "../../../chunk-m3grz32t.js";
 import {
   TOTP_ERROR_KEYS
-} from "../../../chunk-snqdnkk7.js";
+} from "../../../chunk-z9a175mk.js";
 import {
   BaseError
-} from "../../../chunk-vknq69e0.js";
+} from "../../../chunk-9cgzhc50.js";
 
 // source/modules/totp/utils/base32.ts
 var BASE32_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
@@ -43,10 +43,7 @@ var base32Decode = (base32) => {
   for (const char of cleanBase32) {
     const charValue = BASE32_ALPHABET.indexOf(char);
     if (charValue === -1)
-      throw new BaseError({
-        message: TOTP_ERROR_KEYS.INVALID_BASE32_CHARACTER,
-        cause: `Invalid Base32 character: ${char}`
-      });
+      throw new BaseError(TOTP_ERROR_KEYS.INVALID_BASE32_CHARACTER, `Invalid Base32 character: ${char}`);
     value = value << 5 | charValue;
     bits += 5;
     if (bits >= 8) {
@@ -56,16 +53,14 @@ var base32Decode = (base32) => {
   }
   return new Uint8Array(result);
 };
-// source/modules/totp/utils/generateSecretBytes.ts
+// source/modules/totp/utils/generate-secret-bytes.ts
 import { getRandomValues } from "crypto";
 var generateSecretBytes = (length = 20) => {
   if (length <= 0)
-    throw new BaseError({
-      message: TOTP_ERROR_KEYS.INVALID_SECRET_LENGTH
-    });
+    throw new BaseError(TOTP_ERROR_KEYS.INVALID_SECRET_LENGTH);
   return getRandomValues(new Uint8Array(length));
 };
-// source/modules/totp/utils/timeRemaining.ts
+// source/modules/totp/utils/time-remaining.ts
 var timeRemaining = (period = 30, now = Date.now()) => {
   const elapsed = Math.floor(now / 1000) % period;
   return period - elapsed;

package/dist/modules/typed-event-emitter/index.d.ts

@@ -0,0 +1 @@
+export { TypedEventEmitter } from './typed-event-emitter';

package/dist/modules/{typedEventEmitter → typed-event-emitter}/index.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   TypedEventEmitter
-} from "../../chunk-yvyahr2h.js";
+} from "../../chunk-mvrxngm7.js";
 export {
   TypedEventEmitter
 };