@objectstack/core 4.0.3 → 4.0.5

package/dist/logger.cjs

@@ -0,0 +1,177 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/logger.ts
+var logger_exports = {};
+__export(logger_exports, {
+  ObjectLogger: () => ObjectLogger,
+  createLogger: () => createLogger
+});
+module.exports = __toCommonJS(logger_exports);
+var LEVEL_ORDER = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+  fatal: 4,
+  silent: 5
+};
+var LEVEL_COLORS = {
+  debug: "\x1B[36m",
+  info: "\x1B[32m",
+  warn: "\x1B[33m",
+  error: "\x1B[31m",
+  fatal: "\x1B[35m",
+  silent: ""
+};
+var RESET = "\x1B[0m";
+var ObjectLogger = class _ObjectLogger {
+  constructor(config = {}, bindings = {}) {
+    this.config = {
+      name: config.name,
+      level: config.level ?? "info",
+      format: config.format ?? "pretty",
+      redact: config.redact ?? ["password", "token", "secret", "key"],
+      sourceLocation: config.sourceLocation ?? false,
+      file: config.file,
+      rotation: config.rotation ?? { maxSize: "10m", maxFiles: 5 }
+    };
+    this.bindings = bindings;
+    if (this.config.file && typeof process !== "undefined") {
+      this.openFileStream(this.config.file);
+    }
+  }
+  openFileStream(path) {
+    try {
+      const fs = require("fs");
+      const dir = require("path").dirname(path);
+      fs.mkdirSync(dir, { recursive: true });
+      this.fileStream = fs.createWriteStream(path, { flags: "a" });
+    } catch {
+    }
+  }
+  isEnabled(level) {
+    return LEVEL_ORDER[level] >= LEVEL_ORDER[this.config.level];
+  }
+  redactSensitive(obj) {
+    if (!obj || typeof obj !== "object") return obj;
+    const redacted = Array.isArray(obj) ? [...obj] : { ...obj };
+    for (const key in redacted) {
+      const lower = key.toLowerCase();
+      if (this.config.redact.some((p) => lower.includes(p.toLowerCase()))) {
+        redacted[key] = "***REDACTED***";
+      } else if (typeof redacted[key] === "object" && redacted[key] !== null) {
+        redacted[key] = this.redactSensitive(redacted[key]);
+      }
+    }
+    return redacted;
+  }
+  write(level, message, meta, error) {
+    if (!this.isEnabled(level)) return;
+    const context = this.redactSensitive({
+      ...this.bindings,
+      ...meta,
+      ...error ? { error: { message: error.message, stack: error.stack } } : {}
+    });
+    const hasContext = Object.keys(context).length > 0;
+    const ts = (/* @__PURE__ */ new Date()).toISOString();
+    let line;
+    if (this.config.format === "json") {
+      line = JSON.stringify({
+        time: ts,
+        level,
+        ...this.config.name ? { name: this.config.name } : {},
+        msg: message,
+        ...context
+      });
+    } else if (this.config.format === "text") {
+      const parts = [ts, level.toUpperCase(), message];
+      if (hasContext) parts.push(JSON.stringify(context));
+      line = parts.join(" | ");
+    } else {
+      const color = LEVEL_COLORS[level] || "";
+      const label = this.config.name ? `[${this.config.name}] ` : "";
+      line = `${color}${ts} ${level.toUpperCase()}${RESET} ${label}${message}`;
+      if (hasContext) line += ` ${JSON.stringify(context)}`;
+    }
+    const out = line + "\n";
+    if (typeof process !== "undefined" && process.stderr) {
+      if (level === "error" || level === "fatal") {
+        process.stderr.write(out);
+      } else {
+        process.stdout?.write(out);
+      }
+    } else if (typeof console !== "undefined") {
+      const fn = level === "error" || level === "fatal" ? console.error : level === "warn" ? console.warn : level === "debug" ? console.debug : console.log;
+      fn(line);
+    }
+    if (this.fileStream) {
+      this.fileStream.write(out);
+    }
+  }
+  debug(message, meta) {
+    this.write("debug", message, meta);
+  }
+  info(message, meta) {
+    this.write("info", message, meta);
+  }
+  warn(message, meta) {
+    this.write("warn", message, meta);
+  }
+  error(message, errorOrMeta, meta) {
+    if (errorOrMeta instanceof Error) {
+      this.write("error", message, meta, errorOrMeta);
+    } else {
+      this.write("error", message, errorOrMeta);
+    }
+  }
+  fatal(message, errorOrMeta, meta) {
+    if (errorOrMeta instanceof Error) {
+      this.write("fatal", message, meta, errorOrMeta);
+    } else {
+      this.write("fatal", message, errorOrMeta);
+    }
+  }
+  log(message, ...args) {
+    this.info(message, args.length > 0 ? { args } : void 0);
+  }
+  child(context) {
+    const child = new _ObjectLogger(this.config, { ...this.bindings, ...context });
+    child.fileStream = this.fileStream;
+    return child;
+  }
+  withTrace(traceId, spanId) {
+    return this.child({ traceId, spanId });
+  }
+  async destroy() {
+    if (this.fileStream) {
+      await new Promise((resolve) => this.fileStream.end(resolve));
+      this.fileStream = void 0;
+    }
+  }
+};
+function createLogger(config) {
+  return new ObjectLogger(config);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ObjectLogger,
+  createLogger
+});
+//# sourceMappingURL=logger.cjs.map

package/dist/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { LoggerConfig, LogLevel } from '@objectstack/spec/system';\nimport type { Logger } from '@objectstack/spec/contracts';\n\n// Re-export the contract type so consumers can do\n// `import type { Logger } from '@objectstack/core/logger'` without also\n// pulling `@objectstack/spec` into their bundle graph manually.\nexport type { Logger };\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n    fatal: 4,\n    silent: 5,\n};\n\nconst LEVEL_COLORS: Record<LogLevel, string> = {\n    debug: '\\x1b[36m',\n    info: '\\x1b[32m',\n    warn: '\\x1b[33m',\n    error: '\\x1b[31m',\n    fatal: '\\x1b[35m',\n    silent: '',\n};\n\nconst RESET = '\\x1b[0m';\n\nexport class ObjectLogger implements Logger {\n    private config: Required<Omit<LoggerConfig, 'file' | 'rotation' | 'name'>> & {\n        file?: string;\n        rotation?: { maxSize: string; maxFiles: number };\n        name?: string;\n    };\n    private bindings: Record<string, any>;\n    private fileStream?: any;\n\n    constructor(config: Partial<LoggerConfig> = {}, bindings: Record<string, any> = {}) {\n        this.config = {\n            name: config.name,\n            level: config.level ?? 'info',\n            format: config.format ?? 'pretty',\n            redact: config.redact ?? ['password', 'token', 'secret', 'key'],\n            sourceLocation: config.sourceLocation ?? false,\n            file: config.file,\n            rotation: config.rotation ?? { maxSize: '10m', maxFiles: 5 },\n        };\n        this.bindings = bindings;\n\n        if (this.config.file && typeof process !== 'undefined') {\n            this.openFileStream(this.config.file);\n        }\n    }\n\n    private openFileStream(path: string) {\n        try {\n            // Lazy require to avoid bundling issues\n            const fs = require('fs');\n            const dir = require('path').dirname(path);\n            fs.mkdirSync(dir, { recursive: true });\n            this.fileStream = fs.createWriteStream(path, { flags: 'a' });\n        } catch {\n            // ignore — file logging is optional\n        }\n    }\n\n    private isEnabled(level: LogLevel): boolean {\n        return LEVEL_ORDER[level] >= LEVEL_ORDER[this.config.level];\n    }\n\n    private redactSensitive(obj: any): any {\n        if (!obj || typeof obj !== 'object') return obj;\n        const redacted = Array.isArray(obj) ? [...obj] : { ...obj };\n        for (const key in redacted) {\n            const lower = key.toLowerCase();\n            if (this.config.redact.some((p: string) => lower.includes(p.toLowerCase()))) {\n                redacted[key] = '***REDACTED***';\n            } else if (typeof redacted[key] === 'object' && redacted[key] !== null) {\n                redacted[key] = this.redactSensitive(redacted[key]);\n            }\n        }\n        return redacted;\n    }\n\n    private write(level: LogLevel, message: string, meta?: Record<string, any>, error?: Error) {\n        if (!this.isEnabled(level)) return;\n\n        const context = this.redactSensitive({\n            ...this.bindings,\n            ...meta,\n            ...(error ? { error: { message: error.message, stack: error.stack } } : {}),\n        });\n\n        const hasContext = Object.keys(context).length > 0;\n        const ts = new Date().toISOString();\n\n        let line: string;\n\n        if (this.config.format === 'json') {\n            line = JSON.stringify({\n                time: ts,\n                level,\n                ...(this.config.name ? { name: this.config.name } : {}),\n                msg: message,\n                ...context,\n            });\n        } else if (this.config.format === 'text') {\n            const parts = [ts, level.toUpperCase(), message];\n            if (hasContext) parts.push(JSON.stringify(context));\n            line = parts.join(' | ');\n        } else {\n            // pretty\n            const color = LEVEL_COLORS[level] || '';\n            const label = this.config.name ? `[${this.config.name}] ` : '';\n            line = `${color}${ts} ${level.toUpperCase()}${RESET} ${label}${message}`;\n            if (hasContext) line += ` ${JSON.stringify(context)}`;\n        }\n\n        const out = line + '\\n';\n\n        // Browser-safe output: prefer process streams when available, otherwise\n        // fall back to console. The previous unguarded `process.stderr?.write`\n        // throws `ReferenceError: process is not defined` in browsers because\n        // `process` itself is the missing global, not just its `stderr` field.\n        if (typeof process !== 'undefined' && (process as any).stderr) {\n            if (level === 'error' || level === 'fatal') {\n                (process as any).stderr.write(out);\n            } else {\n                (process as any).stdout?.write(out);\n            }\n        } else if (typeof console !== 'undefined') {\n            const fn =\n                level === 'error' || level === 'fatal' ? console.error\n                : level === 'warn' ? console.warn\n                : level === 'debug' ? console.debug\n                : console.log;\n            fn(line);\n        }\n\n        if (this.fileStream) {\n            this.fileStream.write(out);\n        }\n    }\n\n    debug(message: string, meta?: Record<string, any>): void {\n        this.write('debug', message, meta);\n    }\n\n    info(message: string, meta?: Record<string, any>): void {\n        this.write('info', message, meta);\n    }\n\n    warn(message: string, meta?: Record<string, any>): void {\n        this.write('warn', message, meta);\n    }\n\n    error(message: string, errorOrMeta?: Error | Record<string, any>, meta?: Record<string, any>): void {\n        if (errorOrMeta instanceof Error) {\n            this.write('error', message, meta, errorOrMeta);\n        } else {\n            this.write('error', message, errorOrMeta);\n        }\n    }\n\n    fatal(message: string, errorOrMeta?: Error | Record<string, any>, meta?: Record<string, any>): void {\n        if (errorOrMeta instanceof Error) {\n            this.write('fatal', message, meta, errorOrMeta);\n        } else {\n            this.write('fatal', message, errorOrMeta);\n        }\n    }\n\n    log(message: string, ...args: any[]): void {\n        this.info(message, args.length > 0 ? { args } : undefined);\n    }\n\n    child(context: Record<string, any>): ObjectLogger {\n        const child = new ObjectLogger(this.config, { ...this.bindings, ...context });\n        // Share the file stream — no double-open\n        child.fileStream = this.fileStream;\n        return child;\n    }\n\n    withTrace(traceId: string, spanId?: string): ObjectLogger {\n        return this.child({ traceId, spanId });\n    }\n\n    async destroy(): Promise<void> {\n        if (this.fileStream) {\n            await new Promise<void>((resolve) => this.fileStream.end(resolve));\n            this.fileStream = undefined;\n        }\n    }\n}\n\nexport function createLogger(config?: Partial<LoggerConfig>): ObjectLogger {\n    return new ObjectLogger(config);\n}\n"],"mappings":"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","names":[]}

package/dist/logger.d.cts

@@ -0,0 +1,26 @@
+import { LoggerConfig } from '@objectstack/spec/system';
+import { Logger } from '@objectstack/spec/contracts';
+export { Logger } from '@objectstack/spec/contracts';
+
+declare class ObjectLogger implements Logger {
+    private config;
+    private bindings;
+    private fileStream?;
+    constructor(config?: Partial<LoggerConfig>, bindings?: Record<string, any>);
+    private openFileStream;
+    private isEnabled;
+    private redactSensitive;
+    private write;
+    debug(message: string, meta?: Record<string, any>): void;
+    info(message: string, meta?: Record<string, any>): void;
+    warn(message: string, meta?: Record<string, any>): void;
+    error(message: string, errorOrMeta?: Error | Record<string, any>, meta?: Record<string, any>): void;
+    fatal(message: string, errorOrMeta?: Error | Record<string, any>, meta?: Record<string, any>): void;
+    log(message: string, ...args: any[]): void;
+    child(context: Record<string, any>): ObjectLogger;
+    withTrace(traceId: string, spanId?: string): ObjectLogger;
+    destroy(): Promise<void>;
+}
+declare function createLogger(config?: Partial<LoggerConfig>): ObjectLogger;
+
+export { ObjectLogger, createLogger };

package/dist/logger.d.ts

@@ -0,0 +1,26 @@
+import { LoggerConfig } from '@objectstack/spec/system';
+import { Logger } from '@objectstack/spec/contracts';
+export { Logger } from '@objectstack/spec/contracts';
+
+declare class ObjectLogger implements Logger {
+    private config;
+    private bindings;
+    private fileStream?;
+    constructor(config?: Partial<LoggerConfig>, bindings?: Record<string, any>);
+    private openFileStream;
+    private isEnabled;
+    private redactSensitive;
+    private write;
+    debug(message: string, meta?: Record<string, any>): void;
+    info(message: string, meta?: Record<string, any>): void;
+    warn(message: string, meta?: Record<string, any>): void;
+    error(message: string, errorOrMeta?: Error | Record<string, any>, meta?: Record<string, any>): void;
+    fatal(message: string, errorOrMeta?: Error | Record<string, any>, meta?: Record<string, any>): void;
+    log(message: string, ...args: any[]): void;
+    child(context: Record<string, any>): ObjectLogger;
+    withTrace(traceId: string, spanId?: string): ObjectLogger;
+    destroy(): Promise<void>;
+}
+declare function createLogger(config?: Partial<LoggerConfig>): ObjectLogger;
+
+export { ObjectLogger, createLogger };

package/dist/logger.js

@@ -0,0 +1,158 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/logger.ts
+var LEVEL_ORDER = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3,
+  fatal: 4,
+  silent: 5
+};
+var LEVEL_COLORS = {
+  debug: "\x1B[36m",
+  info: "\x1B[32m",
+  warn: "\x1B[33m",
+  error: "\x1B[31m",
+  fatal: "\x1B[35m",
+  silent: ""
+};
+var RESET = "\x1B[0m";
+var ObjectLogger = class _ObjectLogger {
+  constructor(config = {}, bindings = {}) {
+    this.config = {
+      name: config.name,
+      level: config.level ?? "info",
+      format: config.format ?? "pretty",
+      redact: config.redact ?? ["password", "token", "secret", "key"],
+      sourceLocation: config.sourceLocation ?? false,
+      file: config.file,
+      rotation: config.rotation ?? { maxSize: "10m", maxFiles: 5 }
+    };
+    this.bindings = bindings;
+    if (this.config.file && typeof process !== "undefined") {
+      this.openFileStream(this.config.file);
+    }
+  }
+  openFileStream(path) {
+    try {
+      const fs = __require("fs");
+      const dir = __require("path").dirname(path);
+      fs.mkdirSync(dir, { recursive: true });
+      this.fileStream = fs.createWriteStream(path, { flags: "a" });
+    } catch {
+    }
+  }
+  isEnabled(level) {
+    return LEVEL_ORDER[level] >= LEVEL_ORDER[this.config.level];
+  }
+  redactSensitive(obj) {
+    if (!obj || typeof obj !== "object") return obj;
+    const redacted = Array.isArray(obj) ? [...obj] : { ...obj };
+    for (const key in redacted) {
+      const lower = key.toLowerCase();
+      if (this.config.redact.some((p) => lower.includes(p.toLowerCase()))) {
+        redacted[key] = "***REDACTED***";
+      } else if (typeof redacted[key] === "object" && redacted[key] !== null) {
+        redacted[key] = this.redactSensitive(redacted[key]);
+      }
+    }
+    return redacted;
+  }
+  write(level, message, meta, error) {
+    if (!this.isEnabled(level)) return;
+    const context = this.redactSensitive({
+      ...this.bindings,
+      ...meta,
+      ...error ? { error: { message: error.message, stack: error.stack } } : {}
+    });
+    const hasContext = Object.keys(context).length > 0;
+    const ts = (/* @__PURE__ */ new Date()).toISOString();
+    let line;
+    if (this.config.format === "json") {
+      line = JSON.stringify({
+        time: ts,
+        level,
+        ...this.config.name ? { name: this.config.name } : {},
+        msg: message,
+        ...context
+      });
+    } else if (this.config.format === "text") {
+      const parts = [ts, level.toUpperCase(), message];
+      if (hasContext) parts.push(JSON.stringify(context));
+      line = parts.join(" | ");
+    } else {
+      const color = LEVEL_COLORS[level] || "";
+      const label = this.config.name ? `[${this.config.name}] ` : "";
+      line = `${color}${ts} ${level.toUpperCase()}${RESET} ${label}${message}`;
+      if (hasContext) line += ` ${JSON.stringify(context)}`;
+    }
+    const out = line + "\n";
+    if (typeof process !== "undefined" && process.stderr) {
+      if (level === "error" || level === "fatal") {
+        process.stderr.write(out);
+      } else {
+        process.stdout?.write(out);
+      }
+    } else if (typeof console !== "undefined") {
+      const fn = level === "error" || level === "fatal" ? console.error : level === "warn" ? console.warn : level === "debug" ? console.debug : console.log;
+      fn(line);
+    }
+    if (this.fileStream) {
+      this.fileStream.write(out);
+    }
+  }
+  debug(message, meta) {
+    this.write("debug", message, meta);
+  }
+  info(message, meta) {
+    this.write("info", message, meta);
+  }
+  warn(message, meta) {
+    this.write("warn", message, meta);
+  }
+  error(message, errorOrMeta, meta) {
+    if (errorOrMeta instanceof Error) {
+      this.write("error", message, meta, errorOrMeta);
+    } else {
+      this.write("error", message, errorOrMeta);
+    }
+  }
+  fatal(message, errorOrMeta, meta) {
+    if (errorOrMeta instanceof Error) {
+      this.write("fatal", message, meta, errorOrMeta);
+    } else {
+      this.write("fatal", message, errorOrMeta);
+    }
+  }
+  log(message, ...args) {
+    this.info(message, args.length > 0 ? { args } : void 0);
+  }
+  child(context) {
+    const child = new _ObjectLogger(this.config, { ...this.bindings, ...context });
+    child.fileStream = this.fileStream;
+    return child;
+  }
+  withTrace(traceId, spanId) {
+    return this.child({ traceId, spanId });
+  }
+  async destroy() {
+    if (this.fileStream) {
+      await new Promise((resolve) => this.fileStream.end(resolve));
+      this.fileStream = void 0;
+    }
+  }
+};
+function createLogger(config) {
+  return new ObjectLogger(config);
+}
+export {
+  ObjectLogger,
+  createLogger
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logger.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { LoggerConfig, LogLevel } from '@objectstack/spec/system';\nimport type { Logger } from '@objectstack/spec/contracts';\n\n// Re-export the contract type so consumers can do\n// `import type { Logger } from '@objectstack/core/logger'` without also\n// pulling `@objectstack/spec` into their bundle graph manually.\nexport type { Logger };\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n    fatal: 4,\n    silent: 5,\n};\n\nconst LEVEL_COLORS: Record<LogLevel, string> = {\n    debug: '\\x1b[36m',\n    info: '\\x1b[32m',\n    warn: '\\x1b[33m',\n    error: '\\x1b[31m',\n    fatal: '\\x1b[35m',\n    silent: '',\n};\n\nconst RESET = '\\x1b[0m';\n\nexport class ObjectLogger implements Logger {\n    private config: Required<Omit<LoggerConfig, 'file' | 'rotation' | 'name'>> & {\n        file?: string;\n        rotation?: { maxSize: string; maxFiles: number };\n        name?: string;\n    };\n    private bindings: Record<string, any>;\n    private fileStream?: any;\n\n    constructor(config: Partial<LoggerConfig> = {}, bindings: Record<string, any> = {}) {\n        this.config = {\n            name: config.name,\n            level: config.level ?? 'info',\n            format: config.format ?? 'pretty',\n            redact: config.redact ?? ['password', 'token', 'secret', 'key'],\n            sourceLocation: config.sourceLocation ?? false,\n            file: config.file,\n            rotation: config.rotation ?? { maxSize: '10m', maxFiles: 5 },\n        };\n        this.bindings = bindings;\n\n        if (this.config.file && typeof process !== 'undefined') {\n            this.openFileStream(this.config.file);\n        }\n    }\n\n    private openFileStream(path: string) {\n        try {\n            // Lazy require to avoid bundling issues\n            const fs = require('fs');\n            const dir = require('path').dirname(path);\n            fs.mkdirSync(dir, { recursive: true });\n            this.fileStream = fs.createWriteStream(path, { flags: 'a' });\n        } catch {\n            // ignore — file logging is optional\n        }\n    }\n\n    private isEnabled(level: LogLevel): boolean {\n        return LEVEL_ORDER[level] >= LEVEL_ORDER[this.config.level];\n    }\n\n    private redactSensitive(obj: any): any {\n        if (!obj || typeof obj !== 'object') return obj;\n        const redacted = Array.isArray(obj) ? [...obj] : { ...obj };\n        for (const key in redacted) {\n            const lower = key.toLowerCase();\n            if (this.config.redact.some((p: string) => lower.includes(p.toLowerCase()))) {\n                redacted[key] = '***REDACTED***';\n            } else if (typeof redacted[key] === 'object' && redacted[key] !== null) {\n                redacted[key] = this.redactSensitive(redacted[key]);\n            }\n        }\n        return redacted;\n    }\n\n    private write(level: LogLevel, message: string, meta?: Record<string, any>, error?: Error) {\n        if (!this.isEnabled(level)) return;\n\n        const context = this.redactSensitive({\n            ...this.bindings,\n            ...meta,\n            ...(error ? { error: { message: error.message, stack: error.stack } } : {}),\n        });\n\n        const hasContext = Object.keys(context).length > 0;\n        const ts = new Date().toISOString();\n\n        let line: string;\n\n        if (this.config.format === 'json') {\n            line = JSON.stringify({\n                time: ts,\n                level,\n                ...(this.config.name ? { name: this.config.name } : {}),\n                msg: message,\n                ...context,\n            });\n        } else if (this.config.format === 'text') {\n            const parts = [ts, level.toUpperCase(), message];\n            if (hasContext) parts.push(JSON.stringify(context));\n            line = parts.join(' | ');\n        } else {\n            // pretty\n            const color = LEVEL_COLORS[level] || '';\n            const label = this.config.name ? `[${this.config.name}] ` : '';\n            line = `${color}${ts} ${level.toUpperCase()}${RESET} ${label}${message}`;\n            if (hasContext) line += ` ${JSON.stringify(context)}`;\n        }\n\n        const out = line + '\\n';\n\n        // Browser-safe output: prefer process streams when available, otherwise\n        // fall back to console. The previous unguarded `process.stderr?.write`\n        // throws `ReferenceError: process is not defined` in browsers because\n        // `process` itself is the missing global, not just its `stderr` field.\n        if (typeof process !== 'undefined' && (process as any).stderr) {\n            if (level === 'error' || level === 'fatal') {\n                (process as any).stderr.write(out);\n            } else {\n                (process as any).stdout?.write(out);\n            }\n        } else if (typeof console !== 'undefined') {\n            const fn =\n                level === 'error' || level === 'fatal' ? console.error\n                : level === 'warn' ? console.warn\n                : level === 'debug' ? console.debug\n                : console.log;\n            fn(line);\n        }\n\n        if (this.fileStream) {\n            this.fileStream.write(out);\n        }\n    }\n\n    debug(message: string, meta?: Record<string, any>): void {\n        this.write('debug', message, meta);\n    }\n\n    info(message: string, meta?: Record<string, any>): void {\n        this.write('info', message, meta);\n    }\n\n    warn(message: string, meta?: Record<string, any>): void {\n        this.write('warn', message, meta);\n    }\n\n    error(message: string, errorOrMeta?: Error | Record<string, any>, meta?: Record<string, any>): void {\n        if (errorOrMeta instanceof Error) {\n            this.write('error', message, meta, errorOrMeta);\n        } else {\n            this.write('error', message, errorOrMeta);\n        }\n    }\n\n    fatal(message: string, errorOrMeta?: Error | Record<string, any>, meta?: Record<string, any>): void {\n        if (errorOrMeta instanceof Error) {\n            this.write('fatal', message, meta, errorOrMeta);\n        } else {\n            this.write('fatal', message, errorOrMeta);\n        }\n    }\n\n    log(message: string, ...args: any[]): void {\n        this.info(message, args.length > 0 ? { args } : undefined);\n    }\n\n    child(context: Record<string, any>): ObjectLogger {\n        const child = new ObjectLogger(this.config, { ...this.bindings, ...context });\n        // Share the file stream — no double-open\n        child.fileStream = this.fileStream;\n        return child;\n    }\n\n    withTrace(traceId: string, spanId?: string): ObjectLogger {\n        return this.child({ traceId, spanId });\n    }\n\n    async destroy(): Promise<void> {\n        if (this.fileStream) {\n            await new Promise<void>((resolve) => this.fileStream.end(resolve));\n            this.fileStream = undefined;\n        }\n    }\n}\n\nexport function createLogger(config?: Partial<LoggerConfig>): ObjectLogger {\n    return new ObjectLogger(config);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/core",
-  "version": "4.0.3",
+  "version": "4.0.5",
   "license": "Apache-2.0",
   "description": "Microkernel Core for ObjectStack",
   "type": "module",
@@ -11,29 +11,50 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./logger": {
+      "types": "./dist/logger.d.ts",
+      "import": "./dist/logger.js",
+      "require": "./dist/logger.cjs"
     }
   },
   "devDependencies": {
-    "@types/node": "^25.6.0",
-    "typescript": "^6.0.2",
-    "vitest": "^4.1.4"
+    "@types/node": "^25.6.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
   },
   "dependencies": {
-    "pino": "^10.3.1",
-    "pino-pretty": "^13.1.3",
-    "zod": "^4.3.6",
-    "@objectstack/spec": "4.0.3"
+    "zod": "^4.4.3",
+    "@objectstack/spec": "4.0.5"
   },
-  "peerDependencies": {
-    "pino": "^8.0.0"
+  "keywords": [
+    "objectstack",
+    "kernel",
+    "microkernel",
+    "plugin",
+    "dependency-injection",
+    "event-bus"
+  ],
+  "author": "ObjectStack",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/objectstack-ai/framework.git",
+    "directory": "packages/core"
   },
-  "peerDependenciesMeta": {
-    "pino": {
-      "optional": true
-    }
+  "homepage": "https://objectstack.ai/docs",
+  "bugs": "https://github.com/objectstack-ai/framework/issues",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
   },
   "scripts": {
-    "build": "tsup --config ../../tsup.config.ts",
+    "build": "tsup",
     "test": "vitest run",
     "test:watch": "vitest"
   }

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-
-> @objectstack/core@4.0.3 build /home/runner/work/framework/framework/packages/core
-> tsup --config ../../tsup.config.ts
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/framework/framework/tsup.config.ts
-CLI Target: es2020
-CLI Cleaning output folder
-ESM Build start
-CJS Build start
-ESM dist/index.js     152.14 KB
-ESM dist/index.js.map 322.73 KB
-ESM ⚡️ Build success in 67ms
-CJS dist/index.cjs     155.32 KB
-CJS dist/index.cjs.map 324.45 KB
-CJS ⚡️ Build success in 75ms
-DTS Build start
-DTS ⚡️ Build success in 2677ms
-DTS dist/index.d.ts  64.24 KB
-DTS dist/index.d.cts 64.24 KB