@psavelis/enterprise-blockchain 0.1.0 → 1.1.1

package/dist/integrations/fabric-gateway/index.d.ts

@@ -0,0 +1,78 @@
+import grpc from "@grpc/grpc-js";
+import { type Contract, type Gateway, type Identity, type Signer } from "@hyperledger/fabric-gateway";
+import { type CircuitBreakerOptions } from "../shared/retry.js";
+import type { FabricGatewayProfile, FabricProposalPlan, IFabricConnectionFactory, IFabricGatewayFactory, IFabricProfileFactory, IFabricProposalBuilder } from "./ports.js";
+export type { FabricGatewayProfile, FabricProposalPlan } from "./ports.js";
+export declare class FabricProfileFactory implements IFabricProfileFactory {
+    createProfileFromEnv(env?: NodeJS.ProcessEnv): FabricGatewayProfile;
+    createProfile(profile: FabricGatewayProfile): FabricGatewayProfile;
+}
+export declare class FabricConnectionFactory implements IFabricConnectionFactory {
+    createGrpcClient(profile: FabricGatewayProfile): Promise<grpc.Client>;
+    createIdentity(profile: FabricGatewayProfile): Promise<Identity>;
+    createSigner(profile: FabricGatewayProfile): Promise<Signer>;
+}
+export declare class FabricGatewayFactory implements IFabricGatewayFactory {
+    private readonly connectionFactory;
+    constructor(connectionFactory: IFabricConnectionFactory);
+    createGateway(profile: FabricGatewayProfile): Promise<{
+        gateway: Gateway;
+        client: grpc.Client;
+    }>;
+    getContract(gateway: Gateway, profile: FabricGatewayProfile): Contract;
+}
+export declare class FabricProposalBuilder implements IFabricProposalBuilder {
+    buildRecordShipmentProposal(input: {
+        lotId: string;
+        shipmentId: string;
+        temperatureCelsius: number;
+        location: string;
+        telemetryTimestamp: string;
+        endorsingOrganizations: string[];
+    }): FabricProposalPlan;
+    buildEvaluateRecallRequest(input: {
+        lotId: string;
+        reason: string;
+    }): FabricProposalPlan;
+}
+/**
+ * Resilient Fabric gateway client with circuit breaker and retry support.
+ *
+ * Circuit breaker prevents cascading failures when Fabric peer is unavailable.
+ * Retry policy handles transient gRPC errors (UNAVAILABLE, DEADLINE_EXCEEDED).
+ */
+export declare class FabricGatewayClientSketch implements IFabricProfileFactory, IFabricConnectionFactory, IFabricGatewayFactory, IFabricProposalBuilder {
+    private readonly profileFactory;
+    private readonly connectionFactory;
+    private readonly gatewayFactory;
+    private readonly proposalBuilder;
+    private readonly circuitBreaker;
+    constructor(circuitBreakerOptions?: Partial<CircuitBreakerOptions>);
+    createProfileFromEnv(env?: NodeJS.ProcessEnv): FabricGatewayProfile;
+    createProfile(profile: FabricGatewayProfile): FabricGatewayProfile;
+    createGrpcClient(profile: FabricGatewayProfile): Promise<grpc.Client>;
+    createIdentity(profile: FabricGatewayProfile): Promise<Identity>;
+    createSigner(profile: FabricGatewayProfile): Promise<Signer>;
+    createGateway(profile: FabricGatewayProfile): Promise<{
+        gateway: Gateway;
+        client: grpc.Client;
+    }>;
+    getContract(gateway: Gateway, profile: FabricGatewayProfile): Contract;
+    buildRecordShipmentProposal(input: {
+        lotId: string;
+        shipmentId: string;
+        temperatureCelsius: number;
+        location: string;
+        telemetryTimestamp: string;
+        endorsingOrganizations: string[];
+    }): FabricProposalPlan;
+    buildEvaluateRecallRequest(input: {
+        lotId: string;
+        reason: string;
+    }): FabricProposalPlan;
+    /** Get circuit breaker state for monitoring dashboards. */
+    getCircuitBreakerHealth(): import("../shared/retry.js").CircuitBreakerHealth;
+    /** Reset circuit breaker (use after resolving underlying issues). */
+    resetCircuitBreaker(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/fabric-gateway/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/fabric-gateway/index.ts"],"names":[],"mappings":"AAGA,OAAO,IAAI,MAAM,eAAe,CAAC;AACjC,OAAO,EAKL,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,MAAM,EACZ,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,oBAAoB,CAAC;AAM5B,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAIpB,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE3E,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE,oBAAoB,CAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,oBAAoB;IAmBvB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB;CAQnE;AAED,qBAAa,uBAAwB,YAAW,wBAAwB;IAChE,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IAmBrE,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAUhE,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;CAOnE;AAED,qBAAa,oBAAqB,YAAW,qBAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBAAjB,iBAAiB,EAAE,wBAAwB;IAElE,aAAa,CACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAA;KAAE,CAAC;IA8BrD,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,GAAG,QAAQ;CAIvE;AAED,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,2BAA2B,CAAC,KAAK,EAAE;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,sBAAsB,EAAE,MAAM,EAAE,CAAC;KAClC,GAAG,kBAAkB;IAqBtB,0BAA0B,CAAC,KAAK,EAAE;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,kBAAkB;CAevB;AAED;;;;;GAKG;AACH,qBAAa,yBACX,YACE,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB;IAExB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAiC;IACnE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE7B;IACF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA+B;IAC/D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;gBAEpC,qBAAqB,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAOlE,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,oBAAoB;IAInE,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB;IAIlE,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;IAIrE,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIhE,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAI5D,aAAa,CACX,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAA;KAAE,CAAC;IAYrD,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,GAAG,QAAQ;IAItE,2BAA2B,CAAC,KAAK,EAAE;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,sBAAsB,EAAE,MAAM,EAAE,CAAC;KAClC,GAAG,kBAAkB;IAItB,0BAA0B,CAAC,KAAK,EAAE;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,kBAAkB;IAItB,2DAA2D;IAC3D,uBAAuB;IAIvB,qEAAqE;IACrE,mBAAmB,IAAI,IAAI;CAG5B"}

package/dist/integrations/fabric-gateway/index.js

@@ -0,0 +1,214 @@
+import { createPrivateKey } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import grpc from "@grpc/grpc-js";
+import { connect, hash, signers, } from "@hyperledger/fabric-gateway";
+import { getOptionalEnv, getRequiredEnv } from "../shared/env.js";
+import { CircuitBreaker, FABRIC_RETRY_POLICY, withRetry, } from "../shared/retry.js";
+import { createTracer, withSpan, TelemetryAttributes, } from "../../shared/telemetry.js";
+const tracer = createTracer("fabric-gateway");
+export class FabricProfileFactory {
+    createProfileFromEnv(env = process.env) {
+        const profile = {
+            mspId: getRequiredEnv("FABRIC_MSP_ID", env),
+            channelName: getRequiredEnv("FABRIC_CHANNEL_NAME", env),
+            chaincodeName: getRequiredEnv("FABRIC_CHAINCODE_NAME", env),
+            peerEndpoint: getRequiredEnv("FABRIC_PEER_ENDPOINT", env),
+            tlsCertPath: getRequiredEnv("FABRIC_TLS_CERT_PATH", env),
+            identityCertPath: getRequiredEnv("FABRIC_IDENTITY_CERT_PATH", env),
+            privateKeyPath: getRequiredEnv("FABRIC_PRIVATE_KEY_PATH", env),
+        };
+        const peerHostAlias = getOptionalEnv("FABRIC_PEER_HOST_ALIAS", env);
+        if (peerHostAlias) {
+            profile.peerHostAlias = peerHostAlias;
+        }
+        return profile;
+    }
+    createProfile(profile) {
+        if (!profile.peerEndpoint.includes(":")) {
+            throw new Error("FabricGatewayProfile.peerEndpoint must be in host:port format");
+        }
+        return profile;
+    }
+}
+export class FabricConnectionFactory {
+    async createGrpcClient(profile) {
+        return withSpan(tracer, "fabric.createGrpcClient", async (span) => {
+            span.setAttribute(TelemetryAttributes.BLOCKCHAIN_PLATFORM, "fabric");
+            span.setAttribute("fabric.peer_endpoint", profile.peerEndpoint);
+            const tlsRootCert = await readFile(profile.tlsCertPath);
+            const credentials = grpc.credentials.createSsl(tlsRootCert);
+            const options = {};
+            if (profile.peerHostAlias) {
+                options["grpc.ssl_target_name_override"] = profile.peerHostAlias;
+                options["grpc.default_authority"] = profile.peerHostAlias;
+                span.setAttribute("fabric.peer_host_alias", profile.peerHostAlias);
+            }
+            return new grpc.Client(profile.peerEndpoint, credentials, options);
+        });
+    }
+    async createIdentity(profile) {
+        return withSpan(tracer, "fabric.createIdentity", async (span) => {
+            span.setAttribute("fabric.msp_id", profile.mspId);
+            return {
+                mspId: profile.mspId,
+                credentials: await readFile(profile.identityCertPath),
+            };
+        });
+    }
+    async createSigner(profile) {
+        return withSpan(tracer, "fabric.createSigner", async () => {
+            const privateKeyPem = await readFile(profile.privateKeyPath);
+            const privateKey = createPrivateKey(privateKeyPem);
+            return signers.newPrivateKeySigner(privateKey);
+        });
+    }
+}
+export class FabricGatewayFactory {
+    connectionFactory;
+    constructor(connectionFactory) {
+        this.connectionFactory = connectionFactory;
+    }
+    async createGateway(profile) {
+        return withSpan(tracer, "fabric.createGateway", async (span) => {
+            span.setAttribute(TelemetryAttributes.BLOCKCHAIN_PLATFORM, "fabric");
+            span.setAttribute(TelemetryAttributes.BLOCKCHAIN_CHANNEL, profile.channelName);
+            span.setAttribute(TelemetryAttributes.BLOCKCHAIN_CHAINCODE, profile.chaincodeName);
+            const client = await this.connectionFactory.createGrpcClient(profile);
+            const identity = await this.connectionFactory.createIdentity(profile);
+            const signer = await this.connectionFactory.createSigner(profile);
+            const options = {
+                client,
+                identity,
+                signer,
+                hash: hash.sha256,
+            };
+            return {
+                gateway: connect(options),
+                client,
+            };
+        });
+    }
+    getContract(gateway, profile) {
+        const network = gateway.getNetwork(profile.channelName);
+        return network.getContract(profile.chaincodeName);
+    }
+}
+export class FabricProposalBuilder {
+    buildRecordShipmentProposal(input) {
+        const payload = JSON.stringify(input);
+        return {
+            transactionName: "RecordShipment",
+            args: [
+                input.lotId,
+                input.shipmentId,
+                String(input.temperatureCelsius),
+                input.location,
+            ],
+            transientData: {
+                telemetryTimestamp: Buffer.from(input.telemetryTimestamp, "utf8"),
+            },
+            endorsingOrganizations: input.endorsingOrganizations,
+            payloadDigestHex: Buffer.from(hash.sha256(Buffer.from(payload, "utf8"))).toString("hex"),
+        };
+    }
+    buildEvaluateRecallRequest(input) {
+        const args = [input.lotId];
+        const transientData = {
+            recallReason: Buffer.from(input.reason, "utf8"),
+        };
+        return {
+            transactionName: "TraceOrigin",
+            args,
+            transientData,
+            endorsingOrganizations: ["RetailerMSP", "SupplierMSP"],
+            payloadDigestHex: Buffer.from(hash.sha256(Buffer.from(JSON.stringify(input), "utf8"))).toString("hex"),
+        };
+    }
+}
+/**
+ * Resilient Fabric gateway client with circuit breaker and retry support.
+ *
+ * Circuit breaker prevents cascading failures when Fabric peer is unavailable.
+ * Retry policy handles transient gRPC errors (UNAVAILABLE, DEADLINE_EXCEEDED).
+ */
+export class FabricGatewayClientSketch {
+    profileFactory = new FabricProfileFactory();
+    connectionFactory = new FabricConnectionFactory();
+    gatewayFactory = new FabricGatewayFactory(this.connectionFactory);
+    proposalBuilder = new FabricProposalBuilder();
+    circuitBreaker;
+    constructor(circuitBreakerOptions) {
+        this.circuitBreaker = new CircuitBreaker(circuitBreakerOptions, "fabric-gateway");
+    }
+    createProfileFromEnv(env) {
+        return this.profileFactory.createProfileFromEnv(env);
+    }
+    createProfile(profile) {
+        return this.profileFactory.createProfile(profile);
+    }
+    createGrpcClient(profile) {
+        return this.connectionFactory.createGrpcClient(profile);
+    }
+    createIdentity(profile) {
+        return this.connectionFactory.createIdentity(profile);
+    }
+    createSigner(profile) {
+        return this.connectionFactory.createSigner(profile);
+    }
+    createGateway(profile) {
+        return this.circuitBreaker.execute(() => withRetry(() => this.gatewayFactory.createGateway(profile), FABRIC_RETRY_POLICY, [], extractGrpcErrorCode, "fabric.createGateway"));
+    }
+    getContract(gateway, profile) {
+        return this.gatewayFactory.getContract(gateway, profile);
+    }
+    buildRecordShipmentProposal(input) {
+        return this.proposalBuilder.buildRecordShipmentProposal(input);
+    }
+    buildEvaluateRecallRequest(input) {
+        return this.proposalBuilder.buildEvaluateRecallRequest(input);
+    }
+    /** Get circuit breaker state for monitoring dashboards. */
+    getCircuitBreakerHealth() {
+        return this.circuitBreaker.getHealthStatus();
+    }
+    /** Reset circuit breaker (use after resolving underlying issues). */
+    resetCircuitBreaker() {
+        this.circuitBreaker.reset();
+    }
+}
+/**
+ * Extract gRPC error codes for retry policy decisions.
+ * Maps gRPC status codes to string names.
+ */
+function extractGrpcErrorCode(err) {
+    if (err && typeof err === "object") {
+        const e = err;
+        // gRPC-js ServiceError has numeric code
+        if (typeof e.code === "number") {
+            // Map gRPC status codes: https://grpc.io/docs/guides/status-codes/
+            const grpcCodeMap = {
+                0: "OK",
+                1: "CANCELLED",
+                2: "UNKNOWN",
+                3: "INVALID_ARGUMENT",
+                4: "DEADLINE_EXCEEDED",
+                5: "NOT_FOUND",
+                6: "ALREADY_EXISTS",
+                7: "PERMISSION_DENIED",
+                8: "RESOURCE_EXHAUSTED",
+                9: "FAILED_PRECONDITION",
+                10: "ABORTED",
+                11: "OUT_OF_RANGE",
+                12: "UNIMPLEMENTED",
+                13: "INTERNAL",
+                14: "UNAVAILABLE",
+                15: "DATA_LOSS",
+                16: "UNAUTHENTICATED",
+            };
+            return grpcCodeMap[e.code] ?? "UNKNOWN";
+        }
+        if (typeof e.code === "string")
+            return e.code.toUpperCase();
+    }
+    return "UNKNOWN";
+}

package/dist/integrations/fabric-gateway/ports.d.ts

@@ -0,0 +1,50 @@
+import type { Client as GrpcClient } from "@grpc/grpc-js";
+import type { Contract, Gateway, Identity, Signer } from "@hyperledger/fabric-gateway";
+export interface FabricGatewayProfile {
+    mspId: string;
+    channelName: string;
+    chaincodeName: string;
+    peerEndpoint: string;
+    peerHostAlias?: string;
+    tlsCertPath: string;
+    identityCertPath: string;
+    privateKeyPath: string;
+}
+export interface FabricProposalPlan {
+    transactionName: string;
+    args: string[];
+    transientData?: Record<string, Uint8Array>;
+    endorsingOrganizations: string[];
+    payloadDigestHex: string;
+}
+export interface IFabricProfileFactory {
+    createProfileFromEnv(env?: NodeJS.ProcessEnv): FabricGatewayProfile;
+    createProfile(profile: FabricGatewayProfile): FabricGatewayProfile;
+}
+export interface IFabricConnectionFactory {
+    createGrpcClient(profile: FabricGatewayProfile): Promise<GrpcClient>;
+    createIdentity(profile: FabricGatewayProfile): Promise<Identity>;
+    createSigner(profile: FabricGatewayProfile): Promise<Signer>;
+}
+export interface IFabricGatewayFactory {
+    createGateway(profile: FabricGatewayProfile): Promise<{
+        gateway: Gateway;
+        client: GrpcClient;
+    }>;
+    getContract(gateway: Gateway, profile: FabricGatewayProfile): Contract;
+}
+export interface IFabricProposalBuilder {
+    buildRecordShipmentProposal(input: {
+        lotId: string;
+        shipmentId: string;
+        temperatureCelsius: number;
+        location: string;
+        telemetryTimestamp: string;
+        endorsingOrganizations: string[];
+    }): FabricProposalPlan;
+    buildEvaluateRecallRequest(input: {
+        lotId: string;
+        reason: string;
+    }): FabricProposalPlan;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/integrations/fabric-gateway/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/integrations/fabric-gateway/ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EACV,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,MAAM,EACP,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC3C,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,oBAAoB,CAAC;IACpE,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,oBAAoB,CAAC;CACpE;AAED,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrE,cAAc,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjE,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CACX,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IACrD,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,oBAAoB,GAAG,QAAQ,CAAC;CACxE;AAED,MAAM,WAAW,sBAAsB;IACrC,2BAA2B,CAAC,KAAK,EAAE;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,sBAAsB,EAAE,MAAM,EAAE,CAAC;KAClC,GAAG,kBAAkB,CAAC;IAEvB,0BAA0B,CAAC,KAAK,EAAE;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,kBAAkB,CAAC;CACxB"}

package/dist/integrations/fabric-gateway/ports.js

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

package/dist/integrations/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Integration clients for enterprise blockchain platforms.
+ *
+ * Provides SDK-based clients for:
+ * - Hyperledger Fabric (via @hyperledger/fabric-gateway)
+ * - Hyperledger Besu (via ethers.js)
+ * - R3 Corda (via REST gateway)
+ *
+ * Each client includes circuit breaker and retry patterns for resilience.
+ */
+export { FabricProfileFactory, FabricConnectionFactory, FabricGatewayFactory, FabricProposalBuilder, FabricGatewayClientSketch, type FabricGatewayProfile, type FabricProposalPlan, } from "./fabric-gateway/index.js";
+export type { IFabricProfileFactory, IFabricConnectionFactory, IFabricGatewayFactory, IFabricProposalBuilder, } from "./fabric-gateway/ports.js";
+export { BesuProfileFactory, BesuProviderFactory, BesuGasEstimator, BesuTransactionBuilder, BesuTransactionSender, BesuHealthChecker, BesuEthersClientSketch, type BesuRpcProfile, type BesuPrivateTransactionRequest, type BesuHealthStatus, } from "./besu-client/index.js";
+export type { IBesuProfileFactory, IBesuProviderFactory, IBesuGasEstimator, IBesuTransactionBuilder, IBesuTransactionSender, IBesuHealthChecker, } from "./besu-client/ports.js";
+export { CordaProfileFactory, CordaRequestBuilder, CordaFlowInvoker, CordaGatewayClientSketch, type CordaGatewayProfile, type CordaGatewayRequest, type ProviderClearancePayload, } from "./corda-gateway/index.js";
+export type { ICordaProfileFactory, ICordaRequestBuilder, ICordaFlowInvoker, } from "./corda-gateway/ports.js";
+export { CircuitBreaker, withRetry, FABRIC_RETRY_POLICY, BESU_RETRY_POLICY, BESU_NON_RETRYABLE, CORDA_RETRY_POLICY, CORDA_NON_RETRYABLE, type CircuitBreakerOptions, type RetryPolicy, } from "./shared/retry.js";
+export { getRequiredEnv, getOptionalEnv, getNumberEnv } from "./shared/env.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,6BAA6B,EAClC,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,wBAAwB,EACxB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,GAC9B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/integrations/index.js

@@ -0,0 +1,19 @@
+/**
+ * Integration clients for enterprise blockchain platforms.
+ *
+ * Provides SDK-based clients for:
+ * - Hyperledger Fabric (via @hyperledger/fabric-gateway)
+ * - Hyperledger Besu (via ethers.js)
+ * - R3 Corda (via REST gateway)
+ *
+ * Each client includes circuit breaker and retry patterns for resilience.
+ */
+// Fabric Gateway
+export { FabricProfileFactory, FabricConnectionFactory, FabricGatewayFactory, FabricProposalBuilder, FabricGatewayClientSketch, } from "./fabric-gateway/index.js";
+// Besu Client
+export { BesuProfileFactory, BesuProviderFactory, BesuGasEstimator, BesuTransactionBuilder, BesuTransactionSender, BesuHealthChecker, BesuEthersClientSketch, } from "./besu-client/index.js";
+// Corda Gateway
+export { CordaProfileFactory, CordaRequestBuilder, CordaFlowInvoker, CordaGatewayClientSketch, } from "./corda-gateway/index.js";
+// Shared utilities
+export { CircuitBreaker, withRetry, FABRIC_RETRY_POLICY, BESU_RETRY_POLICY, BESU_NON_RETRYABLE, CORDA_RETRY_POLICY, CORDA_NON_RETRYABLE, } from "./shared/retry.js";
+export { getRequiredEnv, getOptionalEnv, getNumberEnv } from "./shared/env.js";

package/dist/integrations/shared/env.d.ts

@@ -0,0 +1,4 @@
+export declare function getRequiredEnv(name: string, env?: NodeJS.ProcessEnv): string;
+export declare function getOptionalEnv(name: string, env?: NodeJS.ProcessEnv): string | undefined;
+export declare function getNumberEnv(name: string, fallback?: number, env?: NodeJS.ProcessEnv): number;
+//# sourceMappingURL=env.d.ts.map

package/dist/integrations/shared/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/integrations/shared/env.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAOR;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,EACjB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,CAgBR"}

package/dist/integrations/shared/env.js

@@ -0,0 +1,24 @@
+export function getRequiredEnv(name, env = process.env) {
+    const value = env[name];
+    if (value === undefined) {
+        throw new Error(`Missing required environment variable: ${name}`);
+    }
+    return value;
+}
+export function getOptionalEnv(name, env = process.env) {
+    return env[name];
+}
+export function getNumberEnv(name, fallback, env = process.env) {
+    const value = env[name];
+    if (value === undefined) {
+        if (fallback === undefined) {
+            throw new Error(`Missing required numeric environment variable: ${name}`);
+        }
+        return fallback;
+    }
+    const parsed = Number(value);
+    if (Number.isNaN(parsed)) {
+        throw new Error(`Invalid numeric environment variable: ${name}`);
+    }
+    return parsed;
+}

package/dist/integrations/shared/retry.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Shared retry policy and circuit breaker for integration adapters.
+ *
+ * Each platform adapter configures which error codes are retryable:
+ * - Fabric: UNAVAILABLE, DEADLINE_EXCEEDED gRPC status codes
+ * - Besu: SERVER_ERROR, TIMEOUT JSON-RPC errors (not NONCE_TOO_LOW)
+ * - Corda: HTTP 502/503/504 (not 400/401/403)
+ *
+ * OpenTelemetry instrumentation:
+ * - withRetry() creates spans per attempt with error code attributes
+ * - CircuitBreaker emits state transition metrics
+ */
+export interface RetryPolicy {
+    maxAttempts: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    retryableErrors: string[];
+}
+export declare const DEFAULT_RETRY_POLICY: RetryPolicy;
+export declare const FABRIC_RETRY_POLICY: RetryPolicy;
+export declare const BESU_RETRY_POLICY: RetryPolicy;
+/** Non-retryable Besu errors (fail immediately). */
+export declare const BESU_NON_RETRYABLE: string[];
+export declare const CORDA_RETRY_POLICY: RetryPolicy;
+/** Non-retryable Corda HTTP status codes. */
+export declare const CORDA_NON_RETRYABLE: string[];
+export declare function isRetryable(errorCode: string, policy: RetryPolicy, nonRetryable?: string[]): boolean;
+export declare function computeDelay(attempt: number, policy: RetryPolicy): number;
+export declare function withRetry<T>(fn: () => Promise<T>, policy: RetryPolicy, nonRetryable?: string[], extractErrorCode?: (err: unknown) => string, operationName?: string): Promise<T>;
+export type CircuitState = "closed" | "open" | "half-open";
+export interface CircuitBreakerOptions {
+    failureThreshold: number;
+    cooldownMs: number;
+}
+export declare const DEFAULT_CIRCUIT_BREAKER_OPTIONS: CircuitBreakerOptions;
+export declare class CircuitBreaker {
+    private state;
+    private consecutiveFailures;
+    private lastFailureTime;
+    private readonly options;
+    private readonly name;
+    constructor(options?: Partial<CircuitBreakerOptions>, name?: string);
+    getState(): CircuitState;
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    private transitionTo;
+    private onSuccess;
+    private onFailure;
+    /** Reset the circuit to closed state. Useful for testing. */
+    reset(): void;
+    /** Get health status for Kubernetes probes or monitoring. */
+    getHealthStatus(): CircuitBreakerHealth;
+}
+export interface CircuitBreakerHealth {
+    state: CircuitState;
+    healthy: boolean;
+    consecutiveFailures: number;
+    lastFailureTime: string | null;
+    cooldownRemainingMs: number;
+}
+export interface IntegrationHealthStatus {
+    name: string;
+    healthy: boolean;
+    circuitBreaker: CircuitBreakerHealth;
+    lastCheckTime: string;
+    latencyMs?: number;
+    error?: string;
+}
+/**
+ * Health checker for integration clients.
+ * Combines circuit breaker state with active endpoint probing.
+ */
+export declare class IntegrationHealthChecker {
+    private readonly name;
+    private readonly circuitBreaker;
+    private readonly probe?;
+    constructor(name: string, circuitBreaker: CircuitBreaker, probe?: (() => Promise<void>) | undefined);
+    check(): Promise<IntegrationHealthStatus>;
+}
+//# sourceMappingURL=retry.d.ts.map

package/dist/integrations/shared/retry.d.ts.map

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