@ryusenkei/maezae 0.4.0 → 0.5.0

package/dist/dev.d.ts

@@ -0,0 +1 @@
+export * from './types/sdk/src/dev.js';

package/dist/dev.js

@@ -0,0 +1,100 @@
+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 { createServer } from "node:http";
+import { pathToFileURL } from "node:url";
+// src/dev.ts
+/** 記録する応答のヘッダー（配信のキャッシュの照合と本文の形式） */
+const KEPT_HEADERS = [
+	"content-type",
+	"etag",
+	"x-stale"
+];
+/** 記録のディレクトリの 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 }) {
+	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
+		});
+	};
+}
+/** 手元の配信 API のサーバー（/content/v1/… だけ、記録にない呼び出しは502、戻り値は origin と停止の関数） */
+async function serveDelivery(options) {
+	const delivery = fixtureDelivery(options);
+	const server = createServer(async (req, res) => {
+		const chunks = [];
+		for await (const chunk of req) chunks.push(chunk);
+		const path = req.url ?? "/";
+		if (!path.startsWith("/content/v1")) {
+			res.writeHead(404).end();
+			return;
+		}
+		const headers = Object.entries(req.headers).flatMap(([k, v]) => typeof v === "string" && k !== "host" ? [[k, v]] : []);
+		try {
+			const response = await delivery(path, {
+				method: req.method ?? "GET",
+				headers,
+				...chunks.length ? { body: Buffer.concat(chunks).toString("utf8") } : {}
+			});
+			const out = {};
+			response.headers.forEach((v, k) => out[k] = v);
+			res.writeHead(response.status, out);
+			res.end(Buffer.from(await response.arrayBuffer()));
+		} catch (e) {
+			res.writeHead(502, { "content-type": "text/plain; charset=utf-8" }).end(e instanceof Error ? e.message : String(e));
+		}
+	});
+	const hostname = options.hostname ?? "127.0.0.1";
+	await new Promise((resolve) => server.listen(options.port ?? 0, hostname, resolve));
+	const address = server.address();
+	return {
+		origin: `http://${hostname}:${typeof address === "object" && address ? address.port : options.port}`,
+		close: () => new Promise((resolve) => server.close(() => resolve()))
+	};
+}
+export { fixtureDelivery, serveDelivery };

package/dist/types/cms-contract/src/errors.d.ts

@@ -45,6 +45,7 @@ export declare const ERROR_STATUS: {
     readonly upstream_failed: 502;
     readonly not_configured: 503;
     readonly unavailable: 503;
+    readonly writes_paused: 503;
     readonly job_failed: 500;
     readonly internal_error: 500;
     readonly network_error: 0;

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

@@ -0,0 +1,22 @@
+import type { Delivery } from '../../delivery-client/src/index.js';
+/** 公開の配信 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<{
+    port?: number;
+    hostname?: string;
+}>): Promise<Readonly<{
+    origin: string;
+    close: () => Promise<void>;
+}>>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ryusenkei/maezae",
-  "version": "0.4.0",
-  "description": "maezae の導入先のサイト向けの SDK（配信 API の取得・本文の型・プレビューの署名）",
+  "version": "0.5.0",
+  "description": "maezae の導入先のサイト向けの SDK（配信 API の取得・本文の型・プレビューの署名・手元の開発の配信 API）",
   "license": "UNLICENSED",
   "author": "RYUSENKEI",
   "repository": {
@@ -39,6 +39,10 @@
     "./trace": {
       "types": "./dist/trace.d.ts",
       "default": "./dist/trace.js"
+    },
+    "./dev": {
+      "types": "./dist/dev.d.ts",
+      "default": "./dist/dev.js"
     }
   },
   "files": [