@crimsonsunset/jsg-logger 1.8.4 → 1.8.5

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.5] - 2026-03-28 🏷️ **configure() TypeScript types**
+
+### Added
+- **`configure()` TypeScript types** — `JSGLogger.configure(partialConfig?)` is now typed in `index.d.ts`. The method already existed in the JS implementation (1.8.4) but was missing from the type definitions, causing `any`-cast workarounds in consuming projects.
+
+### Migration
+Replace `JSGLogger.getInstanceSync(loggerConfig)` in post-init contexts (e.g. Next.js `instrumentation-client.ts`) with:
+```ts
+JSGLogger.configure(loggerConfig);
+```
+This merges config into the running singleton without triggering the reinit guard or wiping registered transports.
+
+---
+
 ## [1.8.3] - 2026-03-28 🔌 **addTransport() API**
 
 ### Added

package/index.d.ts

@@ -231,6 +231,25 @@ export interface JSGLogger {
    */
   getInstanceSync(config?: JSGLoggerConfig): LoggerInstanceType;
 
+  /**
+   * Update config on an already-initialized singleton without reinitializing.
+   * Merges the provided partial config into the running instance, preserving all
+   * registered transports. Use this instead of getInstanceSync(config) when the
+   * singleton may already be initialized (e.g. by module-level auto-init).
+   *
+   * If the singleton has not yet been initialized, behaves like getInstanceSync(config).
+   *
+   * @param partialConfig - Partial config to merge into the running instance
+   * @returns The enhanced logger exports with controls API
+   *
+   * @example
+   * ```ts
+   * // instrumentation-client.ts — configure project name + display before anything uses the logger
+   * JSGLogger.configure({ projectName: 'My App', display: { timestamp: true } });
+   * ```
+   */
+  configure(partialConfig?: Partial<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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crimsonsunset/jsg-logger",
-  "version": "1.8.4",
+  "version": "1.8.5",
   "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",