@sempdev/semp 0.5.1 → 0.5.5

package/dist/brief/address.d.ts

@@ -38,7 +38,7 @@ export declare function addressDomain(addr: string): string;
 /**
  * Validate `addr` against the canonical wire form per §2.3:
  *
- *  - Non-empty, valid UTF-8 (always true for JS strings — included
+ *  - Non-empty, valid UTF-8 (always true for JS strings - included
  *    for symmetry with semp-go).
  *  - Composed length ≤ {@link MaxAddressLength} bytes.
  *  - No control characters (C0, DEL, C1).

package/dist/brief/address.js

@@ -51,7 +51,7 @@ export function addressDomain(addr) {
 /**
  * Validate `addr` against the canonical wire form per §2.3:
  *
- *  - Non-empty, valid UTF-8 (always true for JS strings — included
+ *  - Non-empty, valid UTF-8 (always true for JS strings - included
  *    for symmetry with semp-go).
  *  - Composed length ≤ {@link MaxAddressLength} bytes.
  *  - No control characters (C0, DEL, C1).

package/dist/brief/brief.d.ts

@@ -57,7 +57,7 @@ export interface Brief {
  *
  * Returned copies:
  *
- *  1. If `b.bcc` is empty or undefined, returns `[b]` — a single
+ *  1. If `b.bcc` is empty or undefined, returns `[b]` - a single
  *     copy, returned unchanged.
  *
  *  2. Otherwise, returns `b.bcc.length + 1` elements:

package/dist/brief/brief.js

@@ -23,7 +23,7 @@
  *
  * Returned copies:
  *
- *  1. If `b.bcc` is empty or undefined, returns `[b]` — a single
+ *  1. If `b.bcc` is empty or undefined, returns `[b]` - a single
  *     copy, returned unchanged.
  *
  *  2. Otherwise, returns `b.bcc.length + 1` elements:

package/dist/canonical/marshal.d.ts

@@ -25,11 +25,11 @@ export declare function marshal(v: unknown): Uint8Array;
 /**
  * Apply an in-place elision callback to a deep copy of `v`, then
  * canonicalize. The elider can mutate `map[string]any` / `any[]`
- * structures freely — the original is untouched.
+ * structures freely - the original is untouched.
  *
  * Use case: envelope canonicalization sets `seal.signature` and
  * `seal.session_mac` to "", omits `postmark.hop_count`, omits
- * `padding` — all by mutating the deep copy before serialization.
+ * `padding` - all by mutating the deep copy before serialization.
  */
 export declare function marshalWithElision(v: unknown, elide: (clone: unknown) => void): Uint8Array;
 //# sourceMappingURL=marshal.d.ts.map

package/dist/canonical/marshal.js

@@ -35,11 +35,11 @@ export function marshal(v) {
 /**
  * Apply an in-place elision callback to a deep copy of `v`, then
  * canonicalize. The elider can mutate `map[string]any` / `any[]`
- * structures freely — the original is untouched.
+ * structures freely - the original is untouched.
  *
  * Use case: envelope canonicalization sets `seal.signature` and
  * `seal.session_mac` to "", omits `postmark.hop_count`, omits
- * `padding` — all by mutating the deep copy before serialization.
+ * `padding` - all by mutating the deep copy before serialization.
  */
 export function marshalWithElision(v, elide) {
     const raw = JSON.stringify(v);

package/dist/closure/driver.d.ts

@@ -29,7 +29,7 @@ export interface DriverConfig {
  *  - `already_pending`: a request is already pending for this
  *    user_id; the §2.4 rule rejects double-requests.
  *  - `not_pending`: a cancel arrived for an account with no
- *    pending request — the spec treats this as a no-op success.
+ *    pending request - the spec treats this as a no-op success.
  *  - `invalid`: the record failed structural validation.
  */
 export type SubmitResult = {
@@ -54,7 +54,7 @@ export declare class Driver {
     constructor(cfg: DriverConfig);
     /**
      * Apply `record` to the store. Caller MUST verify the record's
-     * signature and authority (§2.3 — the issuing device must be a
+     * signature and authority (§2.3 - the issuing device must be a
      * full-access device of the account) BEFORE calling submit.
      */
     submit(record: ClosureRecord): Promise<SubmitResult>;

package/dist/closure/driver.js

@@ -22,7 +22,7 @@ export class Driver {
     }
     /**
      * Apply `record` to the store. Caller MUST verify the record's
-     * signature and authority (§2.3 — the issuing device must be a
+     * signature and authority (§2.3 - the issuing device must be a
      * full-access device of the account) BEFORE calling submit.
      */
     async submit(record) {

package/dist/crypto/aead.d.ts

@@ -4,8 +4,8 @@
  * The two currently defined algorithm suites use different AEAD
  * variants:
  *
- *   - `x25519-chacha20-poly1305` — ChaCha20-Poly1305, 12-byte nonce.
- *   - `pq-kyber768-x25519`       — XChaCha20-Poly1305, 24-byte nonce.
+ *   - `x25519-chacha20-poly1305` - ChaCha20-Poly1305, 12-byte nonce.
+ *   - `pq-kyber768-x25519`       - XChaCha20-Poly1305, 24-byte nonce.
  *
  * The sealing flow is identical in both cases: AEAD.Seal(key, nonce,
  * plaintext, aad) -> ciphertext || tag. Returns a single byte slice

package/dist/crypto/aead.js

@@ -4,8 +4,8 @@
  * The two currently defined algorithm suites use different AEAD
  * variants:
  *
- *   - `x25519-chacha20-poly1305` — ChaCha20-Poly1305, 12-byte nonce.
- *   - `pq-kyber768-x25519`       — XChaCha20-Poly1305, 24-byte nonce.
+ *   - `x25519-chacha20-poly1305` - ChaCha20-Poly1305, 12-byte nonce.
+ *   - `pq-kyber768-x25519`       - XChaCha20-Poly1305, 24-byte nonce.
  *
  * The sealing flow is identical in both cases: AEAD.Seal(key, nonce,
  * plaintext, aad) -> ciphertext || tag. Returns a single byte slice

package/dist/crypto/kdf.d.ts

@@ -11,7 +11,7 @@
 /**
  * Per-key HKDF info labels for the five session keys derived from
  * the initial-handshake PRK. Per VECTORS.md §2.2, the rekey
- * derivation reuses these same labels — cross-context separation
+ * derivation reuses these same labels - cross-context separation
  * comes from the salt change (rekey nonces vs handshake nonces),
  * not from a different label namespace.
  */

package/dist/crypto/kdf.js

@@ -13,7 +13,7 @@ import { sha512 } from "@noble/hashes/sha2.js";
 /**
  * Per-key HKDF info labels for the five session keys derived from
  * the initial-handshake PRK. Per VECTORS.md §2.2, the rekey
- * derivation reuses these same labels — cross-context separation
+ * derivation reuses these same labels - cross-context separation
  * comes from the salt change (rekey nonces vs handshake nonces),
  * not from a different label namespace.
  */

package/dist/crypto/mac.d.ts

@@ -6,7 +6,7 @@
  */
 /**
  * Compute HMAC-SHA-256 over `message` keyed by `key`. The output is
- * always 32 bytes — the same width every SEMP MAC field expects.
+ * always 32 bytes - the same width every SEMP MAC field expects.
  */
 export declare function computeMAC(key: Uint8Array, message: Uint8Array): Uint8Array;
 /**

package/dist/crypto/mac.js

@@ -8,7 +8,7 @@ import { hmac } from "@noble/hashes/hmac.js";
 import { sha256 } from "@noble/hashes/sha2.js";
 /**
  * Compute HMAC-SHA-256 over `message` keyed by `key`. The output is
- * always 32 bytes — the same width every SEMP MAC field expects.
+ * always 32 bytes - the same width every SEMP MAC field expects.
  */
 export function computeMAC(key, message) {
     return hmac(sha256, key, message);

package/dist/delivery/ack.d.ts

@@ -4,12 +4,12 @@
  * A recipient server returns exactly one of three acknowledgments
  * for every envelope delivery attempt:
  *
- *   - `delivered`  — accepted; carries a signed
+ *   - `delivered`  - accepted; carries a signed
  *     {@link "./receipt".DeliveryReceipt} per §1.1.1, MAY include a
  *     {@link RecipientStatus} per §1.6 if the sender matches the
  *     recipient's visibility rules.
- *   - `rejected`   — explicitly refused with a reason code per §1.2.
- *   - `silent`     — no response within the sender's timeout window
+ *   - `rejected`   - explicitly refused with a reason code per §1.2.
+ *   - `silent`     - no response within the sender's timeout window
  *     per §1.3. The wire form for silent is "no response sent at
  *     all"; this module exposes a constant value the sending server
  *     uses internally to record the outcome on its own queue state.
@@ -66,7 +66,7 @@ export declare const MaxStatusMessageBytes = 256;
  *   - acknowledgment="rejected" with `reason_code` populated and an
  *     optional `reason`.
  *
- * The `silent` outcome is not represented on the wire — the
+ * The `silent` outcome is not represented on the wire - the
  * recipient simply does not respond.
  */
 export interface DeliveryAck {
@@ -105,7 +105,7 @@ export interface SenderIdentity {
  *  - `nobody` (default): never disclose, regardless of the allow list.
  *  - `everyone`: always disclose, regardless of the allow list.
  *  - `domains` / `servers` / `users`: walk the allow list looking for
- *    a match. The mode constrains which entry kinds are honored — in
+ *    a match. The mode constrains which entry kinds are honored - in
  *    `domains` mode only entries with `type: "domain"`, etc.
  *    Mismatched entries in the allow list are ignored.
  *

package/dist/delivery/ack.js

@@ -4,12 +4,12 @@
  * A recipient server returns exactly one of three acknowledgments
  * for every envelope delivery attempt:
  *
- *   - `delivered`  — accepted; carries a signed
+ *   - `delivered`  - accepted; carries a signed
  *     {@link "./receipt".DeliveryReceipt} per §1.1.1, MAY include a
  *     {@link RecipientStatus} per §1.6 if the sender matches the
  *     recipient's visibility rules.
- *   - `rejected`   — explicitly refused with a reason code per §1.2.
- *   - `silent`     — no response within the sender's timeout window
+ *   - `rejected`   - explicitly refused with a reason code per §1.2.
+ *   - `silent`     - no response within the sender's timeout window
  *     per §1.3. The wire form for silent is "no response sent at
  *     all"; this module exposes a constant value the sending server
  *     uses internally to record the outcome on its own queue state.
@@ -55,7 +55,7 @@ export function buildRejectedAck(reasonCode, reason) {
  *  - `nobody` (default): never disclose, regardless of the allow list.
  *  - `everyone`: always disclose, regardless of the allow list.
  *  - `domains` / `servers` / `users`: walk the allow list looking for
- *    a match. The mode constrains which entry kinds are honored — in
+ *    a match. The mode constrains which entry kinds are honored - in
  *    `domains` mode only entries with `type: "domain"`, etc.
  *    Mismatched entries in the allow list are ignored.
  *
@@ -79,7 +79,7 @@ export function matchVisibility(visibility, sender) {
         case "users":
             break;
         default:
-            // Unknown mode — fail closed.
+            // Unknown mode - fail closed.
             return false;
     }
     const senderAddress = (sender.address ?? "").toLowerCase();
@@ -116,7 +116,7 @@ export function matchVisibility(visibility, sender) {
                 }
                 break;
             default:
-                // Unknown entry type — skip.
+                // Unknown entry type - skip.
                 break;
         }
     }

package/dist/delivery/blocklist.d.ts

@@ -63,7 +63,7 @@ export interface BlockListSender {
  * `user > server > domain`.
  *
  * Entries past `expires_at` are skipped (no clock-skew tolerance
- * applied here — callers that want the §4.4 grace window evaluate
+ * applied here - callers that want the §4.4 grace window evaluate
  * expiry themselves).
  *
  * All comparisons are case-insensitive.

package/dist/delivery/blocklist.js

@@ -14,7 +14,7 @@
  * `user > server > domain`.
  *
  * Entries past `expires_at` are skipped (no clock-skew tolerance
- * applied here — callers that want the §4.4 grace window evaluate
+ * applied here - callers that want the §4.4 grace window evaluate
  * expiry themselves).
  *
  * All comparisons are case-insensitive.
@@ -66,7 +66,7 @@ export function matchBlockList(list, sender, now = new Date()) {
                 rank = RANK_DOMAIN;
                 break;
             default:
-                continue; // unknown entity type — forward-compat ignore
+                continue; // unknown entity type - forward-compat ignore
         }
         if (rank > bestRank) {
             bestRank = rank;

package/dist/delivery/device_sync.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Device-sync extension marker per draft-gokce-semp-client §5.6.
+ *
+ * Every sync envelope MUST carry the marker in `brief.extensions`
+ * with `required: true`. The marker's `data` object carries a
+ * single `kind` field that names the sync category; each sync
+ * kind declares the `kind` value it produces.
+ *
+ * The marker lives in the brief so the home server can apply
+ * correct policy without decrypting the enclosure. Clients
+ * receiving an envelope with this marker MUST NOT surface the
+ * envelope as ordinary correspondence in any mailbox view.
+ *
+ * @module
+ */
+/** Namespaced identifier of the device-sync marker extension. */
+export declare const DeviceSyncExtensionID = "semp.dev/device-sync";
+/** Content of the device-sync extension's `data` field per §5.6. */
+export interface DeviceSyncMarkerData {
+    /**
+     * Identifies the sync category. Each sync extension declares
+     * the `kind` value it produces.
+     */
+    kind: string;
+}
+//# sourceMappingURL=device_sync.d.ts.map

package/dist/delivery/device_sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device_sync.d.ts","sourceRoot":"","sources":["../../src/delivery/device_sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,iEAAiE;AACjE,eAAO,MAAM,qBAAqB,yBAAyB,CAAC;AAE5D,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/delivery/device_sync.js

@@ -0,0 +1,18 @@
+/**
+ * Device-sync extension marker per draft-gokce-semp-client §5.6.
+ *
+ * Every sync envelope MUST carry the marker in `brief.extensions`
+ * with `required: true`. The marker's `data` object carries a
+ * single `kind` field that names the sync category; each sync
+ * kind declares the `kind` value it produces.
+ *
+ * The marker lives in the brief so the home server can apply
+ * correct policy without decrypting the enclosure. Clients
+ * receiving an envelope with this marker MUST NOT surface the
+ * envelope as ordinary correspondence in any mailbox view.
+ *
+ * @module
+ */
+/** Namespaced identifier of the device-sync marker extension. */
+export const DeviceSyncExtensionID = "semp.dev/device-sync";
+//# sourceMappingURL=device_sync.js.map

package/dist/delivery/device_sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device_sync.js","sourceRoot":"","sources":["../../src/delivery/device_sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,iEAAiE;AACjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,sBAAsB,CAAC"}

package/dist/delivery/disposition.d.ts

@@ -71,7 +71,7 @@ export interface StagedHeldStage {
 }
 /**
  * One envelope held in the staged-delivery queue per §3.2.2. The
- * envelope itself is NOT stored twice — this record is the
+ * envelope itself is NOT stored twice - this record is the
  * per-stage pointer set the server maintains.
  */
 export interface StagedHeld {

package/dist/delivery/fetch.d.ts

@@ -1,5 +1,5 @@
 /**
- * SEMP_FETCH wire shapes — the demo-only client → home-server inbox
+ * SEMP_FETCH wire shapes - the demo-only client → home-server inbox
  * pull protocol per CLIENT.md §3.
  *
  * HANDSHAKE.md §4.6 explicitly leaves the client wakeup mechanism

package/dist/delivery/fetch.js

@@ -1,5 +1,5 @@
 /**
- * SEMP_FETCH wire shapes — the demo-only client → home-server inbox
+ * SEMP_FETCH wire shapes - the demo-only client → home-server inbox
  * pull protocol per CLIENT.md §3.
  *
  * HANDSHAKE.md §4.6 explicitly leaves the client wakeup mechanism

package/dist/delivery/inbox.d.ts

@@ -1,5 +1,5 @@
 /**
- * Reference per-user envelope inbox — minimal in-memory FIFO.
+ * Reference per-user envelope inbox - minimal in-memory FIFO.
  *
  * Intended for in-process tests, embedded servers, and the
  * reference {@link "./fetch".FetchResponse} producer. NOT a
@@ -14,7 +14,7 @@
  *
  * Production deployments MUST back this with a durable store,
  * retention rules, fairness controls, and per-address access
- * control — none of which are present here.
+ * control - none of which are present here.
  *
  * @module
  */

package/dist/delivery/inbox.js

@@ -1,5 +1,5 @@
 /**
- * Reference per-user envelope inbox — minimal in-memory FIFO.
+ * Reference per-user envelope inbox - minimal in-memory FIFO.
  *
  * Intended for in-process tests, embedded servers, and the
  * reference {@link "./fetch".FetchResponse} producer. NOT a
@@ -14,7 +14,7 @@
  *
  * Production deployments MUST back this with a durable store,
  * retention rules, fairness controls, and per-address access
- * control — none of which are present here.
+ * control - none of which are present here.
  *
  * @module
  */

package/dist/delivery/index.d.ts

@@ -28,4 +28,8 @@ export { type DecodedBrief, type DomainKeyLookup, type DomainPolicyFunc, type En
 export { type StageCompleteFunc, type StageDeliverFunc, type StageSuppressFunc, type StagedRunnerConfig, EnvelopeAlreadyHeldError, EnvelopeNotHeldError, StagedRunner, } from "./staged_runner.js";
 export { type AttemptResult, type DeliverFunc, type EventSink, type SchedulerConfig, type SchedulerStore, InMemorySchedulerStore, Scheduler, TickInProgressError, UnknownRecordError, } from "./scheduler.js";
 export { type Dialer, type EndpointResolver, type ForwarderConfig, type PeerDomainKeyLookup, Forwarder, } from "./forwarder.js";
+export { PersistentSilentCounter, PersistentSilentDefaults, } from "./persistent_silent.js";
+export { type StatusMessage, type StatusMessageSignature, type StatusState, type StatusVisibility, type StatusVisibilityEntry, type StatusVisibilityMode, StatusMessagePrefix, StatusMessageType, StatusMessageVersion, signStatusMessage, validateStatusMessage, verifyStatusMessage, } from "./status_message.js";
+export { UpgradeCapabilityPresent, UpgradeHeaderAddress, UpgradeHeaderCapability, UpgradeHeaderDomain, UpgradeHeaderIdentity, } from "./upgrade_signal.js";
+export { type DeviceSyncMarkerData, DeviceSyncExtensionID, } from "./device_sync.js";
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/delivery/index.js

@@ -28,4 +28,8 @@ export { Pipeline, } from "./pipeline.js";
 export { EnvelopeAlreadyHeldError, EnvelopeNotHeldError, StagedRunner, } from "./staged_runner.js";
 export { InMemorySchedulerStore, Scheduler, TickInProgressError, UnknownRecordError, } from "./scheduler.js";
 export { Forwarder, } from "./forwarder.js";
+export { PersistentSilentCounter, PersistentSilentDefaults, } from "./persistent_silent.js";
+export { StatusMessagePrefix, StatusMessageType, StatusMessageVersion, signStatusMessage, validateStatusMessage, verifyStatusMessage, } from "./status_message.js";
+export { UpgradeCapabilityPresent, UpgradeHeaderAddress, UpgradeHeaderCapability, UpgradeHeaderDomain, UpgradeHeaderIdentity, } from "./upgrade_signal.js";
+export { DeviceSyncExtensionID, } from "./device_sync.js";
 //# sourceMappingURL=index.js.map

package/dist/delivery/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAOL,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EASL,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,GACxB,MAAM,UAAU,CAAC;AAElB,OAAO,EAGL,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAGL,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAQL,qBAAqB,EACrB,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAKL,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAIL,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAIL,SAAS,EACT,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,OAAO,EAGL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAML,qBAAqB,EACrB,eAAe,EACf,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAKL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAKL,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAGL,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAGL,gBAAgB,EAChB,WAAW,EACX,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAaL,QAAQ,GACT,MAAM,eAAe,CAAC;AAEvB,OAAO,EAKL,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAML,sBAAsB,EACtB,SAAS,EACT,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAKL,SAAS,GACV,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/delivery/index.ts"],"names":[],"mappings":"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"}

package/dist/delivery/persistent_silent.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Persistent silent recipient state per
+ * draft-gokce-semp-delivery §4.5 / DELIVERY.md §2.5.
+ *
+ * After repeated `silent` outcomes for the same recipient the
+ * sending server tightens its retry deadline so it does not waste
+ * effort retrying a recipient that consistently fails to
+ * acknowledge.
+ *
+ * The state is purely sender-side. It MUST NOT be transmitted on
+ * the wire and MUST NOT be published as a trust-gossip observation.
+ * Two senders correctly disagree on which recipients are
+ * persistently silent because each only sees its own envelopes.
+ *
+ * @module
+ */
+/** §4.5 spec defaults. */
+export declare const PersistentSilentDefaults: {
+    /** Consecutive silents required before tightening engages. */
+    readonly threshold: 5;
+    /** Minimum observation window before tightening engages. */
+    readonly observationWindowMs: number;
+    /** Tightened retry deadline once the trigger fires. */
+    readonly shortDeadlineMs: number;
+    /** Idle expiry after which the counter for a recipient is dropped. */
+    readonly idleExpiryMs: number;
+};
+/** Counter configuration. Zero / undefined falls back to the spec defaults. */
+export interface PersistentSilentConfig {
+    threshold?: number;
+    observationWindowMs?: number;
+    shortDeadlineMs?: number;
+    idleExpiryMs?: number;
+}
+/**
+ * Sender-side ledger of per-recipient silent-acknowledgment
+ * counters.
+ *
+ * Usage:
+ *
+ *  - `inc(addr, now)` on every `silent` outcome.
+ *  - `reset(addr)` on every non-silent outcome (delivered /
+ *    rejected).
+ *  - `effective(addr, now)` returns the tightened retry deadline
+ *    (in ms) once the count + observation-window thresholds are
+ *    met, or null to keep the caller's default.
+ *  - `pruneExpired(now)` on a janitor cadence so the map does not
+ *    grow without bound.
+ */
+export declare class PersistentSilentCounter {
+    private readonly cfg;
+    private readonly entries;
+    constructor(cfg?: PersistentSilentConfig);
+    /** Record one silent outcome for `recipient` at `now`. Returns the running count. */
+    inc(recipient: string, now: Date): number;
+    /** Clear the counter for `recipient`. Idempotent on missing entries. */
+    reset(recipient: string): void;
+    /**
+     * Returns the §4.5 shortened deadline (in ms) once the count and
+     * minimum-observation-window thresholds are met. Returns null
+     * when the trigger has not fired yet - caller falls back to its
+     * default per-envelope deadline.
+     */
+    effective(recipient: string, now: Date): number | null;
+    /** Current silent count for `recipient`. */
+    count(recipient: string): number;
+    /** Drop entries whose lastSeen is older than IdleExpiry. Returns the removed count. */
+    pruneExpired(now: Date): number;
+}
+//# sourceMappingURL=persistent_silent.d.ts.map

package/dist/delivery/persistent_silent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent_silent.d.ts","sourceRoot":"","sources":["../../src/delivery/persistent_silent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,0BAA0B;AAC1B,eAAO,MAAM,wBAAwB;IACnC,8DAA8D;;IAE9D,4DAA4D;;IAE5D,uDAAuD;;IAEvD,sEAAsE;;CAE9D,CAAC;AAEX,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAQD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;gBAExD,GAAG,GAAE,sBAA2B;IAoB5C,qFAAqF;IACrF,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM;IAezC,wEAAwE;IACxE,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI9B;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI;IActD,4CAA4C;IAC5C,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIhC,uFAAuF;IACvF,YAAY,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM;CAWhC"}

package/dist/delivery/persistent_silent.js

@@ -0,0 +1,117 @@
+/**
+ * Persistent silent recipient state per
+ * draft-gokce-semp-delivery §4.5 / DELIVERY.md §2.5.
+ *
+ * After repeated `silent` outcomes for the same recipient the
+ * sending server tightens its retry deadline so it does not waste
+ * effort retrying a recipient that consistently fails to
+ * acknowledge.
+ *
+ * The state is purely sender-side. It MUST NOT be transmitted on
+ * the wire and MUST NOT be published as a trust-gossip observation.
+ * Two senders correctly disagree on which recipients are
+ * persistently silent because each only sees its own envelopes.
+ *
+ * @module
+ */
+/** §4.5 spec defaults. */
+export const PersistentSilentDefaults = {
+    /** Consecutive silents required before tightening engages. */
+    threshold: 5,
+    /** Minimum observation window before tightening engages. */
+    observationWindowMs: 24 * 60 * 60 * 1000,
+    /** Tightened retry deadline once the trigger fires. */
+    shortDeadlineMs: 4 * 60 * 60 * 1000,
+    /** Idle expiry after which the counter for a recipient is dropped. */
+    idleExpiryMs: 30 * 24 * 60 * 60 * 1000,
+};
+/**
+ * Sender-side ledger of per-recipient silent-acknowledgment
+ * counters.
+ *
+ * Usage:
+ *
+ *  - `inc(addr, now)` on every `silent` outcome.
+ *  - `reset(addr)` on every non-silent outcome (delivered /
+ *    rejected).
+ *  - `effective(addr, now)` returns the tightened retry deadline
+ *    (in ms) once the count + observation-window thresholds are
+ *    met, or null to keep the caller's default.
+ *  - `pruneExpired(now)` on a janitor cadence so the map does not
+ *    grow without bound.
+ */
+export class PersistentSilentCounter {
+    cfg;
+    entries = new Map();
+    constructor(cfg = {}) {
+        this.cfg = {
+            threshold: cfg.threshold && cfg.threshold > 0
+                ? cfg.threshold
+                : PersistentSilentDefaults.threshold,
+            observationWindowMs: cfg.observationWindowMs && cfg.observationWindowMs > 0
+                ? cfg.observationWindowMs
+                : PersistentSilentDefaults.observationWindowMs,
+            shortDeadlineMs: cfg.shortDeadlineMs && cfg.shortDeadlineMs > 0
+                ? cfg.shortDeadlineMs
+                : PersistentSilentDefaults.shortDeadlineMs,
+            idleExpiryMs: cfg.idleExpiryMs && cfg.idleExpiryMs > 0
+                ? cfg.idleExpiryMs
+                : PersistentSilentDefaults.idleExpiryMs,
+        };
+    }
+    /** Record one silent outcome for `recipient` at `now`. Returns the running count. */
+    inc(recipient, now) {
+        if (recipient === "") {
+            return 0;
+        }
+        const t = now.getTime();
+        const e = this.entries.get(recipient);
+        if (e === undefined) {
+            this.entries.set(recipient, { count: 1, firstSeenMs: t, lastSeenMs: t });
+            return 1;
+        }
+        e.count++;
+        e.lastSeenMs = t;
+        return e.count;
+    }
+    /** Clear the counter for `recipient`. Idempotent on missing entries. */
+    reset(recipient) {
+        this.entries.delete(recipient);
+    }
+    /**
+     * Returns the §4.5 shortened deadline (in ms) once the count and
+     * minimum-observation-window thresholds are met. Returns null
+     * when the trigger has not fired yet - caller falls back to its
+     * default per-envelope deadline.
+     */
+    effective(recipient, now) {
+        const e = this.entries.get(recipient);
+        if (e === undefined) {
+            return null;
+        }
+        if (e.count < this.cfg.threshold) {
+            return null;
+        }
+        if (now.getTime() - e.firstSeenMs < this.cfg.observationWindowMs) {
+            return null;
+        }
+        return this.cfg.shortDeadlineMs;
+    }
+    /** Current silent count for `recipient`. */
+    count(recipient) {
+        return this.entries.get(recipient)?.count ?? 0;
+    }
+    /** Drop entries whose lastSeen is older than IdleExpiry. Returns the removed count. */
+    pruneExpired(now) {
+        const t = now.getTime();
+        let removed = 0;
+        for (const [k, e] of this.entries) {
+            if (t - e.lastSeenMs >= this.cfg.idleExpiryMs) {
+                this.entries.delete(k);
+                removed++;
+            }
+        }
+        return removed;
+    }
+}
+//# sourceMappingURL=persistent_silent.js.map

package/dist/delivery/persistent_silent.js.map

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