@rendobar/sdk 5.1.1 → 5.3.0

package/dist/index.cjs

@@ -209,6 +209,25 @@ function createJobsResource(request) {
 			signal: options?.signal
 		});
 	}
+	/**
+	* Create a job and wait for it to reach a terminal state, returning the
+	* finished job. A convenience wrapper over `create()` + `wait()` for
+	* callers who just want the result without juggling two calls — works for
+	* any job type, not just a specific product.
+	*
+	* Unlike `wait()` (which defaults `throwOnFailure` to `false` to preserve
+	* its existing behavior), `run()` defaults `throwOnFailure` to `true`: a
+	* job that ends "failed" or "cancelled" throws `JobFailedError` unless the
+	* caller explicitly opts out with `throwOnFailure: false`.
+	*/
+	async function run(params, options = {}) {
+		const { signal, throwOnFailure = true, ...waitOptions } = options;
+		return wait((await create(params, { signal })).id, {
+			...waitOptions,
+			signal,
+			throwOnFailure
+		});
+	}
 	async function get(id, options) {
 		return request(`/jobs/${id}`, { signal: options?.signal });
 	}
@@ -265,6 +284,7 @@ function createJobsResource(request) {
 		list,
 		listAll,
 		wait,
+		run,
 		cancel,
 		download,
 		logs,
@@ -397,9 +417,9 @@ function attemptTimeoutMs(sizeBytes, attempt) {
 		6e4
 	];
 	const RATE_BPS = [
-		500 * 1024,
-		100 * 1024,
-		50 * 1024
+		512e3,
+		102400,
+		51200
 	];
 	const i = Math.min(attempt, GRACE_MS.length - 1);
 	return GRACE_MS[i] + Math.ceil(sizeBytes / RATE_BPS[i] * 1e3);
@@ -778,6 +798,7 @@ const KNOWN_EVENT_TYPES = /* @__PURE__ */ new Set([
 	"job.resources",
 	"job.metrics",
 	"job.context",
+	"job.preview",
 	"job.region_failover",
 	"balance.updated",
 	"subscription.updated",
@@ -877,6 +898,7 @@ function dispatchJobEvent(event, options) {
 		case "job.context":
 			options.onContext?.(event);
 			break;
+		case "job.preview": options.onPreview?.(event);
 	}
 }
 //#endregion

package/dist/index.d.cts

@@ -2195,6 +2195,7 @@ declare const fileSchema: ZodObject<{
     width: ZodOptional<ZodNumber>;
     height: ZodOptional<ZodNumber>;
     durationMs: ZodOptional<ZodNumber>;
+    seed: ZodOptional<ZodNumber>;
   }, $strip>>;
 }, $strip>;
 declare const jobOutputSchema: ZodObject<{
@@ -2217,6 +2218,7 @@ declare const jobOutputSchema: ZodObject<{
       width: ZodOptional<ZodNumber>;
       height: ZodOptional<ZodNumber>;
       durationMs: ZodOptional<ZodNumber>;
+      seed: ZodOptional<ZodNumber>;
     }, $strip>>;
   }, $strip>>;
   files: ZodArray<ZodObject<{
@@ -2237,6 +2239,7 @@ declare const jobOutputSchema: ZodObject<{
       width: ZodOptional<ZodNumber>;
       height: ZodOptional<ZodNumber>;
       durationMs: ZodOptional<ZodNumber>;
+      seed: ZodOptional<ZodNumber>;
     }, $strip>>;
   }, $strip>>;
   expiresAt: ZodNullable<ZodNumber>;
@@ -2301,6 +2304,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -2353,6 +2358,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -2363,6 +2370,13 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   status: ZodLiteral<"dispatched">;
   progress: ZodOptional<ZodNullable<ZodNumber>>;
   eta: ZodOptional<ZodNullable<ZodNumber>>;
+  bootState: ZodOptional<ZodNullable<ZodObject<{
+    phase: ZodString;
+    detail: ZodString;
+    elapsedMs: ZodNumber;
+    typicalMs: ZodNullable<ZodNumber>;
+    etaMs: ZodNullable<ZodNumber>;
+  }, $strip>>>;
 }, $strip>, ZodObject<{
   id: ZodString;
   orgId: ZodString;
@@ -2407,6 +2421,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -2461,6 +2477,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -2489,6 +2507,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
         width: ZodOptional<ZodNumber>;
         height: ZodOptional<ZodNumber>;
         durationMs: ZodOptional<ZodNumber>;
+        seed: ZodOptional<ZodNumber>;
       }, $strip>>;
     }, $strip>>;
     files: ZodArray<ZodObject<{
@@ -2509,6 +2528,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
         width: ZodOptional<ZodNumber>;
         height: ZodOptional<ZodNumber>;
         durationMs: ZodOptional<ZodNumber>;
+        seed: ZodOptional<ZodNumber>;
       }, $strip>>;
     }, $strip>>;
     expiresAt: ZodNullable<ZodNumber>;
@@ -2557,6 +2577,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -2620,6 +2642,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -3015,8 +3039,8 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
   jobId: ZodString;
   timestamp: ZodNumber;
   machine: ZodString;
-  cpu: ZodNumber;
-  memory: ZodNumber;
+  cpu: ZodOptional<ZodNumber>;
+  memory: ZodOptional<ZodNumber>;
   region: ZodOptional<ZodString>;
 }, $strip>, ZodObject<{
   type: ZodLiteral<"job.progress">;
@@ -3034,38 +3058,38 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
   metrics: ZodOptional<ZodRecord<ZodString, ZodUnion<readonly [ZodNumber, ZodString]>>>;
 }, $strip>, ZodObject<{
   timestamp: ZodNumber;
-  cpuPct: ZodNumber;
+  cpuPct: ZodDefault<ZodNullable<ZodNumber>>;
   cpuCores: ZodNumber;
-  allocatedCores: ZodOptional<ZodNumber>;
+  allocatedCores: ZodDefault<ZodNullable<ZodNumber>>;
   memUsedMB: ZodNumber;
-  memLimitMB: ZodNumber;
-  diskRMBps: ZodOptional<ZodNumber>;
-  diskWMBps: ZodOptional<ZodNumber>;
-  netRxMBps: ZodOptional<ZodNumber>;
-  netTxMBps: ZodOptional<ZodNumber>;
-  gpuPct: ZodOptional<ZodNumber>;
-  gpuMemUsedMB: ZodOptional<ZodNumber>;
-  gpuMemTotalMB: ZodOptional<ZodNumber>;
-  gpuTempC: ZodOptional<ZodNumber>;
-  gpuPowerW: ZodOptional<ZodNumber>;
+  memLimitMB: ZodDefault<ZodNullable<ZodNumber>>;
+  diskRMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  diskWMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  netRxMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  netTxMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuPct: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuMemUsedMB: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuMemTotalMB: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuTempC: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuPowerW: ZodDefault<ZodNullable<ZodNumber>>;
   type: ZodLiteral<"job.resources">;
   jobId: ZodString;
 }, $strip>, ZodObject<{
   timestamp: ZodNumber;
-  cpuPct: ZodNumber;
+  cpuPct: ZodDefault<ZodNullable<ZodNumber>>;
   cpuCores: ZodNumber;
-  allocatedCores: ZodOptional<ZodNumber>;
+  allocatedCores: ZodDefault<ZodNullable<ZodNumber>>;
   memUsedMB: ZodNumber;
-  memLimitMB: ZodNumber;
-  diskRMBps: ZodOptional<ZodNumber>;
-  diskWMBps: ZodOptional<ZodNumber>;
-  netRxMBps: ZodOptional<ZodNumber>;
-  netTxMBps: ZodOptional<ZodNumber>;
-  gpuPct: ZodOptional<ZodNumber>;
-  gpuMemUsedMB: ZodOptional<ZodNumber>;
-  gpuMemTotalMB: ZodOptional<ZodNumber>;
-  gpuTempC: ZodOptional<ZodNumber>;
-  gpuPowerW: ZodOptional<ZodNumber>;
+  memLimitMB: ZodDefault<ZodNullable<ZodNumber>>;
+  diskRMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  diskWMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  netRxMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  netTxMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuPct: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuMemUsedMB: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuMemTotalMB: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuTempC: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuPowerW: ZodDefault<ZodNullable<ZodNumber>>;
   type: ZodLiteral<"job.metrics">;
   jobId: ZodString;
 }, $strip>, ZodObject<{
@@ -3093,6 +3117,15 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
   event: ZodOptional<ZodString>;
   durationMs: ZodOptional<ZodNumber>;
   meta: ZodOptional<ZodRecord<ZodString, ZodUnknown>>;
+}, $strip>, ZodObject<{
+  type: ZodLiteral<"job.preview">;
+  jobId: ZodString;
+  timestamp: ZodNumber;
+  seq: ZodNumber;
+  progress: ZodNullable<ZodNumber>;
+  width: ZodNumber;
+  height: ZodNumber;
+  data: ZodString;
 }, $strip>, ZodObject<{
   type: ZodLiteral<"replay.done">;
 }, $strip>, ZodObject<{
@@ -3332,6 +3365,7 @@ declare function createClient(config?: ClientConfig): {
     }) => Promise<JobListPage>;
     listAll: (params?: Omit<ListJobsParams, "offset">) => AsyncGenerator<JobResponse>;
     wait: (id: string, options?: WaitOptions) => Promise<JobResponse>;
+    run: (params: CreateJobParams, options?: WaitOptions) => Promise<JobResponse>;
     cancel: (id: string, options?: {
       signal?: AbortSignal;
     }) => Promise<JobResponse>;
@@ -3641,6 +3675,14 @@ interface JobSubscribeOptions {
   onMetrics?: (event: Extract<OrgEvent, {
     type: "job.resources";
   }>) => void;
+  /**
+   * Progressive preview frame of an image mid-generation. Ephemeral: 0..N per
+   * job, never replayed on reconnect — only the latest frame is available to
+   * late subscribers.
+   */
+  onPreview?: (event: Extract<OrgEvent, {
+    type: "job.preview";
+  }>) => void;
   onContext?: (event: Extract<OrgEvent, {
     type: "job.context";
   }>) => void;
@@ -3678,6 +3720,61 @@ interface FfmpegParams {
   compute?: "auto" | "cpu" | "gpu";
 }
 //#endregion
+//#region src/jobs/image.d.ts
+/**
+ * Public params types for the `image.generate` and `image.edit` jobs.
+ *
+ * Declared as plain interfaces here (rather than re-exported from
+ * `@rendobar/shared`) for the same reason as `FfmpegParams` in `./ffmpeg.js`:
+ * the SDK's dts bundler must not follow the shared package's job-registry
+ * type graph — that graph pulls the full generation model catalog into the
+ * .d.ts output and causes tsdown to OOM.
+ *
+ * The canonical runtime shape is the discriminated Zod unions in
+ * `packages/shared/src/jobs/definitions/image-generate.job.ts` and
+ * `image-edit.job.ts` (built from `GEN_BASE_PARAMS` in
+ * `packages/shared/src/jobs/gen-registry.ts`) — keep these interfaces in
+ * sync with them. Both jobs share the same base field set. The per-model
+ * extras (`negativePrompt`, `guidance`, `steps`) are offered here as
+ * optional on every model rather than reproduced as the catalog's per-model
+ * discriminated union, so the SDK doesn't have to track which model
+ * supports which knob — the API validates against the real per-model schema
+ * and rejects a field the resolved model doesn't support.
+ */
+/**
+ * Tier alias for a generation model. `"economy"` is the default when `model`
+ * is omitted. Pin an exact model id (e.g. `"qwen-image-2512"`) instead of a
+ * tier to reach that model's own controls.
+ */
+type GenModelTier = "economy" | "standard" | "premium";
+interface ImageGenBaseParams {
+  /** Tier alias or exact model id. Defaults to the "economy" tier when omitted. */
+  model?: GenModelTier | string;
+  /** What you want. For image.edit, describe the change to make. Plain language, no special syntax. */
+  prompt: string;
+  /** Requested output width in pixels. Snapped to what the model can render. */
+  width?: number;
+  /** Requested output height in pixels. Snapped to what the model can render. */
+  height?: number;
+  /** Fixed seed for a reproducible result. The seed used is echoed back. */
+  seed?: number;
+  /** What to keep out of the image. Only some models support this. */
+  negativePrompt?: string;
+  /** How strictly to follow the prompt. Higher is stricter. Only some models support this. */
+  guidance?: number;
+  /** Denoise steps. More steps means more detail and more time. Range depends on the resolved model. */
+  steps?: number;
+  /** Rewrite the prompt for the model before generating. Defaults per model; omit to keep the model's default. */
+  enhancePrompt?: boolean;
+}
+/** Public params type for the `image.generate` job. */
+interface ImageGenerateParams extends ImageGenBaseParams {}
+/**
+ * Public params type for the `image.edit` job. Reference images (1-4) are
+ * passed as job `inputs.images`, not here — see `CreateJobParams.inputs`.
+ */
+interface ImageEditParams extends ImageGenBaseParams {}
+//#endregion
 //#region src/resources/jobs.d.ts
 type CreateJobParams = {
   type: string;
@@ -3852,4 +3949,4 @@ type AssetListPage = {
   meta: AssetListMeta;
 };
 //#endregion
-export { ApiError, type ApiKey, type AssetResponse as Asset, type AssetDownloadResponse, type AssetInitResponse, type AssetListMeta, type AssetListPage, type BalanceDepletedData, type BalanceLowData, type BillingInvoice, type BillingState, type ClientConfig, type Cost, type CreateJobParams, type CreateUploadOptions, type CreateWebhookParams, type FfmpegParams, type FileType, type JobResponse as Job, type JobCancelledData, type JobCompletedData, type JobCreatedData, type JobCreatedResponse, type JobError, type JobFailedData, JobFailedError, type JobListPage, type JobStartedData, type JobStats, 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 RetryDeliveryResult, type StatsParams, type TestEventData, type Transaction, type TransactionListParams, type UpdateWebhookParams, type UploadProgress, type UsageParams, type UsageSummary, type WaitOptions, WaitTimeoutError, type WebhookDelivery, type WebhookEndpoint, type WebhookEventDataMap, type WebhookPayload, createClient, isApiError, jobData, outputUrl };
+export { ApiError, type ApiKey, type AssetResponse as Asset, type AssetDownloadResponse, type AssetInitResponse, type AssetListMeta, type AssetListPage, type BalanceDepletedData, type BalanceLowData, type BillingInvoice, type BillingState, type ClientConfig, type Cost, type CreateJobParams, type CreateUploadOptions, type CreateWebhookParams, type FfmpegParams, type FileType, type GenModelTier, type ImageEditParams, type ImageGenerateParams, type JobResponse as Job, type JobCancelledData, type JobCompletedData, type JobCreatedData, type JobCreatedResponse, type JobError, type JobFailedData, JobFailedError, type JobListPage, type JobStartedData, type JobStats, 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 RetryDeliveryResult, type StatsParams, type TestEventData, type Transaction, type TransactionListParams, type UpdateWebhookParams, type UploadProgress, type UsageParams, type UsageSummary, type WaitOptions, WaitTimeoutError, type WebhookDelivery, type WebhookEndpoint, type WebhookEventDataMap, type WebhookPayload, createClient, isApiError, jobData, outputUrl };

package/dist/index.d.mts

@@ -2195,6 +2195,7 @@ declare const fileSchema: ZodObject<{
     width: ZodOptional<ZodNumber>;
     height: ZodOptional<ZodNumber>;
     durationMs: ZodOptional<ZodNumber>;
+    seed: ZodOptional<ZodNumber>;
   }, $strip>>;
 }, $strip>;
 declare const jobOutputSchema: ZodObject<{
@@ -2217,6 +2218,7 @@ declare const jobOutputSchema: ZodObject<{
       width: ZodOptional<ZodNumber>;
       height: ZodOptional<ZodNumber>;
       durationMs: ZodOptional<ZodNumber>;
+      seed: ZodOptional<ZodNumber>;
     }, $strip>>;
   }, $strip>>;
   files: ZodArray<ZodObject<{
@@ -2237,6 +2239,7 @@ declare const jobOutputSchema: ZodObject<{
       width: ZodOptional<ZodNumber>;
       height: ZodOptional<ZodNumber>;
       durationMs: ZodOptional<ZodNumber>;
+      seed: ZodOptional<ZodNumber>;
     }, $strip>>;
   }, $strip>>;
   expiresAt: ZodNullable<ZodNumber>;
@@ -2301,6 +2304,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -2353,6 +2358,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -2363,6 +2370,13 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   status: ZodLiteral<"dispatched">;
   progress: ZodOptional<ZodNullable<ZodNumber>>;
   eta: ZodOptional<ZodNullable<ZodNumber>>;
+  bootState: ZodOptional<ZodNullable<ZodObject<{
+    phase: ZodString;
+    detail: ZodString;
+    elapsedMs: ZodNumber;
+    typicalMs: ZodNullable<ZodNumber>;
+    etaMs: ZodNullable<ZodNumber>;
+  }, $strip>>>;
 }, $strip>, ZodObject<{
   id: ZodString;
   orgId: ZodString;
@@ -2407,6 +2421,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -2461,6 +2477,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -2489,6 +2507,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
         width: ZodOptional<ZodNumber>;
         height: ZodOptional<ZodNumber>;
         durationMs: ZodOptional<ZodNumber>;
+        seed: ZodOptional<ZodNumber>;
       }, $strip>>;
     }, $strip>>;
     files: ZodArray<ZodObject<{
@@ -2509,6 +2528,7 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
         width: ZodOptional<ZodNumber>;
         height: ZodOptional<ZodNumber>;
         durationMs: ZodOptional<ZodNumber>;
+        seed: ZodOptional<ZodNumber>;
       }, $strip>>;
     }, $strip>>;
     expiresAt: ZodNullable<ZodNumber>;
@@ -2557,6 +2577,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -2620,6 +2642,8 @@ declare const jobResponseSchema: ZodDiscriminatedUnion<[ZodObject<{
   completedAt: ZodNullable<ZodNumber>;
   settledAt: ZodNullable<ZodNumber>;
   retentionExpiresAt: ZodNullable<ZodNumber>;
+  webUrl: ZodString;
+  model: ZodNullable<ZodString>;
   callback: ZodOptional<ZodNullable<ZodObject<{
     status: ZodEnum<{
       delivered: "delivered";
@@ -3015,8 +3039,8 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
   jobId: ZodString;
   timestamp: ZodNumber;
   machine: ZodString;
-  cpu: ZodNumber;
-  memory: ZodNumber;
+  cpu: ZodOptional<ZodNumber>;
+  memory: ZodOptional<ZodNumber>;
   region: ZodOptional<ZodString>;
 }, $strip>, ZodObject<{
   type: ZodLiteral<"job.progress">;
@@ -3034,38 +3058,38 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
   metrics: ZodOptional<ZodRecord<ZodString, ZodUnion<readonly [ZodNumber, ZodString]>>>;
 }, $strip>, ZodObject<{
   timestamp: ZodNumber;
-  cpuPct: ZodNumber;
+  cpuPct: ZodDefault<ZodNullable<ZodNumber>>;
   cpuCores: ZodNumber;
-  allocatedCores: ZodOptional<ZodNumber>;
+  allocatedCores: ZodDefault<ZodNullable<ZodNumber>>;
   memUsedMB: ZodNumber;
-  memLimitMB: ZodNumber;
-  diskRMBps: ZodOptional<ZodNumber>;
-  diskWMBps: ZodOptional<ZodNumber>;
-  netRxMBps: ZodOptional<ZodNumber>;
-  netTxMBps: ZodOptional<ZodNumber>;
-  gpuPct: ZodOptional<ZodNumber>;
-  gpuMemUsedMB: ZodOptional<ZodNumber>;
-  gpuMemTotalMB: ZodOptional<ZodNumber>;
-  gpuTempC: ZodOptional<ZodNumber>;
-  gpuPowerW: ZodOptional<ZodNumber>;
+  memLimitMB: ZodDefault<ZodNullable<ZodNumber>>;
+  diskRMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  diskWMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  netRxMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  netTxMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuPct: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuMemUsedMB: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuMemTotalMB: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuTempC: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuPowerW: ZodDefault<ZodNullable<ZodNumber>>;
   type: ZodLiteral<"job.resources">;
   jobId: ZodString;
 }, $strip>, ZodObject<{
   timestamp: ZodNumber;
-  cpuPct: ZodNumber;
+  cpuPct: ZodDefault<ZodNullable<ZodNumber>>;
   cpuCores: ZodNumber;
-  allocatedCores: ZodOptional<ZodNumber>;
+  allocatedCores: ZodDefault<ZodNullable<ZodNumber>>;
   memUsedMB: ZodNumber;
-  memLimitMB: ZodNumber;
-  diskRMBps: ZodOptional<ZodNumber>;
-  diskWMBps: ZodOptional<ZodNumber>;
-  netRxMBps: ZodOptional<ZodNumber>;
-  netTxMBps: ZodOptional<ZodNumber>;
-  gpuPct: ZodOptional<ZodNumber>;
-  gpuMemUsedMB: ZodOptional<ZodNumber>;
-  gpuMemTotalMB: ZodOptional<ZodNumber>;
-  gpuTempC: ZodOptional<ZodNumber>;
-  gpuPowerW: ZodOptional<ZodNumber>;
+  memLimitMB: ZodDefault<ZodNullable<ZodNumber>>;
+  diskRMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  diskWMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  netRxMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  netTxMBps: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuPct: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuMemUsedMB: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuMemTotalMB: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuTempC: ZodDefault<ZodNullable<ZodNumber>>;
+  gpuPowerW: ZodDefault<ZodNullable<ZodNumber>>;
   type: ZodLiteral<"job.metrics">;
   jobId: ZodString;
 }, $strip>, ZodObject<{
@@ -3093,6 +3117,15 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
   event: ZodOptional<ZodString>;
   durationMs: ZodOptional<ZodNumber>;
   meta: ZodOptional<ZodRecord<ZodString, ZodUnknown>>;
+}, $strip>, ZodObject<{
+  type: ZodLiteral<"job.preview">;
+  jobId: ZodString;
+  timestamp: ZodNumber;
+  seq: ZodNumber;
+  progress: ZodNullable<ZodNumber>;
+  width: ZodNumber;
+  height: ZodNumber;
+  data: ZodString;
 }, $strip>, ZodObject<{
   type: ZodLiteral<"replay.done">;
 }, $strip>, ZodObject<{
@@ -3332,6 +3365,7 @@ declare function createClient(config?: ClientConfig): {
     }) => Promise<JobListPage>;
     listAll: (params?: Omit<ListJobsParams, "offset">) => AsyncGenerator<JobResponse>;
     wait: (id: string, options?: WaitOptions) => Promise<JobResponse>;
+    run: (params: CreateJobParams, options?: WaitOptions) => Promise<JobResponse>;
     cancel: (id: string, options?: {
       signal?: AbortSignal;
     }) => Promise<JobResponse>;
@@ -3641,6 +3675,14 @@ interface JobSubscribeOptions {
   onMetrics?: (event: Extract<OrgEvent, {
     type: "job.resources";
   }>) => void;
+  /**
+   * Progressive preview frame of an image mid-generation. Ephemeral: 0..N per
+   * job, never replayed on reconnect — only the latest frame is available to
+   * late subscribers.
+   */
+  onPreview?: (event: Extract<OrgEvent, {
+    type: "job.preview";
+  }>) => void;
   onContext?: (event: Extract<OrgEvent, {
     type: "job.context";
   }>) => void;
@@ -3678,6 +3720,61 @@ interface FfmpegParams {
   compute?: "auto" | "cpu" | "gpu";
 }
 //#endregion
+//#region src/jobs/image.d.ts
+/**
+ * Public params types for the `image.generate` and `image.edit` jobs.
+ *
+ * Declared as plain interfaces here (rather than re-exported from
+ * `@rendobar/shared`) for the same reason as `FfmpegParams` in `./ffmpeg.js`:
+ * the SDK's dts bundler must not follow the shared package's job-registry
+ * type graph — that graph pulls the full generation model catalog into the
+ * .d.ts output and causes tsdown to OOM.
+ *
+ * The canonical runtime shape is the discriminated Zod unions in
+ * `packages/shared/src/jobs/definitions/image-generate.job.ts` and
+ * `image-edit.job.ts` (built from `GEN_BASE_PARAMS` in
+ * `packages/shared/src/jobs/gen-registry.ts`) — keep these interfaces in
+ * sync with them. Both jobs share the same base field set. The per-model
+ * extras (`negativePrompt`, `guidance`, `steps`) are offered here as
+ * optional on every model rather than reproduced as the catalog's per-model
+ * discriminated union, so the SDK doesn't have to track which model
+ * supports which knob — the API validates against the real per-model schema
+ * and rejects a field the resolved model doesn't support.
+ */
+/**
+ * Tier alias for a generation model. `"economy"` is the default when `model`
+ * is omitted. Pin an exact model id (e.g. `"qwen-image-2512"`) instead of a
+ * tier to reach that model's own controls.
+ */
+type GenModelTier = "economy" | "standard" | "premium";
+interface ImageGenBaseParams {
+  /** Tier alias or exact model id. Defaults to the "economy" tier when omitted. */
+  model?: GenModelTier | string;
+  /** What you want. For image.edit, describe the change to make. Plain language, no special syntax. */
+  prompt: string;
+  /** Requested output width in pixels. Snapped to what the model can render. */
+  width?: number;
+  /** Requested output height in pixels. Snapped to what the model can render. */
+  height?: number;
+  /** Fixed seed for a reproducible result. The seed used is echoed back. */
+  seed?: number;
+  /** What to keep out of the image. Only some models support this. */
+  negativePrompt?: string;
+  /** How strictly to follow the prompt. Higher is stricter. Only some models support this. */
+  guidance?: number;
+  /** Denoise steps. More steps means more detail and more time. Range depends on the resolved model. */
+  steps?: number;
+  /** Rewrite the prompt for the model before generating. Defaults per model; omit to keep the model's default. */
+  enhancePrompt?: boolean;
+}
+/** Public params type for the `image.generate` job. */
+interface ImageGenerateParams extends ImageGenBaseParams {}
+/**
+ * Public params type for the `image.edit` job. Reference images (1-4) are
+ * passed as job `inputs.images`, not here — see `CreateJobParams.inputs`.
+ */
+interface ImageEditParams extends ImageGenBaseParams {}
+//#endregion
 //#region src/resources/jobs.d.ts
 type CreateJobParams = {
   type: string;
@@ -3852,4 +3949,4 @@ type AssetListPage = {
   meta: AssetListMeta;
 };
 //#endregion
-export { ApiError, type ApiKey, type AssetResponse as Asset, type AssetDownloadResponse, type AssetInitResponse, type AssetListMeta, type AssetListPage, type BalanceDepletedData, type BalanceLowData, type BillingInvoice, type BillingState, type ClientConfig, type Cost, type CreateJobParams, type CreateUploadOptions, type CreateWebhookParams, type FfmpegParams, type FileType, type JobResponse as Job, type JobCancelledData, type JobCompletedData, type JobCreatedData, type JobCreatedResponse, type JobError, type JobFailedData, JobFailedError, type JobListPage, type JobStartedData, type JobStats, 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 RetryDeliveryResult, type StatsParams, type TestEventData, type Transaction, type TransactionListParams, type UpdateWebhookParams, type UploadProgress, type UsageParams, type UsageSummary, type WaitOptions, WaitTimeoutError, type WebhookDelivery, type WebhookEndpoint, type WebhookEventDataMap, type WebhookPayload, createClient, isApiError, jobData, outputUrl };
+export { ApiError, type ApiKey, type AssetResponse as Asset, type AssetDownloadResponse, type AssetInitResponse, type AssetListMeta, type AssetListPage, type BalanceDepletedData, type BalanceLowData, type BillingInvoice, type BillingState, type ClientConfig, type Cost, type CreateJobParams, type CreateUploadOptions, type CreateWebhookParams, type FfmpegParams, type FileType, type GenModelTier, type ImageEditParams, type ImageGenerateParams, type JobResponse as Job, type JobCancelledData, type JobCompletedData, type JobCreatedData, type JobCreatedResponse, type JobError, type JobFailedData, JobFailedError, type JobListPage, type JobStartedData, type JobStats, 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 RetryDeliveryResult, type StatsParams, type TestEventData, type Transaction, type TransactionListParams, type UpdateWebhookParams, type UploadProgress, type UsageParams, type UsageSummary, type WaitOptions, WaitTimeoutError, type WebhookDelivery, type WebhookEndpoint, type WebhookEventDataMap, type WebhookPayload, createClient, isApiError, jobData, outputUrl };

package/dist/index.mjs

@@ -208,6 +208,25 @@ function createJobsResource(request) {
 			signal: options?.signal
 		});
 	}
+	/**
+	* Create a job and wait for it to reach a terminal state, returning the
+	* finished job. A convenience wrapper over `create()` + `wait()` for
+	* callers who just want the result without juggling two calls — works for
+	* any job type, not just a specific product.
+	*
+	* Unlike `wait()` (which defaults `throwOnFailure` to `false` to preserve
+	* its existing behavior), `run()` defaults `throwOnFailure` to `true`: a
+	* job that ends "failed" or "cancelled" throws `JobFailedError` unless the
+	* caller explicitly opts out with `throwOnFailure: false`.
+	*/
+	async function run(params, options = {}) {
+		const { signal, throwOnFailure = true, ...waitOptions } = options;
+		return wait((await create(params, { signal })).id, {
+			...waitOptions,
+			signal,
+			throwOnFailure
+		});
+	}
 	async function get(id, options) {
 		return request(`/jobs/${id}`, { signal: options?.signal });
 	}
@@ -264,6 +283,7 @@ function createJobsResource(request) {
 		list,
 		listAll,
 		wait,
+		run,
 		cancel,
 		download,
 		logs,
@@ -396,9 +416,9 @@ function attemptTimeoutMs(sizeBytes, attempt) {
 		6e4
 	];
 	const RATE_BPS = [
-		500 * 1024,
-		100 * 1024,
-		50 * 1024
+		512e3,
+		102400,
+		51200
 	];
 	const i = Math.min(attempt, GRACE_MS.length - 1);
 	return GRACE_MS[i] + Math.ceil(sizeBytes / RATE_BPS[i] * 1e3);
@@ -777,6 +797,7 @@ const KNOWN_EVENT_TYPES = /* @__PURE__ */ new Set([
 	"job.resources",
 	"job.metrics",
 	"job.context",
+	"job.preview",
 	"job.region_failover",
 	"balance.updated",
 	"subscription.updated",
@@ -876,6 +897,7 @@ function dispatchJobEvent(event, options) {
 		case "job.context":
 			options.onContext?.(event);
 			break;
+		case "job.preview": options.onPreview?.(event);
 	}
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rendobar/sdk",
-  "version": "5.1.1",
+  "version": "5.3.0",
   "type": "module",
   "description": "TypeScript client for the Rendobar media processing API",
   "license": "MIT",