@edryslabs/genericprovider 1.0.1

package/dist/providers/nostr/index.js

@@ -0,0 +1,280 @@
+/**
+ * Nostr Transport Provider
+ *
+ * Serverless, decentralised synchronisation using the Nostr protocol.
+ * Binary Yjs updates are base64-encoded and published as signed Nostr events
+ * to one or more relays. Every connected client subscribes to the same room tag,
+ * so updates fan out through all configured relays automatically.
+ *
+ * Features:
+ * - No server setup required (uses public relays or your own)
+ * - Multi-relay fan-out for redundancy
+ * - Ephemeral or persistent identity (bring-your-own key pair)
+ * - Optional password to obfuscate the room tag (SHA-256)
+ * - Configurable history window to catch up on missed updates
+ * - Automatic deduplication (events from self are ignored)
+ *
+ * @example
+ * ```typescript
+ * import * as Y from 'yjs'
+ * import { GenericProvider } from 'y-generic'
+ * import { NostrTransport } from 'y-generic/providers/nostr'
+ * import { finalizeEvent, getPublicKey, SimplePool } from 'nostr-tools'
+ *
+ * const doc = new Y.Doc()
+ * const transport = new NostrTransport({ finalizeEvent, getPublicKey, SimplePool })
+ *
+ * const provider = new GenericProvider(doc, transport)
+ * await provider.connect({
+ *   room: 'my-doc',
+ *   relays: ['wss://relay.damus.io', 'wss://nos.lol'],
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With a persistent identity and password-protected room
+ * import { generateSecretKey } from 'nostr-tools/pure'
+ *
+ * const secretKey = generateSecretKey()  // persist this to keep identity
+ * const transport = new NostrTransport({ finalizeEvent, getPublicKey, SimplePool, secretKey })
+ *
+ * await provider.connect({
+ *   room: 'my-doc',
+ *   password: 'secret',
+ *   relays: ['wss://relay.damus.io'],
+ *   historyWindowSecs: 3600,  // fetch last hour of updates on connect
+ * })
+ * ```
+ */
+// ---------------------------------------------------------------------------
+// CRC32 translation helpers
+//
+// GenericProvider wraps every outgoing message as [CRC32 (4 bytes)][payload].
+// Nostr event content is plain text (base64), so we strip the CRC32 header
+// before encoding and re-add it after decoding so GenericProvider accepts the
+// incoming message.
+// ---------------------------------------------------------------------------
+const _CRC32_TABLE = (() => {
+    const table = new Uint32Array(256);
+    for (let i = 0; i < 256; i++) {
+        let c = i;
+        for (let j = 0; j < 8; j++)
+            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        table[i] = c;
+    }
+    return table;
+})();
+function _crc32(data) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < data.length; i++)
+        crc = (crc >>> 8) ^ _CRC32_TABLE[(crc ^ data[i]) & 0xff];
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/** Strip the 4-byte CRC32 header that GenericProvider prepends. */
+function stripCRC32Header(data) {
+    return data.length >= 4 ? data.subarray(4) : data;
+}
+/** Add a valid CRC32 header so GenericProvider accepts the message. */
+function addCRC32Header(data) {
+    const crc = _crc32(data);
+    const wrapped = new Uint8Array(4 + data.length);
+    wrapped[0] = (crc >>> 24) & 0xff;
+    wrapped[1] = (crc >>> 16) & 0xff;
+    wrapped[2] = (crc >>> 8) & 0xff;
+    wrapped[3] = crc & 0xff;
+    wrapped.set(data, 4);
+    return wrapped;
+}
+// ---------------------------------------------------------------------------
+// Base64 helpers (no Buffer/Node dependency)
+// ---------------------------------------------------------------------------
+function uint8ArrayToBase64(data) {
+    let binary = '';
+    for (let i = 0; i < data.length; i++) {
+        binary += String.fromCharCode(data[i]);
+    }
+    return btoa(binary);
+}
+function base64ToUint8Array(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+// ---------------------------------------------------------------------------
+// Password hashing (obfuscates room tag — not encryption)
+// ---------------------------------------------------------------------------
+async function hashPassword(password) {
+    const encoded = new TextEncoder().encode(password);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', encoded);
+    return Array.from(new Uint8Array(hashBuffer))
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('')
+        .substring(0, 16);
+}
+// ---------------------------------------------------------------------------
+// Nostr event kind for Yjs collaboration events.
+//
+// Kind 27370 is an application-specific kind chosen to avoid collisions with
+// any well-known NIPs. Relays treat it as a regular (stored) event so that
+// peers joining later can catch up on missed updates.
+// ---------------------------------------------------------------------------
+const DEFAULT_KIND = 27370;
+// Default public relays used when no `relays` list is provided in config.
+const DEFAULT_RELAYS = [
+    'wss://relay.damus.io',
+    'wss://nos.lol',
+    'wss://relay.nostr.band',
+];
+// ---------------------------------------------------------------------------
+// NostrTransport
+// ---------------------------------------------------------------------------
+/**
+ * Nostr transport for y-generic.
+ *
+ * Publishes Yjs binary updates as base64-encoded Nostr events and subscribes
+ * to matching events from peers. Works in both browser and Node.js environments.
+ */
+export class NostrTransport {
+    constructor(opts) {
+        this._connected = false;
+        this._buffer = [];
+        this.pool = null;
+        this.sub = null;
+        this.relays = [];
+        this.pubkey = '';
+        this.roomTag = '';
+        this.opts = opts;
+        this.eventKind = opts.eventKind ?? DEFAULT_KIND;
+        // Use provided key or an initial placeholder; real key resolved on connect.
+        this.secretKey = opts.secretKey ?? new Uint8Array(32);
+    }
+    get isConnected() {
+        return this._connected;
+    }
+    // ---------------------------------------------------------------------------
+    // Transport interface
+    // ---------------------------------------------------------------------------
+    async connect(config) {
+        if (this._connected) {
+            throw new Error('NostrTransport: already connected');
+        }
+        const debug = config.debug ?? this.opts.debug ?? false;
+        this.relays =
+            config.relays && config.relays.length > 0 ? config.relays : DEFAULT_RELAYS;
+        // Resolve signing key
+        if (this.opts.secretKey) {
+            this.secretKey = this.opts.secretKey;
+        }
+        else {
+            // Ephemeral key — unique per transport instance lifetime
+            this.secretKey = crypto.getRandomValues(new Uint8Array(32));
+        }
+        this.pubkey = this.opts.getPublicKey(this.secretKey);
+        // Compute room tag (optionally obfuscated by password)
+        this.roomTag = config.password
+            ? `${config.room}-${await hashPassword(config.password)}`
+            : config.room;
+        const historyWindowSecs = config.historyWindowSecs ?? 86400;
+        const since = historyWindowSecs > 0
+            ? Math.floor(Date.now() / 1000) - historyWindowSecs
+            : Math.floor(Date.now() / 1000); // real-time only
+        const filter = {
+            kinds: [this.eventKind],
+            '#r': [this.roomTag],
+            since,
+        };
+        this.pool = new this.opts.SimplePool();
+        if (debug) {
+            console.log('[NostrTransport] Connecting. relays:', this.relays, 'room:', this.roomTag, 'kind:', this.eventKind, 'filter.since:', since);
+        }
+        // Subscribe to events matching our room. The subscription delivers both
+        // stored (historical) events first, then real-time new events.
+        this.sub = this.pool.subscribeMany(this.relays, [filter], {
+            onevent: (event) => {
+                // Ignore events published by this client to avoid echo
+                if (event.pubkey === this.pubkey)
+                    return;
+                if (debug) {
+                    console.log('[NostrTransport] Received event', event.id.substring(0, 8), 'from', event.pubkey.substring(0, 8));
+                }
+                try {
+                    const raw = base64ToUint8Array(event.content);
+                    const withHeader = addCRC32Header(raw);
+                    this._deliver(withHeader);
+                }
+                catch (err) {
+                    console.warn('[NostrTransport] Failed to decode event content:', err);
+                }
+            },
+            oneose: () => {
+                if (debug) {
+                    console.log('[NostrTransport] EOSE — stored events delivered');
+                }
+            },
+        });
+        this._connected = true;
+        if (debug) {
+            console.log('[NostrTransport] Connected, pubkey:', this.pubkey);
+        }
+    }
+    disconnect() {
+        if (this.sub) {
+            this.sub.close();
+            this.sub = null;
+        }
+        if (this.pool) {
+            this.pool.close(this.relays);
+            this.pool = null;
+        }
+        this._connected = false;
+        this._buffer = [];
+    }
+    async send(data) {
+        if (!this._connected || !this.pool) {
+            console.warn('[NostrTransport] Cannot send: not connected');
+            return;
+        }
+        // Strip the 4-byte CRC32 header added by GenericProvider before encoding
+        const raw = stripCRC32Header(data);
+        const content = uint8ArrayToBase64(raw);
+        const event = this.opts.finalizeEvent({
+            kind: this.eventKind,
+            created_at: Math.floor(Date.now() / 1000),
+            // Tag `r` is used as the room/document identifier for filtering
+            tags: [['r', this.roomTag]],
+            content,
+        }, this.secretKey);
+        // Publish to all relays; ignore individual relay errors
+        await Promise.allSettled(this.pool.publish(this.relays, event));
+    }
+    onMessage(callback) {
+        this._callback = callback;
+        // Flush buffered messages that arrived before this registration
+        if (this._buffer.length > 0) {
+            for (const msg of this._buffer) {
+                callback(msg);
+            }
+            this._buffer = [];
+        }
+        return () => {
+            this._callback = undefined;
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Private helpers
+    // ---------------------------------------------------------------------------
+    _deliver(data) {
+        if (this._callback) {
+            this._callback(data);
+        }
+        else {
+            // Buffer messages that arrive before onMessage() is registered
+            this._buffer.push(data);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/nostr/index.js.map

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

package/dist/providers/peerjs/index.d.ts

@@ -0,0 +1,231 @@
+/**
+ * PeerJS Transport Provider
+ *
+ * Peer-to-peer transport using WebRTC data channels with PeerJS library.
+ * PeerJS provides a simpler API and built-in signaling infrastructure.
+ *
+ * Features:
+ * - Direct peer-to-peer connections
+ * - Built-in signaling servers (PeerJS Cloud)
+ * - Automatic peer ID management
+ * - Simple connection API
+ * - Optional encryption
+ * - Automatic reconnection
+ *
+ * @example
+ * ```typescript
+ * import { GenericProvider } from 'y-generic'
+ * import { PeerJSTransport } from 'y-generic/providers/peerjs'
+ * import Peer from 'peerjs'
+ *
+ * const doc = new Y.Doc()
+ * const transport = new PeerJSTransport({
+ *   peer: Peer, // Pass the PeerJS constructor
+ *   password: 'optional-encryption-key'
+ * })
+ * const provider = new GenericProvider(doc, transport)
+ * await provider.connect({ room: 'my-room' })
+ * ```
+ */
+import type { Transport, ConnectionConfig } from '../../transport';
+/**
+ * PeerJS constructor type (from peerjs library).
+ */
+export type PeerJSConstructor = any;
+/**
+ * Configuration options for PeerJS transport.
+ */
+export interface PeerJSTransportOptions {
+    /**
+     * The PeerJS library constructor.
+     * Users must provide this to avoid bundling the library.
+     * @example
+     * ```typescript
+     * import Peer from 'peerjs'
+     * const transport = new PeerJSTransport({ peer: Peer })
+     * ```
+     */
+    peer: PeerJSConstructor;
+    /**
+     * PeerJS server configuration.
+     * @default Uses PeerJS Cloud (cloud.peerjs.com)
+     */
+    peerOptions?: {
+        host?: string;
+        port?: number;
+        path?: string;
+        key?: string;
+        secure?: boolean;
+        config?: any;
+        debug?: number;
+    };
+    /**
+     * Optional password for encrypting messages.
+     * When provided, all messages are encrypted before sending.
+     * @default undefined
+     */
+    password?: string;
+    /**
+     * Maximum number of peer connections.
+     * @default 20 + random(0-15)
+     */
+    maxConns?: number;
+    /**
+     * Enable debug logging.
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * PeerJS transport implementation.
+ * Creates direct peer-to-peer connections using PeerJS library.
+ */
+export declare class PeerJSTransport implements Transport {
+    private options;
+    private _connected;
+    private _room;
+    private _callback?;
+    private _peerConnectCallback?;
+    private peer;
+    private peerId;
+    private peers;
+    private knownPeers;
+    private broadcastChannel?;
+    private discoveryInterval?;
+    private isCoordinator;
+    private coordinatorPeerId;
+    private coordinatorConn?;
+    private roomPeers;
+    private reElectionInProgress;
+    private _destroying;
+    /**
+     * Create a new PeerJS transport.
+     *
+     * @param options - Configuration options (must include peer constructor)
+     */
+    constructor(options: PeerJSTransportOptions);
+    /**
+     * Connect to the room and start discovering peers.
+     */
+    connect(config: ConnectionConfig): Promise<void>;
+    /**
+     * Create a regular (non-coordinator) peer and connect to coordinator.
+     */
+    private createRegularPeer;
+    /**
+     * Disconnect from all peers and cleanup.
+     */
+    disconnect(): void;
+    /**
+     * Handle unexpected disconnect from the PeerJS signaling server.
+     * Happens on network changes (WiFi ↔ mobile), server restarts, etc.
+     * PeerJS keeps the same Peer ID — we call reconnect() then re-open
+     * DataConnections to all peers we already knew about.
+     */
+    private _handlePeerServerDisconnect;
+    /**
+     * Register callback for new peer data-channel connections.
+     */
+    onPeerConnect(callback: (peerId: string) => void): () => void;
+    /**
+     * Send data to all connected peers.
+     */
+    send(data: Uint8Array): void;
+    /**
+     * Register callback for incoming messages.
+     */
+    onMessage(callback: (data: Uint8Array) => void): () => void;
+    /**
+     * Check if connected.
+     */
+    get isConnected(): boolean;
+    /**
+     * Get number of connected peers (for debugging).
+     */
+    get connectedPeers(): number;
+    /**
+     * Setup peer discovery using BroadcastChannel for same-browser tabs.
+     */
+    private setupPeerDiscovery;
+    /**
+     * Announce presence to other peers.
+     */
+    private announcePeer;
+    /**
+     * Setup cross-browser peer discovery by connecting to the coordinator.
+     *
+     * Note: This method is only called for regular (non-coordinator) peers.
+     * The coordinator already exists because we failed to claim its ID.
+     */
+    private setupCrossBrowserDiscovery;
+    /**
+     * Become the coordinator for this room.
+     */
+    private becomeCoordinator;
+    /**
+     * Handle messages from coordinator (when we're a regular peer).
+     */
+    private handleCoordinatorMessage;
+    /**
+     * Handle coordinator disconnect - start re-election.
+     */
+    private handleCoordinatorDisconnect;
+    /**
+     * Attempt to connect to the coordinator.
+     * If coordinator doesn't exist yet, retry a few times.
+     */
+    private attemptCoordinatorConnection;
+    /**
+     * Transition from regular peer to coordinator by reconnecting with coordinator ID.
+     */
+    private transitionToCoordinator;
+    /**
+     * Recreate the local peer with a fresh random ID and reconnect to the
+     * coordinator (whoever won the election while we were transitioning).
+     * Called when transitionToCoordinator() fails.
+     */
+    private reestablishAsRegularPeer;
+    /**
+     * Connect to a peer by ID.
+     * To avoid race conditions, only the peer with the lower ID initiates the connection.
+     */
+    private connectToPeer;
+    /**
+     * Handle incoming connection from another peer.
+     */
+    private handleIncomingConnection;
+    /**
+     * Setup a peer connection with event handlers.
+     */
+    private setupConnection;
+    /**
+     * Remove and cleanup a peer connection.
+     */
+    private removePeer;
+    /**
+     * Send a coordination message (JSON encoded as binary).
+     */
+    private sendCoordinationMessage;
+    /**
+     * Try to decode data as a coordination message.
+     * Returns the parsed message if successful, null otherwise.
+     */
+    private tryDecodeCoordinationMessage;
+    /**
+     * Simple XOR encryption (not cryptographically secure, just obfuscation).
+     */
+    private encrypt;
+    /**
+     * Simple XOR decryption.
+     */
+    private decrypt;
+    /**
+     * Hash password to key.
+     */
+    private hashPassword;
+    /**
+     * Log debug messages if enabled.
+     */
+    private log;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/peerjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/peerjs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAElE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAEnC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;OAQG;IACH,IAAI,EAAE,iBAAiB,CAAA;IAEvB;;;OAGG;IACH,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,MAAM,CAAC,EAAE,GAAG,CAAA;QACZ,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IAED;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAQD;;;GAGG;AACH,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAAC,CAA4B;IAC9C,OAAO,CAAC,oBAAoB,CAAC,CAA0B;IACvD,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,gBAAgB,CAAC,CAAkB;IAC3C,OAAO,CAAC,iBAAiB,CAAC,CAAgC;IAG1D,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,eAAe,CAAC,CAAK;IAC7B,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,oBAAoB,CAAiB;IAC7C,OAAO,CAAC,WAAW,CAAiB;IAEpC;;;;OAIG;gBACS,OAAO,EAAE,sBAAsB;IAkB3C;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwFtD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuDzB;;OAEG;IACH,UAAU,IAAI,IAAI;IA+ElB;;;;;OAKG;IACH,OAAO,CAAC,2BAA2B;IAyDnC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAO7D;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IA2B5B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;IAO3D;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwC1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;OAKG;YACW,0BAA0B;IA4GxC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsBzB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA6ChC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAmDnC;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAqCpC;;OAEG;YACW,uBAAuB;IAsFrC;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAuDhC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAuCrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAkDhC;;OAEG;IACH,OAAO,CAAC,eAAe;IAiGvB;;OAEG;IACH,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAW/B;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IAsBpC;;OAEG;IACH,OAAO,CAAC,OAAO;IASf;;OAEG;IACH,OAAO,CAAC,OAAO;IAKf;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}