@codeleap/logger 6.8.0 → 7.0.1

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './lib';
+export * from './types';
+export * from './utils';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA;AACrB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA"}

package/dist/lib/Logger.js

@@ -0,0 +1,82 @@
+import { SlackService } from './Slack';
+import { PerformanceService } from './performance';
+/**
+ * Base logger class. Logging methods (`info`, `error`, `warn`, `log`, `debug`, `test`) are stubs
+ * that must be overridden by the consuming app — calling them before providing an implementation
+ * throws. Use {@link createLogger} to produce a concrete instance, then assign it to `logger`.
+ *
+ * `initialize` must be called once before `patchConsole` or any Slack/perf functionality works.
+ */
+export class Logger {
+    isIgnored(args) {
+        if (!Logger.initialized)
+            return false;
+        const ignoreLogs = this.config.Logger.ignoreLogs;
+        return typeof args[0] === 'string' && ignoreLogs.some(w => args.join(' ').includes(w));
+    }
+    /**
+     * Monkey-patches `console.log`, `console.warn`, and `console.error` so that any message
+     * matching an entry in `config.Logger.ignoreLogs` is silently dropped.
+     *
+     * Call this after `initialize`. Patching before initialization has no effect because
+     * `isIgnored` returns `false` until the config is loaded.
+     */
+    patchConsole() {
+        const consoles = ['log', 'warn', 'error'];
+        consoles.forEach(level => {
+            const consoleAny = console;
+            const consoleRef = consoleAny[level].bind(console);
+            consoleAny[level] = (...args) => {
+                if (!this.isIgnored(args))
+                    consoleRef(...args);
+            };
+        });
+    }
+    /**
+     * Bootstraps the logger with app-wide config. Safe to call multiple times — subsequent calls
+     * are no-ops. Also instantiates `slack` and `perf` sub-services, so they are only available
+     * after this method returns.
+     */
+    initialize(config) {
+        if (Logger.initialized)
+            return;
+        this.config = config;
+        this.slack = new SlackService(config);
+        this.perf = new PerformanceService(config);
+        Logger.initialized = true;
+    }
+    /**
+     * Stub — must be overridden. Intended for temporary test logs that should never reach
+     * production; implementations typically no-op in non-dev environments.
+     */
+    test(...args) {
+        throw new Error('Logger: implement the method "test"');
+    }
+    /** Stub — must be overridden. */
+    info(...args) {
+        throw new Error('Logger: implement the method "info"');
+    }
+    /** Stub — must be overridden. */
+    error(...args) {
+        throw new Error('Logger: implement the method "error"');
+    }
+    /** Stub — must be overridden. */
+    warn(...args) {
+        throw new Error('Logger: implement the method "warn"');
+    }
+    /** Stub — must be overridden. */
+    log(...args) {
+        throw new Error('Logger: implement the method "log"');
+    }
+    /** Stub — must be overridden. */
+    debug(...args) {
+        throw new Error('Logger: implement the method "debug"');
+    }
+}
+Logger.initialized = false;
+/**
+ * Shared `Logger` instance. Logging methods throw until the consuming app replaces them via
+ * {@link createLogger} and calls {@link Logger.initialize}.
+ */
+export const logger = new 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":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD;;;;;;GAMG;AACH,MAAM,OAAO,MAAM;IAST,SAAS,CAAC,IAAe;QAC/B,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO,KAAK,CAAA;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAA;QAChD,OAAO,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IACxF,CAAC;IAED;;;;;;OAMG;IACH,YAAY;QACV,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAU,CAAA;QAClD,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACvB,MAAM,UAAU,GAAG,OAAkE,CAAA;YACrF,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAClD,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;gBACzC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAAE,UAAU,CAAC,GAAG,IAAI,CAAC,CAAA;YAChD,CAAC,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAyB,MAAS;QAC1C,IAAI,MAAM,CAAC,WAAW;YAAE,OAAM;QAE9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QAGpB,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAA;QAErC,IAAI,CAAC,IAAI,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAA;QAE1C,MAAM,CAAC,WAAW,GAAG,IAAI,CAAA;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,GAAG,IAAe;QACrB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACxD,CAAC;IAED,iCAAiC;IACjC,IAAI,CAAC,GAAG,IAAe;QACrB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACxD,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,GAAG,IAAe;QACtB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACzD,CAAC;IAED,iCAAiC;IACjC,IAAI,CAAC,GAAG,IAAe;QACrB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACxD,CAAC;IAED,iCAAiC;IACjC,GAAG,CAAC,GAAG,IAAe;QACpB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACvD,CAAC;IAED,iCAAiC;IACjC,KAAK,CAAC,GAAG,IAAe;QACtB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;IACzD,CAAC;;AAjFM,kBAAW,GAAG,KAAK,CAAA;AAoF5B;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAA"}

package/dist/lib/Slack.js

@@ -0,0 +1,120 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/// <reference types="node" />
+import { inspect } from 'util';
+import { TypeGuards } from '@codeleap/types';
+const DEFAULT_CHANNEL = '#_dev_logs';
+const DEFAULT_BASE_URL = 'https://slack.com/api/chat.postMessage';
+/**
+ * Sends structured log messages to a Slack channel via the Slack Web API.
+ *
+ * The service is inert until {@link setApi} is called with an HTTP client. Messages are
+ * silently suppressed when the API client is absent, `echoConfig.enabled` is `false`, or
+ * the current environment does not match the caller-supplied `sendIn` filter.
+ */
+export class SlackService {
+    constructor(config) {
+        this.config = config;
+        this.serializers = {
+            version: (IsDev) => {
+                return IsDev ? 'debug' : 'release';
+            },
+        };
+        this.echoConfig = config.Slack.echo;
+        this.isDev = config.Environment.IsDev;
+        this.appName = config.AppName;
+    }
+    /**
+     * Registers the HTTP client used to POST messages to Slack. Must be called before `echo`
+     * can send anything; calling `echo` without a registered API is a no-op.
+     */
+    setApi(fetcher) {
+        this.api = fetcher;
+    }
+    /**
+     * Posts a labelled object to Slack. The message is formatted with `util.inspect` so nested
+     * structures are human-readable in the channel.
+     *
+     * Delivery is conditional on three independent guards:
+     * - `options.sendIn` — restricts to `'debug'` (IsDev) or `'release'` (production) builds;
+     *   omitting `sendIn` sends in both environments.
+     * - `echoConfig.enabled` — master switch in the config; defaults to `true` when omitted.
+     * - A registered API client (see {@link setApi}).
+     *
+     * Failures are caught and logged to `console.error` rather than propagated.
+     */
+    echo(label_1, slackData_1) {
+        return __awaiter(this, arguments, void 0, function* (label, slackData, moduleName = undefined, messageOptions = {}) {
+            var _a, _b, _c, _d, _e, _f, _g, _h;
+            const options = this.parseOptions(messageOptions);
+            const slack = this.parseData(label, slackData, options.info, moduleName);
+            const enabled = TypeGuards.isBoolean(this.echoConfig.enabled) ? this.echoConfig.enabled : true;
+            if (!options.send || !this.api || !this.echoConfig || !enabled)
+                return;
+            const settingsData = (_b = (_a = this === null || this === void 0 ? void 0 : this.echoConfig) === null || _a === void 0 ? void 0 : _a.options) !== null && _b !== void 0 ? _b : {};
+            try {
+                const data = Object.assign({ 'channel': (_d = (_c = this === null || this === void 0 ? void 0 : this.echoConfig) === null || _c === void 0 ? void 0 : _c.channel) !== null && _d !== void 0 ? _d : DEFAULT_CHANNEL, 'text': slack, 'username': `${this.appName} Log`, 'icon_url': (_e = this === null || this === void 0 ? void 0 : this.echoConfig) === null || _e === void 0 ? void 0 : _e.icon }, settingsData);
+                yield this.api.post('', data, {
+                    baseURL: (_g = (_f = this === null || this === void 0 ? void 0 : this.echoConfig) === null || _f === void 0 ? void 0 : _f.baseURL) !== null && _g !== void 0 ? _g : DEFAULT_BASE_URL,
+                    headers: {
+                        Authorization: `Bearer ${(_h = this === null || this === void 0 ? void 0 : this.echoConfig) === null || _h === void 0 ? void 0 : _h.token}`,
+                    },
+                });
+            }
+            catch (err) {
+                console.error('Failed to echo', err, 'logger echoSlack');
+            }
+        });
+    }
+    parseOptions(options) {
+        const { sendIn = [], include = [], } = options;
+        const hasSendIn = sendIn.length >= 1;
+        const isDebug = hasSendIn ? sendIn.includes('debug') : true;
+        const isRelease = hasSendIn ? sendIn.includes('release') : true;
+        if (!isDebug && this.isDev || !isRelease && !this.isDev) {
+            return {
+                info: '',
+                send: false,
+            };
+        }
+        let str = '';
+        const separator = ' - ';
+        include.forEach(k => {
+            var _a, _b;
+            const data = (_b = (_a = this.serializers)[k]) === null || _b === void 0 ? void 0 : _b.call(_a, this.isDev);
+            str = `${str}${str.length > 0 ? separator : ''}[${data}]`;
+        });
+        return {
+            info: str,
+            send: true,
+        };
+    }
+    parseData(label, data, info, module) {
+        const obj = !info ? data : Object.assign(Object.assign({}, data), { info });
+        const args = [`${!module ? '' : `(${module}) `}${label}: `, obj];
+        const slack = args.map(i => {
+            if (typeof i === 'object') {
+                try {
+                    return inspect(i, {
+                        depth: 5,
+                        compact: false,
+                        showHidden: true,
+                    });
+                }
+                catch (e) {
+                    return `${i} (Unserializable value)`;
+                }
+            }
+            return String(i);
+        }).join(' ');
+        return slack;
+    }
+}
+//# sourceMappingURL=Slack.js.map

package/dist/lib/Slack.js.map

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

package/dist/lib/index.js

@@ -0,0 +1,2 @@
+export * from './Logger';
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA"}

package/dist/lib/performance/errors.js

@@ -0,0 +1,21 @@
+const defineError = (errorName, args) => {
+    var _a;
+    switch (errorName) {
+        case 'maxRenders':
+            return `${args.name} is rendering more than ${args.maxRenders}time per ${((_a = args.throttleInterval) !== null && _a !== void 0 ? _a : 0) / 1000}second!
+      If you aware of this, you can disable it in the Settings.ts > Performancer.
+      `;
+    }
+};
+/**
+ * Thrown by {@link PerformanceService.inspectRender} when a component exceeds its allowed
+ * render budget. The error name is always `'Codeleap:Perf'`, making it easy to distinguish
+ * from application errors in React error boundaries or crash-reporting tools.
+ */
+export class PerformanceError extends Error {
+    constructor(errorName, args) {
+        super(defineError(errorName, args));
+        this.name = 'Codeleap:Perf';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/performance/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/lib/performance/errors.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,GAAG,CAAC,SAAqB,EAAE,IAAwB,EAAE,EAAE;;IACtE,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,YAAY;YACf,OAAO,GAAG,IAAI,CAAC,IAAI,2BAA2B,IAAI,CAAC,UAAU,YAC3D,CAAC,MAAA,IAAI,CAAC,gBAAgB,mCAAI,CAAC,CAAC,GAAG,IACjC;;OAEC,CAAA;IACL,CAAC;AACH,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,SAAqB,EAAE,IAAwB;QACzD,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF"}

package/dist/lib/performance/index.js

@@ -0,0 +1,76 @@
+import { throttle } from '@codeleap/utils';
+import { useEffect } from 'react';
+import { PerformanceError } from './errors';
+export * from './types';
+/**
+ * Dev-only performance utilities. All methods are no-ops in production
+ * (`config.Environment.IsDev === false`) or when
+ * `config.Logger.performanceInspector.enabled` is `false`.
+ */
+export class PerformanceService {
+    constructor(config) {
+        this.config = config;
+        this.renderCounter = {};
+        /**
+         * Tracks render frequency for a component and warns when it exceeds the configured threshold.
+         *
+         * Call this at the top of a function component body (not inside a hook). By default it also
+         * registers mount/unmount effects via `useEffect` — pass `noHooks: true` to skip those when
+         * the component cannot accept additional hooks.
+         *
+         * When the accumulated render count within a `throttleInterval` window exceeds `maxRenders`,
+         * the counter resets and a {@link PerformanceError} is thrown (surfacing as a React error
+         * boundary hit rather than a silent warning).
+         *
+         * Components whose names start with any entry in
+         * `config.Logger.performanceInspector.blacklist` are silently skipped.
+         *
+         * Has no effect outside a dev environment or when the inspector is disabled in config.
+         */
+        this.inspectRender = (name, options = {
+            noHooks: false,
+            logMode: 'summarized',
+            throttleInterval: 1000,
+        }) => {
+            const config = this.config.Logger.performanceInspector;
+            const blacklist = config.blacklist || [];
+            if (blacklist.some((item) => name.startsWith(item)))
+                return;
+            const { noHooks, logMode, throttleInterval, maxRenders = config.maxRenders } = options;
+            if (!config.enabled || !this.config.Environment.IsDev) {
+                return;
+            }
+            if (!noHooks) {
+                useEffect(() => {
+                    console.log(`[PerformanceInspector] Mounted -> ${name}`);
+                    return () => {
+                        console.log(`[PerformanceInspector] Unmounted -> ${name}`);
+                    };
+                });
+            }
+            this.renderCounter[name] = this.renderCounter[name] ? this.renderCounter[name] + 1 : 1;
+            const renders = this.renderCounter[name];
+            if (renders > maxRenders) {
+                this.renderCounter[name] = 0;
+                throw new PerformanceError('maxRenders', {
+                    name,
+                    throttleInterval,
+                    maxRenders,
+                });
+            }
+            if (logMode === 'raw') {
+                console.log(`[PerformanceInspector] Rendered -> ${name}: ${renders}`);
+                return;
+            }
+            function logSummary() {
+                if (renders <= 0)
+                    return;
+                console.log(`[PerformanceInspector] Render summary -> ${name}: ${renders}`);
+                this.renderCounter[name] = 0;
+            }
+            // @ts-ignore
+            throttle(logSummary, name, throttleInterval);
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/performance/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/performance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAI3C,cAAc,SAAS,CAAA;AAEvB;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IAG7B,YAAoB,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;QAFxC,kBAAa,GAA2B,EAAE,CAAA;QAI1C;;;;;;;;;;;;;;;WAeG;QACH,kBAAa,GAAG,CACd,IAAY,EACZ,UAAgC;YAC9B,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,YAAY;YACrB,gBAAgB,EAAE,IAAI;SACvB,EACD,EAAE;YACF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAA;YAEtD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAA;YAExC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBAAE,OAAM;YAE3D,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,GAAG,OAAO,CAAA;YAEtF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;gBACtD,OAAM;YACR,CAAC;YAED,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,SAAS,CAAC,GAAG,EAAE;oBACb,OAAO,CAAC,GAAG,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAA;oBAExD,OAAO,GAAG,EAAE;wBACV,OAAO,CAAC,GAAG,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAA;oBAC5D,CAAC,CAAA;gBACH,CAAC,CAAC,CAAA;YACJ,CAAC;YAED,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAEtF,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;YAExC,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBACzB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBAE5B,MAAM,IAAI,gBAAgB,CAAC,YAAY,EAAE;oBACvC,IAAI;oBACJ,gBAAgB;oBAChB,UAAU;iBACX,CAAC,CAAA;YACJ,CAAC;YAED,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,sCAAsC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAA;gBACrE,OAAM;YACR,CAAC;YAED,SAAS,UAAU;gBACjB,IAAI,OAAO,IAAI,CAAC;oBAAE,OAAM;gBAExB,OAAO,CAAC,GAAG,CAAC,4CAA4C,IAAI,KAAK,OAAO,EAAE,CAAC,CAAA;gBAC3E,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC9B,CAAC;YACD,aAAa;YACb,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAA;QAC9C,CAAC,CAAA;IA3E2C,CAAC;CA4E9C"}

package/dist/lib/performance/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/performance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/performance/types.ts"],"names":[],"mappings":""}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/createLogger.js

@@ -0,0 +1,56 @@
+/**
+ * Concrete logger implementation produced by {@link createLogger}. Each log method writes to
+ * the native `console` counterpart **and** fans out to every registered transport, so
+ * third-party sinks (e.g. Sentry, Datadog) receive the same payload without extra wiring.
+ *
+ * `test` is intentionally a no-op — it exists as a scratch channel that leaves no output in
+ * any environment.
+ *
+ * Transport functions are shared as a static property, meaning all `CustomLogger` instances
+ * created in the same process share the same transport list. Only one call to
+ * {@link createLogger} is expected per app.
+ */
+class CustomLogger {
+    static applyTransport(level, ...args) {
+        CustomLogger.transport.map(fn => {
+            fn(level, ...args);
+        });
+    }
+    info(...args) {
+        console.info(...args);
+        CustomLogger.applyTransport('info', ...args);
+    }
+    error(...args) {
+        console.error(...args);
+        CustomLogger.applyTransport('error', ...args);
+    }
+    warn(...args) {
+        console.warn(...args);
+        CustomLogger.applyTransport('warn', ...args);
+    }
+    /** Intentional no-op. Use as a scratch channel for temporary logs that must not ship. */
+    test(...args) {
+    }
+    log(...args) {
+        console.log(...args);
+        CustomLogger.applyTransport('log', ...args);
+    }
+    debug(...args) {
+        console.debug(...args);
+        CustomLogger.applyTransport('debug', ...args);
+    }
+}
+/**
+ * Wires up the transport list and returns a ready-to-use {@link CustomLogger} instance.
+ *
+ * The returned instance satisfies the logging method contract expected by {@link Logger},
+ * so it should be used to replace the stub methods on the shared `logger` singleton after
+ * calling `logger.initialize(config)`.
+ *
+ * Calling this more than once replaces the shared transport list for all existing instances.
+ */
+export const createLogger = (options) => {
+    CustomLogger.transport = options.transport;
+    return new CustomLogger();
+};
+//# sourceMappingURL=createLogger.js.map

package/dist/utils/createLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createLogger.js","sourceRoot":"","sources":["../../src/utils/createLogger.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;GAWG;AACH,MAAM,YAAY;IAGhB,MAAM,CAAC,cAAc,CAAC,KAAY,EAAE,GAAG,IAAe;QACpD,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAC9B,EAAE,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAA;QACpB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;QACrB,YAAY,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;QACtB,YAAY,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IAC/C,CAAC;IAED,IAAI,CAAC,GAAG,IAAe;QACrB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;QACrB,YAAY,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAA;IAC9C,CAAC;IAED,yFAAyF;IACzF,IAAI,CAAC,GAAG,IAAe;IAEvB,CAAC;IAED,GAAG,CAAC,GAAG,IAAe;QACpB,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAA;QACpB,YAAY,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK,CAAC,GAAG,IAAe;QACtB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAA;QACtB,YAAY,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAA;IAC/C,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAsB,EAAE,EAAE;IACrD,YAAY,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAA;IAE1C,OAAO,IAAI,YAAY,EAAE,CAAA;AAC3B,CAAC,CAAA"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export * from './createLogger';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codeleap/logger",
-  "version": "6.8.0",
-  "main": "src/index.ts",
+  "version": "7.0.1",
+  "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
@@ -22,9 +22,9 @@
     "directory": "packages/logger"
   },
   "devDependencies": {
-    "@codeleap/types": "6.8.0",
-    "@codeleap/utils": "6.8.0",
-    "@codeleap/config": "6.8.0",
+    "@codeleap/types": "7.0.1",
+    "@codeleap/utils": "7.0.1",
+    "@codeleap/config": "7.0.1",
     "ts-node-dev": "1.1.8",
     "@sentry/types": "8.40.0"
   },
@@ -33,8 +33,8 @@
     "typecheck": "bun tsc --noEmit -p ./tsconfig.json"
   },
   "peerDependencies": {
-    "@codeleap/types": "6.8.0",
-    "@codeleap/utils": "6.8.0",
+    "@codeleap/types": "7.0.1",
+    "@codeleap/utils": "7.0.1",
     "typescript": "6.0.3",
     "react": "19.1.0"
   },