{"_id":"@bigfootai/noded-sdk","_rev":"2-a85b5854140497d50184b01845f801b4","name":"@bigfootai/noded-sdk","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@bigfootai/noded-sdk","version":"0.1.0","keywords":["noded","customer-context","graphql","crm","customer-success","sdk"],"license":"MIT","_id":"@bigfootai/noded-sdk@0.1.0","maintainers":[{"name":"eric-noded","email":"eric@getnotify.ai"},{"name":"gowildly","email":"steve@getnotify.ai"},{"name":"jonjomckay","email":"jonjo@jonjomckay.com"}],"homepage":"https://github.com/Notify-AI/noded-sdk#readme","bugs":{"url":"https://github.com/Notify-AI/noded-sdk/issues"},"dist":{"shasum":"b21f843595e51df8b9306d0120ab62a27349509b","tarball":"https://registry.npmjs.org/@bigfootai/noded-sdk/-/noded-sdk-0.1.0.tgz","fileCount":6,"integrity":"sha512-E2sJ4me7K2WBfYcywUMRoUV/KJD1MF7JWTSVC4tju//b3wGvMMwapduwBYgllpMgACTYNAoLH0PRq1fEcBtobw==","signatures":[{"sig":"MEQCIHIDprEtK6An4AKjVhIhEEuIjyWR+CelA4QmCYxxrZkQAiBM/0J3U1yWpiJwGHop+y5GwWpFgPr1Ef5GqAdD6DkO1g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25634},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"1f8908003055650b25f0c1b0b004dbcc3693774d","scripts":{"build":"tsup src/index.ts --format esm --dts --clean","release":"npm version patch && npm publish && git push --follow-tags","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"gowildly","email":"steve@getnotify.ai"},"repository":{"url":"git+https://github.com/Notify-AI/noded-sdk.git","type":"git"},"_npmVersion":"11.12.1","description":"Bring your Noded customer context into any front-end app. A vibe-code-friendly SDK over the Noded (Apollo) GraphQL API.","directories":{},"sideEffects":false,"_nodeVersion":"25.9.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","typescript":"^5.7.0","oidc-client-ts":"^3.0.0"},"peerDependencies":{"oidc-client-ts":"^3.0.0"},"peerDependenciesMeta":{"oidc-client-ts":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/noded-sdk_0.1.0_1783054311824_0.371025071969745","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@bigfootai/noded-sdk","version":"0.1.2","description":"Bring your Noded customer context into any front-end app. A vibe-code-friendly SDK over the Noded (Apollo) GraphQL API.","type":"module","main":"./dist/index.js","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"sideEffects":false,"engines":{"node":">=18"},"publishConfig":{"access":"public"},"scripts":{"build":"tsup src/index.ts --format esm --dts --clean","typecheck":"tsc --noEmit","prepublishOnly":"npm run build","release":"npm version patch && npm publish && git push --follow-tags"},"keywords":["noded","customer-context","graphql","crm","customer-success","sdk"],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/Notify-AI/noded-sdk.git"},"homepage":"https://github.com/Notify-AI/noded-sdk#readme","bugs":{"url":"https://github.com/Notify-AI/noded-sdk/issues"},"peerDependencies":{"oidc-client-ts":"^3.0.0"},"peerDependenciesMeta":{"oidc-client-ts":{"optional":true}},"devDependencies":{"oidc-client-ts":"^3.0.0","tsup":"^8.0.0","typescript":"^5.7.0"},"gitHead":"ed90587389ce93bdc5e839c7715e005e4fc18722","_id":"@bigfootai/noded-sdk@0.1.2","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-BnliiUqxeUeOiky2yJnhQgAcTRcHXhUMgNLdjQZaoVncM7tnY7JoceW0XRPdIILcAqgOmc+udPNt+giMlaaFLw==","shasum":"d9c17bff28bb205361d4c3f02319d98fabd72375","tarball":"https://registry.npmjs.org/@bigfootai/noded-sdk/-/noded-sdk-0.1.2.tgz","fileCount":6,"unpackedSize":25643,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCjssGVQ+rL7eMtB3mRBj/Ee0861+0bGsjpkrwviqksjgIgMbAN4qLvqxg5UNJHJF1gcB5uH1pd5odvnYdAWb/O9VA="}]},"_npmUser":{"name":"gowildly","email":"steve@getnotify.ai"},"directories":{},"maintainers":[{"name":"eric-noded","email":"eric@getnotify.ai"},{"name":"gowildly","email":"steve@getnotify.ai"},{"name":"jonjomckay","email":"jonjo@jonjomckay.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/noded-sdk_0.1.2_1783098547703_0.38882162450796987"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-03T04:51:51.652Z","modified":"2026-07-03T17:09:08.016Z","0.1.0":"2026-07-03T04:51:51.972Z","0.1.2":"2026-07-03T17:09:07.858Z"},"bugs":{"url":"https://github.com/Notify-AI/noded-sdk/issues"},"license":"MIT","homepage":"https://github.com/Notify-AI/noded-sdk#readme","keywords":["noded","customer-context","graphql","crm","customer-success","sdk"],"repository":{"type":"git","url":"git+https://github.com/Notify-AI/noded-sdk.git"},"description":"Bring your Noded customer context into any front-end app. A vibe-code-friendly SDK over the Noded (Apollo) GraphQL API.","maintainers":[{"name":"eric-noded","email":"eric@getnotify.ai"},{"name":"gowildly","email":"steve@getnotify.ai"},{"name":"jonjomckay","email":"jonjo@jonjomckay.com"}],"readme":"# @bigfootai/noded-sdk\n\nBring your **Noded customer context** — people, accounts, activity, notes, memory — into any\nfront-end app. Built for vibe coding: one-line auth, typed helpers, and an `AGENTS.md` your coding\nagent can read so \"add a Noded account panel\" just works.\n\n```bash\nnpm i @bigfootai/noded-sdk oidc-client-ts\n```\n\n## Get access\n\nRequest your **Noded developer credentials** — an **auth domain (issuer)**, a **client ID**, and an\n**API audience** — from the Noded team (getnoded.ai/contact-us or your Noded account team). Tell us\nyour app's origin(s) and we provision access as needed; you don't set up any auth infrastructure\nyourself. Then paste those three values into the client below.\n\n## Quickstart (browser, 5 minutes)\n\nYour users sign in with their Noded account — **no secret keys in your app.**\n\n```ts\nimport { Noded } from '@bigfootai/noded-sdk';\n\nconst noded = new Noded({\n  auth: {\n    mode: 'oidc',\n    issuer: NODED_ISSUER,       // provided by Noded when you request access\n    clientId: NODED_CLIENT_ID,  // provided by Noded — your app's SPA client\n    audience: NODED_AUDIENCE,   // provided by Noded — the Noded API audience\n  },\n});\n\n// Opens the Noded login, then silently refreshes the token from then on.\nawait noded.connect();\n\n// Now read your customer context:\nconst [acme] = await noded.accounts.search('Acme');\nconst timeline = await noded.activity.forTag(acme.id, { limit: 20 });\nconst people = await noded.people.search('acme.com');\nconst memory = await noded.memory.forTag(acme.id);\n\nconsole.log(acme.name, timeline, people, memory);\n```\n\n## What you can do\n\n| Call | Returns |\n|---|---|\n| `noded.people.search(q)` / `.get(id)` | People (contacts) |\n| `noded.accounts.search(q)` / `.get(id)` | Accounts / accounts |\n| `noded.activity.forTag(id)` | Unified timeline — notes, emails, tasks, messages, meetings |\n| `noded.notes.create({ title })` / `.list()` | Create / list notes |\n| `noded.memory.forTag(id)` / `.all()` | What the graph remembers |\n| `noded.search(q)` | People + accounts in one call |\n| `noded.graphql(query, vars)` | Escape hatch — any Noded GraphQL operation |\n\n## Auth options\n\n- **`mode: 'oidc'`** *(browser, recommended)* — no secret in the browser; the signed-in user's\n  permissions apply automatically.\n- **`mode: 'token'`** — you already have an access token (e.g. from your own OIDC flow); pass a\n  `getToken()`.\n- **`mode: 'apiKey'`** *(server only)* — `{ apiKey, actAs }`. **Never** ship an `apiKey` to a browser.\n\n### Embedding where your viewers aren't Noded users\n\nRun a tiny server proxy that holds the token and forwards to the Noded API; point the SDK at it with\n`endpoint`. See [`examples/`](./examples). (A first-class Personal Access Token flow is on the roadmap.)\n\n## Escape hatch\n\nThe helpers cover the common cases. For anything else, drop to GraphQL:\n\n```ts\nconst data = await noded.graphql(`query { recentTags { _id alias } }`);\n```\n\nThe full schema is the Noded Apollo API at `POST /api/v1/graph`.\n\n## Vibe coding\n\nCopy [`AGENTS.md`](./AGENTS.md) into your project (or `.cursorrules` / `CLAUDE.md`). It teaches your\ncoding agent the SDK, the auth model, and the data shapes so it writes correct code the first time.\n","readmeFilename":"README.md"}