{"_id":"@aethoncredit/sdk","_rev":"2-c5a29141c46bf1b2a2a3aff30d321efa","name":"@aethoncredit/sdk","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@aethoncredit/sdk","version":"1.0.0","keywords":["aci","credit","scoring","api","sdk","fintech"],"author":{"name":"ACI Platform"},"license":"MIT","_id":"@aethoncredit/sdk@1.0.0","maintainers":[{"name":"aethoncredit","email":"sales@aethoncredit.com"}],"dist":{"shasum":"e672b01bbda0aa9b937e3fba012c4d0106e8f0c8","tarball":"https://registry.npmjs.org/@aethoncredit/sdk/-/sdk-1.0.0.tgz","fileCount":5,"integrity":"sha512-mc07TUdv8h4gJwW1yzuf1FfKQGY57Hx3rnm2yF6a5Ov5a6q1vFvpBKwgF/m5d6U6XbCc4u3RAfRhFlkcYOUSyg==","signatures":[{"sig":"MEQCICtGSPMDT20obvhPfoL3JU5dlSB90hPwmQ5qMcaSBY/YAiBYS/A8VDS7kVQimpMKK7piwoU+C+K0MoaffjWL8qiqbg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":15371},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"71d631807b9427789bc6c90bc405732ea2352f1c","scripts":{"build":"tsc --project tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"aethoncredit","email":"sales@aethoncredit.com"},"_npmVersion":"11.9.0","description":"Official TypeScript SDK for the Aethon Credit Intelligence (ACI) API","directories":{},"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.0.0"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.0_1778229922810_0.8483318234617185","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aethoncredit/sdk","version":"1.0.1","description":"Official TypeScript SDK for the Aethon Credit Intelligence (ACI) API","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc --project tsconfig.json","prepublishOnly":"npm run build"},"publishConfig":{"access":"public"},"keywords":["aci","credit","scoring","api","sdk","fintech"],"author":{"name":"ACI Platform"},"license":"MIT","engines":{"node":">=18.0.0"},"devDependencies":{"typescript":"^5.0.0"},"_id":"@aethoncredit/sdk@1.0.1","gitHead":"9dce7ab8f57efe592697306c798299b992ecafd0","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-hfYvL/J4Tk6jOTe2MqD7shS/xgxnygCqDrxO0HM3L6S1pK7YXoerPlmO7zI4rLj4un42i251Bxq63GMV9l11IA==","shasum":"e0303cec069422383ea643fb7945719d8f61ce71","tarball":"https://registry.npmjs.org/@aethoncredit/sdk/-/sdk-1.0.1.tgz","fileCount":5,"unpackedSize":15917,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAVJSUiyYgLFGqcXP34+JblSSgkAmkPDYCSMa3/10rz/AiEA3yOyhYCqzb9c6uzbTKUgur1w0x2J4qiEVEk8wMeIuvs="}]},"_npmUser":{"name":"aethoncredit","email":"sales@aethoncredit.com"},"directories":{},"maintainers":[{"name":"aethoncredit","email":"sales@aethoncredit.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_1.0.1_1785670860890_0.318868686421125"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-08T08:45:22.708Z","modified":"2026-08-02T11:41:01.184Z","1.0.0":"2026-05-08T08:45:22.945Z","1.0.1":"2026-08-02T11:41:01.038Z"},"author":{"name":"ACI Platform"},"license":"MIT","keywords":["aci","credit","scoring","api","sdk","fintech"],"description":"Official TypeScript SDK for the Aethon Credit Intelligence (ACI) API","maintainers":[{"name":"aethoncredit","email":"sales@aethoncredit.com"}],"readme":"# @aethoncredit/sdk\n\nOfficial TypeScript SDK for the Aethon Credit Intelligence (ACI) API.\n\n## Installation\n\n```bash\nnpm install @aethoncredit/sdk\n```\n\n## Quick Start\n\n```typescript\nimport { ACIClient } from '@aethoncredit/sdk';\n\nconst aci = new ACIClient({ apiKey: 'sk_live_your_key_here' });\n\n// List all provider scores\nconst scores = await aci.getScores();\nscores.forEach(s => console.log(`${s.provider_name}: ${s.composite_score}`));\n\n// Get a single provider's score\nconst score = await aci.getScore('provider-uuid');\nconsole.log(score.risk_band); // 'LOW' | 'MEDIUM' | 'ELEVATED' | 'HIGH'\n```\n\n## Sandbox\n\n```typescript\nconst sandbox = new ACIClient({\n  apiKey: 'sk_test_your_key',\n  baseUrl: 'https://sandbox.aethoncredit.com/v1',\n});\n```\n\n## Methods\n\n| Method | Description | Tier |\n|--------|-------------|------|\n| `getScores()` | List all provider scores | FREE+ |\n| `getScore(id)` | Single provider detail | FREE+ |\n| `getScoreHistory(id, opts?)` | Score history & trends | PRO+ |\n| `getMethodology()` | Current ACI Framework methodology | FREE+ |\n| `getComputationPackage(id)` | Computation package | INST |\n| `getStatus()` | API health check | ALL |\n\n## Score History\n\n```typescript\nconst history = await aci.getScoreHistory('provider-uuid', {\n  granularity: 'weekly',\n  from: '2026-01-01',\n  include_trend: true,\n});\n```\n\n## Error Handling\n\n```typescript\nimport { ACIClient, ACIApiError } from '@aethoncredit/sdk';\n\ntry {\n  const score = await aci.getScore('invalid-id');\n} catch (err) {\n  if (err instanceof ACIApiError) {\n    console.log(err.code);       // 'NOT_FOUND'\n    console.log(err.statusCode); // 404\n  }\n}\n```\n\n## Webhook Verification\n\n```typescript\nimport { WebhookVerifier } from '@aethoncredit/sdk';\n\nconst isValid = WebhookVerifier.verify(\n  rawBody,\n  request.headers['x-aci-signature'],\n  'whsec_your_secret',\n);\n```\n\n## Built-in Features\n\n- Automatic retry with exponential backoff (1s, 2s, 4s)\n- Rate limit handling (429 waits for Retry-After)\n- Configurable timeout (default 30s)\n- Zero external dependencies\n","readmeFilename":"README.md"}