@ninetailed/experience.js 2.0.2 → 2.1.0

package/index.umd.js

@@ -1,32 +1,13 @@
 (function (global, factory) {
-	typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('lodash/get'), require('lodash/unionBy'), require('@ninetailed/experience.js-shared'), require('loglevel'), require('analytics'), require('lodash/flatten'), require('lodash/find'), require('lodash/includes'), require('lodash/pickBy'), require('murmurhash-js')) :
-	typeof define === 'function' && define.amd ? define(['exports', 'lodash/get', 'lodash/unionBy', '@ninetailed/experience.js-shared', 'loglevel', 'analytics', 'lodash/flatten', 'lodash/find', 'lodash/includes', 'lodash/pickBy', 'murmurhash-js'], factory) :
-	(global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.Javascript = {}, global.get$2, global.unionBy, global.experience_jsShared, global.loglevel, global.Analytics, global.flatten, global.find, global.includes, global.pickBy, global.murmurhashJs));
-})(this, (function (exports, get$2, unionBy, experience_jsShared, loglevel, Analytics, flatten, find, includes, pickBy, murmurhashJs) { 'use strict';
+	typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('lodash/get'), require('lodash/unionBy'), require('@ninetailed/experience.js-shared'), require('diary'), require('analytics'), require('lodash/flatten'), require('lodash/find'), require('lodash/includes'), require('lodash/pickBy'), require('murmurhash-js')) :
+	typeof define === 'function' && define.amd ? define(['exports', 'lodash/get', 'lodash/unionBy', '@ninetailed/experience.js-shared', 'diary', 'analytics', 'lodash/flatten', 'lodash/find', 'lodash/includes', 'lodash/pickBy', 'murmurhash-js'], factory) :
+	(global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.Javascript = {}, global.get$2, global.unionBy, global.experience_jsShared, global.diary, global.Analytics, global.flatten, global.find, global.includes, global.pickBy, global.murmurhashJs));
+})(this, (function (exports, get$2, unionBy, experience_jsShared, diary, Analytics, flatten, find, includes, pickBy, murmurhashJs) { 'use strict';
 
 	function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
-	function _interopNamespace(e) {
-		if (e && e.__esModule) return e;
-		var n = Object.create(null);
-		if (e) {
-			Object.keys(e).forEach(function (k) {
-				if (k !== 'default') {
-					var d = Object.getOwnPropertyDescriptor(e, k);
-					Object.defineProperty(n, k, d.get ? d : {
-						enumerable: true,
-						get: function () { return e[k]; }
-					});
-				}
-			});
-		}
-		n["default"] = e;
-		return Object.freeze(n);
-	}
-
 	var get__default = /*#__PURE__*/_interopDefaultLegacy(get$2);
 	var unionBy__default = /*#__PURE__*/_interopDefaultLegacy(unionBy);
-	var loglevel__namespace = /*#__PURE__*/_interopNamespace(loglevel);
 	var Analytics__default = /*#__PURE__*/_interopDefaultLegacy(Analytics);
 	var flatten__default = /*#__PURE__*/_interopDefaultLegacy(flatten);
 	var find__default = /*#__PURE__*/_interopDefaultLegacy(find);
@@ -2313,15 +2294,6 @@
 	  };
 	};
 
-	var enable = function enable() {
-	  loglevel__namespace.enableAll();
-	};
-	var disable = function disable() {
-	  loglevel__namespace.disableAll();
-	};
-	var Logger = loglevel__namespace.getLogger('ninetailed:experience.js');
-	var log = Logger.log;
-
 	var BASE_URL = 'https://api.ninetailed.co';
 
 	var fetchWithTimeout = function fetchWithTimeout(input, init) {
@@ -2333,7 +2305,7 @@
 	          timeout = init.timeout;
 	          controller = new AbortController();
 	          id = setTimeout(function () {
-	            log("Profile Request timed out.");
+	            logger.error(new Error('Ninetailed Request timed out.'));
 	            controller.abort();
 	          }, timeout);
 	          return [4
@@ -2373,11 +2345,11 @@
 	      return __generator(this, function (_a) {
 	        switch (_a.label) {
 	          case 0:
-	            log('Sending Profile Request.');
+	            logger.info('Sending Profile Request.');
 	            events = options.events;
 	            anonymousId = events[0].anonymousId;
 	            body = options;
-	            log('Profile Request Body: ', body);
+	            logger.debug('Profile Request Body: ', body);
 	            _a.label = 1;
 
 	          case 1:
@@ -2396,14 +2368,14 @@
 
 	          case 2:
 	            request = _a.sent();
-	            log('Profile Request: ', request);
+	            logger.debug('Profile Request: ', request);
 	            return [4
 	            /*yield*/
 	            , request.json()];
 
 	          case 3:
 	            data = _a.sent().data;
-	            log('Profile Request completed.');
+	            logger.debug('Profile Request completed.');
 	            return [2
 	            /*return*/
 	            , data];
@@ -2411,7 +2383,7 @@
 	          case 4:
 	            error_1 = _a.sent(); // TODO only during debug.
 
-	            log(error_1);
+	            logger.error(error_1);
 	            throw error_1;
 
 	          case 5:
@@ -2426,6 +2398,262 @@
 	  return NinetailedApiClient;
 	}();
 
+	var Logger =
+	/** @class */
+	function () {
+	  function Logger() {
+	    this.name = '@ninetailed/experience.js';
+	    this.sinks = [];
+	    this.diary = diary.diary(this.name, this.onLogEvent.bind(this));
+	    diary.enable(this.name);
+	  }
+
+	  Logger.prototype.addSink = function (sink) {
+	    this.sinks = __spreadArray(__spreadArray([], this.sinks, true), [sink], false);
+	  };
+
+	  Logger.prototype.removeSink = function (name) {
+	    this.sinks = this.sinks.filter(function (sink) {
+	      return sink.name !== name;
+	    });
+	  };
+
+	  Logger.prototype.debug = function (message) {
+	    var _a;
+
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    (_a = this.diary).debug.apply(_a, __spreadArray([message], args, false));
+	  };
+
+	  Logger.prototype.info = function (message) {
+	    var _a;
+
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    (_a = this.diary).info.apply(_a, __spreadArray([message], args, false));
+	  };
+
+	  Logger.prototype.log = function (message) {
+	    var _a;
+
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    (_a = this.diary).log.apply(_a, __spreadArray([message], args, false));
+	  };
+
+	  Logger.prototype.warn = function (message) {
+	    var _a;
+
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    (_a = this.diary).warn.apply(_a, __spreadArray([message], args, false));
+	  };
+
+	  Logger.prototype.error = function (message) {
+	    var _a;
+
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    (_a = this.diary).error.apply(_a, __spreadArray([message], args, false));
+	  };
+
+	  Logger.prototype.fatal = function (message) {
+	    var _a;
+
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    (_a = this.diary).fatal.apply(_a, __spreadArray([message], args, false));
+	  };
+
+	  Logger.prototype.onLogEvent = function (event) {
+	    this.sinks.forEach(function (sink) {
+	      if (sink[event.level]) {
+	        sink[event.level].apply(sink, __spreadArray([event.message], event.extra, false));
+	      }
+	    });
+	  };
+
+	  return Logger;
+	}();
+	var logger = new Logger();
+
+	var ConsoleLogSink =
+	/** @class */
+	function () {
+	  function ConsoleLogSink() {
+	    this.name = "ConsoleLogSink";
+	  }
+
+	  ConsoleLogSink.prototype.debug = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    console.debug.apply(console, __spreadArray([message], args, false));
+	  };
+
+	  ConsoleLogSink.prototype.info = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    console.info.apply(console, __spreadArray([message], args, false));
+	  };
+
+	  ConsoleLogSink.prototype.log = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    console.log.apply(console, __spreadArray([message], args, false));
+	  };
+
+	  ConsoleLogSink.prototype.warn = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    console.warn.apply(console, __spreadArray([message], args, false));
+	  };
+
+	  ConsoleLogSink.prototype.error = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    console.error.apply(console, __spreadArray([message], args, false));
+	  };
+
+	  ConsoleLogSink.prototype.fatal = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    console.error.apply(console, __spreadArray([message], args, false));
+	  };
+
+	  return ConsoleLogSink;
+	}();
+
+	var OnLogLogSink =
+	/** @class */
+	function () {
+	  function OnLogLogSink(onLog) {
+	    this.onLog = onLog;
+	    this.name = 'OnLogLogSink';
+	  }
+
+	  OnLogLogSink.prototype.debug = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    this.onLog.apply(this, __spreadArray([message], args, false));
+	  };
+
+	  OnLogLogSink.prototype.info = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    this.onLog.apply(this, __spreadArray([message], args, false));
+	  };
+
+	  OnLogLogSink.prototype.log = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    this.onLog.apply(this, __spreadArray([message], args, false));
+	  };
+
+	  OnLogLogSink.prototype.warn = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    this.onLog.apply(this, __spreadArray([message], args, false));
+	  };
+
+	  return OnLogLogSink;
+	}();
+
+	var OnErrorLogSink =
+	/** @class */
+	function () {
+	  function OnErrorLogSink(onError) {
+	    this.onError = onError;
+	    this.name = 'OnErrorLogSink';
+	  }
+
+	  OnErrorLogSink.prototype.error = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    this.onError.apply(this, __spreadArray([message], args, false));
+	  };
+
+	  OnErrorLogSink.prototype.fatal = function (message) {
+	    var args = [];
+
+	    for (var _i = 1; _i < arguments.length; _i++) {
+	      args[_i - 1] = arguments[_i];
+	    }
+
+	    this.onError.apply(this, __spreadArray([message], args, false));
+	  };
+
+	  return OnErrorLogSink;
+	}();
+
 	var NINETAILED_TRACKER_EVENTS = {
 	  /**
 	   * `profile` - Fires when the profile is returned by the cdp API.
@@ -2433,6 +2661,7 @@
 	  profile: 'profile'
 	};
 	var PLUGIN_NAME = 'ninetailed';
+	var DEBUG_FLAG_KEY = 'nt-debug';
 
 	var delay = function delay(ms) {
 	  return new Promise(function (resolve) {
@@ -2507,7 +2736,7 @@
 	        switch (_b.label) {
 	          case 0:
 	            events = Object.assign([], queue);
-	            log('Start flushing events.');
+	            logger.info('Start flushing events.');
 	            queue = [];
 
 	            if (!events.length) {
@@ -2524,7 +2753,7 @@
 	          case 1:
 	            _b.trys.push([1, 3,, 4]);
 
-	            log('Cache: ', cache);
+	            logger.debug('Cache: ', cache);
 	            return [4
 	            /*yield*/
 	            , apiClient.profile({
@@ -2542,7 +2771,7 @@
 
 	          case 2:
 	            _a = _b.sent(), profile_1 = _a.profile, signals = _a.signals, traitsUpdatedAt = _a.traitsUpdatedAt, sessions = _a.sessions;
-	            log('Profile from api: ', profile_1);
+	            logger.debug('Profile from api: ', profile_1);
 	            updatedCache = set({
 	              id: profile_1.id,
 	              random: profile_1.random,
@@ -2567,7 +2796,7 @@
 
 	          case 3:
 	            error_1 = _b.sent();
-	            log('An error occurred during flushing the events: ', error_1);
+	            logger.debug('An error occurred during flushing the events: ', error_1);
 	            instance.dispatch({
 	              type: NINETAILED_TRACKER_EVENTS.profile,
 	              profile: {
@@ -2625,6 +2854,11 @@
 	    config: {},
 	    initialize: function (_a) {
 	      var instance = _a.instance;
+
+	      if (instance.storage.getItem(DEBUG_FLAG_KEY)) {
+	        logger.addSink(new ConsoleLogSink());
+	      }
+
 	      var cache = get({
 	        instance: instance
 	      });
@@ -2655,7 +2889,7 @@
 	        return __generator(this, function (_b) {
 	          switch (_b.label) {
 	            case 0:
-	              log('Sending Page event.');
+	              logger.info('Sending Page event.');
 	              ctx = buildClientNinetailedRequestContext();
 	              localOnly = payload.localOnly;
 	              return [4
@@ -2687,7 +2921,7 @@
 	        return __generator(this, function (_b) {
 	          switch (_b.label) {
 	            case 0:
-	              log('Sending Track event.');
+	              logger.info('Sending Track event.');
 	              ctx = buildClientNinetailedRequestContext();
 	              localOnly = payload.localOnly;
 	              return [4
@@ -2720,7 +2954,7 @@
 	        return __generator(this, function (_b) {
 	          switch (_b.label) {
 	            case 0:
-	              log('Sending Identify event.');
+	              logger.info('Sending Identify event.');
 	              localOnly = payload.localOnly;
 	              ctx = buildClientNinetailedRequestContext();
 	              return [4
@@ -2797,14 +3031,58 @@
 	          });
 	        });
 	      },
-	      debug: function (enabled) {
-	        if (enabled) {
-	          enable();
-	          log('Debug mode is now enabled.');
-	        } else {
-	          disable();
-	          log('Debug mode is now disabled.');
+	      debug: function () {
+	        var args = [];
+
+	        for (var _i = 0; _i < arguments.length; _i++) {
+	          args[_i] = arguments[_i];
 	        }
+
+	        return __awaiter(void 0, void 0, void 0, function () {
+	          var enabled, instance, consoleLogSink;
+	          return __generator(this, function (_a) {
+	            switch (_a.label) {
+	              case 0:
+	                enabled = args[0];
+	                instance = args[args.length - 1];
+	                consoleLogSink = new ConsoleLogSink();
+	                if (!enabled) return [3
+	                /*break*/
+	                , 2];
+	                return [4
+	                /*yield*/
+	                , instance.storage.setItem(DEBUG_FLAG_KEY, true)];
+
+	              case 1:
+	                _a.sent(); // cleanup other console log sinks if there are already some.
+
+
+	                logger.removeSink(consoleLogSink.name);
+	                logger.addSink(consoleLogSink);
+	                logger.info('Debug mode enabled.');
+	                return [3
+	                /*break*/
+	                , 4];
+
+	              case 2:
+	                return [4
+	                /*yield*/
+	                , instance.storage.removeItem(DEBUG_FLAG_KEY)];
+
+	              case 3:
+	                _a.sent();
+
+	                logger.info('Debug mode disabled.');
+	                logger.removeSink(consoleLogSink.name);
+	                _a.label = 4;
+
+	              case 4:
+	                return [2
+	                /*return*/
+	                ];
+	            }
+	          });
+	        });
 	      }
 	    }
 	  };
@@ -2825,7 +3103,9 @@
 	        url = _c.url,
 	        profile = _c.profile,
 	        locale = _c.locale,
-	        requestTimeout = _c.requestTimeout;
+	        requestTimeout = _c.requestTimeout,
+	        onLog = _c.onLog,
+	        onError = _c.onError;
 
 	    this.page = function (data, options) {
 	      return _this.instance.page(data, _this.buildOptions(options));
@@ -2895,6 +3175,15 @@
 	      };
 	    }
 
+	    if (typeof onLog === 'function') {
+	      logger.addSink(new OnLogLogSink(onLog));
+	    }
+
+	    if (typeof onError === 'function') {
+	      logger.addSink(new OnErrorLogSink(onError));
+	    }
+
+	    this.logger = logger;
 	    this.instance = Analytics__default["default"]({
 	      app: 'ninetailed',
 	      plugins: __spreadArray(__spreadArray([], this.plugins, true), [ninetailedPlugin({
@@ -3834,13 +4123,13 @@
 	      activeExperiments = _a.activeExperiments,
 	      profile = _a.profile;
 	  var trafficRandom = getTrafficRandom(profile, experience);
-	  log("The traffic random factor for experience ".concat(experience.id, " is ").concat(trafficRandom, ". It's traffic allocation is set to ").concat(experience.trafficAllocation, "."));
+	  logger.info("The traffic random factor for experience ".concat(experience.id, " is ").concat(trafficRandom, ". It's traffic allocation is set to ").concat(experience.trafficAllocation, "."));
 	  var isInTrafficRange = experience.trafficAllocation > trafficRandom;
 	  var matchesAudience = !experience.audience || includes__default["default"](profile.audiences, experience.audience.id);
 	  var hasActiveExperiment = !!find__default["default"](activeExperiments, {
 	    id: experience.id
 	  });
-	  log("Is the profile in traffic allocation range? ".concat(isInTrafficRange ? 'yes' : 'no', ".\n\n      Does the profile match the audience of the experience? ").concat(matchesAudience ? 'yes' : 'no', ".\n\n      Is there an active experiment for this profile? ").concat(hasActiveExperiment ? 'yes' : 'no', "."));
+	  logger.info("Is the profile in traffic allocation range? ".concat(isInTrafficRange ? 'yes' : 'no', ".\n\n      Does the profile match the audience of the experience? ").concat(matchesAudience ? 'yes' : 'no', ".\n\n      Is there an active experiment for this profile? ").concat(hasActiveExperiment ? 'yes' : 'no', "."));
 	  return isInTrafficRange && (matchesAudience || // if the expriment is active already then it's selectible without further contraints to be fullfilled
 	  hasActiveExperiment);
 	};
@@ -3867,7 +4156,7 @@
 	  var experience = _a.experience,
 	      profile = _a.profile;
 	  var distributionRandom = getDistributionRandom(profile, experience);
-	  log("The distribution random factor for experience ".concat(experience.id, " is ").concat(distributionRandom, ". It's distribution is set to ").concat(JSON.stringify(experience.distribution, null, 2), "."));
+	  logger.log("The distribution random factor for experience ".concat(experience.id, " is ").concat(distributionRandom, ". It's distribution is set to ").concat(JSON.stringify(experience.distribution, null, 2), "."));
 	  var distribution = find__default["default"](experience.distribution, function (_a) {
 	    var start = _a.start,
 	        end = _a.end;
@@ -4277,6 +4566,7 @@
 	exports.PLUGIN_NAME = PLUGIN_NAME;
 	exports.decodeExperienceVariantsMap = decodeExperienceVariantsMap;
 	exports.isExperienceMatch = isExperienceMatch;
+	exports.logger = logger;
 	exports.ninetailedPlugin = ninetailedPlugin;
 	exports.selectActiveExperiments = selectActiveExperiments;
 	exports.selectDistribution = selectDistribution;

package/lib/Ninetailed.d.ts

@@ -2,6 +2,8 @@ import { PageData, AnalyticsPlugin, DetachListeners } from 'analytics';
 import { Locale, Traits, Profile, Variant } from '@ninetailed/experience.js-shared';
 import { ProfileState } from './types';
 import { ExperienceConfiguration } from './experience';
+import { Logger, OnLogHandler, OnErrorHandler } from './logger';
+export type { OnErrorHandler, OnLogHandler } from './logger';
 declare global {
     interface Window {
         ninetailed?: {
@@ -17,6 +19,8 @@ declare type Options = {
     plugins?: (AnalyticsPlugin | AnalyticsPlugin[])[];
     profile?: Profile;
     requestTimeout?: number;
+    onLog?: OnLogHandler;
+    onError?: OnErrorHandler;
 };
 declare type EventFunctionOptions = {
     plugins?: {
@@ -57,16 +61,18 @@ export interface NinetailedInstance {
     profileState: ProfileState;
     onProfileChange: OnProfileChange;
     plugins: AnalyticsPlugin[];
+    logger: Logger;
 }
 export declare class Ninetailed implements NinetailedInstance {
     private readonly instance;
     private _profileState;
     readonly plugins: AnalyticsPlugin[];
-    constructor({ clientId, environment, preview }: {
+    readonly logger: Logger;
+    constructor({ clientId, environment, preview, }: {
         clientId: string;
         environment?: string;
         preview?: boolean;
-    }, { plugins, url, profile, locale, requestTimeout }?: Options);
+    }, { plugins, url, profile, locale, requestTimeout, onLog, onError, }?: Options);
     page: (data?: PageData, options?: EventFunctionOptions) => Promise<any>;
     track: (event: string, payload?: unknown, options?: EventFunctionOptions) => Promise<any>;
     trackHasSeenComponent: TrackHasSeenComponent;
@@ -79,4 +85,3 @@ export declare class Ninetailed implements NinetailedInstance {
     private buildOptions;
     private registerWindowHandlers;
 }
-export {};

package/lib/analytics/utility/index.d.ts

@@ -1,2 +1 @@
 export * from './apiClient';
-export * from './debug';

package/lib/logger/ConsoleLogSink.d.ts

@@ -0,0 +1,10 @@
+import { LogSink } from './LogSink';
+export declare class ConsoleLogSink implements LogSink {
+    name: string;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    log(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string | Error, ...args: unknown[]): void;
+    fatal(message: string | Error, ...args: unknown[]): void;
+}

package/lib/logger/LogSink.d.ts

@@ -0,0 +1,10 @@
+import { LogFn, LogFnAsError } from 'diary';
+export interface LogSink {
+    name: string;
+    debug?: LogFn;
+    info?: LogFn;
+    log?: LogFn;
+    warn?: LogFn;
+    error?: LogFnAsError;
+    fatal?: LogFnAsError;
+}

package/lib/logger/Logger.d.ts

@@ -0,0 +1,17 @@
+import { LogSink } from './LogSink';
+export declare class Logger {
+    readonly name = "@ninetailed/experience.js";
+    private readonly diary;
+    private sinks;
+    constructor();
+    addSink(sink: LogSink): void;
+    removeSink(name: string): void;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    log(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string | Error, ...args: unknown[]): void;
+    fatal(message: string | Error, ...args: unknown[]): void;
+    private onLogEvent;
+}
+export declare const logger: Logger;

package/lib/logger/OnErrorLogSink.d.ts

@@ -0,0 +1,10 @@
+import { LogFnAsError } from 'diary';
+import { LogSink } from './LogSink';
+export declare type OnErrorHandler = LogFnAsError;
+export declare class OnErrorLogSink implements LogSink {
+    private readonly onError;
+    name: string;
+    constructor(onError: OnErrorHandler);
+    error(message: string | Error, ...args: unknown[]): void;
+    fatal(message: string | Error, ...args: unknown[]): void;
+}

package/lib/logger/OnLogLogSink.d.ts

@@ -0,0 +1,12 @@
+import { LogFnAsError } from 'diary';
+import { LogSink } from './LogSink';
+export declare type OnLogHandler = LogFnAsError;
+export declare class OnLogLogSink implements LogSink {
+    private readonly onLog;
+    name: string;
+    constructor(onLog: OnLogHandler);
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    log(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+}

package/lib/logger/index.d.ts

@@ -0,0 +1,7 @@
+export { Logger, logger } from './Logger';
+export { ConsoleLogSink } from './ConsoleLogSink';
+export { OnLogLogSink } from './OnLogLogSink';
+export { OnErrorLogSink } from './OnErrorLogSink';
+export type { LogSink } from './LogSink';
+export type { OnLogHandler } from './OnLogLogSink';
+export type { OnErrorHandler } from './OnErrorLogSink';