Merge branch 'main' into codex/refactor-tsup-to-vite-and-reduce-build-size

Author: seonglae

package.json

@@ -8,7 +8,7 @@
   "engines": {
     "node": ">=22.16.0"
   },
-  "packageManager": "[email protected].0",
+  "packageManager": "[email protected].1",
   "scripts": {
     "prepare": "husky install",
     "link": "turbo link",
@@ -24,10 +24,10 @@
     "pu": "turbo pu -- --access=public --no-git-checks"
   },
   "devDependencies": {
-    "@types/node": "^22.15.29",
-    "@typescript-eslint/eslint-plugin": "^8.33.0",
-    "@typescript-eslint/parser": "^8.33.0",
-    "@vitest/coverage-v8": "^3.1.4",
+    "@types/node": "^22.15.30",
+    "@typescript-eslint/eslint-plugin": "^8.33.1",
+    "@typescript-eslint/parser": "^8.33.1",
+    "@vitest/coverage-v8": "^3.2.2",
     "dotenv": "^16.5.0",
     "eslint": "8.57.1",
     "eslint-config-next": "^15.3.3",
@@ -45,7 +45,7 @@
     "typescript": "^5.8.3",
     "vite": "^6.3.5",
     "vite-plugin-dts": "^3.8.1",
-    "vitest": "^3.1.4"
+    "vitest": "^3.2.2"
   },
   "standard-version": {
     "scripts": {

packages/cli/src/main.ts

@@ -16,3 +16,5 @@ cli.runExit(process.argv.slice(2), Cli.defaultContext)
 
 export * from './notion/export'
 export * from './notion/index'
+export * from './treemap'
+export * from './stats'

packages/cli/src/notion/export.ts

@@ -1,5 +1,7 @@
 import { Option, Command } from 'clipanion'
 import { NotionExporter } from './index'
+import { generateTreemaps, PageNode } from '../treemap'
+import { computeStats, writeStats } from '../stats'
 
 export class NotionExportCommand extends Command {
   static paths = [['export']]
@@ -38,6 +40,12 @@ export class NotionExportCommand extends Command {
   dataset = Option.Boolean('-d, --dataset', {
     description: 'Export as dataset for LLM learning'
   })
+  treemap = Option.Boolean('--treemap', {
+    description: 'Generate HTML treemap after export'
+  })
+  stats = Option.Boolean('--stats', {
+    description: 'Generate statistics JSON after export'
+  })
   token = Option.String('-t,--token', {
     description: 'Notion Access Token'
   })
@@ -59,5 +67,15 @@ export class NotionExportCommand extends Command {
       token: this.token
     })
     await exporter.execute()
+
+    if (this.treemap || this.stats) if (!exporter.pageTree) await exporter.loadRaw()
+
+    const tree = exporter.pageTree as unknown as PageNode
+    if (this.treemap && tree) await generateTreemaps(this.folder, tree)
+
+    if (this.stats && tree) {
+      const stats = computeStats(tree)
+      await writeStats(`${this.folder}/stats.json`, stats)
+    }
   }
 }

packages/cli/src/stats.ts

@@ -0,0 +1,28 @@
+import type { PageNode } from './treemap'
+
+export interface ExportStats {
+  totalPages: number
+  totalBlocks: number
+  maxDepth: number
+}
+
+export function computeStats(pageTree: PageNode): ExportStats {
+  let totalPages = 0
+  let totalBlocks = 0
+  let maxDepth = 0
+
+  function traverse(node: PageNode, depth: number) {
+    totalPages += node.pages || 0
+    totalBlocks += node.blocks || 0
+    if (depth > maxDepth) maxDepth = depth
+    if (node.children) for (const child of node.children) traverse(child, depth + 1)
+  }
+
+  traverse(pageTree, 1)
+  return { totalPages, totalBlocks, maxDepth }
+}
+
+export async function writeStats(file: string, stats: ExportStats) {
+  const fs = await import('fs/promises')
+  await fs.writeFile(file, JSON.stringify(stats, null, 2), 'utf8')
+}

packages/cli/src/treemap.ts

@@ -1,33 +1,26 @@
 import fs from 'fs'
 import { promisify } from 'util'
-import { loadRaw } from './notion'
 
-const writeFile = promisify(fs.writeFile)
-
-interface PageNode {
+export interface PageNode {
   id: string
   blocks: number
   pages: number
   title: string
   children?: PageNode[]
 }
 
-async function main() {
-  const { pageTree } = await loadRaw('texonom-raw')
+const writeFile = promisify(fs.writeFile)
 
-  // Generate treemap for page counts
+export async function generateTreemaps(folder: string, pageTree: PageNode) {
   const treemapDataPages = computeMetrics(pageTree, 'pages')
   const titlePages = 'Texonom PageTree'
-  const outputPathPages = 'texonom-raw/pagetree.html'
+  const outputPathPages = `${folder}/pagetree.html`
   await generateTreemapHTML(treemapDataPages, titlePages, outputPathPages)
 
-  // Generate treemap for block counts
   const treemapDataBlocks = computeMetrics(pageTree, 'blocks')
   const titleBlocks = 'Texonom BlockMap'
-  const outputPathBlocks = 'texonom-raw/blocktree.html'
+  const outputPathBlocks = `${folder}/blocktree.html`
   await generateTreemapHTML(treemapDataBlocks, titleBlocks, outputPathBlocks)
-
-  console.info('Treemap HTML files generated successfully.')
 }
 
 interface TreemapNode {
@@ -353,5 +346,3 @@ async function generateTreemapHTML(data: TreemapNode, title: string, outputPath:
 
   await writeFile(outputPath, htmlContent, 'utf8')
 }
-
-main().catch(error => console.error(error))

packages/nclient/readme.md

@@ -29,6 +29,19 @@ const collectionViewId = 'ab639a5a-853e-45e1-9ef7-133b486c0acf'
 const collectionData = await api.getCollectionData(collectionId, collectionViewId)
 ```
 
+### Fetch backlinks
+
+Backlinks require an auth token.
+
+```ts
+const backlinks = await api.getBacklinks({
+  block: { id: 'page-id', spaceId: 'space-id' }
+})
+
+// or simply pass the page id
+const pageBacklinks = await api.getPageBacklinks('page-id')
+```
+
 ### Fetch a database's content
 
 You can pass a database ID to the `getPage` method. The response is an object which contains several important properties:

packages/nclient/src/notion-api.test.ts

@@ -59,6 +59,12 @@ test(`Backlink`, { timeout: 10000, concurrent: true }, async () => {
   expect(backlinks.backlinks.length > 0)
 })
 
+test(`Page Backlink`, { timeout: 10000, concurrent: true }, async () => {
+  const api = new NotionAPI({ authToken: process.env.NOTION_TOKEN })
+  const backlinks = await api.getPageBacklinks('441d5ce2-b781-46d0-9354-54042b4f06d9')
+  expect(backlinks.backlinks.length > 0)
+})
+
 test(`Get block`, { timeout: 10000, concurrent: true }, async () => {
   const id = '3f9e0d86-c643-4672-aa0c-78d63fa80598'
   const api = new NotionAPI()

packages/nclient/src/notion-api.ts

@@ -574,6 +574,23 @@ export class NotionAPI {
     })
   }
 
+  /**
+   * Fetch backlinks for a page by automatically resolving its space id.
+   * Requires an authToken since backlinks are a private API.
+   *
+   * @param pageId page id or url
+   * @param fetchOption additional fetch options
+   */
+  public async getPageBacklinks(pageId: string, fetchOption?: FetchOption) {
+    const id = parsePageId(pageId)
+    const res = await this.getBlocks([id], fetchOption)
+    const block = res.recordMap.block[id]?.value
+    if (!block) throw new Error(`Block not found "${uuidToId(id)}"`)
+    const spaceId = block.space_id
+
+    return this.getBacklinks({ block: { id, spaceId } }, fetchOption)
+  }
+
   public async fetch<T>({
     endpoint,
     body,

packages/nreact/package.json

@@ -40,7 +40,7 @@
   },
   "devDependencies": {
     "@types/lodash.throttle": "^4.1.9",
-    "@types/node": "^22.15.29",
+    "@types/node": "^22.15.30",
     "@types/react": "^19.1.6",
     "clipboard-copy": "^4.0.1",
     "date-fns": "^2.30.0",

packages/nreact/src/components/search-dialog.tsx

@@ -1,6 +1,4 @@
 import React from 'react'
-
-import throttle from 'lodash.throttle'
 import { getBlockParentPage, getBlockTitle } from '@texonom/nutils'
 
 import { NotionContextConsumer, NotionContextProvider } from '../context'
@@ -12,6 +10,15 @@ import { PageTitle } from './page-title'
 import type { SearchParams, SearchResults, APIError } from '@texonom/ntypes'
 // TODO: modal.default.setAppElement('.notion-viewport')
 
+// simple debounce utility so we only search after the user stops typing
+const debounce = (func: (...args: any[]) => void, wait: number) => {
+  let timeout: ReturnType<typeof setTimeout> | undefined
+  return (...args: any[]) => {
+    if (timeout) clearTimeout(timeout)
+    timeout = setTimeout(() => func(...args), wait)
+  }
+}
+
 export class SearchDialog extends React.Component<{
   isOpen: boolean
   rootBlockId: string
@@ -34,7 +41,8 @@ export class SearchDialog extends React.Component<{
   _search: any
 
   componentDidMount() {
-    this._search = throttle(this._searchImpl.bind(this), 1000)
+    // debounce search calls so the expensive query only runs after typing stops
+    this._search = debounce(this._searchImpl.bind(this), 500)
     this._warmupSearch()
   }
 
@@ -66,7 +74,7 @@ export class SearchDialog extends React.Component<{
                     placeholder='Search'
                     value={query}
                     ref={this._inputRef}
-                    onChange={this._onChangeQuery}
+                    onInput={this._onChangeQuery}
                   />
 
                   {query && (