@nodaro/sdk 2.4.0 → 2.6.0

package/dist/index.cjs

@@ -146,6 +146,20 @@ var JobAbortedError = class extends NodaroError {
   }
   jobId;
 };
+var StudioPreviewUnavailable = class extends NodaroError {
+  constructor(message = "This deployment does not preview operation batches; nothing was sent") {
+    super(message, "studio_preview_unavailable", 0);
+    this.name = "StudioPreviewUnavailable";
+  }
+};
+var StudioPreviewAppliedError = class extends NodaroError {
+  constructor(applied, message = applied ? "Asked for a preview and this deployment APPLIED the batch; the change is written \u2014 see `applied`" : "Asked for a preview and this deployment answered with neither one nor a body to read; the batch may have been applied \u2014 re-read the production before deciding anything") {
+    super(message, "studio_preview_applied", 0);
+    this.applied = applied;
+    this.name = "StudioPreviewAppliedError";
+  }
+  applied;
+};
 var JobHeldError = class extends NodaroError {
   constructor(message, jobId) {
     super(message, "job_held", 0);
@@ -2037,6 +2051,47 @@ var LlmResource = class {
   }
 };
 
+// src/sse.ts
+async function* readSseStream(res, opts = {}) {
+  if (!res.ok) {
+    let errBody = {};
+    try {
+      errBody = await res.json();
+    } catch {
+    }
+    throwFromResponse(res.status, errBody);
+  }
+  if (!res.body) {
+    throw new NodaroError(`${opts.label ?? "event stream"} has no response body`, "empty_stream", res.status);
+  }
+  const reader = res.body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      let sep;
+      while ((sep = buffer.indexOf("\n\n")) >= 0) {
+        const frame = buffer.slice(0, sep);
+        buffer = buffer.slice(sep + 2);
+        for (const line of frame.split("\n")) {
+          if (!line.startsWith("data:")) continue;
+          try {
+            yield JSON.parse(line.slice(5).trim());
+          } catch {
+          }
+        }
+      }
+    }
+  } finally {
+    reader.releaseLock();
+    await res.body.cancel().catch(() => {
+    });
+  }
+}
+
 // src/resources/media.ts
 var MediaResource = class {
   constructor(client) {
@@ -2073,43 +2128,7 @@ var MediaResource = class {
       headers: token ? { Authorization: `Bearer ${token}` } : {},
       signal: opts.signal
     });
-    if (!res.ok) {
-      let errBody = {};
-      try {
-        errBody = await res.json();
-      } catch {
-      }
-      throwFromResponse(res.status, errBody);
-    }
-    if (!res.body) {
-      throw new NodaroError("progress stream has no response body", "empty_stream", res.status);
-    }
-    const reader = res.body.getReader();
-    const decoder = new TextDecoder();
-    let buffer = "";
-    try {
-      for (; ; ) {
-        const { done, value } = await reader.read();
-        if (done) break;
-        buffer += decoder.decode(value, { stream: true });
-        let sep;
-        while ((sep = buffer.indexOf("\n\n")) >= 0) {
-          const frame = buffer.slice(0, sep);
-          buffer = buffer.slice(sep + 2);
-          for (const line of frame.split("\n")) {
-            if (!line.startsWith("data:")) continue;
-            try {
-              yield JSON.parse(line.slice(5).trim());
-            } catch {
-            }
-          }
-        }
-      }
-    } finally {
-      reader.releaseLock();
-      await res.body.cancel().catch(() => {
-      });
-    }
+    yield* readSseStream(res, { label: "progress stream" });
   }
   /**
    * Copy an external media URL into your Nodaro storage (`POST /v1/save-to-storage`)
@@ -2138,6 +2157,22 @@ var MediaResource = class {
   imageCollage(input) {
     return this.client.request("POST", "/v1/image-collage", { body: input });
   }
+  /**
+   * Place 1–12 layers — pictures, real text, QR codes, shapes — on a base image,
+   * pixel-exactly (`POST /v1/image-overlay`) — local, deterministic, no AI.
+   * Every layer position/size is a PERCENT of the base image: `anchor` (nine
+   * positions, default `"center"`), `x`/`y` (offset from the anchor in % of
+   * the base width/height; negative on a right/bottom anchor moves inward),
+   * `width` (% of the base width, default 25 — height follows the layer's
+   * aspect unless `height` is set). Plus `opacity` (0..1), `rotation`
+   * (degrees), `blend` (`"over"` | `"multiply"` | `"screen"`), `fit`,
+   * `shadow` and `roundedCorners`. The output keeps the base's pixel size
+   * unless `canvas` is set. Flat credit cost. Poll `jobs.get(jobId)` for the
+   * finished image.
+   */
+  imageOverlay(input) {
+    return this.client.request("POST", "/v1/image-overlay", { body: input });
+  }
   /**
    * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever
    * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or
@@ -2631,19 +2666,27 @@ var StudioProductionsResource = class {
     );
     return res.data;
   }
-  /**
-   * Apply a batch of operations. Atomic: one bad operation refuses the whole
-   * batch with a `StudioOpError` naming its index, and nothing is written. On
-   * success adopt `production` wholesale and carry `version` forward as the
-   * next `baseVersion`.
-   */
   async ops(productionId, input) {
-    const res = await this.client.request(
+    if (input.dryRun !== true) {
+      const res2 = await this.client.request(
+        "POST",
+        this.path(productionId, "/ops"),
+        { body: input }
+      );
+      return res2.data;
+    }
+    const ping = await this.client.request(
       "POST",
       this.path(productionId, "/ops"),
-      { body: input }
+      { body: { ops: [], dryRun: true } }
     );
-    return res.data;
+    if (ping?.data?.dryRun !== true) throw new StudioPreviewUnavailable();
+    const res = await this.client.request("POST", this.path(productionId, "/ops"), { body: input });
+    const data = res?.data;
+    if (data?.dryRun !== true) {
+      throw new StudioPreviewAppliedError(data);
+    }
+    return data;
   }
   /**
    * Land every generation that has finished since you last looked, and report
@@ -2851,6 +2894,103 @@ var StudioResource = class {
   }
 };
 
+// src/resources/copilot.ts
+var COPILOT_FRAME_TYPES = /* @__PURE__ */ new Set([
+  "metadata",
+  "token",
+  "tool_call",
+  "workflow_updated",
+  "workflow_created",
+  "run_proposed",
+  "memory_saved",
+  "usage",
+  "done",
+  "error"
+]);
+function isCopilotFrame(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const type = value.type;
+  return typeof type === "string" && COPILOT_FRAME_TYPES.has(type);
+}
+var CopilotResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Open a conversation (`POST /v1/copilot/threads`) — on `workflowId`, or on
+   * a workflow the server creates from `prompt`. Re-opening a workflow that
+   * already has an active thread answers THAT thread rather than a second one.
+   */
+  create(input) {
+    return this.client.request("POST", "/v1/copilot/threads", { body: input });
+  }
+  /**
+   * The active thread for a workflow (`GET /v1/copilot/threads?workflowId=…`),
+   * or `null` when the user has none open on it.
+   */
+  list(params) {
+    return this.client.request("GET", "/v1/copilot/threads", { query: { workflowId: params.workflowId } });
+  }
+  /**
+   * One thread with its messages (`GET /v1/copilot/threads/:id`). `after` reads
+   * only what followed that sequence number (the panel's catch-up); `limit`
+   * caps the page at the server's own ceiling.
+   */
+  get(id, opts = {}) {
+    return this.client.request("GET", `/v1/copilot/threads/${encodeURIComponent(id)}`, {
+      query: { ...opts.after !== void 0 ? { after: opts.after } : {}, ...opts.limit !== void 0 ? { limit: opts.limit } : {} }
+    });
+  }
+  /**
+   * Close a conversation (`DELETE /v1/copilot/threads/:id`). Archival, not
+   * deletion — the messages stay readable. Refused while a turn is running.
+   */
+  archive(id) {
+    return this.client.request("DELETE", `/v1/copilot/threads/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Stop the running turn (`POST /v1/copilot/threads/:id/cancel`). Answers the
+   * turn it asked to stop; the turn's own stream ends with a `done` frame.
+   */
+  cancel(id) {
+    return this.client.request("POST", `/v1/copilot/threads/${encodeURIComponent(id)}/cancel`);
+  }
+  /**
+   * Send one message and iterate the turn's frames
+   * (`POST /v1/copilot/threads/:id/messages`, server-sent events).
+   *
+   * Deliberately NOT routed through `client.request`: that path arms an abort
+   * timer around the whole exchange, and a turn legitimately runs for minutes —
+   * inheriting `timeoutMs` would cut the assistant off mid-answer. The caller
+   * owns the lifetime instead: pass `signal` to end the stream, or stop
+   * iterating (the reader cancels the body, which ends the request).
+   *
+   * A frame kind this package does not model is skipped rather than thrown, so
+   * a newer server cannot break an older caller.
+   */
+  async *stream(threadId, opts) {
+    const url = `${this.client.baseUrl}/v1/copilot/threads/${encodeURIComponent(threadId)}/messages`;
+    const token = await this.client.auth.getToken();
+    const res = await this.client.fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...token ? { Authorization: `Bearer ${token}` } : {}
+      },
+      body: JSON.stringify({
+        message: opts.message,
+        ...opts.baseVersion !== void 0 ? { baseVersion: opts.baseVersion } : {},
+        ...opts.tier ? { tier: opts.tier } : {}
+      }),
+      signal: opts.signal
+    });
+    for await (const value of readSseStream(res, { label: "copilot stream" })) {
+      if (isCopilotFrame(value)) yield value;
+    }
+  }
+};
+
 // src/resources/community.ts
 var CommunityResource = class {
   constructor(client) {
@@ -3232,7 +3372,7 @@ var WorkspacesResource = class {
     return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
   }
 };
-var SDK_VERSION = "2.4.0" ;
+var SDK_VERSION = "2.6.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -3284,6 +3424,7 @@ var NodaroClient = class _NodaroClient {
   shots;
   recast;
   studio;
+  copilot;
   community;
   templates;
   tutorials;
@@ -3330,6 +3471,7 @@ var NodaroClient = class _NodaroClient {
     this.shots = new ShotsResource(this);
     this.recast = new RecastResource(this);
     this.studio = new StudioResource(this);
+    this.copilot = new CopilotResource(this);
     this.community = new CommunityResource(this);
     this.templates = new TemplatesResource(this);
     this.tutorials = new TutorialsResource(this);
@@ -3582,6 +3724,7 @@ exports.CallbackAuth = CallbackAuth;
 exports.CatalogsResource = CatalogsResource;
 exports.CharactersResource = CharactersResource;
 exports.CommunityResource = CommunityResource;
+exports.CopilotResource = CopilotResource;
 exports.CreaturesResource = CreaturesResource;
 exports.CreditsResource = CreditsResource;
 exports.DeveloperAppsResource = DeveloperAppsResource;
@@ -3619,6 +3762,8 @@ exports.ShotsResource = ShotsResource;
 exports.StaticTokenAuth = StaticTokenAuth;
 exports.StorageExceededError = StorageExceededError;
 exports.StudioOpError = StudioOpError;
+exports.StudioPreviewAppliedError = StudioPreviewAppliedError;
+exports.StudioPreviewUnavailable = StudioPreviewUnavailable;
 exports.StudioProductionsResource = StudioProductionsResource;
 exports.StudioResource = StudioResource;
 exports.TemplatesResource = TemplatesResource;