@ryusenkei/maezae 0.5.0 → 0.6.0

package/dist/dev.js

@@ -1,71 +1,56 @@
 import { i as SIGNED_HEADERS, s as signedHeaders } from "./src-Baj-EC2G.js";
 import { createHash } from "node:crypto";
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { createServer } from "node:http";
 import { pathToFileURL } from "node:url";
 // src/dev.ts
-/** 記録する応答のヘッダー（配信のキャッシュの照合と本文の形式） */
-const KEPT_HEADERS = [
-	"content-type",
-	"etag",
-	"x-stale"
-];
+/** 呼び出しの記録のファイル名（メソッド・パス・If-None-Match・本文のハッシュ） */
+const fixtureName = (method, path, ifNoneMatch = "", body = "") => `${createHash("sha256").update(`${method.toUpperCase()} ${path}\n${ifNoneMatch}\n${body}`).digest("hex").slice(0, 16)}.json`;
 /** 記録のディレクトリの URL（末尾はスラッシュ） */
 const dirUrl = (dir) => {
 	const url = dir instanceof URL ? dir : pathToFileURL(dir);
 	return url.href.endsWith("/") ? url : new URL(`${url.href}/`);
 };
-/** 呼び出しの記録のファイル */
-const fileOf = (dir, method, path, ifNoneMatch, body) => new URL(`${createHash("sha256").update(`${method} ${path}\n${ifNoneMatch}\n${body}`).digest("hex").slice(0, 16)}.json`, dir);
-/** upstream へ中継（API の鍵を付与、下書きの署名は upstream の URL で改めて付与） */
-async function relay({ origin, apiKey, previewSecret }, path, init) {
-	const url = `${origin.replace(/\/$/, "")}${path}`;
-	const body = typeof init.body === "string" ? init.body : null;
-	const headers = new Headers(init.headers);
-	if (previewSecret && headers.has(SIGNED_HEADERS.preview)) headers.set(SIGNED_HEADERS.preview, (await signedHeaders(previewSecret, {
-		method: init.method ?? "GET",
-		url,
-		body
-	}, { header: SIGNED_HEADERS.preview })).get(SIGNED_HEADERS.preview));
-	headers.set("authorization", `Bearer ${apiKey}`);
-	return fetch(url, {
-		...init,
-		headers
-	});
-}
-/** 記録の配信 API（port Delivery、upstream があれば中継して保存、並行の書き込みは一時のファイルから置き換え） */
-function fixtureDelivery({ dir, upstream }) {
+/** 記録の再生（port Delivery、dir は記録のディレクトリ） */
+function fixtureDelivery(dir) {
 	const base = dirUrl(dir);
 	return async (path, init = {}) => {
 		const method = (init.method ?? "GET").toUpperCase();
-		const file = fileOf(base, method, path, new Headers(init.headers).get("if-none-match") ?? "", typeof init.body === "string" ? init.body : "");
-		let recorded;
-		if (upstream) {
-			const res = await relay(upstream, path, init);
-			recorded = {
-				method,
-				path,
-				status: res.status,
-				headers: Object.fromEntries(KEPT_HEADERS.flatMap((h) => res.headers.has(h) ? [[h, res.headers.get(h)]] : [])),
-				body: await res.text()
-			};
-			mkdirSync(base, { recursive: true });
-			const tmp = new URL(`${file.href}.${process.pid}.tmp`);
-			writeFileSync(tmp, `${JSON.stringify(recorded, null, 2)}\n`);
-			renameSync(tmp, file);
-		} else {
-			if (!existsSync(file)) throw new Error(`配信 API の記録なし: ${method} ${path}（upstream を指定して記録）`);
-			recorded = JSON.parse(readFileSync(file, "utf8"));
-		}
-		return new Response(recorded.status === 304 ? null : recorded.body, {
-			status: recorded.status,
-			headers: recorded.headers
+		const file = new URL(fixtureName(method, path, new Headers(init.headers).get("if-none-match") ?? "", typeof init.body === "string" ? init.body : ""), base);
+		if (!existsSync(file)) throw new Error(`配信 API の記録なし: ${method} ${path}（${file.pathname.split("/").at(-1)}）`);
+		const { status, headers, body } = JSON.parse(readFileSync(file, "utf8"));
+		return new Response(status === 304 ? null : body, {
+			status,
+			headers
+		});
+	};
+}
+const READ_METHODS = /* @__PURE__ */ new Set(["GET", "HEAD"]);
+/** 公開の配信 API への中継（port Delivery、読み取りだけで書き込みの操作は405） */
+function relayDelivery({ origin, apiKey, previewSecret }) {
+	return async (path, init = {}) => {
+		const method = (init.method ?? "GET").toUpperCase();
+		if (!READ_METHODS.has(method)) return new Response("手元の中継は読み取りだけ", {
+			status: 405,
+			headers: { allow: "GET, HEAD" }
+		});
+		const url = `${origin.replace(/\/$/, "")}${path}`;
+		const headers = new Headers(init.headers);
+		if (previewSecret && headers.has(SIGNED_HEADERS.preview)) headers.set(SIGNED_HEADERS.preview, (await signedHeaders(previewSecret, {
+			method,
+			url,
+			body: null
+		}, { header: SIGNED_HEADERS.preview })).get(SIGNED_HEADERS.preview));
+		headers.set("authorization", `Bearer ${apiKey}`);
+		return fetch(url, {
+			...init,
+			method,
+			headers
 		});
 	};
 }
-/** 手元の配信 API のサーバー（/content/v1/… だけ、記録にない呼び出しは502、戻り値は origin と停止の関数） */
-async function serveDelivery(options) {
-	const delivery = fixtureDelivery(options);
+/** 手元の配信 API のサーバー（/content/v1/… だけ、失敗は502、戻り値は origin と停止の関数） */
+async function serveDelivery(delivery, options = {}) {
 	const server = createServer(async (req, res) => {
 		const chunks = [];
 		for await (const chunk of req) chunks.push(chunk);
@@ -97,4 +82,4 @@ async function serveDelivery(options) {
 		close: () => new Promise((resolve) => server.close(() => resolve()))
 	};
 }
-export { fixtureDelivery, serveDelivery };
+export { fixtureDelivery, fixtureName, relayDelivery, serveDelivery };

package/dist/types/sdk/src/dev.d.ts

@@ -1,19 +1,26 @@
 import type { Delivery } from '../../delivery-client/src/index.js';
-/** 公開の配信 API の取得先（origin は媒体の識別子までの URL、例: <公開の配信 API のオリジン>/demo） */
+/** 記録の1件（記録のファイルの JSON） */
+export type FixtureResponse = Readonly<{
+    method: string;
+    path: string;
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+}>;
+/** 呼び出しの記録のファイル名（メソッド・パス・If-None-Match・本文のハッシュ） */
+export declare const fixtureName: (method: string, path: string, ifNoneMatch?: string, body?: string) => string;
+/** 記録の再生（port Delivery、dir は記録のディレクトリ） */
+export declare function fixtureDelivery(dir: string | URL): Delivery;
+/** 公開の配信 API の中継先（origin は媒体の識別子までの URL、例: <公開の配信 API のオリジン>/demo） */
 export type Upstream = Readonly<{
     origin: string;
     apiKey: string;
     previewSecret?: string;
 }>;
-/** 記録の配信 API の指定（dir は記録のディレクトリ、upstream があれば中継して記録） */
-export type FixtureOptions = Readonly<{
-    dir: string | URL;
-    upstream?: Upstream;
-}>;
-/** 記録の配信 API（port Delivery、upstream があれば中継して保存、並行の書き込みは一時のファイルから置き換え） */
-export declare function fixtureDelivery({ dir, upstream }: FixtureOptions): Delivery;
-/** 手元の配信 API のサーバー（/content/v1/… だけ、記録にない呼び出しは502、戻り値は origin と停止の関数） */
-export declare function serveDelivery(options: FixtureOptions & Readonly<{
+/** 公開の配信 API への中継（port Delivery、読み取りだけで書き込みの操作は405） */
+export declare function relayDelivery({ origin, apiKey, previewSecret }: Upstream): Delivery;
+/** 手元の配信 API のサーバー（/content/v1/… だけ、失敗は502、戻り値は origin と停止の関数） */
+export declare function serveDelivery(delivery: Delivery, options?: Readonly<{
     port?: number;
     hostname?: string;
 }>): Promise<Readonly<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryusenkei/maezae",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "maezae の導入先のサイト向けの SDK（配信 API の取得・本文の型・プレビューの署名・手元の開発の配信 API）",
   "license": "UNLICENSED",
   "author": "RYUSENKEI",