@crimsonsunset/jsg-logger 1.8.2 → 1.8.3

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to the JSG Logger project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.8.3] - 2026-03-28 🔌 **addTransport() API**
+
+### Added
+- **`JSGLogger.addTransport(transport)`** — new static method to register a transport on the running singleton without reinitializing. Bypasses the reinit guard entirely. Idempotent (calling with the same instance twice is a no-op). Also exposed on the default export as `logger.addTransport()`.
+
+### Fixed
+- **Transport registration after module-level init** — `jsg-logger` initializes itself with default config at module evaluation time (line 1042). This caused the reinit guard introduced in 1.8.2 to silently drop transports passed to `getInstanceSync(options)` in e.g. Next.js `instrumentation.ts`, because `initialized` was already `true`. `addTransport()` is the correct API for post-init transport registration — it pushes directly to `_instance.transports` and is unaffected by the reinit guard.
+
+### Migration
+Replace `getInstanceSync({ ...config, transports: [myTransport] })` in post-init contexts (e.g. Next.js `register()`) with:
+```ts
+JSGLogger.addTransport(myTransport);
+```
+
 ## [1.8.2] - 2026-03-27 🛡️ **Reinit Guard + configure() API**
 
 ### Added

package/index.d.ts

@@ -195,6 +195,12 @@ export interface LoggerInstanceType {
    */
   getInstanceSync?: (config?: JSGLoggerConfig) => LoggerInstanceType;
 
+  /**
+   * Add a transport to the running singleton without reinitializing. Idempotent.
+   * @param transport - LogTransport instance to register
+   */
+  addTransport?: (transport: LogTransport) => void;
+
   /**
    * Static performance logging utility
    */
@@ -225,6 +231,21 @@ export interface JSGLogger {
    */
   getInstanceSync(config?: JSGLoggerConfig): LoggerInstanceType;
 
+  /**
+   * Add a transport to the running singleton without reinitializing.
+   * Safe to call even after the singleton was initialized by module-level code or a
+   * third-party library — bypasses the reinit guard entirely. Idempotent.
+   *
+   * @param transport - LogTransport instance to register
+   *
+   * @example
+   * ```ts
+   * // instrumentation.ts — runs after module-level init, still registers transport cleanly
+   * JSGLogger.addTransport(new PostHogServerTransport(posthogServer, { level: 'warn' }));
+   * ```
+   */
+  addTransport(transport: LogTransport): void;
+
   /**
    * Static performance logging utility
    * @param label - Performance label

package/index.js

@@ -1019,6 +1019,29 @@ class JSGLogger {
         return JSGLogger._enhancedLoggers;
     }
 
+    /**
+     * Add a transport to the running singleton without reinitializing.
+     * Safe to call even if the singleton was already initialized by module-level code
+     * or a third-party library — bypasses the reinit guard entirely.
+     * Idempotent: calling with the same transport instance twice is a no-op.
+     * @param {Object} transport - LogTransport instance to register
+     * @returns {void}
+     */
+    static addTransport(transport) {
+        if (!transport || typeof transport.send !== 'function') {
+            metaWarn('[JSGLogger] addTransport() received an invalid transport — must have a send() method');
+            return;
+        }
+        if (!JSGLogger._instance) {
+            metaWarn('[JSGLogger] addTransport() called before any initialization — initializing with defaults first');
+            JSGLogger._instance = new JSGLogger();
+            JSGLogger._enhancedLoggers = JSGLogger._instance.initSync({});
+        }
+        if (!JSGLogger._instance.transports.includes(transport)) {
+            JSGLogger._instance.transports.push(transport);
+        }
+    }
+
     /**
      * Get singleton controls without triggering initialization
      * Checks window.JSG_Logger first to ensure singleton works across separate bundles
@@ -1052,6 +1075,7 @@ if (isBrowser() && typeof window !== 'undefined') {
 enhancedLoggers.getInstance = JSGLogger.getInstance;
 enhancedLoggers.getInstanceSync = JSGLogger.getInstanceSync;
 enhancedLoggers.configure = JSGLogger.configure.bind(JSGLogger);
+enhancedLoggers.addTransport = JSGLogger.addTransport.bind(JSGLogger);
 enhancedLoggers.logPerformance = JSGLogger.logPerformance;
 enhancedLoggers.JSGLogger = JSGLogger;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crimsonsunset/jsg-logger",
-  "version": "1.8.2",
+  "version": "1.8.3",
   "type": "module",
   "description": "Multi-environment logger with smart detection, file-level overrides, and beautiful console formatting. Test it live: https://logger.joesangiorgio.com/",
   "main": "index.js",