notion-to-md 3.1.7 → 4.0.0-alpha.1

package/README.md

@@ -1,322 +1,31 @@
-
-
-<!-- 
-💡 For better readability and detailed instructions head over to the [wiki](https://github.com/souvikinator/notion-to-md/wiki). 
--->
 <h1 align="center">
   <br>
-<img src="https://i.ibb.co/Pzyf13S/Group-168.png" alt="notion-to-md banner"  width="750" />
+  <img src="https://raw.githubusercontent.com/souvikinator/notion-to-md/refs/heads/v4.0.0-alpha.1/docs/notion-to-md/static/v4-banner.png" alt="notion-to-md banner" width="750" />
   <br>
-  <b>Notion-to-MD</b>
+  <b>Notion-to-MD v4 <sup>α</sup></b>
   <br>
-  <sub><sup><b>(Notion to Markdown)</b></sup></sub>
+  <sub><sup><b>Convert Notion to Markdown & Beyond</b></sup></sub>
   <br>
 </h1>
 
-<div align="center">
-  <a href="https://github.com/souvikinator/notion-to-md/discussions/112">
-    <img src="https://i.ibb.co/Tmyf805/Group-167.png" />
-  </a>
-</div>
-
-<div align="center">
-  <a href="https://discord.gg/drWw5Ya535">
-    <img src="https://i.ibb.co/ZTk7QCW/Group-186.png" />
-  </a>
-</div>
-
-<div align="center">
-  <a href="https://www.reddit.com/r/notion_to_md/">
-    <img src="https://i.ibb.co/vBN5Cgz/Frame-4.png" />
-  </a>
-</div>
-
 <p align="center">
-       Notion-to-MD is a Node.js package that allows you to convert Notion pages to Markdown format. 
-</p>
-<p align="center">
-  Convert notion pages, blocks and list of blocks to markdown (supports nesting) using <a href="https://github.com/makenotion/notion-sdk-js">notion-sdk-js</a>
+Powerful Notion conversion engine that lets you write once in Notion and seamlessly publish anywhere, in any format.
 </p>
+
 <p align="center">
 <img src="https://img.shields.io/github/stars/souvikinator/notion-to-md?style=flat" alt="github stars">
 <img src="https://img.shields.io/twitter/follow/souvikinator?color=blue&logo=x&style=flat" alt="twitter" />
 <img src="https://komarev.com/ghpvc/?username=notion-to-md&abbreviated=true&label=REPO+VIEWS" alt="repo views" />
 </p>
 
-## Looking for Support in Other Languages?
-> If you've created a specific client, please open an issue to have it added here.
-
-- [notion-to-md-py](https://github.com/SwordAndTea/notion-to-md-py) by [@SwordAndTea](https://github.com/SwordAndTea)
-
-## Install
-
-```Bash
-npm install notion-to-md
-```
-
-## Usage
-> ⚠️ **Note:** Before getting started, create [an integration and find the token](https://www.notion.so/my-integrations).
->  Details on methods can be found in [API section](https://github.com/souvikinator/notion-to-md#api)
-
-> ⚠️ **Note:** Starting from v2.7.0, `toMarkdownString` no longer automatically saves child pages. 
-> Now it provides an object containing the markdown content of child pages.
-
-## converting markdown objects to markdown string
-
-This is how the notion page looks for this example:
-
-<img src="https://imgur.com/O6bKCmH.png"  width="500"  />
-
-```javascript
-const { Client } = require("@notionhq/client");
-const { NotionToMarkdown } = require("notion-to-md");
-const fs = require('fs');
-// or
-// import {NotionToMarkdown} from "notion-to-md";
-
-const notion = new Client({
-  auth: "your integration token",
-});
-
-// passing notion client to the option
-const n2m = new NotionToMarkdown({ notionClient: notion });
-
-(async () => {
-  const mdblocks = await n2m.pageToMarkdown("target_page_id");
-  const mdString = n2m.toMarkdownString(mdblocks);
-  console.log(mdString.parent);
-})();
-```
-<img src="https://imgur.com/XrUYrZ0.png"  width="500"  />
-
-## Separate child page content
-
-**parent page content:**
-
-<img src="https://github.com/souvikinator/notion-to-md/assets/64456160/531ef45d-2dc7-47f4-bbb3-12d6fd44d299" width="500" />
-
-**child page content:**
-
-<img src="https://github.com/souvikinator/notion-to-md/assets/64456160/7dde090b-7333-46f8-b6df-e6c9a7b62fa9" width="500" />
-
-`NotionToMarkdown` takes second argument, `config`
-
-```javascript
-const { Client } = require("@notionhq/client");
-const { NotionToMarkdown } = require("notion-to-md");
-const fs = require('fs');
-// or
-// import {NotionToMarkdown} from "notion-to-md";
-
-const notion = new Client({
-  auth: "your integration token",
-});
-
-// passing notion client to the option
-const n2m = new NotionToMarkdown({ 
-  notionClient: notion,
-    config:{
-     separateChildPage:true, // default: false
-  }
- });
-
-(async () => {
-  const mdblocks = await n2m.pageToMarkdown("target_page_id");
-  const mdString = n2m.toMarkdownString(mdblocks);
-  
-  console.log(mdString);
-})();
-```
-
-**Output:**
-
-`toMarkdownString` returns an object with target page content corresponding to `parent` property and if any child page exists then it's included in the same object.
-
-<img src="https://github.com/souvikinator/notion-to-md/assets/64456160/99bcc14e-46e6-4bed-912d-8b9300c214c1" width="500" />
-
-User gets to save the content separately.
-
-## Disable child page parsing
-
-```javascript
-...
-
-const n2m = new NotionToMarkdown({ 
-  notionClient: notion,
-    config:{
-     parseChildPages:false, // default: parseChildPages
-  }
- });
-
-...
-```
-
-## converting page to markdown object
-
-**Example notion page:**
-
-<img src="https://imgur.com/9iqRpBl.png"  width="500"  />
-
-```js
-const { Client } = require("@notionhq/client");
-const { NotionToMarkdown } = require("notion-to-md");
-
-const notion = new Client({
-  auth: "your integration token",
-});
-
-// passing notion client to the option
-const n2m = new NotionToMarkdown({ notionClient: notion });
-
-(async () => {
-  // notice second argument, totalPage.
-  const x = await n2m.pageToMarkdown("target_page_id", 2);
-  console.log(x);
-})();
-```
-
-**Output:**
-
-```json
-[
-  {
-    "parent": "# heading 1",
-    "children": []
-  },
-  {
-    "parent": "- bullet 1",
-    "children": [
-      {
-        "parent": "- bullet 1.1",
-        "children": []
-      },
-      {
-        "parent": "- bullet 1.2",
-        "children": []
-      }
-    ]
-  },
-  {
-    "parent": "- bullet 2",
-    "children": []
-  },
-  {
-    "parent": "- [ ] check box 1",
-    "children": [
-      {
-        "parent": "- [x] check box 1.2",
-        "children": []
-      },
-      {
-        "parent": "- [ ] check box 1.3",
-        "children": []
-      }
-    ]
-  },
-  {
-    "parent": "- [ ] checkbox 2",
-    "children": []
-  }
-]
-```
-
-## converting list of blocks to markdown object
-
-```js
-const { Client } = require("@notionhq/client");
-const { NotionToMarkdown } = require("notion-to-md");
-
-const notion = new Client({
-  auth: "your integration token",
-});
-
-// passing notion client to the option
-const n2m = new NotionToMarkdown({ notionClient: notion });
-
-(async () => {
-  // get all blocks in the page
-  const { results } = await notion.blocks.children.list({
-    block_id,
-  });
-
-  //convert to markdown
-  const x = await n2m.blocksToMarkdown(results);
-  console.log(x);
-})();
-```
-
-**Output**: same as before
-
-## Converting a single block to markdown string
-
-- only takes a single notion block and returns corresponding markdown string
-- nesting is ignored
-- depends on @notionhq/client
-
-```js
-const { NotionToMarkdown } = require("notion-to-md");
-
-// passing notion client to the option
-const n2m = new NotionToMarkdown({ notionClient: notion });
-
-const result = n2m.blockToMarkdown(block);
-console.log(result);
-```
-
-**result**:
-
-```
-![image](https://media.giphy.com/media/Ju7l5y9osyymQ/giphy.gif)
-```
-
-## Custom Transformers
-
-You can define your own custom transformer for a notion type, to parse and return your own string.
-`setCustomTransformer(type, func)` will overload the parsing for the giving type.
-
-```ts
-const { NotionToMarkdown } = require("notion-to-md");
-const n2m = new NotionToMarkdown({ notionClient: notion });
-n2m.setCustomTransformer("embed", async (block) => {
-  const { embed } = block as any;
-  if (!embed?.url) return "";
-  return `<figure>
-  <iframe src="${embed?.url}"></iframe>
-  <figcaption>${await n2m.blockToMarkdown(embed?.caption)}</figcaption>
-</figure>`;
-});
-const result = n2m.blockToMarkdown(block);
-// Result will now parse the `embed` type with your custom function.
-```
-
-**Note** Be aware that `setCustomTransformer` will take only the last function for the given type. You can't set two different transforms for the same type.
-
-You can also use the default parsing by returning `false` in your custom transformer.
-
-```ts
-// ...
-n2m.setCustomTransformer("embed", async (block) => {
-  const { embed } = block as any;
-  if (embed?.url?.includes("myspecialurl.com")) {
-    return `...`; // some special rendering
-  }
-  return false; // use default behavior
-});
-const result = n2m.blockToMarkdown(block);
-// Result will now only use custom parser if the embed url matches a specific url
-```
-
-## Contribution
+## Vision
 
-Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
-Please make sure to update tests as appropriate.
+Notion-to-MD v4 represents a fundamental reimagining of what a Notion conversion library can be. Building on the solid foundation of previous versions, v4 introduces a modular, extensible architecture designed to meet the evolving needs of modern content workflows.
 
-## Contributers
+We aim to build more than a Markdown converter; our goal is to develop a comprehensive content transformation system that seamlessly adapts to diverse output formats, allows instant export anywhere, and integrates smoothly into any content workflow while preserving the structure and richness of Notion content.
 
-<a href="https://github.com/souvikinator/notion-to-md/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=souvikinator/notion-to-md" />
-</a>
+## Documentation
 
-## License
+For installation instructions, complete API references, and detailed examples, please visit our comprehensive documentation:
 
-[MIT](https://choosealicense.com/licenses/mit/)
+[https://notionconvert.com/notion-to-md/](https://notionconvert.com/notion-to-md/)

package/build/core/block-fetcher/index.d.ts

@@ -0,0 +1,36 @@
+import { Client } from '@notionhq/client';
+import { ExtendedFetcherOutput, ProcessorChainNode, ChainData } from '../../types';
+export interface BlockFetcherConfig {
+    fetchPageProperties?: boolean;
+    fetchComments?: boolean;
+    maxRequestsPerSecond?: number;
+    batchSize?: number;
+    trackMediaBlocks?: boolean;
+    trackPageRefBlocks?: boolean;
+}
+export declare class BlockFetcher implements ProcessorChainNode {
+    private client;
+    private config;
+    next?: ProcessorChainNode;
+    private queue;
+    private blocks;
+    private processedTasks;
+    private pageProperties?;
+    private rootComments;
+    private rootBlockId;
+    private mediaBlocks;
+    private pageRefBlocks;
+    private rateLimitWindow;
+    constructor(pageId: string, client: Client, config?: BlockFetcherConfig);
+    process(data: ChainData): Promise<ChainData>;
+    getBlocks(pageId: string): Promise<ExtendedFetcherOutput>;
+    private addTask;
+    private processTask;
+    private rateLimitRequest;
+    private fetchBlockChildren;
+    private fetchAllComments;
+    private fetchPageProperties;
+    private normalizeId;
+    private buildBlockTree;
+}
+//# sourceMappingURL=index.d.ts.map

package/build/core/block-fetcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/block-fetcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAML,qBAAqB,EACrB,kBAAkB,EAClB,SAAS,EACV,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,kBAAkB;IACjC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAQD,qBAAa,YAAa,YAAW,kBAAkB;IAmBnD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IAnBhB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAE1B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,cAAc,CAAC,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,aAAa,CAAyC;IAE9D,OAAO,CAAC,eAAe,CAGrB;gBAGA,MAAM,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,kBAKf;IAOG,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAW5C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA6C/D,OAAO,CAAC,OAAO;YAOD,WAAW;YAuEX,gBAAgB;YA0BhB,kBAAkB;YA6BlB,gBAAgB;YAuBhB,mBAAmB;IAUjC,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,cAAc;CAmCvB"}

package/build/core/block-fetcher/index.js

@@ -0,0 +1,241 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockFetcher = void 0;
+const notion_1 = require("../../utils/notion");
+class BlockFetcher {
+    constructor(pageId, client, config = {
+        fetchPageProperties: false,
+        fetchComments: false,
+        maxRequestsPerSecond: 3,
+        batchSize: 3,
+    }) {
+        var _a, _b;
+        this.client = client;
+        this.config = config;
+        this.queue = [];
+        this.blocks = new Map();
+        this.processedTasks = new Set();
+        this.rootComments = [];
+        this.rootBlockId = '';
+        this.mediaBlocks = [];
+        this.pageRefBlocks = [];
+        this.rateLimitWindow = {
+            requests: 0,
+            startTime: Date.now(),
+        };
+        const moduleType = 'BlockFetcher';
+        this.config.maxRequestsPerSecond = (_a = config.maxRequestsPerSecond) !== null && _a !== void 0 ? _a : 3;
+        this.config.batchSize = (_b = config.batchSize) !== null && _b !== void 0 ? _b : 3;
+    }
+    async process(data) {
+        const blockTree = await this.getBlocks(data.pageId);
+        const updatedData = {
+            ...data,
+            blockTree,
+        };
+        return this.next ? this.next.process(updatedData) : updatedData;
+    }
+    async getBlocks(pageId) {
+        this.rootBlockId = pageId;
+        this.queue = [];
+        this.blocks.clear();
+        this.processedTasks.clear();
+        this.pageProperties = undefined;
+        this.rootComments = [];
+        // Initialize queue with root level tasks
+        this.addTask({ type: 'fetch_blocks', id: pageId });
+        if (this.config.fetchPageProperties) {
+            this.addTask({ type: 'fetch_properties', id: pageId });
+        }
+        if (this.config.fetchComments) {
+            this.addTask({ type: 'fetch_comments', id: pageId });
+        }
+        // Process queue until empty
+        while (this.queue.length > 0) {
+            const batch = this.queue.splice(0, this.config.batchSize);
+            await Promise.all(batch.map((task) => this.processTask(task)));
+        }
+        const baseOutput = {
+            properties: this.pageProperties || {},
+            comments: this.rootComments,
+            blocks: this.buildBlockTree(pageId),
+        };
+        // Only include special arrays if tracking was enabled
+        if (this.config.trackMediaBlocks || this.config.trackPageRefBlocks) {
+            return {
+                ...baseOutput,
+                ...(this.config.trackMediaBlocks && { mediaBlocks: this.mediaBlocks }),
+                ...(this.config.trackPageRefBlocks && {
+                    pageRefBlocks: this.pageRefBlocks,
+                }),
+            };
+        }
+        return baseOutput;
+    }
+    addTask(task) {
+        const taskId = `${task.type}-${task.id}`;
+        if (!this.processedTasks.has(taskId)) {
+            this.queue.push(task);
+        }
+    }
+    async processTask(task) {
+        const taskId = `${task.type}-${task.id}`;
+        if (this.processedTasks.has(taskId))
+            return;
+        switch (task.type) {
+            case 'fetch_blocks': {
+                const blocks = await this.fetchBlockChildren(task.id);
+                for (const block of blocks) {
+                    const storedBlock = {
+                        ...block,
+                        children: [],
+                        comments: [],
+                    };
+                    this.blocks.set(block.id, storedBlock);
+                    // Track special blocks if enabled (storing references)
+                    // these will be used by the next stage saving us from a
+                    // lot of recursive calls to idenitfy blocks
+                    if (this.config.trackMediaBlocks && (0, notion_1.isMediaBlock)(storedBlock)) {
+                        this.mediaBlocks.push(storedBlock);
+                    }
+                    if (this.config.trackPageRefBlocks && (0, notion_1.isPageRefBlock)(storedBlock)) {
+                        this.pageRefBlocks.push(storedBlock);
+                    }
+                    // If block has children, queue task to fetch them
+                    if ('has_children' in block && block.has_children) {
+                        this.addTask({
+                            type: 'fetch_blocks',
+                            id: block.id,
+                            parentId: task.id,
+                        });
+                    }
+                    // Queue comment fetching for each block if enabled
+                    // extra api call for comment fetching, no way to know otherwise
+                    if (this.config.fetchComments) {
+                        this.addTask({
+                            type: 'fetch_comments',
+                            id: block.id,
+                        });
+                    }
+                }
+                break;
+            }
+            case 'fetch_comments': {
+                const comments = await this.fetchAllComments(task.id);
+                if (task.id === this.rootBlockId) {
+                    // page level comments
+                    this.rootComments = comments;
+                }
+                else {
+                    const block = this.blocks.get(task.id);
+                    if (block) {
+                        block.comments = comments;
+                    }
+                }
+                break;
+            }
+            case 'fetch_properties': {
+                const properties = await this.fetchPageProperties(task.id);
+                this.pageProperties = properties;
+                break;
+            }
+        }
+        this.processedTasks.add(taskId);
+    }
+    async rateLimitRequest(request) {
+        const now = Date.now();
+        const windowSize = 1000;
+        // Reset window if it's expired
+        if (now - this.rateLimitWindow.startTime >= windowSize) {
+            this.rateLimitWindow = {
+                requests: 0,
+                startTime: now,
+            };
+        }
+        // Wait if we've hit the rate limit
+        if (this.rateLimitWindow.requests >= this.config.maxRequestsPerSecond) {
+            const waitTime = windowSize - (now - this.rateLimitWindow.startTime);
+            await new Promise((resolve) => setTimeout(resolve, waitTime));
+            this.rateLimitWindow = {
+                requests: 0,
+                startTime: Date.now(),
+            };
+        }
+        this.rateLimitWindow.requests++;
+        return request();
+    }
+    async fetchBlockChildren(blockId) {
+        var _a;
+        let allBlocks = [];
+        let hasMore = true;
+        let cursor;
+        while (hasMore) {
+            const response = await this.rateLimitRequest(() => this.client.blocks.children.list({
+                block_id: blockId,
+                start_cursor: cursor,
+            }));
+            // Filter out unsupported blocks
+            // should we leave it here or let user handle it in renderer?
+            const blocks = response.results.filter((block) => 'type' in block && block.type !== 'unsupported');
+            allBlocks = [...allBlocks, ...blocks];
+            hasMore = response.has_more;
+            cursor = (_a = response.next_cursor) !== null && _a !== void 0 ? _a : undefined;
+        }
+        return allBlocks;
+    }
+    async fetchAllComments(blockId) {
+        var _a;
+        let allComments = [];
+        let hasMore = true;
+        let cursor;
+        while (hasMore) {
+            const response = await this.rateLimitRequest(() => this.client.comments.list({
+                block_id: blockId,
+                start_cursor: cursor,
+            }));
+            allComments = [...allComments, ...response.results];
+            hasMore = response.has_more;
+            cursor = (_a = response.next_cursor) !== null && _a !== void 0 ? _a : undefined;
+        }
+        return allComments;
+    }
+    async fetchPageProperties(pageId) {
+        const response = await this.rateLimitRequest(() => this.client.pages.retrieve({ page_id: pageId }));
+        return 'properties' in response ? response.properties : {};
+    }
+    normalizeId(id) {
+        return id.replace(/-/g, '');
+    }
+    buildBlockTree(rootId) {
+        var _a, _b;
+        const childrenMap = new Map();
+        for (const [id, block] of this.blocks.entries()) {
+            const parentId = 
+            // @ts-ignore
+            ((_a = block.parent) === null || _a === void 0 ? void 0 : _a.type) === 'block_id'
+                ? // @ts-ignore
+                    this.normalizeId(block.parent.block_id)
+                : // @ts-ignore
+                    ((_b = block.parent) === null || _b === void 0 ? void 0 : _b.type) === 'page_id'
+                        ? // @ts-ignore
+                            this.normalizeId(block.parent.page_id)
+                        : undefined;
+            if (parentId) {
+                if (!childrenMap.has(parentId)) {
+                    childrenMap.set(parentId, []);
+                }
+                childrenMap.get(parentId).push(block);
+            }
+        }
+        const buildChildren = (parentId) => {
+            const children = childrenMap.get(this.normalizeId(parentId)) || [];
+            return children.map((block) => {
+                block.children = buildChildren(block.id);
+                return block;
+            });
+        };
+        return buildChildren(rootId);
+    }
+}
+exports.BlockFetcher = BlockFetcher;
+//# sourceMappingURL=index.js.map

package/build/core/block-fetcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/block-fetcher/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { Client } from '@notionhq/client';\nimport {\n  ListBlockChildrenResponseResult,\n  PageObjectProperties,\n  CommentResponseResults,\n  FetcherOutput,\n  ListBlockChildrenResponseResults,\n  ExtendedFetcherOutput,\n  ProcessorChainNode,\n  ChainData,\n} from '../../types';\nimport { isMediaBlock, isPageRefBlock } from '../../utils/notion';\n\nexport interface BlockFetcherConfig {\n  fetchPageProperties?: boolean;\n  fetchComments?: boolean;\n  maxRequestsPerSecond?: number;\n  batchSize?: number;\n  trackMediaBlocks?: boolean;\n  trackPageRefBlocks?: boolean;\n}\n\ninterface QueueTask {\n  type: 'fetch_properties' | 'fetch_comments' | 'fetch_blocks';\n  id: string;\n  parentId?: string;\n}\n\nexport class BlockFetcher implements ProcessorChainNode {\n  next?: ProcessorChainNode;\n\n  private queue: QueueTask[] = [];\n  private blocks = new Map<string, ListBlockChildrenResponseResult>();\n  private processedTasks = new Set<string>();\n  private pageProperties?: PageObjectProperties;\n  private rootComments: CommentResponseResults = [];\n  private rootBlockId: string = '';\n  private mediaBlocks: ListBlockChildrenResponseResult[] = [];\n  private pageRefBlocks: ListBlockChildrenResponseResult[] = [];\n\n  private rateLimitWindow = {\n    requests: 0,\n    startTime: Date.now(),\n  };\n\n  constructor(\n    pageId: string,\n    private client: Client,\n    private config: BlockFetcherConfig = {\n      fetchPageProperties: false,\n      fetchComments: false,\n      maxRequestsPerSecond: 3,\n      batchSize: 3,\n    },\n  ) {\n    const moduleType = 'BlockFetcher';\n    this.config.maxRequestsPerSecond = config.maxRequestsPerSecond ?? 3;\n    this.config.batchSize = config.batchSize ?? 3;\n  }\n\n  async process(data: ChainData): Promise<ChainData> {\n    const blockTree = await this.getBlocks(data.pageId);\n\n    const updatedData: ChainData = {\n      ...data,\n      blockTree,\n    };\n\n    return this.next ? this.next.process(updatedData) : updatedData;\n  }\n\n  async getBlocks(pageId: string): Promise<ExtendedFetcherOutput> {\n    this.rootBlockId = pageId;\n    this.queue = [];\n    this.blocks.clear();\n    this.processedTasks.clear();\n    this.pageProperties = undefined;\n    this.rootComments = [];\n\n    // Initialize queue with root level tasks\n    this.addTask({ type: 'fetch_blocks', id: pageId });\n\n    if (this.config.fetchPageProperties) {\n      this.addTask({ type: 'fetch_properties', id: pageId });\n    }\n\n    if (this.config.fetchComments) {\n      this.addTask({ type: 'fetch_comments', id: pageId });\n    }\n\n    // Process queue until empty\n    while (this.queue.length > 0) {\n      const batch = this.queue.splice(0, this.config.batchSize);\n      await Promise.all(batch.map((task) => this.processTask(task)));\n    }\n\n    const baseOutput: FetcherOutput = {\n      properties: this.pageProperties || {},\n      comments: this.rootComments,\n      blocks: this.buildBlockTree(pageId),\n    };\n\n    // Only include special arrays if tracking was enabled\n    if (this.config.trackMediaBlocks || this.config.trackPageRefBlocks) {\n      return {\n        ...baseOutput,\n        ...(this.config.trackMediaBlocks && { mediaBlocks: this.mediaBlocks }),\n        ...(this.config.trackPageRefBlocks && {\n          pageRefBlocks: this.pageRefBlocks,\n        }),\n      };\n    }\n\n    return baseOutput;\n  }\n\n  private addTask(task: QueueTask): void {\n    const taskId = `${task.type}-${task.id}`;\n    if (!this.processedTasks.has(taskId)) {\n      this.queue.push(task);\n    }\n  }\n\n  private async processTask(task: QueueTask): Promise<void> {\n    const taskId = `${task.type}-${task.id}`;\n    if (this.processedTasks.has(taskId)) return;\n\n    switch (task.type) {\n      case 'fetch_blocks': {\n        const blocks = await this.fetchBlockChildren(task.id);\n\n        for (const block of blocks) {\n          const storedBlock = {\n            ...block,\n            children: [],\n            comments: [],\n          };\n          this.blocks.set(block.id, storedBlock);\n\n          // Track special blocks if enabled (storing references)\n          // these will be used by the next stage saving us from a\n          // lot of recursive calls to idenitfy blocks\n          if (this.config.trackMediaBlocks && isMediaBlock(storedBlock)) {\n            this.mediaBlocks.push(storedBlock);\n          }\n          if (this.config.trackPageRefBlocks && isPageRefBlock(storedBlock)) {\n            this.pageRefBlocks.push(storedBlock);\n          }\n\n          // If block has children, queue task to fetch them\n          if ('has_children' in block && block.has_children) {\n            this.addTask({\n              type: 'fetch_blocks',\n              id: block.id,\n              parentId: task.id,\n            });\n          }\n\n          // Queue comment fetching for each block if enabled\n          // extra api call for comment fetching, no way to know otherwise\n          if (this.config.fetchComments) {\n            this.addTask({\n              type: 'fetch_comments',\n              id: block.id,\n            });\n          }\n        }\n        break;\n      }\n\n      case 'fetch_comments': {\n        const comments = await this.fetchAllComments(task.id);\n        if (task.id === this.rootBlockId) {\n          // page level comments\n          this.rootComments = comments;\n        } else {\n          const block = this.blocks.get(task.id);\n          if (block) {\n            block.comments = comments;\n          }\n        }\n        break;\n      }\n\n      case 'fetch_properties': {\n        const properties = await this.fetchPageProperties(task.id);\n        this.pageProperties = properties;\n        break;\n      }\n    }\n\n    this.processedTasks.add(taskId);\n  }\n\n  private async rateLimitRequest<T>(request: () => Promise<T>): Promise<T> {\n    const now = Date.now();\n    const windowSize = 1000;\n\n    // Reset window if it's expired\n    if (now - this.rateLimitWindow.startTime >= windowSize) {\n      this.rateLimitWindow = {\n        requests: 0,\n        startTime: now,\n      };\n    }\n\n    // Wait if we've hit the rate limit\n    if (this.rateLimitWindow.requests >= this.config.maxRequestsPerSecond!) {\n      const waitTime = windowSize - (now - this.rateLimitWindow.startTime);\n      await new Promise((resolve) => setTimeout(resolve, waitTime));\n      this.rateLimitWindow = {\n        requests: 0,\n        startTime: Date.now(),\n      };\n    }\n\n    this.rateLimitWindow.requests++;\n    return request();\n  }\n\n  private async fetchBlockChildren(\n    blockId: string,\n  ): Promise<ListBlockChildrenResponseResults> {\n    let allBlocks: ListBlockChildrenResponseResults = [];\n    let hasMore = true;\n    let cursor: string | undefined;\n\n    while (hasMore) {\n      const response = await this.rateLimitRequest(() =>\n        this.client.blocks.children.list({\n          block_id: blockId,\n          start_cursor: cursor,\n        }),\n      );\n\n      // Filter out unsupported blocks\n      // should we leave it here or let user handle it in renderer?\n      const blocks = response.results.filter(\n        (block) => 'type' in block && block.type !== 'unsupported',\n      ) as ListBlockChildrenResponseResults;\n\n      allBlocks = [...allBlocks, ...blocks];\n      hasMore = response.has_more;\n      cursor = response.next_cursor ?? undefined;\n    }\n\n    return allBlocks;\n  }\n\n  private async fetchAllComments(\n    blockId: string,\n  ): Promise<CommentResponseResults> {\n    let allComments: CommentResponseResults = [];\n    let hasMore = true;\n    let cursor: string | undefined;\n\n    while (hasMore) {\n      const response = await this.rateLimitRequest(() =>\n        this.client.comments.list({\n          block_id: blockId,\n          start_cursor: cursor,\n        }),\n      );\n\n      allComments = [...allComments, ...response.results];\n      hasMore = response.has_more;\n      cursor = response.next_cursor ?? undefined;\n    }\n\n    return allComments;\n  }\n\n  private async fetchPageProperties(\n    pageId: string,\n  ): Promise<PageObjectProperties> {\n    const response = await this.rateLimitRequest(() =>\n      this.client.pages.retrieve({ page_id: pageId }),\n    );\n\n    return 'properties' in response ? response.properties : {};\n  }\n\n  private normalizeId(id: string): string {\n    return id.replace(/-/g, '');\n  }\n\n  private buildBlockTree(rootId: string): ListBlockChildrenResponseResults {\n    const childrenMap = new Map<string, ListBlockChildrenResponseResult[]>();\n\n    for (const [id, block] of this.blocks.entries()) {\n      const parentId =\n        // @ts-ignore\n        block.parent?.type === 'block_id'\n          ? // @ts-ignore\n            this.normalizeId(block.parent.block_id)\n          : // @ts-ignore\n            block.parent?.type === 'page_id'\n            ? // @ts-ignore\n              this.normalizeId(block.parent.page_id)\n            : undefined;\n\n      if (parentId) {\n        if (!childrenMap.has(parentId)) {\n          childrenMap.set(parentId, []);\n        }\n        childrenMap.get(parentId)!.push(block);\n      }\n    }\n\n    const buildChildren = (\n      parentId: string,\n    ): ListBlockChildrenResponseResults => {\n      const children = childrenMap.get(this.normalizeId(parentId)) || [];\n      return children.map((block) => {\n        block.children = buildChildren(block.id);\n        return block;\n      });\n    };\n\n    return buildChildren(rootId);\n  }\n}\n"]}

package/build/core/errors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Specific error for when manifest management fails
+ */
+export declare class ManifestNotInitializedError extends Error {
+    constructor(moduleType: string);
+}
+export declare class MediaHandlerError extends Error {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Specific error class for page reference handling errors
+ */
+export declare class PageReferenceHandlerError extends Error {
+    constructor(message: string, cause?: Error);
+}
+//# sourceMappingURL=errors.d.ts.map

package/build/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;gBACxC,UAAU,EAAE,MAAM;CAM/B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI3C;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI3C"}