{"_id":"@atlas-cloud/sdk","_rev":"2-ec17f8b0588172b6d050903a5df4a0ae","name":"@atlas-cloud/sdk","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@atlas-cloud/sdk","version":"0.1.0","keywords":["atlascloud","storage","translation","sdk","cloud"],"author":{"name":"AtlasCloud"},"license":"MIT","_id":"@atlas-cloud/sdk@0.1.0","maintainers":[{"name":"devblackjulio","email":"julioperdigaoblack@gmail.com"}],"dist":{"shasum":"e56ccda3b9c7780b1b611114e04ffe01e674dfc0","tarball":"https://registry.npmjs.org/@atlas-cloud/sdk/-/sdk-0.1.0.tgz","fileCount":6,"integrity":"sha512-FvrkSvPPrJznDv3f2OHmszhvGuhHZDBEHbdK6HDL+pTLAXUUNl1oTNaU9vEs/rEo2vaKtMRAOt/y1hgzX2AAsw==","signatures":[{"sig":"MEUCIQCCgNL0zPFGhuyYp+t5zRWHm7/PR6v+2GJe8KELocyvCAIge0kliTCii1rYq+V+bjpExzQLC6i4G3t83frLIWKzMNM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33280},"main":"./dist/index.cjs","types":"./dist/index.d.ts","module":"./dist/index.js","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"gitHead":"7ebbe61a2ebb9173a9eb96d2431657679e364e67","scripts":{"dev":"tsup src/index.ts --format esm,cjs --dts --watch","lint":"tsc --noEmit","test":"vitest run","build":"tsup src/index.ts --format esm,cjs --dts --clean"},"_npmUser":{"name":"devblackjulio","email":"julioperdigaoblack@gmail.com"},"_npmVersion":"11.9.0","description":"Official JavaScript/TypeScript SDK for AtlasCloud — Storage, Translation, and more.","directories":{},"_nodeVersion":"24.14.0","_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.0.0","vitest":"^1.6.0","typescript":"^5.4.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_0.1.0_1785911195259_0.5759565927504462","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@atlas-cloud/sdk","version":"0.2.0","description":"Official JavaScript/TypeScript SDK for AtlasCloud — Storage, Translation, and more.","main":"./dist/index.cjs","module":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs"}},"scripts":{"build":"tsup src/index.ts --format esm,cjs --dts --clean","dev":"tsup src/index.ts --format esm,cjs --dts --watch","test":"vitest run","lint":"tsc --noEmit"},"keywords":["atlascloud","storage","translation","sdk","cloud"],"author":{"name":"AtlasCloud"},"license":"MIT","devDependencies":{"tsup":"^8.0.0","typescript":"^5.4.0","vitest":"^1.6.0"},"engines":{"node":">=18"},"gitHead":"edbfab33b1e4b328a57cd2493161cdc00894b63b","_id":"@atlas-cloud/sdk@0.2.0","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-B89+3RuB1JOR8CVyOur5LEq5mW/IYguZ7aAbChe256zqQIT9ojbQSKrJYsnHzxId+oXHacau1g0EwJx+HADFJA==","shasum":"1043e1255ab7f1ff14951e9f2cdf0ac530c6f1e6","tarball":"https://registry.npmjs.org/@atlas-cloud/sdk/-/sdk-0.2.0.tgz","fileCount":6,"unpackedSize":43828,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCiI4ZqBem+BdR9VVv3OiP2YdnHlXwLmdEHOnYDxvRVwwIgdUxuT9od8Zj1oPcDVDEMUYPA8XBLPqUgVVGnhs85qDs="}]},"_npmUser":{"name":"devblackjulio","email":"julioperdigaoblack@gmail.com"},"directories":{},"maintainers":[{"name":"devblackjulio","email":"julioperdigaoblack@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_0.2.0_1786108908014_0.83455389900769"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-05T06:26:34.911Z","modified":"2026-08-07T13:21:48.346Z","0.1.0":"2026-08-05T06:26:35.397Z","0.2.0":"2026-08-07T13:21:48.170Z"},"author":{"name":"AtlasCloud"},"license":"MIT","keywords":["atlascloud","storage","translation","sdk","cloud"],"description":"Official JavaScript/TypeScript SDK for AtlasCloud — Storage, Translation, and more.","maintainers":[{"name":"devblackjulio","email":"julioperdigaoblack@gmail.com"}],"readme":"# @atlas-cloud/sdk\n\nOfficial JavaScript/TypeScript SDK for [AtlasCloud](https://atlascloudapp.com).\n\n## Installation\n\n```bash\nnpm install @atlas-cloud/sdk\n# or\npnpm add @atlas-cloud/sdk\n# or\nyarn add @atlas-cloud/sdk\n```\n\n## Quick Start\n\n```ts\nimport { AtlasCloud } from \"@atlas-cloud/sdk\"\n\nconst atlas = new AtlasCloud({\n  apiKey: \"atlas_...\", // Generate at https://atlascloudapp.com/dashboard/settings/developer\n})\n```\n\n---\n\n## Storage\n\nUpload, list, and delete files across your buckets.\n\n```ts\n// List all buckets\nconst buckets = await atlas.storage.listBuckets()\n\n// Upload a file (Node.js)\nimport fs from \"fs\"\nconst buffer = fs.readFileSync(\"./avatar.png\")\nconst { url } = await atlas.storage.upload({\n  bucket: \"my-bucket\",\n  key: \"images/avatar.png\",\n  body: buffer,\n  contentType: \"image/png\",\n  public: true,\n})\nconsole.log(url) // https://cdn.atlascloudapp.com/...\n\n// Upload in the browser\nconst fileInput = document.querySelector(\"input[type=file]\") as HTMLInputElement\nconst file = fileInput.files![0]\nconst { url: uploadedUrl } = await atlas.storage.upload({\n  bucket: \"my-bucket\",\n  key: `uploads/${file.name}`,\n  body: file,\n  contentType: file.type,\n})\n\n// List objects\nconst { objects, nextCursor } = await atlas.storage.list({\n  bucket: \"my-bucket\",\n  prefix: \"images/\",\n  limit: 50,\n})\n\n// Delete an object\nawait atlas.storage.delete({ bucket: \"my-bucket\", key: \"images/avatar.png\" })\n\n// Get a signed URL (private objects)\nconst signedUrl = await atlas.storage.getUrl({\n  bucket: \"private-bucket\",\n  key: \"reports/q4.pdf\",\n  expiresIn: 3600, // 1 hour\n})\n```\n\n---\n\n## Translation\n\nTranslate text across **50+ languages** powered by LibreTranslate (open-source, privacy-friendly).\n\n```ts\n// Translate a single string\nconst { translated } = await atlas.translation.translate({\n  text: \"Hello, world!\",\n  to: \"pt\", // Portuguese\n})\n// => \"Olá, mundo!\"\n\n// Auto-detect source language\nconst result = await atlas.translation.translate({\n  text: \"Bonjour le monde\",\n  to: \"en\",\n  from: \"auto\", // default\n  })\nconsole.log(result.detectedLanguage) // { code: \"fr\", confidence: 0.98 }\n\n// Translate an array of strings in one call\nconst { translated: [t1, t2] } = await atlas.translation.translate({\n  text: [\"Good morning\", \"See you later\"],\n  to: \"es\",\n})\n\n// Batch translate with different targets\nconst { results } = await atlas.translation.batch({\n  items: [\n    { text: \"Hello\", to: \"es\" },\n    { text: \"Thank you\", to: \"ja\" },\n    { text: \"Goodbye\", to: \"de\" },\n  ],\n})\n\n// Detect language only\nconst { code, confidence } = await atlas.translation.detect(\"Olá!\")\n// => { code: \"pt\", confidence: 0.97, name: \"Portuguese\" }\n\n// List all supported languages\nconst languages = await atlas.translation.listLanguages()\n// => [{ code: \"en\", name: \"English\" }, { code: \"pt\", name: \"Portuguese\" }, ...]\n```\n\n### Supported Languages\n\n| Code | Language    | Code | Language   |\n|------|-------------|------|------------|\n| `ar` | Arabic      | `ja` | Japanese   |\n| `zh` | Chinese (S) | `ko` | Korean     |\n| `nl` | Dutch       | `pl` | Polish     |\n| `en` | English     | `pt` | Portuguese |\n| `fr` | French      | `ru` | Russian    |\n| `de` | German      | `es` | Spanish    |\n| `hi` | Hindi       | `sv` | Swedish    |\n| `id` | Indonesian  | `tr` | Turkish    |\n| `it` | Italian     | `uk` | Ukrainian  |\n|      |             | `vi` | Vietnamese |\n\n[Full list of 50+ languages →](https://atlascloudapp.com/docs/translation/languages)\n\n---\n\n## Email\n\nSend transactional emails and query dispatch logs.\n\n```ts\n// Send an email\nconst result = await atlas.email.send({\n  to: \"user@example.com\",\n  subject: \"Welcome to AtlasCloud!\",\n  html: \"<h1>Hello!</h1><p>We are glad you are here.</p>\",\n})\nconsole.log(result.id) // Log ID tracking the message status\n\n// List email history logs\nconst logs = await atlas.email.listLogs({\n  limit: 10,\n  status: \"SENT\",\n})\n\n// Get a single log detail\nconst log = await atlas.email.getLog(\"some-log-uuid\")\n```\n\n---\n\n## Error Handling\n\n```ts\nimport { AtlasCloud, AtlasCloudError } from \"@atlas-cloud/sdk\"\n\ntry {\n  await atlas.storage.upload({ ... })\n} catch (err) {\n  if (err instanceof AtlasCloudError) {\n    console.error(err.message)  // human-readable message\n    console.error(err.status)   // HTTP status code\n    console.error(err.code)     // optional error code\n  }\n}\n```\n\n---\n\n## Configuration\n\n| Option    | Type     | Default                                      | Description                        |\n|-----------|----------|----------------------------------------------|------------------------------------|\n| `apiKey`  | `string` | —                                            | **Required.** Your `atlas_` key   |\n| `baseUrl` | `string` | `https://api-atlascloud.up.railway.app/api/v1` | Base URL. Use `http://localhost:3000/v1` for local development |\n\n---\n\n## License\n\nMIT © AtlasCloud\n","readmeFilename":"README.md"}