@nodaro/sdk 1.16.0 → 1.19.0

package/README.md

@@ -263,14 +263,19 @@ try {
 | `client.workflows` | List, get, create, update, delete, run |
 | `client.projects` | Workspace organization |
 | `client.jobs` | Job status (+ lean `getStatus` for poll loops) and cancellation |
+| `client.videoPro` | Generate Video Pro run control: graceful stop + continue |
+| `client.recast` | Recast runs + authored-script import (validate / import / estimate / gates) — Cloud |
 | `client.executions` | Workflow execution status, list, cancel |
 | `client.nodes` | Node discovery + direct `run` / `runAndWait` / `runMany` |
+| `client.models` | Model catalog: capability sheets, credit pricing, prompt tips, `doctrineCovered` |
 | `client.apps` | Published apps: inputs, run, runs history |
 | `client.characters` | Character Studio: CRUD, portraits, assets, motion, LoRA |
 | `client.locations` | Location Studio: CRUD, assets, atmosphere motion |
 | `client.objects` | Object Studio: CRUD, assets, motion |
 | `client.creatures` | Creature Studio: CRUD, assets, motion |
 | `client.voices` | Voice catalog + clones (from URL or file), voice changer, multi-speaker recast + the interactive `analyze`/stems/`exportMix` flow, design, remix, dubbing |
+| `client.media` | Social-video import, trim, collage, save-to-storage, metadata probe |
+| `client.audio` | Audio primitives: separate, isolate, FX, mix, volume, combine |
 | `client.pipelines` | Showrunner pipelines: stages, approvals, chat, branch |
 | `client.reduce` | Fan-in reducer (pick-best, concat, vote, merge…) |
 | `client.promptHelper` | Prompt enhancement / wizard |
@@ -278,8 +283,11 @@ try {
 | `client.uploads` | Signed upload URLs for image / video / audio |
 | `client.library` | Generated-media library |
 | `client.presets` | Node presets (factory + user) |
-| `client.pickerCatalogs` | Parameter-picker catalog discovery |
+| `client.pickerCatalogs` | Parameter-picker catalog discovery + text→pickers AI Fill (`analyzeText`) |
+| `client.shots` | Cine share → remix records (create, read, visibility, delete) |
 | `client.community` | Shared characters/locations/objects: browse, clone, favorites |
+| `client.templates` | Workflow templates: browse + clone |
+| `client.tutorials` | Guided tutorial catalog |
 | `client.developerApps` | Manage your own OAuth apps |
 | `client.oauth` | Code exchange, revoke, app-info |
 

package/dist/index.cjs

@@ -170,7 +170,8 @@ var WorkflowsResource = class {
       { body: input }
     );
   }
-  /** Delete a workflow. Returns `{ success: true }`. */
+  /** Delete a workflow. Returns `{ success: true }`. Throws `NotFoundError`
+   *  when the id doesn't exist or isn't yours (the delete is not silent). */
   delete(id) {
     return this.client.request("DELETE", `/v1/workflows/${encodeURIComponent(id)}`);
   }
@@ -199,6 +200,9 @@ var WorkflowsResource = class {
   /**
    * Import a `WorkflowExport` bundle into the specified project.
    * Re-creates any bundled assets (characters, objects, locations) under your account.
+   * 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).
    */
   import(input) {
     const { projectId, ...workflowJson } = input;
@@ -465,7 +469,8 @@ var DeveloperAppsResource = class {
       { body: input }
     );
   }
-  /** Delete a developer app. Returns `{ success: true }`. */
+  /** Delete a developer app. Returns `{ success: true }`. Throws
+   *  `NotFoundError` when the id doesn't exist or isn't yours. */
   delete(id) {
     return this.client.request(
       "DELETE",
@@ -1802,6 +1807,30 @@ var MediaResource = class {
   trimAudio(input) {
     return this.client.request("POST", "/v1/trim-audio", { body: input });
   }
+  /**
+   * Turn one still image + one audio track into an MP4
+   * (`POST /v1/still-to-video`) — locally rendered (FFmpeg), no AI model,
+   * zero credits. The output duration IS the audio's duration; there is no
+   * duration field. Optional `motion` animates the still (zoom / pan /
+   * ken-burns) at `intensity` 1–10. `fit: "contain"` letterboxes with
+   * `padColor` instead of cropping. Poll `jobs.get(jobId)`.
+   */
+  stillToVideo(input) {
+    return this.client.request("POST", "/v1/still-to-video", { body: input });
+  }
+  /**
+   * Turn 2–100 images + one optional audio track into an MP4 slideshow
+   * (`POST /v1/slideshow`) — locally rendered (FFmpeg), zero credits. With
+   * audio, the output duration IS the audio's duration (equal split unless
+   * `imageDurations` pins rows — null entries = auto; mismatched pinned sums
+   * scale proportionally and the factor is disclosed in the job output).
+   * Without audio: N × `perImageDuration`, silent output. Transitions
+   * consume the outgoing slide, so totals stay exact. For a single image use
+   * `stillToVideo`. Poll `jobs.get(jobId)`.
+   */
+  slideshow(input) {
+    return this.client.request("POST", "/v1/slideshow", { body: input });
+  }
   /**
    * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,
    * dimensions, title, live status — WITHOUT downloading it. A direct read, not a
@@ -2042,6 +2071,107 @@ var ModelsResource = class {
   }
 };
 
+// src/resources/shots.ts
+var ShotsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Create a shot record. Returns the new shot's id — an unguessable
+   *  capability string that doubles as the share-link path segment. */
+  create(input = {}) {
+    return this.client.request("POST", "/v1/shots", { body: input });
+  }
+  /** Read a shot. Public shots are readable by anyone holding the id;
+   *  private shots resolve only for their owner (404 otherwise). */
+  get(id) {
+    return this.client.request("GET", `/v1/shots/${encodeURIComponent(id)}`);
+  }
+  /** Update an owned shot (any subset of fields, e.g. a visibility toggle). */
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/shots/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** Delete an owned shot. */
+  async delete(id) {
+    await this.client.request("DELETE", `/v1/shots/${encodeURIComponent(id)}`);
+  }
+};
+
+// src/resources/recast.ts
+var RecastResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  // ── Authored-script lane (all three endpoints are free) ────────────────
+  /** The generated authoring guide (markdown): document contract, enum
+   *  vocabularies, bounds, audio rules, and a validated worked example. */
+  async authoringSkill() {
+    const res = await this.client.request(
+      "GET",
+      "/v1/video-analysis/authoring-skill"
+    );
+    return res.markdown ?? "";
+  }
+  /** FREE validation of an authored script. Loop until `valid: true`. */
+  validateScript(script) {
+    return this.client.request("POST", "/v1/video-analysis/import/validate", {
+      body: { script }
+    });
+  }
+  /**
+   * Import a VALIDATED authored script as a completed analysis job.
+   * `rightsAttested: true` is required (403 otherwise) — authored recasts
+   * render Faithful, exactly as written, so only import work you own.
+   */
+  importScript(script, opts) {
+    return this.client.request("POST", "/v1/video-analysis/import", {
+      body: { script, rightsAttested: opts.rightsAttested }
+    });
+  }
+  // ── Run lane ───────────────────────────────────────────────────────────
+  /** Quote a run (credits) before buying the plan. */
+  estimate(input) {
+    return this.client.request("POST", "/v1/recast/estimate", { body: input });
+  }
+  /** Create a run (buys the plan). Returns `{ recastId }`. */
+  create(input) {
+    return this.client.request("POST", "/v1/recast", { body: input });
+  }
+  /** Poll the run — status plus any pending interactive step. */
+  get(recastId) {
+    return this.client.request("GET", `/v1/recast/${encodeURIComponent(recastId)}`);
+  }
+  /** Quote a revisioned Music replacement and/or complete desired mix. Free. */
+  estimateRescore(recastId, input) {
+    return this.client.request(
+      "POST",
+      `/v1/recast/${encodeURIComponent(recastId)}/estimate-rescore`,
+      { body: input }
+    );
+  }
+  /** Apply a quoted audio operation. Reuse its request id only for a transport retry. */
+  rescore(recastId, input) {
+    return this.client.request(
+      "POST",
+      `/v1/recast/${encodeURIComponent(recastId)}/rescore`,
+      { body: input }
+    );
+  }
+  /** Start rendering a `planned` run. Idempotent server-side. */
+  start(recastId, opts = {}) {
+    return this.client.request("POST", `/v1/recast/${encodeURIComponent(recastId)}/start`, {
+      body: opts
+    });
+  }
+  /** Answer a pending interactive gate (the pick itself is free). */
+  resolveGate(recastId, input) {
+    return this.client.request("POST", `/v1/recast/${encodeURIComponent(recastId)}/select`, {
+      body: input
+    });
+  }
+};
+
 // src/resources/community.ts
 var CommunityResource = class {
   constructor(client) {
@@ -2194,11 +2324,204 @@ var TutorialsResource = class {
   }
 };
 
-// src/client.ts
-var SDK_VERSION = "1.16.0" ;
+// src/resources/organizations.ts
+var OrganizationsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** The organizations this account belongs to. */
+  list() {
+    return this.client.request("GET", "/v1/orgs");
+  }
+  get(id) {
+    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Create an organization. On instances that require it, `acceptTerms` must
+   * be true or the server answers `terms_required` — the SDK does not decide
+   * whether terms apply, because only the instance knows.
+   *
+   * A new organization may come back `pending`: some instances hold new
+   * organizations for a platform admin to approve, and a pending one grants
+   * nothing until it is active.
+   */
+  create(input) {
+    return this.client.request("POST", "/v1/orgs", { body: input });
+  }
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/orgs/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** Soft-delete. The organization stops granting context; nothing is destroyed. */
+  delete(id) {
+    return this.client.request("DELETE", `/v1/orgs/${encodeURIComponent(id)}`);
+  }
+  /** Hand the organization to another member. The caller becomes an admin. */
+  transferOwnership(id, userId) {
+    return this.client.request("POST", `/v1/orgs/${encodeURIComponent(id)}/transfer-ownership`, {
+      body: { userId }
+    });
+  }
+  /** Leave. An owner cannot — transfer ownership first (`owner_cannot_leave`). */
+  leave(id) {
+    return this.client.request("POST", `/v1/orgs/${encodeURIComponent(id)}/leave`);
+  }
+  // -- members --------------------------------------------------------------
+  listMembers(orgId, opts = {}) {
+    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/members`, { query: { ...opts } });
+  }
+  updateMember(orgId, userId, input) {
+    return this.client.request(
+      "PATCH",
+      `/v1/orgs/${encodeURIComponent(orgId)}/members/${encodeURIComponent(userId)}`,
+      { body: input }
+    );
+  }
+  removeMember(orgId, userId) {
+    return this.client.request(
+      "DELETE",
+      `/v1/orgs/${encodeURIComponent(orgId)}/members/${encodeURIComponent(userId)}`
+    );
+  }
+  // -- invitations ----------------------------------------------------------
+  /**
+   * Invite by email. Returns ONE ROW PER ADDRESS, and a row whose `status` is
+   * not `sent` carries a `link` instead.
+   *
+   * Surface that link. An install with no mail provider — every fresh
+   * self-host — delivers nothing, and an integration that reports "invited"
+   * without showing the link creates invitations nobody can ever reach.
+   */
+  invite(orgId, input) {
+    return this.client.request("POST", `/v1/orgs/${encodeURIComponent(orgId)}/invitations`, { body: input });
+  }
+  listInvitations(orgId, opts = {}) {
+    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/invitations`, {
+      query: { ...opts }
+    });
+  }
+  revokeInvitation(id) {
+    return this.client.request("DELETE", `/v1/invitations/${encodeURIComponent(id)}`);
+  }
+  resendInvitation(id) {
+    return this.client.request("POST", `/v1/invitations/${encodeURIComponent(id)}/resend`);
+  }
+  /**
+   * What an invitee sees before signing in — the one organization read that
+   * needs no token, so it works while the recipient is still signed out.
+   */
+  previewInvitation(token) {
+    return this.client.request("GET", `/v1/invitations/by-token/${encodeURIComponent(token)}`);
+  }
+  /** Accept. Requires an authenticated caller whose email matches the invite. */
+  acceptInvitation(token) {
+    return this.client.request("POST", `/v1/invitations/${encodeURIComponent(token)}/accept`);
+  }
+  // -- audit ----------------------------------------------------------------
+  /**
+   * The organization's audit log, newest first. Owner and admins only, and
+   * readable while the organization is suspended — the record of what
+   * happened is exactly what someone needs when things have gone wrong.
+   */
+  audit(orgId, opts = {}) {
+    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/audit`, { query: { ...opts } });
+  }
+};
+
+// src/resources/workspaces.ts
+var WorkspacesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Every workspace this account belongs to, across all its organizations.
+   *
+   * An identity read: a stale workspace binding cannot lock a caller out of
+   * it, which is what makes it safe to call when a selection has gone bad.
+   *
+   * Byte-for-byte the list `GET /v1/me` carries, so a client reconciles
+   * against one truth rather than two. That is why these are SUMMARIES —
+   * enough to render a switcher, not the full view; use {@link get} for that.
+   */
+  list() {
+    return this.client.request("GET", "/v1/workspaces");
+  }
+  listForOrg(orgId, opts = {}) {
+    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/workspaces`, {
+      query: { includeArchived: opts.includeArchived }
+    });
+  }
+  get(id) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}`);
+  }
+  create(orgId, input) {
+    return this.client.request("POST", `/v1/orgs/${encodeURIComponent(orgId)}/workspaces`, { body: input });
+  }
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/workspaces/${encodeURIComponent(id)}`, { body: input });
+  }
+  /**
+   * Archive or restore. Archiving is REVERSIBLE and destroys nothing: the
+   * workspace stops accepting new work and stays fully readable, which is
+   * what a finished class term needs and a delete would not survive.
+   */
+  setArchived(id, archived) {
+    return this.client.request(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(id)}/${archived ? "archive" : "unarchive"}`
+    );
+  }
+  // -- members --------------------------------------------------------------
+  listMembers(id, opts = {}) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/members`, {
+      query: { ...opts }
+    });
+  }
+  /** Add someone who is ALREADY in the organization. To bring in a new person, invite them. */
+  addMember(id, input) {
+    return this.client.request("POST", `/v1/workspaces/${encodeURIComponent(id)}/members`, { body: input });
+  }
+  updateMember(id, userId, input) {
+    return this.client.request(
+      "PATCH",
+      `/v1/workspaces/${encodeURIComponent(id)}/members/${encodeURIComponent(userId)}`,
+      { body: input }
+    );
+  }
+  removeMember(id, userId) {
+    return this.client.request(
+      "DELETE",
+      `/v1/workspaces/${encodeURIComponent(id)}/members/${encodeURIComponent(userId)}`
+    );
+  }
+  // -- join codes -----------------------------------------------------------
+  /** The workspace's join code, or `null` if none has been created. Admins only. */
+  getJoinCode(id) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/join-code`);
+  }
+  /**
+   * Rotate, enable or disable the code. Rotating invalidates the old one
+   * immediately — that is the point of it, and anyone still holding a link
+   * with the old code will be refused.
+   */
+  actOnJoinCode(id, action) {
+    return this.client.request("POST", `/v1/workspaces/${encodeURIComponent(id)}/join-code`, {
+      body: { action }
+    });
+  }
+  /**
+   * Join by code. Another way IN, so a stale workspace binding must not block
+   * it — the server treats this as an identity route for that reason.
+   */
+  join(code) {
+    return this.client.request("POST", "/v1/workspaces/join", { body: { code } });
+  }
+};
+var SDK_VERSION = "1.19.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
-var NodaroClient = class {
+var NodaroClient = class _NodaroClient {
   baseUrl;
   auth;
   timeoutMs;
@@ -2241,15 +2564,22 @@ var NodaroClient = class {
   presets;
   pickerCatalogs;
   models;
+  shots;
+  recast;
   community;
   templates;
   tutorials;
+  organizations;
+  workspaces;
+  /** The workspace this client acts in; undefined = the personal space. */
+  workspaceId;
   constructor(opts) {
     this.baseUrl = opts.baseUrl.replace(/\/$/, "");
     this.auth = opts.auth;
     this.fetchOverride = opts.fetch;
     this.timeoutMs = opts.timeoutMs ?? 6e4;
     this.clientLabel = opts.clientLabel ?? `sdk/${SDK_VERSION}`;
+    this.workspaceId = opts.workspaceId;
     this.sendClientHeader = opts.clientLabel !== void 0 || !isBrowser();
     this.workflows = new WorkflowsResource(this);
     this.projects = new ProjectsResource(this);
@@ -2276,9 +2606,34 @@ var NodaroClient = class {
     this.presets = new PresetsResource(this);
     this.pickerCatalogs = new PickerCatalogsResource(this);
     this.models = new ModelsResource(this);
+    this.shots = new ShotsResource(this);
+    this.recast = new RecastResource(this);
     this.community = new CommunityResource(this);
     this.templates = new TemplatesResource(this);
     this.tutorials = new TutorialsResource(this);
+    this.organizations = new OrganizationsResource(this);
+    this.workspaces = new WorkspacesResource(this);
+  }
+  /**
+   * A client that acts in `workspaceId`, sharing this one's auth and config.
+   *
+   * A NEW client rather than a setter, deliberately. A mutable selection is
+   * the bug this whole axis exists to prevent: two concurrent operations
+   * against one client would race over which workspace they were in, and the
+   * loser would create work in the wrong place with nothing failing. A
+   * per-workspace client cannot be raced.
+   *
+   * Pass `null` for the personal space.
+   */
+  withWorkspace(workspaceId) {
+    return new _NodaroClient({
+      baseUrl: this.baseUrl,
+      auth: this.auth,
+      timeoutMs: this.timeoutMs,
+      ...this.fetchOverride ? { fetch: this.fetchOverride } : {},
+      ...this.sendClientHeader ? { clientLabel: this.clientLabel } : {},
+      ...workspaceId ? { workspaceId } : {}
+    });
   }
   async request(method, path, options = {}) {
     const url = this.buildUrl(path, options.query);
@@ -2287,6 +2642,9 @@ var NodaroClient = class {
     const headers = {
       ...isFormData ? {} : { "Content-Type": "application/json" },
       ...this.sendClientHeader ? { [CLIENT_HEADER]: this.clientLabel } : {},
+      // Before per-request headers: a resource that needs to reach outside
+      // this client's workspace says so explicitly and wins.
+      ...this.workspaceId ? { [shared.WORKSPACE_HEADER]: this.workspaceId } : {},
       ...options.headers ?? {}
     };
     if (token) headers["Authorization"] = `Bearer ${token}`;
@@ -2320,6 +2678,14 @@ var NodaroClient = class {
    * `GET /v1/me` → the authenticated user's identity (see {@link UserIdentity}).
    * Unwraps the `{ data }` envelope. Throws `UnauthorizedError` (401) when the
    * token is missing/invalid, and the SDK's other typed errors as usual.
+   *
+   * On an instance with organizations it also carries what the caller belongs
+   * to. THREE states, and collapsing them is wrong in a way users feel: the
+   * organization fields ABSENT means this instance has no organizations at
+   * all; present and empty means the account belongs to none; and
+   * `organizationsUnavailable` means the lookup failed — keep whatever
+   * selection you already had rather than concluding the person was removed
+   * from everything.
    */
   async me() {
     const res = await this.request("GET", "/v1/me");
@@ -2439,6 +2805,10 @@ Object.defineProperty(exports, "SURROUND_DIRECTIONS", {
   enumerable: true,
   get: function () { return shared.SURROUND_DIRECTIONS; }
 });
+Object.defineProperty(exports, "WORKSPACE_HEADER", {
+  enumerable: true,
+  get: function () { return shared.WORKSPACE_HEADER; }
+});
 exports.AppsResource = AppsResource;
 exports.AudioResource = AudioResource;
 exports.CREATURE_ASSET_TYPES = CREATURE_ASSET_TYPES;
@@ -2465,13 +2835,16 @@ exports.NodesResource = NodesResource;
 exports.NotFoundError = NotFoundError;
 exports.OAuthResource = OAuthResource;
 exports.ObjectsResource = ObjectsResource;
+exports.OrganizationsResource = OrganizationsResource;
 exports.PickerCatalogsResource = PickerCatalogsResource;
 exports.PipelinesResource = PipelinesResource;
 exports.PresetsResource = PresetsResource;
 exports.ProjectsResource = ProjectsResource;
 exports.PromptHelperResource = PromptHelperResource;
 exports.RateLimitedError = RateLimitedError;
+exports.RecastResource = RecastResource;
 exports.ReduceResource = ReduceResource;
+exports.ShotsResource = ShotsResource;
 exports.StaticTokenAuth = StaticTokenAuth;
 exports.StorageExceededError = StorageExceededError;
 exports.TemplatesResource = TemplatesResource;
@@ -2482,6 +2855,7 @@ exports.VideoProResource = VideoProResource;
 exports.VoicesResource = VoicesResource;
 exports.WorkflowConflictError = WorkflowConflictError;
 exports.WorkflowsResource = WorkflowsResource;
+exports.WorkspacesResource = WorkspacesResource;
 exports.buildPersonSeedPrompt = buildPersonSeedPrompt;
 exports.createClient = createClient;
 exports.supabaseAuth = supabaseAuth;