DongHyeonkaandClaude Opus 5
639e1a49c9
Vendors the canonical studio-v1.yaml, generates types via an isolated `pnpm dlx` toolchain (openapi-typescript needs TypeScript 5's classic compiler API; this repo pins TypeScript 7.0.2 per VD-01, whose root export has none), and adds an offline drift gate that checks the vendored yaml/generated types/canonical-source.json against each other without touching the sibling design-package repo or the network. Regenerating from canonical surfaces real, new required fields on existing schemas (WorkingCopyDetail.nextAction, PreviewDetail/PublicPreview .dependencyRevision, StudioDashboard.totals.needsValidation, PublicationSnapshot.contentFormatVersion/rendererContractVersion) and a new required EvidenceFigureBlock.asset. The mock gateway and fixtures are updated to satisfy the former; the latter exposes a real authoring- vs-rendering conflation in the content-format parser (it declared its output as the server's fully-resolved PublicRenderModel type, which it has no asset catalog to satisfy). Split that boundary: the parser now produces an authoring block type omitting the resolved asset, and each of its three consumers (the mock gateway, the Studio instant preview, and the static Case demo page) attaches the resolved descriptor from its own asset source through a shared, pure domain-level resolver. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
35 lines
1.5 KiB
TypeScript
35 lines
1.5 KiB
TypeScript
import assert from "node:assert/strict";
|
|
import { readFileSync } from "node:fs";
|
|
import { createHash } from "node:crypto";
|
|
import { test } from "vitest";
|
|
|
|
import canonicalSource from "../../../src/features/tech-log/contracts/studio/canonical-source.json" with { type: "json" };
|
|
|
|
const YAML_PATH = "src/features/tech-log/contracts/studio/studio-api.openapi.yaml";
|
|
|
|
test("vendored contract matches the recorded canonical digest", () => {
|
|
const bytes = readFileSync(YAML_PATH);
|
|
const digest = `sha256:${createHash("sha256").update(bytes).digest("hex")}`;
|
|
assert.equal(digest, canonicalSource.digest);
|
|
});
|
|
|
|
test("canonical source records the pinned revision and version", () => {
|
|
assert.equal(canonicalSource.packageId, "tech-log-studio-contract");
|
|
assert.equal(canonicalSource.version, "2.0.0");
|
|
// revision은 생성 시점에 기록된다. canonical 저장소는 활발히 편집 중이므로
|
|
// 특정 값을 박아두면 계약이 그대로인데도 테스트가 깨진다. 형식만 고정한다.
|
|
assert.match(canonicalSource.sourceRevision, /^[0-9a-f]{7,64}$/);
|
|
assert.match(canonicalSource.digest, /^sha256:[0-9a-f]{64}$/);
|
|
});
|
|
|
|
test("canonical source lists all 19 operationIds", () => {
|
|
assert.equal(canonicalSource.operationIds.length, 19);
|
|
assert.ok(canonicalSource.operationIds.includes("uploadStudioAsset"));
|
|
assert.ok(canonicalSource.operationIds.includes("getStudioSession"));
|
|
});
|
|
|
|
test("vendored contract declares the CSRF header", () => {
|
|
const yaml = readFileSync(YAML_PATH, "utf8");
|
|
assert.ok(yaml.includes("X-CSRF-TOKEN"));
|
|
});
|