@dxos/log 0.10.0 → 0.11.0

package/dist/lib/node-esm/index.mjs

@@ -1,668 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-import {
-  LogEntry,
-  LogLevel,
-  LogProcessorType,
-  gatherLogInfoFromScope,
-  getContextFromEntry,
-  getRelativeFilename,
-  levels,
-  logInfo,
-  shortLevelName,
-  shouldLog
-} from "./chunk-RKEZ3A6V.mjs";
-import {
-  __export,
-  __reExport
-} from "./chunk-2SZHAWBN.mjs";
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  BROWSER_PROCESSOR: () => BROWSER_PROCESSOR,
-  DEBUG_PROCESSOR: () => DEBUG_PROCESSOR,
-  LOG_META_MARKER: () => LOG_META_MARKER,
-  LogBuffer: () => LogBuffer,
-  LogEntry: () => LogEntry,
-  LogLevel: () => LogLevel,
-  LogProcessorType: () => LogProcessorType,
-  createLog: () => createLog,
-  dbg: () => dbg,
-  debug: () => debug,
-  gatherLogInfoFromScope: () => gatherLogInfoFromScope,
-  getContextFromEntry: () => getContextFromEntry,
-  getCurrentOwnershipScope: () => getCurrentOwnershipScope,
-  getRelativeFilename: () => getRelativeFilename,
-  inferEnvironmentName: () => inferEnvironmentName,
-  isLogMeta: () => isLogMeta,
-  levels: () => levels,
-  log: () => log,
-  logInfo: () => logInfo,
-  omit: () => omit,
-  parseFilter: () => parseFilter,
-  pick: () => pick,
-  serializeToJsonl: () => serializeToJsonl,
-  shortLevelName: () => shortLevelName,
-  shouldLog: () => shouldLog
-});
-import { omit, pick } from "@dxos/util";
-
-// src/environment.ts
-var TAB_SUFFIX_STORAGE_KEY = "@dxos/log:env-suffix";
-var SUFFIX_LENGTH = 6;
-var randomSuffix = () => {
-  const cryptoRef = globalThis.crypto;
-  if (cryptoRef?.getRandomValues) {
-    const bytes = new Uint8Array(SUFFIX_LENGTH);
-    cryptoRef.getRandomValues(bytes);
-    let suffix = "";
-    for (const byte of bytes) {
-      suffix += (byte % 36).toString(36);
-    }
-    return suffix;
-  }
-  return Math.random().toString(36).slice(2, 2 + SUFFIX_LENGTH).padEnd(SUFFIX_LENGTH, "0");
-};
-var getOrCreateTabSuffix = (session) => {
-  if (!session) {
-    return randomSuffix();
-  }
-  try {
-    const existing = session.getItem(TAB_SUFFIX_STORAGE_KEY);
-    if (existing && existing.length > 0) {
-      return existing;
-    }
-    const suffix = randomSuffix();
-    session.setItem(TAB_SUFFIX_STORAGE_KEY, suffix);
-    return suffix;
-  } catch {
-    return randomSuffix();
-  }
-};
-var isInstanceOf = (scope, ctorName) => {
-  const ctor = scope?.[ctorName];
-  return typeof ctor === "function" && scope instanceof ctor;
-};
-var CF_WORKER_USER_AGENT = "Cloudflare-Workers";
-var inferEnvironmentName = (options = {}) => {
-  const scope = options.scope ?? globalThis;
-  if (scope.navigator?.userAgent === CF_WORKER_USER_AGENT) {
-    return `cf-worker::${randomSuffix()}`;
-  }
-  if (isInstanceOf(scope, "SharedWorkerGlobalScope")) {
-    return `shared-worker:${scope.name ?? ""}:${randomSuffix()}`;
-  }
-  if (isInstanceOf(scope, "ServiceWorkerGlobalScope")) {
-    return `service-worker::${randomSuffix()}`;
-  }
-  if (isInstanceOf(scope, "DedicatedWorkerGlobalScope")) {
-    return `dedicated-worker:${scope.name ?? ""}:${randomSuffix()}`;
-  }
-  if (scope.window !== void 0 && scope.window === scope) {
-    const origin = scope.location?.origin ?? "";
-    return `tab:${origin}:${getOrCreateTabSuffix(scope.sessionStorage)}`;
-  }
-  const proc = scope.process;
-  if (proc && typeof proc === "object" && proc.versions?.node) {
-    const pid = typeof proc.pid === "number" ? String(proc.pid) : "";
-    return `node:${pid}:${randomSuffix()}`;
-  }
-  return `unknown::${randomSuffix()}`;
-};
-
-// src/jsonl.ts
-var serializeToJsonl = (entry, opts = {}) => {
-  if (entry.level <= LogLevel.TRACE) {
-    return void 0;
-  }
-  const { filename, line, context: scopeName } = entry.computedMeta;
-  const record = {
-    t: new Date(entry.timestamp).toISOString(),
-    l: shortLevelName[entry.level] ?? "?",
-    m: entry.message ?? ""
-  };
-  if (filename !== void 0) {
-    record.f = filename;
-  }
-  if (line !== void 0) {
-    record.n = line;
-  }
-  if (scopeName !== void 0) {
-    record.o = scopeName;
-  }
-  if (entry.computedError !== void 0) {
-    record.e = entry.computedError;
-  }
-  if (opts.env !== void 0) {
-    record.i = opts.env;
-  }
-  const computedContext = entry.computedContext;
-  if (Object.keys(computedContext).length > 0) {
-    try {
-      record.c = JSON.stringify(computedContext);
-    } catch {
-    }
-  }
-  try {
-    return JSON.stringify(record);
-  } catch {
-    return void 0;
-  }
-};
-
-// src/decorators.ts
-import chalk from "chalk";
-import { inspect } from "node:util";
-var nextPromiseId = 0;
-var createMethodLogDecorator = (log2) => (arg0, arg1, meta) => (target, propertyKey, descriptor) => {
-  const method = descriptor.value;
-  const methodName = propertyKey;
-  descriptor.value = function(...args) {
-    const combinedMeta = {
-      F: "",
-      L: 0,
-      ...meta ?? {},
-      S: this
-    };
-    const formattedArgs = args.map((arg) => inspect(arg, false, 1, true)).join(", ");
-    try {
-      const startTime = performance.now();
-      const result = method.apply(this, args);
-      if (isThenable(result)) {
-        const id = nextPromiseId++;
-        logAsyncBegin(log2, methodName, formattedArgs, id, combinedMeta);
-        result.then((resolvedValue) => {
-          logAsyncResolved(log2, methodName, resolvedValue, id, startTime, combinedMeta);
-        }, (err) => {
-          logAsyncRejected(log2, methodName, err, id, startTime, combinedMeta);
-        });
-      } else {
-        logSyncCall(log2, methodName, formattedArgs, result, combinedMeta);
-      }
-      return result;
-    } catch (err) {
-      logSyncError(log2, methodName, formattedArgs, err, combinedMeta);
-      throw err;
-    }
-  };
-  Object.defineProperty(descriptor.value, "name", {
-    value: methodName + "$log"
-  });
-};
-var createFunctionLogDecorator = (log2) => (name, fn, opts = {}) => {
-  const decoratedFn = function(...args) {
-    const combinedMeta = {
-      F: "",
-      L: 0
-    };
-    const formattedArgs = args.map((arg) => inspect(arg, false, 1, true)).join(", ");
-    try {
-      const startTime = performance.now();
-      const result = fn.apply(this, args);
-      let transformedResult = result;
-      if (opts.transformOutput) {
-        if (isThenable(result)) {
-          transformedResult = result.then(opts.transformOutput);
-        } else {
-          transformedResult = opts.transformOutput(result);
-        }
-      }
-      if (isThenable(transformedResult)) {
-        const id = nextPromiseId++;
-        logAsyncBegin(log2, name, formattedArgs, id, combinedMeta);
-        transformedResult.then((resolvedValue) => {
-          logAsyncResolved(log2, name, resolvedValue, id, startTime, combinedMeta);
-        }, (err) => {
-          logAsyncRejected(log2, name, err, id, startTime, combinedMeta);
-        });
-      } else {
-        logSyncCall(log2, name, formattedArgs, transformedResult, combinedMeta);
-      }
-      return result;
-    } catch (err) {
-      logSyncError(log2, name, formattedArgs, err, combinedMeta);
-      throw err;
-    }
-  };
-  Object.defineProperty(decoratedFn, "name", {
-    value: name + "$log"
-  });
-  return decoratedFn;
-};
-var isThenable = (obj) => obj && typeof obj.then === "function";
-var logSyncCall = (log2, methodName, formattedArgs, result, combinedMeta) => {
-  log2.info(`.${formatFunction(methodName)} (${formattedArgs}) ${chalk.gray("=>")} ${inspect(result, false, 1, true)}`, {}, combinedMeta);
-};
-var logSyncError = (log2, methodName, formattedArgs, err, combinedMeta) => {
-  log2.error(`.${formatFunction(methodName)} (${formattedArgs}) \u{1F525} ${err}`, {}, combinedMeta);
-};
-var logAsyncBegin = (log2, methodName, formattedArgs, promiseId, combinedMeta) => {
-  log2.info(`.${formatFunction(methodName)} \u21B4 (${formattedArgs}) ${chalk.gray("=>")} ${formatPromise(promiseId)}`, {}, combinedMeta);
-};
-var logAsyncResolved = (log2, methodName, resolvedValue, promiseId, startTime, combinedMeta) => {
-  if (resolvedValue !== void 0) {
-    log2.info(`.${formatFunction(methodName)} \u21B2 ${greenCheck} ${chalk.gray("resolve")} ${formatPromise(promiseId)} ${formatTimeElapsed(startTime)} ${chalk.gray("=>")} ${inspect(resolvedValue, false, 1, true)}`, {}, combinedMeta);
-  } else {
-    log2.info(`.${formatFunction(methodName)} \u21B2 ${greenCheck} ${chalk.gray("resolve")} ${formatPromise(promiseId)} ${formatTimeElapsed(startTime)}`, {}, combinedMeta);
-  }
-};
-var logAsyncRejected = (log2, methodName, err, promiseId, startTime, combinedMeta) => {
-  log2.info(`.${formatFunction(methodName)} \u21B2 \u{1F525} ${chalk.gray("reject")} ${formatPromise(promiseId)} ${formatTimeElapsed(startTime)} ${chalk.gray("=>")} ${err}`, {}, combinedMeta);
-};
-var COLOR_FUNCTION = [
-  220,
-  220,
-  170
-];
-var greenCheck = typeof chalk.green === "function" ? chalk.green("\u2714") : "\u2714";
-var formatTimeElapsed = (startTime) => chalk.gray(`${(performance.now() - startTime).toFixed(0)}ms`);
-var formatFunction = (name) => chalk.bold(chalk.rgb(...COLOR_FUNCTION)(name));
-var formatPromise = (id) => chalk.blue(`Promise#${id}`);
-
-// src/options.ts
-import defaultsDeep from "lodash.defaultsdeep";
-
-// src/platform/index.ts
-var platform_exports = {};
-__reExport(platform_exports, platform_star);
-import * as platform_star from "#platform";
-
-// src/processors/index.ts
-var processors_exports = {};
-__export(processors_exports, {
-  BROWSER_PROCESSOR: () => BROWSER_PROCESSOR,
-  DEBUG_PROCESSOR: () => DEBUG_PROCESSOR,
-  getRelativeFilename: () => getRelativeFilename
-});
-
-// src/processors/browser-processor.ts
-import { safariCheck } from "@dxos/util";
-var CONFIG = {
-  useTestProcessor: false,
-  printFileLinks: false
-};
-var APP_BROWSER_PROCESSOR = (config, entry) => {
-  if (!shouldLog(entry, config.filters)) {
-    return;
-  }
-  const LOG_BROWSER_PREFIX = config.prefix ?? "https://vscode.dev/github.com/dxos/dxos/blob/main/";
-  const LOG_BROWSER_CSS = [];
-  const { filename, line: lineNumber, context: scopeDebugName } = entry.computedMeta;
-  let link = "";
-  if (filename !== void 0 && lineNumber !== void 0) {
-    const filepath = `${LOG_BROWSER_PREFIX.replace(/\/$/, "")}/${filename}`;
-    link = `${filepath}#L${lineNumber}`;
-  }
-  let args = [];
-  const scope = entry.meta?.S;
-  if (scope) {
-    const scopeName = scope.name || scopeDebugName;
-    if (scopeName) {
-      const processPrefix = scope.hostSessionId ? "[worker] " : "";
-      args.push(`%c${processPrefix}${scopeName}`, "color:#C026D3;font-weight:bold");
-    }
-  }
-  if (entry.message) {
-    args.push(entry.message);
-  }
-  const context = getContextFromEntry(entry);
-  if (context) {
-    if (Object.keys(context).length === 1 && "error" in context) {
-      args.push(unwrapEffectError(context.error));
-    } else if (Object.keys(context).length === 1 && "err" in context) {
-      args.push(unwrapEffectError(context.err));
-    } else {
-      args.push(context);
-    }
-  }
-  const levels2 = {
-    [LogLevel.ERROR]: console.error.bind(console),
-    [LogLevel.WARN]: console.warn.bind(console),
-    [LogLevel.DEBUG]: console.log.bind(console)
-  };
-  if (CONFIG.printFileLinks || safariCheck()) {
-    if (LOG_BROWSER_CSS?.length) {
-      args = [
-        `%c${link}
-%c${args.join(" ")}`,
-        ...LOG_BROWSER_CSS
-      ];
-    } else {
-      args = [
-        link + "\n",
-        ...args
-      ];
-    }
-  }
-  const level = levels2[entry.level] ?? console.log.bind(console);
-  if (typeof entry.meta?.C === "function") {
-    entry.meta.C(level, args);
-  } else {
-    level(...args);
-  }
-};
-var TEST_BROWSER_PROCESSOR = (config, entry) => {
-  if (!shouldLog(entry, config.filters)) {
-    return;
-  }
-  const { filename, line: lineNumber } = entry.computedMeta;
-  const path = filename !== void 0 && lineNumber !== void 0 ? `${filename}:${lineNumber}` : "";
-  let args = [];
-  const processPrefix = entry.meta?.S?.hostSessionId ? "[worker] " : "";
-  args.push(`${processPrefix}${entry.message}`);
-  const context = getContextFromEntry(entry);
-  if (context) {
-    args.push(context);
-  }
-  const levels2 = {
-    [LogLevel.ERROR]: console.error,
-    [LogLevel.WARN]: console.warn,
-    [LogLevel.DEBUG]: console.log
-  };
-  if (CONFIG.printFileLinks) {
-    args = [
-      path,
-      ...args
-    ];
-  }
-  const level = levels2[entry.level] ?? console.log;
-  if (typeof entry.meta?.C === "function") {
-    entry.meta.C(level, args);
-  } else {
-    level(...args);
-  }
-};
-var BROWSER_PROCESSOR = CONFIG.useTestProcessor ? TEST_BROWSER_PROCESSOR : APP_BROWSER_PROCESSOR;
-var originalSymbol = /* @__PURE__ */ Symbol.for("effect/OriginalAnnotation");
-var unwrapEffectError = (error) => {
-  if (typeof error === "object" && error !== null && originalSymbol in error) {
-    return error[originalSymbol];
-  }
-  return error;
-};
-
-// src/processors/index.ts
-__reExport(processors_exports, console_processor_star);
-import * as console_processor_star from "#console-processor";
-
-// src/processors/debug-processor.ts
-import { inspect as inspect2 } from "node:util";
-var DEBUG_PROCESSOR = (config, entry) => {
-  console.log(inspect2(entry, false, null, true));
-};
-
-// src/options.ts
-var processors = {
-  [LogProcessorType.CONSOLE]: processors_exports.CONSOLE_PROCESSOR,
-  [LogProcessorType.BROWSER]: BROWSER_PROCESSOR,
-  [LogProcessorType.DEBUG]: DEBUG_PROCESSOR
-};
-var browser = (typeof window !== "undefined" || typeof navigator !== "undefined") && !(typeof process !== "undefined" && process?.env?.VITEST);
-var DEFAULT_PROCESSORS = [
-  browser ? BROWSER_PROCESSOR : processors_exports.CONSOLE_PROCESSOR
-];
-var parseLogLevel = (level, defValue = LogLevel.WARN) => levels[level.toLowerCase()] ?? defValue;
-var parseFilter = (filter) => {
-  if (typeof filter === "number") {
-    return [
-      {
-        level: filter
-      }
-    ];
-  }
-  const lines = typeof filter === "string" ? filter.split(/,\s*/) : filter;
-  return lines.map((filter2) => {
-    const [pattern, level] = filter2.split(":");
-    return level ? {
-      level: parseLogLevel(level),
-      pattern
-    } : {
-      level: parseLogLevel(pattern)
-    };
-  });
-};
-var createConfig = (options) => {
-  const envOptions = "process" in globalThis ? {
-    file: process.env.LOG_CONFIG,
-    filter: process.env.LOG_FILTER,
-    processor: process.env.LOG_PROCESSOR
-  } : void 0;
-  const mergedOptions = defaultsDeep({}, (0, platform_exports.loadOptions)(envOptions?.file), envOptions, options);
-  return {
-    options: mergedOptions,
-    filters: parseFilter(mergedOptions.filter ?? LogLevel.INFO),
-    captureFilters: parseFilter(mergedOptions.captureFilter ?? LogLevel.WARN),
-    processors: mergedOptions.processor ? [
-      processors[mergedOptions.processor]
-    ] : [
-      ...DEFAULT_PROCESSORS
-    ],
-    prefix: mergedOptions.prefix
-  };
-};
-
-// src/log.ts
-var logCount = 0;
-var createLog = () => {
-  const log2 = (...params) => processLog(LogLevel.DEBUG, ...params);
-  Object.assign(log2, {
-    _id: `log-${++logCount}`,
-    _config: createConfig()
-  });
-  Object.defineProperty(log2, "runtimeConfig", {
-    get: () => log2._config
-  });
-  const processLog = (level, message, context = {}, meta, error) => {
-    const entry = new LogEntry({
-      level,
-      message,
-      context,
-      meta,
-      error
-    });
-    log2._config.processors.forEach((processor) => processor(log2._config, entry));
-  };
-  Object.assign(log2, {
-    /**
-    * Update config.
-    * NOTE: Preserves any processors that were already added to this logger instance
-    * unless an explicit processor option is provided.
-    */
-    config: ({ processor, ...options } = {}) => {
-      const config = createConfig(options);
-      const processors2 = processor ? config.processors : log2._config.processors;
-      log2._config = {
-        ...config,
-        processors: processors2
-      };
-      return log2;
-    },
-    /**
-    * Adds a processor to the logger.
-    */
-    addProcessor: (processor) => {
-      if (log2._config.processors.filter((p) => p === processor).length === 0) {
-        log2._config.processors.push(processor);
-      }
-      return () => {
-        log2._config.processors = log2._config.processors.filter((p) => p !== processor);
-      };
-    },
-    trace: (...params) => processLog(LogLevel.TRACE, ...params),
-    debug: (...params) => processLog(LogLevel.DEBUG, ...params),
-    verbose: (...params) => processLog(LogLevel.VERBOSE, ...params),
-    info: (...params) => processLog(LogLevel.INFO, ...params),
-    warn: (...params) => processLog(LogLevel.WARN, ...params),
-    error: (...params) => processLog(LogLevel.ERROR, ...params),
-    catch: (error, context, meta) => processLog(LogLevel.ERROR, void 0, context, meta, error),
-    method: createMethodLogDecorator(log2),
-    function: createFunctionLogDecorator(log2),
-    break: () => log2.info("-".repeat(80)),
-    stack: (message, context, meta) => {
-      return processLog(LogLevel.INFO, `${message ?? "Stack Dump"}
-${getFormattedStackTrace()}`, context, meta);
-    }
-  });
-  return log2;
-};
-var log = globalThis.DX_LOG ??= createLog();
-var start = Date.now();
-var last = start;
-var debug = (label, args) => {
-  const now = Date.now();
-  const err = new Error();
-  console.group(`DEBUG[${label}]`, JSON.stringify({
-    t: Number(now - start).toLocaleString(),
-    dt: Number(now - last).toLocaleString(),
-    ...args
-  }));
-  console.warn(err.stack);
-  console.groupEnd();
-  last = Date.now();
-};
-var getFormattedStackTrace = () => new Error().stack.split("\n").slice(3).join("\n");
-
-// src/index.ts
-__reExport(index_exports, processors_exports);
-
-// src/meta.ts
-var LOG_META_MARKER = "~LogMeta";
-var isLogMeta = (value) => {
-  return value != null && typeof value === "object" && value[LOG_META_MARKER] === LOG_META_MARKER;
-};
-
-// src/dbg.ts
-var dbg = (arg, meta) => {
-  if (meta?.A) {
-    console.log(`${meta.A[0]} =`, arg);
-  } else {
-    console.log(arg);
-  }
-  return arg;
-};
-
-// src/log-buffer.ts
-import { CircularBuffer } from "@dxos/util";
-var DEFAULT_BUFFER_SIZE = 2e3;
-var MAX_CONTEXT_LENGTH = 500;
-var LogBuffer = class {
-  _buffer;
-  constructor(size = DEFAULT_BUFFER_SIZE) {
-    this._buffer = new CircularBuffer(size);
-  }
-  /**
-  * Log processor that can be registered with `log.runtimeConfig.processors`.
-  * Captures every level except TRACE (does not apply `shouldLog` / filter; use for full debug dumps).
-  */
-  logProcessor = (_config, entry) => {
-    if (entry.level <= LogLevel.TRACE) {
-      return;
-    }
-    const { filename, line, context: scopeName } = entry.computedMeta;
-    const record = {
-      t: new Date(entry.timestamp).toISOString(),
-      l: shortLevelName[entry.level] ?? "?",
-      m: entry.message ?? ""
-    };
-    if (filename !== void 0) {
-      record.f = filename;
-    }
-    if (line !== void 0) {
-      record.n = line;
-    }
-    if (scopeName !== void 0) {
-      record.o = scopeName;
-    }
-    if (entry.computedError !== void 0) {
-      record.e = entry.computedError;
-    }
-    const computedContext = entry.computedContext;
-    if (Object.keys(computedContext).length > 0) {
-      try {
-        let json = JSON.stringify(computedContext);
-        if (json.length > MAX_CONTEXT_LENGTH) {
-          json = json.slice(0, MAX_CONTEXT_LENGTH);
-        }
-        record.c = json;
-      } catch {
-      }
-    }
-    this._buffer.push(record);
-  };
-  /** Number of entries currently in the buffer. */
-  get size() {
-    return this._buffer.elementCount;
-  }
-  /** Discard all buffered entries. */
-  clear() {
-    this._buffer.clear();
-  }
-  /** Serialize buffer contents as NDJSON (newline-delimited JSON). */
-  serialize() {
-    const lines = [];
-    for (const record of this._buffer) {
-      lines.push(JSON.stringify(record));
-    }
-    return lines.join("\n");
-  }
-};
-
-// src/experimental/ownership.ts
-import { inspect as inspect3 } from "node:util";
-var kDebugInfoProperties = /* @__PURE__ */ Symbol("kDebugInfoProperties");
-var OwnershipScope = class {
-  constr;
-  parent;
-  instance;
-  constructor(constr, parent) {
-    this.constr = constr;
-    this.parent = parent;
-  }
-  getInfo() {
-    if (!this.instance) {
-      return {};
-    }
-    const props = this.constr.prototype[kDebugInfoProperties] ?? [];
-    const info = {};
-    for (const prop of props) {
-      info[prop] = this.instance[prop];
-    }
-    return info;
-  }
-  [inspect3.custom]() {
-    return {
-      className: this.constr.name,
-      info: this.getInfo(),
-      parent: this.parent
-    };
-  }
-};
-var getCurrentOwnershipScope = (thisRef) => thisRef;
-export {
-  BROWSER_PROCESSOR,
-  DEBUG_PROCESSOR,
-  LOG_META_MARKER,
-  LogBuffer,
-  LogEntry,
-  LogLevel,
-  LogProcessorType,
-  createLog,
-  dbg,
-  debug,
-  gatherLogInfoFromScope,
-  getContextFromEntry,
-  getCurrentOwnershipScope,
-  getRelativeFilename,
-  inferEnvironmentName,
-  isLogMeta,
-  levels,
-  log,
-  logInfo,
-  omit,
-  parseFilter,
-  pick,
-  serializeToJsonl,
-  shortLevelName,
-  shouldLog
-};
-//# sourceMappingURL=index.mjs.map