@olane/o-node 0.7.12-alpha.4 → 0.7.12-alpha.40

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

@@ -0,0 +1,8 @@
+export * from './o-connection.js';
+export * from './o-connection-manager.js';
+export * from './interfaces/connection.config.js';
+export * from './interfaces/connection-manager.config.js';
+export * from './o-request.js';
+export * from './o-response.js';
+export * from './interfaces/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/connection/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mCAAmC,CAAC;AAClD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}

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

@@ -0,0 +1,7 @@
+export * from './o-connection.js';
+export * from './o-connection-manager.js';
+export * from './interfaces/connection.config.js';
+export * from './interfaces/connection-manager.config.js';
+export * from './o-request.js';
+export * from './o-response.js';
+export * from './interfaces/index.js';

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

@@ -0,0 +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/o-core/src/connection/interfaces/connection-manager.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-manager.config.d.ts","sourceRoot":"","sources":["../../../../../../o-core/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/o-core/src/connection/interfaces/connection-manager.config.js

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

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

@@ -0,0 +1,9 @@
+export interface ConnectionSendParams {
+    address: string;
+    payload: {
+        [key: string]: unknown;
+    };
+    id?: string;
+    isStream?: boolean;
+}
+//# sourceMappingURL=connection-send-params.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection-send-params.interface.d.ts","sourceRoot":"","sources":["../../../../../../o-core/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/o-core/src/connection/interfaces/connection-send-params.interface.js

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

package/dist/o-core/src/connection/interfaces/connection.config.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="node" />
+import { oAddress } from '../../router/o-address.js';
+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/o-core/src/connection/interfaces/connection.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.config.d.ts","sourceRoot":"","sources":["../../../../../../o-core/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/o-core/src/connection/interfaces/connection.config.js

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

package/dist/o-core/src/connection/interfaces/index.d.ts

@@ -0,0 +1,5 @@
+export * from './connection.config.js';
+export * from './connection-manager.config.js';
+export * from './connection-send-params.interface.js';
+export * from './request-state.enum.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/o-core/src/connection/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../o-core/src/connection/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,yBAAyB,CAAC"}

package/dist/o-core/src/connection/interfaces/index.js

@@ -0,0 +1,4 @@
+export * from './connection.config.js';
+export * from './connection-manager.config.js';
+export * from './connection-send-params.interface.js';
+export * from './request-state.enum.js';

package/dist/o-core/src/connection/interfaces/request-state.enum.d.ts

@@ -0,0 +1,7 @@
+export declare enum RequestState {
+    PENDING = "PENDING",
+    PROCESSING = "PROCESSING",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED"
+}
+//# sourceMappingURL=request-state.enum.d.ts.map

package/dist/o-core/src/connection/interfaces/request-state.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-state.enum.d.ts","sourceRoot":"","sources":["../../../../../../o-core/src/connection/interfaces/request-state.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB"}

package/dist/o-core/src/connection/interfaces/request-state.enum.js

@@ -0,0 +1,7 @@
+export var RequestState;
+(function (RequestState) {
+    RequestState["PENDING"] = "PENDING";
+    RequestState["PROCESSING"] = "PROCESSING";
+    RequestState["COMPLETED"] = "COMPLETED";
+    RequestState["FAILED"] = "FAILED";
+})(RequestState || (RequestState = {}));

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

@@ -0,0 +1,19 @@
+import { oAddress } from '../router/o-address.js';
+import { oConnection } from './o-connection.js';
+import { oConnectionManagerConfig } from './interfaces/connection-manager.config.js';
+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
+     * @param address - The address to connect to
+     * @returns The connection object
+     */
+    abstract connect(config: oConnectionConfig): Promise<oConnection>;
+    isCached(address: oAddress): boolean;
+    getCachedConnection(address: oAddress): oConnection | null;
+}
+//# sourceMappingURL=o-connection-manager.d.ts.map

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

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

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

@@ -0,0 +1,27 @@
+import { oObject } from '../core/o-object.js';
+export class oConnectionManager extends oObject {
+    constructor(config) {
+        super();
+        this.config = config;
+        this.cache = new Map();
+    }
+    isCached(address) {
+        return this.cache.has(address.toString());
+    }
+    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/o-core/src/connection/o-connection.d.ts

@@ -0,0 +1,26 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { oAddress } from '../router/o-address.js';
+import { oRequest } from './o-request.js';
+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>;
+    send(data: ConnectionSendParams): Promise<oResponse>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=o-connection.d.ts.map

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

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

@@ -0,0 +1,54 @@
+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;
+        this.callerAddress = config.callerAddress;
+        this.logger.setNamespace('Connection:[' +
+            (config.callerAddress?.value || 'unknown') +
+            ']-->[' +
+            this.address.value +
+            ']:' +
+            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');
+        }
+    }
+    createRequest(method, params) {
+        return new oRequest({
+            method: method,
+            params: {
+                _connectionId: this.id,
+                _requestMethod: method,
+                _callerAddress: this.callerAddress?.value,
+                _isStreaming: this.config.isStream ?? false,
+                ...params,
+            },
+            id: params.id || uuidv4(),
+        });
+    }
+    async send(data) {
+        // proxy through the router tool
+        const request = this.createRequest(oProtocolMethods.ROUTE, data);
+        return this.transmit(request);
+    }
+    async close() {
+        this.logger.debug('Closing connection...');
+    }
+}

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

@@ -0,0 +1,23 @@
+import { JSONRPC_VERSION, JSONRPCRequest, Request, RequestId, RequestParams } from '@olane/o-protocol';
+import { RequestState } from './interfaces/request-state.enum.js';
+import { oObject } from '../core/o-object.js';
+export declare class oRequest extends oObject implements JSONRPCRequest {
+    jsonrpc: typeof JSONRPC_VERSION;
+    method: string;
+    params: RequestParams;
+    id: RequestId;
+    state: RequestState;
+    constructor(config: Request & {
+        id: RequestId;
+    });
+    get connectionId(): string;
+    toJSON(): JSONRPCRequest;
+    setState(state: RequestState): void;
+    toString(): string;
+    static hasOlaneAddress(value: string): boolean;
+    static extractAddresses(value: string): string[];
+    static fromJSON(json: Request & {
+        id: RequestId;
+    }): oRequest;
+}
+//# sourceMappingURL=o-request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"o-request.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/connection/o-request.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EACd,OAAO,EACP,SAAS,EACT,aAAa,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,qBAAa,QAAS,SAAQ,OAAQ,YAAW,cAAc;IAC7D,OAAO,EAAE,OAAO,eAAe,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,YAAY,CAAwB;gBAE/B,MAAM,EAAE,OAAO,GAAG;QAAE,EAAE,EAAE,SAAS,CAAA;KAAE;IAU/C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,MAAM,IAAI,cAAc;IASxB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAInC,QAAQ;IAIR,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAQ9C,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAKhD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG;QAAE,EAAE,EAAE,SAAS,CAAA;KAAE,GAAG,QAAQ;CAG7D"}

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

@@ -0,0 +1,42 @@
+import { JSONRPC_VERSION, } from '@olane/o-protocol';
+import { RequestState } from './interfaces/request-state.enum.js';
+import { oObject } from '../core/o-object.js';
+export class oRequest extends oObject {
+    constructor(config) {
+        super(`Request:${config.id}${config.params?._callerAddress ? `Origin:${config.params._callerAddress}` : ''}`);
+        this.state = RequestState.PENDING;
+        this.jsonrpc = JSONRPC_VERSION;
+        this.method = config.method;
+        this.params = config.params;
+        this.id = config.id;
+    }
+    get connectionId() {
+        return this.params._connectionId;
+    }
+    toJSON() {
+        return {
+            jsonrpc: this.jsonrpc,
+            method: this.method,
+            params: this.params,
+            id: this.id,
+        };
+    }
+    setState(state) {
+        this.state = state;
+    }
+    toString() {
+        return JSON.stringify(this.toJSON());
+    }
+    static hasOlaneAddress(value) {
+        return (!!value &&
+            typeof value === 'string' &&
+            !!value?.match(/o:\/\/.*(placeholder)+(?:\/[\w.-]+)+/g));
+    }
+    static extractAddresses(value) {
+        const matches = value.matchAll(/o:\/\/.*(placeholder)+(?:\/[\w.-]+)+/g);
+        return Array.from(matches, (match) => match[0]);
+    }
+    static fromJSON(json) {
+        return new oRequest(json);
+    }
+}

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

@@ -0,0 +1,13 @@
+import { JSONRPC_VERSION, RequestId, oResponse as Response, Result } from '@olane/o-protocol';
+export declare class oResponse implements Response {
+    jsonrpc: typeof JSONRPC_VERSION;
+    id: RequestId;
+    result: Result;
+    constructor(config: Result & {
+        id: RequestId;
+    });
+    toJSON(): any;
+    toString(): string;
+    static fromJSON(json: any): oResponse;
+}
+//# sourceMappingURL=o-response.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"o-response.d.ts","sourceRoot":"","sources":["../../../../../o-core/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/o-core/src/connection/o-response.js

@@ -0,0 +1,25 @@
+import { JSONRPC_VERSION, } from '@olane/o-protocol';
+export class oResponse {
+    constructor(config) {
+        this.jsonrpc = JSONRPC_VERSION;
+        this.id = config.id;
+        this.result = config;
+    }
+    toJSON() {
+        return {
+            jsonrpc: this.jsonrpc,
+            id: this.id,
+            result: this.result,
+        };
+    }
+    toString() {
+        return JSON.stringify(this);
+    }
+    static fromJSON(json) {
+        return new oResponse({
+            ...json.result,
+            _connectionId: json.result?._connectionId,
+            _requestMethod: json.result?._requestMethod,
+        });
+    }
+}

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

@@ -0,0 +1,4 @@
+export declare const DEFAULT_CONFIG_PATH: string;
+export declare const DEFAULT_INSTANCE_PATH: string;
+export declare const DEFAULT_CONFIG_FILE: string;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../../../o-core/src/core/defaults/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,mBAAmB,QAAoC,CAAC;AACrE,eAAO,MAAM,qBAAqB,QAGjC,CAAC;AACF,eAAO,MAAM,mBAAmB,QAG/B,CAAC"}

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

@@ -0,0 +1,5 @@
+import path from 'path';
+import os from 'os';
+export const DEFAULT_CONFIG_PATH = path.join(os.homedir(), '.olane');
+export const DEFAULT_INSTANCE_PATH = path.join(DEFAULT_CONFIG_PATH, 'os-instances');
+export const DEFAULT_CONFIG_FILE = path.join(DEFAULT_CONFIG_PATH, 'config.json');

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

@@ -0,0 +1,2 @@
+export * from './config.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../o-core/src/core/defaults/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1 @@
+export * from './config.js';

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

@@ -0,0 +1,25 @@
+import { Logger } from '../utils/logger.js';
+export interface CleanupFunction {
+    (): Promise<void> | void;
+}
+export interface GracefulShutdownOptions {
+    timeout?: number;
+    logger?: Logger;
+    onTimeout?: () => void;
+}
+/**
+ * Sets up signal handlers for graceful shutdown
+ * @param cleanup Cleanup function to run on shutdown
+ * @param options Configuration options for graceful shutdown
+ */
+export declare function setupGracefulShutdown(cleanup: CleanupFunction, options?: GracefulShutdownOptions): void;
+/**
+ * Creates a cleanup function that stops multiple resources
+ * @param resources Array of resources with stop methods
+ * @param logger Logger instance for logging
+ */
+export declare function createMultiResourceCleanup(resources: Array<{
+    stop(): Promise<void> | void;
+    address?: string;
+}>, logger?: Logger): CleanupFunction;
+//# sourceMappingURL=graceful-shutdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graceful-shutdown.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/core/graceful-shutdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,uBAA4B,GACpC,IAAI,CAmEN;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACpE,MAAM,GAAE,MAA2C,GAClD,eAAe,CAmBjB"}

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

@@ -0,0 +1,84 @@
+import { Logger } from '../utils/logger.js';
+/**
+ * Sets up signal handlers for graceful shutdown
+ * @param cleanup Cleanup function to run on shutdown
+ * @param options Configuration options for graceful shutdown
+ */
+export function setupGracefulShutdown(cleanup, options = {}) {
+    const { timeout = 30000, // 30 seconds default timeout
+    logger = new Logger('GracefulShutdown'), onTimeout, } = options;
+    let isShuttingDown = false;
+    const performCleanup = async (signal) => {
+        if (isShuttingDown) {
+            logger.debug('Shutdown already in progress, skipping...');
+            return;
+        }
+        isShuttingDown = true;
+        logger.info(`Received ${signal}, initiating graceful shutdown...`);
+        try {
+            // Set up timeout for cleanup operations
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => {
+                    reject(new Error(`Cleanup timeout after ${timeout}ms`));
+                }, timeout);
+            });
+            // Perform cleanup with timeout
+            await Promise.race([Promise.resolve(cleanup()), timeoutPromise]);
+            logger.info('Graceful shutdown completed successfully');
+        }
+        catch (error) {
+            logger.error('Error during graceful shutdown:', error);
+            if (onTimeout) {
+                onTimeout();
+            }
+        }
+        finally {
+            logger.info('Process exiting');
+            process.exit(0);
+        }
+    };
+    // Handle SIGINT (Ctrl+C)
+    process.on('SIGINT', () => performCleanup('SIGINT'));
+    // Handle SIGTERM (termination signal)
+    process.on('SIGTERM', () => performCleanup('SIGTERM'));
+    // Handle SIGUSR2 (Node.js restart signal)
+    process.on('SIGUSR2', () => performCleanup('SIGUSR2'));
+    // Handle uncaught exceptions
+    process.on('uncaughtException', (error) => {
+        logger.error('Uncaught Exception:', error);
+        performCleanup('uncaughtException');
+    });
+    // Handle unhandled promise rejections
+    process.on('unhandledRejection', (reason, promise) => {
+        logger.error('Unhandled Rejection at:', promise, 'reason:', reason);
+        performCleanup('unhandledRejection');
+    });
+    // Handle process exit (synchronous cleanup)
+    process.on('exit', (code) => {
+        logger.info(`Process exiting with code: ${code}`);
+    });
+}
+/**
+ * Creates a cleanup function that stops multiple resources
+ * @param resources Array of resources with stop methods
+ * @param logger Logger instance for logging
+ */
+export function createMultiResourceCleanup(resources, logger = new Logger('MultiResourceCleanup')) {
+    return async () => {
+        logger.info(`Stopping ${resources.length} resources...`);
+        const stopPromises = resources.map(async (resource) => {
+            try {
+                const resourceName = resource.address || resource.constructor.name;
+                logger.debug(`Stopping resource: ${resourceName}`);
+                await Promise.resolve(resource.stop());
+                logger.debug(`Successfully stopped resource: ${resourceName}`);
+            }
+            catch (error) {
+                const resourceName = resource.address || resource.constructor.name;
+                logger.error(`Error stopping resource ${resourceName}:`, error);
+            }
+        });
+        await Promise.allSettled(stopPromises);
+        logger.info('All resources stopped');
+    };
+}

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

@@ -0,0 +1,9 @@
+export * from './o-core.js';
+export * from './interfaces/index.js';
+export * from './o-dependency.js';
+export * from './o-parameter.js';
+export * from './defaults/index.js';
+export * from './graceful-shutdown.js';
+export * from './lib/index.js';
+export * from './o-object.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

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

@@ -0,0 +1,8 @@
+export * from './o-core.js';
+export * from './interfaces/index.js';
+export * from './o-dependency.js';
+export * from './o-parameter.js';
+export * from './defaults/index.js';
+export * from './graceful-shutdown.js';
+export * from './lib/index.js';
+export * from './o-object.js';

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

@@ -0,0 +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/o-core/src/core/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../o-core/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/o-core/src/core/interfaces/index.js

@@ -0,0 +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/o-core/src/core/interfaces/node-type.enum.d.ts

@@ -0,0 +1,10 @@
+export declare enum NodeType {
+    LEADER = "leader",
+    ROOT = "root",
+    NODE = "node",
+    TOOL = "tool",
+    AGENT = "agent",
+    HUMAN = "human",
+    UNKNOWN = "unknown"
+}
+//# sourceMappingURL=node-type.enum.d.ts.map

package/dist/o-core/src/core/interfaces/node-type.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-type.enum.d.ts","sourceRoot":"","sources":["../../../../../../o-core/src/core/interfaces/node-type.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;CACpB"}

package/dist/o-core/src/core/interfaces/node-type.enum.js

@@ -0,0 +1,10 @@
+export var NodeType;
+(function (NodeType) {
+    NodeType["LEADER"] = "leader";
+    NodeType["ROOT"] = "root";
+    NodeType["NODE"] = "node";
+    NodeType["TOOL"] = "tool";
+    NodeType["AGENT"] = "agent";
+    NodeType["HUMAN"] = "human";
+    NodeType["UNKNOWN"] = "unknown";
+})(NodeType || (NodeType = {}));

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

@@ -0,0 +1,23 @@
+import { Libp2pConfig } from '@olane/o-config';
+import { oAddress } from '../../router/o-address.js';
+import { NodeType } from './node-type.enum.js';
+import { oDependency, oMethod } from '@olane/o-protocol';
+export interface oCoreConfig {
+    address: oAddress;
+    leader: oAddress | null;
+    parent: oAddress | null;
+    type?: NodeType;
+    seed?: string;
+    name?: string;
+    network?: Libp2pConfig;
+    metrics?: boolean;
+    description?: string;
+    dependencies?: oDependency[];
+    methods?: {
+        [key: string]: oMethod;
+    };
+    cwd?: string;
+    systemName?: string;
+    joinToken?: string;
+}
+//# sourceMappingURL=o-core.config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"o-core.config.d.ts","sourceRoot":"","sources":["../../../../../../o-core/src/core/interfaces/o-core.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}