nostr-double-ratchet 0.0.36 → 0.0.38

package/dist/DeviceManager.d.ts

@@ -0,0 +1,127 @@
+import { InviteList, DeviceEntry } from "./InviteList";
+import { DevicePayload } from "./inviteUtils";
+import { NostrSubscribe, NostrPublish, IdentityKey } from "./types";
+import { StorageAdapter } from "./StorageAdapter";
+import { SessionManager } from "./SessionManager";
+export interface OwnerDeviceOptions {
+    ownerPublicKey: string;
+    identityKey: IdentityKey;
+    deviceId: string;
+    deviceLabel: string;
+    nostrSubscribe: NostrSubscribe;
+    nostrPublish: NostrPublish;
+    storage?: StorageAdapter;
+}
+export interface DelegateDeviceOptions {
+    deviceId: string;
+    deviceLabel: string;
+    nostrSubscribe: NostrSubscribe;
+    nostrPublish: NostrPublish;
+    storage?: StorageAdapter;
+}
+export interface RestoreDelegateOptions {
+    deviceId: string;
+    devicePublicKey: string;
+    devicePrivateKey: Uint8Array;
+    ephemeralPublicKey: string;
+    ephemeralPrivateKey: Uint8Array;
+    sharedSecret: string;
+    nostrSubscribe: NostrSubscribe;
+    nostrPublish: NostrPublish;
+    storage?: StorageAdapter;
+}
+export interface CreateDelegateResult {
+    manager: DelegateDeviceManager;
+    payload: DevicePayload;
+}
+export interface IDeviceManager {
+    init(): Promise<void>;
+    getDeviceId(): string;
+    getIdentityPublicKey(): string;
+    getIdentityKey(): IdentityKey;
+    getEphemeralKeypair(): {
+        publicKey: string;
+        privateKey: Uint8Array;
+    } | null;
+    getSharedSecret(): string | null;
+    getOwnerPublicKey(): string | null;
+    close(): void;
+    createSessionManager(sessionStorage?: StorageAdapter): SessionManager;
+}
+/** Owner's main device. Has identity key and can manage InviteList. */
+export declare class OwnerDeviceManager implements IDeviceManager {
+    private readonly deviceId;
+    private readonly deviceLabel;
+    private readonly nostrSubscribe;
+    private readonly nostrPublish;
+    private readonly storage;
+    private readonly ownerPublicKey;
+    private readonly identityKey;
+    private inviteList;
+    private initialized;
+    private subscriptions;
+    private readonly storageVersion;
+    private get versionPrefix();
+    constructor(options: OwnerDeviceOptions);
+    init(): Promise<void>;
+    getDeviceId(): string;
+    getIdentityPublicKey(): string;
+    getIdentityKey(): IdentityKey;
+    getEphemeralKeypair(): {
+        publicKey: string;
+        privateKey: Uint8Array;
+    } | null;
+    getSharedSecret(): string | null;
+    getOwnerPublicKey(): string;
+    getInviteList(): InviteList | null;
+    getOwnDevices(): DeviceEntry[];
+    addDevice(payload: DevicePayload): Promise<void>;
+    revokeDevice(deviceId: string): Promise<void>;
+    updateDeviceLabel(deviceId: string, label: string): Promise<void>;
+    close(): void;
+    createSessionManager(sessionStorage?: StorageAdapter): SessionManager;
+    private inviteListKey;
+    private loadInviteList;
+    private saveInviteList;
+    private fetchInviteList;
+    private mergeInviteLists;
+    private modifyInviteList;
+    private subscribeToOwnInviteList;
+}
+/** Delegate device. Has own identity key, waits for activation, checks revocation. */
+export declare class DelegateDeviceManager implements IDeviceManager {
+    private readonly deviceId;
+    private readonly nostrSubscribe;
+    private readonly nostrPublish;
+    private readonly storage;
+    private readonly devicePublicKey;
+    private readonly devicePrivateKey;
+    private readonly ephemeralPublicKey;
+    private readonly ephemeralPrivateKey;
+    private readonly sharedSecret;
+    private ownerPubkeyFromActivation?;
+    private initialized;
+    private subscriptions;
+    private readonly storageVersion;
+    private get versionPrefix();
+    private constructor();
+    static create(options: DelegateDeviceOptions): CreateDelegateResult;
+    static restore(options: RestoreDelegateOptions): DelegateDeviceManager;
+    init(): Promise<void>;
+    getDeviceId(): string;
+    getIdentityPublicKey(): string;
+    getIdentityKey(): Uint8Array;
+    getEphemeralKeypair(): {
+        publicKey: string;
+        privateKey: Uint8Array;
+    };
+    getSharedSecret(): string;
+    getOwnerPublicKey(): string | null;
+    waitForActivation(timeoutMs?: number): Promise<string>;
+    isRevoked(): Promise<boolean>;
+    close(): void;
+    createSessionManager(sessionStorage?: StorageAdapter): SessionManager;
+    private ownerPubkeyKey;
+    private fetchInviteList;
+}
+//# sourceMappingURL=DeviceManager.d.ts.map

package/dist/DeviceManager.d.ts.map

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

package/dist/Invite.d.ts

@@ -36,8 +36,9 @@ export declare class Invite {
     getUrl(root?: string): string;
     getEvent(): UnsignedEvent;
     /**
-     * Creates an "invite tombstone" event that clears the original content and removes the list tag.
-     * Used when the inviter logs out and wants to make the invite invisible to other devices.
+     * Creates a tombstone event that replaces the invite, signaling device revocation.
+     * The tombstone has the same d-tag but no keys, making it invalid as an invite.
+     * Used during migration to InviteList or when revoking a device.
      */
     getDeletionEvent(): UnsignedEvent;
     /**

package/dist/Invite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Invite.d.ts","sourceRoot":"","sources":["../src/Invite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyD,aAAa,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AACvI,OAAO,EAAqB,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAwB,MAAM,SAAS,CAAC;AAEjI,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAQvC;;;;;;;;;GASG;AACH,qBAAa,MAAM;IAEJ,yBAAyB,EAAE,MAAM;IACjC,YAAY,EAAE,MAAM;IACpB,OAAO,EAAE,MAAM;IACf,0BAA0B,CAAC,EAAE,UAAU;IACvC,QAAQ,CAAC,EAAE,MAAM;IACjB,OAAO,CAAC,EAAE,MAAM;IAChB,MAAM,EAAE,MAAM,EAAE;IAChB,SAAS,EAAE,MAAM;gBAPjB,yBAAyB,EAAE,MAAM,EACjC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,0BAA0B,CAAC,EAAE,UAAU,YAAA,EACvC,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,OAAO,CAAC,EAAE,MAAM,YAAA,EAChB,MAAM,GAAE,MAAM,EAAO,EACrB,SAAS,GAAE,MAAc;IAIpC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAiB9E,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IA2BnC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAcxC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;IAkC9C,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW;IAwB1G;;OAEG;IACH,SAAS,IAAI,MAAM;IAanB;;OAEG;IACH,MAAM,CAAC,IAAI,SAAoB;IAW/B,QAAQ,IAAI,aAAa;IAkBzB;;;OAGG;IACH,gBAAgB,IAAI,aAAa;IAiBjC;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CACR,cAAc,EAAE,cAAc,EAC9B,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,UAAU,GAAG,eAAe,EACvC,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC;IA0CtD,MAAM,CAAC,SAAS,EAAE,UAAU,GAAG,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW;CAqD9K"}
+{"version":3,"file":"Invite.d.ts","sourceRoot":"","sources":["../src/Invite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAE,aAAa,EAAuB,MAAM,aAAa,CAAC;AAC/F,OAAO,EAAqB,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAwB,MAAM,SAAS,CAAC;AACjI,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAWvC;;;;;;;;;GASG;AACH,qBAAa,MAAM;IAEJ,yBAAyB,EAAE,MAAM;IACjC,YAAY,EAAE,MAAM;IACpB,OAAO,EAAE,MAAM;IACf,0BAA0B,CAAC,EAAE,UAAU;IACvC,QAAQ,CAAC,EAAE,MAAM;IACjB,OAAO,CAAC,EAAE,MAAM;IAChB,MAAM,EAAE,MAAM,EAAE;IAChB,SAAS,EAAE,MAAM;gBAPjB,yBAAyB,EAAE,MAAM,EACjC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,0BAA0B,CAAC,EAAE,UAAU,YAAA,EACvC,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,OAAO,CAAC,EAAE,MAAM,YAAA,EAChB,MAAM,GAAE,MAAM,EAAO,EACrB,SAAS,GAAE,MAAc;IAIpC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAgB9E,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IA2BnC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAcxC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;IAkC9C,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW;IAwB1G;;OAEG;IACH,SAAS,IAAI,MAAM;IAanB;;OAEG;IACH,MAAM,CAAC,IAAI,SAAoB;IAW/B,QAAQ,IAAI,aAAa;IAkBzB;;;;OAIG;IACH,gBAAgB,IAAI,aAAa;IAgBjC;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CACR,cAAc,EAAE,cAAc,EAC9B,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,UAAU,GAAG,eAAe,EACvC,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC;IA6BtD,MAAM,CAAC,SAAS,EAAE,UAAU,GAAG,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW;CA4C9K"}

package/dist/InviteList.d.ts

@@ -0,0 +1,43 @@
+import { VerifiedEvent, UnsignedEvent } from "nostr-tools";
+import { NostrSubscribe, Unsubscribe, EncryptFunction, DecryptFunction } from "./types";
+import { Session } from "./Session";
+export interface DeviceEntry {
+    ephemeralPublicKey: string;
+    /** Only stored locally, not published */
+    ephemeralPrivateKey?: Uint8Array;
+    sharedSecret: string;
+    deviceId: string;
+    deviceLabel: string;
+    createdAt: number;
+    /** Owner's pubkey for owner devices, delegate's own pubkey for delegate devices */
+    identityPubkey: string;
+}
+/**
+ * Manages a consolidated list of device invites (kind 10078).
+ * Single atomic event containing all device invites for a user.
+ * Uses union merge strategy for conflict resolution.
+ */
+export declare class InviteList {
+    readonly ownerPublicKey: string;
+    private devices;
+    private removedDeviceIds;
+    constructor(ownerPublicKey: string, devices?: DeviceEntry[], removedDeviceIds?: string[]);
+    createDevice(label: string, deviceId?: string): DeviceEntry;
+    addDevice(device: DeviceEntry): void;
+    removeDevice(deviceId: string): void;
+    getDevice(deviceId: string): DeviceEntry | undefined;
+    getAllDevices(): DeviceEntry[];
+    getRemovedDeviceIds(): string[];
+    updateDeviceLabel(deviceId: string, newLabel: string): void;
+    getEvent(): UnsignedEvent;
+    static fromEvent(event: VerifiedEvent): InviteList;
+    serialize(): string;
+    static deserialize(json: string): InviteList;
+    merge(other: InviteList): InviteList;
+    accept(deviceId: string, nostrSubscribe: NostrSubscribe, inviteePublicKey: string, encryptor: Uint8Array | EncryptFunction, inviteeDeviceId?: string): Promise<{
+        session: Session;
+        event: VerifiedEvent;
+    }>;
+    listen(decryptor: Uint8Array | DecryptFunction, nostrSubscribe: NostrSubscribe, onSession: (session: Session, identity: string, deviceId?: string, ourDeviceId?: string) => void): Unsubscribe;
+}
+//# sourceMappingURL=InviteList.d.ts.map

package/dist/InviteList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InviteList.d.ts","sourceRoot":"","sources":["../src/InviteList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAE,aAAa,EAAe,MAAM,aAAa,CAAA;AACtF,OAAO,EACL,cAAc,EACd,WAAW,EACX,eAAe,EACf,eAAe,EAGhB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAiCnC,MAAM,WAAW,WAAW;IAC1B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,yCAAyC;IACzC,mBAAmB,CAAC,EAAE,UAAU,CAAA;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,mFAAmF;IACnF,cAAc,EAAE,MAAM,CAAA;CACvB;AAMD;;;;GAIG;AACH,qBAAa,UAAU;aAKH,cAAc,EAAE,MAAM;IAJxC,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,gBAAgB,CAAyB;gBAG/B,cAAc,EAAE,MAAM,EACtC,OAAO,GAAE,WAAW,EAAO,EAC3B,gBAAgB,GAAE,MAAM,EAAO;IAQjC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW;IAa3D,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IASpC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIpD,aAAa,IAAI,WAAW,EAAE;IAI9B,mBAAmB,IAAI,MAAM,EAAE;IAI/B,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO3D,QAAQ,IAAI,aAAa;IA6BzB,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU;IA0BlD,SAAS,IAAI,MAAM;IAenB,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAY5C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU;IA0B9B,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,cAAc,EAC9B,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,UAAU,GAAG,eAAe,EACvC,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC;IAoCtD,MAAM,CACJ,SAAS,EAAE,UAAU,GAAG,eAAe,EACvC,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,CACT,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,KACjB,IAAI,GACR,WAAW;CAiDf"}

package/dist/SessionManager.d.ts

@@ -1,40 +1,96 @@
-import { NostrPublish, NostrSubscribe, Rumor } from "./types";
-import { Invite } from "./Invite";
+import { IdentityKey, NostrSubscribe, NostrPublish, Rumor } from "./types";
 import { StorageAdapter } from "./StorageAdapter";
+import { Session } from "./Session";
 export type OnEventCallback = (event: Rumor, from: string) => void;
-export default class SessionManager {
-    private userRecords;
-    private nostrSubscribe;
-    private nostrPublish;
-    private ourIdentityKey;
-    private inviteUnsubscribes;
+/**
+ * Credentials for the invite handshake - used to listen for and decrypt invite responses
+ */
+export interface InviteCredentials {
+    ephemeralKeypair: {
+        publicKey: string;
+        privateKey: Uint8Array;
+    };
+    sharedSecret: string;
+}
+interface DeviceRecord {
+    deviceId: string;
+    activeSession?: Session;
+    inactiveSessions: Session[];
+    createdAt: number;
+    staleAt?: number;
+    hasResponderSession?: boolean;
+}
+interface UserRecord {
+    publicKey: string;
+    devices: Map<string, DeviceRecord>;
+}
+export declare class SessionManager {
+    private readonly storageVersion;
+    private readonly versionPrefix;
     private deviceId;
-    private invite?;
     private storage;
-    private messageQueue;
-    constructor(ourIdentityKey: Uint8Array, deviceId: string, nostrSubscribe: NostrSubscribe, nostrPublish: NostrPublish, storage?: StorageAdapter);
-    private _initialised;
+    private nostrSubscribe;
+    private nostrPublish;
+    private identityKey;
+    private ourPublicKey;
+    private ownerPublicKey;
+    private inviteKeys;
+    private userRecords;
+    private messageHistory;
+    private delegateToOwner;
+    private ourInviteResponseSubscription;
+    private inviteSubscriptions;
+    private sessionSubscriptions;
+    private internalSubscriptions;
+    private initialized;
+    constructor(ourPublicKey: string, identityKey: IdentityKey, deviceId: string, nostrSubscribe: NostrSubscribe, nostrPublish: NostrPublish, ownerPublicKey: string, inviteKeys: InviteCredentials, storage?: StorageAdapter);
+    init(): Promise<void>;
     /**
-     * Perform asynchronous initialisation steps: create (or load) our invite,
-     * publish it, hydrate sessions from storage and subscribe to new invites.
-     * Can be awaited by callers that need deterministic readiness.
+     * Start listening for invite responses on our ephemeral key.
+     * This is used by devices to receive session establishment responses.
      */
-    init(): Promise<void>;
-    private loadSessions;
-    private saveSession;
-    getDeviceId(): string;
-    getInvite(): Invite;
-    sendText(recipientIdentityKey: string, text: string): Promise<any[]>;
-    sendEvent(recipientIdentityKey: string, event: Partial<Rumor>): Promise<any[]>;
-    listenToUser(userPubkey: string): void;
-    stopListeningToUser(userPubkey: string): void;
-    private internalSubscriptions;
-    onEvent(callback: OnEventCallback): () => void;
-    close(): void;
+    private startInviteResponseListener;
+    private getOrCreateUserRecord;
+    private upsertDeviceRecord;
+    private sessionKey;
+    private sessionKeyPrefix;
+    private userRecordKey;
+    private userRecordKeyPrefix;
+    private versionKey;
     /**
-     * Accept an invite as our own device, persist the session, and publish the acceptance event.
-     * Used for multi-device flows where a user adds a new device.
+     * Resolve a pubkey to its owner if it's a known delegate device.
+     * Returns the input pubkey if not a known delegate.
      */
-    acceptOwnInvite(invite: Invite): Promise<void>;
+    private resolveToOwner;
+    /**
+     * Update the delegate-to-owner mapping from an InviteList.
+     * Extracts delegate device pubkeys and maps them to the owner.
+     */
+    private updateDelegateMapping;
+    private subscribeToUserInviteList;
+    private attachSessionSubscription;
+    private attachInviteListSubscription;
+    setupUser(userPubkey: string): void;
+    onEvent(callback: OnEventCallback): () => void;
+    getDeviceId(): string;
+    getUserRecords(): Map<string, UserRecord>;
+    close(): void;
+    deactivateCurrentSessions(publicKey: string): void;
+    deleteUser(userPubkey: string): Promise<void>;
+    private removeSessionSubscription;
+    private deleteUserSessionsFromStorage;
+    private sendMessageHistory;
+    sendEvent(recipientIdentityKey: string, event: Partial<Rumor>): Promise<Rumor | undefined>;
+    sendMessage(recipientPublicKey: string, content: string, options?: {
+        kind?: number;
+        tags?: string[][];
+    }): Promise<Rumor>;
+    private cleanupDevice;
+    private buildMessageTags;
+    private storeUserRecord;
+    private loadUserRecord;
+    private loadAllUserRecords;
+    private runMigrations;
 }
+export {};
 //# sourceMappingURL=SessionManager.d.ts.map

package/dist/SessionManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../src/SessionManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,YAAY,EAAE,cAAc,EAAE,KAAK,EAAe,MAAM,SAAS,CAAA;AAE7F,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,OAAO,EAAE,cAAc,EAA0B,MAAM,kBAAkB,CAAA;AAIzE,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;AAElE,MAAM,CAAC,OAAO,OAAO,cAAc;IAC/B,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,cAAc,CAAY;IAClC,OAAO,CAAC,kBAAkB,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,MAAM,CAAC,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAA4F;gBAG5G,cAAc,EAAE,UAAU,EAC1B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,cAA6C;IAc1D,OAAO,CAAC,YAAY,CAAQ;IAE5B;;;;OAIG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAwGpB,YAAY;YAiCZ,WAAW;IAOzB,WAAW,IAAI,MAAM;IAIrB,SAAS,IAAI,MAAM;IAOb,QAAQ,CAAC,oBAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAQnD,SAAS,CAAC,oBAAoB,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;IA4DnE,YAAY,CAAC,UAAU,EAAE,MAAM;IA8D/B,mBAAmB,CAAC,UAAU,EAAE,MAAM;IAStC,OAAO,CAAC,qBAAqB,CAAkC;IAE/D,OAAO,CAAC,QAAQ,EAAE,eAAe;IAkBjC,KAAK;IAiBL;;;OAGG;IACU,eAAe,CAAC,MAAM,EAAE,MAAM;CAgB9C"}
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../src/SessionManager.ts"],"names":[],"mappings":"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"}

package/dist/StorageAdapter.d.ts

@@ -15,4 +15,13 @@ export declare class InMemoryStorageAdapter implements StorageAdapter {
     del(key: string): Promise<void>;
     list(prefix?: string): Promise<string[]>;
 }
+export declare class LocalStorageAdapter implements StorageAdapter {
+    private keyPrefix;
+    constructor(keyPrefix?: string);
+    private getFullKey;
+    get<T = unknown>(key: string): Promise<T | undefined>;
+    put<T = unknown>(key: string, value: T): Promise<void>;
+    del(key: string): Promise<void>;
+    list(prefix?: string): Promise<string[]>;
+}
 //# sourceMappingURL=StorageAdapter.d.ts.map

package/dist/StorageAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageAdapter.d.ts","sourceRoot":"","sources":["../src/StorageAdapter.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IACrD,4BAA4B;IAC5B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,oCAAoC;IACpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,sDAAsD;IACtD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CACzC;AAED,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,KAAK,CAA6B;IAEpC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAIrD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B,IAAI,CAAC,MAAM,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAO3C"}
+{"version":3,"file":"StorageAdapter.d.ts","sourceRoot":"","sources":["../src/StorageAdapter.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IACrD,4BAA4B;IAC5B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,oCAAoC;IACpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,sDAAsD;IACtD,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CACzC;AAED,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,KAAK,CAA6B;IAEpC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAIrD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B,IAAI,CAAC,MAAM,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAQ3C;AAED,qBAAa,mBAAoB,YAAW,cAAc;IACxD,OAAO,CAAC,SAAS,CAAQ;gBAEb,SAAS,SAAa;IAIlC,OAAO,CAAC,UAAU;IAIZ,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IASrD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAStD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/B,IAAI,CAAC,MAAM,SAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAkB3C"}

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 export * from "./Session";
 export * from "./Invite";
+export * from "./InviteList";
+export * from "./inviteUtils";
 export * from "./types";
 export * from "./utils";
 export * from "./SessionManager";
+export * from "./DeviceManager";
+export * from "./StorageAdapter";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA"}

package/dist/inviteUtils.d.ts

@@ -0,0 +1,122 @@
+import { Session } from './Session';
+import { NostrSubscribe, EncryptFunction, DecryptFunction, KeyPair } from './types';
+/**
+ * Device payload for QR code / text code sharing.
+ */
+export interface DevicePayload {
+    /** Ephemeral public key (64 hex chars) */
+    ephemeralPubkey: string;
+    /** Shared secret (64 hex chars) */
+    sharedSecret: string;
+    /** Device ID (16 hex chars) */
+    deviceId: string;
+    /** Human-readable device label */
+    deviceLabel: string;
+    /** Identity public key for this device (64 hex chars) */
+    identityPubkey: string;
+}
+/**
+ * Generates a new ephemeral keypair for invites.
+ * @returns A keypair with publicKey (hex string) and privateKey (Uint8Array)
+ */
+export declare function generateEphemeralKeypair(): KeyPair;
+/**
+ * Generates a new shared secret for invite handshakes.
+ * @returns A 64-character hex string (32 bytes)
+ */
+export declare function generateSharedSecret(): string;
+/**
+ * Generates a unique device ID.
+ * @returns A random device ID string
+ */
+export declare function generateDeviceId(): string;
+export interface EncryptInviteResponseParams {
+    /** The invitee's session public key */
+    inviteeSessionPublicKey: string;
+    /** The invitee's identity public key */
+    inviteePublicKey: string;
+    /** The invitee's identity private key (optional if encrypt function provided) */
+    inviteePrivateKey?: Uint8Array;
+    /** The inviter's identity public key */
+    inviterPublicKey: string;
+    /** The inviter's ephemeral public key */
+    inviterEphemeralPublicKey: string;
+    /** The shared secret for the invite */
+    sharedSecret: string;
+    /** Optional device ID for the invitee's device */
+    deviceId?: string;
+    /** Optional custom encrypt function */
+    encrypt?: EncryptFunction;
+}
+export interface EncryptedInviteResponse {
+    /** The inner event containing the encrypted payload */
+    innerEvent: {
+        pubkey: string;
+        content: string;
+        created_at: number;
+    };
+    /** The outer envelope event */
+    envelope: {
+        kind: number;
+        pubkey: string;
+        content: string;
+        created_at: number;
+        tags: string[][];
+    };
+    /** The random sender's public key used for the envelope */
+    randomSenderPublicKey: string;
+    /** The random sender's private key used for the envelope */
+    randomSenderPrivateKey: Uint8Array;
+}
+/**
+ * Encrypts an invite response with two-layer encryption.
+ *
+ * Layer 1 (inner): Payload encrypted with DH key, then encrypted with shared secret.
+ * Layer 2 (outer): Envelope encrypted with random key -> inviter ephemeral key.
+ */
+export declare function encryptInviteResponse(params: EncryptInviteResponseParams): Promise<EncryptedInviteResponse>;
+export interface DecryptInviteResponseParams {
+    /** The encrypted envelope content */
+    envelopeContent: string;
+    /** The envelope sender's public key */
+    envelopeSenderPubkey: string;
+    /** The inviter's ephemeral private key */
+    inviterEphemeralPrivateKey: Uint8Array;
+    /** The inviter's identity private key (optional if decrypt function provided) */
+    inviterPrivateKey?: Uint8Array;
+    /** The shared secret for the invite */
+    sharedSecret: string;
+    /** Optional custom decrypt function */
+    decrypt?: DecryptFunction;
+}
+export interface DecryptedInviteResponse {
+    /** The invitee's identity public key */
+    inviteeIdentity: string;
+    /** The invitee's session public key */
+    inviteeSessionPublicKey: string;
+    /** Optional device ID for the invitee's device */
+    deviceId?: string;
+}
+/**
+ * Decrypts an invite response.
+ */
+export declare function decryptInviteResponse(params: DecryptInviteResponseParams): Promise<DecryptedInviteResponse>;
+export interface CreateSessionFromAcceptParams {
+    /** Nostr subscription function */
+    nostrSubscribe: NostrSubscribe;
+    /** The other party's public key */
+    theirPublicKey: string;
+    /** Our session private key */
+    ourSessionPrivateKey: Uint8Array;
+    /** The shared secret (hex string) */
+    sharedSecret: string;
+    /** Whether we are the sender (initiator) */
+    isSender: boolean;
+    /** Optional session name */
+    name?: string;
+}
+/**
+ * Creates a Session from invite acceptance parameters.
+ */
+export declare function createSessionFromAccept(params: CreateSessionFromAcceptParams): Session;
+//# sourceMappingURL=inviteUtils.d.ts.map

package/dist/inviteUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inviteUtils.d.ts","sourceRoot":"","sources":["../src/inviteUtils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,cAAc,EAAwB,eAAe,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEzG;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAA;IACvB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAA;IACpB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,OAAO,CAIlD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,MAAM,WAAW,2BAA2B;IAC1C,uCAAuC;IACvC,uBAAuB,EAAE,MAAM,CAAA;IAC/B,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,CAAA;IACxB,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,UAAU,CAAA;IAC9B,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,CAAA;IACxB,yCAAyC;IACzC,yBAAyB,EAAE,MAAM,CAAA;IACjC,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,UAAU,EAAE;QACV,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,+BAA+B;IAC/B,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,MAAM,CAAA;QACf,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;KACjB,CAAA;IACD,2DAA2D;IAC3D,qBAAqB,EAAE,MAAM,CAAA;IAC7B,4DAA4D;IAC5D,sBAAsB,EAAE,UAAU,CAAA;CACnC;AAMD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA0DjH;AAED,MAAM,WAAW,2BAA2B;IAC1C,qCAAqC;IACrC,eAAe,EAAE,MAAM,CAAA;IACvB,uCAAuC;IACvC,oBAAoB,EAAE,MAAM,CAAA;IAC5B,0CAA0C;IAC1C,0BAA0B,EAAE,UAAU,CAAA;IACtC,iFAAiF;IACjF,iBAAiB,CAAC,EAAE,UAAU,CAAA;IAC9B,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAA;IACpB,uCAAuC;IACvC,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAA;IACvB,uCAAuC;IACvC,uBAAuB,EAAE,MAAM,CAAA;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAoDjH;AAED,MAAM,WAAW,6BAA6B;IAC5C,kCAAkC;IAClC,cAAc,EAAE,cAAc,CAAA;IAC9B,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,8BAA8B;IAC9B,oBAAoB,EAAE,UAAU,CAAA;IAChC,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAA;IACjB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,6BAA6B,GAAG,OAAO,CAYtF"}