@scpxl/nodejs-framework 1.0.22 → 1.0.25

package/README.md

@@ -110,6 +110,37 @@ await app.start();
 console.log(`Server running at http://localhost:3000`);
 ```
 
+### Type-Safe Routes with Zod
+
+```typescript
+import { WebApplication } from '@scpxl/nodejs-framework';
+import { defineRoute } from '@scpxl/nodejs-framework/webserver';
+import { z } from 'zod';
+import { PaginationQuerySchema, NumericIdSchema } from '@scpxl/nodejs-framework/schemas';
+
+const app = new WebApplication({
+  /* config */
+});
+
+// Define a typed route with automatic validation
+const getUserRoute = defineRoute({
+  method: 'GET',
+  url: '/users/:id',
+  schema: {
+    params: z.object({ id: NumericIdSchema }),
+    querystring: PaginationQuerySchema,
+  },
+  handler: async (request, reply) => {
+    // TypeScript knows request.params.id is a number
+    // and request.query has page/limit with defaults
+    const user = await db.findUser(request.params.id);
+    return { data: user };
+  },
+});
+
+app.webserver.route(getUserRoute);
+```
+
 ### With Database & Queue
 
 ```typescript
@@ -152,33 +183,146 @@ await app.queue.manager.addJobToQueue({
 });
 ```
 
+### Simple Load Test
+
+Run lightweight load against any endpoint while iterating locally:
+
+```bash
+npm run load:test -- --url http://localhost:3000/health --requests 200 --concurrency 10
+```
+
+Switch to a time-based stream for soak-style checks:
+
+```bash
+npm run load:test -- --url http://localhost:3000/api/users --duration 30 --concurrency 8 --method POST --body '{"name":"Test"}' --header 'Content-Type: application/json'
+```
+
+The script reports latency percentiles, status code counts, and a few failure samples for quick feedback.
+
 ### WebSocket Server
 
+Real-time bidirectional communication with room support and authentication:
+
 ```typescript
 import { WebApplication } from '@scpxl/nodejs-framework';
+import { WebSocketServerBaseController } from '@scpxl/nodejs-framework/websocket';
+import type { WebSocket } from 'ws';
+
+// Create WebSocket controller
+class ChatController extends WebSocketServerBaseController {
+  public send = (ws: WebSocket, clientId: string, data: any) => {
+    // Broadcast to all clients
+    this.webSocketServer.sendMessageToAll({
+      data: {
+        type: 'chat',
+        action: 'message',
+        data: {
+          clientId,
+          text: data.text,
+          timestamp: new Date().toISOString(),
+        },
+      },
+    });
+
+    return { success: true };
+  };
+}
 
 const app = new WebApplication({
   name: 'chat-app',
   webserver: { port: 3000 },
-  websocket: { enabled: true },
+  websocket: {
+    enabled: true,
+    type: 'server',
+    url: 'ws://localhost:3000/ws',
+    controllersDirectory: './controllers',
+    routes: [
+      {
+        type: 'chat',
+        action: 'send',
+        controllerName: 'chat',
+        controller: ChatController,
+      },
+    ],
+    // Optional: JWT authentication
+    // Clients connect with: ws://localhost:3000/ws?token=<jwt>
+    events: {
+      onConnected: ({ ws, clientId }) => {
+        console.log('Client connected:', clientId);
+        ws.send(
+          JSON.stringify({
+            type: 'system',
+            action: 'connected',
+            data: { clientId, message: 'Welcome!' },
+          }),
+        );
+      },
+    },
+  },
   redis: { host: '127.0.0.1', port: 6379 },
+  auth: {
+    jwtSecretKey: process.env.JWT_SECRET || 'your-secret-key',
+  },
 });
 
 await app.start();
+console.log('WebSocket server running at ws://localhost:3000/ws');
+```
+
+#### Using Rooms
+
+```typescript
+// Client joins a room (built-in system controller)
+// Send from client: { type: 'system', action: 'joinRoom', data: { roomName: 'general', username: 'Alice' } }
+
+// Server-side: Broadcast to room members
+const roomClients = app.websocket.server.rooms.get('general');
+roomClients?.forEach(clientId => {
+  const client = app.websocket.server.clientManager.getClient({ clientId });
+  if (client?.ws) {
+    app.websocket.server.sendClientMessage(client.ws, {
+      type: 'room',
+      action: 'message',
+      data: { text: 'Room-specific announcement' },
+    });
+  }
+});
+```
 
-// Handle WebSocket connections
-app.websocket.server.onConnection(client => {
-  console.log('Client connected:', client.id);
+#### Using WebSocket Service
 
-  client.sendJSON({ type: 'welcome', message: 'Connected to chat server' });
+Simplified API for common operations:
 
-  client.on('message', data => {
-    // Broadcast to all clients
-    app.websocket.server.broadcast({ type: 'chat', data });
-  });
+```typescript
+import { WebSocketService } from '@scpxl/nodejs-framework/websocket';
+
+const wsService = new WebSocketService({
+  webSocketServer: app.websocket.server,
+  redisInstance: app.redis.instance,
+  workerId: String(process.pid),
+});
+
+// Broadcast to all clients
+await wsService.broadcast({
+  type: 'notification',
+  action: 'alert',
+  data: { message: 'New features available!' },
+});
+
+// Send to specific rooms
+await wsService.sendToRooms(['vip', 'premium'], {
+  type: 'offer',
+  action: 'new',
+  data: { discount: 20 },
 });
+
+// Convenience methods
+await wsService.sendUserMessage('profileUpdated', { userId: 123 });
+await wsService.sendSystemMessage('maintenance', { minutes: 5 });
 ```
 
+See the [WebSocket Guide](./docs/guides/websocket.md) for complete documentation.
+
 ---
 
 ## 📚 Documentation
@@ -212,6 +356,27 @@ The framework is built around three main application types:
 | **API Requester**   | HTTP client wrapper (migrated to native `fetch`) | `@scpxl/nodejs-framework/api-requester`   |
 | **Command**         | CLI command framework                            | `@scpxl/nodejs-framework/command`         |
 | **Services**        | Additional service integrations (AWS S3, etc.)   | `@scpxl/nodejs-framework/services`        |
+| **Schemas**         | Reusable Zod validation schemas                  | `@scpxl/nodejs-framework/schemas`         |
+
+### Guides
+
+Comprehensive guides for common tasks and features:
+
+- **[Getting Started](./docs/getting-started.md)** - Installation and first steps
+- **[Configuration](./docs/guides/configuration.md)** - Environment variables and config options
+- **[WebSocket Guide](./docs/guides/websocket.md)** - Real-time communication setup
+- **[Authentication Guide](./docs/guides/authentication.md)** - JWT auth implementation
+- **[Typed Routes](./docs/guides/typed-routes.md)** - Type-safe routing with Zod validation
+- **[Error Handling](./docs/guides/error-handling.md)** - Custom errors and error handling
+- **[Commands](./docs/guides/commands.md)** - Building CLI commands
+- **[Testing](./docs/guides/testing.md)** - Testing strategies and utilities
+- **[Performance Monitoring](./docs/guides/performance-monitoring.md)** - Metrics and observability
+- **[Simple Load Testing](./docs/guides/simple-load-test.md)** - Built-in load testing tool
+- **[Hot Module Reload (HMR)](./docs/guides/hmr.md)** - Development workflow
+- **[Deployment](./docs/guides/deployment.md)** - Production deployment guide
+- **[Scaling](./docs/guides/scaling.md)** - Horizontal scaling strategies
+- **[Logging](./docs/guides/logging.md)** - Structured logging best practices
+- **[Environment Variables](./docs/guides/env.md)** - Managing environment configuration
 
 ### Key Patterns
 
@@ -299,15 +464,15 @@ A full-stack example with:
 **Run the example:**
 
 ```bash
-# Install dependencies for examples (one-time setup)
-npm run example:install
+# Install dependencies (one-time setup)
+cd examples/hello-world/backend && npm install
+cd ../frontend && npm install
 
-# Run backend + frontend together with hot-reload
-npm run example:hello-world
+# Run backend
+npm run example --example=hello-world/backend
 
-# Or run individually
-npm run example:hello-world:backend
-npm run example:hello-world:frontend
+# Or run frontend (in another terminal)
+npm run example --example=hello-world/frontend
 ```
 
 Then open http://localhost:5173 to see the app.
@@ -317,17 +482,13 @@ Then open http://localhost:5173 to see the app.
 Demonstrates the command framework with examples:
 
 ```bash
-# Install dependencies
-npm run example:commands:install
-
-# Run hello command
-npm run example:commands:hello
+# Install dependencies (one-time setup)
+cd examples/commands && npm install
 
-# Run database seed command
-npm run example:commands:seed
-
-# Run queue processing command
-npm run example:commands:queue
+# Run commands from repository root
+npm run example --example=commands -- hello
+npm run example --example=commands -- database-seed
+npm run example --example=commands -- queue-process
 ```
 
 See [examples/README.md](examples/README.md) for more details.
@@ -336,6 +497,51 @@ See [examples/README.md](examples/README.md) for more details.
 
 ## 🛠️ Development
 
+### CLI (`pxl`)
+
+The framework now ships with a bundled CLI executable exposed as `pxl` when the package is installed.
+
+Current capabilities:
+
+- `pxl --version` / `pxl -v` / `pxl version` – Print framework version
+- `pxl info` (or just `pxl`) – Display banner + roadmap
+
+Planned subcommands (roadmap):
+
+- `pxl doctor` – Environment diagnostics (Node version, dependency checks, Redis/Postgres availability)
+- `pxl generate` – Scaffolding for applications, routes, commands, processors
+- `pxl analyze` – Project inspection (unused files, dependency graph summary)
+
+Usage examples:
+
+```bash
+# Show version
+pxl --version
+
+# Show framework banner and roadmap
+pxl info
+
+# (Future) Run doctor diagnostics
+pxl doctor
+```
+
+Development Note:
+
+When iterating locally, rebuild after CLI changes:
+
+```bash
+npm run build && pxl info
+```
+
+To test unpublished changes in another project via yalc:
+
+```bash
+npm run build:local
+yalc add @scpxl/nodejs-framework
+```
+
+For contributions adding new subcommands, implement them in `src/cli/` and register via the yargs builder in `src/cli/index.ts`.
+
 ### Build Commands
 
 ```bash
@@ -380,6 +586,38 @@ npm run test:ui
 
 The framework maintains **80% code coverage** across all metrics (lines, branches, functions, statements) as enforced by Vitest thresholds.
 
+### Framework Status Report
+
+Generate a cross-platform project health snapshot (dependency counts, git status, directory sizes, large packages, outdated/age metrics):
+
+```bash
+npm run status
+```
+
+Optional flags:
+
+```bash
+npm run status -- --include-cache               # Include .turbo/ and .next/cache directories
+npm run status -- --exclude "coverage,fixtures,**/*.snap"  # Additional exclude globs (comma-separated)
+```
+
+What it does:
+
+- Collects repo & package metadata (version, scripts, dependency counts)
+- Summarizes current git branch, last commit, and pending change counts
+- Computes sizes for `src`, `dist`, and `node_modules` using fast native traversal (`fast-folder-size`) with a JS fallback, filtering via `.gitignore` / `.npmignore` plus exclusions
+- Lists the largest packages in `node_modules` (top 8 by size)
+- Ranks outdated dependencies by publish age and major version lag (uses `npm outdated` / `npm view`)
+- Provides age distribution stats for installed top-level packages
+
+Exclusions & Ignore Behavior:
+
+- Always respects patterns found in `.gitignore` and `.npmignore` (except always keeps top-level `dist` & `node_modules`)
+- Built-in default excludes: `coverage/`, `fixtures/`, and `**/*.snap`
+- Skips heavy build caches (`.turbo`, `.next/cache`) unless `--include-cache` is passed
+
+Return codes: exits with non-zero only on unexpected internal errors; missing npm or network failures simply degrade sections gracefully.
+
 ### Local Development with Yalc
 
 For testing changes in consuming applications:

package/dist/api-requester/api-requester.d.ts

@@ -0,0 +1,32 @@
+export interface ApiRequestConfig extends Omit<RequestInit, 'method' | 'body' | 'headers'> {
+    headers?: Record<string, string | undefined>;
+    params?: Record<string, string | number | boolean | null | undefined>;
+    responseType?: 'json' | 'text';
+}
+export interface ApiResponse<T> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+}
+export default class ApiRequester {
+    private readonly baseURL;
+    private readonly defaultHeaders;
+    constructor(baseURL: string, headers?: Record<string, string>);
+    get<T>(url: string, config?: ApiRequestConfig): Promise<ApiResponse<T> | undefined>;
+    post<T, R>(url: string, data: T, config?: ApiRequestConfig): Promise<ApiResponse<R> | undefined>;
+    put<T, R>(url: string, data: T, config?: ApiRequestConfig): Promise<ApiResponse<R> | undefined>;
+    delete<T>(url: string, config?: ApiRequestConfig): Promise<ApiResponse<T> | undefined>;
+    private request;
+    private mergeHeaders;
+    private prepareBody;
+    private shouldSerializeAsJson;
+    private headersToRecord;
+    private buildUrl;
+    private isAbsoluteUrl;
+    private combineWithBase;
+    private parseResponse;
+    private createHttpError;
+    private handleError;
+}
+//# sourceMappingURL=api-requester.d.ts.map

package/dist/api-requester/api-requester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-requester.d.ts","sourceRoot":"","sources":["../../src/api-requester/api-requester.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACtE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AA0BD,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;gBAE5C,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM;IAKpD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAInF,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAIhG,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAI/F,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;YAIrF,OAAO;IAsCrB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,eAAe;YAUT,aAAa;YAkBb,eAAe;IAoC7B,OAAO,CAAC,WAAW;CAapB"}

package/dist/api-requester/api-requester.js

@@ -1,5 +1,6 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { safeSerializeError } from "../error/error-reporter.js";
 class ApiRequesterHttpError extends Error {
   static {
     __name(this, "ApiRequesterHttpError");
@@ -166,7 +167,7 @@ class ApiRequester {
     try {
       return JSON.parse(body);
     } catch (error) {
-      const reason = error instanceof Error ? error.message : String(error);
+      const reason = error instanceof Error ? error.message : safeSerializeError(error);
       throw new Error(`Failed to parse JSON response: ${reason}`);
     }
   }

package/dist/api-requester/api-requester.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/api-requester/api-requester.ts"],
-  "sourcesContent": ["export interface ApiRequestConfig extends Omit<RequestInit, 'method' | 'body' | 'headers'> {\n  headers?: Record<string, string | undefined>;\n  params?: Record<string, string | number | boolean | null | undefined>;\n  responseType?: 'json' | 'text';\n}\n\nexport interface ApiResponse<T> {\n  data: T;\n  status: number;\n  statusText: string;\n  headers: Record<string, string>;\n}\n\nclass ApiRequesterHttpError extends Error {\n  public readonly status: number;\n  public readonly statusText: string;\n  public readonly data: unknown;\n  public readonly headers: Record<string, string>;\n\n  constructor(\n    message: string,\n    options: {\n      status: number;\n      statusText: string;\n      data: unknown;\n      headers: Record<string, string>;\n    },\n  ) {\n    super(message);\n    this.name = 'ApiRequesterHttpError';\n    this.status = options.status;\n    this.statusText = options.statusText;\n    this.data = options.data;\n    this.headers = options.headers;\n  }\n}\n\nexport default class ApiRequester {\n  private readonly baseURL: string;\n  private readonly defaultHeaders: Record<string, string>;\n\n  constructor(baseURL: string, headers: Record<string, string> = {}) {\n    this.baseURL = baseURL;\n    this.defaultHeaders = { ...headers };\n  }\n\n  public async get<T>(url: string, config?: ApiRequestConfig): Promise<ApiResponse<T> | undefined> {\n    return this.request<T>('GET', url, undefined, config);\n  }\n\n  public async post<T, R>(url: string, data: T, config?: ApiRequestConfig): Promise<ApiResponse<R> | undefined> {\n    return this.request<R>('POST', url, data, config);\n  }\n\n  public async put<T, R>(url: string, data: T, config?: ApiRequestConfig): Promise<ApiResponse<R> | undefined> {\n    return this.request<R>('PUT', url, data, config);\n  }\n\n  public async delete<T>(url: string, config?: ApiRequestConfig): Promise<ApiResponse<T> | undefined> {\n    return this.request<T>('DELETE', url, undefined, config);\n  }\n\n  private async request<T>(\n    method: string,\n    url: string,\n    data?: unknown,\n    config?: ApiRequestConfig,\n  ): Promise<ApiResponse<T> | undefined> {\n    try {\n      const { headers: configHeaders, params, responseType = 'json', ...init } = config ?? {};\n      const finalUrl = this.buildUrl(url, params);\n      const headers = this.mergeHeaders(configHeaders, data);\n      const body = this.prepareBody(method, data);\n\n      // fetch is a global in Node.js 18+\n      // eslint-disable-next-line no-undef\n      const response = await fetch(finalUrl, {\n        ...init,\n        method,\n        headers,\n        body,\n      });\n\n      if (!response.ok) {\n        throw await this.createHttpError(response);\n      }\n\n      const parsed = await this.parseResponse<T>(response, responseType);\n\n      return {\n        data: parsed,\n        status: response.status,\n        statusText: response.statusText,\n        headers: this.headersToRecord(response.headers),\n      };\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n\n  private mergeHeaders(headers?: Record<string, string | undefined>, body?: unknown): Headers {\n    const merged = new Headers();\n\n    for (const [key, value] of Object.entries(this.defaultHeaders)) {\n      if (value !== undefined) {\n        merged.set(key, value);\n      }\n    }\n\n    if (headers) {\n      for (const [key, value] of Object.entries(headers)) {\n        if (value !== undefined) {\n          merged.set(key, value);\n        } else {\n          merged.delete(key);\n        }\n      }\n    }\n\n    if (body !== undefined && this.shouldSerializeAsJson(body) && !merged.has('content-type')) {\n      merged.set('content-type', 'application/json');\n    }\n\n    return merged;\n  }\n\n  private prepareBody(method: string, data?: unknown): BodyInit | null | undefined {\n    if (method === 'GET' || method === 'HEAD' || data === undefined) {\n      return undefined;\n    }\n\n    if (typeof data === 'string' || data instanceof ArrayBuffer || ArrayBuffer.isView(data)) {\n      return data as BodyInit;\n    }\n\n    if (typeof Blob !== 'undefined' && data instanceof Blob) {\n      return data;\n    }\n\n    if (typeof FormData !== 'undefined' && data instanceof FormData) {\n      return data;\n    }\n\n    if (typeof URLSearchParams !== 'undefined' && data instanceof URLSearchParams) {\n      return data;\n    }\n\n    if (typeof ReadableStream !== 'undefined' && data instanceof ReadableStream) {\n      return data;\n    }\n\n    return JSON.stringify(data);\n  }\n\n  private shouldSerializeAsJson(data: unknown): boolean {\n    if (data === null) {\n      return true;\n    }\n\n    if (Array.isArray(data)) {\n      return true;\n    }\n\n    const primitiveTypes = ['string', 'number', 'boolean', 'bigint'];\n    if (primitiveTypes.includes(typeof data)) {\n      return false;\n    }\n\n    if (typeof data === 'object') {\n      return !(\n        data instanceof ArrayBuffer ||\n        ArrayBuffer.isView(data) ||\n        (typeof Blob !== 'undefined' && data instanceof Blob) ||\n        (typeof FormData !== 'undefined' && data instanceof FormData) ||\n        (typeof URLSearchParams !== 'undefined' && data instanceof URLSearchParams) ||\n        (typeof ReadableStream !== 'undefined' && data instanceof ReadableStream) ||\n        (typeof Buffer !== 'undefined' && Buffer.isBuffer(data))\n      );\n    }\n\n    return false;\n  }\n\n  private headersToRecord(headers: Headers): Record<string, string> {\n    const result: Record<string, string> = {};\n    headers.forEach((value, key) => {\n      // Safe: key comes from Headers iterator, not user input\n      // eslint-disable-next-line security/detect-object-injection\n      result[key] = value;\n    });\n    return result;\n  }\n\n  private buildUrl(path: string, params?: Record<string, string | number | boolean | null | undefined>): string {\n    const absolute = this.isAbsoluteUrl(path) ? path : this.combineWithBase(path);\n    if (!params) {\n      return absolute;\n    }\n\n    const url = new URL(absolute);\n    for (const [key, rawValue] of Object.entries(params)) {\n      if (rawValue === undefined || rawValue === null) {\n        continue;\n      }\n      url.searchParams.set(key, String(rawValue));\n    }\n    return url.toString();\n  }\n\n  private isAbsoluteUrl(url: string): boolean {\n    return /^https?:\\/\\//i.test(url);\n  }\n\n  private combineWithBase(path: string): string {\n    if (!this.baseURL) {\n      return path;\n    }\n\n    const normalizedBase = this.baseURL.endsWith('/') ? this.baseURL.slice(0, -1) : this.baseURL;\n    const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n    return `${normalizedBase}${normalizedPath}`;\n  }\n\n  private async parseResponse<T>(response: Response, responseType: 'json' | 'text'): Promise<T> {\n    if (responseType === 'text') {\n      return (await response.text()) as T;\n    }\n\n    const body = await response.text();\n    if (!body) {\n      return undefined as T;\n    }\n\n    try {\n      return JSON.parse(body) as T;\n    } catch (error) {\n      const reason = error instanceof Error ? error.message : String(error);\n      throw new Error(`Failed to parse JSON response: ${reason}`);\n    }\n  }\n\n  private async createHttpError(response: Response): Promise<ApiRequesterHttpError> {\n    const headers = this.headersToRecord(response.headers);\n    let data: unknown = undefined;\n    let message = `Request failed with status ${response.status}`;\n\n    try {\n      const text = await response.text();\n      if (text) {\n        const contentType = headers['content-type'] ?? '';\n        if (contentType.includes('application/json')) {\n          data = JSON.parse(text);\n          if (data && typeof data === 'object' && 'message' in (data as Record<string, unknown>)) {\n            const potentialMessage = (data as Record<string, unknown>).message;\n            if (typeof potentialMessage === 'string') {\n              message = potentialMessage;\n            }\n          }\n        } else {\n          data = text;\n          message = text;\n        }\n      }\n    } catch {\n      // If parsing fails, use defaults set above\n      data = undefined;\n      message = `Request failed with status ${response.status}`;\n    }\n\n    return new ApiRequesterHttpError(message, {\n      status: response.status,\n      statusText: response.statusText,\n      data,\n      headers,\n    });\n  }\n\n  private handleError(error: unknown): never {\n    if (error instanceof ApiRequesterHttpError) {\n      console.error('HTTP error:', {\n        status: error.status,\n        statusText: error.statusText,\n        data: error.data,\n      });\n    } else {\n      console.error('Unexpected error:', error);\n    }\n\n    throw error;\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { safeSerializeError } from '../error/error-reporter.js';\n\nexport interface ApiRequestConfig extends Omit<RequestInit, 'method' | 'body' | 'headers'> {\n  headers?: Record<string, string | undefined>;\n  params?: Record<string, string | number | boolean | null | undefined>;\n  responseType?: 'json' | 'text';\n}\n\nexport interface ApiResponse<T> {\n  data: T;\n  status: number;\n  statusText: string;\n  headers: Record<string, string>;\n}\n\nclass ApiRequesterHttpError extends Error {\n  public readonly status: number;\n  public readonly statusText: string;\n  public readonly data: unknown;\n  public readonly headers: Record<string, string>;\n\n  constructor(\n    message: string,\n    options: {\n      status: number;\n      statusText: string;\n      data: unknown;\n      headers: Record<string, string>;\n    },\n  ) {\n    super(message);\n    this.name = 'ApiRequesterHttpError';\n    this.status = options.status;\n    this.statusText = options.statusText;\n    this.data = options.data;\n    this.headers = options.headers;\n  }\n}\n\nexport default class ApiRequester {\n  private readonly baseURL: string;\n  private readonly defaultHeaders: Record<string, string>;\n\n  constructor(baseURL: string, headers: Record<string, string> = {}) {\n    this.baseURL = baseURL;\n    this.defaultHeaders = { ...headers };\n  }\n\n  public async get<T>(url: string, config?: ApiRequestConfig): Promise<ApiResponse<T> | undefined> {\n    return this.request<T>('GET', url, undefined, config);\n  }\n\n  public async post<T, R>(url: string, data: T, config?: ApiRequestConfig): Promise<ApiResponse<R> | undefined> {\n    return this.request<R>('POST', url, data, config);\n  }\n\n  public async put<T, R>(url: string, data: T, config?: ApiRequestConfig): Promise<ApiResponse<R> | undefined> {\n    return this.request<R>('PUT', url, data, config);\n  }\n\n  public async delete<T>(url: string, config?: ApiRequestConfig): Promise<ApiResponse<T> | undefined> {\n    return this.request<T>('DELETE', url, undefined, config);\n  }\n\n  private async request<T>(\n    method: string,\n    url: string,\n    data?: unknown,\n    config?: ApiRequestConfig,\n  ): Promise<ApiResponse<T> | undefined> {\n    try {\n      const { headers: configHeaders, params, responseType = 'json', ...init } = config ?? {};\n      const finalUrl = this.buildUrl(url, params);\n      const headers = this.mergeHeaders(configHeaders, data);\n      const body = this.prepareBody(method, data);\n\n      // fetch is a global in Node.js 18+\n      // eslint-disable-next-line no-undef\n      const response = await fetch(finalUrl, {\n        ...init,\n        method,\n        headers,\n        body,\n      });\n\n      if (!response.ok) {\n        throw await this.createHttpError(response);\n      }\n\n      const parsed = await this.parseResponse<T>(response, responseType);\n\n      return {\n        data: parsed,\n        status: response.status,\n        statusText: response.statusText,\n        headers: this.headersToRecord(response.headers),\n      };\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n\n  private mergeHeaders(headers?: Record<string, string | undefined>, body?: unknown): Headers {\n    const merged = new Headers();\n\n    for (const [key, value] of Object.entries(this.defaultHeaders)) {\n      if (value !== undefined) {\n        merged.set(key, value);\n      }\n    }\n\n    if (headers) {\n      for (const [key, value] of Object.entries(headers)) {\n        if (value !== undefined) {\n          merged.set(key, value);\n        } else {\n          merged.delete(key);\n        }\n      }\n    }\n\n    if (body !== undefined && this.shouldSerializeAsJson(body) && !merged.has('content-type')) {\n      merged.set('content-type', 'application/json');\n    }\n\n    return merged;\n  }\n\n  private prepareBody(method: string, data?: unknown): BodyInit | null | undefined {\n    if (method === 'GET' || method === 'HEAD' || data === undefined) {\n      return undefined;\n    }\n\n    if (typeof data === 'string' || data instanceof ArrayBuffer || ArrayBuffer.isView(data)) {\n      return data as BodyInit;\n    }\n\n    if (typeof Blob !== 'undefined' && data instanceof Blob) {\n      return data;\n    }\n\n    if (typeof FormData !== 'undefined' && data instanceof FormData) {\n      return data;\n    }\n\n    if (typeof URLSearchParams !== 'undefined' && data instanceof URLSearchParams) {\n      return data;\n    }\n\n    if (typeof ReadableStream !== 'undefined' && data instanceof ReadableStream) {\n      return data;\n    }\n\n    return JSON.stringify(data);\n  }\n\n  private shouldSerializeAsJson(data: unknown): boolean {\n    if (data === null) {\n      return true;\n    }\n\n    if (Array.isArray(data)) {\n      return true;\n    }\n\n    const primitiveTypes = ['string', 'number', 'boolean', 'bigint'];\n    if (primitiveTypes.includes(typeof data)) {\n      return false;\n    }\n\n    if (typeof data === 'object') {\n      return !(\n        data instanceof ArrayBuffer ||\n        ArrayBuffer.isView(data) ||\n        (typeof Blob !== 'undefined' && data instanceof Blob) ||\n        (typeof FormData !== 'undefined' && data instanceof FormData) ||\n        (typeof URLSearchParams !== 'undefined' && data instanceof URLSearchParams) ||\n        (typeof ReadableStream !== 'undefined' && data instanceof ReadableStream) ||\n        (typeof Buffer !== 'undefined' && Buffer.isBuffer(data))\n      );\n    }\n\n    return false;\n  }\n\n  private headersToRecord(headers: Headers): Record<string, string> {\n    const result: Record<string, string> = {};\n    headers.forEach((value, key) => {\n      // Safe: key comes from Headers iterator, not user input\n      // eslint-disable-next-line security/detect-object-injection\n      result[key] = value;\n    });\n    return result;\n  }\n\n  private buildUrl(path: string, params?: Record<string, string | number | boolean | null | undefined>): string {\n    const absolute = this.isAbsoluteUrl(path) ? path : this.combineWithBase(path);\n    if (!params) {\n      return absolute;\n    }\n\n    const url = new URL(absolute);\n    for (const [key, rawValue] of Object.entries(params)) {\n      if (rawValue === undefined || rawValue === null) {\n        continue;\n      }\n      url.searchParams.set(key, String(rawValue));\n    }\n    return url.toString();\n  }\n\n  private isAbsoluteUrl(url: string): boolean {\n    return /^https?:\\/\\//i.test(url);\n  }\n\n  private combineWithBase(path: string): string {\n    if (!this.baseURL) {\n      return path;\n    }\n\n    const normalizedBase = this.baseURL.endsWith('/') ? this.baseURL.slice(0, -1) : this.baseURL;\n    const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n    return `${normalizedBase}${normalizedPath}`;\n  }\n\n  private async parseResponse<T>(response: Response, responseType: 'json' | 'text'): Promise<T> {\n    if (responseType === 'text') {\n      return (await response.text()) as T;\n    }\n\n    const body = await response.text();\n    if (!body) {\n      return undefined as T;\n    }\n\n    try {\n      return JSON.parse(body) as T;\n    } catch (error) {\n      const reason = error instanceof Error ? error.message : safeSerializeError(error);\n      throw new Error(`Failed to parse JSON response: ${reason}`);\n    }\n  }\n\n  private async createHttpError(response: Response): Promise<ApiRequesterHttpError> {\n    const headers = this.headersToRecord(response.headers);\n    let data: unknown = undefined;\n    let message = `Request failed with status ${response.status}`;\n\n    try {\n      const text = await response.text();\n      if (text) {\n        const contentType = headers['content-type'] ?? '';\n        if (contentType.includes('application/json')) {\n          data = JSON.parse(text);\n          if (data && typeof data === 'object' && 'message' in (data as Record<string, unknown>)) {\n            const potentialMessage = (data as Record<string, unknown>).message;\n            if (typeof potentialMessage === 'string') {\n              message = potentialMessage;\n            }\n          }\n        } else {\n          data = text;\n          message = text;\n        }\n      }\n    } catch {\n      // If parsing fails, use defaults set above\n      data = undefined;\n      message = `Request failed with status ${response.status}`;\n    }\n\n    return new ApiRequesterHttpError(message, {\n      status: response.status,\n      statusText: response.statusText,\n      data,\n      headers,\n    });\n  }\n\n  private handleError(error: unknown): never {\n    if (error instanceof ApiRequesterHttpError) {\n      console.error('HTTP error:', {\n        status: error.status,\n        statusText: error.statusText,\n        data: error.data,\n      });\n    } else {\n      console.error('Unexpected error:', error);\n    }\n\n    throw error;\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/api-requester/index.d.ts

@@ -0,0 +1,3 @@
+export { default as ApiRequester } from './api-requester.js';
+export type { ApiRequestConfig, ApiResponse } from './api-requester.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/api-requester/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api-requester/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/application/base-application.d.ts

@@ -0,0 +1,106 @@
+import { type DatabaseInstance, DatabaseManager } from '../database/index.js';
+import QueueManager from '../queue/manager.js';
+import RedisManager from '../redis/manager.js';
+import type { ApplicationConfig, ApplicationStopInstanceOptions } from './base-application.interface.js';
+import type RedisInstance from '../redis/instance.js';
+import CacheManager from '../cache/manager.js';
+import EventManager from '../event/manager.js';
+import type { PerformanceMonitor } from '../performance/performance-monitor.js';
+import { LifecycleManager, ShutdownController } from '../lifecycle/index.js';
+export type { ApplicationConfig } from './base-application.interface.js';
+export default abstract class BaseApplication {
+    /** Unique instance ID */
+    uniqueInstanceId: string;
+    /** Application start time */
+    protected startTime: number;
+    /** Shutdown timeout (30 seconds) */
+    protected shutdownTimeout: number;
+    /** Cache for application version to avoid repeated imports */
+    private static applicationVersionCache;
+    /** Cluster worker ID */
+    protected workerId: number | null;
+    /** Application config */
+    protected config: ApplicationConfig;
+    /** Application version */
+    protected applicationVersion?: string;
+    /** Redis manager */
+    redisManager: RedisManager;
+    /** Cache manager */
+    cacheManager: CacheManager;
+    /** Database manager */
+    databaseManager?: DatabaseManager;
+    /** Queue manager */
+    queueManager?: QueueManager;
+    /** Event manager */
+    eventManager?: EventManager;
+    /** Performance monitor */
+    performanceMonitor?: PerformanceMonitor;
+    /** Lifecycle manager */
+    lifecycle: LifecycleManager;
+    /** Shutdown controller */
+    shutdownController: ShutdownController;
+    get Name(): string;
+    /**
+     * Application constructor
+     */
+    constructor(config: ApplicationConfig);
+    /**
+     * Get application version
+     */
+    getApplicationVersion(): Promise<string>;
+    /**
+     * Start application
+     */
+    start(): Promise<void>;
+    /**
+     * Before application start
+     */
+    private onBeforeStart;
+    /**
+     * Application started event
+     */
+    protected onStarted({ startupTime: _startupTime }: {
+        startupTime: number;
+    }): void;
+    /**
+     * Application stopped event
+     */
+    protected onStopped({ runtime: _runtime }: {
+        runtime: number;
+    }): void;
+    /**
+     * Start application instance
+     */
+    private startInstance;
+    protected abstract startHandler({ redisInstance, databaseInstance, queueManager, eventManager, }: {
+        redisInstance: RedisInstance;
+        databaseInstance?: DatabaseInstance | null;
+        queueManager: QueueManager;
+        eventManager?: EventManager | null;
+    }): Promise<void>;
+    protected abstract stopCallback(): void;
+    /**
+     * Set up global error handlers
+     */
+    /**
+     * Initialize performance monitor
+     */
+    private setupGlobalErrorHandlers;
+    /**
+     * Register shutdown hooks for proper cleanup
+     */
+    private registerShutdownHooks;
+    /**
+     * Initiate graceful shutdown
+     */
+    private initiateGracefulShutdown;
+    /**
+     * Stop application using lifecycle manager
+     */
+    stop({ onStopped }?: ApplicationStopInstanceOptions): Promise<void>;
+    /**
+     * Finalize exit: during tests, suppress actual process exit to avoid failing vitest runs.
+     */
+    private finalizeExit;
+}
+//# sourceMappingURL=base-application.d.ts.map

package/dist/application/base-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-application.d.ts","sourceRoot":"","sources":["../../src/application/base-application.ts"],"names":[],"mappings":"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"}