@flight-framework/core 0.0.3 → 0.1.0
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.
- package/dist/{chunk-CLMFEKYM.js → chunk-54HPVE7N.js} +67 -2
- package/dist/chunk-54HPVE7N.js.map +1 -0
- package/dist/{chunk-ABNCAPQB.js → chunk-6WSPUG5L.js} +2 -2
- package/dist/chunk-6WSPUG5L.js.map +1 -0
- package/dist/chunk-I2B4WSHC.js +126 -0
- package/dist/chunk-I2B4WSHC.js.map +1 -0
- package/dist/chunk-MQQLYWZZ.js +288 -0
- package/dist/chunk-MQQLYWZZ.js.map +1 -0
- package/dist/chunk-OBNYNJB5.js +353 -0
- package/dist/chunk-OBNYNJB5.js.map +1 -0
- package/dist/chunk-WFAWAHJH.js +267 -0
- package/dist/chunk-WFAWAHJH.js.map +1 -0
- package/dist/chunk-XOIYNY4I.js +164 -0
- package/dist/chunk-XOIYNY4I.js.map +1 -0
- package/dist/chunk-YIOQC3DC.js +282 -0
- package/dist/chunk-YIOQC3DC.js.map +1 -0
- package/dist/file-router/index.d.ts +9 -0
- package/dist/file-router/index.js +1 -1
- package/dist/file-router/streaming-hints.d.ts +129 -0
- package/dist/file-router/streaming-hints.js +3 -0
- package/dist/file-router/streaming-hints.js.map +1 -0
- package/dist/index.d.ts +6 -0
- package/dist/index.js +10 -4
- package/dist/index.js.map +1 -1
- package/dist/islands/index.d.ts +234 -0
- package/dist/islands/index.js +3 -0
- package/dist/islands/index.js.map +1 -0
- package/dist/streaming/adapters/index.d.ts +223 -0
- package/dist/streaming/adapters/index.js +3 -0
- package/dist/streaming/adapters/index.js.map +1 -0
- package/dist/streaming/conditional.d.ts +130 -0
- package/dist/streaming/conditional.js +3 -0
- package/dist/streaming/conditional.js.map +1 -0
- package/dist/streaming/index.d.ts +8 -0
- package/dist/streaming/index.js +1 -1
- package/dist/streaming/observability.d.ts +201 -0
- package/dist/streaming/observability.js +4 -0
- package/dist/streaming/observability.js.map +1 -0
- package/dist/streaming/priority.d.ts +103 -0
- package/dist/streaming/priority.js +3 -0
- package/dist/streaming/priority.js.map +1 -0
- package/package.json +25 -1
- package/dist/chunk-ABNCAPQB.js.map +0 -1
- package/dist/chunk-CLMFEKYM.js.map +0 -1
|
@@ -0,0 +1,288 @@
|
|
|
1
|
+
// src/streaming/adapters/index.ts
|
|
2
|
+
function createReactStreamAdapter(options) {
|
|
3
|
+
if (!options.renderToReadableStream) {
|
|
4
|
+
throw new Error(
|
|
5
|
+
"[Flight] createReactStreamAdapter requires renderToReadableStream. Import it from react-dom/server and pass it in options."
|
|
6
|
+
);
|
|
7
|
+
}
|
|
8
|
+
return {
|
|
9
|
+
name: "react",
|
|
10
|
+
framework: "react@18+",
|
|
11
|
+
runtime: "edge",
|
|
12
|
+
async stream(component, streamOptions = {}) {
|
|
13
|
+
const mergedOptions = { ...options, ...streamOptions };
|
|
14
|
+
let resolveShell;
|
|
15
|
+
let resolveAll;
|
|
16
|
+
const shellReady = new Promise((r) => {
|
|
17
|
+
resolveShell = r;
|
|
18
|
+
});
|
|
19
|
+
const allReady = new Promise((r) => {
|
|
20
|
+
resolveAll = r;
|
|
21
|
+
});
|
|
22
|
+
const stream = await options.renderToReadableStream(component, {
|
|
23
|
+
bootstrapScripts: mergedOptions.bootstrapScripts,
|
|
24
|
+
bootstrapModules: mergedOptions.bootstrapModules,
|
|
25
|
+
identifierPrefix: mergedOptions.identifierPrefix,
|
|
26
|
+
signal: mergedOptions.signal,
|
|
27
|
+
onError: (error) => {
|
|
28
|
+
mergedOptions.onError?.(error);
|
|
29
|
+
}
|
|
30
|
+
});
|
|
31
|
+
resolveShell();
|
|
32
|
+
mergedOptions.onShellReady?.();
|
|
33
|
+
stream.allReady.then(() => {
|
|
34
|
+
resolveAll();
|
|
35
|
+
mergedOptions.onAllReady?.();
|
|
36
|
+
});
|
|
37
|
+
return {
|
|
38
|
+
stream,
|
|
39
|
+
abort: () => {
|
|
40
|
+
},
|
|
41
|
+
shellReady,
|
|
42
|
+
allReady
|
|
43
|
+
};
|
|
44
|
+
},
|
|
45
|
+
async renderToString(component) {
|
|
46
|
+
if (!options.renderToString) {
|
|
47
|
+
throw new Error("[Flight] renderToString not provided to adapter");
|
|
48
|
+
}
|
|
49
|
+
return options.renderToString(component);
|
|
50
|
+
}
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
function createVueStreamAdapter(options) {
|
|
54
|
+
if (!options.renderToWebStream) {
|
|
55
|
+
throw new Error(
|
|
56
|
+
"[Flight] createVueStreamAdapter requires renderToWebStream. Import it from vue/server-renderer and pass it in options."
|
|
57
|
+
);
|
|
58
|
+
}
|
|
59
|
+
return {
|
|
60
|
+
name: "vue",
|
|
61
|
+
framework: "vue@3+",
|
|
62
|
+
runtime: "universal",
|
|
63
|
+
async stream(app, streamOptions = {}) {
|
|
64
|
+
const mergedOptions = { ...options, ...streamOptions };
|
|
65
|
+
let resolveShell;
|
|
66
|
+
let resolveAll;
|
|
67
|
+
const shellReady = new Promise((r) => {
|
|
68
|
+
resolveShell = r;
|
|
69
|
+
});
|
|
70
|
+
const allReady = new Promise((r) => {
|
|
71
|
+
resolveAll = r;
|
|
72
|
+
});
|
|
73
|
+
try {
|
|
74
|
+
const stream = options.renderToWebStream(app, mergedOptions.context);
|
|
75
|
+
resolveShell();
|
|
76
|
+
mergedOptions.onShellReady?.();
|
|
77
|
+
const reader = stream.getReader();
|
|
78
|
+
const wrappedStream = new ReadableStream({
|
|
79
|
+
async pull(controller) {
|
|
80
|
+
const { done, value } = await reader.read();
|
|
81
|
+
if (done) {
|
|
82
|
+
resolveAll();
|
|
83
|
+
mergedOptions.onAllReady?.();
|
|
84
|
+
controller.close();
|
|
85
|
+
} else {
|
|
86
|
+
controller.enqueue(value);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
});
|
|
90
|
+
return {
|
|
91
|
+
stream: wrappedStream,
|
|
92
|
+
abort: () => reader.cancel(),
|
|
93
|
+
shellReady,
|
|
94
|
+
allReady
|
|
95
|
+
};
|
|
96
|
+
} catch (error) {
|
|
97
|
+
mergedOptions.onError?.(error);
|
|
98
|
+
throw error;
|
|
99
|
+
}
|
|
100
|
+
},
|
|
101
|
+
async renderToString(app) {
|
|
102
|
+
if (!options.renderToString) {
|
|
103
|
+
throw new Error("[Flight] renderToString not provided to adapter");
|
|
104
|
+
}
|
|
105
|
+
return options.renderToString(app);
|
|
106
|
+
}
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
function createSolidStreamAdapter(options) {
|
|
110
|
+
if (!options.renderToStream) {
|
|
111
|
+
throw new Error(
|
|
112
|
+
"[Flight] createSolidStreamAdapter requires renderToStream. Import it from solid-js/web and pass it in options."
|
|
113
|
+
);
|
|
114
|
+
}
|
|
115
|
+
return {
|
|
116
|
+
name: "solid",
|
|
117
|
+
framework: "solid-js@1+",
|
|
118
|
+
runtime: "universal",
|
|
119
|
+
async stream(component, streamOptions = {}) {
|
|
120
|
+
const mergedOptions = { ...options, ...streamOptions };
|
|
121
|
+
let resolveShell;
|
|
122
|
+
let resolveAll;
|
|
123
|
+
const shellReady = new Promise((r) => {
|
|
124
|
+
resolveShell = r;
|
|
125
|
+
});
|
|
126
|
+
const allReady = new Promise((r) => {
|
|
127
|
+
resolveAll = r;
|
|
128
|
+
});
|
|
129
|
+
try {
|
|
130
|
+
const { readable, writable } = new TransformStream();
|
|
131
|
+
const result = options.renderToStream(component, {
|
|
132
|
+
nonce: mergedOptions.nonce,
|
|
133
|
+
onCompleteShell: () => {
|
|
134
|
+
resolveShell();
|
|
135
|
+
mergedOptions.onShellReady?.();
|
|
136
|
+
},
|
|
137
|
+
onCompleteAll: () => {
|
|
138
|
+
resolveAll();
|
|
139
|
+
mergedOptions.onAllReady?.();
|
|
140
|
+
}
|
|
141
|
+
});
|
|
142
|
+
result.pipeTo(writable);
|
|
143
|
+
return {
|
|
144
|
+
stream: readable,
|
|
145
|
+
abort: () => writable.abort(),
|
|
146
|
+
shellReady,
|
|
147
|
+
allReady
|
|
148
|
+
};
|
|
149
|
+
} catch (error) {
|
|
150
|
+
mergedOptions.onError?.(error);
|
|
151
|
+
throw error;
|
|
152
|
+
}
|
|
153
|
+
},
|
|
154
|
+
async renderToString(component) {
|
|
155
|
+
if (!options.renderToString) {
|
|
156
|
+
throw new Error("[Flight] renderToString not provided to adapter");
|
|
157
|
+
}
|
|
158
|
+
return options.renderToString(component);
|
|
159
|
+
}
|
|
160
|
+
};
|
|
161
|
+
}
|
|
162
|
+
function createSvelteStreamAdapter(options) {
|
|
163
|
+
if (!options.render) {
|
|
164
|
+
throw new Error(
|
|
165
|
+
"[Flight] createSvelteStreamAdapter requires render. Import it from svelte/server and pass it in options."
|
|
166
|
+
);
|
|
167
|
+
}
|
|
168
|
+
return {
|
|
169
|
+
name: "svelte",
|
|
170
|
+
framework: "svelte@5+",
|
|
171
|
+
runtime: "universal",
|
|
172
|
+
async stream(component, streamOptions = {}) {
|
|
173
|
+
const mergedOptions = { ...options, ...streamOptions };
|
|
174
|
+
let resolveShell;
|
|
175
|
+
let resolveAll;
|
|
176
|
+
const shellReady = new Promise((r) => {
|
|
177
|
+
resolveShell = r;
|
|
178
|
+
});
|
|
179
|
+
const allReady = new Promise((r) => {
|
|
180
|
+
resolveAll = r;
|
|
181
|
+
});
|
|
182
|
+
try {
|
|
183
|
+
const result = options.render(component, { props: mergedOptions.props || {} });
|
|
184
|
+
const html = result.body;
|
|
185
|
+
const encoder = new TextEncoder();
|
|
186
|
+
const stream = new ReadableStream({
|
|
187
|
+
start(controller) {
|
|
188
|
+
if (result.head) {
|
|
189
|
+
controller.enqueue(encoder.encode(result.head));
|
|
190
|
+
}
|
|
191
|
+
resolveShell();
|
|
192
|
+
mergedOptions.onShellReady?.();
|
|
193
|
+
controller.enqueue(encoder.encode(html));
|
|
194
|
+
resolveAll();
|
|
195
|
+
mergedOptions.onAllReady?.();
|
|
196
|
+
controller.close();
|
|
197
|
+
}
|
|
198
|
+
});
|
|
199
|
+
return {
|
|
200
|
+
stream,
|
|
201
|
+
abort: () => {
|
|
202
|
+
},
|
|
203
|
+
shellReady,
|
|
204
|
+
allReady
|
|
205
|
+
};
|
|
206
|
+
} catch (error) {
|
|
207
|
+
mergedOptions.onError?.(error);
|
|
208
|
+
throw error;
|
|
209
|
+
}
|
|
210
|
+
},
|
|
211
|
+
async renderToString(component) {
|
|
212
|
+
const result = options.render(component, { props: options?.props || {} });
|
|
213
|
+
return result.body;
|
|
214
|
+
}
|
|
215
|
+
};
|
|
216
|
+
}
|
|
217
|
+
function createHTMXStreamAdapter(options) {
|
|
218
|
+
return {
|
|
219
|
+
name: "htmx",
|
|
220
|
+
framework: "htmx@2+",
|
|
221
|
+
runtime: "universal",
|
|
222
|
+
async stream(htmlChunks, streamOptions = {}) {
|
|
223
|
+
const mergedOptions = { ...options, ...streamOptions };
|
|
224
|
+
const eventName = mergedOptions.eventName || "message";
|
|
225
|
+
const retryMs = mergedOptions.retryMs || 3e3;
|
|
226
|
+
let resolveShell;
|
|
227
|
+
let resolveAll;
|
|
228
|
+
const shellReady = new Promise((r) => {
|
|
229
|
+
resolveShell = r;
|
|
230
|
+
});
|
|
231
|
+
const allReady = new Promise((r) => {
|
|
232
|
+
resolveAll = r;
|
|
233
|
+
});
|
|
234
|
+
const encoder = new TextEncoder();
|
|
235
|
+
let chunkIndex = 0;
|
|
236
|
+
const stream = new ReadableStream({
|
|
237
|
+
start(controller) {
|
|
238
|
+
controller.enqueue(encoder.encode(`retry: ${retryMs}
|
|
239
|
+
|
|
240
|
+
`));
|
|
241
|
+
resolveShell();
|
|
242
|
+
mergedOptions.onShellReady?.();
|
|
243
|
+
},
|
|
244
|
+
async pull(controller) {
|
|
245
|
+
if (chunkIndex >= htmlChunks.length) {
|
|
246
|
+
resolveAll();
|
|
247
|
+
mergedOptions.onAllReady?.();
|
|
248
|
+
controller.close();
|
|
249
|
+
return;
|
|
250
|
+
}
|
|
251
|
+
const chunk = htmlChunks[chunkIndex++];
|
|
252
|
+
const sseData = `event: ${eventName}
|
|
253
|
+
data: ${JSON.stringify(chunk)}
|
|
254
|
+
|
|
255
|
+
`;
|
|
256
|
+
controller.enqueue(encoder.encode(sseData));
|
|
257
|
+
}
|
|
258
|
+
});
|
|
259
|
+
return {
|
|
260
|
+
stream,
|
|
261
|
+
abort: () => {
|
|
262
|
+
},
|
|
263
|
+
shellReady,
|
|
264
|
+
allReady
|
|
265
|
+
};
|
|
266
|
+
}
|
|
267
|
+
};
|
|
268
|
+
}
|
|
269
|
+
function createStreamAdapter(framework, options) {
|
|
270
|
+
switch (framework) {
|
|
271
|
+
case "react":
|
|
272
|
+
return createReactStreamAdapter(options);
|
|
273
|
+
case "vue":
|
|
274
|
+
return createVueStreamAdapter(options);
|
|
275
|
+
case "solid":
|
|
276
|
+
return createSolidStreamAdapter(options);
|
|
277
|
+
case "svelte":
|
|
278
|
+
return createSvelteStreamAdapter(options);
|
|
279
|
+
case "htmx":
|
|
280
|
+
return createHTMXStreamAdapter(options);
|
|
281
|
+
default:
|
|
282
|
+
throw new Error(`[Flight] Unknown framework: ${framework}`);
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
export { createHTMXStreamAdapter, createReactStreamAdapter, createSolidStreamAdapter, createStreamAdapter, createSvelteStreamAdapter, createVueStreamAdapter };
|
|
287
|
+
//# sourceMappingURL=chunk-MQQLYWZZ.js.map
|
|
288
|
+
//# sourceMappingURL=chunk-MQQLYWZZ.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/streaming/adapters/index.ts"],"names":[],"mappings":";AAsHO,SAAS,yBAAyB,OAAA,EAAgD;AACrF,EAAA,IAAI,CAAC,QAAQ,sBAAA,EAAwB;AACjC,IAAA,MAAM,IAAI,KAAA;AAAA,MACN;AAAA,KAEJ;AAAA,EACJ;AAEA,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,OAAA;AAAA,IACN,SAAA,EAAW,WAAA;AAAA,IACX,OAAA,EAAS,MAAA;AAAA,IAET,MAAM,MAAA,CAAO,SAAA,EAAW,aAAA,GAAgB,EAAC,EAAG;AACxC,MAAA,MAAM,aAAA,GAAgB,EAAE,GAAG,OAAA,EAAS,GAAG,aAAA,EAAc;AAErD,MAAA,IAAI,YAAA;AACJ,MAAA,IAAI,UAAA;AACJ,MAAA,MAAM,UAAA,GAAa,IAAI,OAAA,CAAc,CAAC,CAAA,KAAM;AAAE,QAAA,YAAA,GAAe,CAAA;AAAA,MAAG,CAAC,CAAA;AACjE,MAAA,MAAM,QAAA,GAAW,IAAI,OAAA,CAAc,CAAC,CAAA,KAAM;AAAE,QAAA,UAAA,GAAa,CAAA;AAAA,MAAG,CAAC,CAAA;AAE7D,MAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,sBAAA,CAAwB,SAAA,EAAW;AAAA,QAC5D,kBAAkB,aAAA,CAAc,gBAAA;AAAA,QAChC,kBAAkB,aAAA,CAAc,gBAAA;AAAA,QAChC,kBAAkB,aAAA,CAAc,gBAAA;AAAA,QAChC,QAAQ,aAAA,CAAc,MAAA;AAAA,QACtB,OAAA,EAAS,CAAC,KAAA,KAAmB;AACzB,UAAA,aAAA,CAAc,UAAU,KAAc,CAAA;AAAA,QAC1C;AAAA,OACH,CAAA;AAGD,MAAA,YAAA,EAAc;AACd,MAAA,aAAA,CAAc,YAAA,IAAe;AAG7B,MAAA,MAAA,CAAO,QAAA,CAAS,KAAK,MAAM;AACvB,QAAA,UAAA,EAAY;AACZ,QAAA,aAAA,CAAc,UAAA,IAAa;AAAA,MAC/B,CAAC,CAAA;AAED,MAAA,OAAO;AAAA,QACH,MAAA;AAAA,QACA,OAAO,MAAM;AAAA,QAAwC,CAAA;AAAA,QACrD,UAAA;AAAA,QACA;AAAA,OACJ;AAAA,IACJ,CAAA;AAAA,IAEA,MAAM,eAAe,SAAA,EAAW;AAC5B,MAAA,IAAI,CAAC,QAAQ,cAAA,EAAgB;AACzB,QAAA,MAAM,IAAI,MAAM,iDAAiD,CAAA;AAAA,MACrE;AACA,MAAA,OAAO,OAAA,CAAQ,eAAe,SAAS,CAAA;AAAA,IAC3C;AAAA,GACJ;AACJ;AAiCO,SAAS,uBAAuB,OAAA,EAA8C;AACjF,EAAA,IAAI,CAAC,QAAQ,iBAAA,EAAmB;AAC5B,IAAA,MAAM,IAAI,KAAA;AAAA,MACN;AAAA,KAEJ;AAAA,EACJ;AAEA,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,KAAA;AAAA,IACN,SAAA,EAAW,QAAA;AAAA,IACX,OAAA,EAAS,WAAA;AAAA,IAET,MAAM,MAAA,CAAO,GAAA,EAAK,aAAA,GAAgB,EAAC,EAAG;AAClC,MAAA,MAAM,aAAA,GAAgB,EAAE,GAAG,OAAA,EAAS,GAAG,aAAA,EAAc;AAErD,MAAA,IAAI,YAAA;AACJ,MAAA,IAAI,UAAA;AACJ,MAAA,MAAM,UAAA,GAAa,IAAI,OAAA,CAAc,CAAC,CAAA,KAAM;AAAE,QAAA,YAAA,GAAe,CAAA;AAAA,MAAG,CAAC,CAAA;AACjE,MAAA,MAAM,QAAA,GAAW,IAAI,OAAA,CAAc,CAAC,CAAA,KAAM;AAAE,QAAA,UAAA,GAAa,CAAA;AAAA,MAAG,CAAC,CAAA;AAE7D,MAAA,IAAI;AACA,QAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,iBAAA,CAAmB,GAAA,EAAK,cAAc,OAAO,CAAA;AAGpE,QAAA,YAAA,EAAc;AACd,QAAA,aAAA,CAAc,YAAA,IAAe;AAG7B,QAAA,MAAM,MAAA,GAAS,OAAO,SAAA,EAAU;AAEhC,QAAA,MAAM,aAAA,GAAgB,IAAI,cAAA,CAA2B;AAAA,UACjD,MAAM,KAAK,UAAA,EAAY;AACnB,YAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,YAAA,IAAI,IAAA,EAAM;AACN,cAAA,UAAA,EAAY;AACZ,cAAA,aAAA,CAAc,UAAA,IAAa;AAC3B,cAAA,UAAA,CAAW,KAAA,EAAM;AAAA,YACrB,CAAA,MAAO;AACH,cAAA,UAAA,CAAW,QAAQ,KAAK,CAAA;AAAA,YAC5B;AAAA,UACJ;AAAA,SACH,CAAA;AAED,QAAA,OAAO;AAAA,UACH,MAAA,EAAQ,aAAA;AAAA,UACR,KAAA,EAAO,MAAM,MAAA,CAAO,MAAA,EAAO;AAAA,UAC3B,UAAA;AAAA,UACA;AAAA,SACJ;AAAA,MACJ,SAAS,KAAA,EAAO;AACZ,QAAA,aAAA,CAAc,UAAU,KAAc,CAAA;AACtC,QAAA,MAAM,KAAA;AAAA,MACV;AAAA,IACJ,CAAA;AAAA,IAEA,MAAM,eAAe,GAAA,EAAK;AACtB,MAAA,IAAI,CAAC,QAAQ,cAAA,EAAgB;AACzB,QAAA,MAAM,IAAI,MAAM,iDAAiD,CAAA;AAAA,MACrE;AACA,MAAA,OAAO,OAAA,CAAQ,eAAe,GAAG,CAAA;AAAA,IACrC;AAAA,GACJ;AACJ;AAwCO,SAAS,yBAAyB,OAAA,EAAgD;AACrF,EAAA,IAAI,CAAC,QAAQ,cAAA,EAAgB;AACzB,IAAA,MAAM,IAAI,KAAA;AAAA,MACN;AAAA,KAEJ;AAAA,EACJ;AAEA,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,OAAA;AAAA,IACN,SAAA,EAAW,aAAA;AAAA,IACX,OAAA,EAAS,WAAA;AAAA,IAET,MAAM,MAAA,CAAO,SAAA,EAAW,aAAA,GAAgB,EAAC,EAAG;AACxC,MAAA,MAAM,aAAA,GAAgB,EAAE,GAAG,OAAA,EAAS,GAAG,aAAA,EAAc;AAErD,MAAA,IAAI,YAAA;AACJ,MAAA,IAAI,UAAA;AACJ,MAAA,MAAM,UAAA,GAAa,IAAI,OAAA,CAAc,CAAC,CAAA,KAAM;AAAE,QAAA,YAAA,GAAe,CAAA;AAAA,MAAG,CAAC,CAAA;AACjE,MAAA,MAAM,QAAA,GAAW,IAAI,OAAA,CAAc,CAAC,CAAA,KAAM;AAAE,QAAA,UAAA,GAAa,CAAA;AAAA,MAAG,CAAC,CAAA;AAE7D,MAAA,IAAI;AACA,QAAA,MAAM,EAAE,QAAA,EAAU,QAAA,EAAS,GAAI,IAAI,eAAA,EAAwC;AAG3E,QAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,cAAA,CAAgB,SAAA,EAA4B;AAAA,UAC/D,OAAO,aAAA,CAAc,KAAA;AAAA,UACrB,iBAAiB,MAAM;AACnB,YAAA,YAAA,EAAc;AACd,YAAA,aAAA,CAAc,YAAA,IAAe;AAAA,UACjC,CAAA;AAAA,UACA,eAAe,MAAM;AACjB,YAAA,UAAA,EAAY;AACZ,YAAA,aAAA,CAAc,UAAA,IAAa;AAAA,UAC/B;AAAA,SACH,CAAA;AAGD,QAAA,MAAA,CAAO,OAAO,QAAQ,CAAA;AAEtB,QAAA,OAAO;AAAA,UACH,MAAA,EAAQ,QAAA;AAAA,UACR,KAAA,EAAO,MAAM,QAAA,CAAS,KAAA,EAAM;AAAA,UAC5B,UAAA;AAAA,UACA;AAAA,SACJ;AAAA,MACJ,SAAS,KAAA,EAAO;AACZ,QAAA,aAAA,CAAc,UAAU,KAAc,CAAA;AACtC,QAAA,MAAM,KAAA;AAAA,MACV;AAAA,IACJ,CAAA;AAAA,IAEA,MAAM,eAAe,SAAA,EAAW;AAC5B,MAAA,IAAI,CAAC,QAAQ,cAAA,EAAgB;AACzB,QAAA,MAAM,IAAI,MAAM,iDAAiD,CAAA;AAAA,MACrE;AACA,MAAA,OAAO,OAAA,CAAQ,eAAe,SAA0B,CAAA;AAAA,IAC5D;AAAA,GACJ;AACJ;AAmCO,SAAS,0BAA0B,OAAA,EAAiD;AACvF,EAAA,IAAI,CAAC,QAAQ,MAAA,EAAQ;AACjB,IAAA,MAAM,IAAI,KAAA;AAAA,MACN;AAAA,KAEJ;AAAA,EACJ;AAEA,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,QAAA;AAAA,IACN,SAAA,EAAW,WAAA;AAAA,IACX,OAAA,EAAS,WAAA;AAAA,IAET,MAAM,MAAA,CAAO,SAAA,EAAW,aAAA,GAAgB,EAAC,EAAG;AACxC,MAAA,MAAM,aAAA,GAAgB,EAAE,GAAG,OAAA,EAAS,GAAG,aAAA,EAAc;AAErD,MAAA,IAAI,YAAA;AACJ,MAAA,IAAI,UAAA;AACJ,MAAA,MAAM,UAAA,GAAa,IAAI,OAAA,CAAc,CAAC,CAAA,KAAM;AAAE,QAAA,YAAA,GAAe,CAAA;AAAA,MAAG,CAAC,CAAA;AACjE,MAAA,MAAM,QAAA,GAAW,IAAI,OAAA,CAAc,CAAC,CAAA,KAAM;AAAE,QAAA,UAAA,GAAa,CAAA;AAAA,MAAG,CAAC,CAAA;AAE7D,MAAA,IAAI;AAEA,QAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,CAAQ,SAAA,EAAW,EAAE,OAAO,aAAA,CAAc,KAAA,IAAS,EAAC,EAAG,CAAA;AAC9E,QAAA,MAAM,OAAO,MAAA,CAAO,IAAA;AAGpB,QAAA,MAAM,OAAA,GAAU,IAAI,WAAA,EAAY;AAChC,QAAA,MAAM,MAAA,GAAS,IAAI,cAAA,CAA2B;AAAA,UAC1C,MAAM,UAAA,EAAY;AAEd,YAAA,IAAI,OAAO,IAAA,EAAM;AACb,cAAA,UAAA,CAAW,OAAA,CAAQ,OAAA,CAAQ,MAAA,CAAO,MAAA,CAAO,IAAI,CAAC,CAAA;AAAA,YAClD;AAEA,YAAA,YAAA,EAAc;AACd,YAAA,aAAA,CAAc,YAAA,IAAe;AAG7B,YAAA,UAAA,CAAW,OAAA,CAAQ,OAAA,CAAQ,MAAA,CAAO,IAAI,CAAC,CAAA;AAEvC,YAAA,UAAA,EAAY;AACZ,YAAA,aAAA,CAAc,UAAA,IAAa;AAC3B,YAAA,UAAA,CAAW,KAAA,EAAM;AAAA,UACrB;AAAA,SACH,CAAA;AAED,QAAA,OAAO;AAAA,UACH,MAAA;AAAA,UACA,OAAO,MAAM;AAAA,UAAE,CAAA;AAAA,UACf,UAAA;AAAA,UACA;AAAA,SACJ;AAAA,MACJ,SAAS,KAAA,EAAO;AACZ,QAAA,aAAA,CAAc,UAAU,KAAc,CAAA;AACtC,QAAA,MAAM,KAAA;AAAA,MACV;AAAA,IACJ,CAAA;AAAA,IAEA,MAAM,eAAe,SAAA,EAAW;AAC5B,MAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,CAAQ,SAAA,EAAW,EAAE,OAAO,OAAA,EAAS,KAAA,IAAS,EAAC,EAAG,CAAA;AACzE,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAClB;AAAA,GACJ;AACJ;AA8BO,SAAS,wBAAwB,OAAA,EAA0D;AAC9F,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,MAAA;AAAA,IACN,SAAA,EAAW,SAAA;AAAA,IACX,OAAA,EAAS,WAAA;AAAA,IAET,MAAM,MAAA,CAAO,UAAA,EAAY,aAAA,GAAgB,EAAC,EAAG;AACzC,MAAA,MAAM,aAAA,GAAgB,EAAE,GAAG,OAAA,EAAS,GAAG,aAAA,EAAc;AACrD,MAAA,MAAM,SAAA,GAAY,cAAc,SAAA,IAAa,SAAA;AAC7C,MAAA,MAAM,OAAA,GAAU,cAAc,OAAA,IAAW,GAAA;AAEzC,MAAA,IAAI,YAAA;AACJ,MAAA,IAAI,UAAA;AACJ,MAAA,MAAM,UAAA,GAAa,IAAI,OAAA,CAAc,CAAC,CAAA,KAAM;AAAE,QAAA,YAAA,GAAe,CAAA;AAAA,MAAG,CAAC,CAAA;AACjE,MAAA,MAAM,QAAA,GAAW,IAAI,OAAA,CAAc,CAAC,CAAA,KAAM;AAAE,QAAA,UAAA,GAAa,CAAA;AAAA,MAAG,CAAC,CAAA;AAE7D,MAAA,MAAM,OAAA,GAAU,IAAI,WAAA,EAAY;AAChC,MAAA,IAAI,UAAA,GAAa,CAAA;AAEjB,MAAA,MAAM,MAAA,GAAS,IAAI,cAAA,CAA2B;AAAA,QAC1C,MAAM,UAAA,EAAY;AAEd,UAAA,UAAA,CAAW,OAAA,CAAQ,OAAA,CAAQ,MAAA,CAAO,CAAA,OAAA,EAAU,OAAO;;AAAA,CAAM,CAAC,CAAA;AAC1D,UAAA,YAAA,EAAc;AACd,UAAA,aAAA,CAAc,YAAA,IAAe;AAAA,QACjC,CAAA;AAAA,QAEA,MAAM,KAAK,UAAA,EAAY;AACnB,UAAA,IAAI,UAAA,IAAc,WAAW,MAAA,EAAQ;AACjC,YAAA,UAAA,EAAY;AACZ,YAAA,aAAA,CAAc,UAAA,IAAa;AAC3B,YAAA,UAAA,CAAW,KAAA,EAAM;AACjB,YAAA;AAAA,UACJ;AAEA,UAAA,MAAM,KAAA,GAAQ,WAAW,UAAA,EAAY,CAAA;AACrC,UAAA,MAAM,OAAA,GAAU,UAAU,SAAS;AAAA,MAAA,EAAW,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC;;AAAA,CAAA;AACnE,UAAA,UAAA,CAAW,OAAA,CAAQ,OAAA,CAAQ,MAAA,CAAO,OAAO,CAAC,CAAA;AAAA,QAC9C;AAAA,OACH,CAAA;AAED,MAAA,OAAO;AAAA,QACH,MAAA;AAAA,QACA,OAAO,MAAM;AAAA,QAAE,CAAA;AAAA,QACf,UAAA;AAAA,QACA;AAAA,OACJ;AAAA,IACJ;AAAA,GACJ;AACJ;AAYO,SAAS,mBAAA,CACZ,WACA,OAAA,EACgB;AAChB,EAAA,QAAQ,SAAA;AAAW,IACf,KAAK,OAAA;AACD,MAAA,OAAO,yBAAyB,OAA8B,CAAA;AAAA,IAClE,KAAK,KAAA;AACD,MAAA,OAAO,uBAAuB,OAA4B,CAAA;AAAA,IAC9D,KAAK,OAAA;AACD,MAAA,OAAO,yBAAyB,OAA8B,CAAA;AAAA,IAClE,KAAK,QAAA;AACD,MAAA,OAAO,0BAA0B,OAA+B,CAAA;AAAA,IACpE,KAAK,MAAA;AACD,MAAA,OAAO,wBAAwB,OAA6B,CAAA;AAAA,IAChE;AACI,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,4BAAA,EAA+B,SAAS,CAAA,CAAE,CAAA;AAAA;AAEtE","file":"chunk-MQQLYWZZ.js","sourcesContent":["/**\r\n * @flight-framework/core - Multi-Framework Streaming Adapters\r\n * \r\n * Streaming SSR adapters for React, Vue, Svelte, Solid, and HTMX.\r\n * Uses dependency injection pattern for optional framework dependencies.\r\n * \r\n * Best Practices 2026:\r\n * - Dependency injection for optional peer dependencies\r\n * - Support both Node.js and Edge runtimes \r\n * - Progressive hydration support\r\n * - Error boundary integration\r\n * \r\n * @example\r\n * ```typescript\r\n * // React adapter with your imports\r\n * import { renderToReadableStream } from 'react-dom/server';\r\n * \r\n * const adapter = createReactStreamAdapter({\r\n * renderToReadableStream,\r\n * bootstrapModules: ['/client.js'],\r\n * });\r\n * ```\r\n */\r\n\r\nimport type { StreamingRenderOptions, StreamingRenderResult } from '../index.js';\r\n\r\n// ============================================================================\r\n// Common Types\r\n// ============================================================================\r\n\r\n/**\r\n * Framework-specific streaming adapter\r\n */\r\nexport interface StreamingAdapter<TComponent = unknown> {\r\n /** Adapter name */\r\n readonly name: string;\r\n /** Framework version support */\r\n readonly framework: string;\r\n /** Runtime support */\r\n readonly runtime: 'universal' | 'node' | 'edge';\r\n\r\n /**\r\n * Create a streaming response from a component\r\n */\r\n stream(\r\n component: TComponent,\r\n options?: StreamingRenderOptions\r\n ): Promise<StreamingRenderResult>;\r\n\r\n /**\r\n * Render to static string (for comparison/fallback)\r\n */\r\n renderToString?(component: TComponent): Promise<string>;\r\n}\r\n\r\n/**\r\n * Common adapter options\r\n */\r\nexport interface AdapterOptions {\r\n /** Enable streaming (default: true) */\r\n streaming?: boolean;\r\n /** Scripts to bootstrap on client */\r\n bootstrapScripts?: string[];\r\n /** Modules to bootstrap on client */\r\n bootstrapModules?: string[];\r\n /** Error handling strategy */\r\n onError?: (error: Error) => void;\r\n /** Shell ready callback */\r\n onShellReady?: () => void;\r\n /** All content ready callback */\r\n onAllReady?: () => void;\r\n}\r\n\r\n// ============================================================================\r\n// React Adapter (Dependency Injection Pattern)\r\n// ============================================================================\r\n\r\n/**\r\n * React streaming adapter options with required dependencies\r\n */\r\nexport interface ReactAdapterOptions extends AdapterOptions {\r\n /** React's renderToReadableStream (for Edge) */\r\n renderToReadableStream?: (\r\n element: unknown,\r\n options?: {\r\n bootstrapScripts?: string[];\r\n bootstrapModules?: string[];\r\n identifierPrefix?: string;\r\n signal?: AbortSignal;\r\n onError?: (error: unknown) => void;\r\n }\r\n ) => Promise<ReadableStream<Uint8Array> & { allReady: Promise<void> }>;\r\n\r\n /** React's renderToString (for static fallback) */\r\n renderToString?: (element: unknown) => string;\r\n\r\n /** Custom identifier prefix */\r\n identifierPrefix?: string;\r\n /** Abort signal */\r\n signal?: AbortSignal;\r\n}\r\n\r\n/**\r\n * Create a React streaming adapter\r\n * \r\n * @example\r\n * ```typescript\r\n * import { renderToReadableStream, renderToString } from 'react-dom/server';\r\n * \r\n * const adapter = createReactStreamAdapter({\r\n * renderToReadableStream,\r\n * renderToString,\r\n * bootstrapModules: ['/client.js'],\r\n * });\r\n * \r\n * const result = await adapter.stream(<App />);\r\n * ```\r\n */\r\nexport function createReactStreamAdapter(options: ReactAdapterOptions): StreamingAdapter {\r\n if (!options.renderToReadableStream) {\r\n throw new Error(\r\n '[Flight] createReactStreamAdapter requires renderToReadableStream. ' +\r\n 'Import it from react-dom/server and pass it in options.'\r\n );\r\n }\r\n\r\n return {\r\n name: 'react',\r\n framework: 'react@18+',\r\n runtime: 'edge',\r\n\r\n async stream(component, streamOptions = {}) {\r\n const mergedOptions = { ...options, ...streamOptions };\r\n\r\n let resolveShell: () => void;\r\n let resolveAll: () => void;\r\n const shellReady = new Promise<void>((r) => { resolveShell = r; });\r\n const allReady = new Promise<void>((r) => { resolveAll = r; });\r\n\r\n const stream = await options.renderToReadableStream!(component, {\r\n bootstrapScripts: mergedOptions.bootstrapScripts,\r\n bootstrapModules: mergedOptions.bootstrapModules,\r\n identifierPrefix: mergedOptions.identifierPrefix,\r\n signal: mergedOptions.signal,\r\n onError: (error: unknown) => {\r\n mergedOptions.onError?.(error as Error);\r\n },\r\n });\r\n\r\n // Shell is ready when stream is created\r\n resolveShell!();\r\n mergedOptions.onShellReady?.();\r\n\r\n // Track all ready via stream completion\r\n stream.allReady.then(() => {\r\n resolveAll!();\r\n mergedOptions.onAllReady?.();\r\n });\r\n\r\n return {\r\n stream,\r\n abort: () => { /* stream handles abort via signal */ },\r\n shellReady,\r\n allReady,\r\n };\r\n },\r\n\r\n async renderToString(component) {\r\n if (!options.renderToString) {\r\n throw new Error('[Flight] renderToString not provided to adapter');\r\n }\r\n return options.renderToString(component);\r\n },\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// Vue Adapter (Dependency Injection Pattern)\r\n// ============================================================================\r\n\r\n/**\r\n * Vue streaming adapter options\r\n */\r\nexport interface VueAdapterOptions extends AdapterOptions {\r\n /** Vue's renderToWebStream */\r\n renderToWebStream?: (app: unknown, context?: Record<string, unknown>) => ReadableStream;\r\n /** Vue's renderToString */\r\n renderToString?: (app: unknown) => Promise<string>;\r\n /** Vue app context */\r\n context?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Create a Vue 3 streaming adapter\r\n * \r\n * @example\r\n * ```typescript\r\n * import { renderToWebStream, renderToString } from 'vue/server-renderer';\r\n * \r\n * const adapter = createVueStreamAdapter({\r\n * renderToWebStream,\r\n * renderToString,\r\n * });\r\n * \r\n * const result = await adapter.stream(createSSRApp(App));\r\n * ```\r\n */\r\nexport function createVueStreamAdapter(options: VueAdapterOptions): StreamingAdapter {\r\n if (!options.renderToWebStream) {\r\n throw new Error(\r\n '[Flight] createVueStreamAdapter requires renderToWebStream. ' +\r\n 'Import it from vue/server-renderer and pass it in options.'\r\n );\r\n }\r\n\r\n return {\r\n name: 'vue',\r\n framework: 'vue@3+',\r\n runtime: 'universal',\r\n\r\n async stream(app, streamOptions = {}) {\r\n const mergedOptions = { ...options, ...streamOptions };\r\n\r\n let resolveShell: () => void;\r\n let resolveAll: () => void;\r\n const shellReady = new Promise<void>((r) => { resolveShell = r; });\r\n const allReady = new Promise<void>((r) => { resolveAll = r; });\r\n\r\n try {\r\n const stream = options.renderToWebStream!(app, mergedOptions.context);\r\n\r\n // Vue streams shell immediately\r\n resolveShell!();\r\n mergedOptions.onShellReady?.();\r\n\r\n // Wrap to detect completion\r\n const reader = stream.getReader();\r\n\r\n const wrappedStream = new ReadableStream<Uint8Array>({\r\n async pull(controller) {\r\n const { done, value } = await reader.read();\r\n if (done) {\r\n resolveAll!();\r\n mergedOptions.onAllReady?.();\r\n controller.close();\r\n } else {\r\n controller.enqueue(value);\r\n }\r\n },\r\n });\r\n\r\n return {\r\n stream: wrappedStream,\r\n abort: () => reader.cancel(),\r\n shellReady,\r\n allReady,\r\n };\r\n } catch (error) {\r\n mergedOptions.onError?.(error as Error);\r\n throw error;\r\n }\r\n },\r\n\r\n async renderToString(app) {\r\n if (!options.renderToString) {\r\n throw new Error('[Flight] renderToString not provided to adapter');\r\n }\r\n return options.renderToString(app);\r\n },\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// Solid Adapter (Dependency Injection Pattern)\r\n// ============================================================================\r\n\r\n/**\r\n * Solid streaming adapter options\r\n */\r\nexport interface SolidAdapterOptions extends AdapterOptions {\r\n /** Solid's renderToStream */\r\n renderToStream?: (\r\n fn: () => unknown,\r\n options?: {\r\n nonce?: string;\r\n onCompleteShell?: () => void;\r\n onCompleteAll?: () => void;\r\n }\r\n ) => { pipeTo: (writable: WritableStream) => void };\r\n /** Solid's renderToString */\r\n renderToString?: (fn: () => unknown) => string;\r\n /** Nonce for CSP */\r\n nonce?: string;\r\n}\r\n\r\n/**\r\n * Create a Solid.js streaming adapter\r\n * \r\n * @example\r\n * ```typescript\r\n * import { renderToStream, renderToString } from 'solid-js/web';\r\n * \r\n * const adapter = createSolidStreamAdapter({\r\n * renderToStream,\r\n * renderToString,\r\n * });\r\n * \r\n * const result = await adapter.stream(() => <App />);\r\n * ```\r\n */\r\nexport function createSolidStreamAdapter(options: SolidAdapterOptions): StreamingAdapter {\r\n if (!options.renderToStream) {\r\n throw new Error(\r\n '[Flight] createSolidStreamAdapter requires renderToStream. ' +\r\n 'Import it from solid-js/web and pass it in options.'\r\n );\r\n }\r\n\r\n return {\r\n name: 'solid',\r\n framework: 'solid-js@1+',\r\n runtime: 'universal',\r\n\r\n async stream(component, streamOptions = {}) {\r\n const mergedOptions = { ...options, ...streamOptions };\r\n\r\n let resolveShell: () => void;\r\n let resolveAll: () => void;\r\n const shellReady = new Promise<void>((r) => { resolveShell = r; });\r\n const allReady = new Promise<void>((r) => { resolveAll = r; });\r\n\r\n try {\r\n const { readable, writable } = new TransformStream<Uint8Array, Uint8Array>();\r\n\r\n // Solid's renderToStream with async options\r\n const result = options.renderToStream!(component as () => unknown, {\r\n nonce: mergedOptions.nonce,\r\n onCompleteShell: () => {\r\n resolveShell!();\r\n mergedOptions.onShellReady?.();\r\n },\r\n onCompleteAll: () => {\r\n resolveAll!();\r\n mergedOptions.onAllReady?.();\r\n },\r\n });\r\n\r\n // Pipe to transform stream\r\n result.pipeTo(writable);\r\n\r\n return {\r\n stream: readable,\r\n abort: () => writable.abort(),\r\n shellReady,\r\n allReady,\r\n };\r\n } catch (error) {\r\n mergedOptions.onError?.(error as Error);\r\n throw error;\r\n }\r\n },\r\n\r\n async renderToString(component) {\r\n if (!options.renderToString) {\r\n throw new Error('[Flight] renderToString not provided to adapter');\r\n }\r\n return options.renderToString(component as () => unknown);\r\n },\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// Svelte Adapter (Dependency Injection Pattern)\r\n// ============================================================================\r\n\r\n/**\r\n * Svelte streaming adapter options\r\n */\r\nexport interface SvelteAdapterOptions extends AdapterOptions {\r\n /** Svelte's render function */\r\n render?: (\r\n component: unknown,\r\n options?: { props?: Record<string, unknown> }\r\n ) => { body: string; head?: string };\r\n /** Props for the component */\r\n props?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * Create a Svelte 5 streaming adapter\r\n * Note: Svelte's SSR is primarily string-based, streaming is simulated\r\n * \r\n * @example\r\n * ```typescript\r\n * import { render } from 'svelte/server';\r\n * \r\n * const adapter = createSvelteStreamAdapter({\r\n * render,\r\n * props: { name: 'World' },\r\n * });\r\n * \r\n * const result = await adapter.stream(App);\r\n * ```\r\n */\r\nexport function createSvelteStreamAdapter(options: SvelteAdapterOptions): StreamingAdapter {\r\n if (!options.render) {\r\n throw new Error(\r\n '[Flight] createSvelteStreamAdapter requires render. ' +\r\n 'Import it from svelte/server and pass it in options.'\r\n );\r\n }\r\n\r\n return {\r\n name: 'svelte',\r\n framework: 'svelte@5+',\r\n runtime: 'universal',\r\n\r\n async stream(component, streamOptions = {}) {\r\n const mergedOptions = { ...options, ...streamOptions };\r\n\r\n let resolveShell: () => void;\r\n let resolveAll: () => void;\r\n const shellReady = new Promise<void>((r) => { resolveShell = r; });\r\n const allReady = new Promise<void>((r) => { resolveAll = r; });\r\n\r\n try {\r\n // Render to string first\r\n const result = options.render!(component, { props: mergedOptions.props || {} });\r\n const html = result.body;\r\n\r\n // Convert to stream\r\n const encoder = new TextEncoder();\r\n const stream = new ReadableStream<Uint8Array>({\r\n start(controller) {\r\n // Send head/css first\r\n if (result.head) {\r\n controller.enqueue(encoder.encode(result.head));\r\n }\r\n\r\n resolveShell!();\r\n mergedOptions.onShellReady?.();\r\n\r\n // Send body\r\n controller.enqueue(encoder.encode(html));\r\n\r\n resolveAll!();\r\n mergedOptions.onAllReady?.();\r\n controller.close();\r\n },\r\n });\r\n\r\n return {\r\n stream,\r\n abort: () => { },\r\n shellReady,\r\n allReady,\r\n };\r\n } catch (error) {\r\n mergedOptions.onError?.(error as Error);\r\n throw error;\r\n }\r\n },\r\n\r\n async renderToString(component) {\r\n const result = options.render!(component, { props: options?.props || {} });\r\n return result.body;\r\n },\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// HTMX Streaming Adapter (SSE-based)\r\n// ============================================================================\r\n\r\n/**\r\n * HTMX streaming adapter options\r\n */\r\nexport interface HTMXAdapterOptions extends AdapterOptions {\r\n /** Event name for SSE */\r\n eventName?: string;\r\n /** Retry interval for SSE */\r\n retryMs?: number;\r\n}\r\n\r\n/**\r\n * Create an HTMX SSE streaming adapter\r\n * Uses Server-Sent Events for progressive updates\r\n * \r\n * @example\r\n * ```typescript\r\n * const adapter = createHTMXStreamAdapter({\r\n * eventName: 'update',\r\n * retryMs: 3000,\r\n * });\r\n * \r\n * const result = await adapter.stream(['<div>Part 1</div>', '<div>Part 2</div>']);\r\n * ```\r\n */\r\nexport function createHTMXStreamAdapter(options?: HTMXAdapterOptions): StreamingAdapter<string[]> {\r\n return {\r\n name: 'htmx',\r\n framework: 'htmx@2+',\r\n runtime: 'universal',\r\n\r\n async stream(htmlChunks, streamOptions = {}) {\r\n const mergedOptions = { ...options, ...streamOptions };\r\n const eventName = mergedOptions.eventName || 'message';\r\n const retryMs = mergedOptions.retryMs || 3000;\r\n\r\n let resolveShell: () => void;\r\n let resolveAll: () => void;\r\n const shellReady = new Promise<void>((r) => { resolveShell = r; });\r\n const allReady = new Promise<void>((r) => { resolveAll = r; });\r\n\r\n const encoder = new TextEncoder();\r\n let chunkIndex = 0;\r\n\r\n const stream = new ReadableStream<Uint8Array>({\r\n start(controller) {\r\n // Send retry configuration\r\n controller.enqueue(encoder.encode(`retry: ${retryMs}\\n\\n`));\r\n resolveShell!();\r\n mergedOptions.onShellReady?.();\r\n },\r\n\r\n async pull(controller) {\r\n if (chunkIndex >= htmlChunks.length) {\r\n resolveAll!();\r\n mergedOptions.onAllReady?.();\r\n controller.close();\r\n return;\r\n }\r\n\r\n const chunk = htmlChunks[chunkIndex++];\r\n const sseData = `event: ${eventName}\\ndata: ${JSON.stringify(chunk)}\\n\\n`;\r\n controller.enqueue(encoder.encode(sseData));\r\n },\r\n });\r\n\r\n return {\r\n stream,\r\n abort: () => { },\r\n shellReady,\r\n allReady,\r\n };\r\n },\r\n };\r\n}\r\n\r\n// ============================================================================\r\n// Adapter Factory\r\n// ============================================================================\r\n\r\nexport type FrameworkType = 'react' | 'vue' | 'solid' | 'svelte' | 'htmx';\r\n\r\n/**\r\n * Create a streaming adapter for any supported framework\r\n * Note: For react, vue, solid, svelte you need to pass the required dependencies\r\n */\r\nexport function createStreamAdapter(\r\n framework: FrameworkType,\r\n options?: AdapterOptions & Record<string, unknown>\r\n): StreamingAdapter {\r\n switch (framework) {\r\n case 'react':\r\n return createReactStreamAdapter(options as ReactAdapterOptions);\r\n case 'vue':\r\n return createVueStreamAdapter(options as VueAdapterOptions);\r\n case 'solid':\r\n return createSolidStreamAdapter(options as SolidAdapterOptions);\r\n case 'svelte':\r\n return createSvelteStreamAdapter(options as SvelteAdapterOptions);\r\n case 'htmx':\r\n return createHTMXStreamAdapter(options as HTMXAdapterOptions);\r\n default:\r\n throw new Error(`[Flight] Unknown framework: ${framework}`);\r\n }\r\n}\r\n"]}
|