{"_id":"@asksoma/astro-client","_rev":"5-8d083f5e0a650211982a477cd29fc90a","name":"@asksoma/astro-client","dist-tags":{"latest":"1.1.2"},"versions":{"1.0.4":{"name":"@asksoma/astro-client","version":"1.0.4","keywords":["asksoma","astrology","vedic","jyotish","api-client"],"license":"UNLICENSED","_id":"@asksoma/astro-client@1.0.4","maintainers":[{"name":"asksoma","email":"asksoma.ai@gmail.com"}],"bin":{"asksoma":"dist/cli.js"},"dist":{"shasum":"152e6b008ac24a1ec433a0a97b7a7ac4d402bdb4","tarball":"https://registry.npmjs.org/@asksoma/astro-client/-/astro-client-1.0.4.tgz","fileCount":8,"integrity":"sha512-nG0EpDBriqsNJ250KeGBO+0GfIcAjdDKyYHXKunObr+IL95J3Vd1LBjuOwfZHyo8G/az0nl2CldeR3pitzPkRw==","signatures":[{"sig":"MEUCIQDKrlTSij6f0VSFXK1lkAMrxaJ7B1bDdPJgE0ZbM71ykwIgLQFiVh+SUcrv9gFMnGP3UpY/IrxOL0kuN0szZ1OMku0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38884},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"c4966a991748653e6437d7e87eed0ec9a71e2213","private":false,"scripts":{"build":"tsc -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"asksoma","email":"asksoma.ai@gmail.com"},"_npmVersion":"10.9.7","description":"Official TypeScript client for the AskSoma Partner (Astrology Brain) API. Private/admin-issued keys.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0"},"_npmOperationalInternal":{"tmp":"tmp/astro-client_1.0.4_1784890459337_0.8504516738883254","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@asksoma/astro-client","version":"1.0.6","keywords":["asksoma","astrology","vedic","jyotish","api-client"],"license":"UNLICENSED","_id":"@asksoma/astro-client@1.0.6","maintainers":[{"name":"asksoma","email":"asksoma.ai@gmail.com"}],"bin":{"asksoma":"dist/cli.js"},"dist":{"shasum":"1002459528ef8b0fdcb0b859ce68ec3e2fc85835","tarball":"https://registry.npmjs.org/@asksoma/astro-client/-/astro-client-1.0.6.tgz","fileCount":8,"integrity":"sha512-25h06ryNy90LumtvKrj1jFR8n0nVwRXAGV35lsiHxWPK+Ah2/6xnniIPcOaFug+HyLj30HsxOW7cEYKHUULCmw==","signatures":[{"sig":"MEUCICcFIpczHX5dK9/KYaB+rSRRODgp6AHvAYtX1ORu000NAiEA1Phh0rL/oFLf3cX7diKI4L1nHvRgG8QIckw7Ghw4/p4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38884},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"f93211cb0ad9ea27e415c6d195438cfea837edc9","private":false,"scripts":{"build":"tsc -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"asksoma","email":"asksoma.ai@gmail.com"},"_npmVersion":"10.9.7","description":"Official TypeScript client for the AskSoma Partner (Astrology Brain) API. Private/admin-issued keys.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0"},"_npmOperationalInternal":{"tmp":"tmp/astro-client_1.0.6_1784912521978_0.7485220521220621","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@asksoma/astro-client","version":"1.1.0","keywords":["asksoma","astrology","vedic","jyotish","api-client"],"license":"UNLICENSED","_id":"@asksoma/astro-client@1.1.0","maintainers":[{"name":"asksoma","email":"asksoma.ai@gmail.com"}],"bin":{"asksoma":"dist/cli.js"},"dist":{"shasum":"16605a3914f9b0939ff9bd6c8cd6bdbded6de913","tarball":"https://registry.npmjs.org/@asksoma/astro-client/-/astro-client-1.1.0.tgz","fileCount":8,"integrity":"sha512-+U+Lv7pWkr3VTkkqSKPNve0fJwN77fj3uZHh8djFhOCEW+/XJhV6vRBfGLBYyCAPl9TAowDQ91TI56uEeqD+Kw==","signatures":[{"sig":"MEUCIEmkj9dO0qGG0TJovjxnJooUJIhi3ZkVP0oUKns0EJ/jAiEAl5z4tDrjbqB3RwFNxf61+BZf6KMMTuCmkbVz803ZMnY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38884},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"1bab1afa7942b5d3a9dbae1e26c81c1aa62c439a","private":false,"scripts":{"build":"tsc -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"asksoma","email":"asksoma.ai@gmail.com"},"_npmVersion":"10.9.7","description":"Official TypeScript client for the AskSoma Partner (Astrology Brain) API. Private/admin-issued keys.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0"},"_npmOperationalInternal":{"tmp":"tmp/astro-client_1.1.0_1784933391973_0.13582228434291155","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@asksoma/astro-client","version":"1.1.1","keywords":["asksoma","astrology","vedic","jyotish","api-client"],"license":"UNLICENSED","_id":"@asksoma/astro-client@1.1.1","maintainers":[{"name":"asksoma","email":"asksoma.ai@gmail.com"}],"bin":{"asksoma":"dist/cli.js"},"dist":{"shasum":"70b2489f60b7ef89060dd4034304c8c0a36b4f7d","tarball":"https://registry.npmjs.org/@asksoma/astro-client/-/astro-client-1.1.1.tgz","fileCount":8,"integrity":"sha512-5xjgI0QFglWc6vgR92kRp3jTxRh+rjlL5DdRDlC0wIjzfMlN/BkDf7JI1LpBkDkRXSjtsWxYRxQ4ioBPai/vqA==","signatures":[{"sig":"MEUCIQCpKGrn8Dp9RMUFxH5KVpZ6+P13QlePnhWK5XsK7tiVCQIgKVMIsPIl9kLTJ/I+RlmUabX98RTIOuJTuB5YpqhoZQg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38884},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"1bab1afa7942b5d3a9dbae1e26c81c1aa62c439a","private":false,"scripts":{"build":"tsc -p tsconfig.json","prepublishOnly":"npm run build"},"_npmUser":{"name":"asksoma","email":"asksoma.ai@gmail.com"},"_npmVersion":"10.9.7","description":"Official TypeScript client for the AskSoma Partner (Astrology Brain) API. Private/admin-issued keys.","directories":{},"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.6.0"},"_npmOperationalInternal":{"tmp":"tmp/astro-client_1.1.1_1784933962879_0.6723629059390841","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@asksoma/astro-client","version":"1.1.2","private":false,"description":"Official TypeScript client for the AskSoma Partner (Astrology Brain) API. Private/admin-issued keys.","type":"module","main":"dist/index.js","module":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"bin":{"asksoma":"dist/cli.js"},"scripts":{"build":"tsc -p tsconfig.json","prepublishOnly":"npm run build"},"keywords":["asksoma","astrology","vedic","jyotish","api-client"],"license":"UNLICENSED","devDependencies":{"typescript":"^5.6.0"},"_id":"@asksoma/astro-client@1.1.2","gitHead":"1bab1afa7942b5d3a9dbae1e26c81c1aa62c439a","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-pdPNXkIYBcTBnHTZIi4O6Bo4+pcospxvrDjou2TFKSu0NTa61Xkc0Pn/PyvGF0552s9c8jL3DcCk0CXYEUN5sA==","shasum":"66751bd28cfb6d791aa8e8bdb8f11915026f7cc3","tarball":"https://registry.npmjs.org/@asksoma/astro-client/-/astro-client-1.1.2.tgz","fileCount":8,"unpackedSize":38884,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDtzjKv43Fie6tAQsexk7speDSxFliexrp4hLwO6Ak2fwIgJbJpVAD7c8e+Y62x0Kp1QAKfR8yW0GU27zh63QJf+b8="}]},"_npmUser":{"name":"asksoma","email":"asksoma.ai@gmail.com"},"directories":{},"maintainers":[{"name":"asksoma","email":"asksoma.ai@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/astro-client_1.1.2_1784934716104_0.38052334793698805"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-24T10:54:19.208Z","modified":"2026-07-24T23:11:56.387Z","1.0.4":"2026-07-24T10:54:19.482Z","1.0.6":"2026-07-24T17:02:02.157Z","1.1.0":"2026-07-24T22:49:52.122Z","1.1.1":"2026-07-24T22:59:22.995Z","1.1.2":"2026-07-24T23:11:56.243Z"},"license":"UNLICENSED","keywords":["asksoma","astrology","vedic","jyotish","api-client"],"description":"Official TypeScript client for the AskSoma Partner (Astrology Brain) API. Private/admin-issued keys.","maintainers":[{"name":"asksoma","email":"asksoma.ai@gmail.com"}],"readme":"# @asksoma/astro-client\n\nOfficial TypeScript client + CLI for the **AskSoma Partner (Astrology Brain) API**.\nZero dependencies (uses global `fetch`). Node 18+, Deno, Bun, browsers.\n\n> **Private / admin-issued.** Partner (brain) keys are issued by AskSoma — they\n> are not self-serve. Core endpoints work with any valid `sk_live_` key.\n\n## Install & build (internal)\n\n```bash\ncd packages/astro-client\nnpm install\nnpm run build     # emits dist/\n```\n\n## SDK usage\n\n```ts\nimport { AskSomaClient } from '@asksoma/astro-client';\n\nconst soma = new AskSomaClient({ apiKey: process.env.ASKSOMA_API_KEY! });\n// Default base: https://api.asksoma.ai\n\n// Brain — muhurat (electional windows; needs scope 'brain')\nconst muhurat = await soma.muhurat({\n  chart: { date: '1994-08-19', time: '06:15', lat: 19.07, lon: 72.87, tz: 5.5 },\n  activity: 'wedding',\n  from: '2026-08-01',\n  to: '2026-09-30',\n  event: { lat: 19.076, lon: 72.877, tz: 5.5 },\n});\n\n// Brain — daily frames (Rahu Kaal / Choghadiya / Amrit — not ranked windows)\nconst daily = await soma.muhuratDaily({\n  date: '2026-07-24', lat: 28.6139, lon: 77.209, tz: 5.5,\n  signature: 'daily_rahu_kaal',\n});\n\n// Brain — occasion catalog for Finder UIs\nconst catalog = await soma.muhuratCatalog();\n\n// Brain — other\nconst dasha = await soma.dasha({ date: '1990-05-15', time: '14:30', lat: 28.6139, lon: 77.209, tz: 5.5 });\nconst timing = await soma.timing({\n  chart: { date: '1994-08-19', time: '06:15', lat: 19.07, lon: 72.87, tz: 5.5 },\n  domain: 'marriage',\n});\n\n// Core (any valid key)\nawait soma.natalChart({ date: '1990-05-15', time: '14:30', lat: 28.6139, lon: 77.209, tz: 5.5 });\nawait soma.chatCompletions({\n  messages: [{ role: 'user', content: 'Explain the top muhurat window in plain English.' }],\n});\n```\n\n`tz` is a **numeric UTC offset in hours** (e.g. `5.5` for IST) on brain routes.\nErrors throw `AskSomaApiError` with `.status`, `.code`, and `.scope` (e.g. `scope_required`).\n\n### Agent / LLM auto-connect\n\nHand coding agents this URL first: **https://asksoma.ai/partner-llm.txt**  \n(machine map: **https://asksoma.ai/partner-connect.json**). Repo source: `docs/PARTNER_API_LLM.md`.\n\n### Muhurat vs timing\n\n| Method | Meaning |\n|--------|---------|\n| `muhurat()` | **When to do X** — ranked electional windows (Good Timings) |\n| `timing()` | **When will X happen** — Phalita life-event bands |\n\nDo not merge these.\n\n## CLI usage\n\n```bash\nexport ASKSOMA_API_KEY=sk_live_...\nnpx asksoma muhurat --date 1994-08-19 --time 06:15 --lat 19.07 --lon 72.87 --tz 5.5 \\\n  --activity wedding --from 2026-08-01 --to 2026-09-30\nnpx asksoma catalog\nnpx asksoma daily --date 2026-07-24 --lat 28.6139 --lon 77.209 --tz 5.5\nnpx asksoma dasha --date 1990-05-15 --time 14:30 --lat 28.6139 --lon 77.209 --tz 5.5\nnpx asksoma help\n```\n\n## Determinism\n\nEvery brain response carries `meta.engine_version` and is computed with pinned\n**Lahiri ayanamsa + Placidus houses** — same inputs → same output.\n\n## MCP (alternative)\n\nAskSoma also exposes `find_muhurat`, `get_dasha`, `get_transits`, `get_composite_chart`\nat `https://api.asksoma.ai/mcp` — see `docs/PARTNER_API_CONNECT.md`.\n\n## Security\n\nNever put `sk_live_` keys in a browser. For embeds, proxy through your backend\n(see `packages/muhurat-embed` and `docs/PARTNER_API_EMBED.md`).\n","readmeFilename":"README.md"}