diff --git a/public/release-manifest.json b/public/release-manifest.json index aa2664d..3fedbd2 100644 --- a/public/release-manifest.json +++ b/public/release-manifest.json @@ -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" } ] } diff --git a/src/features/tech-log/contracts/management/canonical-source.json b/src/features/tech-log/contracts/management/canonical-source.json index 6b4baf6..921f238 100644 --- a/src/features/tech-log/contracts/management/canonical-source.json +++ b/src/features/tech-log/contracts/management/canonical-source.json @@ -2,7 +2,7 @@ "packageId": "@tech-log/management-contract", "version": "1.0.0", "digest": "sha256:0c226600c45b06433480a8a2ef3d812480dce3850c333bfcab5f626143ce77ea", - "sourceRevision": "4065e89", + "sourceRevision": "a0dac96", "operationIds": [ "createCaseDraft", "getCaseForEdit", diff --git a/src/features/tech-log/contracts/public/canonical-source.json b/src/features/tech-log/contracts/public/canonical-source.json index f314c39..6b261d3 100644 --- a/src/features/tech-log/contracts/public/canonical-source.json +++ b/src/features/tech-log/contracts/public/canonical-source.json @@ -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" ] } diff --git a/src/features/tech-log/contracts/public/generated.ts b/src/features/tech-log/contracts/public/generated.ts index ac1f0ee..a2945cd 100644 --- a/src/features/tech-log/contracts/public/generated.ts +++ b/src/features/tech-log/contracts/public/generated.ts @@ -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; diff --git a/src/features/tech-log/contracts/public/public-api.openapi.yaml b/src/features/tech-log/contracts/public/public-api.openapi.yaml index d97ea6d..c97e4c2 100644 --- a/src/features/tech-log/contracts/public/public-api.openapi.yaml +++ b/src/features/tech-log/contracts/public/public-api.openapi.yaml @@ -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 diff --git a/src/features/tech-log/contracts/studio/canonical-source.json b/src/features/tech-log/contracts/studio/canonical-source.json index 3210501..1876d2b 100644 --- a/src/features/tech-log/contracts/studio/canonical-source.json +++ b/src/features/tech-log/contracts/studio/canonical-source.json @@ -2,7 +2,7 @@ "packageId": "@tech-log/studio-contract", "version": "3.1.0", "digest": "sha256:d06434f33a944f4bbcb26d8725e36c0391685125d2f902176c7ec4b16a78dc40", - "sourceRevision": "4065e89", + "sourceRevision": "a0dac96", "operationIds": [ "getStudioSession", "getStudioDashboard", diff --git a/tests/features/tech-log/contract-operation-coverage.test.ts b/tests/features/tech-log/contract-operation-coverage.test.ts index 3c9a03d..b7f08c5 100644 --- a/tests/features/tech-log/contract-operation-coverage.test.ts +++ b/tests/features/tech-log/contract-operation-coverage.test.ts @@ -25,8 +25,11 @@ function contractOperationIds(path: string): string[] { /** * 봉투를 쓰지 않고 바이트를 그대로 돌려주는 연산. `` 가 직접 가리키므로 HTTP 기여 * 목록을 지나지 않는다 — 등록을 잊은 것이 아니라 지날 이유가 없다. + * + *

`getPublicSitemap` 도 같은 자리다. XML 을 돌려주고, 그것을 읽는 것은 브라우저 코드가 + * 아니라 크롤러다. */ -const NOT_A_JSON_OPERATION = new Set(["getPublicMedia"]); +const NOT_A_JSON_OPERATION = new Set(["getPublicMedia", "getPublicSitemap"]); test("공개 계약의 모든 연산이 기여 목록에 등록되어 있다", () => { const declared = contractOperationIds(