feat: sitemap 을 공개 계약에 올린다
서버가 공개 프리픽스 아래에 내는 것은 전부 계약에 있어야 한다 — PublicContractDriftTest 가 양방향으로 본다. 봉투를 쓰지 않는 자리는 media 가 선례이고, sitemap 도 같다: XML 이고 읽는 것은 브라우저가 아니라 크롤러다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01PTnWufiY9ATv57egkKKVAV
This commit is contained in:
co-authored by
Claude Opus 5
parent
871e791cbc
commit
0d4d1e5c0c
@@ -38,28 +38,28 @@
|
||||
},
|
||||
"contractSet": {
|
||||
"setAlgorithm": "CA_CONTRACT_SET_V1",
|
||||
"setDigest": "sha256:9f103bda702c05965e54732f975f68f5f850d9496fc2a59209d9891e64602d80",
|
||||
"setDigest": "sha256:bc0766de75feb10ebc689402840def8689d4653f10d3c42cfbe5f553c7844890",
|
||||
"packages": [
|
||||
{
|
||||
"packageId": "@tech-log/management-contract",
|
||||
"version": "1.0.0",
|
||||
"digest": "sha256:0c226600c45b06433480a8a2ef3d812480dce3850c333bfcab5f626143ce77ea",
|
||||
"runtimeProtocolVersion": 1,
|
||||
"sourceRevision": "4065e89"
|
||||
"sourceRevision": "a0dac96"
|
||||
},
|
||||
{
|
||||
"packageId": "@tech-log/public-contract",
|
||||
"version": "2.1.0",
|
||||
"digest": "sha256:0159d7b834d69252c6edcb5102166084769a58fe1c36764958b90511bb5ec2cc",
|
||||
"digest": "sha256:99f75d51cf19c8efe9847e9080babb8e5bf14ad28223e1a90d6501d96a0b4e15",
|
||||
"runtimeProtocolVersion": 1,
|
||||
"sourceRevision": "4065e89"
|
||||
"sourceRevision": "a0dac96"
|
||||
},
|
||||
{
|
||||
"packageId": "@tech-log/studio-contract",
|
||||
"version": "3.1.0",
|
||||
"digest": "sha256:d06434f33a944f4bbcb26d8725e36c0391685125d2f902176c7ec4b16a78dc40",
|
||||
"runtimeProtocolVersion": 1,
|
||||
"sourceRevision": "4065e89"
|
||||
"sourceRevision": "a0dac96"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
"packageId": "@tech-log/management-contract",
|
||||
"version": "1.0.0",
|
||||
"digest": "sha256:0c226600c45b06433480a8a2ef3d812480dce3850c333bfcab5f626143ce77ea",
|
||||
"sourceRevision": "4065e89",
|
||||
"sourceRevision": "a0dac96",
|
||||
"operationIds": [
|
||||
"createCaseDraft",
|
||||
"getCaseForEdit",
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
{
|
||||
"packageId": "@tech-log/public-contract",
|
||||
"version": "2.1.0",
|
||||
"digest": "sha256:0159d7b834d69252c6edcb5102166084769a58fe1c36764958b90511bb5ec2cc",
|
||||
"sourceRevision": "4065e89",
|
||||
"digest": "sha256:99f75d51cf19c8efe9847e9080babb8e5bf14ad28223e1a90d6501d96a0b4e15",
|
||||
"sourceRevision": "a0dac96",
|
||||
"operationIds": [
|
||||
"getPublicSite",
|
||||
"getPublicHome",
|
||||
@@ -24,6 +24,7 @@
|
||||
"getPublicRelease",
|
||||
"getPublicProfile",
|
||||
"searchPublicResources",
|
||||
"getPublicSitemap",
|
||||
"getPublicMedia"
|
||||
]
|
||||
}
|
||||
|
||||
@@ -339,6 +339,35 @@ export interface paths {
|
||||
patch?: never;
|
||||
trace?: never;
|
||||
};
|
||||
"/sitemap": {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
/** @description 크롤러가 읽는 공개 주소 목록.
|
||||
*
|
||||
* `public/robots.txt` 는 처음부터 Sitemap 을 광고했는데 그 주소가 404 였다 — 규칙이
|
||||
* 있다고 말해 놓고 규칙이 없는 것과 같았다.
|
||||
*
|
||||
* 정적 파일로 만들 수 없다. 무엇이 게시됐는지는 빌드 시점이 아니라 게시 시점에 정해지고,
|
||||
* 그것을 아는 것은 서버뿐이다.
|
||||
*
|
||||
* 경로에 `.xml` 을 붙이지 않는다 — 경로 조각 규칙(AIP-122)이 점을 막고, sitemap
|
||||
* 프로토콜은 확장자를 요구하지 않는다. robots.txt 가 가리키는 주소가 sitemap XML 을
|
||||
* 돌려주면 된다.
|
||||
*
|
||||
* 봉투를 쓰지 않는다. XML 이고 브라우저 코드가 부르지 않는다. */
|
||||
get: operations["getPublicSitemap"];
|
||||
put?: never;
|
||||
post?: never;
|
||||
delete?: never;
|
||||
options?: never;
|
||||
head?: never;
|
||||
patch?: never;
|
||||
trace?: never;
|
||||
};
|
||||
"/media/{assetId}": {
|
||||
parameters: {
|
||||
query?: never;
|
||||
@@ -1918,6 +1947,26 @@ export interface operations {
|
||||
};
|
||||
};
|
||||
};
|
||||
getPublicSitemap: {
|
||||
parameters: {
|
||||
query?: never;
|
||||
header?: never;
|
||||
path?: never;
|
||||
cookie?: never;
|
||||
};
|
||||
requestBody?: never;
|
||||
responses: {
|
||||
/** @description OK */
|
||||
200: {
|
||||
headers: {
|
||||
[name: string]: unknown;
|
||||
};
|
||||
content: {
|
||||
"application/xml": string;
|
||||
};
|
||||
};
|
||||
};
|
||||
};
|
||||
getPublicMedia: {
|
||||
parameters: {
|
||||
query?: never;
|
||||
|
||||
@@ -750,6 +750,32 @@ paths:
|
||||
application/json:
|
||||
schema:
|
||||
$ref: '#/components/schemas/ErrorEnvelope'
|
||||
/sitemap:
|
||||
get:
|
||||
operationId: getPublicSitemap
|
||||
tags:
|
||||
- Sitemap
|
||||
description: |-
|
||||
크롤러가 읽는 공개 주소 목록.
|
||||
|
||||
`public/robots.txt` 는 처음부터 Sitemap 을 광고했는데 그 주소가 404 였다 — 규칙이
|
||||
있다고 말해 놓고 규칙이 없는 것과 같았다.
|
||||
|
||||
정적 파일로 만들 수 없다. 무엇이 게시됐는지는 빌드 시점이 아니라 게시 시점에 정해지고,
|
||||
그것을 아는 것은 서버뿐이다.
|
||||
|
||||
경로에 `.xml` 을 붙이지 않는다 — 경로 조각 규칙(AIP-122)이 점을 막고, sitemap
|
||||
프로토콜은 확장자를 요구하지 않는다. robots.txt 가 가리키는 주소가 sitemap XML 을
|
||||
돌려주면 된다.
|
||||
|
||||
봉투를 쓰지 않는다. XML 이고 브라우저 코드가 부르지 않는다.
|
||||
responses:
|
||||
'200':
|
||||
description: OK
|
||||
content:
|
||||
application/xml:
|
||||
schema:
|
||||
type: string
|
||||
/media/{assetId}:
|
||||
get:
|
||||
operationId: getPublicMedia
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
"packageId": "@tech-log/studio-contract",
|
||||
"version": "3.1.0",
|
||||
"digest": "sha256:d06434f33a944f4bbcb26d8725e36c0391685125d2f902176c7ec4b16a78dc40",
|
||||
"sourceRevision": "4065e89",
|
||||
"sourceRevision": "a0dac96",
|
||||
"operationIds": [
|
||||
"getStudioSession",
|
||||
"getStudioDashboard",
|
||||
|
||||
@@ -25,8 +25,11 @@ function contractOperationIds(path: string): string[] {
|
||||
/**
|
||||
* 봉투를 쓰지 않고 바이트를 그대로 돌려주는 연산. `<img src>` 가 직접 가리키므로 HTTP 기여
|
||||
* 목록을 지나지 않는다 — 등록을 잊은 것이 아니라 지날 이유가 없다.
|
||||
*
|
||||
* <p>`getPublicSitemap` 도 같은 자리다. XML 을 돌려주고, 그것을 읽는 것은 브라우저 코드가
|
||||
* 아니라 크롤러다.
|
||||
*/
|
||||
const NOT_A_JSON_OPERATION = new Set(["getPublicMedia"]);
|
||||
const NOT_A_JSON_OPERATION = new Set(["getPublicMedia", "getPublicSitemap"]);
|
||||
|
||||
test("공개 계약의 모든 연산이 기여 목록에 등록되어 있다", () => {
|
||||
const declared = contractOperationIds(
|
||||
|
||||
Reference in New Issue
Block a user