@meshline/sdk 0.0.0-stage → 0.1.0-alpha.1

package/dist/transport/client.js

@@ -0,0 +1,392 @@
+import { createAbortController } from '../runtime/abort.js';
+import { systemRandom } from '../crypto/primitives.js';
+import { ProtocolError } from '../errors.js';
+import { abortScope, awaitWithSignal, systemClock, throwIfAborted } from '../runtime/clock.js';
+import { EventHub } from '../runtime/events.js';
+import { RelayDiscovery } from './discovery.js';
+import { HttpRelayTransport, RelayBackoff } from './http.js';
+import { RelayError } from './relay-error.js';
+import { HttpRelaySessions, RelayAuthenticator } from './session.js';
+import { RpcConnection } from './socket.js';
+import { RelaySubscription } from './subscription.js';
+function readiness() {
+    let settled = false;
+    let resolve, reject;
+    const promise = new Promise((yes, no) => { resolve = yes; reject = no; });
+    // A notification-only client may have no readiness waiter; retain errors for later callers.
+    promise.then(() => undefined, () => undefined);
+    return { promise, get settled() { return settled; }, resolve(slot) { settled = true; resolve(slot); }, reject(error) { settled = true; reject(error); } };
+}
+function retryable(error) {
+    if (error instanceof RelayError)
+        return ['unauthorized', 'temporarily_unavailable', 'bad_gateway', 'rate_limited'].includes(error.code);
+    if (error instanceof ProtocolError)
+        return ['socket_closed', 'socket_error', 'notification_overflow'].includes(error.code);
+    if (error instanceof Error && error.name === 'TimeoutError')
+        return true;
+    // Fetch uses TypeError for connection failure; Node HTTPS preserves its system error code.
+    return error instanceof TypeError || error instanceof Error && 'code' in error
+        && ['ECONNRESET', 'ECONNREFUSED', 'ENOTFOUND', 'EAI_AGAIN', 'ETIMEDOUT', 'EPIPE'].includes(String(error.code));
+}
+/** Pool-owned transport for one relay and one immutable session identity. No constructor I/O. */
+export class RelayClient {
+    relayId;
+    #events = new EventHub();
+    #lifetime = createAbortController();
+    #clock;
+    #random;
+    #options;
+    #http;
+    #discovery;
+    #sessions;
+    #authenticator;
+    #backoff;
+    #httpSession;
+    #socket;
+    #opening;
+    #notifications;
+    #ready = readiness();
+    #generation = 0;
+    #connection = 'disconnected';
+    #authenticating = false;
+    #authenticationRejected = false;
+    #lastError;
+    #terminal;
+    #disposal;
+    #subscriptions = new Map();
+    constructor(relayId, registry, options = {}, authenticator) {
+        this.relayId = relayId;
+        this.#options = { ...options };
+        this.#clock = options.clock ?? systemClock;
+        this.#random = options.random ?? systemRandom;
+        this.#backoff = new RelayBackoff(this.#clock);
+        this.#http = new HttpRelayTransport({ ...options, backoff: this.#backoff });
+        this.#discovery = new RelayDiscovery(relayId, registry, this.#http, this.#clock);
+        if (authenticator && (authenticator.relayId !== relayId || authenticator.context.toString() !== registry.context.toString()))
+            throw new ProtocolError('invalid_identity', 'Authenticator does not match this relay and network.');
+        this.#authenticator = authenticator;
+        if (authenticator)
+            this.#sessions = new HttpRelaySessions(authenticator, this.#http);
+    }
+    get sessionMode() { return this.#authenticator?.mode; }
+    get isDisposed() { return this.#lifetime.signal.aborted; }
+    #hasValidSession() { return (this.#httpSession?.remainingSeconds ?? 0) > 0 || this.#socket !== undefined && !this.#socket.connection.failure && this.#socket.session.remainingSeconds > 0; }
+    get state() {
+        const valid = this.#hasValidSession();
+        return Object.freeze({ connection: this.#connection,
+            authentication: this.isDisposed ? 'none' : this.#authenticationRejected ? 'rejected' : valid ? this.sessionMode : this.#authenticating ? 'authenticating' : this.#httpSession || this.#socket ? 'expired' : 'none',
+            sessionMode: this.sessionMode, lastError: this.#lastError });
+    }
+    on(event, listener) { return this.#events.on(event, listener); }
+    #check(signal) { throwIfAborted(signal); throwIfAborted(this.#lifetime.signal); if (this.#terminal !== undefined)
+        throw this.#terminal; }
+    #notify(event, value) {
+        this.#events.notify(event, value, error => this.#publishError(this.#lastError === undefined ? error
+            : new AggregateError([this.#lastError, error], 'Relay operation and observer failed.')));
+    }
+    #stateChanged() { this.#notify('stateChanged', this.state); }
+    #publishError(error) {
+        this.#lastError = error;
+        // Do not publish another state event for observer failures: a failing state
+        // subscriber must not recursively trigger itself through error reporting.
+        this.#events.notify('errorOccurred', error, observerError => {
+            this.#lastError = new AggregateError([error, observerError], 'Relay operation and error observer failed.');
+        });
+    }
+    #report(error) {
+        if (error instanceof RelayError && ['unauthorized', 'device_unknown', 'invalid_signature'].includes(error.code))
+            this.#authenticationRejected = true;
+        this.#publishError(error);
+        this.#stateChanged();
+    }
+    #acceptHttpSession(session) {
+        // A public response or a cached token is not evidence that a rejected
+        // identity has authenticated again. Only a newly issued session clears it.
+        if (session !== this.#httpSession)
+            this.#authenticationRejected = false;
+        this.#httpSession = session;
+    }
+    getDescriptor(signal) { this.#check(signal); return this.#discovery.getDescriptor(signal); }
+    getInfo(signal) { this.#check(signal); return this.#discovery.getInfo(signal); }
+    async authenticate(signal) {
+        this.#check(signal);
+        if (!this.#sessions)
+            throw new ProtocolError('authentication_required', 'This relay client has no authentication identity.');
+        if (!this.#hasValidSession())
+            this.#authenticationRejected = false;
+        this.#authenticating = true;
+        this.#connection = 'connecting';
+        try {
+            this.#stateChanged();
+            const descriptor = await this.getDescriptor(signal);
+            this.#acceptHttpSession(await this.#sessions.get(descriptor.endpoints.find(value => value.startsWith('https://')), signal));
+            this.#check(signal);
+            this.#connection = 'connected';
+            this.#lastError = undefined;
+        }
+        catch (error) {
+            if (!signal?.aborted && !this.isDisposed)
+                this.#report(error);
+            throw error;
+        }
+        finally {
+            this.#authenticating = false;
+            this.#stateChanged();
+        }
+    }
+    async requestHttp(method, name, parameters, options = {}) {
+        this.#check(options.signal);
+        const scope = abortScope([options.signal, this.#lifetime.signal]);
+        let session;
+        try {
+            const descriptor = await this.getDescriptor(scope.signal);
+            const endpoint = descriptor.endpoints.find(value => value.startsWith('https://'));
+            if (options.authenticated !== false) {
+                if (!this.#sessions)
+                    throw new ProtocolError('authentication_required', 'Establish a relay session before an authenticated request.');
+                session = await this.#sessions.get(endpoint, scope.signal);
+                this.#acceptHttpSession(session);
+            }
+            const result = await this.#http.request(endpoint, method, name, parameters, session?.getToken(endpoint), scope.signal);
+            this.#connection = 'connected';
+            this.#lastError = undefined;
+            this.#stateChanged();
+            return result;
+        }
+        catch (error) {
+            if (error instanceof RelayError && error.code === 'unauthorized' && session) {
+                this.#sessions.invalidate(session);
+                if (this.#httpSession === session)
+                    this.#httpSession = undefined;
+            }
+            if (!scope.signal.aborted)
+                this.#report(error);
+            throw error;
+        }
+        finally {
+            scope.dispose();
+        }
+    }
+    async #getSocket(signal) {
+        this.#check(signal);
+        if (!this.#authenticator)
+            throw new ProtocolError('authentication_required', 'WebSocket connections require an authentication identity.');
+        if (!this.#opening) {
+            const opening = this.#openSocket();
+            this.#opening = opening;
+            opening.then(() => { if (this.#opening === opening)
+                this.#opening = undefined; }, () => { if (this.#opening === opening)
+                this.#opening = undefined; });
+        }
+        return awaitWithSignal(this.#opening, signal);
+    }
+    async #openSocket() {
+        const descriptor = await this.getDescriptor(this.#lifetime.signal);
+        const endpoint = descriptor.endpoints.find(value => value.startsWith('wss://'));
+        if (!endpoint)
+            throw new ProtocolError('socket_unavailable', 'The relay does not advertise WebSocket support.');
+        const existing = this.#socket;
+        if (existing && existing.connection.endpoint === endpoint && !existing.connection.failure && existing.session.remainingSeconds > 0)
+            return existing;
+        if (existing) {
+            existing.controller.abort();
+            existing.connection.dispose();
+            await existing.renewal;
+            this.#socket = undefined;
+        }
+        const connection = new RpcConnection(endpoint, { ...this.#options, clock: this.#clock, random: this.#random, backoff: this.#backoff });
+        const timeout = abortScope([this.#lifetime.signal], this.#options.requestTimeoutMilliseconds ?? 60000);
+        this.#connection = 'connecting';
+        this.#stateChanged();
+        try {
+            const session = await this.#authenticator.authenticate(endpoint, (name, params, signal) => connection.request(name, params, signal), timeout.signal);
+            this.#check(timeout.signal);
+            const slot = { connection, session, controller: createAbortController(), renewal: Promise.resolve(), generation: ++this.#generation };
+            this.#socket = slot;
+            this.#authenticationRejected = false;
+            slot.renewal = this.#renew(slot);
+            this.#connection = 'connected';
+            this.#lastError = undefined;
+            this.#stateChanged();
+            return slot;
+        }
+        catch (error) {
+            connection.dispose();
+            if (this.#socket?.connection === connection) {
+                const failed = this.#socket;
+                this.#socket = undefined;
+                failed.controller.abort(error);
+                await failed.renewal;
+            }
+            throw error;
+        }
+        finally {
+            timeout.dispose();
+        }
+    }
+    async #renew(slot) {
+        const scope = abortScope([this.#lifetime.signal, slot.controller.signal]);
+        try {
+            while (!scope.signal.aborted) {
+                const previous = slot.session;
+                const remaining = previous.remainingSeconds;
+                if (remaining <= 0)
+                    throw new ProtocolError('expired_session', 'The WebSocket session expired.');
+                const due = this.#clock.monotonicMilliseconds() + Math.max(remaining * 0.8, remaining - 30) * 1000;
+                while (due > this.#clock.monotonicMilliseconds())
+                    await this.#clock.delay(Math.min(60000, due - this.#clock.monotonicMilliseconds()), scope.signal);
+                const deadline = abortScope([scope.signal], Math.max(1, Math.min(60000, Math.floor(previous.remainingSeconds * 1000))));
+                try {
+                    const renewed = await this.#authenticator.authenticate(slot.connection.endpoint, (name, params, signal) => slot.connection.request(name, params, signal), deadline.signal);
+                    if (previous.remainingSeconds <= 0)
+                        throw new ProtocolError('expired_session', 'Previous socket session expired before renewal completed.');
+                    slot.session = renewed;
+                    this.#authenticationRejected = false;
+                    this.#stateChanged();
+                }
+                catch (error) {
+                    if (error instanceof RelayError && error.code !== 'unauthorized' && previous.remainingSeconds > 0) {
+                        this.#report(error);
+                        // A rejected renewal other than unauthorized leaves the
+                        // already accepted socket session usable until expiry.
+                        this.#authenticationRejected = false;
+                        this.#stateChanged();
+                        await this.#clock.delay(Math.min(5000, previous.remainingSeconds * 1000), scope.signal);
+                    }
+                    else
+                        throw error;
+                }
+                finally {
+                    deadline.dispose();
+                }
+            }
+        }
+        catch (error) {
+            if (!scope.signal.aborted) {
+                this.#report(error);
+                slot.connection.fail(error);
+            }
+        }
+        finally {
+            scope.dispose();
+        }
+    }
+    /** Device notification reconnection restores transport only; callers synchronize after socketConnected. */
+    startNotifications() {
+        this.#check();
+        if (this.sessionMode !== 'device')
+            throw new ProtocolError('device_session_required', 'Notifications require a device session.');
+        this.#notifications ??= this.#dispatchNotifications();
+    }
+    async #dispatchNotifications() {
+        let failures = 0;
+        try {
+            while (!this.isDisposed) {
+                try {
+                    const slot = await this.#getSocket(this.#lifetime.signal);
+                    this.#ready.resolve(slot);
+                    this.#notify('socketConnected', { generation: slot.generation });
+                    failures = 0;
+                    for (;;) {
+                        const notification = await slot.connection.nextNotification(this.#lifetime.signal);
+                        if (slot.session.remainingSeconds <= 0)
+                            throw new ProtocolError('expired_session', 'A notification arrived after socket session expiry.');
+                        this.#notify('notificationReceived', notification);
+                    }
+                }
+                catch (error) {
+                    if (this.isDisposed)
+                        break;
+                    this.#connection = 'disconnected';
+                    if (this.#ready.settled)
+                        this.#ready = readiness();
+                    this.#report(error);
+                    if (!retryable(error)) {
+                        this.#terminal = error;
+                        this.#ready.reject(error);
+                        this.#socket?.controller.abort(error);
+                        this.#socket?.connection.fail(error);
+                        this.#notify('faulted', error);
+                        return;
+                    }
+                    const jitter = this.#random.bytes(2);
+                    const fraction = ((jitter[0] << 8) | jitter[1]) / 65536;
+                    await this.#clock.delay((Math.min(30, 2 ** Math.min(failures++, 5)) + fraction) * 1000, this.#lifetime.signal);
+                }
+            }
+        }
+        catch (error) {
+            if (!this.isDisposed) {
+                this.#terminal = error;
+                this.#ready.reject(error);
+                this.#report(error);
+            }
+        }
+    }
+    async requestWebSocket(method, parameters, signal) {
+        this.#check(signal);
+        const deadline = abortScope([signal, this.#lifetime.signal], this.#options.requestTimeoutMilliseconds ?? 60000);
+        try {
+            let slot;
+            if (this.sessionMode === 'device') {
+                this.startNotifications();
+                slot = await awaitWithSignal(this.#ready.promise, deadline.signal);
+            }
+            else
+                slot = await this.#getSocket(deadline.signal);
+            const result = await slot.connection.request(method, parameters, deadline.signal);
+            this.#connection = 'connected';
+            this.#lastError = undefined;
+            this.#stateChanged();
+            return result;
+        }
+        catch (error) {
+            if (!deadline.signal.aborted)
+                this.#report(error);
+            throw error;
+        }
+        finally {
+            deadline.dispose();
+        }
+    }
+    /** Owns the complete replacement stream for this method; dispose it after stopping its update producers. */
+    createSubscription(method, empty, options = {}) {
+        this.#check(options.signal);
+        if (this.sessionMode !== 'device')
+            throw new ProtocolError('device_session_required', 'Subscriptions require a device session.');
+        if (method !== 'channel.subscribe' && method !== 'group.subscribe')
+            throw new TypeError('Unknown subscription method.');
+        if (this.#subscriptions.has(method))
+            throw new ProtocolError('subscription_in_use', 'This client already has an owner for the subscription method.');
+        const subscription = new RelaySubscription(method, empty, { ...options }, {
+            clock: this.#clock, lifetime: this.#lifetime.signal, onConnected: listener => this.on('socketConnected', listener),
+            ready: async (signal) => {
+                this.startNotifications();
+                const slot = await awaitWithSignal(this.#ready.promise, signal);
+                return { generation: slot.generation, get failure() { return slot.connection.failure; },
+                    request: (name, params, token) => slot.connection.request(name, params, token), retire: error => slot.connection.fail(error) };
+            },
+            closed: () => { if (this.#subscriptions.get(method) === subscription)
+                this.#subscriptions.delete(method); },
+        });
+        this.#subscriptions.set(method, subscription);
+        return subscription;
+    }
+    dispose() {
+        return this.#disposal ??= (async () => {
+            const reason = new DOMException('Relay client was disposed.', 'AbortError');
+            this.#lifetime.abort(reason);
+            this.#ready.reject(reason);
+            this.#sessions?.dispose();
+            this.#discovery.dispose();
+            this.#http.dispose();
+            this.#socket?.controller.abort(reason);
+            this.#socket?.connection.dispose();
+            await Promise.allSettled([this.#opening, this.#notifications, this.#socket?.renewal, ...[...this.#subscriptions.values()].map(value => value.dispose())]);
+            this.#connection = 'disconnected';
+            this.#stateChanged();
+            this.#events.clear();
+        })();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/transport/client.js.map

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

package/dist/transport/discovery.d.ts

@@ -0,0 +1,19 @@
+import type { RelayRegistry } from '../interactions.js';
+import { type RelayDescriptor, type RelayInfo } from '../models/relay.js';
+import { NetworkContext } from '../protocol/context.js';
+import { type RuntimeClock } from '../runtime/clock.js';
+import type { HttpRelayTransport } from './http.js';
+/** Resolves one trusted relay identity; descriptors, never old URLs, authorize endpoint selection. */
+export declare class RelayDiscovery {
+    #private;
+    readonly relayId: string;
+    readonly registry: RelayRegistry;
+    readonly transport: HttpRelayTransport;
+    readonly clock: RuntimeClock;
+    constructor(relayId: string, registry: RelayRegistry, transport: HttpRelayTransport, clock?: RuntimeClock);
+    get context(): NetworkContext;
+    getDescriptor(signal?: AbortSignal): Promise<RelayDescriptor>;
+    getInfo(signal?: AbortSignal): Promise<RelayInfo>;
+    dispose(): void;
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/transport/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/transport/discovery.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAoF,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5J,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAgD,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEtG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD,sGAAsG;AACtG,qBAAa,cAAc;;IAKX,QAAQ,CAAC,OAAO,EAAE,MAAM;IAAE,QAAQ,CAAC,QAAQ,EAAE,aAAa;IAAE,QAAQ,CAAC,SAAS,EAAE,kBAAkB;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY;IAA5I,YAAqB,OAAO,EAAE,MAAM,EAAW,QAAQ,EAAE,aAAa,EAAW,SAAS,EAAE,kBAAkB,EAAW,KAAK,GAAE,YAA0B,EAGzJ;IACD,IAAI,OAAO,IAAI,cAAc,CAA0B;IAEjD,aAAa,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAWlE;IAkBK,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAQtD;IAGD,OAAO,IAAI,IAAI,CAAqH;CACvI"}

package/dist/transport/discovery.js

@@ -0,0 +1,75 @@
+import { createAbortController } from '../runtime/abort.js';
+import { ProtocolError } from '../errors.js';
+import { validateRelayId } from '../identity/neo.js';
+import { relayDescriptorCodec, relayInfoCodec, validateRelayDescriptor, validateRelayInfo } from '../models/relay.js';
+import { NetworkContext } from '../protocol/context.js';
+import { awaitWithSignal, systemClock, throwIfAborted } from '../runtime/clock.js';
+import { webEndpoint } from './endpoint.js';
+/** Resolves one trusted relay identity; descriptors, never old URLs, authorize endpoint selection. */
+export class RelayDiscovery {
+    relayId;
+    registry;
+    transport;
+    clock;
+    #lifetime = createAbortController();
+    #context;
+    #cached;
+    #pending;
+    constructor(relayId, registry, transport, clock = systemClock) {
+        this.relayId = relayId;
+        this.registry = registry;
+        this.transport = transport;
+        this.clock = clock;
+        validateRelayId(relayId);
+        this.#context = NetworkContext.parse(registry.context.toString());
+    }
+    get context() { return this.#context; }
+    async getDescriptor(signal) {
+        throwIfAborted(signal);
+        throwIfAborted(this.#lifetime.signal);
+        if (this.registry.context.toString() !== this.#context.toString())
+            throw new ProtocolError('context_changed', 'The relay registry network context has changed.');
+        if (this.#cached && this.#cached.expiresAt > this.clock.nowSeconds())
+            return this.#copy(this.#cached);
+        if (!this.#pending) {
+            const pending = this.#discover();
+            this.#pending = pending;
+            pending.then(value => { this.#cached = value; if (this.#pending === pending)
+                this.#pending = undefined; }, () => { if (this.#pending === pending)
+                this.#pending = undefined; });
+        }
+        return this.#copy(await awaitWithSignal(this.#pending, signal));
+    }
+    async #discover() {
+        const signal = this.#lifetime.signal;
+        const entry = await this.registry.getRelay(this.relayId, signal);
+        throwIfAborted(signal);
+        if (this.registry.context.toString() !== this.#context.toString())
+            throw new ProtocolError('context_changed', 'The registry network context changed during discovery.');
+        if (!entry || entry.relayId !== this.relayId || entry.status !== 'active')
+            throw new ProtocolError('inactive_relay', 'The registry does not identify an active relay with the requested ID.');
+        webEndpoint(entry.endpoint, 'https:');
+        const wire = await this.transport.request(entry.endpoint, 'GET', 'relay.descriptor', undefined, undefined, signal);
+        if (wire === undefined)
+            throw new ProtocolError('missing_result', 'Relay discovery returned no descriptor.');
+        const descriptor = relayDescriptorCodec.decode(wire);
+        validateRelayDescriptor(descriptor, this.#context, this.clock.nowSeconds());
+        if (descriptor.relayId !== this.relayId)
+            throw new ProtocolError('invalid_identity', 'The descriptor does not identify the registered relay.');
+        throwIfAborted(signal);
+        return descriptor;
+    }
+    async getInfo(signal) {
+        const descriptor = await this.getDescriptor(signal);
+        const endpoint = descriptor.endpoints.find(endpoint => endpoint.startsWith('https://'));
+        const wire = await this.transport.request(endpoint, 'GET', 'relay.info', undefined, undefined, signal);
+        if (wire === undefined)
+            throw new ProtocolError('missing_result', 'Relay info returned no result.');
+        const info = relayInfoCodec.decode(wire);
+        validateRelayInfo(info, descriptor);
+        return info;
+    }
+    #copy(value) { return relayDescriptorCodec.decode(relayDescriptorCodec.encode(value)); }
+    dispose() { this.#cached = undefined; this.#lifetime.abort(new DOMException('Relay discovery was disposed.', 'AbortError')); }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/transport/discovery.js.map

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

package/dist/transport/endpoint.d.ts

@@ -0,0 +1,6 @@
+/** Validates before URL parsing so a parser cannot silently repair unsafe input. */
+export declare function webEndpoint(endpoint: string, protocol?: 'https:' | 'wss:'): URL;
+/** Authentication maps WSS to HTTPS and excludes the endpoint path. */
+export declare function relayOrigin(endpoint: string): string;
+export declare function validateMethodName(name: string): void;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/transport/endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.d.ts","sourceRoot":"","sources":["../../src/transport/endpoint.ts"],"names":[],"mappings":"AAIA,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,GAAG,CAe/E;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGrD"}

package/dist/transport/endpoint.js

@@ -0,0 +1,35 @@
+import { ProtocolError } from '../errors.js';
+import { encodeUtf8 } from '../protocol/encoding.js';
+import { parseAbsoluteUrl } from '../runtime/url.js';
+/** Validates before URL parsing so a parser cannot silently repair unsafe input. */
+export function webEndpoint(endpoint, protocol) {
+    if (typeof endpoint !== 'string' || !/^(https|wss):\/\//.test(endpoint) || encodeUtf8(endpoint).length > 512
+        || /[\s\p{Cc}?#\\]/u.test(endpoint))
+        throw new ProtocolError('invalid_endpoint', 'Expected an HTTPS or WSS relay endpoint without whitespace, query, fragment or backslash.');
+    const authority = endpoint.slice(endpoint.indexOf('://') + 3).split('/')[0];
+    if (authority.length === 0 || authority.includes('@') || authority.includes('%'))
+        throw new ProtocolError('invalid_endpoint', 'Relay endpoints must have a host and cannot contain user information or an escaped authority.');
+    // URL accepts malformed percent escapes in paths; the protocol does not.
+    if (/%(?![0-9a-fA-F]{2})/.test(endpoint))
+        throw new ProtocolError('invalid_endpoint', 'Malformed endpoint escape.');
+    let url;
+    try {
+        url = parseAbsoluteUrl(endpoint);
+    }
+    catch (cause) {
+        throw new ProtocolError('invalid_endpoint', 'Invalid relay endpoint.', { cause });
+    }
+    if (!url.hostname || (protocol !== undefined && url.protocol !== protocol))
+        throw new ProtocolError('invalid_endpoint', 'Unexpected relay endpoint protocol or host.');
+    return url;
+}
+/** Authentication maps WSS to HTTPS and excludes the endpoint path. */
+export function relayOrigin(endpoint) {
+    const url = webEndpoint(endpoint);
+    return `https://${url.hostname.toLowerCase()}${url.port === '' || url.port === '443' ? '' : `:${url.port}`}`;
+}
+export function validateMethodName(name) {
+    if (!/^[a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*$/.test(name) || /\s/.test(name))
+        throw new ProtocolError('invalid_method', 'Invalid relay method name.');
+}
+//# sourceMappingURL=endpoint.js.map

package/dist/transport/endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint.js","sourceRoot":"","sources":["../../src/transport/endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,QAA4B;IACtE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,GAAG;WACrG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC;QACnC,MAAM,IAAI,aAAa,CAAC,kBAAkB,EAAE,2FAA2F,CAAC,CAAC;IAC7I,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IAC7E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC5E,MAAM,IAAI,aAAa,CAAC,kBAAkB,EAAE,+FAA+F,CAAC,CAAC;IACjJ,yEAAyE;IACzE,IAAI,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,aAAa,CAAC,kBAAkB,EAAE,4BAA4B,CAAC,CAAC;IACpH,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QAAC,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAAC,CAAC;IACzC,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,IAAI,aAAa,CAAC,kBAAkB,EAAE,yBAAyB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAAC,CAAC;IACpG,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;QACtE,MAAM,IAAI,aAAa,CAAC,kBAAkB,EAAE,6CAA6C,CAAC,CAAC;IAC/F,OAAO,GAAG,CAAC;AACf,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,QAAgB;IACxC,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,WAAW,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,IAAI,KAAK,EAAE,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC3C,IAAI,CAAC,yCAAyC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACxE,MAAM,IAAI,aAAa,CAAC,gBAAgB,EAAE,4BAA4B,CAAC,CAAC;AAChF,CAAC"}

package/dist/transport/http.d.ts

@@ -0,0 +1,52 @@
+import { type JsonObject, type JsonValue } from '../protocol/json.js';
+import { type RuntimeClock } from '../runtime/clock.js';
+import { type RelayFailure } from './relay-error.js';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface RelayFetchInit {
+    readonly method: HttpMethod;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body?: string;
+    readonly signal: AbortSignal;
+    readonly redirect: 'error';
+    readonly credentials: 'omit';
+    readonly cache: 'no-store';
+    readonly referrerPolicy: 'no-referrer';
+}
+export interface RelayFetchResponse {
+    readonly status: number;
+    readonly redirected?: boolean;
+    readonly type?: string;
+    readonly headers: {
+        get(name: string): string | null;
+    };
+    readonly body?: {
+        cancel(): Promise<void>;
+    } | null;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+/** An injected fetch must honor redirect:error and credentials:omit and must never replay a business request. */
+export type RelayFetch = (url: string, init: RelayFetchInit) => Promise<RelayFetchResponse>;
+/** Share between HTTP and WebSocket for one relay. A rejected request is never automatically retried. */
+export declare class RelayBackoff {
+    #private;
+    readonly clock: RuntimeClock;
+    constructor(clock?: RuntimeClock);
+    apply(failure: RelayFailure): void;
+    wait(signal?: AbortSignal): Promise<void>;
+}
+/** Strict media-type parsing avoids accepting a second hidden non-UTF8 charset. */
+export declare function validateJsonContentType(value: string | null): void;
+export interface HttpRelayTransportOptions {
+    readonly fetch?: RelayFetch;
+    readonly backoff?: RelayBackoff;
+    readonly requestTimeoutMilliseconds?: number;
+}
+export declare class HttpRelayTransport {
+    #private;
+    readonly backoff: RelayBackoff;
+    constructor(options?: HttpRelayTransportOptions);
+    request(endpoint: string, method: HttpMethod, name: string, parameters?: JsonObject, token?: string, signal?: AbortSignal): Promise<JsonValue | undefined>;
+    /** Cancels active requests and makes later requests fail. */
+    dispose(): void;
+}
+//# sourceMappingURL=http.d.ts.map