@nodaro/sdk 1.24.0 → 1.26.0

package/dist/index.cjs

@@ -238,10 +238,17 @@ var WorkflowsResource = class {
   }
   /**
    * Import a `WorkflowExport` bundle into the specified project.
-   * Re-creates any bundled assets (characters, objects, locations) under your account.
+   * Re-creates any bundled assets (characters, objects, creatures, locations)
+   * under your account, and re-points BOTH the entity nodes and every `@`-chip
+   * (`ConnectedReference`) bound in the graph at the rows it created.
    * Media the bundle references on other hosts is copied onto this instance's
-   * storage where reachable; `importReport` says what was copied, what could
-   * not be reached, and what was skipped (and why).
+   * storage where reachable; a bundled entity's images are copied whoever
+   * hosts them, because they are the exporter's bytes and their lifecycle is
+   * not yours. `importReport` says what was copied, what could not be reached
+   * and what was skipped (and why); `assetIdMap` maps each bundled entity id
+   * to the row created for it (for chips you hold outside the graph), and
+   * `assetsSkipped` names the entities your storage quota left uncreated —
+   * the workflow itself still lands.
    */
   import(input) {
     const { projectId, ...workflowJson } = input;
@@ -324,6 +331,14 @@ var JobsResource = class {
   get(id) {
     return this.client.request("GET", `/v1/jobs/${encodeURIComponent(id)}`);
   }
+  /**
+   * Your jobs, newest first (`GET /v1/jobs`), cursor-paginated. `type` and
+   * `origin` filter on the job's own `input_data`, which every job carries —
+   * a client app lists its runs with `{ type: "llm-structured", origin: "studio" }`.
+   */
+  list(params = {}) {
+    return this.client.request("GET", "/v1/jobs", { query: { ...params } });
+  }
   /**
    * Get the lean status of a single job (poll-loop friendly).
    * Hits `GET /v1/jobs/:id/status` — returns only id/status/progress/
@@ -1786,6 +1801,36 @@ var VoicesResource = class {
   }
 };
 
+// src/resources/llm.ts
+var LlmResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Synchronous forced-schema completion (`POST /v1/llm/structured`). A call
+   * can run several minutes — longer than the client's default 60 s
+   * `timeoutMs`; construct the client with a larger `timeoutMs` for this
+   * call, or use {@link LlmResource.structuredJob}.
+   */
+  structured(input) {
+    return this.client.request("POST", "/v1/llm/structured", { body: input });
+  }
+  /**
+   * The same call as a job (`POST /v1/llm/structured/jobs`): answers `{ jobId }`
+   * at once. Poll `jobs.getStatus(jobId)` — `output_data` is an
+   * {@link LlmStructuredJobOutput}; `error_message` says why a run failed.
+   * `jobs.list({ type: "llm-structured", origin })` finds every run later.
+   * Throws `NotFoundError` on a platform that predates the route. An instance
+   * that proxies its LLM calls to nodaro.ai answers `503 provider_unavailable`
+   * permanently — the SDK surfaces that as a generic `NodaroError` with the
+   * same code; treat it as unavailable here, not as transient.
+   */
+  structuredJob(input) {
+    return this.client.request("POST", "/v1/llm/structured/jobs", { body: input });
+  }
+};
+
 // src/resources/media.ts
 var MediaResource = class {
   constructor(client) {
@@ -1935,6 +1980,16 @@ var MediaResource = class {
   videoMetadata(input) {
     return this.client.request("POST", "/v1/video-metadata", { body: input });
   }
+  /**
+   * Cut or crop a stored file (`POST /v1/media/process`) — synchronous and
+   * free, the source-preparation sibling of the priced `trimVideo` node.
+   * `trim` is `[startTime, endTime]` in seconds; `deleteSource: true` removes
+   * the source object afterwards when it is yours and nothing else references
+   * it ("the cut replaces the original"). Answers the stored file.
+   */
+  process(input) {
+    return this.client.request("POST", "/v1/media/process", { body: input });
+  }
 };
 
 // src/resources/audio.ts
@@ -2536,6 +2591,23 @@ var OrganizationsResource = class {
   audit(orgId, opts = {}) {
     return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/audit`, { query: { ...opts } });
   }
+  // -- usage ----------------------------------------------------------------
+  /**
+   * Credits by workspace, member, model or day. Owner and org admins only.
+   * Inclusive dates (`from`/`to`), IANA `tz` (default UTC), ≤ 366 days
+   * (default last 30).
+   */
+  usage(orgId, opts = {}) {
+    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/usage`, { query: { ...opts } });
+  }
+  /** The individual runs behind a report, newest first, cursor-paged. */
+  usageRows(orgId, opts = {}) {
+    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/usage`, { query: { ...opts, groupBy: "none" } });
+  }
+  /** The same report (or the rows, with `groupBy: "none"`) as CSV text. */
+  usageCsv(orgId, opts = {}) {
+    return this.client.requestText("GET", `/v1/orgs/${encodeURIComponent(orgId)}/usage`, { query: { ...opts, format: "csv" } });
+  }
 };
 
 // src/resources/workspaces.ts
@@ -2627,8 +2699,26 @@ var WorkspacesResource = class {
   join(code) {
     return this.client.request("POST", "/v1/workspaces/join", { body: { code } });
   }
+  // -- usage ----------------------------------------------------------------
+  /**
+   * Credits by member, model or day for this workspace. A plain member sees
+   * their OWN runs (the report is self-narrowed and `groupBy: "member"` is
+   * refused); a workspace admin sees everyone and may filter `userId`.
+   * Inclusive dates, IANA `tz` (default UTC), ≤ 366 days (default last 30).
+   */
+  usage(id, opts = {}) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts } });
+  }
+  /** The individual runs behind a report, newest first, cursor-paged. */
+  usageRows(id, opts = {}) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, groupBy: "none" } });
+  }
+  /** The same report (or the rows, with `groupBy: "none"`) as CSV text. */
+  usageCsv(id, opts = {}) {
+    return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
+  }
 };
-var SDK_VERSION = "1.24.0" ;
+var SDK_VERSION = "1.26.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -2666,6 +2756,7 @@ var NodaroClient = class _NodaroClient {
   reduce;
   promptHelper;
   voices;
+  llm;
   media;
   audio;
   credits;
@@ -2709,6 +2800,7 @@ var NodaroClient = class _NodaroClient {
     this.reduce = new ReduceResource(this);
     this.promptHelper = new PromptHelperResource(this);
     this.voices = new VoicesResource(this);
+    this.llm = new LlmResource(this);
     this.media = new MediaResource(this);
     this.audio = new AudioResource(this);
     this.credits = new CreditsResource(this);
@@ -2747,7 +2839,14 @@ var NodaroClient = class _NodaroClient {
       ...workspaceId ? { workspaceId } : {}
     });
   }
-  async request(method, path, options = {}) {
+  /**
+   * The transport: build the request, send it, throw the typed error on a
+   * non-2xx via {@link throwFromResponse}, then read the body via `read` — all
+   * inside the abort timer, so `timeoutMs` bounds the body download too (a
+   * stalled CSV stream aborts, it does not hang forever). Both the JSON path
+   * ({@link request}) and the text path ({@link requestText}) go through here.
+   */
+  async send(method, path, options, read) {
     const url = this.buildUrl(path, options.query);
     const token = await this.auth.getToken();
     const isFormData = typeof FormData !== "undefined" && options.body instanceof FormData;
@@ -2780,12 +2879,30 @@ var NodaroClient = class _NodaroClient {
         }
         throwFromResponse(res.status, errBody);
       }
-      if (res.status === 204) return void 0;
-      return await res.json();
+      return await read(res);
     } finally {
       clearTimeout(timeoutId);
     }
   }
+  async request(method, path, options = {}) {
+    return this.send(
+      method,
+      path,
+      options,
+      async (res) => (
+        // 204 No Content
+        res.status === 204 ? void 0 : await res.json()
+      )
+    );
+  }
+  /**
+   * Like {@link request}, for endpoints that answer text (CSV exports). Errors
+   * are still the JSON envelope and throw the same typed errors, and the read is
+   * bounded by the same timeout as the request.
+   */
+  async requestText(method, path, options = {}) {
+    return this.send(method, path, options, (res) => res.text());
+  }
   /**
    * `GET /v1/me` → the authenticated user's identity (see {@link UserIdentity}).
    * Unwraps the `{ data }` envelope. Throws `UnauthorizedError` (401) when the
@@ -2925,6 +3042,10 @@ Object.defineProperty(exports, "SURROUND_DIRECTIONS", {
   enumerable: true,
   get: function () { return shared.SURROUND_DIRECTIONS; }
 });
+Object.defineProperty(exports, "USAGE_GROUP_BYS", {
+  enumerable: true,
+  get: function () { return shared.USAGE_GROUP_BYS; }
+});
 Object.defineProperty(exports, "WORKSPACE_HEADER", {
   enumerable: true,
   get: function () { return shared.WORKSPACE_HEADER; }
@@ -2947,6 +3068,7 @@ exports.JobFailedError = JobFailedError;
 exports.JobTimeoutError = JobTimeoutError;
 exports.JobsResource = JobsResource;
 exports.LibraryResource = LibraryResource;
+exports.LlmResource = LlmResource;
 exports.LocationsResource = LocationsResource;
 exports.MediaResource = MediaResource;
 exports.ModelsResource = ModelsResource;