Original em inglês: https://argusic.com/subject/notion-sdk-js
notion-sdk-js
Cliente JavaScript oficial do Notion
Executa com mocksfonte: GitHubpágina do projetoTypeScriptMITcommit 51268112018f
TypeScript, licença MIT. O projeto se descreve como: api, api client, javascript, js, notion e typescript.
notion-sdk-js executa, com substitutos para os serviços de que depende. Em uma máquina limpa sem GPU, um agent da Argusic o instalou em 16 minutos e encontrou 1 erro, corrigindo-o sem ajuda, e a sessão inteira foi gravada.
SDK installed, built, and all 5 main test suites pass (135 tests). SDK exports work with a mock Notion API server: users.list and users.retrieve return correctly formatted responses. Webhook signature helpers verify correctly.
O que o agent conseguiu em uma máquina limpa, nas palavras dele. Como isto é medido
Medido pela Argusic em uma máquina nova, todas as vezes. Cada número tem link para as suas evidências. Pontuação Argusic 56 de 100 (a média das pontuações das execuções deste projeto).
Visão geral
Dados do projeto de GitHub, com link no topo desta página, atualizado em . Dados de teste da Argusic (CC BY 4.0); cada número tem link para uma página de execução com o log completo, a gravação e os hashes sha256 deles.
O que foi medido
Da execução que decidiu este veredito. Cada linha é um valor registrado, não uma estimativa.
O que deu errado, nas palavras do agent
As palavras do próprio agent, das piores para as menores, nunca reescritas como conselho.
- Compatibility test (compatibility.test.ts) hangs due to TypeScript compiler API resource constraints in the container
- Tempo de instalação
- 16 minutos
- Da máquina limpa até o fim
- 30 minutos
- Erros encontrados e corrigidos
- 1 encontrado, 1 corrigido sem ajuda humana
- Como o resultado foi comprovado
- npm test exited 0, 5 suites 135 tests passed; node mock-server exercise returned users.list 1 result and users.retrieve user object; webhook sign/verify helpers validated correctly
- Tokens de modelo usados
- 154.060
- Commit exato testado
- 51268112018f
- Imagem do container
- sha256:cdd920bce783
O que não foi medido
A outra metade, para você ver exatamente até onde estas evidências vão. Uma lacuna é mostrada como lacuna e nunca é preenchida.
- Pico de memória da GPU
- esta execução foi em uma máquina com CPU, então não havia GPU para medir
- Comportamento em uma execução longa
- cada tentativa usa as menores configurações documentadas e um orçamento de tempo fixo, então isto mede se ele executa, não como ele se comporta sob carga
- Comportamento com serviços reais
- esta execução foi verificada apenas com serviços substitutos
O fim da gravação
As últimas linhas da sessão de terminal que decidiu este veredito, exatamente como foram gravadas.
2026-09-29T13:57:15.236516Z ERROR codex_core::session: failed to record rollout items: thread 01a0e…
2026-09-29T13:57:15.237305Z ERROR codex_core::session: failed to record rollout items: thread 01a0e…
tokens used
154,060
All findings are in. Let me compile the final report.
**Install & Build**: `npm ci` ran successfully (it auto-triggered `tsc` build via the `prepare` scr…
**Test suite**: 5 test suites — 135 tests — all passed with exit code 0. The `compatibility.test.ts…
**End-to-end verification**:
- SDK exports all documented symbols (`Client`, `APIErrorCode`, `isNotionClientError`, `LogLevel`, …
- Mock server test: `client.users.list({})` returned 1 result (`Test User abc-123`), `client.users.…
- Webhook helpers: `signWebhookPayload` generated a valid HMAC-SHA256 signature; `verifyWebhookSign…
**No unrecoverable errors encountered.**Reproduzir a sessão inteira, cada comando desde a máquina limpa até este ponto.
Como foi testado
Um agent, um container, nenhuma ajuda humana. Ele instala o projeto do jeito que a própria documentação do projeto manda, executa o projeto e corrige o que quebra. Tudo abaixo é registrado como aconteceu: a sessão de terminal, o log e o commit exato. A metodologia completa.
Pontos fortes e limites
Fatos medidos, não opiniões. Como este conteúdo é escrito.
O que deu certo
- Recuperou-se do único erro sem que uma pessoa interviesse, o que indica que as falhas estão documentadas o suficiente para serem resolvidas.
- Licença MIT, segundo a plataforma onde o projeto está hospedado.
- Medido 2 vezes, então o resultado não é um caso isolado.
O que não deu certo, ou não se sabe
- Só chegou a um estado de execução com serviços substitutos, então nada aqui prova que ele funciona com os serviços reais.
- Levou 16 minutos para instalar, mais devagar que a mediana dos 60 projetos comparáveis que a Argusic mediu.
Dos 61 projetos de api que a Argusic instalou e cronometrou, notion-sdk-js foi o 53º mais rápido a chegar a um estado de execução, e 35 de 61 chegaram a esse estado.
Também testados, na mesma área
Cada um destes foi instalado e executado pela Argusic em uma máquina limpa. Nada aparece aqui sem ter sido testado.
Histórico de execuções
| testado por | tentativa | resultado | pontuação | custo USD | quando |
|---|---|---|---|---|---|
| Argusic Runner | 2/3 | Executa com mocks | 92,00 | 0,05 | |
| Argusic Runner | 1/3 | Não executou | 20,00 | 0,02 |
Tópicos (de GitHub)
Incorporar o selo
Markdown para o README do projeto. Ele tem link de volta para esta página; os termos estão na página de termos.
[](https://argusic.com/subject/notion-sdk-js)Perguntas
- notion-sdk-js executa?
- notion-sdk-js executa, com mocks no lugar de serviços externos. A Argusic o instalou e iniciou em uma máquina limpa em 16 minutos, encontrando 1 erro no caminho, e gravou a sessão.
- Como a Argusic testou notion-sdk-js?
- Em uma máquina nova e descartável, com cada comando gravado e o repositório fixado no commit 51268112018f. Há 2 tentativas registradas, e a metodologia completa está na página da metodologia.
- Quanto custou testar notion-sdk-js?
- A execução que produziu este veredito custou US$ 0,05: custo real de computação e de modelo, não um preço de tabela por milhão de tokens. Esse valor está registrado na página da execução.
- Quanto tempo leva para instalar notion-sdk-js?
- 16 minutos na execução que decidiu este veredito, de uma máquina limpa até um estado de execução. É uma tentativa medida, não uma média.
- notion-sdk-js precisa de GPU?
- Não para iniciar. A Argusic chegou a um estado de execução em uma máquina sem GPU.
- O que dá errado ao instalar notion-sdk-js?
- 1 coisa quebrou na execução registrada, e 1 foi corrigida sem ajuda humana. Cada uma, com o tempo que custou, está listada nesta página.
- Como notion-sdk-js se compara às alternativas?
- Dos 61 projetos de api que a Argusic instalou e cronometrou, notion-sdk-js foi o 53º mais rápido a chegar a um estado de execução, e 35 de 61 chegaram a esse estado.
- Onde estão as evidências de notion-sdk-js?
- Todas as 2 execuções registradas estão nesta página, cada uma com link para o seu log completo e a sua gravação do terminal, guardados com uma impressão digital sha256 para que não possam ser alterados discretamente.