@schorts/shared-kernel 4.1.1 → 4.2.0

package/CHANGELOG

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.2.0] - 2025-10-21
+
+### Added
+
+- Added `ConsoleTelemetry` for dev or test environments.
+
+## [4.1.2] - 2025-10-21
+
+### Changed
+
+- Allow any params in the `init` method of the `Telemetry` and `Subscription`.
+
 ## [4.1.1] - 2025-10-21
 
 ### Added

package/README.md

@@ -85,6 +85,7 @@ Translation keys are centralized in registries for discoverability and tooling,
 ### 📈 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.
+- **ConsoleTelemetry:** Development-friendly implementation of the `Telemetry` interface that logs errors, context, and transaction names to the console. Useful for local environments, testing, or CI pipelines where external observability is not required.
 
 ### 🧪 Value Objects
 

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleTelemetry = void 0;
+class ConsoleTelemetry {
+    customContext = {};
+    transaction = null;
+    init() {
+        console.log("Telemetry initialized");
+    }
+    trackError(error) {
+        console.error({
+            error,
+            timestamp: new Date(),
+            customContext: this.customContext,
+            transaction: this.transaction,
+        });
+    }
+    setCustomContext(key, value) {
+        this.customContext[key] = value;
+    }
+    setTransaction(name) {
+        this.transaction = name;
+    }
+}
+exports.ConsoleTelemetry = ConsoleTelemetry;
+//# sourceMappingURL=console-telemetry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"console-telemetry.js","sourceRoot":"","sources":["../../../src/telemetry/console-telemetry.ts"],"names":[],"mappings":";;;AAEA,MAAa,gBAAgB;IACV,aAAa,GAA2B,EAAE,CAAC;IACpD,WAAW,GAAkB,IAAI,CAAC;IAE1C,IAAI;QACF,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC;IAED,UAAU,CAAC,KAAY;QACrB,OAAO,CAAC,KAAK,CAAC;YACZ,KAAK;YACL,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB,CAAC,GAAW,EAAE,KAAa;QACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAClC,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;CACF;AAxBD,4CAwBC"}

package/dist/cjs/telemetry/index.js

@@ -1,3 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleTelemetry = void 0;
+var console_telemetry_1 = require("./console-telemetry");
+Object.defineProperty(exports, "ConsoleTelemetry", { enumerable: true, get: function () { return console_telemetry_1.ConsoleTelemetry; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":";;;AACA,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA"}

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleTelemetry = void 0;
+class ConsoleTelemetry {
+    customContext = {};
+    transaction = null;
+    init() {
+        console.log("Telemetry initialized");
+    }
+    trackError(error) {
+        console.error({
+            error,
+            timestamp: new Date(),
+            customContext: this.customContext,
+            transaction: this.transaction,
+        });
+    }
+    setCustomContext(key, value) {
+        this.customContext[key] = value;
+    }
+    setTransaction(name) {
+        this.transaction = name;
+    }
+}
+exports.ConsoleTelemetry = ConsoleTelemetry;
+//# sourceMappingURL=console-telemetry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"console-telemetry.js","sourceRoot":"","sources":["../../../src/telemetry/console-telemetry.ts"],"names":[],"mappings":";;;AAEA,MAAa,gBAAgB;IACV,aAAa,GAA2B,EAAE,CAAC;IACpD,WAAW,GAAkB,IAAI,CAAC;IAE1C,IAAI;QACF,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACvC,CAAC;IAED,UAAU,CAAC,KAAY;QACrB,OAAO,CAAC,KAAK,CAAC;YACZ,KAAK;YACL,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB,CAAC,GAAW,EAAE,KAAa;QACzC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAClC,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;CACF;AAxBD,4CAwBC"}

package/dist/esm/telemetry/index.js

@@ -1,3 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleTelemetry = void 0;
+var console_telemetry_1 = require("./console-telemetry");
+Object.defineProperty(exports, "ConsoleTelemetry", { enumerable: true, get: function () { return console_telemetry_1.ConsoleTelemetry; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":";;;AACA,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA"}

package/dist/types/pub-sub/subscription.d.ts

@@ -1,5 +1,5 @@
 export interface Subscription {
-    init(): void;
+    init(...args: any[]): void;
     connect(): void;
     subscribe(channel: string, event: string, handler: (payload: any) => void): void;
     unsubscribe(channel: string): void;

package/dist/types/pub-sub/subscription.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../src/pub-sub/subscription.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,IAAI,CAAC;IAChB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IACjF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,IAAI,IAAI,CAAC;CACpB"}
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../../src/pub-sub/subscription.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;IAChB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IACjF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,IAAI,IAAI,CAAC;CACpB"}

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

@@ -0,0 +1,10 @@
+import { Telemetry } from "./telemetry";
+export declare class ConsoleTelemetry implements Telemetry {
+    private readonly customContext;
+    private transaction;
+    init(): void;
+    trackError(error: Error): void;
+    setCustomContext(key: string, value: string): void;
+    setTransaction(name: string): void;
+}
+//# sourceMappingURL=console-telemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"console-telemetry.d.ts","sourceRoot":"","sources":["../../../src/telemetry/console-telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,qBAAa,gBAAiB,YAAW,SAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAC5D,OAAO,CAAC,WAAW,CAAuB;IAE1C,IAAI,IAAI,IAAI;IAIZ,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAS9B,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAGnC"}

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

@@ -1,2 +1,3 @@
 export type { Telemetry } from "./telemetry";
+export { ConsoleTelemetry } from "./console-telemetry";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/types/telemetry/telemetry.d.ts

@@ -1,5 +1,5 @@
 export interface Telemetry {
-    init(): void;
+    init(...args: any[]): void;
     trackError(error: Error): void;
     setCustomContext(key: string, value: string): void;
     setTransaction(name: string): void;

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

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,IAAI,IAAI,CAAC;IACb,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/telemetry/telemetry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@schorts/shared-kernel",
-  "version": "4.1.1",
+  "version": "4.2.0",
   "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",

package/src/pub-sub/subscription.ts

@@ -1,5 +1,5 @@
 export interface Subscription {
-  init(): void;
+  init(...args: any[]): void;
   connect(): void;
   subscribe(channel: string, event: string, handler: (payload: any) => void): void;
   unsubscribe(channel: string): void;

package/src/telemetry/console-telemetry.ts

@@ -0,0 +1,27 @@
+import { Telemetry } from "./telemetry";
+
+export class ConsoleTelemetry implements Telemetry {
+  private readonly customContext: Record<string, string> = {};
+  private transaction: string | null = null;
+
+  init(): void {
+    console.log("Telemetry initialized");
+  }
+
+  trackError(error: Error): void {
+    console.error({
+      error,
+      timestamp: new Date(),
+      customContext: this.customContext,
+      transaction: this.transaction,
+    });
+  }
+
+  setCustomContext(key: string, value: string): void {
+    this.customContext[key] = value;
+  }
+
+  setTransaction(name: string): void {
+    this.transaction = name;
+  }
+}

package/src/telemetry/index.ts

@@ -1 +1,2 @@
-export type { Telemetry } from "./telemetry";
+export type { Telemetry } from "./telemetry";
+export { ConsoleTelemetry } from "./console-telemetry";

package/src/telemetry/telemetry.ts

@@ -1,5 +1,5 @@
 export interface Telemetry {
-  init(): void;
+  init(...args: any[]): void;
   trackError(error: Error): void;
   setCustomContext(key: string, value: string): void;
   setTransaction(name: string): void;