@oslo-flanders/core 0.0.1-alpha.0

package/README.md

@@ -0,0 +1,75 @@
+# OSLO Core
+
+> Package that contains the core interfaces, classes and functions that can be used across other packages
+
+## Install
+
+```bash
+npm install @oslo-flanders/Core
+```
+
+## Usage
+
+Everything can be imported through named imports from the core packages.
+```node
+import { XXX } from '@oslo-flanders/core'
+```
+
+## Package content
+
+The core package contains general interfaces and utility functions
+
+### Interfaces
+
+#### `IConversionService`
+Interface that must be implemented when creating a new conversion service
+
+#### `IGenerationService`
+Interface that must be implemented when creating a new generator.
+
+#### `IOutputHandler`
+Interface that must be implemented when creating a new output handler.
+
+#### `IConfiguration`
+Interface that must be implemented when creating a new configuration class.
+
+#### `AppRunner`
+**Abstract** class that contains the CLI service to start a conversion or generator service.
+
+### Utils
+
+Small and easy functions that can be used in other packages
+
+#### `fetchFileOrUrl`
+
+Fetches a file or URL and returns a `Buffer`.
+```node
+import { fetchFileOrUrl } from '@oslo-flanders/core'
+
+const buffer = fetchFileOrUrl('/path/or/url/to/file');
+```
+
+#### `namespaces`
+
+Function that ensures that we don't have to write full URIs anymore. Takes the local identifier as string parameter and returns an RDF.NamedNode:
+```
+import { ns } from '@oslo-flanders/core'
+
+const exampleNamedNode = ns.example('test');
+
+// exampleNamedNode.value is equal to 'http://example.org/test'
+
+const rdfType = ns.rdf('type');
+
+// rdfType.value will be 'http://www.w3.org/1999/02/22-rdf-syntax-ns#type'
+```
+
+#### `uniqueId`
+
+Function that returns random string, with a very low probability that the same string is going to be returned multiple times.
+
+```
+import { uniqueId } from '@oslo-flanders/core'
+
+const id = uniqueId();
+```

package/index.js

@@ -0,0 +1,34 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+__exportStar(require("./lib/interfaces/AppRunner"), exports);
+__exportStar(require("./lib/interfaces/IConfiguration"), exports);
+__exportStar(require("./lib/interfaces/IConversionService"), exports);
+__exportStar(require("./lib/interfaces/IGenerationService"), exports);
+__exportStar(require("./lib/interfaces/IOutputHandler"), exports);
+__exportStar(require("./lib/utils/fetchFileOrUrl"), exports);
+__exportStar(require("./lib/utils/namespaces"), exports);
+__exportStar(require("./lib/utils/uniqueId"), exports);
+__exportStar(require("./lib/utils/N3StoreFunctions"), exports);
+__exportStar(require("./lib/ServiceIdentifier"), exports);
+__exportStar(require("./lib/enums/Scope"), exports);
+__exportStar(require("./lib/enums/PropertyTypes"), exports);
+__exportStar(require("./lib/logging/LogLevel"), exports);
+__exportStar(require("./lib/logging/Logger"), exports);
+__exportStar(require("./lib/logging/VoidLogger"), exports);
+__exportStar(require("./lib/logging/WinstonLogger"), exports);
+//# sourceMappingURL=index.js.map

package/lib/ServiceIdentifier.d.ts

@@ -0,0 +1,7 @@
+export declare class ServiceIdentifier {
+    static readonly ConversionService: unique symbol;
+    static readonly GenerationService: unique symbol;
+    static readonly Configuration: unique symbol;
+    static readonly OutputHandler: unique symbol;
+    static readonly Logger: unique symbol;
+}

package/lib/ServiceIdentifier.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceIdentifier = void 0;
+/* eslint-disable eslint-comments/disable-enable-pair */
+/* eslint-disable @typescript-eslint/no-extraneous-class */
+// This must be a class, because it must be possible to extend it in implementations
+class ServiceIdentifier {
+}
+exports.ServiceIdentifier = ServiceIdentifier;
+ServiceIdentifier.ConversionService = Symbol.for('ConversionService');
+ServiceIdentifier.GenerationService = Symbol.for('GenerationService');
+ServiceIdentifier.Configuration = Symbol.for('Configuration');
+ServiceIdentifier.OutputHandler = Symbol.for('OutputHandler');
+ServiceIdentifier.Logger = Symbol.for('Logger');
+//# sourceMappingURL=ServiceIdentifier.js.map

package/lib/ServiceIdentifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceIdentifier.js","sourceRoot":"","sources":["ServiceIdentifier.ts"],"names":[],"mappings":";;;AAAA,wDAAwD;AACxD,2DAA2D;AAC3D,oFAAoF;AACpF,MAAa,iBAAiB;;AAA9B,8CAMC;AALwB,mCAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACpD,mCAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACpD,+BAAa,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAC5C,+BAAa,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAC5C,wBAAM,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC","sourcesContent":["/* eslint-disable eslint-comments/disable-enable-pair */\r\n/* eslint-disable @typescript-eslint/no-extraneous-class */\r\n// This must be a class, because it must be possible to extend it in implementations\r\nexport class ServiceIdentifier {\r\n  public static readonly ConversionService = Symbol.for('ConversionService');\r\n  public static readonly GenerationService = Symbol.for('GenerationService');\r\n  public static readonly Configuration = Symbol.for('Configuration');\r\n  public static readonly OutputHandler = Symbol.for('OutputHandler');\r\n  public static readonly Logger = Symbol.for('Logger');\r\n}\r\n"]}

package/lib/ServiceIdentifier.ts

@@ -0,0 +1,10 @@
+/* eslint-disable eslint-comments/disable-enable-pair */
+/* eslint-disable @typescript-eslint/no-extraneous-class */
+// This must be a class, because it must be possible to extend it in implementations
+export class ServiceIdentifier {
+  public static readonly ConversionService = Symbol.for('ConversionService');
+  public static readonly GenerationService = Symbol.for('GenerationService');
+  public static readonly Configuration = Symbol.for('Configuration');
+  public static readonly OutputHandler = Symbol.for('OutputHandler');
+  public static readonly Logger = Symbol.for('Logger');
+}

package/lib/enums/PropertyTypes.d.ts

@@ -0,0 +1,5 @@
+export declare enum PropertyType {
+    DataTypeProperty = "http://www.w3.org/2002/07/owl#DatatypeProperty",
+    ObjectProperty = "http://www.w3.org/2002/07/owl#ObjectProperty",
+    Property = "http://www.w3.org/1999/02/22-rdf-syntax-ns#Property"
+}

package/lib/enums/PropertyTypes.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertyType = void 0;
+var PropertyType;
+(function (PropertyType) {
+    PropertyType["DataTypeProperty"] = "http://www.w3.org/2002/07/owl#DatatypeProperty";
+    PropertyType["ObjectProperty"] = "http://www.w3.org/2002/07/owl#ObjectProperty";
+    PropertyType["Property"] = "http://www.w3.org/1999/02/22-rdf-syntax-ns#Property";
+})(PropertyType = exports.PropertyType || (exports.PropertyType = {}));
+//# sourceMappingURL=PropertyTypes.js.map

package/lib/enums/PropertyTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyTypes.js","sourceRoot":"","sources":["PropertyTypes.ts"],"names":[],"mappings":";;;AAAA,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,mFAAmE,CAAA;IACnE,+EAA+D,CAAA;IAC/D,gFAAgE,CAAA;AAClE,CAAC,EAJW,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QAIvB","sourcesContent":["export enum PropertyType {\r\n  DataTypeProperty = 'http://www.w3.org/2002/07/owl#DatatypeProperty',\r\n  ObjectProperty = 'http://www.w3.org/2002/07/owl#ObjectProperty',\r\n  Property = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#Property',\r\n}\r\n"]}

package/lib/enums/PropertyTypes.ts

@@ -0,0 +1,5 @@
+export enum PropertyType {
+  DataTypeProperty = 'http://www.w3.org/2002/07/owl#DatatypeProperty',
+  ObjectProperty = 'http://www.w3.org/2002/07/owl#ObjectProperty',
+  Property = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#Property',
+}

package/lib/enums/Scope.d.ts

@@ -0,0 +1,6 @@
+export declare enum Scope {
+    InPackage = "https://data.vlaanderen.be/id/concept/scope/InPackage",
+    InPublicationEnvironment = "https://data.vlaanderen.be/id/concept/scope/InPublicationEnvironment",
+    External = "https://data.vlaanderen.be/id/concept/scope/External",
+    Undefined = "https://data.vlaanderen.be/id/concept/scope/Undefined"
+}

package/lib/enums/Scope.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scope = void 0;
+var Scope;
+(function (Scope) {
+    Scope["InPackage"] = "https://data.vlaanderen.be/id/concept/scope/InPackage";
+    Scope["InPublicationEnvironment"] = "https://data.vlaanderen.be/id/concept/scope/InPublicationEnvironment";
+    Scope["External"] = "https://data.vlaanderen.be/id/concept/scope/External";
+    Scope["Undefined"] = "https://data.vlaanderen.be/id/concept/scope/Undefined";
+})(Scope = exports.Scope || (exports.Scope = {}));
+//# sourceMappingURL=Scope.js.map

package/lib/enums/Scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scope.js","sourceRoot":"","sources":["Scope.ts"],"names":[],"mappings":";;;AAAA,IAAY,KAKX;AALD,WAAY,KAAK;IACf,4EAAmE,CAAA;IACnE,0GAAiG,CAAA;IACjG,0EAAiE,CAAA;IACjE,4EAAmE,CAAA;AACrE,CAAC,EALW,KAAK,GAAL,aAAK,KAAL,aAAK,QAKhB","sourcesContent":["export enum Scope {\r\n  InPackage = 'https://data.vlaanderen.be/id/concept/scope/InPackage',\r\n  InPublicationEnvironment = 'https://data.vlaanderen.be/id/concept/scope/InPublicationEnvironment',\r\n  External = 'https://data.vlaanderen.be/id/concept/scope/External',\r\n  Undefined = 'https://data.vlaanderen.be/id/concept/scope/Undefined'\r\n}\r\n"]}

package/lib/enums/Scope.ts

@@ -0,0 +1,6 @@
+export enum Scope {
+  InPackage = 'https://data.vlaanderen.be/id/concept/scope/InPackage',
+  InPublicationEnvironment = 'https://data.vlaanderen.be/id/concept/scope/InPublicationEnvironment',
+  External = 'https://data.vlaanderen.be/id/concept/scope/External',
+  Undefined = 'https://data.vlaanderen.be/id/concept/scope/Undefined'
+}

package/lib/interfaces/AppRunner.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="node" />
+export declare type CliArgv = string[];
+export declare type YargsParams = {
+    [x: string]: unknown;
+    _: (string | number)[];
+    $0: string;
+} | {
+    [x: string]: unknown;
+    _: (string | number)[];
+    $0: string;
+};
+export declare abstract class AppRunner {
+    runCliSync(process: NodeJS.Process): void;
+    abstract runCli(argv: CliArgv): Promise<void>;
+}

package/lib/interfaces/AppRunner.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppRunner = void 0;
+const process_1 = require("process");
+class AppRunner {
+    runCliSync(process) {
+        this.runCli(process.argv).catch((error) => {
+            process_1.stderr.write(error.message);
+            // eslint-disable-next-line unicorn/no-process-exit
+            process.exit(1);
+        });
+    }
+}
+exports.AppRunner = AppRunner;
+//# sourceMappingURL=AppRunner.js.map

package/lib/interfaces/AppRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppRunner.js","sourceRoot":"","sources":["AppRunner.ts"],"names":[],"mappings":";;;AAAA,qCAAiC;AAcjC,MAAsB,SAAS;IACtB,UAAU,CAAC,OAAuB;QACvC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAS,EAAE;YAC/C,gBAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5B,mDAAmD;YACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC;CAGF;AAVD,8BAUC","sourcesContent":["import { stderr } from 'process';\r\n\r\nexport type CliArgv = string[];\r\n\r\nexport type YargsParams = {\r\n  [x: string]: unknown;\r\n  _: (string | number)[];\r\n  $0: string;\r\n} | {\r\n  [x: string]: unknown;\r\n  _: (string | number)[];\r\n  $0: string;\r\n};\r\n\r\nexport abstract class AppRunner {\r\n  public runCliSync(process: NodeJS.Process): void {\r\n    this.runCli(process.argv).catch((error): never => {\r\n      stderr.write(error.message);\r\n      // eslint-disable-next-line unicorn/no-process-exit\r\n      process.exit(1);\r\n    });\r\n  }\r\n\r\n  public abstract runCli(argv: CliArgv): Promise<void>;\r\n}\r\n"]}

package/lib/interfaces/AppRunner.ts

@@ -0,0 +1,25 @@
+import { stderr } from 'process';
+
+export type CliArgv = string[];
+
+export type YargsParams = {
+  [x: string]: unknown;
+  _: (string | number)[];
+  $0: string;
+} | {
+  [x: string]: unknown;
+  _: (string | number)[];
+  $0: string;
+};
+
+export abstract class AppRunner {
+  public runCliSync(process: NodeJS.Process): void {
+    this.runCli(process.argv).catch((error): never => {
+      stderr.write(error.message);
+      // eslint-disable-next-line unicorn/no-process-exit
+      process.exit(1);
+    });
+  }
+
+  public abstract runCli(argv: CliArgv): Promise<void>;
+}

package/lib/interfaces/IConfiguration.d.ts

@@ -0,0 +1,7 @@
+import type { YargsParams } from './AppRunner';
+/**
+ * Interface that must be implemented by classes that contain configuration properties
+ */
+export interface IConfiguration {
+    createFromCli: (params: YargsParams) => Promise<void>;
+}

package/lib/interfaces/IConfiguration.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IConfiguration.js.map

package/lib/interfaces/IConfiguration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConfiguration.js","sourceRoot":"","sources":["IConfiguration.ts"],"names":[],"mappings":"","sourcesContent":["import type { YargsParams } from './AppRunner';\r\n\r\n/**\r\n * Interface that must be implemented by classes that contain configuration properties\r\n */\r\nexport interface IConfiguration {\r\n  createFromCli: (params: YargsParams) => Promise<void>;\r\n}\r\n"]}

package/lib/interfaces/IConfiguration.ts

@@ -0,0 +1,8 @@
+import type { YargsParams } from './AppRunner';
+
+/**
+ * Interface that must be implemented by classes that contain configuration properties
+ */
+export interface IConfiguration {
+  createFromCli: (params: YargsParams) => Promise<void>;
+}

package/lib/interfaces/IConversionService.d.ts

@@ -0,0 +1,10 @@
+import type { Logger } from '../logging/Logger';
+import type { IConfiguration } from './IConfiguration';
+/**
+ * Interface that must be implemented by classes that convert a UML diagram to an RDF file
+ */
+export interface IConversionService {
+    logger: Logger;
+    configuration: IConfiguration;
+    run: () => Promise<void>;
+}

package/lib/interfaces/IConversionService.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IConversionService.js.map

package/lib/interfaces/IConversionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConversionService.js","sourceRoot":"","sources":["IConversionService.ts"],"names":[],"mappings":"","sourcesContent":["import type { Logger } from '../logging/Logger';\r\nimport type { IConfiguration } from './IConfiguration';\r\n\r\n/**\r\n * Interface that must be implemented by classes that convert a UML diagram to an RDF file\r\n */\r\nexport interface IConversionService {\r\n  logger: Logger;\r\n  configuration: IConfiguration;\r\n  run: () => Promise<void>;\r\n}\r\n"]}

package/lib/interfaces/IConversionService.ts

@@ -0,0 +1,11 @@
+import type { Logger } from '../logging/Logger';
+import type { IConfiguration } from './IConfiguration';
+
+/**
+ * Interface that must be implemented by classes that convert a UML diagram to an RDF file
+ */
+export interface IConversionService {
+  logger: Logger;
+  configuration: IConfiguration;
+  run: () => Promise<void>;
+}

package/lib/interfaces/IGenerationService.d.ts

@@ -0,0 +1,8 @@
+import type { IConfiguration } from './IConfiguration';
+/**
+ * Interface that must be implemented by classes that use an RDF file as input and generates an artefact
+ */
+export interface IGenerationService {
+    configuration: IConfiguration;
+    run: () => Promise<void>;
+}

package/lib/interfaces/IGenerationService.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IGenerationService.js.map

package/lib/interfaces/IGenerationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGenerationService.js","sourceRoot":"","sources":["IGenerationService.ts"],"names":[],"mappings":"","sourcesContent":["import type { IConfiguration } from './IConfiguration';\r\n\r\n/**\r\n * Interface that must be implemented by classes that use an RDF file as input and generates an artefact\r\n */\r\nexport interface IGenerationService {\r\n  configuration: IConfiguration;\r\n  run: () => Promise<void>;\r\n}\r\n"]}

package/lib/interfaces/IGenerationService.ts

@@ -0,0 +1,9 @@
+import type { IConfiguration } from './IConfiguration';
+
+/**
+ * Interface that must be implemented by classes that use an RDF file as input and generates an artefact
+ */
+export interface IGenerationService {
+  configuration: IConfiguration;
+  run: () => Promise<void>;
+}

package/lib/interfaces/IOutputHandler.d.ts

@@ -0,0 +1,7 @@
+import type { Quad, Store } from 'n3';
+/**
+ * Writes the triples in an RDF store to a write stream
+ */
+export interface IOutputHandler {
+    write: (store: Store<Quad>, writeStream: any) => Promise<void>;
+}

package/lib/interfaces/IOutputHandler.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IOutputHandler.js.map

package/lib/interfaces/IOutputHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IOutputHandler.js","sourceRoot":"","sources":["IOutputHandler.ts"],"names":[],"mappings":"","sourcesContent":["import type { Quad, Store } from 'n3';\r\n\r\n/**\r\n * Writes the triples in an RDF store to a write stream\r\n */\r\nexport interface IOutputHandler {\r\n  write: (store: Store<Quad>, writeStream: any) => Promise<void>;\r\n}\r\n"]}

package/lib/interfaces/IOutputHandler.ts

@@ -0,0 +1,8 @@
+import type { Quad, Store } from 'n3';
+
+/**
+ * Writes the triples in an RDF store to a write stream
+ */
+export interface IOutputHandler {
+  write: (store: Store<Quad>, writeStream: any) => Promise<void>;
+}

package/lib/logging/LogLevel.d.ts

@@ -0,0 +1,5 @@
+export declare const LOG_LEVELS: readonly ["error", "warn", "info", "verbose", "debug", "silly"];
+/**
+ * Different log levels, from most important to least important.
+ */
+export declare type LogLevel = typeof LOG_LEVELS[number];

package/lib/logging/LogLevel.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOG_LEVELS = void 0;
+exports.LOG_LEVELS = ['error', 'warn', 'info', 'verbose', 'debug', 'silly'];
+//# sourceMappingURL=LogLevel.js.map

package/lib/logging/LogLevel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogLevel.js","sourceRoot":"","sources":["LogLevel.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC","sourcesContent":["export const LOG_LEVELS = <const>['error', 'warn', 'info', 'verbose', 'debug', 'silly'];\r\n\r\n/**\r\n * Different log levels, from most important to least important.\r\n */\r\nexport type LogLevel = typeof LOG_LEVELS[number];\r\n"]}

package/lib/logging/LogLevel.ts

@@ -0,0 +1,6 @@
+export const LOG_LEVELS = <const>['error', 'warn', 'info', 'verbose', 'debug', 'silly'];
+
+/**
+ * Different log levels, from most important to least important.
+ */
+export type LogLevel = typeof LOG_LEVELS[number];

package/lib/logging/Logger.d.ts

@@ -0,0 +1,19 @@
+import type { LogLevel } from './LogLevel';
+export interface Logger {
+    log: (level: LogLevel, message: string) => Logger;
+    error: (message: string) => Logger;
+    warn: (message: string) => Logger;
+    info: (message: string) => Logger;
+    verbose: (message: string) => Logger;
+    debug: (message: string) => Logger;
+    silly: (message: string) => Logger;
+}
+export declare abstract class BaseLogger implements Logger {
+    abstract log(level: LogLevel, message: string): Logger;
+    error(message: string): Logger;
+    warn(message: string): Logger;
+    info(message: string): Logger;
+    verbose(message: string): Logger;
+    debug(message: string): Logger;
+    silly(message: string): Logger;
+}

package/lib/logging/Logger.js

@@ -0,0 +1,35 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseLogger = void 0;
+const inversify_1 = require("inversify");
+let BaseLogger = class BaseLogger {
+    error(message) {
+        return this.log('error', message);
+    }
+    warn(message) {
+        return this.log('warn', message);
+    }
+    info(message) {
+        return this.log('info', message);
+    }
+    verbose(message) {
+        return this.log('verbose', message);
+    }
+    debug(message) {
+        return this.log('debug', message);
+    }
+    silly(message) {
+        return this.log('silly', message);
+    }
+};
+BaseLogger = __decorate([
+    (0, inversify_1.injectable)()
+], BaseLogger);
+exports.BaseLogger = BaseLogger;
+//# sourceMappingURL=Logger.js.map

package/lib/logging/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["Logger.ts"],"names":[],"mappings":";;;;;;;;;AAAA,yCAAuC;AAchC,IAAe,UAAU,GAAzB,MAAe,UAAU;IAGvB,KAAK,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAEM,IAAI,CAAC,OAAe;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAEM,IAAI,CAAC,OAAe;QACzB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAEM,OAAO,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAEM,KAAK,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAEM,KAAK,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;CACF,CAAA;AA1BqB,UAAU;IAD/B,IAAA,sBAAU,GAAE;GACS,UAAU,CA0B/B;AA1BqB,gCAAU","sourcesContent":["import { injectable } from 'inversify';\r\nimport type { LogLevel } from './LogLevel';\r\n\r\nexport interface Logger {\r\n  log: (level: LogLevel, message: string) => Logger;\r\n  error: (message: string) => Logger;\r\n  warn: (message: string) => Logger;\r\n  info: (message: string) => Logger;\r\n  verbose: (message: string) => Logger;\r\n  debug: (message: string) => Logger;\r\n  silly: (message: string) => Logger;\r\n}\r\n\r\n@injectable()\r\nexport abstract class BaseLogger implements Logger {\r\n  public abstract log(level: LogLevel, message: string): Logger;\r\n\r\n  public error(message: string): Logger {\r\n    return this.log('error', message);\r\n  }\r\n\r\n  public warn(message: string): Logger {\r\n    return this.log('warn', message);\r\n  }\r\n\r\n  public info(message: string): Logger {\r\n    return this.log('info', message);\r\n  }\r\n\r\n  public verbose(message: string): Logger {\r\n    return this.log('verbose', message);\r\n  }\r\n\r\n  public debug(message: string): Logger {\r\n    return this.log('debug', message);\r\n  }\r\n\r\n  public silly(message: string): Logger {\r\n    return this.log('silly', message);\r\n  }\r\n}\r\n"]}

package/lib/logging/Logger.ts

@@ -0,0 +1,41 @@
+import { injectable } from 'inversify';
+import type { LogLevel } from './LogLevel';
+
+export interface Logger {
+  log: (level: LogLevel, message: string) => Logger;
+  error: (message: string) => Logger;
+  warn: (message: string) => Logger;
+  info: (message: string) => Logger;
+  verbose: (message: string) => Logger;
+  debug: (message: string) => Logger;
+  silly: (message: string) => Logger;
+}
+
+@injectable()
+export abstract class BaseLogger implements Logger {
+  public abstract log(level: LogLevel, message: string): Logger;
+
+  public error(message: string): Logger {
+    return this.log('error', message);
+  }
+
+  public warn(message: string): Logger {
+    return this.log('warn', message);
+  }
+
+  public info(message: string): Logger {
+    return this.log('info', message);
+  }
+
+  public verbose(message: string): Logger {
+    return this.log('verbose', message);
+  }
+
+  public debug(message: string): Logger {
+    return this.log('debug', message);
+  }
+
+  public silly(message: string): Logger {
+    return this.log('silly', message);
+  }
+}

package/lib/logging/VoidLogger.d.ts

@@ -0,0 +1,7 @@
+import type { Logger } from './Logger';
+import { BaseLogger } from './Logger';
+import type { LogLevel } from './LogLevel';
+export declare class VoidLogger extends BaseLogger {
+    constructor();
+    log(level: LogLevel, message: string): Logger;
+}

package/lib/logging/VoidLogger.js

@@ -0,0 +1,28 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VoidLogger = void 0;
+const inversify_1 = require("inversify");
+const Logger_1 = require("./Logger");
+let VoidLogger = class VoidLogger extends Logger_1.BaseLogger {
+    constructor() {
+        super();
+    }
+    log(level, message) {
+        return this;
+    }
+};
+VoidLogger = __decorate([
+    (0, inversify_1.injectable)(),
+    __metadata("design:paramtypes", [])
+], VoidLogger);
+exports.VoidLogger = VoidLogger;
+//# sourceMappingURL=VoidLogger.js.map

package/lib/logging/VoidLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoidLogger.js","sourceRoot":"","sources":["VoidLogger.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAuC;AAEvC,qCAAsC;AAI/B,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,mBAAU;IACxC;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAEM,GAAG,CAAC,KAAe,EAAE,OAAe;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AARY,UAAU;IADtB,IAAA,sBAAU,GAAE;;GACA,UAAU,CAQtB;AARY,gCAAU","sourcesContent":["import { injectable } from 'inversify';\r\nimport type { Logger } from './Logger';\r\nimport { BaseLogger } from './Logger';\r\nimport type { LogLevel } from './LogLevel';\r\n\r\n@injectable()\r\nexport class VoidLogger extends BaseLogger {\r\n  public constructor() {\r\n    super();\r\n  }\r\n\r\n  public log(level: LogLevel, message: string): Logger {\r\n    return this;\r\n  }\r\n}\r\n"]}

package/lib/logging/VoidLogger.ts

@@ -0,0 +1,15 @@
+import { injectable } from 'inversify';
+import type { Logger } from './Logger';
+import { BaseLogger } from './Logger';
+import type { LogLevel } from './LogLevel';
+
+@injectable()
+export class VoidLogger extends BaseLogger {
+  public constructor() {
+    super();
+  }
+
+  public log(level: LogLevel, message: string): Logger {
+    return this;
+  }
+}

package/lib/logging/WinstonLogger.d.ts

@@ -0,0 +1,7 @@
+import { BaseLogger } from './Logger';
+import { LogLevel } from './LogLevel';
+export declare class WinstonLogger extends BaseLogger {
+    private readonly logger;
+    constructor(logLevel: LogLevel);
+    log(level: LogLevel, message: string): this;
+}