@schorts/shared-kernel 5.1.0 → 5.2.1

package/README.md

@@ -97,6 +97,16 @@ Translation keys are centralized in registries for discoverability and tooling,
 - **SessionStorageStateManager:** Concrete implementation using session storage.
 - **InMemoryStateManager:** Concrete implementation using in-memory.
 
+### 🧭 Guided Tours
+
+- **TourGuide:** Abstract base class for defining guided UI tours. Accepts a list of TourStep objects and exposes a fluent API for composing onboarding flows. Designed to be extended by concrete implementations (e.g., Driver.js, Intro.js) in frontend environments.
+
+### 📣 Logger
+
+- **Logger:** Abstract base class for structured, context-aware logging across environments. Supports scoped logging via child() method, enabling per-module or per-request diagnostics. Each method (log, info, debug, warn, error) accepts optional context metadata and variadic arguments for flexible message composition.
+- **ConsoleLogger:** Concrete implementation of Logger that writes to native console methods (console.log, console.info, etc.). Automatically injects timestamps and supports scoped logging via child().
+- **ScopedLogger:** Internal utility class returned by Logger.child(). Merges base context with per-call context, enabling nested, composable logging scopes.
+
 ### 📈 Telemetry
 
 - **Telemetry:** Abstract interface for unified telemetry across frontend and backend environments. Supports initialization, error tracking, custom context attributes, and transaction naming. Enables integration with observability platforms like New Relic via a consistent API.

package/dist/cjs/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./formatters"), exports);
 __exportStar(require("./http"), exports);
 __exportStar(require("./i18n"), exports);
 __exportStar(require("./json-api"), exports);
+__exportStar(require("./logger"), exports);
 __exportStar(require("./mail"), exports);
 __exportStar(require("./models"), exports);
 __exportStar(require("./pub-sub"), exports);
@@ -33,6 +34,7 @@ __exportStar(require("./rbac"), exports);
 __exportStar(require("./result"), exports);
 __exportStar(require("./state-manager"), exports);
 __exportStar(require("./telemetry"), exports);
+__exportStar(require("./tour-guide"), exports);
 __exportStar(require("./unit-of-work"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./value-objects"), exports);

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,+CAA6B;AAC7B,6CAA2B;AAC3B,wCAAsB;AACtB,uCAAqB;AACrB,kDAAgC;AAChC,6CAA2B;AAC3B,8CAA4B;AAC5B,+CAA6B;AAC7B,yCAAuB;AACvB,yCAAuB;AACvB,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB;AACzB,4CAA0B;AAC1B,yCAAuB;AACvB,2CAAyB;AACzB,kDAAgC;AAChC,8CAA4B;AAC5B,iDAA+B;AAC/B,0CAAwB;AACxB,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,+CAA6B;AAC7B,6CAA2B;AAC3B,wCAAsB;AACtB,uCAAqB;AACrB,kDAAgC;AAChC,6CAA2B;AAC3B,8CAA4B;AAC5B,+CAA6B;AAC7B,yCAAuB;AACvB,yCAAuB;AACvB,6CAA2B;AAC3B,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,4CAA0B;AAC1B,yCAAuB;AACvB,2CAAyB;AACzB,kDAAgC;AAChC,8CAA4B;AAC5B,+CAA6B;AAC7B,iDAA+B;AAC/B,0CAAwB;AACxB,kDAAgC"}

package/dist/cjs/logger/console-logger.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleLogger = void 0;
+const _1 = require("./");
+class ConsoleLogger extends _1.Logger {
+    log(context, ...args) {
+        console.log(this.context(context), ...args);
+    }
+    info(context, ...args) {
+        console.info(this.context(context), ...args);
+    }
+    debug(context, ...args) {
+        console.debug(this.context(context), ...args);
+    }
+    warn(context, ...args) {
+        console.warn(this.context(context), ...args);
+    }
+    error(context, ...args) {
+        console.error(this.context(context), ...args);
+    }
+    context(customContext) {
+        return {
+            timestamp: new Date(),
+            ...customContext,
+        };
+    }
+}
+exports.ConsoleLogger = ConsoleLogger;
+//# sourceMappingURL=console-logger.js.map

package/dist/cjs/logger/console-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.js","sourceRoot":"","sources":["../../../src/logger/console-logger.ts"],"names":[],"mappings":";;;AAAA,yBAA4B;AAE5B,MAAa,aAAc,SAAQ,SAAM;IACvC,GAAG,CAAC,OAAiC,EAAE,GAAG,IAAW;QACnD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,OAAiC,EAAE,GAAG,IAAW;QACpD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAiC,EAAE,GAAG,IAAW;QACrD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC,OAAiC,EAAE,GAAG,IAAW;QACpD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAiC,EAAE,GAAG,IAAW;QACrD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAEO,OAAO,CAAC,aAAuC;QACrD,OAAO;YACL,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,GAAG,aAAa;SACjB,CAAC;IACJ,CAAC;CACF;AA3BD,sCA2BC"}

package/dist/cjs/logger/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopedLogger = exports.ConsoleLogger = exports.Logger = void 0;
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
+var console_logger_1 = require("./console-logger");
+Object.defineProperty(exports, "ConsoleLogger", { enumerable: true, get: function () { return console_logger_1.ConsoleLogger; } });
+var scoped_logger_1 = require("./scoped-logger");
+Object.defineProperty(exports, "ScopedLogger", { enumerable: true, get: function () { return scoped_logger_1.ScopedLogger; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA"}

package/dist/cjs/logger/logger.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const _1 = require("./");
+class Logger {
+    child(context) {
+        return new _1.ScopedLogger(this, context);
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/cjs/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/logger/logger.ts"],"names":[],"mappings":";;;AAAA,yBAAkC;AAElC,MAAsB,MAAM;IAO1B,KAAK,CAAC,OAAgC;QACpC,OAAO,IAAI,eAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAVD,wBAUC"}

package/dist/cjs/logger/scoped-logger.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopedLogger = void 0;
+const _1 = require("./");
+class ScopedLogger extends _1.Logger {
+    base;
+    baseContext;
+    constructor(base, baseContext) {
+        super();
+        this.base = base;
+        this.baseContext = baseContext;
+    }
+    log(context, ...args) {
+        this.base.log({ ...this.baseContext, ...context }, ...args);
+    }
+    info(context, ...args) {
+        this.base.info({ ...this.baseContext, ...context }, ...args);
+    }
+    debug(context, ...args) {
+        this.base.debug({ ...this.baseContext, ...context }, ...args);
+    }
+    warn(context, ...args) {
+        this.base.warn({ ...this.baseContext, ...context }, ...args);
+    }
+    error(context, ...args) {
+        this.base.error({ ...this.baseContext, ...context }, ...args);
+    }
+    child(context) {
+        return new ScopedLogger(this.base, { ...this.baseContext, ...context });
+    }
+}
+exports.ScopedLogger = ScopedLogger;
+//# sourceMappingURL=scoped-logger.js.map

package/dist/cjs/logger/scoped-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-logger.js","sourceRoot":"","sources":["../../../src/logger/scoped-logger.ts"],"names":[],"mappings":";;;AAAA,yBAA4B;AAE5B,MAAa,YAAa,SAAQ,SAAM;IAEnB;IACA;IAFnB,YACmB,IAAY,EACZ,WAAoC;QAErD,KAAK,EAAE,CAAC;QAHS,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAyB;IAGvD,CAAC;IAED,GAAG,CAAC,OAAiC,EAAE,GAAG,IAAW;QACnD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,CAAC,OAAiC,EAAE,GAAG,IAAW;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,OAAiC,EAAE,GAAG,IAAW;QACrD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,OAAiC,EAAE,GAAG,IAAW;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,OAAiC,EAAE,GAAG,IAAW;QACrD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,OAAiC;QACrC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF;AA/BD,oCA+BC"}

package/dist/cjs/tour-guide/index.js

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

package/dist/cjs/tour-guide/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tour-guide/index.ts"],"names":[],"mappings":""}

package/dist/cjs/tour-guide/tour-guide.js

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

package/dist/cjs/tour-guide/tour-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-guide.js","sourceRoot":"","sources":["../../../src/tour-guide/tour-guide.ts"],"names":[],"mappings":""}

package/dist/cjs/tour-guide/tour-step.js

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

package/dist/cjs/tour-guide/tour-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-step.js","sourceRoot":"","sources":["../../../src/tour-guide/tour-step.ts"],"names":[],"mappings":""}

package/dist/esm/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./formatters"), exports);
 __exportStar(require("./http"), exports);
 __exportStar(require("./i18n"), exports);
 __exportStar(require("./json-api"), exports);
+__exportStar(require("./logger"), exports);
 __exportStar(require("./mail"), exports);
 __exportStar(require("./models"), exports);
 __exportStar(require("./pub-sub"), exports);
@@ -33,6 +34,7 @@ __exportStar(require("./rbac"), exports);
 __exportStar(require("./result"), exports);
 __exportStar(require("./state-manager"), exports);
 __exportStar(require("./telemetry"), exports);
+__exportStar(require("./tour-guide"), exports);
 __exportStar(require("./unit-of-work"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./value-objects"), exports);

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,+CAA6B;AAC7B,6CAA2B;AAC3B,wCAAsB;AACtB,uCAAqB;AACrB,kDAAgC;AAChC,6CAA2B;AAC3B,8CAA4B;AAC5B,+CAA6B;AAC7B,yCAAuB;AACvB,yCAAuB;AACvB,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB;AACzB,4CAA0B;AAC1B,yCAAuB;AACvB,2CAAyB;AACzB,kDAAgC;AAChC,8CAA4B;AAC5B,iDAA+B;AAC/B,0CAAwB;AACxB,kDAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,+CAA6B;AAC7B,6CAA2B;AAC3B,wCAAsB;AACtB,uCAAqB;AACrB,kDAAgC;AAChC,6CAA2B;AAC3B,8CAA4B;AAC5B,+CAA6B;AAC7B,yCAAuB;AACvB,yCAAuB;AACvB,6CAA2B;AAC3B,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,4CAA0B;AAC1B,yCAAuB;AACvB,2CAAyB;AACzB,kDAAgC;AAChC,8CAA4B;AAC5B,+CAA6B;AAC7B,iDAA+B;AAC/B,0CAAwB;AACxB,kDAAgC"}

package/dist/esm/logger/console-logger.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleLogger = void 0;
+const _1 = require("./");
+class ConsoleLogger extends _1.Logger {
+    log(context, ...args) {
+        console.log(this.context(context), ...args);
+    }
+    info(context, ...args) {
+        console.info(this.context(context), ...args);
+    }
+    debug(context, ...args) {
+        console.debug(this.context(context), ...args);
+    }
+    warn(context, ...args) {
+        console.warn(this.context(context), ...args);
+    }
+    error(context, ...args) {
+        console.error(this.context(context), ...args);
+    }
+    context(customContext) {
+        return {
+            timestamp: new Date(),
+            ...customContext,
+        };
+    }
+}
+exports.ConsoleLogger = ConsoleLogger;
+//# sourceMappingURL=console-logger.js.map

package/dist/esm/logger/console-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.js","sourceRoot":"","sources":["../../../src/logger/console-logger.ts"],"names":[],"mappings":";;;AAAA,yBAA4B;AAE5B,MAAa,aAAc,SAAQ,SAAM;IACvC,GAAG,CAAC,OAAiC,EAAE,GAAG,IAAW;QACnD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,OAAiC,EAAE,GAAG,IAAW;QACpD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAiC,EAAE,GAAG,IAAW;QACrD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC,OAAiC,EAAE,GAAG,IAAW;QACpD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,OAAiC,EAAE,GAAG,IAAW;QACrD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IAEO,OAAO,CAAC,aAAuC;QACrD,OAAO;YACL,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,GAAG,aAAa;SACjB,CAAC;IACJ,CAAC;CACF;AA3BD,sCA2BC"}

package/dist/esm/logger/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopedLogger = exports.ConsoleLogger = exports.Logger = void 0;
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
+var console_logger_1 = require("./console-logger");
+Object.defineProperty(exports, "ConsoleLogger", { enumerable: true, get: function () { return console_logger_1.ConsoleLogger; } });
+var scoped_logger_1 = require("./scoped-logger");
+Object.defineProperty(exports, "ScopedLogger", { enumerable: true, get: function () { return scoped_logger_1.ScopedLogger; } });
+//# sourceMappingURL=index.js.map

package/dist/esm/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,iDAA+C;AAAtC,6GAAA,YAAY,OAAA"}

package/dist/esm/logger/logger.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const _1 = require("./");
+class Logger {
+    child(context) {
+        return new _1.ScopedLogger(this, context);
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/esm/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/logger/logger.ts"],"names":[],"mappings":";;;AAAA,yBAAkC;AAElC,MAAsB,MAAM;IAO1B,KAAK,CAAC,OAAgC;QACpC,OAAO,IAAI,eAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAVD,wBAUC"}

package/dist/esm/logger/scoped-logger.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopedLogger = void 0;
+const _1 = require("./");
+class ScopedLogger extends _1.Logger {
+    base;
+    baseContext;
+    constructor(base, baseContext) {
+        super();
+        this.base = base;
+        this.baseContext = baseContext;
+    }
+    log(context, ...args) {
+        this.base.log({ ...this.baseContext, ...context }, ...args);
+    }
+    info(context, ...args) {
+        this.base.info({ ...this.baseContext, ...context }, ...args);
+    }
+    debug(context, ...args) {
+        this.base.debug({ ...this.baseContext, ...context }, ...args);
+    }
+    warn(context, ...args) {
+        this.base.warn({ ...this.baseContext, ...context }, ...args);
+    }
+    error(context, ...args) {
+        this.base.error({ ...this.baseContext, ...context }, ...args);
+    }
+    child(context) {
+        return new ScopedLogger(this.base, { ...this.baseContext, ...context });
+    }
+}
+exports.ScopedLogger = ScopedLogger;
+//# sourceMappingURL=scoped-logger.js.map

package/dist/esm/logger/scoped-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-logger.js","sourceRoot":"","sources":["../../../src/logger/scoped-logger.ts"],"names":[],"mappings":";;;AAAA,yBAA4B;AAE5B,MAAa,YAAa,SAAQ,SAAM;IAEnB;IACA;IAFnB,YACmB,IAAY,EACZ,WAAoC;QAErD,KAAK,EAAE,CAAC;QAHS,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAyB;IAGvD,CAAC;IAED,GAAG,CAAC,OAAiC,EAAE,GAAG,IAAW;QACnD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,CAAC,OAAiC,EAAE,GAAG,IAAW;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,OAAiC,EAAE,GAAG,IAAW;QACrD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,OAAiC,EAAE,GAAG,IAAW;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,OAAiC,EAAE,GAAG,IAAW;QACrD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,OAAiC;QACrC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF;AA/BD,oCA+BC"}

package/dist/esm/tour-guide/index.js

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

package/dist/esm/tour-guide/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tour-guide/index.ts"],"names":[],"mappings":""}

package/dist/esm/tour-guide/tour-guide.js

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

package/dist/esm/tour-guide/tour-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-guide.js","sourceRoot":"","sources":["../../../src/tour-guide/tour-guide.ts"],"names":[],"mappings":""}

package/dist/esm/tour-guide/tour-step.js

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

package/dist/esm/tour-guide/tour-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-step.js","sourceRoot":"","sources":["../../../src/tour-guide/tour-step.ts"],"names":[],"mappings":""}

package/dist/types/index.d.ts

@@ -10,6 +10,7 @@ export * from "./formatters";
 export * from "./http";
 export * from "./i18n";
 export * from "./json-api";
+export * from "./logger";
 export * from "./mail";
 export * from "./models";
 export * from "./pub-sub";
@@ -17,6 +18,7 @@ export * from "./rbac";
 export * from "./result";
 export * from "./state-manager";
 export * from "./telemetry";
+export * from "./tour-guide";
 export * from "./unit-of-work";
 export * from "./utils";
 export * from "./value-objects";

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,MAAM,CAAC;AACrB,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,MAAM,CAAC;AACrB,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC"}

package/dist/types/logger/console-logger.d.ts

@@ -0,0 +1,10 @@
+import { Logger } from "./";
+export declare class ConsoleLogger extends Logger {
+    log(context?: Record<string, unknown>, ...args: any[]): void;
+    info(context?: Record<string, unknown>, ...args: any[]): void;
+    debug(context?: Record<string, unknown>, ...args: any[]): void;
+    warn(context?: Record<string, unknown>, ...args: any[]): void;
+    error(context?: Record<string, unknown>, ...args: any[]): void;
+    private context;
+}
+//# sourceMappingURL=console-logger.d.ts.map

package/dist/types/logger/console-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.d.ts","sourceRoot":"","sources":["../../../src/logger/console-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAE5B,qBAAa,aAAc,SAAQ,MAAM;IACvC,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI7D,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI7D,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI9D,OAAO,CAAC,OAAO;CAMhB"}

package/dist/types/logger/index.d.ts

@@ -0,0 +1,4 @@
+export { Logger } from "./logger";
+export { ConsoleLogger } from "./console-logger";
+export { ScopedLogger } from "./scoped-logger";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/logger/logger.d.ts

@@ -0,0 +1,10 @@
+import { ScopedLogger } from "./";
+export declare abstract class Logger {
+    abstract log(context?: Record<string, unknown>, ...args: any[]): void;
+    abstract info(context?: Record<string, unknown>, ...args: any[]): void;
+    abstract debug(context?: Record<string, unknown>, ...args: any[]): void;
+    abstract warn(context?: Record<string, unknown>, ...args: any[]): void;
+    abstract error(context?: Record<string, unknown>, ...args: any[]): void;
+    child(context: Record<string, unknown>): ScopedLogger;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/types/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAElC,8BAAsB,MAAM;IAC1B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IACrE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IACtE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IACvE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IACtE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAEvE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;CAGtD"}

package/dist/types/logger/scoped-logger.d.ts

@@ -0,0 +1,13 @@
+import { Logger } from "./";
+export declare class ScopedLogger extends Logger {
+    private readonly base;
+    private readonly baseContext;
+    constructor(base: Logger, baseContext: Record<string, unknown>);
+    log(context?: Record<string, unknown>, ...args: any[]): void;
+    info(context?: Record<string, unknown>, ...args: any[]): void;
+    debug(context?: Record<string, unknown>, ...args: any[]): void;
+    warn(context?: Record<string, unknown>, ...args: any[]): void;
+    error(context?: Record<string, unknown>, ...args: any[]): void;
+    child(context?: Record<string, unknown>): ScopedLogger;
+}
+//# sourceMappingURL=scoped-logger.d.ts.map

package/dist/types/logger/scoped-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-logger.d.ts","sourceRoot":"","sources":["../../../src/logger/scoped-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAE5B,qBAAa,YAAa,SAAQ,MAAM;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,WAAW;gBADX,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAKvD,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAIrD,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAItD,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAIvD,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAItD,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE;IAIvD,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;CAGvD"}

package/dist/types/tour-guide/index.d.ts

@@ -0,0 +1,3 @@
+export type { TourGuide } from "./tour-guide";
+export type { TourStep } from "./tour-step";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/tour-guide/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tour-guide/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/tour-guide/tour-guide.d.ts

@@ -0,0 +1,6 @@
+import { TourStep } from "./tour-step";
+export interface TourGuide {
+    addStep(step: TourStep): TourGuide;
+    startTour(): void;
+}
+//# sourceMappingURL=tour-guide.d.ts.map

package/dist/types/tour-guide/tour-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-guide.d.ts","sourceRoot":"","sources":["../../../src/tour-guide/tour-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACnC,SAAS,IAAI,IAAI,CAAC;CACnB"}

package/dist/types/tour-guide/tour-step.d.ts

@@ -0,0 +1,8 @@
+export type TourStep = {
+    element?: string;
+    title: string;
+    description: string;
+    side: "TOP" | "RIGHT" | "BOTTOM" | "LEFT";
+    align: "START" | "CENTER" | "END";
+};
+//# sourceMappingURL=tour-step.d.ts.map

package/dist/types/tour-guide/tour-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour-step.d.ts","sourceRoot":"","sources":["../../../src/tour-guide/tour-step.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CACnC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schorts/shared-kernel",
-  "version": "5.1.0",
+  "version": "5.2.1",
   "description": "A modular, type-safe foundation for building expressive, maintainable applications. This package provides core abstractions for domain modeling, HTTP integration, authentication, state management, and more — designed to be framework-agnostic and highly extensible.",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -76,6 +76,11 @@
       "require": "./dist/cjs/json-api/index.js",
       "types": "./dist/types/json-api/index.d.ts"
     },
+    "./logger": {
+      "import": "./dist/esm/logger/index.js",
+      "require": "./dist/cjs/logger/index.js",
+      "types": "./dist/types/logger/index.d.ts"
+    },
     "./mail": {
       "import": "./dist/esm/mail/index.js",
       "require": "./dist/cjs/mail/index.js",
@@ -111,6 +116,11 @@
       "require": "./dist/cjs/telemetry/index.js",
       "types": "./dist/types/telemetry/index.d.ts"
     },
+    "./tour-guide": {
+      "import": "./dist/esm/tour-guide/index.js",
+      "require": "./dist/cjs/tour-guide/index.js",
+      "types": "./dist/types/tour-guide/index.d.ts"
+    },
     "./unit-of-work": {
       "import": "./dist/esm/unit-of-work/index.js",
       "require": "./dist/cjs/unit-of-work/index.js",