@nodaro/sdk 2.29.0 → 2.32.0

package/dist/chunk-Y6V6CBY5.js

@@ -0,0 +1,23 @@
+// src/resources/models.ts
+var ModelsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Browse the models available on this instance — capability sheets,
+   *  per-variant credit pricing, prompt tips, and the `doctrineCovered`
+   *  truth flag. Public endpoint; cached 5 minutes. */
+  list(opts = {}) {
+    const qs = new URLSearchParams();
+    if (opts.kind) qs.set("kind", opts.kind);
+    if (opts.mode) qs.set("mode", opts.mode);
+    if (opts.family) qs.set("family", opts.family);
+    if (opts.featuredOnly) qs.set("featuredOnly", "true");
+    const query = qs.toString();
+    return this.client.request("GET", `/v1/models${query ? `?${query}` : ""}`);
+  }
+};
+
+export { ModelsResource };
+//# sourceMappingURL=chunk-Y6V6CBY5.js.map
+//# sourceMappingURL=chunk-Y6V6CBY5.js.map

package/dist/chunk-Y6V6CBY5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/models.ts"],"names":[],"mappings":";AAyEO,IAAM,iBAAN,MAAqB;AAAA,EAC1B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA,EAKpB,IAAA,CAAK,IAAA,GAA0B,EAAC,EAA8B;AAC5D,IAAA,MAAM,EAAA,GAAK,IAAI,eAAA,EAAgB;AAC/B,IAAA,IAAI,KAAK,IAAA,EAAM,EAAA,CAAG,GAAA,CAAI,MAAA,EAAQ,KAAK,IAAI,CAAA;AACvC,IAAA,IAAI,KAAK,IAAA,EAAM,EAAA,CAAG,GAAA,CAAI,MAAA,EAAQ,KAAK,IAAI,CAAA;AACvC,IAAA,IAAI,KAAK,MAAA,EAAQ,EAAA,CAAG,GAAA,CAAI,QAAA,EAAU,KAAK,MAAM,CAAA;AAC7C,IAAA,IAAI,IAAA,CAAK,YAAA,EAAc,EAAA,CAAG,GAAA,CAAI,gBAAgB,MAAM,CAAA;AACpD,IAAA,MAAM,KAAA,GAAQ,GAAG,QAAA,EAAS;AAC1B,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,CAAA,UAAA,EAAa,QAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAE,CAAA,CAAE,CAAA;AAAA,EAC3E;AACF","file":"chunk-Y6V6CBY5.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * The company that made a model. `id` is stable — one id per company, the\n * company's name lowercased and hyphenated (`\"google\"`, `\"black-forest-labs\"`)\n * — so an app may key its own assets on it; a newer server can add makers, so\n * handle an id you do not know. `name` is the company's display name.\n */\nexport interface ModelMaker {\n  id: string\n  name: string\n}\n\n/**\n * Model-catalog types. Mirrors the backend's `GET /v1/models` projection\n * (itself shared with the MCP `list_models` tool) so the SDK stays\n * dependency-free — same convention as `PickerCatalog` / `NodeDescriptor`.\n */\nexport interface ModelSummary {\n  id: string\n  label: string\n  /** The company that made the model. Not the same as the family it is\n   *  grouped under: a few families name a lab or a product line (Tongyi-MAI\n   *  and HappyHorse are Alibaba's, Depth Anything is ByteDance's). Absent on\n   *  an older server. */\n  maker?: ModelMaker\n  /** The maker's official mark (an SVG) on this deployment's media CDN, or\n   *  null when the deployment does not publish one for this maker — draw a\n   *  fallback (the maker's name or initial) then. The address carries its\n   *  file's version, so a replaced mark arrives under a new address. Absent\n   *  on an older server. */\n  logoUrl?: string | null\n  description: string\n  modes: string[]\n  useCases: string[]\n  /** Per-variant credit pricing: the credits a run of each variant is\n   *  charged, the figure on the node's Run button. Cloud only — editions\n   *  without a credit system (community/business) omit the field entirely. */\n  pricing?: Array<{ identifier: string; credits: number; note?: string }>\n  featured?: boolean\n  features?: string[]\n  aspectRatios?: string[]\n  resolutions?: string[]\n  qualities?: string[]\n  durations?: number[]\n  /** Compact per-model prompting tips (present when a doctrine exists). */\n  promptTips?: string[]\n  /** TRUE only when a sourced per-family prompt doctrine exists for this\n   *  model — gate \"vendor doctrine · real rewrite\" badges on this and show\n   *  a generic label otherwise (never overclaim). */\n  doctrineCovered: boolean\n}\n\nexport interface ModelFamilyGroup {\n  family: string\n  models: ModelSummary[]\n}\n\nexport interface ModelsListResult {\n  sections: Array<{ kind: \"image\" | \"video\" | \"audio\"; families: ModelFamilyGroup[] }>\n  recommendations: Array<{ id: string; title: string; modelIds: string[]; reason?: string } & Record<string, unknown>>\n  totalModels: number\n}\n\nexport interface ListModelsOptions {\n  kind?: \"image\" | \"video\" | \"audio\"\n  /** Operation filter, e.g. \"t2v\", \"i2v\", \"t2i\". */\n  mode?: string\n  /** Vendor / lab name, e.g. \"Google\", \"Bytedance\". */\n  family?: string\n  featuredOnly?: boolean\n}\n\nexport class ModelsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** Browse the models available on this instance — capability sheets,\n   *  per-variant credit pricing, prompt tips, and the `doctrineCovered`\n   *  truth flag. Public endpoint; cached 5 minutes. */\n  list(opts: ListModelsOptions = {}): Promise<ModelsListResult> {\n    const qs = new URLSearchParams()\n    if (opts.kind) qs.set(\"kind\", opts.kind)\n    if (opts.mode) qs.set(\"mode\", opts.mode)\n    if (opts.family) qs.set(\"family\", opts.family)\n    if (opts.featuredOnly) qs.set(\"featuredOnly\", \"true\")\n    const query = qs.toString()\n    return this.client.request(\"GET\", `/v1/models${query ? `?${query}` : \"\"}`)\n  }\n}\n"]}

package/dist/chunk-Y6VDCZPB.js

@@ -0,0 +1,62 @@
+// src/resources/sessions.ts
+var SessionsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Create a session. Send its `id` as `sessionId` on a generation request
+   * (`nodes.run("generate-image", { sessionId, … })`, video, speech, music) and
+   * the job is born in it.
+   */
+  create(input) {
+    return this.client.request("POST", "/v1/sessions", { body: input });
+  }
+  /** Your sessions, newest first. */
+  list(params = {}) {
+    const query = {};
+    if (params.projectId) query.projectId = params.projectId;
+    if (params.tool) query.tool = params.tool;
+    if (params.includeArchived) query.includeArchived = "true";
+    if (params.limit !== void 0) query.limit = String(params.limit);
+    if (params.cursor) query.cursor = params.cursor;
+    return this.client.request("GET", "/v1/sessions", { query });
+  }
+  get(id) {
+    return this.client.request("GET", `/v1/sessions/${encodeURIComponent(id)}`);
+  }
+  /** Rename or archive a session, or pick its cover. Its project cannot change. */
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/sessions/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** Delete a session and its links. Its jobs are kept, and stay in every other session holding them. */
+  delete(id) {
+    return this.client.request("DELETE", `/v1/sessions/${encodeURIComponent(id)}`);
+  }
+  /** The session's items, born-in and imported, newest first. */
+  items(id, params = {}) {
+    const query = {};
+    if (params.limit !== void 0) query.limit = String(params.limit);
+    if (params.cursor) query.cursor = params.cursor;
+    return this.client.request("GET", `/v1/sessions/${encodeURIComponent(id)}/items`, { query });
+  }
+  /**
+   * Import some of your own jobs into a session — a link, not a copy (up to 100
+   * a call). All-or-nothing: if any id is not one of your jobs, nothing is
+   * imported and the call fails with 404. Items already there are left as they are.
+   */
+  importItems(id, input) {
+    return this.client.request("POST", `/v1/sessions/${encodeURIComponent(id)}/items`, { body: input });
+  }
+  /** Remove one item from a session. Only the link goes: the job, and every other session holding it, stay. */
+  removeItem(id, jobId) {
+    return this.client.request(
+      "DELETE",
+      `/v1/sessions/${encodeURIComponent(id)}/items/${encodeURIComponent(jobId)}`
+    );
+  }
+};
+
+export { SessionsResource };
+//# sourceMappingURL=chunk-Y6VDCZPB.js.map
+//# sourceMappingURL=chunk-Y6VDCZPB.js.map

package/dist/chunk-Y6VDCZPB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/sessions.ts"],"names":[],"mappings":"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","file":"chunk-Y6VDCZPB.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type { Job } from \"./jobs.js\"\n\n/**\n * A generation session: one run of work in a creation tool (Create Image,\n * Video, Music), optionally inside a project. Its project is fixed at\n * creation — to get an item into another project, import it into a session\n * there.\n */\nexport interface GenerationSession {\n  id: string\n  /** Null when the session has no project, or its project was deleted. */\n  projectId: string | null\n  /** Null = untitled; a UI may fall back to the first prompt. */\n  title: string | null\n  /** The creation tool that owns the session, e.g. `\"create-image\"`. */\n  tool: string\n  createdAt: string\n  /** The latest activity: an item added, or an edit. */\n  updatedAt: string\n  archivedAt: string | null\n  /** The item picked as the session's cover (`update(id, { coverJobId })`); `null` = automatic. */\n  coverJobId: string | null\n  itemCount: number\n  /** Up to four image links: the cover's image first when one is set, then the\n   *  newest completed items. */\n  previewUrls: string[]\n}\n\nexport interface CreateSessionInput {\n  /** One of your projects (on the side of the workspace line you are on). */\n  projectId?: string\n  title?: string\n  /** Lowercase letters, digits and dashes, at most 40 — e.g. `\"create-image\"`. */\n  tool: string\n}\n\nexport interface UpdateSessionInput {\n  /** `null` makes the session untitled again. */\n  title?: string | null\n  archived?: boolean\n  /** One of the session's items to lead its previews (404 if it is not an\n   *  item of this session); `null` goes back to automatic. */\n  coverJobId?: string | null\n}\n\nexport interface ListSessionsParams {\n  projectId?: string\n  tool?: string\n  /** Archived sessions are left out unless this is true. */\n  includeArchived?: boolean\n  /** Page size, 1–100 (server default 50). */\n  limit?: number\n  /** The previous page's `next`. */\n  cursor?: string\n}\n\n/** One item of a session's feed: a link to one of your jobs. */\nexport interface SessionItem {\n  jobId: string\n  addedAt: string\n  /** True when imported from elsewhere rather than born in this session. */\n  imported: boolean\n  importedFrom: { sessionId: string; title: string | null } | null\n  job: Job\n}\n\nexport interface ListSessionItemsParams {\n  limit?: number\n  cursor?: string\n}\n\nexport interface SessionPage<T> {\n  data: T[]\n  /** Pass back as `cursor` for the next page; `null` on the last one. */\n  next: string | null\n}\n\nexport class SessionsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Create a session. Send its `id` as `sessionId` on a generation request\n   * (`nodes.run(\"generate-image\", { sessionId, … })`, video, speech, music) and\n   * the job is born in it.\n   */\n  create(input: CreateSessionInput): Promise<{ data: GenerationSession }> {\n    return this.client.request(\"POST\", \"/v1/sessions\", { body: input })\n  }\n\n  /** Your sessions, newest first. */\n  list(params: ListSessionsParams = {}): Promise<SessionPage<GenerationSession>> {\n    const query: Record<string, string> = {}\n    if (params.projectId) query.projectId = params.projectId\n    if (params.tool) query.tool = params.tool\n    if (params.includeArchived) query.includeArchived = \"true\"\n    if (params.limit !== undefined) query.limit = String(params.limit)\n    if (params.cursor) query.cursor = params.cursor\n    return this.client.request(\"GET\", \"/v1/sessions\", { query })\n  }\n\n  get(id: string): Promise<{ data: GenerationSession }> {\n    return this.client.request(\"GET\", `/v1/sessions/${encodeURIComponent(id)}`)\n  }\n\n  /** Rename or archive a session, or pick its cover. Its project cannot change. */\n  update(id: string, input: UpdateSessionInput): Promise<{ data: GenerationSession }> {\n    return this.client.request(\"PATCH\", `/v1/sessions/${encodeURIComponent(id)}`, { body: input })\n  }\n\n  /** Delete a session and its links. Its jobs are kept, and stay in every other session holding them. */\n  delete(id: string): Promise<{ success: true }> {\n    return this.client.request(\"DELETE\", `/v1/sessions/${encodeURIComponent(id)}`)\n  }\n\n  /** The session's items, born-in and imported, newest first. */\n  items(id: string, params: ListSessionItemsParams = {}): Promise<SessionPage<SessionItem>> {\n    const query: Record<string, string> = {}\n    if (params.limit !== undefined) query.limit = String(params.limit)\n    if (params.cursor) query.cursor = params.cursor\n    return this.client.request(\"GET\", `/v1/sessions/${encodeURIComponent(id)}/items`, { query })\n  }\n\n  /**\n   * Import some of your own jobs into a session — a link, not a copy (up to 100\n   * a call). All-or-nothing: if any id is not one of your jobs, nothing is\n   * imported and the call fails with 404. Items already there are left as they are.\n   */\n  importItems(id: string, input: { jobIds: string[] }): Promise<{ data: { imported: number; requested: number } }> {\n    return this.client.request(\"POST\", `/v1/sessions/${encodeURIComponent(id)}/items`, { body: input })\n  }\n\n  /** Remove one item from a session. Only the link goes: the job, and every other session holding it, stay. */\n  removeItem(id: string, jobId: string): Promise<{ success: true }> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/sessions/${encodeURIComponent(id)}/items/${encodeURIComponent(jobId)}`,\n    )\n  }\n}\n"]}

package/dist/chunk-YDRXBRW2.cjs

@@ -0,0 +1,184 @@
+'use strict';
+
+var scene3d = require('@nodaro/shared/scene3d');
+
+// src/resources/scene3d-types.ts
+var SCENE3D_DELIVERY_ASSET_USAGE = {
+  poster: "poster",
+  "validation-report": "validation",
+  "shot-still": "shot-still",
+  /** The recipe a run that never compiled was refused for. See {@link Scene3DDeliveryAsset}. */
+  "source-json": "checkpoint"
+};
+function newIdempotencyKey() {
+  const random = globalThis.crypto?.randomUUID?.();
+  return `sdk-pro3d-${random ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`}`;
+}
+var Scene3DResource = class {
+  /** Every operation runs a platform node, so the client must carry `nodes` too. */
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  capabilities() {
+    return this.client.request("GET", "/v1/3d-scene/capabilities");
+  }
+  /** Current access to both the delivery and its source is required on every read. */
+  getDelivery(jobId) {
+    return this.client.request("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}`);
+  }
+  /**
+   * The bytes of one descriptor the delivery listed.
+   *
+   * Checked against {@link SCENE3D_DELIVERY_ASSET_USAGE} rather than a hardcoded pair, which
+   * is why a `shot-still` now works: the route has served stills since they existed, and this
+   * guard refused them. `source-json` — the recipe a refused run was kept for — is on the same
+   * map; the server still decides whether THIS caller may read it.
+   */
+  deliveryAssetBytes(jobId, asset, options) {
+    if (SCENE3D_DELIVERY_ASSET_USAGE[asset.kind] !== asset.usage) {
+      throw new Error("This asset is not available through the delivery endpoint");
+    }
+    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > scene3d.SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
+      throw new Error("Invalid scene delivery asset byte length");
+    }
+    return this.client.requestBytes("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}/assets/${encodeURIComponent(asset.assetId)}`, {
+      signal: options?.signal,
+      maxBytes: asset.byteLength
+    });
+  }
+  /**
+   * The recipe a 3D Render Pro run was refused for, parsed — or `null` when there is none.
+   *
+   * The one thing such a run leaves behind. Its recipe never compiled, so there is no scene
+   * revision, no poster and no `.blend`: `output_data` carries a `deliveryId`, the compiler's
+   * reasons, and `validation.sourceRetained` saying whether the recipe itself was kept. This
+   * fetches it in one call — delivery, then the `source-json` descriptor's bytes.
+   *
+   * `null` means the delivery has no retained recipe to hand back: no pass ever cleared
+   * admission, or this caller holds less than `edit` on the job's workflow and the descriptor
+   * is therefore not listed for them.
+   *
+   * Read it to see what was attempted and to inform the next prompt. There is no input that
+   * takes a recipe back: a refused run published no revision, so there is no `{kind:"scene"}`
+   * source to re-run it from.
+   */
+  async retainedRecipe(jobId, options) {
+    const delivery = await this.getDelivery(jobId);
+    const asset = delivery.assets.find((item) => item.kind === "source-json");
+    if (!asset) return null;
+    const bytes = await this.deliveryAssetBytes(jobId, asset, options);
+    return JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+  }
+  /** Persist deterministic overlays without an LLM or a generation charge. */
+  applyEdits(revisionId, params) {
+    return this.client.request("POST", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/edits`, { body: params });
+  }
+  /** Asset access is scoped to an exact retained revision, with fresh authentication. */
+  assetBytes(revisionId, asset, options) {
+    if (!["glb", "camera-track-json", "poster", "validation-report"].includes(asset.kind)) {
+      throw new Error("This asset is not available through the playback endpoint");
+    }
+    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > scene3d.SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
+      throw new Error("Invalid scene asset byte length");
+    }
+    return this.client.requestBytes("GET", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/assets/${encodeURIComponent(asset.assetId)}`, {
+      signal: options?.signal,
+      maxBytes: asset.byteLength
+    });
+  }
+  /** The editable native file has its own authorization lane. */
+  sourceBytes(revisionId, options) {
+    return this.client.requestBytes("GET", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/source`, {
+      signal: options?.signal,
+      maxBytes: scene3d.SCENE3D_V2_LIMITS.maxBlendSourceBytes
+    });
+  }
+  generate(params) {
+    return this.client.nodes.run("generate-3d-scene", params);
+  }
+  generateAndWait(params, options) {
+    return this.client.nodes.runAndWait("generate-3d-scene", params, options);
+  }
+  edit(params) {
+    return this.client.nodes.run("edit-3d-scene", params);
+  }
+  editAndWait(params, options) {
+    return this.client.nodes.runAndWait("edit-3d-scene", params, options);
+  }
+  /**
+   * Price a 3D Render Pro request WITHOUT starting it.
+   *
+   * Takes the same body a run takes, minus the `quoteId`, and answers a
+   * ceiling (`maxCredits`), a `breakdown` to show, and the
+   * `normalizedInputHash` admission re-checks. It reserves nothing and spends
+   * nothing — a quote is a price, not a purchase.
+   */
+  quotePro(params) {
+    return this.client.request("POST", "/v1/pro-3d-render/quote", { body: params });
+  }
+  /**
+   * Submit a quoted 3D Render Pro run.
+   *
+   * Requires the `quoteId` from {@link quotePro}: no run starts at a price
+   * nobody showed. Sends an `Idempotency-Key` — a fresh one per call unless you
+   * supply your own, which you should when retrying a call that timed out.
+   *
+   * Availability is a property of the deployment: `capabilities().pro` says
+   * whether this install can serve it, and which controls you may offer.
+   */
+  runPro(params, options) {
+    return this.client.nodes.run("pro-3d-render", params, {
+      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey()
+    });
+  }
+  /**
+   * Quote if needed, run, and wait — the whole operation in one call.
+   *
+   * Two HTTP requests at most, still ONE paid job: when `quoteId` is absent
+   * this quotes the identical body first, so the run is admitted against a
+   * hash of exactly what was priced. Pass a `quoteId` to run against a quote
+   * you already showed the user.
+   *
+   * Resolves with the settled result — `videoUrl` (the MP4) and `scenePlan`
+   * (the exact composition it was rendered from), plus the revision, poster,
+   * validation and renderer metadata. A run that AUTHORED also reports its own
+   * account of the answer — `metadata.summary`, `repairPasses`,
+   * `admissionRetries`, `mechanicalPasses` (repairs the engine applied from
+   * the compiler's own remedy with no planner call, counted APART from
+   * `repairPasses` on their own quoted allowance), `restoredAssertions`, and
+   * any `SCENE_AUTHORING_ASSUMPTION` warnings. A
+   * completed result whose `metadata.review` is present passed every mandatory
+   * assertion but did NOT get the visual reviewer's approval: `verdict:
+   * "refused"` means it objected, each objection also a `SCENE_REVIEW_REFUSED`
+   * warning; `verdict: "unavailable"` means the review produced no usable
+   * verdict in `attempts` asks (`reason: "provider"` — never reached its
+   * provider; `"unusable"` — it answered, unusably), so nobody judged the scene and
+   * `SCENE_REVIEW_UNAVAILABLE` leads the warnings. Re-render that same
+   * `scenePlan` later with {@link render}, or with a `{kind:'scene'}` source;
+   * that costs no authoring.
+   */
+  async renderProAndWait(params, options) {
+    const quoteId = typeof params.quoteId === "string" ? params.quoteId : (await this.quotePro(params)).quoteId;
+    return this.client.nodes.runAndWait("pro-3d-render", { ...params, quoteId }, {
+      ...options,
+      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey()
+    });
+  }
+  /**
+   * Uses the supplied immutable revision; never starts authoring or a rebuild.
+   *
+   * Priced by the plan's frame size — see {@link RenderScene3DParams}.
+   */
+  render(params) {
+    return this.client.nodes.run("render-video", params);
+  }
+  renderAndWait(params, options) {
+    return this.client.nodes.runAndWait("render-video", params, options);
+  }
+};
+
+exports.SCENE3D_DELIVERY_ASSET_USAGE = SCENE3D_DELIVERY_ASSET_USAGE;
+exports.Scene3DResource = Scene3DResource;
+//# sourceMappingURL=chunk-YDRXBRW2.cjs.map
+//# sourceMappingURL=chunk-YDRXBRW2.cjs.map

package/dist/chunk-YDRXBRW2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/scene3d-types.ts","../src/resources/scene3d.ts"],"names":["SCENE3D_V2_LIMITS"],"mappings":"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","file":"chunk-YDRXBRW2.cjs","sourcesContent":["import type { Scene3DPlan, Scene3DPlanV2, Scene3DReference, Scene3DEditOperation, Scene3DV2EditOperation, Scene3DJobOutputAny as Scene3DWireJobOutput, Pro3DRenderCapabilities, Pro3DRenderEngine, Pro3DRenderJobOutput as Pro3DRenderWireOutput, Pro3DRenderQuality, Pro3DRenderQuote as Pro3DRenderWireQuote, Pro3DRenderSource, Pro3DRenderStyle } from \"@nodaro/shared/scene3d\"\nimport type { GenerationSessionParams } from \"./nodes.js\"\n\n/** Reuse newRevisionId for transport retries of the same immutable edit. */\nexport interface RetainedScene3DEditParams {\n  newRevisionId: string\n  expectedContentHash: string\n  operations: readonly Scene3DV2EditOperation[]\n  lockedObjectIds?: readonly string[]\n}\nexport interface RetainedScene3DEditResult { scenePlan: Scene3DPlanV2; changeSummary: string }\n\n/**\n * The kind of bytes a delivery descriptor names, and the usage it is pinned under.\n *\n * PAIRED, not two free enums: the platform refuses a pin whose usage is not the one its kind is\n * defined to have, and a client that checks only one of the two would accept a mis-pinned\n * artifact the server would then refuse. {@link SCENE3D_DELIVERY_ASSET_USAGE} is the map both\n * halves are read from.\n */\nexport const SCENE3D_DELIVERY_ASSET_USAGE = {\n  poster: \"poster\",\n  \"validation-report\": \"validation\",\n  \"shot-still\": \"shot-still\",\n  /** The recipe a run that never compiled was refused for. See {@link Scene3DDeliveryAsset}. */\n  \"source-json\": \"checkpoint\",\n} as const\n\nexport type Scene3DDeliveryAssetKind = keyof typeof SCENE3D_DELIVERY_ASSET_USAGE\n\n/**\n * One artifact a delivery pins, as a descriptor: opaque ids and digests only.\n *\n * Four kinds, and two of them are conditional:\n *\n * - `poster` and `validation-report` are on every delivery;\n * - `shot-still` appears once per shot on a render that produced a contact sheet, and carries\n *   its own shot identity (`shotIndex`, `frame`, and the frame size);\n * - `source-json` appears on ONE shape only — a `refused-authoring` delivery, published by a\n *   3D Render Pro run whose recipe the compiler refused on every pass. It is the planner's last\n *   admitted recipe, and it is the only thing such a run leaves that names what was attempted.\n *   Reading it needs `edit` on the job's workflow (the same access the `.blend` export costs);\n *   a reader with less simply does not see the descriptor.\n */\nexport interface Scene3DDeliveryAsset {\n  assetId: string\n  kind: Scene3DDeliveryAssetKind\n  usage: (typeof SCENE3D_DELIVERY_ASSET_USAGE)[Scene3DDeliveryAssetKind]\n  byteLength: number\n  sha256: string\n  viaRevisionId: string | null\n  /** Set on a `shot-still` and absent on every other kind — never `null`. */\n  shotIndex?: number\n  frame?: number\n  width?: number\n  height?: number\n}\n\n/** Export evidence is retained separately from the immutable scene it rendered. */\nexport interface Scene3DDelivery {\n  deliveryId: string\n  /**\n   * Null on a `refused-authoring` delivery and on that alone.\n   *\n   * A Pro run whose recipe the compiler refused on every pass still retains the refusal\n   * report, but nothing was ever compiled, so no scene revision was published. The field is\n   * null rather than absent so the shape stays one shape; read `sourceKind` to tell why.\n   */\n  sceneRevisionId: string | null\n  /**\n   * What this delivery was made from. Absent when read from a deployment that predates the\n   * refused lane, where every delivery necessarily had a scene behind it.\n   */\n  sourceKind?: \"retained-revision\" | \"job-output\" | \"refused-authoring\"\n  /** Null when there is no plan to hash — see `sceneRevisionId`. */\n  sourcePlanSha256: string | null\n  sourceContentHash: string | null\n  sourceJobId: string | null\n  workflowId: string | null\n  mode: \"authored\" | \"render-only\"\n  createdAt: string\n  access: \"view\" | \"edit\" | \"own\"\n  assets: Scene3DDeliveryAsset[]\n}\n\nexport type Scene3DAuthoringEngine = \"basic\" | \"blender-cloud\" | \"blender-local\"\n\nexport interface Scene3DCapabilities {\n  basic: { available: boolean; sceneSchemaVersions: number[] }\n  advanced: null | {\n    version: string\n    engines: Array<Exclude<Scene3DAuthoringEngine, \"basic\">>\n    sceneSchemaVersions: number[]\n    maxRepairPasses: number\n  }\n  /**\n   * What this deployment can serve for `pro-3d-render`, including which\n   * quality profiles, engines and aspect ratios a client may OFFER. Optional so\n   * a client of this version reads an older backend without throwing; absent\n   * means the node is unavailable.\n   */\n  pro?: Pro3DRenderCapabilities\n}\n\ninterface Scene3DEngineParams {\n  /** Basic is the default. Discover optional engines through scene3d.capabilities(). */\n  engine?: Scene3DAuthoringEngine\n  acceptedSceneSchemaVersions?: readonly number[]\n  localConnectionId?: string\n  quoteId?: string\n  maxRepairPasses?: number\n}\n\n/** Structured authoring inputs; reference roles are interpreted by the platform. */\nexport interface GenerateScene3DParams extends Record<string, unknown>, Scene3DEngineParams, GenerationSessionParams {\n  /** Existing GLBs selected by immutable revision/artifact IDs. Requires an import-capable advanced engine. */\n  inputAssets?: readonly import(\"@nodaro/shared/scene3d\").Scene3DInputAsset[]\n  prompt: string\n  durationSeconds?: number\n  fps?: number\n  aspectRatio?: string\n  references?: readonly Scene3DReference[]\n  llmModel?: string\n  reasoningEffort?: string\n  workflowId?: string\n  nodeId?: string\n}\n\n/** Editing creates a new revision and never mutates the supplied scene. */\nexport interface EditScene3DParams extends Record<string, unknown>, Scene3DEngineParams, GenerationSessionParams {\n  scenePlan: Scene3DPlan\n  expectedRevisionId: string\n  /** Replace the complete reference set, including clearing it with an empty list. Default: merge by id. */\n  replaceReferences?: boolean\n  /** Supply an instruction or deterministic operations, never both. */\n  prompt?: string\n  operations?: readonly (Scene3DEditOperation | Scene3DV2EditOperation)[]\n  references?: readonly Scene3DReference[]\n  lockedObjectIds?: readonly string[]\n  selectedObjectIds?: readonly string[]\n  llmModel?: string\n  reasoningEffort?: string\n  workflowId?: string\n  nodeId?: string\n}\n\n/**\n * 3D Render Pro — ONE durable operation producing a composition and its MP4.\n *\n * `source` is a strict discriminated union, not a bag of optionals:\n *  - `{kind:'prompt', prompt, references?}` authors a new scene;\n *  - `{kind:'scene', revisionId, sourceJobId}` with NO `editPrompt` is the\n *    render-only export — it spends no authoring or build credits, and OMIT\n *    the field rather than sending `\"\"`, which would buy an authoring pass;\n *  - `{kind:'local-export', exportId, connectionId}` uses a paired desktop.\n *\n * There is no model or effort field: the planner is fixed and server-owned.\n *\n * `durationSeconds` / `fps` / `aspectRatio` on a `scene` source are an EXPLICIT\n * re-time request. Omit them to keep the source's own timing; a conflicting\n * override is rejected rather than silently applied.\n */\nexport interface Pro3DRenderParams extends Record<string, unknown> {\n  source: Pro3DRenderSource\n  /** Optional. An unknown or unavailable engine is rejected, never downgraded. */\n  engine?: Pro3DRenderEngine\n  /** Names a paired desktop for a local run. */\n  localConnectionId?: string\n  durationSeconds?: number\n  fps?: number\n  aspectRatio?: string\n  quality?: Pro3DRenderQuality\n  style?: Pro3DRenderStyle\n  /** Correction budget, 0-2. Each pass is paid work. */\n  maxRepairPasses?: number\n  /**\n   * Which scene-schema versions THIS client can render. A prompt or\n   * local-export source mints v2, so omitting 2 is refused for free; a scene\n   * source inherits its revision's version and is left to the server.\n   */\n  acceptedSceneSchemaVersions?: readonly number[]\n  workflowId?: string\n  nodeId?: string\n  /** Keep every artifact of this run out of publicly-readable storage. */\n  forcePrivate?: boolean\n}\n\n/** A run additionally carries the quote it was priced under. */\nexport interface Pro3DRenderRunParams extends Pro3DRenderParams {\n  quoteId: string\n}\n\n/** The quote's answer. `maxCredits` is a ceiling; quoting spends nothing. */\nexport type Pro3DRenderQuote = Readonly<Pro3DRenderWireQuote> & Readonly<Record<string, unknown>>\n\n/** Per-call transport controls for the paid run. */\nexport interface Pro3DRenderRunOptions {\n  /**\n   * The `Idempotency-Key` the run is submitted under. Reuse the same value when\n   * retrying a call that timed out, so the run is not started twice; the SDK\n   * generates a fresh one per call when this is omitted, because two deliberate\n   * calls are two runs.\n   */\n  idempotencyKey?: string\n}\n\n/**\n * Render the exact scene revision through the existing render-video node.\n *\n * The price follows the plan's OWN `width`/`height`, not any node setting: a\n * frame up to 1920 px on its longest side settles under `render-video`, a\n * larger one under `render-video:3d-large` (1.5x) or, above 5.12 megapixels,\n * `render-video:3d-xlarge` (2.5x). Read the current numbers from the\n * model-cost API for those three identifiers.\n */\nexport interface RenderScene3DParams extends Record<string, unknown>, GenerationSessionParams {\n  planType: \"3d-scene\"\n  plan: Scene3DPlan\n  workflowId?: string\n  nodeId?: string\n}\n\n/**\n * Preserve the shared wire contract while allowing additive job metadata.\n *\n * A scene authored by an ADVANCED engine additionally reports what the run knows about its own\n * answer, every field optional and all of them absent on the deterministic Basic lane:\n * `validation.warnings[]` entries coded `SCENE_AUTHORING_ASSUMPTION` (the planner's\n * assumptions), `metadata.summary` (its description of what it authored), `repairPasses`\n * (repairs actually run — `0` when the scene was accepted first time), `admissionRetries`\n * (pre-build planner retries, which spend no repair pass), `mechanicalPasses` (repairs the engine\n * applied from the compiler's own remedy with no planner call, counted APART from `repairPasses`\n * on their own quoted allowance, each with a `REMEDY_AUTO_APPLIED` warning) and\n * `restoredAssertions` (mandatory assertions put back after a planner answer re-shaped one the\n * feedback had not named, each a `ASSERTION_RESTORED` warning).\n *\n * A scene that passed every mandatory assertion but did not get the visual reviewer's approval\n * is delivered anyway, and `metadata.review` carries a verdict saying why. `verdict: \"refused\"`\n * is the ADVISORY delivery — the reviewer objected once the repair budget was spent — with one\n * `SCENE_REVIEW_REFUSED` warning per objection. `verdict: \"unavailable\"` is the UNREVIEWED\n * delivery: the review produced no usable verdict after `attempts` asks — `reason: \"provider\"`\n * when it never reached its provider, `\"unusable\"` when the provider answered with nothing usable\n * (`Scene3DReviewUnavailableReason` in `@nodaro/shared`) — so nobody judged the scene, and\n * `validation.warnings[]` LEADS with `SCENE_REVIEW_UNAVAILABLE` (any objections under it came from\n * review batches that answered usably first, and are not the whole verdict).\n *\n * `validation.status` stays `\"passed\"` on both, so `metadata.review` being present is the only\n * reliable test — use `scene3DReviewVerdictOf` from `@nodaro/shared` rather than reading it by\n * hand, and `scene3DReviewNote` rather than writing the sentence yourself: a message that says\n * the reviewer refused a scene nobody reviewed invents an opinion.\n */\nexport type Scene3DJobOutput = Readonly<Scene3DWireJobOutput> & Readonly<Record<string, unknown>>\n\n/**\n * The settled 3D Render Pro result, plus any additive job metadata.\n *\n * On a run that AUTHORED, the result reports the run's own account of its answer:\n * `validation.warnings[]` entries coded `SCENE_AUTHORING_ASSUMPTION`, `metadata.summary`,\n * `repairPasses` (`0` when accepted first time), `admissionRetries` (pre-build planner retries,\n * which spend no repair pass), `mechanicalPasses` (repairs the engine authored itself from the\n * compiler's own remedy, counted APART from `repairPasses` because they buy their own quoted\n * allowance rather than spending one of your repairs) and `restoredAssertions`. A render-only\n * export authored nothing, so it carries no summary and omits the counts rather than claiming `0`.\n *\n * The one case where `mechanicalPasses` IS a subset of `repairPasses` is a run quoted before that\n * allowance existed — its quote carries no `mechanical` line. The discriminant is the quote, not\n * the result, so read the quote you were given rather than deriving it from the two counts.\n *\n * A completed result may also be published without the visual reviewer's approval, and then\n * `metadata.review` holds a verdict saying which way. `{ verdict: \"refused\", objections[],\n * observed? }` is the ADVISORY delivery: every mandatory assertion passed, the reviewer still\n * objected, and the scene was published once the repair budget was spent, with one\n * `SCENE_REVIEW_REFUSED` warning per objection. `{ verdict: \"unavailable\", reason, attempts,\n * objections[], observed? }` is the UNREVIEWED delivery: the review produced no usable verdict in\n * `attempts` asks — `reason: \"provider\"` when it never reached its provider, `\"unusable\"` when the\n * provider answered with nothing usable — so the assertion-passing scene was delivered with no\n * verdict on it and `validation.warnings[]` LEADS with `SCENE_REVIEW_UNAVAILABLE`. Objections on\n * that arm are whatever review batches answered usably first — real, but not the whole verdict.\n *\n * `validation.status` is `\"passed\"` on both, so test for `metadata.review` — via\n * `scene3DReviewVerdictOf` from `@nodaro/shared` — rather than for the status or the warnings,\n * and render it with `scene3DReviewNote` rather than assuming a refusal.\n */\nexport type Pro3DRenderJobOutput = Readonly<Pro3DRenderWireOutput> & Readonly<Record<string, unknown>>\n","import { SCENE3D_V2_LIMITS, type Scene3DAssetRef } from \"@nodaro/shared/scene3d\"\nimport type { NodaroClientCore } from \"../core.js\"\nimport type { RunNodeResult, RunAndWaitOptions, NodeJobOutput, NodesResource } from \"./nodes.js\"\nimport type { EditScene3DParams, GenerateScene3DParams, Pro3DRenderJobOutput, Pro3DRenderParams, Pro3DRenderQuote, Pro3DRenderRunOptions, Pro3DRenderRunParams, RenderScene3DParams, Scene3DCapabilities, Scene3DJobOutput } from \"./scene3d-types.js\"\nimport type { RetainedScene3DEditParams, RetainedScene3DEditResult } from \"./scene3d-types.js\"\nimport { SCENE3D_DELIVERY_ASSET_USAGE } from \"./scene3d-types.js\"\nimport type { Scene3DDelivery, Scene3DDeliveryAsset } from \"./scene3d-types.js\"\n\n/**\n * A fresh per-call retry token.\n *\n * Random rather than derived from the request: two deliberate calls with the\n * same parameters are two runs, and collapsing them would silently swallow the\n * second. A caller who wants retry safety passes its own key.\n */\nfunction newIdempotencyKey(): string {\n  const random = globalThis.crypto?.randomUUID?.()\n  return `sdk-pro3d-${random ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`}`\n}\n\n/** Scene authoring and render-only export through the same platform nodes. */\nexport class Scene3DResource {\n  /** Every operation runs a platform node, so the client must carry `nodes` too. */\n  constructor(private client: NodaroClientCore & { readonly nodes: NodesResource }) {}\n\n  capabilities(): Promise<Scene3DCapabilities> {\n    return this.client.request(\"GET\", \"/v1/3d-scene/capabilities\")\n  }\n\n  /** Current access to both the delivery and its source is required on every read. */\n  getDelivery(jobId: string): Promise<Scene3DDelivery> {\n    return this.client.request(\"GET\", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}`)\n  }\n\n  /**\n   * The bytes of one descriptor the delivery listed.\n   *\n   * Checked against {@link SCENE3D_DELIVERY_ASSET_USAGE} rather than a hardcoded pair, which\n   * is why a `shot-still` now works: the route has served stills since they existed, and this\n   * guard refused them. `source-json` — the recipe a refused run was kept for — is on the same\n   * map; the server still decides whether THIS caller may read it.\n   */\n  deliveryAssetBytes(jobId: string, asset: Scene3DDeliveryAsset, options?: { signal?: AbortSignal }): Promise<ArrayBuffer> {\n    if (SCENE3D_DELIVERY_ASSET_USAGE[asset.kind] !== asset.usage) {\n      throw new Error(\"This asset is not available through the delivery endpoint\")\n    }\n    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {\n      throw new Error(\"Invalid scene delivery asset byte length\")\n    }\n    return this.client.requestBytes(\"GET\", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}/assets/${encodeURIComponent(asset.assetId)}`, {\n      signal: options?.signal, maxBytes: asset.byteLength,\n    })\n  }\n\n  /**\n   * The recipe a 3D Render Pro run was refused for, parsed — or `null` when there is none.\n   *\n   * The one thing such a run leaves behind. Its recipe never compiled, so there is no scene\n   * revision, no poster and no `.blend`: `output_data` carries a `deliveryId`, the compiler's\n   * reasons, and `validation.sourceRetained` saying whether the recipe itself was kept. This\n   * fetches it in one call — delivery, then the `source-json` descriptor's bytes.\n   *\n   * `null` means the delivery has no retained recipe to hand back: no pass ever cleared\n   * admission, or this caller holds less than `edit` on the job's workflow and the descriptor\n   * is therefore not listed for them.\n   *\n   * Read it to see what was attempted and to inform the next prompt. There is no input that\n   * takes a recipe back: a refused run published no revision, so there is no `{kind:\"scene\"}`\n   * source to re-run it from.\n   */\n  async retainedRecipe(jobId: string, options?: { signal?: AbortSignal }): Promise<unknown | null> {\n    const delivery = await this.getDelivery(jobId)\n    const asset = delivery.assets.find((item) => item.kind === \"source-json\")\n    if (!asset) return null\n    const bytes = await this.deliveryAssetBytes(jobId, asset, options)\n    return JSON.parse(new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes)) as unknown\n  }\n\n  /** Persist deterministic overlays without an LLM or a generation charge. */\n  applyEdits(revisionId: string, params: RetainedScene3DEditParams): Promise<RetainedScene3DEditResult> {\n    return this.client.request(\"POST\", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/edits`, { body: params })\n  }\n\n  /** Asset access is scoped to an exact retained revision, with fresh authentication. */\n  assetBytes(revisionId: string, asset: Scene3DAssetRef, options?: { signal?: AbortSignal }): Promise<ArrayBuffer> {\n    if (![\"glb\", \"camera-track-json\", \"poster\", \"validation-report\"].includes(asset.kind)) {\n      throw new Error(\"This asset is not available through the playback endpoint\")\n    }\n    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {\n      throw new Error(\"Invalid scene asset byte length\")\n    }\n    return this.client.requestBytes(\"GET\", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/assets/${encodeURIComponent(asset.assetId)}`, {\n      signal: options?.signal, maxBytes: asset.byteLength,\n    })\n  }\n\n  /** The editable native file has its own authorization lane. */\n  sourceBytes(revisionId: string, options?: { signal?: AbortSignal }): Promise<ArrayBuffer> {\n    return this.client.requestBytes(\"GET\", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/source`, {\n      signal: options?.signal, maxBytes: SCENE3D_V2_LIMITS.maxBlendSourceBytes,\n    })\n  }\n\n  generate(params: GenerateScene3DParams): Promise<RunNodeResult> {\n    return this.client.nodes.run(\"generate-3d-scene\", params)\n  }\n\n  generateAndWait(params: GenerateScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput> {\n    return this.client.nodes.runAndWait(\"generate-3d-scene\", params, options)\n  }\n\n  edit(params: EditScene3DParams): Promise<RunNodeResult> {\n    return this.client.nodes.run(\"edit-3d-scene\", params)\n  }\n\n  editAndWait(params: EditScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput> {\n    return this.client.nodes.runAndWait(\"edit-3d-scene\", params, options)\n  }\n\n  /**\n   * Price a 3D Render Pro request WITHOUT starting it.\n   *\n   * Takes the same body a run takes, minus the `quoteId`, and answers a\n   * ceiling (`maxCredits`), a `breakdown` to show, and the\n   * `normalizedInputHash` admission re-checks. It reserves nothing and spends\n   * nothing — a quote is a price, not a purchase.\n   */\n  quotePro(params: Pro3DRenderParams): Promise<Pro3DRenderQuote> {\n    return this.client.request(\"POST\", \"/v1/pro-3d-render/quote\", { body: params })\n  }\n\n  /**\n   * Submit a quoted 3D Render Pro run.\n   *\n   * Requires the `quoteId` from {@link quotePro}: no run starts at a price\n   * nobody showed. Sends an `Idempotency-Key` — a fresh one per call unless you\n   * supply your own, which you should when retrying a call that timed out.\n   *\n   * Availability is a property of the deployment: `capabilities().pro` says\n   * whether this install can serve it, and which controls you may offer.\n   */\n  runPro(params: Pro3DRenderRunParams, options?: Pro3DRenderRunOptions): Promise<RunNodeResult> {\n    return this.client.nodes.run(\"pro-3d-render\", params, {\n      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey(),\n    })\n  }\n\n  /**\n   * Quote if needed, run, and wait — the whole operation in one call.\n   *\n   * Two HTTP requests at most, still ONE paid job: when `quoteId` is absent\n   * this quotes the identical body first, so the run is admitted against a\n   * hash of exactly what was priced. Pass a `quoteId` to run against a quote\n   * you already showed the user.\n   *\n   * Resolves with the settled result — `videoUrl` (the MP4) and `scenePlan`\n   * (the exact composition it was rendered from), plus the revision, poster,\n   * validation and renderer metadata. A run that AUTHORED also reports its own\n   * account of the answer — `metadata.summary`, `repairPasses`,\n   * `admissionRetries`, `mechanicalPasses` (repairs the engine applied from\n   * the compiler's own remedy with no planner call, counted APART from\n   * `repairPasses` on their own quoted allowance), `restoredAssertions`, and\n   * any `SCENE_AUTHORING_ASSUMPTION` warnings. A\n   * completed result whose `metadata.review` is present passed every mandatory\n   * assertion but did NOT get the visual reviewer's approval: `verdict:\n   * \"refused\"` means it objected, each objection also a `SCENE_REVIEW_REFUSED`\n   * warning; `verdict: \"unavailable\"` means the review produced no usable\n   * verdict in `attempts` asks (`reason: \"provider\"` — never reached its\n   * provider; `\"unusable\"` — it answered, unusably), so nobody judged the scene and\n   * `SCENE_REVIEW_UNAVAILABLE` leads the warnings. Re-render that same\n   * `scenePlan` later with {@link render}, or with a `{kind:'scene'}` source;\n   * that costs no authoring.\n   */\n  async renderProAndWait(\n    params: Pro3DRenderParams | Pro3DRenderRunParams,\n    options?: RunAndWaitOptions & Pro3DRenderRunOptions,\n  ): Promise<Pro3DRenderJobOutput> {\n    const quoteId =\n      typeof (params as Pro3DRenderRunParams).quoteId === \"string\"\n        ? (params as Pro3DRenderRunParams).quoteId\n        : (await this.quotePro(params)).quoteId\n    return this.client.nodes.runAndWait(\"pro-3d-render\", { ...params, quoteId }, {\n      ...options,\n      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey(),\n    })\n  }\n\n  /**\n   * Uses the supplied immutable revision; never starts authoring or a rebuild.\n   *\n   * Priced by the plan's frame size — see {@link RenderScene3DParams}.\n   */\n  render(params: RenderScene3DParams): Promise<RunNodeResult> {\n    return this.client.nodes.run(\"render-video\", params)\n  }\n\n  renderAndWait(params: RenderScene3DParams, options?: RunAndWaitOptions): Promise<NodeJobOutput> {\n    return this.client.nodes.runAndWait(\"render-video\", params, options)\n  }\n}\n"]}

package/dist/chunk-YFS2LMG4.cjs

@@ -0,0 +1,124 @@
+'use strict';
+
+// src/resources/competitors.ts
+var CompetitorsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** `GET /v1/competitors` → every tracked brand. */
+  async list() {
+    const res = await this.listWithPlan();
+    return [...res.data];
+  }
+  /** `GET /v1/competitors` → every tracked brand, with how many months of scans your plan keeps. */
+  listWithPlan() {
+    return this.client.request("GET", "/v1/competitors");
+  }
+  /**
+   * `GET /v1/competitors/:id` → one brand with its latest scan (posts and
+   * cards) and its scan history; with `scan`, the brand as of that scan.
+   */
+  get(id, options = {}) {
+    const query = options.scan ? `?scan=${encodeURIComponent(options.scan)}` : "";
+    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}${query}`);
+  }
+  /** `GET /v1/competitors/:id/history` → the brand's scans oldest first, per platform what each found and read (free). */
+  history(id) {
+    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}/history`);
+  }
+  /**
+   * `GET /v1/competitors/:id/compare` → the brand over a period, and over a
+   * second one to compare with (free). A post belongs to a period by its
+   * publish date; a period is at most a year.
+   */
+  compare(id, input) {
+    const params = new URLSearchParams({ from: input.from, to: input.to });
+    if (input.vsFrom !== void 0 && input.vsTo !== void 0) {
+      params.set("vsFrom", input.vsFrom);
+      params.set("vsTo", input.vsTo);
+    }
+    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}/compare?${params.toString()}`);
+  }
+  /** `POST /v1/competitors` → track a brand. Accounts take handles or links. */
+  create(input) {
+    return this.client.request("POST", "/v1/competitors", { body: input });
+  }
+  /**
+   * `PATCH /v1/competitors/:id` → change its accounts, platforms, name or schedule.
+   * `accounts` replaces the whole set: pass every account to keep. Send
+   * `schedule` only to change it (it restarts the brand's schedule). While a
+   * scan of the brand runs, a change to its name, accounts, platforms or
+   * `isOwn` is refused with `409 scan_running`.
+   */
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/competitors/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** `DELETE /v1/competitors/:id` → stop tracking it (its scans go too). */
+  async delete(id) {
+    await this.client.request("DELETE", `/v1/competitors/${encodeURIComponent(id)}`);
+  }
+  /** `GET /v1/competitors/cards` → every action card, most urgent first, with the posts they rest on. */
+  cards() {
+    return this.client.request("GET", "/v1/competitors/cards");
+  }
+  /**
+   * `GET /v1/competitors/:id/lessons` → what works for a brand: per platform,
+   * what its best posts share, measured on its own posts across every stored
+   * scan, with the posts each lesson rests on (free). "What works for you" on
+   * the brand marked as yours.
+   */
+  lessons(id) {
+    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}/lessons`);
+  }
+  /**
+   * `GET /v1/competitors/actions` → the cards you marked "I did this", newest
+   * first, each with how it went (`outcome`), and your track record per
+   * family of advice (free). Each scan of your own brand judges the post that
+   * came of a card once it is a few days old; the first verdict stays.
+   */
+  tried() {
+    return this.client.request("GET", "/v1/competitors/actions");
+  }
+  /**
+   * `POST /v1/competitors/actions` → "I did this" on a card on your wall (its
+   * `id` from `cards()`), optionally with the link to your post that came of
+   * it. Only cards whose advice ends in a post of yours can be marked
+   * (`400 not_measurable`). Marking a marked card returns its mark
+   * (`created: false`).
+   */
+  markDone(cardId, options = {}) {
+    return this.client.request("POST", "/v1/competitors/actions", { body: { cardId, ...options.postUrl ? { postUrl: options.postUrl } : {} } });
+  }
+  /**
+   * `PATCH /v1/competitors/actions/:id` → link the post that came of a marked
+   * card (the post's full link; a short link is refused with `400
+   * short_link`), or `null` to remove the link. Another post is judged afresh.
+   */
+  linkPost(markId, postUrl) {
+    return this.client.request("PATCH", `/v1/competitors/actions/${encodeURIComponent(markId)}`, { body: { postUrl } });
+  }
+  /** `PATCH /v1/competitors/actions/:id` with `seen: true` → you have seen its verdict (the app stops announcing it). */
+  markSeen(markId) {
+    return this.client.request("PATCH", `/v1/competitors/actions/${encodeURIComponent(markId)}`, { body: { seen: true } });
+  }
+  /** `DELETE /v1/competitors/actions/:id` → undo "I did this" (its verdict leaves your track record). */
+  async unmark(markId) {
+    await this.client.request("DELETE", `/v1/competitors/actions/${encodeURIComponent(markId)}`);
+  }
+  /** `POST /v1/competitor-discover` → a brand's accounts found from its website (free; guesses are marked). */
+  discover(website) {
+    return this.client.request("POST", "/v1/competitor-discover", { body: { website } });
+  }
+  /**
+   * `POST /v1/competitor-scan` → scan a brand now. Answers with a job id;
+   * poll `client.jobs.getStatus(jobId)`, then read `get(id)` or `cards()`.
+   */
+  scan(id) {
+    return this.client.request("POST", "/v1/competitor-scan", { body: { competitorId: id } });
+  }
+};
+
+exports.CompetitorsResource = CompetitorsResource;
+//# sourceMappingURL=chunk-YFS2LMG4.cjs.map
+//# sourceMappingURL=chunk-YFS2LMG4.cjs.map

package/dist/chunk-YFS2LMG4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/competitors.ts"],"names":[],"mappings":";;;AAyBO,IAAM,sBAAN,MAA0B;AAAA,EAC/B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,MAAM,IAAA,GAAqC;AACzC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,YAAA,EAAa;AACpC,IAAA,OAAO,CAAC,GAAG,GAAA,CAAI,IAAI,CAAA;AAAA,EACrB;AAAA;AAAA,EAGA,YAAA,GAA8C;AAC5C,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA8B,KAAA,EAAO,iBAAiB,CAAA;AAAA,EAC3E;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,GAAA,CAAI,EAAA,EAAY,OAAA,GAAsC,EAAC,EAA8B;AACnF,IAAA,MAAM,KAAA,GAAQ,QAAQ,IAAA,GAAO,CAAA,MAAA,EAAS,mBAAmB,OAAA,CAAQ,IAAI,CAAC,CAAA,CAAA,GAAK,EAAA;AAC3E,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA0B,KAAA,EAAO,CAAA,gBAAA,EAAmB,mBAAmB,EAAE,CAAC,CAAA,EAAG,KAAK,CAAA,CAAE,CAAA;AAAA,EACzG;AAAA;AAAA,EAGA,QAAQ,EAAA,EAAwC;AAC9C,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,KAAA,EAAO,mBAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,QAAA,CAAU,CAAA;AAAA,EAC1G;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAA,CAAQ,IAAY,KAAA,EAAiE;AACnF,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,CAAgB,EAAE,IAAA,EAAM,MAAM,IAAA,EAAM,EAAA,EAAI,KAAA,CAAM,EAAA,EAAI,CAAA;AACrE,IAAA,IAAI,KAAA,CAAM,MAAA,KAAW,MAAA,IAAa,KAAA,CAAM,SAAS,MAAA,EAAW;AAC1D,MAAA,MAAA,CAAO,GAAA,CAAI,QAAA,EAAU,KAAA,CAAM,MAAM,CAAA;AACjC,MAAA,MAAA,CAAO,GAAA,CAAI,MAAA,EAAQ,KAAA,CAAM,IAAI,CAAA;AAAA,IAC/B;AACA,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAiC,KAAA,EAAO,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,SAAA,EAAY,MAAA,CAAO,QAAA,EAAU,CAAA,CAAE,CAAA;AAAA,EACrI;AAAA;AAAA,EAGA,OAAO,KAAA,EAA0D;AAC/D,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,mBAAmB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC1F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAA,CAAO,IAAY,KAAA,EAA0D;AAC3E,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA2B,OAAA,EAAS,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA,EAAI,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,EACrH;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;AAAA;AAAA,EAGA,KAAA,GAAwC;AACtC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA+B,KAAA,EAAO,uBAAuB,CAAA;AAAA,EAClF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,QAAQ,EAAA,EAA8C;AACpD,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAiC,KAAA,EAAO,mBAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,QAAA,CAAU,CAAA;AAAA,EAChH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,KAAA,GAA0C;AACxC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAiC,KAAA,EAAO,yBAAyB,CAAA;AAAA,EACtF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,QAAA,CAAS,MAAA,EAAgB,OAAA,GAAgC,EAAC,EAA8B;AACtF,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA0B,MAAA,EAAQ,2BAA2B,EAAE,IAAA,EAAM,EAAE,MAAA,EAAQ,GAAI,QAAQ,OAAA,GAAU,EAAE,SAAS,OAAA,CAAQ,OAAA,KAAY,EAAC,IAAM,CAAA;AAAA,EAChK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,QAAA,CAAS,QAAgB,OAAA,EAAmD;AAC1E,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA0B,OAAA,EAAS,2BAA2B,kBAAA,CAAmB,MAAM,CAAC,CAAA,CAAA,EAAI,EAAE,IAAA,EAAM,EAAE,OAAA,IAAW,CAAA;AAAA,EACtI;AAAA;AAAA,EAGA,SAAS,MAAA,EAA2C;AAClD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA0B,OAAA,EAAS,2BAA2B,kBAAA,CAAmB,MAAM,CAAC,CAAA,CAAA,EAAI,EAAE,IAAA,EAAM,EAAE,IAAA,EAAM,IAAA,IAAQ,CAAA;AAAA,EACzI;AAAA;AAAA,EAGA,MAAM,OAAO,MAAA,EAA+B;AAC1C,IAAA,MAAM,IAAA,CAAK,OAAO,OAAA,CAA2B,QAAA,EAAU,2BAA2B,kBAAA,CAAmB,MAAM,CAAC,CAAA,CAAE,CAAA;AAAA,EAChH;AAAA;AAAA,EAGA,SAAS,OAAA,EAA+C;AACtD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA6B,MAAA,EAAQ,yBAAA,EAA2B,EAAE,IAAA,EAAM,EAAE,OAAA,EAAQ,EAAG,CAAA;AAAA,EAC1G;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,KAAK,EAAA,EAAwC;AAC3C,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA2B,MAAA,EAAQ,qBAAA,EAAuB,EAAE,IAAA,EAAM,EAAE,YAAA,EAAc,EAAA,EAAG,EAAG,CAAA;AAAA,EAC7G;AACF","file":"chunk-YFS2LMG4.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type {\n  CardActionResult,\n  CompetitorActionsResult,\n  CompetitorCardsResult,\n  CompetitorCompareInput,\n  CompetitorCompareResult,\n  CompetitorDetail,\n  CompetitorDiscovery,\n  CompetitorHistory,\n  CompetitorLessonsResult,\n  CompetitorListResult,\n  CreateCompetitorInput,\n  TrackedCompetitor,\n  UpdateCompetitorInput,\n} from \"@nodaro/shared/social\"\n\n/**\n * Competitors — brands you track (competitors, or your own), their scans and\n * the action cards read from them. Nodaro Cloud.\n *\n * Adding, reading and website lookups are free. A scan costs one Social\n * Search page per search it runs (`TrackedCompetitor.searches`); searches that\n * fail are not charged.\n */\nexport class CompetitorsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** `GET /v1/competitors` → every tracked brand. */\n  async list(): Promise<TrackedCompetitor[]> {\n    const res = await this.listWithPlan()\n    return [...res.data]\n  }\n\n  /** `GET /v1/competitors` → every tracked brand, with how many months of scans your plan keeps. */\n  listWithPlan(): Promise<CompetitorListResult> {\n    return this.client.request<CompetitorListResult>(\"GET\", \"/v1/competitors\")\n  }\n\n  /**\n   * `GET /v1/competitors/:id` → one brand with its latest scan (posts and\n   * cards) and its scan history; with `scan`, the brand as of that scan.\n   */\n  get(id: string, options: { readonly scan?: string } = {}): Promise<CompetitorDetail> {\n    const query = options.scan ? `?scan=${encodeURIComponent(options.scan)}` : \"\"\n    return this.client.request<CompetitorDetail>(\"GET\", `/v1/competitors/${encodeURIComponent(id)}${query}`)\n  }\n\n  /** `GET /v1/competitors/:id/history` → the brand's scans oldest first, per platform what each found and read (free). */\n  history(id: string): Promise<CompetitorHistory> {\n    return this.client.request<CompetitorHistory>(\"GET\", `/v1/competitors/${encodeURIComponent(id)}/history`)\n  }\n\n  /**\n   * `GET /v1/competitors/:id/compare` → the brand over a period, and over a\n   * second one to compare with (free). A post belongs to a period by its\n   * publish date; a period is at most a year.\n   */\n  compare(id: string, input: CompetitorCompareInput): Promise<CompetitorCompareResult> {\n    const params = new URLSearchParams({ from: input.from, to: input.to })\n    if (input.vsFrom !== undefined && input.vsTo !== undefined) {\n      params.set(\"vsFrom\", input.vsFrom)\n      params.set(\"vsTo\", input.vsTo)\n    }\n    return this.client.request<CompetitorCompareResult>(\"GET\", `/v1/competitors/${encodeURIComponent(id)}/compare?${params.toString()}`)\n  }\n\n  /** `POST /v1/competitors` → track a brand. Accounts take handles or links. */\n  create(input: CreateCompetitorInput): Promise<TrackedCompetitor> {\n    return this.client.request<TrackedCompetitor>(\"POST\", \"/v1/competitors\", { body: input })\n  }\n\n  /**\n   * `PATCH /v1/competitors/:id` → change its accounts, platforms, name or schedule.\n   * `accounts` replaces the whole set: pass every account to keep. Send\n   * `schedule` only to change it (it restarts the brand's schedule). While a\n   * scan of the brand runs, a change to its name, accounts, platforms or\n   * `isOwn` is refused with `409 scan_running`.\n   */\n  update(id: string, input: UpdateCompetitorInput): Promise<TrackedCompetitor> {\n    return this.client.request<TrackedCompetitor>(\"PATCH\", `/v1/competitors/${encodeURIComponent(id)}`, { body: input })\n  }\n\n  /** `DELETE /v1/competitors/:id` → stop tracking it (its scans go too). */\n  async delete(id: string): Promise<void> {\n    await this.client.request<{ success: true }>(\"DELETE\", `/v1/competitors/${encodeURIComponent(id)}`)\n  }\n\n  /** `GET /v1/competitors/cards` → every action card, most urgent first, with the posts they rest on. */\n  cards(): Promise<CompetitorCardsResult> {\n    return this.client.request<CompetitorCardsResult>(\"GET\", \"/v1/competitors/cards\")\n  }\n\n  /**\n   * `GET /v1/competitors/:id/lessons` → what works for a brand: per platform,\n   * what its best posts share, measured on its own posts across every stored\n   * scan, with the posts each lesson rests on (free). \"What works for you\" on\n   * the brand marked as yours.\n   */\n  lessons(id: string): Promise<CompetitorLessonsResult> {\n    return this.client.request<CompetitorLessonsResult>(\"GET\", `/v1/competitors/${encodeURIComponent(id)}/lessons`)\n  }\n\n  /**\n   * `GET /v1/competitors/actions` → the cards you marked \"I did this\", newest\n   * first, each with how it went (`outcome`), and your track record per\n   * family of advice (free). Each scan of your own brand judges the post that\n   * came of a card once it is a few days old; the first verdict stays.\n   */\n  tried(): Promise<CompetitorActionsResult> {\n    return this.client.request<CompetitorActionsResult>(\"GET\", \"/v1/competitors/actions\")\n  }\n\n  /**\n   * `POST /v1/competitors/actions` → \"I did this\" on a card on your wall (its\n   * `id` from `cards()`), optionally with the link to your post that came of\n   * it. Only cards whose advice ends in a post of yours can be marked\n   * (`400 not_measurable`). Marking a marked card returns its mark\n   * (`created: false`).\n   */\n  markDone(cardId: string, options: { postUrl?: string } = {}): Promise<CardActionResult> {\n    return this.client.request<CardActionResult>(\"POST\", \"/v1/competitors/actions\", { body: { cardId, ...(options.postUrl ? { postUrl: options.postUrl } : {}) } })\n  }\n\n  /**\n   * `PATCH /v1/competitors/actions/:id` → link the post that came of a marked\n   * card (the post's full link; a short link is refused with `400\n   * short_link`), or `null` to remove the link. Another post is judged afresh.\n   */\n  linkPost(markId: string, postUrl: string | null): Promise<CardActionResult> {\n    return this.client.request<CardActionResult>(\"PATCH\", `/v1/competitors/actions/${encodeURIComponent(markId)}`, { body: { postUrl } })\n  }\n\n  /** `PATCH /v1/competitors/actions/:id` with `seen: true` → you have seen its verdict (the app stops announcing it). */\n  markSeen(markId: string): Promise<CardActionResult> {\n    return this.client.request<CardActionResult>(\"PATCH\", `/v1/competitors/actions/${encodeURIComponent(markId)}`, { body: { seen: true } })\n  }\n\n  /** `DELETE /v1/competitors/actions/:id` → undo \"I did this\" (its verdict leaves your track record). */\n  async unmark(markId: string): Promise<void> {\n    await this.client.request<{ success: true }>(\"DELETE\", `/v1/competitors/actions/${encodeURIComponent(markId)}`)\n  }\n\n  /** `POST /v1/competitor-discover` → a brand's accounts found from its website (free; guesses are marked). */\n  discover(website: string): Promise<CompetitorDiscovery> {\n    return this.client.request<CompetitorDiscovery>(\"POST\", \"/v1/competitor-discover\", { body: { website } })\n  }\n\n  /**\n   * `POST /v1/competitor-scan` → scan a brand now. Answers with a job id;\n   * poll `client.jobs.getStatus(jobId)`, then read `get(id)` or `cards()`.\n   */\n  scan(id: string): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/competitor-scan\", { body: { competitorId: id } })\n  }\n}\n"]}

package/dist/chunk-YN6CBIIB.js

@@ -0,0 +1,63 @@
+// src/resources/webhooks.ts
+var WebhooksResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** `POST /v1/webhook-endpoints` → the endpoint and its signing secret (shown this once). */
+  create(input) {
+    return this.client.request("POST", "/v1/webhook-endpoints", { body: input });
+  }
+  /** `GET /v1/webhook-endpoints` → your endpoints, newest first. Never a secret. */
+  list() {
+    return this.client.request("GET", "/v1/webhook-endpoints");
+  }
+  /** `GET /v1/webhook-endpoints/:id`. */
+  get(id) {
+    return this.client.request("GET", `/v1/webhook-endpoints/${encodeURIComponent(id)}`);
+  }
+  /** `PATCH /v1/webhook-endpoints/:id` → change the address, events, description; switch on or off. */
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/webhook-endpoints/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** `DELETE /v1/webhook-endpoints/:id` → the endpoint and its delivery log. */
+  delete(id) {
+    return this.client.request("DELETE", `/v1/webhook-endpoints/${encodeURIComponent(id)}`);
+  }
+  /**
+   * `POST /v1/webhook-endpoints/:id/rotate-secret` → a new signing secret,
+   * shown this once. It signs every delivery from now on (retries included);
+   * the one it replaces keeps signing beside it for `gracePeriodSeconds` (a
+   * day by default), so update your receiver within that time.
+   */
+  rotateSecret(id, input = {}) {
+    return this.client.request("POST", `/v1/webhook-endpoints/${encodeURIComponent(id)}/rotate-secret`, {
+      body: input
+    });
+  }
+  /** `GET /v1/webhook-endpoints/:id/deliveries` → the delivery log, newest first (kept 30 days). */
+  deliveries(id, params = {}) {
+    return this.client.request("GET", `/v1/webhook-endpoints/${encodeURIComponent(id)}/deliveries`, {
+      query: { status: params.status, limit: params.limit, cursor: params.cursor }
+    });
+  }
+  /** `GET /v1/webhook-endpoints/:id/deliveries/:deliveryId` → one delivery (`test()` returns its id). */
+  getDelivery(id, deliveryId) {
+    return this.client.request(
+      "GET",
+      `/v1/webhook-endpoints/${encodeURIComponent(id)}/deliveries/${encodeURIComponent(deliveryId)}`
+    );
+  }
+  /**
+   * `POST /v1/webhook-endpoints/:id/test` → queue a `ping` (sent within
+   * seconds, tried once — even to an endpoint that is switched off). Follow
+   * it with `deliveries()`.
+   */
+  test(id) {
+    return this.client.request("POST", `/v1/webhook-endpoints/${encodeURIComponent(id)}/test`);
+  }
+};
+
+export { WebhooksResource };
+//# sourceMappingURL=chunk-YN6CBIIB.js.map
+//# sourceMappingURL=chunk-YN6CBIIB.js.map

package/dist/chunk-YN6CBIIB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/webhooks.ts"],"names":[],"mappings":";AAsKO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,OAAO,KAAA,EAAoE;AACzE,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAgC,MAAA,EAAQ,yBAAyB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACrG;AAAA;AAAA,EAGA,IAAA,GAA6C;AAC3C,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,uBAAuB,CAAA;AAAA,EAC3D;AAAA;AAAA,EAGA,IAAI,EAAA,EAAgD;AAClD,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,KAAA,EAAO,yBAAyB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACrF;AAAA;AAAA,EAGA,MAAA,CAAO,IAAY,KAAA,EAAuE;AACxF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,OAAA,EAAS,CAAA,sBAAA,EAAyB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA,EAAI,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,EACxG;AAAA;AAAA,EAGA,OAAO,EAAA,EAAwC;AAC7C,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,QAAA,EAAU,yBAAyB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACxF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YAAA,CAAa,EAAA,EAAY,KAAA,GAAkC,EAAC,EAAkC;AAC5F,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA8B,MAAA,EAAQ,yBAAyB,kBAAA,CAAmB,EAAE,CAAC,CAAA,cAAA,CAAA,EAAkB;AAAA,MACxH,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,UAAA,CAAW,EAAA,EAAY,MAAA,GAAsC,EAAC,EAAiC;AAC7F,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,KAAA,EAAO,yBAAyB,kBAAA,CAAmB,EAAE,CAAC,CAAA,WAAA,CAAA,EAAe;AAAA,MAC9F,KAAA,EAAO,EAAE,MAAA,EAAQ,MAAA,CAAO,MAAA,EAAQ,OAAO,MAAA,CAAO,KAAA,EAAO,MAAA,EAAQ,MAAA,CAAO,MAAA;AAAO,KAC5E,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,WAAA,CAAY,IAAY,UAAA,EAAwD;AAC9E,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,KAAA;AAAA,MACA,yBAAyB,kBAAA,CAAmB,EAAE,CAAC,CAAA,YAAA,EAAe,kBAAA,CAAmB,UAAU,CAAC,CAAA;AAAA,KAC9F;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KAAK,EAAA,EAAgD;AACnD,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,MAAA,EAAQ,yBAAyB,kBAAA,CAAmB,EAAE,CAAC,CAAA,KAAA,CAAO,CAAA;AAAA,EAC3F;AACF","file":"chunk-YN6CBIIB.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type { Job } from \"./jobs.js\"\n\n/** Events an endpoint can subscribe to. */\nexport type WebhookJobEvent = \"job.completed\" | \"job.failed\"\n\n/** Every event a delivery can carry: the job events, and the test ping. */\nexport type WebhookEventType = WebhookJobEvent | \"ping\"\n\n/** A delivery's lifecycle: waiting (or being sent), sent, or given up on. */\nexport type WebhookDeliveryStatus = \"pending\" | \"delivered\" | \"failed\"\n\n/** An https address Nodaro POSTs your job events to. */\nexport interface WebhookEndpoint {\n  id: string\n  url: string\n  description: string | null\n  events: WebhookJobEvent[]\n  isActive: boolean\n  /**\n   * Why the platform switched it off: `\"consecutive_failures\"` (50\n   * deliveries in a row failed for good) or `\"legacy_secret\"` (it predates\n   * signing; rotate its secret). `null` when it is on, or you switched it off.\n   */\n  disabledReason: \"consecutive_failures\" | \"legacy_secret\" | null\n  disabledAt: string | null\n  /** Deliveries in a row that failed for good. Reset by a success. */\n  consecutiveFailures: number\n  /**\n   * The connected app that registered it — it then receives only the jobs\n   * that app submitted itself. `null` = registered by the account.\n   */\n  appId: string | null\n  /** When the current signing secret was issued; `null` = none yet. */\n  secretCreatedAt: string | null\n  /**\n   * After a rotation: until when the secret it replaced still signs too (a\n   * second `v1=` in `Nodaro-Signature`). `null` when only one secret signs.\n   */\n  previousSecretExpiresAt: string | null\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface CreateWebhookEndpointInput {\n  /** An https address on a public host. */\n  url: string\n  /** Default: both. */\n  events?: WebhookJobEvent[]\n  /** Up to 500 characters. */\n  description?: string\n}\n\nexport interface UpdateWebhookEndpointInput {\n  url?: string\n  events?: WebhookJobEvent[]\n  /** `true` also clears an automatic switch-off and its failure count. */\n  isActive?: boolean\n  /** `null` clears it. */\n  description?: string | null\n}\n\n/** `create()`'s answer: the endpoint and its signing secret — shown this once. */\nexport interface CreatedWebhookEndpoint {\n  data: WebhookEndpoint\n  /** `whsec_…`. Store it now: no other call returns it. */\n  secret: string\n}\n\nexport interface RotateWebhookSecretInput {\n  /**\n   * Seconds the replaced secret keeps signing beside the new one (0 – 604800),\n   * so your receiver can switch over without a gap. Default a day; `0` ends\n   * the old secret at once (one that leaked).\n   */\n  gracePeriodSeconds?: number\n}\n\n/** `rotateSecret()`'s answer — the secret is shown this once. */\nexport interface RotatedWebhookSecret {\n  /** `whsec_…`. Store it now: no other call returns it. */\n  secret: string\n  /** Until when the replaced secret still signs; `null` when it stopped at once. */\n  previousSecretExpiresAt: string | null\n}\n\n/** One event sent (or to be sent) to one endpoint, with its attempts. */\nexport interface WebhookDelivery {\n  /** Also the event's `id` and the `Nodaro-Delivery` header: the same on every retry. */\n  id: string\n  webhookId: string\n  event: WebhookEventType\n  jobId: string | null\n  status: WebhookDeliveryStatus\n  attempts: number\n  /** The receiver's last HTTP status; `null` when no answer came. */\n  responseStatus: number | null\n  /** The first 2 KB of the receiver's last answer. */\n  responseBody: string | null\n  durationMs: number | null\n  /**\n   * Why the last attempt failed (`http_<status>`, `timeout`, `blocked_address`,\n   * `connection_refused`, …) or why the delivery ended without one\n   * (`endpoint_disabled`, `app_revoked`, `job_deleted`, `attempts_exhausted`).\n   * `signing_unavailable` / `job_unreadable`: a problem on Nodaro's side — the\n   * delivery waits and is tried again, its attempts unspent.\n   */\n  error: string | null\n  /** The exact body sent (retries send the same text); `null` before the first recorded attempt and once delivered. */\n  requestBody: string | null\n  createdAt: string\n  lastAttemptAt: string | null\n  /** When a pending delivery is due (while it is being sent: when that attempt times out). */\n  nextAttemptAt: string | null\n  deliveredAt: string | null\n}\n\nexport interface ListWebhookDeliveriesParams {\n  status?: WebhookDeliveryStatus\n  /** Page size, 1–100 (server default 20). */\n  limit?: number\n  /** The previous page's `next`. */\n  cursor?: string\n}\n\nexport interface WebhookDeliveryPage {\n  data: WebhookDelivery[]\n  /** Pass back as `cursor` for the next page; `null` on the last one. */\n  next: string | null\n}\n\n/** A job event as your endpoint receives it (verify it with `verifyWebhookSignature`). */\nexport interface JobWebhookEvent {\n  /**\n   * The delivery id: the same on every retry — de-duplicate on it (this one,\n   * from the verified body; the `Nodaro-Delivery` header is not signed).\n   */\n  id: string\n  type: WebhookJobEvent\n  /** When the job reached this status. */\n  createdAt: string\n  data: {\n    /** The job, in the same shape `jobs.get()` returns. */\n    job: Job\n    /** Present when the event would pass 64 KB: these fields were left out — read the whole job with `jobs.get()`. */\n    omitted?: Array<\"input_data\" | \"output_data\">\n  }\n}\n\n/** The event `test()` sends. */\nexport interface PingWebhookEvent {\n  id: string\n  type: \"ping\"\n  createdAt: string\n  data: { webhookId: string }\n}\n\nexport type WebhookEvent = JobWebhookEvent | PingWebhookEvent\n\n/**\n * Outbound webhooks: register an https endpoint and Nodaro POSTs it every\n * `job.completed` / `job.failed` of your account, signed with the endpoint's\n * own secret (check it with `verifyWebhookSignature`), retried with backoff,\n * every attempt kept in its delivery log. OAuth app tokens need `jobs:read`;\n * an endpoint an app registers receives only the jobs that app submitted.\n */\nexport class WebhooksResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** `POST /v1/webhook-endpoints` → the endpoint and its signing secret (shown this once). */\n  create(input: CreateWebhookEndpointInput): Promise<CreatedWebhookEndpoint> {\n    return this.client.request<CreatedWebhookEndpoint>(\"POST\", \"/v1/webhook-endpoints\", { body: input })\n  }\n\n  /** `GET /v1/webhook-endpoints` → your endpoints, newest first. Never a secret. */\n  list(): Promise<{ data: WebhookEndpoint[] }> {\n    return this.client.request(\"GET\", \"/v1/webhook-endpoints\")\n  }\n\n  /** `GET /v1/webhook-endpoints/:id`. */\n  get(id: string): Promise<{ data: WebhookEndpoint }> {\n    return this.client.request(\"GET\", `/v1/webhook-endpoints/${encodeURIComponent(id)}`)\n  }\n\n  /** `PATCH /v1/webhook-endpoints/:id` → change the address, events, description; switch on or off. */\n  update(id: string, input: UpdateWebhookEndpointInput): Promise<{ data: WebhookEndpoint }> {\n    return this.client.request(\"PATCH\", `/v1/webhook-endpoints/${encodeURIComponent(id)}`, { body: input })\n  }\n\n  /** `DELETE /v1/webhook-endpoints/:id` → the endpoint and its delivery log. */\n  delete(id: string): Promise<{ success: true }> {\n    return this.client.request(\"DELETE\", `/v1/webhook-endpoints/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * `POST /v1/webhook-endpoints/:id/rotate-secret` → a new signing secret,\n   * shown this once. It signs every delivery from now on (retries included);\n   * the one it replaces keeps signing beside it for `gracePeriodSeconds` (a\n   * day by default), so update your receiver within that time.\n   */\n  rotateSecret(id: string, input: RotateWebhookSecretInput = {}): Promise<RotatedWebhookSecret> {\n    return this.client.request<RotatedWebhookSecret>(\"POST\", `/v1/webhook-endpoints/${encodeURIComponent(id)}/rotate-secret`, {\n      body: input,\n    })\n  }\n\n  /** `GET /v1/webhook-endpoints/:id/deliveries` → the delivery log, newest first (kept 30 days). */\n  deliveries(id: string, params: ListWebhookDeliveriesParams = {}): Promise<WebhookDeliveryPage> {\n    return this.client.request(\"GET\", `/v1/webhook-endpoints/${encodeURIComponent(id)}/deliveries`, {\n      query: { status: params.status, limit: params.limit, cursor: params.cursor },\n    })\n  }\n\n  /** `GET /v1/webhook-endpoints/:id/deliveries/:deliveryId` → one delivery (`test()` returns its id). */\n  getDelivery(id: string, deliveryId: string): Promise<{ data: WebhookDelivery }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/webhook-endpoints/${encodeURIComponent(id)}/deliveries/${encodeURIComponent(deliveryId)}`,\n    )\n  }\n\n  /**\n   * `POST /v1/webhook-endpoints/:id/test` → queue a `ping` (sent within\n   * seconds, tried once — even to an endpoint that is switched off). Follow\n   * it with `deliveries()`.\n   */\n  test(id: string): Promise<{ data: WebhookDelivery }> {\n    return this.client.request(\"POST\", `/v1/webhook-endpoints/${encodeURIComponent(id)}/test`)\n  }\n}\n"]}

package/dist/chunk-YOJ2XNQX.cjs

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

package/dist/chunk-YOJ2XNQX.cjs.map

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

package/dist/chunk-YOOZB4RL.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-YOOZB4RL.js.map
+//# sourceMappingURL=chunk-YOOZB4RL.js.map