@notion-headless-cms/fetch-blocks 0.0.1

package/dist/index.d.mts

@@ -0,0 +1,28 @@
+import { BlockHandler } from "@notion-headless-cms/markdown-html";
+import { ContentFetcher, FetchBlockTreeOgpOptions } from "@notion-headless-cms/notion-orm";
+
+//#region src/index.d.ts
+interface BlocksFetcherOptions {
+  /**
+   * 同時に展開する子ブロックの最大数。デフォルト 3。
+   * Notion API のレート制限 (3 req/s) に抵触しないよう抑制する。
+   */
+  concurrency?: number;
+  /** カスタムブロックハンドラーのマップ。`Transformer` (notion-to-md) に渡る。 */
+  blocks?: Record<string, BlockHandler>;
+  /** embed / bookmark / link_preview ブロックの OGP 取得設定。 */
+  ogp?: FetchBlockTreeOgpOptions;
+}
+/**
+ * Notion `blocks.children.list` を再帰的に呼ぶ既定の取得戦略。
+ * BlockObjectResponse ツリーを返すため `@notion-headless-cms/react-renderer` の
+ * `NotionRenderer` で高忠実度に描画できる。
+ *
+ * ⚠️ ネストが深い大きなページでは Cloudflare Workers Free プランの
+ * 50 subrequest/invocation 上限を超えうる。その場合は
+ * `@notion-headless-cms/fetch-markdown` の `markdownFetcher()` を検討する。
+ */
+declare function blocksFetcher(opts?: BlocksFetcherOptions): ContentFetcher;
+//#endregion
+export { BlocksFetcherOptions, blocksFetcher };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,33 @@
+import { Transformer } from "@notion-headless-cms/markdown-html";
+import { fetchBlockTree } from "@notion-headless-cms/notion-orm";
+//#region src/index.ts
+/**
+* Notion `blocks.children.list` を再帰的に呼ぶ既定の取得戦略。
+* BlockObjectResponse ツリーを返すため `@notion-headless-cms/react-renderer` の
+* `NotionRenderer` で高忠実度に描画できる。
+*
+* ⚠️ ネストが深い大きなページでは Cloudflare Workers Free プランの
+* 50 subrequest/invocation 上限を超えうる。その場合は
+* `@notion-headless-cms/fetch-markdown` の `markdownFetcher()` を検討する。
+*/
+function blocksFetcher(opts = {}) {
+	const blocks = opts.blocks;
+	const ogp = opts.ogp;
+	const concurrency = opts.concurrency;
+	return {
+		kind: "blocks",
+		async loadMarkdown(client, pageId) {
+			return new Transformer(blocks ? { blocks } : void 0).transform(client, pageId);
+		},
+		async loadNotionBlocks(client, pageId) {
+			return fetchBlockTree(client, pageId, {
+				...ogp ? { ogp } : {},
+				...concurrency !== void 0 ? { concurrency } : {}
+			});
+		}
+	};
+}
+//#endregion
+export { blocksFetcher };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { BlockHandler } from \"@notion-headless-cms/markdown-html\";\nimport { Transformer } from \"@notion-headless-cms/markdown-html\";\nimport type {\n  ContentFetcher,\n  FetchBlockTreeOgpOptions,\n  NotionBlockTreeNode,\n} from \"@notion-headless-cms/notion-orm\";\nimport { fetchBlockTree } from \"@notion-headless-cms/notion-orm\";\n\nexport interface BlocksFetcherOptions {\n  /**\n   * 同時に展開する子ブロックの最大数。デフォルト 3。\n   * Notion API のレート制限 (3 req/s) に抵触しないよう抑制する。\n   */\n  concurrency?: number;\n  /** カスタムブロックハンドラーのマップ。`Transformer` (notion-to-md) に渡る。 */\n  blocks?: Record<string, BlockHandler>;\n  /** embed / bookmark / link_preview ブロックの OGP 取得設定。 */\n  ogp?: FetchBlockTreeOgpOptions;\n}\n\n/**\n * Notion `blocks.children.list` を再帰的に呼ぶ既定の取得戦略。\n * BlockObjectResponse ツリーを返すため `@notion-headless-cms/react-renderer` の\n * `NotionRenderer` で高忠実度に描画できる。\n *\n * ⚠️ ネストが深い大きなページでは Cloudflare Workers Free プランの\n * 50 subrequest/invocation 上限を超えうる。その場合は\n * `@notion-headless-cms/fetch-markdown` の `markdownFetcher()` を検討する。\n */\nexport function blocksFetcher(opts: BlocksFetcherOptions = {}): ContentFetcher {\n  const blocks = opts.blocks;\n  const ogp = opts.ogp;\n  const concurrency = opts.concurrency;\n  return {\n    kind: \"blocks\",\n    async loadMarkdown(client, pageId) {\n      const transformer = new Transformer(blocks ? { blocks } : undefined);\n      return transformer.transform(client, pageId);\n    },\n    async loadNotionBlocks(client, pageId): Promise<NotionBlockTreeNode[]> {\n      return fetchBlockTree(client, pageId, {\n        ...(ogp ? { ogp } : {}),\n        ...(concurrency !== undefined ? { concurrency } : {}),\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,SAAgB,cAAc,OAA6B,CAAC,GAAmB;CAC7E,MAAM,SAAS,KAAK;CACpB,MAAM,MAAM,KAAK;CACjB,MAAM,cAAc,KAAK;CACzB,OAAO;EACL,MAAM;EACN,MAAM,aAAa,QAAQ,QAAQ;GAEjC,OAAO,IADiB,YAAY,SAAS,EAAE,OAAO,IAAI,KAAA,CACzC,EAAE,UAAU,QAAQ,MAAM;EAC7C;EACA,MAAM,iBAAiB,QAAQ,QAAwC;GACrE,OAAO,eAAe,QAAQ,QAAQ;IACpC,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;IACrB,GAAI,gBAAgB,KAAA,IAAY,EAAE,YAAY,IAAI,CAAC;GACrD,CAAC;EACH;CACF;AACF"}

package/dist/react.d.mts

@@ -0,0 +1,2 @@
+import { NotionRenderer as Renderer, NotionRendererProps as RendererProps } from "@notion-headless-cms/react-renderer";
+export { Renderer, type RendererProps };

package/dist/react.mjs

@@ -0,0 +1,3 @@
+"use client";
+import { NotionRenderer as Renderer } from "@notion-headless-cms/react-renderer";
+export { Renderer };

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@notion-headless-cms/fetch-blocks",
+  "version": "0.0.1",
+  "description": "Notion ブロック children API を再帰的に取得する fetch 戦略。BlockObjectResponse ツリーを返し、react-renderer で描画する。",
+  "keywords": [
+    "notion",
+    "headless-cms",
+    "fetcher",
+    "blocks",
+    "block-tree",
+    "typescript"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/kjfsm/notion-headless-cms#readme",
+  "bugs": {
+    "url": "https://github.com/kjfsm/notion-headless-cms/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kjfsm/notion-headless-cms.git",
+    "directory": "packages/fetch-blocks"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.mts",
+      "import": "./dist/react.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "tsdown src/index.ts src/react.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",
+    "publint": "publint --strict",
+    "attw": "attw --pack . --profile esm-only"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@notion-headless-cms/markdown-html": "workspace:*",
+    "@notion-headless-cms/notion-orm": "workspace:*"
+  },
+  "peerDependencies": {
+    "@notion-headless-cms/react-renderer": "workspace:*",
+    "@notionhq/client": "^5.20.0",
+    "react": "^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@notion-headless-cms/react-renderer": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@notion-headless-cms/react-renderer": "workspace:*",
+    "@notionhq/client": "catalog:",
+    "@types/react": "catalog:",
+    "react": "catalog:"
+  }
+}