@peers-app/peers-sdk 0.23.13 → 0.24.0

package/dist/group-invite/group-invite.js

@@ -1,231 +0,0 @@
-"use strict";
-/**
- * Utilities for group invitation flow.
- *
- * Uses a simple password that users can edit or customize.
- * The password is hashed to create an alias for network discovery.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateInvitePassword = generateInvitePassword;
-exports.deriveAliasFromPassword = deriveAliasFromPassword;
-exports.encryptWithPassword = encryptWithPassword;
-exports.decryptWithPassword = decryptWithPassword;
-exports.isValidInvitePassword = isValidInvitePassword;
-exports.generateRequestId = generateRequestId;
-const sha2_1 = require("@noble/hashes/sha2");
-const nacl = require("tweetnacl");
-const tx_encoding_1 = require("../device/tx-encoding");
-const keys_1 = require("../keys");
-/**
- * Word list for generating memorable passphrases.
- * Using common, easy-to-spell words.
- */
-const WORD_LIST = [
-    "apple",
-    "banana",
-    "cherry",
-    "date",
-    "elder",
-    "fig",
-    "grape",
-    "honey",
-    "iris",
-    "jade",
-    "kiwi",
-    "lemon",
-    "mango",
-    "nectar",
-    "olive",
-    "peach",
-    "quince",
-    "rose",
-    "sugar",
-    "tulip",
-    "umber",
-    "violet",
-    "willow",
-    "yarrow",
-    "zebra",
-    "amber",
-    "blaze",
-    "coral",
-    "dusk",
-    "ember",
-    "frost",
-    "glow",
-    "haze",
-    "ivory",
-    "jewel",
-    "karma",
-    "lunar",
-    "maple",
-    "nova",
-    "opal",
-    "prism",
-    "quest",
-    "river",
-    "storm",
-    "terra",
-    "ultra",
-    "vivid",
-    "winter",
-    "azure",
-    "brave",
-    "calm",
-    "dawn",
-    "echo",
-    "fern",
-    "gentle",
-    "harbor",
-    "island",
-    "jungle",
-    "kindle",
-    "light",
-    "meadow",
-    "night",
-    "ocean",
-    "piano",
-    "quiet",
-    "rain",
-    "silk",
-    "tide",
-    "unity",
-    "velvet",
-    "wave",
-    "zenith",
-    "arch",
-    "beam",
-    "cloud",
-    "drift",
-    "earth",
-    "flame",
-    "green",
-    "hill",
-    "ink",
-    "jazz",
-    "keen",
-    "lake",
-    "moon",
-    "nest",
-    "oak",
-    "peak",
-    "ruby",
-    "sand",
-    "tree",
-    "vine",
-    "wind",
-    "year",
-    "zone",
-    "bold",
-    "crisp",
-    "deep",
-    "fair",
-    "glad",
-    "warm",
-    "pure",
-    "safe",
-    "true",
-];
-/**
- * Generate a random memorable passphrase.
- * Format: "word-word-word-word" (4 words separated by dashes)
- *
- * @param wordCount Number of words to use (default 4)
- * @returns A memorable passphrase
- */
-function generateInvitePassword(wordCount = 4) {
-    const words = [];
-    const bytes = nacl.randomBytes(wordCount);
-    for (let i = 0; i < wordCount; i++) {
-        const index = bytes[i] % WORD_LIST.length;
-        words.push(WORD_LIST[index]);
-    }
-    return words.join("-");
-}
-/**
- * Derive a network alias from a password.
- * Uses SHA-256 hash, takes first 8 characters as hex.
- *
- * @param password The password to derive from
- * @returns An 8-character hex alias
- */
-function deriveAliasFromPassword(password) {
-    const normalized = password.toLowerCase().trim();
-    const hash = (0, sha2_1.sha256)(new TextEncoder().encode(normalized));
-    // Convert first 4 bytes to 8-char hex string
-    const hexChars = Array.from(hash.slice(0, 4))
-        .map((b) => b.toString(16).padStart(2, "0"))
-        .join("")
-        .toUpperCase();
-    return hexChars;
-}
-/**
- * Derive a 32-byte encryption key from the password.
- * Uses SHA-256 of the password.
- *
- * @param password The password to derive key from
- * @returns A 32-byte encryption key
- */
-function deriveKeyFromPassword(password) {
-    const normalized = password.toLowerCase().trim();
-    return (0, sha2_1.sha256)(new TextEncoder().encode(normalized));
-}
-/**
- * Encrypt data using the invite password.
- * Uses NaCl secretbox with a key derived from the password.
- *
- * @param data Data to encrypt
- * @param password The invitation password
- * @returns Base64-encoded encrypted data with nonce
- */
-function encryptWithPassword(data, password) {
-    const key = deriveKeyFromPassword(password);
-    const nonce = nacl.randomBytes(24);
-    const dataBytes = (0, tx_encoding_1.txEncode)(data);
-    const encrypted = nacl.secretbox(dataBytes, nonce, key);
-    // Combine nonce + encrypted data
-    const combined = new Uint8Array(nonce.length + encrypted.length);
-    combined.set(nonce);
-    combined.set(encrypted, nonce.length);
-    return (0, keys_1.encodeBase64)(combined);
-}
-/**
- * Decrypt data using the invite password.
- *
- * @param encrypted Base64-encoded encrypted data
- * @param password The invitation password
- * @returns Decrypted data
- */
-function decryptWithPassword(encrypted, password) {
-    const key = deriveKeyFromPassword(password);
-    const combined = (0, keys_1.decodeBase64)(encrypted);
-    const nonce = combined.slice(0, 24);
-    const ciphertext = combined.slice(24);
-    const decrypted = nacl.secretbox.open(ciphertext, nonce, key);
-    if (!decrypted) {
-        throw new Error("Decryption failed - invalid password or corrupted data");
-    }
-    return (0, tx_encoding_1.txDecode)(decrypted);
-}
-/**
- * Validate a password format.
- * Passwords should be at least 4 characters.
- *
- * @param password Password to validate
- * @returns true if valid
- */
-function isValidInvitePassword(password) {
-    const trimmed = password.trim();
-    return trimmed.length >= 4;
-}
-/**
- * Generate a unique request ID for tracking join requests.
- *
- * @returns A unique request ID
- */
-function generateRequestId() {
-    const bytes = nacl.randomBytes(8);
-    return Array.from(bytes)
-        .map((b) => b.toString(16).padStart(2, "0"))
-        .join("");
-}

package/dist/group-invite/group-invite.pvars.d.ts

@@ -1,94 +0,0 @@
-/**
- * Persistent variables for group invitation state.
- *
- * These device-level variables track:
- * - Active invitation listeners (admin side)
- * - Pending join requests (admin side)
- * - Status messages for UI feedback
- * - Action triggers (UI sets these, device layer reacts)
- */
-import type { GroupMemberRole } from "../data/group-member-roles";
-import type { IGroupInviteListener, IGroupInviteListenerInfo, IGroupJoinRequest, IGroupJoinResult } from "./group-invite.types";
-/**
- * Active group invitation listeners.
- * Key is groupId, value contains the password and alias being listened for.
- *
- * Used by admins who are waiting for join requests.
- */
-export declare const groupInviteListeners: import("../data/persistent-vars").PersistentVar<Record<string, IGroupInviteListener>>;
-/**
- * Pending join requests that need admin approval.
- * Array of requests waiting to be approved or denied.
- *
- * These are shown to the admin in the group details UI.
- */
-export declare const groupInviteRequests: import("../data/persistent-vars").PersistentVar<IGroupJoinRequest[]>;
-/**
- * Status message for the group invite UI (admin side).
- * Used to show success/error messages to the user.
- */
-export declare const groupInviteStatus: import("../data/persistent-vars").PersistentVar<string>;
-/**
- * Status message for the join group UI (joiner side).
- * Used to show discovery/join status to the user.
- */
-export declare const groupJoinStatus: import("../data/persistent-vars").PersistentVar<string>;
-/**
- * Results from discovering group listeners.
- * Updated by the device layer after discovery completes.
- */
-export declare const groupInviteDiscoveryResult: import("../data/persistent-vars").PersistentVar<IGroupInviteListenerInfo[]>;
-/**
- * Result of joining a group.
- * Updated by the device layer after join completes.
- */
-export declare const groupInviteJoinResult: import("../data/persistent-vars").PersistentVar<IGroupJoinResult | null>;
-/**
- * Responses to join requests, keyed by requestId.
- * Written by processJoinRequest, read by handleJoinRequest.
- * Entries are cleaned up after being read.
- */
-export declare const groupInviteResponses: import("../data/persistent-vars").PersistentVar<Record<string, {
-    statusCode: number;
-    payload: string;
-}>>;
-/**
- * Trigger to start listening for invitations.
- * Set by UI: { groupId, password }
- * Device layer clears after processing.
- */
-export declare const groupInviteStartListening: import("../data/persistent-vars").PersistentVar<{
-    groupId: string;
-    password: string;
-} | null>;
-/**
- * Trigger to stop listening for invitations.
- * Set by UI: groupId
- * Device layer clears after processing.
- */
-export declare const groupInviteStopListening: import("../data/persistent-vars").PersistentVar<string | null>;
-/**
- * Trigger to discover groups with a password.
- * Set by UI: password
- * Device layer updates groupInviteDiscoveryResult and clears this.
- */
-export declare const groupInviteDiscover: import("../data/persistent-vars").PersistentVar<string | null>;
-/**
- * Trigger to send a join request.
- * Set by UI: { listener, password }
- * Device layer updates groupInviteJoinResult and clears this.
- */
-export declare const groupInviteSendRequest: import("../data/persistent-vars").PersistentVar<{
-    listener: IGroupInviteListenerInfo;
-    password: string;
-} | null>;
-/**
- * Trigger to process (approve/deny) a join request.
- * Set by UI: { requestId, approved, role }
- * Device layer processes and clears this.
- */
-export declare const groupInviteProcessRequest: import("../data/persistent-vars").PersistentVar<{
-    requestId: string;
-    approved: boolean;
-    role: GroupMemberRole;
-} | null>;

package/dist/group-invite/group-invite.pvars.js

@@ -1,139 +0,0 @@
-"use strict";
-/**
- * Persistent variables for group invitation state.
- *
- * These device-level variables track:
- * - Active invitation listeners (admin side)
- * - Pending join requests (admin side)
- * - Status messages for UI feedback
- * - Action triggers (UI sets these, device layer reacts)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.groupInviteProcessRequest = exports.groupInviteSendRequest = exports.groupInviteDiscover = exports.groupInviteStopListening = exports.groupInviteStartListening = exports.groupInviteResponses = exports.groupInviteJoinResult = exports.groupInviteDiscoveryResult = exports.groupJoinStatus = exports.groupInviteStatus = exports.groupInviteRequests = exports.groupInviteListeners = void 0;
-const persistent_vars_1 = require("../data/persistent-vars");
-// ============================================================================
-// STATE VARIABLES (read by both UI and device layer)
-// ============================================================================
-/**
- * Active group invitation listeners.
- * Key is groupId, value contains the password and alias being listened for.
- *
- * Used by admins who are waiting for join requests.
- */
-exports.groupInviteListeners = (0, persistent_vars_1.deviceVar)("groupInviteListeners", { defaultValue: {} });
-/**
- * Pending join requests that need admin approval.
- * Array of requests waiting to be approved or denied.
- *
- * These are shown to the admin in the group details UI.
- */
-exports.groupInviteRequests = (0, persistent_vars_1.deviceVar)("groupInviteRequests", {
-    defaultValue: [],
-});
-/**
- * Status message for the group invite UI (admin side).
- * Used to show success/error messages to the user.
- */
-exports.groupInviteStatus = (0, persistent_vars_1.deviceVar)("groupInviteStatus", { defaultValue: "" });
-/**
- * Status message for the join group UI (joiner side).
- * Used to show discovery/join status to the user.
- */
-exports.groupJoinStatus = (0, persistent_vars_1.deviceVar)("groupJoinStatus", { defaultValue: "" });
-/**
- * Results from discovering group listeners.
- * Updated by the device layer after discovery completes.
- */
-exports.groupInviteDiscoveryResult = (0, persistent_vars_1.deviceVar)("groupInviteDiscoveryResult", { defaultValue: [] });
-/**
- * Result of joining a group.
- * Updated by the device layer after join completes.
- */
-exports.groupInviteJoinResult = (0, persistent_vars_1.deviceVar)("groupInviteJoinResult", {
-    defaultValue: null,
-});
-/**
- * Responses to join requests, keyed by requestId.
- * Written by processJoinRequest, read by handleJoinRequest.
- * Entries are cleaned up after being read.
- */
-exports.groupInviteResponses = (0, persistent_vars_1.deviceVar)("groupInviteResponses", { defaultValue: {} });
-// ============================================================================
-// ACTION TRIGGERS (UI sets these, device layer reacts)
-// ============================================================================
-/**
- * Trigger to start listening for invitations.
- * Set by UI: { groupId, password }
- * Device layer clears after processing.
- */
-exports.groupInviteStartListening = (0, persistent_vars_1.deviceVar)("groupInviteStartListening", { defaultValue: null });
-/**
- * Trigger to stop listening for invitations.
- * Set by UI: groupId
- * Device layer clears after processing.
- */
-exports.groupInviteStopListening = (0, persistent_vars_1.deviceVar)("groupInviteStopListening", {
-    defaultValue: null,
-});
-/**
- * Trigger to discover groups with a password.
- * Set by UI: password
- * Device layer updates groupInviteDiscoveryResult and clears this.
- */
-exports.groupInviteDiscover = (0, persistent_vars_1.deviceVar)("groupInviteDiscover", {
-    defaultValue: null,
-});
-/**
- * Trigger to send a join request.
- * Set by UI: { listener, password }
- * Device layer updates groupInviteJoinResult and clears this.
- */
-exports.groupInviteSendRequest = (0, persistent_vars_1.deviceVar)("groupInviteSendRequest", { defaultValue: null });
-/**
- * Trigger to process (approve/deny) a join request.
- * Set by UI: { requestId, approved, role }
- * Device layer processes and clears this.
- */
-exports.groupInviteProcessRequest = (0, persistent_vars_1.deviceVar)("groupInviteProcessRequest", { defaultValue: null });
-// ============================================================================
-// AUTO-CLEANUP
-// ============================================================================
-// Auto-cleanup of expired listeners (10 minute expiry)
-exports.groupInviteListeners.loadingPromise.then(() => {
-    // Check every minute for expired listeners
-    setInterval(() => {
-        const listeners = (0, exports.groupInviteListeners)();
-        const now = Date.now();
-        const expiredGroupIds = [];
-        for (const [groupId, listener] of Object.entries(listeners)) {
-            const startedAt = new Date(listener.startedAt).getTime();
-            const elapsed = now - startedAt;
-            // Expire after 10 minutes
-            if (elapsed > 600_000) {
-                expiredGroupIds.push(groupId);
-            }
-        }
-        if (expiredGroupIds.length > 0) {
-            const updated = { ...listeners };
-            for (const groupId of expiredGroupIds) {
-                delete updated[groupId];
-            }
-            (0, exports.groupInviteListeners)(updated);
-        }
-    }, 60_000);
-});
-// Clean up old requests after 10 minutes
-exports.groupInviteRequests.loadingPromise.then(() => {
-    setInterval(() => {
-        const requests = (0, exports.groupInviteRequests)();
-        const now = Date.now();
-        const validRequests = requests.filter((req) => {
-            const receivedAt = new Date(req.receivedAt).getTime();
-            const elapsed = now - receivedAt;
-            return elapsed < 600_000; // Keep for 10 minutes
-        });
-        if (validRequests.length !== requests.length) {
-            (0, exports.groupInviteRequests)(validRequests);
-        }
-    }, 60_000);
-});

package/dist/group-invite/group-invite.types.d.ts

@@ -1,124 +0,0 @@
-/**
- * Types for the group invitation flow.
- *
- * This flow allows admins to invite new members to a group using a simple
- * password. Multiple admins can listen for the same password simultaneously.
- */
-import type { GroupMemberRole } from "../data/group-member-roles";
-import type { IGroupMember } from "../data/group-members";
-import type { IGroupShare } from "../data/group-share";
-/**
- * Information about a group shared during the invitation flow.
- */
-export interface IGroupInviteGroupInfo {
-    groupId: string;
-    name: string;
-    description?: string;
-    iconClassName?: string;
-}
-/**
- * Information about the inviting admin shared during discovery.
- */
-export interface IGroupInviteListenerInfo {
-    /** The admin's user ID */
-    userId: string;
-    /** The admin's display name */
-    name: string;
-    /** The admin's device ID */
-    deviceId: string;
-    /** Group information */
-    group: IGroupInviteGroupInfo;
-    /** The alias being listened on */
-    alias: string;
-}
-/**
- * Information sent by a user requesting to join a group.
- */
-export interface IGroupJoinRequestInfo {
-    /** Requesting user's ID */
-    userId: string;
-    /** Requesting user's display name */
-    name?: string;
-    /** Requesting user's public signing key */
-    publicKey: string;
-    /** Requesting user's public box key for encryption */
-    publicBoxKey: string;
-    /** Requesting user's device ID */
-    deviceId: string;
-}
-/**
- * A pending join request shown to the admin.
- */
-export interface IGroupJoinRequest {
-    /** Unique request ID */
-    requestId: string;
-    /** The group being joined */
-    groupId: string;
-    /** The alias this request came in on */
-    alias: string;
-    /** The password used (for encryption) */
-    password: string;
-    /** Information about the requesting user */
-    requester: IGroupJoinRequestInfo;
-    /** When the request was received */
-    receivedAt: Date;
-}
-/**
- * Response sent by admin when approving a join request.
- */
-export interface IGroupJoinApprovalInfo {
-    /** Whether the request was approved */
-    approved: boolean;
-    /** The role assigned to the new member (if approved) */
-    role?: GroupMemberRole;
-    /** Canonical group record plus Admin+ seed memberships */
-    groupShare?: IGroupShare;
-    /** Newly signed membership for the joiner, including Reader roles */
-    newMember?: IGroupMember;
-    /** Admin's user info for adding to contacts */
-    adminInfo?: IGroupJoinRequestInfo;
-    /** Error message if rejected */
-    rejectionReason?: string;
-}
-/**
- * Signal that a joiner finished importing approval data and can connect to the admin.
- */
-export interface IGroupInviteJoinFinished {
-    /** Group the joiner just imported */
-    groupId: string;
-    /** Approving admin device that should be contacted in that group context */
-    adminDeviceId: string;
-}
-/**
- * Active invitation listener state.
- */
-export interface IGroupInviteListener {
-    /** The group being invited to */
-    groupId: string;
-    /** The password being listened for */
-    password: string;
-    /** The derived alias for network discovery */
-    alias: string;
-    /** When listening started */
-    startedAt: Date;
-}
-/**
- * Result of discovering group invite listeners.
- */
-export interface IGroupInviteDiscoveryResult {
-    /** List of listeners found */
-    listeners: IGroupInviteListenerInfo[];
-    /** Any error that occurred */
-    error?: string;
-}
-/**
- * Result of a join request.
- */
-export interface IGroupJoinResult {
-    /** Whether the join was successful */
-    success: boolean;
-    /** The group ID if successful */
-    groupId?: string;
-    /** Error message if failed */
-    error?: string;
-}

package/dist/group-invite/group-invite.types.js

@@ -1,8 +0,0 @@
-"use strict";
-/**
- * Types for the group invitation flow.
- *
- * This flow allows admins to invite new members to a group using a simple
- * password. Multiple admins can listen for the same password simultaneously.
- */
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/group-invite/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./group-invite";
-export * from "./group-invite.pvars";
-export * from "./group-invite.types";

package/dist/user-connect/connection-code.d.ts

@@ -1,67 +0,0 @@
-/**
- * Utilities for generating and handling connection codes.
- *
- * Connection codes are 12 characters of Crockford Base32:
- * - First 4 chars: device alias (rendezvous point)
- * - Last 8 chars: shared secret for encryption
- *
- * Displayed format: XXXX-YYYY-ZZZZ
- */
-import type { IUserConnectInfo } from "./user-connect.types";
-export interface IConnectionCode {
-    /** Full 12-character code */
-    code: string;
-    /** First 4 characters - device alias for rendezvous */
-    alias: string;
-    /** Last 8 characters - shared secret for encryption */
-    secret: string;
-}
-/**
- * Generate a new connection code.
- * @returns Object with full code, alias, and secret
- */
-export declare function generateConnectionCode(): IConnectionCode;
-/**
- * Format a connection code for display.
- * @param code 12-character code
- * @returns Formatted as "XXXX-YYYY-ZZZZ"
- */
-export declare function formatConnectionCode(code: string): string;
-/**
- * Parse a formatted connection code.
- * @param formatted Code in any format (with or without dashes)
- * @returns Object with alias and secret
- */
-export declare function parseConnectionCode(formatted: string): {
-    code: string;
-    alias: string;
-    secret: string;
-};
-/**
- * Encrypt data using the shared secret.
- * @param data Data to encrypt
- * @param secret 8-character shared secret
- * @returns Base64-encoded encrypted data with nonce
- */
-export declare function encryptWithSecret(data: any, secret: string): string;
-/**
- * Decrypt data using the shared secret.
- * @param encrypted Base64-encoded encrypted data
- * @param secret 8-character shared secret
- * @returns Decrypted data
- */
-export declare function decryptWithSecret(encrypted: string, secret: string): any;
-/**
- * Generate a confirmation hash from both users' information.
- * Both parties should see the same hash if the exchange was successful.
- * @param userA First user's info
- * @param userB Second user's info
- * @returns 4-character confirmation code
- */
-export declare function generateConfirmationHash(userA: IUserConnectInfo, userB: IUserConnectInfo): string;
-/**
- * Validate that a string is a valid connection code format.
- * @param code Code to validate (with or without dashes)
- * @returns true if valid
- */
-export declare function isValidConnectionCode(code: string): boolean;