@joe-broadhead/messaging 0.7.1 → 0.9.0

package/dist/types/core/schema/directory-frames.d.ts

@@ -23,7 +23,7 @@
  *   dir.watch {req, persons}              → dir.ok {req}; then dir.changed {persons, sth} pushes
  *   presence.watch {req, persons}         → dir.ok {req}
  *   dir.erase {req, entries, token}       → dir.ok {req}
- *   wake.arm {req, url, ticket, agents, awaiting} → dir.ok {req}   a Jelly host's device, before it sleeps (§7, "Wake tickets")
+ *   wake.arm {req, url, ticket, agents, awaiting, dms?} → dir.ok {req}   a Jelly host's device, before it sleeps (§7, "Wake tickets")
  *   wake.disarm {req}                     → dir.ok {req}
  *   relay → dir.unbound {entry, sth}      this device's own unbind, just before close 4003
  *
@@ -363,6 +363,8 @@ export declare const DirEraseFrame: z.ZodObject<{
 /** Most agents a wake ticket's filter names, and most awaited task requests (spec §7, "Wake tickets"). */
 export declare const WAKE_AGENTS = 64;
 export declare const WAKE_AWAITING = 500;
+/** Most dm conversations a wake ticket's filter names (spec §7, "Wake tickets", "a peer's dm"). */
+export declare const WAKE_DMS = 256;
 /** Most bytes of a wake ticket, and its longest life: Jelly's `jelly-wake+jwt` lives at most seven days. */
 export declare const WAKE_TICKET_BYTES = 4096;
 export declare const WAKE_TICKET_MAX_S: number;
@@ -372,8 +374,9 @@ export declare const WakeUrl: z.ZodString;
  * A Jelly host's device arms a wake ticket before the host sleeps (spec §7, "Wake tickets"). `url` is Jelly ID's wake
  * endpoint for this device's host; `ticket` the host's single-use `jelly-wake+jwt`, which the relay never verifies
  * (Jelly ID does) and reads only for its `exp`; `agents` the local sessions whose own person's mail may wake the host;
- * `awaiting` the request envelope ids of the tasks those agents wait on, whose updates (`replyTo`) may wake it. A new
- * arm replaces the device's previous one.
+ * `awaiting` the request envelope ids of the tasks those agents wait on, whose updates (`replyTo`) may wake it; `dms`
+ * the dm conversations whose other participant's events may wake it (absent: none), which the host's daemon chose. A
+ * new arm replaces the device's previous one.
  */
 export declare const WakeArmFrame: z.ZodObject<{
     t: z.ZodLiteral<"wake.arm">;
@@ -382,6 +385,7 @@ export declare const WakeArmFrame: z.ZodObject<{
     ticket: z.ZodString;
     agents: z.ZodArray<z.ZodString>;
     awaiting: z.ZodArray<z.ZodString>;
+    dms: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type WakeArmFrame = z.infer<typeof WakeArmFrame>;
 /** The relay forgets this device's wake ticket. */
@@ -643,6 +647,7 @@ export declare const DirectoryClientFrame: z.ZodDiscriminatedUnion<[z.ZodObject<
     ticket: z.ZodString;
     agents: z.ZodArray<z.ZodString>;
     awaiting: z.ZodArray<z.ZodString>;
+    dms: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>, z.ZodObject<{
     t: z.ZodLiteral<"wake.disarm">;
     req: z.ZodString;

package/dist/types/core/schema/envelope.d.ts

@@ -6,9 +6,9 @@
 import { z } from "zod";
 export declare const EnvelopeType: z.ZodEnum<{
     message: "message";
-    "task.cancel": "task.cancel";
     receipt: "receipt";
     presence: "presence";
+    "task.cancel": "task.cancel";
     "task.status": "task.status";
     "task.artifact": "task.artifact";
 }>;
@@ -66,9 +66,9 @@ export declare const Envelope: z.ZodObject<{
     realm: z.ZodString;
     type: z.ZodEnum<{
         message: "message";
-        "task.cancel": "task.cancel";
         receipt: "receipt";
         presence: "presence";
+        "task.cancel": "task.cancel";
         "task.status": "task.status";
         "task.artifact": "task.artifact";
     }>;
@@ -111,44 +111,6 @@ export declare const Envelope: z.ZodObject<{
     sig: z.ZodString;
 }, z.core.$strip>;
 export type Envelope = z.infer<typeof Envelope>;
-/**
- * A channel change or post (spec §6.8), on a `kind: "message"` envelope sealed to a device with no recipient agent.
- * `create`: the full channel record with the person who created it, to every member device and to each later
- * invitee. `invite`: persons added, to the existing members. `leave`: the sender left. `remove`: persons removed by
- * the creator or an admin, to every member device. `post`: a line in the channel. `name` is always the channel's own
- * name. A DM line has no `conv` (spec §5, "Meaning").
- */
-export declare const ChannelConv: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    kind: z.ZodLiteral<"channel">;
-    op: z.ZodLiteral<"create">;
-    id: z.ZodString;
-    name: z.ZodString;
-    persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-    creator: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"channel">;
-    op: z.ZodLiteral<"invite">;
-    id: z.ZodString;
-    name: z.ZodString;
-    persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"channel">;
-    op: z.ZodLiteral<"leave">;
-    id: z.ZodString;
-    name: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"channel">;
-    op: z.ZodLiteral<"remove">;
-    id: z.ZodString;
-    name: z.ZodString;
-    persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"channel">;
-    op: z.ZodLiteral<"post">;
-    id: z.ZodString;
-    name: z.ZodString;
-}, z.core.$strip>], "op">;
-export type ChannelConv = z.infer<typeof ChannelConv>;
 /**
  * Sync between two devices of one person (spec §6.9, "Sync"): `grant` carries grants the person set or re-signed,
  * `snapshot` every current grant, for a device of the person that is new to the sender. The message carries exactly
@@ -168,6 +130,25 @@ export type SelfConv = z.infer<typeof SelfConv>;
  */
 export declare const RequestConv: z.ZodObject<{
     kind: z.ZodLiteral<"request">;
+    proof: z.ZodOptional<z.ZodObject<{
+        descriptor: z.ZodObject<{
+            id: z.ZodString;
+            issuedAt: z.ZodNumber;
+            expiresAt: z.ZodNumber;
+            commitment: z.ZodString;
+            by: z.ZodString;
+            sig: z.ZodString;
+            v: z.ZodLiteral<"messaging/1">;
+            realm: z.ZodString;
+            cid: z.ZodString;
+            from: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+            to: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+        }, z.core.$strict>;
+        opening: z.ZodObject<{
+            salt: z.ZodString;
+            text: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
 }, z.core.$strip>;
 export type RequestConv = z.infer<typeof RequestConv>;
 /**
@@ -183,36 +164,7 @@ export declare const CardConv: z.ZodObject<{
 }, z.core.$strip>;
 export type CardConv = z.infer<typeof CardConv>;
 /** The conversation a `message` belongs to when its ends alone do not say (spec §5, "Meaning"). */
-export declare const Conv: z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
-    kind: z.ZodLiteral<"channel">;
-    op: z.ZodLiteral<"create">;
-    id: z.ZodString;
-    name: z.ZodString;
-    persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-    creator: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"channel">;
-    op: z.ZodLiteral<"invite">;
-    id: z.ZodString;
-    name: z.ZodString;
-    persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"channel">;
-    op: z.ZodLiteral<"leave">;
-    id: z.ZodString;
-    name: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"channel">;
-    op: z.ZodLiteral<"remove">;
-    id: z.ZodString;
-    name: z.ZodString;
-    persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"channel">;
-    op: z.ZodLiteral<"post">;
-    id: z.ZodString;
-    name: z.ZodString;
-}, z.core.$strip>], "op">, z.ZodObject<{
+export declare const Conv: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"self">;
     what: z.ZodEnum<{
         grant: "grant";
@@ -220,6 +172,25 @@ export declare const Conv: z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion<[z.Z
     }>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"request">;
+    proof: z.ZodOptional<z.ZodObject<{
+        descriptor: z.ZodObject<{
+            id: z.ZodString;
+            issuedAt: z.ZodNumber;
+            expiresAt: z.ZodNumber;
+            commitment: z.ZodString;
+            by: z.ZodString;
+            sig: z.ZodString;
+            v: z.ZodLiteral<"messaging/1">;
+            realm: z.ZodString;
+            cid: z.ZodString;
+            from: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+            to: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+        }, z.core.$strict>;
+        opening: z.ZodObject<{
+            salt: z.ZodString;
+            text: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"card">;
     what: z.ZodEnum<{
@@ -273,36 +244,7 @@ export declare const MessagePayload: z.ZodObject<{
         parent: z.ZodOptional<z.ZodString>;
         sig: z.ZodString;
     }, z.core.$loose>>>;
-    conv: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
-        kind: z.ZodLiteral<"channel">;
-        op: z.ZodLiteral<"create">;
-        id: z.ZodString;
-        name: z.ZodString;
-        persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-        creator: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"channel">;
-        op: z.ZodLiteral<"invite">;
-        id: z.ZodString;
-        name: z.ZodString;
-        persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"channel">;
-        op: z.ZodLiteral<"leave">;
-        id: z.ZodString;
-        name: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"channel">;
-        op: z.ZodLiteral<"remove">;
-        id: z.ZodString;
-        name: z.ZodString;
-        persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"channel">;
-        op: z.ZodLiteral<"post">;
-        id: z.ZodString;
-        name: z.ZodString;
-    }, z.core.$strip>], "op">, z.ZodObject<{
+    conv: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"self">;
         what: z.ZodEnum<{
             grant: "grant";
@@ -310,6 +252,25 @@ export declare const MessagePayload: z.ZodObject<{
         }>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"request">;
+        proof: z.ZodOptional<z.ZodObject<{
+            descriptor: z.ZodObject<{
+                id: z.ZodString;
+                issuedAt: z.ZodNumber;
+                expiresAt: z.ZodNumber;
+                commitment: z.ZodString;
+                by: z.ZodString;
+                sig: z.ZodString;
+                v: z.ZodLiteral<"messaging/1">;
+                realm: z.ZodString;
+                cid: z.ZodString;
+                from: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+                to: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+            }, z.core.$strict>;
+            opening: z.ZodObject<{
+                salt: z.ZodString;
+                text: z.ZodString;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"card">;
         what: z.ZodEnum<{
@@ -413,6 +374,7 @@ export declare const ReceiptPayload: z.ZodObject<{
         refused: "refused";
         declined: "declined";
         request_required: "request_required";
+        peer_outdated: "peer_outdated";
         rate_limited: "rate_limited";
         loop_guard: "loop_guard";
         too_large: "too_large";
@@ -430,6 +392,7 @@ export declare const ReceiptPayload: z.ZodObject<{
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
         conv_conflict: "conv_conflict";
+        conflict: "conflict";
         stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";
@@ -537,36 +500,7 @@ export declare const PAYLOAD_BY_TYPE: {
             parent: z.ZodOptional<z.ZodString>;
             sig: z.ZodString;
         }, z.core.$loose>>>;
-        conv: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodDiscriminatedUnion<[z.ZodObject<{
-            kind: z.ZodLiteral<"channel">;
-            op: z.ZodLiteral<"create">;
-            id: z.ZodString;
-            name: z.ZodString;
-            persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-            creator: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
-        }, z.core.$strip>, z.ZodObject<{
-            kind: z.ZodLiteral<"channel">;
-            op: z.ZodLiteral<"invite">;
-            id: z.ZodString;
-            name: z.ZodString;
-            persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-        }, z.core.$strip>, z.ZodObject<{
-            kind: z.ZodLiteral<"channel">;
-            op: z.ZodLiteral<"leave">;
-            id: z.ZodString;
-            name: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            kind: z.ZodLiteral<"channel">;
-            op: z.ZodLiteral<"remove">;
-            id: z.ZodString;
-            name: z.ZodString;
-            persons: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodString]>>;
-        }, z.core.$strip>, z.ZodObject<{
-            kind: z.ZodLiteral<"channel">;
-            op: z.ZodLiteral<"post">;
-            id: z.ZodString;
-            name: z.ZodString;
-        }, z.core.$strip>], "op">, z.ZodObject<{
+        conv: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"self">;
             what: z.ZodEnum<{
                 grant: "grant";
@@ -574,6 +508,25 @@ export declare const PAYLOAD_BY_TYPE: {
             }>;
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"request">;
+            proof: z.ZodOptional<z.ZodObject<{
+                descriptor: z.ZodObject<{
+                    id: z.ZodString;
+                    issuedAt: z.ZodNumber;
+                    expiresAt: z.ZodNumber;
+                    commitment: z.ZodString;
+                    by: z.ZodString;
+                    sig: z.ZodString;
+                    v: z.ZodLiteral<"messaging/1">;
+                    realm: z.ZodString;
+                    cid: z.ZodString;
+                    from: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+                    to: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+                }, z.core.$strict>;
+                opening: z.ZodObject<{
+                    salt: z.ZodString;
+                    text: z.ZodString;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
         }, z.core.$strip>, z.ZodObject<{
             kind: z.ZodLiteral<"card">;
             what: z.ZodEnum<{
@@ -669,6 +622,7 @@ export declare const PAYLOAD_BY_TYPE: {
             refused: "refused";
             declined: "declined";
             request_required: "request_required";
+            peer_outdated: "peer_outdated";
             rate_limited: "rate_limited";
             loop_guard: "loop_guard";
             too_large: "too_large";
@@ -686,6 +640,7 @@ export declare const PAYLOAD_BY_TYPE: {
             jelly_unavailable: "jelly_unavailable";
             log_conflict: "log_conflict";
             conv_conflict: "conv_conflict";
+            conflict: "conflict";
             stale_epoch: "stale_epoch";
             device_limit: "device_limit";
             admission_required: "admission_required";

package/dist/types/core/schema/errors.d.ts

@@ -12,6 +12,7 @@ export declare const ErrorCode: z.ZodEnum<{
     refused: "refused";
     declined: "declined";
     request_required: "request_required";
+    peer_outdated: "peer_outdated";
     rate_limited: "rate_limited";
     loop_guard: "loop_guard";
     too_large: "too_large";
@@ -29,6 +30,7 @@ export declare const ErrorCode: z.ZodEnum<{
     jelly_unavailable: "jelly_unavailable";
     log_conflict: "log_conflict";
     conv_conflict: "conv_conflict";
+    conflict: "conflict";
     stale_epoch: "stale_epoch";
     device_limit: "device_limit";
     admission_required: "admission_required";
@@ -51,7 +53,7 @@ export type ErrorCode = z.infer<typeof ErrorCode>;
 /**
  * The exit status of a messagingd or messaging-relay that refuses its store and changes nothing (spec §8.8): `EX_CONFIG`
  * of sysexits(3), for either reason. messagingd also prints one stderr line,
- * `messagingd: store_refused: <reason>: <why and how to start over>`. A client matches this status, the code and the
+ * `messagingd: store_refused: <reason>: <why and the remedy>`. A client matches this status, the code and the
  * reason, never the wording.
  */
 export declare const STORE_REFUSED_EXIT = 78;
@@ -79,6 +81,7 @@ export declare const ErrorBody: z.ZodObject<{
         refused: "refused";
         declined: "declined";
         request_required: "request_required";
+        peer_outdated: "peer_outdated";
         rate_limited: "rate_limited";
         loop_guard: "loop_guard";
         too_large: "too_large";
@@ -96,6 +99,7 @@ export declare const ErrorBody: z.ZodObject<{
         jelly_unavailable: "jelly_unavailable";
         log_conflict: "log_conflict";
         conv_conflict: "conv_conflict";
+        conflict: "conflict";
         stale_epoch: "stale_epoch";
         device_limit: "device_limit";
         admission_required: "admission_required";

package/dist/types/core/schema/guest-invitation.d.ts

@@ -0,0 +1,51 @@
+/** A bounded, sealed preview. Its signature is portable; the guest accepts exactly this op head and exposure. */
+import { z } from "zod";
+export declare const GuestInvitation: z.ZodObject<{
+    v: z.ZodLiteral<"messaging/1">;
+    realm: z.ZodString;
+    cid: z.ZodString;
+    id: z.ZodString;
+    to: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+    inviter: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+    by: z.ZodString;
+    head: z.ZodObject<{
+        seq: z.ZodNumber;
+        hash: z.ZodString;
+    }, z.core.$strict>;
+    issuedAt: z.ZodNumber;
+    expiresAt: z.ZodNumber;
+    kind: z.ZodEnum<{
+        channel: "channel";
+        group: "group";
+    }>;
+    history: z.ZodEnum<{
+        none: "none";
+        shared: "shared";
+    }>;
+    agentContext: z.ZodEnum<{
+        none: "none";
+        members: "members";
+        seats: "seats";
+    }>;
+    bridges: z.ZodEnum<{
+        none: "none";
+        members: "members";
+        admins: "admins";
+    }>;
+    audience: z.ZodArray<z.ZodObject<{
+        p: z.ZodString;
+        person: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
+        role: z.ZodEnum<{
+            admin: "admin";
+            member: "member";
+            owner: "owner";
+            guest: "guest";
+        }>;
+        state: z.ZodEnum<{
+            member: "member";
+            invited: "invited";
+        }>;
+    }, z.core.$strict>>;
+    sig: z.ZodString;
+}, z.core.$strict>;
+export type GuestInvitation = z.infer<typeof GuestInvitation>;

package/dist/types/core/schema/index.d.ts

@@ -14,3 +14,8 @@ export * from "./ipc.js";
 export * from "./ipc/device.js";
 export * from "./ipc/consent.js";
 export * from "./conversation.js";
+export * from "./conv-frames.js";
+export * from "./contact-request.js";
+export * from "./guest-invitation.js";
+export * from "./ipc/conversation-views.js";
+export * from "./ipc/conversations.js";