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

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

@@ -0,0 +1,8 @@
+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';
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

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

package/dist/o-core/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/o-core/src/response/response-builder.d.ts.map

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

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

@@ -0,0 +1,190 @@
+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 ?? true,
+            _isStreaming: responseContext.isStream ?? false,
+            _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/o-core/src/router/enums/restricted-addresses.enum.d.ts

@@ -0,0 +1,8 @@
+export declare enum RestrictedAddresses {
+    REGISTRY = "o://registry",
+    LEADER = "o://leader",
+    LANE = "o://lane",
+    INTELLIGENCE = "o://intelligence"
+}
+export declare const RestrictedAddressesList: RestrictedAddresses[];
+//# sourceMappingURL=restricted-addresses.enum.d.ts.map

package/dist/o-core/src/router/enums/restricted-addresses.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restricted-addresses.enum.d.ts","sourceRoot":"","sources":["../../../../../../o-core/src/router/enums/restricted-addresses.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,mBAAmB;IAC7B,QAAQ,iBAAiB;IACzB,MAAM,eAAe;IACrB,IAAI,aAAa;IACjB,YAAY,qBAAqB;CAClC;AAED,eAAO,MAAM,uBAAuB,uBAKnC,CAAC"}

package/dist/o-core/src/router/enums/restricted-addresses.enum.js

@@ -0,0 +1,13 @@
+export var RestrictedAddresses;
+(function (RestrictedAddresses) {
+    RestrictedAddresses["REGISTRY"] = "o://registry";
+    RestrictedAddresses["LEADER"] = "o://leader";
+    RestrictedAddresses["LANE"] = "o://lane";
+    RestrictedAddresses["INTELLIGENCE"] = "o://intelligence";
+})(RestrictedAddresses || (RestrictedAddresses = {}));
+export const RestrictedAddressesList = [
+    RestrictedAddresses.REGISTRY,
+    RestrictedAddresses.LEADER,
+    RestrictedAddresses.LANE,
+    RestrictedAddresses.INTELLIGENCE,
+];

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

@@ -0,0 +1,11 @@
+export * from './o-router.js';
+export * from './o-address.js';
+export * from './interfaces/route.response.js';
+export * from './enums/restricted-addresses.enum.js';
+export * from './o-resolver-chain.js';
+export * from './o-address-resolver.js';
+export * from './o-routing-policy.js';
+export * from './o-request-preparation.js';
+export * from './interfaces/resolve.request.js';
+export * from './o-request.router.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/router/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sCAAsC,CAAC;AACrD,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,uBAAuB,CAAC"}

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

@@ -0,0 +1,10 @@
+export * from './o-router.js';
+export * from './o-address.js';
+export * from './interfaces/route.response.js';
+export * from './enums/restricted-addresses.enum.js';
+export * from './o-resolver-chain.js';
+export * from './o-address-resolver.js';
+export * from './o-routing-policy.js';
+export * from './o-request-preparation.js';
+export * from './interfaces/resolve.request.js';
+export * from './o-request.router.js';

package/dist/o-core/src/router/interfaces/resolve.request.d.ts

@@ -0,0 +1,10 @@
+import { oCore } from '../../core/o-core.js';
+import { oAddress } from '../o-address.js';
+import { oRouterRequest } from '../o-request.router.js';
+export interface ResolveRequest {
+    address: oAddress;
+    targetAddress: oAddress;
+    node: oCore;
+    request?: oRouterRequest;
+}
+//# sourceMappingURL=resolve.request.d.ts.map

package/dist/o-core/src/router/interfaces/resolve.request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.request.d.ts","sourceRoot":"","sources":["../../../../../../o-core/src/router/interfaces/resolve.request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,QAAQ,CAAC;IAClB,aAAa,EAAE,QAAQ,CAAC;IACxB,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B"}

package/dist/o-core/src/router/interfaces/resolve.request.js

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

package/dist/o-core/src/router/interfaces/route.response.d.ts

@@ -0,0 +1,8 @@
+import { oAddress } from '../o-address.js';
+import { oRouterRequest } from '../o-request.router.js';
+export interface RouteResponse {
+    nextHopAddress: oAddress;
+    targetAddress: oAddress;
+    requestOverride?: oRouterRequest;
+}
+//# sourceMappingURL=route.response.d.ts.map

package/dist/o-core/src/router/interfaces/route.response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.response.d.ts","sourceRoot":"","sources":["../../../../../../o-core/src/router/interfaces/route.response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,QAAQ,CAAC;IACzB,aAAa,EAAE,QAAQ,CAAC;IACxB,eAAe,CAAC,EAAE,cAAc,CAAC;CAClC"}

package/dist/o-core/src/router/interfaces/route.response.js

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

package/dist/o-core/src/router/o-address-resolver.d.ts

@@ -0,0 +1,14 @@
+import { oAddress } from './o-address.js';
+import { oObject } from '../core/o-object.js';
+import { oTransport } from '../transports/o-transport.js';
+import { TransportType } from '../transports/interfaces/transport-type.enum.js';
+import { RouteResponse } from './interfaces/route.response.js';
+import { ResolveRequest } from './interfaces/resolve.request.js';
+export declare abstract class oAddressResolver extends oObject {
+    protected readonly address: oAddress;
+    constructor(address: oAddress);
+    get customTransports(): oTransport[];
+    get transportTypes(): TransportType[];
+    resolve(request: ResolveRequest): Promise<RouteResponse>;
+}
+//# sourceMappingURL=o-address-resolver.d.ts.map

package/dist/o-core/src/router/o-address-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-address-resolver.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/router/o-address-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,8BAAsB,gBAAiB,SAAQ,OAAO;IACxC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ;gBAAjB,OAAO,EAAE,QAAQ;IAIhD,IAAI,gBAAgB,IAAI,UAAU,EAAE,CAEnC;IAED,IAAI,cAAc,IAAI,aAAa,EAAE,CAEpC;IAEK,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAM/D"}

package/dist/o-core/src/router/o-address-resolver.js

@@ -0,0 +1,19 @@
+import { oObject } from '../core/o-object.js';
+export class oAddressResolver extends oObject {
+    constructor(address) {
+        super();
+        this.address = address;
+    }
+    get customTransports() {
+        return [];
+    }
+    get transportTypes() {
+        return this.customTransports.map((transport) => transport.type);
+    }
+    async resolve(request) {
+        return {
+            nextHopAddress: request.address,
+            targetAddress: request.address,
+        };
+    }
+}

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

@@ -0,0 +1,33 @@
+import { CID } from 'multiformats';
+import { oObject } from '../core/o-object.js';
+import { oTransport } from '../transports/o-transport.js';
+export declare class oAddress extends oObject {
+    readonly value: string;
+    transports: oTransport[];
+    constructor(value: string, transports?: oTransport[]);
+    get libp2pTransports(): oTransport[];
+    get customTransports(): oTransport[];
+    equals(other: oAddress): boolean;
+    transportsEqual(other: oAddress): boolean;
+    setTransports(transports: oTransport[]): void;
+    validate(): boolean;
+    get paths(): string;
+    get protocol(): string;
+    get root(): string;
+    toStaticAddress(): oAddress;
+    toRootAddress(): oAddress;
+    toString(): string;
+    toJSON(): {
+        value: string;
+        transports: string[];
+    };
+    supportsTransport(transport: oTransport): boolean;
+    toCID(): Promise<CID>;
+    static equals(a: oAddress, b: oAddress): boolean;
+    static leader(): oAddress;
+    static lane(): oAddress;
+    static registry(): oAddress;
+    static isStatic(address: oAddress): boolean;
+    static next(address: oAddress, targetAddress: oAddress): oAddress;
+}
+//# sourceMappingURL=o-address.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"o-address.d.ts","sourceRoot":"","sources":["../../../../../o-core/src/router/o-address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI1D,qBAAa,QAAS,SAAQ,OAAO;aAIjB,KAAK,EAAE,MAAM;IAHxB,UAAU,EAAE,UAAU,EAAE,CAAC;gBAGd,KAAK,EAAE,MAAM,EAC7B,UAAU,GAAE,UAAU,EAAO;IAM/B,IAAI,gBAAgB,IAAI,UAAU,EAAE,CAEnC;IAED,IAAI,gBAAgB,IAAI,UAAU,EAAE,CAEnC;IAED,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAIhC,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAMzC,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,IAAI;IAI7C,QAAQ,IAAI,OAAO;IAOnB,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,eAAe,IAAI,QAAQ;IAQ3B,aAAa,IAAI,QAAQ;IAQzB,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI;QACR,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB;IAOD,iBAAiB,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO;IAI3C,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC;IAI3B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO;IAIhD,MAAM,CAAC,MAAM,IAAI,QAAQ;IAIzB,MAAM,CAAC,IAAI,IAAI,QAAQ;IAIvB,MAAM,CAAC,QAAQ,IAAI,QAAQ;IAI3B,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAI3C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,GAAG,QAAQ;CAkClE"}

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

@@ -0,0 +1,114 @@
+import { oObject } from '../core/o-object.js';
+import { TransportType } from '../transports/index.js';
+import { CoreUtils } from '../utils/core.utils.js';
+import { RestrictedAddresses } from './enums/restricted-addresses.enum.js';
+export class oAddress extends oObject {
+    constructor(value, transports = []) {
+        super(value);
+        this.value = value;
+        this.transports = transports;
+    }
+    get libp2pTransports() {
+        return this.transports.filter((t) => t.type === TransportType.LIBP2P) || [];
+    }
+    get customTransports() {
+        return this.transports.filter((t) => t.type === TransportType.CUSTOM) || [];
+    }
+    equals(other) {
+        return this.value === other.value && this.transportsEqual(other);
+    }
+    transportsEqual(other) {
+        return this.transports.every((t) => other.transports.some((t2) => t.toString() === t2.toString()));
+    }
+    setTransports(transports) {
+        this.transports = transports;
+    }
+    validate() {
+        if (!this.value?.startsWith('o://')) {
+            return false;
+        }
+        return true;
+    }
+    get paths() {
+        return this.value.replace('o://', '');
+    }
+    get protocol() {
+        return this.value.replace('o://', '/o/');
+    }
+    get root() {
+        return 'o://' + this.paths.split('/')[0];
+    }
+    toStaticAddress() {
+        const paths = this.paths.split('/');
+        if (paths.length === 0) {
+            return this;
+        }
+        return new oAddress(`o://${paths[paths.length - 1]}`, this.transports);
+    }
+    toRootAddress() {
+        const paths = this.paths.split('/');
+        if (paths.length === 0) {
+            return this;
+        }
+        return new oAddress(`o://${paths[0]}`);
+    }
+    toString() {
+        return this.value;
+    }
+    toJSON() {
+        return {
+            value: this.value,
+            transports: this.transports.map((t) => t.toString()),
+        };
+    }
+    supportsTransport(transport) {
+        return this.transports.some((t) => t.type === transport.type);
+    }
+    async toCID() {
+        return await CoreUtils.toCID({ address: this.toString() });
+    }
+    static equals(a, b) {
+        return a.value === b.value;
+    }
+    static leader() {
+        return new oAddress(RestrictedAddresses.LEADER);
+    }
+    static lane() {
+        return new oAddress(RestrictedAddresses.LANE);
+    }
+    static registry() {
+        return new oAddress(RestrictedAddresses.REGISTRY);
+    }
+    static isStatic(address) {
+        return address.value.startsWith(RestrictedAddresses.LEADER) === false;
+    }
+    static next(address, targetAddress) {
+        const remainingPath = targetAddress.protocol.replace(address.protocol + '/', '');
+        // we are at the destination
+        if (remainingPath === '') {
+            return address;
+        }
+        // if remainingPath equals targetAddress.protocol, the replace didn't match
+        // this means we're either at destination (addresses are equal) or on different branch
+        if (remainingPath === targetAddress.protocol) {
+            // check if we're actually at the destination
+            if (address.value === targetAddress.value) {
+                return address;
+            }
+            // we're on a different branch, need to go back to leader for resolution
+            if (!address.equals(oAddress.leader())) {
+                return oAddress.leader();
+            }
+            // we ARE the leader, and we can't make progress - stay at leader for resolution
+            return address;
+        }
+        // do we need to go back to the leader?
+        if (!address.equals(oAddress.leader()) && // if we are a leader, do not got back to self
+            oAddress.isStatic(targetAddress)) {
+            return oAddress.leader();
+        }
+        // we need to go to the child address
+        const nextHop = remainingPath.replace('/o/', '').split('/').reverse().pop();
+        return new oAddress(address.value + '/' + nextHop);
+    }
+}