@coffer-org/sdk 1.3.1 → 1.4.0

package/dist/logger.d.ts

@@ -0,0 +1,18 @@
+export interface Logger {
+    debug(msg: string, extra?: Record<string, unknown>): void;
+    info(msg: string, extra?: Record<string, unknown>): void;
+    warn(msg: string, extra?: unknown): void;
+    error(msg: string, extra?: unknown): void;
+}
+export interface RootLogger {
+    child(bindings: Record<string, unknown>): RootLogger;
+    debug(obj: unknown, msg?: string): void;
+    info(obj: unknown, msg?: string): void;
+    warn(obj: unknown, msg?: string): void;
+    error(obj: unknown, msg?: string): void;
+}
+export declare const LOG_LEVEL: string;
+export declare function parseTags(raw: string | undefined): Set<string>;
+export declare function tagEnabled(tag: string, tags: Set<string>): boolean;
+export declare function setRootLogger(l: RootLogger | null): void;
+export declare function getLogger(tag: string): Logger;

package/dist/logger.js

@@ -0,0 +1,57 @@
+const LEVEL_NUM = { trace: 10, debug: 20, info: 30, warn: 40, error: 50 };
+export const LOG_LEVEL = process.env.LOG_LEVEL ?? 'info';
+export function parseTags(raw) {
+    return new Set((raw ?? '')
+        .split(',')
+        .map((t) => t.trim())
+        .filter(Boolean));
+}
+export function tagEnabled(tag, tags) {
+    return tags.size === 0 || tags.has(tag);
+}
+const TAGS = parseTags(process.env.LOG_TAGS);
+const CONSOLE_THRESHOLD = LEVEL_NUM[LOG_LEVEL] ?? LEVEL_NUM.info;
+let root = null;
+const children = new Map();
+export function setRootLogger(l) {
+    root = l;
+    children.clear();
+}
+export function getLogger(tag) {
+    const emit = (level, msg, extra) => {
+        if (!tagEnabled(tag, TAGS))
+            return;
+        if (root) {
+            let child = children.get(tag);
+            if (!child) {
+                child = root.child({ tag });
+                children.set(tag, child);
+            }
+            if (extra === undefined)
+                child[level](msg);
+            else if (extra instanceof Error)
+                child[level]({ err: extra }, msg);
+            else if (typeof extra === 'object')
+                child[level](extra, msg);
+            else
+                child[level]({ err: extra }, msg);
+            return;
+        }
+        if (LEVEL_NUM[level] < CONSOLE_THRESHOLD)
+            return;
+        const line = `[${tag}] ${msg}`;
+        const rest = extra === undefined ? [] : [extra];
+        if (level === 'error')
+            console.error(line, ...rest);
+        else if (level === 'warn')
+            console.warn(line, ...rest);
+        else
+            console.log(line, ...rest);
+    };
+    return {
+        debug: (msg, extra) => emit('debug', msg, extra),
+        info: (msg, extra) => emit('info', msg, extra),
+        warn: (msg, extra) => emit('warn', msg, extra),
+        error: (msg, extra) => emit('error', msg, extra),
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/sdk",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "type": "module",
   "engines": {
     "node": ">=24"