@freqhole/haruspex 0.0.0

package/dist/protocol/extensions.test.js

@@ -0,0 +1,65 @@
+import { describe, expect, it } from "vitest";
+import { z } from "zod";
+import { createAppExtensionRegistry, isAppExtensionType, } from "./extensions.js";
+describe("isAppExtensionType", () => {
+    it("is true for a namespaced type", () => {
+        expect(isAppExtensionType("skein:canvas-invite")).toBe(true);
+    });
+    it("is false for a bare core-style type", () => {
+        expect(isAppExtensionType("heartbeat")).toBe(false);
+    });
+});
+describe("AppExtensionRegistry", () => {
+    const canvasInviteSchema = z.object({
+        v: z.literal(1),
+        type: z.literal("skein:canvas-invite"),
+        inviteId: z.string(),
+        canvasDocId: z.string(),
+        canvasTitle: z.string(),
+        originNodeId: z.string(),
+        originUsername: z.string(),
+        role: z.string(),
+        targets: z.array(z.string()),
+        acked: z.array(z.string()),
+    });
+    const message = {
+        messageType: "skein:canvas-invite",
+        payload: {
+            v: 1,
+            type: "skein:canvas-invite",
+            inviteId: "inv-1",
+            canvasDocId: "doc-canvas-1",
+            canvasTitle: "my canvas",
+            originNodeId: "node-abc123",
+            originUsername: "alice",
+            role: "member",
+            targets: ["node-def456"],
+            acked: [],
+        },
+    };
+    it("throws parse() for an unregistered message type", () => {
+        const registry = createAppExtensionRegistry();
+        expect(() => registry.parse(message)).toThrow(/no schema registered/);
+        expect(registry.isRegistered("skein:canvas-invite")).toBe(false);
+    });
+    it("parses a registered message type against its schema", () => {
+        const registry = createAppExtensionRegistry();
+        registry.register("skein:canvas-invite", canvasInviteSchema);
+        expect(registry.isRegistered("skein:canvas-invite")).toBe(true);
+        const parsed = registry.parse(message);
+        expect(parsed.inviteId).toBe("inv-1");
+        expect(parsed.targets).toEqual(["node-def456"]);
+    });
+    it("throws when the payload doesn't match the registered schema", () => {
+        const registry = createAppExtensionRegistry();
+        registry.register("skein:canvas-invite", canvasInviteSchema);
+        expect(() => registry.parse({ messageType: "skein:canvas-invite", payload: { type: "skein:canvas-invite" } })).toThrow();
+    });
+    it("unregister() removes a schema", () => {
+        const registry = createAppExtensionRegistry();
+        registry.register("skein:canvas-invite", canvasInviteSchema);
+        registry.unregister("skein:canvas-invite");
+        expect(registry.isRegistered("skein:canvas-invite")).toBe(false);
+        expect(() => registry.parse(message)).toThrow();
+    });
+});

package/dist/protocol/fixtures.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fixtures.test.d.ts.map

package/dist/protocol/fixtures.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.test.d.ts","sourceRoot":"","sources":["../../src/protocol/fixtures.test.ts"],"names":[],"mappings":""}

package/dist/protocol/fixtures.test.js

@@ -0,0 +1,51 @@
+// primary correctness test for ./protocol: every one of the 20 rust
+// fixture files (haruspex/rust/fixtures/protocol/) must parse successfully
+// through decodeFriendzMessage, and representative fixtures must round-trip
+// (re-encoding produces an equivalent value - not necessarily byte-identical
+// key order/whitespace, which doesn't matter).
+import { readFileSync, readdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, expect, it } from "vitest";
+import { decodeFriendzMessage, encodeFriendzMessageToJson } from "./codec.js";
+const here = dirname(fileURLToPath(import.meta.url));
+const fixturesDir = join(here, "..", "..", "..", "rust", "fixtures", "protocol");
+const fixtureFiles = readdirSync(fixturesDir)
+    .filter((name) => name.endsWith(".json"))
+    .sort();
+describe("protocol fixture parity", () => {
+    it("found the expected 20 fixture files", () => {
+        expect(fixtureFiles).toHaveLength(20);
+    });
+    it.each(fixtureFiles)("parses %s", (name) => {
+        const raw = JSON.parse(readFileSync(join(fixturesDir, name), "utf8"));
+        const message = decodeFriendzMessage(raw);
+        expect(message).toBeDefined();
+    });
+    it("routes the app-extension fixture through the passthrough, not the core union", () => {
+        const raw = JSON.parse(readFileSync(join(fixturesDir, "app-extension-skein-canvas-invite.json"), "utf8"));
+        const message = decodeFriendzMessage(raw);
+        expect(message.kind).toBe("app-extension");
+        if (message.kind === "app-extension") {
+            expect(message.messageType).toBe("skein:canvas-invite");
+            expect(message.payload).toEqual(raw);
+        }
+    });
+    it.each(fixtureFiles.filter((name) => name !== "app-extension-skein-canvas-invite.json"))("round-trips %s through decode -> encode as an equivalent value", (name) => {
+        const raw = JSON.parse(readFileSync(join(fixturesDir, name), "utf8"));
+        const message = decodeFriendzMessage(raw);
+        const reEncoded = encodeFriendzMessageToJson(message);
+        // decode fills in defaults (v, empty arrays) the fixture may omit,
+        // so re-decoding the re-encoded form must reach a fixed point -
+        // that's the round-trip property that matters here, not raw
+        // key-for-key equality with the original fixture.
+        expect(decodeFriendzMessage(reEncoded)).toEqual(message);
+    });
+    it("every fixture's type is either a known core type or namespaced", () => {
+        for (const name of fixtureFiles) {
+            const raw = JSON.parse(readFileSync(join(fixturesDir, name), "utf8"));
+            const message = decodeFriendzMessage(raw);
+            expect(typeof message.kind).toBe("string");
+        }
+    });
+});

package/dist/protocol/index.d.ts

@@ -0,0 +1,9 @@
+export { BrowseCapabilitySchema, CapabilitiesSchema, CORE_MESSAGE_TYPES, CoreMessageSchema, GossipDigestPendingKnockSchema, GossipDigestProfileEntrySchema, isCoreMessageType, WireKnockScopeSchema, WireKnockStatusSchema, WireRoleSchema, } from "./messages.js";
+export type { AclChangeMessage, BlobOfferMessage, BlobSeekMessage, BrowseCapability, Capabilities, CoreMessage, ErrorMessage, FriendAcceptAckMessage, FriendAcceptMessage, FriendRejectMessage, FriendRequestMessage, GossipDigestMessage, GossipDigestPendingKnock, GossipDigestProfileEntry, HeartbeatMessage, HelloMessage, HelloOkMessage, IdentityUpdateMessage, KnockAckMessage, KnockOutcomeMessage, KnockRequestMessage, OfflineAnnouncementMessage, ProfileRequestMessage, ProfileResponseMessage, WireKnockScope, WireKnockStatus, WireRole, } from "./messages.js";
+export type { AppExtensionMessage, AppExtensionRegistry } from "./extensions.js";
+export { createAppExtensionRegistry, isAppExtensionType } from "./extensions.js";
+export type { FriendzMessage } from "./codec.js";
+export { decodeFriendzMessage, decodeMessage, encodeFriendzMessageToJson, encodeMessage, frameMessage, friendzMessageType, FrameReader, } from "./codec.js";
+export type { BiStreamLike, FriendzClient, FriendzClientOptions, MiddenNodeLike, } from "./client.js";
+export { createFriendzClient, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_HEARTBEAT_TIMEOUT_MS, } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,8BAA8B,EAC9B,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,GACf,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,QAAQ,GACT,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,0BAA0B,EAC1B,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,aAAa,CAAC"}

package/dist/protocol/index.js

@@ -0,0 +1,4 @@
+export { BrowseCapabilitySchema, CapabilitiesSchema, CORE_MESSAGE_TYPES, CoreMessageSchema, GossipDigestPendingKnockSchema, GossipDigestProfileEntrySchema, isCoreMessageType, WireKnockScopeSchema, WireKnockStatusSchema, WireRoleSchema, } from "./messages.js";
+export { createAppExtensionRegistry, isAppExtensionType } from "./extensions.js";
+export { decodeFriendzMessage, decodeMessage, encodeFriendzMessageToJson, encodeMessage, frameMessage, friendzMessageType, FrameReader, } from "./codec.js";
+export { createFriendzClient, DEFAULT_HEARTBEAT_INTERVAL_MS, DEFAULT_HEARTBEAT_TIMEOUT_MS, } from "./client.js";

package/dist/protocol/messages.d.ts

@@ -0,0 +1,480 @@
+import { z } from "zod";
+/** the grantable role vocabulary carried on the wire (knock-outcome, acl-change). */
+export declare const WireRoleSchema: z.ZodEnum<{
+    member: "member";
+    viewer: "viewer";
+    root: "root";
+    admin: "admin";
+}>;
+export type WireRole = z.infer<typeof WireRoleSchema>;
+/** resolution of a knock request. */
+export declare const WireKnockStatusSchema: z.ZodEnum<{
+    denied: "denied";
+    pending: "pending";
+    accepted: "accepted";
+}>;
+export type WireKnockStatus = z.infer<typeof WireKnockStatusSchema>;
+/** whether a peer may browse without knocking first, or must knock. */
+export declare const BrowseCapabilitySchema: z.ZodEnum<{
+    public: "public";
+    knock: "knock";
+}>;
+export type BrowseCapability = z.infer<typeof BrowseCapabilitySchema>;
+/** capability bag carried on the hello/hello-ok handshake. */
+export declare const CapabilitiesSchema: z.ZodObject<{
+    browse: z.ZodEnum<{
+        public: "public";
+        knock: "knock";
+    }>;
+}, z.core.$strip>;
+export type Capabilities = z.infer<typeof CapabilitiesSchema>;
+/**
+ * the wire shape of a knock's scope: what access is being requested.
+ *   - account: acceptance creates or links a user identity
+ *   - browse: list access, no specific resource named
+ *   - resource: access to one named resource, with an optional requested role
+ */
+export declare const WireKnockScopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"account">;
+    requestedUsername: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"browse">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"resource">;
+    resourceId: z.ZodString;
+    requestedRole: z.ZodOptional<z.ZodEnum<{
+        member: "member";
+        viewer: "viewer";
+        root: "root";
+        admin: "admin";
+    }>>;
+}, z.core.$strip>], "kind">;
+export type WireKnockScope = z.infer<typeof WireKnockScopeSchema>;
+/** a pending-knock entry gossiped in a gossip-digest message. */
+export declare const GossipDigestPendingKnockSchema: z.ZodObject<{
+    knockId: z.ZodString;
+    nodeId: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    message: z.ZodString;
+    scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"account">;
+        requestedUsername: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"browse">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"resource">;
+        resourceId: z.ZodString;
+        requestedRole: z.ZodOptional<z.ZodEnum<{
+            member: "member";
+            viewer: "viewer";
+            root: "root";
+            admin: "admin";
+        }>>;
+    }, z.core.$strip>], "kind">;
+    knockedAt: z.ZodString;
+}, z.core.$strip>;
+export type GossipDigestPendingKnock = z.infer<typeof GossipDigestPendingKnockSchema>;
+/** a profile-doc pointer entry in a gossip digest. */
+export declare const GossipDigestProfileEntrySchema: z.ZodObject<{
+    peerNodeId: z.ZodString;
+    profileDocId: z.ZodString;
+    updatedAt: z.ZodString;
+}, z.core.$strip>;
+export type GossipDigestProfileEntry = z.infer<typeof GossipDigestProfileEntrySchema>;
+declare const ProfileRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"profile-request">;
+    v: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+declare const ProfileResponseSchema: z.ZodObject<{
+    type: z.ZodLiteral<"profile-response">;
+    v: z.ZodDefault<z.ZodNumber>;
+    username: z.ZodString;
+    bio: z.ZodString;
+    avatarDataUrl: z.ZodString;
+    accentColor: z.ZodOptional<z.ZodNumber>;
+    profileDocId: z.ZodOptional<z.ZodString>;
+    profileUpdatedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const FriendRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"friend-request">;
+    v: z.ZodDefault<z.ZodNumber>;
+    fromNodeId: z.ZodString;
+    fromUsername: z.ZodString;
+    isHub: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const FriendAcceptSchema: z.ZodObject<{
+    type: z.ZodLiteral<"friend-accept">;
+    v: z.ZodDefault<z.ZodNumber>;
+    fromNodeId: z.ZodString;
+    fromUsername: z.ZodString;
+    isHub: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const FriendAcceptAckSchema: z.ZodObject<{
+    type: z.ZodLiteral<"friend-accept-ack">;
+    v: z.ZodDefault<z.ZodNumber>;
+    fromNodeId: z.ZodString;
+}, z.core.$strip>;
+declare const FriendRejectSchema: z.ZodObject<{
+    type: z.ZodLiteral<"friend-reject">;
+    v: z.ZodDefault<z.ZodNumber>;
+    fromNodeId: z.ZodString;
+}, z.core.$strip>;
+declare const HeartbeatSchema: z.ZodObject<{
+    type: z.ZodLiteral<"heartbeat">;
+    v: z.ZodDefault<z.ZodNumber>;
+    nodeId: z.ZodString;
+    username: z.ZodString;
+    appPayload: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+declare const OfflineAnnouncementSchema: z.ZodObject<{
+    type: z.ZodLiteral<"offline-announcement">;
+    v: z.ZodDefault<z.ZodNumber>;
+    nodeId: z.ZodString;
+}, z.core.$strip>;
+declare const HelloSchema: z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    v: z.ZodDefault<z.ZodNumber>;
+    nodeId: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    avatarBlobId: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodObject<{
+        browse: z.ZodEnum<{
+            public: "public";
+            knock: "knock";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const HelloOkSchema: z.ZodObject<{
+    type: z.ZodLiteral<"hello-ok">;
+    v: z.ZodDefault<z.ZodNumber>;
+    nodeId: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    avatarBlobId: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodObject<{
+        browse: z.ZodEnum<{
+            public: "public";
+            knock: "knock";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const KnockRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"knock-request">;
+    v: z.ZodDefault<z.ZodNumber>;
+    knockId: z.ZodString;
+    nodeId: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    message: z.ZodString;
+    scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"account">;
+        requestedUsername: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"browse">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"resource">;
+        resourceId: z.ZodString;
+        requestedRole: z.ZodOptional<z.ZodEnum<{
+            member: "member";
+            viewer: "viewer";
+            root: "root";
+            admin: "admin";
+        }>>;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>;
+declare const KnockAckSchema: z.ZodObject<{
+    type: z.ZodLiteral<"knock-ack">;
+    v: z.ZodDefault<z.ZodNumber>;
+    knockId: z.ZodString;
+    ackerNodeId: z.ZodString;
+    resourceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const KnockOutcomeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"knock-outcome">;
+    v: z.ZodDefault<z.ZodNumber>;
+    knockId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        denied: "denied";
+        pending: "pending";
+        accepted: "accepted";
+    }>;
+    grantedRole: z.ZodOptional<z.ZodEnum<{
+        member: "member";
+        viewer: "viewer";
+        root: "root";
+        admin: "admin";
+    }>>;
+    grantedResourceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    byNodeId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const IdentityUpdateSchema: z.ZodObject<{
+    type: z.ZodLiteral<"identity-update">;
+    v: z.ZodDefault<z.ZodNumber>;
+    nodeId: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    avatarDataUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const AclChangeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"acl-change">;
+    v: z.ZodDefault<z.ZodNumber>;
+    resourceId: z.ZodString;
+    resourceTitle: z.ZodOptional<z.ZodString>;
+    targetNodeId: z.ZodString;
+    newRole: z.ZodOptional<z.ZodEnum<{
+        member: "member";
+        viewer: "viewer";
+        root: "root";
+        admin: "admin";
+    }>>;
+    changedBy: z.ZodString;
+    changedByUsername: z.ZodString;
+}, z.core.$strip>;
+declare const GossipDigestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"gossip-digest">;
+    v: z.ZodDefault<z.ZodNumber>;
+    pendingKnocks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        knockId: z.ZodString;
+        nodeId: z.ZodString;
+        username: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"account">;
+            requestedUsername: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"browse">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"resource">;
+            resourceId: z.ZodString;
+            requestedRole: z.ZodOptional<z.ZodEnum<{
+                member: "member";
+                viewer: "viewer";
+                root: "root";
+                admin: "admin";
+            }>>;
+        }, z.core.$strip>], "kind">;
+        knockedAt: z.ZodString;
+    }, z.core.$strip>>>;
+    profiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        peerNodeId: z.ZodString;
+        profileDocId: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>>;
+    appPayload: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+declare const BlobSeekSchema: z.ZodObject<{
+    type: z.ZodLiteral<"blob-seek">;
+    v: z.ZodDefault<z.ZodNumber>;
+    needed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const BlobOfferSchema: z.ZodObject<{
+    type: z.ZodLiteral<"blob-offer">;
+    v: z.ZodDefault<z.ZodNumber>;
+    available: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+declare const ErrorMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    v: z.ZodDefault<z.ZodNumber>;
+    code: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+/** the discriminated union of every core (non-namespaced) friendz message. */
+export declare const CoreMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"profile-request">;
+    v: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"profile-response">;
+    v: z.ZodDefault<z.ZodNumber>;
+    username: z.ZodString;
+    bio: z.ZodString;
+    avatarDataUrl: z.ZodString;
+    accentColor: z.ZodOptional<z.ZodNumber>;
+    profileDocId: z.ZodOptional<z.ZodString>;
+    profileUpdatedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"friend-request">;
+    v: z.ZodDefault<z.ZodNumber>;
+    fromNodeId: z.ZodString;
+    fromUsername: z.ZodString;
+    isHub: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"friend-accept">;
+    v: z.ZodDefault<z.ZodNumber>;
+    fromNodeId: z.ZodString;
+    fromUsername: z.ZodString;
+    isHub: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"friend-accept-ack">;
+    v: z.ZodDefault<z.ZodNumber>;
+    fromNodeId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"friend-reject">;
+    v: z.ZodDefault<z.ZodNumber>;
+    fromNodeId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"heartbeat">;
+    v: z.ZodDefault<z.ZodNumber>;
+    nodeId: z.ZodString;
+    username: z.ZodString;
+    appPayload: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"offline-announcement">;
+    v: z.ZodDefault<z.ZodNumber>;
+    nodeId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    v: z.ZodDefault<z.ZodNumber>;
+    nodeId: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    avatarBlobId: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodObject<{
+        browse: z.ZodEnum<{
+            public: "public";
+            knock: "knock";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"hello-ok">;
+    v: z.ZodDefault<z.ZodNumber>;
+    nodeId: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    avatarBlobId: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodObject<{
+        browse: z.ZodEnum<{
+            public: "public";
+            knock: "knock";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"knock-request">;
+    v: z.ZodDefault<z.ZodNumber>;
+    knockId: z.ZodString;
+    nodeId: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    message: z.ZodString;
+    scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"account">;
+        requestedUsername: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"browse">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"resource">;
+        resourceId: z.ZodString;
+        requestedRole: z.ZodOptional<z.ZodEnum<{
+            member: "member";
+            viewer: "viewer";
+            root: "root";
+            admin: "admin";
+        }>>;
+    }, z.core.$strip>], "kind">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"knock-ack">;
+    v: z.ZodDefault<z.ZodNumber>;
+    knockId: z.ZodString;
+    ackerNodeId: z.ZodString;
+    resourceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"knock-outcome">;
+    v: z.ZodDefault<z.ZodNumber>;
+    knockId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        denied: "denied";
+        pending: "pending";
+        accepted: "accepted";
+    }>;
+    grantedRole: z.ZodOptional<z.ZodEnum<{
+        member: "member";
+        viewer: "viewer";
+        root: "root";
+        admin: "admin";
+    }>>;
+    grantedResourceIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    byNodeId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"identity-update">;
+    v: z.ZodDefault<z.ZodNumber>;
+    nodeId: z.ZodString;
+    username: z.ZodOptional<z.ZodString>;
+    avatarDataUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"acl-change">;
+    v: z.ZodDefault<z.ZodNumber>;
+    resourceId: z.ZodString;
+    resourceTitle: z.ZodOptional<z.ZodString>;
+    targetNodeId: z.ZodString;
+    newRole: z.ZodOptional<z.ZodEnum<{
+        member: "member";
+        viewer: "viewer";
+        root: "root";
+        admin: "admin";
+    }>>;
+    changedBy: z.ZodString;
+    changedByUsername: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"gossip-digest">;
+    v: z.ZodDefault<z.ZodNumber>;
+    pendingKnocks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        knockId: z.ZodString;
+        nodeId: z.ZodString;
+        username: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"account">;
+            requestedUsername: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"browse">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodLiteral<"resource">;
+            resourceId: z.ZodString;
+            requestedRole: z.ZodOptional<z.ZodEnum<{
+                member: "member";
+                viewer: "viewer";
+                root: "root";
+                admin: "admin";
+            }>>;
+        }, z.core.$strip>], "kind">;
+        knockedAt: z.ZodString;
+    }, z.core.$strip>>>;
+    profiles: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        peerNodeId: z.ZodString;
+        profileDocId: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>>;
+    appPayload: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"blob-seek">;
+    v: z.ZodDefault<z.ZodNumber>;
+    needed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"blob-offer">;
+    v: z.ZodDefault<z.ZodNumber>;
+    available: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    v: z.ZodDefault<z.ZodNumber>;
+    code: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>], "type">;
+export type CoreMessage = z.infer<typeof CoreMessageSchema>;
+export type ProfileRequestMessage = z.infer<typeof ProfileRequestSchema>;
+export type ProfileResponseMessage = z.infer<typeof ProfileResponseSchema>;
+export type FriendRequestMessage = z.infer<typeof FriendRequestSchema>;
+export type FriendAcceptMessage = z.infer<typeof FriendAcceptSchema>;
+export type FriendAcceptAckMessage = z.infer<typeof FriendAcceptAckSchema>;
+export type FriendRejectMessage = z.infer<typeof FriendRejectSchema>;
+export type HeartbeatMessage = z.infer<typeof HeartbeatSchema>;
+export type OfflineAnnouncementMessage = z.infer<typeof OfflineAnnouncementSchema>;
+export type HelloMessage = z.infer<typeof HelloSchema>;
+export type HelloOkMessage = z.infer<typeof HelloOkSchema>;
+export type KnockRequestMessage = z.infer<typeof KnockRequestSchema>;
+export type KnockAckMessage = z.infer<typeof KnockAckSchema>;
+export type KnockOutcomeMessage = z.infer<typeof KnockOutcomeSchema>;
+export type IdentityUpdateMessage = z.infer<typeof IdentityUpdateSchema>;
+export type AclChangeMessage = z.infer<typeof AclChangeSchema>;
+export type GossipDigestMessage = z.infer<typeof GossipDigestSchema>;
+export type BlobSeekMessage = z.infer<typeof BlobSeekSchema>;
+export type BlobOfferMessage = z.infer<typeof BlobOfferSchema>;
+export type ErrorMessage = z.infer<typeof ErrorMessageSchema>;
+/** every core message's wire `type` discriminant, in enum-declaration order. */
+export declare const CORE_MESSAGE_TYPES: readonly ["profile-request", "profile-response", "friend-request", "friend-accept", "friend-accept-ack", "friend-reject", "heartbeat", "offline-announcement", "hello", "hello-ok", "knock-request", "knock-ack", "knock-outcome", "identity-update", "acl-change", "gossip-digest", "blob-seek", "blob-offer", "error"];
+/** is `type` one of the core (non-namespaced) message types above? */
+export declare function isCoreMessageType(type: string): boolean;
+export {};
+//# sourceMappingURL=messages.d.ts.map

package/dist/protocol/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/protocol/messages.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,qFAAqF;AACrF,eAAO,MAAM,cAAc;;;;;EAAgD,CAAC;AAC5E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,qCAAqC;AACrC,eAAO,MAAM,qBAAqB;;;;EAA4C,CAAC;AAC/E,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,uEAAuE;AACvE,eAAO,MAAM,sBAAsB;;;EAA8B,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB;;;;;iBAE7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;2BAa/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,iEAAiE;AACjE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;iBAOzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,sDAAsD;AACtD,eAAO,MAAM,8BAA8B;;;;iBAIzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAMtF,QAAA,MAAM,oBAAoB;;;iBAGxB,CAAC;AAEH,QAAA,MAAM,qBAAqB;;;;;;;;;iBASzB,CAAC;AAEH,QAAA,MAAM,mBAAmB;;;;;;iBAMvB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;iBAMtB,CAAC;AAEH,QAAA,MAAM,qBAAqB;;;;iBAIzB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;iBAItB,CAAC;AAEH,QAAA,MAAM,eAAe;;;;;;iBAMnB,CAAC;AAEH,QAAA,MAAM,yBAAyB;;;;iBAI7B,CAAC;AAEH,QAAA,MAAM,WAAW;;;;;;;;;;;;iBAOf,CAAC;AAEH,QAAA,MAAM,aAAa;;;;;;;;;;;;iBAOjB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;iBAQtB,CAAC;AAEH,QAAA,MAAM,cAAc;;;;;;iBAMlB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;iBAQtB,CAAC;AAEH,QAAA,MAAM,oBAAoB;;;;;;iBAMxB,CAAC;AAEH,QAAA,MAAM,eAAe;;;;;;;;;;;;;;iBASnB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMtB,CAAC;AAEH,QAAA,MAAM,cAAc;;;;iBAIlB,CAAC;AAEH,QAAA,MAAM,eAAe;;;;iBAInB,CAAC;AAEH,QAAA,MAAM,kBAAkB;;;;;iBAKtB,CAAC;AAEH,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAoB5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACzE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC3E,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AACvE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACrE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC3E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC/D,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACnF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC3D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACrE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC7D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACrE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACzE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC/D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACrE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC7D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC/D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,gFAAgF;AAChF,eAAO,MAAM,kBAAkB,0TAoBrB,CAAC;AAEX,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}