@threenative/core 0.3.4 → 0.3.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (176) hide show
  1. package/capabilities.json +1505 -79
  2. package/dist/{audio-7i3Xl0l3.d.ts → audio-DIJE5HTr.d.ts} +43 -3
  3. package/dist/{canvas-layer-DDmC_VVF.d.ts → canvas-layer-C1-5CviZ.d.ts} +5 -1
  4. package/dist/{game-CljaDv4D.d.ts → game-Bj8G1wmD.d.ts} +102 -11
  5. package/dist/hot.d.ts +4 -4
  6. package/dist/index.d.ts +712 -118
  7. package/dist/index.js +12423 -4955
  8. package/dist/{gpu-readback-CqJEfWNQ.d.ts → model-lod-BDAUYgsS.d.ts} +80 -5
  9. package/dist/playtest.d.ts +6 -10
  10. package/dist/playtest.js +47 -24
  11. package/dist/react-css.d.ts +62 -0
  12. package/dist/react-css.js +591 -0
  13. package/dist/react.d.ts +2 -2
  14. package/dist/{renderer-CfsS2hxi.d.ts → renderer-9yEo9hPa.d.ts} +489 -22
  15. package/dist/terrain-jobs-worker.d.ts +2 -0
  16. package/dist/terrain-jobs-worker.js +130 -0
  17. package/dist/ui-layer.js +59 -8
  18. package/dist/world.d.ts +766 -73
  19. package/dist/world.js +9307 -3543
  20. package/gpl/recipes/export_world.py +18 -1
  21. package/mcp/blender-server.mjs +7 -4
  22. package/mcp/blender.mjs +3 -4
  23. package/mcp/engine-server.mjs +2 -2
  24. package/mcp/servers.mjs +4 -4
  25. package/package.json +15 -9
  26. package/patches/three@0.185.1-prd269-upgrade.patch +22418 -0
  27. package/patches/three@0.185.1.patch +6594 -700
  28. package/scripts/apply-three-patch.mjs +62 -4
  29. package/src/animation-blend.ts +264 -0
  30. package/src/animation-composition.ts +362 -0
  31. package/src/animation-layers.ts +260 -0
  32. package/src/animation-root-motion.ts +283 -0
  33. package/src/animation.ts +896 -0
  34. package/src/assets.ts +1303 -0
  35. package/src/atmosphere/index.ts +335 -0
  36. package/src/atmosphere/luts.ts +298 -0
  37. package/src/atmosphere/params.ts +323 -0
  38. package/src/audio.ts +912 -0
  39. package/src/billboard.ts +124 -0
  40. package/src/bone-lengths.ts +157 -0
  41. package/src/camera-shake.ts +116 -0
  42. package/src/canvas-layer.ts +47 -0
  43. package/src/clip-audit.ts +401 -0
  44. package/src/clustered-batch.ts +492 -0
  45. package/src/clustered-mesh.ts +638 -0
  46. package/src/compute-driven.ts +176 -0
  47. package/src/compute-timing.ts +318 -0
  48. package/src/config.ts +593 -0
  49. package/src/debug.ts +82 -0
  50. package/src/engine-render-hook.ts +25 -0
  51. package/src/entities.ts +79 -0
  52. package/src/entity-snapshot.ts +53 -0
  53. package/src/flight.ts +683 -0
  54. package/src/fluid-field.ts +748 -0
  55. package/src/fluid-particles.ts +1253 -0
  56. package/src/frame-budget.ts +1368 -0
  57. package/src/game.ts +2390 -0
  58. package/src/geometry-capture.ts +1098 -0
  59. package/src/gpu-class.ts +160 -0
  60. package/src/gpu-frame-observation.ts +424 -0
  61. package/src/gpu-readback.ts +143 -0
  62. package/src/gpu-scene-bvh.ts +464 -0
  63. package/src/grounding.ts +100 -0
  64. package/src/hot.ts +161 -0
  65. package/src/import-meta.d.ts +13 -0
  66. package/src/index.ts +1536 -0
  67. package/src/input.ts +690 -0
  68. package/src/instanced-batch-lod.ts +283 -0
  69. package/src/instanced-batch.ts +274 -0
  70. package/src/interpolation.ts +129 -0
  71. package/src/launch-diagnostics.ts +161 -0
  72. package/src/loop.ts +564 -0
  73. package/src/matrix-world.ts +245 -0
  74. package/src/merge-parts.ts +812 -0
  75. package/src/model-lod.ts +1315 -0
  76. package/src/net-protocol.ts +333 -0
  77. package/src/net-session.ts +477 -0
  78. package/src/net.ts +80 -0
  79. package/src/ocean/fft.ts +72 -0
  80. package/src/ocean/spectral.ts +728 -0
  81. package/src/particle-significance.ts +102 -0
  82. package/src/particles.ts +648 -0
  83. package/src/path-follow.ts +175 -0
  84. package/src/picking.ts +250 -0
  85. package/src/pipeline-census.ts +1566 -0
  86. package/src/platform.ts +210 -0
  87. package/src/playtest.ts +839 -0
  88. package/src/pointer-events.ts +411 -0
  89. package/src/pose-measure.ts +435 -0
  90. package/src/profiling/FrameCounters.ts +231 -0
  91. package/src/profiling/Spans.ts +548 -0
  92. package/src/profiling/opacity-convention.ts +21 -0
  93. package/src/profiling/render-list-validate.ts +175 -0
  94. package/src/profiling/render-trap-audit.ts +84 -0
  95. package/src/profiling/scene-warning.ts +190 -0
  96. package/src/profiling/span-probes.ts +191 -0
  97. package/src/profiling/unlit-foliage-warning.ts +149 -0
  98. package/src/projection-apply.ts +1529 -0
  99. package/src/projection-marker.ts +142 -0
  100. package/src/projection-plan.ts +1258 -0
  101. package/src/projection-skinned.ts +419 -0
  102. package/src/projection-stability.ts +409 -0
  103. package/src/projection-uniform.ts +328 -0
  104. package/src/random.ts +41 -0
  105. package/src/react-css.ts +604 -0
  106. package/src/react-glyphs.ts +114 -0
  107. package/src/react-host.ts +576 -0
  108. package/src/react-layout.ts +265 -0
  109. package/src/react.ts +60 -0
  110. package/src/render/alpha-antialiasing.ts +159 -0
  111. package/src/render/batched-velocity.ts +126 -0
  112. package/src/render/chain.ts +1021 -0
  113. package/src/render/daylight.ts +189 -0
  114. package/src/render/depth-pyramid.ts +596 -0
  115. package/src/render/foliage-alpha.ts +166 -0
  116. package/src/render/material-key.ts +60 -0
  117. package/src/render/mesh-pool.ts +144 -0
  118. package/src/render/probe-volume.ts +1668 -0
  119. package/src/render/resolution-subrect.ts +253 -0
  120. package/src/render/velocity.ts +442 -0
  121. package/src/render/virtual-shadow-pages.ts +827 -0
  122. package/src/render/virtual-shadow-partial.ts +174 -0
  123. package/src/render/virtual-shadow.ts +3330 -0
  124. package/src/render/world-impostor-surface.ts +722 -0
  125. package/src/render/world-impostor.ts +558 -0
  126. package/src/render-camera-cull.ts +441 -0
  127. package/src/render-pass-budget.ts +501 -0
  128. package/src/renderProjection.ts +758 -0
  129. package/src/renderer-config.ts +127 -0
  130. package/src/renderer.ts +1847 -0
  131. package/src/replay-protocol.ts +85 -0
  132. package/src/replay.ts +205 -0
  133. package/src/resolution-scaler.ts +819 -0
  134. package/src/rig-preparation.ts +271 -0
  135. package/src/ripple-field.ts +432 -0
  136. package/src/scale.ts +109 -0
  137. package/src/scene.ts +239 -0
  138. package/src/schedule.ts +155 -0
  139. package/src/skeletal-mesh.ts +61 -0
  140. package/src/skeleton.ts +100 -0
  141. package/src/snow-field.ts +744 -0
  142. package/src/softbody-topology.ts +269 -0
  143. package/src/softbody.ts +516 -0
  144. package/src/sprite-animator.ts +222 -0
  145. package/src/startup-readiness.ts +386 -0
  146. package/src/state.ts +66 -0
  147. package/src/static-transform.ts +274 -0
  148. package/src/storage-buffer.ts +253 -0
  149. package/src/streaming.ts +308 -0
  150. package/src/target-fps.ts +92 -0
  151. package/src/terrain-jobs-worker.ts +17 -0
  152. package/src/terrain-jobs.ts +353 -0
  153. package/src/textures.ts +39 -0
  154. package/src/tracers.ts +237 -0
  155. package/src/ui-bridge.ts +368 -0
  156. package/src/ui-hit-regions.ts +380 -0
  157. package/src/ui-layer.ts +83 -0
  158. package/src/ui-state.ts +220 -0
  159. package/src/version.ts +2 -0
  160. package/src/viewport.ts +253 -0
  161. package/src/warmup.ts +1357 -0
  162. package/src/water-surface.ts +384 -0
  163. package/src/wave-field.ts +524 -0
  164. package/src/world-capabilities.ts +131 -0
  165. package/src/world-cell-proxy.ts +392 -0
  166. package/src/world-cells.ts +10564 -0
  167. package/src/world-gpu-scene.ts +3354 -0
  168. package/src/world-heightmap.ts +82 -0
  169. package/src/world-package.ts +469 -0
  170. package/src/world-passes.ts +582 -0
  171. package/src/world-region.ts +17 -0
  172. package/src/world-terrain-splat.ts +564 -0
  173. package/src/world-tiles.ts +3826 -0
  174. package/src/world-topology.ts +370 -0
  175. package/src/world-validate.ts +48 -0
  176. package/src/world.ts +805 -0
@@ -0,0 +1,333 @@
1
+ import type { INetworkOptions } from "./net.js";
2
+
3
+ const WIRE_VERSION = 1;
4
+ export const KIND_HELLO = 1;
5
+ export const KIND_WELCOME = 2;
6
+ export const KIND_BIND = 3;
7
+ export const KIND_BOUND = 4;
8
+ export const KIND_DATA = 16;
9
+ export const HEADER_BYTES = 8;
10
+ export const MAX_HELLO_BYTES = 4096;
11
+ const DEFAULT_CONNECT_TIMEOUT_MS = 10_000;
12
+ const DEFAULT_MAX_RELIABLE_MESSAGE_BYTES = 65_536;
13
+ const DEFAULT_MAX_QUEUED_RELIABLE_BYTES = 1_048_576;
14
+ const DEFAULT_MAX_QUEUED_DATAGRAMS = 256;
15
+
16
+ export interface INormalizedOptions {
17
+ applicationProtocol: string;
18
+ credential: string;
19
+ channels: { id: number; delivery: "unreliable" | "reliable-ordered" }[];
20
+ signal: AbortSignal | undefined;
21
+ connectTimeoutMs: number;
22
+ maxReliableMessageBytes: number;
23
+ maxQueuedReliableBytes: number;
24
+ maxQueuedDatagrams: number;
25
+ }
26
+
27
+ export interface IDecodedFrame {
28
+ kind: number;
29
+ channel: number;
30
+ payload: Uint8Array;
31
+ }
32
+
33
+ export interface IWebTransportLike {
34
+ ready: Promise<unknown>;
35
+ closed: Promise<unknown>;
36
+ datagrams: {
37
+ readable: ReadableStream<Uint8Array>;
38
+ writable: WritableStream<Uint8Array>;
39
+ maxDatagramSize?: number;
40
+ };
41
+ createBidirectionalStream():
42
+ | Promise<{
43
+ readable: ReadableStream<Uint8Array>;
44
+ writable: WritableStream<Uint8Array>;
45
+ }>
46
+ | {
47
+ readable: ReadableStream<Uint8Array>;
48
+ writable: WritableStream<Uint8Array>;
49
+ };
50
+ close(): void;
51
+ }
52
+
53
+ export type IWebTransportConstructor = new (url: string, options?: object) => IWebTransportLike;
54
+
55
+ export function invalidArgument(message: string): Error {
56
+ return new Error(`TN_NET_INVALID_ARGUMENT: ${message}`);
57
+ }
58
+
59
+ function isPositiveSafeInteger(value: unknown): value is number {
60
+ return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
61
+ }
62
+
63
+ export function normalizeOptions(url: string, options: INetworkOptions): INormalizedOptions {
64
+ let parsed: URL;
65
+ try {
66
+ parsed = new URL(url);
67
+ } catch {
68
+ throw invalidArgument("url must be a valid URL");
69
+ }
70
+ if (parsed.protocol !== "https:") throw invalidArgument("url must use https");
71
+ if (options === null || typeof options !== "object")
72
+ throw invalidArgument("options are required");
73
+ if (typeof options.applicationProtocol !== "string")
74
+ throw invalidArgument("applicationProtocol is required");
75
+ if (
76
+ options.applicationProtocol.length < 1 ||
77
+ options.applicationProtocol.length > 64 ||
78
+ !/^[\x20-\x7e]+$/u.test(options.applicationProtocol)
79
+ )
80
+ throw invalidArgument("applicationProtocol must be 1-64 printable ASCII characters");
81
+ if (typeof options.credential !== "string" || options.credential.length === 0)
82
+ throw invalidArgument("credential must be nonempty");
83
+ if (
84
+ !Array.isArray(options.channels) ||
85
+ options.channels.length < 1 ||
86
+ options.channels.length > 32
87
+ )
88
+ throw invalidArgument("channels must list 1-32 entries");
89
+ const seen = new Set<number>();
90
+ const channels = options.channels.map((channel) => {
91
+ if (channel === null || typeof channel !== "object")
92
+ throw invalidArgument("channel entries are required");
93
+ if (!Number.isInteger(channel.id) || channel.id < 1 || channel.id > 65535)
94
+ throw invalidArgument("channel ids must be integers 1-65535");
95
+ if (channel.delivery !== "unreliable" && channel.delivery !== "reliable-ordered")
96
+ throw invalidArgument("channel delivery is unknown");
97
+ if (seen.has(channel.id)) throw invalidArgument("channel ids must be unique");
98
+ seen.add(channel.id);
99
+ return { id: channel.id, delivery: channel.delivery };
100
+ });
101
+ if (options.signal !== undefined && !(options.signal instanceof AbortSignal))
102
+ throw invalidArgument("signal must be an AbortSignal");
103
+ const connectTimeoutMs = options.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
104
+ const maxReliableMessageBytes =
105
+ options.maxReliableMessageBytes ?? DEFAULT_MAX_RELIABLE_MESSAGE_BYTES;
106
+ const maxQueuedReliableBytes =
107
+ options.maxQueuedReliableBytes ?? DEFAULT_MAX_QUEUED_RELIABLE_BYTES;
108
+ const maxQueuedDatagrams = options.maxQueuedDatagrams ?? DEFAULT_MAX_QUEUED_DATAGRAMS;
109
+ if (!isPositiveSafeInteger(connectTimeoutMs))
110
+ throw invalidArgument("connectTimeoutMs must be positive");
111
+ if (!isPositiveSafeInteger(maxReliableMessageBytes))
112
+ throw invalidArgument("maxReliableMessageBytes must be positive");
113
+ if (!isPositiveSafeInteger(maxQueuedReliableBytes))
114
+ throw invalidArgument("maxQueuedReliableBytes must be positive");
115
+ if (!isPositiveSafeInteger(maxQueuedDatagrams))
116
+ throw invalidArgument("maxQueuedDatagrams must be positive");
117
+ if (maxReliableMessageBytes > maxQueuedReliableBytes)
118
+ throw invalidArgument("message limit cannot exceed queue limit");
119
+ return {
120
+ applicationProtocol: options.applicationProtocol,
121
+ credential: options.credential,
122
+ channels,
123
+ signal: options.signal,
124
+ connectTimeoutMs,
125
+ maxReliableMessageBytes,
126
+ maxQueuedReliableBytes,
127
+ maxQueuedDatagrams,
128
+ };
129
+ }
130
+
131
+ export function encodeFrame(kind: number, channel: number, payload: Uint8Array): Uint8Array {
132
+ const out = new Uint8Array(HEADER_BYTES + payload.length);
133
+ const view = new DataView(out.buffer, out.byteOffset, out.byteLength);
134
+ out[0] = WIRE_VERSION;
135
+ out[1] = kind;
136
+ view.setUint16(2, channel);
137
+ view.setUint32(4, payload.length);
138
+ out.set(payload, HEADER_BYTES);
139
+ return out;
140
+ }
141
+
142
+ function checkFrameHead(version: number, kind: number, channel: number): void {
143
+ if (version !== WIRE_VERSION) throw new Error("TN_NET_PROTOCOL: unknown wire version");
144
+ if (
145
+ kind !== KIND_HELLO &&
146
+ kind !== KIND_WELCOME &&
147
+ kind !== KIND_BIND &&
148
+ kind !== KIND_BOUND &&
149
+ kind !== KIND_DATA
150
+ )
151
+ throw new Error("TN_NET_PROTOCOL: unknown frame kind");
152
+ if (kind === KIND_DATA && channel === 0) throw new Error("TN_NET_PROTOCOL: DATA on channel 0");
153
+ }
154
+
155
+ export function decodeStandaloneFrame(bytes: Uint8Array): IDecodedFrame {
156
+ if (bytes.length < HEADER_BYTES) throw new Error("TN_NET_PROTOCOL: truncated header");
157
+ const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
158
+ const version = bytes[0] ?? 0;
159
+ const kind = bytes[1] ?? 0;
160
+ const channel = view.getUint16(2);
161
+ const length = view.getUint32(4);
162
+ checkFrameHead(version, kind, channel);
163
+ if (bytes.length !== HEADER_BYTES + length)
164
+ throw new Error("TN_NET_PROTOCOL: bad datagram length");
165
+ return { kind, channel, payload: bytes.slice(HEADER_BYTES) };
166
+ }
167
+
168
+ /** Decode at most one complete frame; trailing bytes stay as a raw view for later calls. */
169
+ function readStreamFrame(
170
+ buffer: Uint8Array,
171
+ limit: number,
172
+ ): { frame: IDecodedFrame; rest: Uint8Array } | undefined {
173
+ if (buffer.length < HEADER_BYTES) return undefined;
174
+ const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
175
+ const version = buffer[0] ?? 0;
176
+ const kind = buffer[1] ?? 0;
177
+ const channel = view.getUint16(2);
178
+ const length = view.getUint32(4);
179
+ checkFrameHead(version, kind, channel);
180
+ if (length > limit) throw new Error("TN_NET_PROTOCOL: frame exceeds limit");
181
+ const frameBytes = HEADER_BYTES + length;
182
+ if (frameBytes > buffer.length) return undefined;
183
+ return {
184
+ frame: { kind, channel, payload: buffer.slice(HEADER_BYTES, frameBytes) },
185
+ rest: buffer.subarray(frameBytes),
186
+ };
187
+ }
188
+
189
+ export function webTransportConstructor(): IWebTransportConstructor | undefined {
190
+ const value = (globalThis as Record<string, unknown>).WebTransport;
191
+ if (typeof value !== "function") return undefined;
192
+ return value as IWebTransportConstructor;
193
+ }
194
+
195
+ export function parseWelcome(
196
+ payload: Uint8Array,
197
+ expectedProtocol: string,
198
+ ): {
199
+ sessionId: string;
200
+ channels: { id: number; delivery: "unreliable" | "reliable-ordered" }[];
201
+ maxReliableMessageBytes: number;
202
+ maxQueuedReliableBytes: number;
203
+ maxQueuedDatagrams: number;
204
+ } {
205
+ const text = new TextDecoder("utf-8", { fatal: true }).decode(payload);
206
+ const parsed = JSON.parse(text) as Record<string, unknown>;
207
+ if (
208
+ Object.keys(parsed).sort().join(",") !==
209
+ "applicationProtocol,channels,maxQueuedDatagrams,maxQueuedReliableBytes,maxReliableMessageBytes,sessionId"
210
+ )
211
+ throw new Error("TN_NET_PROTOCOL: WELCOME has unexpected keys");
212
+ if (parsed.applicationProtocol !== expectedProtocol)
213
+ throw new Error("TN_NET_PROTOCOL: WELCOME protocol mismatch");
214
+ if (typeof parsed.sessionId !== "string" || !/^[0-9a-f]{32}$/u.test(parsed.sessionId))
215
+ throw new Error("TN_NET_PROTOCOL: WELCOME session id is invalid");
216
+ if (!Array.isArray(parsed.channels))
217
+ throw new Error("TN_NET_PROTOCOL: WELCOME channels are invalid");
218
+ const channels = (parsed.channels as unknown[]).map((entry) => {
219
+ if (entry === null || typeof entry !== "object")
220
+ throw new Error("TN_NET_PROTOCOL: bad channel");
221
+ const record = entry as Record<string, unknown>;
222
+ if (Object.keys(record).sort().join(",") !== "delivery,id")
223
+ throw new Error("TN_NET_PROTOCOL: bad channel shape");
224
+ if (!Number.isInteger(record.id) || (record.id as number) < 1 || (record.id as number) > 65535)
225
+ throw new Error("TN_NET_PROTOCOL: bad channel id");
226
+ if (record.delivery !== "unreliable" && record.delivery !== "reliable-ordered")
227
+ throw new Error("TN_NET_PROTOCOL: bad delivery");
228
+ return {
229
+ id: record.id as number,
230
+ delivery: record.delivery as "unreliable" | "reliable-ordered",
231
+ };
232
+ });
233
+ for (const key of [
234
+ "maxReliableMessageBytes",
235
+ "maxQueuedReliableBytes",
236
+ "maxQueuedDatagrams",
237
+ ] as const) {
238
+ const value = parsed[key];
239
+ if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0)
240
+ throw new Error("TN_NET_PROTOCOL: bad WELCOME limit");
241
+ }
242
+ const messageLimit = parsed.maxReliableMessageBytes as number;
243
+ const queueLimit = parsed.maxQueuedReliableBytes as number;
244
+ if (messageLimit > queueLimit) throw new Error("TN_NET_PROTOCOL: invalid negotiated limits");
245
+ return {
246
+ sessionId: parsed.sessionId as string,
247
+ channels,
248
+ maxReliableMessageBytes: messageLimit,
249
+ maxQueuedReliableBytes: queueLimit,
250
+ maxQueuedDatagrams: parsed.maxQueuedDatagrams as number,
251
+ };
252
+ }
253
+
254
+ export async function writeAll(
255
+ writable: WritableStream<Uint8Array>,
256
+ bytes: Uint8Array,
257
+ ): Promise<void> {
258
+ const writer = writable.getWriter();
259
+ try {
260
+ await writer.write(bytes);
261
+ } finally {
262
+ writer.releaseLock();
263
+ }
264
+ }
265
+
266
+ function concatBytes(left: Uint8Array, right: Uint8Array): Uint8Array {
267
+ const out = new Uint8Array(left.length + right.length);
268
+ out.set(left, 0);
269
+ out.set(right, left.length);
270
+ return out;
271
+ }
272
+
273
+ export function asBytes(chunk: unknown): Uint8Array<ArrayBuffer> {
274
+ if (chunk instanceof Uint8Array) return Uint8Array.from(chunk);
275
+ if (chunk instanceof ArrayBuffer) return Uint8Array.from(new Uint8Array(chunk));
276
+ return Uint8Array.from(new Uint8Array(chunk as ArrayBuffer));
277
+ }
278
+
279
+ /** Incremental stream-frame reader used for handshake and reliable channels. */
280
+ export class FrameReader {
281
+ #reader: ReadableStreamDefaultReader<Uint8Array>;
282
+ #buffer: Uint8Array = new Uint8Array(0);
283
+ #limit: number;
284
+ #released = false;
285
+
286
+ constructor(readable: ReadableStream<Uint8Array>, limit: number) {
287
+ this.#reader = readable.getReader();
288
+ this.#limit = limit;
289
+ }
290
+
291
+ async nextFrame(signal?: AbortSignal): Promise<IDecodedFrame> {
292
+ for (;;) {
293
+ if (signal?.aborted) throw new Error("TN_NET_CANCELLED: aborted");
294
+ const decoded = readStreamFrame(this.#buffer, this.#limit);
295
+ if (decoded !== undefined) {
296
+ this.#buffer = decoded.rest.length === 0 ? new Uint8Array(0) : decoded.rest;
297
+ return decoded.frame;
298
+ }
299
+ if (this.#buffer.length > this.#limit + HEADER_BYTES)
300
+ throw new Error("TN_NET_PROTOCOL: frame exceeds limit");
301
+ const abort = new Promise<never>((_, reject) => {
302
+ signal?.addEventListener("abort", () => reject(new Error("TN_NET_CANCELLED: aborted")), {
303
+ once: true,
304
+ });
305
+ });
306
+ const read =
307
+ signal === undefined
308
+ ? await this.#reader.read()
309
+ : await Promise.race([this.#reader.read(), abort]);
310
+ if (read.done) throw new Error("TN_NET_PROTOCOL: stream ended");
311
+ const chunk = asBytes(read.value);
312
+ this.#buffer = this.#buffer.length === 0 ? chunk : concatBytes(this.#buffer, chunk);
313
+ }
314
+ }
315
+
316
+ release(): void {
317
+ if (this.#released) return;
318
+ this.#released = true;
319
+ try {
320
+ this.#reader.releaseLock();
321
+ } catch {
322
+ /* already released */
323
+ }
324
+ }
325
+
326
+ cancel(reason: unknown): Promise<void> {
327
+ try {
328
+ return this.#reader.cancel(reason);
329
+ } catch {
330
+ return Promise.resolve();
331
+ }
332
+ }
333
+ }