@rendobar/sdk 3.2.0 → 3.3.0

package/dist/index.cjs

@@ -61,10 +61,10 @@ const RETRYABLE_STATUS_CODES = new Set([
 	504
 ]);
 function createRequestFn(config) {
-	const { baseUrl = "https://api.rendobar.com", apiKey, accessToken, credentials, orgId, timeout = DEFAULT_TIMEOUT, maxRetries = DEFAULT_MAX_RETRIES, debug = false, fetch: fetchFn = globalThis.fetch } = config;
+	const { baseUrl = "https://api.rendobar.com", apiKey, accessToken, credentials, orgId, client = "sdk", timeout = DEFAULT_TIMEOUT, maxRetries = DEFAULT_MAX_RETRIES, debug = false, fetch: fetchFn = globalThis.fetch } = config;
 	return async function request(path, options = {}) {
 		const url = buildUrl(baseUrl, path, options.query);
-		const init = buildInit(options, apiKey, accessToken, credentials, orgId);
+		const init = buildInit(options, apiKey, accessToken, credentials, orgId, client);
 		const combinedSignal = combineSignals(options.signal, timeout);
 		let lastError;
 		for (let attempt = 0; attempt <= maxRetries; attempt++) {
@@ -109,11 +109,12 @@ function buildUrl(baseUrl, path, query) {
 	}
 	return url;
 }
-function buildInit(options, apiKey, accessToken, credentials, orgId) {
+function buildInit(options, apiKey, accessToken, credentials, orgId, client) {
 	const headers = { "Content-Type": "application/json" };
 	if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
 	else if (accessToken) headers["Authorization"] = `Bearer ${accessToken}`;
 	if (orgId) headers["X-Org-Id"] = orgId;
+	if (client) headers["X-Rendobar-Client"] = client;
 	const init = {
 		method: options.method ?? "GET",
 		headers
@@ -292,6 +293,12 @@ function createBillingResource(request) {
 				signal: options?.signal
 			});
 		},
+		async usageByClient(params, options) {
+			return request("/billing/usage-by-client", {
+				query: params,
+				signal: options?.signal
+			});
+		},
 		async transactions(params, options) {
 			return request("/billing/transactions", {
 				query: params,

package/dist/index.d.cts

@@ -2610,6 +2610,12 @@ declare const usageSummarySchema: ZodObject<{
     computeSeconds: ZodNumber;
   }, $strip>>;
 }, $strip>;
+declare const usageByClientSchema: ZodArray<ZodObject<{
+  client: ZodString;
+  jobCount: ZodNumber;
+  amountCharged: ZodNumber;
+  amountFormatted: ZodString;
+}, $strip>>;
 declare const webhookEndpointSchema: ZodObject<{
   id: ZodString;
   name: ZodString;
@@ -2812,6 +2818,7 @@ type JobType = output<typeof jobTypeSchema>;
 type BillingState = output<typeof billingStateSchema>;
 type Transaction = output<typeof transactionSchema>;
 type UsageSummary = output<typeof usageSummarySchema>;
+type UsageByClient = output<typeof usageByClientSchema>;
 type WebhookEndpoint = output<typeof webhookEndpointSchema>;
 type WebhookDelivery = output<typeof webhookDeliverySchema>;
 type Organization = output<typeof organizationSchema>;
@@ -2840,6 +2847,12 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
 }, $strip>, ZodObject<{
   type: ZodLiteral<"job.result">;
   jobId: ZodString;
+}, $strip>, ZodObject<{
+  type: ZodLiteral<"job.region_failover">;
+  jobId: ZodString;
+  fromRegion: ZodString;
+  toRegion: ZodString;
+  timestamp: ZodOptional<ZodNumber>;
 }, $strip>, ZodObject<{
   type: ZodLiteral<"balance.updated">;
   balance: ZodNumber;
@@ -3011,6 +3024,12 @@ interface ClientConfig {
   maxRetries?: number;
   /** Default org ID (sent as X-Org-Id header). */
   orgId?: string;
+  /**
+   * Client identifier sent as the X-Rendobar-Client header for usage
+   * attribution. Defaults to "sdk". Wrappers built on this SDK should override
+   * it (e.g. "cli", "n8n") so their traffic is attributed distinctly.
+   */
+  client?: string;
   /** Log request metadata to console.debug. Default: false */
   debug?: boolean;
   /** Custom fetch function for testing or special runtimes. */
@@ -3054,6 +3073,11 @@ declare function createClient(config?: ClientConfig): {
     usage(params?: UsageParams, options?: {
       signal?: AbortSignal;
     }): Promise<UsageSummary>;
+    usageByClient(params?: {
+      days?: number;
+    }, options?: {
+      signal?: AbortSignal;
+    }): Promise<UsageByClient>;
     transactions(params?: TransactionListParams, options?: {
       signal?: AbortSignal;
     }): Promise<{

package/dist/index.d.mts

@@ -2610,6 +2610,12 @@ declare const usageSummarySchema: ZodObject<{
     computeSeconds: ZodNumber;
   }, $strip>>;
 }, $strip>;
+declare const usageByClientSchema: ZodArray<ZodObject<{
+  client: ZodString;
+  jobCount: ZodNumber;
+  amountCharged: ZodNumber;
+  amountFormatted: ZodString;
+}, $strip>>;
 declare const webhookEndpointSchema: ZodObject<{
   id: ZodString;
   name: ZodString;
@@ -2812,6 +2818,7 @@ type JobType = output<typeof jobTypeSchema>;
 type BillingState = output<typeof billingStateSchema>;
 type Transaction = output<typeof transactionSchema>;
 type UsageSummary = output<typeof usageSummarySchema>;
+type UsageByClient = output<typeof usageByClientSchema>;
 type WebhookEndpoint = output<typeof webhookEndpointSchema>;
 type WebhookDelivery = output<typeof webhookDeliverySchema>;
 type Organization = output<typeof organizationSchema>;
@@ -2840,6 +2847,12 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
 }, $strip>, ZodObject<{
   type: ZodLiteral<"job.result">;
   jobId: ZodString;
+}, $strip>, ZodObject<{
+  type: ZodLiteral<"job.region_failover">;
+  jobId: ZodString;
+  fromRegion: ZodString;
+  toRegion: ZodString;
+  timestamp: ZodOptional<ZodNumber>;
 }, $strip>, ZodObject<{
   type: ZodLiteral<"balance.updated">;
   balance: ZodNumber;
@@ -3011,6 +3024,12 @@ interface ClientConfig {
   maxRetries?: number;
   /** Default org ID (sent as X-Org-Id header). */
   orgId?: string;
+  /**
+   * Client identifier sent as the X-Rendobar-Client header for usage
+   * attribution. Defaults to "sdk". Wrappers built on this SDK should override
+   * it (e.g. "cli", "n8n") so their traffic is attributed distinctly.
+   */
+  client?: string;
   /** Log request metadata to console.debug. Default: false */
   debug?: boolean;
   /** Custom fetch function for testing or special runtimes. */
@@ -3054,6 +3073,11 @@ declare function createClient(config?: ClientConfig): {
     usage(params?: UsageParams, options?: {
       signal?: AbortSignal;
     }): Promise<UsageSummary>;
+    usageByClient(params?: {
+      days?: number;
+    }, options?: {
+      signal?: AbortSignal;
+    }): Promise<UsageByClient>;
     transactions(params?: TransactionListParams, options?: {
       signal?: AbortSignal;
     }): Promise<{

package/dist/index.mjs

@@ -60,10 +60,10 @@ const RETRYABLE_STATUS_CODES = new Set([
 	504
 ]);
 function createRequestFn(config) {
-	const { baseUrl = "https://api.rendobar.com", apiKey, accessToken, credentials, orgId, timeout = DEFAULT_TIMEOUT, maxRetries = DEFAULT_MAX_RETRIES, debug = false, fetch: fetchFn = globalThis.fetch } = config;
+	const { baseUrl = "https://api.rendobar.com", apiKey, accessToken, credentials, orgId, client = "sdk", timeout = DEFAULT_TIMEOUT, maxRetries = DEFAULT_MAX_RETRIES, debug = false, fetch: fetchFn = globalThis.fetch } = config;
 	return async function request(path, options = {}) {
 		const url = buildUrl(baseUrl, path, options.query);
-		const init = buildInit(options, apiKey, accessToken, credentials, orgId);
+		const init = buildInit(options, apiKey, accessToken, credentials, orgId, client);
 		const combinedSignal = combineSignals(options.signal, timeout);
 		let lastError;
 		for (let attempt = 0; attempt <= maxRetries; attempt++) {
@@ -108,11 +108,12 @@ function buildUrl(baseUrl, path, query) {
 	}
 	return url;
 }
-function buildInit(options, apiKey, accessToken, credentials, orgId) {
+function buildInit(options, apiKey, accessToken, credentials, orgId, client) {
 	const headers = { "Content-Type": "application/json" };
 	if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
 	else if (accessToken) headers["Authorization"] = `Bearer ${accessToken}`;
 	if (orgId) headers["X-Org-Id"] = orgId;
+	if (client) headers["X-Rendobar-Client"] = client;
 	const init = {
 		method: options.method ?? "GET",
 		headers
@@ -291,6 +292,12 @@ function createBillingResource(request) {
 				signal: options?.signal
 			});
 		},
+		async usageByClient(params, options) {
+			return request("/billing/usage-by-client", {
+				query: params,
+				signal: options?.signal
+			});
+		},
 		async transactions(params, options) {
 			return request("/billing/transactions", {
 				query: params,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rendobar/sdk",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "type": "module",
   "description": "TypeScript client for the Rendobar media processing API",
   "main": "./dist/index.cjs",