Package Exports

notion-page-tree
notion-page-tree/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (notion-page-tree) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Notion Page Tree

Fetch nested Notion pages from the root page/database/block.

npm size

Notion Page Tree

Why Would I Want This?

🙌 Use the official Notion API.

Popular /loadpagechunk/ endpoint is not public and may not be stable in future updates.
Official API can be integrated with private key, so you can keep your database private.

🕸 Fetch nested children pages.

Pages inside non-page blocks are also fetched.
Max request-depth can be set in your preference.
Main fetch loop uses nodejs timers, so it's safe from maxing out recursion depth.

🛠 Handle API Errors gracefully.

Maximum fetch concurrency is set to avoid rate_limited error.
On rate_limited error, it stops and waits for some minutes.
Other errors are automatically retried. Max retry count can be set in your preference.

Other Features

💾 It saves fetch results to your local disk.

Set parameter private_file_path to your custom path.

🥞 It builds basic page server.

/page/:id/ endpoint for retrieving page and its childrens' id.
/tree/:id/ endpoint for retrieving all nested pages from the page.

🔎 It builds basic page search indexes (missing feature of the official Notion API).

Uses lunr.js.
Page's properties and chilren are converted into plain text for building search index.
/search?keyword= endpoint for searching page properties and retrieving page ids.
/suggestion?keyword= endpoint for looking for search index's tokens.

Advices

⚠️ This library is not for fetching the whole nested page content.

This library is for listing nested pages to some depth and retrieve their properties.
Page's block children are fetched to boost up the search index results, not to display them.
If you want to render the whole page, use amazing libraries like react-notion-x (yet you should share your pages publically to the web).

⚠️ I recommend to keep maxRequestDepth lower than 5 and maxBlockDepth lower than 2.

Increasing max request depth will increase request count exponentially
If you want to fetch deeply nested pages, don't put them under plain blocks. Rather put them directly on the page's root level.

Usage

See ./sample/index.ts for full example file.

`.env` File Configuration

Write directly on <package_root>/.env

NOTION_ENTRY_ID = <root page/database/block's id>
NOTION_ENTRY_KEY = <root's integration key>
NOTION_ENTRY_TYPE = <page/database/block>

Basic Usage

import NotionPageTree from 'notion-page-tree';

async function simple_use() {
    const notionPageTree = new NotionPageTree();
    // construct main class instance

    const server = notionPageTree.setupServer({ port: 8889 });
    // Setup servers for listing and searching pages. (will respond 503 if pages are not fetched yet)

    await notionPageTree.parseCachedDocument();
    // Look for cached documents in private_file_path.

    await notionPageTree.setRequestParameters({ prompt: true });
    // Set environment variables that are needed for requesting Notion API.

    await notionPageTree.fetchOnce();
    // Fetch pages once asynchronously.

    notionPageTree.startFetchLoop(1000 * 10);
    // Create an asynchronouse fetch loop. Wait for some milliseconds between each fetch.

    setTimeout(() => {
        notionPageTree.stopFetchLoop();
        // Stopping fetch loop immediately.

        server.close();
        // Stopping servers immediately.
    }, 1000 * 30);
}
simple_use();

Usage with More Options

import NotionPageTree from 'notion-page-tree';
import path from 'path';

async function use_more_options() {
    const notionPageTree = new NotionPageTree({
        private_file_path: path.resolve('./results/'), // path to save serialized page data

        searchIndexing: false, // turn off search indexing

        createFetchQueueOptions: {
            maxConcurrency: 3,
            // Current official rate limit is 3 requests per second. Notion api would likely to throw error when you increase this value.

            maxRetry: 2,
            // How many times errored request are retried ("rate_limited" error will wait some minutes before retrying)

            maxRequestDepth: 3,
            // Search depth applied to all the entities.

            maxBlockDepth: 2,
            // Search depth applied only to plain blocks (not page or database, relative depth to the nearest parent page).

            databaseQueryFilter: {
                // Use filters when querying databases (Find details in official notion API).
                property: 'isPublished',
                checkbox: {
                    equals: true
                }
            }
        }
    });

    await notionPageTree.parseCachedDocument();
    const server = notionPageTree.setupServer({ port: 8888 });

    await notionPageTree.setRequestParameters({
        prompt: true,
        // Prompt and rewrite .env if parameters don't exist.

        forceRewrite: false
        // Prompt and rewrite .env even if parameters exist.
    });
    await notionPageTree.fetchOnce();

    notionPageTree.startFetchLoop(1000 * 10);

    setTimeout(() => {
        notionPageTree.stopFetchLoop();
        server.close();
    }, 1000 * 30);
}

Shape of Data

Notion's Original Block Tree Structure


             ┌────────────┐
             │ database A │
             └────────────┘
                    │
       ┌────────────┴────────────────────┐
       ▼                                 ▼
┌────────────┐                    ┌────────────┐
│   page A   │                    │   page B   │
└────────────┘                    └────────────┘
       │                                 │
       │                                 │
       ▼                                 ▼
┌────────────┐                    ┌─────────────┐
│ check list │                    │ bullet-list │
└────────────┘                    └─────────────┘
       │                                 │
       │                 ┌───────────────┼───────────────┐
       ▼                 ▼               ▼               ▼
┌────────────┐    ┌────────────┐  ┌────────────┐  ┌────────────┐
│toggle list │    │   page C   │  │   page D   │  │list element│
└────────────┘    └────────────┘  └────────────┘  └────────────┘
       │                 │                               │
       │                 │                               │
       ▼                 ▼                               ▼
┌────────────┐    ┌────────────┐                  ┌────────────┐
│   page E   │    │ database B │                  │list Element│
└────────────┘    └────────────┘                  └────────────┘

Fetched Page Structure


                  ┌────────────┐
                  │ database A │
                  └────────────┘
                         │
        ┌────────────────┴────────────────┐
        ▼                                 ▼
┌───────────────┐                 ┌───────────────┐
│page A         │                 │page B         │
│               │                 │               │
│ blockChildren │                 │ blockChildren │
│ PlainText     │                 │ PlainText     │
│┌─────────────┐│                 │┌─────────────┐│
││ check list  ││                 ││ bullet list ││
│├─────────────┤│                 │├─────────────┤│
││ toggle list ││                 ││list element ││
│└─────────────┘│                 │├─────────────┤│
└───────┬───────┘                 ││list element ││
        ▼                         │└─────────────┘│
 ┌────────────┐                   └───────┬───────┘
 │   page E   │                   ┌───────┴───────┐
 └────────────┘                   ▼               ▼
                           ┌────────────┐  ┌────────────┐
                           │   page C   │  │   page D   │
                           └────────────┘  └────────────┘
                                  │
                                  ▼
                           ┌────────────┐
                           │ database B │
                           └────────────┘

Entity Data Types

`Entity`

Entity that has children as direct reference.

type Entity = Commons & (Page | Database | Block);
interface Commons {
    id: string;
    depth: number;
    blockContentPlainText: string;
    parent?: Entity;
    children: Entity[];
}

`PlainEntity`

Entity that has children as id.

type FlatEntity = FlatCommons & (Page | Database | Block);
interface FlatCommons {
    id: string;
    depth: number;
    blockContentPlainText: string;
    parent?: string;
    children: string[];
}

`Page | Database | Block`

Notion API's fetch request result for each entity types, with typed properties included.

export interface Page {
    type: 'page';
    metadata: Extract<GetPageResponse, { last_edited_time: string }>;
}
export interface Database {
    type: 'database';
    metadata: Extract<GetDatabaseResponse, { last_edited_time: string }>;
}
export interface Block {
    type: 'block';
    metadata: Extract<GetBlockResponse, { type: string }>;
}

Fetch Result Data Types

`NotionPageTree.prototype.page_collection`

Key, value collection of id and PlainEntity

page_collection: Record<string, FlatEntity> | undefined;

`NotionPageTree.prototype.root`

Root Entity that has nested children Entitys.

root: Entity | undefined;

`NotionPageTree.prototype.search_index`

lunr.Index built with page_collection entities' blockContentPlainText.

search_index: lunr.Index | undefined;

`NotionPageTree.prototype.search_suggestion`

Search tokens extracted from lunr.Index.

search_suggestion: string[] | undefined;

How It Creates Fetch Queue

NodeJS Promise Queue Example

Try it on the Stackblitz. https://stackblitz.com/edit/react-sp2zy3?embed=1&file=src/job.js

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Request Ready Queue ┃ ┃ ┃ ┃ ┌────────────┬────────────┐ ┃ ┃ │ job │ job │ ... ┃ ┃ │description │description │ ┃ ┃ └────────────┴────────────┘ ┃ ┃ │ ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ │ If promise └ queue has ─ ┐ empty slot │ ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Request Promise Queue │ ┃ ┃ ▼ ┃ ┃ ┌────────────┐┌────────────┐┌ ─ ─ ─ ─ ─ ─ ┃ ┃ │ queryable ││ queryable │ (Empty Slot)│┃ ┃ │ promise ││ promise ││ ┃ ┃ └────────────┘└────────────┘ ─ ─ ─ ─ ─ ─ ┘┃ ┃ │ ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛ │ If promise is setteled │ ┌────────────┐ │ promise │ └ ─ ─ ▶│ handler() │ └────────────┘

Flowchart

/******************************************************************************************************************************************************************************************************************************************************************************************************************************\
*                                                                                                                                                                                                                                                                                                                              *
*                                                                                                                                                                                                                                                                                                                              *
*                                                                                                                                                                                                                                                                                                                              *
*                                                                                                                                                                                                                                                                                                                              *
*    ┏━━━━━━━Main Routine━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓                                                                                                                                                *
*    ┃                                                                                                                                                                        ┃                                                                                                                                                *
*    ┃                                                                                                                                                                        ┃                                                                                                                                                *
*    ┃                                          ┌───────────────────────┐                                                           ┌───────────────────────┐                 ┃                                                                                                                                                *
*    ┃                                     ┌───▶│    page_collection    │                                        ┌clearTimeout()───▶│ Request Promise Timer │                 ┃                                                                                                                                                *
*    ┃                                     │    └───────────────────────┘                                        │                  └───────────────────────┘                 ┃                                                                                                                                                *
*    ┃                                     │                                                  Λ                  │                                                            ┃                                                                                                                                                *
*    ┃                                     │    ┌───────────────────────┐                    ╱ ╲                 │                  ┌───────────────────────┐                 ┃                                                                                                                                                *
*    ┃                                     ├───▶│       page_tree       │                   ╱   ╲                ├clearTimeout()───▶│  Request Ready Timer  │                 ┃                                                                                                                                                *
*    ┃                                     │    └───────────────────────┘                  ╱     ╲               │                  └───────────────────────┘                 ┃                                                                                                                                                *
*    ┃                                     │                                              ╱       ╲              │                                                            ┃                                                                                                                                                *
*    ┃                                     │    ┌───────────────────────┐                ╱  check  ╲             │                  ┌─────────────────┐                       ┃                                                                                                                                                *
*    ┃                                     ├───▶│ Request Promise Queue │──────┐        ╱  routine  ╲            │   ┌───update ───▶│ page_collection │                       ┃                                                                                                                                                *
*    ┃        ┌───────────────────────┐    │    └───────────────────────┘      │       ╱      ↻      ╲           │   │              └─────────────────┘                       ┃                                                                                                                                                *
*    ┃        │    Fetcher Routine    │────┤                                   ├─────▶▕  promise = 0  ▏──┬─true──┼───┤                                                        ┃                                                                                                                                                *
*    ┃        └───────────────────────┘    │    ┌───────────────────────┐      │       ╲  ready = 0  ╱   │       │   │              ┌─────────────────┐                       ┃                                                                                                                                                *
*    ┃                    ▲                ├───▶│  Request Ready Queue  │──────┘        ╲     ↻     ╱    │       │   └───update────▶│    page_tree    │                       ┃                                                                                                                                                *
*    ┃                    │                │    └───────────────────────┘                ╲   0ms   ╱     │       │                  └─────────────────┘                       ┃                                                                                                                                                *
*    ┃                    │                │                                              ╲       ╱      │       │                                                            ┃                                                                                                                                                *
*    ┃                    │                │    ┌───────────────────────┐                  ╲     ╱       │       │                                                            ┃                                                                                                                                                *
*    ┃                    │                ├───▶│ Request Promise Timer │                   ╲   ╱        │       └──────────────────▶ wait for some minutes ─ ─ ┐             ┃                                                                                                                                                *
*    ┃                    │                │    └───────────────────────┘                    ╲ ╱         │                                                                    ┃                                                                                                                                                *
*    ┃                    │                │                                                  V          │                                                      │             ┃                                                                                                                                                *
*    ┃                    │                │    ┌───────────────────────┐                     ▲          │                                                                    ┃                                                                                                                                                *
*    ┃                    │                └───▶│  Request Ready Timer  │                     └──false───┘                                                      │             ┃                                                                                                                                                *
*    ┃                    │                     └───────────────────────┘                                                                                                     ┃                                                                                                                                                *
*    ┃                    │                                                                                                                                     │             ┃                                                                                                                                                *
*    ┃                    │─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─  create new fetcher routine ◀ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─              ┃                                                                                                                                                *
*    ┃                                                                                                                                                                        ┃                                                                                                                                                *
*    ┗━━━━━━━━━━━━━━━━━━━━╋━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛                                                                                                                                                *
*                                                                                                                                                                                                                                                                                                                              *
*                         │                                                                                                                                                                                                                                                                                                    *
*                                                                                                                                                                                                                                                                                                                              *
*                         │                                                                                                                                                                                                                                                                                                    *
*                                                                                                                                                                                                                                                                                                                              *
*     ┏━━━Fetcher Routine━┻━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓    *
*     ┃                                                                                                                                                                                                  ┌─.plaintext += plaintext────────────────────────────────────────────────────┐                                   ┃    *
*     ┃                                                                                                                                                                                                  │                                                                            │                                   ┃    *
*     ┃                                                                                                                                                                     ╔══════════════════════════╗ │                                      ╔══════════════════════╗              │                                   ┃    *
*     ┃                                                                                                                       ┌──false───┐                                  ║  Promise (resolved)      ║ ├─.children.push()┐                    ║Connector             ║              │                                   ┃    *
*     ┃                                                                                    ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ │          │                                  ║┌───────────────────────┐ ║ │                 │                    ║ ┌──────────────────┐ ║              │                                   ┃    *
*     ┃                                                                                    ┃   Request Promise Queue        ┃ │          │                                  ║│parentToAssign: Entity │◀──┘       ┌──────────────────┐           ║ │toAssigned: itself│ ║              │                                   ┃    *
*     ┃                                                                                    ┃ ╔══════════════════════════╗   ┃ │          Λ                                  ║└───────────────────────┘ ║   ┌────▶│ is Page/Database │──create──▶║ └──────────────────┘ ║──────────────│─────────────────┐                 ┃    *
*     ┃                                                                                    ┃ ║  Promise (pending)       ║   ┃ │         ╱ ╲                                 ║┌───────────────────────┐ ║   │     └──────────────────┘           ║┌────────────────────┐║              │                 │                 ┃    *
*     ┃       ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓                                          ┃ ║ ┌───────────────────────┐║   ┃ │        ╱   ╲                                ║│parentToRequest: Entity│ ║   │                      │             ║│toRequested: itself │║              │                 │                 ┃    *
*     ┃       ┃  New Requests                 ┌──────────────────────────────────────────────╬▶│parentToAssign: Entity │║   ┃ │       ╱     ╲            ┌──────────────┐   ║└───────────────────────┘ ║   │                      │             ║└────────────────────┘║              │                 │                 ┃    *
*     ┃       ┃ ╔═════════════════════════╗   │ ┃ ┌──────────────────────────────────────┐ ┃ ║ └───────────────────────┘║...┃ │      ╱       ╲       ┌──▶│ is Fulfilled │──▶║┌───────────────────────┐ ║   │                      │             ╚══════════════════════╝              │                 │                 ┃    *
*     ┃       ┃ ║┌───────────────────────┐║   │ ┃ │                                      │ ┃ ║ ┌───────────────────────┐║   ┃ │     ╱  set    ╲      │   └──────────────┘   ║│       children:       │ ║   │                      │                                                   │                 │                 ┃    *
*     ┃       ┃ ║│parentToAssign: Entity │╠───┘ ┃ │   ┌─────────────┐    List Block      └─╋─╬▶│parentToRequest: Entity│║   ┃ │    ╱ interval  ╲     │                      ║│   QueryablePromise    │─╬───┤                      │                                         ┌──────────────────┐        │                 ┃    *
*     ┃       ┃ ║└───────────────────────┘║     ┃ ├──▶│is Block/Page│───▶Children()─────┐  ┃ ║ └───────────────────────┘║   ┃ │   ╱      ↻      ╲    │                      ║│       Entity[]        │ ║   │                      │       extractPlainText                  │   Concatenated   │        │                 ┃    *
*     ┃       ┃ ║┌───────────────────────┐║ ... ┃ │   └─────────────┘                   │  ┃ ║ ┌───────────────────────┐║   ┃─┴─▶▕  promise > 0  ▏───┤                      ║└───────────────────────┘ ║   │                      │    ┌─▶   FromBlock    ────▶.reduce()───▶│    Plain Text    │        │                 ┃    *
*     ┃       ┃ ║│parentToRequest: Entity│╠───────┘                                 .push()┃ ║ │       children:       │║   ┃     ╲ isSetteled  ╱    │   ┌──────────────┐   ║┌───────────────────────┐ ║   │                      │    │                                    └──────────────────┘        │                 ┃    *
*     ┃       ┃ ║└───────────────────────┘║     ┃ │   ┌─────────────┐      Query        ┌────╬▶│   QueryablePromise    │║   ┃      ╲     ↻     ╱     └──▶│ is Rejected  │   ║│     retry: number     │ ║   │                      │    │                                                                │                 ┃    *
*     ┃       ┃ ║┌───────────────────────┐║     ┃ └──▶│ is Database │───▶Database()─────┘  ┃ ║ │       Entity[]        │║   ┃       ╲   0ms   ╱          └──────────────┘   ║└───────────────────────┘ ║   │     ┌────────────────│─┐  │                                                                │                 ┃    *
*     ┃       ┃ ║│     retry: number     │║     ┃     └─────────────┘                      ┃ ║ └───────────────────────┘║   ┃        ╲       ╱                    │         ╚══════════════════════════╝   └────▶│     is Block   │ │──┤                     ┌──────────────────┐                       │                 ┃    *
*     ┃       ┃ ║└───────────────────────┘║     ┃                                          ┃ ║ ┌───────────────────────┐║   ┃         ╲     ╱                     │                                              └────────────────│─┘  │                     │  is in Traverse  │                       │                 ┃    *
*     ┃       ┃ ╚═════════════════════════╝     ┃                                          ┃ ║ │     retry: number     │║   ┃          ╲   ╱                      │               set maxConcurrency to 0                         │    │               ┌────▶│  Exclusion List  │           ╔═══════════╬══════════╗      ┃    *
*     ┃       ┗━━━━━━━━━━━━━━▲━━━━━━━━━━━━━━━━━━┛                                          ┃ ║ └───────────────────────┘║   ┃           ╲ ╱                       ▼               empty promise_queue                             │    │               │     └──────────────────┘           ║Connector  │          ║      ┃    *
*     ┃                      │                                                             ┃ ╚══════════════════════════╝   ┃            V                  rate_limited──true──▶ move promises to ready_queue                    │    └─▶.filter()────┤     ┌──────────────────┐           ║ ┌─────────┴────────┐ ║      ┃    *
*     ┃                      │                                                             ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛                                     │               wait for some minutes                           │                    │     │is NOT in Traverse│           ║ │toAssigned: PARENT│ ║      ┃    *
*     ┃                      │                                                                                                                                    │               set maxConcurrency to 3                         │                    └────▶│  Exclusion List  │──create──▶║ └─────────┬────────┘ ║      ┃    *
*     ┃                      │                                                                                      ╔═════════════════════════╗                 false                                                             │                          └──────────────────┘           ║┌──────────┴─────────┐║      ┃    *
*     ┃                      │                                                                                      ║┌───────────────────────┐║                   │                                                               │                                                         ║│toRequested: itself │║      ┃    *
*     ┃            .splice(concurrency -                                                                            ║│parentToAssign: Entity │║                   │                                                               │                                                         ║└──────────┬─────────┘║      ┃    *
*     ┃               promise.length)                                                                               ║└───────────────────────┘║                   ▼                                                               │                                                         ╚═══════════╬══════════╝      ┃    *
*     ┃                      │                                                                                      ║┌───────────────────────┐║               retry <                                                             │                                                                     │                 ┃    *
*     ┃                      │                                                                               ┌──────║│parentToRequest: Entity│║◀───true───── retryCount ──false──▶ console.error                                  │                                                                     │                 ┃    *
*     ┃                      │                                                                               │      ║└───────────────────────┘║                                                                                   │                                                                     │                 ┃    *
*     ┃                      │                                                                               │      ║┌───────────────────────┐║                                                                                   │                                                                     │                 ┃    *
*     ┃                      │                         ┌──false───┐                                          │      ║│      retry: +=1       │║                                                                                   │                                                                     │                 ┃    *
*     ┃                      │                         │          │                                          │      ║└───────────────────────┘║                                                                                   │                                                                     │                 ┃    *
*     ┃                      │                         │          │                                     .unshift()  ╚═════════════════════════╝                                                                                   │                                                                     │                 ┃    *
*     ┃                      │                         Λ          │                                          ▼                                                                                                                    │                                                                     │                 ┃    *
*     ┃                      │                        ╱ ╲         │            ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓                                                                                      │                                                                     │                 ┃    *
*     ┃                      │                       ╱   ╲        │            ┃  Request Ready Queue                                      ┃                                                                                      │                                                                     │                 ┃    *
*     ┃                      │                      ╱     ╲       │            ┃ ╔═════════════════════════╗ ╔═════════════════════════╗   ┃                                                                                      │                                                                     │                 ┃    *
*     ┃                      │                     ╱       ╲      │            ┃ ║┌───────────────────────┐║ ║┌───────────────────────┐║   ┃                                                                                      │                                                                     │                 ┃    *
*     ┃                      │                    ╱  check  ╲     │            ┃ ║│parentToAssign: Entity │║ ║│parentToAssign: Entity │║   ┃                                                                                      │                                                                     │                 ┃    *
*     ┃                      │                   ╱  routine  ╲    │            ┃ ║└───────────────────────┘║ ║└───────────────────────┘║   ┃                                                                                      │                                                                     │                 ┃    *
*     ┃                      │                  ╱      ↻      ╲   │            ┃ ║┌───────────────────────┐║ ║┌───────────────────────┐║...┃                                                                                      │                                                                     │                 ┃    *
*     ┃                      └──────true───────▕  ready > 0    ▏◀─┴────────────┃ ║│parentToRequest: Entity│║ ║│parentToRequest: Entity│║   ┃◀────────────.push()──────────────────────────────────────────────────────────────────│─────────────────────────────────────────────────────────────────────┘                 ┃    *
*     ┃                                         ╲ promise < 3 ╱                ┃ ║└───────────────────────┘║ ║└───────────────────────┘║   ┃                                                                                      │                                                                                       ┃    *
*     ┃                                          ╲           ╱                 ┃ ║┌───────────────────────┐║ ║┌───────────────────────┐║   ┃                                                                                      │                                                                                       ┃    *
*     ┃                                           ╲    ↻    ╱                  ┃ ║│       retry: 0        │║ ║│       retry: 0        │║   ┃                                                                                      │                                                                                       ┃    *
*     ┃                                            ╲ 250ms ╱                   ┃ ║└───────────────────────┘║ ║└───────────────────────┘║   ┃                                                                                      │                                                                                       ┃    *
*     ┃                                             ╲     ╱                    ┃ ╚═════════════════════════╝ ╚═════════════════════════╝   ┃                                                                                      │                                                                                       ┃    *
*     ┃                                              ╲   ╱                     ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛                                                                                      │                                                                                       ┃    *
*     ┃                                               ╲ ╱                                                    ▲                                                                                                                    │                                                                                       ┃    *
*     ┃                                                V                                                     │                    ┏━━━━━━━━━━━━━━━━━━━━━━━━━━┓                                                                    │                                                                                       ┃    *
*     ┃                                                                                                   (init)                  ┃  Page Collection         ┃                                                                    │                                                                                       ┃    *
*     ┃                                                                                                      │                    ┃ ┌────╦═════════════════╗ ┃                                                                    │                                                                                       ┃    *
*     ┃                                                                                                      │                    ┃ │ id ║  page: Entity   ║ ┃                                                                    │                                                                                       ┃    *
*     ┃                                                                                                      │                    ┃ └────╩═════════════════╝ ┃                                                                    │                                                                                       ┃    *
*     ┃                                                                                            ┌──────────────────┐           ┃ ┌────╦═════════════════╗ ┃                                                                    │                                                                                       ┃    *
*     ┃                                                                                            │       ROOT       │───(init)─▶┃ │ id ║  page: Entity   ║ ┃◀────────────assign with key────────────────────────────────────────┘                                                                                       ┃    *
*     ┃                                                                                            └──────────────────┘           ┃ └────╩═════════════════╝ ┃                                                                                                                                                            ┃    *
*     ┃                                                                                                      │                    ┃ ┌────╦═════════════════╗ ┃                                                                                                                                                            ┃    *
*     ┃                                                                                                                           ┃ │ id ║  page: Entity   ║ ┃                                                                                                                                                            ┃    *
*     ┃                                                                                                      │                    ┃ └────╩═════════════════╝ ┃                                                                                                                                                            ┃    *
*     ┃                                                                                                                           ┃           ....           ┃                                                                                                                                                            ┃    *
*     ┃                                                                                                      │                    ┗━━━━━━━━━━━━━━━━━━━━━━━━━━┛                                                                                                                                                            ┃    *
*     ┃                                                                                                                                         │                                                                                                                                                                         ┃    *
*     ┃                                                                                                      └ ─ ─ ─ ─ ─ ─ ─ ┬ ─ ─ ─ ─ ─ ─ ─ ─ ─                                                                                                                                                                          ┃    *
*     ┃                                                                                                                                                                                                                                                                                                                   ┃    *
*     ┃                                                                                                                      │                                                                                                                                                                                            ┃    *
*     ┃                                                                                                          ╔══════════════════════╗                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║ Entity               ║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║┌────────────────────┐║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│     id: string     │║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║└────────────────────┘║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║┌────────────────────┐║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│   depth: number    │║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║└────────────────────┘║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║┌────────────────────┐║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│       type:        │║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│ 'page'|'database'| │║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│      'block'       │║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║└────────────────────┘║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║┌────────────────────┐║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│     metadata:      │║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│GetBlockResponseWith│║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│      Metadata      │║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║└────────────────────┘║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║┌────────────────────┐║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│     plainText:     │║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│extractPlainText(...│║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│     children)      │║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║└────────────────────┘║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║┌────────────────────┐║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║│ children: Entity[] │║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ║└────────────────────┘║                                                                                                                                                                                 ┃    *
*     ┃                                                                                                          ╚══════════════════════╝                                                                                                                                                                                 ┃    *
*     ┃                                                                                                                                                                                                                                                                                                                   ┃    *
*     ┃                                                                                                                                                                                                                                                                                                                   ┃    *
*     ┃                                                                                                                                                                                                                                                                                                                   ┃    *
*     ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛    *
*                                                                                                                                                                                                                                                                                                                              *
*                                                                                                                                                                                                                                                                                                                              *
*                                                                                                                                                                                                                                                                                                                              *
*                                                                                                                                                                                                                                                                                                                              *
\******************************************************************************************************************************************************************************************************************************************************************************************************************************/

notion-page-tree