@astroway/sdk 0.1.0-alpha.1

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+## 0.1.0-alpha.1 — 2026-05-09
+
+Initial alpha release. Public API may shift before `0.1.0` proper based on integrator feedback.
+
+### What's in the box
+
+- **Type-safe coverage of all 700+ AstroWay API endpoints** — paths, request bodies, and responses are auto-generated from the live OpenAPI 3.1 spec at build time.
+- **`Astroway` client** wrapping [`openapi-fetch`](https://openapi-ts.dev/openapi-fetch/) — `aw.client.POST('/chart', { body })` with full IDE autocomplete.
+- **Two auth schemes:** `X-Api-Key` (default, matches curl/Postman) or `Authorization: Bearer` (matches Stripe/OpenAI convention) via `authScheme: 'bearer'`.
+- **Stainless-template error hierarchy:** `ApiError` → `BadRequestError` / `AuthenticationError` / `PermissionDeniedError` / `NotFoundError` / `UnprocessableEntityError` / `RateLimitError` / `InternalServerError` / `APIConnectionError` (→ `APITimeoutError`).
+- **Built-in retry** with exponential backoff + full jitter on 408 / 409 / 429 / 5xx and connection errors. Default 2 retries; configurable per-request via `retry: { maxRetries: 0 }` to disable. Honors `Retry-After` headers on 429.
+- **Per-request timeout** via `AbortController`, default 30s.
+- **Identification headers** on every request — `User-Agent: astroway-sdk-typescript/<version> (Node/<node-version>)` and `X-Astroway-Channel: sdk-ts`. No telemetry, no phone-home.
+- **37 unit tests** covering error classification, retry semantics, header propagation, and auth scheme switching.
+- **OIDC + npm provenance + SLSA L3 attestation** in publish workflow.
+
+### Internal
+
+- ESM-only package. `type: "module"` in `package.json`. Targets Node 20+ (works in browsers too via global `fetch`).
+- TypeScript 5.7, `strict: true`, `exactOptionalPropertyTypes: true`, `noUncheckedIndexedAccess: true`.
+- Zero runtime dependencies apart from `openapi-fetch` (~6 KB minified).
+- Build pipeline: `npm run sync-spec` (fetch live spec) → `npm run generate` (openapi-typescript → `src/types.generated.ts`) → `tsc` (compile to `dist/`).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AstroWay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,222 @@
+# @astroway/sdk
+
+> Official TypeScript SDK for the [AstroWay API](https://api.astroway.info) — natal charts, synastry, transits, Vedic dashas, Tarot, Numerology, Human Design, AI horoscopes. Type-safe end to end, generated from the OpenAPI 3.1 spec.
+
+[![npm version](https://img.shields.io/npm/v/@astroway/sdk.svg?style=flat&color=blue)](https://www.npmjs.com/package/@astroway/sdk)
+[![npm downloads](https://img.shields.io/npm/dm/@astroway/sdk.svg?style=flat)](https://www.npmjs.com/package/@astroway/sdk)
+[![license: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+700+ endpoints. Path autocomplete + request/response types from your IDE. Built-in retry on 429/5xx with exponential backoff. Stainless-style error hierarchy (`AuthenticationError` / `RateLimitError` / `BadRequestError` / …). Zero-dep at runtime apart from [`openapi-fetch`](https://openapi-ts.dev/openapi-fetch/) (~6 KB).
+
+---
+
+## Install
+
+```bash
+npm install @astroway/sdk
+# or pnpm add @astroway/sdk
+# or yarn add @astroway/sdk
+```
+
+Get an API key at <https://api.astroway.info/dashboard/sign-up> — **10,000 credits/month free**, no card required. Each endpoint costs 5–500 credits depending on what it computes ([pricing](https://api.astroway.info/pricing/)).
+
+---
+
+## Quick start
+
+```ts
+import { Astroway } from '@astroway/sdk';
+
+const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });
+
+const { data, error } = await aw.client.POST('/chart', {
+  body: {
+    date: '1990-07-14',
+    time: '14:30:00',
+    timezoneOffset: 3,
+    latitude: 50.45,
+    longitude: 30.52,
+    houseSystem: 'P',
+  },
+});
+
+if (error) throw error;
+console.log(`ASC: ${data.data.angles.asc.sign} ${data.data.angles.asc.degree.toFixed(2)}°`);
+```
+
+`aw.client` is the typed [`openapi-fetch`](https://openapi-ts.dev/openapi-fetch/) instance — every endpoint, body, and response is autocompleted from the live OpenAPI spec. New endpoints appear on `npm install @astroway/sdk@latest` automatically.
+
+---
+
+## Common workflows
+
+### Natal chart
+
+```ts
+const { data } = await aw.client.POST('/chart', {
+  body: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
+});
+```
+
+### Synastry
+
+```ts
+const { data } = await aw.client.POST('/synastry', {
+  body: {
+    chart1: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
+    chart2: { date: '1992-03-22', time: '09:15:00', timezoneOffset: 2, latitude: 48.85, longitude: 2.35 },
+  },
+});
+console.log(`Score: ${data.data.compatibility.score}/100 (${data.data.compatibility.label})`);
+```
+
+### Transits to natal
+
+```ts
+const { data } = await aw.client.POST('/transits', {
+  body: {
+    date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52,
+    targetDate: '2027-01-01',
+  },
+});
+```
+
+### Vedic Vimshottari Mahadasha
+
+```ts
+const { data } = await aw.client.POST('/vedic/dashas/vimshottari/maha', {
+  body: { date: '1985-07-22', time: '06:45:00', timezoneOffset: 5.5, latitude: 19.07, longitude: 72.87 },
+});
+```
+
+### Tarot reading
+
+```ts
+const { data } = await aw.client.POST('/tarot/rider-waite/spread', {
+  body: { spreadType: 'three-card', seed: 42 },
+});
+```
+
+### Human Design
+
+```ts
+const { data } = await aw.client.POST('/human-design', {
+  body: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
+});
+console.log(`${data.data.type} — ${data.data.strategy} — ${data.data.authority}`);
+```
+
+---
+
+## Error handling
+
+The SDK throws typed subclasses of `ApiError`. Catch order matters — most specific first:
+
+```ts
+import { Astroway, ApiError, AuthenticationError, RateLimitError, BadRequestError } from '@astroway/sdk';
+
+try {
+  await aw.client.POST('/chart', { body });
+} catch (e) {
+  if (e instanceof RateLimitError) {
+    await new Promise(r => setTimeout(r, (e.retryAfterSeconds ?? 60) * 1000));
+    // retry once...
+  } else if (e instanceof AuthenticationError) {
+    throw new Error('Rotate your AstroWay API key');
+  } else if (e instanceof BadRequestError) {
+    console.error('Validation failed:', e.body);
+  } else if (e instanceof ApiError) {
+    console.error(`API error ${e.status} (${e.code}): ${e.message} [request_id=${e.requestId}]`);
+  }
+  throw e;
+}
+```
+
+Full hierarchy: `ApiError` → `APIConnectionError` (→ `APITimeoutError`), `BadRequestError` (400), `AuthenticationError` (401), `PermissionDeniedError` (403), `NotFoundError` (404), `UnprocessableEntityError` (422), `RateLimitError` (429), `InternalServerError` (5xx).
+
+---
+
+## Configuration
+
+```ts
+const aw = new Astroway({
+  apiKey: 'aw_live_...',                  // required
+  baseUrl: 'https://api.astroway.info/v1', // override for staging / self-hosted
+  authScheme: 'header',                    // 'header' (X-Api-Key, default) or 'bearer' (Authorization: Bearer)
+  timeoutMs: 30_000,                       // per-request timeout
+  retry: {
+    maxRetries: 2,                         // total attempts = 1 + maxRetries
+    baseDelayMs: 250,
+    maxDelayMs: 30_000,
+    retryableStatuses: new Set([408, 409, 429, 500, 502, 503, 504]),
+  },
+  fetch: globalThis.fetch,                 // custom fetch implementation
+  defaultHeaders: { 'X-Trace-Id': '...' },  // sent on every request
+});
+```
+
+The default retry honors `Retry-After` (seconds or HTTP-date) on 429 responses.
+
+---
+
+## Authentication
+
+The SDK supports two equivalent auth schemes — pick whichever your stack prefers:
+
+- **Header (default):** `X-Api-Key: aw_live_...` — same convention as `curl`/Postman examples.
+- **Bearer:** `Authorization: Bearer aw_live_...` — same convention as Stripe/OpenAI/Anthropic SDKs.
+
+Set via `authScheme: 'bearer'` in the constructor.
+
+---
+
+## TypeScript types
+
+All paths and bodies are derived from the live OpenAPI 3.1 spec at <https://api.astroway.info/v1/openapi.json>:
+
+```ts
+import type { paths, components } from '@astroway/sdk';
+
+type ChartBody = paths['/chart']['post']['requestBody']['content']['application/json'];
+type ChartResponse = paths['/chart']['post']['responses'][200]['content']['application/json'];
+```
+
+Path autocomplete and body validation work out of the box — no separate `@types` package needed.
+
+---
+
+## Privacy
+
+The SDK does **not** phone home. There is no telemetry, no analytics, no usage reporting. The only network traffic the SDK originates is the AstroWay API calls you ask it to make.
+
+Outgoing requests carry two identifying headers so the AstroWay backend can distinguish SDK traffic from raw HTTP traffic in its own logs:
+
+- `User-Agent: astroway-sdk-typescript/<version> (Node/<node-version>)`
+- `X-Astroway-Channel: sdk-ts`
+
+Neither carries a session ID, machine fingerprint, or anything personal.
+
+---
+
+## Stability
+
+- **Tool identifiers stable inside a major version.** Any path that ships under `1.x` won't be renamed or removed without a deprecation note in `CHANGELOG.md` and a one-minor parallel-availability window.
+- **Input shape stable inside a minor version.** Tightening (regex, range, enum) ships in patches; adding a required field requires a minor bump.
+- **API version vs SDK version are independent.** SDK `0.x` follows its own semver; the API itself sits at `/v1/`. Across `v1` → `v2` API any breaking change is announced.
+
+---
+
+## Links
+
+- 📦 npm: <https://www.npmjs.com/package/@astroway/sdk>
+- 📘 API docs: <https://api.astroway.info/docs/api/>
+- 🔑 Sign up & dashboard: <https://api.astroway.info/dashboard/>
+- 💰 Pricing: <https://api.astroway.info/pricing/>
+- 🤖 MCP server: [`@astroway/mcp`](https://www.npmjs.com/package/@astroway/mcp)
+- 🌐 Website: <https://astroway.info>
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/errors.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Error hierarchy mirroring the Stainless template (OpenAI / Anthropic / Cloudflare SDKs).
+ *
+ * Catch order recommendation in user code:
+ *   try { ... } catch (e) {
+ *     if (e instanceof RateLimitError) { ... await sleep ... }
+ *     else if (e instanceof AuthenticationError) { ... rotate key ... }
+ *     else if (e instanceof ApiError) { ... generic 4xx/5xx ... }
+ *     else throw e;
+ *   }
+ */
+interface ApiErrorInit {
+    status?: number;
+    code?: string;
+    body?: unknown;
+    requestId?: string;
+    cause?: unknown;
+}
+export declare class ApiError extends Error {
+    readonly name: string;
+    /** HTTP status code, when known. `undefined` for connection/timeout. */
+    readonly status?: number;
+    /** Server-provided error code (e.g. 'INVALID_KEY', 'OUT_OF_CREDITS'). */
+    readonly code?: string;
+    /** Raw response body (parsed if JSON). */
+    readonly body?: unknown;
+    /** AstroWay request ID, when present in `X-Request-Id` response header. */
+    readonly requestId?: string;
+    constructor(message: string, init?: ApiErrorInit);
+}
+export declare class APIConnectionError extends ApiError {
+    readonly name: string;
+}
+export declare class APITimeoutError extends APIConnectionError {
+    readonly name: string;
+}
+export declare class BadRequestError extends ApiError {
+    readonly name: string;
+}
+export declare class AuthenticationError extends ApiError {
+    readonly name: string;
+}
+export declare class PermissionDeniedError extends ApiError {
+    readonly name: string;
+}
+export declare class NotFoundError extends ApiError {
+    readonly name: string;
+}
+export declare class UnprocessableEntityError extends ApiError {
+    readonly name: string;
+}
+interface RateLimitErrorInit extends ApiErrorInit {
+    retryAfterSeconds?: number;
+}
+export declare class RateLimitError extends ApiError {
+    readonly name: string;
+    /** Suggested seconds to wait before retrying, from `Retry-After` or server hint. */
+    readonly retryAfterSeconds?: number;
+    constructor(message: string, init?: RateLimitErrorInit);
+}
+export declare class InternalServerError extends ApiError {
+    readonly name: string;
+}
+interface ClassifyArgs {
+    status: number;
+    code?: string;
+    message: string;
+    body?: unknown;
+    requestId?: string;
+    retryAfterSeconds?: number;
+}
+/**
+ * Maps an HTTP status + optional server error code to the most specific
+ * subclass. Used by the openapi-fetch error path.
+ */
+export declare function classifyHttpError(args: ClassifyArgs): ApiError;
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAkB,IAAI,EAAE,MAAM,CAAc;IAC5C,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY;CAOjD;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAkB,IAAI,EAAE,MAAM,CAAwB;CACvD;AAED,qBAAa,eAAgB,SAAQ,kBAAkB;IACrD,SAAkB,IAAI,EAAE,MAAM,CAAqB;CACpD;AAED,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,SAAkB,IAAI,EAAE,MAAM,CAAqB;CACpD;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,SAAkB,IAAI,EAAE,MAAM,CAAyB;CACxD;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;IACjD,SAAkB,IAAI,EAAE,MAAM,CAA2B;CAC1D;AAED,qBAAa,aAAc,SAAQ,QAAQ;IACzC,SAAkB,IAAI,EAAE,MAAM,CAAmB;CAClD;AAED,qBAAa,wBAAyB,SAAQ,QAAQ;IACpD,SAAkB,IAAI,EAAE,MAAM,CAA8B;CAC7D;AAED,UAAU,kBAAmB,SAAQ,YAAY;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,SAAkB,IAAI,EAAE,MAAM,CAAoB;IAClD,oFAAoF;IACpF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB;CAIvD;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,SAAkB,IAAI,EAAE,MAAM,CAAyB;CACxD;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAoB9D"}

package/dist/errors.js

@@ -0,0 +1,98 @@
+/**
+ * Error hierarchy mirroring the Stainless template (OpenAI / Anthropic / Cloudflare SDKs).
+ *
+ * Catch order recommendation in user code:
+ *   try { ... } catch (e) {
+ *     if (e instanceof RateLimitError) { ... await sleep ... }
+ *     else if (e instanceof AuthenticationError) { ... rotate key ... }
+ *     else if (e instanceof ApiError) { ... generic 4xx/5xx ... }
+ *     else throw e;
+ *   }
+ */
+export class ApiError extends Error {
+    name = 'ApiError';
+    /** HTTP status code, when known. `undefined` for connection/timeout. */
+    status;
+    /** Server-provided error code (e.g. 'INVALID_KEY', 'OUT_OF_CREDITS'). */
+    code;
+    /** Raw response body (parsed if JSON). */
+    body;
+    /** AstroWay request ID, when present in `X-Request-Id` response header. */
+    requestId;
+    constructor(message, init) {
+        super(message, init?.cause !== undefined ? { cause: init.cause } : undefined);
+        if (init?.status !== undefined)
+            this.status = init.status;
+        if (init?.code !== undefined)
+            this.code = init.code;
+        if (init?.body !== undefined)
+            this.body = init.body;
+        if (init?.requestId !== undefined)
+            this.requestId = init.requestId;
+    }
+}
+export class APIConnectionError extends ApiError {
+    name = 'APIConnectionError';
+}
+export class APITimeoutError extends APIConnectionError {
+    name = 'APITimeoutError';
+}
+export class BadRequestError extends ApiError {
+    name = 'BadRequestError';
+}
+export class AuthenticationError extends ApiError {
+    name = 'AuthenticationError';
+}
+export class PermissionDeniedError extends ApiError {
+    name = 'PermissionDeniedError';
+}
+export class NotFoundError extends ApiError {
+    name = 'NotFoundError';
+}
+export class UnprocessableEntityError extends ApiError {
+    name = 'UnprocessableEntityError';
+}
+export class RateLimitError extends ApiError {
+    name = 'RateLimitError';
+    /** Suggested seconds to wait before retrying, from `Retry-After` or server hint. */
+    retryAfterSeconds;
+    constructor(message, init) {
+        super(message, init);
+        if (init?.retryAfterSeconds !== undefined)
+            this.retryAfterSeconds = init.retryAfterSeconds;
+    }
+}
+export class InternalServerError extends ApiError {
+    name = 'InternalServerError';
+}
+/**
+ * Maps an HTTP status + optional server error code to the most specific
+ * subclass. Used by the openapi-fetch error path.
+ */
+export function classifyHttpError(args) {
+    const { status, code, message, body, requestId, retryAfterSeconds } = args;
+    const init = { status };
+    if (code !== undefined)
+        init.code = code;
+    if (body !== undefined)
+        init.body = body;
+    if (requestId !== undefined)
+        init.requestId = requestId;
+    switch (status) {
+        case 400: return new BadRequestError(message, init);
+        case 401: return new AuthenticationError(message, init);
+        case 403: return new PermissionDeniedError(message, init);
+        case 404: return new NotFoundError(message, init);
+        case 422: return new UnprocessableEntityError(message, init);
+        case 429: {
+            const rlInit = { ...init };
+            if (retryAfterSeconds !== undefined)
+                rlInit.retryAfterSeconds = retryAfterSeconds;
+            return new RateLimitError(message, rlInit);
+        }
+    }
+    if (status >= 500)
+        return new InternalServerError(message, init);
+    return new ApiError(message, init);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @astroway/sdk — Official TypeScript SDK for the AstroWay API.
+ *
+ * Usage:
+ *   import { Astroway } from '@astroway/sdk';
+ *   const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });
+ *   const { data, error } = await aw.POST('/chart', {
+ *     body: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
+ *   });
+ *
+ * Types come from the live OpenAPI 3.1 spec at build time. Error semantics
+ * mirror Stainless / OpenAI / Cloudflare SDKs — see ./errors.
+ */
+import createClient from 'openapi-fetch';
+import type { paths } from './types.generated.js';
+import { type RetryOptions } from './retry.js';
+export * from './errors.js';
+export type { paths, components, operations } from './types.generated.js';
+export interface AstrowayOptions {
+    /** API key — `aw_live_...` for production, `aw_test_...` for sandbox. Required. */
+    apiKey: string;
+    /** Override base URL — useful for staging or self-hosted. Default `https://api.astroway.info/v1`. */
+    baseUrl?: string;
+    /** Auth scheme. `header` (default) sends `X-Api-Key: <key>`. `bearer` sends `Authorization: Bearer <key>`. */
+    authScheme?: 'header' | 'bearer';
+    /** Per-request timeout in ms. Default 30_000. */
+    timeoutMs?: number;
+    /** Retry configuration. Default 2 retries, exp backoff, on 408/409/429/5xx/connection. Set `{ maxRetries: 0 }` to disable. */
+    retry?: RetryOptions;
+    /** Optional custom `fetch` implementation. Default — global `fetch`. */
+    fetch?: typeof globalThis.fetch;
+    /** Extra headers added to every request. */
+    defaultHeaders?: Record<string, string>;
+}
+/**
+ * Type-safe AstroWay client. Methods (`GET`, `POST`, `PUT`, `DELETE`) and
+ * paths come straight from `openapi-fetch` — see https://openapi-ts.dev/openapi-fetch/
+ * for the full API. Path autocomplete and request/response typing work out
+ * of the box.
+ */
+export type AstrowayClient = ReturnType<typeof createClient<paths>>;
+/**
+ * Creates a new AstroWay client. Equivalent to `new Astroway(...)` for
+ * users who prefer the factory style.
+ */
+export declare function createAstroway(options: AstrowayOptions): AstrowayClient;
+export declare class Astroway {
+    /** The underlying typed openapi-fetch client. */
+    readonly client: AstrowayClient;
+    readonly options: Required<Omit<AstrowayOptions, 'fetch' | 'defaultHeaders' | 'retry'>> & {
+        fetch: typeof globalThis.fetch;
+        defaultHeaders: Record<string, string>;
+        retry: RetryOptions;
+    };
+    constructor(options: AstrowayOptions);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,YAAoC,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAOlD,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/D,cAAc,aAAa,CAAC;AAC5B,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAI1E,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,qGAAqG;IACrG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8GAA8G;IAC9G,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACjC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8HAA8H;IAC9H,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,4CAA4C;IAC5C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAEvE;AAED,qBAAa,QAAQ;IACnB,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,GAAG,gBAAgB,GAAG,OAAO,CAAC,CAAC,GAAG;QACxF,KAAK,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;QAC/B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,KAAK,EAAE,YAAY,CAAC;KACrB,CAAC;gBAEU,OAAO,EAAE,eAAe;CAkErC"}

package/dist/index.js

@@ -0,0 +1,122 @@
+/**
+ * @astroway/sdk — Official TypeScript SDK for the AstroWay API.
+ *
+ * Usage:
+ *   import { Astroway } from '@astroway/sdk';
+ *   const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });
+ *   const { data, error } = await aw.POST('/chart', {
+ *     body: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
+ *   });
+ *
+ * Types come from the live OpenAPI 3.1 spec at build time. Error semantics
+ * mirror Stainless / OpenAI / Cloudflare SDKs — see ./errors.
+ */
+import createClient from 'openapi-fetch';
+import { ApiError, APIConnectionError, APITimeoutError, classifyHttpError, } from './errors.js';
+import { fetchWithRetry } from './retry.js';
+import { SDK_VERSION } from './version.js';
+export * from './errors.js';
+const DEFAULT_BASE_URL = 'https://api.astroway.info/v1';
+/**
+ * Creates a new AstroWay client. Equivalent to `new Astroway(...)` for
+ * users who prefer the factory style.
+ */
+export function createAstroway(options) {
+    return new Astroway(options).client;
+}
+export class Astroway {
+    /** The underlying typed openapi-fetch client. */
+    client;
+    options;
+    constructor(options) {
+        if (!options.apiKey) {
+            throw new ApiError('AstroWay SDK: apiKey is required. Get one at https://api.astroway.info/dashboard/sign-up — 10,000 credits/month free.');
+        }
+        const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        const authScheme = options.authScheme ?? 'header';
+        const timeoutMs = options.timeoutMs ?? 30_000;
+        const retry = options.retry ?? {};
+        const fetchImpl = options.fetch ?? globalThis.fetch;
+        const defaultHeaders = options.defaultHeaders ?? {};
+        this.options = {
+            apiKey: options.apiKey,
+            baseUrl,
+            authScheme,
+            timeoutMs,
+            retry,
+            fetch: fetchImpl,
+            defaultHeaders,
+        };
+        const authHeaders = authScheme === 'bearer'
+            ? { Authorization: `Bearer ${options.apiKey}` }
+            : { 'X-Api-Key': options.apiKey };
+        const userAgent = `astroway-sdk-typescript/${SDK_VERSION} (Node/${typeof process !== 'undefined' ? process.versions.node : 'unknown'})`;
+        const clientOpts = {
+            baseUrl,
+            headers: {
+                ...authHeaders,
+                'User-Agent': userAgent,
+                'X-Astroway-Channel': 'sdk-ts',
+                ...defaultHeaders,
+            },
+            fetch: async (input) => {
+                const controller = new AbortController();
+                const timer = setTimeout(() => controller.abort(), timeoutMs);
+                const reqInit = { signal: controller.signal };
+                try {
+                    const res = await fetchWithRetry(() => fetchImpl(input, reqInit), retry);
+                    await throwOnApiError(res);
+                    return res;
+                }
+                catch (e) {
+                    if (e instanceof ApiError)
+                        throw e;
+                    if (e?.name === 'AbortError') {
+                        throw new APITimeoutError(`Request to ${input.url} timed out after ${timeoutMs}ms`, { cause: e });
+                    }
+                    throw new APIConnectionError(`Network error calling ${input.url}: ${e?.message ?? 'unknown'}. Check your connection or baseUrl.`, { cause: e });
+                }
+                finally {
+                    clearTimeout(timer);
+                }
+            },
+        };
+        this.client = createClient(clientOpts);
+    }
+}
+/**
+ * Re-throws non-2xx responses as the appropriate error subclass.
+ * Body is consumed once and re-attached as a Response clone so the caller
+ * still sees `.json()`/`.text()` semantics if it inspects the original.
+ */
+async function throwOnApiError(res) {
+    if (res.ok)
+        return;
+    const requestId = res.headers.get('x-request-id') ?? undefined;
+    const retryAfter = res.headers.get('retry-after');
+    const retryAfterSeconds = retryAfter && !Number.isNaN(Number(retryAfter)) ? Number(retryAfter) : undefined;
+    let body;
+    let code;
+    let message = `${res.status} ${res.statusText}`;
+    try {
+        const cloned = res.clone();
+        body = await cloned.json();
+        const err = body.error;
+        if (err?.code)
+            code = err.code;
+        if (err?.message)
+            message = err.message;
+    }
+    catch {
+        // Body wasn't JSON — keep the status-line message.
+    }
+    throw classifyHttpError({
+        status: res.status,
+        ...(code !== undefined ? { code } : {}),
+        message,
+        body,
+        ...(requestId !== undefined ? { requestId } : {}),
+        ...(retryAfterSeconds !== undefined ? { retryAfterSeconds } : {}),
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}