@elysiumjs/hermes 0.4.0 → 0.4.3

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @elysiumjs/hermes
 
+## 0.4.3
+
+### Patch Changes
+
+- [`04773f2`](https://github.com/na2axl/elysiumjs/commit/04773f2acd4ab1c762a80ee903715d90f1c08e21) Thanks [@na2axl](https://github.com/na2axl)! - Ship the type declarations. The packages pointed `types` at `dist/index.d.ts` but their build never wrote it, so TypeScript projects got no types for them.
+
+## 0.4.2
+
+### Patch Changes
+
+- [`68a0cdd`](https://github.com/na2axl/elysiumjs/commit/68a0cdd8b2e4a003d6e0af2d78985623cae40428) Thanks [@na2axl](https://github.com/na2axl)! - Route the framework's own diagnostics through the logger service.
+
+  Breaking changes:
+
+  - `@Event.listen()` with a mode other than `on` or `once` now throws an `ElysiumError` when the class is defined, instead of logging to the console and ignoring the listener.
+
+  Fixes and additions:
+
+  - `getLogger(context?)` and `LOGGER_SERVICE` (`'logger'`) are exported by `@elysiumjs/core`. `getLogger()` returns the `logger` service when one is registered (such as the one `HermesModule` provides), and a `ConsoleLogger` otherwise or when the service cannot be built or fails to create a child logger. It is resolved at call time from the global scope only, so a module's own `logger` service does not replace it, and returns a child logger bound to `context` when one is given.
+  - `Middleware.logger` (used by `RequestLoggerMiddleware`) falls back to a `ConsoleLogger` when no `logger` service is registered. It threw before.
+  - Core diagnostics go through the logger with structured context instead of `console.*`: the debug-mode request log (`debug`, with `method` and `url`), `onDestroy` failures on shutdown (`error`, with `target` and `error`), WAMP connection attempts (`warn` while retrying, `error` when giving up, with `connection`, `attempt`/`attempts`, `maxRetries` and `error`), and WAMP registrations and subscriptions (`info`, with `connection`, `topic` and the registration or subscription id).
+  - In debug mode, incoming requests are logged through the logger at `debug` level instead of printed with `console.log`. With `HermesModule`, they show only when its `level` is `debug` or `trace`.
+  - A failed WAMP registration or subscription is logged at `error` level and emitted as `elysium:error` with an error naming the topic and the connection, instead of becoming an unhandled rejection.
+  - The `elysium:error` emitted for a WAMP client error names the connection and its URL and includes the client's message (or the value it reported, when it is not an `Error`), with that value as `cause` when there is one.
+  - `HermesLogger` serialises an `error` field of the log context like pino's `err` (type, message and stack), so logged errors keep their stack trace. Elysium logs errors under `error`.
+  - `@Logged` resolves its fallback logger with `getLogger()`, and logs a thrown error whole under `error` (it logged only its message), so its stack trace is kept.
+  - The `elysium:error` emitted when a WAMP connection gives up states the number of attempts actually made (the first one plus the retries), as the logged `attempts` does. It stated `maxRetries` before.
+
+- Updated dependencies [[`68a0cdd`](https://github.com/na2axl/elysiumjs/commit/68a0cdd8b2e4a003d6e0af2d78985623cae40428), [`2c49acd`](https://github.com/na2axl/elysiumjs/commit/2c49acd3b552aa43765d70339fa216961499e1b5), [`76ba0ff`](https://github.com/na2axl/elysiumjs/commit/76ba0ff18f3c196cebc2189426328f67cb699f46), [`4ebf029`](https://github.com/na2axl/elysiumjs/commit/4ebf029611e6d753a4f1bfdbe247a75d954d9ded), [`bacce71`](https://github.com/na2axl/elysiumjs/commit/bacce7146f667a1a46bf474dc0344fb0111ae12a)]:
+  - @elysiumjs/core@0.10.0
+
+## 0.4.1
+
+### Patch Changes
+
+- Updated dependencies [[`5fef4a7`](https://github.com/na2axl/elysiumjs/commit/5fef4a7199f502fc4fe035299e7670739459a108)]:
+  - @elysiumjs/core@0.9.0
+
 ## 0.4.0
 
 ### Minor Changes

package/dist/decorators/logged.d.ts

@@ -0,0 +1,16 @@
+import type { LogLevel } from '../types';
+export interface LoggedOptions {
+    level?: LogLevel;
+    includeArgs?: boolean;
+    includeResult?: boolean;
+    includeTiming?: boolean;
+}
+/**
+ * Decorator that logs method entry/exit with optional timing.
+ *
+ * Logger is resolved at CALL TIME (not decorator definition time)
+ * to avoid capturing a stale logger reference.
+ *
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare function Logged(options?: LoggedOptions): MethodDecorator;

package/dist/hermes.module.d.ts

@@ -0,0 +1,24 @@
+import { type HermesConfig } from './types';
+declare const HermesModule_base: (abstract new () => {
+    readonly config: HermesConfig;
+    onInit(): Promise<void> | void;
+    onDestroy(): Promise<void> | void;
+    onServe(_app: import("elysia").default<any>): Promise<void> | void;
+}) & {
+    readonly config: string;
+    with(config: Partial<HermesConfig> | (() => Partial<HermesConfig> | Promise<Partial<HermesConfig>>)): import("@elysiumjs/core").ConfiguredModule<HermesConfig>;
+    resolveConfig(input?: Partial<HermesConfig> | undefined): HermesConfig;
+    register<TConfig_1 = any>(props?: import("@elysiumjs/core").ModuleProps<TConfig_1>): (target: import("@elysiumjs/core").ModuleClass) => void;
+    configurable<TConfig extends object>(options?: {
+        defaults?: Partial<TConfig>;
+        required?: (keyof TConfig)[];
+    }): any;
+};
+/**
+ * Provides the {@link HermesLogger} as the global services `HermesLogger` and `logger`
+ * (the same instance), built from the module config.
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare class HermesModule extends HermesModule_base {
+}
+export {};

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { HermesModule } from './hermes.module';
+export { HermesLogger } from './services/logger.service';
+export { HttpTransport } from './transports/http.transport';
+export type { HttpTransportOptions } from './transports/http.transport';
+export { Logged } from './decorators/logged';
+export type { LoggedOptions } from './decorators/logged';
+export type { HermesConfig, LogLevel, LogFormat, TransportConfig } from './types';

package/dist/index.js

@@ -1,2 +1,2 @@
 // @bun
-var __legacyDecorateClassTS=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect==="object"&&typeof Reflect.decorate==="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)if(d=decorators[i])r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r;return c>3&&r&&Object.defineProperty(target,key,r),r};var __require=import.meta.require;import{Module}from"@elysiumjs/core";import{Service}from"@elysiumjs/core";import pino from"pino";var DEFAULT_CONFIG={level:"info",format:"json"};class HermesLogger{pino;config;static make(name){return Service.get(HermesLogger)?.child({name})??new HermesLogger({name})}constructor(config={}){this.config={...DEFAULT_CONFIG,...config},this.pino=this.createPinoInstance()}createPinoInstance(){let options={level:this.config.level,name:this.config.name};if(this.config.format==="pretty")return pino(options,pino.transport({target:"pino-pretty"}));return pino(options)}trace(msg,ctx){this.pino.trace(ctx??{},msg)}debug(msg,ctx){this.pino.debug(ctx??{},msg)}info(msg,ctx){this.pino.info(ctx??{},msg)}warn(msg,ctx){this.pino.warn(ctx??{},msg)}error(msg,ctx){this.pino.error(ctx??{},msg)}fatal(msg,ctx){this.pino.fatal(ctx??{},msg)}flush(){this.pino.flush?.()}onDestroy(){this.flush()}child(ctx){let child=Object.create(this);return child.pino=this.pino.child(ctx),child}}class HermesModule extends Module.configurable({defaults:{...DEFAULT_CONFIG}}){}HermesModule=__legacyDecorateClassTS([Module.register({services:(config)=>[{name:HermesLogger.name,global:!0,factory:()=>new HermesLogger(config)},{name:"logger",global:!0,factory:(_config,get)=>get(HermesLogger.name)}]})],HermesModule);class HttpTransport{options;buffer=[];flushTimer;maxBufferSize;constructor(options){this.options=options;this.options.batchSize??=100,this.options.flushInterval??=5000,this.maxBufferSize=this.options.maxBufferSize??1e4,this.flushTimer=setInterval(()=>this.flush(),this.options.flushInterval)}write(formatted){if(this.buffer.length>=this.maxBufferSize)this.buffer.shift();if(this.buffer.push(formatted),this.buffer.length>=this.options.batchSize)this.flush()}async flush(){if(this.buffer.length===0)return;let batch=this.buffer.splice(0);try{await fetch(this.options.url,{method:"POST",headers:{"Content-Type":"application/json",...this.options.headers},body:JSON.stringify({logs:batch})})}catch{let space=this.maxBufferSize-this.buffer.length;if(space>0)this.buffer.unshift(...batch.slice(0,space))}}async close(){if(this.flushTimer)clearInterval(this.flushTimer);await this.flush()}}import{ConsoleLogger}from"@elysiumjs/core";function Logged(options={}){return function(target,propertyKey,descriptor){let original=descriptor.value,methodName=`${target.constructor.name}.${String(propertyKey)}`;return descriptor.value=async function(...args){let logger=this.logger??getServiceLogger(),startTime=Date.now();if(options.includeArgs)logger.debug(`[${methodName}] Entry`,{args});try{let result=await original.apply(this,args);if(options.includeResult||options.includeTiming){let duration=Date.now()-startTime;logger[options.level??"debug"](`[${methodName}] Exit`,{...options.includeResult&&{result},...options.includeTiming&&{duration:`${duration}ms`}})}return result}catch(error){let duration=Date.now()-startTime;throw logger.error(`[${methodName}] Error`,{error:error instanceof Error?error.message:error,duration:`${duration}ms`}),error}},descriptor}}function getServiceLogger(){try{let{Service}=__require("@elysiumjs/core");return Service.get("logger")??new ConsoleLogger}catch{return new ConsoleLogger}}export{HermesLogger,HermesModule,HttpTransport,Logged};
+var __legacyDecorateClassTS=function(decorators,target,key,desc){var c=arguments.length,r=c<3?target:desc===null?desc=Object.getOwnPropertyDescriptor(target,key):desc,d;if(typeof Reflect==="object"&&typeof Reflect.decorate==="function")r=Reflect.decorate(decorators,target,key,desc);else for(var i=decorators.length-1;i>=0;i--)if(d=decorators[i])r=(c<3?d(r):c>3?d(target,key,r):d(target,key))||r;return c>3&&r&&Object.defineProperty(target,key,r),r};import{LOGGER_SERVICE,Module}from"@elysiumjs/core";import{Service}from"@elysiumjs/core";import pino from"pino";var DEFAULT_CONFIG={level:"info",format:"json"};class HermesLogger{pino;config;static make(name){return Service.get(HermesLogger)?.child({name})??new HermesLogger({name})}constructor(config={}){this.config={...DEFAULT_CONFIG,...config},this.pino=this.createPinoInstance()}createPinoInstance(){let options={level:this.config.level,name:this.config.name,serializers:{error:pino.stdSerializers.err}};if(this.config.format==="pretty")return pino(options,pino.transport({target:"pino-pretty"}));return pino(options)}trace(msg,ctx){this.pino.trace(ctx??{},msg)}debug(msg,ctx){this.pino.debug(ctx??{},msg)}info(msg,ctx){this.pino.info(ctx??{},msg)}warn(msg,ctx){this.pino.warn(ctx??{},msg)}error(msg,ctx){this.pino.error(ctx??{},msg)}fatal(msg,ctx){this.pino.fatal(ctx??{},msg)}flush(){this.pino.flush?.()}onDestroy(){this.flush()}child(ctx){let child=Object.create(this);return child.pino=this.pino.child(ctx),child}}class HermesModule extends Module.configurable({defaults:{...DEFAULT_CONFIG}}){}HermesModule=__legacyDecorateClassTS([Module.register({services:(config)=>[{name:HermesLogger.name,global:!0,factory:()=>new HermesLogger(config)},{name:LOGGER_SERVICE,global:!0,factory:(_config,get)=>get(HermesLogger.name)}]})],HermesModule);class HttpTransport{options;buffer=[];flushTimer;maxBufferSize;constructor(options){this.options=options;this.options.batchSize??=100,this.options.flushInterval??=5000,this.maxBufferSize=this.options.maxBufferSize??1e4,this.flushTimer=setInterval(()=>this.flush(),this.options.flushInterval)}write(formatted){if(this.buffer.length>=this.maxBufferSize)this.buffer.shift();if(this.buffer.push(formatted),this.buffer.length>=this.options.batchSize)this.flush()}async flush(){if(this.buffer.length===0)return;let batch=this.buffer.splice(0);try{await fetch(this.options.url,{method:"POST",headers:{"Content-Type":"application/json",...this.options.headers},body:JSON.stringify({logs:batch})})}catch{let space=this.maxBufferSize-this.buffer.length;if(space>0)this.buffer.unshift(...batch.slice(0,space))}}async close(){if(this.flushTimer)clearInterval(this.flushTimer);await this.flush()}}import{getLogger}from"@elysiumjs/core";function Logged(options={}){return function(target,propertyKey,descriptor){let original=descriptor.value,methodName=`${target.constructor.name}.${String(propertyKey)}`;return descriptor.value=async function(...args){let logger=this.logger??getLogger(),startTime=Date.now();if(options.includeArgs)logger.debug(`[${methodName}] Entry`,{args});try{let result=await original.apply(this,args);if(options.includeResult||options.includeTiming){let duration=Date.now()-startTime;logger[options.level??"debug"](`[${methodName}] Exit`,{...options.includeResult&&{result},...options.includeTiming&&{duration:`${duration}ms`}})}return result}catch(error){let duration=Date.now()-startTime;throw logger.error(`[${methodName}] Error`,{error,duration:`${duration}ms`}),error}},descriptor}}export{HermesLogger,HermesModule,HttpTransport,Logged};

package/dist/services/logger.service.d.ts

@@ -0,0 +1,29 @@
+import type { LoggerInterface } from '@elysiumjs/core';
+import type { HermesConfig } from '../types';
+/**
+ * Production-ready logger implementation wrapping Pino.
+ * Implements `LoggerInterface` from `@elysiumjs/core`.
+ *
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare class HermesLogger implements LoggerInterface {
+    private pino;
+    private config;
+    static make(name: string): HermesLogger;
+    constructor(config?: Partial<HermesConfig>);
+    private createPinoInstance;
+    trace(msg: string, ctx?: Record<string, unknown>): void;
+    debug(msg: string, ctx?: Record<string, unknown>): void;
+    info(msg: string, ctx?: Record<string, unknown>): void;
+    warn(msg: string, ctx?: Record<string, unknown>): void;
+    error(msg: string, ctx?: Record<string, unknown>): void;
+    fatal(msg: string, ctx?: Record<string, unknown>): void;
+    /**
+     * Flushes buffered log lines of the underlying transport, when it supports it.
+     * @author Axel Nana <axel.nana@workbud.com>
+     */
+    flush(): void;
+    /** Flushes on shutdown. Only called for a logger the container built. */
+    onDestroy(): void;
+    child(ctx: Record<string, unknown>): HermesLogger;
+}

package/dist/transports/http.transport.d.ts

@@ -0,0 +1,22 @@
+export interface HttpTransportOptions {
+    url: string;
+    headers?: Record<string, string>;
+    batchSize?: number;
+    flushInterval?: number;
+    maxBufferSize?: number;
+}
+/**
+ * HTTP transport for batching and sending logs to a remote endpoint.
+ *
+ * @author Axel Nana <axel.nana@workbud.com>
+ */
+export declare class HttpTransport {
+    private options;
+    private buffer;
+    private flushTimer?;
+    private maxBufferSize;
+    constructor(options: HttpTransportOptions);
+    write(formatted: string): void;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/types.d.ts

@@ -0,0 +1,13 @@
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export type LogFormat = 'json' | 'pretty' | 'logfmt';
+export interface TransportConfig {
+    type: 'console' | 'file' | 'http';
+    options?: Record<string, unknown>;
+}
+export interface HermesConfig {
+    name?: string;
+    level: LogLevel;
+    format: LogFormat;
+    transports?: TransportConfig[];
+}
+export declare const DEFAULT_CONFIG: HermesConfig;

package/package.json

@@ -1,9 +1,22 @@
 {
   "name": "@elysiumjs/hermes",
-  "version": "0.4.0",
+  "version": "0.4.3",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/na2axl/elysiumjs.git",
+    "directory": "@elysiumjs/hermes"
+  },
+  "homepage": "https://github.com/na2axl/elysiumjs/tree/main/@elysiumjs/hermes#readme",
+  "bugs": {
+    "url": "https://github.com/na2axl/elysiumjs/issues"
+  },
   "type": "module",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
   "sideEffects": false,
   "scripts": {
     "format": "prettier --write \"./src/**/*.ts\"",
@@ -21,9 +34,9 @@
     "pino-pretty": "^13.2.0"
   },
   "devDependencies": {
-    "@elysiumjs/core": "0.8.0"
+    "@elysiumjs/core": "0.10.0"
   },
   "peerDependencies": {
-    "@elysiumjs/core": "^0.8.0"
+    "@elysiumjs/core": "^0.10.0"
   }
 }

package/index.ts

@@ -1,15 +0,0 @@
-// Copyright (c) 2025-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-export * from './src/index';

package/src/decorators/logged.ts

@@ -1,86 +0,0 @@
-// Copyright (c) 2026-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import type { LoggerInterface } from '@elysiumjs/core';
-import type { LogLevel } from '../types';
-
-import { ConsoleLogger } from '@elysiumjs/core';
-
-export interface LoggedOptions {
-	level?: LogLevel;
-	includeArgs?: boolean;
-	includeResult?: boolean;
-	includeTiming?: boolean;
-}
-
-/**
- * Decorator that logs method entry/exit with optional timing.
- *
- * Logger is resolved at CALL TIME (not decorator definition time)
- * to avoid capturing a stale logger reference.
- *
- * @author Axel Nana <axel.nana@workbud.com>
- */
-export function Logged(options: LoggedOptions = {}): MethodDecorator {
-	return function (
-		target: object,
-		propertyKey: string | symbol,
-		descriptor: TypedPropertyDescriptor<any>
-	) {
-		const original = descriptor.value;
-		const methodName = `${target.constructor.name}.${String(propertyKey)}`;
-
-		descriptor.value = async function (...args: any[]) {
-			const logger: LoggerInterface = (this as any).logger ?? getServiceLogger();
-
-			const startTime = Date.now();
-
-			if (options.includeArgs) {
-				logger.debug(`[${methodName}] Entry`, { args });
-			}
-
-			try {
-				const result = await original.apply(this, args);
-
-				if (options.includeResult || options.includeTiming) {
-					const duration = Date.now() - startTime;
-					logger[options.level ?? 'debug'](`[${methodName}] Exit`, {
-						...(options.includeResult && { result }),
-						...(options.includeTiming && { duration: `${duration}ms` })
-					});
-				}
-
-				return result;
-			} catch (error) {
-				const duration = Date.now() - startTime;
-				logger.error(`[${methodName}] Error`, {
-					error: error instanceof Error ? error.message : error,
-					duration: `${duration}ms`
-				});
-				throw error;
-			}
-		};
-
-		return descriptor;
-	};
-}
-
-function getServiceLogger(): LoggerInterface {
-	try {
-		const { Service } = require('@elysiumjs/core');
-		return Service.get('logger') ?? new ConsoleLogger();
-	} catch {
-		return new ConsoleLogger();
-	}
-}

package/src/hermes.module.ts

@@ -1,37 +0,0 @@
-// Copyright (c) 2026-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import { Module } from '@elysiumjs/core';
-
-import { HermesLogger } from './services/logger.service';
-import { DEFAULT_CONFIG, type HermesConfig } from './types';
-
-/**
- * Provides the {@link HermesLogger} as the global services `HermesLogger` and `logger`
- * (the same instance), built from the module config.
- * @author Axel Nana <axel.nana@workbud.com>
- */
-@Module.register<HermesConfig>({
-	services: (config) => [
-		{ name: HermesLogger.name, global: true, factory: () => new HermesLogger(config) },
-		{
-			name: 'logger',
-			global: true,
-			factory: (_config: unknown, get: <T>(name: string) => T) => get<HermesLogger>(HermesLogger.name)
-		}
-	]
-})
-export class HermesModule extends Module.configurable<HermesConfig>({
-	defaults: { ...DEFAULT_CONFIG }
-}) {}

package/src/index.ts

@@ -1,21 +0,0 @@
-// Copyright (c) 2026-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-export { HermesModule } from './hermes.module';
-export { HermesLogger } from './services/logger.service';
-export { HttpTransport } from './transports/http.transport';
-export type { HttpTransportOptions } from './transports/http.transport';
-export { Logged } from './decorators/logged';
-export type { LoggedOptions } from './decorators/logged';
-export type { HermesConfig, LogLevel, LogFormat, TransportConfig } from './types';

package/src/services/logger.service.ts

@@ -1,98 +0,0 @@
-// Copyright (c) 2026-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-import type { LoggerInterface } from '@elysiumjs/core';
-import type { Logger as PinoLogger } from 'pino';
-import type { HermesConfig } from '../types';
-
-import { Service } from '@elysiumjs/core';
-import pino from 'pino';
-
-import { DEFAULT_CONFIG } from '../types';
-
-/**
- * Production-ready logger implementation wrapping Pino.
- * Implements `LoggerInterface` from `@elysiumjs/core`.
- *
- * @author Axel Nana <axel.nana@workbud.com>
- */
-export class HermesLogger implements LoggerInterface {
-	private pino: PinoLogger;
-	private config: HermesConfig;
-
-	public static make(name: string): HermesLogger {
-		return Service.get(HermesLogger)?.child({ name }) ?? new HermesLogger({ name });
-	}
-
-	constructor(config: Partial<HermesConfig> = {}) {
-		this.config = { ...DEFAULT_CONFIG, ...config };
-		this.pino = this.createPinoInstance();
-	}
-
-	private createPinoInstance(): PinoLogger {
-		const options: pino.LoggerOptions = {
-			level: this.config.level,
-			name: this.config.name
-		};
-
-		if (this.config.format === 'pretty') {
-			return pino(options, pino.transport({ target: 'pino-pretty' }));
-		}
-
-		return pino(options);
-	}
-
-	public trace(msg: string, ctx?: Record<string, unknown>): void {
-		this.pino.trace(ctx ?? {}, msg);
-	}
-
-	public debug(msg: string, ctx?: Record<string, unknown>): void {
-		this.pino.debug(ctx ?? {}, msg);
-	}
-
-	public info(msg: string, ctx?: Record<string, unknown>): void {
-		this.pino.info(ctx ?? {}, msg);
-	}
-
-	public warn(msg: string, ctx?: Record<string, unknown>): void {
-		this.pino.warn(ctx ?? {}, msg);
-	}
-
-	public error(msg: string, ctx?: Record<string, unknown>): void {
-		this.pino.error(ctx ?? {}, msg);
-	}
-
-	public fatal(msg: string, ctx?: Record<string, unknown>): void {
-		this.pino.fatal(ctx ?? {}, msg);
-	}
-
-	/**
-	 * Flushes buffered log lines of the underlying transport, when it supports it.
-	 * @author Axel Nana <axel.nana@workbud.com>
-	 */
-	public flush(): void {
-		this.pino.flush?.();
-	}
-
-	/** Flushes on shutdown. Only called for a logger the container built. */
-	public onDestroy(): void {
-		this.flush();
-	}
-
-	public child(ctx: Record<string, unknown>): HermesLogger {
-		const child = Object.create(this) as HermesLogger;
-		child.pino = this.pino.child(ctx);
-		return child;
-	}
-}

package/src/transports/http.transport.ts

@@ -1,79 +0,0 @@
-// Copyright (c) 2026-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-export interface HttpTransportOptions {
-	url: string;
-	headers?: Record<string, string>;
-	batchSize?: number;
-	flushInterval?: number;
-	maxBufferSize?: number;
-}
-
-/**
- * HTTP transport for batching and sending logs to a remote endpoint.
- *
- * @author Axel Nana <axel.nana@workbud.com>
- */
-export class HttpTransport {
-	private buffer: string[] = [];
-	private flushTimer?: ReturnType<typeof setInterval>;
-	private maxBufferSize: number;
-
-	constructor(private options: HttpTransportOptions) {
-		this.options.batchSize ??= 100;
-		this.options.flushInterval ??= 5000;
-		this.maxBufferSize = this.options.maxBufferSize ?? 10_000;
-
-		this.flushTimer = setInterval(() => this.flush(), this.options.flushInterval);
-	}
-
-	public write(formatted: string): void {
-		if (this.buffer.length >= this.maxBufferSize) {
-			this.buffer.shift();
-		}
-
-		this.buffer.push(formatted);
-
-		if (this.buffer.length >= this.options.batchSize!) {
-			this.flush();
-		}
-	}
-
-	public async flush(): Promise<void> {
-		if (this.buffer.length === 0) return;
-
-		const batch = this.buffer.splice(0);
-
-		try {
-			await fetch(this.options.url, {
-				method: 'POST',
-				headers: {
-					'Content-Type': 'application/json',
-					...this.options.headers
-				},
-				body: JSON.stringify({ logs: batch })
-			});
-		} catch {
-			const space = this.maxBufferSize - this.buffer.length;
-			if (space > 0) {
-				this.buffer.unshift(...batch.slice(0, space));
-			}
-		}
-	}
-
-	public async close(): Promise<void> {
-		if (this.flushTimer) clearInterval(this.flushTimer);
-		await this.flush();
-	}
-}

package/src/types.ts

@@ -1,34 +0,0 @@
-// Copyright (c) 2026-present Workbud Technologies Inc. All rights reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
-
-export type LogFormat = 'json' | 'pretty' | 'logfmt';
-
-export interface TransportConfig {
-	type: 'console' | 'file' | 'http';
-	options?: Record<string, unknown>;
-}
-
-export interface HermesConfig {
-	name?: string;
-	level: LogLevel;
-	format: LogFormat;
-	transports?: TransportConfig[];
-}
-
-export const DEFAULT_CONFIG: HermesConfig = {
-	level: 'info',
-	format: 'json'
-};