@nodaro/sdk 2.1.0 → 2.2.0

package/dist/index.cjs

@@ -538,13 +538,19 @@ var NodesResource = class {
   get(type) {
     return this.client.request("GET", `/v1/nodes/${encodeURIComponent(type)}`);
   }
-  run(type, params = {}) {
+  run(type, params = {}, options = {}) {
     const route = type === "generate-3d-scene" ? "/v1/3d-scene/generate" : type === "edit-3d-scene" ? "/v1/3d-scene/edit" : type === "render-video" && typeof params.planType === "string" ? "/v1/render-video/plan" : `/v1/${encodeURIComponent(type)}`;
-    return this.client.request("POST", route, { body: params });
+    return this.client.request("POST", route, {
+      body: params,
+      // Transport-level retry safety, opt-in per call. The platform reads the
+      // standard header, so a caller that reuses a key on a retry gets the
+      // same run back instead of a second charge.
+      ...options.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {}
+    });
   }
   async runAndWait(type, params = {}, opts = {}) {
     if (opts.signal?.aborted) throw new JobAbortedError();
-    const result = await this.run(type, params);
+    const result = await this.run(type, params, { idempotencyKey: opts.idempotencyKey });
     const jobId = extractJobId(result, type);
     return this.pollJob(jobId, type, opts);
   }
@@ -605,6 +611,10 @@ var NodesResource = class {
     }
   }
 };
+function newIdempotencyKey() {
+  const random = globalThis.crypto?.randomUUID?.();
+  return `sdk-pro3d-${random ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`}`;
+}
 var Scene3DResource = class {
   constructor(client) {
     this.client = client;
@@ -613,6 +623,22 @@ var Scene3DResource = class {
   capabilities() {
     return this.client.request("GET", "/v1/3d-scene/capabilities");
   }
+  /** Current access to both the delivery and its source is required on every read. */
+  getDelivery(jobId) {
+    return this.client.request("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}`);
+  }
+  deliveryAssetBytes(jobId, asset, options) {
+    if (asset.kind !== "poster" && asset.kind !== "validation-report" || asset.usage !== (asset.kind === "poster" ? "poster" : "validation")) {
+      throw new Error("This asset is not available through the delivery endpoint");
+    }
+    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > shared.SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
+      throw new Error("Invalid scene delivery asset byte length");
+    }
+    return this.client.requestBytes("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}/assets/${encodeURIComponent(asset.assetId)}`, {
+      signal: options?.signal,
+      maxBytes: asset.byteLength
+    });
+  }
   /** Persist deterministic overlays without an LLM or a generation charge. */
   applyEdits(revisionId, params) {
     return this.client.request("POST", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/edits`, { body: params });
@@ -649,6 +675,53 @@ var Scene3DResource = class {
   editAndWait(params, options) {
     return this.client.nodes.runAndWait("edit-3d-scene", params, options);
   }
+  /**
+   * Price a 3D Render Pro request WITHOUT starting it.
+   *
+   * Takes the same body a run takes, minus the `quoteId`, and answers a
+   * ceiling (`maxCredits`), a `breakdown` to show, and the
+   * `normalizedInputHash` admission re-checks. It reserves nothing and spends
+   * nothing — a quote is a price, not a purchase.
+   */
+  quotePro(params) {
+    return this.client.request("POST", "/v1/pro-3d-render/quote", { body: params });
+  }
+  /**
+   * Submit a quoted 3D Render Pro run.
+   *
+   * Requires the `quoteId` from {@link quotePro}: no run starts at a price
+   * nobody showed. Sends an `Idempotency-Key` — a fresh one per call unless you
+   * supply your own, which you should when retrying a call that timed out.
+   *
+   * Availability is a property of the deployment: `capabilities().pro` says
+   * whether this install can serve it, and which controls you may offer.
+   */
+  runPro(params, options) {
+    return this.client.nodes.run("pro-3d-render", params, {
+      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey()
+    });
+  }
+  /**
+   * Quote if needed, run, and wait — the whole operation in one call.
+   *
+   * Two HTTP requests at most, still ONE paid job: when `quoteId` is absent
+   * this quotes the identical body first, so the run is admitted against a
+   * hash of exactly what was priced. Pass a `quoteId` to run against a quote
+   * you already showed the user.
+   *
+   * Resolves with the settled result — `videoUrl` (the MP4) and `scenePlan`
+   * (the exact composition it was rendered from), plus the revision, poster,
+   * validation and renderer metadata. Re-render that same `scenePlan` later
+   * with {@link render}, or with a `{kind:'scene'}` source; that costs no
+   * authoring.
+   */
+  async renderProAndWait(params, options) {
+    const quoteId = typeof params.quoteId === "string" ? params.quoteId : (await this.quotePro(params)).quoteId;
+    return this.client.nodes.runAndWait("pro-3d-render", { ...params, quoteId }, {
+      ...options,
+      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey()
+    });
+  }
   /** Uses the supplied immutable revision; never starts authoring or a rebuild. */
   render(params) {
     return this.client.nodes.run("render-video", params);
@@ -3090,7 +3163,7 @@ var WorkspacesResource = class {
     return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
   }
 };
-var SDK_VERSION = "2.1.0" ;
+var SDK_VERSION = "2.2.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {