@tanstack/router-core 1.167.1 → 1.167.3

package/dist/esm/ssr/serializer/RawStream.js

@@ -1,288 +1,282 @@
 import { createPlugin, createStream } from "seroval";
-class RawStream {
-  constructor(stream, options) {
-    this.stream = stream;
-    this.hint = options?.hint ?? "binary";
-  }
-}
-const BufferCtor = globalThis.Buffer;
-const hasNodeBuffer = !!BufferCtor && typeof BufferCtor.from === "function";
+//#region src/ssr/serializer/RawStream.ts
+/**
+* Marker class for ReadableStream<Uint8Array> that should be serialized
+* with base64 encoding (SSR) or binary framing (server functions).
+*
+* Wrap your binary streams with this to get efficient serialization:
+* ```ts
+* // For binary data (files, images, etc.)
+* return { data: new RawStream(file.stream()) }
+*
+* // For text-heavy data (RSC payloads, etc.)
+* return { data: new RawStream(rscStream, { hint: 'text' }) }
+* ```
+*/
+var RawStream = class {
+	constructor(stream, options) {
+		this.stream = stream;
+		this.hint = options?.hint ?? "binary";
+	}
+};
+var BufferCtor = globalThis.Buffer;
+var hasNodeBuffer = !!BufferCtor && typeof BufferCtor.from === "function";
 function uint8ArrayToBase64(bytes) {
-  if (bytes.length === 0) return "";
-  if (hasNodeBuffer) {
-    return BufferCtor.from(bytes).toString("base64");
-  }
-  const CHUNK_SIZE = 32768;
-  const chunks = [];
-  for (let i = 0; i < bytes.length; i += CHUNK_SIZE) {
-    const chunk = bytes.subarray(i, i + CHUNK_SIZE);
-    chunks.push(String.fromCharCode.apply(null, chunk));
-  }
-  return btoa(chunks.join(""));
+	if (bytes.length === 0) return "";
+	if (hasNodeBuffer) return BufferCtor.from(bytes).toString("base64");
+	const CHUNK_SIZE = 32768;
+	const chunks = [];
+	for (let i = 0; i < bytes.length; i += CHUNK_SIZE) {
+		const chunk = bytes.subarray(i, i + CHUNK_SIZE);
+		chunks.push(String.fromCharCode.apply(null, chunk));
+	}
+	return btoa(chunks.join(""));
 }
 function base64ToUint8Array(base64) {
-  if (base64.length === 0) return new Uint8Array(0);
-  if (hasNodeBuffer) {
-    const buf = BufferCtor.from(base64, "base64");
-    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
-  }
-  const binary = atob(base64);
-  const bytes = new Uint8Array(binary.length);
-  for (let i = 0; i < binary.length; i++) {
-    bytes[i] = binary.charCodeAt(i);
-  }
-  return bytes;
+	if (base64.length === 0) return new Uint8Array(0);
+	if (hasNodeBuffer) {
+		const buf = BufferCtor.from(base64, "base64");
+		return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+	}
+	const binary = atob(base64);
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return bytes;
 }
-const RAW_STREAM_FACTORY_BINARY = /* @__PURE__ */ Object.create(null);
-const RAW_STREAM_FACTORY_TEXT = /* @__PURE__ */ Object.create(null);
-const RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY = (stream) => new ReadableStream({
-  start(controller) {
-    stream.on({
-      next(base64) {
-        try {
-          controller.enqueue(base64ToUint8Array(base64));
-        } catch {
-        }
-      },
-      throw(error) {
-        controller.error(error);
-      },
-      return() {
-        try {
-          controller.close();
-        } catch {
-        }
-      }
-    });
-  }
-});
-const textEncoderForFactory = new TextEncoder();
-const RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT = (stream) => {
-  return new ReadableStream({
-    start(controller) {
-      stream.on({
-        next(value) {
-          try {
-            if (typeof value === "string") {
-              controller.enqueue(textEncoderForFactory.encode(value));
-            } else {
-              controller.enqueue(base64ToUint8Array(value.$b64));
-            }
-          } catch {
-          }
-        },
-        throw(error) {
-          controller.error(error);
-        },
-        return() {
-          try {
-            controller.close();
-          } catch {
-          }
-        }
-      });
-    }
-  });
+var RAW_STREAM_FACTORY_BINARY = Object.create(null);
+var RAW_STREAM_FACTORY_TEXT = Object.create(null);
+var RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY = (stream) => new ReadableStream({ start(controller) {
+	stream.on({
+		next(base64) {
+			try {
+				controller.enqueue(base64ToUint8Array(base64));
+			} catch {}
+		},
+		throw(error) {
+			controller.error(error);
+		},
+		return() {
+			try {
+				controller.close();
+			} catch {}
+		}
+	});
+} });
+var textEncoderForFactory = new TextEncoder();
+var RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT = (stream) => {
+	return new ReadableStream({ start(controller) {
+		stream.on({
+			next(value) {
+				try {
+					if (typeof value === "string") controller.enqueue(textEncoderForFactory.encode(value));
+					else controller.enqueue(base64ToUint8Array(value.$b64));
+				} catch {}
+			},
+			throw(error) {
+				controller.error(error);
+			},
+			return() {
+				try {
+					controller.close();
+				} catch {}
+			}
+		});
+	} });
 };
-const FACTORY_BINARY = `(s=>new ReadableStream({start(c){s.on({next(b){try{const d=atob(b),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}catch(_){}},throw(e){c.error(e)},return(){try{c.close()}catch(_){}}})}}))`;
-const FACTORY_TEXT = `(s=>{const e=new TextEncoder();return new ReadableStream({start(c){s.on({next(v){try{if(typeof v==='string'){c.enqueue(e.encode(v))}else{const d=atob(v.$b64),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}}catch(_){}},throw(x){c.error(x)},return(){try{c.close()}catch(_){}}})}})})`;
+var FACTORY_BINARY = `(s=>new ReadableStream({start(c){s.on({next(b){try{const d=atob(b),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}catch(_){}},throw(e){c.error(e)},return(){try{c.close()}catch(_){}}})}}))`;
+var FACTORY_TEXT = `(s=>{const e=new TextEncoder();return new ReadableStream({start(c){s.on({next(v){try{if(typeof v==='string'){c.enqueue(e.encode(v))}else{const d=atob(v.$b64),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}}catch(_){}},throw(x){c.error(x)},return(){try{c.close()}catch(_){}}})}})})`;
 function toBinaryStream(readable) {
-  const stream = createStream();
-  const reader = readable.getReader();
-  (async () => {
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) {
-          stream.return(void 0);
-          break;
-        }
-        stream.next(uint8ArrayToBase64(value));
-      }
-    } catch (error) {
-      stream.throw(error);
-    } finally {
-      reader.releaseLock();
-    }
-  })();
-  return stream;
+	const stream = createStream();
+	const reader = readable.getReader();
+	(async () => {
+		try {
+			while (true) {
+				const { done, value } = await reader.read();
+				if (done) {
+					stream.return(void 0);
+					break;
+				}
+				stream.next(uint8ArrayToBase64(value));
+			}
+		} catch (error) {
+			stream.throw(error);
+		} finally {
+			reader.releaseLock();
+		}
+	})();
+	return stream;
 }
 function toTextStream(readable) {
-  const stream = createStream();
-  const reader = readable.getReader();
-  const decoder = new TextDecoder("utf-8", { fatal: true });
-  (async () => {
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) {
-          try {
-            const remaining = decoder.decode();
-            if (remaining.length > 0) {
-              stream.next(remaining);
-            }
-          } catch {
-          }
-          stream.return(void 0);
-          break;
-        }
-        try {
-          const text = decoder.decode(value, { stream: true });
-          if (text.length > 0) {
-            stream.next(text);
-          }
-        } catch {
-          stream.next({ $b64: uint8ArrayToBase64(value) });
-        }
-      }
-    } catch (error) {
-      stream.throw(error);
-    } finally {
-      reader.releaseLock();
-    }
-  })();
-  return stream;
+	const stream = createStream();
+	const reader = readable.getReader();
+	const decoder = new TextDecoder("utf-8", { fatal: true });
+	(async () => {
+		try {
+			while (true) {
+				const { done, value } = await reader.read();
+				if (done) {
+					try {
+						const remaining = decoder.decode();
+						if (remaining.length > 0) stream.next(remaining);
+					} catch {}
+					stream.return(void 0);
+					break;
+				}
+				try {
+					const text = decoder.decode(value, { stream: true });
+					if (text.length > 0) stream.next(text);
+				} catch {
+					stream.next({ $b64: uint8ArrayToBase64(value) });
+				}
+			}
+		} catch (error) {
+			stream.throw(error);
+		} finally {
+			reader.releaseLock();
+		}
+	})();
+	return stream;
 }
-const RawStreamFactoryBinaryPlugin = createPlugin({
-  tag: "tss/RawStreamFactory",
-  test(value) {
-    return value === RAW_STREAM_FACTORY_BINARY;
-  },
-  parse: {
-    sync() {
-      return void 0;
-    },
-    async() {
-      return Promise.resolve(void 0);
-    },
-    stream() {
-      return void 0;
-    }
-  },
-  serialize() {
-    return FACTORY_BINARY;
-  },
-  deserialize() {
-    return RAW_STREAM_FACTORY_BINARY;
-  }
-});
-const RawStreamFactoryTextPlugin = createPlugin({
-  tag: "tss/RawStreamFactoryText",
-  test(value) {
-    return value === RAW_STREAM_FACTORY_TEXT;
-  },
-  parse: {
-    sync() {
-      return void 0;
-    },
-    async() {
-      return Promise.resolve(void 0);
-    },
-    stream() {
-      return void 0;
-    }
-  },
-  serialize() {
-    return FACTORY_TEXT;
-  },
-  deserialize() {
-    return RAW_STREAM_FACTORY_TEXT;
-  }
-});
-const RawStreamSSRPlugin = createPlugin({
-  tag: "tss/RawStream",
-  extends: [RawStreamFactoryBinaryPlugin, RawStreamFactoryTextPlugin],
-  test(value) {
-    return value instanceof RawStream;
-  },
-  parse: {
-    sync(value, ctx) {
-      const factory = value.hint === "text" ? RAW_STREAM_FACTORY_TEXT : RAW_STREAM_FACTORY_BINARY;
-      return {
-        hint: value.hint,
-        factory: ctx.parse(factory),
-        stream: ctx.parse(createStream())
-      };
-    },
-    async async(value, ctx) {
-      const factory = value.hint === "text" ? RAW_STREAM_FACTORY_TEXT : RAW_STREAM_FACTORY_BINARY;
-      const encodedStream = value.hint === "text" ? toTextStream(value.stream) : toBinaryStream(value.stream);
-      return {
-        hint: value.hint,
-        factory: await ctx.parse(factory),
-        stream: await ctx.parse(encodedStream)
-      };
-    },
-    stream(value, ctx) {
-      const factory = value.hint === "text" ? RAW_STREAM_FACTORY_TEXT : RAW_STREAM_FACTORY_BINARY;
-      const encodedStream = value.hint === "text" ? toTextStream(value.stream) : toBinaryStream(value.stream);
-      return {
-        hint: value.hint,
-        factory: ctx.parse(factory),
-        stream: ctx.parse(encodedStream)
-      };
-    }
-  },
-  serialize(node, ctx) {
-    return "(" + ctx.serialize(node.factory) + ")(" + ctx.serialize(node.stream) + ")";
-  },
-  deserialize(node, ctx) {
-    const stream = ctx.deserialize(node.stream);
-    return node.hint === "text" ? RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT(stream) : RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY(stream);
-  }
+/**
+* SSR Plugin - uses base64 or UTF-8+base64 encoding for chunks, delegates to seroval's stream mechanism.
+* Used during SSR when serializing to JavaScript code for HTML injection.
+*
+* Supports two modes based on RawStream hint:
+* - 'binary': Always base64 encode (default)
+* - 'text': Try UTF-8 first, fallback to base64 for invalid UTF-8
+*/
+var RawStreamSSRPlugin = createPlugin({
+	tag: "tss/RawStream",
+	extends: [createPlugin({
+		tag: "tss/RawStreamFactory",
+		test(value) {
+			return value === RAW_STREAM_FACTORY_BINARY;
+		},
+		parse: {
+			sync() {},
+			async() {
+				return Promise.resolve(void 0);
+			},
+			stream() {}
+		},
+		serialize() {
+			return FACTORY_BINARY;
+		},
+		deserialize() {
+			return RAW_STREAM_FACTORY_BINARY;
+		}
+	}), createPlugin({
+		tag: "tss/RawStreamFactoryText",
+		test(value) {
+			return value === RAW_STREAM_FACTORY_TEXT;
+		},
+		parse: {
+			sync() {},
+			async() {
+				return Promise.resolve(void 0);
+			},
+			stream() {}
+		},
+		serialize() {
+			return FACTORY_TEXT;
+		},
+		deserialize() {
+			return RAW_STREAM_FACTORY_TEXT;
+		}
+	})],
+	test(value) {
+		return value instanceof RawStream;
+	},
+	parse: {
+		sync(value, ctx) {
+			const factory = value.hint === "text" ? RAW_STREAM_FACTORY_TEXT : RAW_STREAM_FACTORY_BINARY;
+			return {
+				hint: value.hint,
+				factory: ctx.parse(factory),
+				stream: ctx.parse(createStream())
+			};
+		},
+		async async(value, ctx) {
+			const factory = value.hint === "text" ? RAW_STREAM_FACTORY_TEXT : RAW_STREAM_FACTORY_BINARY;
+			const encodedStream = value.hint === "text" ? toTextStream(value.stream) : toBinaryStream(value.stream);
+			return {
+				hint: value.hint,
+				factory: await ctx.parse(factory),
+				stream: await ctx.parse(encodedStream)
+			};
+		},
+		stream(value, ctx) {
+			const factory = value.hint === "text" ? RAW_STREAM_FACTORY_TEXT : RAW_STREAM_FACTORY_BINARY;
+			const encodedStream = value.hint === "text" ? toTextStream(value.stream) : toBinaryStream(value.stream);
+			return {
+				hint: value.hint,
+				factory: ctx.parse(factory),
+				stream: ctx.parse(encodedStream)
+			};
+		}
+	},
+	serialize(node, ctx) {
+		return "(" + ctx.serialize(node.factory) + ")(" + ctx.serialize(node.stream) + ")";
+	},
+	deserialize(node, ctx) {
+		const stream = ctx.deserialize(node.stream);
+		return node.hint === "text" ? RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT(stream) : RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY(stream);
+	}
 });
+/**
+* Creates an RPC plugin instance that registers raw streams with a multiplexer.
+* Used for server function responses where we want binary framing.
+* Note: RPC always uses binary framing regardless of hint.
+*
+* @param onRawStream Callback invoked when a RawStream is encountered during serialization
+*/
 function createRawStreamRPCPlugin(onRawStream) {
-  let nextStreamId = 1;
-  return createPlugin({
-    tag: "tss/RawStream",
-    test(value) {
-      return value instanceof RawStream;
-    },
-    parse: {
-      async(value) {
-        const streamId = nextStreamId++;
-        onRawStream(streamId, value.stream);
-        return Promise.resolve({ streamId });
-      },
-      stream(value) {
-        const streamId = nextStreamId++;
-        onRawStream(streamId, value.stream);
-        return { streamId };
-      }
-    },
-    serialize() {
-      throw new Error(
-        "RawStreamRPCPlugin.serialize should not be called. RPC uses JSON serialization, not JS code generation."
-      );
-    },
-    deserialize() {
-      throw new Error(
-        "RawStreamRPCPlugin.deserialize should not be called. Use createRawStreamDeserializePlugin on client."
-      );
-    }
-  });
+	let nextStreamId = 1;
+	return createPlugin({
+		tag: "tss/RawStream",
+		test(value) {
+			return value instanceof RawStream;
+		},
+		parse: {
+			async(value) {
+				const streamId = nextStreamId++;
+				onRawStream(streamId, value.stream);
+				return Promise.resolve({ streamId });
+			},
+			stream(value) {
+				const streamId = nextStreamId++;
+				onRawStream(streamId, value.stream);
+				return { streamId };
+			}
+		},
+		serialize() {
+			throw new Error("RawStreamRPCPlugin.serialize should not be called. RPC uses JSON serialization, not JS code generation.");
+		},
+		deserialize() {
+			throw new Error("RawStreamRPCPlugin.deserialize should not be called. Use createRawStreamDeserializePlugin on client.");
+		}
+	});
 }
+/**
+* Creates a deserialize-only plugin for client-side stream reconstruction.
+* Used in serverFnFetcher to wire up streams from frame decoder.
+*
+* @param getOrCreateStream Function to get/create a stream by ID from frame decoder
+*/
 function createRawStreamDeserializePlugin(getOrCreateStream) {
-  return createPlugin({
-    tag: "tss/RawStream",
-    test: () => false,
-    // Client never serializes RawStream
-    parse: {},
-    // Client only deserializes, never parses
-    serialize() {
-      throw new Error(
-        "RawStreamDeserializePlugin.serialize should not be called. Client only deserializes."
-      );
-    },
-    deserialize(node) {
-      return getOrCreateStream(node.streamId);
-    }
-  });
+	return createPlugin({
+		tag: "tss/RawStream",
+		test: () => false,
+		parse: {},
+		serialize() {
+			throw new Error("RawStreamDeserializePlugin.serialize should not be called. Client only deserializes.");
+		},
+		deserialize(node) {
+			return getOrCreateStream(node.streamId);
+		}
+	});
 }
-export {
-  RawStream,
-  RawStreamSSRPlugin,
-  createRawStreamDeserializePlugin,
-  createRawStreamRPCPlugin
-};
-//# sourceMappingURL=RawStream.js.map
+//#endregion
+export { RawStream, RawStreamSSRPlugin, createRawStreamDeserializePlugin, createRawStreamRPCPlugin };
+
+//# sourceMappingURL=RawStream.js.map

package/dist/esm/ssr/serializer/RawStream.js.map

@@ -1 +1 @@
-{"version":3,"file":"RawStream.js","sources":["../../../../src/ssr/serializer/RawStream.ts"],"sourcesContent":["import { createPlugin, createStream } from 'seroval'\nimport type { Plugin } from 'seroval'\n\n/**\n * Hint for RawStream encoding strategy during SSR serialization.\n * - 'binary': Always use base64 encoding (best for binary data like files, images)\n * - 'text': Try UTF-8 first, fallback to base64 (best for text-heavy data like RSC payloads)\n */\nexport type RawStreamHint = 'binary' | 'text'\n\n/**\n * Options for RawStream configuration.\n */\nexport interface RawStreamOptions {\n  /**\n   * Encoding hint for SSR serialization.\n   * - 'binary' (default): Always use base64 encoding\n   * - 'text': Try UTF-8 first, fallback to base64 for invalid UTF-8 chunks\n   */\n  hint?: RawStreamHint\n}\n\n/**\n * Marker class for ReadableStream<Uint8Array> that should be serialized\n * with base64 encoding (SSR) or binary framing (server functions).\n *\n * Wrap your binary streams with this to get efficient serialization:\n * ```ts\n * // For binary data (files, images, etc.)\n * return { data: new RawStream(file.stream()) }\n *\n * // For text-heavy data (RSC payloads, etc.)\n * return { data: new RawStream(rscStream, { hint: 'text' }) }\n * ```\n */\nexport class RawStream {\n  public readonly hint: RawStreamHint\n\n  constructor(\n    public readonly stream: ReadableStream<Uint8Array>,\n    options?: RawStreamOptions,\n  ) {\n    this.hint = options?.hint ?? 'binary'\n  }\n}\n\n/**\n * Callback type for RPC plugin to register raw streams with multiplexer\n */\nexport type OnRawStreamCallback = (\n  streamId: number,\n  stream: ReadableStream<Uint8Array>,\n) => void\n\n// Base64 helpers used in both Node and browser.\n// In Node-like runtimes, prefer Buffer for speed and compatibility.\nconst BufferCtor: any = (globalThis as any).Buffer\nconst hasNodeBuffer = !!BufferCtor && typeof BufferCtor.from === 'function'\n\nfunction uint8ArrayToBase64(bytes: Uint8Array): string {\n  if (bytes.length === 0) return ''\n\n  if (hasNodeBuffer) {\n    return BufferCtor.from(bytes).toString('base64')\n  }\n\n  // Browser fallback: chunked String.fromCharCode + btoa\n  const CHUNK_SIZE = 0x8000 // 32KB chunks to avoid stack overflow\n  const chunks: Array<string> = []\n  for (let i = 0; i < bytes.length; i += CHUNK_SIZE) {\n    const chunk = bytes.subarray(i, i + CHUNK_SIZE)\n    chunks.push(String.fromCharCode.apply(null, chunk as any))\n  }\n  return btoa(chunks.join(''))\n}\n\nfunction base64ToUint8Array(base64: string): Uint8Array {\n  if (base64.length === 0) return new Uint8Array(0)\n\n  if (hasNodeBuffer) {\n    const buf = BufferCtor.from(base64, 'base64')\n    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength)\n  }\n\n  const binary = atob(base64)\n  const bytes = new Uint8Array(binary.length)\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i)\n  }\n  return bytes\n}\n\n// Factory sentinels - use null-proto objects to avoid prototype surprises\nconst RAW_STREAM_FACTORY_BINARY: Record<string, never> = Object.create(null)\nconst RAW_STREAM_FACTORY_TEXT: Record<string, never> = Object.create(null)\n\n// Factory constructor for binary mode - converts seroval stream to ReadableStream<Uint8Array>\n// All chunks are base64 encoded strings\nconst RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY = (\n  stream: ReturnType<typeof createStream>,\n) =>\n  new ReadableStream<Uint8Array>({\n    start(controller) {\n      stream.on({\n        next(base64: string) {\n          try {\n            controller.enqueue(base64ToUint8Array(base64))\n          } catch {\n            // Stream may be closed\n          }\n        },\n        throw(error: unknown) {\n          controller.error(error)\n        },\n        return() {\n          try {\n            controller.close()\n          } catch {\n            // Stream may already be closed\n          }\n        },\n      })\n    },\n  })\n\n// Factory constructor for text mode - converts seroval stream to ReadableStream<Uint8Array>\n// Chunks are either strings (UTF-8) or { $b64: string } (base64 fallback)\n// Use module-level TextEncoder to avoid per-factory allocation\nconst textEncoderForFactory = new TextEncoder()\nconst RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT = (\n  stream: ReturnType<typeof createStream>,\n) => {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      stream.on({\n        next(value: string | { $b64: string }) {\n          try {\n            if (typeof value === 'string') {\n              controller.enqueue(textEncoderForFactory.encode(value))\n            } else {\n              controller.enqueue(base64ToUint8Array(value.$b64))\n            }\n          } catch {\n            // Stream may be closed\n          }\n        },\n        throw(error: unknown) {\n          controller.error(error)\n        },\n        return() {\n          try {\n            controller.close()\n          } catch {\n            // Stream may already be closed\n          }\n        },\n      })\n    },\n  })\n}\n\n// Minified factory function for binary mode - all chunks are base64 strings\n// This must be self-contained since it's injected into the HTML\nconst FACTORY_BINARY = `(s=>new ReadableStream({start(c){s.on({next(b){try{const d=atob(b),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}catch(_){}},throw(e){c.error(e)},return(){try{c.close()}catch(_){}}})}}))`\n\n// Minified factory function for text mode - chunks are string or {$b64: string}\n// Uses cached TextEncoder for performance\nconst FACTORY_TEXT = `(s=>{const e=new TextEncoder();return new ReadableStream({start(c){s.on({next(v){try{if(typeof v==='string'){c.enqueue(e.encode(v))}else{const d=atob(v.$b64),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}}catch(_){}},throw(x){c.error(x)},return(){try{c.close()}catch(_){}}})}})})`\n\n// Convert ReadableStream<Uint8Array> to seroval stream with base64-encoded chunks (binary mode)\nfunction toBinaryStream(readable: ReadableStream<Uint8Array>) {\n  const stream = createStream()\n  const reader = readable.getReader()\n\n  // Use iterative loop instead of recursive async to avoid stack accumulation\n  ;(async () => {\n    try {\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) {\n          stream.return(undefined)\n          break\n        }\n        stream.next(uint8ArrayToBase64(value))\n      }\n    } catch (error) {\n      stream.throw(error)\n    } finally {\n      reader.releaseLock()\n    }\n  })()\n\n  return stream\n}\n\n// Convert ReadableStream<Uint8Array> to seroval stream with UTF-8 first, base64 fallback (text mode)\nfunction toTextStream(readable: ReadableStream<Uint8Array>) {\n  const stream = createStream()\n  const reader = readable.getReader()\n  const decoder = new TextDecoder('utf-8', { fatal: true })\n\n  // Use iterative loop instead of recursive async to avoid stack accumulation\n  ;(async () => {\n    try {\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) {\n          // Flush any remaining bytes in the decoder\n          try {\n            const remaining = decoder.decode()\n            if (remaining.length > 0) {\n              stream.next(remaining)\n            }\n          } catch {\n            // Ignore decode errors on flush\n          }\n          stream.return(undefined)\n          break\n        }\n\n        try {\n          // Try UTF-8 decode first\n          const text = decoder.decode(value, { stream: true })\n          if (text.length > 0) {\n            stream.next(text)\n          }\n        } catch {\n          // UTF-8 decode failed, fallback to base64\n          stream.next({ $b64: uint8ArrayToBase64(value) })\n        }\n      }\n    } catch (error) {\n      stream.throw(error)\n    } finally {\n      reader.releaseLock()\n    }\n  })()\n\n  return stream\n}\n\n// Factory plugin for binary mode\nconst RawStreamFactoryBinaryPlugin = createPlugin<\n  Record<string, never>,\n  undefined\n>({\n  tag: 'tss/RawStreamFactory',\n  test(value) {\n    return value === RAW_STREAM_FACTORY_BINARY\n  },\n  parse: {\n    sync() {\n      return undefined\n    },\n    async() {\n      return Promise.resolve(undefined)\n    },\n    stream() {\n      return undefined\n    },\n  },\n  serialize() {\n    return FACTORY_BINARY\n  },\n  deserialize() {\n    return RAW_STREAM_FACTORY_BINARY\n  },\n})\n\n// Factory plugin for text mode\nconst RawStreamFactoryTextPlugin = createPlugin<\n  Record<string, never>,\n  undefined\n>({\n  tag: 'tss/RawStreamFactoryText',\n  test(value) {\n    return value === RAW_STREAM_FACTORY_TEXT\n  },\n  parse: {\n    sync() {\n      return undefined\n    },\n    async() {\n      return Promise.resolve(undefined)\n    },\n    stream() {\n      return undefined\n    },\n  },\n  serialize() {\n    return FACTORY_TEXT\n  },\n  deserialize() {\n    return RAW_STREAM_FACTORY_TEXT\n  },\n})\n\n/**\n * SSR Plugin - uses base64 or UTF-8+base64 encoding for chunks, delegates to seroval's stream mechanism.\n * Used during SSR when serializing to JavaScript code for HTML injection.\n *\n * Supports two modes based on RawStream hint:\n * - 'binary': Always base64 encode (default)\n * - 'text': Try UTF-8 first, fallback to base64 for invalid UTF-8\n */\nexport const RawStreamSSRPlugin: Plugin<any, any> = createPlugin({\n  tag: 'tss/RawStream',\n  extends: [RawStreamFactoryBinaryPlugin, RawStreamFactoryTextPlugin],\n\n  test(value: unknown) {\n    return value instanceof RawStream\n  },\n\n  parse: {\n    sync(value: RawStream, ctx) {\n      // Sync parse not really supported for streams, return empty stream\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      return {\n        hint: value.hint,\n        factory: ctx.parse(factory),\n        stream: ctx.parse(createStream()),\n      }\n    },\n    async async(value: RawStream, ctx) {\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      const encodedStream =\n        value.hint === 'text'\n          ? toTextStream(value.stream)\n          : toBinaryStream(value.stream)\n      return {\n        hint: value.hint,\n        factory: await ctx.parse(factory),\n        stream: await ctx.parse(encodedStream),\n      }\n    },\n    stream(value: RawStream, ctx) {\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      const encodedStream =\n        value.hint === 'text'\n          ? toTextStream(value.stream)\n          : toBinaryStream(value.stream)\n      return {\n        hint: value.hint,\n        factory: ctx.parse(factory),\n        stream: ctx.parse(encodedStream),\n      }\n    },\n  },\n\n  serialize(node: { hint: RawStreamHint; factory: any; stream: any }, ctx) {\n    return (\n      '(' +\n      ctx.serialize(node.factory) +\n      ')(' +\n      ctx.serialize(node.stream) +\n      ')'\n    )\n  },\n\n  deserialize(\n    node: { hint: RawStreamHint; factory: any; stream: any },\n    ctx,\n  ): any {\n    const stream: ReturnType<typeof createStream> = ctx.deserialize(node.stream)\n    return node.hint === 'text'\n      ? RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT(stream)\n      : RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY(stream)\n  },\n}) as Plugin<any, any>\n\n/**\n * Node type for RPC plugin serialization\n */\ninterface RawStreamRPCNode {\n  streamId: number\n}\n\n/**\n * Creates an RPC plugin instance that registers raw streams with a multiplexer.\n * Used for server function responses where we want binary framing.\n * Note: RPC always uses binary framing regardless of hint.\n *\n * @param onRawStream Callback invoked when a RawStream is encountered during serialization\n */\nexport function createRawStreamRPCPlugin(\n  onRawStream: OnRawStreamCallback,\n): Plugin<any, any> {\n  // Own stream counter - sequential IDs starting at 1, independent of seroval internals\n  let nextStreamId = 1\n\n  return createPlugin({\n    tag: 'tss/RawStream',\n\n    test(value: unknown) {\n      return value instanceof RawStream\n    },\n\n    parse: {\n      async(value: RawStream) {\n        const streamId = nextStreamId++\n        onRawStream(streamId, value.stream)\n        return Promise.resolve({ streamId })\n      },\n      stream(value: RawStream) {\n        const streamId = nextStreamId++\n        onRawStream(streamId, value.stream)\n        return { streamId }\n      },\n    },\n\n    serialize(): never {\n      // RPC uses toCrossJSONStream which produces JSON nodes, not JS code.\n      // This method is only called by crossSerialize* which we don't use.\n      throw new Error(\n        'RawStreamRPCPlugin.serialize should not be called. RPC uses JSON serialization, not JS code generation.',\n      )\n    },\n\n    deserialize(): never {\n      // Client uses createRawStreamDeserializePlugin instead\n      throw new Error(\n        'RawStreamRPCPlugin.deserialize should not be called. Use createRawStreamDeserializePlugin on client.',\n      )\n    },\n  }) as Plugin<any, any>\n}\n\n/**\n * Creates a deserialize-only plugin for client-side stream reconstruction.\n * Used in serverFnFetcher to wire up streams from frame decoder.\n *\n * @param getOrCreateStream Function to get/create a stream by ID from frame decoder\n */\nexport function createRawStreamDeserializePlugin(\n  getOrCreateStream: (id: number) => ReadableStream<Uint8Array>,\n): Plugin<any, any> {\n  return createPlugin({\n    tag: 'tss/RawStream',\n\n    test: () => false, // Client never serializes RawStream\n\n    parse: {}, // Client only deserializes, never parses\n\n    serialize(): never {\n      // Client never serializes RawStream back to server\n      throw new Error(\n        'RawStreamDeserializePlugin.serialize should not be called. Client only deserializes.',\n      )\n    },\n\n    deserialize(node: RawStreamRPCNode) {\n      return getOrCreateStream(node.streamId)\n    },\n  }) as Plugin<any, any>\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"RawStream.js","names":[],"sources":["../../../../src/ssr/serializer/RawStream.ts"],"sourcesContent":["import { createPlugin, createStream } from 'seroval'\nimport type { Plugin } from 'seroval'\n\n/**\n * Hint for RawStream encoding strategy during SSR serialization.\n * - 'binary': Always use base64 encoding (best for binary data like files, images)\n * - 'text': Try UTF-8 first, fallback to base64 (best for text-heavy data like RSC payloads)\n */\nexport type RawStreamHint = 'binary' | 'text'\n\n/**\n * Options for RawStream configuration.\n */\nexport interface RawStreamOptions {\n  /**\n   * Encoding hint for SSR serialization.\n   * - 'binary' (default): Always use base64 encoding\n   * - 'text': Try UTF-8 first, fallback to base64 for invalid UTF-8 chunks\n   */\n  hint?: RawStreamHint\n}\n\n/**\n * Marker class for ReadableStream<Uint8Array> that should be serialized\n * with base64 encoding (SSR) or binary framing (server functions).\n *\n * Wrap your binary streams with this to get efficient serialization:\n * ```ts\n * // For binary data (files, images, etc.)\n * return { data: new RawStream(file.stream()) }\n *\n * // For text-heavy data (RSC payloads, etc.)\n * return { data: new RawStream(rscStream, { hint: 'text' }) }\n * ```\n */\nexport class RawStream {\n  public readonly hint: RawStreamHint\n\n  constructor(\n    public readonly stream: ReadableStream<Uint8Array>,\n    options?: RawStreamOptions,\n  ) {\n    this.hint = options?.hint ?? 'binary'\n  }\n}\n\n/**\n * Callback type for RPC plugin to register raw streams with multiplexer\n */\nexport type OnRawStreamCallback = (\n  streamId: number,\n  stream: ReadableStream<Uint8Array>,\n) => void\n\n// Base64 helpers used in both Node and browser.\n// In Node-like runtimes, prefer Buffer for speed and compatibility.\nconst BufferCtor: any = (globalThis as any).Buffer\nconst hasNodeBuffer = !!BufferCtor && typeof BufferCtor.from === 'function'\n\nfunction uint8ArrayToBase64(bytes: Uint8Array): string {\n  if (bytes.length === 0) return ''\n\n  if (hasNodeBuffer) {\n    return BufferCtor.from(bytes).toString('base64')\n  }\n\n  // Browser fallback: chunked String.fromCharCode + btoa\n  const CHUNK_SIZE = 0x8000 // 32KB chunks to avoid stack overflow\n  const chunks: Array<string> = []\n  for (let i = 0; i < bytes.length; i += CHUNK_SIZE) {\n    const chunk = bytes.subarray(i, i + CHUNK_SIZE)\n    chunks.push(String.fromCharCode.apply(null, chunk as any))\n  }\n  return btoa(chunks.join(''))\n}\n\nfunction base64ToUint8Array(base64: string): Uint8Array {\n  if (base64.length === 0) return new Uint8Array(0)\n\n  if (hasNodeBuffer) {\n    const buf = BufferCtor.from(base64, 'base64')\n    return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength)\n  }\n\n  const binary = atob(base64)\n  const bytes = new Uint8Array(binary.length)\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i)\n  }\n  return bytes\n}\n\n// Factory sentinels - use null-proto objects to avoid prototype surprises\nconst RAW_STREAM_FACTORY_BINARY: Record<string, never> = Object.create(null)\nconst RAW_STREAM_FACTORY_TEXT: Record<string, never> = Object.create(null)\n\n// Factory constructor for binary mode - converts seroval stream to ReadableStream<Uint8Array>\n// All chunks are base64 encoded strings\nconst RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY = (\n  stream: ReturnType<typeof createStream>,\n) =>\n  new ReadableStream<Uint8Array>({\n    start(controller) {\n      stream.on({\n        next(base64: string) {\n          try {\n            controller.enqueue(base64ToUint8Array(base64))\n          } catch {\n            // Stream may be closed\n          }\n        },\n        throw(error: unknown) {\n          controller.error(error)\n        },\n        return() {\n          try {\n            controller.close()\n          } catch {\n            // Stream may already be closed\n          }\n        },\n      })\n    },\n  })\n\n// Factory constructor for text mode - converts seroval stream to ReadableStream<Uint8Array>\n// Chunks are either strings (UTF-8) or { $b64: string } (base64 fallback)\n// Use module-level TextEncoder to avoid per-factory allocation\nconst textEncoderForFactory = new TextEncoder()\nconst RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT = (\n  stream: ReturnType<typeof createStream>,\n) => {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      stream.on({\n        next(value: string | { $b64: string }) {\n          try {\n            if (typeof value === 'string') {\n              controller.enqueue(textEncoderForFactory.encode(value))\n            } else {\n              controller.enqueue(base64ToUint8Array(value.$b64))\n            }\n          } catch {\n            // Stream may be closed\n          }\n        },\n        throw(error: unknown) {\n          controller.error(error)\n        },\n        return() {\n          try {\n            controller.close()\n          } catch {\n            // Stream may already be closed\n          }\n        },\n      })\n    },\n  })\n}\n\n// Minified factory function for binary mode - all chunks are base64 strings\n// This must be self-contained since it's injected into the HTML\nconst FACTORY_BINARY = `(s=>new ReadableStream({start(c){s.on({next(b){try{const d=atob(b),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}catch(_){}},throw(e){c.error(e)},return(){try{c.close()}catch(_){}}})}}))`\n\n// Minified factory function for text mode - chunks are string or {$b64: string}\n// Uses cached TextEncoder for performance\nconst FACTORY_TEXT = `(s=>{const e=new TextEncoder();return new ReadableStream({start(c){s.on({next(v){try{if(typeof v==='string'){c.enqueue(e.encode(v))}else{const d=atob(v.$b64),a=new Uint8Array(d.length);for(let i=0;i<d.length;i++)a[i]=d.charCodeAt(i);c.enqueue(a)}}catch(_){}},throw(x){c.error(x)},return(){try{c.close()}catch(_){}}})}})})`\n\n// Convert ReadableStream<Uint8Array> to seroval stream with base64-encoded chunks (binary mode)\nfunction toBinaryStream(readable: ReadableStream<Uint8Array>) {\n  const stream = createStream()\n  const reader = readable.getReader()\n\n  // Use iterative loop instead of recursive async to avoid stack accumulation\n  ;(async () => {\n    try {\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) {\n          stream.return(undefined)\n          break\n        }\n        stream.next(uint8ArrayToBase64(value))\n      }\n    } catch (error) {\n      stream.throw(error)\n    } finally {\n      reader.releaseLock()\n    }\n  })()\n\n  return stream\n}\n\n// Convert ReadableStream<Uint8Array> to seroval stream with UTF-8 first, base64 fallback (text mode)\nfunction toTextStream(readable: ReadableStream<Uint8Array>) {\n  const stream = createStream()\n  const reader = readable.getReader()\n  const decoder = new TextDecoder('utf-8', { fatal: true })\n\n  // Use iterative loop instead of recursive async to avoid stack accumulation\n  ;(async () => {\n    try {\n      while (true) {\n        const { done, value } = await reader.read()\n        if (done) {\n          // Flush any remaining bytes in the decoder\n          try {\n            const remaining = decoder.decode()\n            if (remaining.length > 0) {\n              stream.next(remaining)\n            }\n          } catch {\n            // Ignore decode errors on flush\n          }\n          stream.return(undefined)\n          break\n        }\n\n        try {\n          // Try UTF-8 decode first\n          const text = decoder.decode(value, { stream: true })\n          if (text.length > 0) {\n            stream.next(text)\n          }\n        } catch {\n          // UTF-8 decode failed, fallback to base64\n          stream.next({ $b64: uint8ArrayToBase64(value) })\n        }\n      }\n    } catch (error) {\n      stream.throw(error)\n    } finally {\n      reader.releaseLock()\n    }\n  })()\n\n  return stream\n}\n\n// Factory plugin for binary mode\nconst RawStreamFactoryBinaryPlugin = createPlugin<\n  Record<string, never>,\n  undefined\n>({\n  tag: 'tss/RawStreamFactory',\n  test(value) {\n    return value === RAW_STREAM_FACTORY_BINARY\n  },\n  parse: {\n    sync() {\n      return undefined\n    },\n    async() {\n      return Promise.resolve(undefined)\n    },\n    stream() {\n      return undefined\n    },\n  },\n  serialize() {\n    return FACTORY_BINARY\n  },\n  deserialize() {\n    return RAW_STREAM_FACTORY_BINARY\n  },\n})\n\n// Factory plugin for text mode\nconst RawStreamFactoryTextPlugin = createPlugin<\n  Record<string, never>,\n  undefined\n>({\n  tag: 'tss/RawStreamFactoryText',\n  test(value) {\n    return value === RAW_STREAM_FACTORY_TEXT\n  },\n  parse: {\n    sync() {\n      return undefined\n    },\n    async() {\n      return Promise.resolve(undefined)\n    },\n    stream() {\n      return undefined\n    },\n  },\n  serialize() {\n    return FACTORY_TEXT\n  },\n  deserialize() {\n    return RAW_STREAM_FACTORY_TEXT\n  },\n})\n\n/**\n * SSR Plugin - uses base64 or UTF-8+base64 encoding for chunks, delegates to seroval's stream mechanism.\n * Used during SSR when serializing to JavaScript code for HTML injection.\n *\n * Supports two modes based on RawStream hint:\n * - 'binary': Always base64 encode (default)\n * - 'text': Try UTF-8 first, fallback to base64 for invalid UTF-8\n */\nexport const RawStreamSSRPlugin: Plugin<any, any> = createPlugin({\n  tag: 'tss/RawStream',\n  extends: [RawStreamFactoryBinaryPlugin, RawStreamFactoryTextPlugin],\n\n  test(value: unknown) {\n    return value instanceof RawStream\n  },\n\n  parse: {\n    sync(value: RawStream, ctx) {\n      // Sync parse not really supported for streams, return empty stream\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      return {\n        hint: value.hint,\n        factory: ctx.parse(factory),\n        stream: ctx.parse(createStream()),\n      }\n    },\n    async async(value: RawStream, ctx) {\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      const encodedStream =\n        value.hint === 'text'\n          ? toTextStream(value.stream)\n          : toBinaryStream(value.stream)\n      return {\n        hint: value.hint,\n        factory: await ctx.parse(factory),\n        stream: await ctx.parse(encodedStream),\n      }\n    },\n    stream(value: RawStream, ctx) {\n      const factory =\n        value.hint === 'text'\n          ? RAW_STREAM_FACTORY_TEXT\n          : RAW_STREAM_FACTORY_BINARY\n      const encodedStream =\n        value.hint === 'text'\n          ? toTextStream(value.stream)\n          : toBinaryStream(value.stream)\n      return {\n        hint: value.hint,\n        factory: ctx.parse(factory),\n        stream: ctx.parse(encodedStream),\n      }\n    },\n  },\n\n  serialize(node: { hint: RawStreamHint; factory: any; stream: any }, ctx) {\n    return (\n      '(' +\n      ctx.serialize(node.factory) +\n      ')(' +\n      ctx.serialize(node.stream) +\n      ')'\n    )\n  },\n\n  deserialize(\n    node: { hint: RawStreamHint; factory: any; stream: any },\n    ctx,\n  ): any {\n    const stream: ReturnType<typeof createStream> = ctx.deserialize(node.stream)\n    return node.hint === 'text'\n      ? RAW_STREAM_FACTORY_CONSTRUCTOR_TEXT(stream)\n      : RAW_STREAM_FACTORY_CONSTRUCTOR_BINARY(stream)\n  },\n}) as Plugin<any, any>\n\n/**\n * Node type for RPC plugin serialization\n */\ninterface RawStreamRPCNode {\n  streamId: number\n}\n\n/**\n * Creates an RPC plugin instance that registers raw streams with a multiplexer.\n * Used for server function responses where we want binary framing.\n * Note: RPC always uses binary framing regardless of hint.\n *\n * @param onRawStream Callback invoked when a RawStream is encountered during serialization\n */\nexport function createRawStreamRPCPlugin(\n  onRawStream: OnRawStreamCallback,\n): Plugin<any, any> {\n  // Own stream counter - sequential IDs starting at 1, independent of seroval internals\n  let nextStreamId = 1\n\n  return createPlugin({\n    tag: 'tss/RawStream',\n\n    test(value: unknown) {\n      return value instanceof RawStream\n    },\n\n    parse: {\n      async(value: RawStream) {\n        const streamId = nextStreamId++\n        onRawStream(streamId, value.stream)\n        return Promise.resolve({ streamId })\n      },\n      stream(value: RawStream) {\n        const streamId = nextStreamId++\n        onRawStream(streamId, value.stream)\n        return { streamId }\n      },\n    },\n\n    serialize(): never {\n      // RPC uses toCrossJSONStream which produces JSON nodes, not JS code.\n      // This method is only called by crossSerialize* which we don't use.\n      throw new Error(\n        'RawStreamRPCPlugin.serialize should not be called. RPC uses JSON serialization, not JS code generation.',\n      )\n    },\n\n    deserialize(): never {\n      // Client uses createRawStreamDeserializePlugin instead\n      throw new Error(\n        'RawStreamRPCPlugin.deserialize should not be called. Use createRawStreamDeserializePlugin on client.',\n      )\n    },\n  }) as Plugin<any, any>\n}\n\n/**\n * Creates a deserialize-only plugin for client-side stream reconstruction.\n * Used in serverFnFetcher to wire up streams from frame decoder.\n *\n * @param getOrCreateStream Function to get/create a stream by ID from frame decoder\n */\nexport function createRawStreamDeserializePlugin(\n  getOrCreateStream: (id: number) => ReadableStream<Uint8Array>,\n): Plugin<any, any> {\n  return createPlugin({\n    tag: 'tss/RawStream',\n\n    test: () => false, // Client never serializes RawStream\n\n    parse: {}, // Client only deserializes, never parses\n\n    serialize(): never {\n      // Client never serializes RawStream back to server\n      throw new Error(\n        'RawStreamDeserializePlugin.serialize should not be called. Client only deserializes.',\n      )\n    },\n\n    deserialize(node: RawStreamRPCNode) {\n      return getOrCreateStream(node.streamId)\n    },\n  }) as Plugin<any, any>\n}\n"],"mappings":"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"}