@genex-ai/multiplayer 0.17.1 → 0.17.8

package/dist/authority/fast-webtransport.d.ts

@@ -0,0 +1,67 @@
+import { F as FastSocketOpener, a as FastFallbackReason, b as FastBindMessage } from '../fast-client--A88q0kk.js';
+import '../module-CSpXrzFc.js';
+import '../shot-world-D22tqOUT.js';
+
+/** Hex digits of one certificate hash (SHA-256). */
+declare const FAST_WT_HASH_HEX_DIGITS = 64;
+/** Hashes one binding may carry (the relay sends its current and next certificate's). */
+declare const FAST_WT_HASHES_MAX = 4;
+/** A `wt` binding this client can open: its url and the certificate hashes as bytes. */
+interface FastWebTransportTarget {
+    url: string;
+    hashes: Uint8Array[];
+}
+/** The WebTransport `wt` of a binding this client can use, else null: an `https://` url with a host and
+ *  no credentials, query or fragment, and 1..{@link FAST_WT_HASHES_MAX} hashes of
+ *  {@link FAST_WT_HASH_HEX_DIGITS} lowercase hex digits. The binding is server-supplied, so anything
+ *  else is refused. */
+declare function fastWebTransportOf(bind: Pick<FastBindMessage, 'wt'>): FastWebTransportTarget | null;
+/** The part of the browser's `WebTransport` the opener uses. */
+interface WebTransportLike {
+    readonly ready: Promise<unknown>;
+    readonly closed: Promise<unknown>;
+    /** `pending`, `reliable-only` or `supports-unreliable` where the browser exposes it. */
+    readonly reliability?: string;
+    readonly datagrams: {
+        readonly readable: ReadableStream<Uint8Array>;
+        /** Chromium's way to send; Safari 26 has only `createWritable()`. */
+        readonly writable?: WritableStream<Uint8Array>;
+        createWritable?(): WritableStream<Uint8Array>;
+        readonly maxDatagramSize?: number;
+    };
+    close(info?: {
+        closeCode?: number;
+        reason?: string;
+    }): void;
+}
+/** `new WebTransport(url, options)`. */
+type WebTransportConstructor = new (url: string, options: Record<string, unknown>) => WebTransportLike;
+/** The options a fast@1 session opens with. */
+declare function webTransportOptions(target: FastWebTransportTarget): Record<string, unknown>;
+/** A {@link FastSocketOpener} on `WebTransport` (the browser's, or a stand-in in tests): null when the
+ *  binding has no usable `wt` or there is no WebTransport. */
+declare function webTransportFastOpener(WebTransport: WebTransportConstructor | undefined): FastSocketOpener;
+/** The part of a global scope {@link chooseFastSocket} reads. */
+interface FastSocketScope {
+    WebTransport?: unknown;
+    /** A page has one; */
+    document?: unknown;
+    /** a worker has this. Neither: not a browser (Node). */
+    importScripts?: unknown;
+}
+/** The browser's opener: the global `WebTransport` (null where there is none, so the seat stays on the
+ *  WebSocket). */
+declare const openWebTransportFastSocket: FastSocketOpener;
+/** How a seat opens its fast channel, and why it never asks when it does not. */
+interface FastSocketChoice {
+    open: FastSocketOpener | undefined;
+    /** The reason `s.fast` reads from the start. */
+    fallback: FastFallbackReason | null;
+}
+/** The socket for `connectAuthority`'s `fast`: the game's own opener, none when the game said `false`;
+ *  with no word from the game, WebTransport wherever `scope` has it. A browser without it never asks
+ *  (a seat that asks and then cannot open the binding loses the WebSocket inputs it sent before the
+ *  binding, PROTOCOL.md §17.12 *Fallback*), and says so. Node, with neither, is a plain WebSocket seat. */
+declare function chooseFastSocket(given: FastSocketOpener | false | undefined, scope?: FastSocketScope): FastSocketChoice;
+
+export { FAST_WT_HASHES_MAX, FAST_WT_HASH_HEX_DIGITS, type FastSocketChoice, type FastSocketScope, type FastWebTransportTarget, type WebTransportConstructor, type WebTransportLike, chooseFastSocket, fastWebTransportOf, openWebTransportFastSocket, webTransportFastOpener, webTransportOptions };

package/dist/authority/fast-webtransport.js

@@ -0,0 +1,21 @@
+import {
+  FAST_WT_HASHES_MAX,
+  FAST_WT_HASH_HEX_DIGITS,
+  chooseFastSocket,
+  fastWebTransportOf,
+  openWebTransportFastSocket,
+  webTransportFastOpener,
+  webTransportOptions
+} from "../chunk-NFMGIKFZ.js";
+import "../chunk-OD6NRSX2.js";
+import "../chunk-2NGXXQDS.js";
+import "../chunk-CSQEEANB.js";
+export {
+  FAST_WT_HASHES_MAX,
+  FAST_WT_HASH_HEX_DIGITS,
+  chooseFastSocket,
+  fastWebTransportOf,
+  openWebTransportFastSocket,
+  webTransportFastOpener,
+  webTransportOptions
+};