@byline/core 0.9.3

package/dist/lib/errors.d.ts

@@ -0,0 +1,98 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ *
+ * Structured error handling for Byline CMS.
+ *
+ * Follows the Modulus CoreError pattern: every error carries a machine-readable
+ * `code`, optional `details` (included in API responses), and optional `logExtra`
+ * (included only in logs). The `.log(logger)` method logs the error exactly once
+ * and then sets the log level to 'silent' to prevent double-logging up the stack.
+ *
+ * Errors are created via factory functions produced by `createErrorType()`:
+ *
+ *   throw ERR_NOT_FOUND({
+ *     message: 'document not found',
+ *     details: { documentId },
+ *   }).log(logger)
+ */
+import type { BylineLogger, LogLevel, LogLevelWithSilent } from './logger.js';
+export type ErrorReport = {
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+};
+export type BylineErrorOptions = {
+    /** Short description of the error, for internal consumption. */
+    message: string;
+    /** Optional underlying cause (e.g. a 3rd-party error). */
+    cause?: unknown;
+    /** Details to be included in the error report (API responses) AND logs. */
+    details?: Record<string, unknown>;
+    /** If true, stack trace will be captured. */
+    captureStack?: boolean;
+    /** Log level for this error. Defaults to 'error'. */
+    logLevel?: LogLevelWithSilent;
+    /** Extra data to include only in logs (never in API responses). */
+    logExtra?: Record<string, unknown>;
+};
+export declare class BylineError extends Error {
+    /** Machine-readable error code (e.g. 'ERR_NOT_FOUND'). */
+    readonly code: string;
+    /** Additional details included in both error reports and logs. */
+    readonly details?: Record<string, unknown>;
+    /** Extra values included only when logging this error. */
+    readonly logExtra?: Record<string, unknown>;
+    /**
+     * Level at which this error should be logged when caught. Will always be
+     * 'silent' after `.log()` has been called.
+     */
+    private logLevel;
+    constructor(code: string, options: BylineErrorOptions, errorConstructor?: any);
+    /**
+     * Log this error via the given logger. Sets `logLevel` to 'silent' after
+     * the first call to prevent double-logging when the error is re-thrown.
+     *
+     * Returns `this` for chaining: `throw ERR_X({ ... }).log(logger)`
+     */
+    log(logger: BylineLogger): typeof this;
+    /**
+     * Serialize this error for API responses. Includes `code`, `message`,
+     * and `details` but deliberately excludes `logExtra`.
+     */
+    report(): ErrorReport;
+}
+/**
+ * Create a reusable error factory for a given error code and default log level.
+ *
+ * ```ts
+ * export const ERR_NOT_FOUND = createErrorType('ERR_NOT_FOUND', 'warn')
+ *
+ * throw ERR_NOT_FOUND({ message: 'document not found' }).log(logger)
+ * ```
+ */
+export declare const createErrorType: (code: string, logLevel?: LogLevel) => (opts: BylineErrorOptions, errorConstructor?: any) => BylineError;
+export declare const ErrorCodes: {
+    readonly UNHANDLED: "ERR_UNHANDLED";
+    readonly NOT_FOUND: "ERR_NOT_FOUND";
+    readonly CONFLICT: "ERR_CONFLICT";
+    readonly VALIDATION: "ERR_VALIDATION";
+    readonly INVALID_TRANSITION: "ERR_INVALID_TRANSITION";
+    readonly PATCH_FAILED: "ERR_PATCH_FAILED";
+    readonly DATABASE: "ERR_DATABASE";
+    readonly STORAGE: "ERR_STORAGE";
+    readonly READ_BUDGET_EXCEEDED: "ERR_READ_BUDGET_EXCEEDED";
+};
+export declare const ERR_UNHANDLED: (opts: BylineErrorOptions, errorConstructor?: any) => BylineError;
+export declare const ERR_NOT_FOUND: (opts: BylineErrorOptions, errorConstructor?: any) => BylineError;
+export declare const ERR_CONFLICT: (opts: BylineErrorOptions, errorConstructor?: any) => BylineError;
+export declare const ERR_VALIDATION: (opts: BylineErrorOptions, errorConstructor?: any) => BylineError;
+export declare const ERR_INVALID_TRANSITION: (opts: BylineErrorOptions, errorConstructor?: any) => BylineError;
+export declare const ERR_PATCH_FAILED: (opts: BylineErrorOptions, errorConstructor?: any) => BylineError;
+export declare const ERR_DATABASE: (opts: BylineErrorOptions, errorConstructor?: any) => BylineError;
+export declare const ERR_STORAGE: (opts: BylineErrorOptions, errorConstructor?: any) => BylineError;
+export declare const ERR_READ_BUDGET_EXCEEDED: (opts: BylineErrorOptions, errorConstructor?: any) => BylineError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAM7E,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,6CAA6C;IAC7C,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,CAAA;AAMD,qBAAa,WAAY,SAAQ,KAAK;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE1C,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE3C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAoB;gBAExB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,EAAE,GAAG;IAiC7E;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,IAAI;IAQtC;;;OAGG;IACH,MAAM,IAAI,WAAW;CAOtB;AAMD;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,WAAU,QAAkB,YACpD,kBAAkB,qBAAqB,GAAG,gBAG/D,CAAA;AAMD,eAAO,MAAM,UAAU;;;;;;;;;;CAUb,CAAA;AAMV,eAAO,MAAM,aAAa,SAzBJ,kBAAkB,qBAAqB,GAAG,gBAyBE,CAAA;AAClE,eAAO,MAAM,aAAa,SA1BJ,kBAAkB,qBAAqB,GAAG,gBA0BU,CAAA;AAC1E,eAAO,MAAM,YAAY,SA3BH,kBAAkB,qBAAqB,GAAG,gBA2BQ,CAAA;AACxE,eAAO,MAAM,cAAc,SA5BL,kBAAkB,qBAAqB,GAAG,gBA4BY,CAAA;AAC5E,eAAO,MAAM,sBAAsB,SA7Bb,kBAAkB,qBAAqB,GAAG,gBA6B4B,CAAA;AAC5F,eAAO,MAAM,gBAAgB,SA9BP,kBAAkB,qBAAqB,GAAG,gBA8BQ,CAAA;AACxE,eAAO,MAAM,YAAY,SA/BH,kBAAkB,qBAAqB,GAAG,gBA+BA,CAAA;AAChE,eAAO,MAAM,WAAW,SAhCF,kBAAkB,qBAAqB,GAAG,gBAgCF,CAAA;AAC9D,eAAO,MAAM,wBAAwB,SAjCf,kBAAkB,qBAAqB,GAAG,gBAiCwB,CAAA"}

package/dist/lib/errors.js

@@ -0,0 +1,134 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ *
+ * Structured error handling for Byline CMS.
+ *
+ * Follows the Modulus CoreError pattern: every error carries a machine-readable
+ * `code`, optional `details` (included in API responses), and optional `logExtra`
+ * (included only in logs). The `.log(logger)` method logs the error exactly once
+ * and then sets the log level to 'silent' to prevent double-logging up the stack.
+ *
+ * Errors are created via factory functions produced by `createErrorType()`:
+ *
+ *   throw ERR_NOT_FOUND({
+ *     message: 'document not found',
+ *     details: { documentId },
+ *   }).log(logger)
+ */
+// ---------------------------------------------------------------------------
+// BylineError base class
+// ---------------------------------------------------------------------------
+export class BylineError extends Error {
+    /** Machine-readable error code (e.g. 'ERR_NOT_FOUND'). */
+    code;
+    /** Additional details included in both error reports and logs. */
+    details;
+    /** Extra values included only when logging this error. */
+    logExtra;
+    /**
+     * Level at which this error should be logged when caught. Will always be
+     * 'silent' after `.log()` has been called.
+     */
+    logLevel;
+    constructor(code, options, errorConstructor) {
+        const { message, cause, details, captureStack = false, logLevel = 'error', logExtra } = options;
+        // If Error.captureStackTrace is available, skip the default stack trace
+        // generation (which would happen during the call to super()), and then
+        // explicitly capture a stack trace _if_ captureStack is true _and_
+        // logLevel is not 'silent'.
+        if ('captureStackTrace' in Error) {
+            const { stackTraceLimit } = Error;
+            Error.stackTraceLimit = 0;
+            super(message, { cause });
+            Error.stackTraceLimit = stackTraceLimit;
+            if (captureStack && logLevel !== 'silent') {
+                Error.captureStackTrace(this, errorConstructor ?? this.constructor);
+            }
+        }
+        else {
+            super(message, { cause });
+        }
+        this.code = code;
+        this.details = details;
+        this.logExtra = logExtra;
+        this.logLevel = logLevel;
+        // Mark these properties as non-enumerable so Pino doesn't serialize them
+        // as part of the error object itself.
+        Object.defineProperties(this, {
+            details: { enumerable: false },
+            logLevel: { enumerable: false },
+            logExtra: { enumerable: false },
+        });
+    }
+    /**
+     * Log this error via the given logger. Sets `logLevel` to 'silent' after
+     * the first call to prevent double-logging when the error is re-thrown.
+     *
+     * Returns `this` for chaining: `throw ERR_X({ ... }).log(logger)`
+     */
+    log(logger) {
+        if (this.logLevel !== 'silent') {
+            logger.log(this.logLevel, { err: this, ...this.details, ...this.logExtra });
+            this.logLevel = 'silent';
+        }
+        return this;
+    }
+    /**
+     * Serialize this error for API responses. Includes `code`, `message`,
+     * and `details` but deliberately excludes `logExtra`.
+     */
+    report() {
+        return {
+            code: this.code,
+            message: this.message,
+            details: this.details,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a reusable error factory for a given error code and default log level.
+ *
+ * ```ts
+ * export const ERR_NOT_FOUND = createErrorType('ERR_NOT_FOUND', 'warn')
+ *
+ * throw ERR_NOT_FOUND({ message: 'document not found' }).log(logger)
+ * ```
+ */
+export const createErrorType = (code, logLevel = 'error') => {
+    const cons = (opts, errorConstructor) => new BylineError(code, { logLevel, ...opts }, errorConstructor ?? cons);
+    return cons;
+};
+// ---------------------------------------------------------------------------
+// Error codes
+// ---------------------------------------------------------------------------
+export const ErrorCodes = {
+    UNHANDLED: 'ERR_UNHANDLED',
+    NOT_FOUND: 'ERR_NOT_FOUND',
+    CONFLICT: 'ERR_CONFLICT',
+    VALIDATION: 'ERR_VALIDATION',
+    INVALID_TRANSITION: 'ERR_INVALID_TRANSITION',
+    PATCH_FAILED: 'ERR_PATCH_FAILED',
+    DATABASE: 'ERR_DATABASE',
+    STORAGE: 'ERR_STORAGE',
+    READ_BUDGET_EXCEEDED: 'ERR_READ_BUDGET_EXCEEDED',
+};
+// ---------------------------------------------------------------------------
+// Pre-instantiated factories
+// ---------------------------------------------------------------------------
+export const ERR_UNHANDLED = createErrorType(ErrorCodes.UNHANDLED);
+export const ERR_NOT_FOUND = createErrorType(ErrorCodes.NOT_FOUND, 'warn');
+export const ERR_CONFLICT = createErrorType(ErrorCodes.CONFLICT, 'warn');
+export const ERR_VALIDATION = createErrorType(ErrorCodes.VALIDATION, 'warn');
+export const ERR_INVALID_TRANSITION = createErrorType(ErrorCodes.INVALID_TRANSITION, 'warn');
+export const ERR_PATCH_FAILED = createErrorType(ErrorCodes.PATCH_FAILED);
+export const ERR_DATABASE = createErrorType(ErrorCodes.DATABASE);
+export const ERR_STORAGE = createErrorType(ErrorCodes.STORAGE);
+export const ERR_READ_BUDGET_EXCEEDED = createErrorType(ErrorCodes.READ_BUDGET_EXCEEDED);
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

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

package/dist/lib/logger.d.ts

@@ -0,0 +1,62 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ *
+ * Structured logging for Byline CMS.
+ *
+ * ## Architecture
+ *
+ * This module defines two layers:
+ *
+ * 1. **Transport-agnostic interface** — `BylineLogger`, `LogLevel`, `LogData`,
+ *    `LogContext`, `withLogContext`. These have zero dependency on any logging
+ *    library. All consumer code (services, db adapters, route handlers, errors)
+ *    depends only on this layer.
+ *
+ * 2. **Pino transport** — `createBylineLogger` + `BylineLoggerImpl`. This is
+ *    the default implementation registered in the DI graph via `core.ts`. To
+ *    swap transports (e.g. for Cloudflare Workers or edge runtimes), provide a
+ *    different factory that produces a `BylineLogger` and register it in the
+ *    Registry instead of `createBylineLogger`.
+ *
+ * Context propagation uses `AsyncLocalStorage` (Node/Bun/Deno/Workers) with a
+ * no-op fallback for environments that don't support it (browser bundles).
+ * When TC39 `AsyncContext` reaches Stage 3+, this can be swapped transparently.
+ *
+ * Primary access is via the typed Registry (see core.ts). A globalThis
+ * singleton (defineLogger / getLogger) provides an escape hatch for code
+ * outside the DI graph (e.g. API route handlers, db adapters).
+ */
+import type { Logger as PinoLogger } from 'pino';
+export interface LogContext {
+    domain?: string;
+    module?: string;
+    class?: string;
+    function?: string;
+}
+export declare const getLogContext: () => LogContext;
+export declare const withLogContext: <T>(context: LogContext, fn: () => T) => T;
+export type LogLevel = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
+export type LogLevelWithSilent = LogLevel | 'silent';
+export type LogData = Record<string, unknown>;
+type LogFnArgs = [message: string, ...args: unknown[]] | [data: LogData, message?: string, ...args: unknown[]];
+export interface BylineLogger {
+    log(level: LogLevel, ...args: LogFnArgs): void;
+    fatal(...args: LogFnArgs): void;
+    error(...args: LogFnArgs): void;
+    warn(...args: LogFnArgs): void;
+    info(...args: LogFnArgs): void;
+    debug(...args: LogFnArgs): void;
+    trace(...args: LogFnArgs): void;
+    silent(...args: LogFnArgs): void;
+}
+export declare const createBylineLogger: (deps: {
+    pinoLogger: PinoLogger;
+}) => BylineLogger;
+export declare function defineLogger(logger: BylineLogger): void;
+export declare function getLogger(): BylineLogger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/lib/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAA;AAMhD,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AA4BD,eAAO,MAAM,aAAa,kBAAyC,CAAA;AACnE,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,SAAS,UAAU,EAAE,IAAI,MAAM,CAAC,KAAG,CAEpE,CAAA;AAMD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAC9E,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEpD,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE7C,KAAK,SAAS,GACV,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,GACrC,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAA;AAEzD,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC9C,KAAK,CAAC,GAAG,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC9B,IAAI,CAAC,GAAG,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC9B,KAAK,CAAC,GAAG,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC/B,MAAM,CAAC,GAAG,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;CACjC;AAWD,eAAO,MAAM,kBAAkB,GAAI,MAAM;IAAE,UAAU,EAAE,UAAU,CAAA;CAAE,KAAG,YAErE,CAAA;AAyDD,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,QAEhD;AAED,wBAAgB,SAAS,IAAI,YAAY,CAQxC"}

package/dist/lib/logger.js

@@ -0,0 +1,120 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ *
+ * Structured logging for Byline CMS.
+ *
+ * ## Architecture
+ *
+ * This module defines two layers:
+ *
+ * 1. **Transport-agnostic interface** — `BylineLogger`, `LogLevel`, `LogData`,
+ *    `LogContext`, `withLogContext`. These have zero dependency on any logging
+ *    library. All consumer code (services, db adapters, route handlers, errors)
+ *    depends only on this layer.
+ *
+ * 2. **Pino transport** — `createBylineLogger` + `BylineLoggerImpl`. This is
+ *    the default implementation registered in the DI graph via `core.ts`. To
+ *    swap transports (e.g. for Cloudflare Workers or edge runtimes), provide a
+ *    different factory that produces a `BylineLogger` and register it in the
+ *    Registry instead of `createBylineLogger`.
+ *
+ * Context propagation uses `AsyncLocalStorage` (Node/Bun/Deno/Workers) with a
+ * no-op fallback for environments that don't support it (browser bundles).
+ * When TC39 `AsyncContext` reaches Stage 3+, this can be swapped transparently.
+ *
+ * Primary access is via the typed Registry (see core.ts). A globalThis
+ * singleton (defineLogger / getLogger) provides an escape hatch for code
+ * outside the DI graph (e.g. API route handlers, db adapters).
+ */
+const noopStore = {
+    getStore: () => undefined,
+    run: (_store, fn) => fn(),
+};
+let logContextStore;
+try {
+    const { AsyncLocalStorage } = await import('node:async_hooks');
+    logContextStore = new AsyncLocalStorage();
+}
+catch {
+    logContextStore = noopStore;
+}
+export const getLogContext = () => logContextStore.getStore() ?? {};
+export const withLogContext = (context, fn) => {
+    return logContextStore.run({ ...getLogContext(), ...context }, fn);
+};
+// ---------------------------------------------------------------------------
+// Pino transport (swappable — see module docblock)
+//
+// Everything below this line depends on pino. To use a different logging
+// backend, replace `createBylineLogger` with a factory that accepts your
+// transport and returns a `BylineLogger`. Register it in the DI graph
+// (core.ts) instead of the default.
+// ---------------------------------------------------------------------------
+export const createBylineLogger = (deps) => {
+    return new BylineLoggerImpl(deps.pinoLogger);
+};
+class BylineLoggerImpl {
+    pinoLogger;
+    constructor(pinoLogger) {
+        this.pinoLogger = pinoLogger;
+    }
+    log(level, ...[first, second, ...rest]) {
+        if (typeof first === 'string') {
+            // args have shape [string, ...unknown[]]
+            this.pinoLogger[level](getLogContext(), first, second, ...rest);
+        }
+        else {
+            // Treat err field specially if present. Other values, if present, go
+            // into extra.
+            const { err, ...data } = first;
+            const extra = Object.keys(data).length > 0 ? data : undefined;
+            if (typeof second === 'string') {
+                // args have shape [LogData, string, ...unknown[]]
+                this.pinoLogger[level]({ ...getLogContext(), extra, err }, second, ...rest);
+            }
+            else {
+                // args have shape [LogData]
+                this.pinoLogger[level]({ ...getLogContext(), extra, err });
+            }
+        }
+    }
+    fatal(...args) {
+        this.log('fatal', ...args);
+    }
+    error(...args) {
+        this.log('error', ...args);
+    }
+    warn(...args) {
+        this.log('warn', ...args);
+    }
+    info(...args) {
+        this.log('info', ...args);
+    }
+    debug(...args) {
+        this.log('debug', ...args);
+    }
+    trace(...args) {
+        this.log('trace', ...args);
+    }
+    silent(..._args) { }
+}
+// ---------------------------------------------------------------------------
+// Global escape hatch — same pattern as defineServerConfig / getServerConfig
+// ---------------------------------------------------------------------------
+const BYLINE_LOGGER = Symbol.for('__byline_logger__');
+export function defineLogger(logger) {
+    ;
+    globalThis[BYLINE_LOGGER] = logger;
+}
+export function getLogger() {
+    const logger = globalThis[BYLINE_LOGGER];
+    if (logger == null) {
+        throw new Error('Byline logger has not been initialized. Ensure initBylineCore() has been called.');
+    }
+    return logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

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

package/dist/lib/registry.d.ts

@@ -0,0 +1,65 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ *
+ * Typed dependency injection registry. Ported from the Modulus project
+ * (https://github.com/infonomic/modulus) with permission.
+ *
+ * Provides compile-time validation of dependency graphs via TypeScript
+ * conditional types. Services declare their dependencies via constructor
+ * or factory signatures; the registry validates that all requirements
+ * are satisfied before composition.
+ */
+type Token = string | symbol;
+type Normalize<T> = T extends object ? {
+    [P in keyof T]: T[P];
+} : never;
+type Extend<TSource extends object, TName extends Token, TValue> = Normalize<Omit<TSource, TName> & {
+    [K in TName]: TValue;
+}>;
+type IsNever<T> = [T] extends [never] ? true : false;
+type IsMergeable<T1, T2> = {
+    [K in keyof T1 & keyof T2]: IsNever<T1[K] & T2[K]> extends true ? false : true;
+} extends Record<keyof T1 & keyof T2, true> ? true : false;
+type ValidateDeps<TRequires, TProvides, TName, TDeps> = TName extends keyof TRequires ? {
+    error: 'Name conflict with prior requirement';
+    name: TName;
+    requirements: TRequires;
+} : TName extends keyof TProvides ? {
+    error: 'Duplicate provider name';
+    name: TName;
+} : Pick<TProvides, keyof TProvides & keyof TDeps> extends Pick<TDeps, keyof TProvides & keyof TDeps> ? IsMergeable<Pick<Omit<TDeps, keyof TProvides>, Extract<keyof TRequires, keyof Omit<TDeps, keyof TProvides>>>, Pick<TRequires, Extract<keyof TRequires, keyof Omit<TDeps, keyof TProvides>>>> extends true ? true : {
+    error: 'Dependency type conflicts with required type';
+    deps: TDeps;
+    requirements: TRequires;
+} : {
+    error: 'Dependency type conflicts with provided type';
+    deps: TDeps;
+    provides: TProvides;
+};
+export declare class Registry<TRequires extends Record<Token, unknown> = {}, TProvides extends Record<Token, unknown> = {}> {
+    private readonly providers;
+    addClass<Name extends Token, TClass extends new (deps: any) => any, TValidation extends ValidateDeps<TRequires, TProvides, Name, ConstructorParameters<TClass>[0]> = ValidateDeps<TRequires, TProvides, Name, ConstructorParameters<TClass>[0]>>(name: Name, value: TValidation extends true ? TClass : TValidation): Registry<Normalize<TRequires & Omit<ConstructorParameters<TClass>[0], keyof TProvides>>, Extend<TProvides, Name, InstanceType<TClass>>>;
+    addFactory<Name extends Token, TFactory extends (deps: any) => any, TValidation extends ValidateDeps<TRequires, TProvides, Name, Parameters<TFactory>[0]> = ValidateDeps<TRequires, TProvides, Name, Parameters<TFactory>[0]>>(name: Name, value: TValidation extends true ? TFactory : TValidation): Registry<Normalize<TRequires & Omit<Parameters<TFactory>[0], keyof TProvides>>, Extend<TProvides, Name, ReturnType<TFactory>>>;
+    addValue<Name extends Token, TValue, TValidation extends ValidateDeps<TRequires, TProvides, Name, {}> = ValidateDeps<TRequires, TProvides, Name, {}>>(name: Name, value: TValidation extends true ? TValue : TValidation): Registry<TRequires, Extend<TProvides, Name, TValue>>;
+    addNested<Name extends Token, TNested extends Registry<any, any>, TValidation extends ValidateDeps<TRequires, TProvides, Name, TNested extends Registry<infer TNestedRequired, any> ? TNestedRequired : never> = ValidateDeps<TRequires, TProvides, Name, TNested extends Registry<infer TNestedRequired, any> ? TNestedRequired : never>>(name: Name, nested: TValidation extends true ? TNested : TValidation): TNested extends Registry<infer TNestedRequires, infer TNestedProvides> ? Registry<Normalize<TRequires & Omit<TNestedRequires, keyof TProvides>>, Extend<TProvides, Name, TNestedProvides>> : never;
+    compose(requirements: TRequires): Normalize<TProvides>;
+}
+export declare class AsyncRegistry<TRequires extends Record<Token, unknown> = {}, TProvides extends Record<Token, unknown> = {}> {
+    private readonly providers;
+    addClass<Name extends Token, TClass extends new (deps: any) => any, TValidation extends ValidateDeps<TRequires, TProvides, Name, ConstructorParameters<TClass>[0]> = ValidateDeps<TRequires, TProvides, Name, ConstructorParameters<TClass>[0]>>(name: Name, value: TValidation extends true ? TClass : TValidation): AsyncRegistry<Normalize<TRequires & Omit<ConstructorParameters<TClass>[0], keyof TProvides>>, Extend<TProvides, Name, InstanceType<TClass>>>;
+    addAsyncClass<Name extends Token, TClass extends {
+        create(deps: any): Promise<any>;
+    }, TValidation extends ValidateDeps<TRequires, TProvides, Name, Parameters<TClass['create']>[0]> = ValidateDeps<TRequires, TProvides, Name, Parameters<TClass['create']>[0]>>(name: Name, value: TValidation extends true ? TClass : TValidation): AsyncRegistry<Normalize<TRequires & Omit<Parameters<TClass['create']>[0], keyof TProvides>>, Extend<TProvides, Name, Awaited<ReturnType<TClass['create']>>>>;
+    addFactory<Name extends Token, TFactory extends (deps: any) => any, TValidation extends ValidateDeps<TRequires, TProvides, Name, Parameters<TFactory>[0]> = ValidateDeps<TRequires, TProvides, Name, Parameters<TFactory>[0]>>(name: Name, value: TValidation extends true ? TFactory : TValidation): AsyncRegistry<Normalize<TRequires & Omit<Parameters<TFactory>[0], keyof TProvides>>, Extend<TProvides, Name, Awaited<ReturnType<TFactory>>>>;
+    addValue<Name extends Token, TValue, TValidation extends ValidateDeps<TRequires, TProvides, Name, {}> = ValidateDeps<TRequires, TProvides, Name, {}>>(name: Name, value: TValidation extends true ? TValue : TValidation): AsyncRegistry<TRequires, Extend<TProvides, Name, Awaited<TValue>>>;
+    addNested<Name extends Token, TNested extends Registry<any, any>, TValidation extends ValidateDeps<TRequires, TProvides, Name, TNested extends Registry<infer TNestedRequired, any> ? TNestedRequired : never> = ValidateDeps<TRequires, TProvides, Name, TNested extends Registry<infer TNestedRequired, any> ? TNestedRequired : never>>(name: Name, nested: TValidation extends true ? TNested : TValidation): TNested extends Registry<infer TNestedRequires, infer TNestedProvides> ? AsyncRegistry<Normalize<TRequires & Omit<TNestedRequires, keyof TProvides>>, Extend<TProvides, Name, TNestedProvides>> : never;
+    addNestedAsync<Name extends Token, TNested extends AsyncRegistry<any, any>, TValidation extends ValidateDeps<TRequires, TProvides, Name, TNested extends AsyncRegistry<infer TNestedRequired, any> ? TNestedRequired : never> = ValidateDeps<TRequires, TProvides, Name, TNested extends AsyncRegistry<infer TNestedRequired, any> ? TNestedRequired : never>>(name: Name, nested: TValidation extends true ? TNested : TValidation): TNested extends AsyncRegistry<infer TNestedRequires, infer TNestedProvides> ? AsyncRegistry<Normalize<TRequires & Omit<TNestedRequires, keyof TProvides>>, Extend<TProvides, Name, TNestedProvides>> : never;
+    compose(requirements: TRequires): Promise<Normalize<TProvides>>;
+}
+export type RegisteredServices<TRegistry extends Registry<any, any> | AsyncRegistry<any, any>> = TRegistry extends Registry<any, infer TProvided> ? TProvided : TRegistry extends AsyncRegistry<any, infer TProvided> ? Normalize<TProvided> : never;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/registry.d.ts.map

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