{"_id":"@carbon-suite/graphene-sdk","_rev":"6-0c492a6a8da8db4d4660c6452ca03b9f","name":"@carbon-suite/graphene-sdk","dist-tags":{"rc":"0.4.2-rc.0","latest":"0.6.0"},"versions":{"0.4.1-rc.1":{"name":"@carbon-suite/graphene-sdk","version":"0.4.1-rc.1","keywords":[],"author":"","license":"ISC","_id":"@carbon-suite/graphene-sdk@0.4.1-rc.1","maintainers":[{"name":"vavaste","email":"stefano.vavassori1997@gmail.com"},{"name":"basah","email":"thommybasa@gmail.com"}],"dist":{"shasum":"a1677f96da92eaa6739fb2caae342dbc438a3a2d","tarball":"https://registry.npmjs.org/@carbon-suite/graphene-sdk/-/graphene-sdk-0.4.1-rc.1.tgz","fileCount":102,"integrity":"sha512-o89BLtl4QvnAdqy2DV78zK0kzlWSf6JrO6cZN+XrxoUfOz4Xb4pds7b1CO3lsrtRgcKyDzQTeV4V2AR+908nPw==","signatures":[{"sig":"MEUCIQDlH6+y1XDnljQT5GpA/VYjIae6kqlmeoyGTZmE6Gts9QIgQz4wT2Q6PcvZfJNL6Gouf2Gq240hNIt7Y7nppdX0m5s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":72238},"main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","clean":"rimraf dist","smoke:dev":"node scripts/smoke-dev.mjs"},"_npmUser":{"name":"vavaste","email":"stefano.vavassori1997@gmail.com"},"repository":{"url":"https://github.com/CodeStormLab/graphene-sdk.git","type":"git"},"description":"Agnostic SDK for Carbon RAG","directories":{},"_nodeVersion":"22.23.1","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.1.3","typescript":"^5.9.3","@changesets/cli":"^2.30.0"},"_npmOperationalInternal":{"tmp":"tmp/graphene-sdk_0.4.1-rc.1_1784901099316_0.9604482667823371","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@carbon-suite/graphene-sdk","version":"0.4.1","keywords":[],"author":"","license":"ISC","_id":"@carbon-suite/graphene-sdk@0.4.1","maintainers":[{"name":"vavaste","email":"stefano.vavassori1997@gmail.com"},{"name":"basah","email":"thommybasa@gmail.com"}],"dist":{"shasum":"a86ad3cbba2fde6c941e4baf30f60087b8aa213d","tarball":"https://registry.npmjs.org/@carbon-suite/graphene-sdk/-/graphene-sdk-0.4.1.tgz","fileCount":102,"integrity":"sha512-I1ee+dOxswRKGAMfZZu8bq62eqJnMMktnC2+fuG9w3vQ8W3Myhce0Rgc5zQTf0Cd7xL0gisPsnymAtAjJaiqIQ==","signatures":[{"sig":"MEYCIQCH9HHw5FuaYYo1MCVZkr4hQ8ZIo2N9wJt+UAuNs3kfJgIhAIOrZPKhwsWvDRhs4XOgQKJNlO4XSivZBBnzpfdjja4V","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":72233},"main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","clean":"rimraf dist","smoke:dev":"node scripts/smoke-dev.mjs"},"_npmUser":{"name":"vavaste","email":"stefano.vavassori1997@gmail.com"},"repository":{"url":"https://github.com/CodeStormLab/graphene-sdk.git","type":"git"},"description":"Agnostic SDK for Carbon RAG","directories":{},"_nodeVersion":"22.23.1","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.1.3","typescript":"^5.9.3","@changesets/cli":"^2.30.0"},"_npmOperationalInternal":{"tmp":"tmp/graphene-sdk_0.4.1_1784901379220_0.21120962658808562","host":"s3://npm-registry-packages-npm-production"}},"0.4.2-rc.0":{"name":"@carbon-suite/graphene-sdk","version":"0.4.2-rc.0","keywords":[],"author":"","license":"ISC","_id":"@carbon-suite/graphene-sdk@0.4.2-rc.0","maintainers":[{"name":"vavaste","email":"stefano.vavassori1997@gmail.com"},{"name":"basah","email":"thommybasa@gmail.com"}],"homepage":"https://github.com/CodeStormLab/graphene-sdk#readme","bugs":{"url":"https://github.com/CodeStormLab/graphene-sdk/issues"},"dist":{"shasum":"6932a125ac1cc4b920633f626cfe0e3ac72e54cf","tarball":"https://registry.npmjs.org/@carbon-suite/graphene-sdk/-/graphene-sdk-0.4.2-rc.0.tgz","fileCount":102,"integrity":"sha512-3f6wyq9t8s6PZi278BGiRc430FYAOCHDzAqt1IwY3xdsCagz+u0kaYH/K9ByxN2xb7RNPUGdOt2dJeGxNJHAaw==","signatures":[{"sig":"MEUCIQCnop2KwFxyQrrZHES94B/C7UeMiZS+zzJ9Qcl+ozO0FAIgKUuy1jOKmA4egiqyQKbP9ohoz05FcTSbsywqyOgJy6I=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":72673},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"497ba7a155a4c631e4a13b168094da6f3ea824b9","scripts":{"build":"tsc","clean":"rimraf dist","smoke:dev":"node scripts/smoke-dev.mjs","prepublishOnly":"pnpm run clean && pnpm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d30557e5-9866-43c2-a035-b251dd936285"}},"repository":{"url":"git+https://github.com/CodeStormLab/graphene-sdk.git","type":"git"},"_npmVersion":"11.16.0","description":"Agnostic SDK for Carbon RAG","directories":{},"_nodeVersion":"24.18.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.1.3","readmeFilename":"README.md","devDependencies":{"rimraf":"^6.1.3","typescript":"^5.9.3","@changesets/cli":"^2.30.0"},"_npmOperationalInternal":{"tmp":"tmp/graphene-sdk_0.4.2-rc.0_1784903709063_0.8283184752938082","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"name":"@carbon-suite/graphene-sdk","version":"0.4.2","keywords":[],"author":"","license":"ISC","_id":"@carbon-suite/graphene-sdk@0.4.2","maintainers":[{"name":"vavaste","email":"stefano.vavassori1997@gmail.com"},{"name":"basah","email":"thommybasa@gmail.com"}],"homepage":"https://github.com/CodeStormLab/graphene-sdk#readme","bugs":{"url":"https://github.com/CodeStormLab/graphene-sdk/issues"},"dist":{"shasum":"4c60ce07c5c9f15dcf4a1d4bbf19061a62babee1","tarball":"https://registry.npmjs.org/@carbon-suite/graphene-sdk/-/graphene-sdk-0.4.2.tgz","fileCount":102,"integrity":"sha512-zvsUWXbXYDSr8MaA20OG7idxKOjOiTX9h1MdnmSQ3mnZvgRVE0BNtQnoh7Vwr0dp1y4nkxaLE2MAMPj5H0lINQ==","signatures":[{"sig":"MEYCIQCKl0UbQLqCPxzBeIxdT91wYGdIo0xaZF8RB1SBxjHAfAIhAIl8fpWMIuLGn+nwA0vtj33WeMX3U/qVnmO8j0EGaWIr","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":72668},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"ac894083a6c2ffdf1ceb09ed7735eba0ddcb63bf","scripts":{"build":"tsc","clean":"rimraf dist","smoke:dev":"node scripts/smoke-dev.mjs","prepublishOnly":"pnpm run clean && pnpm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:d30557e5-9866-43c2-a035-b251dd936285"}},"repository":{"url":"git+https://github.com/CodeStormLab/graphene-sdk.git","type":"git"},"_npmVersion":"11.16.0","description":"Agnostic SDK for Carbon RAG","directories":{},"_nodeVersion":"24.18.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.1.3","devDependencies":{"rimraf":"^6.1.3","typescript":"^5.9.3","@changesets/cli":"^2.30.0"},"_npmOperationalInternal":{"tmp":"tmp/graphene-sdk_0.4.2_1784903881091_0.6106323937871516","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@carbon-suite/graphene-sdk","version":"0.5.0","keywords":[],"author":"","license":"ISC","_id":"@carbon-suite/graphene-sdk@0.5.0","maintainers":[{"name":"vavaste","email":"stefano.vavassori1997@gmail.com"},{"name":"basah","email":"thommybasa@gmail.com"}],"homepage":"https://github.com/codestorm-skunkworks/graphene-sdk#readme","bugs":{"url":"https://github.com/codestorm-skunkworks/graphene-sdk/issues"},"dist":{"shasum":"3560bc80d2f543cc94855425f5de7af9cc19f705","tarball":"https://registry.npmjs.org/@carbon-suite/graphene-sdk/-/graphene-sdk-0.5.0.tgz","fileCount":114,"integrity":"sha512-PgMt76wnpCB0JOqXcxqocX8b4sFVj956f1QOk6GVZJoQE+HlFmqSBDL/KTfVP2I5j3F8xMFC9HIw4yhofRykyg==","signatures":[{"sig":"MEYCIQDIVlNcfUEBbXyaSvqqsRfUN3hkybKYsRsOsyTMcvoRBgIhAOInxtm1vgHZNCqH8zP6xyIqeYX+2kwpNbXJcdbugdhY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCn6VtR7qtcQ0vGAbsoBFkDXhocc+CrmEwdij/rDZ1F6AIhAObOOyWQNEfLVekpNTHGM99JwP+zKFrsZxWHrmRZPXRX","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":82401},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"61d96e18ad537fa82a459e337a1a960e7e6880b3","scripts":{"build":"tsc","clean":"rimraf dist","prepare":"husky","smoke:dev":"node scripts/smoke-dev.mjs","prepublishOnly":"pnpm run clean && pnpm run build","check:changeset":"node scripts/check-changeset.mjs"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"01a3b538-679a-447a-bfd9-046dc3358eeb"}},"repository":{"url":"git+https://github.com/codestorm-skunkworks/graphene-sdk.git","type":"git"},"_npmVersion":"11.19.0","description":"Agnostic SDK for Carbon RAG","directories":{},"_nodeVersion":"24.21.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.1.3","devDependencies":{"husky":"^9.1.7","rimraf":"^6.1.3","typescript":"^5.9.3","@changesets/cli":"^2.30.0"},"_npmOperationalInternal":{"tmp":"tmp/graphene-sdk_0.5.0_1790808372553_0.8181469688845326","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"_id":"@carbon-suite/graphene-sdk@0.6.0","bugs":{"url":"https://github.com/codestorm-skunkworks/graphene-sdk/issues"},"dist":{"shasum":"168fd93e627d120f083c2f90aea79ed4be26a55f","tarball":"https://registry.npmjs.org/@carbon-suite/graphene-sdk/-/graphene-sdk-0.6.0.tgz","fileCount":114,"integrity":"sha512-m9Wfh7lvIoUHjACO2MS7wZktO5ZZ+EByAM1YMEn7aEFlQYEP1q0PJhmik8L3Ycz7aj6ikMSsqv9LqFXEDmtYnQ==","signatures":[{"sig":"MEQCIH3LkPVURl+qUGYHM3yr03/afPFAvdDQYV7QNbjRlz3rAiBgvQjg8nNxjRdxAbgffbjCyoG7oyPFQ+CQCMy0jSaOpw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDvIFsforFVp7HIBesrpzEPccaBsPGOZzBwADg++SfSrQIhAJBdNmlmQZdJuaFWQ55haLFWaVYHKFxp02EUi5gL+eeV"}],"unpackedSize":85764},"main":"dist/index.js","name":"@carbon-suite/graphene-sdk","types":"dist/index.d.ts","author":"","gitHead":"a1d55206b2e9f6eae2698cfcd948a6f69ddebb52","license":"ISC","scripts":{"build":"tsc","clean":"rimraf dist","prepare":"husky","smoke:dev":"node scripts/smoke-dev.mjs","prepublishOnly":"pnpm run clean && pnpm run build","check:changeset":"node scripts/check-changeset.mjs"},"version":"0.6.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"01a3b538-679a-447a-bfd9-046dc3358eeb"}},"homepage":"https://github.com/codestorm-skunkworks/graphene-sdk#readme","keywords":[],"repository":{"url":"git+https://github.com/codestorm-skunkworks/graphene-sdk.git","type":"git"},"_npmVersion":"11.19.0","description":"Agnostic SDK for Carbon RAG","directories":{},"maintainers":[{"name":"vavaste","email":"stefano.vavassori1997@gmail.com"},{"name":"basah","email":"thommybasa@gmail.com"}],"_nodeVersion":"24.21.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.1.3","devDependencies":{"husky":"^9.1.7","rimraf":"^6.1.3","typescript":"^5.9.3","@changesets/cli":"^2.30.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/graphene-sdk_0.6.0_1790840064974_0.5689547130426096"}}},"time":{"created":"2026-07-24T13:51:39.147Z","modified":"2026-10-01T07:34:25.267Z","0.4.1-rc.1":"2026-07-24T13:51:39.468Z","0.4.1":"2026-07-24T13:56:19.358Z","0.4.2-rc.0":"2026-07-24T14:35:09.211Z","0.4.2":"2026-07-24T14:38:01.229Z","0.5.0":"2026-09-30T22:46:12.649Z","0.6.0":"2026-10-01T07:34:25.061Z"},"bugs":{"url":"https://github.com/codestorm-skunkworks/graphene-sdk/issues"},"license":"ISC","homepage":"https://github.com/codestorm-skunkworks/graphene-sdk#readme","keywords":[],"repository":{"url":"git+https://github.com/codestorm-skunkworks/graphene-sdk.git","type":"git"},"description":"Agnostic SDK for Carbon RAG","maintainers":[{"name":"vavaste","email":"stefano.vavassori1997@gmail.com"},{"name":"basah","email":"thommybasa@gmail.com"}],"readme":"# @carbon-suite/graphene-sdk\n\nTypeScript SDK for the Carbon RAG / Graphene backend.\n\n## Install\n\nAfter the first public npm release, install directly from npm:\n\n```bash\npnpm add @carbon-suite/graphene-sdk\n```\n\nNo GitHub Packages configuration or GitHub credentials are required for consumers.\n\nTo install the current release candidate while developing against `develop`:\n\n```bash\npnpm add @carbon-suite/graphene-sdk@rc\n```\n\n## Usage\n\n```ts\nimport { CarbonClient } from \"@carbon-suite/graphene-sdk\";\n\nconst client = new CarbonClient({\n  baseUrl: \"http://localhost:8080\",\n  enableRefreshToken: true,\n});\n\nawait client.auth.login({ email: \"user@example.com\", password: \"password123\" });\nconst user = await client.users.getMe();\nconst conversations = await client.conversations.list();\n\nconst acceptedDocument = await client.documents.createFromRaw({\n  name: \"Notes\",\n  content: \"Text to index\",\n  folderId: \"existing-folder-id\",\n});\nawait client.documents.getStatus(acceptedDocument.id);\n```\n\n## Implemented SDK Surface\n\n- `CarbonClient`\n- `ApiError`\n- `auth.login`\n- `auth.refresh`\n- `users.getMe`\n- `users.updateMe`\n- `documents.*`\n- `search.search`\n- `conversations.*`\n- `folders.*`\n- `admin.*`\n\nBackend registration is admin-only. Use `admin.registerUser`.\n\nThe destructive backend nuke endpoint is intentionally not exposed by the SDK; use Swagger/admin tooling directly when needed.\n\n## Missing SDK Surface\n\nBackend demo endpoints `/chat` and `/messageList` are intentionally not represented as SDK product APIs.\nThe backend `/hello` demo endpoint is also intentionally not represented.\n\n## Development\n\nThis package is managed with pnpm.\n\n```bash\npnpm install\npnpm run build\n```\n\nManual smoke test against a running backend, after building:\n\n```bash\nCARBON_API_URL=https://your-api.example.com CARBON_EMAIL=user@example.com CARBON_PASSWORD=secret pnpm run smoke:dev\n```\n\nThe smoke script avoids destructive admin calls and existing document deletion.\n\n## Versioning and Releases\n\nThis package uses Changesets. Every PR that changes the published surface should include a changeset:\n\n```bash\npnpm changeset\n```\n\nPublishing is automated by the single `release.yml` GitHub Actions workflow,\nusing npm trusted publishing (OIDC); no npm token is stored in GitHub:\n\n- Push/merge to `develop` cuts a release candidate using Changesets pre mode: incrementing versions `X.Y.Z-rc.0`, `-rc.1`, ... published to public npm under the `rc` dist-tag, with a bot commit on `develop` recording the bump (and `.changeset/pre.json` state). Nothing is published when there are no new changesets. Install RCs with `pnpm add @carbon-suite/graphene-sdk@rc`.\n- Push/merge to `main` exits pre mode and consumes the pending changesets: the workflow bumps to the stable version, updates `CHANGELOG.md`, and commits back to `main`. The `npm-production` environment then pauses for manual approval immediately before public npm publication (`latest` dist-tag). After approval and publication, it creates a git tag plus GitHub Release and back-merges `main` into `develop` so the consumed changesets and the new version propagate and the next RC cycle starts clean.\n\nNo manual `pnpm publish` is needed. Create the `npm-production` GitHub\nenvironment and configure its required reviewer(s), otherwise the approval gate\nwill not block publishing. Note: the `github-actions` bot pushes to both\n`develop` (RC bumps, back-merge) and `main` (release commit); if those branches\nhave protection rules, the bot needs a bypass rule or the pipeline will be\nrejected.\n\n## Local and pull request checks\n\n`pnpm install` enables Husky hooks locally. Every commit runs the TypeScript\nbuild. Every push also verifies the build and requires an active Changeset when\nthe SDK source, TypeScript configuration, or published package metadata changes.\nThe same Changeset check and build run in the `SDK quality` workflow for pull\nrequests targeting `develop` or `main`, so the rule cannot be bypassed with\n`--no-verify`.\n","readmeFilename":"README.md"}