p2party 0.14.2 → 0.14.3

package/README.md

@@ -46,7 +46,7 @@ Apache-2.0 · [LICENSE.md](LICENSE.md)
   `window`, or `localStorage`.
 
 Immediate delivery over the existing signaling rendezvous is the shipped
-default. Scheduled timing cover is also wired as of 0.14.2: a room policy may
+default. Scheduled timing cover is also wired: a room policy may
 pin a cadence, lane count, and frames per cell, and every edge in the room then
 emits fixed-size cells on that schedule whether or not there is data to send.
 Sparse post-quantum healing (the OFFER/ADVANCE/ACK epoch exchange) is likewise
@@ -633,8 +633,8 @@ script in and `window.p2party` is there — no npm, no bundler, no build:
 <title>p2party in one file</title>
 
 <script
-  src="https://cdn.p2party.com/@0.14.2/p2party.min.js"
-  integrity="sha384-KJLIhsZkQzkYg1lyk57oAacQBR3DeWHX92Ksv9QTO9tUJVw1pxUNHI9e2nIcacgZ"
+  src="https://cdn.p2party.com/@0.14.3/p2party.min.js"
+  integrity="sha384-dwBCnd3gj0k9HpDetSDOtYhv/CkADQs5h4mz+dI7hdYY1wWQpgvtiOGF4GUrnbqR"
   crossorigin="anonymous"
 ></script>
 
@@ -665,9 +665,9 @@ connect directly to each other.
 The three published objects:
 
 ```text
-https://cdn.p2party.com/@0.14.2/p2party.min.js     UMD bundle -> window.p2party
-https://cdn.p2party.com/@0.14.2/db.worker.js       IndexedDB/OPFS worker
-https://cdn.p2party.com/@0.14.2/libcrypto.wasm     the cryptographic module
+https://cdn.p2party.com/@0.14.3/p2party.min.js     UMD bundle -> window.p2party
+https://cdn.p2party.com/@0.14.3/db.worker.js       IndexedDB/OPFS worker
+https://cdn.p2party.com/@0.14.3/libcrypto.wasm     the cryptographic module
 ```
 
 The `integrity` value above is this release's bundle, and the release build
@@ -688,7 +688,7 @@ same release bytes before calling `connect()`:
 import p2party from "p2party";
 
 p2party.setWasmSourceUrl(
-  new URL("/vendor/p2party-0.14.2/libcrypto.wasm", window.location.href),
+  new URL("/vendor/p2party-0.14.3/libcrypto.wasm", window.location.href),
 );
 ```
 
@@ -701,8 +701,8 @@ object. The path carries the version, so a URL always names exactly one build
 and is safe to cache forever:
 
 ```sh
-curl -O https://cdn.p2party.com/@0.14.2/libcrypto.wasm
-curl -O https://cdn.p2party.com/@0.14.2/libcrypto.provenance.json
+curl -O https://cdn.p2party.com/@0.14.3/libcrypto.wasm
+curl -O https://cdn.p2party.com/@0.14.3/libcrypto.provenance.json
 ```
 
 Check what you downloaded before you serve it. The SHA-256 and the SRI value
@@ -713,7 +713,7 @@ shasum -a 256 libcrypto.wasm
 openssl dgst -sha384 -binary libcrypto.wasm | openssl base64 -A
 ```
 
-For 0.14.2 those are
+For 0.14.3 those are
 `7eea31157e69ac61f3a512b624d5c210296302fd289fc2b65c63ecc31a056267` and
 `sha384-pBMyUqQ3KBztxgeJMgDFZeohfj9QlAFNwt4/gRlqT0vlZ2kbkKxv+q5DwbZOBuUP`.
 They are the same bytes npm ships — the release workflow uploads the CDN object

package/docs/references.md

@@ -152,6 +152,6 @@ third-party security audit. Cite the implementation:
 @software{p2party,
   title  = {p2party: protocol-v4 end-to-end encryption over a WebRTC room mesh},
   url    = {https://github.com/p2party/p2party-js},
-  note   = {Version 0.14.2}
+  note   = {Version 0.14.3}
 }
 ```

package/lib/handlers/reconcile.d.ts

@@ -12,5 +12,29 @@ export interface PeerTransferOutcome {
 /** Accurate, defensive per-peer delivery state for UI/diagnostics consumers. */
 export declare const getPeerTransferOutcome: (roomId: string, peerId: string, transferId: string) => PeerTransferOutcome;
 export declare const isTransferComplete: (roomId: string, peerId: string, transferId: string) => boolean;
+export interface TransferAck {
+    readonly peerId: string;
+    /**
+     * Distinct chunks this peer has receipted so far, counting decoys: a receipt
+     * is emitted per inbound frame, and the padding is what makes every frame
+     * indistinguishable, so excluding it would report a fraction of a denominator
+     * that includes it.
+     */
+    readonly ackedChunks: number;
+    readonly complete: boolean;
+}
+/**
+ * Live outbound progress for one logical send, per peer.
+ *
+ * The sender already knows this -- every receipt lands in the have-set above --
+ * but nothing outside this module could read it, so a UI could say "sending"
+ * and then nothing at all until the transfer settled. On a large file that is
+ * a progress bar's worth of silence.
+ *
+ * Derived from the same state selective retransmit uses, so it cannot drift
+ * from what the sender actually believes was delivered. Read-only and
+ * defensively copied; polling it never affects the transfer.
+ */
+export declare const getTransferAcks: (roomId: string, transferId: string) => TransferAck[];
 export declare const clearTransfer: (roomId: string, peerId: string, transferId: string) => void;
 export declare const waitForCompletion: (roomId: string, peerId: string, transferId: string, timeoutMs: number, signal?: AbortSignal) => Promise<boolean>;

package/lib/index.d.ts

@@ -208,6 +208,7 @@ export declare const p2party: {
         chunksReceivedReal?: number;
         retransmits?: number;
     }>;
+    getTransferAcks: (roomId: string, transferId: string) => import(".").TransferAck[];
     getSendChunksCount: (transferId: string) => Promise<number>;
     cancelMessage: (roomId: string, channelLabel: string, merkleRoot?: string | Uint8Array, hash?: string | Uint8Array, transferId?: string) => Promise<void>;
     createTransferId: () => string;
@@ -351,6 +352,7 @@ export type { State, Room, Peer, Channel, Message, RoomData, MimeType, FileExten
 export { createSession, restoreSession, generateSessionIdentity, setWasmSourceUrl, MessageDeliveryError, joinRoom, waitForRoom, waitForPeers, onMessage, setDebugLogging, };
 export { DEFAULT_ROOM_POLICY_V1, canonicalizeRoomPolicyV1, decodeRoomPolicyV1, encodeRoomPolicyV1, hashRoomPolicyV1, roomPoliciesEqualV1, };
 export { MIN_COVER_CADENCE_MS, MAX_COVER_CADENCE_MS, MAX_COVER_LANES, MAX_COVER_FRAMES_PER_CELL, MIN_COVER_SLOT_MS, validateRoomPolicyV1, WIRE_CHUNK_FRAME_LEN, };
+export type { TransferAck } from "./handlers/reconcile";
 export type { RoomAuthMode, RoomCoverMode, RoomPqMode, RoomRendezvousMode, } from "./roomPolicy";
 export type { CreateSessionOptions, EncryptedSessionMessage, GenerateSessionIdentityOptions, GeneratedSessionIdentity, HandshakeTransport, LocalSessionIdentity, P2PartySession, SessionChannelBinding, SessionCryptoOptions, } from "./session";
 export default p2party;