@knowark/loggarkjs 0.3.6 → 0.3.8

package/lib/index.d.ts

@@ -21,3 +21,15 @@ export declare class Logger {
 
   debug(...data: any[]): void
 }
+
+export declare class Translator {
+  static translate(key: string, options?: object): string
+
+  constructor (options?: object)
+
+  translate(key: string, options?: object): string
+
+  t(key: string, options?: object): string
+}
+
+export declare function t(key: string, options?: object): string

package/lib/index.js

@@ -1 +1,2 @@
 export { Logger } from './logger.js'
+export { Translator, t } from './translator.js'

package/lib/logger.js

@@ -46,6 +46,6 @@ export class Logger {
 
 function log (global, level, context, args) {
   return global.console[level](
-  `[${level.toUpperCase()}]`,
+  `${new global.Date().toISOString()} [${level.toUpperCase()}]`,
   ...[context ? JSON.stringify(context) : false, ...args].filter(Boolean))
 }

package/lib/logger.test.js

@@ -1,7 +1,6 @@
-import { test, expect } from '@jest/globals'
+import { it, expect } from '@jest/globals'
 import { Logger } from './logger.js'
 
-
 function setup () {
   const mockGlobal = {
     console: {
@@ -10,22 +9,27 @@ function setup () {
       warn (...args) { mockGlobal.warnArgs = args },
       info (...args) { mockGlobal.infoArgs = args },
       debug (...args) { mockGlobal.debugArgs = args }
+    },
+    Date: class {
+      toISOString() {
+        return new Date('2025-02-15').toISOString()
+      }
     }
   }
   return {mockGlobal}
 }
 
-test('can be instantiated', () => {
+it('can be instantiated', () => {
   const logger = new Logger()
   expect(logger).toBeTruthy()
 })
 
-test('can be instantiated', () => {
+it('can be instantiated', () => {
   const logger = new Logger()
   expect(logger).toBeTruthy()
 })
 
-test('is disabled by default', () => {
+it('is disabled by default', () => {
   const { mockGlobal } = setup()
   const logger = new Logger({ global: mockGlobal })
 
@@ -45,28 +49,33 @@ test('is disabled by default', () => {
   expect(mockGlobal.debugArgs).toBeFalsy()
 })
 
-test('adds a prefix to the logging methods according to loglevel', () => {
+it('adds a prefix to the logging methods according to loglevel', () => {
   const { mockGlobal } = setup()
   mockGlobal.LOGLEVEL = 'debug'
   const logger = new Logger({ global: mockGlobal })
 
   logger.log('Logging something...')
-  expect(mockGlobal.logArgs).toEqual(['[LOG]', 'Logging something...'])
+  expect(mockGlobal.logArgs).toEqual(
+    ['2025-02-15T00:00:00.000Z [LOG]', 'Logging something...'])
 
   logger.error('Logging something...')
-  expect(mockGlobal.errorArgs).toEqual(['[ERROR]', 'Logging something...'])
+  expect(mockGlobal.errorArgs).toEqual(
+    ['2025-02-15T00:00:00.000Z [ERROR]', 'Logging something...'])
 
   logger.warn('Logging something...')
-  expect(mockGlobal.warnArgs).toEqual(['[WARN]', 'Logging something...'])
+  expect(mockGlobal.warnArgs).toEqual(
+    ['2025-02-15T00:00:00.000Z [WARN]', 'Logging something...'])
 
   logger.info('Logging something...')
-  expect(mockGlobal.infoArgs).toEqual(['[INFO]', 'Logging something...'])
+  expect(mockGlobal.infoArgs).toEqual(
+    ['2025-02-15T00:00:00.000Z [INFO]', 'Logging something...'])
 
   logger.debug('Logging something...')
-  expect(mockGlobal.debugArgs).toEqual(['[DEBUG]', 'Logging something...'])
+  expect(mockGlobal.debugArgs).toEqual(
+    ['2025-02-15T00:00:00.000Z [DEBUG]', 'Logging something...'])
 })
 
-test('adds the provided logging context labels to its final output', () => {
+it('adds the provided logging context labels to its final output', () => {
   const { mockGlobal } = setup()
   mockGlobal.LOGLEVEL = 'debug'
   const context = { correlationId: 'ABCD1234', interactor: 'Informer' }
@@ -74,36 +83,36 @@ test('adds the provided logging context labels to its final output', () => {
 
   logger.log('Logging something...')
   expect(mockGlobal.logArgs).toEqual([
-    '[LOG]',
+    '2025-02-15T00:00:00.000Z [LOG]',
     JSON.stringify({ correlationId: 'ABCD1234', interactor: 'Informer' }),
     'Logging something...'])
 
   logger.error('Logging something...')
   expect(mockGlobal.errorArgs).toEqual([
-    '[ERROR]', 
+    '2025-02-15T00:00:00.000Z [ERROR]', 
     JSON.stringify({ correlationId: 'ABCD1234', interactor: 'Informer' }),
     'Logging something...'])
 
   logger.warn('Logging something...')
   expect(mockGlobal.warnArgs).toEqual([
-    '[WARN]', 
+    '2025-02-15T00:00:00.000Z [WARN]', 
     JSON.stringify({ correlationId: 'ABCD1234', interactor: 'Informer' }),
     'Logging something...'])
 
   logger.info('Logging something...')
   expect(mockGlobal.infoArgs).toEqual([
-    '[INFO]', 
+    '2025-02-15T00:00:00.000Z [INFO]', 
     JSON.stringify({ correlationId: 'ABCD1234', interactor: 'Informer' }),
     'Logging something...'])
 
   logger.debug('Logging something...')
   expect(mockGlobal.debugArgs).toEqual([
-    '[DEBUG]',
+    '2025-02-15T00:00:00.000Z [DEBUG]',
     JSON.stringify({ correlationId: 'ABCD1234', interactor: 'Informer' }),
     'Logging something...'])
 })
 
-test('supports including static context labels', () => {
+it('supports including static context labels', () => {
   Logger.context = () => {
     return { correlationId: 'ABCD1234' }
   }
@@ -115,7 +124,7 @@ test('supports including static context labels', () => {
 
   logger.info('Logging something...')
   expect(mockGlobal.infoArgs).toEqual([
-    '[INFO]',
+    '2025-02-15T00:00:00.000Z [INFO]',
     JSON.stringify({ correlationId: 'ABCD1234', model: 'Product' }),
     'Logging something...'])
 

package/lib/translator.js

@@ -0,0 +1,22 @@
+export class Translator {
+  static translate (key, _options) {
+    return key
+  }
+
+  #options = {}
+
+  constructor (options = {}) {
+    this.#options = options
+  }
+
+  translate (key, options) {
+    return this.constructor.translate(
+      key, { ...this.#options, ...options })
+  }
+
+  get t () {
+    return this.translate.bind(this)
+  }
+}
+
+export const t = (key, options) => Translator.translate(key, options)

package/lib/translator.test.js

@@ -0,0 +1,35 @@
+import { it, expect } from '@jest/globals'
+import { Translator, t } from './translator.js'
+
+it('can be instantiated', () => {
+  const translator = new Translator()
+  expect(translator).toBeTruthy()
+})
+
+it('defines a translate function with options', () => {
+  const translator = new Translator()
+
+  const result = translator.translate('any.key') 
+
+  expect(result).toBe('any.key')
+})
+
+it('defines a t shortcut for function translate', () => {
+  const t = new Translator().t
+
+  const result = t('any.key') 
+
+  expect(result).toBe('any.key')
+})
+
+it('defines a global t shortcut translate', () => {
+  const originalTranslate = Translator.translate
+  Translator.translate = (key, _options) => {
+    return `translated:${key}`
+  }
+
+  const result = t('any.key') 
+
+  expect(result).toBe('translated:any.key')
+  Translator.translate = originalTranslate
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowark/loggarkjs",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "Utilitarian Logging Library",
   "main": "./lib/index.js",
   "type": "module",