cdk-nextjs 0.7.11 → 0.7.13

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 (44) hide show
  1. package/.jsii +310 -100
  2. package/.jsii.tabl.json +1 -1
  3. package/API.md +211 -3
  4. package/README.md +116 -101
  5. package/docs/breaking-changes.md +36 -2
  6. package/docs/development-guide.md +10 -0
  7. package/docs/next-build-output-guide.md +1 -1
  8. package/lib/adapter/adapter.mjs +4 -1
  9. package/lib/generated-structs/OptionalNextjsDistributionProps.d.ts +21 -0
  10. package/lib/generated-structs/OptionalNextjsDistributionProps.js +1 -1
  11. package/lib/nextjs-api.js +1 -1
  12. package/lib/nextjs-build/nextjs-build.js +1 -1
  13. package/lib/nextjs-cache.js +1 -1
  14. package/lib/nextjs-compute/nextjs-containers.js +1 -1
  15. package/lib/nextjs-compute/nextjs-functions.js +1 -1
  16. package/lib/nextjs-distribution.d.ts +71 -2
  17. package/lib/nextjs-distribution.js +156 -107
  18. package/lib/nextjs-distribution.test.js +361 -12
  19. package/lib/nextjs-post-deploy.js +1 -1
  20. package/lib/nextjs-static-assets.d.ts +74 -5
  21. package/lib/nextjs-static-assets.js +276 -41
  22. package/lib/nextjs-static-assets.test.js +298 -1
  23. package/lib/root-constructs/nextjs-base-construct.d.ts +5 -4
  24. package/lib/root-constructs/nextjs-base-construct.js +17 -8
  25. package/lib/root-constructs/nextjs-global-containers.d.ts +16 -1
  26. package/lib/root-constructs/nextjs-global-containers.js +4 -2
  27. package/lib/root-constructs/nextjs-global-functions.d.ts +16 -1
  28. package/lib/root-constructs/nextjs-global-functions.js +4 -2
  29. package/lib/root-constructs/nextjs-regional-containers.js +1 -1
  30. package/lib/root-constructs/nextjs-regional-functions.js +1 -1
  31. package/lib/runtime/image-utils.d.ts +1 -0
  32. package/lib/runtime/image-utils.js +2 -1
  33. package/lib/runtime/image-utils.test.js +17 -1
  34. package/lib/runtime/image.js +5 -2
  35. package/lib/runtime/image.test.js +21 -1
  36. package/lib/runtime/lambda.mjs +9 -2
  37. package/lib/runtime/server.mjs +9 -2
  38. package/lib/utils/viewer-request-functions.d.ts +53 -0
  39. package/lib/utils/viewer-request-functions.js +172 -0
  40. package/lib/utils/viewer-request-functions.test.d.ts +1 -0
  41. package/lib/utils/viewer-request-functions.test.js +43 -0
  42. package/package.json +4 -1
  43. package/scripts/e2e-harness/app.js +7 -2
  44. package/scripts/render-diagrams.mjs +121 -0
@@ -0,0 +1,43 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const viewer_request_functions_1 = require("./viewer-request-functions");
4
+ describe("spliceViewerRequest", () => {
5
+ it.each([
6
+ ["x-forwarded-host", viewer_request_functions_1.X_FORWARDED_HOST_HANDLER],
7
+ ["pass-through", viewer_request_functions_1.PASS_THROUGH_HANDLER],
8
+ ["assetPrefix rewrite", (0, viewer_request_functions_1.assetPrefixRewriteHandler)("base", "/cdn")],
9
+ ])("drops the marker and indentation from the %s handler", (_, handler) => {
10
+ const code = (0, viewer_request_functions_1.spliceViewerRequest)(handler, undefined);
11
+ expect(code).not.toContain(viewer_request_functions_1.VIEWER_REQUEST_HOOK);
12
+ expect(code).not.toMatch(/^[ \t]/m);
13
+ expect(code).toMatch(/^async function handler\(event\) \{$/m);
14
+ });
15
+ it("puts the user's code first and awaits viewerRequest at the marker", () => {
16
+ const code = (0, viewer_request_functions_1.spliceViewerRequest)(viewer_request_functions_1.PASS_THROUGH_HANDLER, 'import cf from "cloudfront";\nfunction viewerRequest(event) {}');
17
+ expect(code.startsWith('import cf from "cloudfront";')).toBe(true);
18
+ expect(code).toMatch(/async function handler\(event\) \{\nconst viewerResult = await viewerRequest\(event\);/);
19
+ });
20
+ });
21
+ describe("assetPrefixRewriteHandler", () => {
22
+ it("swaps the prefix for the basePath", () => {
23
+ expect((0, viewer_request_functions_1.assetPrefixRewriteHandler)("base", "/cdn")).toContain('request.uri = "/base" + request.uri.slice(4);');
24
+ expect((0, viewer_request_functions_1.assetPrefixRewriteHandler)("", "/cdn")).toContain('request.uri = "" + request.uri.slice(4);');
25
+ });
26
+ });
27
+ describe("checkViewerRequestCode", () => {
28
+ it.each([
29
+ "function viewerRequest(event) {}",
30
+ "async function viewerRequest(event) {}",
31
+ "const viewerRequest = (event) => {};",
32
+ "var x = 1, viewerRequest = (event) => {};",
33
+ ])("accepts %s", (code) => {
34
+ expect(() => (0, viewer_request_functions_1.checkViewerRequestCode)(code)).not.toThrow();
35
+ });
36
+ it("refuses code that never defines viewerRequest", () => {
37
+ expect(() => (0, viewer_request_functions_1.checkViewerRequestCode)("const ok = viewerRequest === 1;")).toThrow(/must define `viewerRequest\(event\)`/);
38
+ });
39
+ it("refuses code that uses the name handler", () => {
40
+ expect(() => (0, viewer_request_functions_1.checkViewerRequestCode)("function viewerRequest(event) {} // handler")).toThrow(/uses the name `handler`/);
41
+ });
42
+ });
43
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmlld2VyLXJlcXVlc3QtZnVuY3Rpb25zLnRlc3QuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdXRpbHMvdmlld2VyLXJlcXVlc3QtZnVuY3Rpb25zLnRlc3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFBQSx5RUFPb0M7QUFFcEMsUUFBUSxDQUFDLHFCQUFxQixFQUFFLEdBQUcsRUFBRTtJQUNuQyxFQUFFLENBQUMsSUFBSSxDQUFDO1FBQ04sQ0FBQyxrQkFBa0IsRUFBRSxtREFBd0IsQ0FBQztRQUM5QyxDQUFDLGNBQWMsRUFBRSwrQ0FBb0IsQ0FBQztRQUN0QyxDQUFDLHFCQUFxQixFQUFFLElBQUEsb0RBQXlCLEVBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxDQUFDO0tBQ25FLENBQUMsQ0FBQyxzREFBc0QsRUFBRSxDQUFDLENBQUMsRUFBRSxPQUFPLEVBQUUsRUFBRTtRQUN4RSxNQUFNLElBQUksR0FBRyxJQUFBLDhDQUFtQixFQUFDLE9BQU8sRUFBRSxTQUFTLENBQUMsQ0FBQztRQUNyRCxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyw4Q0FBbUIsQ0FBQyxDQUFDO1FBQ2hELE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUFDO1FBQ3BDLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQyxPQUFPLENBQUMsdUNBQXVDLENBQUMsQ0FBQztJQUNoRSxDQUFDLENBQUMsQ0FBQztJQUVILEVBQUUsQ0FBQyxtRUFBbUUsRUFBRSxHQUFHLEVBQUU7UUFDM0UsTUFBTSxJQUFJLEdBQUcsSUFBQSw4Q0FBbUIsRUFDOUIsK0NBQW9CLEVBQ3BCLGdFQUFnRSxDQUNqRSxDQUFDO1FBQ0YsTUFBTSxDQUFDLElBQUksQ0FBQyxVQUFVLENBQUMsOEJBQThCLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUNuRSxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUMsT0FBTyxDQUNsQix3RkFBd0YsQ0FDekYsQ0FBQztJQUNKLENBQUMsQ0FBQyxDQUFDO0FBQ0wsQ0FBQyxDQUFDLENBQUM7QUFFSCxRQUFRLENBQUMsMkJBQTJCLEVBQUUsR0FBRyxFQUFFO0lBQ3pDLEVBQUUsQ0FBQyxtQ0FBbUMsRUFBRSxHQUFHLEVBQUU7UUFDM0MsTUFBTSxDQUFDLElBQUEsb0RBQXlCLEVBQUMsTUFBTSxFQUFFLE1BQU0sQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUN6RCwrQ0FBK0MsQ0FDaEQsQ0FBQztRQUNGLE1BQU0sQ0FBQyxJQUFBLG9EQUF5QixFQUFDLEVBQUUsRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FDckQsMENBQTBDLENBQzNDLENBQUM7SUFDSixDQUFDLENBQUMsQ0FBQztBQUNMLENBQUMsQ0FBQyxDQUFDO0FBRUgsUUFBUSxDQUFDLHdCQUF3QixFQUFFLEdBQUcsRUFBRTtJQUN0QyxFQUFFLENBQUMsSUFBSSxDQUFDO1FBQ04sa0NBQWtDO1FBQ2xDLHdDQUF3QztRQUN4QyxzQ0FBc0M7UUFDdEMsMkNBQTJDO0tBQzVDLENBQUMsQ0FBQyxZQUFZLEVBQUUsQ0FBQyxJQUFJLEVBQUUsRUFBRTtRQUN4QixNQUFNLENBQUMsR0FBRyxFQUFFLENBQUMsSUFBQSxpREFBc0IsRUFBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxPQUFPLEVBQUUsQ0FBQztJQUMzRCxDQUFDLENBQUMsQ0FBQztJQUVILEVBQUUsQ0FBQywrQ0FBK0MsRUFBRSxHQUFHLEVBQUU7UUFDdkQsTUFBTSxDQUFDLEdBQUcsRUFBRSxDQUNWLElBQUEsaURBQXNCLEVBQUMsaUNBQWlDLENBQUMsQ0FDMUQsQ0FBQyxPQUFPLENBQUMsc0NBQXNDLENBQUMsQ0FBQztJQUNwRCxDQUFDLENBQUMsQ0FBQztJQUVILEVBQUUsQ0FBQyx5Q0FBeUMsRUFBRSxHQUFHLEVBQUU7UUFDakQsTUFBTSxDQUFDLEdBQUcsRUFBRSxDQUNWLElBQUEsaURBQXNCLEVBQUMsNkNBQTZDLENBQUMsQ0FDdEUsQ0FBQyxPQUFPLENBQUMseUJBQXlCLENBQUMsQ0FBQztJQUN2QyxDQUFDLENBQUMsQ0FBQztBQUNMLENBQUMsQ0FBQyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHtcbiAgYXNzZXRQcmVmaXhSZXdyaXRlSGFuZGxlcixcbiAgY2hlY2tWaWV3ZXJSZXF1ZXN0Q29kZSxcbiAgUEFTU19USFJPVUdIX0hBTkRMRVIsXG4gIHNwbGljZVZpZXdlclJlcXVlc3QsXG4gIFZJRVdFUl9SRVFVRVNUX0hPT0ssXG4gIFhfRk9SV0FSREVEX0hPU1RfSEFORExFUixcbn0gZnJvbSBcIi4vdmlld2VyLXJlcXVlc3QtZnVuY3Rpb25zXCI7XG5cbmRlc2NyaWJlKFwic3BsaWNlVmlld2VyUmVxdWVzdFwiLCAoKSA9PiB7XG4gIGl0LmVhY2goW1xuICAgIFtcIngtZm9yd2FyZGVkLWhvc3RcIiwgWF9GT1JXQVJERURfSE9TVF9IQU5ETEVSXSxcbiAgICBbXCJwYXNzLXRocm91Z2hcIiwgUEFTU19USFJPVUdIX0hBTkRMRVJdLFxuICAgIFtcImFzc2V0UHJlZml4IHJld3JpdGVcIiwgYXNzZXRQcmVmaXhSZXdyaXRlSGFuZGxlcihcImJhc2VcIiwgXCIvY2RuXCIpXSxcbiAgXSkoXCJkcm9wcyB0aGUgbWFya2VyIGFuZCBpbmRlbnRhdGlvbiBmcm9tIHRoZSAlcyBoYW5kbGVyXCIsIChfLCBoYW5kbGVyKSA9PiB7XG4gICAgY29uc3QgY29kZSA9IHNwbGljZVZpZXdlclJlcXVlc3QoaGFuZGxlciwgdW5kZWZpbmVkKTtcbiAgICBleHBlY3QoY29kZSkubm90LnRvQ29udGFpbihWSUVXRVJfUkVRVUVTVF9IT09LKTtcbiAgICBleHBlY3QoY29kZSkubm90LnRvTWF0Y2goL15bIFxcdF0vbSk7XG4gICAgZXhwZWN0KGNvZGUpLnRvTWF0Y2goL15hc3luYyBmdW5jdGlvbiBoYW5kbGVyXFwoZXZlbnRcXCkgXFx7JC9tKTtcbiAgfSk7XG5cbiAgaXQoXCJwdXRzIHRoZSB1c2VyJ3MgY29kZSBmaXJzdCBhbmQgYXdhaXRzIHZpZXdlclJlcXVlc3QgYXQgdGhlIG1hcmtlclwiLCAoKSA9PiB7XG4gICAgY29uc3QgY29kZSA9IHNwbGljZVZpZXdlclJlcXVlc3QoXG4gICAgICBQQVNTX1RIUk9VR0hfSEFORExFUixcbiAgICAgICdpbXBvcnQgY2YgZnJvbSBcImNsb3VkZnJvbnRcIjtcXG5mdW5jdGlvbiB2aWV3ZXJSZXF1ZXN0KGV2ZW50KSB7fScsXG4gICAgKTtcbiAgICBleHBlY3QoY29kZS5zdGFydHNXaXRoKCdpbXBvcnQgY2YgZnJvbSBcImNsb3VkZnJvbnRcIjsnKSkudG9CZSh0cnVlKTtcbiAgICBleHBlY3QoY29kZSkudG9NYXRjaChcbiAgICAgIC9hc3luYyBmdW5jdGlvbiBoYW5kbGVyXFwoZXZlbnRcXCkgXFx7XFxuY29uc3Qgdmlld2VyUmVzdWx0ID0gYXdhaXQgdmlld2VyUmVxdWVzdFxcKGV2ZW50XFwpOy8sXG4gICAgKTtcbiAgfSk7XG59KTtcblxuZGVzY3JpYmUoXCJhc3NldFByZWZpeFJld3JpdGVIYW5kbGVyXCIsICgpID0+IHtcbiAgaXQoXCJzd2FwcyB0aGUgcHJlZml4IGZvciB0aGUgYmFzZVBhdGhcIiwgKCkgPT4ge1xuICAgIGV4cGVjdChhc3NldFByZWZpeFJld3JpdGVIYW5kbGVyKFwiYmFzZVwiLCBcIi9jZG5cIikpLnRvQ29udGFpbihcbiAgICAgICdyZXF1ZXN0LnVyaSA9IFwiL2Jhc2VcIiArIHJlcXVlc3QudXJpLnNsaWNlKDQpOycsXG4gICAgKTtcbiAgICBleHBlY3QoYXNzZXRQcmVmaXhSZXdyaXRlSGFuZGxlcihcIlwiLCBcIi9jZG5cIikpLnRvQ29udGFpbihcbiAgICAgICdyZXF1ZXN0LnVyaSA9IFwiXCIgKyByZXF1ZXN0LnVyaS5zbGljZSg0KTsnLFxuICAgICk7XG4gIH0pO1xufSk7XG5cbmRlc2NyaWJlKFwiY2hlY2tWaWV3ZXJSZXF1ZXN0Q29kZVwiLCAoKSA9PiB7XG4gIGl0LmVhY2goW1xuICAgIFwiZnVuY3Rpb24gdmlld2VyUmVxdWVzdChldmVudCkge31cIixcbiAgICBcImFzeW5jIGZ1bmN0aW9uIHZpZXdlclJlcXVlc3QoZXZlbnQpIHt9XCIsXG4gICAgXCJjb25zdCB2aWV3ZXJSZXF1ZXN0ID0gKGV2ZW50KSA9PiB7fTtcIixcbiAgICBcInZhciB4ID0gMSwgdmlld2VyUmVxdWVzdCA9IChldmVudCkgPT4ge307XCIsXG4gIF0pKFwiYWNjZXB0cyAlc1wiLCAoY29kZSkgPT4ge1xuICAgIGV4cGVjdCgoKSA9PiBjaGVja1ZpZXdlclJlcXVlc3RDb2RlKGNvZGUpKS5ub3QudG9UaHJvdygpO1xuICB9KTtcblxuICBpdChcInJlZnVzZXMgY29kZSB0aGF0IG5ldmVyIGRlZmluZXMgdmlld2VyUmVxdWVzdFwiLCAoKSA9PiB7XG4gICAgZXhwZWN0KCgpID0+XG4gICAgICBjaGVja1ZpZXdlclJlcXVlc3RDb2RlKFwiY29uc3Qgb2sgPSB2aWV3ZXJSZXF1ZXN0ID09PSAxO1wiKSxcbiAgICApLnRvVGhyb3coL211c3QgZGVmaW5lIGB2aWV3ZXJSZXF1ZXN0XFwoZXZlbnRcXClgLyk7XG4gIH0pO1xuXG4gIGl0KFwicmVmdXNlcyBjb2RlIHRoYXQgdXNlcyB0aGUgbmFtZSBoYW5kbGVyXCIsICgpID0+IHtcbiAgICBleHBlY3QoKCkgPT5cbiAgICAgIGNoZWNrVmlld2VyUmVxdWVzdENvZGUoXCJmdW5jdGlvbiB2aWV3ZXJSZXF1ZXN0KGV2ZW50KSB7fSAvLyBoYW5kbGVyXCIpLFxuICAgICkudG9UaHJvdygvdXNlcyB0aGUgbmFtZSBgaGFuZGxlcmAvKTtcbiAgfSk7XG59KTtcbiJdfQ==
package/package.json CHANGED
@@ -20,6 +20,7 @@
20
20
  "@aws-sdk/client-s3": "^3.1141.0",
21
21
  "@aws-sdk/client-ssm": "^3.1141.0",
22
22
  "@aws-sdk/lib-storage": "^3.1141.0",
23
+ "@iconify-json/logos": "1.2.16",
23
24
  "@mrgrain/jsii-struct-builder": "^0.7.64",
24
25
  "@next/routing": "16.4.0",
25
26
  "@smithy/signature-v4": "^2.3.0",
@@ -84,7 +85,7 @@
84
85
  "publishConfig": {
85
86
  "access": "public"
86
87
  },
87
- "version": "0.7.11",
88
+ "version": "0.7.13",
88
89
  "jest": {
89
90
  "coverageProvider": "v8",
90
91
  "testPathIgnorePatterns": [
@@ -190,6 +191,8 @@
190
191
  "compat": "pnpm dlx projen compat",
191
192
  "compile": "pnpm dlx projen compile",
192
193
  "default": "pnpm dlx projen default",
194
+ "diagrams": "pnpm dlx projen diagrams",
195
+ "diagrams:check": "pnpm dlx projen diagrams:check",
193
196
  "docgen": "pnpm dlx projen docgen",
194
197
  "eject": "pnpm dlx projen eject",
195
198
  "eslint": "pnpm dlx projen eslint",
@@ -205,8 +205,13 @@ class HarnessStack extends Stack {
205
205
  * `use-cache-metadata-route-handler`'s `/[slug]` page, which threw on it (a 500,
206
206
  * past the ALB's 200-499 range, so the task under test kept being replaced);
207
207
  * `/_next/__cdk-nextjs-harness-health` was taken by `sub-shell-generation`'s
208
- * `/[lang]/[slug]` as `lang: "_next"`, and the health check's renders left
209
- * `/es/*` served a runtime root layout instead of the build-time shell.
208
+ * `/[lang]/[slug]` as `lang: "_next"`. Its fallback shell revalidates 15 minutes
209
+ * after `next build` (`fallbackRevalidate: 900`, the `'use cache'` root layout's
210
+ * default lifetime), and the first request past that serves it stale and
211
+ * regenerates it at runtime, so `/es/*` then reports a runtime root layout -
212
+ * `next start` does the same. The health check was simply that first request,
213
+ * well before the test's own; the test still fails if it runs more than 15
214
+ * minutes after the build (#274).
210
215
  */
211
216
  const HEALTH_CHECK_PATH = "/_next/static/__cdk-nextjs-harness-health";
212
217
 
@@ -0,0 +1,121 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Render the README architecture diagrams with real AWS icons.
4
+ *
5
+ * pnpm diagrams # docs/diagrams/*.mmd -> docs/diagrams/*.svg
6
+ * pnpm diagrams:check # fail if an .svg is missing, orphaned or stale
7
+ *
8
+ * Why committed SVGs and not ```mermaid blocks. GitHub's Mermaid renderer can't
9
+ * register icon packs, so `architecture-beta` there is limited to its generic
10
+ * built-in icons; and npm and Construct Hub don't render Mermaid at all. An SVG
11
+ * renders everywhere the README is shown.
12
+ *
13
+ * Why the check compares a hash and not the rendered bytes. Chromium lays out
14
+ * labels with whatever fonts the machine has, so a render on macOS and one on an
15
+ * Ubuntu runner differ even from the same source. Each SVG instead carries a
16
+ * SHA-256 of the `.mmd` it was rendered from and the `mmdc` and icon pack
17
+ * versions, which the check (no Chrome needed) recomputes from what's on disk.
18
+ *
19
+ * `mmdc` runs through `npx`, not as a devDependency: it pulls in Puppeteer, whose
20
+ * Chrome download pnpm blocks as a build script, and every install would pay for
21
+ * it. The icon pack is an exact-pinned devDependency, which keeps it out of the
22
+ * automated `upgrade-dev-deps` PRs: bumping either version is a hand edit that
23
+ * `diagrams:check` then makes you re-render for.
24
+ */
25
+ import { execFileSync } from "node:child_process";
26
+ import { createHash } from "node:crypto";
27
+ import {
28
+ existsSync,
29
+ mkdtempSync,
30
+ readFileSync,
31
+ readdirSync,
32
+ rmSync,
33
+ writeFileSync,
34
+ } from "node:fs";
35
+ import { tmpdir } from "node:os";
36
+ import { basename, join, resolve } from "node:path";
37
+ import { pathToFileURL } from "node:url";
38
+
39
+ const MERMAID_CLI = "@mermaid-js/mermaid-cli@12.0.0";
40
+ const DIAGRAMS_DIR = resolve("docs", "diagrams");
41
+ const ICON_PACK_DIR = resolve("node_modules", "@iconify-json", "logos");
42
+ const ICON_PACK = join(ICON_PACK_DIR, "icons.json");
43
+ const ICON_PACK_VERSION = JSON.parse(
44
+ readFileSync(join(ICON_PACK_DIR, "package.json"), "utf8"),
45
+ ).version;
46
+ const STAMP = /^<!-- source-sha256: ([0-9a-f]{64}) -->\n/;
47
+
48
+ const files = readdirSync(DIAGRAMS_DIR);
49
+ const sources = files.filter((f) => f.endsWith(".mmd")).sort();
50
+
51
+ const stampOf = (source) =>
52
+ createHash("sha256")
53
+ .update(`${MERMAID_CLI}\n@iconify-json/logos@${ICON_PACK_VERSION}\n`)
54
+ .update(readFileSync(join(DIAGRAMS_DIR, source)))
55
+ .digest("hex");
56
+
57
+ if (process.argv.includes("--check")) {
58
+ const stale = sources.filter((source) => {
59
+ const svg = join(DIAGRAMS_DIR, source.replace(/\.mmd$/, ".svg"));
60
+ if (!existsSync(svg)) return true;
61
+ return STAMP.exec(readFileSync(svg, "utf8"))?.[1] !== stampOf(source);
62
+ });
63
+ const orphaned = files.filter(
64
+ (f) => f.endsWith(".svg") && !sources.includes(f.replace(/\.svg$/, ".mmd")),
65
+ );
66
+ if (stale.length) {
67
+ console.error(
68
+ `Stale diagrams (run \`pnpm diagrams\` and commit the SVGs): ${stale.join(", ")}`,
69
+ );
70
+ }
71
+ if (orphaned.length) {
72
+ console.error(`SVGs with no .mmd source: ${orphaned.join(", ")}`);
73
+ }
74
+ process.exit(stale.length || orphaned.length ? 1 : 0);
75
+ }
76
+
77
+ // Chrome's sandbox can't start on GitHub's Ubuntu runners or in most containers.
78
+ const work = mkdtempSync(join(tmpdir(), "render-diagrams-"));
79
+ const puppeteerConfig = join(work, "puppeteer.json");
80
+ writeFileSync(puppeteerConfig, JSON.stringify({ args: ["--no-sandbox"] }));
81
+
82
+ try {
83
+ for (const source of sources) {
84
+ const name = basename(source, ".mmd");
85
+ const input = join(DIAGRAMS_DIR, source);
86
+ const output = join(DIAGRAMS_DIR, `${name}.svg`);
87
+ execFileSync(
88
+ "npx",
89
+ [
90
+ "--yes",
91
+ MERMAID_CLI,
92
+ "--quiet",
93
+ "--puppeteerConfigFile",
94
+ puppeteerConfig,
95
+ "--iconPacksNamesAndUrls",
96
+ `logos#${pathToFileURL(ICON_PACK)}`,
97
+ "--input",
98
+ input,
99
+ "--output",
100
+ output,
101
+ ],
102
+ // `npx` is `npx.cmd` on Windows, which only a shell can run.
103
+ { stdio: "inherit", shell: process.platform === "win32" },
104
+ );
105
+ // Iconify names gradient ids with a random prefix; renumber them so an
106
+ // unchanged source re-renders to the same bytes on the same machine.
107
+ const ids = new Map();
108
+ const svg = readFileSync(output, "utf8").replace(
109
+ /IconifyId[0-9a-f]+/g,
110
+ (id) => {
111
+ if (!ids.has(id)) ids.set(id, `${name}-icon-${ids.size}`);
112
+ return ids.get(id);
113
+ },
114
+ );
115
+ const stamp = `<!-- source-sha256: ${stampOf(source)} -->\n`;
116
+ writeFileSync(output, `${stamp}${svg}\n`);
117
+ console.log(`rendered ${output}`);
118
+ }
119
+ } finally {
120
+ rmSync(work, { recursive: true, force: true });
121
+ }