@demiurgejs/core 0.2.0-beta.1 → 0.2.0-beta.3

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 (156) hide show
  1. package/README.md +2 -0
  2. package/dist/adapter/testing.d.ts +33 -0
  3. package/dist/adapter/testing.d.ts.map +1 -0
  4. package/dist/adapter/testing.js +251 -0
  5. package/dist/adapter/testing.js.map +1 -0
  6. package/dist/browser/file-router.d.ts.map +1 -1
  7. package/dist/chunks/document-shell-WoM8yZlR.js +35 -0
  8. package/dist/chunks/document-shell-WoM8yZlR.js.map +1 -0
  9. package/dist/chunks/image-codec-Di53WpcH.js +141 -0
  10. package/dist/chunks/image-codec-Di53WpcH.js.map +1 -0
  11. package/dist/chunks/images-Edar3eU1.js +339 -0
  12. package/dist/chunks/images-Edar3eU1.js.map +1 -0
  13. package/dist/chunks/request-metadata-DaIYq4Ea.js +677 -0
  14. package/dist/chunks/request-metadata-DaIYq4Ea.js.map +1 -0
  15. package/dist/chunks/streaming-D0fGAuiO.js +469 -0
  16. package/dist/chunks/streaming-D0fGAuiO.js.map +1 -0
  17. package/dist/chunks/{testing-DBjVCN5v.js → testing-CRflAw4X.js} +1300 -1139
  18. package/dist/chunks/testing-CRflAw4X.js.map +1 -0
  19. package/dist/cli.d.ts.map +1 -1
  20. package/dist/cli.js +63 -54
  21. package/dist/cli.js.map +1 -1
  22. package/dist/data/cache.d.ts +8 -0
  23. package/dist/data/cache.d.ts.map +1 -1
  24. package/dist/data/idempotency.d.ts.map +1 -1
  25. package/dist/data/index.d.ts +3 -1
  26. package/dist/data/index.d.ts.map +1 -1
  27. package/dist/data/testing.d.ts.map +1 -1
  28. package/dist/data/testing.js +94 -72
  29. package/dist/data/testing.js.map +1 -1
  30. package/dist/data/tiered.d.ts +7 -0
  31. package/dist/data/tiered.d.ts.map +1 -0
  32. package/dist/document/deferred-scripts.d.ts +11 -0
  33. package/dist/document/deferred-scripts.d.ts.map +1 -0
  34. package/dist/document/hydration.d.ts.map +1 -1
  35. package/dist/document/index.d.ts +4 -1
  36. package/dist/document/index.d.ts.map +1 -1
  37. package/dist/document/render.d.ts.map +1 -1
  38. package/dist/document/scripts.d.ts +12 -1
  39. package/dist/document/scripts.d.ts.map +1 -1
  40. package/dist/document/trusted-types.d.ts +10 -0
  41. package/dist/document/trusted-types.d.ts.map +1 -0
  42. package/dist/edge/assets.d.ts +14 -0
  43. package/dist/edge/assets.d.ts.map +1 -0
  44. package/dist/edge/index.d.ts +19 -0
  45. package/dist/edge/index.d.ts.map +1 -0
  46. package/dist/edge/index.js +286 -0
  47. package/dist/edge/index.js.map +1 -0
  48. package/dist/edge/stores.d.ts +8 -0
  49. package/dist/edge/stores.d.ts.map +1 -0
  50. package/dist/edge/streaming.d.ts +7 -0
  51. package/dist/edge/streaming.d.ts.map +1 -0
  52. package/dist/index.d.ts +7 -7
  53. package/dist/index.d.ts.map +1 -1
  54. package/dist/index.js +895 -556
  55. package/dist/index.js.map +1 -1
  56. package/dist/internal/testing.js +6 -6
  57. package/dist/kv/index.d.ts +5 -0
  58. package/dist/kv/index.d.ts.map +1 -0
  59. package/dist/kv/index.js +126 -0
  60. package/dist/kv/index.js.map +1 -0
  61. package/dist/kv/rate-limit-store.d.ts +8 -0
  62. package/dist/kv/rate-limit-store.d.ts.map +1 -0
  63. package/dist/kv/store.d.ts +28 -0
  64. package/dist/kv/store.d.ts.map +1 -0
  65. package/dist/node/font.d.ts +5 -0
  66. package/dist/node/font.d.ts.map +1 -0
  67. package/dist/node/http.d.ts.map +1 -1
  68. package/dist/node/image.d.ts +15 -0
  69. package/dist/node/image.d.ts.map +1 -0
  70. package/dist/node/index.d.ts +4 -0
  71. package/dist/node/index.d.ts.map +1 -1
  72. package/dist/node/index.js +25 -23
  73. package/dist/node/index.js.map +1 -1
  74. package/dist/node/static.d.ts.map +1 -1
  75. package/dist/node/streaming.d.ts.map +1 -1
  76. package/dist/platform/analytics.d.ts +58 -5
  77. package/dist/platform/analytics.d.ts.map +1 -1
  78. package/dist/platform/font-assets.d.ts +19 -0
  79. package/dist/platform/font-assets.d.ts.map +1 -0
  80. package/dist/platform/fonts.d.ts +14 -4
  81. package/dist/platform/fonts.d.ts.map +1 -1
  82. package/dist/platform/image-codec.d.ts +15 -0
  83. package/dist/platform/image-codec.d.ts.map +1 -0
  84. package/dist/platform/image-url.d.ts +17 -0
  85. package/dist/platform/image-url.d.ts.map +1 -0
  86. package/dist/platform/image.d.ts +8 -0
  87. package/dist/platform/image.d.ts.map +1 -0
  88. package/dist/platform/images.d.ts +15 -0
  89. package/dist/platform/images.d.ts.map +1 -1
  90. package/dist/platform/index.d.ts +13 -6
  91. package/dist/platform/index.d.ts.map +1 -1
  92. package/dist/platform/observability.d.ts +2 -1
  93. package/dist/platform/observability.d.ts.map +1 -1
  94. package/dist/platform/web-vitals-client.d.ts +32 -0
  95. package/dist/platform/web-vitals-client.d.ts.map +1 -0
  96. package/dist/platform/web-vitals.d.ts +78 -0
  97. package/dist/platform/web-vitals.d.ts.map +1 -0
  98. package/dist/redis/index.d.ts +5 -0
  99. package/dist/redis/index.d.ts.map +1 -0
  100. package/dist/redis/index.js +209 -0
  101. package/dist/redis/index.js.map +1 -0
  102. package/dist/redis/rate-limit-store.d.ts +8 -0
  103. package/dist/redis/rate-limit-store.d.ts.map +1 -0
  104. package/dist/redis/store.d.ts +8 -0
  105. package/dist/redis/store.d.ts.map +1 -0
  106. package/dist/route/action.d.ts.map +1 -1
  107. package/dist/route/middleware.d.ts.map +1 -1
  108. package/dist/route/response.d.ts.map +1 -1
  109. package/dist/router/index.d.ts +1 -1
  110. package/dist/router/index.d.ts.map +1 -1
  111. package/dist/router/manifest.d.ts +1 -0
  112. package/dist/router/manifest.d.ts.map +1 -1
  113. package/dist/security/cookies.d.ts +26 -0
  114. package/dist/security/cookies.d.ts.map +1 -0
  115. package/dist/security/env.d.ts.map +1 -1
  116. package/dist/security/fetch-metadata.d.ts +29 -0
  117. package/dist/security/fetch-metadata.d.ts.map +1 -0
  118. package/dist/security/index.d.ts +5 -1
  119. package/dist/security/index.d.ts.map +1 -1
  120. package/dist/security/policy.d.ts +2 -27
  121. package/dist/security/policy.d.ts.map +1 -1
  122. package/dist/security/rate-limit.d.ts +6 -3
  123. package/dist/security/rate-limit.d.ts.map +1 -1
  124. package/dist/security/request.d.ts.map +1 -1
  125. package/dist/security/types.d.ts +82 -6
  126. package/dist/security/types.d.ts.map +1 -1
  127. package/dist/security/verification.d.ts.map +1 -1
  128. package/dist/server/document-shell.d.ts +12 -0
  129. package/dist/server/document-shell.d.ts.map +1 -0
  130. package/dist/server/index.d.ts +1 -1
  131. package/dist/server/index.d.ts.map +1 -1
  132. package/dist/server/request-handler.d.ts +6 -2
  133. package/dist/server/request-handler.d.ts.map +1 -1
  134. package/dist/static/images.d.ts +13 -0
  135. package/dist/static/images.d.ts.map +1 -0
  136. package/dist/static/index.d.ts +8 -0
  137. package/dist/static/index.d.ts.map +1 -1
  138. package/dist/static/index.js +421 -313
  139. package/dist/static/index.js.map +1 -1
  140. package/dist/static/vercel.d.ts +3 -0
  141. package/dist/static/vercel.d.ts.map +1 -1
  142. package/dist/vite/index.d.ts +3 -0
  143. package/dist/vite/index.d.ts.map +1 -1
  144. package/dist/vite/index.js +1041 -652
  145. package/dist/vite/index.js.map +1 -1
  146. package/dist/vite/plugin.d.ts +9 -0
  147. package/dist/vite/plugin.d.ts.map +1 -1
  148. package/dist/vite/policy-verification.d.ts.map +1 -1
  149. package/dist/vite/route-audit.d.ts +50 -0
  150. package/dist/vite/route-audit.d.ts.map +1 -0
  151. package/package.json +34 -3
  152. package/dist/chunks/request-metadata-DwEO1EAS.js +0 -477
  153. package/dist/chunks/request-metadata-DwEO1EAS.js.map +0 -1
  154. package/dist/chunks/streaming-Ci6vf3BB.js +0 -353
  155. package/dist/chunks/streaming-Ci6vf3BB.js.map +0 -1
  156. package/dist/chunks/testing-DBjVCN5v.js.map +0 -1
package/README.md CHANGED
@@ -66,7 +66,9 @@ covers host allowlists, proxy trust, timeouts, and graceful shutdown.
66
66
  - `@demiurgejs/core` — routes, document APIs, security, caching, and browser runtime
67
67
  - `@demiurgejs/core/node` — production Node HTTP, SSR, and static-file adapter
68
68
  - `@demiurgejs/core/static` — static-output adapter
69
+ - `@demiurgejs/core/redis` — Redis-backed cache store with cross-instance tag invalidation
69
70
  - `@demiurgejs/core/vite` — Vite framework plugin
71
+ - `@demiurgejs/core/adapter/testing` — adapter capability conformance contract
70
72
  - `@demiurgejs/core/data/testing` — cache-store conformance contract
71
73
  - `@demiurgejs/core/internal/testing` — explicitly unstable test helpers
72
74
 
@@ -0,0 +1,33 @@
1
+ import { type CacheStoreFactory } from "../data/testing";
2
+ import type { Adapter } from "./index";
3
+ type MaybePromise<T> = T | Promise<T>;
4
+ export type AdapterUpgradeResult = {
5
+ headers?: Record<string, string>;
6
+ status: number;
7
+ };
8
+ export type AdapterBackgroundHost = {
9
+ shutdown: () => Promise<void>;
10
+ waitUntil: (promise: Promise<unknown>) => void;
11
+ };
12
+ export type AdapterStaticOutputEntry = {
13
+ file: string;
14
+ headers: Record<string, string>;
15
+ pathname: string;
16
+ };
17
+ export type AdapterStaticOutput = {
18
+ entries: readonly AdapterStaticOutputEntry[];
19
+ };
20
+ export type AdapterContractProbes = {
21
+ backgroundLifetime?: () => MaybePromise<AdapterBackgroundHost>;
22
+ crossOriginIsolationHeaders?: () => MaybePromise<Response>;
23
+ nonceInjection?: () => MaybePromise<Response>;
24
+ sharedCache?: CacheStoreFactory;
25
+ staticOutput?: (outDir: string) => MaybePromise<AdapterStaticOutput>;
26
+ streaming?: () => MaybePromise<Response>;
27
+ webSocket?: (request: Request) => MaybePromise<AdapterUpgradeResult>;
28
+ webTransport?: (request: Request) => MaybePromise<AdapterUpgradeResult>;
29
+ };
30
+ export declare const adapterContractOrigin = "https://adapter.contract.test";
31
+ export declare function verifyAdapterContract(adapter: Adapter, probes: AdapterContractProbes): Promise<void>;
32
+ export {};
33
+ //# sourceMappingURL=testing.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/adapter/testing.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,OAAO,EAAqB,MAAM,SAAS,CAAC;AAE1D,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAKtC,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC9C,CAAC;AAKF,MAAM,MAAM,qBAAqB,GAAG;IAClC,kBAAkB,CAAC,EAAE,MAAM,YAAY,CAAC,qBAAqB,CAAC,CAAC;IAC/D,2BAA2B,CAAC,EAAE,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3D,cAAc,CAAC,EAAE,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9C,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,CAAC,mBAAmB,CAAC,CAAC;IACrE,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,oBAAoB,CAAC,CAAC;IACrE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,YAAY,CAAC,oBAAoB,CAAC,CAAC;CACzE,CAAC;AAEF,eAAO,MAAM,qBAAqB,kCAAkC,CAAC;AAiBrE,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,qBAAqB,iBAwD9B"}
@@ -0,0 +1,251 @@
1
+ import { mkdtemp as C, rm as v, readFile as $ } from "node:fs/promises";
2
+ import { tmpdir as O } from "node:os";
3
+ import { join as p } from "node:path";
4
+ import { verifyCacheStoreContract as S, verifyCacheStoreRefreshContract as N } from "../data/testing.js";
5
+ const u = "https://adapter.contract.test", j = "https://foreign.contract.test", q = [
6
+ "backgroundLifetime",
7
+ "crossOriginIsolationHeaders",
8
+ "nonceInjection",
9
+ "sharedCache",
10
+ "staticOutput",
11
+ "streaming",
12
+ "webSocket",
13
+ "webTransport"
14
+ ], g = /'nonce-([^']+)'/;
15
+ async function F(t, e) {
16
+ a(
17
+ typeof t.name == "string" && t.name.length > 0,
18
+ "an adapter must carry a name"
19
+ );
20
+ for (const n of q) {
21
+ const i = t.capabilities[n], s = e[n];
22
+ a(
23
+ typeof i == "boolean",
24
+ `an adapter must declare capability "${n}" as a boolean`
25
+ ), a(
26
+ !i || !!s,
27
+ `capability "${n}" is declared true and needs a probe that proves it`
28
+ ), a(
29
+ i || !s,
30
+ `capability "${n}" has a probe but the adapter declares it false`
31
+ );
32
+ }
33
+ e.backgroundLifetime && await J(e.backgroundLifetime), e.crossOriginIsolationHeaders && await B(e.crossOriginIsolationHeaders), e.nonceInjection && await L(e.nonceInjection), e.sharedCache && await R(e.sharedCache), e.staticOutput && await x(e.staticOutput), e.streaming && await I(e.streaming), e.webSocket && await h(e.webSocket, "websocket", 101), e.webTransport && await h(e.webTransport, "webtransport", 200);
34
+ }
35
+ async function I(t) {
36
+ const e = await t();
37
+ a(
38
+ !!e.body,
39
+ "a streaming response must expose a readable body stream"
40
+ );
41
+ const n = e.body.getReader(), i = new TextDecoder();
42
+ let s = 0, o = "";
43
+ for (; ; ) {
44
+ const r = await n.read();
45
+ if (r.done)
46
+ break;
47
+ s += 1, o += i.decode(r.value, { stream: !0 });
48
+ }
49
+ o += i.decode(), a(o.length > 0, "a streaming response must deliver a body"), a(
50
+ s > 1,
51
+ "a streaming response must deliver its body in more than one chunk"
52
+ );
53
+ const c = await t();
54
+ try {
55
+ await c.body?.cancel();
56
+ } catch (r) {
57
+ throw l(
58
+ `a streaming response body must accept cancellation, and it failed with ${k(r)}`
59
+ );
60
+ }
61
+ }
62
+ async function L(t) {
63
+ const e = await t(), n = await t(), i = m(e), s = m(n);
64
+ await n.body?.cancel(), a(
65
+ !!i,
66
+ "a nonce-injecting response must declare a content-security-policy nonce source"
67
+ ), a(
68
+ !!s && s !== i,
69
+ "every response must carry a freshly generated nonce"
70
+ );
71
+ const o = await e.text();
72
+ a(
73
+ o.includes(`nonce="${i}"`),
74
+ "the rendered document must carry the nonce its header declares"
75
+ );
76
+ const c = (e.headers.get("cache-control") ?? "").toLowerCase();
77
+ a(
78
+ c.includes("no-store") || c.includes("private"),
79
+ "a nonce-backed document must not be a shared cache representation"
80
+ );
81
+ }
82
+ async function B(t) {
83
+ const e = await t(), n = e.headers.get("cross-origin-embedder-policy");
84
+ await e.body?.cancel(), a(
85
+ e.headers.get("cross-origin-opener-policy") === "same-origin",
86
+ "an isolated response must carry cross-origin-opener-policy same-origin"
87
+ ), a(
88
+ n === "require-corp" || n === "credentialless",
89
+ "an isolated response must carry cross-origin-embedder-policy require-corp or credentialless"
90
+ ), a(
91
+ !!e.headers.get("cross-origin-resource-policy"),
92
+ "an isolated response must carry a cross-origin-resource-policy"
93
+ );
94
+ }
95
+ async function J(t) {
96
+ const e = await t();
97
+ let n = () => {
98
+ }, i = !1;
99
+ const s = new Promise((d) => {
100
+ n = () => {
101
+ i = !0, d();
102
+ };
103
+ });
104
+ e.waitUntil(s);
105
+ let o = !1;
106
+ const c = e.shutdown().then(() => {
107
+ o = !0;
108
+ });
109
+ await H(), a(
110
+ !o,
111
+ "shutdown must not complete while background work is pending"
112
+ ), n(), await c, a(
113
+ i && o,
114
+ "shutdown must complete once background work settles"
115
+ );
116
+ const r = await t();
117
+ r.waitUntil(
118
+ Promise.reject(new Error("Adapter contract background failure."))
119
+ );
120
+ try {
121
+ await r.shutdown(), await r.shutdown();
122
+ } catch (d) {
123
+ throw l(
124
+ `failed background work must not fail shutdown, and it failed with ${k(d)}`
125
+ );
126
+ }
127
+ }
128
+ async function R(t) {
129
+ await S(t), (await t()).acquireRefreshLease && await N(t);
130
+ }
131
+ async function x(t) {
132
+ const e = await C(p(O(), "demiurge-adapter-contract-"));
133
+ try {
134
+ const n = await t(e);
135
+ a(
136
+ n.entries.length > 0,
137
+ "a static build must produce at least one output entry"
138
+ );
139
+ const i = /* @__PURE__ */ new Set(), s = /* @__PURE__ */ new Set(), o = /* @__PURE__ */ new Map();
140
+ for (const r of n.entries) {
141
+ const d = JSON.stringify(r.file);
142
+ a(
143
+ E(r.file),
144
+ `every output file must stay inside the output directory, and ${d} does not`
145
+ ), a(
146
+ !i.has(r.file),
147
+ `every output entry must own one file, and ${d} repeats`
148
+ ), a(
149
+ !s.has(r.pathname),
150
+ `every output entry must own one pathname, and ${JSON.stringify(r.pathname)} repeats`
151
+ ), i.add(r.file), s.add(r.pathname);
152
+ const f = b(r.headers);
153
+ a(
154
+ f["set-cookie"] === void 0,
155
+ `a build artifact must not carry per-request state, and ${d} sets a cookie`
156
+ ), a(
157
+ !g.test(f["content-security-policy"] ?? ""),
158
+ `a build artifact must not depend on a per-request nonce, and ${d} declares one`
159
+ ), o.set(r.file, await y(e, r.file));
160
+ }
161
+ const c = await t(e);
162
+ a(
163
+ JSON.stringify(c.entries) === JSON.stringify(n.entries),
164
+ "a repeated static build must produce the same output entries"
165
+ );
166
+ for (const r of c.entries)
167
+ a(
168
+ await y(e, r.file) === o.get(r.file),
169
+ `a repeated static build must write the same file, and ${JSON.stringify(r.file)} changed`
170
+ );
171
+ } finally {
172
+ await v(e, { force: !0, recursive: !0 });
173
+ }
174
+ }
175
+ async function h(t, e, n) {
176
+ const i = await t(
177
+ w(e, u)
178
+ ), s = b(i.headers ?? {}).upgrade;
179
+ a(
180
+ i.status === n,
181
+ `an accepted ${e} handshake must answer with status ${n}`
182
+ ), a(
183
+ s?.toLowerCase() === e,
184
+ `an accepted ${e} handshake must confirm the negotiated protocol`
185
+ );
186
+ const o = await t(w(e, j));
187
+ a(
188
+ o.status >= 400 && o.status < 500,
189
+ `a ${e} handshake from an origin the host does not own must be refused`
190
+ );
191
+ const c = await t(
192
+ new Request(`${u}/`, {
193
+ headers: { origin: u }
194
+ })
195
+ );
196
+ a(
197
+ c.status !== n,
198
+ `a request without a ${e} upgrade must not receive a handshake`
199
+ );
200
+ }
201
+ function w(t, e) {
202
+ return new Request(`${u}/`, {
203
+ headers: {
204
+ connection: "Upgrade",
205
+ origin: e,
206
+ upgrade: t
207
+ }
208
+ });
209
+ }
210
+ function m(t) {
211
+ const e = t.headers.get("content-security-policy") ?? "";
212
+ return g.exec(e)?.[1];
213
+ }
214
+ async function y(t, e) {
215
+ try {
216
+ return await $(p(t, e), "utf8");
217
+ } catch {
218
+ throw l(
219
+ `every output entry must write its file, and ${JSON.stringify(e)} is missing`
220
+ );
221
+ }
222
+ }
223
+ function E(t) {
224
+ return !!t && !t.startsWith("/") && !t.startsWith("\\") && !t.split(/[\\/]/).includes("..");
225
+ }
226
+ function b(t) {
227
+ return Object.fromEntries(
228
+ Object.entries(t).map(([e, n]) => [
229
+ e.toLowerCase(),
230
+ n
231
+ ])
232
+ );
233
+ }
234
+ function H() {
235
+ return new Promise((t) => setTimeout(t, 0));
236
+ }
237
+ function k(t) {
238
+ return t instanceof Error ? t.message : String(t);
239
+ }
240
+ function a(t, e) {
241
+ if (!t)
242
+ throw l(e);
243
+ }
244
+ function l(t) {
245
+ return new Error(`Adapter contract failed: ${t}.`);
246
+ }
247
+ export {
248
+ u as adapterContractOrigin,
249
+ F as verifyAdapterContract
250
+ };
251
+ //# sourceMappingURL=testing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"testing.js","sources":["../../src/adapter/testing.ts"],"sourcesContent":["import { mkdtemp, readFile, rm } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { join } from \"node:path\";\nimport {\n verifyCacheStoreContract,\n verifyCacheStoreRefreshContract,\n type CacheStoreFactory,\n} from \"../data/testing\";\nimport type { Adapter, AdapterCapability } from \"./index\";\n\ntype MaybePromise<T> = T | Promise<T>;\n\n// A host answers a protocol upgrade before it has an HTTP response body, and\n// the Response constructor rejects status 101. A handshake is reported as a\n// plain status and header pair instead.\nexport type AdapterUpgradeResult = {\n headers?: Record<string, string>;\n status: number;\n};\n\nexport type AdapterBackgroundHost = {\n shutdown: () => Promise<void>;\n waitUntil: (promise: Promise<unknown>) => void;\n};\n\nexport type AdapterStaticOutputEntry = {\n file: string;\n headers: Record<string, string>;\n pathname: string;\n};\n\nexport type AdapterStaticOutput = {\n entries: readonly AdapterStaticOutputEntry[];\n};\n\n// One probe per capability. A probe runs the adapter through the smallest\n// deployment that can prove the capability, and the contract reads the result.\n// Every probe may be called more than once.\nexport type AdapterContractProbes = {\n backgroundLifetime?: () => MaybePromise<AdapterBackgroundHost>;\n crossOriginIsolationHeaders?: () => MaybePromise<Response>;\n nonceInjection?: () => MaybePromise<Response>;\n sharedCache?: CacheStoreFactory;\n staticOutput?: (outDir: string) => MaybePromise<AdapterStaticOutput>;\n streaming?: () => MaybePromise<Response>;\n webSocket?: (request: Request) => MaybePromise<AdapterUpgradeResult>;\n webTransport?: (request: Request) => MaybePromise<AdapterUpgradeResult>;\n};\n\nexport const adapterContractOrigin = \"https://adapter.contract.test\";\n\nconst foreignOrigin = \"https://foreign.contract.test\";\n\nconst contractCapabilities = [\n \"backgroundLifetime\",\n \"crossOriginIsolationHeaders\",\n \"nonceInjection\",\n \"sharedCache\",\n \"staticOutput\",\n \"streaming\",\n \"webSocket\",\n \"webTransport\",\n] as const satisfies readonly AdapterCapability[];\n\nconst noncePattern = /'nonce-([^']+)'/;\n\nexport async function verifyAdapterContract(\n adapter: Adapter,\n probes: AdapterContractProbes,\n) {\n assert(\n typeof adapter.name === \"string\" && adapter.name.length > 0,\n \"an adapter must carry a name\",\n );\n\n for (const capability of contractCapabilities) {\n const declared = adapter.capabilities[capability];\n const probe = probes[capability];\n\n assert(\n typeof declared === \"boolean\",\n `an adapter must declare capability \"${capability}\" as a boolean`,\n );\n assert(\n !declared || Boolean(probe),\n `capability \"${capability}\" is declared true and needs a probe that proves it`,\n );\n assert(\n declared || !probe,\n `capability \"${capability}\" has a probe but the adapter declares it false`,\n );\n }\n\n if (probes.backgroundLifetime) {\n await verifyBackgroundLifetimeContract(probes.backgroundLifetime);\n }\n\n if (probes.crossOriginIsolationHeaders) {\n await verifyCrossOriginIsolationContract(probes.crossOriginIsolationHeaders);\n }\n\n if (probes.nonceInjection) {\n await verifyNonceInjectionContract(probes.nonceInjection);\n }\n\n if (probes.sharedCache) {\n await verifySharedCacheContract(probes.sharedCache);\n }\n\n if (probes.staticOutput) {\n await verifyStaticOutputContract(probes.staticOutput);\n }\n\n if (probes.streaming) {\n await verifyStreamingContract(probes.streaming);\n }\n\n if (probes.webSocket) {\n await verifyUpgradeContract(probes.webSocket, \"websocket\", 101);\n }\n\n if (probes.webTransport) {\n await verifyUpgradeContract(probes.webTransport, \"webtransport\", 200);\n }\n}\n\n// A streamed body reaches the client before the render finishes, so it arrives\n// as more than one chunk. A buffered response fails this, and a client that\n// disconnects early must not fault the host.\nasync function verifyStreamingContract(\n probe: NonNullable<AdapterContractProbes[\"streaming\"]>,\n) {\n const response = await probe();\n\n assert(\n Boolean(response.body),\n \"a streaming response must expose a readable body stream\",\n );\n\n const reader = response.body!.getReader();\n const decoder = new TextDecoder();\n let chunks = 0;\n let body = \"\";\n\n while (true) {\n const chunk = await reader.read();\n\n if (chunk.done) {\n break;\n }\n\n chunks += 1;\n body += decoder.decode(chunk.value, { stream: true });\n }\n\n body += decoder.decode();\n\n assert(body.length > 0, \"a streaming response must deliver a body\");\n assert(\n chunks > 1,\n \"a streaming response must deliver its body in more than one chunk\",\n );\n\n const cancelled = await probe();\n\n try {\n await cancelled.body?.cancel();\n } catch (error) {\n throw contractError(\n `a streaming response body must accept cancellation, and it failed with ${describe(error)}`,\n );\n }\n}\n\n// A nonce is single use. Two responses cannot share one, the document must\n// carry the value the header declares, and a shared cache must not store it.\nasync function verifyNonceInjectionContract(\n probe: NonNullable<AdapterContractProbes[\"nonceInjection\"]>,\n) {\n const first = await probe();\n const second = await probe();\n const firstNonce = readCspNonce(first);\n const secondNonce = readCspNonce(second);\n\n await second.body?.cancel();\n\n assert(\n Boolean(firstNonce),\n \"a nonce-injecting response must declare a content-security-policy nonce source\",\n );\n assert(\n Boolean(secondNonce) && secondNonce !== firstNonce,\n \"every response must carry a freshly generated nonce\",\n );\n\n const document = await first.text();\n\n assert(\n document.includes(`nonce=\"${firstNonce}\"`),\n \"the rendered document must carry the nonce its header declares\",\n );\n\n const cacheControl = (first.headers.get(\"cache-control\") ?? \"\").toLowerCase();\n\n assert(\n cacheControl.includes(\"no-store\") || cacheControl.includes(\"private\"),\n \"a nonce-backed document must not be a shared cache representation\",\n );\n}\n\n// Cross-origin isolation needs both headers to survive the host response path.\n// A resource policy travels with them and keeps the isolated document from\n// leaking as a subresource.\nasync function verifyCrossOriginIsolationContract(\n probe: NonNullable<AdapterContractProbes[\"crossOriginIsolationHeaders\"]>,\n) {\n const response = await probe();\n const embedderPolicy = response.headers.get(\"cross-origin-embedder-policy\");\n\n await response.body?.cancel();\n\n assert(\n response.headers.get(\"cross-origin-opener-policy\") === \"same-origin\",\n \"an isolated response must carry cross-origin-opener-policy same-origin\",\n );\n assert(\n embedderPolicy === \"require-corp\" || embedderPolicy === \"credentialless\",\n \"an isolated response must carry cross-origin-embedder-policy require-corp or credentialless\",\n );\n assert(\n Boolean(response.headers.get(\"cross-origin-resource-policy\")),\n \"an isolated response must carry a cross-origin-resource-policy\",\n );\n}\n\n// Background work outlives the response that started it. Shutdown waits for\n// that work, a failed task never fails shutdown, and a repeated shutdown is\n// safe.\nasync function verifyBackgroundLifetimeContract(\n probe: NonNullable<AdapterContractProbes[\"backgroundLifetime\"]>,\n) {\n const host = await probe();\n let release = () => {};\n let settled = false;\n const work = new Promise<void>((resolveWork) => {\n release = () => {\n settled = true;\n resolveWork();\n };\n });\n\n host.waitUntil(work);\n\n let stopped = false;\n const shutdown = host.shutdown().then(() => {\n stopped = true;\n });\n\n await tick();\n\n assert(\n !stopped,\n \"shutdown must not complete while background work is pending\",\n );\n\n release();\n await shutdown;\n\n assert(\n settled && stopped,\n \"shutdown must complete once background work settles\",\n );\n\n const failingHost = await probe();\n failingHost.waitUntil(\n Promise.reject(new Error(\"Adapter contract background failure.\")),\n );\n\n try {\n await failingHost.shutdown();\n await failingHost.shutdown();\n } catch (error) {\n throw contractError(\n `failed background work must not fail shutdown, and it failed with ${describe(error)}`,\n );\n }\n}\n\n// A shared cache is the framework cache store contract seen from a host. The\n// refresh contract applies to a store that publishes the lease methods.\nasync function verifySharedCacheContract(\n probe: NonNullable<AdapterContractProbes[\"sharedCache\"]>,\n) {\n await verifyCacheStoreContract(probe);\n\n const store = await probe();\n\n if (store.acquireRefreshLease) {\n await verifyCacheStoreRefreshContract(probe);\n }\n}\n\n// A build artifact is a file on disk, and it holds no per-request state. The\n// same build run twice writes the same files, which is what makes a deployment\n// reproducible.\nasync function verifyStaticOutputContract(\n probe: NonNullable<AdapterContractProbes[\"staticOutput\"]>,\n) {\n const outDir = await mkdtemp(join(tmpdir(), \"demiurge-adapter-contract-\"));\n\n try {\n const first = await probe(outDir);\n\n assert(\n first.entries.length > 0,\n \"a static build must produce at least one output entry\",\n );\n\n const files = new Set<string>();\n const pathnames = new Set<string>();\n const contents = new Map<string, string>();\n\n for (const entry of first.entries) {\n const file = JSON.stringify(entry.file);\n\n assert(\n isContainedFile(entry.file),\n `every output file must stay inside the output directory, and ${file} does not`,\n );\n assert(\n !files.has(entry.file),\n `every output entry must own one file, and ${file} repeats`,\n );\n assert(\n !pathnames.has(entry.pathname),\n `every output entry must own one pathname, and ${JSON.stringify(entry.pathname)} repeats`,\n );\n\n files.add(entry.file);\n pathnames.add(entry.pathname);\n\n const headers = lowercaseHeaders(entry.headers);\n\n assert(\n headers[\"set-cookie\"] === undefined,\n `a build artifact must not carry per-request state, and ${file} sets a cookie`,\n );\n assert(\n !noncePattern.test(headers[\"content-security-policy\"] ?? \"\"),\n `a build artifact must not depend on a per-request nonce, and ${file} declares one`,\n );\n\n contents.set(entry.file, await readOutputFile(outDir, entry.file));\n }\n\n const second = await probe(outDir);\n\n assert(\n JSON.stringify(second.entries) === JSON.stringify(first.entries),\n \"a repeated static build must produce the same output entries\",\n );\n\n for (const entry of second.entries) {\n assert(\n await readOutputFile(outDir, entry.file) === contents.get(entry.file),\n `a repeated static build must write the same file, and ${JSON.stringify(entry.file)} changed`,\n );\n }\n } finally {\n await rm(outDir, { force: true, recursive: true });\n }\n}\n\n// A host that accepts a connection upgrade also has to refuse one. An origin\n// it does not own and a request without the upgrade never reach the accepted\n// handshake.\nasync function verifyUpgradeContract(\n probe: (request: Request) => MaybePromise<AdapterUpgradeResult>,\n protocol: \"websocket\" | \"webtransport\",\n acceptedStatus: 101 | 200,\n) {\n const accepted = await probe(\n upgradeRequest(protocol, adapterContractOrigin),\n );\n const negotiated = lowercaseHeaders(accepted.headers ?? {}).upgrade;\n\n assert(\n accepted.status === acceptedStatus,\n `an accepted ${protocol} handshake must answer with status ${acceptedStatus}`,\n );\n assert(\n negotiated?.toLowerCase() === protocol,\n `an accepted ${protocol} handshake must confirm the negotiated protocol`,\n );\n\n const foreign = await probe(upgradeRequest(protocol, foreignOrigin));\n\n assert(\n foreign.status >= 400 && foreign.status < 500,\n `a ${protocol} handshake from an origin the host does not own must be refused`,\n );\n\n const plain = await probe(\n new Request(`${adapterContractOrigin}/`, {\n headers: { origin: adapterContractOrigin },\n }),\n );\n\n assert(\n plain.status !== acceptedStatus,\n `a request without a ${protocol} upgrade must not receive a handshake`,\n );\n}\n\nfunction upgradeRequest(protocol: string, origin: string) {\n return new Request(`${adapterContractOrigin}/`, {\n headers: {\n connection: \"Upgrade\",\n origin,\n upgrade: protocol,\n },\n });\n}\n\nfunction readCspNonce(response: Response) {\n const csp = response.headers.get(\"content-security-policy\") ?? \"\";\n\n return noncePattern.exec(csp)?.[1];\n}\n\nasync function readOutputFile(outDir: string, file: string) {\n try {\n return await readFile(join(outDir, file), \"utf8\");\n } catch {\n throw contractError(\n `every output entry must write its file, and ${JSON.stringify(file)} is missing`,\n );\n }\n}\n\nfunction isContainedFile(file: string) {\n return Boolean(file) &&\n !file.startsWith(\"/\") &&\n !file.startsWith(\"\\\\\") &&\n !file.split(/[\\\\/]/).includes(\"..\");\n}\n\nfunction lowercaseHeaders(headers: Record<string, string>) {\n // TYPE-EVIDENCE: Object.fromEntries builds a record with string keys and string values. The cast widens the values to allow undefined.\n return Object.fromEntries(\n Object.entries(headers).map(([name, value]) => [\n name.toLowerCase(),\n value,\n ]),\n ) as Record<string, string | undefined>;\n}\n\nfunction tick() {\n return new Promise((resolveTick) => setTimeout(resolveTick, 0));\n}\n\nfunction describe(error: unknown) {\n return error instanceof Error ? error.message : String(error);\n}\n\nfunction assert(condition: boolean, requirement: string): asserts condition {\n if (!condition) {\n throw contractError(requirement);\n }\n}\n\nfunction contractError(requirement: string) {\n return new Error(`Adapter contract failed: ${requirement}.`);\n}\n"],"names":["adapterContractOrigin","foreignOrigin","contractCapabilities","noncePattern","verifyAdapterContract","adapter","probes","assert","capability","declared","probe","verifyBackgroundLifetimeContract","verifyCrossOriginIsolationContract","verifyNonceInjectionContract","verifySharedCacheContract","verifyStaticOutputContract","verifyStreamingContract","verifyUpgradeContract","response","reader","decoder","chunks","body","chunk","cancelled","error","contractError","describe","first","second","firstNonce","readCspNonce","secondNonce","document","cacheControl","embedderPolicy","host","release","settled","work","resolveWork","stopped","shutdown","tick","failingHost","verifyCacheStoreContract","verifyCacheStoreRefreshContract","outDir","mkdtemp","join","tmpdir","files","pathnames","contents","entry","file","isContainedFile","headers","lowercaseHeaders","readOutputFile","rm","protocol","acceptedStatus","accepted","upgradeRequest","negotiated","foreign","plain","origin","csp","readFile","name","value","resolveTick","condition","requirement"],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"file-router.d.ts","sourceRoot":"","sources":["../../src/browser/file-router.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EAEb,SAAS,EAQV,MAAM,OAAO,CAAC;AACf,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAIL,KAAK,aAAa,EAElB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAUL,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAQ,KAAK,OAAO,EAAmB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE/B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;IAC1C,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CACzC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,4FA8H1D;AA0BD,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,iBAAiB,EACjB,cAAc,CACf,GAAG;IACF,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,iBAkDxE;AAED,KAAK,iBAAiB,GAAG,IAAI,CAC3B,cAAc,kBAAkB,CAAC,EACjC,YAAY,GAAG,aAAa,CAC7B,CAAC;AAEF,KAAK,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG;IACvD,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,qBAiBjE;AAED,wBAAgB,IAAI,CAAC,KAAK,CAAC,GAAG,SAAS,OAAO,EAC5C,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAsBF;AA4LD,KAAK,SAAS,GAAG;IACf,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAC;IAClC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC"}
1
+ {"version":3,"file":"file-router.d.ts","sourceRoot":"","sources":["../../src/browser/file-router.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EAEb,SAAS,EAQV,MAAM,OAAO,CAAC;AACf,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAIL,KAAK,aAAa,EAElB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAUL,KAAK,iBAAiB,EACvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAQ,KAAK,OAAO,EAAmB,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE/B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;IAC1C,UAAU,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CACzC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,4FA8H1D;AA0BD,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,iBAAiB,EACjB,cAAc,CACf,GAAG;IACF,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,iBAoDxE;AAED,KAAK,iBAAiB,GAAG,IAAI,CAC3B,cAAc,kBAAkB,CAAC,EACjC,YAAY,GAAG,aAAa,CAC7B,CAAC;AAEF,KAAK,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG;IACvD,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,qBAkBjE;AAED,wBAAgB,IAAI,CAAC,KAAK,CAAC,GAAG,SAAS,OAAO,EAC5C,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,+BAuBF;AA+LD,KAAK,SAAS,GAAG;IACf,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAC;IAClC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { r as l } from "./request-metadata-DaIYq4Ea.js";
2
+ const t = '<template data-demiurge-stream-root=""></template>';
3
+ async function i(r, e) {
4
+ const s = l({
5
+ body: { data: r.data, navigation: e.navigation },
6
+ entrySrc: e.clientEntry,
7
+ lang: e.lang,
8
+ links: r.links,
9
+ metadata: r.metadata,
10
+ nonce: e.nonce,
11
+ scripts: e.scripts ?? r.scripts,
12
+ styles: e.styles,
13
+ title: e.title
14
+ });
15
+ if (!e.transformDocument)
16
+ return s;
17
+ const n = await e.transformDocument(
18
+ `${s.prefix}${t}${s.suffix}`
19
+ ), a = n.indexOf(t);
20
+ if (a === -1 || n.indexOf(
21
+ t,
22
+ a + t.length
23
+ ) !== -1)
24
+ throw new Error(
25
+ "Demiurge streaming document transform must preserve the root marker exactly once."
26
+ );
27
+ return {
28
+ prefix: n.slice(0, a),
29
+ suffix: n.slice(a + t.length)
30
+ };
31
+ }
32
+ export {
33
+ i as c
34
+ };
35
+ //# sourceMappingURL=document-shell-WoM8yZlR.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"document-shell-WoM8yZlR.js","sources":["../../src/server/document-shell.ts"],"sourcesContent":["import { renderDocumentShell } from \"../document/render\";\nimport type { ScriptTag } from \"../document/scripts\";\nimport type { LoadedRouteMatch } from \"../router\";\nimport type { SsrRenderOptions } from \"./ssr\";\n\n// A streaming render sends the document head before the body exists. A\n// transform that rewrites the document therefore needs a placeholder where the\n// streamed body will go, and it has to leave that placeholder in place.\nexport const STREAM_ROOT_MARKER =\n '<template data-demiurge-stream-root=\"\"></template>';\n\nexport type DocumentShell = {\n prefix: string;\n suffix: string;\n};\n\nexport async function createDocumentShell(\n match: LoadedRouteMatch,\n options: SsrRenderOptions & { scripts?: ScriptTag[] },\n): Promise<DocumentShell> {\n const shell = renderDocumentShell({\n body: { data: match.data, navigation: options.navigation },\n entrySrc: options.clientEntry,\n lang: options.lang,\n links: match.links,\n metadata: match.metadata,\n nonce: options.nonce,\n scripts: options.scripts ?? match.scripts,\n styles: options.styles,\n title: options.title,\n });\n\n if (!options.transformDocument) {\n return shell;\n }\n\n const transformed = await options.transformDocument(\n `${shell.prefix}${STREAM_ROOT_MARKER}${shell.suffix}`,\n );\n const markerIndex = transformed.indexOf(STREAM_ROOT_MARKER);\n\n if (\n markerIndex === -1 ||\n transformed.indexOf(\n STREAM_ROOT_MARKER,\n markerIndex + STREAM_ROOT_MARKER.length,\n ) !== -1\n ) {\n throw new Error(\n \"Demiurge streaming document transform must preserve the root marker exactly once.\",\n );\n }\n\n return {\n prefix: transformed.slice(0, markerIndex),\n suffix: transformed.slice(markerIndex + STREAM_ROOT_MARKER.length),\n };\n}\n"],"names":["STREAM_ROOT_MARKER","createDocumentShell","match","options","shell","renderDocumentShell","transformed","markerIndex"],"mappings":";AAQO,MAAMA,IACX;AAOF,eAAsBC,EACpBC,GACAC,GACwB;AACxB,QAAMC,IAAQC,EAAoB;AAAA,IAChC,MAAM,EAAE,MAAMH,EAAM,MAAM,YAAYC,EAAQ,WAAA;AAAA,IAC9C,UAAUA,EAAQ;AAAA,IAClB,MAAMA,EAAQ;AAAA,IACd,OAAOD,EAAM;AAAA,IACb,UAAUA,EAAM;AAAA,IAChB,OAAOC,EAAQ;AAAA,IACf,SAASA,EAAQ,WAAWD,EAAM;AAAA,IAClC,QAAQC,EAAQ;AAAA,IAChB,OAAOA,EAAQ;AAAA,EAAA,CAChB;AAED,MAAI,CAACA,EAAQ;AACX,WAAOC;AAGT,QAAME,IAAc,MAAMH,EAAQ;AAAA,IAChC,GAAGC,EAAM,MAAM,GAAGJ,CAAkB,GAAGI,EAAM,MAAM;AAAA,EAAA,GAE/CG,IAAcD,EAAY,QAAQN,CAAkB;AAE1D,MACEO,MAAgB,MAChBD,EAAY;AAAA,IACVN;AAAA,IACAO,IAAcP,EAAmB;AAAA,EAAA,MAC7B;AAEN,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAIJ,SAAO;AAAA,IACL,QAAQM,EAAY,MAAM,GAAGC,CAAW;AAAA,IACxC,QAAQD,EAAY,MAAMC,IAAcP,EAAmB,MAAM;AAAA,EAAA;AAErE;"}
@@ -0,0 +1,141 @@
1
+ import { createHash as d } from "node:crypto";
2
+ import { readFile as h, mkdir as p, writeFile as F } from "node:fs/promises";
3
+ import { resolve as u, join as w, relative as b, sep as $ } from "node:path";
4
+ import { d as v, f as S, a as N, r as E, b as J, c as O, i as j } from "./images-Edar3eU1.js";
5
+ const y = 5 * 1024 * 1024;
6
+ async function H(e) {
7
+ const t = e.fonts ?? [];
8
+ if (t.length === 0)
9
+ return [];
10
+ const r = e.basePath ?? v, a = u(e.root), o = u(
11
+ e.cacheDir ?? w(a, "node_modules", ".demiurge", "fonts")
12
+ ), i = e.fetch ?? ((n, s) => fetch(n, s)), c = /* @__PURE__ */ new Map(), f = [];
13
+ for (const n of t) {
14
+ if (!n.selfHost)
15
+ continue;
16
+ const s = S(n), l = c.get(s);
17
+ if (l !== void 0) {
18
+ if (l !== n.src)
19
+ throw new Error(
20
+ `Font family ${JSON.stringify(n.family)} declares two sources that publish the same file ${JSON.stringify(s)}. Give one of them a different weight or style.`
21
+ );
22
+ continue;
23
+ }
24
+ c.set(s, n.src), f.push({
25
+ body: await B(n, { cacheDir: o, load: i, root: a }),
26
+ contentType: N(n.src),
27
+ file: m(r, s),
28
+ url: `${r}/${s}`
29
+ });
30
+ }
31
+ const g = `${E(t, r)}
32
+ `;
33
+ return f.push({
34
+ body: new TextEncoder().encode(g),
35
+ contentType: "text/css; charset=utf-8",
36
+ file: m(r, "fonts.css"),
37
+ url: J(r)
38
+ }), f;
39
+ }
40
+ async function B(e, t) {
41
+ const r = e.source === "google" ? await T(e, t) : await D(e, t.root);
42
+ if (r.byteLength === 0)
43
+ throw new Error(
44
+ `Font family ${JSON.stringify(e.family)} resolved to an empty file.`
45
+ );
46
+ if (r.byteLength > y)
47
+ throw new Error(
48
+ `Font family ${JSON.stringify(e.family)} is larger than the ${y} byte limit.`
49
+ );
50
+ return r;
51
+ }
52
+ async function D(e, t) {
53
+ const r = u(t, e.src.replace(/^\/+/, ""));
54
+ if (b(t, r).split($).includes(".."))
55
+ throw new Error(
56
+ `Font source escaped the project directory: ${JSON.stringify(e.src)}.`
57
+ );
58
+ try {
59
+ return new Uint8Array(await h(r));
60
+ } catch (a) {
61
+ throw new Error(
62
+ `Demiurge could not read the font file ${JSON.stringify(e.src)} for family ${JSON.stringify(e.family)}.`,
63
+ { cause: a }
64
+ );
65
+ }
66
+ }
67
+ async function T(e, t) {
68
+ const r = d("sha256").update(e.src).digest("hex"), a = w(
69
+ t.cacheDir,
70
+ `${r.slice(0, 32)}.${O(e.src)}`
71
+ );
72
+ try {
73
+ return new Uint8Array(await h(a));
74
+ } catch {
75
+ }
76
+ let o;
77
+ try {
78
+ o = await t.load(e.src);
79
+ } catch (c) {
80
+ throw new Error(
81
+ `Demiurge could not download the font for family ${JSON.stringify(e.family)} from ${JSON.stringify(e.src)}.`,
82
+ { cause: c }
83
+ );
84
+ }
85
+ if (!o.ok)
86
+ throw new Error(
87
+ `The font host answered ${o.status} for family ${JSON.stringify(e.family)} at ${JSON.stringify(e.src)}.`
88
+ );
89
+ const i = new Uint8Array(await o.arrayBuffer());
90
+ return await p(t.cacheDir, { recursive: !0 }), await F(a, i), i;
91
+ }
92
+ function m(e, t) {
93
+ return `${e.replace(/^\/+/, "")}/${t}`;
94
+ }
95
+ const A = {
96
+ avif: "image/avif",
97
+ jpeg: "image/jpeg",
98
+ png: "image/png",
99
+ webp: "image/webp"
100
+ }, U = 75;
101
+ function M(e, t) {
102
+ if (e.format !== "auto")
103
+ return e.format;
104
+ const r = (t ?? "").toLowerCase();
105
+ return r.includes("image/avif") ? "avif" : r.includes("image/webp") ? "webp" : x(e.src);
106
+ }
107
+ function x(e) {
108
+ const t = j(e);
109
+ return t === "avif" ? "avif" : t === "webp" ? "webp" : t === "png" ? "png" : "jpeg";
110
+ }
111
+ async function q(e, t) {
112
+ const r = await L(), a = t.quality ?? U, o = r(e).resize({
113
+ width: t.width,
114
+ withoutEnlargement: !0
115
+ });
116
+ return {
117
+ body: new Uint8Array(await I(o, t.format, a)),
118
+ contentType: A[t.format]
119
+ };
120
+ }
121
+ function I(e, t, r) {
122
+ return t === "png" ? e.png().toBuffer() : t === "jpeg" ? e.jpeg({ quality: r }).toBuffer() : t === "avif" ? e.avif({ quality: r }).toBuffer() : e.webp({ quality: r }).toBuffer();
123
+ }
124
+ async function L() {
125
+ let e;
126
+ try {
127
+ e = await import("sharp");
128
+ } catch (t) {
129
+ throw new Error(
130
+ "Demiurge image optimization requires the optional peer dependency sharp. Install sharp in the application.",
131
+ { cause: t }
132
+ );
133
+ }
134
+ return e.default;
135
+ }
136
+ export {
137
+ M as n,
138
+ H as r,
139
+ q as t
140
+ };
141
+ //# sourceMappingURL=image-codec-Di53WpcH.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"image-codec-Di53WpcH.js","sources":["../../src/platform/font-assets.ts","../../src/platform/image-codec.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { join, relative, resolve, sep } from \"node:path\";\nimport {\n defaultFontPath,\n fontAssetFileName,\n fontFormat,\n fontMediaType,\n fontStylesheetUrl,\n renderFontFaceCss,\n type FontContribution,\n type FontDefinition,\n} from \"./fonts\";\n\nexport type FontAssetFetch = (\n input: string,\n init?: { signal?: AbortSignal },\n) => Promise<Response>;\n\nexport type FontAssetOptions = {\n basePath?: string;\n // Where a downloaded font file stays between builds. A build that already\n // downloaded a font reads it back and makes no network request.\n cacheDir?: string;\n fetch?: FontAssetFetch;\n fonts?: FontContribution;\n // The project directory that every local font source resolves against.\n root: string;\n};\n\nexport type FontAsset = {\n body: Uint8Array;\n contentType: string;\n // The output path, relative to the directory that the build publishes.\n file: string;\n url: string;\n};\n\nconst maximumFontBytes = 5 * 1024 * 1024;\n\n// One font declaration becomes one published file plus one stylesheet. The\n// build writes these files, and the Node handler serves the same set from\n// memory. Both derive every URL from the declaration, so they cannot drift.\nexport async function resolveFontAssets(\n options: FontAssetOptions,\n): Promise<FontAsset[]> {\n const fonts = options.fonts ?? [];\n\n if (fonts.length === 0) {\n return [];\n }\n\n const basePath = options.basePath ?? defaultFontPath;\n const root = resolve(options.root);\n const cacheDir = resolve(\n options.cacheDir ?? join(root, \"node_modules\", \".demiurge\", \"fonts\"),\n );\n const load = options.fetch ?? ((input, init) => fetch(input, init));\n const published = new Map<string, string>();\n const assets: FontAsset[] = [];\n\n for (const definition of fonts) {\n if (!definition.selfHost) {\n continue;\n }\n\n const name = fontAssetFileName(definition);\n const claimed = published.get(name);\n\n if (claimed !== undefined) {\n if (claimed !== definition.src) {\n throw new Error(\n `Font family ${JSON.stringify(definition.family)} declares two sources that publish the same file ${JSON.stringify(name)}. Give one of them a different weight or style.`,\n );\n }\n\n continue;\n }\n\n published.set(name, definition.src);\n assets.push({\n body: await readFontBody(definition, { cacheDir, load, root }),\n contentType: fontMediaType(definition.src),\n file: outputFile(basePath, name),\n url: `${basePath}/${name}`,\n });\n }\n\n const stylesheet = `${renderFontFaceCss(fonts, basePath)}\\n`;\n\n assets.push({\n body: new TextEncoder().encode(stylesheet),\n contentType: \"text/css; charset=utf-8\",\n file: outputFile(basePath, \"fonts.css\"),\n url: fontStylesheetUrl(basePath),\n });\n\n return assets;\n}\n\nasync function readFontBody(\n definition: FontDefinition,\n context: { cacheDir: string; load: FontAssetFetch; root: string },\n) {\n const body = definition.source === \"google\"\n ? await downloadFontFile(definition, context)\n : await readLocalFontFile(definition, context.root);\n\n if (body.byteLength === 0) {\n throw new Error(\n `Font family ${JSON.stringify(definition.family)} resolved to an empty file.`,\n );\n }\n\n if (body.byteLength > maximumFontBytes) {\n throw new Error(\n `Font family ${JSON.stringify(definition.family)} is larger than the ${maximumFontBytes} byte limit.`,\n );\n }\n\n return body;\n}\n\nasync function readLocalFontFile(definition: FontDefinition, root: string) {\n const file = resolve(root, definition.src.replace(/^\\/+/, \"\"));\n\n if (relative(root, file).split(sep).includes(\"..\")) {\n throw new Error(\n `Font source escaped the project directory: ${JSON.stringify(definition.src)}.`,\n );\n }\n\n try {\n return new Uint8Array(await readFile(file));\n } catch (error) {\n throw new Error(\n `Demiurge could not read the font file ${JSON.stringify(definition.src)} for family ${JSON.stringify(definition.family)}.`,\n { cause: error },\n );\n }\n}\n\n// A downloaded font stays in the cache directory. The first build reaches the\n// font host once, and every later build reads the file from disk. A build that\n// runs without network access therefore keeps working.\nasync function downloadFontFile(\n definition: FontDefinition,\n context: { cacheDir: string; load: FontAssetFetch; root: string },\n) {\n const digest = createHash(\"sha256\").update(definition.src).digest(\"hex\");\n const cacheFile = join(\n context.cacheDir,\n `${digest.slice(0, 32)}.${fontFormat(definition.src)}`,\n );\n\n try {\n return new Uint8Array(await readFile(cacheFile));\n } catch {\n // The cache holds no copy yet, so the font host answers this once.\n }\n\n let response: Response;\n\n try {\n response = await context.load(definition.src);\n } catch (error) {\n throw new Error(\n `Demiurge could not download the font for family ${JSON.stringify(definition.family)} from ${JSON.stringify(definition.src)}.`,\n { cause: error },\n );\n }\n\n if (!response.ok) {\n throw new Error(\n `The font host answered ${response.status} for family ${JSON.stringify(definition.family)} at ${JSON.stringify(definition.src)}.`,\n );\n }\n\n const body = new Uint8Array(await response.arrayBuffer());\n\n await mkdir(context.cacheDir, { recursive: true });\n await writeFile(cacheFile, body);\n\n return body;\n}\n\nfunction outputFile(basePath: string, name: string) {\n return `${basePath.replace(/^\\/+/, \"\")}/${name}`;\n}\n","import type { ImageFormat } from \"./images\";\nimport { imageSourceExtension, type ImageVariantDescriptor } from \"./image-url\";\n\nexport type EncodedImage = {\n body: Uint8Array;\n contentType: string;\n};\n\ntype SharpModule = {\n default: (input: Uint8Array) => SharpPipeline;\n};\n\ntype SharpPipeline = {\n avif: (options: { quality: number }) => SharpPipeline;\n jpeg: (options: { quality: number }) => SharpPipeline;\n png: () => SharpPipeline;\n resize: (options: {\n width: number;\n withoutEnlargement: boolean;\n }) => SharpPipeline;\n toBuffer: () => Promise<Buffer>;\n webp: (options: { quality: number }) => SharpPipeline;\n};\n\nconst contentTypes: Record<Exclude<ImageFormat, \"auto\">, string> = {\n avif: \"image/avif\",\n jpeg: \"image/jpeg\",\n png: \"image/png\",\n webp: \"image/webp\",\n};\n\nconst defaultQuality = 75;\n\nexport function imageContentType(format: Exclude<ImageFormat, \"auto\">) {\n return contentTypes[format];\n}\n\n// `auto` lets the browser take the smallest format that it accepts. A client\n// that sends no usable `accept` header keeps the source format.\nexport function negotiateImageFormat(\n descriptor: ImageVariantDescriptor,\n accept: string | null,\n): Exclude<ImageFormat, \"auto\"> {\n if (descriptor.format !== \"auto\") {\n return descriptor.format;\n }\n\n const accepted = (accept ?? \"\").toLowerCase();\n\n if (accepted.includes(\"image/avif\")) {\n return \"avif\";\n }\n\n if (accepted.includes(\"image/webp\")) {\n return \"webp\";\n }\n\n return sourceFormat(descriptor.src);\n}\n\nexport function sourceFormat(src: string): Exclude<ImageFormat, \"auto\"> {\n const extension = imageSourceExtension(src);\n\n if (extension === \"avif\") {\n return \"avif\";\n }\n\n if (extension === \"webp\") {\n return \"webp\";\n }\n\n if (extension === \"png\") {\n return \"png\";\n }\n\n return \"jpeg\";\n}\n\nexport async function transformImage(\n source: Uint8Array,\n options: {\n format: Exclude<ImageFormat, \"auto\">;\n quality?: number;\n width: number;\n },\n): Promise<EncodedImage> {\n const sharp = await loadImageCodec();\n const quality = options.quality ?? defaultQuality;\n const resized = sharp(source).resize({\n width: options.width,\n withoutEnlargement: true,\n });\n\n return {\n body: new Uint8Array(await encode(resized, options.format, quality)),\n contentType: contentTypes[options.format],\n };\n}\n\nfunction encode(\n pipeline: SharpPipeline,\n format: Exclude<ImageFormat, \"auto\">,\n quality: number,\n) {\n if (format === \"png\") {\n return pipeline.png().toBuffer();\n }\n\n if (format === \"jpeg\") {\n return pipeline.jpeg({ quality }).toBuffer();\n }\n\n if (format === \"avif\") {\n return pipeline.avif({ quality }).toBuffer();\n }\n\n return pipeline.webp({ quality }).toBuffer();\n}\n\n// `sharp` is an optional peer dependency. Only an application that optimizes\n// an image installs it, the same rule that ADR 0006 states for a host\n// adapter dependency.\nasync function loadImageCodec() {\n let module: SharpModule;\n\n try {\n // TYPE-EVIDENCE: sharp ships no types. The local type describes the methods the codec calls.\n module = (await import(\"sharp\")) as SharpModule;\n } catch (error) {\n throw new Error(\n \"Demiurge image optimization requires the optional peer dependency sharp. Install sharp in the application.\",\n { cause: error },\n );\n }\n\n return module.default;\n}\n"],"names":["maximumFontBytes","resolveFontAssets","options","fonts","basePath","defaultFontPath","root","resolve","cacheDir","join","load","input","init","published","assets","definition","name","fontAssetFileName","claimed","readFontBody","fontMediaType","outputFile","stylesheet","renderFontFaceCss","fontStylesheetUrl","context","body","downloadFontFile","readLocalFontFile","file","relative","sep","readFile","error","digest","createHash","cacheFile","fontFormat","response","mkdir","writeFile","contentTypes","defaultQuality","negotiateImageFormat","descriptor","accept","accepted","sourceFormat","src","extension","imageSourceExtension","transformImage","source","sharp","loadImageCodec","quality","resized","encode","pipeline","format","module"],"mappings":"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"}