@ryusenkei/maezae 0.18.1 → 0.20.0

package/README.md

@@ -13,6 +13,7 @@ maezae の SDK（導入先のサイト向け）
 | `@ryusenkei/maezae/analytics` | サイトの閲覧の記録（CMS の閲覧数の集計と同じ形式） |
 | `@ryusenkei/maezae/trace` | CMS のログと相関を取るトレースの区間 |
 | `@ryusenkei/maezae/integrations` | 外の関数・Webhook が受け取る本文の型と署名の検証（ヘッダー `x-cms-signature`） |
+| `@ryusenkei/maezae/schema` | 配信 API の値の型の定義の生成とずれの検査（CLI `maezae-types`、Node） |
 
 ## 取得（Cloudflare Workers の service binding）
 
@@ -131,6 +132,38 @@ try {
 }
 ```
 
+## スキーマを取る口（0.19.0 から）
+
+スキーマの正本は CMS。サイトは `schema.json` の写しを置かず、次の3つに分ける
+
+| 値 | 置き場所 | 取り方 |
+| --- | --- | --- |
+| コードが前提にする形（型の id、項目の key と種類、複数か、選択肢の値） | リポに置く生成のファイル | `maezae-types` で生成し、`--check` でずれを止める |
+| 編集で変わる値（表示名、文字数の上限、URL の形） | 置かない | 実行時に `GET /content/v1/types` を読み、`optionLabels`・`limitOf`・`pagePath`（`@ryusenkei/maezae/delivery`）に渡す |
+| 本文の設定と部品の宣言 | 置かない | CMS が保存のときに検査する。知らない部品は描画しない |
+
+```sh
+# 生成（API の鍵は MAEZAE_API_KEY、URL は --url か MAEZAE_DELIVERY_URL）
+npx maezae-types --out src/cms-types.ts --url https://example.com/<媒体>
+# ずれの検査（CI と pre-push。CMS で項目を足すと失敗し、生成し直してコミットする）
+npx maezae-types --out src/cms-types.ts --check
+```
+
+- 生成のファイル: 型ごとに `export type <PascalCase の型の id>`（`ItemOf` と同じ値の形）、全体の対応 `CmsTypes`、型の id の一覧 `TYPE_IDS`。表示名・上限・配信しない項目は含めないので、管理画面での表示名の変更ではずれにならない
+- 整形の対象から外す（`--check` は文字の一致で比べる。改行の CRLF は同じとみなす）
+- 識別子でない key（`lab-note` など）は引用符で囲む（0.20.0 から）
+- 終了の状態（0.20.0 から、`TYPES_EXIT_CODES`）: 成功は `0`、ずれは `1`、引数と鍵の不足や CMS の拒否（4xx）は `2`、CMS に届かない（接続の失敗、5xx）ときは `3`。CMS が止まったときに検査を省くなら、`3` だけを通す
+- 同じ処理を Node のスクリプトから呼ぶときは `runTypesCli`（`@ryusenkei/maezae/schema`）。戻り値が終了の状態で、例外を投げない
+- MCP の `get_schema` も同じ文を返す（`format: "typescript"`）。管理画面の「設定 → データ」の型定義のエクスポートも同じ文
+
+## 公開のフォーム（お問い合わせ）
+
+お問い合わせのモジュールを有効にした媒体は、toolkit の `@ryusenkei/web/form` の形でフォームを受け付ける
+
+- `GET /content/v1/forms/contact`: 項目の宣言 `{ form, label, fields, labels, choices }`。`fields` は web/form の宣言のまま（`parseForm` と画面の検査にそのまま渡せる）、`labels` は項目の名前、`choices` は選択肢の表示。ご用件と上限は CMS の設定から作るので、サイトは写しを持たない
+- `POST /content/v1/forms/contact`: 本文は項目の値の JSON。受け付けは `200 { ok: true, requestId, id }`（`id` は受付の番号、転送だけの設定は `null`）、検査の失敗は `400 { ok: false, error: "invalid", problems }`（文言は web/form の `FORM_MESSAGES_JA` で引く）
+- ボット対策と送信元ごとの回数の制限はサイトの受け取りの処理で行う（web/form の `submissionHandler` の `botCheck`・`rateLimiter`、CMS への転送は `httpDestination` に API の鍵を付ける）
+
 ## 回数の制限
 
 - 対象は公開のエンドポイント（`https://api.maezae.app/<媒体>/content/v1/…`）だけ。上限は媒体と API の鍵ごとに1分で600回で、データセンターごとの近似で数える
@@ -243,7 +276,8 @@ if (body.hook === 'publish_check' && body.dryRun) problems.push(...(await verify
 
 - `event`: `submitted`（レビューの依頼）・`published`（公開）・`unpublished`（非公開）・`rejected`（差し戻し）。型は `type`（型の ID）で判断する（型の ID を変えても `event` は変わらない）
 - `id`: イベントの ID（再送しても同じ値、重複の除去に使用）、`item`: 行の ID と題、`by`: 操作した人の表示名、`at`: 出来事の日時
-- 拡張機能の出来事（例: お問い合わせの `contact.received`）: `{ version: 1, id, event: "contact.received", data, at }`（接頭辞はモジュールの ID で型の ID ではない）
+- 拡張機能の出来事: `{ version: 1, id, event, data, at }`（`event` は拡張機能が宣言した名前で、接頭辞は型の ID ではない）
+- 公開のフォームの送信（お問い合わせの `form.submitted`）: toolkit の `@ryusenkei/web/form` の `webhookDestination` と同じ `{ event: "form.submitted", id, form, values, order, receivedAt }`。`id` は送信ごとの UUID、`values` は項目の値（未入力の項目は含めない）、`order` は宣言の項目の順。署名は `x-cms-signature`
 - 購読: 管理画面の「設定 → 連携」で、送る出来事と対象の型を別々に選ぶ。編集の出来事は「選んだ出来事 × 選んだ型」で届く
 
 ```ts

package/dist/analytics.js

@@ -6,27 +6,43 @@ const dayIn = (timeZone, at = /* @__PURE__ */ new Date()) => new Intl.DateTimeFo
 	month: "2-digit",
 	day: "2-digit"
 }).format(at);
-// ../analytics/src/record.ts
+// ../analytics/src/view.ts
+/** 位置で持つ記録先の列の順 */
+const VIEW_COLUMNS = [
+	"kind",
+	"id",
+	"path",
+	"date",
+	"event",
+	"project"
+];
 const BOT = /bot|crawl|spider|slurp|preview|monitor|headless/i;
 /** ボットの UA か */
 const isBot = (userAgent) => BOT.test(userAgent ?? "");
-/** 閲覧を1件記録（対象: GET で応答が200の HTML・ボット以外、記録の失敗は無視） */
-function recordView(dataset, request, response, { classify, timeZone, project }) {
-	if (!dataset || request.method !== "GET" || response.status !== 200) return;
-	if (!response.headers.get("content-type")?.includes("text/html") || isBot(request.headers.get("user-agent"))) return;
+/** 閲覧の出来事（対象: GET で応答が200の HTML・ボット以外、ほかは null） */
+function viewOf(request, response, { classify, timeZone, project }) {
+	if (request.method !== "GET" || response.status !== 200) return null;
+	if (!response.headers.get("content-type")?.includes("text/html") || isBot(request.headers.get("user-agent"))) return null;
 	const path = new URL(request.url).pathname;
 	const { kind, id } = classify(path);
+	return {
+		kind,
+		id,
+		path,
+		date: dayIn(timeZone),
+		event: "view",
+		...project !== void 0 && { project }
+	};
+}
+// src/analytics.ts
+/** 閲覧を1件記録（対象: GET で応答が200の HTML・ボット以外、binding なしと記録の失敗は無視） */
+function recordView(dataset, request, response, options) {
+	const view = dataset && viewOf(request, response, options);
+	if (!view) return;
 	try {
 		dataset.writeDataPoint({
-			blobs: [
-				kind,
-				id,
-				path,
-				dayIn(timeZone),
-				"view",
-				project ?? ""
-			],
-			indexes: [project ?? kind]
+			blobs: VIEW_COLUMNS.map((key) => view[key] ?? ""),
+			indexes: [view.project ?? view.kind]
 		});
 	} catch {}
 }

package/dist/client-ClY3gSSd.js

@@ -0,0 +1,137 @@
+// src/delivery/query.ts
+const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+const OPS = [
+	"eq",
+	"ne",
+	"in",
+	"gte",
+	"lte",
+	"begins",
+	"exists"
+];
+/** in・ids の値の検査（コンマを含む値はクエリで区切れない） */
+const joined = (values) => {
+	const parts = values.map(String);
+	const bad = parts.find((p) => p.includes(","));
+	if (bad !== void 0) throw new Error(`in・ids の値にコンマは不可: ${bad}`);
+	return parts.join(",");
+};
+/** 一覧の指定をクエリの組に（find・get・subPath の params、一式の path に使用、1件の取得の fields にも使用） */
+function listParams(query) {
+	const params = {};
+	for (const [key, value] of Object.entries(query.filter ?? {})) {
+		if (value === void 0) continue;
+		if (!isRecord(value)) {
+			params[`filter[${key}]`] = String(value);
+			continue;
+		}
+		for (const op of OPS) if (value[op] !== void 0) params[`filter[${key}][${op}]`] = op === "in" ? joined(value[op]) : String(value[op]);
+	}
+	if (query.ids) params.ids = joined(query.ids);
+	if (query.fields?.length) params.fields = joined(query.fields);
+	if (query.order?.length) params.order = query.order.join(",");
+	if (query.limit !== void 0) params.limit = String(query.limit);
+	if (query.cursor) params.cursor = query.cursor;
+	return params;
+}
+// src/delivery/client.ts
+/** 配信 API のパスの前半 */
+const DELIVERY_PATH = "/content/v1";
+/** 配信 API の取得の失敗（call: 失敗した経路、status: 応答のステータス） */
+var DeliveryError = class extends Error {
+	call;
+	status;
+	constructor(call, status, body) {
+		super(`配信 API ${call}: ${status}${body ? ` ${body}` : ""}`);
+		this.name = "DeliveryError";
+		this.call = call;
+		this.status = status;
+	}
+};
+/** 配信 API の中のパスとクエリ（一式の path と結果のキー） */
+const subPath = (path, params = {}) => {
+	const q = new URLSearchParams(params).toString();
+	return `${path}${q ? `?${q}` : ""}`;
+};
+/**
+* 配信 API の読み取り
+* - drafts: 下書き・予約なども含める（プレビュー用、署名は接続の側で付与）
+* - at: 公開の基準の日時（なしは今）
+*/
+function createDeliveryClient(delivery, { drafts = false, at } = {}) {
+	const query = (params = {}) => new URLSearchParams({
+		...params,
+		...drafts ? { drafts: "1" } : {},
+		...at ? { at } : {}
+	});
+	const url = (path, params) => {
+		const q = query(params).toString();
+		return `${DELIVERY_PATH}${path}${q ? `?${q}` : ""}`;
+	};
+	let bundled = /* @__PURE__ */ new Map();
+	/** 取得（404は undefined、ほかの失敗は例外、一式で取得済みならその結果） */
+	const find = async (path, params = {}) => {
+		const hit = bundled.get(subPath(path, params));
+		if (hit) {
+			if (hit.status === 404) return void 0;
+			if (hit.status < 200 || hit.status >= 300) throw new DeliveryError(path, hit.status, JSON.stringify(hit.body));
+			return hit.body;
+		}
+		const res = await delivery(url(path, params));
+		if (res.status === 404) return void 0;
+		if (!res.ok) throw new DeliveryError(path, res.status, await res.text());
+		return await res.json();
+	};
+	/** 取得（404も例外） */
+	const get = async (path, params) => {
+		const v = await find(path, params);
+		if (v === void 0) throw new DeliveryError(path, 404, "");
+		return v;
+	};
+	/**
+	* 型の一覧の1ページ（path は型の一覧の経路、例: /post）
+	* - query: 絞り込み・並べ替えと limit、次のページは前の応答の next を cursor に
+	* - 一式で同じ path とクエリを取得済みならその結果（一式の path は `subPath(path, listParams(query))`）
+	*/
+	const page = (path, query) => get(path, listParams(query));
+	/**
+	* 経路の一覧を一式の1回で取得（paths は配信 API の中のパスとクエリ、`*` の区画は一覧の id ごとに展開）
+	* - ifNoneMatch: 前回の ETag（一致すれば notModified で、結果は未取得）
+	*/
+	const prefetch = async (paths, { ifNoneMatch } = {}) => {
+		const q = query();
+		for (const p of paths) q.append("path", p);
+		const res = await delivery(`${DELIVERY_PATH}/bundle?${q}`, ifNoneMatch ? { headers: { "if-none-match": ifNoneMatch } } : {});
+		if (res.status === 304) return {
+			notModified: true,
+			etag: ifNoneMatch ?? null,
+			stale: false,
+			partial: false
+		};
+		if (!res.ok) throw new DeliveryError("/bundle", res.status, await res.text());
+		const { results } = await res.json();
+		bundled = new Map(Object.entries(results));
+		return {
+			notModified: false,
+			etag: res.headers.get("etag"),
+			stale: res.headers.has("x-stale"),
+			partial: res.headers.has("x-partial")
+		};
+	};
+	/**
+	* 変更の一覧の1ページ（since は前回の next、null は全件の取得から）
+	* - 410（保存の期間を過ぎた cursor）は DeliveryError、since なしで取り直す
+	*/
+	const changes = (since, { limit } = {}) => get("/changes", {
+		...since ? { since } : {},
+		...limit !== void 0 ? { limit: String(limit) } : {}
+	});
+	return {
+		find,
+		get,
+		page,
+		prefetch,
+		changes
+	};
+}
+export { listParams as a, subPath as i, DeliveryError as n, createDeliveryClient as r, DELIVERY_PATH as t };

package/dist/delivery.js

@@ -1,3 +1,4 @@
+import { a as listParams, i as subPath, n as DeliveryError, r as createDeliveryClient, t as DELIVERY_PATH } from "./client-ClY3gSSd.js";
 import { a as optionsOf, l as cropRect, o as typeOf, p as createClock, t as pagePathOf, u as croppedHotspot } from "./page-BnwHL-LC.js";
 // src/delivery/cache.ts
 /** 保持した日時（ミリ秒）を置く内部のヘッダー */
@@ -106,142 +107,6 @@ async function readChanges(client, since, apply, { limit } = {}) {
 		if (!page.more) return cursor;
 	}
 }
-// src/delivery/query.ts
-const isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-const OPS = [
-	"eq",
-	"ne",
-	"in",
-	"gte",
-	"lte",
-	"begins",
-	"exists"
-];
-/** in・ids の値の検査（コンマを含む値はクエリで区切れない） */
-const joined = (values) => {
-	const parts = values.map(String);
-	const bad = parts.find((p) => p.includes(","));
-	if (bad !== void 0) throw new Error(`in・ids の値にコンマは不可: ${bad}`);
-	return parts.join(",");
-};
-/** 一覧の指定をクエリの組に（find・get・subPath の params、一式の path に使用、1件の取得の fields にも使用） */
-function listParams(query) {
-	const params = {};
-	for (const [key, value] of Object.entries(query.filter ?? {})) {
-		if (value === void 0) continue;
-		if (!isRecord(value)) {
-			params[`filter[${key}]`] = String(value);
-			continue;
-		}
-		for (const op of OPS) if (value[op] !== void 0) params[`filter[${key}][${op}]`] = op === "in" ? joined(value[op]) : String(value[op]);
-	}
-	if (query.ids) params.ids = joined(query.ids);
-	if (query.fields?.length) params.fields = joined(query.fields);
-	if (query.order?.length) params.order = query.order.join(",");
-	if (query.limit !== void 0) params.limit = String(query.limit);
-	if (query.cursor) params.cursor = query.cursor;
-	return params;
-}
-// src/delivery/client.ts
-/** 配信 API のパスの前半 */
-const DELIVERY_PATH = "/content/v1";
-/** 配信 API の取得の失敗（call: 失敗した経路、status: 応答のステータス） */
-var DeliveryError = class extends Error {
-	call;
-	status;
-	constructor(call, status, body) {
-		super(`配信 API ${call}: ${status}${body ? ` ${body}` : ""}`);
-		this.name = "DeliveryError";
-		this.call = call;
-		this.status = status;
-	}
-};
-/** 配信 API の中のパスとクエリ（一式の path と結果のキー） */
-const subPath = (path, params = {}) => {
-	const q = new URLSearchParams(params).toString();
-	return `${path}${q ? `?${q}` : ""}`;
-};
-/**
-* 配信 API の読み取り
-* - drafts: 下書き・予約なども含める（プレビュー用、署名は接続の側で付与）
-* - at: 公開の基準の日時（なしは今）
-*/
-function createDeliveryClient(delivery, { drafts = false, at } = {}) {
-	const query = (params = {}) => new URLSearchParams({
-		...params,
-		...drafts ? { drafts: "1" } : {},
-		...at ? { at } : {}
-	});
-	const url = (path, params) => {
-		const q = query(params).toString();
-		return `${DELIVERY_PATH}${path}${q ? `?${q}` : ""}`;
-	};
-	let bundled = /* @__PURE__ */ new Map();
-	/** 取得（404は undefined、ほかの失敗は例外、一式で取得済みならその結果） */
-	const find = async (path, params = {}) => {
-		const hit = bundled.get(subPath(path, params));
-		if (hit) {
-			if (hit.status === 404) return void 0;
-			if (hit.status < 200 || hit.status >= 300) throw new DeliveryError(path, hit.status, JSON.stringify(hit.body));
-			return hit.body;
-		}
-		const res = await delivery(url(path, params));
-		if (res.status === 404) return void 0;
-		if (!res.ok) throw new DeliveryError(path, res.status, await res.text());
-		return await res.json();
-	};
-	/** 取得（404も例外） */
-	const get = async (path, params) => {
-		const v = await find(path, params);
-		if (v === void 0) throw new DeliveryError(path, 404, "");
-		return v;
-	};
-	/**
-	* 型の一覧の1ページ（path は型の一覧の経路、例: /post）
-	* - query: 絞り込み・並べ替えと limit、次のページは前の応答の next を cursor に
-	* - 一式で同じ path とクエリを取得済みならその結果（一式の path は `subPath(path, listParams(query))`）
-	*/
-	const page = (path, query) => get(path, listParams(query));
-	/**
-	* 経路の一覧を一式の1回で取得（paths は配信 API の中のパスとクエリ、`*` の区画は一覧の id ごとに展開）
-	* - ifNoneMatch: 前回の ETag（一致すれば notModified で、結果は未取得）
-	*/
-	const prefetch = async (paths, { ifNoneMatch } = {}) => {
-		const q = query();
-		for (const p of paths) q.append("path", p);
-		const res = await delivery(`${DELIVERY_PATH}/bundle?${q}`, ifNoneMatch ? { headers: { "if-none-match": ifNoneMatch } } : {});
-		if (res.status === 304) return {
-			notModified: true,
-			etag: ifNoneMatch ?? null,
-			stale: false,
-			partial: false
-		};
-		if (!res.ok) throw new DeliveryError("/bundle", res.status, await res.text());
-		const { results } = await res.json();
-		bundled = new Map(Object.entries(results));
-		return {
-			notModified: false,
-			etag: res.headers.get("etag"),
-			stale: res.headers.has("x-stale"),
-			partial: res.headers.has("x-partial")
-		};
-	};
-	/**
-	* 変更の一覧の1ページ（since は前回の next、null は全件の取得から）
-	* - 410（保存の期間を過ぎた cursor）は DeliveryError、since なしで取り直す
-	*/
-	const changes = (since, { limit } = {}) => get("/changes", {
-		...since ? { since } : {},
-		...limit !== void 0 ? { limit: String(limit) } : {}
-	});
-	return {
-		find,
-		get,
-		page,
-		prefetch,
-		changes
-	};
-}
 // ../model/src/mediaUrl.ts
 /** 配信する形式と拡張子 */
 const EXTENSIONS = {

package/dist/dev.js

@@ -1,4 +1,4 @@
-import { i as SIGNED_HEADERS, s as signedHeaders } from "./src-C6YqllXw.js";
+import { i as SIGNED_HEADERS, s as signedHeaders } from "./src-BMOqN7Xs.js";
 import { createHash } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
 import { createServer } from "node:http";

package/dist/integrations.js

@@ -1,4 +1,4 @@
-import { a as openValue, i as SIGNED_HEADERS, l as verifyRequest } from "./src-C6YqllXw.js";
+import { a as openValue, i as SIGNED_HEADERS, l as verifyRequest } from "./src-BMOqN7Xs.js";
 import "./src-BrLwIWaT.js";
 // ../cms-contract/src/embeds.ts
 /** URL のクエリの名前（署名つきの文脈） */

package/dist/model.js

@@ -1,5 +1,6 @@
 import { c as coverStart, d as objectPosition, f as stillOf, i as acceptsRole, l as cropRect, m as isDateOnly, n as publicPathOf, o as typeOf, p as createClock, r as FIELD_ROLES, s as coverPosition, t as pagePathOf, u as croppedHotspot } from "./page-BnwHL-LC.js";
 import { i as CORE_COMPONENTS, t as declaredComponentsSchema } from "./declared-Qo-mWnDd.js";
+import { t as typesSourceOf } from "./typesSource-DKTe9a2-.js";
 import "./src-BrLwIWaT.js";
 import { z } from "zod";
 // ../model/src/asset.ts
@@ -751,4 +752,4 @@ const DEFAULT_SCREENS = {
 		"updated_at"
 	] }
 };
-export { CONFIG_FORMAT, DEFAULT_SCHEMA, DEFAULT_SCREENS, IMAGE_TYPE, VIDEO_TYPE, coverPosition, coverStart, createClock, cropRect, croppedHotspot, isDateOnly, mediaSchema, objectPosition, pagePathOf, parseModel, parseScreens, publicPathOf, stillOf, typeOf };
+export { CONFIG_FORMAT, DEFAULT_SCHEMA, DEFAULT_SCREENS, IMAGE_TYPE, VIDEO_TYPE, coverPosition, coverStart, createClock, cropRect, croppedHotspot, isDateOnly, mediaSchema, objectPosition, pagePathOf, parseModel, parseScreens, publicPathOf, stillOf, typeOf, typesSourceOf };

package/dist/preview.js

@@ -1 +1 @@
-export { i as SIGNED_HEADERS, o as signParts, s as signedHeaders, c as verifyParts, l as verifyRequest } from "./src-C6YqllXw.js";
+export { i as SIGNED_HEADERS, o as signParts, s as signedHeaders, c as verifyParts, l as verifyRequest } from "./src-BMOqN7Xs.js";

package/dist/schema-CUrLZWsb.js

@@ -0,0 +1,114 @@
+import { t as typesSourceOf } from "./typesSource-DKTe9a2-.js";
+import { t as DELIVERY_PATH } from "./client-ClY3gSSd.js";
+import { readFileSync, writeFileSync } from "node:fs";
+// src/schema.ts
+/**
+* maezae-types の終了の状態
+* - drift: --check でファイルが CMS のスキーマと違う
+* - failed: 引数と鍵の不足、CMS の拒否（4xx）、応答の形の誤り、ファイルの読み書きの失敗
+* - unreachable: CMS に届かない（接続の失敗、5xx）
+*/
+const TYPES_EXIT_CODES = {
+	ok: 0,
+	drift: 1,
+	failed: 2,
+	unreachable: 3
+};
+/** 標準出力と標準エラーの文 */
+const MESSAGES = {
+	usage: "usage: maezae-types --out <file> [--check] [--url <delivery API URL>]（API key: MAEZAE_API_KEY）",
+	missingUrl: "missing_url: --url か MAEZAE_DELIVERY_URL に配信 API の URL（例: https://example.com/<媒体>）",
+	missingKey: "missing_api_key: 環境変数 MAEZAE_API_KEY",
+	fetchFailed: (status, body) => `fetch_failed: ${status} ${body.slice(0, 200)}`,
+	invalidResponse: "invalid_response: 配信 API の /types の応答に types がない",
+	unreachable: (url, reason) => `cms_unreachable: ${url} ${reason}`,
+	drift: (file) => `schema_drift: ${file} が CMS のスキーマと違う（maezae-types --out ${file} で生成し直す）`,
+	upToDate: (file) => `up_to_date: ${file}`,
+	written: (file) => `written: ${file}`
+};
+/** 引数（--name value と --flag） */
+function argsOf(argv) {
+	const value = (name) => {
+		const i = argv.indexOf(name);
+		return i >= 0 ? argv[i + 1] : void 0;
+	};
+	return {
+		out: value("--out"),
+		url: value("--url"),
+		check: argv.includes("--check")
+	};
+}
+/** 配信 API の /types の応答の失敗（status は HTTP の状態） */
+var TypesResponseError = class extends Error {
+	status;
+	constructor(message, status) {
+		super(message);
+		this.status = status;
+	}
+};
+/**
+* 配信 API の型の一覧（/types、表示名・選択肢・上限・ページの URL の形を含む。実行時に読む値もここから）
+* - 例外: 2xx でなければ `fetch_failed: <状態> <本文>`、本文に types がなければ `invalid_response`、接続の失敗は fetcher の例外のまま
+*/
+async function fetchDeliveredTypes(url, apiKey, fetcher = fetch) {
+	const res = await fetcher(`${url.replace(/\/+$/, "")}${DELIVERY_PATH}/types`, { headers: { authorization: `Bearer ${apiKey}` } });
+	if (!res.ok) throw new TypesResponseError(MESSAGES.fetchFailed(res.status, await res.text().catch(() => "")), res.status);
+	const types = (await res.json().catch(() => null))?.types;
+	if (!Array.isArray(types)) throw new TypesResponseError(MESSAGES.invalidResponse, res.status);
+	return types;
+}
+const messageOf = (e) => {
+	const cause = e instanceof Error && e.cause instanceof Error ? `（${e.cause.message}）` : "";
+	return `${e instanceof Error ? e.message : String(e)}${cause}`;
+};
+/** 取得の失敗の終了の状態と文（接続の失敗と 5xx は unreachable） */
+function fetchFailureOf(url, e) {
+	if (!(e instanceof TypesResponseError)) return {
+		code: TYPES_EXIT_CODES.unreachable,
+		message: MESSAGES.unreachable(url, messageOf(e))
+	};
+	return {
+		code: e.status >= 500 ? TYPES_EXIT_CODES.unreachable : TYPES_EXIT_CODES.failed,
+		message: e.message
+	};
+}
+/** 生成の結果をファイルに書くか、--check でファイルと比べる（戻り値は終了の状態） */
+function writeOrCheck(out, source, check) {
+	if (!check) {
+		writeFileSync(out, source);
+		console.log(MESSAGES.written(out));
+		return TYPES_EXIT_CODES.ok;
+	}
+	let current = null;
+	try {
+		current = readFileSync(out, "utf8").replace(/\r\n/g, "\n");
+	} catch {
+		current = null;
+	}
+	if (current !== source) return console.error(MESSAGES.drift(out)), TYPES_EXIT_CODES.drift;
+	console.log(MESSAGES.upToDate(out));
+	return TYPES_EXIT_CODES.ok;
+}
+/** CLI の本体（戻り値は終了の状態 TYPES_EXIT_CODES、失敗は例外にせず標準エラーと終了の状態で返す） */
+async function runTypesCli(argv, env, fetcher = fetch) {
+	const { out, url = env.MAEZAE_DELIVERY_URL, check } = argsOf(argv);
+	if (!out) return console.error(MESSAGES.usage), TYPES_EXIT_CODES.failed;
+	if (!url) return console.error(MESSAGES.missingUrl), TYPES_EXIT_CODES.failed;
+	const apiKey = env.MAEZAE_API_KEY;
+	if (!apiKey) return console.error(MESSAGES.missingKey), TYPES_EXIT_CODES.failed;
+	let types;
+	try {
+		types = await fetchDeliveredTypes(url, apiKey, fetcher);
+	} catch (e) {
+		const failure = fetchFailureOf(url, e);
+		console.error(failure.message);
+		return failure.code;
+	}
+	try {
+		return writeOrCheck(out, typesSourceOf({ types }), check);
+	} catch (e) {
+		console.error(messageOf(e));
+		return TYPES_EXIT_CODES.failed;
+	}
+}
+export { fetchDeliveredTypes as n, runTypesCli as r, TYPES_EXIT_CODES as t };

package/dist/schema.d.ts

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

package/dist/schema.js

@@ -0,0 +1 @@
+export { t as TYPES_EXIT_CODES, n as fetchDeliveredTypes, r as runTypesCli } from "./schema-CUrLZWsb.js";

package/dist/{src-C6YqllXw.js → src-BMOqN7Xs.js}

@@ -1,32 +1,9 @@
-// ../access/src/jwt.ts
-const CERTS_TTL_MS = 3e5;
-const REFRESH_INTERVAL_MS = 3e4;
-/** 公開鍵の一覧を保持する取得（取得の失敗は保持しない） */
-function cachedCerts(fetcher, clock = Date.now) {
-	const cache = /* @__PURE__ */ new Map();
-	return async (url, refresh = false) => {
-		const hit = cache.get(url);
-		const age = hit ? clock() - hit.at : Infinity;
-		if (hit && age < (refresh ? REFRESH_INTERVAL_MS : CERTS_TTL_MS)) return hit;
-		const fresh = await fetcher(url);
-		cache.set(url, {
-			keys: fresh.keys,
-			at: clock()
-		});
-		return fresh;
-	};
-}
-cachedCerts(async (url) => {
-	const res = await fetch(url);
-	if (!res.ok) throw new Error(`JWKS の取得に失敗（${res.status}）`);
-	return res.json();
-});
-/** base64url の復号 */
-const decodeBase64Url = (s) => Uint8Array.from(atob(s.replace(/-/g, "+").replace(/_/g, "/").padEnd(Math.ceil(s.length / 4) * 4, "=")), (c) => c.charCodeAt(0));
 // ../access/src/signed.ts
 const enc = new TextEncoder();
 /** 既定で許す時刻のずれ（秒） */
 const MAX_SKEW_SEC = 300;
+/** base64url の復号 */
+const decodeBase64Url = (s) => Uint8Array.from(atob(s.replace(/-/g, "+").replace(/_/g, "/").padEnd(Math.ceil(s.length / 4) * 4, "=")), (c) => c.charCodeAt(0));
 /** 経路ごとのヘッダーの名前（署名と主体） */
 const SIGNED_HEADERS = {
 	/** MCP → CMS の署名（鍵は MCP_TOKEN） */
@@ -195,7 +172,7 @@ function startEdgeSpan({ name, request, sampleRate = 1, write = (line) => consol
 			};
 			write(JSON.stringify({
 				level: "info",
-				msg: "span",
+				event: "span",
 				...span
 			}));
 		}

package/dist/trace.js

@@ -1 +1 @@
-export { r as TRACEPARENT_HEADER, t as sampleRateOf, n as withEdgeSpan } from "./src-C6YqllXw.js";
+export { r as TRACEPARENT_HEADER, t as sampleRateOf, n as withEdgeSpan } from "./src-BMOqN7Xs.js";

package/dist/types/access/src/jwt.d.ts

@@ -1,12 +1,9 @@
-type Jwk = JsonWebKey & {
-    kid?: string;
-};
-/** 公開鍵の一覧の取得（引数は JWKS の URL、refresh は保持した値を使用せずに再取得、テストで差し替え） */
-export type FetchCerts = (jwksUrl: string, refresh?: boolean) => Promise<{
-    keys: Jwk[];
-}>;
 /** JWT のクレーム（検証を通った値） */
 export type JwtClaims = Readonly<Record<string, unknown>>;
+/** 公開鍵の一覧の取得の差し替え（テスト用、引数は JWKS の URL） */
+export type FetchCerts = (jwksUrl: string) => Promise<{
+    keys: JsonWebKey[];
+}>;
 /** JWT の検証の設定 */
 export type JwtOptions = Readonly<{
     /** 発行元（iss と完全に一致） */
@@ -15,15 +12,12 @@ export type JwtOptions = Readonly<{
     audience: string | readonly string[];
     /** 公開鍵の一覧の URL */
     jwksUrl: string;
+    /** 現在時刻（ミリ秒、テスト用） */
     now?: number;
     certs?: FetchCerts;
 }>;
-/** 公開鍵の一覧を保持する取得（取得の失敗は保持しない） */
-export declare function cachedCerts(fetcher: FetchCerts, clock?: () => number): FetchCerts;
-/** base64url の復号 */
-export declare const decodeBase64Url: (s: string) => Uint8Array<ArrayBuffer>;
 /** 検証を通った JWT のクレーム（署名・発行元・宛先・期限のどれかが違えば null） */
-export declare function verifyJwt(token: string, { issuer, audience, jwksUrl, now, certs }: JwtOptions): Promise<JwtClaims | null>;
+export declare function verifyJwt(token: string, options: JwtOptions): Promise<JwtClaims | null>;
 /**
  * Cloudflare Access の JWT を検証する設定（teamDomain は <チーム>.cloudflareaccess.com、aud はアプリの AUD）
  * - aud: カンマ区切りで複数のアプリ（ホスト名ごとにアプリが分かれる管理画面、どのアプリを通すかは Access がホスト名で判定）
@@ -39,4 +33,3 @@ export declare function verifyAccessJwt(token: string, { teamDomain, aud, now, c
     now?: number;
     certs?: FetchCerts;
 }): Promise<string | null>;
-export {};

package/dist/types/analytics/src/index.d.ts

@@ -1,5 +1,5 @@
-export { recordView, type Classify, type Dataset } from './record.js';
+export { type Classify, VIEW_COLUMNS, type ViewEvent, viewOf, type ViewOptions } from './view.js';
 export { syncCron } from './schedule.js';
 export { isViewsCron, sharedViews, viewsFor, viewsSince, viewsSyncOf } from './shared.js';
-export { analyticsEngine, type DailyRow, fixedSource, type Source, projectDaily, type ProjectSource, renamedSource } from './source.js';
+export { type DailyRow, fixedSource, type ProjectSource, renamedSource, type Source } from './source.js';
 export { readDaily, syncDaily } from './store.js';

package/dist/types/analytics/src/source.d.ts

@@ -9,27 +9,11 @@ export type DailyRow = {
 export type Source = {
     daily(since: string): Promise<DailyRow[]>;
 };
-/** Analytics Engine の接続の設定（token は Account Analytics の読み取りの API トークン、project は絞り込む媒体の識別子） */
-type AnalyticsEngineOptions = {
-    accountId: string;
-    token: string;
-    dataset: string;
-    project?: string;
-};
-/** 1回の問い合わせの行数 */
-export declare const PAGE_ROWS = 10000;
-/** 問い合わせの回数の上限（PAGE_ROWS との積が1回で集計できる行数） */
-export declare const MAX_PAGES = 20;
-/** Analytics Engine の SQL API の読み込み元 */
-export declare function analyticsEngine({ accountId, token, dataset, project }: AnalyticsEngineOptions): Source;
 /** 全媒体の読み込み元の型（since 以降の日付の閲覧数を媒体の識別子ごとに） */
 export type ProjectSource = {
     dailyByProject(since: string): Promise<ReadonlyMap<string, DailyRow[]>>;
 };
-/** 全媒体を1回の問い合わせで集計する Analytics Engine の読み込み元（媒体の列が空の記録は除外） */
-export declare function projectDaily(options: Omit<AnalyticsEngineOptions, 'project'>): ProjectSource;
 /** 集計済みの行の読み込み元（定期の集計で全媒体の問い合わせ結果を媒体ごとに受け渡し、daily は since 以降の行） */
 export declare const fixedSource: (rows: readonly DailyRow[]) => Source;
 /** 種類を付け替えた読み込み元（renames は旧の種類 → 今の種類、付け替えで重なった行は閲覧数を合計） */
 export declare function renamedSource(source: Source, renames: Readonly<Record<string, string>>): Source;
-export {};

package/dist/types/analytics/src/view.d.ts

@@ -0,0 +1,24 @@
+/** パスから種類と ID への対応（利用側が定義、例: /articles/<id> は記事） */
+export type Classify = (path: string) => {
+    kind: string;
+    id: string;
+};
+/** 閲覧の出来事（project は媒体の識別子） */
+export type ViewEvent = Readonly<{
+    kind: string;
+    id: string;
+    path: string;
+    date: string;
+    event: 'view';
+    project?: string;
+}>;
+/** 位置で持つ記録先の列の順 */
+export declare const VIEW_COLUMNS: readonly ["kind", "id", "path", "date", "event", "project"];
+/** 出来事にする設定（project は媒体の識別子） */
+export type ViewOptions = Readonly<{
+    classify: Classify;
+    timeZone: string;
+    project?: string;
+}>;
+/** 閲覧の出来事（対象: GET で応答が200の HTML・ボット以外、ほかは null） */
+export declare function viewOf(request: Request, response: Response, { classify, timeZone, project }: ViewOptions): ViewEvent | null;

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

@@ -9,7 +9,7 @@ export { type CallApi, type ConnectionPoint, type ContentTypePoint, createModule
 export { applyFieldRules, autoFieldsOf, type FieldRule, hiddenFieldsOf, restrictedChoicesOf, restrictedProblemsOf } from './fieldRules.js';
 export { pendingIds, pendingValue } from './pending.js';
 export { type AccountLink, type Action, ACTION_LEVELS, ACTIONS, allows, ANY_TARGET, canChangeRow, canDeleteContent, canEditContent, canPublishContent, canReadContent, canReadRow, canSubmitContent, checkPermissions, type ContentAccess, type Level, LEVELS, levelOf, ownsContent, ownsRow, type Permissions, type RowAccess } from './permissions.js';
-export { ADMIN_PERMISSIONS, ADMIN_ROLE, defaultRoleOf, isAdmin, rolePermissionsOf, type Role, SYSTEM_ROLES, type User, WRITER_ROLE } from './roles.js';
+export { ADMIN_PERMISSIONS, ADMIN_ROLE, defaultRoleOf, isAdmin, rolePermissionsOf, type Role, SYSTEM_ROLES, type User, DEFAULT_ROLE } from './roles.js';
 export { isServerPath, OPS_PATHS, SERVER_PATHS } from './paths.js';
 export { CONFIG_FORMAT, type ConfigBundle, type ConfigPreview } from './transfer.js';
 export { IMPORT_ITEMS_MAX, IMPORT_PROBLEM_LABELS, IMPORT_PROBLEMS, type ImportIdChange, type ImportIdConflict, importIdOf, type ImportIdPlan, type ImportImage, type ImportItem, type ImportItemReport, type ImportProblem, type ImportProblemCode, type ImportReport, importReportOf, mergeImportReports, type MicroCmsApiInput, type MicroCmsContentResult, type MicroCmsDropped, type MicroCmsNote, planImportIds, sourceOf } from './import.js';

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

@@ -1,15 +1,15 @@
 import { type AccountLink, type Permissions } from './permissions.js';
 /** 管理者のロールの ID */
 export declare const ADMIN_ROLE = "admin";
-/** ライターのロールの ID（あれば新しいアカウントの既定、削除できる） */
-export declare const WRITER_ROLE = "writer";
+/** 新しいアカウントの既定のロールの ID（テンプレートのロールの ID、あれば既定、削除できる） */
+export declare const DEFAULT_ROLE = "writer";
 /** 管理者の権限の表（すべての対象・操作が可、DB の値より優先） */
 export declare const ADMIN_PERMISSIONS: Permissions;
 /** ロールの権限の表（管理者のロールは固定の表、ほかは保存した表） */
 export declare const rolePermissionsOf: (roleId: string, stored: Permissions) => Permissions;
 /** 削除できないロールの ID */
 export declare const SYSTEM_ROLES: readonly string[];
-/** 新しいアカウントの既定のロール（ライター、なければ管理者以外の最初のロール、それもなければ管理者） */
+/** 新しいアカウントの既定のロール（DEFAULT_ROLE、なければ管理者以外の最初のロール、それもなければ管理者） */
 export declare const defaultRoleOf: (roles: readonly Pick<Role, "id">[]) => string;
 /** ロール（API /api/roles の行） */
 export type Role = Readonly<{

package/dist/types/model/src/index.d.ts

@@ -2,11 +2,12 @@ export { fieldZod, jsonSchemaOf, normalizeValues, zodOf, type ValueOptions } fro
 export { assetRefSchema, cropSchema, hotspotSchema, mediaSchema, type Asset, type AssetRef, type Crop, type DeliveredAsset, type Hotspot, type LocalImage, type Media } from './asset.js';
 export { coverPosition, coverStart, cropRect, croppedHotspot, objectPosition, stillOf, type CropRect } from './image.js';
 export { IMAGE_TYPE, VIDEO_TYPE } from './media.js';
-export { IMAGE_SIZE_MAX, imageParamsOf, MEDIA_SIGNING_KEY_BLOB, mediaBlobKeyOf, mediaExtOf, mediaKindOf, mediaMimeOf, mediaPathOf, parseMediaPath, signMediaUrl, verifyMediaUrl, withImageParams, type ImageParams, type AssetKind, type MediaPath } from './mediaUrl.js';
+export { IMAGE_SIZE_MAX, imageParamsOf, isMediaId, MEDIA_SIGNING_KEY_BLOB, mediaBlobKeyOf, mediaExtOf, mediaKindOf, mediaMimeOf, mediaPathOf, parseMediaPath, signMediaUrl, verifyMediaUrl, withImageParams, type ImageParams, type AssetKind, type MediaPath } from './mediaUrl.js';
 export { diffSchema, renameType, type ChangeKind, type ChangeLevel, type DiffOptions, type SchemaChange } from './changes.js';
 export { dateRoleFieldsOf, primaryTypeOf, requiredPrimaryTypeOf, SOURCES_FIELD, sourceIdsOf, sourcesFieldOf, sourceTypeOf, type SourcesField } from './capabilities.js';
 export { appliesTo, checkFields, fieldsFor } from './check.js';
 export { deliveredFields, emptyValues, pickValues, referencedIds, referencesOf, valueFieldsOf } from './values.js';
+export { typesSourceOf } from './typesSource.js';
 export { entryRefsOf, type EntryRef } from './refs.js';
 export { acceptsRole, bodyFieldsOf, computedFieldsOf, FIELD_ROLES, idInputOf, initialValueOf, isPublishable, isInputField, isListType, isMediaType, isSingleton, isStoredType, MEDIA_TYPE_IDS, optionLabelOf, optionsOf, publishingOf, requestReferencesOf, resolvedRolesOf, roleFieldOf, toneOf, typeOf, type ComputedKind, type FieldRole, type FieldRoles, type FieldComputed, type ContentFormat, type ContentModel, type ContentType, type FieldCondition, type FieldDef, type FieldDerive, type FieldFixedBy, type CountDef, type FieldProblem, type MediaKind, type OptionTone, type Publishing, type ReferenceRules, type SelectOption, usesReview } from './model.js';
 export { hasPublicPage, imageFrameOf, pagePathOf, publicPathOf, withPagesFrom, type ImageFrame, type ImageFrameDef, type PageDef, type PageEntry, type PageRule } from './page.js';

package/dist/types/model/src/mediaUrl.d.ts

@@ -16,6 +16,8 @@ export type MediaPath = Readonly<{
     width?: number;
     height?: number;
 }>;
+/** 実体の ID の形か（CMS の /media と配信の Worker の共通、保存先のほかのキーを ID として読ませない） */
+export declare const isMediaId: (id: string) => boolean;
 /** 配信 URL のパス（媒体・ID の形が不正、配信しない形式なら null） */
 export declare function mediaPathOf({ kind, project, id, mimeType, width, height }: Readonly<{
     kind: AssetKind;

package/dist/types/model/src/typesSource.d.ts

@@ -0,0 +1,7 @@
+import type { ContentModel } from './model.js';
+/**
+ * スキーマから配信 API の値の型の定義（TypeScript のモジュールの文）
+ * - 型ごとに `export type <PascalCase の型の id>`、全体の対応 `CmsTypes` と型の id の一覧 `TYPE_IDS`
+ * - types: 配信する型だけ（メディアの型を除いた一覧、配信 API の `/types` の値）
+ */
+export declare function typesSourceOf(model: Pick<ContentModel, 'types'>): string;

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

@@ -1,2 +1,12 @@
-export { recordView } from '../../analytics/src/index.js';
-export type { Classify, Dataset } from '../../analytics/src/index.js';
+import { type Classify, type ViewOptions } from '../../analytics/src/index.js';
+export type { Classify };
+/** Analytics Engine のデータセットの binding（書き込みだけ） */
+export type Dataset = {
+    writeDataPoint(point: {
+        blobs?: string[];
+        doubles?: number[];
+        indexes?: string[];
+    }): void;
+};
+/** 閲覧を1件記録（対象: GET で応答が200の HTML・ボット以外、binding なしと記録の失敗は無視） */
+export declare function recordView(dataset: Dataset | undefined, request: Request, response: Response, options: ViewOptions): void;

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

@@ -1,4 +1,4 @@
-export { coverPosition, coverStart, createClock, cropRect, croppedHotspot, IMAGE_TYPE, isDateOnly, mediaSchema, objectPosition, pagePathOf, parseModel, parseScreens, publicPathOf, stillOf, typeOf, VIDEO_TYPE } from '../../model/src/index.js';
+export { coverPosition, coverStart, createClock, cropRect, croppedHotspot, IMAGE_TYPE, isDateOnly, mediaSchema, objectPosition, pagePathOf, parseModel, parseScreens, publicPathOf, stillOf, typeOf, typesSourceOf, VIDEO_TYPE } from '../../model/src/index.js';
 export type { Asset, AssetRef, Clock, ContentModel, ContentType, Crop, CropRect, DateString, FieldDef, Hotspot, LocalImage, Media, PageDef, PageEntry, ScreenSettings } from '../../model/src/index.js';
 export { CONFIG_FORMAT } from '../../cms-contract/src/index.js';
 export type { ConfigBundle } from '../../cms-contract/src/index.js';

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

@@ -0,0 +1,20 @@
+import { type ContentType } from '../../model/src/index.js';
+/**
+ * maezae-types の終了の状態
+ * - drift: --check でファイルが CMS のスキーマと違う
+ * - failed: 引数と鍵の不足、CMS の拒否（4xx）、応答の形の誤り、ファイルの読み書きの失敗
+ * - unreachable: CMS に届かない（接続の失敗、5xx）
+ */
+export declare const TYPES_EXIT_CODES: {
+    readonly ok: 0;
+    readonly drift: 1;
+    readonly failed: 2;
+    readonly unreachable: 3;
+};
+/**
+ * 配信 API の型の一覧（/types、表示名・選択肢・上限・ページの URL の形を含む。実行時に読む値もここから）
+ * - 例外: 2xx でなければ `fetch_failed: <状態> <本文>`、本文に types がなければ `invalid_response`、接続の失敗は fetcher の例外のまま
+ */
+export declare function fetchDeliveredTypes(url: string, apiKey: string, fetcher?: typeof fetch): Promise<readonly ContentType[]>;
+/** CLI の本体（戻り値は終了の状態 TYPES_EXIT_CODES、失敗は例外にせず標準エラーと終了の状態で返す） */
+export declare function runTypesCli(argv: readonly string[], env: Readonly<Record<string, string | undefined>>, fetcher?: typeof fetch): Promise<number>;

package/dist/types/sdk/src/types-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/types-cli.d.ts

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

package/dist/types-cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { r as runTypesCli } from "./schema-CUrLZWsb.js";
+// src/types-cli.ts
+process.exitCode = await runTypesCli(process.argv.slice(2), process.env);

package/dist/typesSource-DKTe9a2-.js

@@ -0,0 +1,64 @@
+// ../model/src/values.ts
+/** 配信する項目（非公開の項目を除く、まとまりの中も） */
+const deliveredFields = (fields) => fields.filter((f) => !f.private).map((f) => f.type === "group" ? {
+	...f,
+	fields: deliveredFields(f.fields)
+} : f);
+// ../model/src/typesSource.ts
+/** 生成した型の定義が SDK から読む型の import の元 */
+const SDK = "@ryusenkei/maezae";
+/** 型の import の行（指定は JSON の文字列の形） */
+const importLine = (names, spec) => `import type { ${names.join(", ")} } from ${JSON.stringify(spec)};`;
+/** プロパティの名前（識別子でない key は JSON の文字列の形） */
+const propertyName = (key) => /^[A-Za-z_$][\w$]*$/.test(key) ? key : JSON.stringify(key);
+const pascal = (id) => id.replace(/(^|[-_])(\w)/g, (_, __, ch) => ch.toUpperCase());
+/** 項目の1つ分の値の型（SDK の SingleValue と同じ） */
+function singleOf(f, indent) {
+	switch (f.type) {
+		case "text":
+		case "textarea":
+		case "datetime":
+		case "reference": return "string";
+		case "date": return "DateString";
+		case "number": return "number";
+		case "checkbox": return "boolean";
+		case "select": return f.options.map((o) => JSON.stringify(o.value)).join(" | ") || "string";
+		case "media": return "DeliveredAsset | null";
+		case "body": return "Body<DeliveredAsset | null>";
+		case "group": return `{\n${fieldsOf(deliveredFields(f.fields), `${indent}  `)}\n${indent}}`;
+	}
+}
+/** 項目の値の型（SDK の FieldValue と同じ、複数は readonly の配列、値なしは null） */
+const valueOf = (f, indent) => {
+	const one = singleOf(f, indent);
+	if ("multiple" in f && f.multiple) return `readonly ${one.includes(" | ") ? `(${one})` : one}[] | null`;
+	return one.endsWith(" | null") ? one : `${one} | null`;
+};
+/** 配信する項目の種類（まとまりの中を含む） */
+const kindsOf = (fields) => deliveredFields(fields).flatMap((f) => [f.type, ...f.type === "group" ? kindsOf(f.fields) : []]);
+const fieldsOf = (fields, indent) => fields.map((f) => `${indent}readonly ${propertyName(f.key)}: ${valueOf(f, indent)};`).join("\n");
+const typeOf = (t) => `export type ${pascal(t.id)} = Readonly<{\n  id: string;\n  _meta: ItemMeta;\n${fieldsOf(deliveredFields(t.fields), "  ")}\n}>;`;
+/**
+* スキーマから配信 API の値の型の定義（TypeScript のモジュールの文）
+* - 型ごとに `export type <PascalCase の型の id>`、全体の対応 `CmsTypes` と型の id の一覧 `TYPE_IDS`
+* - types: 配信する型だけ（メディアの型を除いた一覧、配信 API の `/types` の値）
+*/
+function typesSourceOf(model) {
+	const types = [...model.types].sort((a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0);
+	const kinds = new Set(types.flatMap((t) => kindsOf(t.fields)));
+	const uses = (kind) => kinds.has(kind);
+	const delivery = ["ItemMeta", ...uses("media") || uses("body") ? ["DeliveredAsset"] : []].sort();
+	return [
+		"// Generated from the CMS schema (GET /content/v1/types). Do not edit; regenerate with maezae-types.",
+		importLine(delivery, `${SDK}/delivery`),
+		...uses("body") ? [importLine(["Body"], `${SDK}/body`)] : [],
+		...uses("date") ? [importLine(["DateString"], `${SDK}/model`)] : [],
+		"",
+		...types.flatMap((t) => [typeOf(t), ""]),
+		`export type CmsTypes = {\n${types.map((t) => `  ${JSON.stringify(t.id)}: ${pascal(t.id)};`).join("\n")}\n};`,
+		"",
+		`export const TYPE_IDS = [${types.map((t) => JSON.stringify(t.id)).join(", ")}] as const;`,
+		""
+	].join("\n");
+}
+export { typesSourceOf as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryusenkei/maezae",
-  "version": "0.18.1",
+  "version": "0.20.0",
   "description": "maezae の導入先のサイト向けの SDK（配信 API の取得・本文の型・プレビューの署名・手元の開発の配信 API）",
   "license": "UNLICENSED",
   "author": "RYUSENKEI",
@@ -43,8 +43,15 @@
     "./dev": {
       "types": "./dist/dev.d.ts",
       "default": "./dist/dev.js"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "default": "./dist/schema.js"
     }
   },
+  "bin": {
+    "maezae-types": "./dist/types-cli.js"
+  },
   "files": [
     "dist"
   ],

package/dist/types/analytics/src/record.d.ts

@@ -1,22 +0,0 @@
-/** Analytics Engine のデータセットの binding（書き込みだけ） */
-export type Dataset = {
-    writeDataPoint(point: {
-        blobs?: string[];
-        doubles?: number[];
-        indexes?: string[];
-    }): void;
-};
-/** パスから種類と ID への対応（利用側が定義、例: /articles/<id> は記事） */
-export type Classify = (path: string) => {
-    kind: string;
-    id: string;
-};
-/** 記録の設定（project は媒体の識別子） */
-type RecordOptions = {
-    classify: Classify;
-    timeZone: string;
-    project?: string;
-};
-/** 閲覧を1件記録（対象: GET で応答が200の HTML・ボット以外、記録の失敗は無視） */
-export declare function recordView(dataset: Dataset | undefined, request: Request, response: Response, { classify, timeZone, project }: RecordOptions): void;
-export {};