@proxyrequest/sdk 2.0.0 → 2.1.0

package/CHANGELOG.md

@@ -4,6 +4,15 @@ All notable changes to this project are documented here. The format follows [Kee
 
 ## [Unreleased]
 
+### Fixed
+
+- Keep the exported `SDK_VERSION` synchronized with the package version and verify it in the package smoke test.
+
+## [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

@@ -84,8 +84,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 +351,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.

package/dist/index.cjs

@@ -924,11 +924,11 @@ var LocationsResource = class {
 		this.#client = client;
 	}
 	/** List available autonomous systems */
-	async listAsns(options = {}) {
+	async listAsns(options) {
 		return (await this.listAsnsWithResponse(options)).data;
 	}
 	/** List available autonomous systems; include response metadata. */
-	async listAsnsWithResponse(options = {}) {
+	async listAsnsWithResponse(options) {
 		return this.#client._callWithResponse({
 			operationId: "locations_asn_list",
 			method: "GET",
@@ -950,11 +950,11 @@ var LocationsResource = class {
 		});
 	}
 	/** List available cities */
-	async listCities(options = {}) {
+	async listCities(options) {
 		return (await this.listCitiesWithResponse(options)).data;
 	}
 	/** List available cities; include response metadata. */
-	async listCitiesWithResponse(options = {}) {
+	async listCitiesWithResponse(options) {
 		return this.#client._callWithResponse({
 			operationId: "locations_cities_list",
 			method: "GET",
@@ -987,16 +987,17 @@ var LocationsResource = class {
 			path: "/locations/cities/{id}"
 		}, {
 			path: { id: options.id },
+			query: { package_id: options.packageId },
 			headers: { "Accept-Language": options.acceptLanguage },
 			...options.request === void 0 ? {} : { request: options.request }
 		});
 	}
 	/** List available continents */
-	async listContinents(options = {}) {
+	async listContinents(options) {
 		return (await this.listContinentsWithResponse(options)).data;
 	}
 	/** List available continents; include response metadata. */
-	async listContinentsWithResponse(options = {}) {
+	async listContinentsWithResponse(options) {
 		return this.#client._callWithResponse({
 			operationId: "locations_continents_list",
 			method: "GET",
@@ -1027,16 +1028,17 @@ var LocationsResource = class {
 			path: "/locations/continents/{id}"
 		}, {
 			path: { id: options.id },
+			query: { package_id: options.packageId },
 			headers: { "Accept-Language": options.acceptLanguage },
 			...options.request === void 0 ? {} : { request: options.request }
 		});
 	}
 	/** List available countries */
-	async listCountries(options = {}) {
+	async listCountries(options) {
 		return (await this.listCountriesWithResponse(options)).data;
 	}
 	/** List available countries; include response metadata. */
-	async listCountriesWithResponse(options = {}) {
+	async listCountriesWithResponse(options) {
 		return this.#client._callWithResponse({
 			operationId: "locations_countries_list",
 			method: "GET",
@@ -1067,16 +1069,17 @@ var LocationsResource = class {
 			path: "/locations/countries/{id}"
 		}, {
 			path: { id: options.id },
+			query: { package_id: options.packageId },
 			headers: { "Accept-Language": options.acceptLanguage },
 			...options.request === void 0 ? {} : { request: options.request }
 		});
 	}
 	/** List available internet service providers */
-	async listIsps(options = {}) {
+	async listIsps(options) {
 		return (await this.listIspsWithResponse(options)).data;
 	}
 	/** List available internet service providers; include response metadata. */
-	async listIspsWithResponse(options = {}) {
+	async listIspsWithResponse(options) {
 		return this.#client._callWithResponse({
 			operationId: "locations_isps_list",
 			method: "GET",
@@ -1097,11 +1100,11 @@ var LocationsResource = class {
 		});
 	}
 	/** List available regions */
-	async listRegions(options = {}) {
+	async listRegions(options) {
 		return (await this.listRegionsWithResponse(options)).data;
 	}
 	/** List available regions; include response metadata. */
-	async listRegionsWithResponse(options = {}) {
+	async listRegionsWithResponse(options) {
 		return this.#client._callWithResponse({
 			operationId: "locations_regions_list",
 			method: "GET",
@@ -1133,6 +1136,7 @@ var LocationsResource = class {
 			path: "/locations/regions/{id}"
 		}, {
 			path: { id: options.id },
+			query: { package_id: options.packageId },
 			headers: { "Accept-Language": options.acceptLanguage },
 			...options.request === void 0 ? {} : { request: options.request }
 		});
@@ -1645,11 +1649,11 @@ var UsersResource = class {
 			...options.request === void 0 ? {} : { request: options.request }
 		});
 	}
-	/** Create a sub-user */
+	/** Create a customer account */
 	async create(options) {
 		return (await this.createWithResponse(options)).data;
 	}
-	/** Create a sub-user; include response metadata. */
+	/** Create a customer account; include response metadata. */
 	async createWithResponse(options) {
 		return this.#client._callWithResponse({
 			operationId: "users_create",
@@ -1764,6 +1768,27 @@ var UsersResource = class {
 			...options.request === void 0 ? {} : { request: options.request }
 		});
 	}
+	/** Reset a user's remaining data */
+	async resetData(options) {
+		return (await this.resetDataWithResponse(options)).data;
+	}
+	/** Reset a user's remaining data; include response metadata. */
+	async resetDataWithResponse(options) {
+		return this.#client._callWithResponse({
+			operationId: "users_data_reset_create",
+			method: "POST",
+			path: "/users/{id}/data/reset",
+			idempotent: true
+		}, {
+			path: { id: options.id },
+			headers: {
+				"Idempotency-Key": options.idempotencyKey,
+				"Accept-Language": options.acceptLanguage
+			},
+			body: options.body,
+			...options.request === void 0 ? {} : { request: options.request }
+		});
+	}
 	/** List a sub-user's orders */
 	async listOrders(options) {
 		return (await this.listOrdersWithResponse(options)).data;
@@ -1801,7 +1826,7 @@ var UsersResource = class {
 		}, {
 			path: { id: options.id },
 			headers: { "Accept-Language": options.acceptLanguage },
-			...options.body === void 0 ? {} : { body: options.body },
+			body: options.body,
 			...options.request === void 0 ? {} : { request: options.request }
 		});
 	}
@@ -1948,7 +1973,7 @@ function offsetFromUrl(url) {
 //#endregion
 //#region src/client.ts
 const DEFAULT_BASE_URL = "https://api.proxyrequest.com/api/v1";
-const SDK_VERSION = "1.0.0";
+const SDK_VERSION = "2.1.0";
 var ProxyRequestClient = class ProxyRequestClient {
 	apiKeys;
 	affiliates;