{"_id":"@ainative/serviceos-sdk","_rev":"2-e7f5677556300d31ef557d347aecf365","name":"@ainative/serviceos-sdk","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@ainative/serviceos-sdk","version":"0.1.0","keywords":["serviceos","helpdesk","ticketing","ainative","sdk","mcp"],"author":{"name":"AINative Dev Team"},"license":"MIT","_id":"@ainative/serviceos-sdk@0.1.0","maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"homepage":"https://github.com/AINative-Studio/service-os#readme","bugs":{"url":"https://github.com/AINative-Studio/service-os/issues"},"dist":{"shasum":"7aa1a3bc1468b922cde78022568d99fd3b5c5a39","tarball":"https://registry.npmjs.org/@ainative/serviceos-sdk/-/serviceos-sdk-0.1.0.tgz","fileCount":38,"integrity":"sha512-zeEGF64ZxBVKXrxHOcPt4wqBKrnlM9u/qumk5xJcWR+hpq4N4pSFLKHaP3X2MDKIaI+rXiibUVc9ctmJSQdZgQ==","signatures":[{"sig":"MEQCIHISbs3DDE83EfuyFg8EGhRAZs3QBOdRS2bkAApVBdVmAiB1fD/Of16MeaTkzjtdfyruSXz+wl/eqwoNOHMA6fMTsw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48652},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"e2e91af7aa28ee6bb2ab1915f5d39d908508de77","scripts":{"test":"jest --coverage","build":"tsc","test:watch":"jest --watch","prepublishOnly":"npm run build"},"_npmUser":{"name":"ainative-studio","email":"toby@rely.ventures"},"repository":{"url":"git+https://github.com/AINative-Studio/service-os.git","type":"git"},"_npmVersion":"10.9.4","description":"Official Node.js/TypeScript SDK for ServiceOS Helpdesk API","directories":{},"_nodeVersion":"22.21.0","dependencies":{"axios":"^1.6.7"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","ts-jest":"^29.1.2","typescript":"^5.3.3","@types/jest":"^29.5.12","@types/node":"^20.11.17"},"_npmOperationalInternal":{"tmp":"tmp/serviceos-sdk_0.1.0_1781424557398_0.4500543531687857","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@ainative/serviceos-sdk","version":"0.1.1","description":"Helpdesk software SDK — AI customer support, ticketing API, SLA management. Zendesk alternative for developers. ServiceOS by AINative.","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","test":"jest --coverage","test:watch":"jest --watch","prepublishOnly":"npm run build"},"keywords":["helpdesk software","help desk software","helpdesk api","ticketing api","ai helpdesk","ai customer support","zendesk alternative","freshdesk alternative","support ticket system","sla management","helpdesk automation","customer support software","it helpdesk software","best helpdesk software","ai ticketing system","helpdesk sdk","service desk","customer service api","serviceos","ainative","mcp","helpdesk for developers"],"license":"MIT","dependencies":{"axios":"^1.6.7"},"devDependencies":{"@types/jest":"^29.5.12","@types/node":"^20.11.17","jest":"^29.7.0","ts-jest":"^29.1.2","typescript":"^5.3.3"},"engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/AINative-Studio/service-os.git"},"author":{"name":"AINative Dev Team"},"_id":"@ainative/serviceos-sdk@0.1.1","gitHead":"c65b3e14d09af9e7ae2d2a10997f7fc7ff66259c","bugs":{"url":"https://github.com/AINative-Studio/service-os/issues"},"homepage":"https://github.com/AINative-Studio/service-os#readme","_nodeVersion":"22.21.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-8APtgJeyNnmJPxIBTqHFW5XmtiVk5YUzx5f3DnB6O7SORnTkNmnA/PBnvsicigeey0ymH4ZuwvSE9J91sOZqIA==","shasum":"70194afd8caa5584d9b463c42c2562a116b31816","tarball":"https://registry.npmjs.org/@ainative/serviceos-sdk/-/serviceos-sdk-0.1.1.tgz","fileCount":38,"unpackedSize":49176,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICiYsEq7jnWxHfRuD2B2KjwbqZ4uzNRQl8mCR64JuWz/AiB9ebort0tIpUvZif2EB84LfFH1DTpBIY+sftnWYjCc7w=="}]},"_npmUser":{"name":"ainative-studio","email":"toby@rely.ventures"},"directories":{},"maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/serviceos-sdk_0.1.1_1781560898490_0.7782247861113434"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-14T08:09:17.287Z","modified":"2026-06-15T22:01:38.781Z","0.1.0":"2026-06-14T08:09:17.537Z","0.1.1":"2026-06-15T22:01:38.633Z"},"bugs":{"url":"https://github.com/AINative-Studio/service-os/issues"},"author":{"name":"AINative Dev Team"},"license":"MIT","homepage":"https://github.com/AINative-Studio/service-os#readme","keywords":["helpdesk software","help desk software","helpdesk api","ticketing api","ai helpdesk","ai customer support","zendesk alternative","freshdesk alternative","support ticket system","sla management","helpdesk automation","customer support software","it helpdesk software","best helpdesk software","ai ticketing system","helpdesk sdk","service desk","customer service api","serviceos","ainative","mcp","helpdesk for developers"],"repository":{"type":"git","url":"git+https://github.com/AINative-Studio/service-os.git"},"description":"Helpdesk software SDK — AI customer support, ticketing API, SLA management. Zendesk alternative for developers. ServiceOS by AINative.","maintainers":[{"name":"ainative-studio","email":"toby@rely.ventures"}],"readme":"# @serviceos/sdk\n\nTypeScript/Node.js SDK for ServiceOS API.\n\n## Installation\n\n```bash\nnpm install @serviceos/sdk\n```\n\n## Quick Start\n\n```typescript\nimport { ServiceOS } from \"@serviceos/sdk\";\n\nconst client = new ServiceOS({\n  apiKey: \"sk_...\",\n  orgId: \"org_123\",\n  baseUrl: \"https://helpdesk.ainative.studio\",\n});\n\n// List open tickets\nconst tickets = await client.tickets.list({ status: \"open\" });\n\n// Create a ticket\nconst ticket = await client.tickets.create({\n  title: \"Bug report\",\n  priority: \"high\",\n});\n\n// Update a ticket\nawait client.tickets.update(ticket.data.ticket_id, { status: \"resolved\" });\n\n// Auto-paginate all tickets\nfor await (const ticket of client.tickets.listAll({ status: \"open\" })) {\n  console.log(ticket.title);\n}\n\n// Teams, queues, webhooks, views\nconst teams = await client.teams.list();\nconst queues = await client.queues.list();\n```\n\n## Debug Mode\n\n```typescript\nconst client = new ServiceOS({ ..., debug: true });\n```\n\n## Error Handling\n\n```typescript\nimport { ServiceOS, AuthError, RateLimitError, NotFoundError } from \"@serviceos/sdk\";\n\ntry {\n  await client.tickets.get(\"nonexistent\");\n} catch (err) {\n  if (err instanceof NotFoundError) {\n    console.log(\"Ticket not found\");\n  } else if (err instanceof RateLimitError) {\n    console.log(`Retry after ${err.retryAfter}s`);\n  }\n}\n```\n\n## Features\n\n- Auto-retry on 429 (respects Retry-After header) and 5xx (exponential backoff)\n- Async pagination iterator via `listAll()`\n- Typed error classes with API error codes\n- Debug mode for request logging\n","readmeFilename":"README.md"}