@notion-headless-cms/core 0.0.1 → 0.0.5

package/README.md

@@ -16,6 +16,10 @@ Cloudflare Workers で使う場合は [`@notion-headless-cms/adapter-cloudflare`
 import { CMS } from "@notion-headless-cms/core";
 
 const cms = new CMS({
+  env: {
+    NOTION_TOKEN: process.env.NOTION_TOKEN!,
+    NOTION_DATA_SOURCE_ID: process.env.NOTION_DATA_SOURCE_ID!,
+  },
   schema: {
     publishedStatuses: ["公開"],
     properties: { slug: "Slug" },
@@ -23,11 +27,11 @@ const cms = new CMS({
   cache: { ttlMs: 5 * 60 * 1000 },
 });
 
-// コンテンツ一覧を取得（R2 から返すか Notion API を呼ぶかはキャッシュ状態に依存）
-const { items } = await cms.getItems(env);
+// コンテンツ一覧を取得
+const { items } = await cms.getItems();
 
 // スラッグで個別コンテンツを取得（HTML 付き）
-const cached = await cms.getItemBySlug("my-post", env);
+const cached = await cms.getItemBySlug("my-post");
 console.log(cached?.html);
 ```
 
@@ -45,6 +49,10 @@ interface MyPost extends BaseContentItem {
 }
 
 const config: CMSConfig<MyPost> = {
+  env: {
+    NOTION_TOKEN: process.env.NOTION_TOKEN!,
+    NOTION_DATA_SOURCE_ID: process.env.NOTION_DATA_SOURCE_ID!,
+  },
   schema: {
     mapItem: (page: PageObjectResponse): MyPost => ({
       id: page.id,
@@ -65,8 +73,14 @@ const config: CMSConfig<MyPost> = {
 
 | メソッド | 説明 |
 |---|---|
-| `getItems(env)` | コンテンツ一覧を返す（キャッシュ優先） |
-| `getItemBySlug(slug, env)` | スラッグで個別コンテンツを返す（HTML 付き） |
+| `getItems()` | コンテンツ一覧を返す |
+| `getItemBySlug(slug)` | スラッグで個別コンテンツを返す |
+| `renderItem(item)` | アイテムをレンダリングして `CachedItem` を返す |
+| `renderItemBySlug(slug)` | スラッグで取得してレンダリングする |
+| `getItemsCachedFirst(options?)` | キャッシュ優先でコンテンツ一覧を返す（SWR） |
+| `getItemCachedFirst(slug, options?)` | キャッシュ優先で個別コンテンツを返す（SWR） |
+| `checkItemsUpdate(clientVersion)` | 一覧の更新有無を確認する |
+| `checkItemUpdate(slug, lastEdited)` | 個別コンテンツの更新有無を確認する |
 
 ### ユーティリティ
 
@@ -79,7 +93,7 @@ const config: CMSConfig<MyPost> = {
 
 ## 主要な型
 
-- `CMSConfig<T>` — CMS 設定オブジェクト
+- `CMSConfig<T>` — CMS 設定オブジェクト（`env` フィールドで認証情報を渡す）
 - `BaseContentItem` — デフォルト・カスタム型の基底インターフェース
 - `CachedItem<T>` — キャッシュ済みコンテンツ（HTML + メタデータ）
 - `StorageAdapter` — ストレージ抽象インターフェース

package/dist/index.d.ts

@@ -2,7 +2,6 @@ import { RendererFn } from '@notion-headless-cms/renderer';
 import { BlockHandler } from '@notion-headless-cms/transformer';
 import { PageObjectResponse, RichTextItemResponse } from '@notionhq/client/build/src/api-endpoints';
 import { PluggableList } from 'unified';
-import { Client } from '@notionhq/client';
 
 /**
  * ライブラリが動作するために必須なフィールド。
@@ -67,6 +66,8 @@ interface CMSSchemaProperties {
  * ジェネリクス型 T にカスタムコンテンツ型を指定できる（デフォルト: BaseContentItem）。
  */
 interface CMSConfig<T extends BaseContentItem = BaseContentItem> {
+    /** Notion API 認証情報。コンストラクタでクライアントを事前生成するために使用。 */
+    env?: CMSEnv;
     /** キャッシュ/画像保存用ストレージ。未設定時はキャッシュ機能を無効化。 */
     storage?: StorageAdapter;
     schema?: {
@@ -135,8 +136,10 @@ declare class CacheStore<T extends BaseContentItem = BaseContentItem> {
  *
  * @example
  * const cms = createCMS({
- *   schema: { properties: { slug: 'Slug' }, publishedStatuses: ['Published'] }
+ *   env: { NOTION_TOKEN: '...', NOTION_DATA_SOURCE_ID: '...' },
+ *   schema: { publishedStatuses: ['Published'] }
  * });
+ * const items = await cms.getItems();
  */
 declare class CMS<T extends BaseContentItem = BaseContentItem> {
     private readonly itemMapper;
@@ -149,40 +152,42 @@ declare class CMS<T extends BaseContentItem = BaseContentItem> {
     private readonly store;
     private readonly hasStorage;
     private readonly ttlMs;
+    private readonly client;
+    private readonly dataSourceId;
     constructor(config?: CMSConfig<T>);
-    createClient(env: Pick<CMSEnv, "NOTION_TOKEN">): Client;
+    private requireClient;
     /** 公開済みコンテンツ一覧を Notion から直接取得する。 */
-    getItems(env: CMSEnv): Promise<T[]>;
+    getItems(): Promise<T[]>;
     /** スラッグでコンテンツを Notion から直接取得する。 */
-    getItemBySlug(env: CMSEnv, slug: string): Promise<T | null>;
+    getItemBySlug(slug: string): Promise<T | null>;
     /** アイテムが publishedStatuses に含まれるステータスかどうかを返す。 */
     isPublished(item: T): boolean;
     /** コンテンツをMarkdown→HTMLにレンダリングし、CachedItemとして返す。 */
-    renderItem(env: CMSEnv, item: T): Promise<CachedItem<T>>;
+    renderItem(item: T): Promise<CachedItem<T>>;
     /** スラッグでコンテンツを取得してMarkdown→HTMLにレンダリングする。 */
-    renderItemBySlug(env: CMSEnv, slug: string): Promise<CachedItem<T> | null>;
+    renderItemBySlug(slug: string): Promise<CachedItem<T> | null>;
     getCachedItemList(): Promise<CachedItemList<T> | null>;
     setCachedItemList(items: T[]): Promise<void>;
     getCachedItem(slug: string): Promise<CachedItem<T> | null>;
     setCachedItem(slug: string, data: CachedItem<T>): Promise<void>;
     getCachedImage(hash: string): Promise<StorageBinary | null>;
     createCachedImageResponse(hash: string): Promise<Response | null>;
-    getItemsCachedFirst(env: CMSEnv, options?: {
+    getItemsCachedFirst(options?: {
         waitUntil?: (promise: Promise<void>) => void;
     }): Promise<{
         items: T[];
         listVersion: string;
     }>;
-    getItemCachedFirst(env: CMSEnv, slug: string, options?: {
+    getItemCachedFirst(slug: string, options?: {
         waitUntil?: (promise: Promise<void>) => void;
     }): Promise<CachedItem<T> | null>;
-    checkItemsUpdate(env: CMSEnv, clientVersion: string): Promise<{
+    checkItemsUpdate(clientVersion: string): Promise<{
         changed: false;
     } | {
         changed: true;
         items: T[];
     }>;
-    checkItemUpdate(env: CMSEnv, slug: string, lastEdited: string): Promise<{
+    checkItemUpdate(slug: string, lastEdited: string): Promise<{
         changed: false;
     } | {
         changed: true;

package/dist/index.js

@@ -194,6 +194,8 @@ var CMS = class {
   store;
   hasStorage;
   ttlMs;
+  client;
+  dataSourceId;
   constructor(config) {
     const props = {
       ...DEFAULT_PROPERTIES,
@@ -218,16 +220,27 @@ var CMS = class {
       config?.cache?.itemPrefix ?? DEFAULT_ITEM_PREFIX,
       config?.cache?.imagePrefix ?? DEFAULT_IMAGE_PREFIX
     );
+    if (config?.env) {
+      const { dataSourceId } = validateEnv(config.env);
+      this.client = createClient(config.env);
+      this.dataSourceId = dataSourceId;
+    }
   }
-  // ── Notionクライアント生成 ───────────────────────────────────────────────
-  createClient(env) {
-    return createClient(env);
+  // ── プライベートヘルパー（認証） ──────────────────────────────────────
+  requireClient() {
+    if (!this.client || !this.dataSourceId) {
+      throw new CMSError({
+        code: "CONFIG_INVALID",
+        message: "NOTION_TOKEN \u3068 NOTION_DATA_SOURCE_ID \u306F CMS \u306E\u8A2D\u5B9A\u306B\u5FC5\u8981\u3067\u3059\u3002",
+        context: { operation: "requireClient" }
+      });
+    }
+    return { client: this.client, dataSourceId: this.dataSourceId };
   }
   // ── コンテンツ取得 ────────────────────────────────────────────────────
   /** 公開済みコンテンツ一覧を Notion から直接取得する。 */
-  async getItems(env) {
-    const { dataSourceId } = validateEnv(env);
-    const client = createClient(env);
+  async getItems() {
+    const { client, dataSourceId } = this.requireClient();
     try {
       const pages = await queryAllPages(client, dataSourceId);
       const items = pages.map(this.itemMapper);
@@ -246,9 +259,8 @@ var CMS = class {
     }
   }
   /** スラッグでコンテンツを Notion から直接取得する。 */
-  async getItemBySlug(env, slug) {
-    const { dataSourceId } = validateEnv(env);
-    const client = createClient(env);
+  async getItemBySlug(slug) {
+    const { client, dataSourceId } = this.requireClient();
     try {
       const page = await queryPageBySlug(
         client,
@@ -278,15 +290,13 @@ var CMS = class {
     return this.publishedStatuses.includes(item.status);
   }
   /** コンテンツをMarkdown→HTMLにレンダリングし、CachedItemとして返す。 */
-  async renderItem(env, item) {
-    validateEnv(env);
-    const client = createClient(env);
+  async renderItem(item) {
+    const { client } = this.requireClient();
     return this.buildCachedItem(client, item);
   }
   /** スラッグでコンテンツを取得してMarkdown→HTMLにレンダリングする。 */
-  async renderItemBySlug(env, slug) {
-    const { dataSourceId } = validateEnv(env);
-    const client = createClient(env);
+  async renderItemBySlug(slug) {
+    const { client, dataSourceId } = this.requireClient();
     try {
       const page = await queryPageBySlug(
         client,
@@ -335,7 +345,7 @@ var CMS = class {
     return new Response(object.data, { headers });
   }
   // ── キャッシュ優先取得（Stale-While-Revalidate） ─────────────────────
-  async getItemsCachedFirst(env, options) {
+  async getItemsCachedFirst(options) {
     const cached = await this.store.getItemList();
     if (cached && !isStale(cached.cachedAt, this.ttlMs)) {
       return {
@@ -343,7 +353,7 @@ var CMS = class {
         listVersion: buildListVersion(cached.items)
       };
     }
-    const items = await this.getItems(env);
+    const items = await this.getItems();
     const save = this.store.setItemList(items);
     if (options?.waitUntil) {
       options.waitUntil(save);
@@ -352,10 +362,10 @@ var CMS = class {
     }
     return { items, listVersion: buildListVersion(items) };
   }
-  async getItemCachedFirst(env, slug, options) {
+  async getItemCachedFirst(slug, options) {
     const cached = await this.store.getItem(slug);
     if (cached && !isStale(cached.cachedAt, this.ttlMs)) return cached;
-    const entry = await this.renderItemBySlug(env, slug);
+    const entry = await this.renderItemBySlug(slug);
     if (!entry) return null;
     const save = this.store.setItem(slug, entry);
     if (options?.waitUntil) {
@@ -365,19 +375,19 @@ var CMS = class {
     }
     return entry;
   }
-  async checkItemsUpdate(env, clientVersion) {
-    const items = await this.getItems(env);
+  async checkItemsUpdate(clientVersion) {
+    const items = await this.getItems();
     const serverVersion = buildListVersion(items);
     if (serverVersion === clientVersion) return { changed: false };
     await this.store.setItemList(items);
     return { changed: true, items };
   }
-  async checkItemUpdate(env, slug, lastEdited) {
-    const item = await this.getItemBySlug(env, slug);
+  async checkItemUpdate(slug, lastEdited) {
+    const item = await this.getItemBySlug(slug);
     if (!item) return { changed: false };
     if (!this.isPublished(item)) return { changed: false };
     if (item.updatedAt === lastEdited) return { changed: false };
-    const entry = await this.renderItemBySlug(env, slug);
+    const entry = await this.renderItemBySlug(slug);
     if (!entry) return { changed: false };
     await this.store.setItem(slug, entry);
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@notion-headless-cms/core",
-  "version": "0.0.1",
+  "version": "0.0.5",
   "description": "Core CMS engine for notion-headless-cms — fetch, transform, cache with stale-while-revalidate strategy",
   "keywords": [
     "notion",
@@ -42,9 +42,9 @@
     "@notionhq/client": "^5.18.0",
     "unified": "^11.0.5",
     "zod": "^4.1.12",
-    "@notion-headless-cms/fetcher": "0.0.1",
-    "@notion-headless-cms/transformer": "0.0.1",
-    "@notion-headless-cms/renderer": "0.0.1"
+    "@notion-headless-cms/fetcher": "0.0.3",
+    "@notion-headless-cms/transformer": "0.0.3",
+    "@notion-headless-cms/renderer": "0.0.3"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --out-dir dist",