@garydevenay/emporion 0.0.1

package/dist/src/protocol/messaging.d.ts

@@ -0,0 +1,87 @@
+import type { ProtocolEnvelope } from "./envelope.js";
+import { type ProtocolJsonObject } from "./shared.js";
+export type SpaceKind = "direct-inbox" | "contract-thread" | "company-room" | "market-room";
+export interface MembershipPolicy {
+    mode: "invite-only" | "owner-controlled" | "public-read";
+    ownerMemberDids: string[];
+}
+export interface EncryptionPolicy {
+    mode: "none" | "member-sealed-box";
+    keyAgreementMethod: "did-keyagreement-v1";
+}
+export interface OwnerRef {
+    kind: "agent" | "company" | "marketplace" | "contract" | "dispute";
+    id: string;
+}
+export interface SpaceState {
+    objectId: string;
+    spaceId: string;
+    spaceKind: SpaceKind;
+    ownerRef: OwnerRef;
+    membershipPolicy: MembershipPolicy;
+    encryptionPolicy: EncryptionPolicy;
+    status: "active" | "archived";
+    latestEventId: string;
+    eventIds: string[];
+}
+export interface SpaceMembershipState {
+    objectId: string;
+    spaceId: string;
+    memberDid: string;
+    role: "owner" | "moderator" | "member";
+    status: "active" | "removed" | "muted";
+    latestEventId: string;
+    eventIds: string[];
+}
+export interface EncryptedRecipientBox {
+    recipientDid: string;
+    nonce: string;
+    ciphertext: string;
+}
+export interface EncryptedMessageBody {
+    senderDid: string;
+    senderKeyAgreementPublicKey: string;
+    recipientBoxes: EncryptedRecipientBox[];
+}
+export interface MessageState {
+    objectId: string;
+    spaceId: string;
+    senderDid: string;
+    messageType: string;
+    metadata: ProtocolJsonObject;
+    encryptedBody: EncryptedMessageBody;
+    status: "sent" | "edited" | "deleted";
+    reactions: Record<string, string[]>;
+    latestEventId: string;
+    eventIds: string[];
+}
+export declare function encryptMessageForRecipients(input: {
+    plaintext: string;
+    senderDid: string;
+    senderKeyAgreementPublicKey: string;
+    senderKeyAgreementSecretKey: Uint8Array;
+    recipientDids: string[];
+}): Promise<EncryptedMessageBody>;
+export declare function decryptEncryptedMessageBody(input: {
+    encryptedBody: EncryptedMessageBody;
+    recipientDid: string;
+    recipientKeyAgreementSecretKey: Uint8Array;
+}): string;
+export declare function applySpaceEvent(currentState: SpaceState | undefined, envelope: ProtocolEnvelope): SpaceState;
+export declare function applySpaceMembershipEvent(currentState: SpaceMembershipState | undefined, envelope: ProtocolEnvelope, refs: {
+    spaces: Map<string, SpaceState>;
+    memberships: Map<string, SpaceMembershipState>;
+}): SpaceMembershipState;
+export declare function applyMessageEvent(currentState: MessageState | undefined, envelope: ProtocolEnvelope, refs: {
+    spaces: Map<string, SpaceState>;
+    memberships: Map<string, SpaceMembershipState>;
+}): MessageState;
+export declare function spacePayloadToJson(payload: Omit<SpaceState, "objectId" | "spaceId" | "status" | "latestEventId" | "eventIds">): ProtocolJsonObject;
+export declare function spaceMembershipPayloadToJson(payload: Omit<SpaceMembershipState, "objectId" | "status" | "latestEventId" | "eventIds">): ProtocolJsonObject;
+export declare function messageSentPayloadToJson(payload: {
+    spaceId: string;
+    messageType: string;
+    metadata: ProtocolJsonObject;
+    encryptedBody: EncryptedMessageBody;
+    sentAt?: string;
+}): ProtocolJsonObject;

package/dist/src/protocol/messaging.js

@@ -0,0 +1,296 @@
+import { randomBytes } from "node:crypto";
+import bs58 from "bs58";
+import nacl from "tweetnacl";
+import { extractKeyAgreementPublicKeyMultibase, resolveDidDocument } from "../did.js";
+import { ProtocolConflictError, ProtocolValidationError } from "../errors.js";
+import { assertIsoTimestamp, decodeBase64Url, encodeBase64Url } from "./shared.js";
+const X25519_MULTICODEC_PREFIX = Buffer.from([0xec, 0x01]);
+function assertNonEmpty(value, fieldName) {
+    if (value.trim().length === 0) {
+        throw new ProtocolValidationError(`${fieldName} must not be blank`);
+    }
+}
+function ensureLatestPredecessor(state, envelope, createEventKind) {
+    if (!state) {
+        if (envelope.eventKind !== createEventKind) {
+            throw new ProtocolConflictError(`The first event must be ${createEventKind}`);
+        }
+        if (envelope.previousEventIds.length !== 0) {
+            throw new ProtocolConflictError(`${createEventKind} must not reference previous events`);
+        }
+        return;
+    }
+    if (envelope.previousEventIds.length === 0 || !envelope.previousEventIds.includes(state.latestEventId)) {
+        throw new ProtocolConflictError("Event must reference the latest event");
+    }
+}
+function decodeX25519Multibase(publicKeyMultibase) {
+    if (!publicKeyMultibase.startsWith("z")) {
+        throw new ProtocolValidationError("Messaging keys must use base58-btc multibase");
+    }
+    const decoded = Buffer.from(bs58.decode(publicKeyMultibase.slice(1)));
+    if (decoded.byteLength < 3 || decoded[0] !== X25519_MULTICODEC_PREFIX[0] || decoded[1] !== X25519_MULTICODEC_PREFIX[1]) {
+        throw new ProtocolValidationError("Messaging key multibase is not an X25519 multicodec");
+    }
+    return decoded.subarray(2);
+}
+function activeMembersForSpace(spaceId, memberships) {
+    const results = new Map();
+    for (const membership of memberships.values()) {
+        if (membership.spaceId === spaceId && membership.status !== "removed") {
+            results.set(membership.memberDid, membership);
+        }
+    }
+    return results;
+}
+function assertCanManageMembership(space, actorDid, memberships) {
+    if (space.membershipPolicy.ownerMemberDids.includes(actorDid)) {
+        return;
+    }
+    const membership = activeMembersForSpace(space.spaceId, memberships).get(actorDid);
+    if (membership?.role === "owner" || membership?.role === "moderator") {
+        return;
+    }
+    throw new ProtocolConflictError("Only owners or moderators can manage space membership");
+}
+function assertActiveMember(spaceId, actorDid, memberships) {
+    const membership = activeMembersForSpace(spaceId, memberships).get(actorDid);
+    if (!membership || membership.status !== "active") {
+        throw new ProtocolConflictError("Actor must be an active member of the space");
+    }
+    return membership;
+}
+export async function encryptMessageForRecipients(input) {
+    const recipientBoxes = [];
+    const recipientSet = [...new Set([input.senderDid, ...input.recipientDids])].sort();
+    for (const recipientDid of recipientSet) {
+        const resolved = await resolveDidDocument(recipientDid);
+        const publicKeyMultibase = extractKeyAgreementPublicKeyMultibase(resolved.didDocument);
+        const recipientPublicKey = decodeX25519Multibase(publicKeyMultibase);
+        const nonce = randomBytes(nacl.box.nonceLength);
+        const ciphertext = nacl.box(Buffer.from(input.plaintext, "utf8"), nonce, recipientPublicKey, input.senderKeyAgreementSecretKey);
+        recipientBoxes.push({
+            recipientDid,
+            nonce: encodeBase64Url(nonce),
+            ciphertext: encodeBase64Url(ciphertext)
+        });
+    }
+    return {
+        senderDid: input.senderDid,
+        senderKeyAgreementPublicKey: input.senderKeyAgreementPublicKey,
+        recipientBoxes
+    };
+}
+export function decryptEncryptedMessageBody(input) {
+    const recipientBox = input.encryptedBody.recipientBoxes.find((entry) => entry.recipientDid === input.recipientDid);
+    if (!recipientBox) {
+        throw new ProtocolConflictError(`Encrypted message body was not addressed to ${input.recipientDid}`);
+    }
+    const plaintext = nacl.box.open(decodeBase64Url(recipientBox.ciphertext), decodeBase64Url(recipientBox.nonce), Buffer.from(input.encryptedBody.senderKeyAgreementPublicKey, "hex"), input.recipientKeyAgreementSecretKey);
+    if (!plaintext) {
+        throw new ProtocolConflictError("Failed to decrypt the message body");
+    }
+    return Buffer.from(plaintext).toString("utf8");
+}
+export function applySpaceEvent(currentState, envelope) {
+    if (envelope.objectKind !== "space") {
+        throw new ProtocolValidationError("Envelope is not a space event");
+    }
+    ensureLatestPredecessor(currentState, envelope, "space.created");
+    switch (envelope.eventKind) {
+        case "space.created": {
+            const payload = envelope.payload;
+            if (payload.membershipPolicy.ownerMemberDids.length === 0) {
+                throw new ProtocolValidationError("Space membershipPolicy.ownerMemberDids must not be empty");
+            }
+            return {
+                objectId: envelope.objectId,
+                spaceId: envelope.objectId,
+                spaceKind: payload.spaceKind,
+                ownerRef: payload.ownerRef,
+                membershipPolicy: payload.membershipPolicy,
+                encryptionPolicy: payload.encryptionPolicy,
+                status: "active",
+                latestEventId: envelope.eventId,
+                eventIds: [envelope.eventId]
+            };
+        }
+        case "space.archived":
+            if (!currentState) {
+                throw new ProtocolConflictError("Cannot archive a space before it is created");
+            }
+            return {
+                ...currentState,
+                status: "archived",
+                latestEventId: envelope.eventId,
+                eventIds: [...currentState.eventIds, envelope.eventId]
+            };
+        default:
+            throw new ProtocolValidationError(`Unsupported space event: ${envelope.eventKind}`);
+    }
+}
+export function applySpaceMembershipEvent(currentState, envelope, refs) {
+    if (envelope.objectKind !== "space-membership") {
+        throw new ProtocolValidationError("Envelope is not a space-membership event");
+    }
+    ensureLatestPredecessor(currentState, envelope, "space-membership.member-added");
+    switch (envelope.eventKind) {
+        case "space-membership.member-added": {
+            const payload = envelope.payload;
+            const space = refs.spaces.get(payload.spaceId);
+            if (!space) {
+                throw new ProtocolConflictError("Space membership target space does not exist");
+            }
+            if (currentState) {
+                throw new ProtocolConflictError("space-membership.member-added cannot be appended twice");
+            }
+            if (refs.memberships.size > 0 &&
+                !space.membershipPolicy.ownerMemberDids.includes(envelope.actorDid) &&
+                activeMembersForSpace(payload.spaceId, refs.memberships).size > 0) {
+                assertCanManageMembership(space, envelope.actorDid, refs.memberships);
+            }
+            return {
+                objectId: envelope.objectId,
+                spaceId: payload.spaceId,
+                memberDid: payload.memberDid,
+                role: payload.role,
+                status: "active",
+                latestEventId: envelope.eventId,
+                eventIds: [envelope.eventId]
+            };
+        }
+        case "space-membership.member-removed":
+            if (!currentState) {
+                throw new ProtocolConflictError("Cannot remove a space member before it is added");
+            }
+            assertCanManageMembership(refs.spaces.get(currentState.spaceId), envelope.actorDid, refs.memberships);
+            return {
+                ...currentState,
+                status: "removed",
+                latestEventId: envelope.eventId,
+                eventIds: [...currentState.eventIds, envelope.eventId]
+            };
+        case "space-membership.member-muted":
+            if (!currentState) {
+                throw new ProtocolConflictError("Cannot mute a space member before it is added");
+            }
+            assertCanManageMembership(refs.spaces.get(currentState.spaceId), envelope.actorDid, refs.memberships);
+            return {
+                ...currentState,
+                status: "muted",
+                latestEventId: envelope.eventId,
+                eventIds: [...currentState.eventIds, envelope.eventId]
+            };
+        case "space-membership.member-role-updated": {
+            if (!currentState) {
+                throw new ProtocolConflictError("Cannot update a space member role before it is added");
+            }
+            assertCanManageMembership(refs.spaces.get(currentState.spaceId), envelope.actorDid, refs.memberships);
+            const role = String(envelope.payload.role ?? "");
+            return {
+                ...currentState,
+                role,
+                latestEventId: envelope.eventId,
+                eventIds: [...currentState.eventIds, envelope.eventId]
+            };
+        }
+        default:
+            throw new ProtocolValidationError(`Unsupported space-membership event: ${envelope.eventKind}`);
+    }
+}
+export function applyMessageEvent(currentState, envelope, refs) {
+    if (envelope.objectKind !== "message") {
+        throw new ProtocolValidationError("Envelope is not a message event");
+    }
+    ensureLatestPredecessor(currentState, envelope, "message.sent");
+    switch (envelope.eventKind) {
+        case "message.sent": {
+            const payload = envelope.payload;
+            const space = refs.spaces.get(payload.spaceId);
+            if (!space) {
+                throw new ProtocolConflictError("Message target space does not exist");
+            }
+            assertActiveMember(payload.spaceId, envelope.actorDid, refs.memberships);
+            if (space.status !== "active") {
+                throw new ProtocolConflictError("Messages cannot be sent to an archived space");
+            }
+            if (payload.encryptedBody.senderDid !== envelope.actorDid) {
+                throw new ProtocolConflictError("Encrypted message senderDid must match the actor DID");
+            }
+            if (payload.sentAt) {
+                assertIsoTimestamp(payload.sentAt, "Message.sentAt");
+            }
+            return {
+                objectId: envelope.objectId,
+                spaceId: payload.spaceId,
+                senderDid: envelope.actorDid,
+                messageType: payload.messageType,
+                metadata: payload.metadata,
+                encryptedBody: payload.encryptedBody,
+                status: "sent",
+                reactions: {},
+                latestEventId: envelope.eventId,
+                eventIds: [envelope.eventId]
+            };
+        }
+        case "message.edited": {
+            if (!currentState) {
+                throw new ProtocolConflictError("Cannot edit a message before it is sent");
+            }
+            if (currentState.senderDid !== envelope.actorDid) {
+                throw new ProtocolConflictError("Only the sender can edit a message");
+            }
+            const payload = envelope.payload;
+            return {
+                ...currentState,
+                metadata: payload.metadata ?? currentState.metadata,
+                encryptedBody: payload.encryptedBody,
+                status: "edited",
+                latestEventId: envelope.eventId,
+                eventIds: [...currentState.eventIds, envelope.eventId]
+            };
+        }
+        case "message.deleted":
+            if (!currentState) {
+                throw new ProtocolConflictError("Cannot delete a message before it is sent");
+            }
+            if (currentState.senderDid !== envelope.actorDid) {
+                throw new ProtocolConflictError("Only the sender can delete a message");
+            }
+            return {
+                ...currentState,
+                status: "deleted",
+                latestEventId: envelope.eventId,
+                eventIds: [...currentState.eventIds, envelope.eventId]
+            };
+        case "message.reacted": {
+            if (!currentState) {
+                throw new ProtocolConflictError("Cannot react to a message before it is sent");
+            }
+            assertActiveMember(currentState.spaceId, envelope.actorDid, refs.memberships);
+            const reaction = String(envelope.payload.reaction ?? "");
+            assertNonEmpty(reaction, "Message.reaction");
+            return {
+                ...currentState,
+                reactions: {
+                    ...currentState.reactions,
+                    [reaction]: [...new Set([...(currentState.reactions[reaction] ?? []), envelope.actorDid])].sort()
+                },
+                latestEventId: envelope.eventId,
+                eventIds: [...currentState.eventIds, envelope.eventId]
+            };
+        }
+        default:
+            throw new ProtocolValidationError(`Unsupported message event: ${envelope.eventKind}`);
+    }
+}
+export function spacePayloadToJson(payload) {
+    return payload;
+}
+export function spaceMembershipPayloadToJson(payload) {
+    return payload;
+}
+export function messageSentPayloadToJson(payload) {
+    return payload;
+}
+//# sourceMappingURL=messaging.js.map

package/dist/src/protocol/messaging.js.map

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

package/dist/src/protocol/repository.d.ts

@@ -0,0 +1,87 @@
+import type { Logger } from "../logger.js";
+import { type CompanyState } from "./company.js";
+import { type ContractState } from "./contracts.js";
+import { type FeedbackCredentialRefState } from "./credential-reference.js";
+import { type ProtocolEnvelope } from "./envelope.js";
+import { type AgentProfileState } from "./identity.js";
+import { type AgreementState, type BidState, type ListingState, type OfferState, type ProductState, type RequestState } from "./market.js";
+import { type DisputeCaseState, type EvidenceBundleState, type OracleAttestationState } from "./resolution.js";
+import { type MessageState, type SpaceMembershipState, type SpaceState } from "./messaging.js";
+type ObjectState = AgentProfileState | CompanyState | ProductState | ListingState | RequestState | OfferState | BidState | AgreementState | FeedbackCredentialRefState | ContractState | EvidenceBundleState | OracleAttestationState | DisputeCaseState | SpaceState | SpaceMembershipState | MessageState;
+interface ObjectCatalogRecord {
+    protocol: ProtocolEnvelope["protocol"];
+    version: ProtocolEnvelope["version"];
+    objectKind: ProtocolEnvelope["objectKind"];
+    objectId: string;
+    feedName: string;
+    feedKey: string;
+    headEventId: string;
+    subjectId: string;
+    actorDid: string;
+    marketplaceId: string | undefined;
+    companyDid: string | undefined;
+    updatedAt: string;
+}
+interface MarketplaceIndexEntry {
+    objectKind: ProtocolEnvelope["objectKind"];
+    objectId: string;
+    marketplaceId: string;
+    status: string;
+    updatedAt: string;
+}
+interface SpaceIndexEntry {
+    objectKind: "space" | "space-membership" | "message";
+    objectId: string;
+    spaceId: string;
+    status: string;
+    updatedAt: string;
+}
+interface ProtocolStateSnapshot {
+    agentProfiles: Map<string, AgentProfileState>;
+    companies: Map<string, CompanyState>;
+    products: Map<string, ProductState>;
+    listings: Map<string, ListingState>;
+    requests: Map<string, RequestState>;
+    offers: Map<string, OfferState>;
+    bids: Map<string, BidState>;
+    agreements: Map<string, AgreementState>;
+    feedbackCredentialRefs: Map<string, FeedbackCredentialRefState>;
+    contracts: Map<string, ContractState>;
+    evidenceBundles: Map<string, EvidenceBundleState>;
+    oracleAttestations: Map<string, OracleAttestationState>;
+    disputes: Map<string, DisputeCaseState>;
+    spaces: Map<string, SpaceState>;
+    spaceMemberships: Map<string, SpaceMembershipState>;
+    messages: Map<string, MessageState>;
+}
+export declare class ProtocolRepository {
+    private readonly store;
+    private readonly logger;
+    private readonly logs;
+    private readonly stateBee;
+    private readonly catalogBee;
+    private readonly controlBee;
+    private readonly marketBee;
+    private readonly companyBee;
+    private readonly contractBee;
+    private readonly spaceBee;
+    private readonly snapshot;
+    private constructor();
+    static create(dataDir: string, options?: {
+        logger?: Logger;
+    }): Promise<ProtocolRepository>;
+    private static openBee;
+    appendEnvelope(envelope: ProtocolEnvelope): Promise<void>;
+    getSnapshot(): Readonly<ProtocolStateSnapshot>;
+    rebuildFromLogs(): Promise<void>;
+    listMarketplaceEntries(marketplaceId: string): Promise<MarketplaceIndexEntry[]>;
+    listContractEntries(contractId: string): Promise<ObjectCatalogRecord[]>;
+    listSpaceEntries(spaceId: string): Promise<SpaceIndexEntry[]>;
+    listCatalogRecords(): Promise<ObjectCatalogRecord[]>;
+    readObjectState(objectKind: ProtocolEnvelope["objectKind"], objectId: string): Promise<ObjectState | null>;
+    close(): Promise<void>;
+    private openObjectLog;
+    private hydrateSnapshotFromStateIndex;
+    private applyToSnapshot;
+}
+export {};