@rendobar/sdk 3.0.1 → 3.2.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
 /**
@@ -183,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`, {
@@ -222,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) {
@@ -575,6 +619,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
+			});
 		}
 	};
 }
@@ -699,6 +753,8 @@ const KNOWN_EVENT_TYPES = new Set([
 	"job.progress",
 	"job.step",
 	"job.log",
+	"job.metrics",
+	"job.context",
 	"balance.updated",
 	"subscription.updated",
 	"notification",
@@ -787,6 +843,12 @@ function dispatchJobEvent(event, options) {
 		case "job.result":
 			options.onResult?.(event);
 			break;
+		case "job.metrics":
+			options.onMetrics?.(event);
+			break;
+		case "job.context":
+			options.onContext?.(event);
+			break;
 	}
 }
 //#endregion
@@ -851,6 +913,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

@@ -2269,6 +2269,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2305,6 +2307,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2343,6 +2347,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2381,6 +2387,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2461,6 +2469,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2503,6 +2513,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2520,7 +2532,7 @@ declare const jobTypeSchema: ZodObject<{
   summary: ZodString;
   needs: ZodArray<ZodString>;
   pattern: ZodNullable<ZodString>;
-  provider: ZodOptional<ZodObject<{
+  runner: ZodOptional<ZodObject<{
     id: ZodString;
     resource: ZodString;
   }, $strip>>;
@@ -2782,6 +2794,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>;
@@ -2866,6 +2884,19 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
   stepProgress: ZodOptional<ZodNumber>;
   eta: ZodOptional<ZodNumber>;
   metrics: ZodOptional<ZodRecord<ZodString, ZodUnion<readonly [ZodNumber, ZodString]>>>;
+}, $strip>, ZodObject<{
+  type: ZodLiteral<"job.metrics">;
+  jobId: ZodString;
+  timestamp: ZodNumber;
+  cpuPct: ZodNumber;
+  cpuCores: ZodNumber;
+  allocatedCores: ZodOptional<ZodNumber>;
+  memUsedMB: ZodNumber;
+  memLimitMB: ZodNumber;
+  diskRMBps: ZodOptional<ZodNumber>;
+  diskWMBps: ZodOptional<ZodNumber>;
+  netRxMBps: ZodOptional<ZodNumber>;
+  netTxMBps: ZodOptional<ZodNumber>;
 }, $strip>, ZodObject<{
   type: ZodLiteral<"job.step">;
   jobId: ZodString;
@@ -2902,10 +2933,10 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
 }, $strip>], "type">;
 type OrgEvent = output<typeof orgEventSchema>;
 /**
- * Log entry data structure used by dashboard hooks and executor.
+ * Log entry data structure used by dashboard hooks and runner.
  * Import from `@rendobar/shared/events/org-events`.
  *
- * Matches executor's log event format.
+ * Matches runner's log event format.
  */
 interface LogEntryData {
   timestamp: number;
@@ -2949,7 +2980,7 @@ declare function jobData<T>(job: JobResponse): T | null;
  * Per-job execution timing breakdown. Returned by `client.jobs.getTimings(id)`.
  *
  * All values are milliseconds, or `null` if the corresponding stage did not
- * execute (e.g. a sync-completed job has no executor or queue timings).
+ * execute (e.g. a sync-completed job has no runner or queue timings).
  */
 interface JobTimings {
   jobId: string;
@@ -3159,6 +3190,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: {
@@ -3247,6 +3284,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 {
@@ -3278,6 +3329,12 @@ interface JobSubscribeOptions {
   onComplete?: (event: Extract<OrgEvent, {
     type: "job.status";
   }>) => void;
+  onMetrics?: (event: Extract<OrgEvent, {
+    type: "job.metrics";
+  }>) => void;
+  onContext?: (event: Extract<OrgEvent, {
+    type: "job.context";
+  }>) => void;
   onError?: (error: Error) => void;
 }
 interface JobSubscription {
@@ -3323,10 +3380,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[];
@@ -3426,4 +3489,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

@@ -2269,6 +2269,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2305,6 +2307,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2343,6 +2347,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2381,6 +2387,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2461,6 +2469,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2503,6 +2513,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
     error: ZodOptional<ZodString>;
   }, $strip>>;
   logsAvailable: ZodBoolean;
+  metricsAvailable: ZodBoolean;
+  region: ZodOptional<ZodNullable<ZodString>>;
   createdAt: ZodNumber;
   dispatchedAt: ZodNullable<ZodNumber>;
   startedAt: ZodNullable<ZodNumber>;
@@ -2520,7 +2532,7 @@ declare const jobTypeSchema: ZodObject<{
   summary: ZodString;
   needs: ZodArray<ZodString>;
   pattern: ZodNullable<ZodString>;
-  provider: ZodOptional<ZodObject<{
+  runner: ZodOptional<ZodObject<{
     id: ZodString;
     resource: ZodString;
   }, $strip>>;
@@ -2782,6 +2794,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>;
@@ -2866,6 +2884,19 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
   stepProgress: ZodOptional<ZodNumber>;
   eta: ZodOptional<ZodNumber>;
   metrics: ZodOptional<ZodRecord<ZodString, ZodUnion<readonly [ZodNumber, ZodString]>>>;
+}, $strip>, ZodObject<{
+  type: ZodLiteral<"job.metrics">;
+  jobId: ZodString;
+  timestamp: ZodNumber;
+  cpuPct: ZodNumber;
+  cpuCores: ZodNumber;
+  allocatedCores: ZodOptional<ZodNumber>;
+  memUsedMB: ZodNumber;
+  memLimitMB: ZodNumber;
+  diskRMBps: ZodOptional<ZodNumber>;
+  diskWMBps: ZodOptional<ZodNumber>;
+  netRxMBps: ZodOptional<ZodNumber>;
+  netTxMBps: ZodOptional<ZodNumber>;
 }, $strip>, ZodObject<{
   type: ZodLiteral<"job.step">;
   jobId: ZodString;
@@ -2902,10 +2933,10 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
 }, $strip>], "type">;
 type OrgEvent = output<typeof orgEventSchema>;
 /**
- * Log entry data structure used by dashboard hooks and executor.
+ * Log entry data structure used by dashboard hooks and runner.
  * Import from `@rendobar/shared/events/org-events`.
  *
- * Matches executor's log event format.
+ * Matches runner's log event format.
  */
 interface LogEntryData {
   timestamp: number;
@@ -2949,7 +2980,7 @@ declare function jobData<T>(job: JobResponse): T | null;
  * Per-job execution timing breakdown. Returned by `client.jobs.getTimings(id)`.
  *
  * All values are milliseconds, or `null` if the corresponding stage did not
- * execute (e.g. a sync-completed job has no executor or queue timings).
+ * execute (e.g. a sync-completed job has no runner or queue timings).
  */
 interface JobTimings {
   jobId: string;
@@ -3159,6 +3190,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: {
@@ -3247,6 +3284,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 {
@@ -3278,6 +3329,12 @@ interface JobSubscribeOptions {
   onComplete?: (event: Extract<OrgEvent, {
     type: "job.status";
   }>) => void;
+  onMetrics?: (event: Extract<OrgEvent, {
+    type: "job.metrics";
+  }>) => void;
+  onContext?: (event: Extract<OrgEvent, {
+    type: "job.context";
+  }>) => void;
   onError?: (error: Error) => void;
 }
 interface JobSubscription {
@@ -3323,10 +3380,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[];
@@ -3426,4 +3489,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
 /**
@@ -182,21 +208,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 +250,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) {
@@ -574,6 +618,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
+			});
 		}
 	};
 }
@@ -698,6 +752,8 @@ const KNOWN_EVENT_TYPES = new Set([
 	"job.progress",
 	"job.step",
 	"job.log",
+	"job.metrics",
+	"job.context",
 	"balance.updated",
 	"subscription.updated",
 	"notification",
@@ -786,6 +842,12 @@ function dispatchJobEvent(event, options) {
 		case "job.result":
 			options.onResult?.(event);
 			break;
+		case "job.metrics":
+			options.onMetrics?.(event);
+			break;
+		case "job.context":
+			options.onContext?.(event);
+			break;
 	}
 }
 //#endregion
@@ -849,4 +911,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.0.1",
+  "version": "3.2.0",
   "type": "module",
   "description": "TypeScript client for the Rendobar media processing API",
   "main": "./dist/index.cjs",