peerix - v0.8.0
    Preparing search index...

    Class SupabaseDriver

    Supabase-based signaling driver.

    This driver uses Supabase Realtime to relay signaling messages between clients through your Supabase server. Each namespace maps to its own broadcast channel. Messages for namespaces the client isn't subscribed to (such as direct messages to other peers) are sent via the Realtime REST API.

    A namespace that fails to subscribe is retried with exponential backoff while the driver stays active, and rooms announce themselves again once it is restored.

    This driver requires the @supabase/supabase-js module in the browser.

    import { createClient } from "@supabase/supabase-js";

    // connect to a Supabase server
    const supabase = createClient("https://xyz.supabase.co", "your-publishable-key");

    // create a new driver instance
    const driver = new SupabaseDriver({ supabase });

    Hierarchy (View Summary)

    Index
    • Creates a new instance of the driver.

      Parameters

      • options: { prefix?: string; supabase: SupabaseClient }

        Configuration options for the driver.

        • Optionalprefix?: string

          Optional Supabase channel prefix.

        • supabase: SupabaseClient

          Supabase client instance.

      Returns SupabaseDriver

      If supabase is not a valid Supabase client.

    • get active(): boolean

      Indicates whether the driver is currently active. Subclasses must keep it in sync with their connection: signaling messages are only published while the driver is active, and joined rooms announce themselves again when it becomes active. A namespace that fails on its own leaves the driver active, and emitting active once it is subscribed again makes rooms announce themselves to the peers they missed.

      Returns boolean

    • set active(value: boolean): void

      Sets the active state of the driver and emits corresponding events.

      Parameters

      • value: boolean

      Returns void

    • Destroys the driver instance, cleaning up any resources. Emits inactive if the driver was active, then removes all event handlers.

      Returns void

    • Registers an event handler for the specified internal event.

      Type Parameters

      Parameters

      • event: K

        The event name.

      • handler: (...args: DriverEvents[K]) => void

        The event handler function.

      • Optionaloptions: { signal?: AbortSignal }

        Listener options.

        • Optionalsignal?: AbortSignal

          Removes the handler when aborted.

      Returns () => void

      A function that removes the handler.

    • Publishes a signaling message to the specified namespace.

      Parameters

      • namespace: string

        The namespace to publish the message to.

      • data: number[]

        The message data to publish.

      Returns Promise<void>

      Nothing directly; resolves once the message is delivered (async drivers may return a promise).

    • Subscribes to signaling messages for the specified namespace.

      Parameters

      • namespace: string

        The namespace to subscribe to.

      • handler: (data: number[]) => void

        The handler function to call when a message is received.

      Returns Promise<void>

      Nothing directly; resolves once the subscription is established (async drivers may return a promise).

    • Unsubscribes from signaling messages for the specified namespace.

      Parameters

      • namespace: string

        The namespace to unsubscribe from.

      • handler: (data: number[]) => void

        The handler function to remove.

      Returns Promise<void>

      Nothing directly; resolves once the unsubscription is confirmed (async drivers may return a promise).