@proxyrequest/sdk 4.0.0 → 4.1.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project uses [Semantic Versioning](https://semver.org/).
 
+## 4.1.0 (2026-09-25)
+
+- Add provider data balances with typed pagination, byte strings, calculation status, and checkpoint history. Access requires a superuser JWT or a superuser-owned API key.
+- Add optional `include_asns` to country, region, and city methods. Request `true` to include nested ASNs; the current API returns empty nested ASN arrays by default.
+- Preserve existing public methods and argument compatibility, and regenerate SDK reference documentation from the latest public API contract.
+
 ## [Unreleased]
 
 ## [4.0.0] - 2026-09-22

package/README.md

@@ -87,8 +87,8 @@ Never embed a Static API key or webhook secret in frontend JavaScript. Browser s
 
 ## Resource API
 
-The client exposes 80 supported operations through 17 resource groups. The pinned
-public schema contains 82 operations; the disabled `sessions_list` and
+The client exposes 81 supported operations through 18 resource groups. The pinned
+public schema contains 83 operations; the disabled `sessions_list` and
 `sessions_destroy` operations are intentionally excluded from the SDK. Sticky
 session options in proxy generation remain supported.
 
@@ -107,6 +107,7 @@ client.news;
 client.orders;
 client.packages;
 client.profile;
+client.providers;
 client.proxies;
 client.rewards;
 client.settings;
@@ -312,7 +313,7 @@ It reuses base URL, authentication, language, timeout, cancellation, and `ApiErr
 
 ## Types and generated code
 
-All 127 OpenAPI model types are exported from both the package root and `@proxyrequest/sdk/models`:
+All public OpenAPI model types are exported from both the package root and `@proxyrequest/sdk/models`:
 
 ```ts
 import type { User, InvoiceCreateRequestRequest } from "@proxyrequest/sdk/models";
@@ -370,3 +371,18 @@ Send only `package_id`, without `data`. A system administrator can reset any use
 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.
+
+## Provider data balances
+
+Available since 4.1.0. Authenticate with a superuser JWT or an API key owned by an active superuser.
+
+```ts
+const page = await client.providers.listDataBalances({ limit: 20 });
+for (const balance of page.results) {
+  console.log(balance.provider_name, balance.remaining_bytes, balance.history);
+}
+```
+
+Provider byte amounts are exact decimal **strings**, including history entries; calculated usage and remaining amounts can be `null`. The response includes observation and calculation times, freshness, errors, and recent checkpoint history. History is limited by the server's `PROVIDER_DATA_BALANCE_HISTORY_LIMIT` setting (default 10). Standard pagination applies to providers.
+
+Country, region, and city methods also support `includeAsns`. Set it to `true` to populate nested ASN arrays; omitted or false uses the API's empty-array default.

package/dist/index.cjs

@@ -1813,6 +1813,7 @@ var LocationsResource = class {
 			query: {
 				code: options.code,
 				country__code: options.countryCode,
+				include_asns: options.includeAsns,
 				limit: options.limit,
 				name: options.name,
 				offset: options.offset,
@@ -1837,7 +1838,10 @@ var LocationsResource = class {
 			path: "/locations/cities/{id}"
 		}, {
 			path: { id: options.id },
-			query: { package_id: options.packageId },
+			query: {
+				include_asns: options.includeAsns,
+				package_id: options.packageId
+			},
 			headers: { "Accept-Language": options.acceptLanguage },
 			...options.request === void 0 ? {} : { request: options.request }
 		});
@@ -1896,6 +1900,7 @@ var LocationsResource = class {
 		}, {
 			query: {
 				code: options.code,
+				include_asns: options.includeAsns,
 				limit: options.limit,
 				name: options.name,
 				offset: options.offset,
@@ -1919,7 +1924,10 @@ var LocationsResource = class {
 			path: "/locations/countries/{id}"
 		}, {
 			path: { id: options.id },
-			query: { package_id: options.packageId },
+			query: {
+				include_asns: options.includeAsns,
+				package_id: options.packageId
+			},
 			headers: { "Accept-Language": options.acceptLanguage },
 			...options.request === void 0 ? {} : { request: options.request }
 		});
@@ -1963,6 +1971,7 @@ var LocationsResource = class {
 			query: {
 				code: options.code,
 				country__code: options.countryCode,
+				include_asns: options.includeAsns,
 				limit: options.limit,
 				name: options.name,
 				offset: options.offset,
@@ -1986,7 +1995,10 @@ var LocationsResource = class {
 			path: "/locations/regions/{id}"
 		}, {
 			path: { id: options.id },
-			query: { package_id: options.packageId },
+			query: {
+				include_asns: options.includeAsns,
+				package_id: options.packageId
+			},
 			headers: { "Accept-Language": options.acceptLanguage },
 			...options.request === void 0 ? {} : { request: options.request }
 		});
@@ -2314,6 +2326,31 @@ var ProfileResource = class {
 		});
 	}
 };
+var ProvidersResource = class {
+	#client;
+	constructor(client) {
+		this.#client = client;
+	}
+	/** List provider data balances */
+	async listDataBalances(options = {}) {
+		return (await this.listDataBalancesWithResponse(options)).data;
+	}
+	/** List provider data balances; include response metadata. */
+	async listDataBalancesWithResponse(options = {}) {
+		return this.#client._callWithResponse({
+			operationId: "providers_data_balances_list",
+			method: "GET",
+			path: "/providers/data-balances"
+		}, {
+			query: {
+				limit: options.limit,
+				offset: options.offset
+			},
+			headers: { "Accept-Language": options.acceptLanguage },
+			...options.request === void 0 ? {} : { request: options.request }
+		});
+	}
+};
 var ProxiesResource = class {
 	#client;
 	constructor(client) {
@@ -2776,6 +2813,7 @@ function createResourceCollection(client) {
 		orders: new OrdersResource(client),
 		packages: new PackagesResource(client),
 		profile: new ProfileResource(client),
+		providers: new ProvidersResource(client),
 		proxies: new ProxiesResource(client),
 		rewards: new RewardsResource(client),
 		settings: new SettingsResource(client),
@@ -2823,7 +2861,7 @@ function offsetFromUrl(url) {
 //#endregion
 //#region src/client.ts
 const DEFAULT_BASE_URL = "https://api.proxyrequest.com/api/v1";
-const SDK_VERSION = "4.0.0";
+const SDK_VERSION = "4.1.0";
 var ProxyRequestClient = class ProxyRequestClient {
 	apiKeys;
 	affiliates;
@@ -2836,6 +2874,7 @@ var ProxyRequestClient = class ProxyRequestClient {
 	orders;
 	packages;
 	profile;
+	providers;
 	proxies;
 	rewards;
 	settings;
@@ -2886,6 +2925,7 @@ var ProxyRequestClient = class ProxyRequestClient {
 		this.orders = resources.orders;
 		this.packages = resources.packages;
 		this.profile = resources.profile;
+		this.providers = resources.providers;
 		this.proxies = resources.proxies;
 		this.rewards = resources.rewards;
 		this.settings = resources.settings;
@@ -3129,6 +3169,7 @@ exports.OrdersResource = OrdersResource;
 exports.PackagesResource = PackagesResource;
 exports.PaginationError = PaginationError;
 exports.ProfileResource = ProfileResource;
+exports.ProvidersResource = ProvidersResource;
 exports.ProxiesResource = ProxiesResource;
 exports.ProxyRequestClient = ProxyRequestClient;
 exports.ProxyRequestError = ProxyRequestError;