@ryusenkei/maezae 0.4.0 → 0.6.0

package/dist/dev.d.ts

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

package/dist/dev.js

@@ -0,0 +1,85 @@
+import { i as SIGNED_HEADERS, s as signedHeaders } from "./src-Baj-EC2G.js";
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { createServer } from "node:http";
+import { pathToFileURL } from "node:url";
+// src/dev.ts
+/** 呼び出しの記録のファイル名（メソッド・パス・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}/`);
+};
+/** 記録の再生（port Delivery、dir は記録のディレクトリ） */
+function fixtureDelivery(dir) {
+	const base = dirUrl(dir);
+	return async (path, init = {}) => {
+		const method = (init.method ?? "GET").toUpperCase();
+		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(delivery, 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, fixtureName, relayDelivery, 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,29 @@
+import type { Delivery } from '../../delivery-client/src/index.js';
+/** 記録の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 への中継（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<{
+    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.6.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": [