@nodaro/sdk 2.29.0 → 2.31.0

package/dist/chunk-N6GLZOE4.cjs

@@ -0,0 +1,282 @@
+'use strict';
+
+// src/errors.ts
+var NodaroError = class extends Error {
+  constructor(message, code, status) {
+    super(message);
+    this.code = code;
+    this.status = status;
+    this.name = "NodaroError";
+  }
+  code;
+  status;
+};
+var UnauthorizedError = class extends NodaroError {
+  constructor(message = "Authentication required") {
+    super(message, "unauthorized", 401);
+    this.name = "UnauthorizedError";
+  }
+};
+var ForbiddenError = class extends NodaroError {
+  constructor(message = "Forbidden", missingScope) {
+    super(message, "forbidden", 403);
+    this.missingScope = missingScope;
+    this.name = "ForbiddenError";
+  }
+  missingScope;
+};
+var NotFoundError = class extends NodaroError {
+  constructor(message = "Not found") {
+    super(message, "not_found", 404);
+    this.name = "NotFoundError";
+  }
+};
+var RateLimitedError = class extends NodaroError {
+  constructor(message = "Rate limited") {
+    super(message, "rate_limited", 429);
+    this.name = "RateLimitedError";
+  }
+};
+var InsufficientCreditsError = class extends NodaroError {
+  constructor(message = "Insufficient credits", required, available) {
+    super(message, "insufficient_credits", 402);
+    this.required = required;
+    this.available = available;
+    this.name = "InsufficientCreditsError";
+  }
+  required;
+  available;
+};
+var StorageExceededError = class extends NodaroError {
+  constructor(message = "Storage exceeded", limitBytes) {
+    super(message, "storage_exceeded", 413);
+    this.limitBytes = limitBytes;
+    this.name = "StorageExceededError";
+  }
+  limitBytes;
+};
+var WorkflowConflictError = class extends NodaroError {
+  constructor(message = "Workflow was updated by another writer", currentUpdatedAt, currentVersion, currentRecord, code = "workflow_conflict") {
+    super(message, code, 409);
+    this.currentUpdatedAt = currentUpdatedAt;
+    this.currentVersion = currentVersion;
+    this.currentRecord = currentRecord;
+    this.name = "WorkflowConflictError";
+  }
+  currentUpdatedAt;
+  currentVersion;
+  currentRecord;
+};
+var StudioOpError = class extends NodaroError {
+  constructor(message, code, status, opIndex) {
+    super(message, code, status);
+    this.opIndex = opIndex;
+    this.name = "StudioOpError";
+  }
+  opIndex;
+};
+var CONTINUATION_REFUSAL_CODES = /* @__PURE__ */ new Set([
+  "already_running",
+  "continuation_superseded",
+  "render_final_already_rendered"
+]);
+var ContinuationRefusedError = class extends NodaroError {
+  constructor(message, code, jobId) {
+    super(message, code, 409);
+    this.jobId = jobId;
+    this.name = "ContinuationRefusedError";
+  }
+  jobId;
+};
+var ContinuationPreviewPendingError = class extends NodaroError {
+  constructor(message, executionId, renderNodeIds, reviewNodeIds, next) {
+    super(message, "continuation_preview_pending", 409);
+    this.executionId = executionId;
+    this.renderNodeIds = renderNodeIds;
+    this.reviewNodeIds = reviewNodeIds;
+    this.next = next;
+    this.name = "ContinuationPreviewPendingError";
+  }
+  executionId;
+  renderNodeIds;
+  reviewNodeIds;
+  next;
+};
+var stringList = (v) => Array.isArray(v) ? v.filter((id) => typeof id === "string") : [];
+function heldFinalRunOf(v) {
+  if (!v || typeof v !== "object") return void 0;
+  const r = v;
+  if (typeof r.continueFromExecutionId !== "string" || !Array.isArray(r.nodeIds)) return void 0;
+  if (!r.inputOverrides || typeof r.inputOverrides !== "object" || Array.isArray(r.inputOverrides)) return void 0;
+  return {
+    continueFromExecutionId: r.continueFromExecutionId,
+    nodeIds: stringList(r.nodeIds),
+    inputOverrides: r.inputOverrides
+  };
+}
+var AlreadyRunningError = class extends NodaroError {
+  constructor(message, executionId) {
+    super(message, "already_running", 409);
+    this.executionId = executionId;
+    this.name = "AlreadyRunningError";
+  }
+  executionId;
+};
+var AppRunVersionChangedError = class extends NodaroError {
+  constructor(message, runVersion, appVersion) {
+    super(message, "app_run_version_changed", 409);
+    this.runVersion = runVersion;
+    this.appVersion = appVersion;
+    this.name = "AppRunVersionChangedError";
+  }
+  runVersion;
+  appVersion;
+};
+var JobBlockedError = class extends NodaroError {
+  constructor(message = "Blocked by this deployment's content policy") {
+    super(message, "job_blocked", 422);
+    this.name = "JobBlockedError";
+  }
+};
+var JobFailedError = class extends NodaroError {
+  constructor(message, jobId, jobStatus = "failed") {
+    super(message, "job_failed", 0);
+    this.jobId = jobId;
+    this.jobStatus = jobStatus;
+    this.name = "JobFailedError";
+  }
+  jobId;
+  jobStatus;
+};
+var JobTimeoutError = class extends NodaroError {
+  constructor(message, jobId, timeoutMs) {
+    super(message, "job_timeout", 0);
+    this.jobId = jobId;
+    this.timeoutMs = timeoutMs;
+    this.name = "JobTimeoutError";
+  }
+  jobId;
+  timeoutMs;
+};
+var JobAbortedError = class extends NodaroError {
+  constructor(message = "Aborted", jobId) {
+    super(message, "job_aborted", 0);
+    this.jobId = jobId;
+    this.name = "JobAbortedError";
+  }
+  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);
+    this.jobId = jobId;
+    this.name = "JobHeldError";
+  }
+  jobId;
+};
+var finite = (v) => typeof v === "number" && Number.isFinite(v) ? v : void 0;
+var BARE_CODE = /^[a-z][a-z0-9_]*$/;
+var nonEmpty = (v) => typeof v === "string" && v.length > 0 ? v : void 0;
+function readErrorBody(status, body) {
+  const raw = body.error;
+  const envelope = raw && typeof raw === "object" ? raw : {};
+  const bare = typeof raw === "string" ? raw : void 0;
+  const bareCode = bare !== void 0 && BARE_CODE.test(bare) ? bare : void 0;
+  const bareSentence = bare !== void 0 && bareCode === void 0 && /\s/.test(bare.trim()) ? bare : void 0;
+  const code = nonEmpty(envelope.code) ?? bareCode ?? (status === 400 && raw === void 0 && Array.isArray(body.issues) ? "validation_error" : void 0);
+  const outside = status >= 500 ? void 0 : nonEmpty(body.message) ?? nonEmpty(body.error_description) ?? bareSentence;
+  const message = nonEmpty(envelope.message) ?? outside;
+  return { code, message, envelope };
+}
+function throwFromResponse(status, body) {
+  const parsed = body && typeof body === "object" ? body : {};
+  const read = readErrorBody(status, parsed);
+  const envelope = read.envelope;
+  const code = read.code ?? "internal_error";
+  const message = read.message ?? (read.code ? read.code : "Request failed");
+  if (status === 401) throw new UnauthorizedError(read.message);
+  if (status === 409 && (code === "workflow_conflict" || code === "production_busy")) {
+    throw new WorkflowConflictError(
+      read.message,
+      envelope.currentUpdatedAt,
+      envelope.currentVersion,
+      envelope.currentRecord,
+      code
+    );
+  }
+  if (status >= 400 && status < 500 && typeof envelope.opIndex === "number") {
+    throw new StudioOpError(message, code, status, envelope.opIndex);
+  }
+  if (status === 409 && CONTINUATION_REFUSAL_CODES.has(code) && typeof parsed.jobId === "string") {
+    throw new ContinuationRefusedError(message, code, parsed.jobId);
+  }
+  if (status === 409 && code === "continuation_preview_pending" && typeof parsed.executionId === "string") {
+    throw new ContinuationPreviewPendingError(
+      message,
+      parsed.executionId,
+      stringList(parsed.renderNodeIds),
+      stringList(parsed.reviewNodeIds),
+      heldFinalRunOf(parsed.next)
+    );
+  }
+  if (status === 409 && code === "already_running" && typeof parsed.executionId === "string") {
+    throw new AlreadyRunningError(message, parsed.executionId);
+  }
+  if (status === 409 && code === "app_run_version_changed") {
+    throw new AppRunVersionChangedError(message, finite(parsed.runVersion), finite(parsed.appVersion));
+  }
+  if (status === 422 && code === "job_blocked") throw new JobBlockedError(read.message);
+  if (status === 403 && code === "insufficient_scope") {
+    throw new ForbiddenError(read.message, envelope.missingScope);
+  }
+  if (status === 403) throw new ForbiddenError(read.message);
+  if (status === 404) throw new NotFoundError(read.message);
+  if (status === 429) throw new RateLimitedError(read.message);
+  if (status === 402) {
+    throw new InsufficientCreditsError(
+      read.message,
+      finite(envelope.required) ?? finite(parsed.required),
+      finite(envelope.available) ?? finite(parsed.balance)
+    );
+  }
+  if (status === 413) throw new StorageExceededError(read.message, envelope.limitBytes);
+  throw new NodaroError(message, code, status);
+}
+
+exports.AlreadyRunningError = AlreadyRunningError;
+exports.AppRunVersionChangedError = AppRunVersionChangedError;
+exports.ContinuationPreviewPendingError = ContinuationPreviewPendingError;
+exports.ContinuationRefusedError = ContinuationRefusedError;
+exports.ForbiddenError = ForbiddenError;
+exports.InsufficientCreditsError = InsufficientCreditsError;
+exports.JobAbortedError = JobAbortedError;
+exports.JobBlockedError = JobBlockedError;
+exports.JobFailedError = JobFailedError;
+exports.JobHeldError = JobHeldError;
+exports.JobTimeoutError = JobTimeoutError;
+exports.NodaroError = NodaroError;
+exports.NotFoundError = NotFoundError;
+exports.RateLimitedError = RateLimitedError;
+exports.StorageExceededError = StorageExceededError;
+exports.StudioOpError = StudioOpError;
+exports.StudioPreviewAppliedError = StudioPreviewAppliedError;
+exports.StudioPreviewUnavailable = StudioPreviewUnavailable;
+exports.UnauthorizedError = UnauthorizedError;
+exports.WorkflowConflictError = WorkflowConflictError;
+exports.throwFromResponse = throwFromResponse;
+//# sourceMappingURL=chunk-N6GLZOE4.cjs.map
+//# sourceMappingURL=chunk-N6GLZOE4.cjs.map

package/dist/chunk-N6GLZOE4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":"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","file":"chunk-N6GLZOE4.cjs","sourcesContent":["import type { StudioOpsResponse } from \"./resources/studio-productions.js\"\n\nexport class NodaroError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly status: number,\n  ) {\n    super(message)\n    this.name = \"NodaroError\"\n  }\n}\n\nexport class UnauthorizedError extends NodaroError {\n  constructor(message = \"Authentication required\") {\n    super(message, \"unauthorized\", 401)\n    this.name = \"UnauthorizedError\"\n  }\n}\n\nexport class ForbiddenError extends NodaroError {\n  constructor(message = \"Forbidden\", public readonly missingScope?: string) {\n    super(message, \"forbidden\", 403)\n    this.name = \"ForbiddenError\"\n  }\n}\n\nexport class NotFoundError extends NodaroError {\n  constructor(message = \"Not found\") {\n    super(message, \"not_found\", 404)\n    this.name = \"NotFoundError\"\n  }\n}\n\nexport class RateLimitedError extends NodaroError {\n  constructor(message = \"Rate limited\") {\n    super(message, \"rate_limited\", 429)\n    this.name = \"RateLimitedError\"\n  }\n}\n\nexport class InsufficientCreditsError extends NodaroError {\n  constructor(\n    message = \"Insufficient credits\",\n    public readonly required?: number,\n    public readonly available?: number,\n  ) {\n    super(message, \"insufficient_credits\", 402)\n    this.name = \"InsufficientCreditsError\"\n  }\n}\n\nexport class StorageExceededError extends NodaroError {\n  constructor(message = \"Storage exceeded\", public readonly limitBytes?: number) {\n    super(message, \"storage_exceeded\", 413)\n    this.name = \"StorageExceededError\"\n  }\n}\n\n/**\n * Optimistic-concurrency rejection (HTTP 409 `workflow_conflict`): the workflow\n * was written by another tab/device after the state carried in\n * `expectedUpdatedAt`/`expectedVersion` was read. `currentRecord` — when the\n * server includes it — is the full current workflow: merge your changes onto it\n * and retry with its fresh `updatedAt`, no follow-up GET needed.\n */\nexport class WorkflowConflictError extends NodaroError {\n  constructor(\n    message = \"Workflow was updated by another writer\",\n    public readonly currentUpdatedAt?: string,\n    public readonly currentVersion?: number,\n    public readonly currentRecord?: Record<string, unknown>,\n    /**\n     * The wire code this conflict actually arrived with.\n     *\n     * `production_busy` is the studio production routes' own 409: the row\n     * changed under a read-modify-write and the server exhausted its retries.\n     * It is the same situation and the same remedy — re-read and apply again —\n     * so it is the same ERROR, and a caller catching `WorkflowConflictError`\n     * handles both. The code stays truthful because a caller that logs or\n     * branches on it should see what the server said, not what the class is\n     * usually called.\n     */\n    code: WorkflowConflictCode = \"workflow_conflict\",\n  ) {\n    super(message, code, 409)\n    this.name = \"WorkflowConflictError\"\n  }\n}\n\n/** The 409 codes that mean \"somebody else wrote first; re-read and retry\". */\nexport type WorkflowConflictCode = \"workflow_conflict\" | \"production_busy\"\n\n/**\n * A studio operation batch was refused, and the error names WHICH operation\n * (`opIndex`, zero-based) was wrong. Nothing in the batch was written: a batch\n * applies atomically or not at all, so fix that one operation and send the\n * whole batch again.\n *\n * Selected by SHAPE — any 4xx carrying a numeric `opIndex` — not by a list of\n * codes, so a new refusal reason (`op_invalid`, `op_target_missing`, whatever\n * the server adds next) reaches the caller as this error without an SDK\n * release. `code` is whatever the server sent.\n */\nexport class StudioOpError extends NodaroError {\n  constructor(\n    message: string,\n    code: string,\n    status: number,\n    /** Zero-based index into the `ops` array that was sent. */\n    public readonly opIndex: number,\n  ) {\n    super(message, code, status)\n    this.name = \"StudioOpError\"\n  }\n}\n\n/** The 409 codes whose answer names the job to turn to instead (a top-level `jobId`). */\nconst CONTINUATION_REFUSAL_CODES: ReadonlySet<string> = new Set([\n  \"already_running\",\n  \"continuation_superseded\",\n  \"render_final_already_rendered\",\n])\n\n/**\n * A 409 that names the job to turn to instead: continuing a use-case run\n * (`client.edit.continueUseCase`) answers `already_running` (a continuation is\n * under way, or one that already completed — follow `jobId`),\n * `continuation_superseded` (a later continuation failed too — continue\n * `jobId` instead) or `render_final_already_rendered` (a Render final with this\n * very edit already completed — `jobId` holds the result). `code` and `status`\n * are what the server sent. Selected for exactly those three codes when the\n * answer carries a top-level `jobId`; every other 409 stays a plain\n * `NodaroError`.\n */\nexport class ContinuationRefusedError extends NodaroError {\n  constructor(\n    message: string,\n    code: string,\n    /** The job the refusal names. */\n    public readonly jobId: string,\n  ) {\n    super(message, code, 409)\n    this.name = \"ContinuationRefusedError\"\n  }\n}\n\n/**\n * The one run that finishes a continuation held at a Preview review (the\n * `next` of {@link ContinuationPreviewPendingError}): pass these three fields\n * to `client.workflows.run`. It continues that execution, runs each held render\n * at Final and each held Tighten Episode continuing the run that made its\n * Preview, then every node after them.\n */\nexport interface HeldFinalRun {\n  continueFromExecutionId: string\n  /** The nodes it runs, in canvas order. */\n  nodeIds: string[]\n  /** For this run only: each held render at Final, each held use-case node's `useCaseContinue`. */\n  inputOverrides: Record<string, Record<string, unknown>>\n}\n\n/**\n * HTTP 409 `continuation_preview_pending`: a continue-from-failed\n * (`client.workflows.run` with `continueMode: \"from-failed\"`) whose run's\n * newest later continuation completed by stopping at a Preview review, so\n * continuing again would stop there too. `executionId` is that continuation;\n * `renderNodeIds` the Apply EDL renders and `reviewNodeIds` the Tighten Episode\n * nodes holding it; `next` the run that finishes them — send it first\n * (`client.workflows.run(workflowId, error.next)`), then continue. Absent only\n * when the server could not name it. For a single held render, `next` is that\n * render's `client.workflows.renderFinal`.\n */\nexport class ContinuationPreviewPendingError extends NodaroError {\n  constructor(\n    message: string,\n    public readonly executionId: string,\n    public readonly renderNodeIds: readonly string[],\n    public readonly reviewNodeIds: readonly string[],\n    public readonly next?: HeldFinalRun,\n  ) {\n    super(message, \"continuation_preview_pending\", 409)\n    this.name = \"ContinuationPreviewPendingError\"\n  }\n}\n\nconst stringList = (v: unknown): string[] => (Array.isArray(v) ? v.filter((id): id is string => typeof id === \"string\") : [])\n\n/** A `next` as the server sends it, or undefined for anything else. */\nfunction heldFinalRunOf(v: unknown): HeldFinalRun | undefined {\n  if (!v || typeof v !== \"object\") return undefined\n  const r = v as Record<string, unknown>\n  if (typeof r.continueFromExecutionId !== \"string\" || !Array.isArray(r.nodeIds)) return undefined\n  if (!r.inputOverrides || typeof r.inputOverrides !== \"object\" || Array.isArray(r.inputOverrides)) return undefined\n  return {\n    continueFromExecutionId: r.continueFromExecutionId,\n    nodeIds: stringList(r.nodeIds),\n    inputOverrides: r.inputOverrides as Record<string, Record<string, unknown>>,\n  }\n}\n\n/**\n * HTTP 409 `already_running` that names the execution under way (a top-level\n * `executionId`): the run you asked to start or continue is still running —\n * follow `executionId` (`client.executions.get`) instead of starting it again.\n * Sent by the workflow run route and by an app run's Retry\n * (`client.apps.resume`). An `already_running` that names a job instead stays\n * {@link ContinuationRefusedError}; one that names nothing, a plain\n * `NodaroError`.\n */\nexport class AlreadyRunningError extends NodaroError {\n  constructor(\n    message: string,\n    /** The execution under way. */\n    public readonly executionId: string,\n  ) {\n    super(message, \"already_running\", 409)\n    this.name = \"AlreadyRunningError\"\n  }\n}\n\n/**\n * HTTP 409 `app_run_version_changed`: a Retry of a failed app run\n * (`client.apps.resume`) refused because the app is on another version than\n * the one the run ran — continuing would mix them. `runVersion` is the run's\n * version, `appVersion` the one you are on (the `version` you sent, else the\n * app's latest). Start the run over (`client.apps.run`) to run `appVersion`,\n * or send `{ version: runVersion }` to continue on the run's own version.\n * Nothing was written or billed. Selected by code; the two numbers are\n * `undefined` when the answer does not carry them.\n */\nexport class AppRunVersionChangedError extends NodaroError {\n  constructor(\n    message: string,\n    public readonly runVersion?: number,\n    public readonly appVersion?: number,\n  ) {\n    super(message, \"app_run_version_changed\", 409)\n    this.name = \"AppRunVersionChangedError\"\n  }\n}\n\n/**\n * HTTP 422 `job_blocked`. A job policy registered by this deployment refused\n * the generation **before it ran** — no job was created, nothing was reserved\n * and nothing was charged. `message` is the policy's user-safe text: show it\n * as-is. Do not retry the identical request; whether the same input would be\n * judged differently is the deployment's policy's business.\n *\n * Only occurs on deployments that register a job policy. Selected by `code`,\n * not by status, the same way `workflow_conflict` narrows a 409 above — any\n * other 422 stays a plain `NodaroError`.\n */\nexport class JobBlockedError extends NodaroError {\n  constructor(message = \"Blocked by this deployment's content policy\") {\n    super(message, \"job_blocked\", 422)\n    this.name = \"JobBlockedError\"\n  }\n}\n\n/**\n * A job reached a terminal `failed`/`cancelled` status while being awaited by\n * `nodes.runAndWait` / `nodes.runMany`. Not an HTTP-level error (the polls\n * themselves succeeded), so `status` is 0 — distinguish it by type/`code`.\n * Carries the job's own `error_message` (as the message) and `jobId`.\n */\nexport class JobFailedError extends NodaroError {\n  constructor(\n    message: string,\n    public readonly jobId: string,\n    /** The terminal status that triggered the failure (`failed` | `cancelled`). */\n    public readonly jobStatus: \"failed\" | \"cancelled\" = \"failed\",\n  ) {\n    super(message, \"job_failed\", 0)\n    this.name = \"JobFailedError\"\n  }\n}\n\n/**\n * `nodes.runAndWait` polled past its `maxMs` deadline without the job reaching\n * a terminal status. Not an HTTP error — `status` is 0; catch by type/`code`.\n */\nexport class JobTimeoutError extends NodaroError {\n  constructor(\n    message: string,\n    public readonly jobId: string,\n    /** The wall-clock deadline (ms) that was exceeded. */\n    public readonly timeoutMs: number,\n  ) {\n    super(message, \"job_timeout\", 0)\n    this.name = \"JobTimeoutError\"\n  }\n}\n\n/**\n * The caller's `AbortSignal` fired while `nodes.runAndWait` was polling (or it\n * was already aborted on entry). Polling stops and this rejects. Not an HTTP\n * error — `status` is 0; catch by type/`code`.\n */\nexport class JobAbortedError extends NodaroError {\n  constructor(message = \"Aborted\", public readonly jobId?: string) {\n    super(message, \"job_aborted\", 0)\n    this.name = \"JobAbortedError\"\n  }\n}\n\n/**\n * A batch preview was asked for and this deployment cannot give one, so\n * NOTHING was sent: the batch is still unapplied and the production untouched.\n *\n * A preview is two requests because the route's body is parsed in strip mode —\n * a deployment that predates the preview silently DROPS the flag and APPLIES\n * the batch. So the SDK asks with an EMPTY batch first and sends the real one\n * only when that answer carries the `dryRun` marker. This is what it throws\n * when the answer does not: whatever the older deployment made of an empty\n * batch, the caller's batch never left.\n *\n * The remedy is a deployment that serves the preview — there is nothing to\n * retry here. To apply the batch instead, send it without the flag.\n *\n * A deployment that REFUSES the empty batch outright throws its own error\n * instead of this one, which is the right way round: the route's message says\n * more than \"unavailable\" does.\n *\n * Not an HTTP error: the request itself succeeded and answered the older shape.\n * `status` is 0; catch by type/`code`.\n */\nexport class StudioPreviewUnavailable extends NodaroError {\n  constructor(\n    message = \"This deployment does not preview operation batches; nothing was sent\",\n  ) {\n    super(message, \"studio_preview_unavailable\", 0)\n    this.name = \"StudioPreviewUnavailable\"\n  }\n}\n\n/**\n * A batch preview was asked for and the batch was APPLIED instead. The\n * production is written; this is the opposite of {@link\n * StudioPreviewUnavailable}, where nothing was sent.\n *\n * How it happens: the preview's proving ping and the batch are two requests,\n * and a fleet mid-rollout can serve them from different deployments. The ping\n * answers the marker, the batch reaches a deployment that predates the preview,\n * parses in strip mode, drops the flag and writes. The SDK cannot recall that\n * request — by the time the answer comes back the change has landed — so it\n * refuses to call the result a preview, which is the only thing still in its\n * gift. `receipts` and `warnings` are on both shapes, so an unchecked reply\n * would have shown a person what ALREADY happened under the heading of what\n * would.\n *\n * `applied` is what the route answered: the ordinary apply reply, whose\n * `production` and `version` are now the truth. Adopt them the way a plain\n * apply's caller does — do NOT re-send the batch, and do not present it for\n * approval.\n *\n * Not an HTTP error: the request succeeded, at the wrong thing. `status` is 0.\n */\nexport class StudioPreviewAppliedError extends NodaroError {\n  constructor(\n    /**\n     * The apply reply the route sent back, as it sent it. An answer this\n     * package does not recognise arrives here unchanged rather than being\n     * dressed up: it is what the deployment said about a batch it took.\n     *\n     * `undefined` when the answer carried no body at all — a 204, an empty\n     * envelope. The refusal still fires, because a non-preview answer is never\n     * handed back as a preview, but there is nothing to report and the SDK will\n     * not invent it: whether the batch was applied is unknown from here, and\n     * the caller settles it by re-reading the production.\n     */\n    public readonly applied: StudioOpsResponse | undefined,\n    message = applied\n      ? \"Asked for a preview and this deployment APPLIED the batch; the change is written — see `applied`\"\n      : \"Asked for a preview and this deployment answered with neither one nor a body to read; the batch may have been applied — re-read the production before deciding anything\",\n  ) {\n    super(message, \"studio_preview_applied\", 0)\n    this.name = \"StudioPreviewAppliedError\"\n  }\n}\n\n/**\n * The awaited job entered `pending_review`: a job policy registered by this\n * deployment held its output for a human reviewer. `pending_review` is\n * IN-FLIGHT, not terminal, so `nodes.runAndWait` / `nodes.runMany` end the\n * poll on the first tick they observe it rather than burning `maxMs` on a\n * status that no longer moves on its own.\n *\n * This does NOT cancel the job — the output exists, a human is reviewing it,\n * and the credit reservation stays `reserved` for the whole hold. Do not\n * re-run the request (a duplicate would be held too): re-fetch with\n * `jobs.get(jobId)` later, or surface \"awaiting review\" to your user and poll\n * `jobs.getStatus()` yourself. It resolves to `completed` (approved), `failed`\n * (rejected, with `error_hint.kind === \"policy-block\"`) or `cancelled`.\n *\n * Not an HTTP error — `status` is 0; catch by type/`code`.\n */\nexport class JobHeldError extends NodaroError {\n  constructor(\n    message: string,\n    public readonly jobId: string,\n  ) {\n    super(message, \"job_held\", 0)\n    this.name = \"JobHeldError\"\n  }\n}\n\n/** The `{ error: { code, message, … } }` envelope every current route sends. */\ninterface ApiErrorEnvelope {\n  code?: string\n  message?: string\n  missingScope?: string\n  required?: number\n  available?: number\n  limitBytes?: number\n  opIndex?: number\n  [key: string]: unknown\n}\n\ninterface ApiErrorBody {\n  /** The envelope — or, on an older route, a bare string (see {@link readErrorBody}). */\n  error?: ApiErrorEnvelope | string\n  /** A top-level message: an older route's, a bare validation answer's, or the server framework's own. */\n  message?: unknown\n  /** OAuth's human text (RFC 6749 §5.2), beside a bare-string `error`. */\n  error_description?: unknown\n  /** A bare validation answer's per-field issues (`{ message, issues }`). */\n  issues?: unknown\n  /** A refusal that names another job (see {@link ContinuationRefusedError}). */\n  jobId?: unknown\n  /** `continuation_preview_pending`: the held continuation, what holds it, and the run that finishes it. */\n  executionId?: unknown\n  renderNodeIds?: unknown\n  reviewNodeIds?: unknown\n  next?: unknown\n  /** The credit guard's 402 sends its figures beside the envelope: what the run needs… */\n  required?: unknown\n  /** …and what the caller has (withheld on a deployment-paid instance). */\n  balance?: unknown\n  /** `app_run_version_changed`: the version the run ran, and the one the caller is on. */\n  runVersion?: unknown\n  appVersion?: unknown\n}\n\nconst finite = (v: unknown): number | undefined => (typeof v === \"number\" && Number.isFinite(v) ? v : undefined)\n\n/** A machine code as an older route writes it: lower snake_case, never a sentence or a reason phrase. */\nconst BARE_CODE = /^[a-z][a-z0-9_]*$/\n\nconst nonEmpty = (v: unknown): string | undefined => (typeof v === \"string\" && v.length > 0 ? v : undefined)\n\n/**\n * Where a body keeps its code and its human message. Most routes send the\n * envelope `{ error: { code, message } }`; three other shapes reach the SDK\n * too, and each is read for what it says rather than collapsed into\n * `internal_error` / \"Request failed\":\n *\n * - an older route's bare string, `{ error: \"<code>\", message?, … }` (character\n *   training, a few profile and billing routes), and OAuth's\n *   `{ error: \"<code>\", error_description }`. A snake_case string is the code;\n *   a sentence (`\"Profile not found\"`) is the message.\n * - a bare validation answer, `{ message, issues: [...] }`: `validation_error`.\n * - the server framework's own answer, `{ statusCode, error: \"<reason phrase>\",\n *   message }` (a route it does not have): the reason phrase is neither, the\n *   message is kept — so \"no such route\" stays distinguishable from \"no such\n *   resource\".\n *\n * At HTTP 500 and above only the CODE is read from outside the envelope. Text\n * there can be whatever the server failed with: the framework's own answer to\n * an uncaught throw is `{ statusCode: 500, error: \"Internal Server Error\",\n * message: <the raw error> }`, and the server's sanitizer rewrites only the\n * `internal_error` envelope. The envelope's own message is a route's chosen\n * sentence and is read at every status, as before.\n *\n * `message` is undefined when the body carries no human text it may show, so a\n * typed class keeps its own default (\"Not found\").\n */\nfunction readErrorBody(status: number, body: ApiErrorBody): { code: string | undefined; message: string | undefined; envelope: ApiErrorEnvelope } {\n  const raw = body.error\n  const envelope: ApiErrorEnvelope = raw && typeof raw === \"object\" ? raw : {}\n  const bare = typeof raw === \"string\" ? raw : undefined\n  const bareCode = bare !== undefined && BARE_CODE.test(bare) ? bare : undefined\n  // Words with a space between them are human text: an older route's sentence,\n  // or the framework's reason phrase — which always arrives with a real\n  // `message`, read first. A single capitalised word (\"Unauthorized\") is a\n  // reason phrase alone and says nothing the status does not.\n  const bareSentence = bare !== undefined && bareCode === undefined && /\\s/.test(bare.trim()) ? bare : undefined\n  const code =\n    nonEmpty(envelope.code) ??\n    bareCode ??\n    (status === 400 && raw === undefined && Array.isArray(body.issues) ? \"validation_error\" : undefined)\n  const outside = status >= 500 ? undefined : (nonEmpty(body.message) ?? nonEmpty(body.error_description) ?? bareSentence)\n  const message = nonEmpty(envelope.message) ?? outside\n  return { code, message, envelope }\n}\n\nexport function throwFromResponse(status: number, body: ApiErrorBody): never {\n  // A body that is not an object (an empty answer, `null`, a bare string) still\n  // throws by its status.\n  const parsed: ApiErrorBody = body && typeof body === \"object\" ? body : {}\n  const read = readErrorBody(status, parsed)\n  const envelope = read.envelope\n  const code = read.code ?? \"internal_error\"\n  // A typed class falls back to its own default; a generic error to the code\n  // it carries, which says more than \"Request failed\" does.\n  const message = read.message ?? (read.code ? read.code : \"Request failed\")\n  if (status === 401) throw new UnauthorizedError(read.message)\n  if (status === 409 && (code === \"workflow_conflict\" || code === \"production_busy\")) {\n    throw new WorkflowConflictError(\n      read.message,\n      envelope.currentUpdatedAt as string | undefined,\n      envelope.currentVersion as number | undefined,\n      envelope.currentRecord as Record<string, unknown> | undefined,\n      code,\n    )\n  }\n  // By shape, not by code — see StudioOpError. Only the studio operations route\n  // sends an op index, so this cannot capture anyone else's 400.\n  if (status >= 400 && status < 500 && typeof envelope.opIndex === \"number\") {\n    throw new StudioOpError(message, code, status, envelope.opIndex)\n  }\n  if (status === 409 && CONTINUATION_REFUSAL_CODES.has(code) && typeof parsed.jobId === \"string\") {\n    throw new ContinuationRefusedError(message, code, parsed.jobId)\n  }\n  if (status === 409 && code === \"continuation_preview_pending\" && typeof parsed.executionId === \"string\") {\n    throw new ContinuationPreviewPendingError(\n      message,\n      parsed.executionId,\n      stringList(parsed.renderNodeIds),\n      stringList(parsed.reviewNodeIds),\n      heldFinalRunOf(parsed.next),\n    )\n  }\n  if (status === 409 && code === \"already_running\" && typeof parsed.executionId === \"string\") {\n    throw new AlreadyRunningError(message, parsed.executionId)\n  }\n  if (status === 409 && code === \"app_run_version_changed\") {\n    throw new AppRunVersionChangedError(message, finite(parsed.runVersion), finite(parsed.appVersion))\n  }\n  if (status === 422 && code === \"job_blocked\") throw new JobBlockedError(read.message)\n  if (status === 403 && code === \"insufficient_scope\") {\n    throw new ForbiddenError(read.message, envelope.missingScope)\n  }\n  if (status === 403) throw new ForbiddenError(read.message)\n  // A 404 the framework answered itself (no route at that path) carries its\n  // message at the top level, not under `error`; `readErrorBody` keeps it so\n  // callers can tell \"no such route\" from \"no such resource\".\n  if (status === 404) throw new NotFoundError(read.message)\n  if (status === 429) throw new RateLimitedError(read.message)\n  if (status === 402) {\n    // The credit guard puts `required` / `balance` beside the envelope; an\n    // envelope that carries them (`required` / `available`) is read first.\n    throw new InsufficientCreditsError(\n      read.message,\n      finite(envelope.required) ?? finite(parsed.required),\n      finite(envelope.available) ?? finite(parsed.balance),\n    )\n  }\n  if (status === 413) throw new StorageExceededError(read.message, envelope.limitBytes)\n  throw new NodaroError(message, code, status)\n}\n"]}

package/dist/chunk-NBVARNVA.cjs

@@ -0,0 +1,38 @@
+'use strict';
+
+// src/resources/palettes.ts
+var PALETTE_DIRECTION_PREFIX = "palette:";
+function paletteDirectionId(id) {
+  return `${PALETTE_DIRECTION_PREFIX}${id}`;
+}
+var PalettesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Your palettes, newest first. Page with `nextCursor`. */
+  list(params = {}) {
+    return this.client.request("GET", "/v1/palettes", {
+      query: { limit: params.limit, cursor: params.cursor }
+    });
+  }
+  get(id) {
+    return this.client.request("GET", `/v1/palettes/${encodeURIComponent(id)}`);
+  }
+  create(input) {
+    return this.client.request("POST", "/v1/palettes", { body: input });
+  }
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/palettes/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** A run that still names the palette answers 404 `direction_not_found`. */
+  async delete(id) {
+    await this.client.request("DELETE", `/v1/palettes/${encodeURIComponent(id)}`);
+  }
+};
+
+exports.PALETTE_DIRECTION_PREFIX = PALETTE_DIRECTION_PREFIX;
+exports.PalettesResource = PalettesResource;
+exports.paletteDirectionId = paletteDirectionId;
+//# sourceMappingURL=chunk-NBVARNVA.cjs.map
+//# sourceMappingURL=chunk-NBVARNVA.cjs.map

package/dist/chunk-NBVARNVA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/palettes.ts"],"names":[],"mappings":";;;AA4CO,IAAM,wBAAA,GAA2B;AAQjC,SAAS,mBAAmB,EAAA,EAAiC;AAClE,EAAA,OAAO,CAAA,EAAG,wBAAwB,CAAA,EAAG,EAAE,CAAA,CAAA;AACzC;AASO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,CAAK,MAAA,GAA6B,EAAC,EAAyB;AAC1D,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAqB,KAAA,EAAO,cAAA,EAAgB;AAAA,MAC7D,OAAO,EAAE,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,EAAQ,OAAO,MAAA;AAAO,KACrD,CAAA;AAAA,EACH;AAAA,EAEA,IAAI,EAAA,EAAmC;AACrC,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAsB,KAAA,EAAO,gBAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EAC1F;AAAA,EAEA,OAAO,KAAA,EAAkD;AACvD,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAsB,MAAA,EAAQ,gBAAgB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAClF;AAAA,EAEA,MAAA,CAAO,IAAY,KAAA,EAAkD;AACnE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAsB,OAAA,EAAS,CAAA,aAAA,EAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA,EAAI,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,EAC7G;AAAA;AAAA,EAGA,MAAM,OAAO,EAAA,EAA2B;AACtC,IAAA,MAAM,IAAA,CAAK,OAAO,OAAA,CAA2B,QAAA,EAAU,gBAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACjG;AACF","file":"chunk-NBVARNVA.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/** One of your colour palettes. */\nexport interface ColorPalette {\n  id: string\n  name: string\n  /** 2–12 colours, `#RRGGBB`, upper case. */\n  colors: string[]\n  /** Your own note. It is not put into the prompt. */\n  description: string | null\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface CreatePaletteInput {\n  /** 1–80 characters. */\n  name: string\n  /** 2–12 colours, `#RRGGBB` (any case; stored upper case). */\n  colors: string[]\n  /** Up to 500 characters. */\n  description?: string | null\n}\n\n/** Only the fields you send are written; `description: null` clears it. */\nexport interface UpdatePaletteInput {\n  name?: string\n  colors?: string[]\n  description?: string | null\n}\n\nexport interface ListPalettesParams {\n  /** Page size, 1–100 (server default 50). */\n  limit?: number\n  /** The previous page's `nextCursor`. */\n  cursor?: string\n}\n\nexport interface PalettePage {\n  data: ColorPalette[]\n  /** Pass back as `cursor` for the next page; `null` on the last one. */\n  nextCursor: string | null\n}\n\n/** The prefix of a palette's generate-image direction id (`direction.colorLook`). */\nexport const PALETTE_DIRECTION_PREFIX = \"palette:\" as const\n\n/**\n * A palette as a generate-image direction value — put it on\n * `direction.colorLook`. The run names each colour (an everyday name and its\n * hex) in the prompt; the job keeps the id, so a re-run uses the palette as it\n * is then.\n */\nexport function paletteDirectionId(id: string): `palette:${string}` {\n  return `${PALETTE_DIRECTION_PREFIX}${id}`\n}\n\n/**\n * Colour palettes — `GET/POST /v1/palettes`, `GET/PATCH/DELETE /v1/palettes/:id`.\n *\n * Yours only (another person's id answers 404). Use one on generate-image as\n * `direction: { colorLook: paletteDirectionId(id) }`. OAuth app tokens need\n * `assets:read` for reads and `assets:write` for writes.\n */\nexport class PalettesResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** Your palettes, newest first. Page with `nextCursor`. */\n  list(params: ListPalettesParams = {}): Promise<PalettePage> {\n    return this.client.request<PalettePage>(\"GET\", \"/v1/palettes\", {\n      query: { limit: params.limit, cursor: params.cursor },\n    })\n  }\n\n  get(id: string): Promise<ColorPalette> {\n    return this.client.request<ColorPalette>(\"GET\", `/v1/palettes/${encodeURIComponent(id)}`)\n  }\n\n  create(input: CreatePaletteInput): Promise<ColorPalette> {\n    return this.client.request<ColorPalette>(\"POST\", \"/v1/palettes\", { body: input })\n  }\n\n  update(id: string, input: UpdatePaletteInput): Promise<ColorPalette> {\n    return this.client.request<ColorPalette>(\"PATCH\", `/v1/palettes/${encodeURIComponent(id)}`, { body: input })\n  }\n\n  /** A run that still names the palette answers 404 `direction_not_found`. */\n  async delete(id: string): Promise<void> {\n    await this.client.request<{ success: true }>(\"DELETE\", `/v1/palettes/${encodeURIComponent(id)}`)\n  }\n}\n"]}

package/dist/chunk-NCCBS6GU.js

@@ -0,0 +1,42 @@
+// src/resources/saved-posts.ts
+var SavedPostsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** `GET /v1/saved-posts` → your saves, newest first. Page with `nextCursor`. */
+  list(params = {}) {
+    return this.client.request("GET", "/v1/saved-posts", {
+      query: {
+        platform: params.platform,
+        tag: params.tag,
+        q: params.q,
+        cursor: params.cursor,
+        limit: params.limit
+      }
+    });
+  }
+  /**
+   * `POST /v1/saved-posts` → save a post. Saving a post that is already saved
+   * updates its note and tags (when given) and returns the existing save.
+   */
+  save(input) {
+    return this.client.request("POST", "/v1/saved-posts", { body: input });
+  }
+  /** `POST /v1/saved-posts/lookup` → which of these post ids (`SocialPost.id`) you saved. */
+  lookup(postIds) {
+    return this.client.request("POST", "/v1/saved-posts/lookup", { body: { postIds } });
+  }
+  /** `PATCH /v1/saved-posts/:id` → change a save's note or tags. */
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/saved-posts/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** `DELETE /v1/saved-posts/:id` → remove a save and its copied still. */
+  async delete(id) {
+    await this.client.request("DELETE", `/v1/saved-posts/${encodeURIComponent(id)}`);
+  }
+};
+
+export { SavedPostsResource };
+//# sourceMappingURL=chunk-NCCBS6GU.js.map
+//# sourceMappingURL=chunk-NCCBS6GU.js.map

package/dist/chunk-NCCBS6GU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/saved-posts.ts"],"names":[],"mappings":";AAkBO,IAAM,qBAAN,MAAyB;AAAA,EAC9B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,CAAK,MAAA,GAA+B,EAAC,EAAkC;AACrE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA8B,KAAA,EAAO,iBAAA,EAAmB;AAAA,MACzE,KAAA,EAAO;AAAA,QACL,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,KAAK,MAAA,CAAO,GAAA;AAAA,QACZ,GAAG,MAAA,CAAO,CAAA;AAAA,QACV,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,OAAO,MAAA,CAAO;AAAA;AAChB,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,KAAK,KAAA,EAA0C;AAC7C,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAmB,MAAA,EAAQ,mBAAmB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAClF;AAAA;AAAA,EAGA,OAAO,OAAA,EAA6D;AAClE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,wBAAA,EAA0B,EAAE,IAAA,EAAM,EAAE,OAAA,EAAQ,EAAG,CAAA;AAAA,EAC5G;AAAA;AAAA,EAGA,MAAA,CAAO,IAAY,KAAA,EAAiD;AAClE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAmB,OAAA,EAAS,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA,EAAI,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,EAC7G;AAAA;AAAA,EAGA,MAAM,OAAO,EAAA,EAA2B;AACtC,IAAA,MAAM,IAAA,CAAK,OAAO,OAAA,CAA2B,QAAA,EAAU,mBAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACpG;AACF","file":"chunk-NCCBS6GU.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type {\n  ListSavedPostsParams,\n  ListSavedPostsResult,\n  SavePostInput,\n  SavedPost,\n  SavedPostsLookupResult,\n  UpdateSavedPostInput,\n} from \"@nodaro/shared/social\"\n\n/**\n * Saved posts — the inspiration wall.\n *\n * Save a post you found (a Social Search result, `nodes.run(\"social-search\")`)\n * with a note and tags, list and filter your saves, and change or remove them.\n * A save keeps a snapshot of the post and a copy of its still in your storage.\n * OAuth app tokens need `assets:read` for reads and `assets:write` for writes.\n */\nexport class SavedPostsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** `GET /v1/saved-posts` → your saves, newest first. Page with `nextCursor`. */\n  list(params: ListSavedPostsParams = {}): Promise<ListSavedPostsResult> {\n    return this.client.request<ListSavedPostsResult>(\"GET\", \"/v1/saved-posts\", {\n      query: {\n        platform: params.platform,\n        tag: params.tag,\n        q: params.q,\n        cursor: params.cursor,\n        limit: params.limit,\n      },\n    })\n  }\n\n  /**\n   * `POST /v1/saved-posts` → save a post. Saving a post that is already saved\n   * updates its note and tags (when given) and returns the existing save.\n   */\n  save(input: SavePostInput): Promise<SavedPost> {\n    return this.client.request<SavedPost>(\"POST\", \"/v1/saved-posts\", { body: input })\n  }\n\n  /** `POST /v1/saved-posts/lookup` → which of these post ids (`SocialPost.id`) you saved. */\n  lookup(postIds: readonly string[]): Promise<SavedPostsLookupResult> {\n    return this.client.request<SavedPostsLookupResult>(\"POST\", \"/v1/saved-posts/lookup\", { body: { postIds } })\n  }\n\n  /** `PATCH /v1/saved-posts/:id` → change a save's note or tags. */\n  update(id: string, input: UpdateSavedPostInput): Promise<SavedPost> {\n    return this.client.request<SavedPost>(\"PATCH\", `/v1/saved-posts/${encodeURIComponent(id)}`, { body: input })\n  }\n\n  /** `DELETE /v1/saved-posts/:id` → remove a save and its copied still. */\n  async delete(id: string): Promise<void> {\n    await this.client.request<{ success: true }>(\"DELETE\", `/v1/saved-posts/${encodeURIComponent(id)}`)\n  }\n}\n"]}

package/dist/chunk-NGKODS3J.cjs

@@ -0,0 +1,52 @@
+'use strict';
+
+// src/resources/billing.ts
+var BillingResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * `GET /v1/billing/plans` → the plans and credit packs on sale, with their
+   * prices. Public: works with no credential, the same for every caller.
+   * Nodaro Cloud only — a self-hosted instance answers 404. Throws on `403
+   * self_serve_disabled` (this deployment does not sell to its users) and on
+   * `503` (`stripe_not_configured`, or prices briefly unavailable).
+   */
+  plans() {
+    return this.client.request("GET", "/v1/billing/plans");
+  }
+  /**
+   * `GET /v1/billing/subscription` → the account's latest subscription
+   * (`null` when it never subscribed) and the tier its entitlements follow.
+   * Match `effectiveTier` to a {@link BillingPlan} `id` to mark the current
+   * plan (no match: pay-as-you-go, or a tier not on sale). Needs a signed-in
+   * session, a personal API token without a workflow limit, or an app's OAuth
+   * token. Nodaro Cloud only — a self-hosted instance answers 404.
+   */
+  subscription() {
+    return this.client.request("GET", "/v1/billing/subscription");
+  }
+  /**
+   * `GET /v1/billing/surface` → how this deployment bills: whether it meters
+   * at all (`providerId !== "none"`) and in which unit costs display. Public,
+   * every edition.
+   */
+  async surface() {
+    const res = await this.client.request("GET", "/v1/billing/surface");
+    return res.data;
+  }
+  /**
+   * `GET /v1/billing/account` → the caller's plan and balance as the
+   * deployment's billing provider reports them, in its display unit. `null`
+   * when the provider could not answer — not a zero balance. Every edition.
+   */
+  async account() {
+    const res = await this.client.request("GET", "/v1/billing/account");
+    return res.data;
+  }
+};
+
+exports.BillingResource = BillingResource;
+//# sourceMappingURL=chunk-NGKODS3J.cjs.map
+//# sourceMappingURL=chunk-NGKODS3J.cjs.map

package/dist/chunk-NGKODS3J.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/billing.ts"],"names":[],"mappings":";;;AA6KO,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASpB,KAAA,GAAqC;AACnC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA4B,KAAA,EAAO,mBAAmB,CAAA;AAAA,EAC3E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,YAAA,GAAmD;AACjD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAmC,KAAA,EAAO,0BAA0B,CAAA;AAAA,EACzF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAA,GAAmC;AACvC,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAkC,OAAO,qBAAqB,CAAA;AAC5F,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAA,GAAiD;AACrD,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgD,OAAO,qBAAqB,CAAA;AAC1G,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AACF","file":"chunk-NGKODS3J.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Plans and prices, the subscription, and the billing surface — the shapes of\n * the `/v1/billing/*` routes an app may call. Mirrors the backend routes\n * (`backend/src/ee/routes/billing.ts`, `backend/src/routes/billing-surface.ts`),\n * the source of truth: keep these in sync if they change.\n *\n * Buying, changing the plan and the payment settings stay in the Nodaro app:\n * those routes refuse API and app tokens, so they have no method here.\n */\n\n/** A sum of money in its currency's major unit (`12` = 12.00), with its ISO-4217 code (`\"USD\"`). */\nexport interface BillingMoney {\n  amount: number\n  currency: string\n}\n\n/** The credits a price grants, and how often. */\nexport interface BillingPriceCredits {\n  amount: number\n  per: \"month\" | \"year\"\n}\n\n/** A monthly price, and what it grants. */\nexport interface BillingMonthlyPrice extends BillingMoney {\n  /** `null` when the price does not state it. */\n  credits: BillingPriceCredits | null\n}\n\n/** A yearly price, what it comes to per month, and what it grants. */\nexport interface BillingYearlyPrice extends BillingMoney {\n  /** The yearly amount spread over the months it pays for; `null` when that cannot be said. */\n  perMonth: number | null\n  /** What the price grants — the plan's credits every month, as a monthly price; `null` when the price does not state it. */\n  credits: BillingPriceCredits | null\n}\n\nexport interface BillingPlanPrices {\n  /** `null` = Stripe cannot sell this price right now: show it as unavailable, never as free. */\n  monthly: BillingMonthlyPrice | null\n  yearly: BillingYearlyPrice | null\n}\n\n/** One plan on sale. */\nexport interface BillingPlan {\n  /** `\"free\"`, `\"basic\"`, `\"standard\"`, … — the stable id. */\n  id: string\n  name: string\n  /** `null` for the free plan: there is nothing to pay. */\n  prices: BillingPlanPrices | null\n  /** The free plan's one-time grant at sign-up; `null` on a paid plan, whose credits come with each price. */\n  signupCredits: number | null\n  /** How many nodes of one workflow run at once. */\n  parallelism: number\n  /** Storage for your media, in bytes. */\n  storageBytes: number\n}\n\n/** A credit pack: this many credits for this price. */\nexport interface BillingTopUp {\n  id: string\n  credits: number\n  /** `null` when the pack's price cannot be stated right now: show it as unavailable. */\n  price: BillingMoney | null\n}\n\n/** The answer of `GET /v1/billing/plans`. */\nexport interface BillingPlansResult {\n  /** The free plan first, then each paid plan from the smallest. */\n  data: BillingPlan[]\n  /** The credit packs, from the smallest. */\n  topUps: BillingTopUp[]\n  /** Any whole amount in this range can be loaded as credits, at the same rate as the packs. */\n  topUpRange: { min: number; max: number; currency: string }\n}\n\n/** The account's latest subscription record. */\nexport interface BillingSubscription {\n  id: string\n  stripe_subscription_id: string | null\n  /** The plan id: `\"basic\"`, `\"standard\"`, … */\n  tier: string\n  /** `\"active\"`, `\"trialing\"`, `\"past_due\"`, `\"paused\"`, `\"canceled\"`, `\"incomplete\"` or `\"expired\"`. */\n  status: string\n  stripe_price_id: string | null\n  /** ISO-8601. */\n  current_period_start: string | null\n  /** ISO-8601: when the current period ends (and renews, unless cancelled). */\n  current_period_end: string | null\n  /** True when the subscription ends at `current_period_end` instead of renewing. */\n  cancel_at_period_end: boolean\n  /** ISO-8601: when a scheduled cancellation takes effect. */\n  cancel_at: string | null\n  /** ISO-8601: when it was cancelled. */\n  canceled_at: string | null\n}\n\n/** The answer of `GET /v1/billing/subscription`. */\nexport interface BillingSubscriptionResult {\n  /** `null` when the account never subscribed. */\n  data: BillingSubscription | null\n  /**\n   * The tier the account's entitlements follow: usually a plan id from\n   * `plans()` (`\"free\"` included); `\"payg\"` — no subscription, but credits\n   * bought (every model, no watermark); or a tier that is not on sale, such\n   * as `\"enterprise\"`.\n   */\n  effectiveTier: string\n}\n\n/** How this deployment bills, the same for every caller (`GET /v1/billing/surface`). */\nexport interface BillingSurface {\n  /** The billing-surface contract version (an integer). */\n  contract: number\n  /** The registered billing provider; `\"none\"` = this deployment meters nothing. */\n  providerId: string\n  /** The unit costs display in by default (`\"credits\"`, `\"usd\"`, or a deployment's own label). */\n  displayUnit: string\n  canReport: boolean\n  canQuote: boolean\n  canAccount: boolean\n  /** Whether a cost view belongs on this deployment. */\n  mountCostTab: boolean\n  /** One billing account pays for every user here. */\n  deploymentPayer: boolean\n}\n\n/** One row of {@link BillingAccountSummary.byCategory}. */\nexport interface BillingUsageCategory {\n  category: string\n  count: number\n  /** Spend in the display unit; `null` = unavailable, never 0. */\n  amount: number | null\n  spent: BillingMoney | null\n}\n\n/**\n * The caller's account as the deployment's billing provider sees it\n * (`GET /v1/billing/account`). Money and amounts are `null` when the provider\n * could not say: show that distinctly, never as 0. A field the provider leaves\n * out is a concept it does not have.\n */\nexport interface BillingAccountSummary {\n  /** A plain string; `\"unknown\"` is a real answer. */\n  plan: string\n  balance: number | null\n  dailyAllowance: number | null\n  unit: string\n  /** `\"external_wallet\"` when the balance comes from a wallet outside Nodaro. */\n  balanceSource?: \"external_wallet\"\n  /** ISO-8601 start of the current usage period. */\n  periodStart?: string | null\n  /** Generations this period. */\n  generations?: number | null\n  /** Money spent this period. */\n  spent?: BillingMoney | null\n  /** Pay-as-you-go state. */\n  payg?: {\n    enabled: boolean\n    reserve: number | null\n    rate: { creditsPerUnit: number; currency: string } | null\n    monthlyCap: BillingMoney | null\n  } | null\n  /** The daily cap and when it resets; prefer it over `dailyAllowance` when present. `limit: 0` means blocked. */\n  daily?: { limit: number; used: number; remaining: number; resetsAt: string } | null\n  /** Money value of the pay-as-you-go reserve. */\n  reserveValue?: BillingMoney | null\n  byCategory?: BillingUsageCategory[] | null\n  /** The total the balance is drawn from, where the provider grants each user an allocation. */\n  allocated?: number | null\n}\n\nexport class BillingResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * `GET /v1/billing/plans` → the plans and credit packs on sale, with their\n   * prices. Public: works with no credential, the same for every caller.\n   * Nodaro Cloud only — a self-hosted instance answers 404. Throws on `403\n   * self_serve_disabled` (this deployment does not sell to its users) and on\n   * `503` (`stripe_not_configured`, or prices briefly unavailable).\n   */\n  plans(): Promise<BillingPlansResult> {\n    return this.client.request<BillingPlansResult>(\"GET\", \"/v1/billing/plans\")\n  }\n\n  /**\n   * `GET /v1/billing/subscription` → the account's latest subscription\n   * (`null` when it never subscribed) and the tier its entitlements follow.\n   * Match `effectiveTier` to a {@link BillingPlan} `id` to mark the current\n   * plan (no match: pay-as-you-go, or a tier not on sale). Needs a signed-in\n   * session, a personal API token without a workflow limit, or an app's OAuth\n   * token. Nodaro Cloud only — a self-hosted instance answers 404.\n   */\n  subscription(): Promise<BillingSubscriptionResult> {\n    return this.client.request<BillingSubscriptionResult>(\"GET\", \"/v1/billing/subscription\")\n  }\n\n  /**\n   * `GET /v1/billing/surface` → how this deployment bills: whether it meters\n   * at all (`providerId !== \"none\"`) and in which unit costs display. Public,\n   * every edition.\n   */\n  async surface(): Promise<BillingSurface> {\n    const res = await this.client.request<{ data: BillingSurface }>(\"GET\", \"/v1/billing/surface\")\n    return res.data\n  }\n\n  /**\n   * `GET /v1/billing/account` → the caller's plan and balance as the\n   * deployment's billing provider reports them, in its display unit. `null`\n   * when the provider could not answer — not a zero balance. Every edition.\n   */\n  async account(): Promise<BillingAccountSummary | null> {\n    const res = await this.client.request<{ data: BillingAccountSummary | null }>(\"GET\", \"/v1/billing/account\")\n    return res.data\n  }\n}\n"]}

package/dist/chunk-NJVSKUL2.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=chunk-NJVSKUL2.cjs.map
+//# sourceMappingURL=chunk-NJVSKUL2.cjs.map

package/dist/chunk-NJVSKUL2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-NJVSKUL2.cjs"}