@olane/o-core 0.7.12-alpha.5 → 0.7.12-alpha.6

package/dist/src/core/lib/events/connection-events.d.ts

@@ -0,0 +1,31 @@
+import { oAddress } from '../../../router/o-address.js';
+import { oNotificationEvent } from './o-notification-event.js';
+/**
+ * Emitted when a connection becomes degraded (some pings failing)
+ */
+export declare class ConnectionDegradedEvent extends oNotificationEvent {
+    readonly targetAddress: oAddress;
+    readonly role: 'parent' | 'child';
+    readonly consecutiveFailures: number;
+    constructor(config: {
+        source: oAddress;
+        targetAddress: oAddress;
+        role: 'parent' | 'child';
+        consecutiveFailures: number;
+    });
+    protected getEventData(): Record<string, any>;
+}
+/**
+ * Emitted when a degraded connection recovers
+ */
+export declare class ConnectionRecoveredEvent extends oNotificationEvent {
+    readonly targetAddress: oAddress;
+    readonly role: 'parent' | 'child';
+    constructor(config: {
+        source: oAddress;
+        targetAddress: oAddress;
+        role: 'parent' | 'child';
+    });
+    protected getEventData(): Record<string, any>;
+}
+//# sourceMappingURL=connection-events.d.ts.map

package/dist/src/core/lib/events/connection-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-events.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/events/connection-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EACL,kBAAkB,EAEnB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,kBAAkB;IAC7D,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;gBAEzB,MAAM,EAAE;QAClB,MAAM,EAAE,QAAQ,CAAC;QACjB,aAAa,EAAE,QAAQ,CAAC;QACxB,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;QACzB,mBAAmB,EAAE,MAAM,CAAC;KAC7B;IAcD,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAO9C;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,kBAAkB;IAC9D,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;gBAEtB,MAAM,EAAE;QAClB,MAAM,EAAE,QAAQ,CAAC;QACjB,aAAa,EAAE,QAAQ,CAAC;QACxB,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;KAC1B;IAUD,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAM9C"}

package/dist/src/core/lib/events/connection-events.js

@@ -0,0 +1,46 @@
+import { oNotificationEvent, } from './o-notification-event.js';
+/**
+ * Emitted when a connection becomes degraded (some pings failing)
+ */
+export class ConnectionDegradedEvent extends oNotificationEvent {
+    constructor(config) {
+        super({
+            type: 'connection:degraded',
+            source: config.source,
+            metadata: {
+                role: config.role,
+                consecutiveFailures: config.consecutiveFailures,
+            },
+        });
+        this.targetAddress = config.targetAddress;
+        this.role = config.role;
+        this.consecutiveFailures = config.consecutiveFailures;
+    }
+    getEventData() {
+        return {
+            targetAddress: this.targetAddress.toString(),
+            role: this.role,
+            consecutiveFailures: this.consecutiveFailures,
+        };
+    }
+}
+/**
+ * Emitted when a degraded connection recovers
+ */
+export class ConnectionRecoveredEvent extends oNotificationEvent {
+    constructor(config) {
+        super({
+            type: 'connection:recovered',
+            source: config.source,
+            metadata: { role: config.role },
+        });
+        this.targetAddress = config.targetAddress;
+        this.role = config.role;
+    }
+    getEventData() {
+        return {
+            targetAddress: this.targetAddress.toString(),
+            role: this.role,
+        };
+    }
+}

package/dist/src/core/lib/events/hierarchy-events.d.ts

@@ -0,0 +1,69 @@
+import { oAddress } from '../../../router/o-address.js';
+import { oNotificationEvent } from './o-notification-event.js';
+/**
+ * Emitted when a child node joins the hierarchy (registers with parent)
+ */
+export declare class ChildJoinedEvent extends oNotificationEvent {
+    readonly childAddress: oAddress;
+    readonly parentAddress: oAddress;
+    constructor(config: {
+        source: oAddress;
+        childAddress: oAddress;
+        parentAddress: oAddress;
+    });
+    protected getEventData(): Record<string, any>;
+}
+/**
+ * Emitted when a child node leaves the hierarchy (unregisters or disconnects)
+ */
+export declare class ChildLeftEvent extends oNotificationEvent {
+    readonly childAddress: oAddress;
+    readonly parentAddress: oAddress;
+    readonly reason?: string;
+    constructor(config: {
+        source: oAddress;
+        childAddress: oAddress;
+        parentAddress: oAddress;
+        reason?: string;
+    });
+    protected getEventData(): Record<string, any>;
+}
+/**
+ * Emitted when a parent connection is established
+ */
+export declare class ParentConnectedEvent extends oNotificationEvent {
+    readonly parentAddress: oAddress;
+    constructor(config: {
+        source: oAddress;
+        parentAddress: oAddress;
+    });
+    protected getEventData(): Record<string, any>;
+}
+/**
+ * Emitted when a parent connection is lost
+ */
+export declare class ParentDisconnectedEvent extends oNotificationEvent {
+    readonly parentAddress: oAddress;
+    readonly reason?: string;
+    constructor(config: {
+        source: oAddress;
+        parentAddress: oAddress;
+        reason?: string;
+    });
+    protected getEventData(): Record<string, any>;
+}
+/**
+ * Emitted when connection to leader is lost (CRITICAL)
+ * This is a catastrophic failure - node cannot function without leader
+ */
+export declare class LeaderDisconnectedEvent extends oNotificationEvent {
+    readonly leaderAddress: oAddress;
+    readonly reason?: string;
+    constructor(config: {
+        source: oAddress;
+        leaderAddress: oAddress;
+        reason?: string;
+    });
+    protected getEventData(): Record<string, any>;
+}
+//# sourceMappingURL=hierarchy-events.d.ts.map

package/dist/src/core/lib/events/hierarchy-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy-events.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/events/hierarchy-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EACL,kBAAkB,EAEnB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IACtD,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;gBAErB,MAAM,EAAE;QAClB,MAAM,EAAE,QAAQ,CAAC;QACjB,YAAY,EAAE,QAAQ,CAAC;QACvB,aAAa,EAAE,QAAQ,CAAC;KACzB;IASD,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAM9C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,kBAAkB;IACpD,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE;QAClB,MAAM,EAAE,QAAQ,CAAC;QACjB,YAAY,EAAE,QAAQ,CAAC;QACvB,aAAa,EAAE,QAAQ,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAWD,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAO9C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,kBAAkB;IAC1D,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;gBAErB,MAAM,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAC;QAAC,aAAa,EAAE,QAAQ,CAAA;KAAE;IAQjE,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAK9C;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,kBAAkB;IAC7D,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE;QAClB,MAAM,EAAE,QAAQ,CAAC;QACjB,aAAa,EAAE,QAAQ,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAUD,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAM9C;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,kBAAkB;IAC7D,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE;QAClB,MAAM,EAAE,QAAQ,CAAC;QACjB,aAAa,EAAE,QAAQ,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAUD,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAM9C"}

package/dist/src/core/lib/events/hierarchy-events.js

@@ -0,0 +1,100 @@
+import { oNotificationEvent, } from './o-notification-event.js';
+/**
+ * Emitted when a child node joins the hierarchy (registers with parent)
+ */
+export class ChildJoinedEvent extends oNotificationEvent {
+    constructor(config) {
+        super({
+            type: 'child:joined',
+            source: config.source,
+        });
+        this.childAddress = config.childAddress;
+        this.parentAddress = config.parentAddress;
+    }
+    getEventData() {
+        return {
+            childAddress: this.childAddress.toString(),
+            parentAddress: this.parentAddress.toString(),
+        };
+    }
+}
+/**
+ * Emitted when a child node leaves the hierarchy (unregisters or disconnects)
+ */
+export class ChildLeftEvent extends oNotificationEvent {
+    constructor(config) {
+        super({
+            type: 'child:left',
+            source: config.source,
+            metadata: { reason: config.reason },
+        });
+        this.childAddress = config.childAddress;
+        this.parentAddress = config.parentAddress;
+        this.reason = config.reason;
+    }
+    getEventData() {
+        return {
+            childAddress: this.childAddress.toString(),
+            parentAddress: this.parentAddress.toString(),
+            reason: this.reason,
+        };
+    }
+}
+/**
+ * Emitted when a parent connection is established
+ */
+export class ParentConnectedEvent extends oNotificationEvent {
+    constructor(config) {
+        super({
+            type: 'parent:connected',
+            source: config.source,
+        });
+        this.parentAddress = config.parentAddress;
+    }
+    getEventData() {
+        return {
+            parentAddress: this.parentAddress.toString(),
+        };
+    }
+}
+/**
+ * Emitted when a parent connection is lost
+ */
+export class ParentDisconnectedEvent extends oNotificationEvent {
+    constructor(config) {
+        super({
+            type: 'parent:disconnected',
+            source: config.source,
+            metadata: { reason: config.reason },
+        });
+        this.parentAddress = config.parentAddress;
+        this.reason = config.reason;
+    }
+    getEventData() {
+        return {
+            parentAddress: this.parentAddress.toString(),
+            reason: this.reason,
+        };
+    }
+}
+/**
+ * Emitted when connection to leader is lost (CRITICAL)
+ * This is a catastrophic failure - node cannot function without leader
+ */
+export class LeaderDisconnectedEvent extends oNotificationEvent {
+    constructor(config) {
+        super({
+            type: 'leader:disconnected',
+            source: config.source,
+            metadata: { reason: config.reason },
+        });
+        this.leaderAddress = config.leaderAddress;
+        this.reason = config.reason;
+    }
+    getEventData() {
+        return {
+            leaderAddress: this.leaderAddress.toString(),
+            reason: this.reason,
+        };
+    }
+}

package/dist/src/core/lib/events/index.d.ts

@@ -0,0 +1,6 @@
+export * from './o-notification-event.js';
+export * from './node-events.js';
+export * from './hierarchy-events.js';
+export * from './connection-events.js';
+export * from '../interfaces/notification-types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/lib/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/events/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qCAAqC,CAAC"}

package/dist/src/core/lib/events/index.js

@@ -0,0 +1,5 @@
+export * from './o-notification-event.js';
+export * from './node-events.js';
+export * from './hierarchy-events.js';
+export * from './connection-events.js';
+export * from '../interfaces/notification-types.js';

package/dist/src/core/lib/events/node-events.d.ts

@@ -0,0 +1,40 @@
+import { oAddress } from '../../../router/o-address.js';
+import { oNotificationEvent } from './o-notification-event.js';
+/**
+ * Emitted when a node establishes a connection (transport-agnostic)
+ */
+export declare class NodeConnectedEvent extends oNotificationEvent {
+    readonly nodeAddress: oAddress;
+    readonly connectionMetadata: Record<string, any>;
+    constructor(config: {
+        source: oAddress;
+        nodeAddress: oAddress;
+        connectionMetadata?: Record<string, any>;
+    });
+    protected getEventData(): Record<string, any>;
+}
+/**
+ * Emitted when a node disconnects (transport-agnostic)
+ */
+export declare class NodeDisconnectedEvent extends oNotificationEvent {
+    readonly nodeAddress: oAddress;
+    readonly reason?: string;
+    constructor(config: {
+        source: oAddress;
+        nodeAddress: oAddress;
+        reason?: string;
+    });
+    protected getEventData(): Record<string, any>;
+}
+/**
+ * Emitted when a node is discovered but not yet connected
+ */
+export declare class NodeDiscoveredEvent extends oNotificationEvent {
+    readonly nodeAddress: oAddress;
+    constructor(config: {
+        source: oAddress;
+        nodeAddress: oAddress;
+    });
+    protected getEventData(): Record<string, any>;
+}
+//# sourceMappingURL=node-events.d.ts.map

package/dist/src/core/lib/events/node-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-events.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/events/node-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EACL,kBAAkB,EAEnB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,kBAAkB;IACxD,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAErC,MAAM,EAAE;QAClB,MAAM,EAAE,QAAQ,CAAC;QACjB,WAAW,EAAE,QAAQ,CAAC;QACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC1C;IAUD,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAM9C;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,kBAAkB;IAC3D,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE;QAClB,MAAM,EAAE,QAAQ,CAAC;QACjB,WAAW,EAAE,QAAQ,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;IAUD,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAM9C;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,kBAAkB;IACzD,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC;gBAEnB,MAAM,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAC;QAAC,WAAW,EAAE,QAAQ,CAAA;KAAE;IAQ/D,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAK9C"}

package/dist/src/core/lib/events/node-events.js

@@ -0,0 +1,58 @@
+import { oNotificationEvent, } from './o-notification-event.js';
+/**
+ * Emitted when a node establishes a connection (transport-agnostic)
+ */
+export class NodeConnectedEvent extends oNotificationEvent {
+    constructor(config) {
+        super({
+            type: 'node:connected',
+            source: config.source,
+            metadata: config.connectionMetadata || {},
+        });
+        this.nodeAddress = config.nodeAddress;
+        this.connectionMetadata = config.connectionMetadata || {};
+    }
+    getEventData() {
+        return {
+            nodeAddress: this.nodeAddress.toString(),
+            connectionMetadata: this.connectionMetadata,
+        };
+    }
+}
+/**
+ * Emitted when a node disconnects (transport-agnostic)
+ */
+export class NodeDisconnectedEvent extends oNotificationEvent {
+    constructor(config) {
+        super({
+            type: 'node:disconnected',
+            source: config.source,
+            metadata: { reason: config.reason },
+        });
+        this.nodeAddress = config.nodeAddress;
+        this.reason = config.reason;
+    }
+    getEventData() {
+        return {
+            nodeAddress: this.nodeAddress.toString(),
+            reason: this.reason,
+        };
+    }
+}
+/**
+ * Emitted when a node is discovered but not yet connected
+ */
+export class NodeDiscoveredEvent extends oNotificationEvent {
+    constructor(config) {
+        super({
+            type: 'node:discovered',
+            source: config.source,
+        });
+        this.nodeAddress = config.nodeAddress;
+    }
+    getEventData() {
+        return {
+            nodeAddress: this.nodeAddress.toString(),
+        };
+    }
+}

package/dist/src/core/lib/events/o-notification-event.d.ts

@@ -0,0 +1,26 @@
+import { oAddress } from '../../../router/o-address.js';
+export interface oNotificationEventConfig {
+    type: string;
+    source: oAddress;
+    metadata?: Record<string, any>;
+}
+/**
+ * Base class for all notification events in the Olane system.
+ * Transport-agnostic - contains only Olane concepts, no libp2p/HTTP/etc dependencies.
+ */
+export declare abstract class oNotificationEvent {
+    readonly type: string;
+    readonly timestamp: Date;
+    readonly source: oAddress;
+    readonly metadata: Record<string, any>;
+    constructor(config: oNotificationEventConfig);
+    /**
+     * Serialize event to JSON for transmission
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Subclasses override to provide event-specific data
+     */
+    protected getEventData(): Record<string, any>;
+}
+//# sourceMappingURL=o-notification-event.d.ts.map

package/dist/src/core/lib/events/o-notification-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-notification-event.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/events/o-notification-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAExD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;;GAGG;AACH,8BAAsB,kBAAkB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAE3B,MAAM,EAAE,wBAAwB;IAO5C;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAU7B;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAG9C"}

package/dist/src/core/lib/events/o-notification-event.js

@@ -0,0 +1,30 @@
+/**
+ * Base class for all notification events in the Olane system.
+ * Transport-agnostic - contains only Olane concepts, no libp2p/HTTP/etc dependencies.
+ */
+export class oNotificationEvent {
+    constructor(config) {
+        this.type = config.type;
+        this.source = config.source;
+        this.metadata = config.metadata || {};
+        this.timestamp = new Date();
+    }
+    /**
+     * Serialize event to JSON for transmission
+     */
+    toJSON() {
+        return {
+            type: this.type,
+            timestamp: this.timestamp.toISOString(),
+            source: this.source.toString(),
+            metadata: this.metadata,
+            ...this.getEventData(),
+        };
+    }
+    /**
+     * Subclasses override to provide event-specific data
+     */
+    getEventData() {
+        return {};
+    }
+}

package/dist/src/core/lib/index.d.ts

@@ -1,4 +1,8 @@
 export * from './o-hierarchy.manager.js';
 export * from './o-metrics.js';
 export * from './o-request.manager.js';
+export * from './o-notification.manager.js';
+export * from './events/index.js';
+export * from './interfaces/notification-types.js';
+export * from './utils/event-filters.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/core/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC"}

package/dist/src/core/lib/index.js

@@ -1,3 +1,7 @@
 export * from './o-hierarchy.manager.js';
 export * from './o-metrics.js';
 export * from './o-request.manager.js';
+export * from './o-notification.manager.js';
+export * from './events/index.js';
+export * from './interfaces/notification-types.js';
+export * from './utils/event-filters.js';

package/dist/src/core/lib/interfaces/notification-types.d.ts

@@ -0,0 +1,49 @@
+import { oNotificationEvent } from '../events/o-notification-event.js';
+/**
+ * Handler function for notification events
+ */
+export type NotificationHandler = (event: oNotificationEvent) => void | Promise<void>;
+/**
+ * Filter for event subscriptions
+ */
+export interface EventFilter {
+    /**
+     * Match events from nodes matching this address pattern
+     * Supports wildcards: e.g., "o://leader/children/*"
+     */
+    addressPattern?: string;
+    /**
+     * Only match these specific event types
+     */
+    eventTypes?: string[];
+    /**
+     * Custom filter function
+     */
+    customFilter?: (event: oNotificationEvent) => boolean;
+}
+/**
+ * Subscription handle returned when subscribing to events
+ */
+export interface Subscription {
+    /**
+     * Unique subscription ID
+     */
+    id: string;
+    /**
+     * Event type subscribed to
+     */
+    eventType: string;
+    /**
+     * Handler function
+     */
+    handler: NotificationHandler;
+    /**
+     * Optional filter
+     */
+    filter?: EventFilter;
+    /**
+     * Unsubscribe from this event
+     */
+    unsubscribe(): void;
+}
+//# sourceMappingURL=notification-types.d.ts.map

package/dist/src/core/lib/interfaces/notification-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-types.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/interfaces/notification-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,kBAAkB,KACtB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAE7B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,WAAW,IAAI,IAAI,CAAC;CACrB"}

package/dist/src/core/lib/interfaces/notification-types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/lib/o-notification.manager.d.ts

@@ -0,0 +1,58 @@
+import { oObject } from '../o-object.js';
+import { oNotificationEvent } from './events/o-notification-event.js';
+import { EventFilter, NotificationHandler, Subscription } from './interfaces/notification-types.js';
+/**
+ * Abstract notification manager - transport agnostic
+ * NO dependencies on libp2p, HTTP, or any specific transport
+ *
+ * Subclasses implement setupListeners() to wire up transport-specific events
+ */
+export declare abstract class oNotificationManager extends oObject {
+    private eventTarget;
+    private subscriptions;
+    constructor();
+    /**
+     * Subscribe to a notification event
+     *
+     * @param eventType - The event type to subscribe to (e.g., "node:connected", "child:joined")
+     * @param handler - The handler function to call when event is emitted
+     * @param filter - Optional filter to apply to events
+     * @returns Subscription handle
+     */
+    on(eventType: string, handler: NotificationHandler, filter?: EventFilter): Subscription;
+    /**
+     * Unsubscribe from a notification event
+     */
+    off(subscription: Subscription): void;
+    /**
+     * Emit a notification event
+     */
+    emit(event: oNotificationEvent): void;
+    /**
+     * Check if an event matches a filter
+     */
+    protected matchesFilter(event: oNotificationEvent, filter: EventFilter): boolean;
+    /**
+     * Get all active subscriptions for an event type
+     */
+    getSubscriptions(eventType?: string): Subscription[];
+    /**
+     * Get count of active subscriptions
+     */
+    getSubscriptionCount(eventType?: string): number;
+    /**
+     * Subclasses must implement this to wire up transport-specific listeners
+     * This is where libp2p/HTTP/WebSocket events get connected
+     */
+    protected abstract setupListeners(): void | Promise<void>;
+    /**
+     * Initialize the notification manager
+     * Calls setupListeners() to wire up transport events
+     */
+    initialize(): Promise<void>;
+    /**
+     * Cleanup all subscriptions
+     */
+    teardown(): Promise<void>;
+}
+//# sourceMappingURL=o-notification.manager.d.ts.map

package/dist/src/core/lib/o-notification.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-notification.manager.d.ts","sourceRoot":"","sources":["../../../../src/core/lib/o-notification.manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,YAAY,EACb,MAAM,oCAAoC,CAAC;AAG5C;;;;;GAKG;AACH,8BAAsB,oBAAqB,SAAQ,OAAO;IACxD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAiC;;IAQtD;;;;;;;OAOG;IACH,EAAE,CACA,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mBAAmB,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,YAAY;IAoDf;;OAEG;IACH,GAAG,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IA6BrC;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAUrC;;OAEG;IACH,SAAS,CAAC,aAAa,CACrB,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,WAAW,GAClB,OAAO;IAyBV;;OAEG;IACH,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAcpD;;OAEG;IACH,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAIhD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,cAAc,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAEzD;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAYhC"}

package/dist/src/core/lib/o-notification.manager.js

@@ -0,0 +1,159 @@
+import { v4 as uuidv4 } from 'uuid';
+import { oObject } from '../o-object.js';
+import { EventFilters } from './utils/event-filters.js';
+/**
+ * Abstract notification manager - transport agnostic
+ * NO dependencies on libp2p, HTTP, or any specific transport
+ *
+ * Subclasses implement setupListeners() to wire up transport-specific events
+ */
+export class oNotificationManager extends oObject {
+    constructor() {
+        super();
+        this.eventTarget = new EventTarget();
+        this.subscriptions = new Map();
+    }
+    /**
+     * Subscribe to a notification event
+     *
+     * @param eventType - The event type to subscribe to (e.g., "node:connected", "child:joined")
+     * @param handler - The handler function to call when event is emitted
+     * @param filter - Optional filter to apply to events
+     * @returns Subscription handle
+     */
+    on(eventType, handler, filter) {
+        const subscriptionId = uuidv4();
+        const subscription = {
+            id: subscriptionId,
+            eventType,
+            handler,
+            filter,
+            unsubscribe: () => {
+                this.off(subscription);
+            },
+        };
+        // Add to subscriptions map
+        if (!this.subscriptions.has(eventType)) {
+            this.subscriptions.set(eventType, new Set());
+        }
+        this.subscriptions.get(eventType).add(subscription);
+        // Add DOM event listener
+        const wrappedHandler = async (event) => {
+            if (!(event instanceof CustomEvent)) {
+                return;
+            }
+            const notificationEvent = event.detail;
+            // Apply filter if provided
+            if (filter && !this.matchesFilter(notificationEvent, filter)) {
+                return;
+            }
+            try {
+                await handler(notificationEvent);
+            }
+            catch (error) {
+                this.logger.error(`Error in notification handler for ${eventType}:`, error);
+            }
+        };
+        // Store wrapped handler for later removal
+        subscription._wrappedHandler = wrappedHandler;
+        this.eventTarget.addEventListener(eventType, wrappedHandler);
+        this.logger.debug(`Subscribed to ${eventType} with ID ${subscriptionId}`);
+        return subscription;
+    }
+    /**
+     * Unsubscribe from a notification event
+     */
+    off(subscription) {
+        const subscriptionsForType = this.subscriptions.get(subscription.eventType);
+        if (!subscriptionsForType) {
+            return;
+        }
+        // Remove from subscriptions set
+        subscriptionsForType.delete(subscription);
+        // Remove DOM event listener
+        const wrappedHandler = subscription._wrappedHandler;
+        if (wrappedHandler) {
+            this.eventTarget.removeEventListener(subscription.eventType, wrappedHandler);
+        }
+        // Clean up empty sets
+        if (subscriptionsForType.size === 0) {
+            this.subscriptions.delete(subscription.eventType);
+        }
+        this.logger.debug(`Unsubscribed from ${subscription.eventType} with ID ${subscription.id}`);
+    }
+    /**
+     * Emit a notification event
+     */
+    emit(event) {
+        this.logger.debug(`Emitting event: ${event.type}`, event.toJSON());
+        const customEvent = new CustomEvent(event.type, {
+            detail: event,
+        });
+        this.eventTarget.dispatchEvent(customEvent);
+    }
+    /**
+     * Check if an event matches a filter
+     */
+    matchesFilter(event, filter) {
+        // Check event type filter
+        if (filter.eventTypes && !filter.eventTypes.includes(event.type)) {
+            return false;
+        }
+        // Check address pattern filter
+        if (filter.addressPattern) {
+            const eventAddress = EventFilters.getEventAddress(event);
+            if (!eventAddress ||
+                !EventFilters.addressMatches(eventAddress, filter.addressPattern)) {
+                return false;
+            }
+        }
+        // Check custom filter
+        if (filter.customFilter && !filter.customFilter(event)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get all active subscriptions for an event type
+     */
+    getSubscriptions(eventType) {
+        if (eventType) {
+            const subs = this.subscriptions.get(eventType);
+            return subs ? Array.from(subs) : [];
+        }
+        // Return all subscriptions
+        const allSubs = [];
+        for (const subs of this.subscriptions.values()) {
+            allSubs.push(...Array.from(subs));
+        }
+        return allSubs;
+    }
+    /**
+     * Get count of active subscriptions
+     */
+    getSubscriptionCount(eventType) {
+        return this.getSubscriptions(eventType).length;
+    }
+    /**
+     * Initialize the notification manager
+     * Calls setupListeners() to wire up transport events
+     */
+    async initialize() {
+        this.logger.debug('Initializing notification manager...');
+        await this.setupListeners();
+        this.logger.debug('Notification manager initialized');
+    }
+    /**
+     * Cleanup all subscriptions
+     */
+    async teardown() {
+        this.logger.debug('Tearing down notification manager...');
+        // Unsubscribe all
+        const allSubs = this.getSubscriptions();
+        for (const sub of allSubs) {
+            this.off(sub);
+        }
+        this.subscriptions.clear();
+        this.logger.debug('Notification manager torn down');
+    }
+}

package/dist/src/core/lib/utils/event-filters.d.ts

@@ -0,0 +1,38 @@
+import { oAddress } from '../../../router/o-address.js';
+import { oNotificationEvent } from '../events/o-notification-event.js';
+/**
+ * Utility functions for filtering notification events
+ */
+export declare class EventFilters {
+    /**
+     * Check if an address matches a pattern
+     * Supports:
+     *   - Regex patterns: any string starting with '/' or containing regex special chars
+     *   - Wildcards: * for single segment, ** for multiple segments
+     *
+     * Examples:
+     *   Wildcards:
+     *     - "o://leader/*" matches "o://leader/child1" but not "o://leader/child1/grandchild"
+     *     - "o://leader/**" matches "o://leader/child1" and "o://leader/child1/grandchild"
+     *     - "o://leader/tools/*" matches "o://leader/tools/calculator"
+     *
+     *   Regex (use standard regex patterns with / delimiters):
+     *     - /^o:\/\/leader\/.*\/ matches any path starting with o://leader/
+     *     - /tool-\d+/ matches paths with tool-1, tool-99, etc.
+     *     - /o:\/\/leader\/(analytics|reporting)\// matches analytics or reporting paths
+     */
+    static addressMatches(address: oAddress, pattern: string): boolean;
+    /**
+     * Filter events to only include direct children of a parent address
+     */
+    static childrenOnly(event: oNotificationEvent, parentAddress: oAddress): boolean;
+    /**
+     * Filter events to only include descendants (children, grandchildren, etc.) of an ancestor address
+     */
+    static descendantsOnly(event: oNotificationEvent, ancestorAddress: oAddress): boolean;
+    /**
+     * Get the address from an event based on its type
+     */
+    static getEventAddress(event: oNotificationEvent): oAddress | null;
+}
+//# sourceMappingURL=event-filters.d.ts.map

package/dist/src/core/lib/utils/event-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-filters.d.ts","sourceRoot":"","sources":["../../../../../src/core/lib/utils/event-filters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAUvE;;GAEG;AACH,qBAAa,YAAY;IACvB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAiElE;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,KAAK,EAAE,kBAAkB,EACzB,aAAa,EAAE,QAAQ,GACtB,OAAO;IAiCV;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,KAAK,EAAE,kBAAkB,EACzB,eAAe,EAAE,QAAQ,GACxB,OAAO;IAgDV;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,QAAQ,GAAG,IAAI;CAcnE"}

package/dist/src/core/lib/utils/event-filters.js

@@ -0,0 +1,159 @@
+import { ChildJoinedEvent, ChildLeftEvent, } from '../events/hierarchy-events.js';
+import { NodeConnectedEvent, NodeDisconnectedEvent, } from '../events/node-events.js';
+/**
+ * Utility functions for filtering notification events
+ */
+export class EventFilters {
+    /**
+     * Check if an address matches a pattern
+     * Supports:
+     *   - Regex patterns: any string starting with '/' or containing regex special chars
+     *   - Wildcards: * for single segment, ** for multiple segments
+     *
+     * Examples:
+     *   Wildcards:
+     *     - "o://leader/*" matches "o://leader/child1" but not "o://leader/child1/grandchild"
+     *     - "o://leader/**" matches "o://leader/child1" and "o://leader/child1/grandchild"
+     *     - "o://leader/tools/*" matches "o://leader/tools/calculator"
+     *
+     *   Regex (use standard regex patterns with / delimiters):
+     *     - /^o:\/\/leader\/.*\/ matches any path starting with o://leader/
+     *     - /tool-\d+/ matches paths with tool-1, tool-99, etc.
+     *     - /o:\/\/leader\/(analytics|reporting)\// matches analytics or reporting paths
+     */
+    static addressMatches(address, pattern) {
+        const addressStr = address.toString();
+        // Check if pattern is a regex (starts with / or contains regex special chars like ^, $, [], (), |)
+        const isRegex = pattern.startsWith('/') || /[\^\$\[\]\(\)\|]/.test(pattern);
+        if (isRegex) {
+            try {
+                // Extract regex pattern and flags if format is /pattern/flags
+                let regexPattern = pattern;
+                let flags = '';
+                if (pattern.startsWith('/')) {
+                    const lastSlash = pattern.lastIndexOf('/');
+                    if (lastSlash > 0) {
+                        regexPattern = pattern.slice(1, lastSlash);
+                        flags = pattern.slice(lastSlash + 1);
+                    }
+                }
+                const regex = new RegExp(regexPattern, flags);
+                return regex.test(addressStr);
+            }
+            catch (e) {
+                // If regex compilation fails, fall back to exact match
+                console.warn(`Invalid regex pattern: ${pattern}`, e);
+                return addressStr === pattern;
+            }
+        }
+        // Handle wildcard patterns (backward compatibility)
+        const addressPaths = address.paths;
+        const patternPaths = pattern.replace('o://', '').split('/').filter(Boolean);
+        // Handle exact match
+        if (addressStr === pattern) {
+            return true;
+        }
+        // Handle wildcard patterns
+        for (let i = 0; i < patternPaths.length; i++) {
+            const patternSegment = patternPaths[i];
+            // ** matches rest of path
+            if (patternSegment === '**') {
+                return true;
+            }
+            // * matches single segment
+            if (patternSegment === '*') {
+                if (i >= addressPaths.length) {
+                    return false;
+                }
+                continue;
+            }
+            // Exact segment match
+            if (addressPaths[i] !== patternSegment) {
+                return false;
+            }
+        }
+        // Pattern must match full address length (unless ended with **)
+        return addressPaths.length === patternPaths.length;
+    }
+    /**
+     * Filter events to only include direct children of a parent address
+     */
+    static childrenOnly(event, parentAddress) {
+        // Check if event is a hierarchy event
+        if (event instanceof ChildJoinedEvent || event instanceof ChildLeftEvent) {
+            return event.parentAddress.toString() === parentAddress.toString();
+        }
+        // For node events, check if the node is a direct child
+        if (event instanceof NodeConnectedEvent ||
+            event instanceof NodeDisconnectedEvent) {
+            const nodeAddr = event.nodeAddress;
+            const parentPaths = parentAddress.paths;
+            const nodePaths = nodeAddr.paths;
+            // Direct child has exactly one more path segment
+            if (nodePaths.length !== parentPaths.length + 1) {
+                return false;
+            }
+            // Check all parent segments match
+            for (let i = 0; i < parentPaths.length; i++) {
+                if (parentPaths[i] !== nodePaths[i]) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Filter events to only include descendants (children, grandchildren, etc.) of an ancestor address
+     */
+    static descendantsOnly(event, ancestorAddress) {
+        // Check if event is a hierarchy event
+        if (event instanceof ChildJoinedEvent || event instanceof ChildLeftEvent) {
+            // Check if parent is a descendant of or equal to ancestor
+            const parentPaths = event.parentAddress.paths;
+            const ancestorPaths = ancestorAddress.paths;
+            if (parentPaths.length < ancestorPaths.length) {
+                return false;
+            }
+            // Check all ancestor segments match
+            for (let i = 0; i < ancestorPaths.length; i++) {
+                if (ancestorPaths[i] !== parentPaths[i]) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        // For node events, check if the node is a descendant
+        if (event instanceof NodeConnectedEvent ||
+            event instanceof NodeDisconnectedEvent) {
+            const nodeAddr = event.nodeAddress;
+            const nodePaths = nodeAddr.paths;
+            const ancestorPaths = ancestorAddress.paths;
+            // Descendant must have more path segments
+            if (nodePaths.length <= ancestorPaths.length) {
+                return false;
+            }
+            // Check all ancestor segments match
+            for (let i = 0; i < ancestorPaths.length; i++) {
+                if (ancestorPaths[i] !== nodePaths[i]) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Get the address from an event based on its type
+     */
+    static getEventAddress(event) {
+        if (event instanceof NodeConnectedEvent ||
+            event instanceof NodeDisconnectedEvent) {
+            return event.nodeAddress;
+        }
+        if (event instanceof ChildJoinedEvent || event instanceof ChildLeftEvent) {
+            return event.childAddress;
+        }
+        return null;
+    }
+}

package/dist/src/core/o-core.d.ts

@@ -14,6 +14,8 @@ import { oRequestManager } from './lib/o-request.manager.js';
 import { oTransport } from '../transports/o-transport.js';
 import { oRouter } from '../router/o-router.js';
 import { oRequest } from '../connection/o-request.js';
+import { oNotificationManager } from './lib/o-notification.manager.js';
+import { oNotificationEvent, EventFilter, NotificationHandler, Subscription } from './lib/events/index.js';
 export declare abstract class oCore extends oObject {
     readonly config: oCoreConfig;
     address: oAddress;
@@ -24,6 +26,7 @@ export declare abstract class oCore extends oObject {
     metrics: oMetrics;
     requestManager: oRequestManager;
     router: oRouter;
+    notificationManager: oNotificationManager;
     private heartbeatInterval?;
     constructor(config: oCoreConfig);
     get isLeader(): boolean;
@@ -110,6 +113,15 @@ export declare abstract class oCore extends oObject {
     abstract initializeRouter(): void;
     abstract unregister(): Promise<void>;
     abstract register(): Promise<void>;
+    protected abstract createNotificationManager(): oNotificationManager;
+    /**
+     * Emit a notification event
+     */
+    protected notify(event: oNotificationEvent): void;
+    /**
+     * Subscribe to notification events
+     */
+    protected onNotification(eventType: string, handler: NotificationHandler, filter?: EventFilter): Subscription;
     initialize(): Promise<void>;
     get isRunning(): boolean;
     /**

package/dist/src/core/o-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-core.d.ts","sourceRoot":"","sources":["../../../src/core/o-core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"o-core.d.ts","sourceRoot":"","sources":["../../../src/core/o-core.ts"],"names":[],"mappings":"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"}

package/dist/src/core/o-core.js

@@ -183,8 +183,29 @@ export class oCore extends oObject {
     removeChildNode(node) {
         this.hierarchyManager.removeChild(node.address);
     }
+    /**
+     * Emit a notification event
+     */
+    notify(event) {
+        if (this.notificationManager) {
+            this.notificationManager.emit(event);
+        }
+    }
+    /**
+     * Subscribe to notification events
+     */
+    onNotification(eventType, handler, filter) {
+        if (!this.notificationManager) {
+            throw new Error('Notification manager not initialized');
+        }
+        return this.notificationManager.on(eventType, handler, filter);
+    }
     // initialize
-    async initialize() { }
+    async initialize() {
+        // Create and initialize notification manager
+        this.notificationManager = this.createNotificationManager();
+        await this.notificationManager.initialize();
+    }
     get isRunning() {
         return (this.state === NodeState.RUNNING ||
             this.state === NodeState.STOPPING ||
@@ -318,6 +339,10 @@ export class oCore extends oObject {
             this.logger.debug('Child stopped: ' + child.toString());
         }
         this.hierarchyManager.clear();
+        // Teardown notification manager
+        if (this.notificationManager) {
+            await this.notificationManager.teardown();
+        }
     }
     get dependencies() {
         return this.config.dependencies?.map((d) => new oDependency(d)) || [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olane/o-core",
-  "version": "0.7.12-alpha.5",
+  "version": "0.7.12-alpha.6",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -55,11 +55,11 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@olane/o-protocol": "0.7.12-alpha.5",
+    "@olane/o-protocol": "0.7.12-alpha.6",
     "chalk": "^5.4.1",
     "debug": "^4.4.1",
     "dotenv": "^16.5.0",
     "multiformats": "^13.3.7"
   },
-  "gitHead": "5c45d9050148c0596b4adeea3d66647c37577a8c"
+  "gitHead": "fad0400ec59d38b163bd996d967cd46c6a5a9e0a"
 }