@bitefoundry/notion 0.2.2 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/docs/NPM.md CHANGED
@@ -1,21 +1,21 @@
1
- # `@bitefoundry/notion` 6-Platform npm Distribution
2
-
3
- `@bitefoundry/notion` distributes prebuilt native Rust binaries via npm `optionalDependencies`, installing the `notion` command with zero Node.js runtime overhead after `postinstall` hardlinking.
4
-
5
- ## Platform Packages
6
-
7
- | Platform Package | Rust Target | Binary |
8
- |---|---|---|
9
- | `@bitefoundry/notion-win32-x64` | `x86_64-pc-windows-msvc` | `bin/notion.exe` |
10
- | `@bitefoundry/notion-win32-arm64` | `aarch64-pc-windows-msvc` | `bin/notion.exe` |
11
- | `@bitefoundry/notion-darwin-x64` | `x86_64-apple-darwin` | `bin/notion` |
12
- | `@bitefoundry/notion-darwin-arm64` | `aarch64-apple-darwin` | `bin/notion` |
13
- | `@bitefoundry/notion-linux-x64` | `x86_64-unknown-linux-gnu.2.28` | `bin/notion` |
14
- | `@bitefoundry/notion-linux-arm64` | `aarch64-unknown-linux-gnu.2.28` | `bin/notion` |
15
-
16
- ## Packaging Scripts
17
-
18
- - `node scripts/sync-version.mjs --check`: verifies `Cargo.toml`, root `package.json`, and all 6 `npm/notion-*/package.json` manifests match version `0.1.0`.
19
- - `node scripts/verify-glibc.mjs --self-test`: verifies the GLIBC <= 2.28 ELF symbol checker used in GitHub Actions Linux releases.
20
- - `node scripts/build-npm.mjs [--target <triple>] [--all]`: stages Cargo release binaries into `npm/notion-*/bin/`.
21
- - `scripts/postinstall.mjs`: links `notion` directly to the native binary on Unix/Windows while guarding against mutating a git development checkout.
1
+ # `@bitefoundry/notion` 6-Platform npm Distribution
2
+
3
+ `@bitefoundry/notion` distributes prebuilt native Rust binaries via npm `optionalDependencies`, installing the `notion` command with zero Node.js runtime overhead after `postinstall` hardlinking.
4
+
5
+ ## Platform Packages
6
+
7
+ | Platform Package | Rust Target | Binary |
8
+ |---|---|---|
9
+ | `@bitefoundry/notion-win32-x64` | `x86_64-pc-windows-msvc` | `bin/notion.exe` |
10
+ | `@bitefoundry/notion-win32-arm64` | `aarch64-pc-windows-msvc` | `bin/notion.exe` |
11
+ | `@bitefoundry/notion-darwin-x64` | `x86_64-apple-darwin` | `bin/notion` |
12
+ | `@bitefoundry/notion-darwin-arm64` | `aarch64-apple-darwin` | `bin/notion` |
13
+ | `@bitefoundry/notion-linux-x64` | `x86_64-unknown-linux-gnu.2.28` | `bin/notion` |
14
+ | `@bitefoundry/notion-linux-arm64` | `aarch64-unknown-linux-gnu.2.28` | `bin/notion` |
15
+
16
+ ## Packaging Scripts
17
+
18
+ - `node scripts/sync-version.mjs --check`: verifies `Cargo.toml`, root `package.json`, and all 6 `npm/notion-*/package.json` manifests match version `0.1.0`.
19
+ - `node scripts/verify-glibc.mjs --self-test`: verifies the GLIBC <= 2.28 ELF symbol checker used in GitHub Actions Linux releases.
20
+ - `node scripts/build-npm.mjs [--target <triple>] [--all]`: stages Cargo release binaries into `npm/notion-*/bin/`.
21
+ - `scripts/postinstall.mjs`: links `notion` directly to the native binary on Unix/Windows while guarding against mutating a git development checkout.
package/docs/openapi.yaml CHANGED
@@ -1,171 +1,185 @@
1
- openapi: 3.1.0
2
- info:
3
- title: "@bitefoundry/notion Local HTTP API"
4
- version: 0.1.0
5
- description: Local HTTP JSON API exposed by `notion serve` (default `127.0.0.1:8791`).
6
- servers:
7
- - url: http://127.0.0.1:8791
8
- paths:
9
- /health:
10
- get:
11
- summary: Health check
12
- responses:
13
- "200":
14
- description: Service status
15
- /api/v1/whoami:
16
- get:
17
- summary: Current authenticated Notion bot/user & active workspace
18
- responses:
19
- "200":
20
- description: User and workspace metadata
21
- /api/v1/workspaces:
22
- get:
23
- summary: List configured Notion workspace profiles
24
- responses:
25
- "200":
26
- description: Workspace profile registry
27
- /api/v1/search:
28
- get:
29
- summary: Search Notion pages and databases (SQLite FTS5 + Korean <3 char LIKE or remote)
30
- parameters:
31
- - name: q
32
- in: query
33
- required: true
34
- schema: { type: string }
35
- - name: remote
36
- in: query
37
- schema: { type: boolean, default: false }
38
- - name: offline
39
- in: query
40
- schema: { type: boolean, default: false }
41
- - name: limit
42
- in: query
43
- schema: { type: integer, default: 50 }
44
- responses:
45
- "200":
46
- description: Search hits
47
- /api/v1/pages:
48
- get:
49
- summary: List workspace pages
50
- responses:
51
- "200":
52
- description: Page list
53
- post:
54
- summary: Create a Notion page
55
- responses:
56
- "200":
57
- description: Created page
58
- /api/v1/pages/{id}:
59
- get:
60
- summary: Get full Notion page detail (metadata, blocks, comments, markdown, media)
61
- parameters:
62
- - name: id
63
- in: path
64
- required: true
65
- schema: { type: string }
66
- responses:
67
- "200":
68
- description: Page detail
69
- patch:
70
- summary: Update page metadata, properties, or archive state
71
- parameters:
72
- - name: id
73
- in: path
74
- required: true
75
- schema: { type: string }
76
- responses:
77
- "200":
78
- description: Updated page
79
- /api/v1/pages/{id}/blocks:
80
- get:
81
- summary: Get recursive children of a page or block
82
- parameters:
83
- - name: id
84
- in: path
85
- required: true
86
- schema: { type: string }
87
- - name: offline
88
- in: query
89
- schema: { type: boolean, default: false }
90
- description: Use locally cached children.
91
- responses:
92
- "200":
93
- description: Block tree, including a verified empty list
94
- "404":
95
- description: Resource not found or children unavailable in the offline cache
96
- post:
97
- summary: Append Markdown or slash-style blocks to a page
98
- parameters:
99
- - name: id
100
- in: path
101
- required: true
102
- schema: { type: string }
103
- responses:
104
- "200":
105
- description: Appended blocks
106
- /api/v1/blocks/{id}:
107
- patch:
108
- summary: Update block text or toggle to_do checkbox
109
- parameters:
110
- - name: id
111
- in: path
112
- required: true
113
- schema: { type: string }
114
- responses:
115
- "200":
116
- description: Updated block
117
- /api/v1/databases:
118
- get:
119
- summary: List Notion databases
120
- responses:
121
- "200":
122
- description: Database list
123
- /api/v1/databases/{id}/query:
124
- post:
125
- summary: Query database rows
126
- parameters:
127
- - name: id
128
- in: path
129
- required: true
130
- schema: { type: string }
131
- responses:
132
- "200":
133
- description: Database rows
134
- /api/v1/databases/{id}/items:
135
- post:
136
- summary: Create a new database item row
137
- parameters:
138
- - name: id
139
- in: path
140
- required: true
141
- schema: { type: string }
142
- responses:
143
- "200":
144
- description: Created item
145
- /api/v1/pages/{id}/comments:
146
- get:
147
- summary: List comments on a page
148
- parameters:
149
- - name: id
150
- in: path
151
- required: true
152
- schema: { type: string }
153
- responses:
154
- "200":
155
- description: Comments list
156
- post:
157
- summary: Add a comment or discussion reply
158
- parameters:
159
- - name: id
160
- in: path
161
- required: true
162
- schema: { type: string }
163
- responses:
164
- "200":
165
- description: Created comment
166
- /api/v1/sync:
167
- post:
168
- summary: Trigger immediate workspace sync into SQLite WAL + FTS5
169
- responses:
170
- "200":
171
- description: Sync summary
1
+ openapi: 3.1.0
2
+ info:
3
+ title: "@bitefoundry/notion Local HTTP API"
4
+ version: 0.1.0
5
+ description: Local HTTP JSON API exposed by `notion serve` (default `127.0.0.1:8791`).
6
+ servers:
7
+ - url: http://127.0.0.1:8791
8
+ paths:
9
+ /health:
10
+ get:
11
+ summary: Health check
12
+ responses:
13
+ "200":
14
+ description: Service status
15
+ /api/v1/whoami:
16
+ get:
17
+ summary: Current authenticated Notion bot/user & active workspace
18
+ responses:
19
+ "200":
20
+ description: User and workspace metadata
21
+ /api/v1/workspaces:
22
+ get:
23
+ summary: List configured Notion workspace profiles
24
+ responses:
25
+ "200":
26
+ description: Workspace profile registry
27
+ /api/v1/search:
28
+ get:
29
+ summary: Search Notion pages and databases (SQLite FTS5 + Korean <3 char LIKE or remote)
30
+ parameters:
31
+ - name: q
32
+ in: query
33
+ required: true
34
+ schema: { type: string }
35
+ - name: remote
36
+ in: query
37
+ schema: { type: boolean, default: false }
38
+ - name: offline
39
+ in: query
40
+ schema: { type: boolean, default: false }
41
+ - name: limit
42
+ in: query
43
+ schema: { type: integer, default: 50 }
44
+ responses:
45
+ "200":
46
+ description: Search hits
47
+ /api/v1/pages:
48
+ get:
49
+ summary: List workspace pages
50
+ responses:
51
+ "200":
52
+ description: Page list
53
+ post:
54
+ summary: Create a Notion page
55
+ responses:
56
+ "200":
57
+ description: Created page
58
+ /api/v1/pages/{id}:
59
+ get:
60
+ summary: Get full Notion page detail (metadata, blocks, comments, markdown, media, incomplete_blocks, comments_has_more)
61
+ parameters:
62
+ - name: id
63
+ in: path
64
+ required: true
65
+ schema: { type: string }
66
+ - name: offline
67
+ in: query
68
+ schema: { type: boolean, default: false }
69
+ description: Read only from the local offline cache.
70
+ responses:
71
+ "200":
72
+ description: Page detail
73
+ "404":
74
+ description: Page not found or page body unavailable in the offline cache
75
+ patch:
76
+ summary: Update page metadata, properties, or archive state
77
+ parameters:
78
+ - name: id
79
+ in: path
80
+ required: true
81
+ schema: { type: string }
82
+ responses:
83
+ "200":
84
+ description: Updated page
85
+ /api/v1/pages/{id}/blocks:
86
+ get:
87
+ summary: Get recursive children of a page or block
88
+ parameters:
89
+ - name: id
90
+ in: path
91
+ required: true
92
+ schema: { type: string }
93
+ - name: offline
94
+ in: query
95
+ schema: { type: boolean, default: false }
96
+ description: Use locally cached children.
97
+ responses:
98
+ "200":
99
+ description: Block tree, including a verified empty list
100
+ "404":
101
+ description: Resource not found or children unavailable in the offline cache
102
+ post:
103
+ summary: Append Markdown or slash-style blocks to a page
104
+ parameters:
105
+ - name: id
106
+ in: path
107
+ required: true
108
+ schema: { type: string }
109
+ responses:
110
+ "200":
111
+ description: Appended blocks
112
+ /api/v1/blocks/{id}:
113
+ patch:
114
+ summary: Update block text or toggle to_do checkbox
115
+ parameters:
116
+ - name: id
117
+ in: path
118
+ required: true
119
+ schema: { type: string }
120
+ responses:
121
+ "200":
122
+ description: Updated block
123
+ /api/v1/databases:
124
+ get:
125
+ summary: List Notion databases
126
+ responses:
127
+ "200":
128
+ description: Database list
129
+ /api/v1/databases/{id}/query:
130
+ post:
131
+ summary: Query database rows
132
+ parameters:
133
+ - name: id
134
+ in: path
135
+ required: true
136
+ schema: { type: string }
137
+ responses:
138
+ "200":
139
+ description: Database rows
140
+ "400":
141
+ description: Invalid offline query (filter or sorts combined with offline=true) or invalid limit
142
+ /api/v1/databases/{id}/items:
143
+ post:
144
+ summary: Create a new database item row
145
+ parameters:
146
+ - name: id
147
+ in: path
148
+ required: true
149
+ schema: { type: string }
150
+ responses:
151
+ "200":
152
+ description: Created item
153
+ /api/v1/pages/{id}/comments:
154
+ get:
155
+ summary: List comments on a page
156
+ parameters:
157
+ - name: id
158
+ in: path
159
+ required: true
160
+ schema: { type: string }
161
+ - name: offline
162
+ in: query
163
+ schema: { type: boolean, default: false }
164
+ description: Read only from the local offline cache.
165
+ responses:
166
+ "200":
167
+ description: Comments list
168
+ "404":
169
+ description: Page not found or comments unavailable in the offline cache
170
+ post:
171
+ summary: Add a comment or discussion reply
172
+ parameters:
173
+ - name: id
174
+ in: path
175
+ required: true
176
+ schema: { type: string }
177
+ responses:
178
+ "200":
179
+ description: Created comment
180
+ /api/v1/sync:
181
+ post:
182
+ summary: Trigger immediate workspace sync into SQLite WAL + FTS5
183
+ responses:
184
+ "200":
185
+ description: Sync summary
package/package.json CHANGED
@@ -1,50 +1,50 @@
1
- {
2
- "name": "@bitefoundry/notion",
3
- "version": "0.2.2",
4
- "description": "Notion terminal client & AI agent toolkit — Pages, Blocks, Databases (Table/Board/List), Comments & Multi-Workspace (CLI, TUI, HTTP API, MCP)",
5
- "repository": {
6
- "type": "git",
7
- "url": "git+https://github.com/BiteFoundry/notion.git"
8
- },
9
- "license": "MIT",
10
- "bin": {
11
- "notion": "bin/notion.js"
12
- },
13
- "files": [
14
- "bin/notion.js",
15
- "scripts/postinstall.mjs",
16
- "docs/NPM.md",
17
- "docs/API.md",
18
- "docs/MCP.md",
19
- "docs/openapi.yaml",
20
- "README.md"
21
- ],
22
- "engines": {
23
- "node": ">=18"
24
- },
25
- "keywords": [
26
- "notion",
27
- "notion-cli",
28
- "notion-tui",
29
- "knowledge-base",
30
- "kanban",
31
- "database",
32
- "markdown",
33
- "cli",
34
- "tui",
35
- "mcp"
36
- ],
37
- "scripts": {
38
- "postinstall": "node scripts/postinstall.mjs",
39
- "sync-version": "node scripts/sync-version.mjs",
40
- "build:npm": "node scripts/build-npm.mjs"
41
- },
42
- "optionalDependencies": {
43
- "@bitefoundry/notion-win32-x64": "0.2.2",
44
- "@bitefoundry/notion-win32-arm64": "0.2.2",
45
- "@bitefoundry/notion-darwin-x64": "0.2.2",
46
- "@bitefoundry/notion-darwin-arm64": "0.2.2",
47
- "@bitefoundry/notion-linux-x64": "0.2.2",
48
- "@bitefoundry/notion-linux-arm64": "0.2.2"
49
- }
50
- }
1
+ {
2
+ "name": "@bitefoundry/notion",
3
+ "version": "0.4.0",
4
+ "description": "Notion terminal client & AI agent toolkit — Pages, Blocks, Databases (Table/Board/List), Comments & Multi-Workspace (CLI, TUI, HTTP API, MCP)",
5
+ "repository": {
6
+ "type": "git",
7
+ "url": "git+https://github.com/BiteFoundry/notion.git"
8
+ },
9
+ "license": "MIT",
10
+ "bin": {
11
+ "notion": "bin/notion.js"
12
+ },
13
+ "files": [
14
+ "bin/notion.js",
15
+ "scripts/postinstall.mjs",
16
+ "docs/NPM.md",
17
+ "docs/API.md",
18
+ "docs/MCP.md",
19
+ "docs/openapi.yaml",
20
+ "README.md"
21
+ ],
22
+ "engines": {
23
+ "node": ">=18"
24
+ },
25
+ "keywords": [
26
+ "notion",
27
+ "notion-cli",
28
+ "notion-tui",
29
+ "knowledge-base",
30
+ "kanban",
31
+ "database",
32
+ "markdown",
33
+ "cli",
34
+ "tui",
35
+ "mcp"
36
+ ],
37
+ "scripts": {
38
+ "postinstall": "node scripts/postinstall.mjs",
39
+ "sync-version": "node scripts/sync-version.mjs",
40
+ "build:npm": "node scripts/build-npm.mjs"
41
+ },
42
+ "optionalDependencies": {
43
+ "@bitefoundry/notion-win32-x64": "0.4.0",
44
+ "@bitefoundry/notion-win32-arm64": "0.4.0",
45
+ "@bitefoundry/notion-darwin-x64": "0.4.0",
46
+ "@bitefoundry/notion-darwin-arm64": "0.4.0",
47
+ "@bitefoundry/notion-linux-x64": "0.4.0",
48
+ "@bitefoundry/notion-linux-arm64": "0.4.0"
49
+ }
50
+ }