{"_id":"@americancloud/sdk","_rev":"8-d17e6fe4e6feee4ff39421097d705b4d","name":"@americancloud/sdk","dist-tags":{"next":"1.2.2-rc.2","latest":"1.4.0"},"versions":{"1.2.2-rc.1":{"name":"@americancloud/sdk","version":"1.2.2-rc.1","keywords":["americancloud","american-cloud","sdk","api","cloud","client"],"license":"Apache-2.0","_id":"@americancloud/sdk@1.2.2-rc.1","maintainers":[{"name":"americancloud-dev","email":"dev@americancloud.com"},{"name":"americancloud-ben","email":"ben@americancloud.com"}],"homepage":"https://americancloud.com","bugs":{"url":"https://github.com/American-Cloud/americancloud-sdk-typescript/issues"},"dist":{"shasum":"0db02d3c6764ea018255bc589562e3fdd9acc5ca","tarball":"https://registry.npmjs.org/@americancloud/sdk/-/sdk-1.2.2-rc.1.tgz","fileCount":12,"integrity":"sha512-HGV8gd6TVPOUiqBTZzateyZI48YYW02vpBDYb1KgQlTifvw9PFbfAPSZSetU6ejXVIG01oFjJb3ohwtubva8xQ==","signatures":[{"sig":"MEYCIQCfgmnZHnJE6g8bdIrTjodIKJhJ/ANA7PG/OfwtwZ5FhgIhALXCyg4l5yC9k9JjvfNFw5JF3PEtzvbTRgOoLCeXtyX1","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4581454},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"d46ea5d6af3fac2b7e0d77cb0882b22fa696330d","scripts":{"build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"americancloud-dev","email":"dev@americancloud.com"},"repository":{"url":"git+https://github.com/American-Cloud/americancloud-sdk-typescript.git","type":"git"},"_npmVersion":"10.9.4","description":"Official TypeScript & JavaScript SDK for the American Cloud Platform API.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"8.5.1","typescript":"5.9.3","@types/node":"22.19.17"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.2.2-rc.1_1780418706606_0.2767373769383741","host":"s3://npm-registry-packages-npm-production"}},"1.2.2-rc.2":{"name":"@americancloud/sdk","version":"1.2.2-rc.2","keywords":["americancloud","american-cloud","sdk","api","cloud","client"],"license":"Apache-2.0","_id":"@americancloud/sdk@1.2.2-rc.2","maintainers":[{"name":"americancloud-dev","email":"dev@americancloud.com"},{"name":"americancloud-ben","email":"ben@americancloud.com"}],"homepage":"https://americancloud.com","bugs":{"url":"https://github.com/American-Cloud/americancloud-sdk-typescript/issues"},"dist":{"shasum":"d2f3f0efd6b145207c058d940a7a9c55dbedc653","tarball":"https://registry.npmjs.org/@americancloud/sdk/-/sdk-1.2.2-rc.2.tgz","fileCount":12,"integrity":"sha512-13pyEG0H8o81c0aiV1xkv+ft4OkU1tY2Zx/sity1yGMi5sJ3mmSPwPTd7MiiUwo4I+Z5RIrtoui8OMrITHI4XA==","signatures":[{"sig":"MEQCIBQBgxPjNeT81tpH2acC731MEhEoBPYWZh9eA6cFCONpAiAxp3G4DgrF7t425FPWpWkYdkrvlIVVQVIZW8Ygth921w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":4581484},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"fa49e91c41e835e12a1233a15bc77907a33848c4","scripts":{"build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:53b7f97f-d6e4-4538-b04f-e64110fd24b3"}},"repository":{"url":"git+https://github.com/American-Cloud/americancloud-sdk-typescript.git","type":"git"},"_npmVersion":"11.16.0","description":"Official TypeScript & JavaScript SDK for the American Cloud Platform API.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"tsup":"8.5.1","typescript":"5.9.3","@types/node":"22.19.17"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.2.2-rc.2_1780419599107_0.230336189951726","host":"s3://npm-registry-packages-npm-production"}},"1.2.2":{"name":"@americancloud/sdk","version":"1.2.2","keywords":["americancloud","american-cloud","sdk","api","cloud","client"],"license":"Apache-2.0","_id":"@americancloud/sdk@1.2.2","maintainers":[{"name":"americancloud-dev","email":"dev@americancloud.com"},{"name":"americancloud-ben","email":"ben@americancloud.com"}],"homepage":"https://americancloud.com","bugs":{"url":"https://github.com/American-Cloud/americancloud-sdk-typescript/issues"},"dist":{"shasum":"dbb8f04f44bdf03d50b862231d706c3001f4af09","tarball":"https://registry.npmjs.org/@americancloud/sdk/-/sdk-1.2.2.tgz","fileCount":12,"integrity":"sha512-yjHTigxfBXsm1khPCl6KnwiMlIZjyDWBVvzIBetae/EmlPd6ZsMQk5LWKy2q6llXMmLhYIVdMW/tonk7H4skTw==","signatures":[{"sig":"MEYCIQDfcL02m0bxFVJ3xNtFAI7g9G0uxJ2Dg4NElGagIDnpyQIhALn9UpqdY8Sy8PV/oLydVKpB8SMu1zBUsLyq1QTZ9XIb","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@americancloud%2fsdk@1.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":4581419},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"d5568827ba6e607d2500ef5579db26d217ac5c1d","scripts":{"build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:53b7f97f-d6e4-4538-b04f-e64110fd24b3"}},"repository":{"url":"git+https://github.com/American-Cloud/americancloud-sdk-typescript.git","type":"git"},"_npmVersion":"11.16.0","description":"Official TypeScript & JavaScript SDK for the American Cloud Platform API.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"8.5.1","typescript":"5.9.3","@types/node":"22.19.17"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.2.2_1780420945151_0.6007546806593724","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@americancloud/sdk","version":"1.3.0","keywords":["americancloud","american-cloud","sdk","api","cloud","client"],"license":"Apache-2.0","_id":"@americancloud/sdk@1.3.0","maintainers":[{"name":"americancloud-dev","email":"dev@americancloud.com"},{"name":"americancloud-ben","email":"ben@americancloud.com"}],"homepage":"https://americancloud.com","bugs":{"url":"https://github.com/American-Cloud/americancloud-sdk-typescript/issues"},"dist":{"shasum":"7679e13c5e716ae20c069011f42b8aa0470e1a3f","tarball":"https://registry.npmjs.org/@americancloud/sdk/-/sdk-1.3.0.tgz","fileCount":12,"integrity":"sha512-XdinGIIXtKCDW5eoi5pKRh3AMTwFOg5znFF88McyZ5xbnz20X39MVXgcCetK0TWNLZ3Cvbv67NaI5gzly9VaiA==","signatures":[{"sig":"MEQCIGqRnqPLrrF7F21aIq0+YjXx3AvrUi6UxlK5SYp86xZ5AiBo3zWiqROjMKHCm8BMMorb/0exX19drKLvgL3l9paR+g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@americancloud%2fsdk@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":4681397},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"bf64c014d666628149d7640f9a1354a4b4f7c6d5","scripts":{"build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:53b7f97f-d6e4-4538-b04f-e64110fd24b3"}},"repository":{"url":"git+https://github.com/American-Cloud/americancloud-sdk-typescript.git","type":"git"},"_npmVersion":"11.16.0","description":"Official TypeScript & JavaScript SDK for the American Cloud Platform API.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"8.5.1","typescript":"5.9.3","@types/node":"22.19.17"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.3.0_1780627434915_0.12850041482184604","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"@americancloud/sdk","version":"1.3.1","keywords":["americancloud","american-cloud","sdk","api","cloud","client"],"license":"Apache-2.0","_id":"@americancloud/sdk@1.3.1","maintainers":[{"name":"americancloud-dev","email":"dev@americancloud.com"},{"name":"americancloud-ben","email":"ben@americancloud.com"}],"homepage":"https://americancloud.com","bugs":{"url":"https://github.com/American-Cloud/americancloud-sdk-typescript/issues"},"dist":{"shasum":"5e2dcc3fc84273ce9fac4e7c580338d4b3e212fe","tarball":"https://registry.npmjs.org/@americancloud/sdk/-/sdk-1.3.1.tgz","fileCount":12,"integrity":"sha512-2lOuZhXbWRP21AlQM0ERyzxXz39pYsJeZS+PEq0ltmD8P+Bxqmrx6hNoN2q895Rwal/gaqUpNyKKweiDPXwW0Q==","signatures":[{"sig":"MEUCIFvaSONGwfKAbSGCxNibBoxIzYMKqR88Hc9YGnYXp66ZAiEA75lNPB8GCCbHOUBpzZE2IphXiJ3b3HTTvTO2Y+cJkDI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@americancloud%2fsdk@1.3.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":4690838},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"0753e8ebd6367c16bdd934bf32c05247c928d84a","scripts":{"build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:53b7f97f-d6e4-4538-b04f-e64110fd24b3"}},"repository":{"url":"git+https://github.com/American-Cloud/americancloud-sdk-typescript.git","type":"git"},"_npmVersion":"11.16.0","description":"Official TypeScript & JavaScript SDK for the American Cloud Platform API.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"8.5.1","typescript":"5.9.3","@types/node":"22.19.17"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.3.1_1780697608740_0.46858915692995073","host":"s3://npm-registry-packages-npm-production"}},"1.3.2":{"name":"@americancloud/sdk","version":"1.3.2","keywords":["americancloud","american-cloud","sdk","api","cloud","client"],"license":"Apache-2.0","_id":"@americancloud/sdk@1.3.2","maintainers":[{"name":"americancloud-dev","email":"dev@americancloud.com"},{"name":"americancloud-ben","email":"ben@americancloud.com"}],"homepage":"https://americancloud.com","bugs":{"url":"https://github.com/American-Cloud/americancloud-sdk-typescript/issues"},"dist":{"shasum":"5d3387bc21991719dc2321ee76da6efc5f8372ac","tarball":"https://registry.npmjs.org/@americancloud/sdk/-/sdk-1.3.2.tgz","fileCount":12,"integrity":"sha512-l39TydMXV0tR4xZEEWE8OcBX4poGzjZ/tCBnzPkKonHwS1iLV2VnhNLkP5YR/Zuy5R8FgUrouTAB0dUR9oa1eQ==","signatures":[{"sig":"MEUCIFRwCjJcFYi5UvdBdat+pDPi8xLwIMKIKcZxuMJaZlq3AiEAv10SJydrtUL2vrobLZlM6D0WYqBVIsAYuDpne4SNyAQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@americancloud%2fsdk@1.3.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":4718367},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"b5242b7b51a74b1fbb03cce3e64aac8da1e598dd","scripts":{"build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:53b7f97f-d6e4-4538-b04f-e64110fd24b3"}},"repository":{"url":"git+https://github.com/American-Cloud/americancloud-sdk-typescript.git","type":"git"},"_npmVersion":"11.17.0","description":"Official TypeScript & JavaScript SDK for the American Cloud Platform API.","directories":{},"sideEffects":false,"_nodeVersion":"22.22.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"8.5.1","typescript":"5.9.3","@types/node":"22.19.17"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.3.2_1781731207576_0.6894408726108128","host":"s3://npm-registry-packages-npm-production"}},"1.3.3":{"name":"@americancloud/sdk","version":"1.3.3","keywords":["americancloud","american-cloud","sdk","api","cloud","client"],"license":"Apache-2.0","_id":"@americancloud/sdk@1.3.3","maintainers":[{"name":"americancloud-dev","email":"dev@americancloud.com"},{"name":"americancloud-ben","email":"ben@americancloud.com"}],"homepage":"https://americancloud.com","bugs":{"url":"https://github.com/American-Cloud/americancloud-sdk-typescript/issues"},"dist":{"shasum":"a902f0bfa2d094abadb01d498660ceacc27c051b","tarball":"https://registry.npmjs.org/@americancloud/sdk/-/sdk-1.3.3.tgz","fileCount":12,"integrity":"sha512-wIPymDoBHVj0INCHfRFkV6ZyBeuMIjWzH2Vyz3Uk3UljkM3ZVpO2OUlZ6f6LoBReLl7ByniyoIya5NbF0HeM1w==","signatures":[{"sig":"MEQCIHo5h5N4WSmrw2qO/5nX50l4wR0rkxge3EkxZ0LUZx+HAiB961EGJPMvNx17YVpxTd9Ld0Ap7AEZ6cry7C5o6W8I6w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@americancloud%2fsdk@1.3.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":4723295},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"gitHead":"820f0f0e084edf1bd18676fd21d655aa61640dab","scripts":{"build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:53b7f97f-d6e4-4538-b04f-e64110fd24b3"}},"repository":{"url":"git+https://github.com/American-Cloud/americancloud-sdk-typescript.git","type":"git"},"_npmVersion":"11.18.0","description":"Official TypeScript & JavaScript SDK for the American Cloud Platform API.","directories":{},"sideEffects":false,"_nodeVersion":"22.23.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"8.5.1","typescript":"5.9.3","@types/node":"22.19.17"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.3.3_1785178375281_0.8814968834646082","host":"s3://npm-registry-packages-npm-production"}},"1.4.0":{"name":"@americancloud/sdk","version":"1.4.0","description":"Official TypeScript & JavaScript SDK for the American Cloud Platform API.","license":"Apache-2.0","type":"module","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"}}},"sideEffects":false,"engines":{"node":">=18"},"scripts":{"build":"tsup","typecheck":"tsc --noEmit","prepublishOnly":"npm run build"},"devDependencies":{"@types/node":"22.19.17","tsup":"8.5.1","typescript":"5.9.3"},"keywords":["americancloud","american-cloud","sdk","api","cloud","client"],"homepage":"https://americancloud.com","repository":{"type":"git","url":"git+https://github.com/American-Cloud/americancloud-sdk-typescript.git"},"bugs":{"url":"https://github.com/American-Cloud/americancloud-sdk-typescript/issues"},"publishConfig":{"access":"public"},"gitHead":"cf52db330ebcb0db62f5ed5874de2422f73fdb10","_id":"@americancloud/sdk@1.4.0","_nodeVersion":"22.23.2","_npmVersion":"11.19.0","dist":{"integrity":"sha512-2imJN1r4040AGJTCw7MpZiRxZZvJVGgXMYtC+vYhHmVL5gPVeKRAy9gshwCd5NnJFnEA4hegZ8ajh9OFTH4aMQ==","shasum":"7e5010ef0c807dd577cb540b715816cec1466302","tarball":"https://registry.npmjs.org/@americancloud/sdk/-/sdk-1.4.0.tgz","fileCount":12,"unpackedSize":4810664,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@americancloud%2fsdk@1.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBY2fqEy2/OVpfijzDd94RlzwrXJQqe599qcVdg9JjrHAiEApKNmT9rf+/EcZoGLAVjLDRrdu9eEZSEFQILboXHPpGU="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:53b7f97f-d6e4-4538-b04f-e64110fd24b3"}},"directories":{},"maintainers":[{"name":"americancloud-dev","email":"dev@americancloud.com"},{"name":"americancloud-ben","email":"ben@americancloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_1.4.0_1787752703339_0.43041847667942323"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-02T16:45:06.413Z","modified":"2026-08-26T13:58:24.023Z","1.2.2-rc.1":"2026-06-02T16:45:06.763Z","1.2.2-rc.2":"2026-06-02T16:59:59.346Z","1.2.2":"2026-06-02T17:22:25.343Z","1.3.0":"2026-06-05T02:43:55.092Z","1.3.1":"2026-06-05T22:13:28.910Z","1.3.2":"2026-06-17T21:20:07.817Z","1.3.3":"2026-07-27T18:52:55.516Z","1.4.0":"2026-08-26T13:58:23.489Z"},"bugs":{"url":"https://github.com/American-Cloud/americancloud-sdk-typescript/issues"},"license":"Apache-2.0","homepage":"https://americancloud.com","keywords":["americancloud","american-cloud","sdk","api","cloud","client"],"repository":{"type":"git","url":"git+https://github.com/American-Cloud/americancloud-sdk-typescript.git"},"description":"Official TypeScript & JavaScript SDK for the American Cloud Platform API.","maintainers":[{"name":"americancloud-dev","email":"dev@americancloud.com"},{"name":"americancloud-ben","email":"ben@americancloud.com"}],"readme":"# American Cloud TypeScript SDK\n\nTyped TypeScript / JavaScript client for the [American Cloud](https://americancloud.com) public API.\n\nThis SDK is auto-generated from the OpenAPI specification using [Fern](https://buildwithfern.com). It targets American Cloud API **`v1`** — see [`VERSIONING.md`](./VERSIONING.md) for how SDK releases track the API.\n\n![Listing regions and VMs with the American Cloud TypeScript SDK](https://raw.githubusercontent.com/American-Cloud/americancloud-sdk-typescript/master/.demo/sdk-firstcall.gif)\n\n## Installation\n\n```sh\nnpm install @americancloud/sdk\n# or\npnpm add @americancloud/sdk\n```\n\n## Authentication\n\nEvery request requires **both** parts of an American Cloud API key, sent as headers:\n\n| Header | SDK option |\n|---|---|\n| `X-API-Client-ID` | `apiKey` |\n| `X-API-Client-Secret` | `apiClientSecret` |\n\nCreate and manage keys at **[console.americancloud.com/api-keys](https://console.americancloud.com/api-keys)**. The client secret is shown once at creation — store it securely. If lost, revoke the key and create a new one.\n\nEach key is scoped at creation:\n\n- **`read-only`** — `GET` endpoints only\n- **`read-write`** — full access to all resource management endpoints\n\n## Quick start\n\n```ts\nimport { AmericancloudApiClient } from \"@americancloud/sdk\";\n\nconst client = new AmericancloudApiClient({\n  apiKey: process.env.AMERICANCLOUD_API_CLIENT_ID!,\n  apiClientSecret: process.env.AMERICANCLOUD_API_CLIENT_SECRET!,\n});\n\nconst vms = await client.vms.listVms();\nconsole.log(vms);\n```\n\nThe client is namespaced by resource — `client.vms`, `client.blockStorage`, `client.kubernetes`, `client.dnsZones`, etc. Each namespace exposes the operations available on that resource.\n\n## API endpoint\n\nThe SDK targets the American Cloud production API at **`https://api.americancloud.com`** by default. To override (e.g. for a self-hosted or internal environment), pass `baseUrl`:\n\n```ts\nconst client = new AmericancloudApiClient({\n  apiKey: \"...\",\n  apiClientSecret: \"...\",\n  baseUrl: \"https://your-custom-endpoint.example.com\",\n});\n```\n\n## API reference\n\n- **Full reference + code samples**: [americancloud.docs.buildwithfern.com](https://americancloud.docs.buildwithfern.com)\n- **Interactive Swagger UI**: [api.americancloud.com/api-v1](https://api.americancloud.com/api-v1)\n\n## Guides\n\nNarrative walkthroughs on the American Cloud docs site:\n\n- [TypeScript SDK quickstart](https://americancloud.com/docs/sdks/typescript) — install, authenticate, estimate cost, then create a VM, with error handling and pagination\n- [SDKs & Terraform overview](https://americancloud.com/docs/sdks/overview) — when to reach for an SDK, Terraform, or the MCP server\n- [Deploy with AI](https://americancloud.com/docs/deploy-with-ai/overview) — let an AI assistant build and ship to American Cloud\n\n## Versioning\n\nThe SDK version **matches the API platform version it was generated from** — SDK `x.y.z` is generated from OpenAPI document `x.y.z`, so the SDK↔API mapping is one-to-one by construction:\n\n- **Patch / minor** releases are backward-compatible — safe to upgrade.\n- **Major** releases track a new API URL version (`/api/v2`) and may require code changes; check the [`CHANGELOG`](./CHANGELOG.md) first.\n- The `1.x` line targets API `v1`, which remains available for at least six months after a `v2` release.\n- Additive API changes (new endpoints, optional fields, enum values) ship within a version — tolerate unknown fields and new enum values gracefully.\n\nSee [`VERSIONING.md`](./VERSIONING.md) for the full policy.\n\n## Reporting issues\n\nOpen an issue against this repository, or contact American Cloud support.\n\n## Contributing\n\nThis SDK is generated — do not edit the source by hand. See [`CONTRIBUTING.md`](./CONTRIBUTING.md) for the generation workflow.\n","readmeFilename":"README.md"}