@meshwhisper/sdk 0.1.0

package/dist/crypto/index.js.map

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

package/dist/group/index.d.ts

@@ -0,0 +1,155 @@
+import type { Group, GroupMember, PermissionModel } from '../types.js';
+/** Relay tree node representing a group member's position in the relay topology. */
+export interface TreeNode {
+    peerId: string;
+    children: TreeNode[];
+    activityScore: number;
+    lastActive: number;
+}
+/** Invitation payload to join a group, distributed via pairwise encrypted channels. */
+export interface GroupInvite {
+    groupId: string;
+    groupName: string;
+    invitedBy: string;
+    senderKeys: Map<string, Uint8Array>;
+    members: string[];
+}
+/** Distribution message for a single sender key. */
+export interface SenderKeyDistribution {
+    groupId: string;
+    senderId: string;
+    senderKey: Uint8Array;
+    iteration: number;
+}
+export declare class GroupManager {
+    private readonly localPeerId;
+    private readonly groups;
+    constructor(localPeerId: string);
+    /**
+     * Creates a new group. The local peer is the initial admin and tree root.
+     * Generates sender keys for the local peer and all initial members.
+     */
+    createGroup(name: string, members: string[], permissionModel: PermissionModel): Group;
+    /**
+     * Joins an existing group using invite data received via a pairwise channel.
+     * Stores all distributed sender keys from the invite.
+     */
+    joinGroup(groupId: string, inviteData: GroupInvite): Group;
+    /**
+     * Leaves a group, removing all local state for it.
+     */
+    leaveGroup(groupId: string): void;
+    /**
+     * Returns the group with the given ID, or null if not found.
+     */
+    getGroup(groupId: string): Group | null;
+    /**
+     * Returns all groups the local peer is participating in.
+     */
+    getGroups(): Group[];
+    /**
+     * Adds a new member to the group and generates a sender key for them.
+     */
+    addMember(groupId: string, peerId: string): void;
+    /**
+     * Removes a member from the group and triggers rotation of all sender keys
+     * to maintain forward secrecy — the removed member must not be able to
+     * decrypt future messages.
+     */
+    removeMember(groupId: string, peerId: string): void;
+    /**
+     * Returns the list of all members in a group.
+     */
+    getMembers(groupId: string): GroupMember[];
+    /**
+     * Returns the role of a member in a group, or null if not a member.
+     */
+    getMemberRole(groupId: string, peerId: string): 'admin' | 'member' | null;
+    /**
+     * Updates a member's role within the group.
+     */
+    setMemberRole(groupId: string, peerId: string, role: 'admin' | 'member'): void;
+    /**
+     * Generates a new 32-byte sender key using cryptographically secure randomness.
+     */
+    generateSenderKey(): Uint8Array;
+    /**
+     * Creates a sender key distribution message for a specific recipient.
+     * This message should be encrypted via the pairwise channel before transmission.
+     */
+    distributeSenderKey(groupId: string, senderKey: Uint8Array, recipientId: string): SenderKeyDistribution;
+    /**
+     * Processes a received sender key distribution message from another member.
+     */
+    receiveSenderKey(distribution: SenderKeyDistribution): void;
+    /**
+     * Rotates all sender keys in a group. Called when a member is removed
+     * to ensure forward secrecy.
+     */
+    rotateAllSenderKeys(groupId: string): void;
+    /**
+     * Returns the sender key for a specific member in a group, or null if unknown.
+     */
+    getSenderKey(groupId: string, memberId: string): Uint8Array | null;
+    /**
+     * Encrypts plaintext for the group using the local peer's sender key.
+     * Uses AES-256-GCM. The ciphertext format is: nonce (12) || ciphertext || tag (16).
+     */
+    encryptForGroup(groupId: string, plaintext: Uint8Array): {
+        ciphertext: Uint8Array;
+        senderId: string;
+    };
+    /**
+     * Decrypts a group message from a specific sender using their sender key.
+     * Expects the ciphertext format: nonce (12) || ciphertext || tag (16).
+     */
+    decryptFromGroup(groupId: string, senderId: string, ciphertext: Uint8Array): Uint8Array;
+    /**
+     * Records a message-send activity for a member. Used to compute
+     * activity scores that drive relay tree topology.
+     */
+    updateActivity(groupId: string, peerId: string): void;
+    /**
+     * Builds (or returns cached) relay tree for the group. The tree is
+     * structured so that the most active members form the trunk near the
+     * root, and less active members are leaves.
+     *
+     * The tree is rebuilt at most once per TREE_REBUILD_INTERVAL_MS.
+     */
+    buildRelayTree(groupId: string): TreeNode;
+    /**
+     * Determines which peer should relay a message to reach the target peer.
+     * Returns the parent of the target in the relay tree, or null if the
+     * target is the root or not found.
+     */
+    getRelayTarget(groupId: string, targetPeerId: string): string | null;
+    /**
+     * Returns the list of peer IDs that the local peer should relay messages to
+     * (i.e., the local peer's children in the relay tree).
+     */
+    getRelayChildren(groupId: string): string[];
+    /**
+     * Routes a group message through the relay tree. Returns the list of peers
+     * that the local peer should forward the message to, based on the relay
+     * tree position.
+     *
+     * If the local peer is the sender (or root), it forwards to its children.
+     * If the local peer is relaying, it forwards to its children plus its parent
+     * (if the message didn't come from the parent direction).
+     */
+    routeGroupMessage(groupId: string, ciphertext: Uint8Array, senderId: string): Array<{
+        peerId: string;
+        data: Uint8Array;
+    }>;
+    /** Generates a random hex-encoded group ID. */
+    private generateGroupId;
+    /** Retrieves group state or throws if the group is unknown. */
+    private requireGroupState;
+    /** Searches the relay tree for a node by peer ID. */
+    private findNodeInTree;
+    /** Finds the parent node of a given peer in the relay tree. */
+    private findParentInTree;
+    /** Checks whether a peer is anywhere in the subtree rooted at the given node. */
+    private isInSubtree;
+}
+//# sourceMappingURL=index.d.ts.map

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

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