@nodaro/sdk 2.46.0 → 2.49.0

package/dist/entries/cast-swap.d.ts

@@ -15,8 +15,8 @@ import '@nodaro/shared/organizations';
  * photos if it fails, and is turned off with `prepareReferences: false`.
  * Locations are not prepared.
  *
- * Engines: a run is made on Nodaro Motion Pro (`engine` left out, or
- * `"motion-pro"`) or Nodaro Motion Lite (`"motion-lite"`). Lite renders 720p
+ * Engines: a run is made on Nodaro Motion Prism (`engine` left out, or
+ * `"motion-prism"`) or Nodaro Motion Pulse (`"motion-pulse"`). Pulse renders 720p
  * (its default) or 1080p and has no draft; it makes a new take guided by the
  * clip and pictures, so its Full Quality is a new take at 1080p rather than
  * the same take re-rendered (`CastSwapFullQualityEstimate.kind`).
@@ -40,7 +40,7 @@ import '@nodaro/shared/organizations';
  * anything is charged: 400 `validation_error` (the body: no role with images,
  * no reference and no `prePrompt` or `postPrompt`, more roles of a kind
  * than allowed, more than 30 images in all, `draft: true` above 480p, a
- * `prePrompt` or `postPrompt` over 4,000 characters); on Nodaro Motion Lite,
+ * `prePrompt` or `postPrompt` over 4,000 characters); on Nodaro Motion Pulse,
  * `draft_unsupported` (`draft: true`), `resolution_unsupported` (480p),
  * `output_format_unsupported` (a MOV edit output) and `too_many_images` (more
  * than 10 images in the run, across every role and fixed reference);
@@ -51,32 +51,34 @@ import '@nodaro/shared/organizations';
  * `inPreview: false`, always refused even with a prompt, or with no role kept
  * in it that has images and no `prePrompt` or `postPrompt`), `prompt_too_long`
  * (the prompt would build too long: a `{role:N}` reads as the role's name when
- * it sends no images; Nodaro Motion Lite's cap is 8,000 characters); 401; 402 `insufficient_credits` (`run()` only); 404
+ * it sends no images; Nodaro Motion Pulse's cap is 8,000 characters); 401; 402 `insufficient_credits` (`run()` only); 404
  * (a `sessionId` you may not use, `run()` only); 422 `job_blocked` (`run()`
  * only); 503 `host_too_old` (both); 503 `estimate_unavailable` (`estimate()`
  * only).
  */
 /**
  * The engine a Nodaro Motion run is made on, by its public id. Left out =
- * `"motion-pro"`.
+ * `"motion-prism"`.
  *
- * - `"motion-pro"` (Nodaro Motion Pro): 480p (the default, a draft unless
+ * - `"motion-prism"` (Nodaro Motion Prism): 480p (the default, a draft unless
  *   `draft: false`), 720p or 1080p; Full Quality re-renders a draft's own take
  *   at 1080p.
- * - `"motion-lite"` (Nodaro Motion Lite): 720p (the default) or 1080p, never a
+ * - `"motion-pulse"` (Nodaro Motion Pulse): 720p (the default) or 1080p, never a
  *   draft (`draft: true` answers 400 `draft_unsupported`); Full Quality makes a
  *   new take at 1080p from a completed 720p run's inputs. A preview is still
  *   4 s from `previewStart`.
  */
-type CastSwapEngine = "motion-pro" | "motion-lite";
+type CastSwapEngine = "motion-prism" | "motion-pulse";
 /**
- * The engine ids an older client sent (`"seedance-2-5"` = `"motion-pro"`,
- * `"kling-4"` = `"motion-lite"`). Still accepted in a request; never returned.
+ * The engine ids an older client sent: the earlier public ids (`"motion-pro"`
+ * = `"motion-prism"`, `"motion-lite"` = `"motion-pulse"`) and the internal
+ * ones (`"seedance-2-5"`, `"kling-4"`). Still accepted in a request; never
+ * returned.
  * @deprecated use {@link CastSwapEngine}.
  */
-type CastSwapEngineLegacyId = "seedance-2-5" | "kling-4";
+type CastSwapEngineLegacyId = "motion-pro" | "motion-lite" | "seedance-2-5" | "kling-4";
 /**
- * Where a Nodaro Motion Lite run cuts the clip to whole seconds (Lite renders
+ * Where a Nodaro Motion Pulse run cuts the clip to whole seconds (Pulse renders
  * whole seconds; asked for more than the clip, it would stretch the motion):
  * - `"cut-end"` (the default): drop the fraction of a second at its end;
  * - `"cut-start"`: drop it at its start.
@@ -228,29 +230,29 @@ interface CastSwapParams {
     /** Where the preview starts, in seconds. Default 0. */
     previewStart?: number;
     /**
-     * The engine (see {@link CastSwapEngine}). Default `"motion-pro"`. The job
+     * The engine (see {@link CastSwapEngine}). Default `"motion-prism"`. The job
      * records it in `input_data.engine`, and a completed job's output in its
      * `engine`. The ids an older client sent ({@link CastSwapEngineLegacyId})
      * are still accepted.
      */
     engine?: CastSwapEngine | CastSwapEngineLegacyId;
     /**
-     * Nodaro Motion Lite only (Pro ignores it): which end of the clip is cut to
+     * Nodaro Motion Pulse only (Prism ignores it): which end of the clip is cut to
      * whole seconds (see {@link CastSwapMotionLength}). Default `"cut-end"`.
      */
     motionLength?: CastSwapMotionLength;
     /** @deprecated use {@link motionLength} (still accepted). */
     klingLength?: CastSwapKlingLength;
     /**
-     * The output resolution. Nodaro Motion Pro: `"480p"` (default), `"720p"` or
-     * `"1080p"`. Nodaro Motion Lite: `"720p"` (default) or `"1080p"`; `"480p"`
+     * The output resolution. Nodaro Motion Prism: `"480p"` (default), `"720p"` or
+     * `"1080p"`. Nodaro Motion Pulse: `"720p"` (default) or `"1080p"`; `"480p"`
      * answers 400.
      */
     resolution?: "480p" | "720p" | "1080p";
     /**
-     * Render as a draft (Nodaro Motion Pro only). Defaults to `true` at 480p and
+     * Render as a draft (Nodaro Motion Prism only). Defaults to `true` at 480p and
      * `false` above it; `true` with `"720p"` or `"1080p"` answers 400 (draft is
-     * 480p only). Nodaro Motion Lite has no draft: `true` answers 400
+     * 480p only). Nodaro Motion Pulse has no draft: `true` answers 400
      * `draft_unsupported`.
      */
     draft?: boolean;
@@ -281,7 +283,8 @@ interface CastSwapParams {
 interface CastSwapEstimate {
     /**
      * The engine the run would use, by its public id (absent from an older
-     * server = `"motion-pro"`).
+     * server = `"motion-prism"`). An id an older server answers is read as the
+     * public id it names.
      */
     engine?: CastSwapEngine;
     /**
@@ -291,19 +294,20 @@ interface CastSwapEstimate {
     totalCredits: number;
     /**
      * The charge the run is expected to come to. Never above `totalCredits`
-     * (on Nodaro Motion Lite it equals it: Lite renders exactly the length
+     * (on Nodaro Motion Pulse it equals it: Pulse renders exactly the length
      * asked for, so the hold is what it settles at). Absent from an older
      * server: read `totalCredits` then.
      */
     expectedCredits?: number;
     /**
      * The parts of the quote, by name, for display only:
-     * - `castSwap`: the run itself;
+     * - `base`: the run itself (its base fee). A server before Cast Swap 0.396.0
+     *   names it `castSwap` instead: read `base`, else `castSwap`;
      * - `references`: preparing the reference pictures (0 when
      *   `prepareReferences` is off or there is nothing to prepare);
-     * - `motion`: what the video holds (on Nodaro Motion Lite, what it costs);
+     * - `motion`: what the video holds (on Nodaro Motion Pulse, what it costs);
      * - `motionExpected`: what the video is expected to be charged, never above
-     *   `motion` (Nodaro Motion Pro);
+     *   `motion` (Nodaro Motion Prism);
      * - `privacy`: preparing the clip, when the engine's setting does. In both
      *   totals when it always runs; outside both when it is the retry
      *   (`privacyCredits`).
@@ -313,7 +317,9 @@ interface CastSwapEstimate {
      * sum. Other parts may appear.
      */
     breakdown: {
-        castSwap: number;
+        base?: number;
+        /** @deprecated read {@link base} (an older server answered this name for the same part). */
+        castSwap?: number;
         references: number;
         motion?: number;
         motionExpected?: number;
@@ -329,9 +335,9 @@ interface CastSwapEstimate {
     /** @deprecated read {@link privacyCredits} (an older server answered this name). */
     maskingCredits?: number;
     /**
-     * `true` when the video is made at Auto length (every Nodaro Motion Pro
+     * `true` when the video is made at Auto length (every Nodaro Motion Prism
      * run): the final charge is expected to come out lower than `totalCredits`,
-     * at about `expectedCredits`. `false` on Nodaro Motion Lite.
+     * at about `expectedCredits`. `false` on Nodaro Motion Pulse.
      */
     settlesLower: boolean;
 }
@@ -349,15 +355,15 @@ interface CastSwapRunOptions {
 }
 /**
  * What a Full Quality version would be: `"same-take"` re-renders a Nodaro
- * Motion Pro draft's own take at 1080p; `"new-take"` makes a new Nodaro Motion Lite take at
+ * Motion Prism draft's own take at 1080p; `"new-take"` makes a new Nodaro Motion Pulse take at
  * 1080p from a 720p run's inputs (it will not match the 720p run frame for
  * frame). The 720p run or draft stays either way.
  */
 type CastSwapFullQualityKind = "same-take" | "new-take";
 /**
  * What a Full Quality version of a run would cost
- * (`POST /v1/cast-swap/:jobId/full-quality/estimate`): a Nodaro Motion Pro
- * draft, or a completed Nodaro Motion Lite run at 720p.
+ * (`POST /v1/cast-swap/:jobId/full-quality/estimate`): a Nodaro Motion Prism
+ * draft, or a completed Nodaro Motion Pulse run at 720p.
  */
 interface CastSwapFullQualityEstimate {
     /**
@@ -365,16 +371,19 @@ interface CastSwapFullQualityEstimate {
      * be worded right. Absent from an older server: `"same-take"`.
      */
     kind?: CastSwapFullQualityKind;
-    /** The quote in credits: `breakdown.castSwap` plus the 1080p render (same take) or the new take. */
+    /** The quote in credits: `breakdown.base` plus the 1080p render (same take) or the new take. */
     totalCredits: number;
     /**
-     * The parts of the quote, by name, for display only: `castSwap` (the Full
-     * Quality job's own steps), and `motionHd` (a same take: the 1080p render,
-     * 0 when an earlier try of this draft already finished that render, which
-     * is then reused) or `motion` (a new take).
+     * The parts of the quote, by name, for display only: `base` (the Full
+     * Quality job's own steps; a server before Cast Swap 0.396.0 names it
+     * `castSwap` instead: read `base`, else `castSwap`), and `motionHd` (a same
+     * take: the 1080p render, 0 when an earlier try of this draft already
+     * finished that render, which is then reused) or `motion` (a new take).
      */
     breakdown: {
-        castSwap: number;
+        base?: number;
+        /** @deprecated read {@link base} (an older server answered this name for the same part). */
+        castSwap?: number;
         motionHd?: number;
         motion?: number;
     } & Record<string, number>;
@@ -399,8 +408,8 @@ interface CastSwapFullQualityResult {
  * - `not_found` (404): not your job, or not a Nodaro Motion run; also a
  *   `sessionId` you may not use;
  * - `not_completed` (409): the run has not finished;
- * - `not_a_draft` (409): the run is neither a Nodaro Motion Pro draft nor a
- *   Nodaro Motion Lite run at 720p (a Lite run at 1080p is already Full Quality);
+ * - `not_a_draft` (409): the run is neither a Nodaro Motion Prism draft nor a
+ *   Nodaro Motion Pulse run at 720p (a Pulse run at 1080p is already Full Quality);
  * - `draft_expired` (410): more than 7 days after the draft completed, or
  *   the draft can no longer be finished at Full Quality;
  * - `full_quality_pending` (409, `details.retryable: true`): not final — an
@@ -439,7 +448,7 @@ declare class CastSwapResource {
     /**
      * Quote finishing a run at Full Quality (`POST
      * /v1/cast-swap/:jobId/full-quality/estimate`); spends nothing. `jobId` is a
-     * finished Nodaro Motion Pro DRAFT run, or a finished Nodaro Motion Lite
+     * finished Nodaro Motion Prism DRAFT run, or a finished Nodaro Motion Pulse
      * run at 720p (a Nodaro Motion or trend run); the quote's `kind` says whether it is the same take
      * re-rendered or a new take. The quote
      * does not look for a Full Quality already running: when one is,
@@ -450,7 +459,7 @@ declare class CastSwapResource {
     /**
      * Finish a run at Full Quality (`POST /v1/cast-swap/:jobId/full-quality`):
      * at 1080p, with the clip's audio, as a new job linked to the run — a
-     * Nodaro Motion Pro draft's own take re-rendered, or a new Nodaro Motion Lite take from a
+     * Nodaro Motion Prism draft's own take re-rendered, or a new Nodaro Motion Pulse take from a
      * 720p run's inputs (the quote's `kind`). SPENDS CREDITS: quote it first with
      * {@link fullQualityEstimate}. Answers 202 `{ jobId }`, or 200
      * `{ jobId, existing: true }` when this run's Full Quality is already

package/dist/entries/cast-swap.js

@@ -1,4 +1,4 @@
 import '../chunk-KARJ7P7Y.js';
-export { CastSwapResource } from '../chunk-C3C7IL25.js';
+export { CastSwapResource } from '../chunk-OCRUDBPG.js';
 //# sourceMappingURL=cast-swap.js.map
 //# sourceMappingURL=cast-swap.js.map

package/dist/entries/client.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkPOKNFGGD_cjs = require('../chunk-POKNFGGD.cjs');
+var chunkPPP6VZ3I_cjs = require('../chunk-PPP6VZ3I.cjs');
 require('../chunk-JTOEHQQJ.cjs');
 require('../chunk-W5VHATSR.cjs');
 require('../chunk-R63TTR35.cjs');
@@ -12,8 +12,8 @@ require('../chunk-WMT7HEBZ.cjs');
 require('../chunk-MBFUMWI5.cjs');
 require('../chunk-NKH2UFSD.cjs');
 require('../chunk-UIBYZNDR.cjs');
-require('../chunk-XKDVEQVD.cjs');
-require('../chunk-DIF7A5OH.cjs');
+require('../chunk-LTZKNAXM.cjs');
+require('../chunk-E5MJK3W5.cjs');
 require('../chunk-KMNSPC72.cjs');
 require('../chunk-NBVARNVA.cjs');
 require('../chunk-7YHIFCJ4.cjs');
@@ -26,7 +26,7 @@ require('../chunk-SYVNY3AH.cjs');
 require('../chunk-22P4X3N5.cjs');
 require('../chunk-7QOCWJKD.cjs');
 require('../chunk-ZCWKX4V6.cjs');
-require('../chunk-34PU2DAT.cjs');
+require('../chunk-Q45PC4YD.cjs');
 require('../chunk-TK2CEVSK.cjs');
 require('../chunk-GVIFLUYZ.cjs');
 require('../chunk-CR5E2SF3.cjs');
@@ -34,7 +34,7 @@ require('../chunk-J5LGGCAS.cjs');
 require('../chunk-SF2CMKWA.cjs');
 require('../chunk-SBV5MWEL.cjs');
 require('../chunk-WUKIJJG2.cjs');
-require('../chunk-7LTVS75S.cjs');
+require('../chunk-P6AM42UB.cjs');
 require('../chunk-2DZWWIJ4.cjs');
 require('../chunk-SS3B6PHT.cjs');
 require('../chunk-MQ74AKA2.cjs');
@@ -43,7 +43,7 @@ require('../chunk-43FVH6LJ.cjs');
 require('../chunk-YFS2LMG4.cjs');
 require('../chunk-OSMKIRKI.cjs');
 require('../chunk-FRQJNGJS.cjs');
-var chunkZJCHIJND_cjs = require('../chunk-ZJCHIJND.cjs');
+var chunkNOBQQTAG_cjs = require('../chunk-NOBQQTAG.cjs');
 require('../chunk-FM2KM5TY.cjs');
 require('../chunk-HGCVWOGK.cjs');
 require('../chunk-FIMBPKIH.cjs');
@@ -51,7 +51,7 @@ require('../chunk-A3S55XGF.cjs');
 require('../chunk-JOXZ4ZIF.cjs');
 require('../chunk-GA4LZZKQ.cjs');
 require('../chunk-NGKODS3J.cjs');
-require('../chunk-66M54BUO.cjs');
+require('../chunk-TY2S25W5.cjs');
 require('../chunk-BPWUWUZ3.cjs');
 require('../chunk-HAKYPZLB.cjs');
 
@@ -59,23 +59,23 @@ require('../chunk-HAKYPZLB.cjs');
 
 Object.defineProperty(exports, "NodaroClient", {
   enumerable: true,
-  get: function () { return chunkPOKNFGGD_cjs.NodaroClient; }
+  get: function () { return chunkPPP6VZ3I_cjs.NodaroClient; }
 });
 Object.defineProperty(exports, "createClient", {
   enumerable: true,
-  get: function () { return chunkPOKNFGGD_cjs.createClient; }
+  get: function () { return chunkPPP6VZ3I_cjs.createClient; }
 });
 Object.defineProperty(exports, "CallbackAuth", {
   enumerable: true,
-  get: function () { return chunkZJCHIJND_cjs.CallbackAuth; }
+  get: function () { return chunkNOBQQTAG_cjs.CallbackAuth; }
 });
 Object.defineProperty(exports, "StaticTokenAuth", {
   enumerable: true,
-  get: function () { return chunkZJCHIJND_cjs.StaticTokenAuth; }
+  get: function () { return chunkNOBQQTAG_cjs.StaticTokenAuth; }
 });
 Object.defineProperty(exports, "supabaseAuth", {
   enumerable: true,
-  get: function () { return chunkZJCHIJND_cjs.supabaseAuth; }
+  get: function () { return chunkNOBQQTAG_cjs.supabaseAuth; }
 });
 //# sourceMappingURL=client.cjs.map
 //# sourceMappingURL=client.cjs.map

package/dist/entries/client.js

@@ -1,4 +1,4 @@
-export { NodaroClient, createClient } from '../chunk-WFAFFAGV.js';
+export { NodaroClient, createClient } from '../chunk-2JAKOBD3.js';
 import '../chunk-WY4QRJZW.js';
 import '../chunk-ERLXU47J.js';
 import '../chunk-T7N7DFQJ.js';
@@ -10,8 +10,8 @@ import '../chunk-WS4ZQ4AA.js';
 import '../chunk-WVFAQBS7.js';
 import '../chunk-AUKHMT53.js';
 import '../chunk-M7VSFZMV.js';
-import '../chunk-KBHDUHKM.js';
-import '../chunk-XILR6TFO.js';
+import '../chunk-2SQ7V6EX.js';
+import '../chunk-YXVMQEJX.js';
 import '../chunk-HPXE3NZW.js';
 import '../chunk-WEQWU2IC.js';
 import '../chunk-KFZOJBI5.js';
@@ -24,7 +24,7 @@ import '../chunk-NCCBS6GU.js';
 import '../chunk-BQAW4RX2.js';
 import '../chunk-Y6V6CBY5.js';
 import '../chunk-YVU2M7MI.js';
-import '../chunk-JTAW54UM.js';
+import '../chunk-AEUPH7EE.js';
 import '../chunk-GW76IRQD.js';
 import '../chunk-Z7LGWNI7.js';
 import '../chunk-7LSFG2AF.js';
@@ -32,7 +32,7 @@ import '../chunk-ALSLZG3U.js';
 import '../chunk-RBX3QTKB.js';
 import '../chunk-Z3ZKFI2M.js';
 import '../chunk-JDEZHITT.js';
-import '../chunk-PQHZUWSL.js';
+import '../chunk-THLTFB6I.js';
 import '../chunk-P6E4QDJN.js';
 import '../chunk-E37CVHWW.js';
 import '../chunk-TVENC6PH.js';
@@ -41,7 +41,7 @@ import '../chunk-SFB4YLCS.js';
 import '../chunk-BU5A6K4C.js';
 import '../chunk-D2ILCSOQ.js';
 import '../chunk-7CUWAVWB.js';
-export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-5Q4SUZPL.js';
+export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-5MZYOJCJ.js';
 import '../chunk-L6T44A3G.js';
 import '../chunk-CK3AMMSC.js';
 import '../chunk-5MOJSYHI.js';
@@ -49,7 +49,7 @@ import '../chunk-65E3JBFZ.js';
 import '../chunk-7LODCIQK.js';
 import '../chunk-3QFTP5P5.js';
 import '../chunk-J4WFSKY6.js';
-import '../chunk-C3C7IL25.js';
+import '../chunk-OCRUDBPG.js';
 import '../chunk-KG4R454Z.js';
 import '../chunk-EJSGJDZY.js';
 //# sourceMappingURL=client.js.map

package/dist/entries/core.cjs

@@ -1,26 +1,26 @@
 'use strict';
 
 require('../chunk-X7XP5WBP.cjs');
-var chunkZJCHIJND_cjs = require('../chunk-ZJCHIJND.cjs');
+var chunkNOBQQTAG_cjs = require('../chunk-NOBQQTAG.cjs');
 require('../chunk-FM2KM5TY.cjs');
 
 
 
 Object.defineProperty(exports, "CallbackAuth", {
   enumerable: true,
-  get: function () { return chunkZJCHIJND_cjs.CallbackAuth; }
+  get: function () { return chunkNOBQQTAG_cjs.CallbackAuth; }
 });
 Object.defineProperty(exports, "NodaroClientCore", {
   enumerable: true,
-  get: function () { return chunkZJCHIJND_cjs.NodaroClientCore; }
+  get: function () { return chunkNOBQQTAG_cjs.NodaroClientCore; }
 });
 Object.defineProperty(exports, "StaticTokenAuth", {
   enumerable: true,
-  get: function () { return chunkZJCHIJND_cjs.StaticTokenAuth; }
+  get: function () { return chunkNOBQQTAG_cjs.StaticTokenAuth; }
 });
 Object.defineProperty(exports, "supabaseAuth", {
   enumerable: true,
-  get: function () { return chunkZJCHIJND_cjs.supabaseAuth; }
+  get: function () { return chunkNOBQQTAG_cjs.supabaseAuth; }
 });
 //# sourceMappingURL=core.cjs.map
 //# sourceMappingURL=core.cjs.map

package/dist/entries/core.js

@@ -1,5 +1,5 @@
 import '../chunk-AUDHV3OE.js';
-export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-5Q4SUZPL.js';
+export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-5MZYOJCJ.js';
 import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=core.js.map
 //# sourceMappingURL=core.js.map

package/dist/entries/jobs.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-EHRWTYGR.cjs');
-var chunk7LTVS75S_cjs = require('../chunk-7LTVS75S.cjs');
+var chunkP6AM42UB_cjs = require('../chunk-P6AM42UB.cjs');
 
 
 
 Object.defineProperty(exports, "JobsResource", {
   enumerable: true,
-  get: function () { return chunk7LTVS75S_cjs.JobsResource; }
+  get: function () { return chunkP6AM42UB_cjs.JobsResource; }
 });
 //# sourceMappingURL=jobs.cjs.map
 //# sourceMappingURL=jobs.cjs.map

package/dist/entries/jobs.d.cts

@@ -133,17 +133,28 @@ interface Job {
      *  `usage_logs.status`. `null` when there is no usage log to report. Never
      *  changes the meaning of `credits` (the reserved amount) below. */
     credit_status?: CreditStatus | null;
-    /** The credits HELD when the job was accepted. Never changes — a job can
-     *  settle below it; read {@link Job.credits_charged} for what it cost. */
+    /** The credits the job itself HELD when it was accepted. Never changes — a
+     *  job can settle below it; read {@link Job.credits_charged} for what it cost. */
     credits: number | null;
     /**
-     * What the job actually cost once its hold settled. Can be lower than
-     * `credits` (the unused part goes back to the balance), `0` when the hold was
-     * refunded, `null` while the job is still running or when it reserved
-     * nothing of its own. Sum this — not `credits` — to total spend. Returned by
-     * `get()` and `list()`.
+     * What the job actually cost once its hold settled, INCLUDING the steps it
+     * ran: a job that runs other jobs for you (a Nodaro Motion run's reference
+     * preparation, mask and video) is charged for each, and they are not listed
+     * on their own. A step adds its charge once it settles. Can be lower than
+     * {@link Job.credits_held} (the unused part goes back to the balance). `0`
+     * when the run's own hold was refunded, plus any settled steps (a refunded
+     * Nodaro Motion run whose reference and mask steps committed reads
+     * `credit_status: "refunded"` with `credits_charged: 165`). `null` while the
+     * job's own hold is still open (even when some steps have settled), when
+     * nothing in the run was reserved, or when its steps could not be read for a
+     * moment (unknown — never a lower figure). Sum this — not `credits` — to
+     * total spend. Returned by `get()` and `list()`.
      */
     credits_charged?: number | null;
+    /** The run's hold: the job's own `credits` plus its steps' holds (equals `credits` for a job with no steps). */
+    credits_held?: number | null;
+    /** What went back from `credits_held` once every hold in the run settled; `null` until then. */
+    credits_released?: number | null;
     job_type: string | null;
     created_at: string;
     started_at: string | null;

package/dist/entries/jobs.d.ts

@@ -133,17 +133,28 @@ interface Job {
      *  `usage_logs.status`. `null` when there is no usage log to report. Never
      *  changes the meaning of `credits` (the reserved amount) below. */
     credit_status?: CreditStatus | null;
-    /** The credits HELD when the job was accepted. Never changes — a job can
-     *  settle below it; read {@link Job.credits_charged} for what it cost. */
+    /** The credits the job itself HELD when it was accepted. Never changes — a
+     *  job can settle below it; read {@link Job.credits_charged} for what it cost. */
     credits: number | null;
     /**
-     * What the job actually cost once its hold settled. Can be lower than
-     * `credits` (the unused part goes back to the balance), `0` when the hold was
-     * refunded, `null` while the job is still running or when it reserved
-     * nothing of its own. Sum this — not `credits` — to total spend. Returned by
-     * `get()` and `list()`.
+     * What the job actually cost once its hold settled, INCLUDING the steps it
+     * ran: a job that runs other jobs for you (a Nodaro Motion run's reference
+     * preparation, mask and video) is charged for each, and they are not listed
+     * on their own. A step adds its charge once it settles. Can be lower than
+     * {@link Job.credits_held} (the unused part goes back to the balance). `0`
+     * when the run's own hold was refunded, plus any settled steps (a refunded
+     * Nodaro Motion run whose reference and mask steps committed reads
+     * `credit_status: "refunded"` with `credits_charged: 165`). `null` while the
+     * job's own hold is still open (even when some steps have settled), when
+     * nothing in the run was reserved, or when its steps could not be read for a
+     * moment (unknown — never a lower figure). Sum this — not `credits` — to
+     * total spend. Returned by `get()` and `list()`.
      */
     credits_charged?: number | null;
+    /** The run's hold: the job's own `credits` plus its steps' holds (equals `credits` for a job with no steps). */
+    credits_held?: number | null;
+    /** What went back from `credits_held` once every hold in the run settled; `null` until then. */
+    credits_released?: number | null;
     job_type: string | null;
     created_at: string;
     started_at: string | null;

package/dist/entries/jobs.js

@@ -1,4 +1,4 @@
 import '../chunk-I3TYBAOX.js';
-export { JobsResource } from '../chunk-PQHZUWSL.js';
+export { JobsResource } from '../chunk-THLTFB6I.js';
 //# sourceMappingURL=jobs.js.map
 //# sourceMappingURL=jobs.js.map

package/dist/entries/node-presets.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-RA42NMWV.cjs');
-var chunk34PU2DAT_cjs = require('../chunk-34PU2DAT.cjs');
+var chunkQ45PC4YD_cjs = require('../chunk-Q45PC4YD.cjs');
 
 
 
 Object.defineProperty(exports, "PresetsResource", {
   enumerable: true,
-  get: function () { return chunk34PU2DAT_cjs.PresetsResource; }
+  get: function () { return chunkQ45PC4YD_cjs.PresetsResource; }
 });
 //# sourceMappingURL=node-presets.cjs.map
 //# sourceMappingURL=node-presets.cjs.map

package/dist/entries/node-presets.d.cts

@@ -58,6 +58,12 @@ interface FactoryPresetEntry extends FactoryPreset {
      * server you asked — or null while the preset has none.
      */
     previewUrl?: string | null;
+    /**
+     * The same picture at its two sizes for an `<img srcset>` — the tile picture
+     * at 512w and the full-screen one at up to 1024w. Present only when the
+     * preset has both; absent from servers that predate it.
+     */
+    previewSrcSet?: string;
 }
 /**
  * Result of `GET /v1/node-presets/factory` — the built-in (factory) catalog for

package/dist/entries/node-presets.d.ts

@@ -58,6 +58,12 @@ interface FactoryPresetEntry extends FactoryPreset {
      * server you asked — or null while the preset has none.
      */
     previewUrl?: string | null;
+    /**
+     * The same picture at its two sizes for an `<img srcset>` — the tile picture
+     * at 512w and the full-screen one at up to 1024w. Present only when the
+     * preset has both; absent from servers that predate it.
+     */
+    previewSrcSet?: string;
 }
 /**
  * Result of `GET /v1/node-presets/factory` — the built-in (factory) catalog for

package/dist/entries/node-presets.js

@@ -1,4 +1,4 @@
 import '../chunk-NX67YIF3.js';
-export { PresetsResource } from '../chunk-JTAW54UM.js';
+export { PresetsResource } from '../chunk-AEUPH7EE.js';
 //# sourceMappingURL=node-presets.js.map
 //# sourceMappingURL=node-presets.js.map

package/dist/entries/trash.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-UANHMQ3A.cjs');
-var chunkXKDVEQVD_cjs = require('../chunk-XKDVEQVD.cjs');
+var chunkLTZKNAXM_cjs = require('../chunk-LTZKNAXM.cjs');
 
 
 
 Object.defineProperty(exports, "TrashResource", {
   enumerable: true,
-  get: function () { return chunkXKDVEQVD_cjs.TrashResource; }
+  get: function () { return chunkLTZKNAXM_cjs.TrashResource; }
 });
 //# sourceMappingURL=trash.cjs.map
 //# sourceMappingURL=trash.cjs.map

package/dist/entries/trash.d.cts

@@ -3,10 +3,13 @@ import { Job } from './jobs.cjs';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 
-/** The session a removed item was removed from. */
+/** The session a removed item was removed from — restore it there with
+ *  `client.sessions.restoreItem(session.id, job.id)`. */
 interface TrashSession {
     id: string;
+    /** `null` = untitled; a UI may fall back to the first prompt. */
     title: string | null;
+    /** The session's project, or `null` when it has none. */
     projectId: string | null;
 }
 /**

package/dist/entries/trash.d.ts

@@ -3,10 +3,13 @@ import { Job } from './jobs.js';
 import '@nodaro/shared/apps';
 import '@nodaro/shared/organizations';
 
-/** The session a removed item was removed from. */
+/** The session a removed item was removed from — restore it there with
+ *  `client.sessions.restoreItem(session.id, job.id)`. */
 interface TrashSession {
     id: string;
+    /** `null` = untitled; a UI may fall back to the first prompt. */
     title: string | null;
+    /** The session's project, or `null` when it has none. */
     projectId: string | null;
 }
 /**

package/dist/entries/trash.js

@@ -1,4 +1,4 @@
 import '../chunk-6NTKEXT5.js';
-export { TrashResource } from '../chunk-KBHDUHKM.js';
+export { TrashResource } from '../chunk-2SQ7V6EX.js';
 //# sourceMappingURL=trash.js.map
 //# sourceMappingURL=trash.js.map

package/dist/entries/trends.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-PG2GBS3K.cjs');
-var chunkDIF7A5OH_cjs = require('../chunk-DIF7A5OH.cjs');
+var chunkE5MJK3W5_cjs = require('../chunk-E5MJK3W5.cjs');
 
 
 
 Object.defineProperty(exports, "TrendsResource", {
   enumerable: true,
-  get: function () { return chunkDIF7A5OH_cjs.TrendsResource; }
+  get: function () { return chunkE5MJK3W5_cjs.TrendsResource; }
 });
 //# sourceMappingURL=trends.cjs.map
 //# sourceMappingURL=trends.cjs.map