@notion-headless-cms/core 0.3.19 → 0.3.20

package/README.md

@@ -30,7 +30,6 @@ const cms = createClient({
     }),
   },
   cache: [memoryCache()],
-  swr: { ttlMs: 5 * 60_000 },
 });
 
 const posts = await cms.posts.list();
@@ -47,7 +46,7 @@ if (post) console.log(await post.render());
 | `sources` | データソースアダプターのマップ（`{ notion: notionSource(...) }` 等）。複数ソースの `collections` は自動マージされる |
 | `collections` | 直接 `CollectionDef` を渡す低レベル API（通常は `sources` を使う） |
 | `cache` | `readonly CacheAdapter[]` — `memoryCache()` / `cloudflareCache(env)` 等を配列で指定 |
-| `swr` | `{ ttlMs?: number }` — SWR (Stale-While-Revalidate) TTL |
+| `swr` | `{ ttlMs?: number }` — SWR の TTL。未指定だとキャッシュは期限なしで永続し、Notion の `lastEditedTime` 差分があれば bg で差し替え。指定するとブロッキング再取得が走る |
 | `renderer` | `RendererFn` — 未指定なら `@notion-headless-cms/renderer` を動的ロード |
 | `imageProxyBase` | 画像プロキシのベース URL（デフォルト `/api/images`） |
 | `waitUntil` | Cloudflare Workers の `ctx.waitUntil` 相当 |
@@ -103,7 +102,7 @@ CLI 生成物の各アイテム型は `BaseContentItem` を拡張する:
 
 - `memoryCache({ maxItems? })` — インプロセス LRU
 - `noopDocOps` / `noopImgOps` — キャッシュ無効化用
-- 別パッケージ: `@notion-headless-cms/cache/cloudflare` の `cloudflareCache(env)` / `r2Cache()` / `kvCache()`、`@notion-headless-cms/cache/next` の `nextCache()`
+- 別パッケージ: `@notion-headless-cms/cache/cloudflare` の `cloudflarePreset({ env, ctx })` / `cloudflareCache(...)` / `r2Cache()` / `kvCache()`、`@notion-headless-cms/cache/next` の `nextCache()`
 
 ### エラー
 
@@ -124,6 +123,7 @@ import { memoryCache } from "@notion-headless-cms/core/cache/memory";
 | `@notion-headless-cms/core/hooks` | `mergeHooks` / `mergeLoggers` |
 | `@notion-headless-cms/core/cache/memory` | `memoryCache` |
 | `@notion-headless-cms/core/cache/noop` | `noopDocOps` / `noopImgOps` |
+| `@notion-headless-cms/core/html` | `notionRevalidatorScript` (Astro / Hono / Express など素 HTML 向け) |
 
 ## ランタイム別レシピ
 

package/dist/html.d.mts

@@ -0,0 +1,23 @@
+//#region src/html.d.ts
+interface NotionRevalidatorScriptOptions {
+  /**
+   * 再検証のトリガー。既定値: "visibility"
+   * - "visibility": タブ可視化 (`visibilitychange` で hidden→visible) の度に reload
+   * - "focus": ウィンドウ focus の度に reload (visibility より発火が頻繁)
+   */
+  on?: "visibility" | "focus";
+  /**
+   * `<script nonce="...">` を出力したい場合 (CSP 対応)。
+   * 英数字・`-` / `_` / `+` / `/` / `=` のみ許可。属性値ブレイクアウトを防ぐため
+   * 不正な文字が含まれていれば throw する。
+   */
+  nonce?: string;
+}
+/**
+ * React を使わないページに埋め込むための `<script>...</script>` 文字列を返す。
+ * 返り値は外部入力を埋め込まない（nonce は厳格に検証）safe な内容。
+ */
+declare function notionRevalidatorScript(opts?: NotionRevalidatorScriptOptions): string;
+//#endregion
+export { NotionRevalidatorScriptOptions, notionRevalidatorScript };
+//# sourceMappingURL=html.d.mts.map

package/dist/html.mjs

@@ -0,0 +1,19 @@
+//#region src/html.ts
+const NONCE_PATTERN = /^[A-Za-z0-9+/=_-]+$/;
+/**
+* React を使わないページに埋め込むための `<script>...<\/script>` 文字列を返す。
+* 返り値は外部入力を埋め込まない（nonce は厳格に検証）safe な内容。
+*/
+function notionRevalidatorScript(opts = {}) {
+	const body = (opts.on ?? "visibility") === "focus" ? "let l=false;addEventListener(\"focus\",()=>{if(l)location.reload();l=true});" : "document.addEventListener(\"visibilitychange\",()=>{if(document.visibilityState===\"visible\")location.reload()});";
+	let nonceAttr = "";
+	if (opts.nonce !== void 0) {
+		if (!NONCE_PATTERN.test(opts.nonce)) throw new Error("notionRevalidatorScript: nonce に不正な文字が含まれています。base64 / base64url 由来の英数字のみ受け付けます。");
+		nonceAttr = ` nonce="${opts.nonce}"`;
+	}
+	return `<script${nonceAttr}>(()=>{${body}})();<\/script>`;
+}
+//#endregion
+export { notionRevalidatorScript };
+
+//# sourceMappingURL=html.mjs.map

package/dist/html.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.mjs","names":[],"sources":["../src/html.ts"],"sourcesContent":["// React を使わないテンプレート (Astro / Hono / Express など) で SWR 体験を\n// 成立させるための、ゼロ依存の小さな <script> 文字列ジェネレータ。\n//\n// 使い方 (Astro):\n//   import { notionRevalidatorScript } from \"@notion-headless-cms/core/html\";\n//   <Fragment set:html={notionRevalidatorScript()} />\n//\n// 使い方 (Hono):\n//   import { raw, html as h } from \"hono/html\";\n//   c.html(h`...${raw(notionRevalidatorScript())}`);\n//\n// 仕組み: タブ可視化 (visibilitychange で hidden→visible) を検知して\n// `location.reload()` で同じ URL を再リクエストする。サーバ側は\n// `cloudflarePreset` 等で `waitUntil` が配線されていれば、前回訪問時に\n// SWR bg が KV を最新化済み → 再取得で新内容が返る。クエリ無し・別 API fetch 無し。\n\nexport interface NotionRevalidatorScriptOptions {\n  /**\n   * 再検証のトリガー。既定値: \"visibility\"\n   * - \"visibility\": タブ可視化 (`visibilitychange` で hidden→visible) の度に reload\n   * - \"focus\": ウィンドウ focus の度に reload (visibility より発火が頻繁)\n   */\n  on?: \"visibility\" | \"focus\";\n  /**\n   * `<script nonce=\"...\">` を出力したい場合 (CSP 対応)。\n   * 英数字・`-` / `_` / `+` / `/` / `=` のみ許可。属性値ブレイクアウトを防ぐため\n   * 不正な文字が含まれていれば throw する。\n   */\n  nonce?: string;\n}\n\n// CSP nonce は本来 base64 / base64url 由来のランダム文字列。属性値の\n// クォート・タグブレイクアウトを未然に防ぐため、最小限の許可セットで検証する。\nconst NONCE_PATTERN = /^[A-Za-z0-9+/=_-]+$/;\n\n/**\n * React を使わないページに埋め込むための `<script>...</script>` 文字列を返す。\n * 返り値は外部入力を埋め込まない（nonce は厳格に検証）safe な内容。\n */\nexport function notionRevalidatorScript(\n  opts: NotionRevalidatorScriptOptions = {},\n): string {\n  const trigger = opts.on ?? \"visibility\";\n  const body =\n    trigger === \"focus\"\n      ? // 初回ロード時の focus は無視するため、loaded フラグで初回をスキップ。\n        'let l=false;addEventListener(\"focus\",()=>{if(l)location.reload();l=true});'\n      : 'document.addEventListener(\"visibilitychange\",()=>{if(document.visibilityState===\"visible\")location.reload()});';\n  let nonceAttr = \"\";\n  if (opts.nonce !== undefined) {\n    if (!NONCE_PATTERN.test(opts.nonce)) {\n      throw new Error(\n        \"notionRevalidatorScript: nonce に不正な文字が含まれています。base64 / base64url 由来の英数字のみ受け付けます。\",\n      );\n    }\n    nonceAttr = ` nonce=\"${opts.nonce}\"`;\n  }\n  return `<script${nonceAttr}>(()=>{${body}})();</script>`;\n}\n"],"mappings":";AAiCA,MAAM,gBAAgB;;;;;AAMtB,SAAgB,wBACd,OAAuC,EAAE,EACjC;CAER,MAAM,QADU,KAAK,MAAM,kBAEb,UAER,iFACA;CACN,IAAI,YAAY;AAChB,KAAI,KAAK,UAAU,KAAA,GAAW;AAC5B,MAAI,CAAC,cAAc,KAAK,KAAK,MAAM,CACjC,OAAM,IAAI,MACR,mFACD;AAEH,cAAY,WAAW,KAAK,MAAM;;AAEpC,QAAO,UAAU,UAAU,SAAS,KAAK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@notion-headless-cms/core",
-  "version": "0.3.19",
+  "version": "0.3.20",
   "description": "Core CMS engine for notion-headless-cms — fetch, transform, cache with stale-while-revalidate strategy",
   "keywords": [
     "notion",
@@ -38,6 +38,10 @@
     "./cache/memory": {
       "types": "./dist/cache/memory.d.mts",
       "import": "./dist/cache/memory.mjs"
+    },
+    "./html": {
+      "types": "./dist/html.d.mts",
+      "import": "./dist/html.mjs"
     }
   },
   "files": [
@@ -60,7 +64,7 @@
   },
   "devDependencies": {},
   "scripts": {
-    "build": "tsdown src/index.ts src/errors.ts src/hooks.ts src/cache/memory.ts --format esm --dts --sourcemap --out-dir dist",
+    "build": "tsdown src/index.ts src/errors.ts src/hooks.ts src/cache/memory.ts src/html.ts --format esm --dts --sourcemap --out-dir dist",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage --coverage.reporter=lcov --coverage.reporter=text",