@astroway/sdk 0.1.0 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 1.0.0 — 2026-05-11
+
+**Production guarantee.** Public API stable, SemVer commitment. Same code as `0.1.0` — every export, namespace, error class, helper, option ships unchanged. The major bump reflects engine drop and contractual commitment, not surface change.
+
+### Changed
+
+- **Node 22 minimum.** Dropped Node 20 — Node 22 has been LTS since 2024-10-29, the v20 LTS line entered maintenance mode 2025-10-21. CI matrix drops 20.
+  - If you still need Node 20: pin to `@astroway/sdk@^0.1.0` (the `0.1.x` line will receive critical security patches).
+- **SemVer commitment in README** — removing or narrowing public exports requires `2.0.0`.
+
+### Locked (same as 0.1.0, now contractual)
+
+103 typed namespaces / 623 methods. 12-class error hierarchy. Constructor + `CallOptions` shapes. Cache (`MemoryStore`, `LocalStorageStore`). Streaming (`aw.streamSSE()`). Mock (`MockAstroway` from `/testing`). Helpers (`BirthDateTime` from `/helpers`). Connection pooling (`dispatcher`).
+
+### Migration from 0.1.x
+
+`npm install @astroway/sdk@1.0.0` is a drop-in upgrade **if you're on Node 22+**. No code changes needed.
+
+### Verification
+
+141 vitest tests pass (same suite as 0.1.0).
+
 ## 0.1.0 — 2026-05-11
 
 **Stable surface commitment.** Public API frozen — every export shipped across alphas / betas / RCs is now part of the `0.1.x` contract. No code changes vs `0.1.0-rc.2` — same `Astroway` constructor, same 103 namespaces / 623 methods, same error hierarchy, same helpers / cache / streaming / mock / dispatcher / timeout surface. Ready to be depended on.

package/README.md

@@ -214,9 +214,13 @@ Neither carries a session ID, machine fingerprint, or anything personal.
 
 ## Stability
 
+Since **`1.0.0` (2026-05-11)** this package follows strict SemVer:
+
+- **Public exports won't be removed or narrowed in `1.x`.** Doing so requires a `2.0.0` major bump with a deprecation period covering at least one minor.
 - **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.
+- **API version vs SDK version are independent.** SDK `1.x` follows its own semver; the API itself sits at `/v1/`. Across `v1` → `v2` API any breaking change is announced.
+- **Node 22+ required** since `1.0.0`. Need Node 20? Stay on `0.1.x` (will receive critical security patches).
 
 ### Migration from `0.1.0-alpha.x` / `0.1.0-beta.x` / `0.1.0-rc.x` to `0.1.0`
 

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Auto-injected from package.json at build time. Update via npm version <bump>. */
-export declare const SDK_VERSION = "0.1.0";
+export declare const SDK_VERSION = "1.0.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** Auto-injected from package.json at build time. Update via npm version <bump>. */
-export const SDK_VERSION = '0.1.0';
+export const SDK_VERSION = '1.0.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astroway/sdk",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "Official TypeScript SDK for the AstroWay API — natal, synastry, transits, Vedic, Human Design, Tarot, Numerology, AI horoscopes. Type-safe, retry-aware, OpenAPI 3.1 generated.",
   "type": "module",
   "main": "./dist/index.js",
@@ -72,7 +72,7 @@
   },
   "homepage": "https://api.astroway.info/docs/",
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "publishConfig": {
     "access": "public",