@olane/o-core 0.7.12-alpha.24 → 0.7.12-alpha.26

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._connectionId,
+            _requestMethod: json._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,9 @@
+import { oResponse } from '../../connection/o-response.js';
+export interface UseOptions {
+    readTimeoutMs?: number;
+    drainTimeoutMs?: number;
+    isStream?: boolean;
+    onChunk?: (chunk: oResponse) => void;
+    noRouting?: boolean;
+}
+//# 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;CACrB"}

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/o-core.d.ts

@@ -17,6 +17,8 @@ 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';
 import { oConnectionConfig } from '../connection/index.js';
+import { UseOptions } from './interfaces/use-options.interface.js';
+import { UseStreamOptions } from './interfaces/use-stream-options.interface.js';
 export declare abstract class oCore extends oObject {
     readonly config: oCoreConfig;
     address: oAddress;
@@ -39,9 +41,7 @@ export declare abstract class oCore extends oObject {
             [key: string]: any;
         };
         id?: string;
-    }, options: {
-        onChunk?: (chunk: oResponse) => void;
-    }): Promise<oResponse>;
+    }, options: UseStreamOptions): Promise<oResponse>;
     useDirect(address: oAddress, data?: {
         method?: string;
         params?: {
@@ -108,14 +108,19 @@ export declare abstract class oCore extends oObject {
             [key: string]: any;
         };
         id?: string;
-    }, options?: {
-        noRouting?: boolean;
-        readTimeoutMs?: number;
-        drainTimeoutMs?: number;
-        isStream?: boolean;
-        onChunk?: (chunk: oResponse) => void;
-    }): Promise<oResponse>;
+    }, options?: UseOptions): Promise<oResponse>;
     abstract execute(request: oRequest): Promise<any>;
+    /**
+     * Helper method to handle response errors
+     * @param response The response to check for errors
+     * @throws oError if the response contains an error
+     */
+    private handleResponseError;
+    /**
+     * Helper method to validate node is running
+     * @throws Error if node is not running
+     */
+    private validateRunning;
     useSelf(data?: {
         method?: string;
         params?: {

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

@@ -7,9 +7,8 @@ import { oObject } from './o-object.js';
 import { oMetrics } from './lib/o-metrics.js';
 import { oHierarchyManager } from './lib/o-hierarchy.manager.js';
 import { oRequestManager } from './lib/o-request.manager.js';
-import { CoreUtils } from '../utils/core.utils.js';
-import { oErrorCodes } from '../error/index.js';
 import { oRequest } from '../connection/o-request.js';
+import { ResponseBuilder } from '../response/response-builder.js';
 export class oCore extends oObject {
     constructor(config) {
         super((config.name ? `:${config.name}` : '') + ':' + config.address.toString());
@@ -31,9 +30,15 @@ export class oCore extends oObject {
         return this.isLeader ? this.address : this.config?.leader || null;
     }
     async useStream(address, data, options) {
-        return this.use(address, data, {
+        return this.use(address, {
+            ...data,
+            params: {
+                ...data.params,
+                _isStream: true,
+            },
+        }, {
+            ...options,
             isStream: true,
-            onChunk: options.onChunk,
         });
     }
     async useDirect(address, data) {
@@ -93,10 +98,7 @@ export class oCore extends oObject {
      * ```
      */
     async use(address, data, options) {
-        if (!this.isRunning) {
-            this.logger.error('Node is not running', this.state);
-            throw new Error('Node is not running');
-        }
+        this.validateRunning();
         if (!address.validate()) {
             throw new Error('Invalid address');
         }
@@ -139,16 +141,32 @@ export class oCore extends oObject {
             return response;
         }
         // if there is an error, throw it to continue to bubble up
+        this.handleResponseError(response);
+        return response;
+    }
+    /**
+     * Helper method to handle response errors
+     * @param response The response to check for errors
+     * @throws oError if the response contains an error
+     */
+    handleResponseError(response) {
         if (response.result.error) {
             this.logger.error('response.result.error', JSON.stringify(response.result.error, null, 2));
             throw oError.fromJSON(response.result.error);
         }
-        return response;
     }
-    async useSelf(data) {
+    /**
+     * Helper method to validate node is running
+     * @throws Error if node is not running
+     */
+    validateRunning() {
         if (!this.isRunning) {
+            this.logger.error('Node is not running', this.state);
             throw new Error('Node is not running');
         }
+    }
+    async useSelf(data) {
+        this.validateRunning();
         // let's call our own tool
         this.logger.debug('Calling ourselves, skipping...', data);
         const request = new oRequest({
@@ -160,29 +178,19 @@ export class oCore extends oObject {
             },
             id: 0,
         });
-        let success = true;
-        const result = await this.execute(request).catch((error) => {
-            this.logger.error('Error executing tool [self]: ', error);
-            success = false;
-            const responseError = error instanceof oError
-                ? error
-                : new oError(oErrorCodes.UNKNOWN, error.message);
-            return {
-                error: responseError.toJSON(),
-            };
-        });
-        if (success) {
-            this.metrics.successCount++;
+        // Use ResponseBuilder with automatic error handling and metrics tracking
+        const responseBuilder = ResponseBuilder.create().withMetrics(this.metrics);
+        try {
+            const result = await this.execute(request);
+            return await responseBuilder.build(request, result, null);
         }
-        else {
-            this.metrics.errorCount++;
+        catch (error) {
+            this.logger.error('Error executing tool [self]: ', error);
+            return await responseBuilder.buildError(request, error);
         }
-        return CoreUtils.buildResponse(request, result, result?.error);
     }
     async useChild(childAddress, data, options) {
-        if (!this.isRunning) {
-            throw new Error('Node is not running');
-        }
+        this.validateRunning();
         if (!childAddress.transports) {
             const child = this.hierarchyManager.getChild(childAddress);
             if (!child) {
@@ -197,7 +205,13 @@ export class oCore extends oObject {
             nextHopAddress: childAddress,
             address: childAddress,
             callerAddress: this.address,
+            isStream: options?.isStream,
         });
+        if (options?.isStream) {
+            connection.onChunk((response) => {
+                options.onChunk?.(response);
+            });
+        }
         // communicate the payload to the target node
         const response = await connection.send({
             address: childAddress?.toString() || '',
@@ -205,10 +219,7 @@ export class oCore extends oObject {
             id: data?.id,
         });
         // if there is an error, throw it to continue to bubble up
-        if (response.result.error) {
-            this.logger.error('response.result.error', JSON.stringify(response.result.error, null, 2));
-            throw oError.fromJSON(response.result.error);
-        }
+        this.handleResponseError(response);
         return response;
     }
     // hierarchy

package/dist/src/index.d.ts

@@ -1,6 +1,7 @@
 export * from './connection/index.js';
 export * from './core/index.js';
 export * from './error/index.js';
+export * from './response/index.js';
 export * from './router/index.js';
 export * from './transports/index.js';
 export * from './utils/index.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC"}

package/dist/src/index.js

@@ -1,6 +1,7 @@
 export * from './connection/index.js';
 export * from './core/index.js';
 export * from './error/index.js';
+export * from './response/index.js';
 export * from './router/index.js';
 export * from './transports/index.js';
 export * from './utils/index.js';

package/dist/src/response/index.d.ts

@@ -0,0 +1,2 @@
+export { ResponseBuilder, ResponseContext, ResponseMiddleware, MetricsTracker, DefaultMetricsTracker, } from './response-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/response/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/response/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/src/response/index.js

@@ -0,0 +1 @@
+export { ResponseBuilder, DefaultMetricsTracker, } from './response-builder.js';

package/dist/src/response/response-builder.d.ts

@@ -0,0 +1,140 @@
+import { oRequest } from '../connection/o-request.js';
+import { oResponse } from '../connection/o-response.js';
+import { oError } from '../error/o-error.js';
+/**
+ * Response context for building responses with proper metadata
+ */
+export interface ResponseContext {
+    /** Whether this is a streaming response */
+    isStream?: boolean;
+    /** Whether this is the last chunk in a stream */
+    isLast?: boolean;
+    /** Whether the operation was successful */
+    success?: boolean;
+    /** Request ID for correlation */
+    requestId?: string | number;
+    /** Connection ID from the request */
+    connectionId?: string | number;
+    /** Request method for tracking */
+    requestMethod?: string | number;
+}
+/**
+ * Middleware function that can intercept and transform responses
+ */
+export type ResponseMiddleware = (response: oResponse, context: ResponseContext) => oResponse | Promise<oResponse>;
+/**
+ * Metrics tracker interface for extensible metrics tracking
+ */
+export interface MetricsTracker {
+    trackSuccess(context: ResponseContext): void;
+    trackError(context: ResponseContext, error: oError): void;
+}
+/**
+ * Default metrics tracker that increments counters
+ */
+export declare class DefaultMetricsTracker implements MetricsTracker {
+    private metrics;
+    constructor(metrics: {
+        successCount: number;
+        errorCount: number;
+    });
+    trackSuccess(context: ResponseContext): void;
+    trackError(context: ResponseContext, error: oError): void;
+}
+/**
+ * ResponseBuilder - Unified response generation for all Olane routing paths
+ *
+ * This class provides a single source of truth for creating responses across:
+ * - Local execution (useSelf)
+ * - Remote execution (use, useChild)
+ * - Router forwarding (forward, executeSelfRouting)
+ * - Streaming responses
+ *
+ * Features:
+ * - Consistent error normalization
+ * - Automatic metrics tracking
+ * - Context-aware response building (streaming, success/error states)
+ * - Extensible middleware system
+ *
+ * @example
+ * ```typescript
+ * const builder = new ResponseBuilder()
+ *   .withMetrics(node.metrics)
+ *   .use(loggingMiddleware);
+ *
+ * const response = await builder.build(request, result, error);
+ * ```
+ */
+export declare class ResponseBuilder {
+    private middlewares;
+    private metricsTracker?;
+    /**
+     * Add a middleware function to intercept responses
+     */
+    use(middleware: ResponseMiddleware): this;
+    /**
+     * Configure metrics tracking
+     * @param metrics The metrics object to track success/error counts
+     */
+    withMetrics(metrics: {
+        successCount: number;
+        errorCount: number;
+    }): this;
+    /**
+     * Configure custom metrics tracker
+     * @param tracker Custom metrics tracker implementation
+     */
+    withCustomMetrics(tracker: MetricsTracker): this;
+    /**
+     * Normalize any error into an oError instance
+     * @param error The error to normalize
+     * @returns An oError instance
+     */
+    normalizeError(error: any): oError;
+    /**
+     * Build a complete response from a request and result
+     * @param request The original request
+     * @param result The result data (or error object)
+     * @param error Optional error object
+     * @param context Additional response context
+     * @returns An oResponse instance
+     */
+    build(request: oRequest, result: any, error?: any, context?: Partial<ResponseContext>): Promise<oResponse>;
+    /**
+     * Build a streaming chunk response
+     * @param request The original request
+     * @param chunkData The chunk data
+     * @param context Additional response context
+     * @returns An oResponse instance with _last: false
+     */
+    buildChunk(request: oRequest, chunkData: any, context?: Partial<ResponseContext>): Promise<oResponse>;
+    /**
+     * Build the final chunk in a stream
+     * @param request The original request
+     * @param context Additional response context
+     * @returns An oResponse instance with _last: true
+     */
+    buildFinalChunk(request: oRequest, context?: Partial<ResponseContext>): Promise<oResponse>;
+    /**
+     * Build an error response
+     * @param request The original request
+     * @param error The error that occurred
+     * @param context Additional response context
+     * @returns An oResponse instance with error details
+     */
+    buildError(request: oRequest, error: any, context?: Partial<ResponseContext>): Promise<oResponse>;
+    /**
+     * Execute a function and automatically build a response based on the outcome
+     * @param request The request being executed
+     * @param executor The function to execute
+     * @param context Additional response context
+     * @returns An oResponse instance
+     */
+    execute(request: oRequest, executor: () => Promise<any>, context?: Partial<ResponseContext>): Promise<oResponse>;
+    /**
+     * Create a new ResponseBuilder instance (for chaining)
+     * @returns A new ResponseBuilder instance
+     */
+    static create(): ResponseBuilder;
+}
+//# sourceMappingURL=response-builder.d.ts.map

package/dist/src/response/response-builder.d.ts.map

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

package/dist/src/response/response-builder.js

@@ -0,0 +1,189 @@
+import { oResponse } from '../connection/o-response.js';
+import { oError } from '../error/o-error.js';
+import { oErrorCodes } from '../error/enums/codes.error.js';
+/**
+ * Default metrics tracker that increments counters
+ */
+export class DefaultMetricsTracker {
+    constructor(metrics) {
+        this.metrics = metrics;
+    }
+    trackSuccess(context) {
+        this.metrics.successCount++;
+    }
+    trackError(context, error) {
+        this.metrics.errorCount++;
+    }
+}
+/**
+ * ResponseBuilder - Unified response generation for all Olane routing paths
+ *
+ * This class provides a single source of truth for creating responses across:
+ * - Local execution (useSelf)
+ * - Remote execution (use, useChild)
+ * - Router forwarding (forward, executeSelfRouting)
+ * - Streaming responses
+ *
+ * Features:
+ * - Consistent error normalization
+ * - Automatic metrics tracking
+ * - Context-aware response building (streaming, success/error states)
+ * - Extensible middleware system
+ *
+ * @example
+ * ```typescript
+ * const builder = new ResponseBuilder()
+ *   .withMetrics(node.metrics)
+ *   .use(loggingMiddleware);
+ *
+ * const response = await builder.build(request, result, error);
+ * ```
+ */
+export class ResponseBuilder {
+    constructor() {
+        this.middlewares = [];
+    }
+    /**
+     * Add a middleware function to intercept responses
+     */
+    use(middleware) {
+        this.middlewares.push(middleware);
+        return this;
+    }
+    /**
+     * Configure metrics tracking
+     * @param metrics The metrics object to track success/error counts
+     */
+    withMetrics(metrics) {
+        this.metricsTracker = new DefaultMetricsTracker(metrics);
+        return this;
+    }
+    /**
+     * Configure custom metrics tracker
+     * @param tracker Custom metrics tracker implementation
+     */
+    withCustomMetrics(tracker) {
+        this.metricsTracker = tracker;
+        return this;
+    }
+    /**
+     * Normalize any error into an oError instance
+     * @param error The error to normalize
+     * @returns An oError instance
+     */
+    normalizeError(error) {
+        if (error instanceof oError) {
+            return error;
+        }
+        return new oError(oErrorCodes.UNKNOWN, error?.message || String(error), error?.stack);
+    }
+    /**
+     * Build a complete response from a request and result
+     * @param request The original request
+     * @param result The result data (or error object)
+     * @param error Optional error object
+     * @param context Additional response context
+     * @returns An oResponse instance
+     */
+    async build(request, result, error, context) {
+        const isError = !!error;
+        const success = !isError;
+        // Build context
+        const responseContext = {
+            isStream: context?.isStream ?? false,
+            isLast: context?.isLast ?? true,
+            success,
+            requestId: request.id,
+            connectionId: request.params?._connectionId,
+            requestMethod: request.method,
+            ...context,
+        };
+        // Create response
+        let response = new oResponse({
+            id: request.id,
+            data: result,
+            error: result?.error,
+            success,
+            _last: responseContext.isLast,
+            _requestMethod: String(responseContext.requestMethod || request.method || ''),
+            _connectionId: String(responseContext.connectionId || ''),
+        });
+        // Apply middleware
+        for (const middleware of this.middlewares) {
+            response = await middleware(response, responseContext);
+        }
+        // Track metrics
+        if (this.metricsTracker) {
+            if (success) {
+                this.metricsTracker.trackSuccess(responseContext);
+            }
+            else {
+                this.metricsTracker.trackError(responseContext, this.normalizeError(error));
+            }
+        }
+        return response;
+    }
+    /**
+     * Build a streaming chunk response
+     * @param request The original request
+     * @param chunkData The chunk data
+     * @param context Additional response context
+     * @returns An oResponse instance with _last: false
+     */
+    async buildChunk(request, chunkData, context) {
+        return this.build(request, chunkData, null, {
+            ...context,
+            isStream: true,
+            isLast: false,
+            success: true,
+        });
+    }
+    /**
+     * Build the final chunk in a stream
+     * @param request The original request
+     * @param context Additional response context
+     * @returns An oResponse instance with _last: true
+     */
+    async buildFinalChunk(request, context) {
+        return this.build(request, { success: true, response: 'Stream completed' }, null, {
+            ...context,
+            isStream: true,
+            isLast: true,
+            success: true,
+        });
+    }
+    /**
+     * Build an error response
+     * @param request The original request
+     * @param error The error that occurred
+     * @param context Additional response context
+     * @returns An oResponse instance with error details
+     */
+    async buildError(request, error, context) {
+        const normalizedError = this.normalizeError(error);
+        return this.build(request, { error: normalizedError.toJSON() }, normalizedError, context);
+    }
+    /**
+     * Execute a function and automatically build a response based on the outcome
+     * @param request The request being executed
+     * @param executor The function to execute
+     * @param context Additional response context
+     * @returns An oResponse instance
+     */
+    async execute(request, executor, context) {
+        try {
+            const result = await executor();
+            return await this.build(request, result, null, context);
+        }
+        catch (error) {
+            return await this.buildError(request, error, context);
+        }
+    }
+    /**
+     * Create a new ResponseBuilder instance (for chaining)
+     * @returns A new ResponseBuilder instance
+     */
+    static create() {
+        return new ResponseBuilder();
+    }
+}

package/dist/src/utils/core.utils.d.ts

@@ -3,7 +3,8 @@ import { oAddress } from '../router/o-address.js';
 import { oResponse } from '../connection/o-response.js';
 import { oRequest } from '../connection/o-request.js';
 import { CID } from 'multiformats';
-export declare class CoreUtils {
+import { oObject } from '../core/o-object.js';
+export declare class CoreUtils extends oObject {
     static generatePeerId(): Promise<any>;
     static doHealthCheck(address: oAddress, node: any): Promise<boolean>;
     static healthCheck(config: {
@@ -12,6 +13,21 @@ export declare class CoreUtils {
         node: any;
         timeout?: number;
     }): Promise<boolean>;
+    /**
+     * @deprecated Use ResponseBuilder.build() instead for consistent response generation with metrics tracking and error handling.
+     *
+     * Example migration:
+     * ```typescript
+     * // Old:
+     * const response = CoreUtils.buildResponse(request, result, error);
+     *
+     * // New:
+     * const responseBuilder = ResponseBuilder.create().withMetrics(node.metrics);
+     * const response = await responseBuilder.build(request, result, error);
+     * ```
+     *
+     * This method will be removed in a future major version.
+     */
     static buildResponse(request: oRequest, result: any, error: any): oResponse;
     static generatePrivateKey(seed: string): Promise<any>;
     /**

package/dist/src/utils/core.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/core.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,EAGP,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAInC,qBAAa,SAAS;WACP,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC;IAK3C,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;WAkBvD,WAAW,CAAC,MAAM,EAAE;QAC/B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;QACrC,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,IAAI,EAAE,GAAG,CAAC;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BpB,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS;WAe9D,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ3D;;;;;;OAMG;WACW,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;WAO7C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;WAOpC,YAAY,CACxB,aAAa,EAAE,QAAQ,EACvB,YAAY,EAAE,QAAQ,GACrB,QAAQ;WAIS,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;WAahD,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;WAQtD,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;WAMvC,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;WAKnD,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC;WAKrD,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CAMnD"}
+{"version":3,"file":"core.utils.d.ts","sourceRoot":"","sources":["../../../src/utils/core.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,MAAM,EAGP,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGnC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,qBAAa,SAAU,SAAQ,OAAO;WACvB,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC;IAK3C,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;WAkBvD,WAAW,CAAC,MAAM,EAAE;QAC/B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;QACrC,OAAO,CAAC,EAAE,QAAQ,CAAC;QACnB,IAAI,EAAE,GAAG,CAAC;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BpB;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS;WAgB9D,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAQ3D;;;;;;OAMG;WACW,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;WAO7C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;WAOpC,YAAY,CACxB,aAAa,EAAE,QAAQ,EACvB,YAAY,EAAE,QAAQ,GACrB,QAAQ;WAIS,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;WAahD,kBAAkB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM;WAYtD,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;WAMvC,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;WAKnD,qBAAqB,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC;WAKrD,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;CAMnD"}

package/dist/src/utils/core.utils.js

@@ -6,7 +6,8 @@ import { oRequest } from '../connection/o-request.js';
 import { CID } from 'multiformats';
 import * as json from 'multiformats/codecs/json';
 import { sha256 } from 'multiformats/hashes/sha2';
-export class CoreUtils {
+import { oObject } from '../core/o-object.js';
+export class CoreUtils extends oObject {
     static async generatePeerId() {
         const peerId = await createEd25519PeerId();
         return peerId;
@@ -46,6 +47,21 @@ export class CoreUtils {
         }
         throw new Error('Address is required');
     }
+    /**
+     * @deprecated Use ResponseBuilder.build() instead for consistent response generation with metrics tracking and error handling.
+     *
+     * Example migration:
+     * ```typescript
+     * // Old:
+     * const response = CoreUtils.buildResponse(request, result, error);
+     *
+     * // New:
+     * const responseBuilder = ResponseBuilder.create().withMetrics(node.metrics);
+     * const response = await responseBuilder.build(request, result, error);
+     * ```
+     *
+     * This method will be removed in a future major version.
+     */
     static buildResponse(request, result, error) {
         let success = true;
         if (error) {
@@ -56,6 +72,7 @@ export class CoreUtils {
             data: result,
             error: result?.error,
             ...{ success },
+            _last: true,
             _requestMethod: request.method,
             _connectionId: request.params?._connectionId,
         });
@@ -101,8 +118,10 @@ export class CoreUtils {
         }
     }
     static async sendStreamResponse(response, stream) {
-        if (stream.status !== 'open') {
-            throw new Error('Stream is not open');
+        const utils = new CoreUtils();
+        if (!stream || stream.status !== 'open') {
+            utils.logger.warn('Stream is not open. Status: ' + stream?.status || 'undefined');
+            return;
         }
         await stream.send(new TextEncoder().encode(response.toString()));
     }
@@ -116,7 +135,7 @@ export class CoreUtils {
     }
     static async processStreamResponse(event) {
         const res = await CoreUtils.processStream(event);
-        return new oResponse(res);
+        return res?.id ? oResponse.fromJSON(res) : new oResponse(res);
     }
     static async toCID(data) {
         const bytes = json.encode(data);

package/dist/src/utils/logger.d.ts

@@ -1,6 +1,7 @@
 export declare class Logger {
     private readonly name;
     private log;
+    private suffix;
     constructor(name: string);
     setNamespace(name: string): void;
     verbose(...args: any[]): void;

package/dist/src/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAGA,qBAAa,MAAM;IAGL,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,GAAG,CAAW;gBAEO,IAAI,EAAE,MAAM;IAIzC,YAAY,CAAC,IAAI,EAAE,MAAM;IAIzB,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAItB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAInB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAInB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;CAGrB"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAGA,qBAAa,MAAM;IAIL,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,MAAM,CAAc;gBAEC,IAAI,EAAE,MAAM;IAKzC,YAAY,CAAC,IAAI,EAAE,MAAM;IAIzB,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAItB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAInB,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAInB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;IAIpB,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;CAGrB"}

package/dist/src/utils/logger.js

@@ -3,7 +3,9 @@ import chalk from 'chalk';
 export class Logger {
     constructor(name) {
         this.name = name;
-        this.log = debug('olane-os:' + name);
+        this.suffix = '';
+        this.suffix = process.env.LOG_ID ? process.env.LOG_ID + ':' : '';
+        this.log = debug('olane-os:' + this.suffix + name);
     }
     setNamespace(name) {
         this.log = debug('olane-os:' + name);

package/package.json

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