@ryusenkei/maezae 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# CHANGELOG
+
+## 0.21.0
+
+互換のない変更。Webhook の署名と検証、トレース、閲覧の記録の仕組みを SDK から外した。導入先は toolkit（`@ryusenkei/web` 0.7.0 以上、`@ryusenkei/core` 0.4.0 以上）を直接 import する。署名の値と閲覧の列は 0.20.0 と同じなので、CMS との間で同時に切り替える必要はない
+
+| 0.20.0 まで | 0.21.0 から | 差 |
+| --- | --- | --- |
+| `signedHeaders`（`/preview`） | `webhookHeaders`（`@ryusenkei/web/webhook`） | 引数は同じ。鍵が空なら `ConfigError` |
+| `signParts`（`/preview`） | `signWebhook`（`@ryusenkei/web/webhook`） | 3番目の引数が `{ now }` |
+| `verifyRequest`（`/preview`、`/integrations`） | `verifyWebhookRequest`（`@ryusenkei/web/webhook`） | `boolean` ではなく `Result`（`.ok`）。鍵が空なら `ConfigError`。鍵が任意なら呼ぶ前に確かめる |
+| `verifyParts`（`/preview`） | `verifyWebhook`（`@ryusenkei/web/webhook`） | 同上。`maxSkewSec` は `toleranceSec` |
+| `SignedParts`、`VerifyRequestOptions` | `WebhookParts`、`VerifyWebhookRequestOptions`（`@ryusenkei/web/webhook`） | — |
+| `withEdgeSpan`（`/trace`） | `traceRequest(logTracer({ sampleRate }), name, request, (span) => …)`（`@ryusenkei/core/trace`、`logTracer` は `@ryusenkei/core`） | `span.traceparent` は `formatTraceparent(span.context)`。ログの属性が `method`・`path`・`status` から `http.method`・`http.path`・`http.status` に。Workers は互換のフラグ `nodejs_als` が要る |
+| `TRACEPARENT_HEADER`、`sampleRateOf`、`TraceContext`（`/trace`） | 同じ名前（`@ryusenkei/core`） | — |
+| `EdgeSpan`、`EdgeSpanOptions`、`EdgeSpanStatus`（`/trace`） | `Span`、`SpanStatus`（`@ryusenkei/core`） | — |
+| `recordView(dataset, request, response, options)`（`/analytics`） | `viewOf(request, response, options)` と `analyticsEngineRecorder(dataset, VIEW_SCHEMA).record(view)`（`analyticsEngineRecorder` は `@ryusenkei/web/cloudflare`） | 閲覧の判定と列は SDK の `viewOf`・`VIEW_SCHEMA`。書き込みの失敗は警告のログ |
+| `Dataset`（`/analytics`） | `AnalyticsEngineDataset`（`@ryusenkei/web/cloudflare`） | — |
+
+- 残したもの: `SIGNED_HEADERS`（`/preview`、`/integrations`）、`openValue`・`openEmbedContext`（`/integrations`）、`VIEW_COLUMNS`・`viewOf`・`Classify`（`/analytics`）
+- 足したもの: `VIEW_SCHEMA`、`ViewEvent`、`ViewOptions`（`/analytics`）
+- 消したもの: エントリポイント `/trace`
+- 依存に `@ryusenkei/web` を足した（`/dev` の下書きの署名と `VIEW_SCHEMA`）

package/README.md

@@ -9,12 +9,23 @@ maezae の SDK（導入先のサイト向け）
 | `@ryusenkei/maezae/delivery` | 配信 API `/content/v1` の取得（一覧の絞り込み・`/bundle`・ETag） |
 | `@ryusenkei/maezae/body` | 本文のブロックの型と描画の補助 |
 | `@ryusenkei/maezae/model` | コンテンツスキーマの型・ページのパス・画像の切り抜き |
-| `@ryusenkei/maezae/preview` | プレビューと下書きの取得の署名（ヘッダー `x-preview-signature`） |
-| `@ryusenkei/maezae/analytics` | サイトの閲覧の記録（CMS の閲覧数の集計と同じ形式） |
-| `@ryusenkei/maezae/trace` | CMS のログと相関を取るトレースの区間 |
-| `@ryusenkei/maezae/integrations` | 外の関数・Webhook が受け取る本文の型と署名の検証（ヘッダー `x-cms-signature`） |
+| `@ryusenkei/maezae/preview` | プレビューと下書きの取得の署名のヘッダーの名前（`x-preview-signature`） |
+| `@ryusenkei/maezae/analytics` | サイトの閲覧の判定と、CMS の閲覧数の集計と同じ列の形 |
+| `@ryusenkei/maezae/integrations` | 外の関数・Webhook が受け取る本文の型と署名のヘッダーの名前（`x-cms-signature`）、外の画面の文脈 |
 | `@ryusenkei/maezae/schema` | 配信 API の値の型の定義の生成とずれの検査（CLI `maezae-types`、Node） |
 
+署名と検証、トレース、閲覧の記録の仕組みは toolkit（`@ryusenkei/web`、`@ryusenkei/core`）を直接 import する（0.21.0 から、置き換えは [CHANGELOG.md](CHANGELOG.md)）。SDK はヘッダーの名前と閲覧の列の形だけを持つ
+
+## 閲覧の記録
+
+```ts
+import { VIEW_SCHEMA, viewOf } from '@ryusenkei/maezae/analytics';
+import { analyticsEngineRecorder } from '@ryusenkei/web/cloudflare';
+
+const view = viewOf(request, response, { classify, timeZone: 'Asia/Tokyo' });
+if (view) analyticsEngineRecorder(env.VIEWS, VIEW_SCHEMA).record(view);
+```
+
 ## 取得（Cloudflare Workers の service binding）
 
 - バインディング: `services: [{ "binding": "CMS", "service": "<CMS のサーバーの Worker>", "entrypoint": "Delivery" }]`
@@ -239,9 +250,11 @@ const thumb = withImageParams(src, { w: 400, auto: 'format' });
 - 書きかけの値の画像: 配信 API の1件と同じ値（`id`・`kind`・`url`・`width`・`height`・`alt`・`hotspot`・`crop`）に参照の `asset` を足した形（0.17.0 から）
 
 ```ts
-import { SIGNED_HEADERS, verifyRequest } from '@ryusenkei/maezae/preview';
+import { SIGNED_HEADERS } from '@ryusenkei/maezae/preview';
+import { verifyWebhookRequest } from '@ryusenkei/web/webhook';
 
-const isPreview = await verifyRequest(env.PREVIEW_TOKEN, request, { header: SIGNED_HEADERS.preview });
+// 鍵が空なら verifyWebhookRequest は ConfigError を投げるので、鍵が任意なら先に確かめる
+const isPreview = !!env.PREVIEW_TOKEN && (await verifyWebhookRequest(env.PREVIEW_TOKEN, request, { header: SIGNED_HEADERS.preview })).ok;
 ```
 
 ## 外の関数・Webhook の受け手
@@ -249,9 +262,10 @@ const isPreview = await verifyRequest(env.PREVIEW_TOKEN, request, { header: SIGN
 - 鍵: 媒体の管理画面の「設定 → 連携」の登録ごとの署名の鍵
 
 ```ts
-import { type PublishCheckRequest, SIGNED_HEADERS, verifyRequest } from '@ryusenkei/maezae/integrations';
+import { type PublishCheckRequest, SIGNED_HEADERS } from '@ryusenkei/maezae/integrations';
+import { verifyWebhookRequest } from '@ryusenkei/web/webhook';
 
-if (!(await verifyRequest(env.CMS_FUNCTION_SECRET, request, { header: SIGNED_HEADERS.outbound }))) return new Response(null, { status: 401 });
+if (!(await verifyWebhookRequest(env.CMS_FUNCTION_SECRET, request, { header: SIGNED_HEADERS.outbound })).ok) return new Response(null, { status: 401 });
 const body = (await request.json()) as PublishCheckRequest;
 ```
 
@@ -326,8 +340,8 @@ if (!context) return new Response(null, { status: 401 });
   - 外の画面: クエリ `ctx` は古い鍵、`ctx_next` は新しい鍵で封印
   - 古い SDK（0.10.0 より前）: 古い鍵の署名だけを照合するため、古い鍵のままなら移行の期間も通る
 - 導入先の手順
-  1. SDK を 0.10.0 以上にしてデプロイ（照合は `verifyRequest`、外の画面は `openEmbedContext`）
+  1. 鍵を並べて照合する受け手にしてデプロイ（照合は toolkit の `verifyWebhookRequest`、外の画面は `openEmbedContext`）
   2. 管理画面で「鍵を再発行」し、表示された新しい鍵を受け手の秘密値（例: `CMS_FUNCTION_SECRET`）に設定してデプロイ
   3. 管理画面の「送信の記録」で、差し替えの後の送信が成功していることを確かめる
   4. 管理画面で「古い鍵を失効」
-- 受け手が新旧の鍵を並べて持つこともできる: `verifyRequest([env.NEW_SECRET, env.OLD_SECRET], request, …)`
+- 受け手が新旧の鍵を並べて持つこともできる: `verifyWebhookRequest([env.NEW_SECRET, env.OLD_SECRET], request, …)`

package/dist/analytics.js

@@ -1,3 +1,4 @@
+import { defineEventSchema, isBotUserAgent } from "@ryusenkei/web/analytics";
 // ../analytics/src/day.ts
 /** 時間帯 timeZone での日付（YYYY-MM-DD、例: timeZone は Asia/Tokyo） */
 const dayIn = (timeZone, at = /* @__PURE__ */ new Date()) => new Intl.DateTimeFormat("en-CA", {
@@ -16,13 +17,18 @@ const VIEW_COLUMNS = [
 	"event",
 	"project"
 ];
-const BOT = /bot|crawl|spider|slurp|preview|monitor|headless/i;
-/** ボットの UA か */
-const isBot = (userAgent) => BOT.test(userAgent ?? "");
+/**
+* 閲覧の出来事の形（toolkit の analyticsEngineRecorder・analyticsEngineCounts に渡す）
+* - index: 媒体、指定なしは種類（Analytics Engine は index ごとに標本を抽出するため、共有のデータセットで小さな媒体の記録が間引かれないように）
+*/
+const VIEW_SCHEMA = defineEventSchema({
+	blobs: VIEW_COLUMNS,
+	index: (view) => view.project ?? view.kind ?? ""
+});
 /** 閲覧の出来事（対象: 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;
+	if (!response.headers.get("content-type")?.includes("text/html") || isBotUserAgent(request.headers.get("user-agent"))) return null;
 	const path = new URL(request.url).pathname;
 	const { kind, id } = classify(path);
 	return {
@@ -34,16 +40,4 @@ function viewOf(request, response, { classify, timeZone, project }) {
 		...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: VIEW_COLUMNS.map((key) => view[key] ?? ""),
-			indexes: [view.project ?? view.kind]
-		});
-	} catch {}
-}
-export { recordView };
+export { VIEW_COLUMNS, VIEW_SCHEMA, viewOf };

package/dist/dev.js

@@ -1,8 +1,9 @@
-import { i as SIGNED_HEADERS, s as signedHeaders } from "./src-BMOqN7Xs.js";
+import { t as SIGNED_HEADERS } from "./src-BCTmQ5n-.js";
 import { createHash } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
 import { createServer } from "node:http";
 import { pathToFileURL } from "node:url";
+import { webhookHeaders } from "@ryusenkei/web/webhook";
 // 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`;
@@ -36,7 +37,7 @@ function relayDelivery({ origin, apiKey, previewSecret }) {
 		});
 		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, {
+		if (previewSecret && headers.has(SIGNED_HEADERS.preview)) headers.set(SIGNED_HEADERS.preview, (await webhookHeaders(previewSecret, {
 			method,
 			url,
 			body: null

package/dist/integrations.js

@@ -1,4 +1,4 @@
-import { a as openValue, i as SIGNED_HEADERS, l as verifyRequest } from "./src-BMOqN7Xs.js";
+import { n as openValue, t as SIGNED_HEADERS } from "./src-BCTmQ5n-.js";
 import "./src-BrLwIWaT.js";
 // ../cms-contract/src/embeds.ts
 /** URL のクエリの名前（署名つきの文脈） */
@@ -25,4 +25,4 @@ async function openEmbedContext(secret, url, now = Date.now()) {
 	}
 	return null;
 }
-export { EMBED_CONTEXT_NEXT_PARAM, EMBED_CONTEXT_PARAM, EMBED_MESSAGES, FUNCTION_HOOKS, SIGNED_HEADERS, openEmbedContext, openValue, verifyRequest };
+export { EMBED_CONTEXT_NEXT_PARAM, EMBED_CONTEXT_PARAM, EMBED_MESSAGES, FUNCTION_HOOKS, SIGNED_HEADERS, openEmbedContext, openValue };

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-BMOqN7Xs.js";
+export { t as SIGNED_HEADERS } from "./src-BCTmQ5n-.js";

package/dist/src-BCTmQ5n-.js

@@ -0,0 +1,37 @@
+// ../access/src/signed.ts
+const enc = new TextEncoder();
+/** 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） */
+	mcp: "x-mcp-signature",
+	/** MCP → CMS のログインのメールアドレス（署名の主体） */
+	mcpEmail: "x-mcp-email",
+	/** CMS ⇄ サイトのプレビューと下書きの署名（鍵は PREVIEW_TOKEN） */
+	preview: "x-preview-signature",
+	/** CMS → 外の送信先の Webhook・外の関数の署名（鍵は登録ごと、受け手は @ryusenkei/web/webhook の verifyWebhookRequest で照合） */
+	outbound: "x-cms-signature"
+};
+const hmacKey = (secret) => crypto.subtle.importKey("raw", enc.encode(secret), {
+	name: "HMAC",
+	hash: "SHA-256"
+}, false, ["sign", "verify"]);
+/** 鍵の一覧（空の値を除く） */
+const secretsOf = (secret) => (typeof secret === "string" ? [secret] : [...secret ?? []]).filter(Boolean);
+/** 封印した値（鍵のどれかで署名が合えば値、署名の不一致・期限切れ・形の誤りは null） */
+async function openValue(secret, token, now = Date.now()) {
+	const [body, sig] = token?.split(".") ?? [];
+	const secrets = secretsOf(secret);
+	if (!secrets.length || !body || !sig) return null;
+	try {
+		let matched = false;
+		for (const s of secrets) if (!matched) matched = await crypto.subtle.verify("HMAC", await hmacKey(s), decodeBase64Url(sig), enc.encode(body));
+		if (!matched) return null;
+		const { v, exp } = JSON.parse(new TextDecoder().decode(decodeBase64Url(body)));
+		return typeof exp === "number" && exp * 1e3 > now ? v : null;
+	} catch {
+		return null;
+	}
+}
+export { openValue as n, SIGNED_HEADERS as t };

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

@@ -1,6 +1,4 @@
 export { accessJwtOptions, type FetchCerts, type JwtClaims, type JwtOptions, verifyAccessJwt, verifyJwt } from './jwt.js';
 export { cookieValue, eitherLogin, handoffLogin, type HandoffLoginOptions, openSession, sessionCookie, sessionCookieName } from './handoff.js';
 export { emailOfClaims, type LoginAuth, oidcLogin, type OidcLoginOptions, safeNext, tokenAuth, type TokenAuthOptions } from './oidc.js';
-export { type EdgeSpan, type EdgeSpanOptions, type EdgeSpanStatus, sampleRateOf, startEdgeSpan, withEdgeSpan } from './span.js';
-export { openValue, sealValue, SIGNED_HEADERS, signedHeaders, type SigningSecrets, signParts, type SignedParts, verifyParts, verifyRequest, type VerifyRequestOptions } from './signed.js';
-export { childTraceContext, formatTraceparent, newSpanId, newTraceId, parseTraceparent, type TraceContext, TRACEPARENT_HEADER } from './traceparent.js';
+export { openValue, sealValue, SIGNED_HEADERS, type SigningSecrets } from './signed.js';

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

@@ -6,43 +6,11 @@ export declare const SIGNED_HEADERS: {
     readonly mcpEmail: "x-mcp-email";
     /** CMS ⇄ サイトのプレビューと下書きの署名（鍵は PREVIEW_TOKEN） */
     readonly preview: "x-preview-signature";
-    /** CMS → 外の送信先の Webhook・外の関数の署名（鍵は登録ごと、受け手は verifyParts と同じ手順で照合） */
+    /** CMS → 外の送信先の Webhook・外の関数の署名（鍵は登録ごと、受け手は @ryusenkei/web/webhook の verifyWebhookRequest で照合） */
     readonly outbound: "x-cms-signature";
 };
-/** 署名の対象（body は本文、なしは空） */
-export type SignedParts = Readonly<{
-    method: string;
-    url: string;
-    body?: string | ArrayBuffer | Uint8Array | null;
-    /** 主体（MCP のログインのメールアドレスなど、なしは空） */
-    subject?: string | null;
-}>;
 /** 署名の鍵（1つか、移行の期間は新しい鍵を先・古い鍵を最後に並べた複数） */
 export type SigningSecrets = string | readonly string[];
-/** 署名のヘッダーの値（t=<秒>,v1=<署名>、鍵が複数なら v1 を鍵の順に並べる） */
-export declare function signParts(secret: SigningSecrets, parts: SignedParts, now?: number): Promise<string>;
-/** 署名の照合（鍵のどれかと v1 のどれかが合えば true、形の誤り・時刻のずれの超過・不一致は false） */
-export declare function verifyParts(secret: SigningSecrets | null | undefined, header: string | null | undefined, parts: SignedParts, { now, maxSkewSec }?: {
-    now?: number;
-    maxSkewSec?: number;
-}): Promise<boolean>;
-/** 署名を付けたヘッダー（init のヘッダーに署名と主体を追加した新しい Headers） */
-export declare function signedHeaders(secret: SigningSecrets, { method, url, body, subject }: SignedParts, { header, subjectHeader, init, now }: Readonly<{
-    header: string;
-    subjectHeader?: string;
-    init?: HeadersInit;
-    now?: number;
-}>): Promise<Headers>;
-/** 署名つきのリクエストを照合する設定 */
-export type VerifyRequestOptions = Readonly<{
-    /** 署名のヘッダーの名前 */
-    header: string;
-    /** 主体のヘッダーの名前（なしは主体なしで照合） */
-    subjectHeader?: string;
-    now?: number;
-}>;
-/** リクエストの署名の照合（本文は複製から読み込み、元のリクエストの本文は残す、鍵の移行の期間は受け手が新旧の鍵を並べて渡せる） */
-export declare function verifyRequest(secret: SigningSecrets | undefined, request: Request, { header, subjectHeader, now }: VerifyRequestOptions): Promise<boolean>;
 /** 期限と署名を付けた値（JSON にできる値、ttlSec は有効な秒数） */
 export declare function sealValue(secret: string, value: unknown, ttlSec: number, now?: number): Promise<string>;
 /** 封印した値（鍵のどれかで署名が合えば値、署名の不一致・期限切れ・形の誤りは null） */

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

@@ -1,4 +1,4 @@
-export { type Classify, VIEW_COLUMNS, type ViewEvent, viewOf, type ViewOptions } from './view.js';
+export { type Classify, VIEW_COLUMNS, VIEW_SCHEMA, type ViewEvent, viewOf, type ViewOptions } from './view.js';
 export { syncCron } from './schedule.js';
 export { isViewsCron, sharedViews, viewsFor, viewsSince, viewsSyncOf } from './shared.js';
 export { type DailyRow, fixedSource, type ProjectSource, renamedSource, type Source } from './source.js';

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

@@ -14,6 +14,15 @@ export type ViewEvent = Readonly<{
 }>;
 /** 位置で持つ記録先の列の順 */
 export declare const VIEW_COLUMNS: readonly ["kind", "id", "path", "date", "event", "project"];
+/**
+ * 閲覧の出来事の形（toolkit の analyticsEngineRecorder・analyticsEngineCounts に渡す）
+ * - index: 媒体、指定なしは種類（Analytics Engine は index ごとに標本を抽出するため、共有のデータセットで小さな媒体の記録が間引かれないように）
+ */
+export declare const VIEW_SCHEMA: Readonly<{
+    blobs: readonly ("id" | "kind" | "date" | "path" | "project" | "event")[];
+    doubles?: readonly never[] | undefined;
+    index?: ((event: Readonly<Partial<Record<"id" | "kind" | "date" | "path" | "project" | "event", string>> & Partial<Record<never, number>>>) => string) | undefined;
+}>;
 /** 出来事にする設定（project は媒体の識別子） */
 export type ViewOptions = Readonly<{
     classify: Classify;

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

@@ -1,12 +1,2 @@
-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;
+export { VIEW_COLUMNS, VIEW_SCHEMA, viewOf } from '../../analytics/src/index.js';
+export type { Classify, ViewEvent, ViewOptions } from '../../analytics/src/index.js';

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

@@ -1,7 +1,7 @@
 import { type SigningSecrets } from '../../access/src/index.js';
 import { type EmbedContext } from '../../cms-contract/src/index.js';
-export { openValue, SIGNED_HEADERS, verifyRequest } from '../../access/src/index.js';
-export type { SigningSecrets, VerifyRequestOptions } from '../../access/src/index.js';
+export { openValue, SIGNED_HEADERS } from '../../access/src/index.js';
+export type { SigningSecrets } from '../../access/src/index.js';
 export { EMBED_CONTEXT_NEXT_PARAM, EMBED_CONTEXT_PARAM, EMBED_MESSAGES, FUNCTION_HOOKS } from '../../cms-contract/src/index.js';
 export type { EmbedContext, EmbedMessage, FunctionHook, FunctionRequest, PublishCheckRequest, PublishCheckResponse, SaveCheckRequest, SaveCheckResponse, WebhookAction, WebhookBody, WebhookEvent, WebhookModuleBody, WebhookVersion } from '../../cms-contract/src/index.js';
 /** 外の画面の URL の文脈（クエリ ctx と、鍵の移行の期間の ctx_next のどちらかが鍵で開けば文脈、なければ null） */

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

@@ -1,2 +1 @@
-export { SIGNED_HEADERS, signedHeaders, signParts, verifyParts, verifyRequest } from '../../access/src/index.js';
-export type { SignedParts, SigningSecrets, VerifyRequestOptions } from '../../access/src/index.js';
+export { SIGNED_HEADERS } from '../../access/src/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryusenkei/maezae",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "maezae の導入先のサイト向けの SDK（配信 API の取得・本文の型・プレビューの署名・手元の開発の配信 API）",
   "license": "UNLICENSED",
   "author": "RYUSENKEI",
@@ -36,10 +36,6 @@
       "types": "./dist/analytics.d.ts",
       "default": "./dist/analytics.js"
     },
-    "./trace": {
-      "types": "./dist/trace.d.ts",
-      "default": "./dist/trace.js"
-    },
     "./dev": {
       "types": "./dist/dev.d.ts",
       "default": "./dist/dev.js"
@@ -53,12 +49,14 @@
     "maezae-types": "./dist/types-cli.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
+    "@ryusenkei/web": "^0.7.0",
     "zod": "^4.6.7"
   },
   "devDependencies": {

package/dist/src-BMOqN7Xs.js

@@ -1,193 +0,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） */
-	mcp: "x-mcp-signature",
-	/** MCP → CMS のログインのメールアドレス（署名の主体） */
-	mcpEmail: "x-mcp-email",
-	/** CMS ⇄ サイトのプレビューと下書きの署名（鍵は PREVIEW_TOKEN） */
-	preview: "x-preview-signature",
-	/** CMS → 外の送信先の Webhook・外の関数の署名（鍵は登録ごと、受け手は verifyParts と同じ手順で照合） */
-	outbound: "x-cms-signature"
-};
-const base64Url = (bytes) => btoa(String.fromCharCode(...new Uint8Array(bytes))).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
-const hmacKey = (secret) => crypto.subtle.importKey("raw", enc.encode(secret), {
-	name: "HMAC",
-	hash: "SHA-256"
-}, false, ["sign", "verify"]);
-async function messageOf(t, { method, url, body, subject }) {
-	const { pathname, search } = new URL(url);
-	const bytes = typeof body === "string" ? enc.encode(body) : body ? Uint8Array.from(new Uint8Array(body)) : /* @__PURE__ */ new Uint8Array();
-	const digest = base64Url(await crypto.subtle.digest("SHA-256", bytes));
-	return enc.encode([
-		"v1",
-		t,
-		method.toUpperCase(),
-		`${pathname}${search}`,
-		subject ?? "",
-		digest
-	].join("\n"));
-}
-/** 鍵の一覧（空の値を除く） */
-const secretsOf = (secret) => (typeof secret === "string" ? [secret] : [...secret ?? []]).filter(Boolean);
-/** 署名のヘッダーの値（t=<秒>,v1=<署名>、鍵が複数なら v1 を鍵の順に並べる） */
-async function signParts(secret, parts, now = Date.now()) {
-	const t = Math.floor(now / 1e3);
-	const message = await messageOf(t, parts);
-	const sigs = await Promise.all(secretsOf(secret).map(async (s) => base64Url(await crypto.subtle.sign("HMAC", await hmacKey(s), message))));
-	return [`t=${t}`, ...sigs.map((sig) => `v1=${sig}`)].join(",");
-}
-/** 署名の照合（鍵のどれかと v1 のどれかが合えば true、形の誤り・時刻のずれの超過・不一致は false） */
-async function verifyParts(secret, header, parts, { now = Date.now(), maxSkewSec = MAX_SKEW_SEC } = {}) {
-	const secrets = secretsOf(secret);
-	if (!secrets.length || !header) return false;
-	const fields = header.split(",").map((f) => f.trim().split("=", 2));
-	const t = Number(fields.find(([k]) => k === "t")?.[1]);
-	const sigs = fields.flatMap(([k, v]) => k === "v1" && v ? [v] : []);
-	if (!Number.isInteger(t) || !sigs.length || Math.abs(now / 1e3 - t) > maxSkewSec) return false;
-	const message = await messageOf(t, parts);
-	for (const s of secrets) {
-		const key = await hmacKey(s);
-		for (const sig of sigs) try {
-			if (await crypto.subtle.verify("HMAC", key, decodeBase64Url(sig), message)) return true;
-		} catch {}
-	}
-	return false;
-}
-/** 署名を付けたヘッダー（init のヘッダーに署名と主体を追加した新しい Headers） */
-async function signedHeaders(secret, { method, url, body, subject }, { header, subjectHeader, init, now }) {
-	const headers = new Headers(init);
-	if (subjectHeader && subject) headers.set(subjectHeader, subject);
-	headers.set(header, await signParts(secret, {
-		method,
-		url,
-		body: body ?? null,
-		subject: subjectHeader ? subject : null
-	}, now));
-	return headers;
-}
-/** リクエストの署名の照合（本文は複製から読み込み、元のリクエストの本文は残す、鍵の移行の期間は受け手が新旧の鍵を並べて渡せる） */
-async function verifyRequest(secret, request, { header, subjectHeader, now }) {
-	const value = request.headers.get(header);
-	if (!secretsOf(secret).length || !value) return false;
-	const body = request.body ? await request.clone().arrayBuffer() : null;
-	return verifyParts(secret, value, {
-		method: request.method,
-		url: request.url,
-		body,
-		subject: subjectHeader ? request.headers.get(subjectHeader) : null
-	}, now === void 0 ? {} : { now });
-}
-/** 封印した値（鍵のどれかで署名が合えば値、署名の不一致・期限切れ・形の誤りは null） */
-async function openValue(secret, token, now = Date.now()) {
-	const [body, sig] = token?.split(".") ?? [];
-	const secrets = secretsOf(secret);
-	if (!secrets.length || !body || !sig) return null;
-	try {
-		let matched = false;
-		for (const s of secrets) if (!matched) matched = await crypto.subtle.verify("HMAC", await hmacKey(s), decodeBase64Url(sig), enc.encode(body));
-		if (!matched) return null;
-		const { v, exp } = JSON.parse(new TextDecoder().decode(decodeBase64Url(body)));
-		return typeof exp === "number" && exp * 1e3 > now ? v : null;
-	} catch {
-		return null;
-	}
-}
-// ../access/src/traceparent.ts
-/** traceparent のヘッダーの名前 */
-const TRACEPARENT_HEADER = "traceparent";
-const PATTERN = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})(-.*)?$/;
-const ZERO_TRACE = "0".repeat(32);
-const ZERO_SPAN = "0".repeat(16);
-/** 受け取った traceparent の解釈（なし・形の違反は null） */
-function parseTraceparent(value) {
-	const m = value ? PATTERN.exec(value.trim()) : null;
-	if (!m) return null;
-	const [, version, traceId, spanId, flags, rest] = m;
-	if (version === "ff" || version === "00" && rest !== void 0) return null;
-	if (traceId === ZERO_TRACE || spanId === ZERO_SPAN) return null;
-	return {
-		traceId,
-		spanId,
-		sampled: (parseInt(flags, 16) & 1) === 1
-	};
-}
-/** traceparent の値（版は00） */
-const formatTraceparent = (ctx) => `00-${ctx.traceId}-${ctx.spanId}-${ctx.sampled ? "01" : "00"}`;
-function randomHexId(bytes) {
-	const values = crypto.getRandomValues(new Uint8Array(bytes));
-	let hex = "";
-	for (const b of values) hex += b.toString(16).padStart(2, "0");
-	return hex;
-}
-/** 新しいトレースの ID（32桁） */
-const newTraceId = () => randomHexId(16);
-/** 新しい区間の ID（16桁） */
-const newSpanId = () => randomHexId(8);
-// ../access/src/span.ts
-/** 記録の割合（0〜1、なし・範囲の外・数でない値は1） */
-const sampleRateOf = (value) => {
-	const rate = value === void 0 || value.trim() === "" ? NaN : Number(value);
-	return rate >= 0 && rate <= 1 ? rate : 1;
-};
-/** エントリポイントの区間の開始（受け取った traceparent の子か、新しいトレースの根） */
-function startEdgeSpan({ name, request, sampleRate = 1, write = (line) => console.info(line) }) {
-	const parent = parseTraceparent(request.headers.get(TRACEPARENT_HEADER));
-	const context = {
-		traceId: parent?.traceId ?? newTraceId(),
-		spanId: newSpanId(),
-		sampled: parent ? parent.sampled : Math.random() < sampleRate
-	};
-	const attributes = {
-		method: request.method,
-		path: new URL(request.url).pathname
-	};
-	const started = performance.now();
-	let ended = false;
-	return {
-		context,
-		traceparent: formatTraceparent(context),
-		end(result) {
-			if (ended) return;
-			ended = true;
-			if (!context.sampled) return;
-			const status = result === "error" || result >= 500 ? "error" : "ok";
-			const durationMs = Math.round((performance.now() - started) * 10) / 10;
-			const span = {
-				traceId: context.traceId,
-				spanId: context.spanId,
-				parentSpanId: parent?.spanId ?? null,
-				name,
-				durationMs,
-				status,
-				attributes: {
-					...attributes,
-					...result !== "error" && { status: result }
-				}
-			};
-			write(JSON.stringify({
-				level: "info",
-				event: "span",
-				...span
-			}));
-		}
-	};
-}
-/** 処理をエントリポイントの区間で包む（応答のステータスか例外で終了、例外は再送出） */
-async function withEdgeSpan(options, handle) {
-	const span = startEdgeSpan(options);
-	try {
-		const res = await handle(span);
-		span.end(res.status);
-		return res;
-	} catch (e) {
-		span.end("error");
-		throw e;
-	}
-}
-export { openValue as a, verifyParts as c, SIGNED_HEADERS as i, verifyRequest as l, withEdgeSpan as n, signParts as o, TRACEPARENT_HEADER as r, signedHeaders as s, sampleRateOf as t };

package/dist/trace.d.ts

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

package/dist/trace.js

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

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

@@ -1,23 +0,0 @@
-import { type TraceContext } from './traceparent.js';
-/** 区間の結果（ok・error、logTracer と同じ値） */
-export type EdgeSpanStatus = 'ok' | 'error';
-/** エントリポイントの区間（context は転送先へ受け渡す自身の区間、traceparent はその値） */
-export type EdgeSpan = Readonly<{
-    context: TraceContext;
-    traceparent: string;
-    /** 応答のステータスの数か例外で終了（500以上・例外は error、2回目以降は無視） */
-    end: (result: number | 'error') => void;
-}>;
-/** エントリポイントの区間の引数（write は1行の出力先、既定は console.info） */
-export type EdgeSpanOptions = Readonly<{
-    name: string;
-    request: Request;
-    sampleRate?: number;
-    write?: (line: string) => void;
-}>;
-/** 記録の割合（0〜1、なし・範囲の外・数でない値は1） */
-export declare const sampleRateOf: (value: string | undefined) => number;
-/** エントリポイントの区間の開始（受け取った traceparent の子か、新しいトレースの根） */
-export declare function startEdgeSpan({ name, request, sampleRate, write }: EdgeSpanOptions): EdgeSpan;
-/** 処理をエントリポイントの区間で包む（応答のステータスか例外で終了、例外は再送出） */
-export declare function withEdgeSpan(options: EdgeSpanOptions, handle: (span: EdgeSpan) => Promise<Response>): Promise<Response>;

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

@@ -1,21 +0,0 @@
-/** traceparent のヘッダーの名前 */
-export declare const TRACEPARENT_HEADER = "traceparent";
-/** トレースの文脈（traceId は32桁、spanId は呼び出し元の区間の16桁、sampled は記録の対象か） */
-export type TraceContext = Readonly<{
-    traceId: string;
-    spanId: string;
-    sampled: boolean;
-}>;
-/** 受け取った traceparent の解釈（なし・形の違反は null） */
-export declare function parseTraceparent(value: string | null | undefined): TraceContext | null;
-/** traceparent の値（版は00） */
-export declare const formatTraceparent: (ctx: TraceContext) => string;
-/** 新しいトレースの ID（32桁） */
-export declare const newTraceId: () => string;
-/** 新しい区間の ID（16桁） */
-export declare const newSpanId: () => string;
-/**
- * 呼び出し元の区間の文脈（受け取った traceparent があれば同じトレースの子、なければ新しいトレース）
- * - sampled: 受け取った値のフラグ、新しいトレースは引数（既定は記録の対象）
- */
-export declare function childTraceContext(incoming: string | null | undefined, sampled?: boolean): TraceContext;

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

@@ -1,2 +0,0 @@
-export { sampleRateOf, TRACEPARENT_HEADER, withEdgeSpan } from '../../access/src/index.js';
-export type { EdgeSpan, EdgeSpanOptions, EdgeSpanStatus, TraceContext } from '../../access/src/index.js';