sequenceDiagram
    title Stream — Partner Heartbeat et propagation CRUD Pair A ↔ Pair B

    participant DBA as DB Pair A (oc-lib)
    participant StreamA as StreamService A
    participant NodeA as Node A
    participant NodeB as Node B
    participant StreamB as StreamService B
    participant NATSB as NATS B
    participant DBB as DB Pair B (oc-lib)
    participant NATSA as NATS A

    Note over StreamA: Démarrage → connectToPartners()

    StreamA->>DBA: Search(PEER, PARTNER) + PeerIDS config
    DBA-->>StreamA: [Peer B, ...]

    StreamA->>NodeB: Connect (libp2p)
    StreamA->>NodeB: NewStream /opencloud/resource/heartbeat/partner/1.0
    StreamA->>NodeB: json.Encode(Heartbeat{Name_A, DID_A, PeerID_A, IndexersBinded_A})

    NodeB->>StreamB: HandlePartnerHeartbeat(stream)
    StreamB->>StreamB: CheckHeartbeat → bandwidth challenge
    StreamB->>StreamA: Echo(payload)
    StreamB->>StreamB: streams[ProtocolHeartbeatPartner][PeerID_A] = {DID_A, Expiry=now+10s}

    StreamA->>StreamA: streams[ProtocolHeartbeatPartner][PeerID_B] = {DID_B, Expiry=now+10s}

    Note over StreamA,StreamB: Stream partner long-lived établi<br/>GC toutes les 8s (StreamService A)<br/>GC toutes les 30s (StreamService B)

    Note over NATSA: Pair A reçoit PROPALGATION_EVENT{PB_DELETE, dt:"storage", payload:res}

    NATSA->>NodeA: ListenNATS → ToPartnerPublishEvent(PB_DELETE, dt, user, payload)
    NodeA->>StreamA: ToPartnerPublishEvent(ctx, PB_DELETE, dt_storage, user, payload)

    alt dt == PEER (mise à jour relation partenaire)
        StreamA->>StreamA: json.Unmarshal → peer.Peer B updated
        alt B.Relation == PARTNER
            StreamA->>NodeB: ConnectToPartner(B.StreamAddress)
            Note over StreamA,NodeB: Reconnexion heartbeat si relation upgrade
        else B.Relation != PARTNER
            loop Tous les protocoles
                StreamA->>StreamA: delete(streams[proto][PeerID_B])
                StreamA->>NodeB: (streams fermés)
            end
        end
    else dt != PEER (ressource ordinaire)
        StreamA->>DBA: Search(PEER, PARTNER) → [Pair B, ...]
        loop Pour chaque protocole partner (Create/Update/Delete)
            StreamA->>NodeB: write(PeerID_B, addr_B, dt, user, payload, ProtocolDeleteResource)
            Note over NodeB: /opencloud/resource/delete/1.0

            NodeB->>StreamB: HandleResponse → readLoop
            StreamB->>StreamB: handleEventFromPartner(evt, ProtocolDeleteResource)
            StreamB->>NATSB: SetNATSPub(REMOVE_RESOURCE, {DataType, resource JSON})
            NATSB->>DBB: Supprimer ressource dans DB B
        end
    end