@peers-app/peers-sdk 0.23.14 → 0.24.0

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;

package/dist/user-connect/connection-code.js

@@ -1,176 +0,0 @@
-"use strict";
-/**
- * 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
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateConnectionCode = generateConnectionCode;
-exports.formatConnectionCode = formatConnectionCode;
-exports.parseConnectionCode = parseConnectionCode;
-exports.encryptWithSecret = encryptWithSecret;
-exports.decryptWithSecret = decryptWithSecret;
-exports.generateConfirmationHash = generateConfirmationHash;
-exports.isValidConnectionCode = isValidConnectionCode;
-const sha2_1 = require("@noble/hashes/sha2");
-const nacl = require("tweetnacl");
-const tx_encoding_1 = require("../device/tx-encoding");
-const keys_1 = require("../keys");
-/**
- * Crockford Base32 alphabet.
- * Excludes I, L, O, U to avoid confusion with 1, 1, 0, V respectively.
- */
-const CROCKFORD_ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-/**
- * Generate random bytes using nacl.
- */
-function randomBytes(length) {
-    return nacl.randomBytes(length);
-}
-/**
- * Encode bytes to Crockford Base32 string.
- */
-function toCrockfordBase32(bytes, length) {
-    let result = "";
-    let i = 0;
-    while (result.length < length) {
-        if (i >= bytes.length) {
-            // Need more bytes
-            const moreBytes = randomBytes(length - result.length);
-            for (const b of moreBytes) {
-                result += CROCKFORD_ALPHABET[b % 32];
-                if (result.length >= length)
-                    break;
-            }
-            break;
-        }
-        // Use 5 bits at a time for base32
-        result += CROCKFORD_ALPHABET[bytes[i] % 32];
-        i++;
-    }
-    return result.substring(0, length);
-}
-/**
- * Derive a 32-byte encryption key from the shared secret.
- */
-function deriveKeyFromSecret(secret) {
-    // Use SHA-256 to derive a proper 32-byte key from the secret
-    const secretBytes = new TextEncoder().encode(secret);
-    return (0, sha2_1.sha256)(secretBytes);
-}
-/**
- * Generate a new connection code.
- * @returns Object with full code, alias, and secret
- */
-function generateConnectionCode() {
-    const bytes = randomBytes(16);
-    const alias = toCrockfordBase32(bytes.slice(0, 4), 4);
-    const secret = toCrockfordBase32(bytes.slice(4), 8);
-    return {
-        code: alias + secret,
-        alias,
-        secret,
-    };
-}
-/**
- * Format a connection code for display.
- * @param code 12-character code
- * @returns Formatted as "XXXX-YYYY-ZZZZ"
- */
-function formatConnectionCode(code) {
-    const normalized = code.toUpperCase().replace(/[^0-9A-Z]/g, "");
-    if (normalized.length !== 12) {
-        throw new Error(`Connection code must be 12 characters, got ${normalized.length}`);
-    }
-    return `${normalized.slice(0, 4)}-${normalized.slice(4, 8)}-${normalized.slice(8, 12)}`;
-}
-/**
- * Parse a formatted connection code.
- * @param formatted Code in any format (with or without dashes)
- * @returns Object with alias and secret
- */
-function parseConnectionCode(formatted) {
-    const normalized = formatted.toUpperCase().replace(/[^0-9A-Z]/g, "");
-    if (normalized.length !== 12) {
-        throw new Error(`Connection code must be 12 characters, got ${normalized.length}`);
-    }
-    return {
-        code: normalized,
-        alias: normalized.slice(0, 4),
-        secret: normalized.slice(4, 12),
-    };
-}
-/**
- * Encrypt data using the shared secret.
- * @param data Data to encrypt
- * @param secret 8-character shared secret
- * @returns Base64-encoded encrypted data with nonce
- */
-function encryptWithSecret(data, secret) {
-    const key = deriveKeyFromSecret(secret);
-    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 shared secret.
- * @param encrypted Base64-encoded encrypted data
- * @param secret 8-character shared secret
- * @returns Decrypted data
- */
-function decryptWithSecret(encrypted, secret) {
-    const key = deriveKeyFromSecret(secret);
-    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 secret or corrupted data");
-    }
-    return (0, tx_encoding_1.txDecode)(decrypted);
-}
-/**
- * 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
- */
-function generateConfirmationHash(userA, userB) {
-    // Sort by userId to ensure consistent ordering regardless of who is A or B
-    const sorted = [userA, userB].sort((a, b) => a.userId.localeCompare(b.userId));
-    const combined = JSON.stringify(sorted);
-    const hash = (0, sha2_1.sha256)(new TextEncoder().encode(combined));
-    // Take first 4 characters of the hash encoded in Crockford Base32
-    return toCrockfordBase32(hash.slice(0, 4), 4);
-}
-/**
- * Validate that a string is a valid connection code format.
- * @param code Code to validate (with or without dashes)
- * @returns true if valid
- */
-function isValidConnectionCode(code) {
-    try {
-        const normalized = code.toUpperCase().replace(/[^0-9A-Z]/g, "");
-        if (normalized.length !== 12)
-            return false;
-        // Check all characters are valid Crockford Base32
-        for (const char of normalized) {
-            if (!CROCKFORD_ALPHABET.includes(char))
-                return false;
-        }
-        return true;
-    }
-    catch {
-        return false;
-    }
-}