@privateclaw/privateclaw-relay 0.1.0

package/dist/push-notifier.js.map

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

package/dist/push-registration-store.d.ts

@@ -0,0 +1,39 @@
+export interface RelayPushRegistrationRecord {
+    sessionId: string;
+    appId: string;
+    token: string;
+    updatedAt: number;
+}
+export interface RelayPushRegistrationStore {
+    readonly persistent: boolean;
+    saveRegistration(registration: RelayPushRegistrationRecord, expiresAt: number): Promise<void>;
+    deleteRegistration(sessionId: string, appId: string): Promise<void>;
+    listRegistrations(sessionId: string): Promise<RelayPushRegistrationRecord[]>;
+    clearSession(sessionId: string): Promise<void>;
+    touchSession(sessionId: string, expiresAt: number): Promise<void>;
+    close(): Promise<void>;
+}
+export declare class InMemoryRelayPushRegistrationStore implements RelayPushRegistrationStore {
+    readonly persistent = false;
+    private readonly registrations;
+    saveRegistration(registration: RelayPushRegistrationRecord, _expiresAt: number): Promise<void>;
+    deleteRegistration(sessionId: string, appId: string): Promise<void>;
+    listRegistrations(sessionId: string): Promise<RelayPushRegistrationRecord[]>;
+    clearSession(sessionId: string): Promise<void>;
+    touchSession(_sessionId: string, _expiresAt: number): Promise<void>;
+    close(): Promise<void>;
+}
+export declare class RedisRelayPushRegistrationStore implements RelayPushRegistrationStore {
+    readonly persistent = true;
+    private readonly redis;
+    constructor(redisUrl: string);
+    saveRegistration(registration: RelayPushRegistrationRecord, expiresAt: number): Promise<void>;
+    deleteRegistration(sessionId: string, appId: string): Promise<void>;
+    listRegistrations(sessionId: string): Promise<RelayPushRegistrationRecord[]>;
+    clearSession(sessionId: string): Promise<void>;
+    touchSession(sessionId: string, expiresAt: number): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function createRelayPushRegistrationStore(params: {
+    redisUrl?: string;
+}): RelayPushRegistrationStore;

package/dist/push-registration-store.js

@@ -0,0 +1,98 @@
+import { Redis } from "ioredis";
+const PUSH_REGISTRATION_KEY_PREFIX = "privateclaw:push-registrations:v1";
+function pushRegistrationsKey(sessionId) {
+    return `${PUSH_REGISTRATION_KEY_PREFIX}:${sessionId}`;
+}
+export class InMemoryRelayPushRegistrationStore {
+    persistent = false;
+    registrations = new Map();
+    async saveRegistration(registration, _expiresAt) {
+        const sessionRegistrations = this.registrations.get(registration.sessionId) ??
+            new Map();
+        sessionRegistrations.set(registration.appId, { ...registration });
+        this.registrations.set(registration.sessionId, sessionRegistrations);
+    }
+    async deleteRegistration(sessionId, appId) {
+        const sessionRegistrations = this.registrations.get(sessionId);
+        if (!sessionRegistrations) {
+            return;
+        }
+        sessionRegistrations.delete(appId);
+        if (sessionRegistrations.size === 0) {
+            this.registrations.delete(sessionId);
+        }
+    }
+    async listRegistrations(sessionId) {
+        const sessionRegistrations = this.registrations.get(sessionId);
+        if (!sessionRegistrations) {
+            return [];
+        }
+        return [...sessionRegistrations.values()].map((registration) => ({
+            ...registration,
+        }));
+    }
+    async clearSession(sessionId) {
+        this.registrations.delete(sessionId);
+    }
+    async touchSession(_sessionId, _expiresAt) { }
+    async close() {
+        this.registrations.clear();
+    }
+}
+export class RedisRelayPushRegistrationStore {
+    persistent = true;
+    redis;
+    constructor(redisUrl) {
+        this.redis = new Redis(redisUrl, {
+            lazyConnect: false,
+            maxRetriesPerRequest: 1,
+        });
+    }
+    async saveRegistration(registration, expiresAt) {
+        const ttlMs = Math.max(expiresAt - Date.now(), 1);
+        await this.redis
+            .multi()
+            .hset(pushRegistrationsKey(registration.sessionId), registration.appId, JSON.stringify(registration))
+            .pexpire(pushRegistrationsKey(registration.sessionId), ttlMs)
+            .exec();
+    }
+    async deleteRegistration(sessionId, appId) {
+        await this.redis.hdel(pushRegistrationsKey(sessionId), appId);
+    }
+    async listRegistrations(sessionId) {
+        const values = await this.redis.hvals(pushRegistrationsKey(sessionId));
+        const registrations = [];
+        for (const rawValue of values) {
+            try {
+                const registration = JSON.parse(rawValue);
+                if (typeof registration.sessionId === "string" &&
+                    typeof registration.appId === "string" &&
+                    typeof registration.token === "string" &&
+                    typeof registration.updatedAt === "number") {
+                    registrations.push(registration);
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        return registrations;
+    }
+    async clearSession(sessionId) {
+        await this.redis.del(pushRegistrationsKey(sessionId));
+    }
+    async touchSession(sessionId, expiresAt) {
+        const ttlMs = Math.max(expiresAt - Date.now(), 1);
+        await this.redis.pexpire(pushRegistrationsKey(sessionId), ttlMs);
+    }
+    async close() {
+        await this.redis.quit();
+    }
+}
+export function createRelayPushRegistrationStore(params) {
+    if (params.redisUrl) {
+        return new RedisRelayPushRegistrationStore(params.redisUrl);
+    }
+    return new InMemoryRelayPushRegistrationStore();
+}
+//# sourceMappingURL=push-registration-store.js.map

package/dist/push-registration-store.js.map

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

package/dist/relay-cli.d.ts

@@ -0,0 +1,28 @@
+import { type RelayServerConfig } from "./config.js";
+import { createRelayServer } from "./relay-server.js";
+import { type RelayTunnelProvider } from "./tunnel.js";
+export interface RelayCliOptions {
+    showHelp: boolean;
+    configOverrides: Partial<RelayServerConfig>;
+    publicTunnel?: RelayTunnelProvider;
+}
+type RelayServerInstance = ReturnType<typeof createRelayServer>;
+interface StartedRelayServer {
+    relayServer: RelayServerInstance;
+    port: number;
+    url: string;
+}
+interface StartRelayServerWithPortFallbackOptions {
+    config: RelayServerConfig;
+    allowPortFallback: boolean;
+    maxAttempts?: number;
+    createRelayServerInstance?: typeof createRelayServer;
+    onLog?: (line: string) => void;
+}
+export declare function renderRelayCliHelp(): string;
+export declare function parseRelayCliArgs(args: string[]): RelayCliOptions;
+export declare function shouldAllowRelayCliPortFallback(parsed: RelayCliOptions, env?: NodeJS.ProcessEnv): boolean;
+export declare function startRelayServerWithPortFallback(params: StartRelayServerWithPortFallbackOptions): Promise<StartedRelayServer>;
+export declare function applyRelayCliOverrides(config: RelayServerConfig, overrides: Partial<RelayServerConfig>): RelayServerConfig;
+export declare function runRelayCli(args: string[]): Promise<void>;
+export {};

package/dist/relay-cli.js

@@ -0,0 +1,256 @@
+import { parseArgs } from "node:util";
+import { RelayCliUserError } from "./cli-error.js";
+import { loadRelayConfig } from "./config.js";
+import { createRelayServer } from "./relay-server.js";
+import { ensureRelayTunnelDependencyAvailable } from "./tunnel-installer.js";
+import { isRelayTunnelProvider, MissingRelayTunnelBinaryError, openRelayTunnel, } from "./tunnel.js";
+const DEFAULT_PORT_FALLBACK_ATTEMPTS = 50;
+function parsePositiveIntegerFlag(value, label) {
+    if (!value || value.trim() === "") {
+        return undefined;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`${label} must be a positive integer.`);
+    }
+    return parsed;
+}
+export function renderRelayCliHelp() {
+    return `privateclaw-relay [serve] [--host <host>] [--port <port>] [--ttl-ms <ms>] [--frame-cache-size <count>] [--redis-url <url>] [--public <tailscale|cloudflare>]
+
+Start the local PrivateClaw relay server.
+
+Examples:
+  privateclaw-relay
+  privateclaw-relay --port 8787 --public tailscale
+  privateclaw-relay serve --host 0.0.0.0 --redis-url redis://127.0.0.1:6379
+
+Notes:
+  default local port     automatically retries the next free port when 8787 is busy
+  --public tailscale   enables Tailscale Funnel for the relay port
+  --public cloudflare  starts a temporary Cloudflare quick tunnel
+`;
+}
+export function parseRelayCliArgs(args) {
+    const parsed = parseArgs({
+        args,
+        allowPositionals: true,
+        options: {
+            host: { type: "string" },
+            port: { type: "string" },
+            "ttl-ms": { type: "string" },
+            "frame-cache-size": { type: "string" },
+            "redis-url": { type: "string" },
+            public: { type: "string" },
+            help: { type: "boolean", short: "h" },
+        },
+    });
+    const [command, ...rest] = parsed.positionals;
+    if (command === "help") {
+        return {
+            showHelp: true,
+            configOverrides: {},
+        };
+    }
+    if (command && command !== "serve") {
+        throw new Error(`Unsupported privateclaw-relay command: ${command}`);
+    }
+    if (rest.length > 0) {
+        throw new Error(`Unexpected extra arguments: ${rest.join(" ")}`);
+    }
+    if (parsed.values.help) {
+        return {
+            showHelp: true,
+            configOverrides: {},
+        };
+    }
+    const publicTunnelRaw = parsed.values.public?.trim();
+    if (publicTunnelRaw && !isRelayTunnelProvider(publicTunnelRaw)) {
+        throw new Error(`--public must be either "tailscale" or "cloudflare". Received: ${publicTunnelRaw}`);
+    }
+    const publicTunnel = publicTunnelRaw && isRelayTunnelProvider(publicTunnelRaw)
+        ? publicTunnelRaw
+        : undefined;
+    const port = parsePositiveIntegerFlag(parsed.values.port, "--port");
+    const sessionTtlMs = parsePositiveIntegerFlag(parsed.values["ttl-ms"], "--ttl-ms");
+    const frameCacheSize = parsePositiveIntegerFlag(parsed.values["frame-cache-size"], "--frame-cache-size");
+    return {
+        showHelp: false,
+        configOverrides: {
+            ...(parsed.values.host?.trim()
+                ? { host: parsed.values.host.trim() }
+                : {}),
+            ...(typeof port === "number" ? { port } : {}),
+            ...(typeof sessionTtlMs === "number" ? { sessionTtlMs } : {}),
+            ...(typeof frameCacheSize === "number" ? { frameCacheSize } : {}),
+            ...(parsed.values["redis-url"]?.trim()
+                ? { redisUrl: parsed.values["redis-url"].trim() }
+                : {}),
+        },
+        ...(publicTunnel ? { publicTunnel } : {}),
+    };
+}
+function isAddressInUseError(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "EADDRINUSE");
+}
+export function shouldAllowRelayCliPortFallback(parsed, env = process.env) {
+    if (typeof parsed.configOverrides.port === "number") {
+        return false;
+    }
+    return !(env.PRIVATECLAW_RELAY_PORT?.trim() ||
+        env.PORT?.trim());
+}
+export async function startRelayServerWithPortFallback(params) {
+    const createRelayServerInstance = params.createRelayServerInstance ?? createRelayServer;
+    const maxAttempts = params.allowPortFallback
+        ? Math.max(1, params.maxAttempts ?? DEFAULT_PORT_FALLBACK_ATTEMPTS)
+        : 1;
+    let currentPort = params.config.port;
+    for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+        const relayServer = createRelayServerInstance({
+            ...params.config,
+            port: currentPort,
+        });
+        try {
+            const started = await relayServer.start();
+            if (attempt > 0) {
+                params.onLog?.(`[privateclaw-relay] port ${params.config.port} was unavailable, listening on ${started.port} instead.`);
+            }
+            return {
+                relayServer,
+                port: started.port,
+                url: started.url,
+            };
+        }
+        catch (error) {
+            await relayServer.stop();
+            if (!params.allowPortFallback ||
+                !isAddressInUseError(error) ||
+                currentPort >= 65_535 ||
+                attempt + 1 >= maxAttempts) {
+                throw error;
+            }
+            const nextPort = currentPort + 1;
+            params.onLog?.(`[privateclaw-relay] port ${currentPort} is unavailable, retrying on ${nextPort}.`);
+            currentPort = nextPort;
+        }
+    }
+    throw new Error("Relay CLI exhausted its local port fallback attempts.");
+}
+export function applyRelayCliOverrides(config, overrides) {
+    return {
+        ...config,
+        ...overrides,
+    };
+}
+export async function runRelayCli(args) {
+    let parsed;
+    try {
+        parsed = parseRelayCliArgs(args);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new RelayCliUserError(error.message);
+        }
+        throw error;
+    }
+    if (parsed.showHelp) {
+        console.log(renderRelayCliHelp());
+        return;
+    }
+    const config = applyRelayCliOverrides(loadRelayConfig(), parsed.configOverrides);
+    const allowPortFallback = shouldAllowRelayCliPortFallback(parsed);
+    let relayServer;
+    let tunnel;
+    let shuttingDown = false;
+    async function shutdown(signal) {
+        if (shuttingDown) {
+            return;
+        }
+        shuttingDown = true;
+        console.log(`[privateclaw-relay] received ${signal}, shutting down`);
+        await tunnel?.close();
+        await relayServer?.stop();
+        process.exit(0);
+    }
+    process.on("SIGINT", () => {
+        void shutdown("SIGINT");
+    });
+    process.on("SIGTERM", () => {
+        void shutdown("SIGTERM");
+    });
+    try {
+        const startedRelay = await startRelayServerWithPortFallback({
+            config,
+            allowPortFallback,
+            onLog: (line) => {
+                console.log(line);
+            },
+        });
+        relayServer = startedRelay.relayServer;
+        const { port, url } = startedRelay;
+        console.log(`[privateclaw-relay] listening on ${url}`);
+        if (!parsed.publicTunnel) {
+            return;
+        }
+        console.log(`[privateclaw-relay] exposing the relay to the internet through ${parsed.publicTunnel}.`);
+        try {
+            tunnel = await openRelayTunnel({
+                provider: parsed.publicTunnel,
+                localPort: port,
+                localUrl: `http://127.0.0.1:${port}`,
+                onLog: (line) => {
+                    console.log(line);
+                },
+            });
+        }
+        catch (error) {
+            if (parsed.publicTunnel &&
+                error instanceof MissingRelayTunnelBinaryError) {
+                await ensureRelayTunnelDependencyAvailable({
+                    provider: parsed.publicTunnel,
+                    missingDependency: error,
+                    onLog: (line) => {
+                        console.log(line);
+                    },
+                });
+                console.log(`[privateclaw-relay] retrying ${parsed.publicTunnel} setup after installing ${error.command}.`);
+                try {
+                    tunnel = await openRelayTunnel({
+                        provider: parsed.publicTunnel,
+                        localPort: port,
+                        localUrl: `http://127.0.0.1:${port}`,
+                        onLog: (line) => {
+                            console.log(line);
+                        },
+                    });
+                }
+                catch (retryError) {
+                    if (retryError instanceof MissingRelayTunnelBinaryError &&
+                        retryError.command === error.command) {
+                        throw new RelayCliUserError(`Installed \`${error.command}\`, but it is still unavailable in the current shell PATH. Open a new terminal and run \`privateclaw-relay --public ${parsed.publicTunnel}\` again.`);
+                    }
+                    throw retryError;
+                }
+            }
+            else {
+                throw error;
+            }
+        }
+        if (tunnel.publicUrl) {
+            console.log(`[privateclaw-relay] public URL: ${tunnel.publicUrl}`);
+        }
+        for (const note of tunnel.notes) {
+            console.log(`[privateclaw-relay] ${note}`);
+        }
+    }
+    catch (error) {
+        await tunnel?.close();
+        await relayServer?.stop();
+        throw error;
+    }
+}
+//# sourceMappingURL=relay-cli.js.map

package/dist/relay-cli.js.map

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

package/dist/relay-cluster.d.ts

@@ -0,0 +1,144 @@
+import type { EncryptedEnvelope } from "@privateclaw/protocol";
+export interface RelayClusterAppBinding {
+    sessionId: string;
+    appId: string;
+    groupMode: boolean;
+}
+export interface RelayClusterPresenceRefresh {
+    providerIds: string[];
+    appBindings: RelayClusterAppBinding[];
+}
+export interface RelayClusterCallbacks {
+    onRemoteAppFrame(sessionId: string, envelope: EncryptedEnvelope, targetAppId?: string): Promise<void> | void;
+    onRemoteProviderFrame(sessionId: string, envelope: EncryptedEnvelope): Promise<void> | void;
+    onRemoteSessionClosed(sessionId: string, reason: string): Promise<void> | void;
+    onRemoteAppClosed(sessionId: string, appId: string, reason: string): Promise<void> | void;
+    onRemoteAppReconnected(sessionId: string, appId: string): Promise<void> | void;
+    onRemoteProviderReconnected(providerId: string): Promise<void> | void;
+}
+export interface RelayClusterClient {
+    readonly persistent: boolean;
+    claimProvider(providerId: string): Promise<{
+        previousNodeId?: string;
+    }>;
+    releaseProvider(providerId: string): Promise<void>;
+    claimApp(binding: RelayClusterAppBinding): Promise<{
+        previousNodeId?: string;
+    }>;
+    releaseApp(binding: RelayClusterAppBinding): Promise<void>;
+    refreshPresence(params: RelayClusterPresenceRefresh): Promise<void>;
+    subscribeProvider(providerId: string, sessionId: string): Promise<void>;
+    unsubscribeProvider(providerId: string, sessionId: string): Promise<void>;
+    subscribeApp(sessionId: string, appId: string): Promise<void>;
+    unsubscribeApp(sessionId: string, appId: string): Promise<void>;
+    publishFrameToApp(sessionId: string, envelope: EncryptedEnvelope, targetAppId?: string): Promise<number>;
+    publishFrameToProvider(sessionId: string, envelope: EncryptedEnvelope): Promise<number>;
+    publishSessionClosed(sessionId: string, reason: string): Promise<void>;
+    publishAppClosed(sessionId: string, appId: string, reason: string): Promise<void>;
+    publishAppReconnected(sessionId: string, appId: string, targetNodeId: string): Promise<void>;
+    publishProviderReconnected(providerId: string, targetNodeId: string): Promise<void>;
+    hasProviderSessionSubscriber(sessionId: string): Promise<boolean>;
+    hasAppBinding(sessionId: string, appId: string): Promise<boolean>;
+    close(): Promise<void>;
+}
+export declare class RelayClaimConflictError extends Error {
+    constructor(message: string);
+}
+declare abstract class BaseRelayClusterClient implements RelayClusterClient {
+    protected readonly nodeId: string;
+    protected readonly callbacks: RelayClusterCallbacks;
+    readonly persistent = true;
+    private readonly channelRefs;
+    protected constructor(nodeId: string, callbacks: RelayClusterCallbacks);
+    subscribeProvider(providerId: string, sessionId: string): Promise<void>;
+    unsubscribeProvider(providerId: string, sessionId: string): Promise<void>;
+    subscribeApp(sessionId: string, appId: string): Promise<void>;
+    unsubscribeApp(sessionId: string, appId: string): Promise<void>;
+    publishFrameToApp(sessionId: string, envelope: EncryptedEnvelope, targetAppId?: string): Promise<number>;
+    publishFrameToProvider(sessionId: string, envelope: EncryptedEnvelope): Promise<number>;
+    publishSessionClosed(sessionId: string, reason: string): Promise<void>;
+    publishAppClosed(sessionId: string, appId: string, reason: string): Promise<void>;
+    publishAppReconnected(sessionId: string, appId: string, targetNodeId: string): Promise<void>;
+    publishProviderReconnected(providerId: string, targetNodeId: string): Promise<void>;
+    protected handleChannelMessage(channel: string, payload: string): Promise<void>;
+    private retainChannel;
+    private releaseChannel;
+    protected abstract subscribeChannel(channel: string): Promise<void>;
+    protected abstract unsubscribeChannel(channel: string): Promise<void>;
+    protected abstract publish(channel: string, payload: string): Promise<number>;
+    abstract hasProviderSessionSubscriber(sessionId: string): Promise<boolean>;
+    abstract hasAppBinding(sessionId: string, appId: string): Promise<boolean>;
+    abstract claimProvider(providerId: string): Promise<{
+        previousNodeId?: string;
+    }>;
+    abstract releaseProvider(providerId: string): Promise<void>;
+    abstract claimApp(binding: RelayClusterAppBinding): Promise<{
+        previousNodeId?: string;
+    }>;
+    abstract releaseApp(binding: RelayClusterAppBinding): Promise<void>;
+    abstract refreshPresence(params: RelayClusterPresenceRefresh): Promise<void>;
+    abstract close(): Promise<void>;
+}
+interface InMemoryRelayClusterSharedState {
+    channelSubscribers: Map<string, Set<InMemoryRelayClusterClient>>;
+    providerPresence: Map<string, string>;
+    appPresence: Map<string, string>;
+    singleSessionOccupants: Map<string, string>;
+}
+export declare function createInMemoryRelayClusterSharedState(): InMemoryRelayClusterSharedState;
+export declare class InMemoryRelayClusterClient extends BaseRelayClusterClient {
+    private readonly shared;
+    constructor(shared: InMemoryRelayClusterSharedState, params: {
+        nodeId: string;
+        callbacks: RelayClusterCallbacks;
+    });
+    claimProvider(providerId: string): Promise<{
+        previousNodeId?: string;
+    }>;
+    releaseProvider(providerId: string): Promise<void>;
+    claimApp(binding: RelayClusterAppBinding): Promise<{
+        previousNodeId?: string;
+    }>;
+    releaseApp(binding: RelayClusterAppBinding): Promise<void>;
+    refreshPresence(params: RelayClusterPresenceRefresh): Promise<void>;
+    protected subscribeChannel(channel: string): Promise<void>;
+    protected unsubscribeChannel(channel: string): Promise<void>;
+    protected publish(channel: string, payload: string): Promise<number>;
+    close(): Promise<void>;
+    hasAppBinding(sessionId: string, appId: string): Promise<boolean>;
+    hasProviderSessionSubscriber(sessionId: string): Promise<boolean>;
+}
+export declare class RedisRelayClusterClient extends BaseRelayClusterClient {
+    private readonly redis;
+    private readonly subscriber;
+    constructor(redisUrl: string, params: {
+        nodeId: string;
+        callbacks: RelayClusterCallbacks;
+    });
+    claimProvider(providerId: string): Promise<{
+        previousNodeId?: string;
+    }>;
+    releaseProvider(providerId: string): Promise<void>;
+    claimApp(binding: RelayClusterAppBinding): Promise<{
+        previousNodeId?: string;
+    }>;
+    releaseApp(binding: RelayClusterAppBinding): Promise<void>;
+    refreshPresence(params: RelayClusterPresenceRefresh): Promise<void>;
+    protected subscribeChannel(channel: string): Promise<void>;
+    protected unsubscribeChannel(channel: string): Promise<void>;
+    protected publish(channel: string, payload: string): Promise<number>;
+    close(): Promise<void>;
+    hasAppBinding(sessionId: string, appId: string): Promise<boolean>;
+    hasProviderSessionSubscriber(sessionId: string): Promise<boolean>;
+}
+export declare function createRedisRelayClusterClient(params: {
+    redisUrl: string;
+    nodeId: string;
+    callbacks: RelayClusterCallbacks;
+}): RelayClusterClient;
+export declare function createInMemoryRelayClusterClient(params: {
+    shared: InMemoryRelayClusterSharedState;
+    nodeId: string;
+    callbacks: RelayClusterCallbacks;
+}): RelayClusterClient;
+export {};