@proxyrequest/sdk 2.0.0 → 3.0.1

package/CHANGELOG.md

@@ -4,6 +4,27 @@ All notable changes to this project are documented here. The format follows [Kee
 
 ## [Unreleased]
 
+## [3.0.1] - 2026-09-21
+
+- Bundle openapi-fetch to fix client construction in CommonJS builds.
+- Verify actual feed requests and exact IDs in installed ESM and CommonJS packages.
+- Supersede the GitHub-only 3.0.0 build; npm publication of 3.0.0 was blocked by registry authorization.
+
+## [3.0.0] - 2026-09-21
+
+- Keep the exported `SDK_VERSION` synchronized with the package version and verify it in the package smoke test.
+
+- Synchronize the public OpenAPI contract from backend commit `2c4505a`.
+- Accept Unix seconds and all documented date strings while preserving existing date inputs.
+- Keep the legacy logs hostname argument and existing response contracts.
+- Cover feed/domains pagination, nullable feed timestamps, and UInt64 IDs with regression tests.
+- **Breaking:** return every feed ID as an exact decimal string; see [migration notes](docs/analytics.md).
+
+## [2.1.0] - 2026-09-17
+
+- Add atomic per-package data reset with typed requests, response metadata, and idempotent retries.
+- Refresh the public API contract and document root balances versus child allocations.
+
 ## [2.0.0] - 2026-09-16
 
 ### Changed

package/README.md

@@ -7,6 +7,9 @@
 
 The official TypeScript SDK for the [ProxyRequest public API](https://proxyrequest.com/docs/api/). It provides a typed, promise-based client for Node.js 22+ and modern browsers, with both ESM and CommonJS builds.
 
+See [analytics formats and compatibility](docs/analytics.md) for Unix timestamps,
+reporting windows, and feed identifiers.
+
 ## What is ProxyRequest?
 
 [ProxyRequest](https://proxyrequest.com/) is the control plane for operating a white-label proxy platform. It connects the commercial and operational pieces that a proxy provider or reseller would otherwise have to build separately:
@@ -84,8 +87,8 @@ Never embed a Static API key or webhook secret in frontend JavaScript. Browser s
 
 ## Resource API
 
-The client exposes 79 supported operations through 17 resource groups. The pinned
-public schema contains 81 operations; the disabled `sessions_list` and
+The client exposes 80 supported operations through 17 resource groups. The pinned
+public schema contains 82 operations; the disabled `sessions_list` and
 `sessions_destroy` operations are intentionally excluded from the SDK. Sticky
 session options in proxy generation remain supported.
 
@@ -351,3 +354,19 @@ The repository also has a real Chromium smoke test via `npm run test:browser`.
 ## License
 
 [MIT](LICENSE)
+
+## Reset remaining data (SDK 2.1.0+)
+
+```typescript
+const order = await client.users.resetData({
+  id: userId,
+  body: { package_id: packageId },
+  idempotencyKey: resetOperationId,
+});
+```
+
+Send only `package_id`, without `data`. A system administrator can reset any user; other accounts can reset only their direct children. The server atomically clears positive, zero, or negative remaining data for a finite package and returns the updated order. Unlimited packages are rejected. Root orders lose their remaining ledger balances; child orders lose their remaining quota without changing the parent pool. Usage history and invoices are preserved.
+
+Persist one operation ID and reuse it when retrying the same reset, including after a process restart. This prevents a repeated request from clearing a later top-up. Use subtraction when an explicit amount should be removed from a child quota. The backend must support the reset endpoint before calling it.
+
+Version 2.1 retains legacy user and invoice models from 2.0 for compatibility with older deployments. These compatibility types do not change the current public API contract.