codeweaver 3.0.6 → 3.0.8

package/README.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-**Codeweaver** is an unopinionated microframework built with `Express`, `TypeScript`, and `Zod` (v4), seamlessly integrated with `Swagger` for comprehensive API documentation. Its modular architecture for routers promotes scalability and organized development, making it easy to expand and maintain. Routers are automatically discovered and wired up through a conventional folder structure, simplifying project organization and reducing boilerplate. Routers can be nested, allowing you to compose complex route trees by placing sub-routers inside parent router folders. It also uses `utils-decorators`, a collection of middleware utilities (throttling, caching, and error handling) designed to strengthen application resilience.
+**Codeweaver** is an microframework built with `Express`, `TypeScript`, and `Zod` (v4), seamlessly integrated with `Swagger` for comprehensive API documentation. Its modular architecture for routers promotes scalability and organized development, making it easy to expand and maintain. Routers are automatically discovered and wired up through a conventional folder structure, simplifying project organization and reducing boilerplate. Routers can be nested, allowing you to compose complex route trees by placing sub-routers inside parent router folders. It also uses `utils-decorators`, a collection of middleware utilities (throttling, caching, and error handling) designed to strengthen application resilience.
 
 ## Features and Technologies Used
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeweaver",
-  "version": "3.0.6",
+  "version": "3.0.8",
   "main": "src/main.ts",
   "bin": {
     "codeweaver": "command.js"

package/src/config.ts

@@ -10,6 +10,7 @@ import {
 } from "./constants";
 import { SwaggerOptions } from "./swagger-options";
 import { stringToBoolean } from "./utilities/conversion";
+import { logger } from "./utilities/logger/logger.config";
 
 /**
  * Main application configuration
@@ -31,7 +32,7 @@ interface Config {
   cacheSize: number;
 }
 
-let config: Config = {
+export const config: Config = {
   devMode: process.env.NODE_ENV !== productionEnvironment,
   http: process.env.HTTP || http,
   port: Number(process.env.PORT) || port,
@@ -66,4 +67,4 @@ let config: Config = {
   cacheSize: Number(process.env.CACHE_SIZE) || cacheSize,
 };
 
-export default config;
+export const container = { logger };

package/src/main.ts

@@ -1,7 +1,7 @@
 import express, { NextFunction, Request, Response } from "express";
 import fs from "fs";
 import path from "path";
-import config from "./config";
+import { config } from "./config";
 import { ResponseError } from "./utilities/error-handling";
 import { resolve } from "./utilities/container";
 import { WinstonLoggerService } from "./utilities/logger/winston-logger.service";

package/src/routers/orders/order.controller.ts

@@ -2,7 +2,7 @@ import { memoizeAsync, onError, rateLimit, timeout } from "utils-decorators";
 import { OrderDto, OrderCreationDto, ZodOrderDto } from "./dto/order.dto";
 import { ResponseError } from "@/utilities/error-handling";
 import { convert, stringToInteger } from "@/utilities/conversion";
-import config from "@/config";
+import { config } from "@/config";
 import { orders } from "@/db";
 import { Order, ZodOrder } from "@/entities/order.entity";
 import { MapAsyncCache } from "@/utilities/cache/memory-cache";

package/src/routers/products/product.controller.ts

@@ -7,7 +7,7 @@ import {
 } from "./dto/product.dto";
 import { MapAsyncCache } from "@/utilities/cache/memory-cache";
 import { convert, stringToInteger } from "@/utilities/conversion";
-import config from "@/config";
+import { config } from "@/config";
 import { ResponseError } from "@/utilities/error-handling";
 import { products } from "@/db";
 import { Product, ZodProduct } from "@/entities/product.entity";

package/src/routers/users/user.controller.ts

@@ -2,7 +2,7 @@ import { UserCreationDto, UserDto, ZodUserDto } from "./dto/user.dto";
 import { memoizeAsync, onError, rateLimit, timeout } from "utils-decorators";
 import { ResponseError } from "@/utilities/error-handling";
 import { convert, stringToInteger } from "@/utilities/conversion";
-import config from "@/config";
+import { config } from "@/config";
 import { users } from "@/db";
 import { User, ZodUser } from "@/entities/user.entity";
 import { MapAsyncCache } from "@/utilities/cache/memory-cache";

package/src/utilities/conversion.ts

@@ -11,18 +11,18 @@ function parseIntegerStrict(input: string): number {
 
   // Empty or just sign is invalid
   if (s.length === 0 || s === "+" || s === "-") {
-    throw new Error("Invalid integer");
+    throw new TypeError("Invalid integer");
   }
 
   // Use a regex to ensure the entire string is an optional sign followed by digits
   if (!/^[+-]?\d+$/.test(s)) {
-    throw new Error("Invalid integer");
+    throw new TypeError("Invalid integer");
   }
 
   // Safe parse
   const n = Number(s);
   if (!Number.isSafeInteger(n)) {
-    throw new Error("Integer out of safe range");
+    throw new TypeError("Integer out of safe range");
   }
 
   return n;
@@ -41,7 +41,7 @@ export function stringToInteger(input: string): number {
   try {
     return parseIntegerStrict(input);
   } catch {
-    throw new Error("The input parameter must be a valid integer.");
+    throw new TypeError("The input parameter must be a valid integer.");
   }
 }
 
@@ -68,7 +68,7 @@ export function stringToBoolean(input: string): boolean {
     return false;
   }
 
-  throw new Error(
+  throw new TypeError(
     "The input parameter must be a boolean (e.g., true/false, 1/0)."
   );
 }
@@ -89,12 +89,12 @@ export function stringToNumber(input: string): number {
 
     // Allow finite numbers only
     if (!Number.isFinite(n)) {
-      throw new Error("Invalid number");
+      throw new TypeError("Invalid number");
     }
 
     return n;
   } catch {
-    throw new Error("The input parameter must be a valid number.");
+    throw new TypeError("The input parameter must be a valid number.");
   }
 }
 

package/src/utilities/logger/base-logger.interface.ts

@@ -1,11 +1,36 @@
 // src/logging/BaseLogger.ts
 
+/**
+ * The supported log levels for the logger.
+ * - fatal: an unrecoverable error that will terminate the process
+ * - error: a recoverable error that should be reported
+ * - warn: unexpected situation that is not an error
+ * - info: general operational information
+ * - debug: detailed information useful for debugging
+ * - trace: highly verbose information for tracing execution
+ */
 export type LogLevel = "fatal" | "error" | "warn" | "info" | "debug" | "trace";
 
+/**
+ * Arbitrary metadata attached to log entries.
+ * Keys are strings and values can be any serializable data.
+ */
 export interface Meta {
   [key: string]: unknown;
 }
 
+/**
+ * A minimal base logger interface that defines a single logging method.
+ * Implementations should route messages to the appropriate output (console, file, etc.)
+ * according to the provided log level, message, and optional metadata.
+ */
 export interface BaseLogger {
+  /**
+   * Log a message at the specified log level, with optional metadata.
+   *
+   * @param level - The severity of the log message. One of: "fatal", "error", "warn", "info", "debug", "trace".
+   * @param message - The human-readable log message to record.
+   * @param meta - Optional additional structured data to accompany the log entry.
+   */
   log(level: LogLevel, message: string, meta?: Meta): void;
 }

package/src/utilities/parallel/parallel.ts

@@ -9,7 +9,10 @@ import { WorkerPool } from "./worker-pool";
  * @param {T} source - The source value to which `destination` will be rebound when the returned function runs.
  * @returns {() => void} A function that, when called, rebinds the captured `destination` to `source`.
  */
-export function set<T extends object>(destination: T, source: T): () => void {
+export function set<T extends object>(
+  destination: keyof T,
+  source: keyof T
+): () => void {
   return () => {
     destination = source;
   };

package/src/utilities/parallel/worker-pool.ts

@@ -71,9 +71,11 @@ export class WorkerPool<T, R> {
 
   // Map all items using a round-robin distribution across workers
   async mapAll(items: T[]): Promise<R[]> {
-    if (!Array.isArray(items)) throw new Error("Items must be an array");
-    const results: R[] = new Array(items.length);
+    if (!Array.isArray(items)) {
+      throw new TypeError("Items must be an array");
+    }
 
+    const results: R[] = new Array(items.length);
     const workerCount = this.workers.length;
     const tasks: Promise<void>[] = items.map((payload, idx) => {
       const workerIndex = idx % workerCount;