create-windy 0.6.0 → 0.6.1

package/template/packages/shared/src/screenshot-context-digest.test.ts

@@ -0,0 +1,46 @@
+import { describe, expect, test } from "bun:test";
+import {
+  canonicalizeScreenshotContextV1,
+  computeScreenshotContextDigestV1,
+  isScreenshotContextDigestV1,
+} from "./screenshot-context-digest.js";
+
+describe("Screenshot context digest V1", () => {
+  test("Web 与 Host 对 key 顺序不同的结构化上下文得到同一摘要", async () => {
+    const first = {
+      version: 1,
+      pageKey: "case.detail",
+      overlayStack: [{ title: "导入物证", kind: "dialog" }],
+    };
+    const reordered = {
+      overlayStack: [{ kind: "dialog", title: "导入物证" }],
+      pageKey: "case.detail",
+      version: 1,
+    };
+
+    expect(canonicalizeScreenshotContextV1(first)).toBe(
+      '{"overlayStack":[{"kind":"dialog","title":"导入物证"}],"pageKey":"case.detail","version":1}',
+    );
+    expect(await computeScreenshotContextDigestV1(first)).toBe(
+      "sha256:3e274a367806437443ac78bb6955445c5af2ba924f89d113ba6f652c1d6a3905",
+    );
+    expect(await computeScreenshotContextDigestV1(reordered)).toBe(
+      await computeScreenshotContextDigestV1(first),
+    );
+    expect(
+      isScreenshotContextDigestV1(
+        await computeScreenshotContextDigestV1(first),
+      ),
+    ).toBe(true);
+  });
+
+  test("拒绝非有限数值与非 plain JSON", async () => {
+    expect(() => canonicalizeScreenshotContextV1(Number.NaN)).toThrow(
+      "数值无效",
+    );
+    expect(() => canonicalizeScreenshotContextV1(new Date() as never)).toThrow(
+      "plain JSON",
+    );
+    expect(isScreenshotContextDigestV1(`sha256:${"A".repeat(64)}`)).toBe(false);
+  });
+});

package/template/packages/shared/src/screenshot-context-digest.ts

@@ -0,0 +1,72 @@
+import type { JsonValue } from "./json.js";
+
+const MAX_DEPTH = 32;
+const MAX_NODES = 4_096;
+const MAX_CANONICAL_BYTES = 256 * 1_024;
+const DIGEST_PATTERN = /^sha256:[a-f0-9]{64}$/;
+
+export type ScreenshotContextDigestV1 = `sha256:${string}`;
+
+/** Web/Host 共用的稳定 JSON：object key 排序，array 顺序与 JSON 数值语义保持不变。 */
+export function canonicalizeScreenshotContextV1(value: JsonValue): string {
+  let nodes = 0;
+  const visit = (item: JsonValue, depth: number): string => {
+    nodes += 1;
+    if (nodes > MAX_NODES || depth > MAX_DEPTH) {
+      throw new Error("Screenshot context 超过稳定摘要边界");
+    }
+    if (
+      item === null ||
+      typeof item === "boolean" ||
+      typeof item === "string"
+    ) {
+      return JSON.stringify(item);
+    }
+    if (typeof item === "number") {
+      if (!Number.isFinite(item))
+        throw new Error("Screenshot context 数值无效");
+      return JSON.stringify(item);
+    }
+    if (Array.isArray(item)) {
+      if (item.length > MAX_NODES) {
+        throw new Error("Screenshot context 数组超过稳定摘要边界");
+      }
+      return `[${item.map((entry) => visit(entry, depth + 1)).join(",")}]`;
+    }
+    const prototype = Object.getPrototypeOf(item);
+    if (prototype !== Object.prototype && prototype !== null) {
+      throw new Error("Screenshot context 必须是 plain JSON");
+    }
+    const keys = Object.keys(item).sort();
+    return `{${keys
+      .map(
+        (key) =>
+          `${JSON.stringify(key)}:${visit(item[key] as JsonValue, depth + 1)}`,
+      )
+      .join(",")}}`;
+  };
+  const canonical = visit(value, 0);
+  if (new TextEncoder().encode(canonical).byteLength > MAX_CANONICAL_BYTES) {
+    throw new Error("Screenshot context 超过稳定摘要字节边界");
+  }
+  return canonical;
+}
+
+export async function computeScreenshotContextDigestV1(
+  value: JsonValue,
+): Promise<ScreenshotContextDigestV1> {
+  const bytes = new TextEncoder().encode(
+    canonicalizeScreenshotContextV1(value),
+  );
+  const digest = await globalThis.crypto.subtle.digest("SHA-256", bytes);
+  const hex = [...new Uint8Array(digest)]
+    .map((byte) => byte.toString(16).padStart(2, "0"))
+    .join("");
+  return `sha256:${hex}`;
+}
+
+export function isScreenshotContextDigestV1(
+  value: unknown,
+): value is ScreenshotContextDigestV1 {
+  return typeof value === "string" && DIGEST_PATTERN.test(value);
+}