npm - @push.rocks/smartlog - Versions diffs - 3.1.8 → 3.1.10 - Mend

@push.rocks/smartlog 3.1.8 → 3.1.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist_bundle/bundle.js +76 -0
package/dist_bundle/bundle.js.map +4 -4
package/dist_ts/00_commitinfo_data.js +2 -2
package/package.json +7 -7
package/readme.md +612 -164
package/ts/00_commitinfo_data.ts +1 -1

package/dist_bundle/bundle.js CHANGED Viewed

@@ -7,6 +7,10 @@ var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __commonJS = (cb, mod) => function __require() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
+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))
@@ -41,6 +45,78 @@ var require_dist_ts = __commonJS({
   }
 });
+// dist_ts_interfaces/index.js
+var dist_ts_interfaces_exports = {};
+__export(dist_ts_interfaces_exports, {
+  request: () => smartlog_interfaces_requests_exports
+});
+// node_modules/.pnpm/@api.global+typedrequest-interfaces@3.0.19/node_modules/@api.global/typedrequest-interfaces/dist_ts/index.js
+var dist_ts_exports = {};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/index.js
+var dist_ts_exports2 = {};
+__export(dist_ts_exports2, {
+  business: () => business_exports,
+  code: () => code_exports,
+  container: () => container_exports,
+  content: () => content_exports,
+  database: () => database_exports,
+  descriptors: () => descriptors_exports,
+  finance: () => finance_exports,
+  general: () => general_exports,
+  network: () => network_exports,
+  saas: () => saas_exports,
+  storage: () => storage_exports,
+  website: () => website_exports
+});
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/business/index.js
+var business_exports = {};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/database/index.js
+var database_exports = {};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/finance/index.js
+var finance_exports = {};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/code/index.js
+var code_exports = {};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/container/index.js
+var container_exports = {};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/descriptors/index.js
+var descriptors_exports = {};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/content/index.js
+var content_exports = {};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/general/index.js
+var general_exports = {};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/network/index.js
+var network_exports = {};
+__export(network_exports, {
+  ICnameDescriptor: () => ICnameDescriptor
+});
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/network/cname.js
+var ICnameDescriptor = class {
+};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/saas/index.js
+var saas_exports = {};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/storage/index.js
+var storage_exports = {};
+// node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/website/index.js
+var website_exports = {};
+// dist_ts_interfaces/smartlog-interfaces.requests.js
+var smartlog_interfaces_requests_exports = {};
 // ts/smartlog.plugins.ts
 var isounique = __toESM(require_dist_ts(), 1);

package/dist_bundle/bundle.js.map CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../node_modules/.pnpm/@push.rocks+isounique@1.0.5/node_modules/@push.rocks/isounique/ts/index.ts", "../ts/smartlog.plugins.ts", "../ts/smartlog.classes.consolelog.ts", "../ts/smartlog.classes.logrouter.ts", "../ts/smartlog.classes.smartlog.ts", "../ts/smartlog.classes.loggroup.ts"],
-  "sourcesContent": [null, "import * as isounique from '@push.rocks/isounique';\nimport * as smartlogInterfaces from '../dist_ts_interfaces/index.js';\n\nexport { isounique, smartlogInterfaces };\n", "import * as plugins from './smartlog.plugins.js';\n\n/**\n * a console log optimized for smartlog\n */\nexport class ConsoleLog {\n  public log(\n    logLevelArg: plugins.smartlogInterfaces.TLogLevel,\n    logMessageArg: string,\n    dataArg?: any,\n    correlationArg?: plugins.smartlogInterfaces.ILogCorrelation,\n  ) {\n    console.log(`__# ${logLevelArg}: ${logMessageArg}`);\n  }\n}\n", "import * as plugins from './smartlog.plugins.js';\n\nexport class LogRouter {\n  /**\n   * all log destinations\n   */\n  private logDestinations: plugins.smartlogInterfaces.ILogDestination[] = [];\n\n  constructor() {}\n\n  public addLogDestination(logDestination: plugins.smartlogInterfaces.ILogDestination) {\n    this.logDestinations.push(logDestination);\n  }\n\n  // routes the log according to added logDestinations\n  public async routeLog(logPackageArg: plugins.smartlogInterfaces.ILogPackage) {\n    for (const logDestination of this.logDestinations) {\n      await logDestination.handleLog(logPackageArg);\n    }\n  }\n}\n", "import * as plugins from './smartlog.plugins.js';\n\nimport { LogRouter } from './smartlog.classes.logrouter.js';\nimport { LogGroup } from './smartlog.classes.loggroup.js';\n\nexport interface ISmartlogContructorOptions {\n  logContext: plugins.smartlogInterfaces.ILogContext;\n  minimumLogLevel?: plugins.smartlogInterfaces.TLogLevel;\n}\n\nexport class Smartlog implements plugins.smartlogInterfaces.ILogDestination {\n  // STATIC\n  public static createForCommitinfo(\n    commitinfo: plugins.smartlogInterfaces.ILogContext['commitinfo'],\n  ) {\n    return new Smartlog({\n      logContext: {\n        commitinfo,\n      },\n    });\n  }\n\n  // INSTANCE\n  public logContext: plugins.smartlogInterfaces.ILogContext;\n  public minimumLogLevel: plugins.smartlogInterfaces.TLogLevel;\n\n  public uniInstanceId: string = plugins.isounique.uni();\n\n  private consoleEnabled: boolean;\n\n  private logRouter = new LogRouter();\n\n  public addLogDestination(logDestinationArg: plugins.smartlogInterfaces.ILogDestination) {\n    this.logRouter.addLogDestination(logDestinationArg);\n  }\n\n  constructor(optionsArg: ISmartlogContructorOptions) {\n    this.logContext = optionsArg.logContext;\n    this.minimumLogLevel = optionsArg.minimumLogLevel || 'silly';\n  }\n\n  // ============\n  // Logger Setup\n  // ============\n\n  /**\n   * enables console logging\n   */\n  public enableConsole(optionsArg?: { captureAll: boolean }) {\n    if (globalThis.process && optionsArg && optionsArg.captureAll) {\n      const process = globalThis.process;\n      const originalStdoutWrite = process.stdout.write.bind(process.stdout);\n      const originalStderrWrite = process.stderr.write.bind(process.stderr);\n\n      process.stdout.write = (...args: any) => {\n        const logString: string = args[0];\n        if (!logString || typeof logString !== 'string') {\n          // continue as planned\n          return originalStdoutWrite(...args);\n        }\n\n        if (!logString.startsWith('LOG')) {\n          if (logString.includes('Error:')) {\n            this.log('error', logString);\n          } else {\n            this.log('info', logString);\n          }\n          return true;\n        }\n\n        return originalStdoutWrite(...args);\n      };\n\n      process.stderr.write = (...args: any) => {\n        const logString: string = args[0];\n        if (!logString || typeof logString !== 'string' || !logString.startsWith('LOG')) {\n          this.log('error', logString);\n          return true;\n        }\n        return originalStderrWrite(...args);\n      };\n    }\n    this.consoleEnabled = true;\n  }\n\n  // =============\n  // log functions\n  // =============\n  /**\n   * main log method\n   * @param logLevelArg - the log level\n   * @param logMessageArg - the log message\n   * @param logDataArg - any additional log data\n   * @param correlationArg - info about corrleations\n   */\n  public async log(\n    logLevelArg: plugins.smartlogInterfaces.TLogLevel,\n    logMessageArg: string,\n    logDataArg?: any,\n    correlationArg?: plugins.smartlogInterfaces.ILogCorrelation,\n  ) {\n    correlationArg = {\n      ...{\n        id: plugins.isounique.uni(),\n        type: 'none',\n        instance: this.uniInstanceId,\n      },\n      ...correlationArg,\n    };\n\n    if (this.consoleEnabled) {\n      this.safeConsoleLog(`${logLevelArg}: ${logMessageArg}`);\n    }\n\n    const logPackage: plugins.smartlogInterfaces.ILogPackage = {\n      timestamp: Date.now(),\n      type: 'log',\n      context: this.logContext,\n      level: logLevelArg,\n      correlation: correlationArg,\n      message: logMessageArg,\n    };\n    if (logDataArg) {\n      logPackage.data = logDataArg;\n    }\n    await this.logRouter.routeLog(logPackage);\n  }\n\n  public increment(\n    logLevelArg: plugins.smartlogInterfaces.TLogLevel,\n    logMessageArg: string,\n    logDataArg?: any,\n    correlationArg: plugins.smartlogInterfaces.ILogCorrelation = {\n      id: plugins.isounique.uni(),\n      type: 'none',\n    },\n  ) {\n    if (this.consoleEnabled) {\n      this.safeConsoleLog(`INCREMENT: ${logLevelArg}: ${logMessageArg}`);\n    }\n    this.logRouter.routeLog({\n      timestamp: Date.now(),\n      type: 'increment',\n      context: this.logContext,\n      level: logLevelArg,\n      message: logMessageArg,\n      correlation: correlationArg,\n    });\n  }\n\n  public async handleLog(logPackageArg: plugins.smartlogInterfaces.ILogPackage) {\n    await this.logRouter.routeLog(logPackageArg);\n  }\n\n  private safeConsoleLog(logLine: string) {\n    console.log(\n      `LOG => ${new Date().getHours()}:${new Date().getMinutes()}:${new Date().getSeconds()} => ${logLine}`,\n    );\n  }\n\n  public createLogGroup(transactionId: string = 'none') {\n    return new LogGroup(this, transactionId);\n  }\n}\n", "import * as plugins from './smartlog.plugins.js';\nimport { Smartlog } from './smartlog.classes.smartlog.js';\n\nexport class LogGroup {\n  public smartlogRef: Smartlog;\n  public transactionId: string;\n  public groupId = plugins.isounique.uni();\n\n  constructor(smartlogInstance: Smartlog, transactionIdArg: string) {\n    this.smartlogRef = smartlogInstance;\n    this.transactionId = transactionIdArg;\n  }\n\n  public log(\n    logLevelArg: plugins.smartlogInterfaces.TLogLevel,\n    logMessageArg: string,\n    logDataArg?: any,\n  ) {\n    this.smartlogRef.log(logLevelArg, logMessageArg, logDataArg, {\n      id: plugins.isounique.uni(),\n      type: 'none',\n      group: this.groupId,\n      instance: this.smartlogRef.uniInstanceId,\n      transaction: this.transactionId,\n    });\n  }\n}\n"],
-  "mappings": "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",
-  "names": []
+  "sources": ["../node_modules/.pnpm/@push.rocks+isounique@1.0.5/node_modules/@push.rocks/isounique/ts/index.ts", "../ts_interfaces/index.ts", "../node_modules/.pnpm/@api.global+typedrequest-interfaces@3.0.19/node_modules/@api.global/typedrequest-interfaces/dist_ts/index.js", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/index.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/business/index.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/database/index.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/finance/index.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/code/index.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/container/index.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/descriptors/index.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/content/index.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/general/index.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/network/index.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/network/cname.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/saas/index.ts", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/dist_ts/storage/index.js", "../node_modules/.pnpm/@tsclass+tsclass@9.2.0/node_modules/@tsclass/tsclass/ts/website/index.ts", "../ts_interfaces/smartlog-interfaces.requests.ts", "../ts/smartlog.plugins.ts", "../ts/smartlog.classes.consolelog.ts", "../ts/smartlog.classes.logrouter.ts", "../ts/smartlog.classes.smartlog.ts", "../ts/smartlog.classes.loggroup.ts"],
+  "sourcesContent": ["export const uni = (prefix: string = 'uni') => {\n  return `${prefix}_${`xxxxxxxxxxxxxxxxxxxxxxxx`.replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  })}`;\n};\n", "import * as plugins from './smartlog-interfaces.plugins.js';\n\nimport * as requestInterfaces from './smartlog-interfaces.requests.js';\n\nexport { requestInterfaces as request };\n\n/**\n * the different available log types\n */\nexport type TLogType =\n  | 'log'\n  | 'increment'\n  | 'gauge'\n  | 'error'\n  | 'success'\n  | 'value'\n  | 'finance'\n  | 'compliance';\n\n/**\n * the available log levels\n */\nexport type TLogLevel =\n  | 'silly'\n  | 'info'\n  | 'debug'\n  | 'note'\n  | 'ok'\n  | 'success'\n  | 'warn'\n  | 'error'\n  | 'lifecycle';\n\n/**\n * the available environments\n */\nexport type TEnvironment = 'local' | 'test' | 'staging' | 'production';\n\n/**\n * the available runtimes\n */\nexport type TRuntime = 'node' | 'chrome' | 'rust' | 'deno' | 'cloudflare_workers';\n\n/**\n * the log context e.g. what app in what version on what server\n */\nexport interface ILogContext {\n  commitinfo?: plugins.tsclass.code.ICommitInfo;\n  company?: string;\n  companyunit?: string;\n  containerName?: string;\n  environment?: TEnvironment;\n  runtime?: TRuntime;\n  zone?: string;\n}\n\nexport interface ILogCorrelation {\n  /**\n   * a unique id for this log\n   */\n  id: string;\n  /**\n   * the type of this log\n   */\n  type: 'none' | 'service' | 'build' | 'infrastructure' | 'cdn';\n  /**\n   * the instance on which the log is created\n   * use it for pinning logs to a certain instance in a cluster\n   */\n  instance?: string;\n  /**\n   * a series of logs\n   */\n  group?: string;\n  /**\n   * a log that belongs to a transaction. E.g. a Payment or a request traveling through multiple backend instances\n   */\n  transaction?: string;\n}\n\n/**\n * the main logpackage\n */\nexport interface ILogPackage<T = unknown> {\n  /**\n   * a unix timestamp in milliseconds\n   */\n  timestamp: number;\n  type: TLogType;\n  context: ILogContext;\n  level: TLogLevel;\n  /**\n   * allows grouping of log messages\n   */\n  correlation: ILogCorrelation;\n  /**\n   * the message to log\n   */\n  message: string;\n  data?: T;\n}\n\nexport interface ILogPackageDataRequest {\n  requestCorrelationId: string;\n  url: string;\n  pathname: string;\n  method: string;\n  status: string;\n}\n\nexport interface ILogPackageAuthenticated {\n  auth: string;\n  logPackage: ILogPackage;\n}\n\nexport interface ILogPackageArrayAuthenticated {\n  auth: string;\n  logPackages: ILogPackage[];\n}\n\n/**\n * a destination interface for extending smartlog modules\n */\nexport interface ILogDestination {\n  handleLog: (logPackage: ILogPackage) => Promise<void>;\n}\n", "export {};\n//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=", "// Business\nimport * as business from './business/index.js';\n\n// Code\nimport * as code from './code/index.js';\n\n// Container\nimport * as container from './container/index.js';\n\n// Database\nimport * as database from './database/index.js';\n\n// Descriptors \nimport * as descriptors from './descriptors/index.js';\n\n// Finance\nimport * as finance from './finance/index.js';\n\n// Content\nimport * as content from './content/index.js';\n\n// General\nimport * as general from './general/index.js';\n\n// Network\nimport * as network from './network/index.js';\n\n// SaaS\nimport * as saas from './saas/index.js';\n\n// Storage\nimport * as storage from './storage/index.js';\n\n// Website\nimport * as website from './website/index.js';\n\nexport {\n  business,\n  container,\n  code,\n  database,\n  descriptors,\n  finance,\n  content,\n  general,\n  network,\n  saas,\n  storage,\n  website,\n};\n\nimport type * as typeFest from 'type-fest';\nimport * as typeFestOwn from './typefest.own.js';\n\nexport { type typeFest, type typeFestOwn };\n", "export * from './address.js';\nexport * from './contact.js';\nexport * from './document.js';\nexport * from './job.js';\nexport * from './letter.js';\nexport * from './pdf.js';\nexport * from './project.js';\n", "export * from './mongodescriptor.js';\nexport * from './objectaction.js';\nexport * from './objectstatus.js';\nexport * from './wrappeddata.js';\n", "export * from './checkingaccount.js';\nexport * from './currency.js';\nexport * from './expense.js';\nexport * from './accountingdoc.js';\nexport * from './payment.js';\nexport * from './transaction.js';\n", "export * from './commitinfo.js';\nexport * from './statusobject.js';", "export * from './container.js';\nexport * from './volumemount.js';\n", "export type { IMongoDescriptor } from '../database/index.js';\n\nexport interface ICloudflareDescriptor {\n  authToken: string;\n};\n\nexport interface ILetterExpressDescriptor {\n  email: string,\n  apiToken: string,\n}\n", "export * from './article.js';\nexport * from './author.js';\nexport * from './documentationset.js';\n", "export * from './date.js';\nexport * from './time.js';\n", "export * from './cert.js';\nexport * from './cname.js';\nexport * from './device.js';\nexport * from './dns.js';\nexport * from './dnschallenge.js';\nexport * from './dnsconvenience.js';\nexport * from './domaindelegation.js';\nexport * from './jwt.js';\nexport * from './networknode.js';\nexport * from './request.js';\nexport * from './reverseproxy.js';\nexport * from './ssh.js';\n", "import { type ICert } from './cert.js';\n\nexport class ICnameDescriptor {\n  /**\n   * the original domain that is being cnamed\n   */\n  cnamedDomain: string;\n\n  /**\n   * the cname proxy domain\n   * the domain that is used for the cname dns entry\n   */\n  cnameProxyDomain: string;\n\n  /**\n   * the internal target url\n   */\n  targetUrl: string;\n\n  /**\n   * a description\n   */\n  description: string;\n\n  /**\n   * the ssl certificate\n   */\n  sslCertificate?: ICert;\n}\n", "export * from './subscriptionplan.js';\nexport * from './product.js';\n", "export {};\n//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9zdG9yYWdlL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==", "export * from './link.js';\nexport * from './menuitem.js';\nexport * from './linkblock.js';\n", "import { type ILogPackageAuthenticated } from './index.js';\n\nexport interface IRequest_SmartlogDestinationReceiver_Any_PostLogPackages {\n  method: 'postLogPackages';\n  request: {\n    logPackages: ILogPackageAuthenticated[];\n  };\n  response: {};\n}\n", "import * as isounique from '@push.rocks/isounique';\nimport * as smartlogInterfaces from '../dist_ts_interfaces/index.js';\n\nexport { isounique, smartlogInterfaces };\n", "import * as plugins from './smartlog.plugins.js';\n\n/**\n * a console log optimized for smartlog\n */\nexport class ConsoleLog {\n  public log(\n    logLevelArg: plugins.smartlogInterfaces.TLogLevel,\n    logMessageArg: string,\n    dataArg?: any,\n    correlationArg?: plugins.smartlogInterfaces.ILogCorrelation,\n  ) {\n    console.log(`__# ${logLevelArg}: ${logMessageArg}`);\n  }\n}\n", "import * as plugins from './smartlog.plugins.js';\n\nexport class LogRouter {\n  /**\n   * all log destinations\n   */\n  private logDestinations: plugins.smartlogInterfaces.ILogDestination[] = [];\n\n  constructor() {}\n\n  public addLogDestination(logDestination: plugins.smartlogInterfaces.ILogDestination) {\n    this.logDestinations.push(logDestination);\n  }\n\n  // routes the log according to added logDestinations\n  public async routeLog(logPackageArg: plugins.smartlogInterfaces.ILogPackage) {\n    for (const logDestination of this.logDestinations) {\n      await logDestination.handleLog(logPackageArg);\n    }\n  }\n}\n", "import * as plugins from './smartlog.plugins.js';\n\nimport { LogRouter } from './smartlog.classes.logrouter.js';\nimport { LogGroup } from './smartlog.classes.loggroup.js';\n\nexport interface ISmartlogContructorOptions {\n  logContext: plugins.smartlogInterfaces.ILogContext;\n  minimumLogLevel?: plugins.smartlogInterfaces.TLogLevel;\n}\n\nexport class Smartlog implements plugins.smartlogInterfaces.ILogDestination {\n  // STATIC\n  public static createForCommitinfo(\n    commitinfo: plugins.smartlogInterfaces.ILogContext['commitinfo'],\n  ) {\n    return new Smartlog({\n      logContext: {\n        commitinfo,\n      },\n    });\n  }\n\n  // INSTANCE\n  public logContext: plugins.smartlogInterfaces.ILogContext;\n  public minimumLogLevel: plugins.smartlogInterfaces.TLogLevel;\n\n  public uniInstanceId: string = plugins.isounique.uni();\n\n  private consoleEnabled: boolean;\n\n  private logRouter = new LogRouter();\n\n  public addLogDestination(logDestinationArg: plugins.smartlogInterfaces.ILogDestination) {\n    this.logRouter.addLogDestination(logDestinationArg);\n  }\n\n  constructor(optionsArg: ISmartlogContructorOptions) {\n    this.logContext = optionsArg.logContext;\n    this.minimumLogLevel = optionsArg.minimumLogLevel || 'silly';\n  }\n\n  // ============\n  // Logger Setup\n  // ============\n\n  /**\n   * enables console logging\n   */\n  public enableConsole(optionsArg?: { captureAll: boolean }) {\n    if (globalThis.process && optionsArg && optionsArg.captureAll) {\n      const process = globalThis.process;\n      const originalStdoutWrite = process.stdout.write.bind(process.stdout);\n      const originalStderrWrite = process.stderr.write.bind(process.stderr);\n\n      process.stdout.write = (...args: any) => {\n        const logString: string = args[0];\n        if (!logString || typeof logString !== 'string') {\n          // continue as planned\n          return originalStdoutWrite(...args);\n        }\n\n        if (!logString.startsWith('LOG')) {\n          if (logString.includes('Error:')) {\n            this.log('error', logString);\n          } else {\n            this.log('info', logString);\n          }\n          return true;\n        }\n\n        return originalStdoutWrite(...args);\n      };\n\n      process.stderr.write = (...args: any) => {\n        const logString: string = args[0];\n        if (!logString || typeof logString !== 'string' || !logString.startsWith('LOG')) {\n          this.log('error', logString);\n          return true;\n        }\n        return originalStderrWrite(...args);\n      };\n    }\n    this.consoleEnabled = true;\n  }\n\n  // =============\n  // log functions\n  // =============\n  /**\n   * main log method\n   * @param logLevelArg - the log level\n   * @param logMessageArg - the log message\n   * @param logDataArg - any additional log data\n   * @param correlationArg - info about corrleations\n   */\n  public async log(\n    logLevelArg: plugins.smartlogInterfaces.TLogLevel,\n    logMessageArg: string,\n    logDataArg?: any,\n    correlationArg?: plugins.smartlogInterfaces.ILogCorrelation,\n  ) {\n    correlationArg = {\n      ...{\n        id: plugins.isounique.uni(),\n        type: 'none',\n        instance: this.uniInstanceId,\n      },\n      ...correlationArg,\n    };\n\n    if (this.consoleEnabled) {\n      this.safeConsoleLog(`${logLevelArg}: ${logMessageArg}`);\n    }\n\n    const logPackage: plugins.smartlogInterfaces.ILogPackage = {\n      timestamp: Date.now(),\n      type: 'log',\n      context: this.logContext,\n      level: logLevelArg,\n      correlation: correlationArg,\n      message: logMessageArg,\n    };\n    if (logDataArg) {\n      logPackage.data = logDataArg;\n    }\n    await this.logRouter.routeLog(logPackage);\n  }\n\n  public increment(\n    logLevelArg: plugins.smartlogInterfaces.TLogLevel,\n    logMessageArg: string,\n    logDataArg?: any,\n    correlationArg: plugins.smartlogInterfaces.ILogCorrelation = {\n      id: plugins.isounique.uni(),\n      type: 'none',\n    },\n  ) {\n    if (this.consoleEnabled) {\n      this.safeConsoleLog(`INCREMENT: ${logLevelArg}: ${logMessageArg}`);\n    }\n    this.logRouter.routeLog({\n      timestamp: Date.now(),\n      type: 'increment',\n      context: this.logContext,\n      level: logLevelArg,\n      message: logMessageArg,\n      correlation: correlationArg,\n    });\n  }\n\n  public async handleLog(logPackageArg: plugins.smartlogInterfaces.ILogPackage) {\n    await this.logRouter.routeLog(logPackageArg);\n  }\n\n  private safeConsoleLog(logLine: string) {\n    console.log(\n      `LOG => ${new Date().getHours()}:${new Date().getMinutes()}:${new Date().getSeconds()} => ${logLine}`,\n    );\n  }\n\n  public createLogGroup(transactionId: string = 'none') {\n    return new LogGroup(this, transactionId);\n  }\n}\n", "import * as plugins from './smartlog.plugins.js';\nimport { Smartlog } from './smartlog.classes.smartlog.js';\n\nexport class LogGroup {\n  public smartlogRef: Smartlog;\n  public transactionId: string;\n  public groupId = plugins.isounique.uni();\n\n  constructor(smartlogInstance: Smartlog, transactionIdArg: string) {\n    this.smartlogRef = smartlogInstance;\n    this.transactionId = transactionIdArg;\n  }\n\n  public log(\n    logLevelArg: plugins.smartlogInterfaces.TLogLevel,\n    logMessageArg: string,\n    logDataArg?: any,\n  ) {\n    this.smartlogRef.log(logLevelArg, logMessageArg, logDataArg, {\n      id: plugins.isounique.uni(),\n      type: 'none',\n      group: this.groupId,\n      instance: this.smartlogRef.uniInstanceId,\n      transaction: this.transactionId,\n    });\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["dist_ts_exports"]
 }

package/dist_ts/00_commitinfo_data.js CHANGED Viewed

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@push.rocks/smartlog',
-    version: '3.1.8',
+    version: '3.1.10',
     description: 'A minimalistic, distributed, and extensible logging tool supporting centralized log management.'
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxzQkFBc0I7SUFDNUIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLGlHQUFpRztDQUMvRyxDQUFBIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxzQkFBc0I7SUFDNUIsT0FBTyxFQUFFLFFBQVE7SUFDakIsV0FBVyxFQUFFLGlHQUFpRztDQUMvRyxDQUFBIn0=

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@push.rocks/smartlog",
-  "version": "3.1.8",
+  "version": "3.1.10",
   "private": false,
   "description": "A minimalistic, distributed, and extensible logging tool supporting centralized log management.",
   "keywords": [
@@ -36,19 +36,19 @@
   "author": "Lossless GmbH",
   "license": "MIT",
   "devDependencies": {
-    "@git.zone/tsbuild": "^2.5.1",
-    "@git.zone/tsbundle": "^2.2.5",
+    "@git.zone/tsbuild": "^2.6.8",
+    "@git.zone/tsbundle": "^2.5.1",
     "@git.zone/tsrun": "^1.3.3",
-    "@git.zone/tstest": "^1.9.0",
+    "@git.zone/tstest": "^2.3.6",
     "@types/node": "^22.15.20"
   },
   "dependencies": {
     "@api.global/typedrequest-interfaces": "^3.0.19",
-    "@push.rocks/consolecolor": "^2.0.2",
+    "@push.rocks/consolecolor": "^2.0.3",
     "@push.rocks/isounique": "^1.0.4",
     "@push.rocks/smartclickhouse": "^2.0.17",
-    "@push.rocks/smartfile": "^11.2.0",
-    "@push.rocks/smarthash": "^3.0.4",
+    "@push.rocks/smartfile": "^11.2.7",
+    "@push.rocks/smarthash": "^3.2.3",
     "@push.rocks/smartpromise": "^4.2.3",
     "@push.rocks/smarttime": "^4.1.1",
     "@push.rocks/webrequest": "^3.0.37",

package/readme.md CHANGED Viewed

@@ -1,288 +1,736 @@
-# @push.rocks/smartlog
+# @push.rocks/smartlog 🚀
+*The ultimate TypeScript logging solution for modern applications*
-Minimalistic distributed and extensible logging tool for TypeScript and JavaScript applications.
+[![npm version](https://img.shields.io/npm/v/@push.rocks/smartlog.svg)](https://www.npmjs.com/package/@push.rocks/smartlog)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-## Install
+> **smartlog** is a powerful, distributed, and extensible logging system designed for the cloud-native era. Whether you're debugging locally, monitoring production systems, or building complex microservices, smartlog adapts to your needs with style. 🎯
-Install `@push.rocks/smartlog` using pnpm (recommended), npm, or yarn:
+## 🌟 Why smartlog?
-```sh
+- **🎨 Beautiful Console Output**: Color-coded, formatted logs that are actually readable
+- **🔌 Extensible Architecture**: Plug in any destination - databases, files, remote servers
+- **🌍 Distributed by Design**: Built for microservices with correlation and context tracking
+- **⚡ Zero-Config Start**: Works out of the box, scales when you need it
+- **🎭 Interactive CLI Tools**: Spinners and progress bars that handle non-TTY environments gracefully
+- **📊 Structured Logging**: JSON-based for easy parsing and analysis
+- **🔍 Smart Filtering**: Log levels and context-based filtering
+## 📦 Installation
+```bash
 # Using pnpm (recommended)
 pnpm add @push.rocks/smartlog
 # Using npm
-npm install @push.rocks/smartlog --save
+npm install @push.rocks/smartlog
 # Using yarn
 yarn add @push.rocks/smartlog
 ```
-Ensure you have TypeScript and Node.js installed for TypeScript projects.
+## 🚀 Quick Start
-## Package Exports
+### Your First Logger
-The package provides the following exports:
+```typescript
+import { Smartlog } from '@push.rocks/smartlog';
-```javascript
-// Main module
-import { Smartlog, LogGroup, ConsoleLog } from '@push.rocks/smartlog';
+// Create a logger with context
+const logger = new Smartlog({
+  logContext: {
+    company: 'MyStartup',
+    companyunit: 'Backend Team',
+    containerName: 'api-gateway',
+    environment: 'production',
+    runtime: 'node',
+    zone: 'eu-central'
+  }
+});
-// Type definitions and interfaces
-import { ILogPackage, ILogDestination, TLogLevel } from '@push.rocks/smartlog/interfaces';
+// Enable beautiful console output
+logger.enableConsole();
-// Interactive console features (spinners, progress bars)
-import { SmartlogSourceInteractive, SmartlogProgressBar } from '@push.rocks/smartlog/source-interactive';
+// Start logging!
+logger.log('info', '🎉 Application started successfully');
+logger.log('error', '💥 Database connection failed', {
+  errorCode: 'DB_TIMEOUT',
+  attemptCount: 3
+});
+```
-// Context management
-import { ... } from '@push.rocks/smartlog/context';
+### Using the Default Logger
-// Log destinations
-import { SmartlogDestinationClickhouse } from '@push.rocks/smartlog/destination-clickhouse';
-import { SmartlogDestinationDevtools } from '@push.rocks/smartlog/destination-devtools';
-import { SmartlogDestinationFile } from '@push.rocks/smartlog/destination-file';
-import { DestinationLocal } from '@push.rocks/smartlog/destination-local';
-import { SmartlogDestinationReceiver } from '@push.rocks/smartlog/destination-receiver';
+For quick prototyping and simple applications:
+```typescript
+import { defaultLogger } from '@push.rocks/smartlog';
+defaultLogger.log('info', 'This is so easy!');
+```
+## 📚 Core Concepts
+### Log Levels
+smartlog supports semantic log levels for different scenarios:
+```typescript
+// Lifecycle events
+logger.log('lifecycle', '🔄 Container starting up...');
-// Receiver functionality
-import { SmartlogReceiver } from '@push.rocks/smartlog/receiver';
+// Success states
+logger.log('success', '✅ Payment processed');
+logger.log('ok', '👍 Health check passed');
+// Information and debugging
+logger.log('info', '📋 User profile updated');
+logger.log('note', '📌 Cache invalidated');
+logger.log('debug', '🔍 Query execution plan', { sql: 'SELECT * FROM users' });
+// Warnings and errors
+logger.log('warn', '⚠️  Memory usage above 80%');
+logger.log('error', '❌ Failed to send email');
+// Verbose output
+logger.log('silly', '🔬 Entering function processPayment()');
+```
+### Log Groups for Correlation
+Perfect for tracking request flows through your system:
+```typescript
+// Track a user request through multiple operations
+const requestGroup = logger.createLogGroup('req-7f3a2b');
+requestGroup.log('info', 'Received POST /api/users');
+requestGroup.log('debug', 'Validating request body');
+requestGroup.log('info', 'Creating user in database');
+requestGroup.log('success', 'User created successfully', { userId: 'usr_123' });
+// All logs in the group share the same correlation ID
 ```
-## Usage
+## 🎯 Log Destinations
-`@push.rocks/smartlog` is a flexible, extensible logging tool designed for distributed systems. It provides a consistent logging interface across different environments while being lightweight and customizable.
+### Built-in Destinations
-### Creating a Logger Instance
+#### 🖥️ Local Console (Enhanced)
-Start by importing `Smartlog` and create a logger instance:
+Beautiful, colored output for local development:
 ```typescript
-import { Smartlog } from '@push.rocks/smartlog';
+import { DestinationLocal } from '@push.rocks/smartlog/destination-local';
-const logger = new Smartlog({
-  logContext: {
-    company: 'My Company',
-    companyunit: 'Cloud Team',
-    containerName: 'api-service',
-    environment: 'production', // 'local', 'test', 'staging', 'production'
-    runtime: 'node',           // 'node', 'chrome', 'rust', 'deno', 'cloudflare_workers'
-    zone: 'us-west',
-  },
-  minimumLogLevel: 'info',     // Optional, defaults to 'silly'
+const localDestination = new DestinationLocal({
+  logLevel: 'debug'  // Optional: filter by minimum log level
 });
-// Enable console output
-logger.enableConsole();
+logger.addLogDestination(localDestination);
 ```
-The context enriches logs with valuable information for filtering and analysis across distributed systems.
+#### 📁 File Logging
-### Logging Messages
+Persist logs to files with automatic rotation support:
 ```typescript
-// Basic logging
-logger.log('info', 'User authenticated successfully');
-logger.log('error', 'Database connection failed', { errorCode: 'DB_CONN_ERR', retryCount: 3 });
-logger.log('warn', 'Rate limit approaching', { currentRate: 95, limit: 100 });
+import { SmartlogDestinationFile } from '@push.rocks/smartlog/destination-file';
-// Log levels: 'silly', 'info', 'debug', 'note', 'ok', 'success', 'warn', 'error', 'lifecycle'
+const fileDestination = new SmartlogDestinationFile('./logs/app.log');
+logger.addLogDestination(fileDestination);
 ```
-The third parameter accepts any additional data to attach to the log entry.
+#### 🌐 Browser DevTools
-### Default Logger
+Optimized for browser environments with styled console output:
-For simple cases, use the built-in default logger:
+```typescript
+import { SmartlogDestinationDevtools } from '@push.rocks/smartlog/destination-devtools';
+const devtools = new SmartlogDestinationDevtools();
+logger.addLogDestination(devtools);
+```
+#### 📊 ClickHouse Analytics
+Store logs in ClickHouse for powerful analytics:
 ```typescript
-import { defaultLogger } from '@push.rocks/smartlog';
+import { SmartlogDestinationClickhouse } from '@push.rocks/smartlog/destination-clickhouse';
+const clickhouse = await SmartlogDestinationClickhouse.createAndStart({
+  host: 'analytics.example.com',
+  port: 8123,
+  database: 'logs',
+  user: 'logger',
+  password: process.env.CLICKHOUSE_PASSWORD
+});
-defaultLogger.log('info', 'Application started');
+logger.addLogDestination(clickhouse);
+// Query your logs with SQL!
+// SELECT * FROM logs WHERE level = 'error' AND timestamp > now() - INTERVAL 1 HOUR
 ```
-### Log Groups
+#### 🔗 Remote Receiver
-Group related logs for better traceability:
+Send logs to a centralized logging service:
 ```typescript
-// Create a log group with optional transaction ID
-const requestGroup = logger.createLogGroup('tx-123456');
+import { SmartlogDestinationReceiver } from '@push.rocks/smartlog/destination-receiver';
+const receiver = new SmartlogDestinationReceiver({
+  endpoint: 'https://logs.mycompany.com/ingest',
+  apiKey: process.env.LOG_API_KEY,
+  batchSize: 100,  // Send logs in batches
+  flushInterval: 5000  // Flush every 5 seconds
+});
-// Logs within this group will be correlated
-requestGroup.log('info', 'Processing payment request');
-requestGroup.log('debug', 'Validating payment details');
-requestGroup.log('success', 'Payment processed successfully');
+logger.addLogDestination(receiver);
 ```
-### Custom Log Destinations
+### 🛠️ Custom Destinations
-Extend logging capabilities by adding custom destinations:
+Build your own destination for any logging backend:
 ```typescript
-import { Smartlog, ILogDestination } from '@push.rocks/smartlog';
+import { ILogDestination, ILogPackage } from '@push.rocks/smartlog/interfaces';
-class DatabaseLogDestination implements ILogDestination {
-  async handleLog(logPackage) {
-    // Store log in database
-    await db.logs.insert({
-      timestamp: new Date(logPackage.timestamp),
-      level: logPackage.level,
-      message: logPackage.message,
-      data: logPackage.data,
-      context: logPackage.context
+class ElasticsearchDestination implements ILogDestination {
+  private client: ElasticsearchClient;
+  constructor(config: ElasticsearchConfig) {
+    this.client = new ElasticsearchClient(config);
+  }
+  async handleLog(logPackage: ILogPackage): Promise<void> {
+    await this.client.index({
+      index: `logs-${new Date().toISOString().split('T')[0]}`,
+      body: {
+        '@timestamp': logPackage.timestamp,
+        level: logPackage.level,
+        message: logPackage.message,
+        context: logPackage.context,
+        data: logPackage.data,
+        correlation: logPackage.correlation
+      }
     });
   }
 }
-// Add the custom destination to your logger
-logger.addLogDestination(new DatabaseLogDestination());
+// Use your custom destination
+logger.addLogDestination(new ElasticsearchDestination({
+  node: 'https://elasticsearch.example.com'
+}));
 ```
-### Built-in Destinations
+## 🎨 Interactive Console Features
-SmartLog comes with several built-in destinations for various logging needs:
+### Spinners
+Create beautiful loading animations that degrade gracefully in CI/CD:
 ```typescript
-// Log to a file
-import { SmartlogDestinationFile } from '@push.rocks/smartlog/destination-file';
-logger.addLogDestination(new SmartlogDestinationFile('/path/to/logfile.log'));
+import { SmartlogSourceInteractive } from '@push.rocks/smartlog/source-interactive';
-// Colorful local console logging
-import { DestinationLocal } from '@push.rocks/smartlog/destination-local';
-logger.addLogDestination(new DestinationLocal());
+const spinner = new SmartlogSourceInteractive();
-// Browser DevTools with colored formatting
-import { SmartlogDestinationDevtools } from '@push.rocks/smartlog/destination-devtools';
-logger.addLogDestination(new SmartlogDestinationDevtools());
+// Basic usage
+spinner.text('🔄 Fetching data from API...');
+// ... perform async operation
+spinner.finishSuccess('✅ Data fetched successfully!');
+// Chained operations
+spinner
+  .text('📡 Connecting to database')
+  .successAndNext('🔍 Running migrations')
+  .successAndNext('🌱 Seeding data')
+  .finishSuccess('🎉 Database ready!');
+// Customize appearance
+spinner
+  .setSpinnerStyle('dots')  // dots, line, star, simple
+  .setColor('cyan')         // any terminal color
+  .setSpeed(80)            // animation speed in ms
+  .text('🚀 Deploying application...');
+// Handle failures
+try {
+  await deployApp();
+  spinner.finishSuccess('✅ Deployed!');
+} catch (error) {
+  spinner.finishFail('❌ Deployment failed');
+}
+```
+### Progress Bars
+Track long-running operations with style:
+```typescript
+import { SmartlogProgressBar } from '@push.rocks/smartlog/source-interactive';
+// Create a progress bar
+const progress = new SmartlogProgressBar({
+  total: 100,
+  width: 40,
+  complete: '█',
+  incomplete: '░',
+  showEta: true,
+  showPercent: true,
+  showCount: true
+});
+// Update progress
+for (let i = 0; i <= 100; i++) {
+  progress.update(i);
+  await someAsyncWork();
+}
+progress.complete();
+// Real-world example: Processing files
+const files = await getFiles();
+const progress = new SmartlogProgressBar({
+  total: files.length,
+  width: 50
+});
+for (const [index, file] of files.entries()) {
+  await processFile(file);
+  progress.increment();  // or progress.update(index + 1)
+}
+```
+### Non-Interactive Fallback
+Both spinners and progress bars automatically detect non-interactive environments (CI/CD, Docker logs, piped output) and fallback to simple text output:
+```
+[Loading] Connecting to database
+[Success] Connected to database
+[Loading] Running migrations
+Progress: 25% (25/100)
+Progress: 50% (50/100)
+Progress: 100% (100/100)
+[Success] Migrations complete
+```
+## 🔧 Advanced Features
+### Context Management
+Add context that flows through your entire application:
+```typescript
+// Set global context
+logger.addLogContext({
+  requestId: 'req-123',
+  userId: 'user-456',
+  feature: 'payment-processing'
+});
+// All subsequent logs include this context
+logger.log('info', 'Processing payment');
+// Output includes: { ...context, message: 'Processing payment' }
+```
-// ClickHouse database logging
+### Scoped Logging
+Create scoped loggers for different components:
+```typescript
+const dbLogger = logger.createScope('database');
+const apiLogger = logger.createScope('api');
+dbLogger.log('info', 'Executing query');
+apiLogger.log('info', 'Handling request');
+// Logs include scope information for filtering
+```
+### Minimum Log Levels
+Control log verbosity per environment:
+```typescript
+const logger = new Smartlog({
+  logContext: { environment: 'production' },
+  minimumLogLevel: 'warn'  // Only warn and above in production
+});
+// These won't be logged in production
+logger.log('debug', 'Detailed debug info');
+logger.log('info', 'Regular info');
+// These will be logged
+logger.log('warn', 'Warning message');
+logger.log('error', 'Error message');
+```
+### Increment Logging
+Perfect for metrics and counters:
+```typescript
+// Track API calls
+logger.increment('info', 'api.requests', { endpoint: '/users', method: 'GET' });
+logger.increment('info', 'api.requests', { endpoint: '/users', method: 'POST' });
+// Track errors by type
+logger.increment('error', 'payment.failed', { reason: 'insufficient_funds' });
+logger.increment('error', 'payment.failed', { reason: 'card_declined' });
+```
+### Capture All Console Output
+Redirect all console.log and console.error through smartlog:
+```typescript
+logger.enableConsole({
+  captureAll: true  // Capture all console.* methods
+});
+console.log('This goes through smartlog!');
+console.error('This too!');
+// All console output is now structured and routed through your destinations
+```
+## 🏗️ Real-World Examples
+### Microservice with Distributed Tracing
+```typescript
+import { Smartlog } from '@push.rocks/smartlog';
 import { SmartlogDestinationClickhouse } from '@push.rocks/smartlog/destination-clickhouse';
+// Initialize logger with service context
+const logger = new Smartlog({
+  logContext: {
+    company: 'TechCorp',
+    companyunit: 'Platform',
+    containerName: 'user-service',
+    environment: process.env.NODE_ENV,
+    runtime: 'node',
+    zone: process.env.CLOUD_ZONE
+  }
+});
+// Add ClickHouse for analytics
 const clickhouse = await SmartlogDestinationClickhouse.createAndStart({
-  host: 'clickhouse.example.com',
-  port: 8123,
-  user: 'username',
-  password: 'password',
-  database: 'logs_db'
+  host: process.env.CLICKHOUSE_HOST,
+  database: 'microservices_logs'
 });
 logger.addLogDestination(clickhouse);
-// Remote receiver logging
-import { SmartlogDestinationReceiver } from '@push.rocks/smartlog/destination-receiver';
-logger.addLogDestination(new SmartlogDestinationReceiver({
-  endpoint: 'https://logs.example.com/api/logs'
-}));
-```
+// Enable local console for development
+if (process.env.NODE_ENV === 'development') {
+  logger.enableConsole();
+}
-### Interactive Console Features
+// Express middleware for request tracking
+app.use((req, res, next) => {
+  const requestId = generateRequestId();
+  const logGroup = logger.createLogGroup(requestId);
+  // Attach logger to request
+  req.logger = logGroup;
+  // Log request
+  logGroup.log('info', 'Incoming request', {
+    method: req.method,
+    path: req.path,
+    ip: req.ip
+  });
+  // Track response
+  res.on('finish', () => {
+    logGroup.log('info', 'Request completed', {
+      statusCode: res.statusCode,
+      duration: Date.now() - req.startTime
+    });
+  });
+  next();
+});
+```
-For CLI applications, use the interactive console features:
+### CLI Tool with Progress Tracking
 ```typescript
+import { Smartlog } from '@push.rocks/smartlog';
 import { SmartlogSourceInteractive, SmartlogProgressBar } from '@push.rocks/smartlog/source-interactive';
+const logger = new Smartlog({
+  logContext: {
+    containerName: 'migration-tool',
+    environment: 'cli'
+  }
+});
+logger.enableConsole();
+async function migrateDatabase() {
+  const spinner = new SmartlogSourceInteractive();
+  // Connect to database
+  spinner.text('🔌 Connecting to database...');
+  await connectDB();
+  spinner.finishSuccess('✅ Connected to database');
+  // Get migrations
+  spinner.text('📋 Loading migrations...');
+  const migrations = await getMigrations();
+  spinner.finishSuccess(`✅ Found ${migrations.length} migrations`);
+  // Run migrations with progress bar
+  const progress = new SmartlogProgressBar({
+    total: migrations.length,
+    width: 40,
+    showEta: true
+  });
+  for (const [index, migration] of migrations.entries()) {
+    logger.log('info', `Running migration: ${migration.name}`);
+    await runMigration(migration);
+    progress.update(index + 1);
+  }
+  progress.complete();
+  logger.log('success', '🎉 All migrations completed successfully!');
+}
 ```
-#### Spinners
+### Production Logging with Multiple Destinations
 ```typescript
-const spinner = new SmartlogSourceInteractive();
+import { Smartlog } from '@push.rocks/smartlog';
+import { DestinationLocal } from '@push.rocks/smartlog/destination-local';
+import { SmartlogDestinationFile } from '@push.rocks/smartlog/destination-file';
+import { SmartlogDestinationReceiver } from '@push.rocks/smartlog/destination-receiver';
-// Start a spinner with text
-spinner.text('Loading data...');
+const logger = new Smartlog({
+  logContext: {
+    company: 'Enterprise Corp',
+    containerName: 'payment-processor',
+    environment: 'production',
+    runtime: 'node',
+    zone: 'us-east-1'
+  },
+  minimumLogLevel: 'info'  // No debug logs in production
+});
-// Customize appearance
-spinner.setSpinnerStyle('dots');  // 'dots', 'line', 'star', 'simple'
-spinner.setColor('blue');         // 'red', 'green', 'yellow', 'blue', etc.
-spinner.setSpeed(80);             // Animation speed in milliseconds
+// Console for container logs (structured for log aggregators)
+logger.addLogDestination(new DestinationLocal());
-// Update spinner status
-spinner.text('Processing records...');
+// File for audit trail
+logger.addLogDestination(new SmartlogDestinationFile('/var/log/app/audit.log'));
-// Complete with success or failure
-spinner.finishSuccess('Data loaded successfully!');
-spinner.finishFail('Failed to load data!');
+// Central logging service
+logger.addLogDestination(new SmartlogDestinationReceiver({
+  endpoint: 'https://logs.enterprise.com/ingest',
+  apiKey: process.env.LOG_API_KEY,
+  batchSize: 100,
+  flushInterval: 5000
+}));
-// Chain operations
-spinner.text('Connecting to server')
-  .successAndNext('Fetching records')
-  .successAndNext('Processing data')
-  .finishSuccess('All done!');
+// Critical error alerts
+logger.addLogDestination({
+  async handleLog(logPackage) {
+    if (logPackage.level === 'error' && logPackage.data?.critical) {
+      await sendAlert({
+        channel: 'ops-team',
+        message: `🚨 Critical error: ${logPackage.message}`,
+        data: logPackage
+      });
+    }
+  }
+});
 ```
-#### Progress Bars
+## 🔌 Integration with Other Tools
+### PM2 Integration
 ```typescript
-const progressBar = new SmartlogProgressBar({
-  total: 100,                // Total number of items
-  width: 40,                 // Width of the progress bar
-  complete: '█',             // Character for completed section
-  incomplete: '░',           // Character for incomplete section
-  showEta: true,             // Show estimated time remaining
-  showPercent: true,         // Show percentage
-  showCount: true            // Show count (e.g., "50/100")
-});
+// ecosystem.config.js
+module.exports = {
+  apps: [{
+    name: 'api',
+    script: './dist/index.js',
+    error_file: '/dev/null',  // Disable PM2 error log
+    out_file: '/dev/null',    // Disable PM2 out log
+    merge_logs: true,
+    env: {
+      NODE_ENV: 'production',
+      // smartlog handles all logging
+    }
+  }]
+};
+```
-// Update progress
-progressBar.update(25);      // Set to 25% progress
+### Docker Integration
-// Increment progress
-progressBar.increment(5);    // Increase by 5 units
+```dockerfile
+FROM node:18-alpine
+WORKDIR /app
+COPY . .
+RUN pnpm install --production
-// Change color
-progressBar.setColor('blue');
+# smartlog handles structured logging
+# No need for special log drivers
+CMD ["node", "dist/index.js"]
+```
-// Complete the progress bar
-progressBar.complete();
+```yaml
+# docker-compose.yml
+services:
+  app:
+    build: .
+    environment:
+      - NODE_ENV=production
+    # Logs are structured JSON, perfect for log aggregators
+    logging:
+      driver: "json-file"
+      options:
+        max-size: "10m"
+        max-file: "3"
 ```
-#### Non-Interactive Environments
+## 🏆 Best Practices
-Both spinners and progress bars automatically detect non-interactive environments (CI/CD, piped output) and fallback to plain text logging:
+### 1. Use Semantic Log Levels
+```typescript
+// ✅ Good - semantic and meaningful
+logger.log('lifecycle', 'Server starting on port 3000');
+logger.log('success', 'Database connection established');
+logger.log('error', 'Failed to process payment', { orderId, error });
+// ❌ Bad - everything is 'info'
+logger.log('info', 'Server starting');
+logger.log('info', 'Database connected');
+logger.log('info', 'Error: payment failed');
 ```
-[Loading] Connecting to server
-[Success] Connected to server
-[Loading] Fetching records
-Progress: 50% (50/100)
-Progress: 100% (100/100)
-[Success] Fetching complete
+### 2. Include Structured Data
+```typescript
+// ✅ Good - structured data for analysis
+logger.log('error', 'API request failed', {
+  endpoint: '/api/users',
+  statusCode: 500,
+  duration: 1234,
+  userId: 'usr_123',
+  errorCode: 'INTERNAL_ERROR'
+});
+// ❌ Bad - data embedded in message
+logger.log('error', `API request to /api/users failed with 500 in 1234ms for user usr_123`);
 ```
-## Advanced Usage
+### 3. Use Log Groups for Correlation
-### Capturing All Console Output
+```typescript
+// ✅ Good - correlated logs
+async function processOrder(orderId: string) {
+  const logGroup = logger.createLogGroup(orderId);
+  logGroup.log('info', 'Processing order');
+  logGroup.log('debug', 'Validating items');
+  logGroup.log('info', 'Charging payment');
+  logGroup.log('success', 'Order processed');
+}
+// ❌ Bad - no correlation
+async function processOrder(orderId: string) {
+  logger.log('info', `Processing order ${orderId}`);
+  logger.log('debug', `Validating items for ${orderId}`);
+  logger.log('info', `Charging payment for ${orderId}`);
+}
+```
-Capture all `console.log` and `console.error` output through Smartlog:
+### 4. Environment-Specific Configuration
 ```typescript
-logger.enableConsole({ captureAll: true });
+// ✅ Good - different configs per environment
+const logger = new Smartlog({
+  logContext: {
+    environment: process.env.NODE_ENV,
+    // ... other context
+  },
+  minimumLogLevel: process.env.NODE_ENV === 'production' ? 'info' : 'silly'
+});
+// Add destinations based on environment
+if (process.env.NODE_ENV === 'production') {
+  logger.addLogDestination(clickhouseDestination);
+  logger.addLogDestination(alertingDestination);
+} else {
+  logger.enableConsole();
+}
 ```
-### Increment Logging
+## 📖 API Reference
-For metrics and counters:
+### Smartlog Class
 ```typescript
-logger.increment('info', 'api_requests', { endpoint: '/users' });
+class Smartlog {
+  constructor(options?: ISmartlogOptions)
+  // Logging methods
+  log(level: TLogLevel, message: string, data?: any, correlation?: ILogCorrelation): void
+  increment(level: TLogLevel, key: string, data?: any): void
+  // Configuration
+  enableConsole(options?: IConsoleOptions): void
+  addLogDestination(destination: ILogDestination): void
+  addLogContext(context: Partial<ILogContext>): void
+  // Log groups
+  createLogGroup(transactionId?: string): LogGroup
+  createScope(scopeName: string): Smartlog
+}
 ```
-### Log Correlation
+### Log Levels
-Correlate logs across services with correlation IDs:
+```typescript
+type TLogLevel =
+  | 'silly'      // Very verbose debugging
+  | 'debug'      // Debug information
+  | 'info'       // Informational messages
+  | 'note'       // Notable events
+  | 'ok'         // Success confirmation
+  | 'success'    // Major success
+  | 'warn'       // Warning messages
+  | 'error'      // Error messages
+  | 'lifecycle'  // Application lifecycle events
+```
+### Log Package Structure
 ```typescript
-logger.log('info', 'Request received', { userId: 'user-123' }, {
-  id: 'req-abc-123',
-  type: 'service',
-  transaction: 'tx-payment-456'
-});
+interface ILogPackage {
+  timestamp: number;
+  level: TLogLevel;
+  message: string;
+  data?: any;
+  context: ILogContext;
+  correlation?: ILogCorrelation;
+}
 ```
-## API Documentation
+For complete API documentation, see [API.md](API.md).
+## 🤝 Contributing
-For detailed API documentation, see the [API.md](API.md) file.
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
-## License and Legal Information
+## 📄 License and Legal Information
-This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository.
+This repository contains open-source code that is licensed under the MIT License. A copy of the MIT License can be found in the [license](license) file within this repository.
 **Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.

package/ts/00_commitinfo_data.ts CHANGED Viewed

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@push.rocks/smartlog',
-  version: '3.1.8',
+  version: '3.1.10',
   description: 'A minimalistic, distributed, and extensible logging tool supporting centralized log management.'
 }