standard-log 9.1.2 → 9.1.3

package/esm/types.d.ts

@@ -1,9 +1,10 @@
+import { StackTraceMeta } from '@just-func/types';
 export declare type StandardLogOptions<CustomLevelNames extends string = string> = {
     customLevels?: Record<CustomLevelNames, number>;
     logLevel?: number;
     reporters?: LogReporter[];
 };
-export interface LoggerOptions {
+export interface LoggerOptions extends StackTraceMeta {
     level?: number;
     writeTo?: LogReporter | ReporterFilter;
 }

package/esm/types.d.ts.map

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

package/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../ts/types.ts"],"names":[],"mappings":"","sourcesContent":["export type StandardLogOptions<CustomLevelNames extends string = string> = {\n  customLevels?: Record<CustomLevelNames, number>,\n  logLevel?: number,\n  reporters?: LogReporter[]\n}\n\nexport interface LoggerOptions {\n  level?: number,\n  writeTo?: LogReporter | ReporterFilter\n}\n\nexport type Logger<T extends string = LogMethodNames> = {\n  readonly id: string,\n  /**\n   * Logger local log level.\n   */\n  level?: number,\n  /**\n   * Logs with an increment counter.\n   * This is useful during debugging to check for steps executed.\n   */\n  count(...args: any[]): void,\n  on(level: number | T, logFunction: LogFunction): void,\n  /**\n   * Write custom log entries.\n   */\n  write(entry: LogEntry): void\n} & { [k in T]: LogMethod }\n\n/**\n * Names of the standard log methods.\n */\nexport type LogMethodNames = 'emergency' | 'alert' | 'critical' | 'error' | 'warn' | 'notice' | 'info' | 'debug' | 'trace' | 'planck'\n\nexport type LogEntry = {\n  id: string,\n  level: number,\n  // args instead of messages because it is `any[]` instead of `string[]`\n  args: any[],\n  timestamp: Date\n}\n\nexport type LogMethod = (...args: any[]) => void\n\nexport type LogFunction = ((log: LogMethod) => void) | (() => string)\n\nexport type ReporterFilter = string | RegExp | ((reporterId: string) => boolean)\n\n/**\n * Formats a log entry.\n * Depends on the reporter, it can expect a different return type.\n * By default the return type is `any[]` which the `console` accepts.\n */\nexport type LogFormatter<T = any[]> = (entry: LogEntry) => T\n\n/**\n * Determines whether the entry should be written.\n */\nexport type LogFilter = (entry: LogEntry) => boolean\n\nexport type LogLevelEntry = { name: string, level: number }\n\nexport interface LogReporter<T = any> {\n  readonly id: string,\n  /**\n   * Specifies the formatter to be used by the reporter.\n   * Using this you can customize how the reporter writes the log entry.\n   */\n  readonly formatter: LogFormatter<T>,\n  /**\n   * Specifies a filter to determine should the log be written.\n   */\n  readonly filter?: LogFilter,\n  /**\n   * Indicate if this is a console reporter.\n   * There is only one console reporter can be present in the system.\n   */\n  readonly isConsoleReporter?: boolean,\n  write(entry: LogEntry): void\n}\n\nexport type LogReporterOptions<T = any> = {\n  id?: string,\n  /**\n   * Specifies the formatter to be used by the reporter.\n   * Using this you can customize how the reporter writes the log entry.\n   */\n  formatter?: LogFormatter<T>,\n  /**\n   * Specifies a filter to determine should the log be written.\n   */\n  filter?: LogFilter\n}\n\nexport type LogLevel = number\n\nexport interface ConsoleLike {\n  debug(...args: any[]): void,\n  info(...args: any[]): void,\n  warn(...args: any[]): void,\n  error(...args: any[]): void,\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../ts/types.ts"],"names":[],"mappings":"","sourcesContent":["import { StackTraceMeta } from '@just-func/types'\n\nexport type StandardLogOptions<CustomLevelNames extends string = string> = {\n  customLevels?: Record<CustomLevelNames, number>,\n  logLevel?: number,\n  reporters?: LogReporter[]\n}\n\nexport interface LoggerOptions extends StackTraceMeta {\n  level?: number,\n  writeTo?: LogReporter | ReporterFilter\n}\n\nexport type Logger<T extends string = LogMethodNames> = {\n  readonly id: string,\n  /**\n   * Logger local log level.\n   */\n  level?: number,\n  /**\n   * Logs with an increment counter.\n   * This is useful during debugging to check for steps executed.\n   */\n  count(...args: any[]): void,\n  on(level: number | T, logFunction: LogFunction): void,\n  /**\n   * Write custom log entries.\n   */\n  write(entry: LogEntry): void\n} & { [k in T]: LogMethod }\n\n/**\n * Names of the standard log methods.\n */\nexport type LogMethodNames = 'emergency' | 'alert' | 'critical' | 'error' | 'warn' | 'notice' | 'info' | 'debug' | 'trace' | 'planck'\n\nexport type LogEntry = {\n  id: string,\n  level: number,\n  // args instead of messages because it is `any[]` instead of `string[]`\n  args: any[],\n  timestamp: Date\n}\n\nexport type LogMethod = (...args: any[]) => void\n\nexport type LogFunction = ((log: LogMethod) => void) | (() => string)\n\nexport type ReporterFilter = string | RegExp | ((reporterId: string) => boolean)\n\n/**\n * Formats a log entry.\n * Depends on the reporter, it can expect a different return type.\n * By default the return type is `any[]` which the `console` accepts.\n */\nexport type LogFormatter<T = any[]> = (entry: LogEntry) => T\n\n/**\n * Determines whether the entry should be written.\n */\nexport type LogFilter = (entry: LogEntry) => boolean\n\nexport type LogLevelEntry = { name: string, level: number }\n\nexport interface LogReporter<T = any> {\n  readonly id: string,\n  /**\n   * Specifies the formatter to be used by the reporter.\n   * Using this you can customize how the reporter writes the log entry.\n   */\n  readonly formatter: LogFormatter<T>,\n  /**\n   * Specifies a filter to determine should the log be written.\n   */\n  readonly filter?: LogFilter,\n  /**\n   * Indicate if this is a console reporter.\n   * There is only one console reporter can be present in the system.\n   */\n  readonly isConsoleReporter?: boolean,\n  write(entry: LogEntry): void\n}\n\nexport type LogReporterOptions<T = any> = {\n  id?: string,\n  /**\n   * Specifies the formatter to be used by the reporter.\n   * Using this you can customize how the reporter writes the log entry.\n   */\n  formatter?: LogFormatter<T>,\n  /**\n   * Specifies a filter to determine should the log be written.\n   */\n  filter?: LogFilter\n}\n\nexport type LogLevel = number\n\nexport interface ConsoleLike {\n  debug(...args: any[]): void,\n  info(...args: any[]): void,\n  warn(...args: any[]): void,\n  error(...args: any[]): void,\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "standard-log",
-  "version": "9.1.2",
+  "version": "9.1.3",
   "description": "The standard log library",
   "homepage": "https://github.com/unional/standard-log/tree/master/packages/log",
   "bugs": {

package/ts/index.ts

@@ -5,7 +5,7 @@ export * from './logLevels.js'
 export * from './memory.js'
 export {
   configGlobal, createStandardLog, createStandardLogForTest,
-  getLogger, StandardLog, StandardLogInstance, suppressLogs
+  getLogger, suppressLogs
 } from './standardLog.js'
+export type { StandardLog, StandardLogInstance } from './standardLog.js'
 export * from './types.js'
-

package/ts/logger.ts

@@ -6,10 +6,9 @@ import type { LogEntry, LogFunction, Logger, LoggerOptions, LogMethodNames, LogR
 import { LogLevel } from './types.js'
 
 export function createLogger<T extends string = LogMethodNames>(
-  [store, id, options]: [LogStore, string, LoggerOptions | undefined],
-  meta?: StackTraceMeta
+  store: LogStore, id: string, options?: LoggerOptions
 ): Logger {
-  validateId(id, meta)
+  validateId(id, options)
   const writeTo = options?.writeTo ?? (() => true)
   const [filter, reporters]: [(reporterId: string) => boolean, LogReporter[]] = typeof writeTo === 'string'
     ? [id => id === writeTo, store.reporters]

package/ts/standardLog.ts

@@ -1,4 +1,3 @@
-import { StackTraceMeta } from '@just-func/types'
 import { record, required } from 'type-plus'
 import { createLogger } from './logger.js'
 import { logLevels } from './logLevels.js'
@@ -10,7 +9,7 @@ export interface StandardLogInstance<N extends string = LogMethodNames> {
   logLevel: number,
   toLogLevelName(level: number): string,
   toLogLevel(name: N): number,
-  getLogger(params: [id: string, options?: LoggerOptions], meta?: StackTraceMeta): Logger<N | LogMethodNames>
+  getLogger(id: string, options?: LoggerOptions): Logger<N | LogMethodNames>
 }
 
 export interface StandardLog<N extends string = LogMethodNames> extends Readonly<StandardLogInstance<N>> {
@@ -40,9 +39,9 @@ export function createStandardLogClosure<N extends string = LogMethodNames>(
       toLogLevel(name: string) {
         return store.logLevelStore.getLevel(name)
       },
-      getLogger([id, options]: [id: string, options?: LoggerOptions], meta?: StackTraceMeta) {
+      getLogger(id: string, options?: LoggerOptions) {
         if (store.loggers[id]) return store.loggers[id] as any
-        return store.loggers[id] = createLogger([store, id, options], { ssf: this.getLogger, ...meta }) as any
+        return store.loggers[id] = createLogger(store, id, { ssf: this.getLogger, ...options }) as any
       }
     }
   }
@@ -66,9 +65,8 @@ export function suppressLogs<R>(block: () => R, ...logs: Logger[]): R {
   return result
 }
 
-export function getLogger<N extends string = LogMethodNames>(
-  params: [id: string, options?: LoggerOptions], meta?: StackTraceMeta) {
-  return getGlobalSL<N>().getLogger(params, meta)
+export function getLogger<N extends string = LogMethodNames>(id: string, options?: LoggerOptions) {
+  return getGlobalSL<N>().getLogger(id, options)
 }
 
 export const ctx: {
@@ -84,7 +82,7 @@ function getGlobalSL<N extends string = LogMethodNames>(): StandardLogInstance<N
 
 export function configGlobal(options: Omit<StandardLogOptions, 'customLevels'>) {
   if (ctx.configured) {
-    const log = ctx.gsl?.standardLog.getLogger(['standard-log'])
+    const log = ctx.gsl?.standardLog.getLogger('standard-log')
     log?.warn('configGlobal() is being called more than once. Please make sure this is expected. Application should use `createStandardLog()` most of the time.')
   }
 

package/ts/types.ts

@@ -1,10 +1,12 @@
+import { StackTraceMeta } from '@just-func/types'
+
 export type StandardLogOptions<CustomLevelNames extends string = string> = {
   customLevels?: Record<CustomLevelNames, number>,
   logLevel?: number,
   reporters?: LogReporter[]
 }
 
-export interface LoggerOptions {
+export interface LoggerOptions extends StackTraceMeta {
   level?: number,
   writeTo?: LogReporter | ReporterFilter
 }