{"_id":"@build-it-now/binctl-api","_rev":"9-6b1da1b3b7ab92f1db6d958469cd3dc9","name":"@build-it-now/binctl-api","dist-tags":{"latest":"0.1.7"},"versions":{"0.0.1":{"name":"@build-it-now/binctl-api","version":"0.0.1","keywords":["oidc","trusted-publishing","setup"],"_id":"@build-it-now/binctl-api@0.0.1","maintainers":[{"name":"ricsam","email":"oss@ricsam.dev"}],"dist":{"shasum":"a557044da23f9b0449ee0815bda951bfe336f992","tarball":"https://registry.npmjs.org/@build-it-now/binctl-api/-/binctl-api-0.0.1.tgz","fileCount":2,"integrity":"sha512-m0uUscrFod3fvEVzdPIrRdWvEaohFy5sLCiAUAyeecJtBcbeBVGA7BZNfT2RonT1Rne9J9zKpbhxv7g+sKZaaw==","signatures":[{"sig":"MEYCIQDauDWL21BMMpT9K5QZLW7PPAUAN9WsEe4+1wbwo0teWAIhAKNSm+E02IHrOVyzVWn4zSMF5dODF9Oz4VUUOpheAkSI","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2059},"_npmUser":{"name":"ricsam","email":"oss@ricsam.dev"},"_npmVersion":"11.6.2","description":"OIDC trusted publishing setup package for @build-it-now/binctl-api","directories":{},"_nodeVersion":"24.12.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/binctl-api_0.0.1_1773333908162_0.1546090132694291","host":"s3://npm-registry-packages-npm-production"}},"0.1.0":{"name":"@build-it-now/binctl-api","version":"0.1.0","_id":"@build-it-now/binctl-api@0.1.0","maintainers":[{"name":"ricsam","email":"oss@ricsam.dev"}],"dist":{"shasum":"03c38cf30739bf17f669a1175296eec3635dac6e","tarball":"https://registry.npmjs.org/@build-it-now/binctl-api/-/binctl-api-0.1.0.tgz","fileCount":5,"integrity":"sha512-F6CPD6nV6TSutKKzAD0hkIRp4qmvZMFBAcNIaxIvLCVaN2qQWZbZTeywT31qRVvt7cLjdTUubtdQa+0iZGFzdw==","signatures":[{"sig":"MEYCIQDZiKf7pNJ7gVI/FYfgtDR+8gbIoW6fHVXZ+0Wty7FRYgIhAN8oEnRfxJHnSKHOpt3hdHNi1CXcE1Taj5mmXn3KCZhV","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19819},"main":"./dist/cjs/index.cjs","type":"module","types":"./dist/types/index.d.ts","module":"./dist/esm/index.js","engines":{"node":">=18"},"exports":{".":{"types":"./dist/types/index.d.ts","import":"./dist/esm/index.js","require":"./dist/cjs/index.cjs"}},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f10686f8-375f-44c3-833b-374994c95fb1"}},"_npmVersion":"11.9.0","description":"Typed Node.js API client for the `binctl` backend surface on build-it-now.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/binctl-api_0.1.0_1773335955543_0.1500460583489489","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@build-it-now/binctl-api","version":"0.1.1","_id":"@build-it-now/binctl-api@0.1.1","maintainers":[{"name":"ricsam","email":"oss@ricsam.dev"}],"dist":{"shasum":"9d880768d11f59390d68d58f9345346854ad17c9","tarball":"https://registry.npmjs.org/@build-it-now/binctl-api/-/binctl-api-0.1.1.tgz","fileCount":5,"integrity":"sha512-NCnLhHnSotNya1cy2cUyGWX/Pci/UGI7K3weFszR54Rcv+/aoF5q0vk45RZujZU3W7pKv1h4h8XMZ6Dq3rLx2Q==","signatures":[{"sig":"MEUCIQCCNFNo/GCxpVx7lJ18+WcQjgWwdD03DjKBrtH71NQRyQIgFSFG3Cl/2wAsbz/M0cATrHbHYdWGhegcezu2wJ8ttDE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19819},"main":"./dist/cjs/index.cjs","type":"module","types":"./dist/types/index.d.ts","module":"./dist/esm/index.js","engines":{"node":">=18"},"exports":{".":{"types":"./dist/types/index.d.ts","import":"./dist/esm/index.js","require":"./dist/cjs/index.cjs"}},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f10686f8-375f-44c3-833b-374994c95fb1"}},"_npmVersion":"11.9.0","description":"Typed Node.js API client for the `binctl` backend surface on build-it-now.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/binctl-api_0.1.1_1773355321844_0.5710217554887673","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@build-it-now/binctl-api","version":"0.1.2","_id":"@build-it-now/binctl-api@0.1.2","maintainers":[{"name":"ricsam","email":"oss@ricsam.dev"}],"dist":{"shasum":"76b713cdbb1bd5aace90581ee8f46337b6dd6108","tarball":"https://registry.npmjs.org/@build-it-now/binctl-api/-/binctl-api-0.1.2.tgz","fileCount":7,"integrity":"sha512-+xCSVK4XjfgIY85e6JsRptzPEhgiiyNpU6/7/cOltodSjsnUneNHxyhVolAZjrOdi6bU/DzvadLxi5O9Ls4u6A==","signatures":[{"sig":"MEUCIFovzi8NO6YwZw+WFKqZgf0gdxkc5+qTPisRqQ4jR3bTAiEA1Pve9TWu0iYmOKUbDW9Ui2YfsMjDPSSBqEBoTBCxeGg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":19989},"main":"./dist/cjs/index.cjs","type":"module","types":"./dist/types/index.d.ts","module":"./dist/mjs/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/types/index.d.ts","import":"./dist/mjs/index.mjs","require":"./dist/cjs/index.cjs"}},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f10686f8-375f-44c3-833b-374994c95fb1"}},"_npmVersion":"11.9.0","description":"Typed Node.js API client for the `binctl` backend surface on build-it-now.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/binctl-api_0.1.2_1773355540681_0.7780489808295554","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@build-it-now/binctl-api","version":"0.1.3","_id":"@build-it-now/binctl-api@0.1.3","maintainers":[{"name":"ricsam","email":"oss@ricsam.dev"}],"dist":{"shasum":"65907fbc323ba8391aa5c1ccdd775dc999d842f2","tarball":"https://registry.npmjs.org/@build-it-now/binctl-api/-/binctl-api-0.1.3.tgz","fileCount":7,"integrity":"sha512-fSWZmfqnmfJxNL2nGlJBViQEaN7QN3VKehPf9vFTAA3zhqMJJpak65iP394VqUVsrpjRq9uWt5Q3/noy22fI0A==","signatures":[{"sig":"MEUCIQCd9HqpQIhOHkMtQuF6gTpvBQbPbus+Jaz24/1OXcAa9gIgW5SDn3BYLYXAJiyCvc1x1yhLLRHXhd2+6sOPCiyRJK0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23805},"main":"./dist/cjs/index.cjs","type":"module","types":"./dist/types/index.d.ts","module":"./dist/mjs/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/types/index.d.ts","import":"./dist/mjs/index.mjs","require":"./dist/cjs/index.cjs"}},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f10686f8-375f-44c3-833b-374994c95fb1"}},"_npmVersion":"11.9.0","description":"Typed Node.js API client for the `binctl` backend surface on build-it-now.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/binctl-api_0.1.3_1773400398051_0.9389010914907918","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@build-it-now/binctl-api","version":"0.1.4","_id":"@build-it-now/binctl-api@0.1.4","maintainers":[{"name":"ricsam","email":"oss@ricsam.dev"}],"dist":{"shasum":"c22aa754de62a0f88a518d169f0ca4c2de4936d4","tarball":"https://registry.npmjs.org/@build-it-now/binctl-api/-/binctl-api-0.1.4.tgz","fileCount":7,"integrity":"sha512-1Q+ZV+A6xaRZyBlNk2b6UPBav8y6h1A8EzKc08/Cu3xXmNyysCwkEsY+ZSjC+jLhJlft9e+QeFZA0y1Kucr5hA==","signatures":[{"sig":"MEQCIHMlyWwzyrlFeOmjfwAAvRVlNW/aSdsn/Xt4Y0kpzzi0AiB1E1e0MCuwPFfQS4pIjCBomHEB52F3M9sODV0qrcvImA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23805},"main":"./dist/cjs/index.cjs","type":"module","types":"./dist/types/index.d.ts","module":"./dist/mjs/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/types/index.d.ts","import":"./dist/mjs/index.mjs","require":"./dist/cjs/index.cjs"}},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f10686f8-375f-44c3-833b-374994c95fb1"}},"_npmVersion":"11.9.0","description":"Typed Node.js API client for the `binctl` backend surface on build-it-now.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/binctl-api_0.1.4_1773406374653_0.22200981815853793","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@build-it-now/binctl-api","version":"0.1.5","_id":"@build-it-now/binctl-api@0.1.5","maintainers":[{"name":"ricsam","email":"oss@ricsam.dev"}],"dist":{"shasum":"689f1967ccf2648ec8f1cb38e892cd0587797587","tarball":"https://registry.npmjs.org/@build-it-now/binctl-api/-/binctl-api-0.1.5.tgz","fileCount":7,"integrity":"sha512-ICxcVjr//7qjYz+4BWYfRY0G2B1kf3LEQm6aX5cTvnvclZ9S95h/VM8oLGrxgoQuTK+JvooEzz3GHyQk/VNybw==","signatures":[{"sig":"MEUCIQD8BtTNM/vFMBXH6SyxjttqYF/Amg5aWCp/dHx7YvtmgQIgCHQHHcyr1vPUCCiN08+ah1Utvg9J+BkNp0dWCBFT2V8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23849},"main":"./dist/cjs/index.cjs","type":"module","types":"./dist/types/index.d.ts","module":"./dist/mjs/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/types/index.d.ts","import":"./dist/mjs/index.mjs","require":"./dist/cjs/index.cjs"}},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f10686f8-375f-44c3-833b-374994c95fb1"}},"_npmVersion":"11.9.0","description":"Typed Node.js API client for the `binctl` backend surface on build-it-now.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/binctl-api_0.1.5_1773408354862_0.6222526205762602","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@build-it-now/binctl-api","version":"0.1.6","_id":"@build-it-now/binctl-api@0.1.6","maintainers":[{"name":"ricsam","email":"oss@ricsam.dev"}],"dist":{"shasum":"bcc28369463a9cd43c3d662ec4b5d6d4e8491931","tarball":"https://registry.npmjs.org/@build-it-now/binctl-api/-/binctl-api-0.1.6.tgz","fileCount":7,"integrity":"sha512-Xc9GJ3ifjy0A3QIcySY4kBkQMstD9OejIS8g2FZU3U1eFJ+cwnoo5hidgw+cxYFUnJT56pnBaBH1tWv+U0GZEw==","signatures":[{"sig":"MEYCIQDcGiu0Qa0oG3AzfD4MnTKKbdAGb+uQHnwxZOwOXvoJxwIhAJ12un4b6GFEmCPoGD1324LrDExZl4L5kz0rscvy3RH4","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23849},"main":"./dist/cjs/index.cjs","type":"module","types":"./dist/types/index.d.ts","module":"./dist/mjs/index.mjs","engines":{"node":">=18"},"exports":{".":{"types":"./dist/types/index.d.ts","import":"./dist/mjs/index.mjs","require":"./dist/cjs/index.cjs"}},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f10686f8-375f-44c3-833b-374994c95fb1"}},"_npmVersion":"11.9.0","description":"Typed Node.js API client for the `binctl` backend surface on build-it-now.","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/binctl-api_0.1.6_1773412330994_0.9681256109206209","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@build-it-now/binctl-api","version":"0.1.7","type":"module","main":"./dist/cjs/index.cjs","module":"./dist/mjs/index.mjs","types":"./dist/types/index.d.ts","exports":{".":{"types":"./dist/types/index.d.ts","import":"./dist/mjs/index.mjs","require":"./dist/cjs/index.cjs"}},"publishConfig":{"access":"public"},"engines":{"node":">=18"},"sideEffects":false,"_id":"@build-it-now/binctl-api@0.1.7","description":"Typed Node.js API client for the `binctl` backend surface on build-it-now.","_nodeVersion":"24.14.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-gkQcMO3BM318sAXNh7fWXiMSvn5tNUnzMJQq0VDjwC5nD6681lBGeeTAHLp3YISAl6KekHThK7Pp3pGpa0D3ZA==","shasum":"7d7d4eddea96d9422cbc21ed610fe69546191fc4","tarball":"https://registry.npmjs.org/@build-it-now/binctl-api/-/binctl-api-0.1.7.tgz","fileCount":7,"unpackedSize":24725,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCESZnXTEr1HQSsEgVo1i5+1MtYBdaZVVKV9scf0o/NnQIgBJVhoOSI1RXHpcXWZmdbRcqLMD5k8OcQOyAfY9yyGCE="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:f10686f8-375f-44c3-833b-374994c95fb1"}},"directories":{},"maintainers":[{"name":"ricsam","email":"oss@ricsam.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/binctl-api_0.1.7_1778245697706_0.6704875092688583"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-12T16:45:08.048Z","modified":"2026-05-08T13:08:17.949Z","0.0.1":"2026-03-12T16:45:08.289Z","0.1.0":"2026-03-12T17:19:15.685Z","0.1.1":"2026-03-12T22:42:01.984Z","0.1.2":"2026-03-12T22:45:40.835Z","0.1.3":"2026-03-13T11:13:18.201Z","0.1.4":"2026-03-13T12:52:54.770Z","0.1.5":"2026-03-13T13:25:55.001Z","0.1.6":"2026-03-13T14:32:11.132Z","0.1.7":"2026-05-08T13:08:17.836Z"},"description":"Typed Node.js API client for the `binctl` backend surface on build-it-now.","maintainers":[{"name":"ricsam","email":"oss@ricsam.dev"}],"readme":"# @build-it-now/binctl-api\n\nTyped Node.js API client for the `binctl` backend surface on build-it-now.\n\n## Installation\n\n```bash\nnpm install @build-it-now/binctl-api\n```\n\n## Usage\n\n```ts\nimport { BinctlClient } from \"@build-it-now/binctl-api\";\n\nconst client = new BinctlClient({\n  baseUrl: \"https://build-it.now\",\n  token: process.env.BINCTL_TOKEN,\n  // or apiKey: process.env.BINCTL_API_KEY\n});\n\nconst projects = await client.projects.list();\nconsole.log(projects);\n```\n\n## Auth\n\n`BinctlClient` supports:\n- interactive token (`bin_tok_*`)\n- API key (`bin_key_*`)\n\nSet either `token` or `apiKey` in client options, or later via:\n- `client.setToken(...)`\n- `client.setApiKey(...)`\n\nTrusted server-side callers that authenticate through custom headers, such as a session cookie, can pass `headers` with `authMode: \"headers\"`.\n\n## Main API Surface\n\n- `auth.loginStart()`\n- `auth.loginPoll(requestId, { pollCode })`\n- `auth.status()`\n- `auth.logout()`\n- `auth.apiKeys.create/list/revoke`\n- `projects.list()`\n- `projects.create({ name?, orgId? })`\n- `projects.describe(projectRef)`\n- `projects.update(projectRef, { name?, mode?, customDomain? })`\n- `projects.delete(projectRef)`\n- `projects.branches.list/describe(projectRef, ...)`\n- `projects.sessions.list(projectRef, { branch? })`\n- `projects.sessions.create(projectRef, { branchName, name? })`\n- `projects.orchestrate.start(projectRef, { branch, model })`\n- `sessions.describe(sessionId)`\n- `sessions.update(sessionId, { name })`\n- `sessions.delete(sessionId)`\n- `sessions.conversation(sessionId)`\n- `sessions.prompt(sessionId, { message, mode, model })`\n- `sessions.answerQuestions(sessionId, { answers })`\n- `sessions.applyRequiredEnvs(sessionId, { envs })`\n\n## Errors\n\nNon-2xx responses throw `BinctlApiError` with:\n- `status`\n- `path`\n- `body`\n\nProject responses expose `mode: \"greenfield\" | \"prod\"`, derived from the database-backed `projects.backwardsCompatible` flag.\n","readmeFilename":"README.md"}