@nodaro/sdk 2.53.1 → 2.55.0

package/dist/chunk-HUYI5G3D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/creatures.ts"],"names":[],"mappings":"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","file":"chunk-HUYI5G3D.js","sourcesContent":["import type { ObjectAspectRatio, CreatureAttachColumn } from \"@nodaro/shared/entities\"\nimport type { TtsProvider } from \"@nodaro/shared/models\"\nexport type { CreatureAttachColumn, ObjectAspectRatio as CreatureAspectRatio } from \"@nodaro/shared/entities\"\nexport { CREATURE_ATTACH_COLUMNS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS } from \"@nodaro/shared/entities\"\nimport type { NodaroClientCore } from \"../core.js\"\nimport type { GenerationSessionParams, Subject } from \"./nodes.js\"\nimport type { SetKeeperCatalogInput, SetKeeperCatalogResult } from \"./keepers.js\"\n\n/**\n * Creature voice — IDENTICAL shape + semantics to `Character[\"voice\"]` (the\n * \"talking creature\" stack reuses the character voice plumbing verbatim).\n * Render speech via `client.nodes.run(\"text-to-speech\", { text, voice:\n * voiceId, provider: ttsProvider, voiceType })`, then feed the audio + the\n * creature's `sourceImageUrl` to `client.nodes.run(\"lip-sync\", …)` (or\n * speech-to-video) for a talking-creature clip.\n */\nexport interface CreatureVoice {\n  voiceId: string\n  voiceName: string\n  traits: string\n  voiceType?: \"premade\" | \"library\" | \"custom\"\n  /** Playable preview sample (client-played only). */\n  previewUrl?: string\n  /** Recommended TTS provider — send as `provider` on text-to-speech. */\n  ttsProvider?: TtsProvider\n}\n\n/**\n * Re-export the shared `CreatureAttachColumn` union + its runtime tuple so SDK\n * consumers don't have to add `@nodaro/shared` as a second dependency just to\n * typecheck the `attachToColumn` field. Single source of truth lives in\n * `@nodaro/shared/entity-prompts` (`CREATURE_ATTACH_COLUMNS`).\n *\n * `CreatureAspectRatio` is re-exported as an alias of the shared\n * `ObjectAspectRatio` — `generateMotion`'s `aspectRatio` field is the 5-value\n * object enum (1:1 / 3:4 / 16:9 / 9:16 / 4:3). The creature motion route\n * deliberately REUSES `OBJECT_ASPECT_OPTIONS` server-side (a creature reference\n * clip is centered product-showcase framing, not cinematic 16:9), so the SDK\n * surfaces the same enum under a creature-friendly name. The runtime tuple is\n * re-exported as `CREATURE_ASPECT_OPTIONS` / `CREATURE_ASPECT_DEFAULTS` aliases.\n */\n\n/**\n * Creature asset-type enum — the kinds of variant a user can generate off a\n * creature's anchor main image. Mirrors the literal accepted by\n * `POST /v1/generate-creature-asset` (`backend/src/routes/generate-creature-asset.ts`).\n *\n * Delta vs `ObjectAssetType`: object's `materials` becomes `poses` (a creature\n * has poses, not materials), and there is NO `motion` value — creature motion\n * variants flow through the dedicated `/v1/generate-creature-motion` endpoint\n * (worker-side a different BullMQ job type). `custom` is the free-form bucket;\n * callers must supply `attachToColumn` explicitly since the worker can't infer\n * the destination from the asset type.\n *\n * The shared `@nodaro/shared` package does NOT export a `CREATURE_ASSET_TYPES`\n * tuple (the route validates an inline Zod enum), so the SDK defines its own\n * single-source-of-truth tuple here.\n */\nexport const CREATURE_ASSET_TYPES = [\"angles\", \"poses\", \"variations\", \"custom\"] as const\nexport type CreatureAssetType = (typeof CREATURE_ASSET_TYPES)[number]\n\n/**\n * Reference-photo kind discriminator — the mood-board roles a user can attach\n * to a creature. Mirrors the `reference_photos.kind` field accepted by\n * `backend/src/routes/creatures.ts` (the route accepts open strings; this SDK\n * type narrows to the 6 canonical roles surfaced by the Studio). `other` is\n * the free-form bucket.\n */\nexport type CreatureReferencePhotoKind =\n  | \"front\"\n  | \"side\"\n  | \"detail\"\n  | \"context\"\n  | \"moodBoard\"\n  | \"other\"\n\nexport interface CreatureReferencePhoto {\n  url: string\n  kind: CreatureReferencePhotoKind\n}\n\n/**\n * A creature record returned by Nodaro's REST API. Mirrors the camelCase\n * shape produced by `backend/src/routes/creatures.ts::toCamel()`.\n *\n * Asset buckets (`angles`, `poses`, `variations`, `motionClips`) are\n * independent JSONB arrays keyed by a human-readable variant name (e.g.\n * `\"front\"`, `\"walking\"`, `\"scarred\"`). Each entry's `url` points at an\n * R2-hosted asset.\n *\n * Creature delta vs object:\n *   - `species` — free-text creature type (e.g. `\"dragon\"`, `\"wolf\"`). This is\n *     the subject of the establishing-shot prompt and the primary creature\n *     differentiator (object has no equivalent).\n *   - `poses` (where object has `materials`) — the pose-variant asset bucket.\n *   - `category` is free-text (NOT object's fixed 10-value enum) — a creature\n *     can be any animal/type.\n *\n * Identity-foundation fields:\n *   - `referencePhotos` — caller-supplied mood-board refs (cap 20).\n *   - `canonicalDescription` — ~80–120-word LLM-authored visual caption,\n *     populated by `approveMainImage()` / `recaption()`. The wire still sends\n *     `\"\"` on caption sub-failure, but `get()` normalizes `\"\"` → `null` so\n *     consumers see the same `string | null` semantics as characters.\n *   - `styleLock` — whether asset gens should anchor to the canonical style\n *     captured at approval time. Defaults to `true` on new rows.\n */\nexport interface Creature {\n  id: string\n  userId: string\n  nodeId: string\n  projectId: string | null\n  name: string\n  description: string | null\n  /** Free-text creature type/species (e.g. \"dragon\", \"wolf\") — the creature\n   *  delta vs object. `null` when unset. */\n  species: string | null\n  category: string | null\n  style: string | null\n  sourceImageUrl: string | null\n  /** MODEL_CATALOG image-model id the main image was generated with (or `null`).\n   *  Set on create + editable via the update route. */\n  imageProvider: string | null\n  angles: Array<{ name: string; url: string }>\n  poses: Array<{ name: string; url: string }>\n  variations: Array<{ name: string; url: string }>\n  motionClips: Array<{ name: string; url: string }>\n  /** Named Creature Boards — dense reference sheets, one per variant/mood\n   *  (the `generate-image/creature-board` factory preset rendered from the\n   *  creature's images). A first-class bucket: community publish snapshots it\n   *  and clone hands the consumer their own copy to extend. Defaults to `[]`.\n   *  `type` marks an image-collage `\"identity\"` sheet vs a plain `\"looks\"`\n   *  board; `sourceImages` are the R2 URLs it was collaged from. Both optional\n   *  + backward-compatible (legacy boards have neither). */\n  boards?: Array<{ name: string; url: string; type?: \"looks\" | \"identity\"; sourceImages?: string[] }> | null\n  /** The creature's voice (the \"talking creature\" stack) — same shape and\n   *  flow as `Character[\"voice\"]`. `null` when no voice is selected. */\n  voice?: CreatureVoice | null\n  referencePhotos: CreatureReferencePhoto[]\n  /** `null` when no caption is set (or the LLM caption sub-failed) — the wire\n   *  sends `\"\"`, normalized to `null` in `get()` to match character semantics. */\n  canonicalDescription: string | null\n  styleLock: boolean\n  /** The user's chosen DEFAULT asset take per variant (Studio version history).\n   *  OPAQUE map: key `\"<bucket>:<variant>\"` (e.g. `\"angles:front\"`) → the chosen\n   *  asset URL (one already present in that bucket). Stored verbatim — keys are\n   *  NOT normalized; soft-capped server-side at 200 keys / 2048-char values\n   *  (overflow dropped silently). Defaults to `{}`. */\n  selectedAssetByVariant?: Record<string, string> | null\n  /** Nodaro Keepers: whether this row is on the shared shelf (`client.keepers`).\n   *  Admin-set through `setCatalog`; `false` on everyone else's rows and on\n   *  every copy. Optional on the read surface for older servers. */\n  catalog?: boolean\n  /** The shelf order (lowest first); `0` when never set. */\n  catalogSort?: number\n  /** The shelf heading, or `null`. */\n  catalogCategory?: string | null\n  deletedAt: string | null\n  createdAt: string\n  updatedAt: string\n}\n\n/**\n * GET /v1/creatures/:id may append a `pendingJobs` bucket the studio uses to\n * rehydrate spinners after a reload. Optional on the SDK surface — it doesn't\n * appear on `list()` rows.\n */\nexport interface CreatureDetail extends Creature {\n  pendingJobs?: Array<{\n    jobId: string\n    assetType: string\n    name: string\n    status: string\n  }>\n}\n\n/**\n * Body for `client.creatures.create()`. Mirrors the INSERT branch of\n * `upsertCreatureBody` in `backend/src/routes/creatures.ts`. `name` + `nodeId`\n * are required on create.\n */\nexport interface CreateCreatureInput {\n  nodeId: string\n  name: string\n  description?: string\n  /** Free-text creature type/species (the creature delta vs object). */\n  species?: string\n  /** Free-text category (NOT object's fixed enum — a creature can be anything). */\n  category?: string\n  style?: string\n  workflowId?: string\n  projectId?: string\n  sourceImageUrl?: string\n  /** Persistent image-model id (a MODEL_CATALOG image model). Validated\n   *  server-side — unknown / non-image / \"\" is stored as `null`. */\n  imageProvider?: string | null\n  referencePhotos?: CreatureReferencePhoto[]\n  canonicalDescription?: string\n  styleLock?: boolean\n  /** The user's chosen DEFAULT asset take per variant. OPAQUE\n   *  `\"<bucket>:<variant>\"` → chosen-URL map; a write REPLACES the whole map.\n   *  Keys stored verbatim; soft-capped server-side at 200 keys / 2048-char values. */\n  selectedAssetByVariant?: Record<string, string>\n  /** Initial voice selection (see `CreatureVoice`). Omit for a voiceless creature. */\n  voice?: CreatureVoice | null\n}\n\n/**\n * Body for `client.creatures.update()`. Mirrors the UPDATE branch of\n * `upsertCreatureBody` in `backend/src/routes/creatures.ts`.\n *\n * Worker-owned asset buckets (`angles` / `poses` / `variations` /\n * `motionClips`) are deliberately omitted — the route drops them on UPDATE\n * so a Studio auto-save with a stale snapshot cannot clobber the worker's\n * atomic `append_creature_asset()` writes.\n *\n * `expectedUpdatedAt` is the optimistic-concurrency token: when present, the\n * UPDATE only succeeds if the row's `updated_at` still matches; on mismatch\n * the route returns 409 so the studio can re-fetch + merge.\n */\nexport interface UpdateCreatureInput {\n  name?: string\n  description?: string\n  /** Free-text creature type/species (the creature delta vs object). */\n  species?: string\n  category?: string\n  style?: string\n  sourceImageUrl?: string\n  /** Persistent image-model id (a MODEL_CATALOG image model). Validated\n   *  server-side — unknown / non-image / \"\" is stored as `null`. */\n  imageProvider?: string | null\n  referencePhotos?: CreatureReferencePhoto[]\n  canonicalDescription?: string\n  styleLock?: boolean\n  /** The user's chosen DEFAULT asset take per variant. OPAQUE\n   *  `\"<bucket>:<variant>\"` → chosen-URL map; a write REPLACES the whole map\n   *  (omit to leave untouched). Keys stored verbatim; soft-capped server-side\n   *  at 200 keys / 2048-char values. */\n  selectedAssetByVariant?: Record<string, string>\n  /** Named Creature Boards (see `Creature.boards`) — whole-array replace,\n   *  USER-owned (unlike the worker-owned buckets it flows through UPDATE).\n   *  Server caps: 24 boards, 200-char names, 30 sourceImages per board. */\n  boards?: Array<{ name: string; url: string; type?: \"looks\" | \"identity\"; sourceImages?: string[] }>\n  /** Voice selection (see `CreatureVoice`) — whole-object replace; pass\n   *  `null` to clear the voice, omit to leave untouched. */\n  voice?: CreatureVoice | null\n  expectedUpdatedAt?: string\n}\n\nexport interface UpdateCreatureResult {\n  id: string\n  updatedAt: string\n}\n\n/**\n * Combined create + update body (parameter for both branches). Exported for\n * callers that want to drive a single `upsert` flow without picking between\n * `Create*` and `Update*`. Mirrors the `upsertCreatureBody` Zod schema in\n * `backend/src/routes/creatures.ts`. `nodeId` + `name` are required on INSERT;\n * `id` flips the route into UPDATE mode.\n */\nexport interface UpsertCreatureInput extends CreateCreatureInput {\n  id?: string\n  expectedUpdatedAt?: string\n}\n\nexport type UpsertCreatureResult = { id: string } | UpdateCreatureResult\n\nexport interface ListCreaturesParams {\n  /** When true, return archived creatures instead of active ones. */\n  archived?: boolean\n  /** Optional project filter — server-scoped to the caller's user. */\n  projectId?: string\n  /**\n   * Search words: only the creatures whose name or description contains\n   * every word (split on spaces, the first 5), in any order, ignoring case.\n   * Each word is matched as written (`%`, `_` and `*` are not wildcards;\n   * punctuation is kept); blank means no search; up to 200 characters.\n   * Combines with the other filters and with `cursor` paging.\n   */\n  q?: string\n  /**\n   * Max rows to return (cap 500). OPT-IN: omitted, the server returns the\n   * full legacy listing with no `nextCursor`; supplied, the response is one\n   * page plus `nextCursor` — keep passing it back until it is `null`.\n   */\n  limit?: number\n  /** Opaque cursor from a prior page's `nextCursor` (fetches the next page). */\n  cursor?: string\n}\n\n/**\n * Input for `client.creatures.generate()` — fires the\n * `POST /v1/generate-creature` route. Produces 1–10 candidate\n * main images; each lands as one `jobs` row in `pending` state and is then\n * enqueued for the worker.\n *\n * When `attachToCreatureId` is set AND `count === 1`, the worker writes the\n * resulting URL directly to `creatures.source_image_url` on completion —\n * caller doesn't need a separate `approveMainImage` call. Multi-candidate\n * batches MUST go through explicit approval so the user picks the winner.\n *\n * `seedPromptHint` flows the parameter-picker's prompt fragment through to the\n * worker so a catalog selection (e.g. \"armored frost dragon\") gets appended to\n * the generated prompt context.\n */\nexport interface GenerateCreatureInput extends GenerationSessionParams {\n  name: string\n  description?: string\n  userPrompt?: string\n  /** Free-text creature type/species (the creature delta vs object). */\n  species?: string\n  category?: string\n  style?: \"realistic\" | \"anime\" | \"3d-pixar\" | \"illustration\"\n  sourceImageUrl?: string\n  provider?: string\n  /** Number of candidate images to generate (1–10; server-validated). */\n  count?: number\n  /** Auto-attach the result to this creature row (single-candidate only). */\n  attachToCreatureId?: string\n  /** Parameter-picker prompt-fragment pass-through. */\n  seedPromptHint?: string\n  /**\n   * What the creature is, as picker-catalog ids ({@link Subject} — `animal`\n   * above all; the same type and bounds as `generateImage`'s). The platform\n   * writes the wording and folds it into the prompt after `description`, so\n   * send ids rather than phrasing a pick yourself.\n   */\n  subject?: Subject\n  /** Optional name to set on the attached row alongside the main image. */\n  attachName?: string\n  /** Optimistic-concurrency token for the single-candidate auto-attach path. */\n  expectedUpdatedAt?: string\n}\n\n/**\n * `generate()` response — `jobIds` is ALWAYS present (the harmonized contract,\n * matching characters). `jobId` is a deprecated back-compat alias populated only\n * on `count === 1`; prefer `jobIds`. (Will be removed on the next major.)\n */\nexport interface GenerateCreatureResult {\n  jobIds: string[]\n  /** @deprecated count===1 back-compat alias — use `jobIds`. */\n  jobId?: string\n}\n\n/**\n * Input for `client.creatures.generateAsset()` — fires the\n * `POST /v1/generate-creature-asset` route. Produces a single\n * angles / poses / variations / custom variant.\n *\n * When all three studio-path fields are set (`attachToCreatureId` +\n * `attachToColumn` + `attachName`), the worker appends\n * `{ name: attachName, url: <result> }` to the named JSONB array column on\n * the user's creature row on completion. `attachToColumn` is REQUIRED for\n * `assetType === \"custom\"` — the worker can't infer the bucket from the\n * asset type.\n */\nexport interface GenerateCreatureAssetInput extends GenerationSessionParams {\n  assetType: CreatureAssetType\n  variant: string\n  name: string\n  description?: string\n  userPrompt?: string\n  category?: string\n  style?: string\n  sourceImageUrl?: string\n  provider?: string\n  attachToCreatureId?: string\n  attachToColumn?: CreatureAttachColumn\n  attachName?: string\n  /** Parameter-picker prompt-fragment pass-through. */\n  seedPromptHint?: string\n}\n\nexport interface GenerateCreatureAssetResult {\n  jobId: string\n}\n\n/**\n * Input for `client.creatures.generateMotion()` — fires the\n * `POST /v1/generate-creature-motion` route. Produces a single motion clip\n * (idle, prowl, attack, etc.) animated FROM a static creature-shot image.\n *\n * Mirrors `client.objects.generateMotion()` — the creature motion route reuses\n * the entity-agnostic object motion helpers server-side. The route hardcodes\n * the attach column to `motion_clips` — callers supply `attachToCreatureId` +\n * `attachName` only.\n *\n * `sourceImageUrl` is REQUIRED — image-to-video needs a source frame and the\n * route has no fallback (the studio path supplies the canonical creature-shot\n * URL explicitly).\n *\n * Defaults vs location:\n *   - `provider` defaults to `\"kling-turbo\"` (not location's `\"kling\"`)\n *   - `aspectRatio` defaults to `\"1:1\"` server-side via\n *     `resolveObjectAspectRatio({ assetType: \"motion\" })` — creatures use\n *     centered reference framing, not cinematic establishing shots.\n *\n * When the studio path is set (`attachToCreatureId` + `attachName`), the\n * worker appends `{ name: attachName, url: <result> }` to the creature row's\n * `motion_clips` JSONB column on completion.\n */\nexport interface GenerateCreatureMotionInput extends GenerationSessionParams {\n  motionPrompt: string\n  sourceImageUrl: string\n  provider?: string\n  name: string\n  /** Source clip URL — when set, worker routes to video-to-video refine. */\n  refineFromVideoUrl?: string\n  category?: string\n  style?: \"realistic\" | \"anime\" | \"3d-pixar\" | \"illustration\"\n  canonicalDescription?: string\n  /** Parameter-picker prompt-fragment pass-through. */\n  seedPromptHint?: string\n  attachToCreatureId?: string\n  attachName?: string\n  /**\n   * Optional aspect ratio override. Defaults to 1:1 server-side. One of the\n   * 5-value `CreatureAspectRatio` union (1:1 / 3:4 / 16:9 / 9:16 / 4:3) — the\n   * creature route reuses the object aspect enum.\n   */\n  aspectRatio?: ObjectAspectRatio\n  /**\n   * Optional clip duration in seconds. Validated server-side against the chosen\n   * provider's allowed durations (e.g. kling 5/10, wan-i2v 5/10/15); omitted →\n   * the model's own default (no behavior change). Mirrors generate-video's\n   * per-model i2v duration lever.\n   */\n  duration?: number\n}\n\nexport interface GenerateCreatureMotionResult {\n  jobId: string\n}\n\nexport interface ApproveCreatureMainImageResult {\n  sourceImageUrl: string\n  /**\n   * LLM-authored caption. `null` when the LLM caption sub-failed — the wire\n   * sends `\"\"`, normalized to `null` here so consumers see the same\n   * `string | null` semantics as characters. The main image is still set; call\n   * `recaption()` to retry.\n   */\n  canonicalDescription: string | null\n}\n\nexport interface RecaptionCreatureResult {\n  canonicalDescription: string\n}\n\nexport class CreaturesResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * List the caller's creatures. By default returns active creatures only;\n   * pass `archived: true` to fetch soft-deleted rows for an \"archive\" view.\n   * Optional `projectId` scopes the result to a single project; `q` keeps the\n   * creatures whose name or description contains it.\n   */\n  list(params: ListCreaturesParams = {}): Promise<{ creatures: Creature[]; nextCursor?: string | null }> {\n    const query: Record<string, string | undefined> = {}\n    if (params.archived) query.archived = \"true\"\n    if (params.projectId) query.projectId = params.projectId\n    if (params.q) query.q = params.q\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/creatures\", { query })\n  }\n\n  /**\n   * Convenience wrapper for `list({ archived: true })`. Returns soft-deleted\n   * rows so callers can drive a UI \"Archived\" tab without re-encoding the\n   * query param.\n   *\n   * `archived` is omitted from the param type — it's always set to `true` here.\n   */\n  listArchived(params: Omit<ListCreaturesParams, \"archived\"> = {}): Promise<{ creatures: Creature[]; nextCursor?: string | null }> {\n    return this.list({ ...params, archived: true })\n  }\n\n  /**\n   * Fetch a single creature including in-flight asset job state. Soft-deleted\n   * (archived) rows are NOT returned by id — the route enforces\n   * `deleted_at IS NULL` so archived creatures 404 (uniform \"not_found\" — does\n   * not leak the deleted vs non-existent distinction).\n   */\n  async get(id: string): Promise<CreatureDetail> {\n    const res = await this.client.request<CreatureDetail>(\n      \"GET\",\n      `/v1/creatures/${encodeURIComponent(id)}`,\n    )\n    // Normalize the wire `\"\"` caption (DB null / LLM sub-failure) → null so\n    // consumers see the same `string | null` semantics as characters. New\n    // object — never mutate the response.\n    return { ...res, canonicalDescription: res.canonicalDescription || null }\n  }\n\n  /**\n   * Create a new creature. `name` + `nodeId` are required — the route 400s\n   * otherwise. Returns the new row's id.\n   *\n   * Note: the underlying route is the same `POST /v1/creatures` upsert that\n   * powers `update()`. This convenience wrapper enforces the INSERT-required\n   * fields at the type level and never sends an `id`.\n   */\n  create(data: CreateCreatureInput): Promise<{ id: string }> {\n    return this.client.request(\"POST\", \"/v1/creatures\", { body: data })\n  }\n\n  /**\n   * Update a creature. Only the fields you pass are written — undefined keys\n   * are NOT touched on the row. Worker-owned asset buckets are intentionally\n   * not exposed on this surface (see `UpdateCreatureInput` for the rationale).\n   *\n   * Optimistic-concurrency: pass `expectedUpdatedAt` to require the row's\n   * `updated_at` still matches; on mismatch the route returns 409\n   * `concurrent_modification` carrying the fresh `updatedAt`. The SDK\n   * surfaces that as a generic `NodaroError` with the same code.\n   */\n  update(id: string, data: UpdateCreatureInput): Promise<UpdateCreatureResult> {\n    return this.client.request(\"POST\", \"/v1/creatures\", {\n      body: { id, ...data },\n    })\n  }\n\n  /**\n   * Soft-delete (archive) a creature. The row is hidden from `list()` by\n   * default but recoverable via `restore(id)` or visible under\n   * `listArchived()`. Idempotent — repeating a delete on an already-archived\n   * row is a no-op.\n   */\n  delete(id: string): Promise<{ success: true; archived: true }> {\n    return this.client.request(\"DELETE\", `/v1/creatures/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Hard-delete (permanent) a creature — the row + every R2 asset it\n   * references. Archived rows ONLY: active creatures return 400 `not_archived`.\n   * Call `delete()` first to archive, then `permanentDelete()` to destroy.\n   *\n   * Mirrors the `app_runs` permanent-delete pattern (archive-first) so a\n   * stray SDK / curl caller cannot bypass the studio's archive-first UI\n   * flow.\n   */\n  permanentDelete(id: string): Promise<{ success: true; permanent: true }> {\n    return this.client.request(\"DELETE\", `/v1/creatures/${encodeURIComponent(id)}`, {\n      query: { permanent: \"true\" },\n    })\n  }\n\n  /**\n   * Un-archive a creature. If the original name now collides (case-\n   * insensitive) with an active row, the server auto-suffixes \"(restored)\"\n   * and returns the effective name.\n   */\n  restore(id: string): Promise<{ id: string; name: string }> {\n    return this.client.request(\"POST\", `/v1/creatures/${encodeURIComponent(id)}/restore`)\n  }\n\n  /**\n   * Admin only: put one of your own creatures on the shared Nodaro Keepers\n   * shelf (`client.keepers.catalog()`), or take it off. A first-party session\n   * or your personal token; `forbidden` for anyone who is not a platform\n   * admin, `not_found` for a row that is not yours.\n   */\n  setCatalog(id: string, input: SetKeeperCatalogInput): Promise<SetKeeperCatalogResult> {\n    return this.client.request(\"PUT\", `/v1/creatures/${encodeURIComponent(id)}/catalog`, { body: input })\n  }\n\n  /**\n   * Fire `POST /v1/generate-creature` to produce one or more candidate main\n   * images. With `count > 1`, all jobs are reserved up-front before any\n   * is enqueued — mid-batch failures roll back atomically.\n   *\n   * When `attachToCreatureId` is set AND `count === 1`, the worker writes\n   * the result directly to the row's `source_image_url`; otherwise you must\n   * call `approveMainImage()` after picking a candidate.\n   */\n  async generate(data: GenerateCreatureInput): Promise<GenerateCreatureResult> {\n    const res = await this.client.request<{ jobId?: string; jobIds?: string[] }>(\n      \"POST\", \"/v1/generate-creature\", { body: data },\n    )\n    // Tolerate the legacy `{ jobId }`-only shape (older server): synthesize jobIds.\n    const jobIds = res.jobIds ?? (res.jobId ? [res.jobId] : [])\n    return res.jobId ? { jobIds, jobId: res.jobId } : { jobIds }\n  }\n\n  /**\n   * Fire `POST /v1/generate-creature-asset` to produce a single variant.\n   * When the studio path is set (`attachToCreatureId` + `attachToColumn` +\n   * `attachName`), the worker appends `{ name: attachName, url: <result> }`\n   * to the named JSONB array column on completion.\n   *\n   * Note: `attachToColumn` is REQUIRED for `assetType === \"custom\"` — the\n   * worker can't infer the bucket from the asset type. For canonical asset\n   * types (`angles` / `poses` / `variations`), the column is derived\n   * automatically by the route.\n   */\n  generateAsset(\n    data: GenerateCreatureAssetInput,\n  ): Promise<GenerateCreatureAssetResult> {\n    return this.client.request(\"POST\", \"/v1/generate-creature-asset\", { body: data })\n  }\n\n  /**\n   * Fire `POST /v1/generate-creature-motion` to animate the creature's main\n   * image into a motion clip. Image-to-video, single clip per call; the\n   * attach column is hardcoded to `motion_clips` server-side (creatures have a\n   * single motion bucket so the caller doesn't supply `attachToColumn`).\n   * When the studio path is set (`attachToCreatureId` + `attachName`), the\n   * worker appends `{ name: attachName, url: <result> }` to the row's\n   * `motion_clips` column on completion.\n   *\n   * Defaults: `provider` → `\"kling-turbo\"`, `aspectRatio` → `\"1:1\"` (set\n   * server-side via `resolveObjectAspectRatio({ assetType: \"motion\" })`).\n   */\n  generateMotion(\n    data: GenerateCreatureMotionInput,\n  ): Promise<GenerateCreatureMotionResult> {\n    return this.client.request(\"POST\", \"/v1/generate-creature-motion\", { body: data })\n  }\n\n  /**\n   * Approve a completed `generate-creature` job as the creature's main image.\n   * Sets `source_image_url` and fires the LLM caption (Claude Sonnet vision)\n   * inline. Returns the new main-image URL plus the caption.\n   *\n   * Caption-failure semantics: the route still sends `\"\"` on LLM sub-failure,\n   * but the SDK normalizes `\"\"` → `null` here so `canonicalDescription` carries\n   * the same `string | null` semantics as characters. The main image is still\n   * set; call `recaption()` to retry.\n   *\n   * Optimistic-concurrency: pass `expectedUpdatedAt` to gate the update on\n   * the row's current `updated_at`; on mismatch the route returns 409\n   * `concurrent_modification` carrying the fresh token.\n   */\n  async approveMainImage(\n    id: string,\n    candidateJobId: string,\n    expectedUpdatedAt?: string,\n  ): Promise<ApproveCreatureMainImageResult> {\n    const res = await this.client.request<{ sourceImageUrl: string; canonicalDescription: string | null }>(\n      \"POST\",\n      `/v1/creatures/${encodeURIComponent(id)}/approve-main-image`,\n      { body: { candidateJobId, expectedUpdatedAt } },\n    )\n    // Normalize the wire `\"\"` (LLM sub-failure) → null; build a new object\n    // rather than mutating the response.\n    return { sourceImageUrl: res.sourceImageUrl, canonicalDescription: res.canonicalDescription || null }\n  }\n\n  /**\n   * Re-fire the LLM caption against the creature's current main image. 502s\n   * on LLM failure (unlike `approveMainImage` which preserves the side-effect\n   * and returns \"\"); returns 400 `main_image_required` if no main image is\n   * set yet.\n   *\n   * The route is a pure idempotent retry — it does NOT accept an\n   * `expectedUpdatedAt` token (backend route is idempotent retry, not gated on\n   * optimistic-concurrency).\n   */\n  recaption(id: string): Promise<RecaptionCreatureResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/creatures/${encodeURIComponent(id)}/llm-caption`,\n    )\n  }\n}\n"]}

package/dist/{chunk-GAD3QCMM.cjs → chunk-I6Q4UDS2.cjs}

@@ -1,5 +1,6 @@
 'use strict';
 
+var chunkKMNSPC72_cjs = require('./chunk-KMNSPC72.cjs');
 var chunkJTOEHQQJ_cjs = require('./chunk-JTOEHQQJ.cjs');
 var chunkUIDVH3GP_cjs = require('./chunk-UIDVH3GP.cjs');
 var chunkW5VHATSR_cjs = require('./chunk-W5VHATSR.cjs');
@@ -7,14 +8,15 @@ var chunkR63TTR35_cjs = require('./chunk-R63TTR35.cjs');
 var chunk3B47IHB3_cjs = require('./chunk-3B47IHB3.cjs');
 var chunkWUM6CWTE_cjs = require('./chunk-WUM6CWTE.cjs');
 var chunkLKH5M44B_cjs = require('./chunk-LKH5M44B.cjs');
+var chunkSYVNY3AH_cjs = require('./chunk-SYVNY3AH.cjs');
 var chunkYDRXBRW2_cjs = require('./chunk-YDRXBRW2.cjs');
 var chunkWMT7HEBZ_cjs = require('./chunk-WMT7HEBZ.cjs');
 var chunkMBFUMWI5_cjs = require('./chunk-MBFUMWI5.cjs');
 var chunkNKH2UFSD_cjs = require('./chunk-NKH2UFSD.cjs');
 var chunkUIBYZNDR_cjs = require('./chunk-UIBYZNDR.cjs');
 var chunkLTZKNAXM_cjs = require('./chunk-LTZKNAXM.cjs');
-var chunkNWMO4MHE_cjs = require('./chunk-NWMO4MHE.cjs');
-var chunkKMNSPC72_cjs = require('./chunk-KMNSPC72.cjs');
+var chunkPDX742CC_cjs = require('./chunk-PDX742CC.cjs');
+var chunkJ5LGGCAS_cjs = require('./chunk-J5LGGCAS.cjs');
 var chunkNBVARNVA_cjs = require('./chunk-NBVARNVA.cjs');
 var chunk7YHIFCJ4_cjs = require('./chunk-7YHIFCJ4.cjs');
 var chunkCOCKKMNP_cjs = require('./chunk-COCKKMNP.cjs');
@@ -22,28 +24,27 @@ var chunkLAWYFC4G_cjs = require('./chunk-LAWYFC4G.cjs');
 var chunkTCLNSVYA_cjs = require('./chunk-TCLNSVYA.cjs');
 var chunkKXEWTYS4_cjs = require('./chunk-KXEWTYS4.cjs');
 var chunkGB6C5OEZ_cjs = require('./chunk-GB6C5OEZ.cjs');
-var chunkSYVNY3AH_cjs = require('./chunk-SYVNY3AH.cjs');
-var chunk22P4X3N5_cjs = require('./chunk-22P4X3N5.cjs');
+var chunkMIXRL6I2_cjs = require('./chunk-MIXRL6I2.cjs');
+var chunkXALPYUZI_cjs = require('./chunk-XALPYUZI.cjs');
 var chunk7QOCWJKD_cjs = require('./chunk-7QOCWJKD.cjs');
 var chunkZCWKX4V6_cjs = require('./chunk-ZCWKX4V6.cjs');
 var chunkQ45PC4YD_cjs = require('./chunk-Q45PC4YD.cjs');
-var chunkTK2CEVSK_cjs = require('./chunk-TK2CEVSK.cjs');
+var chunkVHTDOACT_cjs = require('./chunk-VHTDOACT.cjs');
 var chunkGVIFLUYZ_cjs = require('./chunk-GVIFLUYZ.cjs');
-var chunkCR5E2SF3_cjs = require('./chunk-CR5E2SF3.cjs');
-var chunkJ5LGGCAS_cjs = require('./chunk-J5LGGCAS.cjs');
+var chunk57GANTLV_cjs = require('./chunk-57GANTLV.cjs');
 var chunkSF2CMKWA_cjs = require('./chunk-SF2CMKWA.cjs');
 var chunkSBV5MWEL_cjs = require('./chunk-SBV5MWEL.cjs');
 var chunkWUKIJJG2_cjs = require('./chunk-WUKIJJG2.cjs');
-var chunkP6AM42UB_cjs = require('./chunk-P6AM42UB.cjs');
+var chunk2KX5ZE6M_cjs = require('./chunk-2KX5ZE6M.cjs');
+var chunkRR45WBME_cjs = require('./chunk-RR45WBME.cjs');
 var chunk2DZWWIJ4_cjs = require('./chunk-2DZWWIJ4.cjs');
 var chunkSS3B6PHT_cjs = require('./chunk-SS3B6PHT.cjs');
-var chunkMQ74AKA2_cjs = require('./chunk-MQ74AKA2.cjs');
 var chunkWK4VXPPZ_cjs = require('./chunk-WK4VXPPZ.cjs');
 var chunk43FVH6LJ_cjs = require('./chunk-43FVH6LJ.cjs');
 var chunkYFS2LMG4_cjs = require('./chunk-YFS2LMG4.cjs');
 var chunkOSMKIRKI_cjs = require('./chunk-OSMKIRKI.cjs');
-var chunk76V6IQZ5_cjs = require('./chunk-76V6IQZ5.cjs');
-var chunkHGCVWOGK_cjs = require('./chunk-HGCVWOGK.cjs');
+var chunkHRV3VX22_cjs = require('./chunk-HRV3VX22.cjs');
+var chunkA3XA6UNM_cjs = require('./chunk-A3XA6UNM.cjs');
 var chunk4BAHF762_cjs = require('./chunk-4BAHF762.cjs');
 var chunkA3S55XGF_cjs = require('./chunk-A3S55XGF.cjs');
 var chunkJOXZ4ZIF_cjs = require('./chunk-JOXZ4ZIF.cjs');
@@ -51,10 +52,10 @@ var chunkGA4LZZKQ_cjs = require('./chunk-GA4LZZKQ.cjs');
 var chunkTVPYDC5T_cjs = require('./chunk-TVPYDC5T.cjs');
 var chunk65VIIZEF_cjs = require('./chunk-65VIIZEF.cjs');
 var chunkBPWUWUZ3_cjs = require('./chunk-BPWUWUZ3.cjs');
-var chunkHAKYPZLB_cjs = require('./chunk-HAKYPZLB.cjs');
+var chunkXZQ6Z4T6_cjs = require('./chunk-XZQ6Z4T6.cjs');
 
 // src/client.ts
-var NodaroClient = class _NodaroClient extends chunk76V6IQZ5_cjs.NodaroClientCore {
+var NodaroClient = class _NodaroClient extends chunkHRV3VX22_cjs.NodaroClientCore {
   workflows;
   projects;
   /** Generation sessions inside projects (Create Image / Video / Music). */
@@ -75,6 +76,8 @@ var NodaroClient = class _NodaroClient extends chunk76V6IQZ5_cjs.NodaroClientCor
   locations;
   objects;
   creatures;
+  /** The shared Nodaro Keepers catalog of characters, creatures, locations and objects. */
+  keepers;
   pipelines;
   reduce;
   promptHelper;
@@ -122,25 +125,26 @@ var NodaroClient = class _NodaroClient extends chunk76V6IQZ5_cjs.NodaroClientCor
     this.projects = new chunkLAWYFC4G_cjs.ProjectsResource(this);
     this.sessions = new chunkWMT7HEBZ_cjs.SessionsResource(this);
     this.trash = new chunkLTZKNAXM_cjs.TrashResource(this);
-    this.jobs = new chunkP6AM42UB_cjs.JobsResource(this);
+    this.jobs = new chunk2KX5ZE6M_cjs.JobsResource(this);
     this.videoPro = new chunkW5VHATSR_cjs.VideoProResource(this);
     this.executions = new chunkSBV5MWEL_cjs.ExecutionsResource(this);
-    this.nodes = new chunkTK2CEVSK_cjs.NodesResource(this);
+    this.nodes = new chunkVHTDOACT_cjs.NodesResource(this);
     this.scene3d = new chunkYDRXBRW2_cjs.Scene3DResource(this);
     this.developerApps = new chunkA3S55XGF_cjs.DeveloperAppsResource(this);
     this.oauth = new chunkGVIFLUYZ_cjs.OAuthResource(this);
     this.webhooks = new chunk3B47IHB3_cjs.WebhooksResource(this);
     this.apps = new chunkJOXZ4ZIF_cjs.AppsResource(this);
-    this.characters = new chunkHAKYPZLB_cjs.CharactersResource(this);
-    this.locations = new chunkMQ74AKA2_cjs.LocationsResource(this);
-    this.objects = new chunkCR5E2SF3_cjs.ObjectsResource(this);
-    this.creatures = new chunkHGCVWOGK_cjs.CreaturesResource(this);
+    this.characters = new chunkXZQ6Z4T6_cjs.CharactersResource(this);
+    this.locations = new chunkMIXRL6I2_cjs.LocationsResource(this);
+    this.objects = new chunk57GANTLV_cjs.ObjectsResource(this);
+    this.creatures = new chunkA3XA6UNM_cjs.CreaturesResource(this);
+    this.keepers = new chunkRR45WBME_cjs.KeepersResource(this);
     this.pipelines = new chunkCOCKKMNP_cjs.PipelinesResource(this);
     this.reduce = new chunkGB6C5OEZ_cjs.ReduceResource(this);
     this.promptHelper = new chunkTCLNSVYA_cjs.PromptHelperResource(this);
     this.voices = new chunkR63TTR35_cjs.VoicesResource(this);
     this.llm = new chunkSS3B6PHT_cjs.LlmResource(this);
-    this.media = new chunk22P4X3N5_cjs.MediaResource(this);
+    this.media = new chunkXALPYUZI_cjs.MediaResource(this);
     this.audio = new chunkGA4LZZKQ_cjs.AudioResource(this);
     this.credits = new chunk4BAHF762_cjs.CreditsResource(this);
     this.userSettings = new chunkUIDVH3GP_cjs.UserSettingsResource(this);
@@ -160,7 +164,7 @@ var NodaroClient = class _NodaroClient extends chunk76V6IQZ5_cjs.NodaroClientCor
     this.shots = new chunkMBFUMWI5_cjs.ShotsResource(this);
     this.recast = new chunkKXEWTYS4_cjs.RecastResource(this);
     this.castSwap = new chunk65VIIZEF_cjs.CastSwapResource(this);
-    this.trends = new chunkNWMO4MHE_cjs.TrendsResource(this);
+    this.trends = new chunkPDX742CC_cjs.TrendsResource(this);
     this.studio = new chunkNKH2UFSD_cjs.StudioResource(this);
     this.copilot = new chunkOSMKIRKI_cjs.CopilotResource(this);
     this.community = new chunk43FVH6LJ_cjs.CommunityResource(this);
@@ -199,5 +203,5 @@ function createClient(opts) {
 
 exports.NodaroClient = NodaroClient;
 exports.createClient = createClient;
-//# sourceMappingURL=chunk-GAD3QCMM.cjs.map
-//# sourceMappingURL=chunk-GAD3QCMM.cjs.map
+//# sourceMappingURL=chunk-I6Q4UDS2.cjs.map
+//# sourceMappingURL=chunk-I6Q4UDS2.cjs.map

package/dist/chunk-I6Q4UDS2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":["NodaroClientCore","WorkflowsResource","ProjectsResource","SessionsResource","TrashResource","JobsResource","VideoProResource","ExecutionsResource","NodesResource","Scene3DResource","DeveloperAppsResource","OAuthResource","WebhooksResource","AppsResource","CharactersResource","LocationsResource","ObjectsResource","CreaturesResource","KeepersResource","PipelinesResource","ReduceResource","PromptHelperResource","VoicesResource","LlmResource","MediaResource","AudioResource","CreditsResource","UserSettingsResource","BillingResource","UploadsResource","LibraryResource","GalleryResource","PresetsResource","SavedPostsResource","CollectionsResource","PalettesResource","MoodboardsResource","CompetitorsResource","PickerCatalogsResource","CatalogsResource","ModelsResource","ShotsResource","RecastResource","CastSwapResource","TrendsResource","StudioResource","CopilotResource","CommunityResource","TemplatesResource","TutorialsResource","OrganizationsResource","WorkspacesResource","EditResource"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DO,IAAM,YAAA,GAAN,MAAM,aAAA,SAAqBA,kCAAA,CAAiB;AAAA,EACxC,SAAA;AAAA,EACA,QAAA;AAAA;AAAA,EAEA,QAAA;AAAA;AAAA,EAEA,KAAA;AAAA,EACA,IAAA;AAAA,EACA,QAAA;AAAA,EACA,UAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA;AAAA,EACA,aAAA;AAAA,EACA,KAAA;AAAA;AAAA,EAEA,QAAA;AAAA,EACA,IAAA;AAAA,EACA,UAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACA,SAAA;AAAA;AAAA,EAEA,OAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,YAAA;AAAA,EACA,MAAA;AAAA,EACA,GAAA;AAAA,EACA,KAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA;AAAA;AAAA,EAEA,YAAA;AAAA;AAAA,EAEA,OAAA;AAAA,EACA,OAAA;AAAA,EACA,OAAA;AAAA;AAAA,EAEA,OAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EACA,WAAA;AAAA;AAAA,EAEA,QAAA;AAAA;AAAA,EAEA,UAAA;AAAA,EACA,WAAA;AAAA,EACA,cAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA;AAAA,EAEA,QAAA;AAAA;AAAA,EAEA,MAAA;AAAA,EACA,MAAA;AAAA,EACA,OAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,aAAA;AAAA,EACA,UAAA;AAAA,EACA,IAAA;AAAA,EAET,YAAY,IAAA,EAAqB;AAC/B,IAAA,KAAA,CAAM,IAAI,CAAA;AAEV,IAAA,IAAA,CAAK,SAAA,GAAY,IAAIC,mCAAA,CAAkB,IAAI,CAAA;AAC3C,IAAA,IAAA,CAAK,QAAA,GAAW,IAAIC,kCAAA,CAAiB,IAAI,CAAA;AACzC,IAAA,IAAA,CAAK,QAAA,GAAW,IAAIC,kCAAA,CAAiB,IAAI,CAAA;AACzC,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAIC,+BAAA,CAAc,IAAI,CAAA;AACnC,IAAA,IAAA,CAAK,IAAA,GAAO,IAAIC,8BAAA,CAAa,IAAI,CAAA;AACjC,IAAA,IAAA,CAAK,QAAA,GAAW,IAAIC,kCAAA,CAAiB,IAAI,CAAA;AACzC,IAAA,IAAA,CAAK,UAAA,GAAa,IAAIC,oCAAA,CAAmB,IAAI,CAAA;AAC7C,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAIC,+BAAA,CAAc,IAAI,CAAA;AACnC,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,iCAAA,CAAgB,IAAI,CAAA;AACvC,IAAA,IAAA,CAAK,aAAA,GAAgB,IAAIC,uCAAA,CAAsB,IAAI,CAAA;AACnD,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAIC,+BAAA,CAAc,IAAI,CAAA;AACnC,IAAA,IAAA,CAAK,QAAA,GAAW,IAAIC,kCAAA,CAAiB,IAAI,CAAA;AACzC,IAAA,IAAA,CAAK,IAAA,GAAO,IAAIC,8BAAA,CAAa,IAAI,CAAA;AACjC,IAAA,IAAA,CAAK,UAAA,GAAa,IAAIC,oCAAA,CAAmB,IAAI,CAAA;AAC7C,IAAA,IAAA,CAAK,SAAA,GAAY,IAAIC,mCAAA,CAAkB,IAAI,CAAA;AAC3C,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,iCAAA,CAAgB,IAAI,CAAA;AACvC,IAAA,IAAA,CAAK,SAAA,GAAY,IAAIC,mCAAA,CAAkB,IAAI,CAAA;AAC3C,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,iCAAA,CAAgB,IAAI,CAAA;AACvC,IAAA,IAAA,CAAK,SAAA,GAAY,IAAIC,mCAAA,CAAkB,IAAI,CAAA;AAC3C,IAAA,IAAA,CAAK,MAAA,GAAS,IAAIC,gCAAA,CAAe,IAAI,CAAA;AACrC,IAAA,IAAA,CAAK,YAAA,GAAe,IAAIC,sCAAA,CAAqB,IAAI,CAAA;AACjD,IAAA,IAAA,CAAK,MAAA,GAAS,IAAIC,gCAAA,CAAe,IAAI,CAAA;AACrC,IAAA,IAAA,CAAK,GAAA,GAAM,IAAIC,6BAAA,CAAY,IAAI,CAAA;AAC/B,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAIC,+BAAA,CAAc,IAAI,CAAA;AACnC,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAIC,+BAAA,CAAc,IAAI,CAAA;AACnC,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,iCAAA,CAAgB,IAAI,CAAA;AACvC,IAAA,IAAA,CAAK,YAAA,GAAe,IAAIC,sCAAA,CAAqB,IAAI,CAAA;AACjD,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,iCAAA,CAAgB,IAAI,CAAA;AACvC,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,iCAAA,CAAgB,IAAI,CAAA;AACvC,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,iCAAA,CAAgB,IAAI,CAAA;AACvC,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,iCAAA,CAAgB,IAAI,CAAA;AACvC,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,iCAAA,CAAgB,IAAI,CAAA;AACvC,IAAA,IAAA,CAAK,UAAA,GAAa,IAAIC,oCAAA,CAAmB,IAAI,CAAA;AAC7C,IAAA,IAAA,CAAK,WAAA,GAAc,IAAIC,qCAAA,CAAoB,IAAI,CAAA;AAC/C,IAAA,IAAA,CAAK,QAAA,GAAW,IAAIC,kCAAA,CAAiB,IAAI,CAAA;AACzC,IAAA,IAAA,CAAK,UAAA,GAAa,IAAIC,oCAAA,CAAmB,IAAI,CAAA;AAC7C,IAAA,IAAA,CAAK,WAAA,GAAc,IAAIC,qCAAA,CAAoB,IAAI,CAAA;AAC/C,IAAA,IAAA,CAAK,cAAA,GAAiB,IAAIC,wCAAA,CAAuB,IAAI,CAAA;AACrD,IAAA,IAAA,CAAK,QAAA,GAAW,IAAIC,kCAAA,CAAiB,IAAI,CAAA;AACzC,IAAA,IAAA,CAAK,MAAA,GAAS,IAAIC,gCAAA,CAAe,IAAI,CAAA;AACrC,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAIC,+BAAA,CAAc,IAAI,CAAA;AACnC,IAAA,IAAA,CAAK,MAAA,GAAS,IAAIC,gCAAA,CAAe,IAAI,CAAA;AACrC,IAAA,IAAA,CAAK,QAAA,GAAW,IAAIC,kCAAA,CAAiB,IAAI,CAAA;AACzC,IAAA,IAAA,CAAK,MAAA,GAAS,IAAIC,gCAAA,CAAe,IAAI,CAAA;AACrC,IAAA,IAAA,CAAK,MAAA,GAAS,IAAIC,gCAAA,CAAe,IAAI,CAAA;AACrC,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,iCAAA,CAAgB,IAAI,CAAA;AACvC,IAAA,IAAA,CAAK,SAAA,GAAY,IAAIC,mCAAA,CAAkB,IAAI,CAAA;AAC3C,IAAA,IAAA,CAAK,SAAA,GAAY,IAAIC,mCAAA,CAAkB,IAAI,CAAA;AAC3C,IAAA,IAAA,CAAK,SAAA,GAAY,IAAIC,mCAAA,CAAkB,IAAI,CAAA;AAC3C,IAAA,IAAA,CAAK,aAAA,GAAgB,IAAIC,uCAAA,CAAsB,IAAI,CAAA;AACnD,IAAA,IAAA,CAAK,UAAA,GAAa,IAAIC,oCAAA,CAAmB,IAAI,CAAA;AAC7C,IAAA,IAAA,CAAK,IAAA,GAAO,IAAIC,8BAAA,CAAa,IAAI,CAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,cAAc,WAAA,EAA0C;AAMtD,IAAA,MAAM,aAAA,GAAgB,KAAK,eAAe,CAAA;AAC1C,IAAA,OAAO,IAAI,aAAA,CAAa;AAAA,MACtB,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,WAAW,IAAA,CAAK,SAAA;AAAA,MAChB,GAAI,aAAA,GAAgB,EAAE,KAAA,EAAO,aAAA,KAAkB,EAAC;AAAA,MAChD,GAAI,KAAK,kBAAkB,CAAA,GAAI,EAAE,WAAA,EAAa,IAAA,CAAK,WAAA,EAAY,GAAI,EAAC;AAAA,MACpE,GAAI,WAAA,GAAc,EAAE,WAAA,KAAgB;AAAC,KACtC,CAAA;AAAA,EACH;AACF;AAGO,SAAS,aAAa,IAAA,EAAmC;AAC9D,EAAA,OAAO,IAAI,aAAa,IAAI,CAAA;AAC9B","file":"chunk-I6Q4UDS2.cjs","sourcesContent":["import { WorkflowsResource } from \"./resources/workflows.js\"\nimport { ProjectsResource } from \"./resources/projects.js\"\nimport { SessionsResource } from \"./resources/sessions.js\"\nimport { TrashResource } from \"./resources/trash.js\"\nimport { JobsResource } from \"./resources/jobs.js\"\nimport { VideoProResource } from \"./resources/video-pro.js\"\nimport { ExecutionsResource } from \"./resources/executions.js\"\nimport { NodesResource } from \"./resources/nodes.js\"\nimport { Scene3DResource } from \"./resources/scene3d.js\"\nimport { DeveloperAppsResource } from \"./resources/developer-apps.js\"\nimport { OAuthResource } from \"./resources/oauth.js\"\nimport { WebhooksResource } from \"./resources/webhooks.js\"\nimport { AppsResource } from \"./resources/apps.js\"\nimport { CharactersResource } from \"./resources/characters.js\"\nimport { LocationsResource } from \"./resources/locations.js\"\nimport { ObjectsResource } from \"./resources/objects.js\"\nimport { CreaturesResource } from \"./resources/creatures.js\"\nimport { KeepersResource } from \"./resources/keepers.js\"\nimport { PipelinesResource } from \"./resources/pipelines.js\"\nimport { ReduceResource } from \"./resources/reduce.js\"\nimport { PromptHelperResource } from \"./resources/prompt-helper.js\"\nimport { VoicesResource } from \"./resources/voices.js\"\nimport { LlmResource } from \"./resources/llm.js\"\nimport { MediaResource } from \"./resources/media.js\"\nimport { AudioResource } from \"./resources/audio.js\"\nimport { CreditsResource } from \"./resources/credits.js\"\nimport { BillingResource } from \"./resources/billing.js\"\nimport { UserSettingsResource } from \"./resources/user-settings.js\"\nimport { UploadsResource } from \"./resources/uploads.js\"\nimport { LibraryResource } from \"./resources/library.js\"\nimport { GalleryResource } from \"./resources/gallery.js\"\nimport { PresetsResource } from \"./resources/node-presets.js\"\nimport { SavedPostsResource } from \"./resources/saved-posts.js\"\nimport { CollectionsResource } from \"./resources/collections.js\"\nimport { PalettesResource } from \"./resources/palettes.js\"\nimport { MoodboardsResource } from \"./resources/moodboards.js\"\nimport { CompetitorsResource } from \"./resources/competitors.js\"\nimport { PickerCatalogsResource } from \"./resources/picker-catalogs.js\"\nimport { CatalogsResource } from \"./resources/catalogs.js\"\nimport { ModelsResource } from \"./resources/models.js\"\nimport { ShotsResource } from \"./resources/shots.js\"\nimport { RecastResource } from \"./resources/recast.js\"\nimport { CastSwapResource } from \"./resources/cast-swap.js\"\nimport { TrendsResource } from \"./resources/trends.js\"\nimport { StudioResource } from \"./resources/studio.js\"\nimport { CopilotResource } from \"./resources/copilot.js\"\nimport { CommunityResource } from \"./resources/community.js\"\nimport { TemplatesResource } from \"./resources/templates.js\"\nimport { TutorialsResource } from \"./resources/tutorials.js\"\nimport { OrganizationsResource } from \"./resources/organizations.js\"\nimport { WorkspacesResource } from \"./resources/workspaces.js\"\nimport { EditResource } from \"./resources/edit.js\"\nimport { NodaroClientCore, type ClientOptions } from \"./core.js\"\n\nexport { CLIENT_HEADER } from \"./core.js\"\nexport type { ClientOptions, UserIdentity, ConnectedApp } from \"./core.js\"\n\n/**\n * The full client: the core (`./core.ts` — config, transport, identity) and\n * every resource.\n */\nexport class NodaroClient extends NodaroClientCore {\n  readonly workflows: WorkflowsResource\n  readonly projects: ProjectsResource\n  /** Generation sessions inside projects (Create Image / Video / Music). */\n  readonly sessions: SessionsResource\n  /** Your Trash: items removed from sessions and deleted jobs. */\n  readonly trash: TrashResource\n  readonly jobs: JobsResource\n  readonly videoPro: VideoProResource\n  readonly executions: ExecutionsResource\n  readonly nodes: NodesResource\n  readonly scene3d: Scene3DResource\n  readonly developerApps: DeveloperAppsResource\n  readonly oauth: OAuthResource\n  /** Outbound webhooks: endpoints that receive your job.completed / job.failed. */\n  readonly webhooks: WebhooksResource\n  readonly apps: AppsResource\n  readonly characters: CharactersResource\n  readonly locations: LocationsResource\n  readonly objects: ObjectsResource\n  readonly creatures: CreaturesResource\n  /** The shared Nodaro Keepers catalog of characters, creatures, locations and objects. */\n  readonly keepers: KeepersResource\n  readonly pipelines: PipelinesResource\n  readonly reduce: ReduceResource\n  readonly promptHelper: PromptHelperResource\n  readonly voices: VoicesResource\n  readonly llm: LlmResource\n  readonly media: MediaResource\n  readonly audio: AudioResource\n  readonly credits: CreditsResource\n  /** The signed-in person's own settings (the interface language, the monthly statement opt-in, …). */\n  readonly userSettings: UserSettingsResource\n  /** Plans and prices, the subscription, and how this deployment bills. */\n  readonly billing: BillingResource\n  readonly uploads: UploadsResource\n  readonly library: LibraryResource\n  /** The public gallery and your favorites. */\n  readonly gallery: GalleryResource\n  readonly presets: PresetsResource\n  readonly savedPosts: SavedPostsResource\n  readonly collections: CollectionsResource\n  /** Your colour palettes — a generate-image direction (`direction.colorLook: paletteDirectionId(id)`). */\n  readonly palettes: PalettesResource\n  /** Your moodboards — a generate-image direction (`direction.style: moodboardDirectionId(id)`). */\n  readonly moodboards: MoodboardsResource\n  readonly competitors: CompetitorsResource\n  readonly pickerCatalogs: PickerCatalogsResource\n  readonly catalogs: CatalogsResource\n  readonly models: ModelsResource\n  readonly shots: ShotsResource\n  readonly recast: RecastResource\n  /** Cast Swap: replace the people and/or location in a short video (Cloud). */\n  readonly castSwap: CastSwapResource\n  /** Trends: ready-made Cast Swap recipes you fill with your own pictures (Cloud). */\n  readonly trends: TrendsResource\n  readonly studio: StudioResource\n  readonly copilot: CopilotResource\n  readonly community: CommunityResource\n  readonly templates: TemplatesResource\n  readonly tutorials: TutorialsResource\n  readonly organizations: OrganizationsResource\n  readonly workspaces: WorkspacesResource\n  readonly edit: EditResource\n\n  constructor(opts: ClientOptions) {\n    super(opts)\n\n    this.workflows = new WorkflowsResource(this)\n    this.projects = new ProjectsResource(this)\n    this.sessions = new SessionsResource(this)\n    this.trash = new TrashResource(this)\n    this.jobs = new JobsResource(this)\n    this.videoPro = new VideoProResource(this)\n    this.executions = new ExecutionsResource(this)\n    this.nodes = new NodesResource(this)\n    this.scene3d = new Scene3DResource(this)\n    this.developerApps = new DeveloperAppsResource(this)\n    this.oauth = new OAuthResource(this)\n    this.webhooks = new WebhooksResource(this)\n    this.apps = new AppsResource(this)\n    this.characters = new CharactersResource(this)\n    this.locations = new LocationsResource(this)\n    this.objects = new ObjectsResource(this)\n    this.creatures = new CreaturesResource(this)\n    this.keepers = new KeepersResource(this)\n    this.pipelines = new PipelinesResource(this)\n    this.reduce = new ReduceResource(this)\n    this.promptHelper = new PromptHelperResource(this)\n    this.voices = new VoicesResource(this)\n    this.llm = new LlmResource(this)\n    this.media = new MediaResource(this)\n    this.audio = new AudioResource(this)\n    this.credits = new CreditsResource(this)\n    this.userSettings = new UserSettingsResource(this)\n    this.billing = new BillingResource(this)\n    this.uploads = new UploadsResource(this)\n    this.library = new LibraryResource(this)\n    this.gallery = new GalleryResource(this)\n    this.presets = new PresetsResource(this)\n    this.savedPosts = new SavedPostsResource(this)\n    this.collections = new CollectionsResource(this)\n    this.palettes = new PalettesResource(this)\n    this.moodboards = new MoodboardsResource(this)\n    this.competitors = new CompetitorsResource(this)\n    this.pickerCatalogs = new PickerCatalogsResource(this)\n    this.catalogs = new CatalogsResource(this)\n    this.models = new ModelsResource(this)\n    this.shots = new ShotsResource(this)\n    this.recast = new RecastResource(this)\n    this.castSwap = new CastSwapResource(this)\n    this.trends = new TrendsResource(this)\n    this.studio = new StudioResource(this)\n    this.copilot = new CopilotResource(this)\n    this.community = new CommunityResource(this)\n    this.templates = new TemplatesResource(this)\n    this.tutorials = new TutorialsResource(this)\n    this.organizations = new OrganizationsResource(this)\n    this.workspaces = new WorkspacesResource(this)\n    this.edit = new EditResource(this)\n  }\n\n  /**\n   * A client that acts in `workspaceId`, sharing this one's auth and config.\n   *\n   * A NEW client rather than a setter, deliberately. A mutable selection is\n   * the bug this whole axis exists to prevent: two concurrent operations\n   * against one client would race over which workspace they were in, and the\n   * loser would create work in the wrong place with nothing failing. A\n   * per-workspace client cannot be raced.\n   *\n   * Pass `null` for the personal space.\n   */\n  withWorkspace(workspaceId: string | null): NodaroClient {\n    // The two private settings are read by bracket access, which TypeScript\n    // allows on a subclass and which adds no member to the declarations. Read\n    // through `this` (not a side table keyed by the instance), so a client\n    // wrapped in a Proxy (Vue/Pinia `reactive()`) or reached through\n    // `Object.create(client)` still works.\n    const fetchOverride = this[\"fetchOverride\"]\n    return new NodaroClient({\n      baseUrl: this.baseUrl,\n      auth: this.auth,\n      timeoutMs: this.timeoutMs,\n      ...(fetchOverride ? { fetch: fetchOverride } : {}),\n      ...(this[\"sendClientHeader\"] ? { clientLabel: this.clientLabel } : {}),\n      ...(workspaceId ? { workspaceId } : {}),\n    })\n  }\n}\n\n/** Factory function — preferred entry point. */\nexport function createClient(opts: ClientOptions): NodaroClient {\n  return new NodaroClient(opts)\n}\n"]}

package/dist/{chunk-HLYRNWHW.js → chunk-LUHAB7UJ.js}

@@ -1,3 +1,4 @@
+import { TutorialsResource } from './chunk-HPXE3NZW.js';
 import { UploadsResource } from './chunk-WY4QRJZW.js';
 import { UserSettingsResource } from './chunk-LR5TGCJP.js';
 import { VideoProResource } from './chunk-ERLXU47J.js';
@@ -5,14 +6,15 @@ import { VoicesResource } from './chunk-T7N7DFQJ.js';
 import { WebhooksResource } from './chunk-YN6CBIIB.js';
 import { WorkflowsResource } from './chunk-33HT46A3.js';
 import { WorkspacesResource } from './chunk-Z5GLY4R3.js';
+import { SavedPostsResource } from './chunk-NCCBS6GU.js';
 import { Scene3DResource } from './chunk-NNHWH7ER.js';
 import { SessionsResource } from './chunk-WS4ZQ4AA.js';
 import { ShotsResource } from './chunk-WVFAQBS7.js';
 import { StudioResource } from './chunk-AUKHMT53.js';
 import { TemplatesResource } from './chunk-M7VSFZMV.js';
 import { TrashResource } from './chunk-2SQ7V6EX.js';
-import { TrendsResource } from './chunk-35CNQ3WW.js';
-import { TutorialsResource } from './chunk-HPXE3NZW.js';
+import { TrendsResource } from './chunk-HFYNZ4SO.js';
+import { OrganizationsResource } from './chunk-ALSLZG3U.js';
 import { PalettesResource } from './chunk-WEQWU2IC.js';
 import { PickerCatalogsResource } from './chunk-KFZOJBI5.js';
 import { PipelinesResource } from './chunk-K4RQOSJH.js';
@@ -20,28 +22,27 @@ import { ProjectsResource } from './chunk-H7VQTG4M.js';
 import { PromptHelperResource } from './chunk-OIPPTBW4.js';
 import { RecastResource } from './chunk-AJVSMNPZ.js';
 import { ReduceResource } from './chunk-IHKIYVZQ.js';
-import { SavedPostsResource } from './chunk-NCCBS6GU.js';
-import { MediaResource } from './chunk-BQAW4RX2.js';
+import { LocationsResource } from './chunk-XZPSJG2X.js';
+import { MediaResource } from './chunk-24JE54FQ.js';
 import { ModelsResource } from './chunk-Y6V6CBY5.js';
 import { MoodboardsResource } from './chunk-YVU2M7MI.js';
 import { PresetsResource } from './chunk-AEUPH7EE.js';
-import { NodesResource } from './chunk-GW76IRQD.js';
+import { NodesResource } from './chunk-47ULSVO2.js';
 import { OAuthResource } from './chunk-Z7LGWNI7.js';
-import { ObjectsResource } from './chunk-7LSFG2AF.js';
-import { OrganizationsResource } from './chunk-ALSLZG3U.js';
+import { ObjectsResource } from './chunk-GIQDM2MH.js';
 import { EditResource } from './chunk-RBX3QTKB.js';
 import { ExecutionsResource } from './chunk-Z3ZKFI2M.js';
 import { GalleryResource } from './chunk-JDEZHITT.js';
-import { JobsResource } from './chunk-THLTFB6I.js';
+import { JobsResource } from './chunk-HJLSOT5C.js';
+import { KeepersResource } from './chunk-MQWZFWHE.js';
 import { LibraryResource } from './chunk-P6E4QDJN.js';
 import { LlmResource } from './chunk-E37CVHWW.js';
-import { LocationsResource } from './chunk-TVENC6PH.js';
 import { CollectionsResource } from './chunk-4WRDR4GN.js';
 import { CommunityResource } from './chunk-SFB4YLCS.js';
 import { CompetitorsResource } from './chunk-BU5A6K4C.js';
 import { CopilotResource } from './chunk-D2ILCSOQ.js';
-import { NodaroClientCore } from './chunk-V5MY46JA.js';
-import { CreaturesResource } from './chunk-CK3AMMSC.js';
+import { NodaroClientCore } from './chunk-CV2ZZAUO.js';
+import { CreaturesResource } from './chunk-HUYI5G3D.js';
 import { CreditsResource } from './chunk-7QK2NXJA.js';
 import { DeveloperAppsResource } from './chunk-65E3JBFZ.js';
 import { AppsResource } from './chunk-7LODCIQK.js';
@@ -49,7 +50,7 @@ import { AudioResource } from './chunk-3QFTP5P5.js';
 import { BillingResource } from './chunk-ZVKEPVDQ.js';
 import { CastSwapResource } from './chunk-DV6GTEX5.js';
 import { CatalogsResource } from './chunk-KG4R454Z.js';
-import { CharactersResource } from './chunk-EJSGJDZY.js';
+import { CharactersResource } from './chunk-CBDUHYTR.js';
 
 // src/client.ts
 var NodaroClient = class _NodaroClient extends NodaroClientCore {
@@ -73,6 +74,8 @@ var NodaroClient = class _NodaroClient extends NodaroClientCore {
   locations;
   objects;
   creatures;
+  /** The shared Nodaro Keepers catalog of characters, creatures, locations and objects. */
+  keepers;
   pipelines;
   reduce;
   promptHelper;
@@ -133,6 +136,7 @@ var NodaroClient = class _NodaroClient extends NodaroClientCore {
     this.locations = new LocationsResource(this);
     this.objects = new ObjectsResource(this);
     this.creatures = new CreaturesResource(this);
+    this.keepers = new KeepersResource(this);
     this.pipelines = new PipelinesResource(this);
     this.reduce = new ReduceResource(this);
     this.promptHelper = new PromptHelperResource(this);
@@ -196,5 +200,5 @@ function createClient(opts) {
 }
 
 export { NodaroClient, createClient };
-//# sourceMappingURL=chunk-HLYRNWHW.js.map
-//# sourceMappingURL=chunk-HLYRNWHW.js.map
+//# sourceMappingURL=chunk-LUHAB7UJ.js.map
+//# sourceMappingURL=chunk-LUHAB7UJ.js.map

package/dist/chunk-LUHAB7UJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"chunk-LUHAB7UJ.js","sourcesContent":["import { WorkflowsResource } from \"./resources/workflows.js\"\nimport { ProjectsResource } from \"./resources/projects.js\"\nimport { SessionsResource } from \"./resources/sessions.js\"\nimport { TrashResource } from \"./resources/trash.js\"\nimport { JobsResource } from \"./resources/jobs.js\"\nimport { VideoProResource } from \"./resources/video-pro.js\"\nimport { ExecutionsResource } from \"./resources/executions.js\"\nimport { NodesResource } from \"./resources/nodes.js\"\nimport { Scene3DResource } from \"./resources/scene3d.js\"\nimport { DeveloperAppsResource } from \"./resources/developer-apps.js\"\nimport { OAuthResource } from \"./resources/oauth.js\"\nimport { WebhooksResource } from \"./resources/webhooks.js\"\nimport { AppsResource } from \"./resources/apps.js\"\nimport { CharactersResource } from \"./resources/characters.js\"\nimport { LocationsResource } from \"./resources/locations.js\"\nimport { ObjectsResource } from \"./resources/objects.js\"\nimport { CreaturesResource } from \"./resources/creatures.js\"\nimport { KeepersResource } from \"./resources/keepers.js\"\nimport { PipelinesResource } from \"./resources/pipelines.js\"\nimport { ReduceResource } from \"./resources/reduce.js\"\nimport { PromptHelperResource } from \"./resources/prompt-helper.js\"\nimport { VoicesResource } from \"./resources/voices.js\"\nimport { LlmResource } from \"./resources/llm.js\"\nimport { MediaResource } from \"./resources/media.js\"\nimport { AudioResource } from \"./resources/audio.js\"\nimport { CreditsResource } from \"./resources/credits.js\"\nimport { BillingResource } from \"./resources/billing.js\"\nimport { UserSettingsResource } from \"./resources/user-settings.js\"\nimport { UploadsResource } from \"./resources/uploads.js\"\nimport { LibraryResource } from \"./resources/library.js\"\nimport { GalleryResource } from \"./resources/gallery.js\"\nimport { PresetsResource } from \"./resources/node-presets.js\"\nimport { SavedPostsResource } from \"./resources/saved-posts.js\"\nimport { CollectionsResource } from \"./resources/collections.js\"\nimport { PalettesResource } from \"./resources/palettes.js\"\nimport { MoodboardsResource } from \"./resources/moodboards.js\"\nimport { CompetitorsResource } from \"./resources/competitors.js\"\nimport { PickerCatalogsResource } from \"./resources/picker-catalogs.js\"\nimport { CatalogsResource } from \"./resources/catalogs.js\"\nimport { ModelsResource } from \"./resources/models.js\"\nimport { ShotsResource } from \"./resources/shots.js\"\nimport { RecastResource } from \"./resources/recast.js\"\nimport { CastSwapResource } from \"./resources/cast-swap.js\"\nimport { TrendsResource } from \"./resources/trends.js\"\nimport { StudioResource } from \"./resources/studio.js\"\nimport { CopilotResource } from \"./resources/copilot.js\"\nimport { CommunityResource } from \"./resources/community.js\"\nimport { TemplatesResource } from \"./resources/templates.js\"\nimport { TutorialsResource } from \"./resources/tutorials.js\"\nimport { OrganizationsResource } from \"./resources/organizations.js\"\nimport { WorkspacesResource } from \"./resources/workspaces.js\"\nimport { EditResource } from \"./resources/edit.js\"\nimport { NodaroClientCore, type ClientOptions } from \"./core.js\"\n\nexport { CLIENT_HEADER } from \"./core.js\"\nexport type { ClientOptions, UserIdentity, ConnectedApp } from \"./core.js\"\n\n/**\n * The full client: the core (`./core.ts` — config, transport, identity) and\n * every resource.\n */\nexport class NodaroClient extends NodaroClientCore {\n  readonly workflows: WorkflowsResource\n  readonly projects: ProjectsResource\n  /** Generation sessions inside projects (Create Image / Video / Music). */\n  readonly sessions: SessionsResource\n  /** Your Trash: items removed from sessions and deleted jobs. */\n  readonly trash: TrashResource\n  readonly jobs: JobsResource\n  readonly videoPro: VideoProResource\n  readonly executions: ExecutionsResource\n  readonly nodes: NodesResource\n  readonly scene3d: Scene3DResource\n  readonly developerApps: DeveloperAppsResource\n  readonly oauth: OAuthResource\n  /** Outbound webhooks: endpoints that receive your job.completed / job.failed. */\n  readonly webhooks: WebhooksResource\n  readonly apps: AppsResource\n  readonly characters: CharactersResource\n  readonly locations: LocationsResource\n  readonly objects: ObjectsResource\n  readonly creatures: CreaturesResource\n  /** The shared Nodaro Keepers catalog of characters, creatures, locations and objects. */\n  readonly keepers: KeepersResource\n  readonly pipelines: PipelinesResource\n  readonly reduce: ReduceResource\n  readonly promptHelper: PromptHelperResource\n  readonly voices: VoicesResource\n  readonly llm: LlmResource\n  readonly media: MediaResource\n  readonly audio: AudioResource\n  readonly credits: CreditsResource\n  /** The signed-in person's own settings (the interface language, the monthly statement opt-in, …). */\n  readonly userSettings: UserSettingsResource\n  /** Plans and prices, the subscription, and how this deployment bills. */\n  readonly billing: BillingResource\n  readonly uploads: UploadsResource\n  readonly library: LibraryResource\n  /** The public gallery and your favorites. */\n  readonly gallery: GalleryResource\n  readonly presets: PresetsResource\n  readonly savedPosts: SavedPostsResource\n  readonly collections: CollectionsResource\n  /** Your colour palettes — a generate-image direction (`direction.colorLook: paletteDirectionId(id)`). */\n  readonly palettes: PalettesResource\n  /** Your moodboards — a generate-image direction (`direction.style: moodboardDirectionId(id)`). */\n  readonly moodboards: MoodboardsResource\n  readonly competitors: CompetitorsResource\n  readonly pickerCatalogs: PickerCatalogsResource\n  readonly catalogs: CatalogsResource\n  readonly models: ModelsResource\n  readonly shots: ShotsResource\n  readonly recast: RecastResource\n  /** Cast Swap: replace the people and/or location in a short video (Cloud). */\n  readonly castSwap: CastSwapResource\n  /** Trends: ready-made Cast Swap recipes you fill with your own pictures (Cloud). */\n  readonly trends: TrendsResource\n  readonly studio: StudioResource\n  readonly copilot: CopilotResource\n  readonly community: CommunityResource\n  readonly templates: TemplatesResource\n  readonly tutorials: TutorialsResource\n  readonly organizations: OrganizationsResource\n  readonly workspaces: WorkspacesResource\n  readonly edit: EditResource\n\n  constructor(opts: ClientOptions) {\n    super(opts)\n\n    this.workflows = new WorkflowsResource(this)\n    this.projects = new ProjectsResource(this)\n    this.sessions = new SessionsResource(this)\n    this.trash = new TrashResource(this)\n    this.jobs = new JobsResource(this)\n    this.videoPro = new VideoProResource(this)\n    this.executions = new ExecutionsResource(this)\n    this.nodes = new NodesResource(this)\n    this.scene3d = new Scene3DResource(this)\n    this.developerApps = new DeveloperAppsResource(this)\n    this.oauth = new OAuthResource(this)\n    this.webhooks = new WebhooksResource(this)\n    this.apps = new AppsResource(this)\n    this.characters = new CharactersResource(this)\n    this.locations = new LocationsResource(this)\n    this.objects = new ObjectsResource(this)\n    this.creatures = new CreaturesResource(this)\n    this.keepers = new KeepersResource(this)\n    this.pipelines = new PipelinesResource(this)\n    this.reduce = new ReduceResource(this)\n    this.promptHelper = new PromptHelperResource(this)\n    this.voices = new VoicesResource(this)\n    this.llm = new LlmResource(this)\n    this.media = new MediaResource(this)\n    this.audio = new AudioResource(this)\n    this.credits = new CreditsResource(this)\n    this.userSettings = new UserSettingsResource(this)\n    this.billing = new BillingResource(this)\n    this.uploads = new UploadsResource(this)\n    this.library = new LibraryResource(this)\n    this.gallery = new GalleryResource(this)\n    this.presets = new PresetsResource(this)\n    this.savedPosts = new SavedPostsResource(this)\n    this.collections = new CollectionsResource(this)\n    this.palettes = new PalettesResource(this)\n    this.moodboards = new MoodboardsResource(this)\n    this.competitors = new CompetitorsResource(this)\n    this.pickerCatalogs = new PickerCatalogsResource(this)\n    this.catalogs = new CatalogsResource(this)\n    this.models = new ModelsResource(this)\n    this.shots = new ShotsResource(this)\n    this.recast = new RecastResource(this)\n    this.castSwap = new CastSwapResource(this)\n    this.trends = new TrendsResource(this)\n    this.studio = new StudioResource(this)\n    this.copilot = new CopilotResource(this)\n    this.community = new CommunityResource(this)\n    this.templates = new TemplatesResource(this)\n    this.tutorials = new TutorialsResource(this)\n    this.organizations = new OrganizationsResource(this)\n    this.workspaces = new WorkspacesResource(this)\n    this.edit = new EditResource(this)\n  }\n\n  /**\n   * A client that acts in `workspaceId`, sharing this one's auth and config.\n   *\n   * A NEW client rather than a setter, deliberately. A mutable selection is\n   * the bug this whole axis exists to prevent: two concurrent operations\n   * against one client would race over which workspace they were in, and the\n   * loser would create work in the wrong place with nothing failing. A\n   * per-workspace client cannot be raced.\n   *\n   * Pass `null` for the personal space.\n   */\n  withWorkspace(workspaceId: string | null): NodaroClient {\n    // The two private settings are read by bracket access, which TypeScript\n    // allows on a subclass and which adds no member to the declarations. Read\n    // through `this` (not a side table keyed by the instance), so a client\n    // wrapped in a Proxy (Vue/Pinia `reactive()`) or reached through\n    // `Object.create(client)` still works.\n    const fetchOverride = this[\"fetchOverride\"]\n    return new NodaroClient({\n      baseUrl: this.baseUrl,\n      auth: this.auth,\n      timeoutMs: this.timeoutMs,\n      ...(fetchOverride ? { fetch: fetchOverride } : {}),\n      ...(this[\"sendClientHeader\"] ? { clientLabel: this.clientLabel } : {}),\n      ...(workspaceId ? { workspaceId } : {}),\n    })\n  }\n}\n\n/** Factory function — preferred entry point. */\nexport function createClient(opts: ClientOptions): NodaroClient {\n  return new NodaroClient(opts)\n}\n"]}

package/dist/{chunk-MQ74AKA2.cjs → chunk-MIXRL6I2.cjs}

@@ -85,6 +85,15 @@ var LocationsResource = class {
   restore(id) {
     return this.client.request("POST", `/v1/locations/${encodeURIComponent(id)}/restore`);
   }
+  /**
+   * Admin only: put one of your own locations on the shared Nodaro Keepers
+   * shelf (`client.keepers.catalog()`), or take it off. A first-party session
+   * or your personal token; `forbidden` for anyone who is not a platform
+   * admin, `not_found` for a row that is not yours.
+   */
+  setCatalog(id, input) {
+    return this.client.request("PUT", `/v1/locations/${encodeURIComponent(id)}/catalog`, { body: input });
+  }
   /**
    * Fire `POST /v1/generate-location` to produce one or more candidate main
    * images. With `count > 1`, all jobs are reserved up-front before any
@@ -196,5 +205,5 @@ Object.defineProperty(exports, "SURROUND_DIRECTIONS", {
   get: function () { return entities.SURROUND_DIRECTIONS; }
 });
 exports.LocationsResource = LocationsResource;
-//# sourceMappingURL=chunk-MQ74AKA2.cjs.map
-//# sourceMappingURL=chunk-MQ74AKA2.cjs.map
+//# sourceMappingURL=chunk-MIXRL6I2.cjs.map
+//# sourceMappingURL=chunk-MIXRL6I2.cjs.map

package/dist/chunk-MIXRL6I2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/locations.ts"],"names":[],"mappings":"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","file":"chunk-MIXRL6I2.cjs","sourcesContent":["import type { CharacterAspectRatio, SurroundDirection, LocationAssetType, LocationAttachColumn } from \"@nodaro/shared/entities\"\nexport type { LocationAssetType, LocationAttachColumn, CharacterAspectRatio, SurroundDirection } from \"@nodaro/shared/entities\"\nexport { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, SURROUND_DIRECTIONS } from \"@nodaro/shared/entities\"\nimport type { NodaroClientCore } from \"../core.js\"\nimport type { SetKeeperCatalogInput, SetKeeperCatalogResult } from \"./keepers.js\"\nimport type { GenerationSessionParams } from \"./nodes.js\"\n\n/**\n * Re-export the shared `LocationAssetType` / `LocationAttachColumn` unions and\n * their runtime tuples so SDK consumers don't have to add `@nodaro/shared` as a\n * second dependency just to typecheck the `assetType` / `attachToColumn`\n * fields. Single source of truth lives in `@nodaro/shared/entity-prompts`.\n *\n * `CharacterAspectRatio` is re-exported alongside them — `generateMotion`'s\n * `aspectRatio` field reuses the same 4-value enum (1:1 / 3:4 / 16:9 / 9:16)\n * as characters; the route enforces this with `z.enum(CHARACTER_ASPECT_OPTIONS)`.\n */\n\n/**\n * Reference-photo kind discriminator — the mood-board roles a user can attach\n * to a location. Mirrors the `reference_photos.kind` Zod enum in\n * `backend/src/routes/locations.ts`. `other` is the free-form bucket.\n */\nexport type LocationReferencePhotoKind =\n  | \"wide\"\n  | \"interior\"\n  | \"exterior\"\n  | \"detail\"\n  | \"moodBoard\"\n  | \"other\"\n\nexport interface LocationReferencePhoto {\n  url: string\n  kind: LocationReferencePhotoKind\n}\n\n/**\n * A location record returned by Nodaro's REST API. Mirrors the camelCase\n * shape produced by `backend/src/routes/locations.ts::toCamel()`.\n *\n * Asset buckets (`timeOfDay`, `weather`, `angles`, `lighting`, `seasons`,\n * `atmosphereMotions`) are independent JSONB arrays keyed by a human-readable\n * variant name (e.g. `\"dawn\"`, `\"clear\"`, `\"wide\"`). Each entry's `url` points\n * at an R2-hosted asset.\n *\n * Identity-foundation fields:\n *   - `referencePhotos` — caller-supplied mood-board refs (cap 20).\n *   - `canonicalDescription` — ~80–120-word LLM-authored visual caption,\n *     populated by `approveMainImage()` / `recaption()`. The wire still sends\n *     `\"\"` on caption sub-failure (the breaking wire change is deferred to a\n *     major bump), but `get()` normalizes `\"\"` → `null` so consumers see the\n *     same `string | null` semantics as characters.\n *   - `styleLock` — whether asset gens should anchor to the canonical style\n *     captured at approval time. Defaults to `true` on new rows.\n */\nexport interface Location {\n  id: string\n  userId: string\n  nodeId: string\n  projectId: string | null\n  name: string\n  description: string | null\n  category: string | null\n  style: string | null\n  sourceImageUrl: string | null\n  /** MODEL_CATALOG image-model id the main image was generated with (or `null`).\n   *  Set on create + editable via the update route. */\n  imageProvider: string | null\n  timeOfDay: Array<{ name: string; url: string }>\n  weather: Array<{ name: string; url: string }>\n  angles: Array<{ name: string; url: string }>\n  lighting: Array<{ name: string; url: string }>\n  seasons: Array<{ name: string; url: string }>\n  atmosphereMotions: Array<{ name: string; url: string }>\n  /** Named Location Boards — dense reference sheets, one per variant/mood\n   *  (the `generate-image/location-board` factory preset rendered from the\n   *  location's images). A first-class bucket: community publish snapshots it\n   *  and clone hands the consumer their own copy to extend. Defaults to `[]`.\n   *  `type` marks an image-collage `\"identity\"` sheet vs a plain `\"looks\"`\n   *  board; `sourceImages` are the R2 URLs it was collaged from. Both optional\n   *  + backward-compatible (legacy boards have neither). */\n  boards?: Array<{ name: string; url: string; type?: \"looks\" | \"identity\"; sourceImages?: string[] }> | null\n  referencePhotos: LocationReferencePhoto[]\n  /** `null` when no caption is set (or the LLM caption sub-failed) — the wire\n   *  sends `\"\"`, normalized to `null` in `get()` to match character semantics. */\n  canonicalDescription: string | null\n  styleLock: boolean\n  /** The user's chosen DEFAULT asset take per variant (Studio version history).\n   *  OPAQUE map: key `\"<bucket>:<variant>\"` (e.g. `\"timeOfDay:dawn\"`) → the chosen\n   *  asset URL (one already present in that bucket). Stored verbatim — keys are\n   *  NOT normalized; soft-capped server-side at 200 keys / 2048-char values\n   *  (overflow dropped silently). Defaults to `{}`. */\n  selectedAssetByVariant?: Record<string, string> | null\n  /** Nodaro Keepers: whether this row is on the shared shelf (`client.keepers`).\n   *  Admin-set through `setCatalog`; `false` on everyone else's rows and on\n   *  every copy. Optional on the read surface for older servers. */\n  catalog?: boolean\n  /** The shelf order (lowest first); `0` when never set. */\n  catalogSort?: number\n  /** The shelf heading, or `null`. */\n  catalogCategory?: string | null\n  deletedAt: string | null\n  createdAt: string\n  updatedAt: string\n}\n\n/**\n * GET /v1/locations/:id appends a `pendingJobs` bucket the studio uses to\n * rehydrate spinners after a reload. Optional on the SDK surface — it doesn't\n * appear on `list()` rows.\n */\nexport interface LocationDetail extends Location {\n  pendingJobs?: Array<{\n    jobId: string\n    assetType: string\n    name: string\n    status: string\n  }>\n  /**\n   * Completed candidate main images for this location whose URL differs from\n   * the current `sourceImageUrl`, newest first (max 5). Surfaced so a\n   * \"pick from N\" UI can offer alternatives the user can promote via\n   * `approveMainImage(id, jobId)`; until they pick, the current main image is\n   * left untouched. Mirrors `CharacterDetail.previousCandidates`. Optional -\n   * absent on `list()` rows, present (possibly empty) on `get()`.\n   */\n  previousCandidates?: Array<{\n    jobId: string\n    url: string\n    createdAt: string\n  }>\n}\n\n/**\n * Body for `client.locations.create()`. Mirrors the INSERT branch of\n * `upsertLocationBody` in `backend/src/routes/locations.ts`. `name` + `nodeId`\n * are required on create.\n */\nexport interface CreateLocationInput {\n  nodeId: string\n  name: string\n  description?: string\n  category?: string\n  style?: string\n  workflowId?: string\n  projectId?: string\n  sourceImageUrl?: string\n  /** Persistent image-model id (a MODEL_CATALOG image model). Validated\n   *  server-side — unknown / non-image / \"\" is stored as `null`. */\n  imageProvider?: string | null\n  referencePhotos?: LocationReferencePhoto[]\n  canonicalDescription?: string\n  styleLock?: boolean\n  /** The user's chosen DEFAULT asset take per variant. OPAQUE\n   *  `\"<bucket>:<variant>\"` → chosen-URL map; a write REPLACES the whole map.\n   *  Keys stored verbatim; soft-capped server-side at 200 keys / 2048-char values. */\n  selectedAssetByVariant?: Record<string, string>\n}\n\n/**\n * Body for `client.locations.update()`. Mirrors the UPDATE branch of\n * `upsertLocationBody` in `backend/src/routes/locations.ts`.\n *\n * Worker-owned asset buckets (`timeOfDay`/`weather`/`angles`/`lighting`/\n * `seasons`/`atmosphereMotions`) are deliberately omitted — the route drops\n * them on UPDATE so a Studio auto-save with a stale snapshot cannot clobber\n * the worker's atomic `append_location_asset()` writes.\n *\n * `expectedUpdatedAt` is the optimistic-concurrency token: when present, the\n * UPDATE only succeeds if the row's `updated_at` still matches; on mismatch\n * the route returns 409 so the studio can re-fetch + merge.\n */\nexport interface UpdateLocationInput {\n  name?: string\n  description?: string\n  category?: string\n  style?: string\n  sourceImageUrl?: string\n  /** Persistent image-model id (a MODEL_CATALOG image model). Validated\n   *  server-side — unknown / non-image / \"\" is stored as `null`. */\n  imageProvider?: string | null\n  referencePhotos?: LocationReferencePhoto[]\n  canonicalDescription?: string\n  styleLock?: boolean\n  /** The user's chosen DEFAULT asset take per variant. OPAQUE\n   *  `\"<bucket>:<variant>\"` → chosen-URL map; a write REPLACES the whole map\n   *  (omit to leave untouched). Keys stored verbatim; soft-capped server-side\n   *  at 200 keys / 2048-char values. */\n  selectedAssetByVariant?: Record<string, string>\n  /** Named Location Boards (see `Location.boards`) — whole-array replace,\n   *  USER-owned (unlike the worker-owned buckets it flows through UPDATE).\n   *  Server caps: 24 boards, 200-char names, 30 sourceImages per board. */\n  boards?: Array<{ name: string; url: string; type?: \"looks\" | \"identity\"; sourceImages?: string[] }>\n  /** ISO-8601 timestamp recording when PII consent was captured for this location. */\n  piiConsentAt?: string\n  expectedUpdatedAt?: string\n}\n\nexport interface UpdateLocationResult {\n  id: string\n  updatedAt: string\n}\n\nexport interface ListLocationsParams {\n  /** When true, return archived locations instead of active ones. */\n  archived?: boolean\n  /**\n   * Search words: only the locations whose name or description contains\n   * every word (split on spaces, the first 5), in any order, ignoring case.\n   * Each word is matched as written (`%`, `_` and `*` are not wildcards;\n   * punctuation is kept); blank means no search; up to 200 characters.\n   * Combines with the other filters and with `cursor` paging.\n   */\n  q?: string\n  /**\n   * Max rows to return (cap 500). OPT-IN: omitted, the server returns the\n   * full legacy listing with no `nextCursor`; supplied, the response is one\n   * page plus `nextCursor` — keep passing it back until it is `null`.\n   */\n  limit?: number\n  /** Opaque cursor from a prior page's `nextCursor` (fetches the next page). */\n  cursor?: string\n}\n\n/**\n * Input for `client.locations.generate()` — fires the\n * `POST /v1/generate-location` route. Produces 1–10 candidate\n * establishing shots; each lands as one `jobs` row in `pending` state and\n * is then enqueued for the worker.\n *\n * When `attachToLocationId` is set AND `count === 1`, the worker writes the\n * resulting URL directly to `locations.source_image_url` on completion —\n * caller doesn't need a separate `approveMainImage` call. Multi-candidate\n * batches MUST go through explicit approval so the user picks the winner.\n */\nexport interface GenerateLocationInput extends GenerationSessionParams {\n  name: string\n  description?: string\n  userPrompt?: string\n  category?: \"indoor\" | \"outdoor\" | \"urban\" | \"nature\" | \"fantasy\" | \"sci-fi\" | \"historical\" | \"futuristic\" | \"other\"\n  style?: \"realistic\" | \"anime\" | \"3d-pixar\" | \"illustration\"\n  sourceImageUrl?: string\n  provider?: string\n  /** Number of candidate images to generate (1–10; server-validated). */\n  count?: number\n  /** Auto-attach the result to this location row (single-candidate only). */\n  attachToLocationId?: string\n  /**\n   * Credit-affecting quality tier (e.g. `\"high\"` for gpt-image). Priced like\n   * generate-image (composite ids such as `gpt-image:high`); values the chosen\n   * model doesn't support are ignored server-side, never rejected.\n   */\n  quality?: string\n  /**\n   * Credit-affecting output resolution (e.g. `\"2K\"` / `\"4K\"` / `\"2 MP\"`).\n   * Priced like generate-image (composite ids such as `nano-banana-pro:4K`);\n   * values the chosen model doesn't support are ignored server-side, never\n   * rejected.\n   */\n  resolution?: string\n}\n\n/**\n * `generate()` response — `jobIds` is ALWAYS present (the harmonized contract,\n * matching characters). `jobId` is a deprecated back-compat alias populated only\n * on `count === 1`; prefer `jobIds`. (Will be removed on the next major.)\n */\nexport interface GenerateLocationResult {\n  jobIds: string[]\n  /** @deprecated count===1 back-compat alias — use `jobIds`. */\n  jobId?: string\n}\n\n/**\n * Input for `client.locations.generateAsset()` — fires the\n * `POST /v1/generate-location-asset` route. Produces a single\n * timeOfDay / weather / seasons / angles / lighting / custom variant.\n *\n * When all three studio-path fields are set (`attachToLocationId` +\n * `attachToColumn` + `attachName`), the worker appends\n * `{ name: attachName, url: <result> }` to the named JSONB array column on\n * the user's location row on completion. `attachToColumn` is REQUIRED for\n * `assetType === \"custom\"` — the worker can't infer the bucket from the\n * asset type.\n */\nexport interface GenerateLocationAssetInput extends GenerationSessionParams {\n  assetType: LocationAssetType\n  variant: string\n  name: string\n  description?: string\n  userPrompt?: string\n  category?: string\n  style?: \"realistic\" | \"anime\" | \"3d-pixar\" | \"illustration\"\n  sourceImageUrl?: string\n  provider?: string\n  /** Optional framing override (the same 4-value enum as `generateMotion`).\n   *  Absent = the image model's default. The studio's 360° surround path pins\n   *  `\"16:9\"` so every ring view matches the establishing shot's frame. */\n  aspectRatio?: CharacterAspectRatio\n  attachToLocationId?: string\n  attachToColumn?: LocationAttachColumn\n  attachName?: string\n  /**\n   * Credit-affecting quality tier (e.g. `\"high\"` for gpt-image). Values the\n   * chosen model doesn't support are ignored server-side, never rejected.\n   */\n  quality?: string\n  /**\n   * Credit-affecting output resolution (e.g. `\"2K\"` / `\"4K\"` / `\"2 MP\"`).\n   * Values the chosen model doesn't support are ignored server-side, never\n   * rejected.\n   */\n  resolution?: string\n}\n\n/**\n * Input for `client.locations.generateSurroundContinuation()` — fires the\n * `POST /v1/generate-surround-continuation` route. Generates one seamless 360°\n * ring view as an image-to-image continuation of `referenceImageUrl` (the\n * previous ring view, or the establishing shot for the first ring).\n *\n * The platform owns the whole pipeline: it builds the half-carry composite\n * server-side (carry the reference's trailing half into the new frame's leading\n * half per `direction`, gray the rest), paints the gray region, then\n * color-harmonizes the painted half to the carried half so there is no tonal\n * seam down the frame's center. The carried half stays pixel-exact, so a\n * panorama viewer stitching adjacent ring views stays geometrically seamless.\n *\n * When the studio path is set (`attachToLocationId` + `attachToColumn` +\n * `attachName`), the worker appends `{ name: attachName, url: <result> }` to the\n * location's bucket (studio uses `attachToColumn: \"angles\"`,\n * `attachName: \"Surround 45°\"`).\n */\nexport interface GenerateSurroundContinuationInput extends GenerationSessionParams {\n  /** The previous ring view to continue from (i2i anchor). */\n  referenceImageUrl: string\n  /** Carry/paint axis: turn right, turn left, tilt up, or tilt down. Tilts\n   *  render the sky/ground (a thin horizon strip), not a horizontal continuation. */\n  direction: SurroundDirection\n  /** Ring angle (45, 90, …) — stored on the result as metadata. */\n  degrees?: number\n  /** Fraction of the frame carried from the reference. Omitted ⇒ per-direction\n   *  default (0.5 for a pan, 0.12 thin strip for a tilt). */\n  carriedFraction?: number\n  /** Upscale/denoise the result before it's chained as the next reference, to\n   *  slow cumulative softening down a long ring chain. Default false. */\n  refine?: boolean\n  /** Refine model when `refine` is set. `recraft-upscale` (1 cr, default) or\n   *  `topaz-image-upscale` (3 cr). */\n  refineProvider?: \"recraft-upscale\" | \"topaz-image-upscale\"\n  /** Optional free-form scene hint woven into the fill prompt. */\n  userPrompt?: string\n  /** Image model. Defaults to the platform's general image model (`gpt-image-2`). */\n  provider?: string\n  /** Studio pins `\"16:9\"` so every ring view matches the establishing frame. */\n  aspectRatio?: CharacterAspectRatio\n  attachToLocationId?: string\n  attachToColumn?: LocationAttachColumn\n  attachName?: string\n}\n\n/**\n * Input for `client.locations.generateMotion()` — fires the\n * `POST /v1/generate-location-motion` route. Produces a single atmospheric\n * motion clip (drifting fog, snowfall, rolling waves, etc.) animated FROM a\n * static establishing-shot image.\n *\n * Mirrors `client.characters.generateMotion()` minus the character-specific\n * fields (gender / baseOutfit / realLifeRefs). The route hardcodes the attach\n * column to `atmosphere_motions` — callers supply `attachToLocationId` +\n * `attachName` only.\n *\n * `sourceImageUrl` is REQUIRED — image-to-video needs a source frame and the\n * route has no fallback (no `source_image_url` column to pull from on the\n * locations row; the studio path supplies the canonical establishing-shot URL\n * explicitly).\n *\n * When the studio path is set (`attachToLocationId` + `attachName`), the\n * worker appends `{ name: attachName, url: <result> }` to the location row's\n * `atmosphere_motions` JSONB column on completion.\n */\nexport interface GenerateLocationMotionInput extends GenerationSessionParams {\n  motionPrompt: string\n  sourceImageUrl: string\n  provider?: string\n  name: string\n  category?: string\n  style?: \"realistic\" | \"anime\" | \"3d-pixar\" | \"illustration\"\n  canonicalDescription?: string\n  attachToLocationId?: string\n  attachName?: string\n  /**\n   * Optional aspect ratio override. Defaults to 16:9 server-side via\n   * `resolveLocationAspectRatio` (locations are cinematic establishing shots).\n   * One of the 4-value `CharacterAspectRatio` union — locations reuse the\n   * character aspect enum since the supported ratios are identical.\n   */\n  aspectRatio?: CharacterAspectRatio\n}\n\nexport interface ApproveMainImageResult {\n  sourceImageUrl: string\n  /**\n   * LLM-authored caption. `null` when the LLM caption sub-failed — the wire\n   * sends `\"\"`, normalized to `null` here so consumers see the same\n   * `string | null` semantics as characters. The main image is still set; call\n   * `recaption()` to retry.\n   */\n  canonicalDescription: string | null\n}\n\nexport interface RecaptionLocationResult {\n  canonicalDescription: string\n}\n\nexport class LocationsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * List the caller's locations. By default returns active locations only;\n   * pass `archived: true` to fetch soft-deleted rows for an \"archive\" view,\n   * and `q` to keep the ones whose name or description contains it.\n   */\n  list(params: ListLocationsParams = {}): Promise<{ locations: Location[]; nextCursor?: string | null }> {\n    const query: Record<string, string | undefined> = {}\n    if (params.archived) query.archived = \"true\"\n    if (params.q) query.q = params.q\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/locations\", { query })\n  }\n\n  /**\n   * Convenience wrapper for `list({ archived: true })`. Returns soft-deleted\n   * rows so callers can drive a UI \"Archived\" tab without re-encoding the\n   * query param. Mirrors `ObjectsResource.listArchived`.\n   *\n   * `archived` is omitted from the param type — it's always set to `true` here.\n   */\n  listArchived(params: Omit<ListLocationsParams, \"archived\"> = {}): Promise<{ locations: Location[]; nextCursor?: string | null }> {\n    return this.list({ ...params, archived: true })\n  }\n\n  /**\n   * Fetch a single location including in-flight asset job state. Soft-deleted\n   * (archived) rows are returned by id intentionally so canvas nodes that\n   * hold a stale `locationDbId` keep loading.\n   */\n  async get(id: string): Promise<LocationDetail> {\n    const res = await this.client.request<LocationDetail>(\n      \"GET\",\n      `/v1/locations/${encodeURIComponent(id)}`,\n    )\n    // Normalize the wire `\"\"` caption (DB null / LLM sub-failure) → null so\n    // consumers see the same `string | null` semantics as characters. New\n    // object — never mutate the response.\n    return { ...res, canonicalDescription: res.canonicalDescription || null }\n  }\n\n  /**\n   * Create a new location. `name` + `nodeId` are required — the route 400s\n   * otherwise. Returns the new row's id.\n   *\n   * Note: the underlying route is the same `POST /v1/locations` upsert that\n   * powers `update()`. This convenience wrapper enforces the INSERT-required\n   * fields at the type level and never sends an `id`.\n   */\n  create(data: CreateLocationInput): Promise<{ id: string }> {\n    return this.client.request(\"POST\", \"/v1/locations\", { body: data })\n  }\n\n  /**\n   * Update a location. Only the fields you pass are written — undefined keys\n   * are NOT touched on the row. Worker-owned asset buckets are intentionally\n   * not exposed on this surface (see `UpdateLocationInput` for the rationale).\n   *\n   * Optimistic-concurrency: pass `expectedUpdatedAt` to require the row's\n   * `updated_at` still matches; on mismatch the route returns 409\n   * `concurrent_modification`. The SDK surfaces that as a generic\n   * `NodaroError` with the same code.\n   */\n  update(id: string, data: UpdateLocationInput): Promise<UpdateLocationResult> {\n    return this.client.request(\"POST\", \"/v1/locations\", {\n      body: { id, ...data },\n    })\n  }\n\n  /**\n   * Soft-delete (archive) a location. The row is hidden from `list()` by\n   * default but still loadable via `get(id)` so canvas nodes pointing at it\n   * keep working. Restore with `restore(id)`.\n   */\n  delete(id: string): Promise<{ success: true; archived: true }> {\n    return this.client.request(\"DELETE\", `/v1/locations/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Un-archive a location. If the original name now collides (case-\n   * insensitive) with an active row, the server auto-suffixes \"(restored)\"\n   * and returns the effective name.\n   */\n  restore(id: string): Promise<{ id: string; name: string }> {\n    return this.client.request(\"POST\", `/v1/locations/${encodeURIComponent(id)}/restore`)\n  }\n\n  /**\n   * Admin only: put one of your own locations on the shared Nodaro Keepers\n   * shelf (`client.keepers.catalog()`), or take it off. A first-party session\n   * or your personal token; `forbidden` for anyone who is not a platform\n   * admin, `not_found` for a row that is not yours.\n   */\n  setCatalog(id: string, input: SetKeeperCatalogInput): Promise<SetKeeperCatalogResult> {\n    return this.client.request(\"PUT\", `/v1/locations/${encodeURIComponent(id)}/catalog`, { body: input })\n  }\n\n  /**\n   * Fire `POST /v1/generate-location` to produce one or more candidate main\n   * images. With `count > 1`, all jobs are reserved up-front before any\n   * is enqueued — mid-batch failures roll back atomically.\n   *\n   * When `attachToLocationId` is set AND `count === 1`, the worker writes\n   * the result directly to the row's `source_image_url`; otherwise you must\n   * call `approveMainImage()` after picking a candidate.\n   */\n  async generate(data: GenerateLocationInput): Promise<GenerateLocationResult> {\n    const res = await this.client.request<{ jobId?: string; jobIds?: string[] }>(\n      \"POST\", \"/v1/generate-location\", { body: data },\n    )\n    // Tolerate the legacy `{ jobId }`-only shape (older server): synthesize jobIds.\n    const jobIds = res.jobIds ?? (res.jobId ? [res.jobId] : [])\n    return res.jobId ? { jobIds, jobId: res.jobId } : { jobIds }\n  }\n\n  /**\n   * Fire `POST /v1/generate-location-asset` to produce a single variant.\n   * When the studio path is set (`attachToLocationId` + `attachToColumn` +\n   * `attachName`), the worker appends `{ name: attachName, url: <result> }`\n   * to the named JSONB array column on completion.\n   */\n  generateAsset(data: GenerateLocationAssetInput): Promise<{ jobId: string }> {\n    return this.client.request(\"POST\", \"/v1/generate-location-asset\", { body: data })\n  }\n\n  /**\n   * Fire `POST /v1/generate-surround-continuation` to produce one seamless 360°\n   * ring view as an i2i continuation of `referenceImageUrl`. The platform builds\n   * the half-carry composite, paints the missing half, and color-harmonizes it\n   * to the carried half (no tonal seam; carried half stays pixel-exact). When the\n   * studio path is set, the worker appends the result to the location's bucket.\n   */\n  generateSurroundContinuation(data: GenerateSurroundContinuationInput): Promise<{ jobId: string }> {\n    return this.client.request(\"POST\", \"/v1/generate-surround-continuation\", { body: data })\n  }\n\n  /**\n   * Fire `POST /v1/generate-location-motion` to animate the location's\n   * establishing shot into an atmospheric motion clip. Image-to-video, single\n   * clip per call; the attach column is hardcoded to `atmosphere_motions`\n   * server-side (locations have a single motion bucket so the caller doesn't\n   * supply `attachToColumn`). When the studio path is set\n   * (`attachToLocationId` + `attachName`), the worker appends\n   * `{ name: attachName, url: <result> }` to the row's `atmosphere_motions`\n   * column on completion.\n   */\n  generateMotion(data: GenerateLocationMotionInput): Promise<{ jobId: string }> {\n    return this.client.request(\"POST\", \"/v1/generate-location-motion\", { body: data })\n  }\n\n  /**\n   * Atomically remove ONE asset take (every entry matching `url`) from a\n   * worker-owned bucket column — `POST /v1/locations/:id/remove-asset`. The\n   * worker-owned buckets are deliberately not writable through `update()`\n   * (a stale snapshot would race concurrent worker appends), so deleting a\n   * take — e.g. a 360° surround view being regenerated — goes through this\n   * single-statement server-side filter instead. 404s (`NotFoundError`) when\n   * the url isn't in that bucket or the location isn't yours.\n   */\n  removeAsset(\n    id: string,\n    data: { column: LocationAttachColumn; url: string },\n  ): Promise<{ removed: true }> {\n    return this.client.request(\n      \"POST\",\n      `/v1/locations/${encodeURIComponent(id)}/remove-asset`,\n      { body: data },\n    )\n  }\n\n  /**\n   * Approve a completed `generate-location` job as the location's main image.\n   * Sets `source_image_url` and fires the LLM caption (Claude Sonnet vision)\n   * inline. Returns the new main-image URL plus the caption.\n   *\n   * Caption-failure semantics: the route still sends `\"\"` on LLM sub-failure,\n   * but the SDK normalizes `\"\"` → `null` here so `canonicalDescription` carries\n   * the same `string | null` semantics as characters. The main image is still\n   * set; call `recaption()` to retry.\n   */\n  async approveMainImage(id: string, candidateJobId: string): Promise<ApproveMainImageResult> {\n    const res = await this.client.request<{ sourceImageUrl: string; canonicalDescription: string | null }>(\n      \"POST\",\n      `/v1/locations/${encodeURIComponent(id)}/approve-main-image`,\n      { body: { candidateJobId } },\n    )\n    // Normalize the wire `\"\"` (LLM sub-failure) → null; build a new object\n    // rather than mutating the response.\n    return { sourceImageUrl: res.sourceImageUrl, canonicalDescription: res.canonicalDescription || null }\n  }\n\n  /**\n   * Re-fire the LLM caption against the location's current main image. 502s\n   * on LLM failure (unlike `approveMainImage` which preserves the side-effect\n   * and returns \"\"); returns 400 `no_source_image` if no main image is set\n   * yet.\n   */\n  recaption(id: string): Promise<RecaptionLocationResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/locations/${encodeURIComponent(id)}/llm-caption`,\n    )\n  }\n}\n"]}

package/dist/chunk-MQWZFWHE.js

@@ -0,0 +1,45 @@
+// src/resources/keepers.ts
+var KEEPER_KINDS = ["character", "creature", "location", "object"];
+var KeepersResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * One page of the shelf. Public data: the same for every caller.
+   *
+   * ```ts
+   * const { data, next } = await client.keepers.catalog({ kind: "character" })
+   * ```
+   */
+  catalog(params = {}) {
+    const query = {};
+    if (params.kind) query.kind = params.kind;
+    if (params.cursor) query.cursor = params.cursor;
+    if (params.limit !== void 0) query.limit = String(params.limit);
+    return this.client.request("GET", "/v1/keepers/catalog", { query });
+  }
+  /**
+   * Use a shelf item: a copy of it in the caller's account — their own row,
+   * made like a community clone: the public text, the main image and the
+   * variant assets (every file copied into the caller's own storage and
+   * counted against it), a custom voice reduced to its name and sample,
+   * editable in Studio. Calling again returns the same copy
+   * (`created: false`). No credits. A 413 `storage_limit_exceeded` when the
+   * files do not fit the caller's storage; `ForbiddenError`
+   * `personal_space_disabled` when their organization closed the personal
+   * space.
+   *
+   * ```ts
+   * const { id } = await client.keepers.copy("character", item.id)
+   * const mine = await client.characters.get(id)
+   * ```
+   */
+  copy(kind, id) {
+    return this.client.request("POST", `/v1/keepers/catalog/${encodeURIComponent(kind)}/${encodeURIComponent(id)}/copy`);
+  }
+};
+
+export { KEEPER_KINDS, KeepersResource };
+//# sourceMappingURL=chunk-MQWZFWHE.js.map
+//# sourceMappingURL=chunk-MQWZFWHE.js.map

package/dist/chunk-MQWZFWHE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/keepers.ts"],"names":[],"mappings":";AAYO,IAAM,YAAA,GAAe,CAAC,WAAA,EAAa,UAAA,EAAY,YAAY,QAAQ;AA+DnE,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAA6B,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS7B,OAAA,CAAQ,MAAA,GAA8B,EAAC,EAA+B;AACpE,IAAA,MAAM,QAA4C,EAAC;AACnD,IAAA,IAAI,MAAA,CAAO,IAAA,EAAM,KAAA,CAAM,IAAA,GAAO,MAAA,CAAO,IAAA;AACrC,IAAA,IAAI,MAAA,CAAO,MAAA,EAAQ,KAAA,CAAM,MAAA,GAAS,MAAA,CAAO,MAAA;AACzC,IAAA,IAAI,OAAO,KAAA,KAAU,MAAA,QAAiB,KAAA,GAAQ,MAAA,CAAO,OAAO,KAAK,CAAA;AACjE,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,qBAAA,EAAuB,EAAE,OAAO,CAAA;AAAA,EACpE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,IAAA,CAAK,MAAkB,EAAA,EAAuC;AAC5D,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,CAAA,oBAAA,EAAuB,kBAAA,CAAmB,IAAI,CAAC,CAAA,CAAA,EAAI,kBAAA,CAAmB,EAAE,CAAC,CAAA,KAAA,CAAO,CAAA;AAAA,EACrH;AACF","file":"chunk-MQWZFWHE.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Nodaro Keepers — the shared catalog of characters, creatures, locations and\n * objects (`/v1/keepers/catalog`). An admin puts some of their own items on\n * the shelf; everyone browses it (the read takes no credential — a guest\n * sees it too); using one copies it into the caller's own account as a row\n * of their own, editable in Studio. The original is never changed, a later\n * change to it does not reach the copies, and taking it off the shelf\n * removes no copy. No credits for reading or copying.\n */\n\nexport const KEEPER_KINDS = [\"character\", \"creature\", \"location\", \"object\"] as const\nexport type KeeperKind = (typeof KEEPER_KINDS)[number]\n\n/** One item on the shelf — display fields only. */\nexport interface KeeperCatalogItem {\n  id: string\n  kind: KeeperKind\n  name: string\n  description: string | null\n  /** The main image, as stored. */\n  imageUrl: string\n  /** A 480px-wide copy of it for a tile (the image itself where the CDN does not resize). */\n  previewUrl: string\n  /** The shelf heading the admin filed it under, if any. */\n  category: string | null\n  /** The shelf order, lowest first. */\n  sort: number\n  createdAt: string\n}\n\nexport interface KeeperCatalogParams {\n  /** One kind only; omitted, the page runs through the kinds in `KEEPER_KINDS` order. */\n  kind?: KeeperKind\n  /** A previous page's `next`. */\n  cursor?: string\n  /** 1–200, default 50. */\n  limit?: number\n}\n\nexport interface KeeperCatalogPage {\n  data: KeeperCatalogItem[]\n  /** The next page's cursor, or null on the last page. */\n  next: string | null\n}\n\n/** The caller's own copy of a shelf item. */\nexport interface CopyKeeperResult {\n  /** The id of the caller's row — `client.characters.get(id)` and the others read it. */\n  id: string\n  name: string\n  kind: KeeperKind\n  /** `false` when the caller already had a copy of this item: that copy is returned, no second one is made. */\n  created: boolean\n}\n\n/** `client.<kind>.setCatalog(id, input)` — admin only, on the admin's own rows. */\nexport interface SetKeeperCatalogInput {\n  /** On the shelf, or not. */\n  catalog: boolean\n  /** The shelf order, lowest first (default 0). */\n  sort?: number\n  /** A shelf heading; `null` clears it. */\n  category?: string | null\n}\n\nexport interface SetKeeperCatalogResult {\n  id: string\n  kind: KeeperKind\n  catalog: boolean\n  sort: number\n  category: string | null\n}\n\nexport class KeepersResource {\n  constructor(private readonly client: NodaroClientCore) {}\n\n  /**\n   * One page of the shelf. Public data: the same for every caller.\n   *\n   * ```ts\n   * const { data, next } = await client.keepers.catalog({ kind: \"character\" })\n   * ```\n   */\n  catalog(params: KeeperCatalogParams = {}): Promise<KeeperCatalogPage> {\n    const query: Record<string, string | undefined> = {}\n    if (params.kind) query.kind = params.kind\n    if (params.cursor) query.cursor = params.cursor\n    if (params.limit !== undefined) query.limit = String(params.limit)\n    return this.client.request(\"GET\", \"/v1/keepers/catalog\", { query })\n  }\n\n  /**\n   * Use a shelf item: a copy of it in the caller's account — their own row,\n   * made like a community clone: the public text, the main image and the\n   * variant assets (every file copied into the caller's own storage and\n   * counted against it), a custom voice reduced to its name and sample,\n   * editable in Studio. Calling again returns the same copy\n   * (`created: false`). No credits. A 413 `storage_limit_exceeded` when the\n   * files do not fit the caller's storage; `ForbiddenError`\n   * `personal_space_disabled` when their organization closed the personal\n   * space.\n   *\n   * ```ts\n   * const { id } = await client.keepers.copy(\"character\", item.id)\n   * const mine = await client.characters.get(id)\n   * ```\n   */\n  copy(kind: KeeperKind, id: string): Promise<CopyKeeperResult> {\n    return this.client.request(\"POST\", `/v1/keepers/catalog/${encodeURIComponent(kind)}/${encodeURIComponent(id)}/copy`)\n  }\n}\n"]}

package/dist/chunk-NQF6UKND.cjs

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

package/dist/chunk-NQF6UKND.cjs.map

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

package/dist/{chunk-NWMO4MHE.cjs → chunk-PDX742CC.cjs}

@@ -100,5 +100,5 @@ var TrendsResource = class {
 };
 
 exports.TrendsResource = TrendsResource;
-//# sourceMappingURL=chunk-NWMO4MHE.cjs.map
-//# sourceMappingURL=chunk-NWMO4MHE.cjs.map
+//# sourceMappingURL=chunk-PDX742CC.cjs.map
+//# sourceMappingURL=chunk-PDX742CC.cjs.map