@rendobar/sdk 3.1.0 → 3.3.0

package/dist/index.cjs

@@ -18,6 +18,32 @@ var ApiError = class extends Error {
 function isApiError(error) {
 	return error instanceof ApiError;
 }
+/** Thrown by jobs.wait() when the deadline passes before the job reaches a terminal state. */
+var WaitTimeoutError = class extends Error {
+	jobId;
+	lastStatus;
+	timeoutMs;
+	constructor(jobId, lastStatus, timeoutMs) {
+		super(`Job ${jobId} did not complete within ${timeoutMs}ms (last status: ${lastStatus}). It may still be queued — check the dashboard or retry.`);
+		this.name = "WaitTimeoutError";
+		this.jobId = jobId;
+		this.lastStatus = lastStatus;
+		this.timeoutMs = timeoutMs;
+	}
+};
+/** Thrown by jobs.wait({ throwOnFailure: true }) when the job ends failed/cancelled. */
+var JobFailedError = class extends Error {
+	jobId;
+	status;
+	job;
+	constructor(jobId, status, job, detail) {
+		super(`Job ${jobId} ended with status "${status}"${detail ? `: ${detail}` : ""}.`);
+		this.name = "JobFailedError";
+		this.jobId = jobId;
+		this.status = status;
+		this.job = job;
+	}
+};
 //#endregion
 //#region src/lib/request.ts
 /**
@@ -35,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++) {
@@ -83,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
@@ -183,21 +210,24 @@ function createJobsResource(request) {
 			}
 		},
 		async wait(id, options = {}) {
-			const { timeout = 3e5, interval = 2e3, onProgress, signal } = options;
+			const { timeout = 3e5, interval = 2e3, maxInterval = 1e4, onProgress, signal, throwOnFailure = false } = options;
 			const deadline = Date.now() + timeout;
+			let currentInterval = interval;
 			while (Date.now() < deadline) {
 				if (signal?.aborted) throw new DOMException("Wait aborted", "AbortError");
 				const job = await request(`/jobs/${id}`, { signal });
 				onProgress?.(job);
-				if (TERMINAL_STATUSES$1.has(job.status)) return job;
+				if (TERMINAL_STATUSES$1.has(job.status)) return resolveTerminal(id, job, throwOnFailure);
 				const remaining = deadline - Date.now();
-				const delay = Math.min(interval, remaining);
+				const delay = Math.min(currentInterval, remaining);
 				if (delay <= 0) break;
 				await sleep(delay, signal);
+				currentInterval = Math.min(currentInterval * 1.5, maxInterval);
 			}
 			const job = await request(`/jobs/${id}`, { signal });
-			if (TERMINAL_STATUSES$1.has(job.status)) return job;
-			throw new Error(`Job ${id} did not complete within ${timeout}ms (status: ${job.status})`);
+			onProgress?.(job);
+			if (TERMINAL_STATUSES$1.has(job.status)) return resolveTerminal(id, job, throwOnFailure);
+			throw new WaitTimeoutError(id, job.status, timeout);
 		},
 		async cancel(id, options) {
 			return request(`/jobs/${id}/cancel`, {
@@ -222,6 +252,21 @@ function createJobsResource(request) {
 		}
 	};
 }
+/**
+* Handle a terminal job result: throw JobFailedError when throwOnFailure is
+* set and the status is failed/cancelled; otherwise return the job.
+*
+* Narrowing on `status === "failed"` before reading `job.error` is required
+* because `error` is only present on the "failed" variant of the discriminated
+* union — the compiler won't allow access without narrowing first.
+*/
+function resolveTerminal(id, job, throwOnFailure) {
+	if (throwOnFailure && (job.status === "failed" || job.status === "cancelled")) {
+		const detail = job.status === "failed" ? job.error.message : void 0;
+		throw new JobFailedError(id, job.status, job, detail);
+	}
+	return job;
+}
 function sleep(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) {
@@ -248,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,
@@ -575,6 +626,16 @@ function createOrgsResource(request) {
 				method: "DELETE",
 				signal: options?.signal
 			});
+		},
+		async getSettings(options) {
+			return request("/orgs/current/settings", { signal: options?.signal });
+		},
+		async updateSettings(body, options) {
+			return request("/orgs/current/settings", {
+				method: "PATCH",
+				body,
+				signal: options?.signal
+			});
 		}
 	};
 }
@@ -859,6 +920,8 @@ function jobData(job) {
 }
 //#endregion
 exports.ApiError = ApiError;
+exports.JobFailedError = JobFailedError;
+exports.WaitTimeoutError = WaitTimeoutError;
 exports.createClient = createClient;
 exports.isApiError = isApiError;
 exports.jobData = jobData;

package/dist/index.d.cts

@@ -2270,6 +2270,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2307,6 +2308,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2346,6 +2348,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2385,6 +2388,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2466,6 +2470,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2509,6 +2514,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2604,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;
@@ -2788,6 +2800,12 @@ declare const assetListMetaSchema: ZodObject<{
   limit: ZodNumber;
   offset: ZodNumber;
 }, $strip>;
+declare const orgSettingsResponseSchema: ZodObject<{
+  billingEmailsEnabled: ZodBoolean;
+  defaultRegion: ZodString;
+  regionPinned: ZodBoolean;
+}, $strip>;
+type OrgSettings = output<typeof orgSettingsResponseSchema>;
 type JobResponse = output<typeof jobResponseSchema>;
 type JobStep = output<typeof jobStepSchema>;
 type Output = output<typeof jobOutputSchema>;
@@ -2800,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>;
@@ -2828,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;
@@ -2999,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. */
@@ -3042,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<{
@@ -3178,6 +3214,12 @@ declare function createClient(config?: ClientConfig): {
     delete(options?: {
       signal?: AbortSignal;
     }): Promise<void>;
+    getSettings(options?: {
+      signal?: AbortSignal;
+    }): Promise<OrgSettings>;
+    updateSettings(body: Partial<Pick<OrgSettings, "billingEmailsEnabled" | "defaultRegion" | "regionPinned">>, options?: {
+      signal?: AbortSignal;
+    }): Promise<OrgSettings>;
   };
   batches: {
     create(params: {
@@ -3266,6 +3308,20 @@ declare class ApiError extends Error {
   constructor(code: string, statusCode: number, message: string, details?: Record<string, unknown> | undefined, retryAfter?: number | undefined);
 }
 declare function isApiError(error: unknown): error is ApiError;
+/** Thrown by jobs.wait() when the deadline passes before the job reaches a terminal state. */
+declare class WaitTimeoutError extends Error {
+  readonly jobId: string;
+  readonly lastStatus: string;
+  readonly timeoutMs: number;
+  constructor(jobId: string, lastStatus: string, timeoutMs: number);
+}
+/** Thrown by jobs.wait({ throwOnFailure: true }) when the job ends failed/cancelled. */
+declare class JobFailedError extends Error {
+  readonly jobId: string;
+  readonly status: string;
+  readonly job: unknown;
+  constructor(jobId: string, status: string, job: unknown, detail?: string);
+}
 //#endregion
 //#region src/realtime/client.d.ts
 interface RealtimeConnectOptions {
@@ -3348,10 +3404,16 @@ type ListJobsParams = {
   offset?: number;
 };
 type WaitOptions = {
-  /** Max wait time in ms. Default: 300_000 (5 minutes). */timeout?: number; /** Poll interval in ms. Default: 2_000. */
-  interval?: number; /** Called on each poll with the latest job state. */
+  /** Max wait time in ms. Default: 300_000 (5 minutes). */timeout?: number; /** Initial poll interval in ms. Default: 2_000. Grows with exponential backoff. */
+  interval?: number; /** Cap for the backoff poll interval in ms. Default: 10_000. */
+  maxInterval?: number; /** Called on each poll with the latest job state. */
   onProgress?: (job: JobResponse) => void; /** Abort signal for cancellation. */
   signal?: AbortSignal;
+  /**
+   * When true, throw JobFailedError if the job ends with status "failed" or "cancelled".
+   * Default: false (returns the terminal job, preserving existing behavior).
+   */
+  throwOnFailure?: boolean;
 };
 type JobListPage = {
   data: JobResponse[];
@@ -3451,4 +3513,4 @@ type AssetListPage = {
   meta: AssetListMeta;
 };
 //#endregion
-export { ApiError, type ApiKey, type AssetResponse as Asset, type AssetDownloadResponse, type AssetInitResponse, type AssetListMeta, type AssetListPage, type BatchResult, type BillingInvoice, type BillingState, type ClientConfig, type Cost, type CreateJobParams, type CreateUploadOptions, type CreateWebhookParams, type FfmpegParams, type FileType, type JobResponse as Job, type JobCreatedResponse, type JobError, type JobListPage, type JobStep, type JobSubscribeOptions, type JobSubscription, type JobTimings, type JobType, type ListAssetsParams, type ListDeliveriesParams, type ListJobsParams, type LogEntryData, type OrgCurrentResponse, type OrgEvent, type Organization, type Output, type OutputFile, type PaginationMeta, type PaymentMethod, type RealtimeConnectOptions, type RealtimeConnection, type RendobarClient, type Transaction, type TransactionListParams, type UpdateWebhookParams, type UploadProgress, type UsageParams, type UsageSummary, type WaitOptions, type WebhookDelivery, type WebhookEndpoint, createClient, isApiError, jobData, outputUrl };
+export { ApiError, type ApiKey, type AssetResponse as Asset, type AssetDownloadResponse, type AssetInitResponse, type AssetListMeta, type AssetListPage, type BatchResult, type BillingInvoice, type BillingState, type ClientConfig, type Cost, type CreateJobParams, type CreateUploadOptions, type CreateWebhookParams, type FfmpegParams, type FileType, type JobResponse as Job, type JobCreatedResponse, type JobError, JobFailedError, type JobListPage, type JobStep, type JobSubscribeOptions, type JobSubscription, type JobTimings, type JobType, type ListAssetsParams, type ListDeliveriesParams, type ListJobsParams, type LogEntryData, type OrgCurrentResponse, type OrgEvent, type OrgSettings, type Organization, type Output, type OutputFile, type PaginationMeta, type PaymentMethod, type RealtimeConnectOptions, type RealtimeConnection, type RendobarClient, type Transaction, type TransactionListParams, type UpdateWebhookParams, type UploadProgress, type UsageParams, type UsageSummary, type WaitOptions, WaitTimeoutError, type WebhookDelivery, type WebhookEndpoint, createClient, isApiError, jobData, outputUrl };

package/dist/index.d.mts

@@ -2270,6 +2270,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2307,6 +2308,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2346,6 +2348,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2385,6 +2388,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2466,6 +2470,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2509,6 +2514,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   }, $strip>>;
   logsAvailable: ZodBoolean;
   metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2604,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;
@@ -2788,6 +2800,12 @@ declare const assetListMetaSchema: ZodObject<{
   limit: ZodNumber;
   offset: ZodNumber;
 }, $strip>;
+declare const orgSettingsResponseSchema: ZodObject<{
+  billingEmailsEnabled: ZodBoolean;
+  defaultRegion: ZodString;
+  regionPinned: ZodBoolean;
+}, $strip>;
+type OrgSettings = output<typeof orgSettingsResponseSchema>;
 type JobResponse = output<typeof jobResponseSchema>;
 type JobStep = output<typeof jobStepSchema>;
 type Output = output<typeof jobOutputSchema>;
@@ -2800,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>;
@@ -2828,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;
@@ -2999,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. */
@@ -3042,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<{
@@ -3178,6 +3214,12 @@ declare function createClient(config?: ClientConfig): {
     delete(options?: {
       signal?: AbortSignal;
     }): Promise<void>;
+    getSettings(options?: {
+      signal?: AbortSignal;
+    }): Promise<OrgSettings>;
+    updateSettings(body: Partial<Pick<OrgSettings, "billingEmailsEnabled" | "defaultRegion" | "regionPinned">>, options?: {
+      signal?: AbortSignal;
+    }): Promise<OrgSettings>;
   };
   batches: {
     create(params: {
@@ -3266,6 +3308,20 @@ declare class ApiError extends Error {
   constructor(code: string, statusCode: number, message: string, details?: Record<string, unknown> | undefined, retryAfter?: number | undefined);
 }
 declare function isApiError(error: unknown): error is ApiError;
+/** Thrown by jobs.wait() when the deadline passes before the job reaches a terminal state. */
+declare class WaitTimeoutError extends Error {
+  readonly jobId: string;
+  readonly lastStatus: string;
+  readonly timeoutMs: number;
+  constructor(jobId: string, lastStatus: string, timeoutMs: number);
+}
+/** Thrown by jobs.wait({ throwOnFailure: true }) when the job ends failed/cancelled. */
+declare class JobFailedError extends Error {
+  readonly jobId: string;
+  readonly status: string;
+  readonly job: unknown;
+  constructor(jobId: string, status: string, job: unknown, detail?: string);
+}
 //#endregion
 //#region src/realtime/client.d.ts
 interface RealtimeConnectOptions {
@@ -3348,10 +3404,16 @@ type ListJobsParams = {
   offset?: number;
 };
 type WaitOptions = {
-  /** Max wait time in ms. Default: 300_000 (5 minutes). */timeout?: number; /** Poll interval in ms. Default: 2_000. */
-  interval?: number; /** Called on each poll with the latest job state. */
+  /** Max wait time in ms. Default: 300_000 (5 minutes). */timeout?: number; /** Initial poll interval in ms. Default: 2_000. Grows with exponential backoff. */
+  interval?: number; /** Cap for the backoff poll interval in ms. Default: 10_000. */
+  maxInterval?: number; /** Called on each poll with the latest job state. */
   onProgress?: (job: JobResponse) => void; /** Abort signal for cancellation. */
   signal?: AbortSignal;
+  /**
+   * When true, throw JobFailedError if the job ends with status "failed" or "cancelled".
+   * Default: false (returns the terminal job, preserving existing behavior).
+   */
+  throwOnFailure?: boolean;
 };
 type JobListPage = {
   data: JobResponse[];
@@ -3451,4 +3513,4 @@ type AssetListPage = {
   meta: AssetListMeta;
 };
 //#endregion
-export { ApiError, type ApiKey, type AssetResponse as Asset, type AssetDownloadResponse, type AssetInitResponse, type AssetListMeta, type AssetListPage, type BatchResult, type BillingInvoice, type BillingState, type ClientConfig, type Cost, type CreateJobParams, type CreateUploadOptions, type CreateWebhookParams, type FfmpegParams, type FileType, type JobResponse as Job, type JobCreatedResponse, type JobError, type JobListPage, type JobStep, type JobSubscribeOptions, type JobSubscription, type JobTimings, type JobType, type ListAssetsParams, type ListDeliveriesParams, type ListJobsParams, type LogEntryData, type OrgCurrentResponse, type OrgEvent, type Organization, type Output, type OutputFile, type PaginationMeta, type PaymentMethod, type RealtimeConnectOptions, type RealtimeConnection, type RendobarClient, type Transaction, type TransactionListParams, type UpdateWebhookParams, type UploadProgress, type UsageParams, type UsageSummary, type WaitOptions, type WebhookDelivery, type WebhookEndpoint, createClient, isApiError, jobData, outputUrl };
+export { ApiError, type ApiKey, type AssetResponse as Asset, type AssetDownloadResponse, type AssetInitResponse, type AssetListMeta, type AssetListPage, type BatchResult, type BillingInvoice, type BillingState, type ClientConfig, type Cost, type CreateJobParams, type CreateUploadOptions, type CreateWebhookParams, type FfmpegParams, type FileType, type JobResponse as Job, type JobCreatedResponse, type JobError, JobFailedError, type JobListPage, type JobStep, type JobSubscribeOptions, type JobSubscription, type JobTimings, type JobType, type ListAssetsParams, type ListDeliveriesParams, type ListJobsParams, type LogEntryData, type OrgCurrentResponse, type OrgEvent, type OrgSettings, type Organization, type Output, type OutputFile, type PaginationMeta, type PaymentMethod, type RealtimeConnectOptions, type RealtimeConnection, type RendobarClient, type Transaction, type TransactionListParams, type UpdateWebhookParams, type UploadProgress, type UsageParams, type UsageSummary, type WaitOptions, WaitTimeoutError, type WebhookDelivery, type WebhookEndpoint, createClient, isApiError, jobData, outputUrl };

package/dist/index.mjs

@@ -17,6 +17,32 @@ var ApiError = class extends Error {
 function isApiError(error) {
 	return error instanceof ApiError;
 }
+/** Thrown by jobs.wait() when the deadline passes before the job reaches a terminal state. */
+var WaitTimeoutError = class extends Error {
+	jobId;
+	lastStatus;
+	timeoutMs;
+	constructor(jobId, lastStatus, timeoutMs) {
+		super(`Job ${jobId} did not complete within ${timeoutMs}ms (last status: ${lastStatus}). It may still be queued — check the dashboard or retry.`);
+		this.name = "WaitTimeoutError";
+		this.jobId = jobId;
+		this.lastStatus = lastStatus;
+		this.timeoutMs = timeoutMs;
+	}
+};
+/** Thrown by jobs.wait({ throwOnFailure: true }) when the job ends failed/cancelled. */
+var JobFailedError = class extends Error {
+	jobId;
+	status;
+	job;
+	constructor(jobId, status, job, detail) {
+		super(`Job ${jobId} ended with status "${status}"${detail ? `: ${detail}` : ""}.`);
+		this.name = "JobFailedError";
+		this.jobId = jobId;
+		this.status = status;
+		this.job = job;
+	}
+};
 //#endregion
 //#region src/lib/request.ts
 /**
@@ -34,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++) {
@@ -82,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
@@ -182,21 +209,24 @@ function createJobsResource(request) {
 			}
 		},
 		async wait(id, options = {}) {
-			const { timeout = 3e5, interval = 2e3, onProgress, signal } = options;
+			const { timeout = 3e5, interval = 2e3, maxInterval = 1e4, onProgress, signal, throwOnFailure = false } = options;
 			const deadline = Date.now() + timeout;
+			let currentInterval = interval;
 			while (Date.now() < deadline) {
 				if (signal?.aborted) throw new DOMException("Wait aborted", "AbortError");
 				const job = await request(`/jobs/${id}`, { signal });
 				onProgress?.(job);
-				if (TERMINAL_STATUSES$1.has(job.status)) return job;
+				if (TERMINAL_STATUSES$1.has(job.status)) return resolveTerminal(id, job, throwOnFailure);
 				const remaining = deadline - Date.now();
-				const delay = Math.min(interval, remaining);
+				const delay = Math.min(currentInterval, remaining);
 				if (delay <= 0) break;
 				await sleep(delay, signal);
+				currentInterval = Math.min(currentInterval * 1.5, maxInterval);
 			}
 			const job = await request(`/jobs/${id}`, { signal });
-			if (TERMINAL_STATUSES$1.has(job.status)) return job;
-			throw new Error(`Job ${id} did not complete within ${timeout}ms (status: ${job.status})`);
+			onProgress?.(job);
+			if (TERMINAL_STATUSES$1.has(job.status)) return resolveTerminal(id, job, throwOnFailure);
+			throw new WaitTimeoutError(id, job.status, timeout);
 		},
 		async cancel(id, options) {
 			return request(`/jobs/${id}/cancel`, {
@@ -221,6 +251,21 @@ function createJobsResource(request) {
 		}
 	};
 }
+/**
+* Handle a terminal job result: throw JobFailedError when throwOnFailure is
+* set and the status is failed/cancelled; otherwise return the job.
+*
+* Narrowing on `status === "failed"` before reading `job.error` is required
+* because `error` is only present on the "failed" variant of the discriminated
+* union — the compiler won't allow access without narrowing first.
+*/
+function resolveTerminal(id, job, throwOnFailure) {
+	if (throwOnFailure && (job.status === "failed" || job.status === "cancelled")) {
+		const detail = job.status === "failed" ? job.error.message : void 0;
+		throw new JobFailedError(id, job.status, job, detail);
+	}
+	return job;
+}
 function sleep(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) {
@@ -247,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,
@@ -574,6 +625,16 @@ function createOrgsResource(request) {
 				method: "DELETE",
 				signal: options?.signal
 			});
+		},
+		async getSettings(options) {
+			return request("/orgs/current/settings", { signal: options?.signal });
+		},
+		async updateSettings(body, options) {
+			return request("/orgs/current/settings", {
+				method: "PATCH",
+				body,
+				signal: options?.signal
+			});
 		}
 	};
 }
@@ -857,4 +918,4 @@ function jobData(job) {
 	return job.output.data;
 }
 //#endregion
-export { ApiError, createClient, isApiError, jobData, outputUrl };
+export { ApiError, JobFailedError, WaitTimeoutError, createClient, isApiError, jobData, outputUrl };

package/package.json

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