@olane/o-core 0.7.12-alpha.4 → 0.7.12-alpha.41

package/dist/src/connection/interfaces/connection-manager.config.d.ts

@@ -1,3 +1,15 @@
 export interface oConnectionManagerConfig {
+    /**
+     * Default timeout in milliseconds for reading response data from a stream.
+     * Can be overridden per connection.
+     * Default: 120000 (2 minutes)
+     */
+    defaultReadTimeoutMs?: number;
+    /**
+     * Default timeout in milliseconds for waiting for stream buffer to drain when backpressure occurs.
+     * Can be overridden per connection.
+     * Default: 30000 (30 seconds)
+     */
+    defaultDrainTimeoutMs?: number;
 }
 //# sourceMappingURL=connection-manager.config.d.ts.map

package/dist/src/connection/interfaces/connection-manager.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-manager.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-manager.config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;CAAG"}
+{"version":3,"file":"connection-manager.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-manager.config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/dist/src/connection/interfaces/connection-send-params.interface.d.ts

@@ -4,5 +4,6 @@ export interface ConnectionSendParams {
         [key: string]: unknown;
     };
     id?: string;
+    isStream?: boolean;
 }
 //# sourceMappingURL=connection-send-params.interface.d.ts.map

package/dist/src/connection/interfaces/connection-send-params.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-send-params.interface.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-send-params.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"connection-send-params.interface.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-send-params.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/src/connection/interfaces/connection.config.d.ts

@@ -3,5 +3,17 @@ export interface oConnectionConfig {
     nextHopAddress: oAddress;
     callerAddress?: oAddress;
     address: oAddress;
+    /**
+     * Timeout in milliseconds for reading response data from a stream.
+     * Default: 120000 (2 minutes)
+     */
+    readTimeoutMs?: number;
+    /**
+     * Timeout in milliseconds for waiting for stream buffer to drain when backpressure occurs.
+     * Default: 30000 (30 seconds)
+     */
+    drainTimeoutMs?: number;
+    isStream?: boolean;
+    abortSignal?: AbortSignal;
 }
 //# sourceMappingURL=connection.config.d.ts.map

package/dist/src/connection/interfaces/connection.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,QAAQ,CAAC;IACzB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,OAAO,EAAE,QAAQ,CAAC;CACnB"}
+{"version":3,"file":"connection.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,QAAQ,CAAC;IACzB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,OAAO,EAAE,QAAQ,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B"}

package/dist/src/connection/o-connection-manager.d.ts

@@ -5,7 +5,6 @@ import { oObject } from '../core/o-object.js';
 import { oConnectionConfig } from './interfaces/connection.config.js';
 export declare abstract class oConnectionManager extends oObject {
     readonly config: oConnectionManagerConfig;
-    protected cache: Map<string, oConnection>;
     constructor(config: oConnectionManagerConfig);
     /**
      * Connect to a given address

package/dist/src/connection/o-connection-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-connection-manager.d.ts","sourceRoot":"","sources":["../../../src/connection/o-connection-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,8BAAsB,kBAAmB,SAAQ,OAAO;IAG1C,QAAQ,CAAC,MAAM,EAAE,wBAAwB;IAFrD,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAa;gBAEjC,MAAM,EAAE,wBAAwB;IAIrD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAEjE,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIpC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI;CAe3D"}
+{"version":3,"file":"o-connection-manager.d.ts","sourceRoot":"","sources":["../../../src/connection/o-connection-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,8BAAsB,kBAAmB,SAAQ,OAAO;IAC1C,QAAQ,CAAC,MAAM,EAAE,wBAAwB;gBAAhC,MAAM,EAAE,wBAAwB;IAIrD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAEjE,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIpC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI;CAG3D"}

package/dist/src/connection/o-connection-manager.js

@@ -3,25 +3,11 @@ export class oConnectionManager extends oObject {
     constructor(config) {
         super();
         this.config = config;
-        this.cache = new Map();
     }
     isCached(address) {
-        return this.cache.has(address.toString());
+        return false;
     }
     getCachedConnection(address) {
-        const key = address.toString();
-        try {
-            const connection = this.cache.get(key);
-            if (!connection) {
-                throw new Error('Connection not found in cache');
-            }
-            connection.validate();
-            return connection;
-        }
-        catch (error) {
-            this.cache.delete(key);
-            this.logger.error('Error getting cached connection:', error);
-        }
         return null;
     }
 }

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

@@ -4,13 +4,17 @@ import { oResponse } from './o-response.js';
 import { ConnectionSendParams } from './interfaces/connection-send-params.interface.js';
 import { oObject } from '../core/o-object.js';
 import { oConnectionConfig } from './interfaces/connection.config.js';
+import { EventEmitter } from 'events';
 export declare abstract class oConnection extends oObject {
     protected readonly config: oConnectionConfig;
     readonly id: string;
     readonly address: oAddress;
     readonly nextHopAddress: oAddress;
     readonly callerAddress: oAddress | undefined;
+    protected readonly emitter: EventEmitter;
     constructor(config: oConnectionConfig);
+    get abortSignal(): AbortSignal | undefined;
+    onChunk(listener: (response: oResponse) => void): void;
     validate(): void;
     createRequest(method: string, params: ConnectionSendParams): oRequest;
     abstract transmit(request: oRequest): Promise<oResponse>;

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

@@ -1 +1 @@
-{"version":3,"file":"o-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAExF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,8BAAsB,WAAY,SAAQ,OAAO;IAMnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IALxD,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,OAAO,EAAE,QAAQ,CAAC;IAClC,SAAgB,cAAc,EAAE,QAAQ,CAAC;IACzC,SAAgB,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;gBAErB,MAAM,EAAE,iBAAiB;IAgBxD,QAAQ,IAAI,IAAI;IAMhB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,QAAQ;IAarE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAElD,IAAI,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAOpD,KAAK;CAGZ"}
+{"version":3,"file":"o-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAExF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,8BAAsB,WAAY,SAAQ,OAAO;IAOnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IANxD,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,OAAO,EAAE,QAAQ,CAAC;IAClC,SAAgB,cAAc,EAAE,QAAQ,CAAC;IACzC,SAAgB,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAsB;gBAE/B,MAAM,EAAE,iBAAiB;IAgBxD,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS,CAEzC;IAED,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,IAAI;IAI/C,QAAQ,IAAI,IAAI;IAMhB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,QAAQ;IAcrE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAElD,IAAI,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAMpD,KAAK;CAGZ"}

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

@@ -2,10 +2,12 @@ import { oRequest } from './o-request.js';
 import { oProtocolMethods } from '@olane/o-protocol';
 import { v4 as uuidv4 } from 'uuid';
 import { oObject } from '../core/o-object.js';
+import { EventEmitter } from 'events';
 export class oConnection extends oObject {
     constructor(config) {
         super();
         this.config = config;
+        this.emitter = new EventEmitter();
         this.id = uuidv4();
         this.address = config.address;
         this.nextHopAddress = config.nextHopAddress;
@@ -17,6 +19,12 @@ export class oConnection extends oObject {
             ']:' +
             this.id);
     }
+    get abortSignal() {
+        return this.config.abortSignal;
+    }
+    onChunk(listener) {
+        this.emitter.addListener('chunk', listener);
+    }
     validate() {
         if (!this.address || !this.nextHopAddress || !this.callerAddress) {
             throw new Error('Connection configuration is invalid');
@@ -29,6 +37,7 @@ export class oConnection extends oObject {
                 _connectionId: this.id,
                 _requestMethod: method,
                 _callerAddress: this.callerAddress?.value,
+                _isStreaming: this.config.isStream ?? false,
                 ...params,
             },
             id: params.id || uuidv4(),
@@ -37,8 +46,7 @@ export class oConnection extends oObject {
     async send(data) {
         // proxy through the router tool
         const request = this.createRequest(oProtocolMethods.ROUTE, data);
-        const result = await this.transmit(request);
-        return result;
+        return this.transmit(request);
     }
     async close() {
         this.logger.debug('Closing connection...');

package/dist/src/connection/o-response.d.ts

@@ -8,5 +8,6 @@ export declare class oResponse implements Response {
     });
     toJSON(): any;
     toString(): string;
+    static fromJSON(json: any): oResponse;
 }
 //# sourceMappingURL=o-response.d.ts.map

package/dist/src/connection/o-response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-response.d.ts","sourceRoot":"","sources":["../../../src/connection/o-response.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,SAAS,EACT,SAAS,IAAI,QAAQ,EACrB,MAAM,EACP,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,SAAU,YAAW,QAAQ;IACxC,OAAO,EAAE,OAAO,eAAe,CAAC;IAChC,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;gBAEH,MAAM,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,SAAS,CAAA;KAAE;IAM9C,MAAM,IAAI,GAAG;IAQb,QAAQ,IAAI,MAAM;CAGnB"}
+{"version":3,"file":"o-response.d.ts","sourceRoot":"","sources":["../../../src/connection/o-response.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,SAAS,EACT,SAAS,IAAI,QAAQ,EACrB,MAAM,EACP,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,SAAU,YAAW,QAAQ;IACxC,OAAO,EAAE,OAAO,eAAe,CAAC;IAChC,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;gBAEH,MAAM,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,SAAS,CAAA;KAAE;IAM9C,MAAM,IAAI,GAAG;IAQb,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,SAAS;CAOtC"}

package/dist/src/connection/o-response.js

@@ -15,4 +15,11 @@ export class oResponse {
     toString() {
         return JSON.stringify(this);
     }
+    static fromJSON(json) {
+        return new oResponse({
+            ...json.result,
+            _connectionId: json.result?._connectionId,
+            _requestMethod: json.result?._requestMethod,
+        });
+    }
 }

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

@@ -1,4 +1,7 @@
 export * from './o-core.config.js';
 export * from './node-type.enum.js';
 export * from './state.enum.js';
+export * from './use-options.interface.js';
+export * from './o-core.interface.js';
+export * from './use-stream-options.interface.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mCAAmC,CAAC"}

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

@@ -1,3 +1,6 @@
 export * from './o-core.config.js';
 export * from './node-type.enum.js';
 export * from './state.enum.js';
+export * from './use-options.interface.js';
+export * from './o-core.interface.js';
+export * from './use-stream-options.interface.js';

package/dist/src/core/interfaces/use-options.interface.d.ts

@@ -0,0 +1,10 @@
+import { oResponse } from '../../connection/o-response.js';
+export interface UseOptions {
+    readTimeoutMs?: number;
+    drainTimeoutMs?: number;
+    isStream?: boolean;
+    onChunk?: (chunk: oResponse) => void;
+    noRouting?: boolean;
+    abortSignal?: AbortSignal;
+}
+//# sourceMappingURL=use-options.interface.d.ts.map

package/dist/src/core/interfaces/use-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-options.interface.d.ts","sourceRoot":"","sources":["../../../../src/core/interfaces/use-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B"}

package/dist/src/core/interfaces/use-options.interface.js

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

package/dist/src/core/interfaces/use-stream-options.interface.d.ts

@@ -0,0 +1,4 @@
+import { UseOptions } from './use-options.interface';
+export interface UseStreamOptions extends Omit<UseOptions, 'isStream'> {
+}
+//# sourceMappingURL=use-stream-options.interface.d.ts.map

package/dist/src/core/interfaces/use-stream-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stream-options.interface.d.ts","sourceRoot":"","sources":["../../../../src/core/interfaces/use-stream-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;CAAG"}

package/dist/src/core/interfaces/use-stream-options.interface.js

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

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(),
+        };
+    }
+}