@dxos/log 0.8.4-main.fbb7a13 → 0.8.4-main.fcfe5033a5

package/dist/lib/node-esm/processors/console-processor.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/processors/console-processor.ts"],
-  "sourcesContent": ["//\n// Copyright 2022 DXOS.org\n//\n\nimport { inspect } from 'node:util';\n\nimport chalk from 'chalk';\n\nimport { getPrototypeSpecificInstanceId, pickBy } from '@dxos/util';\n\nimport { type LogConfig, LogLevel, shortLevelName } from '../config';\nimport { type LogProcessor, getContextFromEntry, shouldLog } from '../context';\n\nimport { getRelativeFilename } from './common';\n\nconst LEVEL_COLORS: Record<LogLevel, typeof chalk.ForegroundColor> = {\n  [LogLevel.TRACE]: 'gray',\n  [LogLevel.DEBUG]: 'gray',\n  [LogLevel.VERBOSE]: 'gray',\n  [LogLevel.INFO]: 'white',\n  [LogLevel.WARN]: 'yellow',\n  [LogLevel.ERROR]: 'red',\n};\n\nexport const truncate = (text?: string, length = 0, right = false) => {\n  const str = text && length ? (right ? text.slice(-length) : text.substring(0, length)) : (text ?? '');\n  return right ? str.padStart(length, ' ') : str.padEnd(length, ' ');\n};\n\n// TODO(burdon): Optional package name.\n// TODO(burdon): Show exceptions on one line.\nexport type FormatParts = {\n  path?: string;\n  line?: number;\n  timestamp?: string;\n  level: LogLevel;\n  message?: string;\n  context?: any;\n  error?: Error;\n  scope?: any;\n};\n\nexport type Formatter = (config: LogConfig, parts: FormatParts) => (string | undefined)[];\n\nexport const DEFAULT_FORMATTER: Formatter = (\n  config,\n  { path, line, level, message, context, error, scope },\n): string[] => {\n  const column = config.options?.formatter?.column;\n  const filepath = path !== undefined && line !== undefined ? chalk.grey(`${path}:${line}`) : undefined;\n\n  let instance;\n  if (scope) {\n    const prototype = Object.getPrototypeOf(scope);\n    if (prototype !== null) {\n      const id = getPrototypeSpecificInstanceId(scope);\n      instance = chalk.magentaBright(`${prototype.constructor.name}#${id}`);\n    }\n  }\n\n  const formattedTimestamp = config.options?.formatter?.timestamp ? new Date().toISOString() : undefined;\n  const formattedLevel = chalk[LEVEL_COLORS[level]](column ? shortLevelName[level] : LogLevel[level]);\n  const padding = column && filepath ? ''.padStart(column - filepath.length) : undefined;\n\n  return config.options?.formatter?.timestampFirst\n    ? [formattedTimestamp, filepath, padding, formattedLevel, instance, message, context, error]\n    : [\n        // NOTE: File path must come fist for console hyperlinks.\n        // Must not truncate for terminal output.\n        filepath,\n        padding,\n        formattedTimestamp,\n        formattedLevel,\n        instance,\n        message,\n        context,\n        error,\n      ];\n};\n\nexport const SHORT_FORMATTER: Formatter = (config, { path, level, message }) => {\n  return [\n    chalk.grey(truncate(path, 16, true)), // NOTE: Breaks terminal linking.\n    chalk[LEVEL_COLORS[level]](shortLevelName[level]),\n    message,\n  ];\n};\n\n// TODO(burdon): Config option.\nconst formatter = DEFAULT_FORMATTER;\n\nexport const CONSOLE_PROCESSOR: LogProcessor = (config, entry) => {\n  const { level, message, meta, error } = entry;\n  if (!shouldLog(entry, config.filters)) {\n    return;\n  }\n\n  const parts: FormatParts = {\n    level,\n    message,\n    error,\n    path: undefined,\n    line: undefined,\n    scope: undefined,\n    context: undefined,\n  };\n\n  if (meta) {\n    parts.path = getRelativeFilename(meta.F);\n    parts.line = meta.L;\n    parts.scope = meta.S;\n  }\n\n  const context = getContextFromEntry(entry);\n  if (context) {\n    // Remove undefined fields.\n    // https://nodejs.org/api/util.html#utilinspectobject-options\n    parts.context = inspect(\n      pickBy(context, (value?: unknown) => value !== undefined),\n      { depth: config.options.depth, colors: true, maxArrayLength: 8, sorted: false },\n    );\n  }\n\n  const line = formatter(config, parts).filter(Boolean).join(' ');\n  console.log(line);\n};\n"],
-  "mappings": "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",
-  "names": ["inspect", "chalk", "getPrototypeSpecificInstanceId", "pickBy", "LEVEL_COLORS", "LogLevel", "TRACE", "DEBUG", "VERBOSE", "INFO", "WARN", "ERROR", "truncate", "text", "length", "right", "str", "slice", "substring", "padStart", "padEnd", "DEFAULT_FORMATTER", "config", "path", "line", "level", "message", "context", "error", "scope", "column", "options", "formatter", "filepath", "undefined", "chalk", "grey", "instance", "prototype", "Object", "getPrototypeOf", "id", "getPrototypeSpecificInstanceId", "magentaBright", "name", "formattedTimestamp", "timestamp", "Date", "toISOString", "formattedLevel", "shortLevelName", "padding", "timestampFirst", "SHORT_FORMATTER", "CONSOLE_PROCESSOR", "entry", "meta", "shouldLog", "filters", "parts", "getRelativeFilename", "F", "L", "S", "getContextFromEntry", "inspect", "pickBy", "value", "depth", "colors", "maxArrayLength", "sorted", "filter", "Boolean", "join", "console", "log"]
+  "sourcesContent": ["//\n// Copyright 2022 DXOS.org\n//\n\nimport chalk from 'chalk';\nimport { inspect } from 'node:util';\n\nimport { getPrototypeSpecificInstanceId, pickBy } from '@dxos/util';\n\nimport { type LogConfig, LogLevel, shortLevelName } from '../config';\nimport { type LogProcessor, getContextFromEntry, shouldLog } from '../context';\nimport { getRelativeFilename } from './common';\n\nconst LEVEL_COLORS: Record<LogLevel, typeof chalk.ForegroundColor> = {\n  [LogLevel.TRACE]: 'gray',\n  [LogLevel.DEBUG]: 'gray',\n  [LogLevel.VERBOSE]: 'gray',\n  [LogLevel.INFO]: 'white',\n  [LogLevel.WARN]: 'yellow',\n  [LogLevel.ERROR]: 'red',\n};\n\nexport const truncate = (text?: string, length = 0, right = false) => {\n  const str = text && length ? (right ? text.slice(-length) : text.substring(0, length)) : (text ?? '');\n  return right ? str.padStart(length, ' ') : str.padEnd(length, ' ');\n};\n\n// TODO(burdon): Optional package name.\n// TODO(burdon): Show exceptions on one line.\nexport type FormatParts = {\n  path?: string;\n  line?: number;\n  timestamp?: string;\n  level: LogLevel;\n  message?: string;\n  context?: any;\n  error?: Error;\n  scope?: any;\n};\n\nexport type Formatter = (config: LogConfig, parts: FormatParts) => (string | undefined)[];\n\nexport const DEFAULT_FORMATTER: Formatter = (\n  config,\n  { path, line, level, message, context, error, scope },\n): string[] => {\n  const column = config.options?.formatter?.column;\n  const filepath = path !== undefined && line !== undefined ? chalk.grey(`${path}:${line}`) : undefined;\n\n  let instance;\n  if (scope) {\n    const prototype = Object.getPrototypeOf(scope);\n    if (prototype !== null) {\n      const id = getPrototypeSpecificInstanceId(scope);\n      instance = chalk.magentaBright(`${prototype.constructor.name}#${id}`);\n    }\n  }\n\n  const formattedTimestamp = config.options?.formatter?.timestamp ? new Date().toISOString() : undefined;\n  const formattedLevel = chalk[LEVEL_COLORS[level]](column ? shortLevelName[level] : LogLevel[level]);\n  const padding = column && filepath ? ''.padStart(column - filepath.length) : undefined;\n\n  return config.options?.formatter?.timestampFirst\n    ? [formattedTimestamp, filepath, padding, formattedLevel, instance, message, context, error]\n    : [\n        // NOTE: File path must come fist for console hyperlinks.\n        // Must not truncate for terminal output.\n        filepath,\n        padding,\n        formattedTimestamp,\n        formattedLevel,\n        instance,\n        message,\n        context,\n        error,\n      ];\n};\n\nexport const SHORT_FORMATTER: Formatter = (config, { path, level, message }) => {\n  return [\n    chalk.grey(truncate(path, 16, true)), // NOTE: Breaks terminal linking.\n    chalk[LEVEL_COLORS[level]](shortLevelName[level]),\n    message,\n  ];\n};\n\n// TODO(burdon): Config option.\nconst formatter = DEFAULT_FORMATTER;\n\nexport const CONSOLE_PROCESSOR: LogProcessor = (config, entry) => {\n  const { level, message, meta, error } = entry;\n  if (!shouldLog(entry, config.filters)) {\n    return;\n  }\n\n  const parts: FormatParts = {\n    level,\n    message,\n    error,\n    path: undefined,\n    line: undefined,\n    scope: undefined,\n    context: undefined,\n  };\n\n  if (meta) {\n    parts.path = getRelativeFilename(meta.F);\n    parts.line = meta.L;\n    parts.scope = meta.S;\n  }\n\n  const context = getContextFromEntry(entry);\n  if (context) {\n    // Remove undefined fields.\n    // https://nodejs.org/api/util.html#utilinspectobject-options\n    parts.context = inspect(\n      pickBy(context, (value?: unknown) => value !== undefined),\n      { depth: config.options.depth, colors: true, maxArrayLength: 8, sorted: false },\n    );\n  }\n\n  const line = formatter(config, parts).filter(Boolean).join(' ');\n  console.log(line);\n};\n"],
+  "mappings": "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",
+  "names": ["chalk", "inspect", "getPrototypeSpecificInstanceId", "pickBy", "LEVEL_COLORS", "LogLevel", "TRACE", "DEBUG", "VERBOSE", "INFO", "WARN", "ERROR", "truncate", "text", "length", "right", "str", "slice", "substring", "padStart", "padEnd", "DEFAULT_FORMATTER", "config", "path", "line", "level", "message", "context", "error", "scope", "column", "options", "formatter", "filepath", "undefined", "chalk", "grey", "instance", "prototype", "Object", "getPrototypeOf", "id", "getPrototypeSpecificInstanceId", "magentaBright", "name", "formattedTimestamp", "timestamp", "Date", "toISOString", "formattedLevel", "shortLevelName", "padding", "timestampFirst", "SHORT_FORMATTER", "CONSOLE_PROCESSOR", "entry", "meta", "shouldLog", "filters", "parts", "getRelativeFilename", "F", "L", "S", "getContextFromEntry", "inspect", "pickBy", "value", "depth", "colors", "maxArrayLength", "sorted", "filter", "Boolean", "join", "console", "log"]
 }

package/dist/types/src/dbg.d.ts

@@ -0,0 +1,23 @@
+import { type CallMetadata } from './meta';
+/**
+ * Debug-log value to console.
+ * Log's the expression being evaluated.
+ *
+ * If only one argument is provided, it will also be returned.
+ *
+ * @example
+ * ```ts
+ * dbg(foo, bar);
+ * // foo = 1
+ * // bar = 2
+ *
+ * bar = dbg(foo * 2);
+ * // foo * 2 = 2
+ * ```
+ *
+ * NOTE: The second argument is injected by the log transform plugin.
+ */
+export declare const dbg: {
+    <T>(value: T, _meta?: CallMetadata): T;
+};
+//# sourceMappingURL=dbg.d.ts.map

package/dist/types/src/dbg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbg.d.ts","sourceRoot":"","sources":["../../../src/dbg.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,GAAG,EAAE;IAChB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC;CASxC,CAAC"}

package/dist/types/src/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/decorators.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAI3C,eAAO,MAAM,wBAAwB,GAClC,KAAK,UAAU,MACf,OAAO,KAAK,EAAE,OAAO,KAAK,EAAE,OAAO,YAAY,KAAG,eAwClD,CAAC;AAEJ,eAAO,MAAM,0BAA0B,GACpC,KAAK,UAAU,MACf,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAChC,MAAM,MAAM,EACZ,IAAI,CAAC,EACL,OAAM;IAAE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;CAAO,KAC7E,CA6CF,CAAC"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/decorators.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAI3C,eAAO,MAAM,wBAAwB,GAClC,KAAK,UAAU,MACf,OAAO,KAAK,EAAE,OAAO,KAAK,EAAE,OAAO,YAAY,KAAG,eAwClD,CAAC;AAEJ,eAAO,MAAM,0BAA0B,GACpC,KAAK,UAAU,MACf,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAChC,MAAM,MAAM,EACZ,IAAI,CAAC,EACL,OAAM;IAAE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;CAAO,KAC7E,CA6CF,CAAC"}

package/dist/types/src/index.d.ts

@@ -1,5 +1,4 @@
-import omit from 'lodash.omit';
-import { pick } from '@dxos/util';
+import { omit, pick } from '@dxos/util';
 export { omit, pick };
 export * from './config';
 export * from './context';
@@ -8,5 +7,7 @@ export { parseFilter } from './options';
 export * from './processors';
 export * from './scope';
 export type * from './meta';
+export { dbg } from './dbg';
+export * from './log-buffer';
 export { getCurrentOwnershipScope } from './experimental/ownership';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,IAAI,MAAM,aAAa,CAAC;AAE/B,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAEtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,mBAAmB,QAAQ,CAAC;AAE5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAEtB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,mBAAmB,QAAQ,CAAC;AAC5B,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,cAAc,cAAc,CAAC;AAE7B,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/types/src/log-buffer.d.ts

@@ -0,0 +1,40 @@
+import { type LogProcessor } from './context';
+/**
+ * Compact log record with short property names for small serialized size.
+ */
+export type LogRecord = {
+    /** ISO timestamp. */
+    t: string;
+    /** Level letter (D, V, I, W, E). */
+    l: string;
+    /** Message. */
+    m: string;
+    /** File path. */
+    f?: string;
+    /** Line number. */
+    n?: number;
+    o?: string;
+    /** Error stack. */
+    e?: string;
+    /** Context JSON. */
+    c?: string;
+};
+/**
+ * Captures recent log entries in a circular buffer for debug log dump.
+ */
+export declare class LogBuffer {
+    private readonly _buffer;
+    constructor(size?: number);
+    /**
+     * 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).
+     */
+    readonly logProcessor: LogProcessor;
+    /** Number of entries currently in the buffer. */
+    get size(): number;
+    /** Discard all buffered entries. */
+    clear(): void;
+    /** Serialize buffer contents as NDJSON (newline-delimited JSON). */
+    serialize(): string;
+}
+//# sourceMappingURL=log-buffer.d.ts.map

package/dist/types/src/log-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-buffer.d.ts","sourceRoot":"","sources":["../../../src/log-buffer.ts"],"names":[],"mappings":"AAOA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAK7D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,qBAAqB;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,oCAAoC;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,eAAe;IACf,CAAC,EAAE,MAAM,CAAC;IACV,iBAAiB;IACjB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,CAAC,CAAC,EAAE,MAAM,CAAC;IAEX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAExC,IAAI,SAAsB;IAItC;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAwCjC;IAEF,iDAAiD;IACjD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,oCAAoC;IACpC,KAAK,IAAI,IAAI;IAIb,oEAAoE;IACpE,SAAS,IAAI,MAAM;CAOpB"}

package/dist/types/src/log-buffer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=log-buffer.test.d.ts.map

package/dist/types/src/log-buffer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-buffer.test.d.ts","sourceRoot":"","sources":["../../../src/log-buffer.test.ts"],"names":[],"mappings":""}

package/dist/types/src/log.d.ts

@@ -3,6 +3,8 @@ import { type LogContext, type LogProcessor } from './context';
 import { type CallMetadata } from './meta';
 /**
  * Accessible from browser console.
+ * Example: `DX_LOG.config({ filter: 'ERROR' })`
+ * NOTE: File level filtering isn't supported in storybooks.
  */
 declare global {
     const DX_LOG: Log;
@@ -15,7 +17,7 @@ type LogFunction = (message: string, context?: LogContext, meta?: CallMetadata)
  * Logging methods.
  */
 export interface LogMethods {
-    config: (options: LogOptions) => Log;
+    config: (options?: LogOptions) => Log;
     addProcessor: (processor: LogProcessor, addDefault?: boolean) => () => void;
     trace: LogFunction;
     debug: LogFunction;

package/dist/types/src/log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/log.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAG3C;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,MAAM,EAAE,GAAG,CAAC;CACnB;AAED;;GAEG;AACH,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,GAAG,CAAC;IACrC,YAAY,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;IAE5E,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAE/E,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,eAAe,CAAC;IAC7E,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC1C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,EACL,IAAI,CAAC,EAAE;QACL,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;KACjE,KACE,CAAC,CAAC;IAEP,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CACzE;AA+GD;;GAEG;AACH,eAAO,MAAM,GAAG,EAAE,GAAkD,CAAC;AAKrE;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,QAAQ,GAAG,EAAE,OAAO,GAAG,SAU5C,CAAC"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../../src/log.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE/D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAG3C;;;;GAIG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,MAAM,MAAM,EAAE,GAAG,CAAC;CACnB;AAED;;GAEG;AACH,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,UAAU,KAAK,GAAG,CAAC;IACtC,YAAY,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;IAE5E,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;IAE/E,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,eAAe,CAAC;IAC7E,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC1C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,EACL,IAAI,CAAC,EAAE;QACL,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;KACjE,KACE,CAAC,CAAC;IAEP,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CACzE;AA+GD;;GAEG;AACH,eAAO,MAAM,GAAG,EAAE,GAAkD,CAAC;AAKrE;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,QAAQ,GAAG,EAAE,OAAO,GAAG,SAU5C,CAAC"}

package/dist/types/src/platform/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/platform/node/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,WAAW,MAAM,KAAG,UAAU,GAAG,SAY5D,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/platform/node/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,WAAW,MAAM,KAAG,UAAU,GAAG,SAY5D,CAAC"}

package/dist/types/src/processors/console-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"console-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/console-processor.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAkB,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,YAAY,CAAC;AAa/E,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,EAAE,eAAU,EAAE,eAAa,WAGhE,CAAC;AAIF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;AAE1F,eAAO,MAAM,iBAAiB,EAAE,SAkC/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,SAM7B,CAAC;AAKF,eAAO,MAAM,iBAAiB,EAAE,YAkC/B,CAAC"}
+{"version":3,"file":"console-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/console-processor.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAkB,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,YAAY,CAAC;AAY/E,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,EAAE,eAAU,EAAE,eAAa,WAGhE,CAAC;AAIF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,KAAK,CAAC,EAAE,GAAG,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;AAE1F,eAAO,MAAM,iBAAiB,EAAE,SAkC/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,SAM7B,CAAC;AAKF,eAAO,MAAM,iBAAiB,EAAE,YAkC/B,CAAC"}

package/dist/types/src/processors/file-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/file-processor.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,YAAY,CAAC;AAO/E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,gCAIjC;IACD,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;CACvB,KAAG,YAoDH,CAAC;AAWF,eAAO,MAAM,cAAc,EAAE,YAG3B,CAAC"}
+{"version":3,"file":"file-processor.d.ts","sourceRoot":"","sources":["../../../../src/processors/file-processor.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,KAAK,YAAY,EAAkC,MAAM,YAAY,CAAC;AAM/E;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,gCAIjC;IACD,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;CACvB,KAAG,YAoDH,CAAC;AAWF,eAAO,MAAM,cAAc,EAAE,YAG3B,CAAC"}