@optimystic/db-p2p 0.0.1

package/dist/src/cluster/client.d.ts

@@ -0,0 +1,12 @@
+import { type PeerId } from '@libp2p/interface';
+import type { IPeerNetwork, ICluster, ClusterRecord } from '@optimystic/db-core';
+import { ProtocolClient } from '../protocol-client.js';
+export declare class ClusterClient extends ProtocolClient implements ICluster {
+    readonly protocolPrefix?: string | undefined;
+    private constructor();
+    /** Create a new client instance */
+    static create(peerId: PeerId, peerNetwork: IPeerNetwork, protocolPrefix?: string): ClusterClient;
+    update(record: ClusterRecord, hop?: number): Promise<ClusterRecord>;
+    private recordCoordinatorForRecordIfSupported;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/cluster/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/cluster/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,qBAAa,aAAc,SAAQ,cAAe,YAAW,QAAQ;IACL,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM;IAA/F,OAAO;IAIP,mCAAmC;WACrB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,aAAa;IAIhG,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,GAAE,MAAU,GAAG,OAAO,CAAC,aAAa,CAAC;IAiC5E,OAAO,CAAC,qCAAqC;CAc9C"}

package/dist/src/cluster/client.js

@@ -0,0 +1,65 @@
+import { ProtocolClient } from '../protocol-client.js';
+import { peerIdFromString } from '@libp2p/peer-id';
+export class ClusterClient extends ProtocolClient {
+    protocolPrefix;
+    constructor(peerId, peerNetwork, protocolPrefix) {
+        super(peerId, peerNetwork);
+        this.protocolPrefix = protocolPrefix;
+    }
+    /** Create a new client instance */
+    static create(peerId, peerNetwork, protocolPrefix) {
+        return new ClusterClient(peerId, peerNetwork, protocolPrefix);
+    }
+    async update(record, hop = 0) {
+        const message = {
+            operation: 'update',
+            record
+        };
+        const preferred = (this.protocolPrefix ?? '/db-p2p') + '/cluster/1.0.0';
+        let response;
+        try {
+            response = await this.processMessage(message, preferred);
+        }
+        catch (err) {
+            if (preferred !== '/db-p2p/cluster/1.0.0') {
+                response = await this.processMessage(message, '/db-p2p/cluster/1.0.0');
+            }
+            else {
+                throw err;
+            }
+        }
+        if (response?.redirect?.peers?.length) {
+            if (hop >= 2) {
+                throw new Error('Redirect loop detected in ClusterClient (max hops reached)');
+            }
+            const currentIdStr = this.peerId.toString();
+            const next = response.redirect.peers.find((p) => p.id !== currentIdStr) ?? response.redirect.peers[0];
+            const nextId = peerIdFromString(next.id);
+            if (next.id === currentIdStr) {
+                throw new Error('Redirect loop detected in ClusterClient (same peer)');
+            }
+            this.recordCoordinatorForRecordIfSupported(record, nextId);
+            const nextClient = ClusterClient.create(nextId, this.peerNetwork, this.protocolPrefix);
+            return await nextClient.update(record, hop + 1);
+        }
+        return response;
+    }
+    recordCoordinatorForRecordIfSupported(record, peerId) {
+        const rmsg = record?.message;
+        let tailId;
+        if (rmsg?.commit?.tailId)
+            tailId = rmsg.commit.tailId;
+        else if (rmsg?.pend?.transforms) {
+            const keys = Object.keys(rmsg.pend.transforms);
+            if (keys.length > 0)
+                tailId = keys[0];
+        }
+        if (tailId) {
+            const kbytes = new TextEncoder().encode(tailId);
+            const pn = this.peerNetwork;
+            if (typeof pn?.recordCoordinator === 'function')
+                pn.recordCoordinator(kbytes, peerId);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/cluster/client.js.map

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

package/dist/src/cluster/cluster-repo.d.ts

@@ -0,0 +1,79 @@
+import type { IRepo, ClusterRecord, ITransactionValidator } from "@optimystic/db-core";
+import type { ICluster } from "@optimystic/db-core";
+import type { IPeerNetwork } from "@optimystic/db-core";
+import type { PeerId } from "@libp2p/interface";
+import type { PartitionDetector } from "./partition-detector.js";
+import type { FretService } from "p2p-fret";
+interface ClusterMemberComponents {
+    storageRepo: IRepo;
+    peerNetwork: IPeerNetwork;
+    peerId: PeerId;
+    protocolPrefix?: string;
+    partitionDetector?: PartitionDetector;
+    fretService?: FretService;
+    validator?: ITransactionValidator;
+}
+export declare function clusterMember(components: ClusterMemberComponents): ClusterMember;
+/**
+ * Handles cluster-side operations, managing promises and commits for cluster updates
+ * and coordinating with the local storage repo.
+ */
+export declare class ClusterMember implements ICluster {
+    private readonly storageRepo;
+    private readonly peerNetwork;
+    private readonly peerId;
+    private readonly protocolPrefix?;
+    private readonly partitionDetector?;
+    private readonly fretService?;
+    private readonly validator?;
+    private activeTransactions;
+    private cleanupQueue;
+    private pendingUpdates;
+    constructor(storageRepo: IRepo, peerNetwork: IPeerNetwork, peerId: PeerId, protocolPrefix?: string | undefined, partitionDetector?: PartitionDetector | undefined, fretService?: FretService | undefined, validator?: ITransactionValidator | undefined);
+    /**
+     * Handles an incoming cluster update, managing the two-phase commit process
+     * and coordinating with the local storage repo
+     */
+    update(record: ClusterRecord): Promise<ClusterRecord>;
+    private processUpdate;
+    /**
+     * Merges two records, validating that non-signature fields match
+     */
+    private mergeRecords;
+    private validateRecord;
+    private computeMessageHash;
+    private validateSignatures;
+    private computePromiseHash;
+    private computeCommitHash;
+    private verifySignature;
+    private getTransactionPhase;
+    private hasMajority;
+    private handlePromiseNeeded;
+    /**
+     * Validates pend operations in a cluster record using the transaction validator.
+     * Returns success if no validator is configured (backwards compatibility).
+     */
+    private validatePendOperations;
+    private handleCommitNeeded;
+    private handleConsensus;
+    private handleRejection;
+    private setupTimeouts;
+    private hasConflict;
+    /**
+     * Resolve race between two conflicting transactions.
+     * Transaction with more promises wins. If tied, higher hash wins.
+     */
+    private resolveRace;
+    private operationsConflict;
+    private getActionId;
+    private getAffectedBlockIds;
+    private propagateIfNeeded;
+    private handleExpiration;
+    private resolveWithPeers;
+    private queueExpiredTransactions;
+    private processCleanupQueue;
+    private hasLocalCommit;
+    private clearTransaction;
+}
+export {};
+//# sourceMappingURL=cluster-repo.d.ts.map

package/dist/src/cluster/cluster-repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster-repo.d.ts","sourceRoot":"","sources":["../../../src/cluster/cluster-repo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAA0B,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC/G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAKhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAqB5C,UAAU,uBAAuB;IAChC,WAAW,EAAE,KAAK,CAAC;IACnB,WAAW,EAAE,YAAY,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,uBAAuB,GAAG,aAAa,CAUhF;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAS5C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;IAb5B,OAAO,CAAC,kBAAkB,CAA4C;IAEtE,OAAO,CAAC,YAAY,CAAgB;IAEpC,OAAO,CAAC,cAAc,CAAkD;gBAGtD,WAAW,EAAE,KAAK,EAClB,WAAW,EAAE,YAAY,EACzB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,YAAA,EACvB,iBAAiB,CAAC,EAAE,iBAAiB,YAAA,EACrC,WAAW,CAAC,EAAE,WAAW,YAAA,EACzB,SAAS,CAAC,EAAE,qBAAqB,YAAA;IAQnD;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;YAyB7C,aAAa;IAoJ3B;;OAEG;YACW,YAAY;YA2BZ,cAAc;YAad,kBAAkB;YAMlB,kBAAkB;YAkBlB,kBAAkB;YAMlB,iBAAiB;YAMjB,eAAe;YAKf,mBAAmB;IAqCjC,OAAO,CAAC,WAAW;YAIL,mBAAmB;IAwBjC;;;OAGG;YACW,sBAAsB;YAsBtB,kBAAkB;YAkBlB,eAAe;YAmBf,eAAe;IAI7B,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,WAAW;IA4CnB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,mBAAmB;YAmBb,iBAAiB;YAejB,gBAAgB;YA4BhB,gBAAgB;IAM9B,OAAO,CAAC,wBAAwB;YASlB,mBAAmB;IAejC,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,gBAAgB;CAkBxB"}