{"id":16442929,"url":"https://github.com/mayneyao/notabase","last_synced_at":"2026-03-10T00:31:36.428Z","repository":{"id":35058126,"uuid":"201481656","full_name":"mayneyao/notabase","owner":"mayneyao","description":"API wrapper for Notion's database [WIP]","archived":false,"fork":false,"pushed_at":"2023-01-04T22:04:34.000Z","size":601,"stargazers_count":125,"open_issues_count":20,"forks_count":11,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-10-06T02:25:25.429Z","etag":null,"topics":["api","api-wrapper","notion","notion-database"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mayneyao.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-08-09T14:20:18.000Z","updated_at":"2025-08-19T14:33:40.000Z","dependencies_parsed_at":"2023-01-15T13:01:20.086Z","dependency_job_id":null,"html_url":"https://github.com/mayneyao/notabase","commit_stats":null,"previous_names":["mayneyao/natabase"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mayneyao/notabase","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayneyao%2Fnotabase","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayneyao%2Fnotabase/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayneyao%2Fnotabase/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayneyao%2Fnotabase/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mayneyao","download_url":"https://codeload.github.com/mayneyao/notabase/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mayneyao%2Fnotabase/sbom","scorecard":{"id":630423,"data":{"date":"2025-08-11","repo":{"name":"github.com/mayneyao/notabase","commit":"7ec55d902eead50212b2dc88e80b4a5f0d4b73c2"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.2,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/18 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/npmpublish.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npmpublish.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/mayneyao/notabase/npmpublish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npmpublish.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/mayneyao/notabase/npmpublish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npmpublish.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/mayneyao/notabase/npmpublish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/npmpublish.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/mayneyao/notabase/npmpublish.yml/master?enable=pin","Info:   0 out of   4 GitHub-owned GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 13 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"60 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-4w2v-q235-vp99","Warn: Project is vulnerable to: GHSA-cph5-m8f7-6c5x","Warn: Project is vulnerable to: GHSA-wf5p-g6vw-rhxx","Warn: Project is vulnerable to: GHSA-jr5f-v2jv-69x6","Warn: Project is vulnerable to: GHSA-74fj-2j2h-c42q","Warn: Project is vulnerable to: GHSA-pw2r-vq6v-hr8c","Warn: Project is vulnerable to: GHSA-jchw-25xp-jwwc","Warn: Project is vulnerable to: GHSA-cxjh-pqwp-8mfp","Warn: Project is vulnerable to: GHSA-w7rc-rwvf-8q5r","Warn: Project is vulnerable to: GHSA-r683-j2x4-v87g","Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8","Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92","Warn: Project is vulnerable to: GHSA-6chw-6frg-f759","Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw","Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c","Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-8r6j-v8pm-fqw3","Warn: Project is vulnerable to: MAL-2023-462","Warn: Project is vulnerable to: GHSA-62gr-4qp9-h98f","Warn: Project is vulnerable to: GHSA-f52g-6jhx-586p","Warn: Project is vulnerable to: GHSA-2cf5-4w76-r9qv","Warn: Project is vulnerable to: GHSA-3cqr-58rm-57f8","Warn: Project is vulnerable to: GHSA-g9r4-xpmj-mj65","Warn: Project is vulnerable to: GHSA-q2c6-c6pm-g3gh","Warn: Project is vulnerable to: GHSA-765h-qjxv-5f44","Warn: Project is vulnerable to: GHSA-f2jv-r9rf-7988","Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj","Warn: Project is vulnerable to: GHSA-qqgx-2p2h-9c37","Warn: Project is vulnerable to: GHSA-896r-f27r-55mw","Warn: Project is vulnerable to: GHSA-9c47-m6qq-7p4h","Warn: Project is vulnerable to: GHSA-6c8f-qphg-qjgp","Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw","Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9","Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-5fw9-fq32-wv5p","Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9","Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-3jfq-g458-7qm9","Warn: Project is vulnerable to: GHSA-r628-mhmh-qjhw","Warn: Project is vulnerable to: GHSA-9r2w-394v-53qc","Warn: Project is vulnerable to: GHSA-5955-9wpr-37jh","Warn: Project is vulnerable to: GHSA-qq89-hq3f-393p","Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36","Warn: Project is vulnerable to: GHSA-jgrx-mgxx-jf9v","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3","Warn: Project is vulnerable to: GHSA-6fc8-4gx4-v693","Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q","Warn: Project is vulnerable to: GHSA-c4w7-xm78-47vh","Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-21T07:46:13.560Z","repository_id":35058126,"created_at":"2025-08-21T07:46:13.560Z","updated_at":"2025-08-21T07:46:13.560Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30318396,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T20:05:46.299Z","status":"ssl_error","status_checked_at":"2026-03-09T19:57:04.425Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-wrapper","notion","notion-database"],"created_at":"2024-10-11T09:19:00.885Z","updated_at":"2026-03-10T00:31:36.388Z","avatar_url":"https://github.com/mayneyao.png","language":"TypeScript","readme":"⚠️ Notion API 变动、不建议使用此项目。等官方 API 开放\n\n⚠️ DO NOT use this\n\n# Notabase (WIP)\nAPI Wrapper For Notion's Database\n\n## Getting Started\n\n### Installing\n\n```\nyarn add notabase\n```\n\n### Use\n\nYou can use notabse in browser, browser extension, and node. But there is a difference when initializing the notabase instance.\n\n#### Node\n\n| Env  | Token | Read | Write | Note|\n| ------------- | ------------- | ------------- | ------------- | ------------- |\n| node  | ❌  | public data | ❌ | you can only read public data without token|\n| node  | ✔  | private data | ✔ | you can read and modify private data with token |\n\n```js\nimport Notabase from 'notabase'\n\n// node env\n// just Read public data\nlet nb = new Notabase()\n// CRUD support\nlet nb = new Notabase({\n  token: \"token_v2 from cookies\"\n})\n\n```\n\n#### Browser\n\nIf you want to use Notabase in your web pages, you need to handle CORS. You can solve this problem with a cloudflare worker.Generate a cloudflare-worker using the code from [`src/cf-worker.js`](src/cf-worker.js)\n\nIn the browser environment, we don't use `token` directly, instead we use `authcode` to handle identity checks. You need to set an `authcode` that only you know in your `cf-worker` , and then we use it when initializing the notabase instance.\n\n| Env  | authCode | Read | Write | Note\n| ------------- | ------------- | ------------- | ------------- | ------------- |\n| browser  | ❌  | public data | ❌ | just read public data without `authCode`|\n| browser  | ✔  | private data | ✔ | you can read and modify private data with `authCode` |\n\n\n```js\nimport Notabase from 'notabase'\n\n// browser env\n// without authCode Read public data\n// with authCode CRUD support\nlet nb = new Notabase({\n  proxy: {\n    url: \"cloudflare worker url\",\n    authCode: \"nobody knows it but you\"\n  }\n})\n\n```\n\n#### Browser Extension\n\n```js\nimport Notabase from 'notabase'\n\n// browser extension env\n// CRUD support without setting anything\nlet nb = new Notabase()\n\n```\n\n[withCredentials](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest/withCredentials)\n\n\n#### Fetch Data\n\n| Method  |  Note|\n| ------------- | ------------- |\n| fetch  | fetch data from one table, but you can't query relation data|\n| fetchAll  | fetch data from multiple tables, you can query relation data if relation table has been fetched|\n\n``` js\n\n// fetch one table\nlet songs = await nb.fetch(\"https://www.notion.so/2628769120ad41d998ec068d6e2eb410?v=e8e69ac68a8d483792c54541e4d8ba72\")\n\n\n// fetch all tables about music\n// get my music data\nlet db = await nb.fetchAll({\n  songs: \"https://www.notion.so/2628769120ad41d998ec068d6e2eb410?v=e8e69ac68a8d483792c54541e4d8ba72\",\n  albums: \"https://www.notion.so/15f1759f38a34fedaa79262812b707f0?v=b385656739214101b2b8a159092a52e8\",\n  artists: \"https://www.notion.so/31b8544ffb034964b1aa56bfa78497c1?v=1d9cbfcd279d4534964acdd374c9824e\"\n})\n\n```\n\n#### Query \n\nData in Notion table will be mapped to JavaScript Array\n\n``` js\n// get all songs\nlet allSongs = db.songs.rows\n \n// get song by index\nlet song = allSongs[0]\n\n// get one song's title (base props)\nconsole.log(`${song.tile}`)\n\n// get artist's name of the song (related props)\nconsole.log(`${song.artist[0].Name}`) // a song maybe has two or more artists\n\n// search song by title in song's table\nlet aSong = allSongs.find(song=\u003e song.title === \"Bad Guy\")\n// search all song by artist's name in song's table\nlet songByArtistName = allSongs.filter(song=\u003e song.artist[0].name === \"someone\")\n// search all song by artist's name in artist's table\nsongByArtistName = db.artists.rows.filter(a=\u003e a.name === \"someone\").songs\n\n```\n#### Write\n\n```js\nlet aSong = allSongs.find(song=\u003e song.title === \"Bad Guy\")\naSong.title = \"new title\"\n```\n\n#### Create\n\n```js\n// create then modify\nlet newRow = collection.addRow()\n// if tag1 is not exists, it will be auto created. \nnewRow.Tags = [\"tag1\"]\n\n\n// create with value\ncollection.addRow({title:\"\",Tags:[\"tag1\"]}) \n\n```\n\n#### Delete\n```js\n// delete row \naSong.delete()\n```\n\n\n#### Update Table Schema\n```js\n// change\ncollection.schema.Tags.options.push({\n  id:nb.genId(),\n  value: \"new tag\",\n  color: \"pink\"\n})\n\n// commit\ncollection.updateSchema()\n```\n\n## Todos\n\n### collection\n+ [x] collection.addRow({title:\"\",Tags:[\"tag1\"]}) // add new row\n+ [x] updateSchema // update schema\n\n### row\n+ [x] row.delete()  // delete a row\n\n### all\n+ [ ] Rewrite in TypeScript\n","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmayneyao%2Fnotabase","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmayneyao%2Fnotabase","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmayneyao%2Fnotabase/lists"}