@rendobar/sdk 5.2.0 → 5.4.0

package/README.md

@@ -28,6 +28,16 @@
 
 `@rendobar/sdk` is the official TypeScript client for [Rendobar](https://rendobar.com), a serverless media processing API. You submit a job, the SDK polls it to completion, and you get back a hosted URL. It ships ESM and CJS builds with full types, retries 429 and 5xx automatically, auto-paginates, and accepts an `AbortSignal` on every method.
 
+## Let your AI assistant do it
+
+Paste this one line into Claude, ChatGPT, or Cursor and the assistant reads the
+full integration playbook, detects your stack, and wires Rendobar into your
+codebase. Your API key stays in your env file, never in the chat.
+
+```text
+Add Rendobar to my app: read and follow https://rendobar.com/prompts/integrate.md
+```
+
 ## Requirements
 
 Node 18 or later. Works in any runtime with `fetch`, including Cloudflare Workers, Deno, and Bun.

package/dist/index.cjs

@@ -417,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);
@@ -798,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",
@@ -897,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

@@ -2370,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;
@@ -3013,6 +3020,9 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
   status: ZodString;
   cancelAtPeriodEnd: ZodOptional<ZodBoolean>;
   timestamp: ZodOptional<ZodNumber>;
+}, $strip>, ZodObject<{
+  type: ZodLiteral<"apikeys.updated">;
+  timestamp: ZodOptional<ZodNumber>;
 }, $strip>, ZodObject<{
   type: ZodLiteral<"notification">;
   severity: ZodEnum<{
@@ -3032,8 +3042,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">;
@@ -3051,38 +3061,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<{
@@ -3110,6 +3120,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<{
@@ -3659,6 +3678,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;

package/dist/index.d.mts

@@ -2370,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;
@@ -3013,6 +3020,9 @@ declare const orgEventSchema: ZodDiscriminatedUnion<[ZodObject<{
   status: ZodString;
   cancelAtPeriodEnd: ZodOptional<ZodBoolean>;
   timestamp: ZodOptional<ZodNumber>;
+}, $strip>, ZodObject<{
+  type: ZodLiteral<"apikeys.updated">;
+  timestamp: ZodOptional<ZodNumber>;
 }, $strip>, ZodObject<{
   type: ZodLiteral<"notification">;
   severity: ZodEnum<{
@@ -3032,8 +3042,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">;
@@ -3051,38 +3061,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<{
@@ -3110,6 +3120,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<{
@@ -3659,6 +3678,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;

package/dist/index.mjs

@@ -416,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);
@@ -797,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",
@@ -896,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,8 +1,8 @@
 {
   "name": "@rendobar/sdk",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "type": "module",
-  "description": "TypeScript client for the Rendobar media processing API",
+  "description": "Rendobar SDK: TypeScript client for the media processing and AI generation API.",
   "license": "MIT",
   "homepage": "https://rendobar.com/docs/sdk",
   "repository": {