@nodaro/sdk 2.43.0 → 2.45.1

package/dist/chunk-DQAYIVVS.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/media.ts"],"names":[],"mappings":"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","file":"chunk-DQAYIVVS.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport { readSseStream } from \"../sse.js\"\nimport type { OverlayAnchor, VideoMaskRequest, MaskCompositeRequest } from \"@nodaro/shared/media\"\nimport type { CaptionStyle, CaptionLookId, SupportedFontName } from \"@nodaro/shared/captions\"\nimport type { TranscribeLane } from \"@nodaro/shared/models\"\nimport type { VideoOverlayRequest } from \"@nodaro/shared/video\"\n\n/** One word-timed caption entry (one per WORD for the kinetic styles). */\nexport interface CaptionEntry {\n  text: string\n  startMs: number\n  endMs: number\n  timestampMs?: number | null\n  confidence?: number | null\n}\n\n/** Look + motion levers — see {@link MediaResource.addCaptions}. `look` is a\n *  named preset the explicit levers override; an unset look renders as `outline`\n *  (the default). The STYLING levers (`look`, `fontFamily`, `fontWeight`,\n *  `strokeColor`/`strokeWidth`, `uppercase`, `positionY`, `maxWordsPerLine`) now\n *  apply to the static `subtitle` style too — a subtitle carrying any of them\n *  renders via Remotion. Only `highlightColor` (no spoken-word cursor to colour)\n *  and `animate` (no motion to freeze) stay kinetic-only and are rejected (400)\n *  on `subtitle`. */\nexport interface CaptionLookInput {\n  look?: CaptionLookId\n  fontFamily?: SupportedFontName\n  fontWeight?: number\n  strokeColor?: string\n  strokeWidth?: number\n  highlightColor?: string\n  uppercase?: boolean\n  positionY?: number\n  /** Cap on how many words one caption LINE (or `tiktok-words` page) may hold,\n   *  1-20, on TOP of the frame-width budget, sentence ends and pauses that\n   *  already close a line — 1-2 gives the punchy CapCut read, unset fits the\n   *  width. Applies to `word-highlight` / `karaoke` / `bouncy` / `tiktok-words`\n   *  and to a Remotion-rendered `subtitle`; inert on `word-pop` (always one\n   *  word). */\n  maxWordsPerLine?: number\n  /** Kinetic styles only. `false` freezes the per-word MOTION — the grouping,\n   *  line-holding and spoken-word highlight stay, only the movement stops;\n   *  default `true`. Rejected (400) on the static `subtitle` style. */\n  animate?: boolean\n}\n\n/** One caption SEGMENT: a time range with optional style/look overrides and its\n *  own words (`text`/`captions`, else the shared transcript filtered to range).\n *  A segmented render is entirely Remotion, so any `style` is valid here. */\nexport interface CaptionSegmentInput extends CaptionLookInput {\n  startMs: number\n  endMs: number\n  style?: CaptionStyle\n  position?: \"bottom\" | \"top\" | \"center\"\n  fontSize?: number\n  color?: string\n  backgroundColor?: string\n  text?: string\n  captions?: CaptionEntry[]\n}\n\n/** {@link MediaResource.addCaptions} input. */\nexport interface AddCaptionsInput extends CaptionLookInput {\n  videoUrl: string\n  text?: string\n  captions?: CaptionEntry[]\n  /** Transcribe the video's audio when no text/captions are given (default true). */\n  autoTranscribe?: boolean\n  transcribeProvider?: TranscribeLane\n  style?: CaptionStyle\n  position?: \"bottom\" | \"top\" | \"center\"\n  fontSize?: number\n  color?: string\n  backgroundColor?: string\n  /** Apply different treatments to time ranges in one call (non-overlapping). */\n  segments?: CaptionSegmentInput[]\n}\n\n/**\n * Media ingestion + trimming — the source-preparation steps a Voice Changer Pro\n * flow (or any pipeline) needs before it has a clip to work on: pull a social\n * video into storage, copy a remote URL into storage, trim a video/audio to a\n * range, and probe a video's metadata. Each generation-style op returns a job id\n * to poll (`jobs.get(jobId)`); `videoMetadata` is a direct read.\n */\n/**\n * Where one overlay layer should go, in {@link MediaResource.imageOverlay}'s\n * percent units — the answer from {@link MediaResource.suggestOverlayPlacement}.\n */\nexport interface OverlayPlacement {\n  /** The point on the base image the layer attaches to. */\n  anchor: OverlayAnchor\n  /** Offset from the anchor in % of the base width (negative on a right anchor = inward). */\n  x: number\n  /** Offset from the anchor in % of the base height (negative on a bottom anchor = inward). */\n  y: number\n  /** The layer's width in % of the base width. */\n  width: number\n  /** One sentence, plain language, on why this spot. */\n  reason: string\n}\n\nexport class MediaResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Download a social video (YouTube / TikTok / Instagram / X / Facebook) into\n   * your storage (`POST /v1/download-video`). `maxHeight` caps the resolution\n   * (default \"best\"); `sectionStartSec` + `sectionEndSec` (both-or-neither) fetch\n   * ONLY that time range instead of the whole video. A download that arrives\n   * with no audio stream FAILS by default (it is usually a degraded source\n   * response, and is retried through other routes first); pass\n   * `requireAudio: false` to accept a clip that really has no sound. Returns a\n   * `downloadId`; progress streams from\n   * `GET /v1/download-video/progress/:downloadId` (server-sent events) and the\n   * finished file lands in your library.\n   */\n  downloadVideo(input: {\n    url: string\n    maxHeight?: number\n    sectionStartSec?: number\n    sectionEndSec?: number\n    requireAudio?: boolean\n  }): Promise<{ downloadId: string }> {\n    return this.client.request<{ downloadId: string }>(\"POST\", \"/v1/download-video\", { body: input })\n  }\n\n  /**\n   * Stream the live progress of a {@link MediaResource.downloadVideo} import\n   * (`GET /v1/download-video/progress/:downloadId`, server-sent events) as an\n   * async iterable. Yields a {@link DownloadVideoProgress} roughly every 500ms\n   * until the download reaches `completed` (its event carries the stored\n   * `videoUrl`) or `failed` (its event carries `error`), then ends. The progress\n   * state expires server-side shortly after the download starts existing, so\n   * start iterating promptly after `downloadVideo` returns.\n   *\n   * No request timeout is applied (a large import legitimately takes minutes) —\n   * pass an `AbortSignal` to cancel from the caller.\n   */\n  async *downloadVideoProgress(\n    downloadId: string,\n    opts: { signal?: AbortSignal } = {},\n  ): AsyncGenerator<DownloadVideoProgress, void, undefined> {\n    const url = `${this.client.baseUrl}/v1/download-video/progress/${encodeURIComponent(downloadId)}`\n    const token = await this.client.auth.getToken()\n    const res = await this.client.fetch(url, {\n      headers: token ? { Authorization: `Bearer ${token}` } : {},\n      signal: opts.signal,\n    })\n    // The shared reader owns the non-OK throw, the empty-body guard, the frame\n    // parse and the cancel-on-early-exit — this route emits the same\n    // `data: <json>` frames every other stream here does.\n    yield* readSseStream<DownloadVideoProgress>(res, { label: \"progress stream\" })\n  }\n\n  /**\n   * Copy an external media URL into your Nodaro storage (`POST /v1/save-to-storage`)\n   * — a server-side fetch, so nothing round-trips through the client. Poll\n   * `jobs.get(jobId)`.\n   */\n  saveToStorage(input: { mediaUrl: string; filename?: string; mediaType?: \"image\" | \"video\" | \"audio\" }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/save-to-storage\", { body: input })\n  }\n\n  /**\n   * Composite 2–30 images into ONE large 2K/4K collage (`POST /v1/image-collage`).\n   * `layout` `\"smart\"` (default — justified rows at each image's exact aspect\n   * ratio, no cropping; the output height floats) or `\"grid\"` (uniform,\n   * letterboxed cells). `imageSizes` is index-aligned with `imageUrls` and\n   * gives per-image RELATIVE size hints for the smart layout: `0` auto\n   * (\"don't care\", default), `1` big (~2× linear vs medium), `2` medium,\n   * `3` small (~½ linear). All-equal hints change nothing; grid ignores them.\n   * For storyboards, set `numbered` to stamp a 1-based sequence badge at each\n   * image's corner (top-left by default; `badgePosition: \"top-right\"` moves it;\n   * in `imageUrls` order) and pass `imageLabels`\n   * (index-aligned with `imageUrls`; `null`/`\"\"`/omitted = no caption for that\n   * image) to caption images after the number, e.g. `3 · Close-up`. Badges are\n   * an overlay only — they never change the layout, the output size or the\n   * credit cost. Poll `jobs.get(jobId)` for the finished image.\n   */\n  imageCollage(input: {\n    imageUrls: string[]\n    imageSizes?: Array<0 | 1 | 2 | 3>\n    numbered?: boolean\n    imageLabels?: Array<string | null>\n    /** Corner the badges sit in — `\"top-left\"` (default, storyboard convention) or `\"top-right\"`. */\n    badgePosition?: \"top-left\" | \"top-right\"\n    layout?: \"smart\" | \"grid\"\n    resolution?: \"2K\" | \"4K\"\n    aspectRatio?: string\n    gap?: number\n    backgroundColor?: string\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/image-collage\", { body: input })\n  }\n\n  /**\n   * Place 1–12 layers — pictures, real text, QR codes, shapes — on a base image,\n   * pixel-exactly (`POST /v1/image-overlay`) — local, deterministic, no AI.\n   * Every layer position/size is a PERCENT of the base image: `anchor` (nine\n   * positions, default `\"center\"`), `x`/`y` (offset from the anchor in % of\n   * the base width/height; negative on a right/bottom anchor moves inward),\n   * `width` (% of the base width, default 25 — height follows the layer's\n   * aspect unless `height` is set). Plus `opacity` (0..1), `rotation`\n   * (degrees), `blend` (`\"over\"` | `\"multiply\"` | `\"screen\"`), `fit`,\n   * `shadow` and `roundedCorners`. The output keeps the base's pixel size\n   * unless `canvas` is set. Flat credit cost. Poll `jobs.get(jobId)` for the\n   * finished image.\n   */\n  imageOverlay(input: {\n    imageUrl: string\n    layers: Array<{\n      imageUrl: string\n      anchor?: OverlayAnchor\n      x?: number\n      y?: number\n      width?: number\n      height?: number\n      opacity?: number\n      rotation?: number\n      blend?: \"over\" | \"multiply\" | \"screen\"\n      fit?: \"contain\" | \"cover\" | \"stretch\"\n      shadow?: { blur: number; offsetX: number; offsetY: number; color: string; opacity: number }\n      roundedCorners?: number\n      zIndex?: number\n      /** \"image\" (default, needs imageUrl) | \"text\" | \"qr\" | \"shape\" — see @nodaro/shared image-overlay-layers. */\n      kind?: \"image\" | \"text\" | \"qr\" | \"shape\"\n      text?: Record<string, unknown>\n      qr?: Record<string, unknown>\n      shape?: Record<string, unknown>\n      effects?: Record<string, unknown>\n    }>\n    canvas?: { width: number; height: number; backgroundColor?: string }\n    baseFit?: \"contain\" | \"cover\"\n    outputFormat?: \"png\" | \"jpg\" | \"webp\"\n    /** Extra platform renders (see OVERLAY_PLATFORMS in @nodaro/shared); returned as output `variants[]`. */\n    variants?: string[]\n    /** The mask the job also emits as output `maskUrl` (white = may change). Default \"around\". */\n    maskMode?: \"none\" | \"layers\" | \"around\" | \"outside\"\n    maskSpread?: number\n    /** Fills every QR layer whose `qr.fromInput` is true — the node's QR link handle. */\n    qrText?: string\n  }): Promise<{ jobId: string }> {\n    // The finished job's output: { imageUrl, width, height, maskUrl?, variants?: [{ id, label, width, height, url }] }.\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/image-overlay\", { body: input })\n  }\n\n  /**\n   * Ask a vision model WHERE one overlay layer should sit on a base image\n   * (`POST /v1/image-overlay/suggest-placement`) — it reads the picture and\n   * keeps the element off the faces, the subject and the busiest texture.\n   * The answer comes back in {@link MediaResource.imageOverlay}'s own percent\n   * units — `anchor`, `x`/`y` offsets, `width` — so it drops straight onto a\n   * layer (`const { reason, ...box } = placement`), plus a one-sentence\n   * `reason` you can show a user. Nothing is composited here: apply the\n   * placement yourself.\n   *\n   * `layerAspect` is the element's width / height (1 = square, the default) so\n   * the proposed box stays in proportion; `intent` says what the element is\n   * (\"a logo\", \"a price badge\"); `safeArea` is the always-visible region as\n   * fractions of the canvas (a platform preset's safe area), which the\n   * placement is kept inside. Unlike the other media calls this one answers\n   * synchronously — there is nothing to poll; `jobId` is the billing record\n   * (one image-to-text call).\n   */\n  suggestOverlayPlacement(input: {\n    imageUrl: string\n    layerAspect?: number\n    intent?: string\n    safeArea?: { x: number; y: number; w: number; h: number }\n    llmModel?: string\n  }): Promise<{ jobId: string; placement: OverlayPlacement }> {\n    return this.client.request<{ jobId: string; placement: OverlayPlacement }>(\n      \"POST\",\n      \"/v1/image-overlay/suggest-placement\",\n      { body: input },\n    )\n  }\n\n  /**\n   * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever\n   * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or\n   * `keepFirst`/`keepLastSeconds`. Poll `jobs.get(jobId)`.\n   */\n  trimVideo(input: {\n    videoUrl: string\n    startTime?: number\n    endTime?: number\n    trimStartFrames?: number\n    trimEndFrames?: number\n    trimStartSeconds?: number\n    trimEndSeconds?: number\n    keepFirstSeconds?: number\n    keepLastSeconds?: number\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/trim-video\", { body: input })\n  }\n\n  /**\n   * Burn captions into a video (`POST /v1/add-captions`). Give the words as\n   * `text`, word-timed `captions[]`, or let it transcribe (`autoTranscribe`,\n   * the default when neither is set).\n   *\n   * `style: \"subtitle\"` renders statically (FFmpeg) UNLESS it carries a styling\n   * lever, in which case it — like the KINETIC styles (`word-highlight` /\n   * `karaoke` / `tiktok-words` / `word-pop` / `bouncy`) — renders via Remotion.\n   * `look` picks a preset — `outline` (Montserrat 900, UPPERCASE, black outline,\n   * yellow spoken word — the TikTok/Reels read) or `clean`; an UNSET look renders\n   * as `outline`. The explicit STYLING levers (`fontFamily`, `fontWeight`,\n   * `strokeColor`/`strokeWidth`, `uppercase`, `positionY`, `maxWordsPerLine`)\n   * override individual fields of it and now apply to `subtitle` too. Only\n   * `highlightColor` (the spoken-word cursor) and `animate` stay kinetic-only\n   * and are REJECTED on `subtitle`.\n   *\n   * `animate` (default true) freezes the per-word MOTION on the kinetic styles\n   * when set to false — the grouping, line-holding and spoken-word highlight\n   * stay; only the movement stops.\n   *\n   * `maxWordsPerLine` (1-20) caps how many words a line — or a `tiktok-words`\n   * page — may hold, on top of the width budget / sentence ends / pauses that\n   * already close one; it is inert on `word-pop`, which is always one word.\n   * Like every lever here it exists top-level AND per segment, and a segment\n   * that does not name its own inherits the top-level value.\n   *\n   * `segments[]` applies DIFFERENT treatments to non-overlapping time ranges in\n   * one call (e.g. a large top intro, then a small bottom body); a segment that\n   * names its own `look` starts fresh from that preset and does not inherit the\n   * top-level explicit levers. Poll `jobs.get(jobId)`.\n   *\n   * `word-highlight` shows ONE held line at a time and a word's\n   * `startMs`/`endMs` is its SPOKEN window (what times the highlight, not how\n   * long the text is on screen) — so `captions[]` can be handed over verbatim\n   * from an `audio.transcribe()` job's `output_data.words`, with\n   * `autoTranscribe: false`.\n   */\n  addCaptions(input: AddCaptionsInput): Promise<{ jobId: string }> {\n    const { autoTranscribe, transcribeProvider, ...rest } = input\n    // The route body is camelCase except these two flags (worker snake_case);\n    // omit each when unset so an absent flag stays absent on the wire.\n    const body: Record<string, unknown> = {\n      ...rest,\n      ...(autoTranscribe !== undefined ? { auto_transcribe: autoTranscribe } : {}),\n      ...(transcribeProvider !== undefined ? { transcribe_provider: transcribeProvider } : {}),\n    }\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/add-captions\", { body })\n  }\n\n  /**\n   * Trim (and extract) audio from a video or audio source\n   * (`POST /v1/trim-audio`) to `[startTime, endTime]` seconds, in `audioFormat`\n   * (`mp3` default / `wav` / `aac`). Poll `jobs.get(jobId)`.\n   */\n  trimAudio(input: {\n    videoUrl?: string\n    audioUrl?: string\n    audioFormat?: \"mp3\" | \"wav\" | \"aac\"\n    startTime?: number\n    endTime?: number\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/trim-audio\", { body: input })\n  }\n\n  /**\n   * Cut a video and/or an audio file into consecutive parts\n   * (`POST /v1/split-media`). Every part is at most `chunkDuration` seconds and\n   * at least `minPartDuration` (default 4, never above `chunkDuration`) — a\n   * short leftover is evened out with the parts before it. Video is cut on\n   * whole frames with each part's sound matching its picture; audio parts are\n   * sample-exact, in `audioFormat` (`mp3` default / `wav` / `aac`). With both\n   * sources each is split on its own. At most 200 parts per input. Poll\n   * `jobs.get(jobId)`; the parts are on the completed job's `output_data` —\n   * see {@link SplitMediaOutput}.\n   */\n  splitMedia(input: SplitMediaInput): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/split-media\", { body: input })\n  }\n\n  /**\n   * Turn one still image + one audio track into an MP4\n   * (`POST /v1/still-to-video`) — locally rendered (FFmpeg), no AI model,\n   * zero credits. The output duration IS the audio's duration; there is no\n   * duration field. Optional `motion` animates the still (zoom / pan /\n   * ken-burns) at `intensity` 1–10. `fit: \"contain\"` letterboxes with\n   * `padColor` instead of cropping. Poll `jobs.get(jobId)`.\n   */\n  stillToVideo(input: {\n    imageUrl: string\n    audioUrl: string\n    motion?: \"none\" | \"zoom-in\" | \"zoom-out\" | \"pan-left\" | \"pan-right\" | \"ken-burns\"\n    intensity?: number\n    resolution?: \"720p\" | \"1080p\" | \"4K\"\n    aspectRatio?: \"16:9\" | \"9:16\" | \"1:1\" | \"4:3\"\n    fps?: 24 | 30\n    fit?: \"cover\" | \"contain\"\n    padColor?: string\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/still-to-video\", { body: input })\n  }\n\n  /**\n   * Turn 2–100 images + one optional audio track into an MP4 slideshow\n   * (`POST /v1/slideshow`) — locally rendered (FFmpeg), zero credits. With\n   * audio, the output duration IS the audio's duration (equal split unless\n   * `imageDurations` pins rows — null entries = auto; mismatched pinned sums\n   * scale proportionally and the factor is disclosed in the job output).\n   * Without audio: N × `perImageDuration`, silent output. Transitions\n   * consume the outgoing slide, so totals stay exact. For a single image use\n   * `stillToVideo`. Poll `jobs.get(jobId)`.\n   */\n  slideshow(input: {\n    imageUrls: string[]\n    audioUrl?: string\n    imageDurations?: Array<number | null>\n    perImageDuration?: number\n    transition?: string\n    transitionDuration?: number\n    motion?: \"none\" | \"zoom-in\" | \"zoom-out\" | \"ken-burns\" | \"alternate\"\n    intensity?: number\n    resolution?: \"720p\" | \"1080p\" | \"4K\"\n    aspectRatio?: \"16:9\" | \"9:16\" | \"1:1\" | \"4:3\"\n    fps?: 24 | 30\n    fit?: \"cover\" | \"contain\"\n    padColor?: string\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/slideshow\", { body: input })\n  }\n\n  /**\n   * Place 1–20 timed image layers over a video (`POST /v1/video-overlay`) —\n   * rendered locally (FFmpeg) in one pass, no AI; the base audio is kept\n   * untouched. Each layer has an `imageUrl`, a `start` and an optional `end`\n   * in seconds (no `end` = to the end of the video) and a placement: a\n   * `preset` (`\"card\"`, `\"corner-badge\"` with a `corner`, `\"full-frame\"`) or\n   * an explicit box in {@link MediaResource.imageOverlay}'s percent vocabulary\n   * (`anchor`, `x`, `y`, `width`, `height`, `fit`) — an explicit box field\n   * overrides the preset, and a layer with neither is a corner badge\n   * (bottom-right, or the `corner` it names). `outputAspect` renders onto a\n   * 16:9 / 9:16 / 1:1 / 4:5 canvas\n   * (`baseFit` cover by default; `backgroundColor` pads `contain`). Poll\n   * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`, `width`,\n   * `height`, `durationSec` and `warnings[]` (a layer clipped or skipped at the\n   * video's end, an animated image's first frame, re-encoded audio).\n   */\n  videoOverlay(input: VideoOverlayRequest): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/video-overlay\", { body: input })\n  }\n\n  /**\n   * Track a subject described in plain text through a video and get a\n   * black-and-white MASK VIDEO back (`POST /v1/video-mask`, SAM 3.1 by default,\n   * or `provider: \"sam-3\"` at half the price) — white = the subject. Clips up\n   * to 5 minutes at 30 fps (a faster clip counts\n   * proportionally longer), priced by the clip's length. Poll\n   * `jobs.get(jobId)`: the output carries `videoUrl` (the mask), `width`,\n   * `height`, `frames`, `coverage` (the fraction of pixels selected, rounded\n   * to 4 decimals) and `kept` (any region left on any frame: false only when\n   * the size / zone filters left an empty mask — read it rather than\n   * `coverage`, which a few pixels round to 0). Feed the mask to\n   * {@link MediaResource.maskComposite}.\n   *\n   * `holdLastMask: true` keeps the last mask on frames where the subject is\n   * lost (a mask covering under 0.002 % of the frame, e.g. a face behind a\n   * hand): each such frame after the first detection repeats the most recent\n   * non-empty one; the output then also carries `heldFrames`.\n   * `minSubjectHeightPct` (0–100, default 0 = off) drops every connected\n   * region whose bounding box is shorter than that % of the frame height\n   * (extras' small faces behind the main subject); it runs before\n   * `holdLastMask`, and the output then carries `droppedRegions`.\n   * `maxSubjectHeightPct` (0–100, default 0 = off) is its mirror: it drops\n   * regions TALLER than that % (keep only the small background faces). With\n   * both set a region is kept when min ≤ height ≤ max; min > max is a 400.\n   * `zone` (`{ leftPct, rightPct, topPct, bottomPct }`, each 0–49 % of the\n   * frame, a margin left out = 0; default null = off) keeps only the regions\n   * whose bounding-box centre lies inside the frame minus those margins (after\n   * the size cuts, before `holdLastMask`). `perShot: true` finds the clip's\n   * scene cuts first and segments each shot on its own: the subject is\n   * detected again after every cut, `holdLastMask` never crosses a cut, and\n   * each shot's mask is fitted to that shot's exact frame count; on a clip\n   * with no cut it gives the same mask, fitted to the clip's exact frame\n   * count. The output carries `shots` (1 when off).\n   */\n  videoMask(input: VideoMaskRequest): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/video-mask\", { body: input })\n  }\n\n  /**\n   * Place a foreground video over a background video through a mask video\n   * (`POST /v1/mask-composite`; white = foreground) — local FFmpeg, no AI.\n   * The result follows the foreground's size, frame rate and length; the\n   * background is fitted (`backgroundFit`, default cover) and loops when\n   * shorter; the mask holds its last frame when shorter. Optional\n   * `invertMask`, `feather` (0–20 px), `grow` (−10–10 px), `opacity` (0–1,\n   * default 1: how strongly the foreground covers the background inside the\n   * mask) and `audioSource` (foreground / background / mix / none). Priced per started 5 seconds of\n   * the result (the video it follows up to 300 s). Poll `jobs.get(jobId)` for `videoUrl`.\n   *\n   * `fill` picks what fills the masked area: `video` (default — the\n   * foreground, required then), `pixelate` (the background itself in\n   * blocks of `pixelSizePct` % of the frame width, 0.2–10, default 1.25) or\n   * `blur` (the background blurred, sigma `blurStrengthPct` % of the frame\n   * width, 0.1–5, default 2). Pixelate and blur take no\n   * `foregroundUrl` (one sent is ignored): the result follows the background\n   * and is priced on its length, and it always carries the background's sound\n   * (`audioSource` is ignored).\n   */\n  maskComposite(input: MaskCompositeRequest): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/mask-composite\", { body: input })\n  }\n\n  /**\n   * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,\n   * dimensions, title, live status — WITHOUT downloading it. A direct read, not a\n   * job. Use it to decide whether to trim before importing.\n   */\n  videoMetadata(input: { url: string }): Promise<VideoMetadata> {\n    return this.client.request<VideoMetadata>(\"POST\", \"/v1/video-metadata\", { body: input })\n  }\n\n  /**\n   * Cut or crop a stored file (`POST /v1/media/process`) — synchronous and\n   * free, the source-preparation sibling of the priced `trimVideo` node.\n   * `trim` is `[startTime, endTime]` in seconds; `deleteSource: true` removes\n   * the source object afterwards when it is yours and nothing else references\n   * it (\"the cut replaces the original\"). Answers the stored file.\n   */\n  process(input: MediaProcessInput): Promise<{ data: MediaProcessResult }> {\n    return this.client.request<{ data: MediaProcessResult }>(\"POST\", \"/v1/media/process\", { body: input })\n  }\n}\n\n/**\n * One event from {@link MediaResource.downloadVideoProgress}. The stream ends\n * after a `completed` event (which carries the stored `videoUrl` + an optional\n * `thumbnailUrl`) or a `failed` event (which carries `error`).\n */\nexport interface DownloadVideoProgress {\n  phase: \"downloading\" | \"processing\" | \"uploading\" | \"completed\" | \"failed\"\n  /** Download percent (0–100). Section fetches report jumpy percents — display, don't sum. */\n  percent: number\n  /** The imported video's storage URL — set on the `completed` event. */\n  videoUrl?: string\n  /** Thumbnail storage URL — set on the `completed` event when one was captured. */\n  thumbnailUrl?: string\n  /** What went wrong — set on the `failed` event. */\n  error?: string\n}\n\n/** Result of {@link MediaResource.videoMetadata}. Fields are best-effort — a probe may omit some. */\nexport interface VideoMetadata {\n  durationSec?: number | null\n  width?: number | null\n  height?: number | null\n  title?: string | null\n  isLive?: boolean\n  [key: string]: unknown\n}\n\n/** Body of {@link MediaResource.splitMedia} (`POST /v1/split-media`). At least one of `videoUrl` / `audioUrl`. */\nexport interface SplitMediaInput {\n  /** Video to split. */\n  videoUrl?: string\n  /** Audio file to split (split on its own when a video is given too). */\n  audioUrl?: string\n  /** The longest a part may be, in seconds (at least 1). Every part is at most this long. */\n  chunkDuration: number\n  /** The shortest a part may be, in seconds (0 or more, default 4). Must not exceed `chunkDuration` (400 otherwise). */\n  minPartDuration?: number\n  /** Format of the audio parts. Default `mp3`. */\n  audioFormat?: \"mp3\" | \"wav\" | \"aac\"\n}\n\n/** A completed split-media job's `output_data`. */\nexport interface SplitMediaOutput {\n  /** The video parts, in order (when a video was split). */\n  videoUrls?: string[]\n  /** The audio parts, in order (when an audio file was split). */\n  audioUrls?: string[]\n  /** The number of parts — the larger of the two lists. */\n  chunkCount: number\n  /** Each part's exact length in seconds: the video parts' when a video was split, else the audio parts'. */\n  partDurationsSec?: number[]\n  /** The audio parts' lengths, only when BOTH a video and an audio file were split. */\n  audioPartDurationsSec?: number[]\n}\n\nexport interface MediaProcessInput {\n  sourceUrl: string\n  type: \"video\" | \"audio\"\n  trim?: { startTime: number; endTime: number }\n  crop?: { x: number; y: number; width: number; height: number }\n  format?: \"mp4\" | \"webm\" | \"mp3\" | \"wav\" | \"m4a\" | \"aac\"\n  deleteSource?: boolean\n}\n\nexport interface MediaProcessResult {\n  url: string\n  thumbnailUrl: string | null\n  assetId: string | null\n  sizeBytes: number\n  mimeType: string\n  metadata: Record<string, unknown>\n}\n"]}

package/dist/chunk-EK672FFM.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/templates.ts"],"names":[],"mappings":";;;AA4GO,IAAM,oBAAN,MAAwB;AAAA,EAC7B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,MAAA,CAAO,MAAA,GAAgC,EAAC,EAAmC;AACzE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,sBAAA,EAAwB,EAAE,KAAA,EAAO,EAAE,GAAG,MAAA,EAAO,EAAG,CAAA;AAAA,EACpF;AAAA;AAAA,EAGA,IAAI,IAAA,EAAiC;AACnC,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,KAAA,EAAO,iBAAiB,kBAAA,CAAmB,IAAI,CAAC,CAAA,CAAE,CAAA;AAAA,EAC/E;AAAA;AAAA,EAGA,KAAA,CAAM,MAAc,MAAA,EAA2D;AAC7E,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,MAAA,EAAQ,iBAAiB,kBAAA,CAAmB,IAAI,CAAC,CAAA,MAAA,CAAA,EAAU;AAAA,MACpF,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AACF","file":"chunk-EK672FFM.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Workflow-template marketplace — the PUBLIC-BY-DESIGN surfaces only:\n * browse cards, a single template with its full snapshot, and the free\n * clone-into-my-project action. Creator/admin surfaces (publish, mine,\n * favorites, metadata patch, tutorial flags) are deliberately NOT part of\n * the public SDK contract; first-party apps reach them via\n * `client.request()`.\n */\n\n/** Card returned by the marketplace browse (no snapshot payload). */\nexport interface TemplateBrowseCard {\n  id: string\n  slug: string\n  name: string\n  description: string | null\n  /** The listed price; when `estimatedPerMinuteCredits` is above 0, its fixed part. */\n  estimatedCredits: number\n  /** The listed price holds a metered LLM call's ESTIMATE (its model's typical\n   *  call, charged its actual usage per token): show it `~N`. Absent for a\n   *  fixed price, and on a deployment running the tier-pricing rollback. */\n  estimatedCreditsIsEstimate?: true\n  /**\n   * Credits per minute of the recording the template is given, when its price\n   * follows that recording's length (an Apply EDL render of a whole episode,\n   * an Edit Plan pass): the price is `estimatedCredits` plus this per minute.\n   * 0 or absent when the price does not depend on a recording's length.\n   */\n  estimatedPerMinuteCredits?: number\n  /**\n   * The listed price is a range: `estimatedCredits` / `estimatedPerMinuteCredits`\n   * are \"from\" (the saved settings), these \"up to\" — the most a run can cost over\n   * the template's exposed fields. Present only when they differ from \"from\".\n   */\n  maxEstimatedCredits?: number\n  maxEstimatedPerMinuteCredits?: number\n  category: string\n  outputTypes: string[]\n  tags: string[]\n  nodeTypesUsed: string[]\n  providersUsed: string[]\n  nodeCount: number\n  complexity: string\n  previewMediaUrl: string | null\n  previewMediaType: \"image\" | \"video\" | null\n  creatorId: string\n  creatorDisplayName: string | null\n  cloneCount: number\n  favoriteCount: number\n  createdAt: string\n}\n\nexport type TemplateSort = \"newest\" | \"popular\" | \"most-favorited\"\n\nexport interface BrowseTemplatesParams {\n  /** Opaque cursor from the previous page's `nextCursor`. */\n  cursor?: string\n  limit?: number\n  category?: string\n  outputType?: string\n  tag?: string\n  /** Full-text search over name/description/tags. */\n  search?: string\n  sort?: TemplateSort\n  /** Only templates using this node type. */\n  nodeType?: string\n  /** Only templates using this provider/model id. */\n  provider?: string\n  complexity?: string\n}\n\nexport interface BrowseTemplatesResult {\n  data: TemplateBrowseCard[]\n  /** Pass back as `cursor` to fetch the next page; `null` on the last page. */\n  nextCursor: string | null\n}\n\n/**\n * A single public template (`GET /v1/templates/:slug`) — the browse-card\n * fields plus the full workflow snapshot the viewer/clone consume. The route\n * returns the whole camelCased row, so additional columns may appear beyond\n * the ones typed here; the index signature keeps them reachable without\n * casting.\n */\nexport interface Template extends TemplateBrowseCard {\n  markdownDescription: string | null\n  /** React Flow node snapshots (generic node JSON, execution data stripped on clone). */\n  snapshotNodes: unknown[]\n  snapshotEdges: unknown[]\n  snapshotSettings: Record<string, unknown>\n  /** Channels the template is listed in (e.g. \"marketplace\", \"tutorial\"). */\n  listedIn: string[]\n  readonly [key: string]: unknown\n}\n\nexport interface CloneTemplateParams {\n  /** Target project (must belong to the caller). */\n  projectId: string\n  /** Optional name for the cloned workflow; defaults to the template's name. */\n  name?: string\n}\n\nexport interface CloneTemplateResult {\n  workflowId: string\n  projectId: string\n}\n\nexport class TemplatesResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** Browse the public template marketplace (cursor-paginated, no auth required). */\n  browse(params: BrowseTemplatesParams = {}): Promise<BrowseTemplatesResult> {\n    return this.client.request(\"GET\", \"/v1/templates/browse\", { query: { ...params } })\n  }\n\n  /** Fetch one public template by slug, including its full workflow snapshot. */\n  get(slug: string): Promise<Template> {\n    return this.client.request(\"GET\", `/v1/templates/${encodeURIComponent(slug)}`)\n  }\n\n  /** Clone a template into one of the caller's projects. Free — no credits charged. */\n  clone(slug: string, params: CloneTemplateParams): Promise<CloneTemplateResult> {\n    return this.client.request(\"POST\", `/v1/templates/${encodeURIComponent(slug)}/clone`, {\n      body: params,\n    })\n  }\n}\n"]}

package/dist/chunk-ETX3TLNB.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/media.ts"],"names":["readSseStream"],"mappings":"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","file":"chunk-ETX3TLNB.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport { readSseStream } from \"../sse.js\"\nimport type { OverlayAnchor, VideoMaskRequest, MaskCompositeRequest } from \"@nodaro/shared/media\"\nimport type { CaptionStyle, CaptionLookId, SupportedFontName } from \"@nodaro/shared/captions\"\nimport type { TranscribeLane } from \"@nodaro/shared/models\"\nimport type { VideoOverlayRequest } from \"@nodaro/shared/video\"\n\n/** One word-timed caption entry (one per WORD for the kinetic styles). */\nexport interface CaptionEntry {\n  text: string\n  startMs: number\n  endMs: number\n  timestampMs?: number | null\n  confidence?: number | null\n}\n\n/** Look + motion levers — see {@link MediaResource.addCaptions}. `look` is a\n *  named preset the explicit levers override; an unset look renders as `outline`\n *  (the default). The STYLING levers (`look`, `fontFamily`, `fontWeight`,\n *  `strokeColor`/`strokeWidth`, `uppercase`, `positionY`, `maxWordsPerLine`) now\n *  apply to the static `subtitle` style too — a subtitle carrying any of them\n *  renders via Remotion. Only `highlightColor` (no spoken-word cursor to colour)\n *  and `animate` (no motion to freeze) stay kinetic-only and are rejected (400)\n *  on `subtitle`. */\nexport interface CaptionLookInput {\n  look?: CaptionLookId\n  fontFamily?: SupportedFontName\n  fontWeight?: number\n  strokeColor?: string\n  strokeWidth?: number\n  highlightColor?: string\n  uppercase?: boolean\n  positionY?: number\n  /** Cap on how many words one caption LINE (or `tiktok-words` page) may hold,\n   *  1-20, on TOP of the frame-width budget, sentence ends and pauses that\n   *  already close a line — 1-2 gives the punchy CapCut read, unset fits the\n   *  width. Applies to `word-highlight` / `karaoke` / `bouncy` / `tiktok-words`\n   *  and to a Remotion-rendered `subtitle`; inert on `word-pop` (always one\n   *  word). */\n  maxWordsPerLine?: number\n  /** Kinetic styles only. `false` freezes the per-word MOTION — the grouping,\n   *  line-holding and spoken-word highlight stay, only the movement stops;\n   *  default `true`. Rejected (400) on the static `subtitle` style. */\n  animate?: boolean\n}\n\n/** One caption SEGMENT: a time range with optional style/look overrides and its\n *  own words (`text`/`captions`, else the shared transcript filtered to range).\n *  A segmented render is entirely Remotion, so any `style` is valid here. */\nexport interface CaptionSegmentInput extends CaptionLookInput {\n  startMs: number\n  endMs: number\n  style?: CaptionStyle\n  position?: \"bottom\" | \"top\" | \"center\"\n  fontSize?: number\n  color?: string\n  backgroundColor?: string\n  text?: string\n  captions?: CaptionEntry[]\n}\n\n/** {@link MediaResource.addCaptions} input. */\nexport interface AddCaptionsInput extends CaptionLookInput {\n  videoUrl: string\n  text?: string\n  captions?: CaptionEntry[]\n  /** Transcribe the video's audio when no text/captions are given (default true). */\n  autoTranscribe?: boolean\n  transcribeProvider?: TranscribeLane\n  style?: CaptionStyle\n  position?: \"bottom\" | \"top\" | \"center\"\n  fontSize?: number\n  color?: string\n  backgroundColor?: string\n  /** Apply different treatments to time ranges in one call (non-overlapping). */\n  segments?: CaptionSegmentInput[]\n}\n\n/**\n * Media ingestion + trimming — the source-preparation steps a Voice Changer Pro\n * flow (or any pipeline) needs before it has a clip to work on: pull a social\n * video into storage, copy a remote URL into storage, trim a video/audio to a\n * range, and probe a video's metadata. Each generation-style op returns a job id\n * to poll (`jobs.get(jobId)`); `videoMetadata` is a direct read.\n */\n/**\n * Where one overlay layer should go, in {@link MediaResource.imageOverlay}'s\n * percent units — the answer from {@link MediaResource.suggestOverlayPlacement}.\n */\nexport interface OverlayPlacement {\n  /** The point on the base image the layer attaches to. */\n  anchor: OverlayAnchor\n  /** Offset from the anchor in % of the base width (negative on a right anchor = inward). */\n  x: number\n  /** Offset from the anchor in % of the base height (negative on a bottom anchor = inward). */\n  y: number\n  /** The layer's width in % of the base width. */\n  width: number\n  /** One sentence, plain language, on why this spot. */\n  reason: string\n}\n\nexport class MediaResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Download a social video (YouTube / TikTok / Instagram / X / Facebook) into\n   * your storage (`POST /v1/download-video`). `maxHeight` caps the resolution\n   * (default \"best\"); `sectionStartSec` + `sectionEndSec` (both-or-neither) fetch\n   * ONLY that time range instead of the whole video. A download that arrives\n   * with no audio stream FAILS by default (it is usually a degraded source\n   * response, and is retried through other routes first); pass\n   * `requireAudio: false` to accept a clip that really has no sound. Returns a\n   * `downloadId`; progress streams from\n   * `GET /v1/download-video/progress/:downloadId` (server-sent events) and the\n   * finished file lands in your library.\n   */\n  downloadVideo(input: {\n    url: string\n    maxHeight?: number\n    sectionStartSec?: number\n    sectionEndSec?: number\n    requireAudio?: boolean\n  }): Promise<{ downloadId: string }> {\n    return this.client.request<{ downloadId: string }>(\"POST\", \"/v1/download-video\", { body: input })\n  }\n\n  /**\n   * Stream the live progress of a {@link MediaResource.downloadVideo} import\n   * (`GET /v1/download-video/progress/:downloadId`, server-sent events) as an\n   * async iterable. Yields a {@link DownloadVideoProgress} roughly every 500ms\n   * until the download reaches `completed` (its event carries the stored\n   * `videoUrl`) or `failed` (its event carries `error`), then ends. The progress\n   * state expires server-side shortly after the download starts existing, so\n   * start iterating promptly after `downloadVideo` returns.\n   *\n   * No request timeout is applied (a large import legitimately takes minutes) —\n   * pass an `AbortSignal` to cancel from the caller.\n   */\n  async *downloadVideoProgress(\n    downloadId: string,\n    opts: { signal?: AbortSignal } = {},\n  ): AsyncGenerator<DownloadVideoProgress, void, undefined> {\n    const url = `${this.client.baseUrl}/v1/download-video/progress/${encodeURIComponent(downloadId)}`\n    const token = await this.client.auth.getToken()\n    const res = await this.client.fetch(url, {\n      headers: token ? { Authorization: `Bearer ${token}` } : {},\n      signal: opts.signal,\n    })\n    // The shared reader owns the non-OK throw, the empty-body guard, the frame\n    // parse and the cancel-on-early-exit — this route emits the same\n    // `data: <json>` frames every other stream here does.\n    yield* readSseStream<DownloadVideoProgress>(res, { label: \"progress stream\" })\n  }\n\n  /**\n   * Copy an external media URL into your Nodaro storage (`POST /v1/save-to-storage`)\n   * — a server-side fetch, so nothing round-trips through the client. Poll\n   * `jobs.get(jobId)`.\n   */\n  saveToStorage(input: { mediaUrl: string; filename?: string; mediaType?: \"image\" | \"video\" | \"audio\" }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/save-to-storage\", { body: input })\n  }\n\n  /**\n   * Composite 2–30 images into ONE large 2K/4K collage (`POST /v1/image-collage`).\n   * `layout` `\"smart\"` (default — justified rows at each image's exact aspect\n   * ratio, no cropping; the output height floats) or `\"grid\"` (uniform,\n   * letterboxed cells). `imageSizes` is index-aligned with `imageUrls` and\n   * gives per-image RELATIVE size hints for the smart layout: `0` auto\n   * (\"don't care\", default), `1` big (~2× linear vs medium), `2` medium,\n   * `3` small (~½ linear). All-equal hints change nothing; grid ignores them.\n   * For storyboards, set `numbered` to stamp a 1-based sequence badge at each\n   * image's corner (top-left by default; `badgePosition: \"top-right\"` moves it;\n   * in `imageUrls` order) and pass `imageLabels`\n   * (index-aligned with `imageUrls`; `null`/`\"\"`/omitted = no caption for that\n   * image) to caption images after the number, e.g. `3 · Close-up`. Badges are\n   * an overlay only — they never change the layout, the output size or the\n   * credit cost. Poll `jobs.get(jobId)` for the finished image.\n   */\n  imageCollage(input: {\n    imageUrls: string[]\n    imageSizes?: Array<0 | 1 | 2 | 3>\n    numbered?: boolean\n    imageLabels?: Array<string | null>\n    /** Corner the badges sit in — `\"top-left\"` (default, storyboard convention) or `\"top-right\"`. */\n    badgePosition?: \"top-left\" | \"top-right\"\n    layout?: \"smart\" | \"grid\"\n    resolution?: \"2K\" | \"4K\"\n    aspectRatio?: string\n    gap?: number\n    backgroundColor?: string\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/image-collage\", { body: input })\n  }\n\n  /**\n   * Place 1–12 layers — pictures, real text, QR codes, shapes — on a base image,\n   * pixel-exactly (`POST /v1/image-overlay`) — local, deterministic, no AI.\n   * Every layer position/size is a PERCENT of the base image: `anchor` (nine\n   * positions, default `\"center\"`), `x`/`y` (offset from the anchor in % of\n   * the base width/height; negative on a right/bottom anchor moves inward),\n   * `width` (% of the base width, default 25 — height follows the layer's\n   * aspect unless `height` is set). Plus `opacity` (0..1), `rotation`\n   * (degrees), `blend` (`\"over\"` | `\"multiply\"` | `\"screen\"`), `fit`,\n   * `shadow` and `roundedCorners`. The output keeps the base's pixel size\n   * unless `canvas` is set. Flat credit cost. Poll `jobs.get(jobId)` for the\n   * finished image.\n   */\n  imageOverlay(input: {\n    imageUrl: string\n    layers: Array<{\n      imageUrl: string\n      anchor?: OverlayAnchor\n      x?: number\n      y?: number\n      width?: number\n      height?: number\n      opacity?: number\n      rotation?: number\n      blend?: \"over\" | \"multiply\" | \"screen\"\n      fit?: \"contain\" | \"cover\" | \"stretch\"\n      shadow?: { blur: number; offsetX: number; offsetY: number; color: string; opacity: number }\n      roundedCorners?: number\n      zIndex?: number\n      /** \"image\" (default, needs imageUrl) | \"text\" | \"qr\" | \"shape\" — see @nodaro/shared image-overlay-layers. */\n      kind?: \"image\" | \"text\" | \"qr\" | \"shape\"\n      text?: Record<string, unknown>\n      qr?: Record<string, unknown>\n      shape?: Record<string, unknown>\n      effects?: Record<string, unknown>\n    }>\n    canvas?: { width: number; height: number; backgroundColor?: string }\n    baseFit?: \"contain\" | \"cover\"\n    outputFormat?: \"png\" | \"jpg\" | \"webp\"\n    /** Extra platform renders (see OVERLAY_PLATFORMS in @nodaro/shared); returned as output `variants[]`. */\n    variants?: string[]\n    /** The mask the job also emits as output `maskUrl` (white = may change). Default \"around\". */\n    maskMode?: \"none\" | \"layers\" | \"around\" | \"outside\"\n    maskSpread?: number\n    /** Fills every QR layer whose `qr.fromInput` is true — the node's QR link handle. */\n    qrText?: string\n  }): Promise<{ jobId: string }> {\n    // The finished job's output: { imageUrl, width, height, maskUrl?, variants?: [{ id, label, width, height, url }] }.\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/image-overlay\", { body: input })\n  }\n\n  /**\n   * Ask a vision model WHERE one overlay layer should sit on a base image\n   * (`POST /v1/image-overlay/suggest-placement`) — it reads the picture and\n   * keeps the element off the faces, the subject and the busiest texture.\n   * The answer comes back in {@link MediaResource.imageOverlay}'s own percent\n   * units — `anchor`, `x`/`y` offsets, `width` — so it drops straight onto a\n   * layer (`const { reason, ...box } = placement`), plus a one-sentence\n   * `reason` you can show a user. Nothing is composited here: apply the\n   * placement yourself.\n   *\n   * `layerAspect` is the element's width / height (1 = square, the default) so\n   * the proposed box stays in proportion; `intent` says what the element is\n   * (\"a logo\", \"a price badge\"); `safeArea` is the always-visible region as\n   * fractions of the canvas (a platform preset's safe area), which the\n   * placement is kept inside. Unlike the other media calls this one answers\n   * synchronously — there is nothing to poll; `jobId` is the billing record\n   * (one image-to-text call).\n   */\n  suggestOverlayPlacement(input: {\n    imageUrl: string\n    layerAspect?: number\n    intent?: string\n    safeArea?: { x: number; y: number; w: number; h: number }\n    llmModel?: string\n  }): Promise<{ jobId: string; placement: OverlayPlacement }> {\n    return this.client.request<{ jobId: string; placement: OverlayPlacement }>(\n      \"POST\",\n      \"/v1/image-overlay/suggest-placement\",\n      { body: input },\n    )\n  }\n\n  /**\n   * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever\n   * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or\n   * `keepFirst`/`keepLastSeconds`. Poll `jobs.get(jobId)`.\n   */\n  trimVideo(input: {\n    videoUrl: string\n    startTime?: number\n    endTime?: number\n    trimStartFrames?: number\n    trimEndFrames?: number\n    trimStartSeconds?: number\n    trimEndSeconds?: number\n    keepFirstSeconds?: number\n    keepLastSeconds?: number\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/trim-video\", { body: input })\n  }\n\n  /**\n   * Burn captions into a video (`POST /v1/add-captions`). Give the words as\n   * `text`, word-timed `captions[]`, or let it transcribe (`autoTranscribe`,\n   * the default when neither is set).\n   *\n   * `style: \"subtitle\"` renders statically (FFmpeg) UNLESS it carries a styling\n   * lever, in which case it — like the KINETIC styles (`word-highlight` /\n   * `karaoke` / `tiktok-words` / `word-pop` / `bouncy`) — renders via Remotion.\n   * `look` picks a preset — `outline` (Montserrat 900, UPPERCASE, black outline,\n   * yellow spoken word — the TikTok/Reels read) or `clean`; an UNSET look renders\n   * as `outline`. The explicit STYLING levers (`fontFamily`, `fontWeight`,\n   * `strokeColor`/`strokeWidth`, `uppercase`, `positionY`, `maxWordsPerLine`)\n   * override individual fields of it and now apply to `subtitle` too. Only\n   * `highlightColor` (the spoken-word cursor) and `animate` stay kinetic-only\n   * and are REJECTED on `subtitle`.\n   *\n   * `animate` (default true) freezes the per-word MOTION on the kinetic styles\n   * when set to false — the grouping, line-holding and spoken-word highlight\n   * stay; only the movement stops.\n   *\n   * `maxWordsPerLine` (1-20) caps how many words a line — or a `tiktok-words`\n   * page — may hold, on top of the width budget / sentence ends / pauses that\n   * already close one; it is inert on `word-pop`, which is always one word.\n   * Like every lever here it exists top-level AND per segment, and a segment\n   * that does not name its own inherits the top-level value.\n   *\n   * `segments[]` applies DIFFERENT treatments to non-overlapping time ranges in\n   * one call (e.g. a large top intro, then a small bottom body); a segment that\n   * names its own `look` starts fresh from that preset and does not inherit the\n   * top-level explicit levers. Poll `jobs.get(jobId)`.\n   *\n   * `word-highlight` shows ONE held line at a time and a word's\n   * `startMs`/`endMs` is its SPOKEN window (what times the highlight, not how\n   * long the text is on screen) — so `captions[]` can be handed over verbatim\n   * from an `audio.transcribe()` job's `output_data.words`, with\n   * `autoTranscribe: false`.\n   */\n  addCaptions(input: AddCaptionsInput): Promise<{ jobId: string }> {\n    const { autoTranscribe, transcribeProvider, ...rest } = input\n    // The route body is camelCase except these two flags (worker snake_case);\n    // omit each when unset so an absent flag stays absent on the wire.\n    const body: Record<string, unknown> = {\n      ...rest,\n      ...(autoTranscribe !== undefined ? { auto_transcribe: autoTranscribe } : {}),\n      ...(transcribeProvider !== undefined ? { transcribe_provider: transcribeProvider } : {}),\n    }\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/add-captions\", { body })\n  }\n\n  /**\n   * Trim (and extract) audio from a video or audio source\n   * (`POST /v1/trim-audio`) to `[startTime, endTime]` seconds, in `audioFormat`\n   * (`mp3` default / `wav` / `aac`). Poll `jobs.get(jobId)`.\n   */\n  trimAudio(input: {\n    videoUrl?: string\n    audioUrl?: string\n    audioFormat?: \"mp3\" | \"wav\" | \"aac\"\n    startTime?: number\n    endTime?: number\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/trim-audio\", { body: input })\n  }\n\n  /**\n   * Cut a video and/or an audio file into consecutive parts\n   * (`POST /v1/split-media`). Every part is at most `chunkDuration` seconds and\n   * at least `minPartDuration` (default 4, never above `chunkDuration`) — a\n   * short leftover is evened out with the parts before it. Video is cut on\n   * whole frames with each part's sound matching its picture; audio parts are\n   * sample-exact, in `audioFormat` (`mp3` default / `wav` / `aac`). With both\n   * sources each is split on its own. At most 200 parts per input. Poll\n   * `jobs.get(jobId)`; the parts are on the completed job's `output_data` —\n   * see {@link SplitMediaOutput}.\n   */\n  splitMedia(input: SplitMediaInput): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/split-media\", { body: input })\n  }\n\n  /**\n   * Turn one still image + one audio track into an MP4\n   * (`POST /v1/still-to-video`) — locally rendered (FFmpeg), no AI model,\n   * zero credits. The output duration IS the audio's duration; there is no\n   * duration field. Optional `motion` animates the still (zoom / pan /\n   * ken-burns) at `intensity` 1–10. `fit: \"contain\"` letterboxes with\n   * `padColor` instead of cropping. Poll `jobs.get(jobId)`.\n   */\n  stillToVideo(input: {\n    imageUrl: string\n    audioUrl: string\n    motion?: \"none\" | \"zoom-in\" | \"zoom-out\" | \"pan-left\" | \"pan-right\" | \"ken-burns\"\n    intensity?: number\n    resolution?: \"720p\" | \"1080p\" | \"4K\"\n    aspectRatio?: \"16:9\" | \"9:16\" | \"1:1\" | \"4:3\"\n    fps?: 24 | 30\n    fit?: \"cover\" | \"contain\"\n    padColor?: string\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/still-to-video\", { body: input })\n  }\n\n  /**\n   * Turn 2–100 images + one optional audio track into an MP4 slideshow\n   * (`POST /v1/slideshow`) — locally rendered (FFmpeg), zero credits. With\n   * audio, the output duration IS the audio's duration (equal split unless\n   * `imageDurations` pins rows — null entries = auto; mismatched pinned sums\n   * scale proportionally and the factor is disclosed in the job output).\n   * Without audio: N × `perImageDuration`, silent output. Transitions\n   * consume the outgoing slide, so totals stay exact. For a single image use\n   * `stillToVideo`. Poll `jobs.get(jobId)`.\n   */\n  slideshow(input: {\n    imageUrls: string[]\n    audioUrl?: string\n    imageDurations?: Array<number | null>\n    perImageDuration?: number\n    transition?: string\n    transitionDuration?: number\n    motion?: \"none\" | \"zoom-in\" | \"zoom-out\" | \"ken-burns\" | \"alternate\"\n    intensity?: number\n    resolution?: \"720p\" | \"1080p\" | \"4K\"\n    aspectRatio?: \"16:9\" | \"9:16\" | \"1:1\" | \"4:3\"\n    fps?: 24 | 30\n    fit?: \"cover\" | \"contain\"\n    padColor?: string\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/slideshow\", { body: input })\n  }\n\n  /**\n   * Place 1–20 timed image layers over a video (`POST /v1/video-overlay`) —\n   * rendered locally (FFmpeg) in one pass, no AI; the base audio is kept\n   * untouched. Each layer has an `imageUrl`, a `start` and an optional `end`\n   * in seconds (no `end` = to the end of the video) and a placement: a\n   * `preset` (`\"card\"`, `\"corner-badge\"` with a `corner`, `\"full-frame\"`) or\n   * an explicit box in {@link MediaResource.imageOverlay}'s percent vocabulary\n   * (`anchor`, `x`, `y`, `width`, `height`, `fit`) — an explicit box field\n   * overrides the preset, and a layer with neither is a corner badge\n   * (bottom-right, or the `corner` it names). `outputAspect` renders onto a\n   * 16:9 / 9:16 / 1:1 / 4:5 canvas\n   * (`baseFit` cover by default; `backgroundColor` pads `contain`). Poll\n   * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`, `width`,\n   * `height`, `durationSec` and `warnings[]` (a layer clipped or skipped at the\n   * video's end, an animated image's first frame, re-encoded audio).\n   */\n  videoOverlay(input: VideoOverlayRequest): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/video-overlay\", { body: input })\n  }\n\n  /**\n   * Track a subject described in plain text through a video and get a\n   * black-and-white MASK VIDEO back (`POST /v1/video-mask`, SAM 3.1 by default,\n   * or `provider: \"sam-3\"` at half the price) — white = the subject. Clips up\n   * to 5 minutes at 30 fps (a faster clip counts\n   * proportionally longer), priced by the clip's length. Poll\n   * `jobs.get(jobId)`: the output carries `videoUrl` (the mask), `width`,\n   * `height`, `frames`, `coverage` (the fraction of pixels selected, rounded\n   * to 4 decimals) and `kept` (any region left on any frame: false only when\n   * the size / zone filters left an empty mask — read it rather than\n   * `coverage`, which a few pixels round to 0). Feed the mask to\n   * {@link MediaResource.maskComposite}.\n   *\n   * `holdLastMask: true` keeps the last mask on frames where the subject is\n   * lost (a mask covering under 0.002 % of the frame, e.g. a face behind a\n   * hand): each such frame after the first detection repeats the most recent\n   * non-empty one; the output then also carries `heldFrames`.\n   * `minSubjectHeightPct` (0–100, default 0 = off) drops every connected\n   * region whose bounding box is shorter than that % of the frame height\n   * (extras' small faces behind the main subject); it runs before\n   * `holdLastMask`, and the output then carries `droppedRegions`.\n   * `maxSubjectHeightPct` (0–100, default 0 = off) is its mirror: it drops\n   * regions TALLER than that % (keep only the small background faces). With\n   * both set a region is kept when min ≤ height ≤ max; min > max is a 400.\n   * `zone` (`{ leftPct, rightPct, topPct, bottomPct }`, each 0–49 % of the\n   * frame, a margin left out = 0; default null = off) keeps only the regions\n   * whose bounding-box centre lies inside the frame minus those margins (after\n   * the size cuts, before `holdLastMask`). `perShot: true` finds the clip's\n   * scene cuts first and segments each shot on its own: the subject is\n   * detected again after every cut, `holdLastMask` never crosses a cut, and\n   * each shot's mask is fitted to that shot's exact frame count; on a clip\n   * with no cut it gives the same mask, fitted to the clip's exact frame\n   * count. The output carries `shots` (1 when off).\n   */\n  videoMask(input: VideoMaskRequest): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/video-mask\", { body: input })\n  }\n\n  /**\n   * Place a foreground video over a background video through a mask video\n   * (`POST /v1/mask-composite`; white = foreground) — local FFmpeg, no AI.\n   * The result follows the foreground's size, frame rate and length; the\n   * background is fitted (`backgroundFit`, default cover) and loops when\n   * shorter; the mask holds its last frame when shorter. Optional\n   * `invertMask`, `feather` (0–20 px), `grow` (−10–10 px), `opacity` (0–1,\n   * default 1: how strongly the foreground covers the background inside the\n   * mask) and `audioSource` (foreground / background / mix / none). Priced per started 5 seconds of\n   * the result (the video it follows up to 300 s). Poll `jobs.get(jobId)` for `videoUrl`.\n   *\n   * `fill` picks what fills the masked area: `video` (default — the\n   * foreground, required then), `pixelate` (the background itself in\n   * blocks of `pixelSizePct` % of the frame width, 0.2–10, default 1.25) or\n   * `blur` (the background blurred, sigma `blurStrengthPct` % of the frame\n   * width, 0.1–5, default 2). Pixelate and blur take no\n   * `foregroundUrl` (one sent is ignored): the result follows the background\n   * and is priced on its length, and it always carries the background's sound\n   * (`audioSource` is ignored).\n   */\n  maskComposite(input: MaskCompositeRequest): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/mask-composite\", { body: input })\n  }\n\n  /**\n   * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,\n   * dimensions, title, live status — WITHOUT downloading it. A direct read, not a\n   * job. Use it to decide whether to trim before importing.\n   */\n  videoMetadata(input: { url: string }): Promise<VideoMetadata> {\n    return this.client.request<VideoMetadata>(\"POST\", \"/v1/video-metadata\", { body: input })\n  }\n\n  /**\n   * Cut or crop a stored file (`POST /v1/media/process`) — synchronous and\n   * free, the source-preparation sibling of the priced `trimVideo` node.\n   * `trim` is `[startTime, endTime]` in seconds; `deleteSource: true` removes\n   * the source object afterwards when it is yours and nothing else references\n   * it (\"the cut replaces the original\"). Answers the stored file.\n   */\n  process(input: MediaProcessInput): Promise<{ data: MediaProcessResult }> {\n    return this.client.request<{ data: MediaProcessResult }>(\"POST\", \"/v1/media/process\", { body: input })\n  }\n}\n\n/**\n * One event from {@link MediaResource.downloadVideoProgress}. The stream ends\n * after a `completed` event (which carries the stored `videoUrl` + an optional\n * `thumbnailUrl`) or a `failed` event (which carries `error`).\n */\nexport interface DownloadVideoProgress {\n  phase: \"downloading\" | \"processing\" | \"uploading\" | \"completed\" | \"failed\"\n  /** Download percent (0–100). Section fetches report jumpy percents — display, don't sum. */\n  percent: number\n  /** The imported video's storage URL — set on the `completed` event. */\n  videoUrl?: string\n  /** Thumbnail storage URL — set on the `completed` event when one was captured. */\n  thumbnailUrl?: string\n  /** What went wrong — set on the `failed` event. */\n  error?: string\n}\n\n/** Result of {@link MediaResource.videoMetadata}. Fields are best-effort — a probe may omit some. */\nexport interface VideoMetadata {\n  durationSec?: number | null\n  width?: number | null\n  height?: number | null\n  title?: string | null\n  isLive?: boolean\n  [key: string]: unknown\n}\n\n/** Body of {@link MediaResource.splitMedia} (`POST /v1/split-media`). At least one of `videoUrl` / `audioUrl`. */\nexport interface SplitMediaInput {\n  /** Video to split. */\n  videoUrl?: string\n  /** Audio file to split (split on its own when a video is given too). */\n  audioUrl?: string\n  /** The longest a part may be, in seconds (at least 1). Every part is at most this long. */\n  chunkDuration: number\n  /** The shortest a part may be, in seconds (0 or more, default 4). Must not exceed `chunkDuration` (400 otherwise). */\n  minPartDuration?: number\n  /** Format of the audio parts. Default `mp3`. */\n  audioFormat?: \"mp3\" | \"wav\" | \"aac\"\n}\n\n/** A completed split-media job's `output_data`. */\nexport interface SplitMediaOutput {\n  /** The video parts, in order (when a video was split). */\n  videoUrls?: string[]\n  /** The audio parts, in order (when an audio file was split). */\n  audioUrls?: string[]\n  /** The number of parts — the larger of the two lists. */\n  chunkCount: number\n  /** Each part's exact length in seconds: the video parts' when a video was split, else the audio parts'. */\n  partDurationsSec?: number[]\n  /** The audio parts' lengths, only when BOTH a video and an audio file were split. */\n  audioPartDurationsSec?: number[]\n}\n\nexport interface MediaProcessInput {\n  sourceUrl: string\n  type: \"video\" | \"audio\"\n  trim?: { startTime: number; endTime: number }\n  crop?: { x: number; y: number; width: number; height: number }\n  format?: \"mp4\" | \"webm\" | \"mp3\" | \"wav\" | \"m4a\" | \"aac\"\n  deleteSource?: boolean\n}\n\nexport interface MediaProcessResult {\n  url: string\n  thumbnailUrl: string | null\n  assetId: string | null\n  sizeBytes: number\n  mimeType: string\n  metadata: Record<string, unknown>\n}\n"]}

package/dist/chunk-F6GENF6R.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/cast-swap.ts"],"names":[],"mappings":";;;AAgZO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASpB,GAAA,CAAI,QAAwB,OAAA,EAA6E;AACvG,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,eAAA,EAAiB;AAAA,MAClD,IAAA,EAAM,MAAA;AAAA,MACN,GAAI,OAAA,EAAS,cAAA,GAAiB,EAAE,OAAA,EAAS,EAAE,iBAAA,EAAmB,OAAA,CAAQ,cAAA,EAAe,EAAE,GAAI;AAAC,KAC7F,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,SAAS,MAAA,EAAmD;AAC1D,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,MAAA,EAAQ,0BAA0B,EAAE,IAAA,EAAM,QAAQ,CAAA;AAAA,EAC/E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,oBAAoB,KAAA,EAAqD;AACvE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,CAAA,cAAA,EAAiB,kBAAA,CAAmB,KAAK,CAAC,CAAA,sBAAA,CAAA,EAA0B,EAAE,IAAA,EAAM,IAAI,CAAA;AAAA,EACrH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,WAAA,CAAY,KAAA,EAAe,MAAA,GAAoC,EAAC,EAAuC;AACrG,IAAA,MAAM,IAAA,GAAO,OAAO,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,MAAA,CAAO,SAAA,EAAU,GAAI,EAAC;AACjF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,CAAA,cAAA,EAAiB,kBAAA,CAAmB,KAAK,CAAC,CAAA,aAAA,CAAA,EAAiB,EAAE,IAAA,EAAM,CAAA;AAAA,EACxG;AACF","file":"chunk-F6GENF6R.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Cast Swap — replace the people, pets, products and/or the location in a\n * short video with your own references, keeping its motion, framing, timing\n * and sound (the clip's audio is kept, and the result is the clip's length).\n *\n * Before the video, each person, pet and product role's photos are turned\n * into one clean reference picture by an image model. This costs extra\n * credits (`breakdown.references` in the estimate), charged when it runs, even\n * if the video then fails; it adds about a minute, falls back to your own\n * photos if it fails, and is turned off with `prepareReferences: false`.\n * Locations are not prepared.\n *\n * Cloud edition only: `/v1/cast-swap` is served by the cloud plugin and 404s\n * on self-hosted installs. `run()` answers 202 with a job id; follow it with\n * `client.jobs.get(jobId)` / `client.jobs.getStatus(jobId)` like any other job.\n *\n * Repeats: pass `{ idempotencyKey }` to `run()` and it is sent as the\n * `Idempotency-Key` header. A repeat with the same key within the credit\n * guard's dedup window (about 10 s) answers 200 `{ jobId, deduped: true }` with\n * an `X-Dedup-Hit` header; a later one answers 202 with the first run's\n * `jobId`. Nothing new is started or charged.\n *\n * Refusals (thrown as a `NodaroError` subclass; body `{ error: { code, message } }`), before\n * anything is charged: 400 `validation_error` (the body: no role with images,\n * no reference and no `prePrompt` or `postPrompt`, more roles of a kind\n * than allowed, more than 30 images in all, `draft: true` above 480p, a\n * `prePrompt` or `postPrompt` over 4,000 characters, a `faceMasking` setting\n * out of range), `raw_reference_token` (also in a reference's `line`),\n * `invalid_role_mention` (also any `{role:N}` in a reference's `line`),\n * `unsafe_url`, `video_unreadable`, `clip_out_of_range` (4–30 s),\n * `preview_out_of_range`, `no_roles_in_preview` (a preview with every role\n * `inPreview: false`, always refused even with a prompt, or with no role kept\n * in it that has images and no `prePrompt` or `postPrompt`), `prompt_too_long`\n * (the prompt would build too long: a `{role:N}` reads as the role's name when\n * it sends no images); 401; 402 `insufficient_credits` (`run()` only); 404\n * (a `sessionId` you may not use, `run()` only); 422 `job_blocked` (`run()`\n * only); 503 `host_too_old` (both); 503 `estimate_unavailable` (`estimate()`\n * only).\n */\n\n/** Whether a swapped subject takes this trait from the references (`\"new\"`) or keeps the video's (`\"original\"`). */\nexport type CastSwapTraitSource = \"new\" | \"original\"\n\n/**\n * Preview-only settings, on every role kind; a full run (`preview` not `true`)\n * ignores both.\n */\nexport interface CastSwapRolePreviewSettings {\n  /** The name used instead of `name` in a preview. Same rules as `name` (1–200 characters). */\n  previewName?: string\n  /**\n   * `false` leaves this role out of the preview: its reference images are not\n   * sent, not prepared and not charged, and a `{role:N}` naming it reads as its\n   * `previewName`, else its `name`. Default `true`. A preview with every role\n   * left out (always refused, even with a prompt), or with no role kept in it\n   * that has images and no pre / post prompt, answers 400 `no_roles_in_preview`.\n   */\n  inPreview?: boolean\n}\n\n/** A person in the video to recast. */\nexport interface CastSwapPersonRole extends CastSwapRolePreviewSettings {\n  kind: \"person\"\n  /** How the person is told apart in the video, e.g. `\"the woman that attacks\"`. */\n  name: string\n  /** 0–3 images of ONE person. Empty or `null` keeps the original person. */\n  images: string[] | null\n  /** Body from the references or the video. Default `\"new\"`. */\n  body?: CastSwapTraitSource\n  /** Outfit from the references or the video. Default `\"new\"`. */\n  outfit?: CastSwapTraitSource\n  /** Hairstyle and haircut from the references or the video. Default `\"new\"`. */\n  hair?: CastSwapTraitSource\n}\n\n/** The place the video happens in. */\nexport interface CastSwapLocationRole extends CastSwapRolePreviewSettings {\n  kind: \"location\"\n  /** How the place is named. Default `\"the setting\"`. */\n  name?: string\n  /** 0–3 images of ONE place. Empty or `null` keeps the original place. */\n  images: string[] | null\n}\n\n/** An animal in the video to recast. */\nexport interface CastSwapPetRole extends CastSwapRolePreviewSettings {\n  kind: \"pet\"\n  /** How the animal is told apart in the video, e.g. `\"the dog\"`. */\n  name: string\n  /** 0–3 images of ONE animal. Empty or `null` keeps the original animal. */\n  images: string[] | null\n  /** Body (shape, size and build) from the references or the video. Default `\"new\"`. */\n  body?: CastSwapTraitSource\n  /** Coat (fur, colors and markings) from the references or the video. Default `\"new\"`. */\n  coat?: CastSwapTraitSource\n}\n\n/** An object in the video to recast. */\nexport interface CastSwapProductRole extends CastSwapRolePreviewSettings {\n  kind: \"product\"\n  /** How the object is told apart in the video, e.g. `\"the can\"`. */\n  name: string\n  /** 0–3 images of ONE product. Empty or `null` keeps the original object. */\n  images: string[] | null\n  /** Shape and proportions from the references or the video. Default `\"new\"`. */\n  shape?: CastSwapTraitSource\n  /** Finish (colors, materials, label and markings) from the references or the video. Default `\"new\"`. */\n  finish?: CastSwapTraitSource\n}\n\nexport type CastSwapRole = CastSwapPersonRole | CastSwapLocationRole | CastSwapPetRole | CastSwapProductRole\n\n/**\n * A fixed reference: 1–3 images of ONE thing that no role replaces, and the\n * line that says what it is (`\"the glass she drinks from\"`). Sent as given,\n * never prepared; its images count toward the 30.\n */\nexport interface CastSwapReference {\n  /** 1–3 http(s) image URLs of one thing. */\n  images: string[]\n  /**\n   * What it is, 1–500 characters. `{image}` in the line stands for this\n   * reference's first image (`\"Use {image} for the sky\"`); a line without it\n   * gets it appended. A `{role:N}` or a raw `{image:` / `{video:` / `{audio:`\n   * token answers 400.\n   */\n  line: string\n}\n\n/**\n * Margins of the frame, each 0–49 %: a face whose centre lies in a margin is\n * not masked, so only faces inside the inner rectangle are. A margin left out\n * of a zone that is given is 0. (A `zone` left out altogether is 10 % at the\n * left and right: see `CastSwapFaceMasking.zone`.)\n */\nexport interface CastSwapFaceMaskingZone {\n  /** % of the frame's width from the left edge. Default 0 in a zone that is given. */\n  leftPct?: number\n  /** % of the frame's width from the right edge. Default 0 in a zone that is given. */\n  rightPct?: number\n  /** % of the frame's height from the top edge. Default 0. */\n  topPct?: number\n  /** % of the frame's height from the bottom edge. Default 0. */\n  bottomPct?: number\n}\n\n/**\n * Face masking: the faces in the source clip are covered before the video\n * model sees it, keeping their movement and lip timing while the rest of the\n * clip is sent as it is.\n *\n * - `\"off\"` (the same as leaving `faceMasking` out): the clip is sent as it is.\n * - `\"always\"`: the faces are masked before the first attempt. Its credits are\n *   in the quote (`breakdown.masking`, counted in `totalCredits`).\n * - `\"auto\"`: the run starts unmasked; only if the video model refuses the\n *   source clip is it retried once with the faces masked. Any other failure is\n *   not retried. The extra credits, charged only when that retry runs, are the\n *   estimate's `maskingCredits` (not in `totalCredits`).\n *\n * A completed job's output carries `faceMasking: { applied, reason }`:\n * `applied` is whether the video was made from the masked clip, and `reason`\n * is `\"always\"` (masked before the first attempt), `\"input_refused\"` (`auto`\n * retried after the source clip was refused), `\"no_faces\"` (no face was left\n * to mask after the filters: an `always` run continues unmasked; an `auto`\n * run fails with the original refusal instead) or `\"off\"`.\n */\nexport interface CastSwapFaceMasking {\n  mode: \"off\" | \"always\" | \"auto\"\n  /** What covers a masked face: `\"blur\"` (default) or `\"depth\"` (a depth-color view of it). */\n  fill?: \"blur\" | \"depth\"\n  /** Mask only faces at least this % of the frame's height, 0–100. Default 15. */\n  minFaceHeightPct?: number\n  /**\n   * Mask only faces at most this % of the frame's height, 0–100. Default 0 (no\n   * limit). When above 0 it must be at least `minFaceHeightPct` (else 400).\n   */\n  maxFaceHeightPct?: number\n  /**\n   * Leave out faces near the edges of the frame. Default (left out):\n   * `{ leftPct: 10, rightPct: 10, topPct: 0, bottomPct: 0 }`, so people at the\n   * left and right edges are not masked. `null`, or all four margins 0, means\n   * no margins.\n   */\n  zone?: CastSwapFaceMaskingZone | null\n  /** The blur's strength, 0.1–5 % of the frame's width (`fill: \"blur\"`). Default 2. */\n  blurStrengthPct?: number\n  /** How sure the face finder must be, 0.05–0.95: lower finds more faces. Default 0.5. */\n  threshold?: number\n}\n\n/** The body of `POST /v1/cast-swap` and `POST /v1/cast-swap/estimate`. */\nexport interface CastSwapParams {\n  /** The source clip, 4–30 seconds. */\n  videoUrl: string\n  /**\n   * Who and what to swap: at most 6 person roles, 1 location role, 3 pet roles\n   * and 3 product roles, with at most 30 images in all. A role with no images\n   * is skipped (that subject or place stays as in the video). At least one role\n   * with images, or a `prePrompt` or `postPrompt`, is required.\n   */\n  roles: CastSwapRole[]\n  /**\n   * Fixed references (at most 5): things the video should show that no role\n   * replaces, each with the line that names it. Their images count toward the\n   * 30. A reference alone is enough for a run (no role needs images).\n   */\n  references?: CastSwapReference[]\n  /**\n   * Your own words placed at the start of the prompt, before the role\n   * instructions; at most 4,000 characters. Mention a role as `{role:N}`, as in\n   * `postPrompt`; the same 400 refusals apply (an N outside 1..`roles.length`,\n   * a raw `{image:` / `{video:` / `{audio:` token).\n   */\n  prePrompt?: string\n  /**\n   * Extra instructions in your own words, at most 4,000 characters. Mention a\n   * role as `{role:N}`, where N is its 1-based position in `roles`\n   * (`{role:1}` is `roles[0]`; empty roles count).\n   *\n   * The route answers 400, before charging, for an N outside 1..`roles.length`,\n   * for a raw `{image:` / `{video:` / `{audio:` token in the pre or post prompt\n   * or a role's `name`, for a clip outside 4–30 s, and for a preview past the clip's\n   * end (`previewStart + 4` > its length).\n   */\n  postPrompt?: string\n  /** `true` runs on 4 seconds of the clip, starting at `previewStart`: a cheap check of the roles and choices. */\n  preview?: boolean\n  /** Where the preview starts, in seconds. Default 0. */\n  previewStart?: number\n  /** The output resolution. Default `\"480p\"`. */\n  resolution?: \"480p\" | \"720p\" | \"1080p\"\n  /**\n   * Render as a draft. Defaults to `true` at 480p and `false` above it; `true`\n   * with `\"720p\"` or `\"1080p\"` answers 400 (draft is 480p only).\n   */\n  draft?: boolean\n  /**\n   * Turn each person, pet and product role's photos into one clean reference\n   * picture before the video (extra credits, shown in `breakdown.references`;\n   * about a minute longer; falls back to your own photos if it fails).\n   * Default `true`.\n   */\n  prepareReferences?: boolean\n  /** Mask the faces in the source clip (see {@link CastSwapFaceMasking}). Default: off. */\n  faceMasking?: CastSwapFaceMasking\n  /**\n   * `\"draft\"` means 480p draft.\n   * @deprecated use `resolution` + `draft`.\n   */\n  quality?: \"draft\"\n  /** A generation session to file the result in. */\n  sessionId?: string\n  /** The client app that sent the run (stored on the job as `input_data.origin`). */\n  origin?: string\n}\n\n/** What a run would cost, in credits. */\nexport interface CastSwapEstimate {\n  /**\n   * What is held when the run starts: `breakdown.castSwap +\n   * breakdown.seedance + breakdown.references`, plus `breakdown.masking` with\n   * face masking `\"always\"`. The run is charged what it actually costs, which\n   * is expected to be `expectedCredits`.\n   */\n  totalCredits: number\n  /**\n   * The charge the run is expected to come to: `breakdown.castSwap +\n   * breakdown.seedanceExpected + breakdown.references`, plus\n   * `breakdown.masking` with face masking `\"always\"` (the hold, with the video\n   * model's expected charge in place of its hold). Never above `totalCredits`.\n   * With `\"auto\"` the masking is in neither total (see `maskingCredits`).\n   * `totalCredits` is what is held when the run starts; the run is charged\n   * what it actually costs.\n   *\n   * Absent from an older Cast Swap engine: read `totalCredits` then.\n   */\n  expectedCredits?: number\n  /**\n   * The parts of the quote:\n   * - `castSwap`: the run itself;\n   * - `seedance`: what the video model it calls holds (the video's length is\n   *   left to the model, so it is held at the model's longest output);\n   * - `seedanceExpected`: what the video model is expected to be charged (the\n   *   clip in and about as much out), never above `seedance`. It takes\n   *   `seedance`'s place in `expectedCredits`; it is not added to it. Absent\n   *   from an older Cast Swap engine, like `expectedCredits`;\n   * - `references`: preparing the reference pictures (0 when\n   *   `prepareReferences` is off or there is nothing to prepare);\n   * - `masking`: masking the faces, present only when `faceMasking` is on.\n   *   With `\"always\"` it is in both totals; with `\"auto\"` it equals\n   *   `maskingCredits` and is in neither.\n   *\n   * So the parts sum to more than either total: `seedance` and\n   * `seedanceExpected` are alternatives, and `\"auto\"` masking is outside both.\n   */\n  breakdown: { castSwap: number; seedance: number; references: number; seedanceExpected?: number; masking?: number }\n  /**\n   * Face masking `\"auto\"` only: the extra credits charged if the source clip\n   * is refused and the run is retried with the faces masked. Not in\n   * `totalCredits` or `expectedCredits`; `run()` needs credits for both the\n   * hold and this (else 402).\n   */\n  maskingCredits?: number\n  /**\n   * `true` when the video is made at Auto length (every run today): the final\n   * charge is expected to come out lower than `totalCredits`, at about\n   * `expectedCredits`.\n   */\n  settlesLower: boolean\n}\n\n/** Per-call options for {@link CastSwapResource.run}. */\nexport interface CastSwapRunOptions {\n  /**\n   * Sent as the `Idempotency-Key` header, unchanged (the SDK checks nothing;\n   * an empty string sends no header, like no key).\n   * The server takes 8–200 characters and answers 400 for any other length.\n   * Reuse the same value when retrying the same run: within about 10 s the\n   * repeat answers 200 `{ jobId, deduped: true }`, later 202 with the first\n   * run's `jobId`. Nothing new is started or charged.\n   */\n  idempotencyKey?: string\n}\n\n/**\n * What finishing a draft at Full Quality would cost\n * (`POST /v1/cast-swap/:jobId/full-quality/estimate`).\n */\nexport interface CastSwapFullQualityEstimate {\n  /** The quote in credits: `breakdown.castSwap + breakdown.seedanceHd`. */\n  totalCredits: number\n  /**\n   * `castSwap`: the Full Quality job's own steps; `seedanceHd`: the 1080p\n   * render of the draft's take (0 when an earlier try of this draft already\n   * finished that render, which is then reused).\n   */\n  breakdown: { castSwap: number; seedanceHd: number }\n  /** ISO time until which the draft can be finished at Full Quality (7 days after it completed). */\n  availableUntil: string\n}\n\n/** Options for {@link CastSwapResource.fullQuality}. */\nexport interface CastSwapFullQualityParams {\n  /** A generation session to file the Full Quality result in. */\n  sessionId?: string\n}\n\n/** The Full Quality job (`POST /v1/cast-swap/:jobId/full-quality`). */\nexport interface CastSwapFullQualityResult {\n  jobId: string\n  /** `true` when this draft's Full Quality was already running or done: that job is answered, nothing new is started or charged. */\n  existing?: boolean\n}\n\n/**\n * The `code` of a Full Quality refusal (`NodaroError.code`), all before\n * anything is charged:\n * - `unauthorized` (401): no authenticated user;\n * - `not_found` (404): not your job, or not a Cast Swap run; also a\n *   `sessionId` you may not use;\n * - `not_completed` (409): the run has not finished;\n * - `not_a_draft` (409): the run was not made as a draft;\n * - `draft_expired` (410): more than 7 days after the draft completed, or\n *   the draft can no longer be finished at Full Quality;\n * - `full_quality_pending` (409, `details.retryable: true`): not final — an\n *   earlier try's 1080p render of this draft is being reviewed, or has not\n *   started yet; try again later (once the review ends). The only refusal\n *   that ends on its own;\n * - `full_quality_unavailable` (409): final — nothing kept to re-render, no\n *   readable completion time, or the 1080p finalize refuses this draft; on\n *   the start only, also \"failed too many times\" (every try failed) or no\n *   try can be started for this run;\n * - `insufficient_credits` (402), or in a workspace `budget_exceeded`,\n *   `member_cap_exceeded` or `user_allowance_exceeded`;\n * - `job_blocked` (422): the request was blocked by the job policy;\n * - `job_read_failed` (503, retryable), `estimate_unavailable` (503, try\n *   again shortly), `host_too_old` (503).\n *\n * Open-ended: a code not listed here may still arrive.\n */\nexport type CastSwapFullQualityRefusalCode =\n  | \"unauthorized\"\n  | \"not_found\"\n  | \"not_completed\"\n  | \"not_a_draft\"\n  | \"draft_expired\"\n  | \"full_quality_pending\"\n  | \"full_quality_unavailable\"\n  | \"insufficient_credits\"\n  | \"budget_exceeded\"\n  | \"member_cap_exceeded\"\n  | \"user_allowance_exceeded\"\n  | \"job_blocked\"\n  | \"job_read_failed\"\n  | \"estimate_unavailable\"\n  | \"host_too_old\"\n  | (string & {})\n\nexport class CastSwapResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Start a Cast Swap run (`POST /v1/cast-swap`, 202 `{ jobId }`). Returns the\n   * job to follow. With `options.idempotencyKey` (sent as the\n   * `Idempotency-Key` header; 8–200 characters, else 400) a repeat with the\n   * same key within about 10 s answers 200 `{ jobId, deduped: true }`, a later\n   * one 202 with the first run's `jobId`; nothing new starts.\n   */\n  run(params: CastSwapParams, options?: CastSwapRunOptions): Promise<{ jobId: string; deduped?: boolean }> {\n    return this.client.request(\"POST\", \"/v1/cast-swap\", {\n      body: params,\n      ...(options?.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}),\n    })\n  }\n\n  /** Quote a run before starting it (`POST /v1/cast-swap/estimate`); spends nothing. */\n  estimate(params: CastSwapParams): Promise<CastSwapEstimate> {\n    return this.client.request(\"POST\", \"/v1/cast-swap/estimate\", { body: params })\n  }\n\n  /**\n   * Quote finishing a draft at Full Quality (`POST\n   * /v1/cast-swap/:jobId/full-quality/estimate`); spends nothing. `jobId` is a\n   * finished DRAFT run (a Cast Swap or trend run made as a draft). The quote\n   * does not look for a Full Quality already running: when one is,\n   * {@link fullQuality} answers it (`existing: true`) and charges nothing.\n   * Refusals: {@link CastSwapFullQualityRefusalCode}.\n   */\n  fullQualityEstimate(jobId: string): Promise<CastSwapFullQualityEstimate> {\n    return this.client.request(\"POST\", `/v1/cast-swap/${encodeURIComponent(jobId)}/full-quality/estimate`, { body: {} })\n  }\n\n  /**\n   * Finish a draft at Full Quality (`POST /v1/cast-swap/:jobId/full-quality`):\n   * the same take re-rendered at 1080p, with the clip's audio, as a new job\n   * linked to the draft. SPENDS CREDITS: quote it first with\n   * {@link fullQualityEstimate}. Answers 202 `{ jobId }`, or 200\n   * `{ jobId, existing: true }` when this draft's Full Quality is already\n   * running or done (one per draft; a failed one may be asked again). Follow\n   * the job with `client.jobs.get(jobId)`. No `Idempotency-Key` is taken: the\n   * server keys the job by the draft. The new job keeps the draft's origin.\n   * Refusals: {@link CastSwapFullQualityRefusalCode}.\n   */\n  fullQuality(jobId: string, params: CastSwapFullQualityParams = {}): Promise<CastSwapFullQualityResult> {\n    const body = params.sessionId !== undefined ? { sessionId: params.sessionId } : {}\n    return this.client.request(\"POST\", `/v1/cast-swap/${encodeURIComponent(jobId)}/full-quality`, { body })\n  }\n}\n"]}

package/dist/chunk-FQNCIP6K.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/apps.ts"],"names":[],"mappings":"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","file":"chunk-FQNCIP6K.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * A published app — a workflow wrapped in a curated input/output presentation.\n * Returned by the public `/v1/apps/browse` endpoint.\n */\nexport interface PublishedApp {\n  id: string\n  slug: string\n  name: string\n  description?: string | null\n  creatorId: string\n  creatorName?: string | null\n  thumbnailUrl?: string | null\n  category?: string | null\n  isFeatured?: boolean\n  runCount?: number\n  /** The listed price per run; when `perMinuteCredits` is above 0, its fixed part. */\n  estimatedCredits?: number | null\n  /** The listed price holds a metered LLM call's ESTIMATE (its model's typical\n   *  call, charged its actual usage per token): show it `~N`. Absent for a\n   *  fixed price, and on a deployment running the tier-pricing rollback. */\n  estimatedCreditsIsEstimate?: true\n  /**\n   * Credits per minute of the recording the app is given, when its price\n   * follows that recording's length: the price is `estimatedCredits` plus\n   * this per minute. 0 or absent when the price does not depend on a\n   * recording's length.\n   */\n  perMinuteCredits?: number\n  /**\n   * Credits for each item beyond the creator's saved items of a list input\n   * the app's user fills: the price is the listed one plus this per further\n   * item. 0 or absent when the app has no such input.\n   */\n  perItemCredits?: number\n  /**\n   * The listed price is a range: `estimatedCredits` (with `perMinuteCredits` /\n   * `perItemCredits`) is \"from\" — the app's saved settings — and these are\n   * \"up to\": the most a run can cost over the choices the app's user has (every\n   * exposed field, at the creator's restricted values where set). Present only\n   * when they differ from \"from\"; absent on an app published before the range\n   * existed until its next publish.\n   */\n  maxEstimatedCredits?: number\n  maxPerMinuteCredits?: number\n  maxPerItemCredits?: number\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface ListAppsParams {\n  /** Substring search across app name + description. */\n  search?: string\n  /** Page size; backend caps at 50. */\n  limit?: number\n  /** Cursor token returned by the previous page. */\n  cursor?: string\n  /** Filter to a single category slug. */\n  category?: string\n}\n\nexport interface ListAppsResult {\n  data: PublishedApp[]\n  nextCursor?: string | null\n}\n\n/**\n * App detail — includes the input schema (required + optional fields end users\n * fill in) and the output mapping (which workflow nodes produce which display\n * cards).\n */\nexport interface PublishedAppDetail extends PublishedApp {\n  inputSchema: Record<string, unknown>\n  outputs: Array<{ nodeId: string; label: string; type: string }>\n  /**\n   * The app run alone: the listed price less its Render final part (run and\n   * charged separately) — fixed, per minute of the recording and per further\n   * list item. Absent from a server that predates them; read the listed\n   * `estimatedCredits` / `perMinuteCredits` / `perItemCredits` instead.\n   */\n  runEstimatedCredits?: number\n  runPerMinuteCredits?: number\n  runPerItemCredits?: number\n  /**\n   * Whether this server charges Edit Plan per started minute of the recording\n   * (otherwise in 15/30/60/90/120/180-minute steps). Absent from a server that\n   * predates it: read it as the steps.\n   */\n  editPlanPerMinute?: boolean\n}\n\nexport interface AppRunResult {\n  /** The execution-id that was started — poll via client.executions.get(). */\n  executionId: string\n  status: \"pending\" | \"running\"\n  /** App-run id (distinct from executionId — used by listRuns/getRun). */\n  runId?: string\n}\n\nexport interface AppRun {\n  id: string\n  appSlug: string\n  executionId: string\n  status: \"pending\" | \"running\" | \"completed\" | \"failed\" | \"cancelled\"\n  inputs: Record<string, unknown>\n  outputs?: Array<{ nodeId: string; type: string; url?: string; text?: string }>\n  startedAt: string\n  finishedAt?: string | null\n}\n\nexport interface ListAppRunsParams {\n  limit?: number\n  cursor?: string\n}\n\n/**\n * Result of a soft-delete (archive) operation. The run is moved to the user's\n * archive in the Nodaro UI; restoration and permanent deletion are UI-only by\n * design — SDK / MCP / API delete callers can't accidentally destroy data.\n */\nexport interface DeleteAppRunResult {\n  success: true\n  archived: true\n}\n\n/** Advanced per-run options for `apps.run`. */\nexport interface RunAppOptions {\n  /**\n   * Raw node-data overrides keyed by node id → field → value, merged onto the\n   * app's workflow for THIS run only. Reaches fields that are NOT exposed as app\n   * inputs — e.g. `{ [nodeId]: { promptPrefix: \"…\", promptSuffix: \"…\" } }` to\n   * wrap the end user's prompt with text they never see.\n   */\n  inputOverrides?: Record<string, Record<string, unknown>>\n}\n\n/** Options for `apps.resume` — the Retry of a failed app run. */\nexport interface ResumeAppRunOptions {\n  /** Answer what the Retry would run and charge, and start nothing. */\n  dryRun?: boolean\n  /**\n   * The app version you expect the Retry to run — the one starting over would\n   * run. Absent: the app's latest. A run of another version is refused with\n   * `app_run_version_changed`; send the run's own version (the refusal's\n   * `runVersion`) to continue on it anyway.\n   */\n  version?: number\n}\n\n/** One step a Retry runs again. */\nexport interface AppRunResumeStep {\n  nodeId: string\n  type: string\n  /** The node's label, or `null` when it has none. */\n  label: string | null\n}\n\n/** What a Retry would do (`apps.resume(…, { dryRun: true })`); nothing is started. */\nexport interface AppRunResumePlan {\n  runId: string\n  /** The failed execution the Retry continues. */\n  continuesExecutionId: string\n  /** The app version the Retry runs (the run's own). */\n  appVersion: number | null\n  /** Every node the Retry runs, in graph order. */\n  nodeIds: string[]\n  /** The steps that run again. */\n  steps: AppRunResumeStep[]\n  /** What the Retry is expected to charge, the creator's fee included; `null` without credits. */\n  estimatedCredits: number | null\n  /** Clips handed back at no cost. */\n  reusedClips: number\n  /** Whether your balance and your app credits cover what the Retry holds while it runs; `null` without credits. */\n  sufficient: boolean | null\n  /** Your spendable balance; `null` without credits. */\n  available: number | null\n  /** Your app credits, present only when they are what stops the Retry (it would be refused `insufficient_app_credits`). */\n  appCreditsAllowance?: number\n}\n\n/**\n * A Retry that started. `deduped: true` when a concurrent double press reached\n * the same Retry; a second call made while the first is pending is refused\n * with `already_running` (`AlreadyRunningError`) instead.\n */\nexport interface AppRunResumeResult {\n  /** The Retry's execution — the run now points at it. Poll via client.executions.get(). */\n  executionId: string\n  runId: string\n  status: \"pending\"\n  /** Every node the Retry runs. */\n  nodeIds: string[]\n  /** `true` when a concurrent press had already started this Retry. */\n  deduped?: true\n}\n\n/**\n * The `code` the server gives an `apps.resume` refusal. Nothing is written or\n * billed when a Retry is refused. How each arrives:\n * - `app_run_version_changed` as `AppRunVersionChangedError`;\n * - `already_running` as `AlreadyRunningError` (with the live `executionId`);\n * - `not_found` and `continuation_not_found` as `NotFoundError`, whose `code`\n *   is always `not_found` (the server's message is kept);\n * - `insufficient_credits` and `insufficient_app_credits` as\n *   `InsufficientCreditsError`, whose `code` is always `insufficient_credits`\n *   (the server's message says which);\n * - the rest as `NodaroError` carrying this code.\n */\nexport type AppRunResumeRefusalCode =\n  /** No such run of yours under this app. */\n  | \"not_found\"\n  /** The run's execution is not yours. */\n  | \"continuation_not_found\"\n  /** A malformed run id or body, or a component's run (continued by the run that called it). */\n  | \"validation_error\"\n  /** The app version the run ran is gone: start the run over. */\n  | \"app_run_version_unavailable\"\n  /** The app is on another version than the run ran: start over, or send `version` = the run's. */\n  | \"app_run_version_changed\"\n  /** The run's execution ran another workflow, or another version of it (rare). */\n  | \"continuation_workflow_mismatch\"\n  | \"continuation_version_mismatch\"\n  /** The run did not fail (it completed or was stopped): start it over. */\n  | \"continuation_not_failed\"\n  /** The run is still running, a Retry of it is pending, or it was started again elsewhere. */\n  | \"already_running\"\n  /** Nothing is left to retry: every step completed (409), or the app runs no step (400). */\n  | \"continuation_subset_required\"\n  /** An input the run applied sets a field the app does not let a runner set. */\n  | \"locked_field\"\n  /**\n   * The Retry would stop at a Preview with nobody to review it: retry it from the app page.\n   * (The same refusal arrives under the other preview refusal codes when a review-on use-case\n   * node holds the run; `isPreviewRefusalCode` in `@nodaro/shared/nodes` asks for all of them.)\n   */\n  | \"preview_review_required\"\n  /** Your app credits cannot cover it. */\n  | \"insufficient_app_credits\"\n  /** Your balance cannot cover it. */\n  | \"insufficient_credits\"\n  /** Billing is briefly unavailable for a workspace run (503): try again shortly. */\n  | \"billing_unavailable\"\n\nexport class AppsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** List published apps. Public — no auth required for community apps. */\n  list(params: ListAppsParams = {}): Promise<ListAppsResult> {\n    const qs = new URLSearchParams()\n    if (params.search) qs.set(\"search\", params.search)\n    if (params.limit !== undefined) qs.set(\"limit\", String(params.limit))\n    if (params.cursor) qs.set(\"cursor\", params.cursor)\n    if (params.category) qs.set(\"category\", params.category)\n    const query = qs.toString()\n    return this.client.request(\"GET\", `/v1/apps/browse${query ? `?${query}` : \"\"}`)\n  }\n\n  /** Get one app's metadata + input schema by slug. */\n  get(slug: string): Promise<{ data: PublishedAppDetail }> {\n    return this.client.request(\"GET\", `/v1/app/${encodeURIComponent(slug)}`)\n  }\n\n  /**\n   * Trigger an app run with the given input values. The keys in `inputs` must\n   * match the app's input-schema field names (see `get(slug).inputSchema`).\n   * `opts.inputOverrides` adds raw per-node overrides (see {@link RunAppOptions}).\n   * Returns the execution-id for status polling via client.executions.get().\n   */\n  run(\n    slug: string,\n    inputs: Record<string, unknown> = {},\n    opts: RunAppOptions = {},\n  ): Promise<AppRunResult> {\n    return this.client.request(\"POST\", `/v1/app/${encodeURIComponent(slug)}/run`, {\n      body: { inputs, ...(opts.inputOverrides ? { inputOverrides: opts.inputOverrides } : {}) },\n    })\n  }\n\n  /** List past runs for an app (the caller must own the app or the runs). */\n  listRuns(slug: string, params: ListAppRunsParams = {}): Promise<{ data: AppRun[]; nextCursor?: string | null }> {\n    const qs = new URLSearchParams()\n    if (params.limit !== undefined) qs.set(\"limit\", String(params.limit))\n    if (params.cursor) qs.set(\"cursor\", params.cursor)\n    const query = qs.toString()\n    return this.client.request(\n      \"GET\",\n      `/v1/app/${encodeURIComponent(slug)}/runs${query ? `?${query}` : \"\"}`,\n    )\n  }\n\n  /** Get one app-run by id. */\n  getRun(slug: string, runId: string): Promise<{ data: AppRun }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`,\n    )\n  }\n\n  /**\n   * Retry a FAILED app run from where it stopped: only the steps it did not\n   * complete run, and only those are charged; every step it completed hands\n   * on its result. It runs the version the run ran, with the inputs the run\n   * applied (it takes none of its own). The run's execution moves to the\n   * Retry's.\n   *\n   * `{ dryRun: true }` answers what the Retry would run and charge\n   * ({@link AppRunResumePlan}) and starts nothing — show it before a Retry.\n   * Refusals are listed in {@link AppRunResumeRefusalCode}; to run with other\n   * inputs or on the app's current version, start over with\n   * `run(slug, inputs)` instead.\n   *\n   * @param slug   The published app's slug.\n   * @param runId  The run's UUID (`AppRunResult.runId`, `AppRun.id`).\n   */\n  resume(slug: string, runId: string, opts: ResumeAppRunOptions & { dryRun: true }): Promise<{ data: AppRunResumePlan }>\n  resume(slug: string, runId: string, opts?: ResumeAppRunOptions & { dryRun?: false }): Promise<AppRunResumeResult>\n  resume(slug: string, runId: string, opts?: ResumeAppRunOptions): Promise<{ data: AppRunResumePlan } | AppRunResumeResult>\n  resume(slug: string, runId: string, opts: ResumeAppRunOptions = {}): Promise<{ data: AppRunResumePlan } | AppRunResumeResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}/resume`,\n      {\n        body: {\n          ...(opts.dryRun ? { dryRun: true } : {}),\n          ...(opts.version !== undefined ? { version: opts.version } : {}),\n        },\n      },\n    )\n  }\n\n  /**\n   * Archive (soft-delete) a published-app run. The run is hidden from the\n   * default run list and can be restored or permanently deleted from the\n   * archive view at https://app.nodaro.ai/archived-runs.\n   *\n   * @param slug   The published app's slug (the last path segment of its URL).\n   * @param runId  The run's UUID.\n   */\n  deleteRun(slug: string, runId: string): Promise<DeleteAppRunResult> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`,\n    )\n  }\n}\n"]}

package/dist/chunk-IGMWFEFB.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/credits.ts"],"names":[],"mappings":";AAuNA,IAAM,iBAAA,GAAoB,EAAA;AAEnB,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpB,MAAM,OAAA,GAAgC;AACpC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA;AAAA,MAC5B,KAAA;AAAA,MACA;AAAA,KACF;AACA,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,YAAA,CAAa,OAAA,GAAqC,EAAC,EAAoC;AACrF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,KAAA,EAAO,0BAAA,EAA4B;AAAA,MACpF,OAAO,EAAE,KAAA,EAAO,QAAQ,KAAA,EAAO,MAAA,EAAQ,QAAQ,MAAA;AAAO,KACvD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,GAAA,EAA0C;AACnD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA0B,MAAA,EAAQ,yBAAA,EAA2B;AAAA,MAC9E,MAAM,EAAE,MAAA,EAAQ,IAAI,KAAA,CAAM,CAAA,EAAG,iBAAiB,CAAA;AAAE,KACjD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,gBAAA,CAAiB,IAAA,GAAmB,EAAC,EAAoC;AACvE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,gCAAA,EAAkC;AAAA,MAC3F,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,iBAAA,CAAkB,KAAA,GAAgC,EAAC,EAAqC;AACtF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAiC,MAAA,EAAQ,iCAAA,EAAmC;AAAA,MAC7F,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,oBAAA,GAAwD;AACtD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,gCAAgC,CAAA;AAAA,EAC7F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUF","file":"chunk-IGMWFEFB.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Authenticated user's credit balance — the shape of `GET /v1/user/credits`'s\n * `data` field. Mirrors the canonical `UserBalance` from the backend billing\n * module (`backend/src/ee/billing/credits.ts`), the source of truth: keep this\n * in sync if that interface changes.\n */\nexport interface UserBalance {\n  total: number\n  subscription: number\n  topup: number\n  dailySpent: number\n  dailyLimit: number | null\n  monthlyAllocation: number\n  /** Stored billing tier. Display should prefer `effectiveTier`. */\n  tier: string\n  /** Derived entitlement tier: \"payg\" when stored-free with purchased credits. */\n  effectiveTier: string\n  features: Record<string, unknown>\n  periodEnd: string | null\n  /** Credits earned for app usage (free tier only — earned by running flows). */\n  appCreditsAllowance: number\n  /** Present when a deployment uses an external shared wallet. Raw credits;\n   * null means unavailable. Do not substitute the personal `total` balance. */\n  externalWallet?: { available: number | null }\n  /**\n   * Where the account's free signup grant stands. `\"withheld\"` means the\n   * account works but the grant did not land — show the activation path.\n   * Absent where the deployment has no signup grant.\n   */\n  freeGrantState?: FreeGrantState\n  /**\n   * Present only with `freeGrantState: \"withheld\"`, when the claim showed no\n   * browser signals at all: the app may say \"free credits need a regular\n   * browser — reload\", because a reload in one judges the account again.\n   */\n  freeGrantNotice?: \"browser_unmeasured\"\n  /**\n   * The welcome-credits opt-in. PRESENT only while the deployment has the\n   * offer switched on — absent means \"no popup, no banner, no block\".\n   */\n  welcomeOffer?: WelcomeOfferState\n}\n\n/** Where an account's free signup grant stands. */\nexport type FreeGrantState = \"unclaimed\" | \"granted\" | \"withheld\" | \"revoked\"\n\n/** `UserBalance.welcomeOffer` — what an app needs to show the welcome offer. */\nexport interface WelcomeOfferState {\n  /** The one-time popup was already shown (see `markWelcomeOfferSeen`). */\n  popupSeen: boolean\n  /**\n   * The account already has its credits (granted elsewhere) but still owes\n   * the email consent: the web apps block creation until it is given — the\n   * claim records it.\n   */\n  consentPending: boolean\n  /** The credits a claim grants. Name this figure in the offer; never hard-code it. */\n  credits: number\n}\n\n/** What `claimWelcomeOffer` sends: the browser signals plus the app answering. */\nexport interface WelcomeOfferClaimInput extends SignupKeys {\n  /**\n   * The answering app's slug (lowercase letters, digits and `-`, up to 40\n   * characters), recorded with the consent. A value outside that grammar is\n   * stored as absent, never refused.\n   */\n  sourceApp?: string\n  /**\n   * The interface language the user answered in — the id of a language Nodaro\n   * ships, such as `\"en\"`, `\"ja\"` or `\"pt-BR\"`. Matched exactly and\n   * case-sensitively: `\"en-US\"` or `\"pt-br\"` is stored as absent, never refused.\n   * Recorded with the consent as the language of the LATEST consent: a later\n   * \"yes\" in another language replaces it.\n   */\n  locale?: string\n}\n\n/** The answer of `POST /v1/credits/welcome-offer/claim`. */\nexport interface WelcomeOfferClaimResult {\n  /** The email consent is recorded. */\n  consent: \"granted\"\n  /** Where the free grant stands after the claim — `\"withheld\"` when the abuse gate refused it. */\n  grant: FreeGrantState\n  /** The grant's figure. A grant tops the subscription credits UP TO it (it is not added on top), so a claim that lands it leaves the subscription credits at no less than this. */\n  credits: number\n}\n\n/** The answer of `POST /v1/credits/welcome-offer/seen`. */\nexport interface WelcomeOfferSeenResult {\n  ok: true\n}\n\n/**\n * Result of `POST /v1/credits/model-costs` — a batch cost lookup for editor\n * cost previews. `data` maps each priced identifier → its credit cost.\n *\n * Per-model fault isolation (the route runs the lookups under\n * `Promise.allSettled`): identifiers with no pricing row are reported in\n * `missing` (undisplayable until an operator seeds a price) and lookup\n * failures in `errors`, instead of failing the whole batch. Callers typically\n * render `'—'` for any identifier that lands in `missing`. The hard-fail\n * policy still triggers at reservation time when the user actually runs the\n * node — this preview lookup is intentionally lenient.\n */\nexport interface ModelCostsResult {\n  data: Record<string, number>\n  missing: string[]\n  errors: string[]\n  /**\n   * Why each identifier in `errors` has no price — today only\n   * `llm_model_unpriced`: a metered LLM price key whose model has no rate on\n   * the lane it would be served on (it cannot be run). Omitted when `errors`\n   * is empty.\n   */\n  errorCodes?: Record<string, ModelCostError>\n  /**\n   * The identifiers in `data` whose figure is an ESTIMATE, not a fixed price:\n   * metered LLM price keys (`llmPriceKey` from `@nodaro/shared/llm-models`,\n   * `<feature>:<model>[:direct]`), charged on what the call actually uses.\n   * Show these as `~N`. Omitted when there are none, so a batch of fixed ids\n   * answers exactly as it always has. A metered key that lands in `missing`\n   * instead means the server is not pricing LLM calls per model — show no\n   * price for it.\n   */\n  estimates?: string[]\n}\n\n/** {@link ModelCostsResult.errorCodes} — why an identifier has no price. */\nexport interface ModelCostError {\n  /** Today only `llm_model_unpriced`; open to codes a newer server may add. */\n  code: \"llm_model_unpriced\" | (string & {})\n  /** A sentence to show the user. */\n  message: string\n}\n\n/**\n * Result of `GET /v1/credits/model-cost?model=<id>` (`data`): the credits one\n * identifier is charged. `estimate: true` marks a metered LLM price key's\n * figure as an estimate (show it as `~N`); such an answer is never cached.\n */\nexport interface ModelCostResult {\n  model: string\n  creditCost: number\n  estimate?: true\n}\n\n/**\n * The two browser signals a claim reports — SHA-256 hex digests computed by\n * `@nodaro/sdk/signup-signals` (`collectSignupKeys`). Either may be absent:\n * a browser that cannot be measured still claims, and the server treats the\n * absence as what it is. Any other value is stored as absent server-side.\n */\nexport interface SignupKeys {\n  browserKey?: string\n  deviceKey?: string\n}\n\n/** The answer of `POST /v1/credits/claim-signup-grant`. */\nexport interface SignupGrantClaimResult {\n  /** Where the account's free grant stands after this call. */\n  state: FreeGrantState\n  /** True only when THIS call moved the credits — a repeat is `false` with the same state. */\n  granted: boolean\n}\n\n/**\n * One row of `GET /v1/credits/transactions` — a run's reservation and how it\n * settled.\n *\n * Which amount to read: a run first HOLDS credits and is then settled — charged\n * all or part of the hold, the rest returned. `credits_charged` is what the run\n * cost (`null` while the hold is still open, `0` once refunded); sum it for\n * spend. `credits_reserved` is the hold, which never changes. `credits_used`\n * is the same hold under its original name, kept for existing integrations.\n */\nexport interface CreditTransaction {\n  id: string\n  /** ISO-8601. Also the paging cursor: pass the last row's value as `cursor`. */\n  created_at: string\n  /** Settled charge; `null` while `status` is `\"reserved\"`, `0` when refunded. */\n  credits_charged: number | null\n  /** The hold taken when the run was accepted. */\n  credits_reserved: number | null\n  /** The hold, under its original name. Prefer `credits_charged`. */\n  credits_used: number | null\n  /** The model or operation the credits were for. */\n  action: string | null\n  provider: string | null\n  /** Reservation lifecycle: `\"reserved\"`, `\"committed\"` or `\"refunded\"`. */\n  status: string | null\n  /** The caller's own billing details for the run (model, which pool paid, …). */\n  metadata: Record<string, unknown>\n  /** `\"workspace\"` when a class or team budget paid, not your balance. */\n  payer: \"user\" | \"workspace\"\n  workspaceId: string | null\n}\n\n/** A page of {@link CreditTransaction}s, newest first. */\nexport interface CreditTransactionsPage {\n  data: CreditTransaction[]\n  /** Pass as `cursor` for the next page; `null` when there are no more rows. */\n  nextCursor: string | null\n}\n\nexport interface CreditTransactionsOptions {\n  /** Rows per page, 1–50 (server default 20). */\n  limit?: number\n  /** The `nextCursor` of the previous page. */\n  cursor?: string\n}\n\n/** Max identifiers per `model-costs` batch — the route caps the request at 50. */\nconst MODEL_COSTS_LIMIT = 50\n\nexport class CreditsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * `GET /v1/user/credits` → the authenticated user's credit balance and tier\n   * info. Throws `UnauthorizedError` (401) when signed out, and the SDK's\n   * other typed errors on the usual statuses.\n   */\n  async balance(): Promise<UserBalance> {\n    const res = await this.client.request<{ data: UserBalance }>(\n      \"GET\",\n      \"/v1/user/credits\",\n    )\n    return res.data\n  }\n\n  /**\n   * `GET /v1/credits/transactions` → one page of the caller's credit\n   * transactions, newest first, with `nextCursor` for the next page (`null`\n   * at the end). Read `credits_charged` for what each run cost — it can be\n   * below the hold (`credits_reserved`) and is `null` while the hold is open.\n   * Cloud-only route: a self-hosted instance answers 404.\n   */\n  transactions(options: CreditTransactionsOptions = {}): Promise<CreditTransactionsPage> {\n    return this.client.request<CreditTransactionsPage>(\"GET\", \"/v1/credits/transactions\", {\n      query: { limit: options.limit, cursor: options.cursor },\n    })\n  }\n\n  /**\n   * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor\n   * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers\n   * (the route's request limit). Preserves the `{ data, missing, errors }`\n   * fault-isolation shape verbatim, plus `estimates` / `errorCodes` when a\n   * metered LLM price key was asked (see {@link ModelCostsResult}).\n   */\n  modelCosts(ids: string[]): Promise<ModelCostsResult> {\n    return this.client.request<ModelCostsResult>(\"POST\", \"/v1/credits/model-costs\", {\n      body: { models: ids.slice(0, MODEL_COSTS_LIMIT) },\n    })\n  }\n\n  /**\n   * `POST /v1/credits/claim-signup-grant` → claims the account's free signup\n   * grant, once, with the browser signals of the page making the claim.\n   *\n   * Call it once per page load as soon as the session is known, and never\n   * wait on it for rendering: it is idempotent (a decided account answers\n   * with its state and `granted: false`), it costs the user nothing when it\n   * fails (the next load asks again), and the signals are what make the\n   * claim worth sending — collect them with `collectSignupKeys()` from\n   * `@nodaro/sdk/signup-signals` and pass whatever came back, `{}` included.\n   * Cloud-only route: a self-hosted instance answers 404.\n   */\n  claimSignupGrant(keys: SignupKeys = {}): Promise<SignupGrantClaimResult> {\n    return this.client.request<SignupGrantClaimResult>(\"POST\", \"/v1/credits/claim-signup-grant\", {\n      body: keys,\n    })\n  }\n\n  /**\n   * `POST /v1/credits/welcome-offer/claim` → the user's \"yes\" to the welcome\n   * offer, as ONE server action: the marketing-email consent is recorded,\n   * then the free signup grant is claimed with that consent. The abuse gate\n   * still decides — consent is necessary, not sufficient — so read `grant`:\n   * `\"granted\"` (the grant has landed: this call topped the subscription credits up to `credits` — not added on top — or it had landed before), `\"withheld\"` (refused), `\"revoked\"` (taken back earlier; nothing moves), `\"unclaimed\"` (nothing moved — treat as a failure and let the user retry).\n   * Pass the browser signals from `collectSignupKeys()` and your app's slug.\n   *\n   * **Browser session only.** Usable from a first-party web app signed in\n   * with a Supabase session (the consent is a person's choice in a browser);\n   * an API key or OAuth app token is refused with 403. 409\n   * `welcome_offer_disabled` while the deployment has the offer off — show\n   * it only when `balance().welcomeOffer` is present. Cloud-only route: a\n   * self-hosted instance answers 404.\n   */\n  claimWelcomeOffer(input: WelcomeOfferClaimInput = {}): Promise<WelcomeOfferClaimResult> {\n    return this.client.request<WelcomeOfferClaimResult>(\"POST\", \"/v1/credits/welcome-offer/claim\", {\n      body: input,\n    })\n  }\n\n  /**\n   * `POST /v1/credits/welcome-offer/seen` → records that the one-time welcome\n   * popup was shown, so `balance().welcomeOffer.popupSeen` turns true on every\n   * app. Idempotent (the first stamp wins); a failed call only means the popup\n   * may show once more, so callers usually ignore errors.\n   *\n   * **Browser session only**, like {@link claimWelcomeOffer}: 403 for an API\n   * key or OAuth app token, 409 `welcome_offer_disabled` while the offer is\n   * off, 404 on a self-hosted instance.\n   */\n  markWelcomeOfferSeen(): Promise<WelcomeOfferSeenResult> {\n    return this.client.request<WelcomeOfferSeenResult>(\"POST\", \"/v1/credits/welcome-offer/seen\")\n  }\n\n  // NOTE: no `estimate(...)` helper. The backend exposes\n  // `POST /v1/credits/estimate-workflow` (body `{ nodes }` → `{ data: {\n  // totalCredits, nodeCount, estimate?: true } }` — `estimate` when a metered\n  // LLM node's estimate is in the total), but no consumer has a settled shape for it\n  // yet (studio pre-checks `balance >= Σ modelCosts` client-side rather than\n  // calling an estimate endpoint). Adding it now would be inventing an API\n  // surface ahead of a real caller, so it's deliberately omitted — add it when\n  // a consumer needs it, shaped to that need.\n}\n"]}

package/dist/chunk-ILG5DHQQ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/templates.ts"],"names":[],"mappings":";AA4GO,IAAM,oBAAN,MAAwB;AAAA,EAC7B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,MAAA,CAAO,MAAA,GAAgC,EAAC,EAAmC;AACzE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,sBAAA,EAAwB,EAAE,KAAA,EAAO,EAAE,GAAG,MAAA,EAAO,EAAG,CAAA;AAAA,EACpF;AAAA;AAAA,EAGA,IAAI,IAAA,EAAiC;AACnC,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,KAAA,EAAO,iBAAiB,kBAAA,CAAmB,IAAI,CAAC,CAAA,CAAE,CAAA;AAAA,EAC/E;AAAA;AAAA,EAGA,KAAA,CAAM,MAAc,MAAA,EAA2D;AAC7E,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,MAAA,EAAQ,iBAAiB,kBAAA,CAAmB,IAAI,CAAC,CAAA,MAAA,CAAA,EAAU;AAAA,MACpF,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AACF","file":"chunk-ILG5DHQQ.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Workflow-template marketplace — the PUBLIC-BY-DESIGN surfaces only:\n * browse cards, a single template with its full snapshot, and the free\n * clone-into-my-project action. Creator/admin surfaces (publish, mine,\n * favorites, metadata patch, tutorial flags) are deliberately NOT part of\n * the public SDK contract; first-party apps reach them via\n * `client.request()`.\n */\n\n/** Card returned by the marketplace browse (no snapshot payload). */\nexport interface TemplateBrowseCard {\n  id: string\n  slug: string\n  name: string\n  description: string | null\n  /** The listed price; when `estimatedPerMinuteCredits` is above 0, its fixed part. */\n  estimatedCredits: number\n  /** The listed price holds a metered LLM call's ESTIMATE (its model's typical\n   *  call, charged its actual usage per token): show it `~N`. Absent for a\n   *  fixed price, and on a deployment running the tier-pricing rollback. */\n  estimatedCreditsIsEstimate?: true\n  /**\n   * Credits per minute of the recording the template is given, when its price\n   * follows that recording's length (an Apply EDL render of a whole episode,\n   * an Edit Plan pass): the price is `estimatedCredits` plus this per minute.\n   * 0 or absent when the price does not depend on a recording's length.\n   */\n  estimatedPerMinuteCredits?: number\n  /**\n   * The listed price is a range: `estimatedCredits` / `estimatedPerMinuteCredits`\n   * are \"from\" (the saved settings), these \"up to\" — the most a run can cost over\n   * the template's exposed fields. Present only when they differ from \"from\".\n   */\n  maxEstimatedCredits?: number\n  maxEstimatedPerMinuteCredits?: number\n  category: string\n  outputTypes: string[]\n  tags: string[]\n  nodeTypesUsed: string[]\n  providersUsed: string[]\n  nodeCount: number\n  complexity: string\n  previewMediaUrl: string | null\n  previewMediaType: \"image\" | \"video\" | null\n  creatorId: string\n  creatorDisplayName: string | null\n  cloneCount: number\n  favoriteCount: number\n  createdAt: string\n}\n\nexport type TemplateSort = \"newest\" | \"popular\" | \"most-favorited\"\n\nexport interface BrowseTemplatesParams {\n  /** Opaque cursor from the previous page's `nextCursor`. */\n  cursor?: string\n  limit?: number\n  category?: string\n  outputType?: string\n  tag?: string\n  /** Full-text search over name/description/tags. */\n  search?: string\n  sort?: TemplateSort\n  /** Only templates using this node type. */\n  nodeType?: string\n  /** Only templates using this provider/model id. */\n  provider?: string\n  complexity?: string\n}\n\nexport interface BrowseTemplatesResult {\n  data: TemplateBrowseCard[]\n  /** Pass back as `cursor` to fetch the next page; `null` on the last page. */\n  nextCursor: string | null\n}\n\n/**\n * A single public template (`GET /v1/templates/:slug`) — the browse-card\n * fields plus the full workflow snapshot the viewer/clone consume. The route\n * returns the whole camelCased row, so additional columns may appear beyond\n * the ones typed here; the index signature keeps them reachable without\n * casting.\n */\nexport interface Template extends TemplateBrowseCard {\n  markdownDescription: string | null\n  /** React Flow node snapshots (generic node JSON, execution data stripped on clone). */\n  snapshotNodes: unknown[]\n  snapshotEdges: unknown[]\n  snapshotSettings: Record<string, unknown>\n  /** Channels the template is listed in (e.g. \"marketplace\", \"tutorial\"). */\n  listedIn: string[]\n  readonly [key: string]: unknown\n}\n\nexport interface CloneTemplateParams {\n  /** Target project (must belong to the caller). */\n  projectId: string\n  /** Optional name for the cloned workflow; defaults to the template's name. */\n  name?: string\n}\n\nexport interface CloneTemplateResult {\n  workflowId: string\n  projectId: string\n}\n\nexport class TemplatesResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** Browse the public template marketplace (cursor-paginated, no auth required). */\n  browse(params: BrowseTemplatesParams = {}): Promise<BrowseTemplatesResult> {\n    return this.client.request(\"GET\", \"/v1/templates/browse\", { query: { ...params } })\n  }\n\n  /** Fetch one public template by slug, including its full workflow snapshot. */\n  get(slug: string): Promise<Template> {\n    return this.client.request(\"GET\", `/v1/templates/${encodeURIComponent(slug)}`)\n  }\n\n  /** Clone a template into one of the caller's projects. Free — no credits charged. */\n  clone(slug: string, params: CloneTemplateParams): Promise<CloneTemplateResult> {\n    return this.client.request(\"POST\", `/v1/templates/${encodeURIComponent(slug)}/clone`, {\n      body: params,\n    })\n  }\n}\n"]}

package/dist/chunk-JUON5NXA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/workflows.ts"],"names":[],"mappings":"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","file":"chunk-JUON5NXA.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type {\n  GenericNode,\n  GenericEdge,\n} from \"@nodaro/shared/types\"\nimport type {\n  WorkflowExport,\n  WorkflowImportReport,\n} from \"@nodaro/shared/workflow\"\nimport type {\n  WorkflowVisibility,\n  CollaboratorRole,\n} from \"@nodaro/shared/organizations\"\n\n/**\n * Workflow metadata + (when fetched as a single record) full nodes/edges/settings.\n *\n * The list endpoint returns metadata only; `get`, `create`, and `update` return the\n * full record. `nodes`, `edges`, `settings`, and `sourcePrompt` are present only on\n * full records and omitted in list responses.\n */\nexport interface Workflow {\n  id: string\n  projectId: string | null\n  userId: string\n  name: string\n  description?: string | null\n  folderId?: string | null\n  isTemplate?: boolean\n  version?: number\n  thumbnailUrl?: string | null\n  nodes?: GenericNode[]\n  edges?: GenericEdge[]\n  settings?: Record<string, unknown>\n  sourcePrompt?: string | null\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface ListWorkflowsParams {\n  /** Required — list endpoint is `/v1/projects/:projectId/workflows`. */\n  projectId: string\n}\n\nexport interface CreateWorkflowInput {\n  /** Required — workflow is created under this project. */\n  projectId: string\n  name: string\n  description?: string\n  folderId?: string | null\n  nodes?: GenericNode[]\n  edges?: GenericEdge[]\n  settings?: Record<string, unknown>\n  sourcePrompt?: string\n}\n\nexport interface UpdateWorkflowInput {\n  name?: string\n  description?: string\n  folderId?: string | null\n  nodes?: GenericNode[]\n  edges?: GenericEdge[]\n  settings?: Record<string, unknown>\n  sourcePrompt?: string\n  thumbnailUrl?: string | null\n  /**\n   * Optimistic concurrency: the `updatedAt` your copy of the workflow was\n   * loaded with. When the row has since been written by another tab/device,\n   * the update is rejected with HTTP 409 `workflow_conflict`\n   * (`WorkflowConflictError`) carrying the current record — re-read/merge and\n   * retry instead of last-writer-wins clobbering the other writer's changes.\n   * Omit for the legacy unconditional replace.\n   */\n  expectedUpdatedAt?: string\n  /**\n   * Optimistic concurrency by monotonic version — preferred over\n   * `expectedUpdatedAt` (integer bumped by the DB on every content change).\n   */\n  expectedVersion?: number\n}\n\nexport interface RunWorkflowParams {\n  /**\n   * Optional subset of node IDs to execute. Omit to run the full workflow.\n   * With `continueMode: \"from-failed\"`, the nodes to consider (default: the\n   * nodes the run's chain was first started on, plus every node left failed or\n   * held back; see `continueMode`); the run executes only those the failed run\n   * did not complete. Every id sent counts as named: a node of work no run of\n   * the chain ever ran (each only handed on its saved results) runs and is\n   * priced, while a source, trigger, parameter picker or container keeps what\n   * the run handed on and a node set to skip never runs.\n   */\n  nodeIds?: string[]\n  /**\n   * Per-node field overrides for this run only, `{ [nodeId]: { field: value } }`,\n   * shallow-merged over each node's saved data (the node's saved results are\n   * not used). A run through the API has nobody to review a Preview render, so\n   * a workflow whose Apply EDL render is set to Preview is refused\n   * (`preview_review_required`) unless the run sets it to Final:\n   * `{ [renderNodeId]: { quality: \"final\" } }`. A node with Review before\n   * render on (Tighten Episode, Trailer) is refused the same way (turn its\n   * review off). A failed execution records what held it —\n   * `preview_review_required` / `preview_render_nested` (a render),\n   * `…_review_on` (a review-on node) or `…_mixed` (both); match all six with\n   * `isPreviewRefusalCode` from `@nodaro/shared`. A review-on Tighten Episode\n   * fed by a List is refused with `use_case_review_list_driven`; a Trailer fed\n   * by a List, with `use_case_list_driven`.\n   */\n  inputOverrides?: Record<string, Record<string, unknown>>\n  /**\n   * Continue from an earlier execution of this workflow — Render final after a\n   * run that stopped at its preview, or (with `continueMode: \"from-failed\"`) a\n   * failed run from where it stopped. The run executes `nodeIds` only\n   * (required with this field, except with `continueMode`); every other node\n   * hands on what that execution produced, not the workflow's saved results,\n   * and an Edit Plan hands on its plan with the person's review applied. The\n   * execution must be your own `completed` run of this workflow (`failed`,\n   * with `continueMode`), not of a published app version. Refused with\n   * `continuation_subset_required`, `continuation_not_found` (404),\n   * `continuation_workflow_mismatch`, `continuation_version_mismatch` or\n   * `continuation_not_completed` (409). A continuation its payer cannot cover\n   * (with or without `continueMode`, priced on the nodes it runs) throws\n   * `InsufficientCreditsError` before any execution exists, checked as a\n   * {@link WorkflowsResource.renderFinal} is.\n   */\n  continueFromExecutionId?: string\n  /**\n   * `\"from-failed\"`: continue a FAILED run (`continueFromExecutionId`) from\n   * where it stopped. It runs every node that run did not complete — of\n   * `nodeIds`, which default to the nodes the run was started on (a run\n   * started on named nodes is continued on those, a run of every node on every\n   * node; a continuation of a continuation keeps those of the first run of its\n   * chain) plus every node the run left failed or held back — and hands on\n   * what it completed,\n   * never run or charged again. That is per node: a node that failed runs\n   * again in full, every list item included. When a later continuation of it\n   * completed only part of what it left (a narrower `nodeIds`), the run builds\n   * on the newest such one: it is seeded from that run and runs only what is\n   * still left ({@link RunWorkflowResult.continuedFrom} names it). A node\n   * `nodeIds` names that no run of the chain ever ran runs too, and is priced\n   * (see `nodeIds`). A Render\n   * final, or a run of named nodes, continuing the newest of those counts as\n   * one of them too. Not combinable with {@link renderFinal}. Refused with\n   * `continuation_not_failed` (409) for a run that did not fail,\n   * `continuation_superseded` (409) when a later continuation supersedes it —\n   * the message names that run: one that failed (continue that one instead),\n   * or one that completed all this run left (the work is done, and its results\n   * are on that run) — `continuation_preview_pending` (409, a\n   * `ContinuationPreviewPendingError`) when the newest later continuation\n   * stopped at a Preview review of a render or of a Tighten Episode (the error\n   * names that run, what holds it, and in `next` the run that finishes it:\n   * `client.workflows.run(workflowId, error.next)` first — for a single render,\n   * its {@link renderFinal}), and\n   * `continuation_subset_required` (409) when nothing is left to run. Send an\n   * {@link RunWorkflowOptions.idempotencyKey} with each continuation.\n   */\n  continueMode?: \"from-failed\"\n}\n\n/** Per-call options for {@link WorkflowsResource.run}. */\nexport interface RunWorkflowOptions {\n  /**\n   * Sent as the `Idempotency-Key` header (at least 8 characters; the server\n   * ignores a shorter one). Reuse the same value when retrying the same\n   * request: the server answers the run it already started (`deduped: true`)\n   * instead of starting a second one — or, once that run is under way or has\n   * superseded the one it continued, refuses with `already_running` (an\n   * `AlreadyRunningError` carrying its `executionId`) or\n   * `continuation_superseded` naming it. Either way nothing runs twice.\n   */\n  idempotencyKey?: string\n}\n\nexport interface RunWorkflowResult {\n  executionId: string\n  status: \"pending\" | \"running\"\n  /** `true` when an `idempotencyKey` retry found the run already started: `executionId` is that run. */\n  deduped?: boolean\n  /**\n   * With `continueMode: \"from-failed\"`: the execution the run continued from —\n   * its states seed the run. The run asked for (`continueFromExecutionId`), or\n   * the newest later continuation of it that completed part of what it left.\n   * Absent on any other run, and on a `deduped` answer.\n   */\n  continuedFrom?: string\n}\n\n/**\n * A Render final: the Apply EDL render at Final for this run only, and every\n * node after it (Camera Switch first, in multicam). The server works out which\n * nodes run — the same rule as the editor's Render final button.\n */\nexport interface RenderFinalParams {\n  /** The Apply EDL render node to finalize. */\n  renderNodeId: string\n  /**\n   * The execution that stopped at the preview: your own `completed` run of\n   * this workflow. Every node the Render final does not run hands on what it\n   * produced (an Edit Plan hands on its plan with the review applied).\n   */\n  continueFromExecutionId: string\n}\n\n/** What a Render final will run and charge. Nothing is created by the quote. */\nexport interface RenderFinalQuote {\n  renderNodeId: string\n  /** The nodes the run executes, in canvas order. */\n  nodeIds: string[]\n  /** The one-shot override it runs with: `{ [renderNodeId]: { quality: \"final\" } }`. */\n  inputOverrides: Record<string, Record<string, unknown>>\n  /** Estimated credits; `null` in an edition without credits. */\n  estimatedCredits: number | null\n  /**\n   * Present (`true`) when `estimatedCredits` includes an LLM node's estimate:\n   * an LLM call is charged its actual usage after it runs, so show `~N`.\n   * Absent for a fixed price.\n   */\n  estimatedCreditsIsEstimate?: true\n  /**\n   * Whether the payer can cover `estimatedCredits`; `null` in an edition\n   * without credits. When `false`, {@link WorkflowsResource.renderFinal} is\n   * refused with `InsufficientCreditsError` before any execution exists.\n   */\n  sufficient: boolean | null\n  /**\n   * The payer's spendable credits; `null` when it is not yours to see (a\n   * deployment's operator pays) or a workspace budget pays.\n   */\n  available: number | null\n}\n\n/** A person granted access to a workflow. Email is never returned (privacy). */\nexport interface Collaborator {\n  userId: string\n  name?: string | null\n  avatar?: string | null\n  role: CollaboratorRole\n}\n\nexport interface AddCollaboratorInput {\n  /** Provide exactly one of `userId` or `email`. */\n  userId?: string\n  email?: string\n  role: CollaboratorRole\n}\n\n/** A workflow someone else shared with you, plus the role you hold on it. */\nexport interface SharedWorkflow extends Workflow {\n  grantedRole: CollaboratorRole\n}\n\n/** A grant dropped because a move took the workflow out of the workspace the\n *  access came from. */\nexport interface DroppedCollaborator {\n  userId: string\n  name: string | null\n}\n\n/**\n * The people a workflow is shared with — reached as `client.workflows.collaborators`.\n * All four endpoints are served by the organizations feature and exist only when\n * it is enabled server-side; against an install without it they 404\n * (→ `NotFoundError`). The active workspace travels on the request like every\n * other call, so a workspace admin's grants apply automatically.\n */\nexport class WorkflowCollaboratorsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** List a workflow's collaborators (id, name, avatar, role — never email). */\n  list(workflowId: string): Promise<{ data: Collaborator[] }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators`,\n    )\n  }\n\n  /** Add a collaborator by `userId` OR `email` (exactly one), at the given role. */\n  add(\n    workflowId: string,\n    input: AddCollaboratorInput,\n  ): Promise<{ data: { userId: string; role: CollaboratorRole } }> {\n    return this.client.request(\n      \"POST\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators`,\n      { body: input },\n    )\n  }\n\n  /** Change a collaborator's role. */\n  update(\n    workflowId: string,\n    userId: string,\n    input: { role: CollaboratorRole },\n  ): Promise<{ data: { userId: string; role: CollaboratorRole } }> {\n    return this.client.request(\n      \"PATCH\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators/${encodeURIComponent(userId)}`,\n      { body: input },\n    )\n  }\n\n  /** Remove a collaborator — or yourself. Returns `{ success: true }`. */\n  remove(workflowId: string, userId: string): Promise<{ success: true }> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators/${encodeURIComponent(userId)}`,\n    )\n  }\n}\n\nexport class WorkflowsResource {\n  /** The people this workflow is shared with. See {@link WorkflowCollaboratorsResource}. */\n  readonly collaborators: WorkflowCollaboratorsResource\n\n  constructor(private client: NodaroClientCore) {\n    this.collaborators = new WorkflowCollaboratorsResource(client)\n  }\n\n  /** List workflows for a project. Returns metadata only — `nodes`/`edges` are not included. */\n  list(params: ListWorkflowsParams): Promise<{ data: Workflow[] }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/projects/${encodeURIComponent(params.projectId)}/workflows`,\n    )\n  }\n\n  /** Get a workflow including its full nodes/edges/settings. */\n  get(id: string): Promise<{ data: Workflow }> {\n    return this.client.request(\"GET\", `/v1/workflows/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Get a PUBLICLY-SHARED workflow by id (`GET /v1/public/workflows/:id`) — the\n   * unauthenticated share-by-link read. Returns the workflow's nodes/edges/\n   * settings ONLY when it's opted into sharing server-side (`settings.studio.shared\n   * === true`); otherwise the route 404s (→ `NotFoundError`). No auth required —\n   * a share viewer has no session; the SDK omits the bearer when no token exists.\n   */\n  getPublic(id: string): Promise<{ data: Workflow }> {\n    return this.client.request(\"GET\", `/v1/public/workflows/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Create a workflow under a project. Returns the full record.\n   * NOTE: server route is `POST /v1/projects/:projectId/workflows`.\n   */\n  create(input: CreateWorkflowInput): Promise<{ data: Workflow }> {\n    const { projectId, ...body } = input\n    return this.client.request(\n      \"POST\",\n      `/v1/projects/${encodeURIComponent(projectId)}/workflows`,\n      { body },\n    )\n  }\n\n  /** Patch a workflow. Returns the full updated record. */\n  update(id: string, input: UpdateWorkflowInput): Promise<{ data: Workflow }> {\n    return this.client.request(\n      \"PATCH\",\n      `/v1/workflows/${encodeURIComponent(id)}`,\n      { body: input },\n    )\n  }\n\n  /** Delete a workflow. Returns `{ success: true }`. Throws `NotFoundError`\n   *  when the id doesn't exist or isn't yours (the delete is not silent). */\n  delete(id: string): Promise<{ success: true }> {\n    return this.client.request(\"DELETE\", `/v1/workflows/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Run a workflow. Returns the executionId for polling via\n   * `client.executions.get(executionId)`.\n   */\n  run(id: string, params: RunWorkflowParams = {}, options?: RunWorkflowOptions): Promise<RunWorkflowResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/workflows/${encodeURIComponent(id)}/run`,\n      {\n        body: params,\n        ...(options?.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}),\n      },\n    )\n  }\n\n  /**\n   * Render final (`renderFinal` on `POST /v1/workflows/:id/run`): run the\n   * render at Final for this run only, and every node after it, continuing the\n   * execution that stopped at its preview. The server derives the nodes and\n   * the override — send nothing else. Quote it first with\n   * {@link estimateRenderFinal}. Refused with `render_final_node_not_found`,\n   * `render_final_not_a_render`, or a continuation code (see `run`); a run\n   * its payer cannot cover throws `InsufficientCreditsError` (with `required`\n   * and, when it is yours to see, `available`) before any execution exists.\n   */\n  renderFinal(id: string, params: RenderFinalParams): Promise<RunWorkflowResult> {\n    return this.client.request(\"POST\", `/v1/workflows/${encodeURIComponent(id)}/run`, {\n      body: {\n        renderFinal: { renderNodeId: params.renderNodeId },\n        continueFromExecutionId: params.continueFromExecutionId,\n      },\n    })\n  }\n\n  /**\n   * Quote a Render final (`POST /v1/workflows/:id/render-final/estimate`): the\n   * nodes it will run, the override it runs with and its estimated credits.\n   * Nothing is created or charged.\n   */\n  estimateRenderFinal(id: string, params: RenderFinalParams): Promise<{ data: RenderFinalQuote }> {\n    return this.client.request(\"POST\", `/v1/workflows/${encodeURIComponent(id)}/render-final/estimate`, {\n      body: { renderNodeId: params.renderNodeId, continueFromExecutionId: params.continueFromExecutionId },\n    })\n  }\n\n  /**\n   * Export a workflow as a portable JSON bundle.\n   * Pass `opts.assets = true` to include character/object/location entity data.\n   */\n  export(\n    workflowId: string,\n    opts?: { assets?: boolean },\n  ): Promise<{ data: WorkflowExport }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/export`,\n      { query: { assets: opts?.assets ?? false } },\n    )\n  }\n\n  /**\n   * Import a `WorkflowExport` bundle into the specified project.\n   * Re-creates any bundled assets (characters, objects, creatures, locations)\n   * under your account, and re-points BOTH the entity nodes and every `@`-chip\n   * (`ConnectedReference`) bound in the graph at the rows it created.\n   * Media the bundle references on other hosts is copied onto this instance's\n   * storage where reachable; a bundled entity's images are copied whoever\n   * hosts them, because they are the exporter's bytes and their lifecycle is\n   * not yours. `importReport` says what was copied, what could not be reached\n   * and what was skipped (and why); `assetIdMap` maps each bundled entity id\n   * to the row created for it (for chips you hold outside the graph), and\n   * `assetsSkipped` names the entities your storage quota left uncreated —\n   * the workflow itself still lands.\n   */\n  import(input: WorkflowExport & { projectId: string }): Promise<{ data: Workflow; importReport?: WorkflowImportReport }> {\n    const { projectId, ...workflowJson } = input\n    return this.client.request(\"POST\", \"/v1/workflows/import\", {\n      body: { projectId, workflow_json: workflowJson },\n    })\n  }\n\n  /**\n   * Set a workflow's visibility — `\"private\"` (creator + explicit collaborators)\n   * or `\"workspace\"` (everyone in its workspace). Only the creator or a workspace\n   * admin may change it; anyone else gets HTTP 403. Thin wrapper over `update()`:\n   * the visibility lever lives on `PATCH /v1/workflows/:id`.\n   */\n  setVisibility(id: string, visibility: WorkflowVisibility): Promise<{ data: Workflow }> {\n    return this.client.request(\"PATCH\", `/v1/workflows/${encodeURIComponent(id)}`, {\n      body: { visibility },\n    })\n  }\n\n  /**\n   * Move a workflow to another project (`POST /v1/workflows/:id/move`); its folder\n   * is cleared. When the move takes the workflow out of a workspace, collaborator\n   * grants that came from that workspace are dropped and returned as\n   * `droppedCollaborators`.\n   */\n  move(\n    id: string,\n    params: { projectId: string },\n  ): Promise<{ data: Workflow; droppedCollaborators: DroppedCollaborator[] }> {\n    return this.client.request(\"POST\", `/v1/workflows/${encodeURIComponent(id)}/move`, {\n      body: params,\n    })\n  }\n\n  /**\n   * Workflows other people shared with you (`GET /v1/workflows/shared-with-me`) —\n   * grants on work that is NOT in a workspace you belong to (workspace work already\n   * shows in that workspace's own lists). Each carries the `grantedRole` you hold.\n   * Empty when the organizations feature is off server-side.\n   */\n  sharedWithMe(): Promise<{ data: SharedWorkflow[] }> {\n    return this.client.request(\"GET\", \"/v1/workflows/shared-with-me\")\n  }\n}\n"]}

package/dist/chunk-OIYMTGYN.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/apps.ts"],"names":[],"mappings":"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","file":"chunk-OIYMTGYN.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * A published app — a workflow wrapped in a curated input/output presentation.\n * Returned by the public `/v1/apps/browse` endpoint.\n */\nexport interface PublishedApp {\n  id: string\n  slug: string\n  name: string\n  description?: string | null\n  creatorId: string\n  creatorName?: string | null\n  thumbnailUrl?: string | null\n  category?: string | null\n  isFeatured?: boolean\n  runCount?: number\n  /** The listed price per run; when `perMinuteCredits` is above 0, its fixed part. */\n  estimatedCredits?: number | null\n  /** The listed price holds a metered LLM call's ESTIMATE (its model's typical\n   *  call, charged its actual usage per token): show it `~N`. Absent for a\n   *  fixed price, and on a deployment running the tier-pricing rollback. */\n  estimatedCreditsIsEstimate?: true\n  /**\n   * Credits per minute of the recording the app is given, when its price\n   * follows that recording's length: the price is `estimatedCredits` plus\n   * this per minute. 0 or absent when the price does not depend on a\n   * recording's length.\n   */\n  perMinuteCredits?: number\n  /**\n   * Credits for each item beyond the creator's saved items of a list input\n   * the app's user fills: the price is the listed one plus this per further\n   * item. 0 or absent when the app has no such input.\n   */\n  perItemCredits?: number\n  /**\n   * The listed price is a range: `estimatedCredits` (with `perMinuteCredits` /\n   * `perItemCredits`) is \"from\" — the app's saved settings — and these are\n   * \"up to\": the most a run can cost over the choices the app's user has (every\n   * exposed field, at the creator's restricted values where set). Present only\n   * when they differ from \"from\"; absent on an app published before the range\n   * existed until its next publish.\n   */\n  maxEstimatedCredits?: number\n  maxPerMinuteCredits?: number\n  maxPerItemCredits?: number\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface ListAppsParams {\n  /** Substring search across app name + description. */\n  search?: string\n  /** Page size; backend caps at 50. */\n  limit?: number\n  /** Cursor token returned by the previous page. */\n  cursor?: string\n  /** Filter to a single category slug. */\n  category?: string\n}\n\nexport interface ListAppsResult {\n  data: PublishedApp[]\n  nextCursor?: string | null\n}\n\n/**\n * App detail — includes the input schema (required + optional fields end users\n * fill in) and the output mapping (which workflow nodes produce which display\n * cards).\n */\nexport interface PublishedAppDetail extends PublishedApp {\n  inputSchema: Record<string, unknown>\n  outputs: Array<{ nodeId: string; label: string; type: string }>\n  /**\n   * The app run alone: the listed price less its Render final part (run and\n   * charged separately) — fixed, per minute of the recording and per further\n   * list item. Absent from a server that predates them; read the listed\n   * `estimatedCredits` / `perMinuteCredits` / `perItemCredits` instead.\n   */\n  runEstimatedCredits?: number\n  runPerMinuteCredits?: number\n  runPerItemCredits?: number\n  /**\n   * Whether this server charges Edit Plan per started minute of the recording\n   * (otherwise in 15/30/60/90/120/180-minute steps). Absent from a server that\n   * predates it: read it as the steps.\n   */\n  editPlanPerMinute?: boolean\n}\n\nexport interface AppRunResult {\n  /** The execution-id that was started — poll via client.executions.get(). */\n  executionId: string\n  status: \"pending\" | \"running\"\n  /** App-run id (distinct from executionId — used by listRuns/getRun). */\n  runId?: string\n}\n\nexport interface AppRun {\n  id: string\n  appSlug: string\n  executionId: string\n  status: \"pending\" | \"running\" | \"completed\" | \"failed\" | \"cancelled\"\n  inputs: Record<string, unknown>\n  outputs?: Array<{ nodeId: string; type: string; url?: string; text?: string }>\n  startedAt: string\n  finishedAt?: string | null\n}\n\nexport interface ListAppRunsParams {\n  limit?: number\n  cursor?: string\n}\n\n/**\n * Result of a soft-delete (archive) operation. The run is moved to the user's\n * archive in the Nodaro UI; restoration and permanent deletion are UI-only by\n * design — SDK / MCP / API delete callers can't accidentally destroy data.\n */\nexport interface DeleteAppRunResult {\n  success: true\n  archived: true\n}\n\n/** Advanced per-run options for `apps.run`. */\nexport interface RunAppOptions {\n  /**\n   * Raw node-data overrides keyed by node id → field → value, merged onto the\n   * app's workflow for THIS run only. Reaches fields that are NOT exposed as app\n   * inputs — e.g. `{ [nodeId]: { promptPrefix: \"…\", promptSuffix: \"…\" } }` to\n   * wrap the end user's prompt with text they never see.\n   */\n  inputOverrides?: Record<string, Record<string, unknown>>\n}\n\n/** Options for `apps.resume` — the Retry of a failed app run. */\nexport interface ResumeAppRunOptions {\n  /** Answer what the Retry would run and charge, and start nothing. */\n  dryRun?: boolean\n  /**\n   * The app version you expect the Retry to run — the one starting over would\n   * run. Absent: the app's latest. A run of another version is refused with\n   * `app_run_version_changed`; send the run's own version (the refusal's\n   * `runVersion`) to continue on it anyway.\n   */\n  version?: number\n}\n\n/** One step a Retry runs again. */\nexport interface AppRunResumeStep {\n  nodeId: string\n  type: string\n  /** The node's label, or `null` when it has none. */\n  label: string | null\n}\n\n/** What a Retry would do (`apps.resume(…, { dryRun: true })`); nothing is started. */\nexport interface AppRunResumePlan {\n  runId: string\n  /** The failed execution the Retry continues. */\n  continuesExecutionId: string\n  /** The app version the Retry runs (the run's own). */\n  appVersion: number | null\n  /** Every node the Retry runs, in graph order. */\n  nodeIds: string[]\n  /** The steps that run again. */\n  steps: AppRunResumeStep[]\n  /** What the Retry is expected to charge, the creator's fee included; `null` without credits. */\n  estimatedCredits: number | null\n  /** Clips handed back at no cost. */\n  reusedClips: number\n  /** Whether your balance and your app credits cover what the Retry holds while it runs; `null` without credits. */\n  sufficient: boolean | null\n  /** Your spendable balance; `null` without credits. */\n  available: number | null\n  /** Your app credits, present only when they are what stops the Retry (it would be refused `insufficient_app_credits`). */\n  appCreditsAllowance?: number\n}\n\n/**\n * A Retry that started. `deduped: true` when a concurrent double press reached\n * the same Retry; a second call made while the first is pending is refused\n * with `already_running` (`AlreadyRunningError`) instead.\n */\nexport interface AppRunResumeResult {\n  /** The Retry's execution — the run now points at it. Poll via client.executions.get(). */\n  executionId: string\n  runId: string\n  status: \"pending\"\n  /** Every node the Retry runs. */\n  nodeIds: string[]\n  /** `true` when a concurrent press had already started this Retry. */\n  deduped?: true\n}\n\n/**\n * The `code` the server gives an `apps.resume` refusal. Nothing is written or\n * billed when a Retry is refused. How each arrives:\n * - `app_run_version_changed` as `AppRunVersionChangedError`;\n * - `already_running` as `AlreadyRunningError` (with the live `executionId`);\n * - `not_found` and `continuation_not_found` as `NotFoundError`, whose `code`\n *   is always `not_found` (the server's message is kept);\n * - `insufficient_credits` and `insufficient_app_credits` as\n *   `InsufficientCreditsError`, whose `code` is always `insufficient_credits`\n *   (the server's message says which);\n * - the rest as `NodaroError` carrying this code.\n */\nexport type AppRunResumeRefusalCode =\n  /** No such run of yours under this app. */\n  | \"not_found\"\n  /** The run's execution is not yours. */\n  | \"continuation_not_found\"\n  /** A malformed run id or body, or a component's run (continued by the run that called it). */\n  | \"validation_error\"\n  /** The app version the run ran is gone: start the run over. */\n  | \"app_run_version_unavailable\"\n  /** The app is on another version than the run ran: start over, or send `version` = the run's. */\n  | \"app_run_version_changed\"\n  /** The run's execution ran another workflow, or another version of it (rare). */\n  | \"continuation_workflow_mismatch\"\n  | \"continuation_version_mismatch\"\n  /** The run did not fail (it completed or was stopped): start it over. */\n  | \"continuation_not_failed\"\n  /** The run is still running, a Retry of it is pending, or it was started again elsewhere. */\n  | \"already_running\"\n  /** Nothing is left to retry: every step completed (409), or the app runs no step (400). */\n  | \"continuation_subset_required\"\n  /** An input the run applied sets a field the app does not let a runner set. */\n  | \"locked_field\"\n  /**\n   * The Retry would stop at a Preview with nobody to review it: retry it from the app page.\n   * (The same refusal arrives under the other preview refusal codes when a review-on use-case\n   * node holds the run; `isPreviewRefusalCode` in `@nodaro/shared/nodes` asks for all of them.)\n   */\n  | \"preview_review_required\"\n  /** Your app credits cannot cover it. */\n  | \"insufficient_app_credits\"\n  /** Your balance cannot cover it. */\n  | \"insufficient_credits\"\n  /** Billing is briefly unavailable for a workspace run (503): try again shortly. */\n  | \"billing_unavailable\"\n\nexport class AppsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** List published apps. Public — no auth required for community apps. */\n  list(params: ListAppsParams = {}): Promise<ListAppsResult> {\n    const qs = new URLSearchParams()\n    if (params.search) qs.set(\"search\", params.search)\n    if (params.limit !== undefined) qs.set(\"limit\", String(params.limit))\n    if (params.cursor) qs.set(\"cursor\", params.cursor)\n    if (params.category) qs.set(\"category\", params.category)\n    const query = qs.toString()\n    return this.client.request(\"GET\", `/v1/apps/browse${query ? `?${query}` : \"\"}`)\n  }\n\n  /** Get one app's metadata + input schema by slug. */\n  get(slug: string): Promise<{ data: PublishedAppDetail }> {\n    return this.client.request(\"GET\", `/v1/app/${encodeURIComponent(slug)}`)\n  }\n\n  /**\n   * Trigger an app run with the given input values. The keys in `inputs` must\n   * match the app's input-schema field names (see `get(slug).inputSchema`).\n   * `opts.inputOverrides` adds raw per-node overrides (see {@link RunAppOptions}).\n   * Returns the execution-id for status polling via client.executions.get().\n   */\n  run(\n    slug: string,\n    inputs: Record<string, unknown> = {},\n    opts: RunAppOptions = {},\n  ): Promise<AppRunResult> {\n    return this.client.request(\"POST\", `/v1/app/${encodeURIComponent(slug)}/run`, {\n      body: { inputs, ...(opts.inputOverrides ? { inputOverrides: opts.inputOverrides } : {}) },\n    })\n  }\n\n  /** List past runs for an app (the caller must own the app or the runs). */\n  listRuns(slug: string, params: ListAppRunsParams = {}): Promise<{ data: AppRun[]; nextCursor?: string | null }> {\n    const qs = new URLSearchParams()\n    if (params.limit !== undefined) qs.set(\"limit\", String(params.limit))\n    if (params.cursor) qs.set(\"cursor\", params.cursor)\n    const query = qs.toString()\n    return this.client.request(\n      \"GET\",\n      `/v1/app/${encodeURIComponent(slug)}/runs${query ? `?${query}` : \"\"}`,\n    )\n  }\n\n  /** Get one app-run by id. */\n  getRun(slug: string, runId: string): Promise<{ data: AppRun }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`,\n    )\n  }\n\n  /**\n   * Retry a FAILED app run from where it stopped: only the steps it did not\n   * complete run, and only those are charged; every step it completed hands\n   * on its result. It runs the version the run ran, with the inputs the run\n   * applied (it takes none of its own). The run's execution moves to the\n   * Retry's.\n   *\n   * `{ dryRun: true }` answers what the Retry would run and charge\n   * ({@link AppRunResumePlan}) and starts nothing — show it before a Retry.\n   * Refusals are listed in {@link AppRunResumeRefusalCode}; to run with other\n   * inputs or on the app's current version, start over with\n   * `run(slug, inputs)` instead.\n   *\n   * @param slug   The published app's slug.\n   * @param runId  The run's UUID (`AppRunResult.runId`, `AppRun.id`).\n   */\n  resume(slug: string, runId: string, opts: ResumeAppRunOptions & { dryRun: true }): Promise<{ data: AppRunResumePlan }>\n  resume(slug: string, runId: string, opts?: ResumeAppRunOptions & { dryRun?: false }): Promise<AppRunResumeResult>\n  resume(slug: string, runId: string, opts?: ResumeAppRunOptions): Promise<{ data: AppRunResumePlan } | AppRunResumeResult>\n  resume(slug: string, runId: string, opts: ResumeAppRunOptions = {}): Promise<{ data: AppRunResumePlan } | AppRunResumeResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}/resume`,\n      {\n        body: {\n          ...(opts.dryRun ? { dryRun: true } : {}),\n          ...(opts.version !== undefined ? { version: opts.version } : {}),\n        },\n      },\n    )\n  }\n\n  /**\n   * Archive (soft-delete) a published-app run. The run is hidden from the\n   * default run list and can be restored or permanently deleted from the\n   * archive view at https://app.nodaro.ai/archived-runs.\n   *\n   * @param slug   The published app's slug (the last path segment of its URL).\n   * @param runId  The run's UUID.\n   */\n  deleteRun(slug: string, runId: string): Promise<DeleteAppRunResult> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`,\n    )\n  }\n}\n"]}

package/dist/chunk-OSX2GVZ2.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/picker-catalogs.ts"],"names":[],"mappings":";;;AAiIO,IAAM,yBAAN,MAA6B;AAAA,EAClC,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,GAAkD;AAChD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,qBAAqB,CAAA;AAAA,EACzD;AAAA;AAAA;AAAA,EAIA,YAAY,MAAA,EAAyD;AACnE,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,MAAA,EAAQ,sBAAsB,EAAE,IAAA,EAAM,QAAQ,CAAA;AAAA,EAC3E;AAAA;AAAA,EAGA,GAAA,CAAI,QAAA,EAAkB,IAAA,GAAgC,EAAC,EAAqC;AAC1F,IAAA,MAAM,EAAA,GAAK,IAAI,eAAA,EAAgB;AAC/B,IAAA,IAAI,KAAK,MAAA,EAAQ,EAAA,CAAG,GAAA,CAAI,QAAA,EAAU,KAAK,MAAM,CAAA;AAC7C,IAAA,IAAI,KAAK,QAAA,EAAU,EAAA,CAAG,GAAA,CAAI,UAAA,EAAY,KAAK,QAAQ,CAAA;AACnD,IAAA,IAAI,KAAK,KAAA,EAAO,EAAA,CAAG,GAAA,CAAI,OAAA,EAAS,KAAK,KAAK,CAAA;AAC1C,IAAA,MAAM,KAAA,GAAQ,GAAG,QAAA,EAAS;AAC1B,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,KAAA;AAAA,MACA,CAAA,oBAAA,EAAuB,mBAAmB,QAAQ,CAAC,GAAG,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAE,CAAA;AAAA,KAChF;AAAA,EACF;AACF","file":"chunk-OSX2GVZ2.cjs","sourcesContent":["import type { CharacterMotionMetadata } from \"@nodaro/shared/types\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Picker-catalog types. Mirrors `@nodaro/shared`'s `ProjectedPickerCatalog` /\n * `PickerCatalogSummary` so the SDK stays dependency-free (same convention as\n * `NodeDescriptor` mirroring node-registry).\n */\nexport interface PickerOption {\n  id: string\n  label: string\n  description?: string\n  category?: string\n  /** The prompt fragment this id injects downstream. Present only when detail=\"full\". */\n  promptHint?: string\n  /**\n   * Short professional term injected by compact hint mode; `label` is for\n   * display. Present at BOTH detail levels — a thin client renders `label`\n   * and injects `term`. Empty for a no-op (\"auto\"/\"none\") entry that injects\n   * nothing.\n   */\n  term?: string\n  icon?: string\n  /** Authored Character Motion prerequisites and sequence state. Missing means unknown. */\n  motion?: CharacterMotionMetadata\n  /**\n   * Per-option parameters — node-data fields that apply only while THIS option\n   * is picked (the Transition catalog's `wipe` → `wipeDirection`). Same shape\n   * as a catalog's `dimensions`, at both detail levels; `auto` leads each list\n   * and means \"send nothing\". Absent on every other option.\n   */\n  params?: PickerDimension[]\n  /**\n   * Absolute URL of the option's picture — a photo, 3D emoji, flag or (Nodaro\n   * Cloud only) rendered look preview — on the installation's own host, or the\n   * Nodaro CDN for look previews. Absent when the option has no picture. Use it\n   * as given: file names carry a content hash, so it can be cached for good.\n   */\n  imageUrl?: string\n}\n\nexport interface PickerDimension {\n  field: string\n  label: string\n  options: PickerOption[]\n}\n\n/** A topic a multi-dim catalog's settings are grouped under in the editor (person, styling). */\nexport interface PickerCatalogSection {\n  /** English topic name, e.g. \"Identity\", \"Beauty & Hair\". */\n  label: string\n  /** Node-data fields of the settings in this topic, in display order. */\n  fields: string[]\n  /** Absolute URL of the topic's round picture. Absent when it has none. */\n  imageUrl?: string\n}\n\nexport interface PickerCatalog {\n  nodeType: string\n  label: string\n  catalogId: string\n  kind: \"single\" | \"multi\"\n  /** single only — the node-data field the chosen id writes to. */\n  valueField?: string\n  defaultValue?: string\n  categoryOrder?: string[]\n  categoryLabels?: Record<string, string>\n  /** single-dim catalogs. */\n  options?: PickerOption[]\n  /** multi-dim catalogs. */\n  fields?: string[]\n  /** Per-field option lists. Multi-dim catalogs always carry these; a\n   *  single-dim catalog carries them when it has secondary parameter\n   *  fields beside its main picker (transition position/duration/intensity). */\n  dimensions?: PickerDimension[]\n  detail?: \"compact\" | \"full\"\n  /** person and styling: the topics their settings are grouped under, in order, each with its picture. */\n  sections?: PickerCatalogSection[]\n}\n\nexport interface PickerCatalogSummary {\n  nodeType: string\n  label: string\n  catalogId: string\n  kind: \"single\" | \"multi\"\n  valueField?: string\n  fields?: string[]\n  optionCount: number\n  /** How many of those options carry an `imageUrl` (0 = no pictures). Absent from servers that predate pictures. */\n  imageCount?: number\n}\n\nexport interface GetPickerCatalogOptions {\n  /** \"compact\" (default) = id, label, category, term, icon, imageUrl; \"full\" additionally includes description + promptHint. */\n  detail?: \"compact\" | \"full\"\n  /** single-dim: filter to one category. */\n  category?: string\n  /** multi-dim: only this dimension field. */\n  field?: string\n}\n\n/** Input for `analyzeText` (POST /v1/text-to-picker). */\nexport interface TextToPickerParams {\n  /** Free-text scene/shot description to analyze. */\n  text: string\n  /** Picker node types to fill. Omit for ALL analyzable pickers (the server\n   *  fans the analysis out per family and merges). */\n  targetPickers?: string[]\n  /** Extra guidance appended to the analyzer system prompt. */\n  instructions?: string\n  /** Originating client app slug (e.g. \"cine\") — attribution only. */\n  origin?: string\n  llmModel?: string\n  reasoningEffort?: string\n}\n\nexport interface TextToPickerResult {\n  jobId: string\n  /** pickerType → dimension → chosen catalog id(s) — same shape as\n   *  describe-to-picker; hydrate pickers from it verbatim. */\n  pickerJson: Record<string, Record<string, string | string[]>>\n  /** Catalog-coverage feedback (attributes the text described that no\n   *  catalog id represents well). Surface as \"we couldn't infer X\". */\n  gaps?: {\n    missingItems: Array<{ picker: string; dimension: string; observed: string }>\n    missingCategories: Array<{ picker: string; suggestedDimension: string; observed: string }>\n  }\n}\n\nexport class PickerCatalogsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** List every parameter-picker node type + its option count. Cached publicly 5 min. */\n  list(): Promise<{ data: PickerCatalogSummary[] }> {\n    return this.client.request(\"GET\", \"/v1/picker-catalogs\")\n  }\n\n  /** Fill pickers from a free-text description (Cine \"AI Fill\"): returns the\n   *  same pickerJson shape as describe-to-picker, keyed by picker node type. */\n  analyzeText(params: TextToPickerParams): Promise<TextToPickerResult> {\n    return this.client.request(\"POST\", \"/v1/text-to-picker\", { body: params })\n  }\n\n  /** Get one picker's catalog of valid values. */\n  get(nodeType: string, opts: GetPickerCatalogOptions = {}): Promise<{ data: PickerCatalog }> {\n    const qs = new URLSearchParams()\n    if (opts.detail) qs.set(\"detail\", opts.detail)\n    if (opts.category) qs.set(\"category\", opts.category)\n    if (opts.field) qs.set(\"field\", opts.field)\n    const query = qs.toString()\n    return this.client.request(\n      \"GET\",\n      `/v1/picker-catalogs/${encodeURIComponent(nodeType)}${query ? `?${query}` : \"\"}`,\n    )\n  }\n}\n"]}

package/dist/chunk-PQ7OKM3E.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/credits.ts"],"names":[],"mappings":";;;AAuNA,IAAM,iBAAA,GAAoB,EAAA;AAEnB,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpB,MAAM,OAAA,GAAgC;AACpC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA;AAAA,MAC5B,KAAA;AAAA,MACA;AAAA,KACF;AACA,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,YAAA,CAAa,OAAA,GAAqC,EAAC,EAAoC;AACrF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,KAAA,EAAO,0BAAA,EAA4B;AAAA,MACpF,OAAO,EAAE,KAAA,EAAO,QAAQ,KAAA,EAAO,MAAA,EAAQ,QAAQ,MAAA;AAAO,KACvD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,GAAA,EAA0C;AACnD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA0B,MAAA,EAAQ,yBAAA,EAA2B;AAAA,MAC9E,MAAM,EAAE,MAAA,EAAQ,IAAI,KAAA,CAAM,CAAA,EAAG,iBAAiB,CAAA;AAAE,KACjD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,gBAAA,CAAiB,IAAA,GAAmB,EAAC,EAAoC;AACvE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,gCAAA,EAAkC;AAAA,MAC3F,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,iBAAA,CAAkB,KAAA,GAAgC,EAAC,EAAqC;AACtF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAiC,MAAA,EAAQ,iCAAA,EAAmC;AAAA,MAC7F,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,oBAAA,GAAwD;AACtD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,gCAAgC,CAAA;AAAA,EAC7F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUF","file":"chunk-PQ7OKM3E.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Authenticated user's credit balance — the shape of `GET /v1/user/credits`'s\n * `data` field. Mirrors the canonical `UserBalance` from the backend billing\n * module (`backend/src/ee/billing/credits.ts`), the source of truth: keep this\n * in sync if that interface changes.\n */\nexport interface UserBalance {\n  total: number\n  subscription: number\n  topup: number\n  dailySpent: number\n  dailyLimit: number | null\n  monthlyAllocation: number\n  /** Stored billing tier. Display should prefer `effectiveTier`. */\n  tier: string\n  /** Derived entitlement tier: \"payg\" when stored-free with purchased credits. */\n  effectiveTier: string\n  features: Record<string, unknown>\n  periodEnd: string | null\n  /** Credits earned for app usage (free tier only — earned by running flows). */\n  appCreditsAllowance: number\n  /** Present when a deployment uses an external shared wallet. Raw credits;\n   * null means unavailable. Do not substitute the personal `total` balance. */\n  externalWallet?: { available: number | null }\n  /**\n   * Where the account's free signup grant stands. `\"withheld\"` means the\n   * account works but the grant did not land — show the activation path.\n   * Absent where the deployment has no signup grant.\n   */\n  freeGrantState?: FreeGrantState\n  /**\n   * Present only with `freeGrantState: \"withheld\"`, when the claim showed no\n   * browser signals at all: the app may say \"free credits need a regular\n   * browser — reload\", because a reload in one judges the account again.\n   */\n  freeGrantNotice?: \"browser_unmeasured\"\n  /**\n   * The welcome-credits opt-in. PRESENT only while the deployment has the\n   * offer switched on — absent means \"no popup, no banner, no block\".\n   */\n  welcomeOffer?: WelcomeOfferState\n}\n\n/** Where an account's free signup grant stands. */\nexport type FreeGrantState = \"unclaimed\" | \"granted\" | \"withheld\" | \"revoked\"\n\n/** `UserBalance.welcomeOffer` — what an app needs to show the welcome offer. */\nexport interface WelcomeOfferState {\n  /** The one-time popup was already shown (see `markWelcomeOfferSeen`). */\n  popupSeen: boolean\n  /**\n   * The account already has its credits (granted elsewhere) but still owes\n   * the email consent: the web apps block creation until it is given — the\n   * claim records it.\n   */\n  consentPending: boolean\n  /** The credits a claim grants. Name this figure in the offer; never hard-code it. */\n  credits: number\n}\n\n/** What `claimWelcomeOffer` sends: the browser signals plus the app answering. */\nexport interface WelcomeOfferClaimInput extends SignupKeys {\n  /**\n   * The answering app's slug (lowercase letters, digits and `-`, up to 40\n   * characters), recorded with the consent. A value outside that grammar is\n   * stored as absent, never refused.\n   */\n  sourceApp?: string\n  /**\n   * The interface language the user answered in — the id of a language Nodaro\n   * ships, such as `\"en\"`, `\"ja\"` or `\"pt-BR\"`. Matched exactly and\n   * case-sensitively: `\"en-US\"` or `\"pt-br\"` is stored as absent, never refused.\n   * Recorded with the consent as the language of the LATEST consent: a later\n   * \"yes\" in another language replaces it.\n   */\n  locale?: string\n}\n\n/** The answer of `POST /v1/credits/welcome-offer/claim`. */\nexport interface WelcomeOfferClaimResult {\n  /** The email consent is recorded. */\n  consent: \"granted\"\n  /** Where the free grant stands after the claim — `\"withheld\"` when the abuse gate refused it. */\n  grant: FreeGrantState\n  /** The grant's figure. A grant tops the subscription credits UP TO it (it is not added on top), so a claim that lands it leaves the subscription credits at no less than this. */\n  credits: number\n}\n\n/** The answer of `POST /v1/credits/welcome-offer/seen`. */\nexport interface WelcomeOfferSeenResult {\n  ok: true\n}\n\n/**\n * Result of `POST /v1/credits/model-costs` — a batch cost lookup for editor\n * cost previews. `data` maps each priced identifier → its credit cost.\n *\n * Per-model fault isolation (the route runs the lookups under\n * `Promise.allSettled`): identifiers with no pricing row are reported in\n * `missing` (undisplayable until an operator seeds a price) and lookup\n * failures in `errors`, instead of failing the whole batch. Callers typically\n * render `'—'` for any identifier that lands in `missing`. The hard-fail\n * policy still triggers at reservation time when the user actually runs the\n * node — this preview lookup is intentionally lenient.\n */\nexport interface ModelCostsResult {\n  data: Record<string, number>\n  missing: string[]\n  errors: string[]\n  /**\n   * Why each identifier in `errors` has no price — today only\n   * `llm_model_unpriced`: a metered LLM price key whose model has no rate on\n   * the lane it would be served on (it cannot be run). Omitted when `errors`\n   * is empty.\n   */\n  errorCodes?: Record<string, ModelCostError>\n  /**\n   * The identifiers in `data` whose figure is an ESTIMATE, not a fixed price:\n   * metered LLM price keys (`llmPriceKey` from `@nodaro/shared/llm-models`,\n   * `<feature>:<model>[:direct]`), charged on what the call actually uses.\n   * Show these as `~N`. Omitted when there are none, so a batch of fixed ids\n   * answers exactly as it always has. A metered key that lands in `missing`\n   * instead means the server is not pricing LLM calls per model — show no\n   * price for it.\n   */\n  estimates?: string[]\n}\n\n/** {@link ModelCostsResult.errorCodes} — why an identifier has no price. */\nexport interface ModelCostError {\n  /** Today only `llm_model_unpriced`; open to codes a newer server may add. */\n  code: \"llm_model_unpriced\" | (string & {})\n  /** A sentence to show the user. */\n  message: string\n}\n\n/**\n * Result of `GET /v1/credits/model-cost?model=<id>` (`data`): the credits one\n * identifier is charged. `estimate: true` marks a metered LLM price key's\n * figure as an estimate (show it as `~N`); such an answer is never cached.\n */\nexport interface ModelCostResult {\n  model: string\n  creditCost: number\n  estimate?: true\n}\n\n/**\n * The two browser signals a claim reports — SHA-256 hex digests computed by\n * `@nodaro/sdk/signup-signals` (`collectSignupKeys`). Either may be absent:\n * a browser that cannot be measured still claims, and the server treats the\n * absence as what it is. Any other value is stored as absent server-side.\n */\nexport interface SignupKeys {\n  browserKey?: string\n  deviceKey?: string\n}\n\n/** The answer of `POST /v1/credits/claim-signup-grant`. */\nexport interface SignupGrantClaimResult {\n  /** Where the account's free grant stands after this call. */\n  state: FreeGrantState\n  /** True only when THIS call moved the credits — a repeat is `false` with the same state. */\n  granted: boolean\n}\n\n/**\n * One row of `GET /v1/credits/transactions` — a run's reservation and how it\n * settled.\n *\n * Which amount to read: a run first HOLDS credits and is then settled — charged\n * all or part of the hold, the rest returned. `credits_charged` is what the run\n * cost (`null` while the hold is still open, `0` once refunded); sum it for\n * spend. `credits_reserved` is the hold, which never changes. `credits_used`\n * is the same hold under its original name, kept for existing integrations.\n */\nexport interface CreditTransaction {\n  id: string\n  /** ISO-8601. Also the paging cursor: pass the last row's value as `cursor`. */\n  created_at: string\n  /** Settled charge; `null` while `status` is `\"reserved\"`, `0` when refunded. */\n  credits_charged: number | null\n  /** The hold taken when the run was accepted. */\n  credits_reserved: number | null\n  /** The hold, under its original name. Prefer `credits_charged`. */\n  credits_used: number | null\n  /** The model or operation the credits were for. */\n  action: string | null\n  provider: string | null\n  /** Reservation lifecycle: `\"reserved\"`, `\"committed\"` or `\"refunded\"`. */\n  status: string | null\n  /** The caller's own billing details for the run (model, which pool paid, …). */\n  metadata: Record<string, unknown>\n  /** `\"workspace\"` when a class or team budget paid, not your balance. */\n  payer: \"user\" | \"workspace\"\n  workspaceId: string | null\n}\n\n/** A page of {@link CreditTransaction}s, newest first. */\nexport interface CreditTransactionsPage {\n  data: CreditTransaction[]\n  /** Pass as `cursor` for the next page; `null` when there are no more rows. */\n  nextCursor: string | null\n}\n\nexport interface CreditTransactionsOptions {\n  /** Rows per page, 1–50 (server default 20). */\n  limit?: number\n  /** The `nextCursor` of the previous page. */\n  cursor?: string\n}\n\n/** Max identifiers per `model-costs` batch — the route caps the request at 50. */\nconst MODEL_COSTS_LIMIT = 50\n\nexport class CreditsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * `GET /v1/user/credits` → the authenticated user's credit balance and tier\n   * info. Throws `UnauthorizedError` (401) when signed out, and the SDK's\n   * other typed errors on the usual statuses.\n   */\n  async balance(): Promise<UserBalance> {\n    const res = await this.client.request<{ data: UserBalance }>(\n      \"GET\",\n      \"/v1/user/credits\",\n    )\n    return res.data\n  }\n\n  /**\n   * `GET /v1/credits/transactions` → one page of the caller's credit\n   * transactions, newest first, with `nextCursor` for the next page (`null`\n   * at the end). Read `credits_charged` for what each run cost — it can be\n   * below the hold (`credits_reserved`) and is `null` while the hold is open.\n   * Cloud-only route: a self-hosted instance answers 404.\n   */\n  transactions(options: CreditTransactionsOptions = {}): Promise<CreditTransactionsPage> {\n    return this.client.request<CreditTransactionsPage>(\"GET\", \"/v1/credits/transactions\", {\n      query: { limit: options.limit, cursor: options.cursor },\n    })\n  }\n\n  /**\n   * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor\n   * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers\n   * (the route's request limit). Preserves the `{ data, missing, errors }`\n   * fault-isolation shape verbatim, plus `estimates` / `errorCodes` when a\n   * metered LLM price key was asked (see {@link ModelCostsResult}).\n   */\n  modelCosts(ids: string[]): Promise<ModelCostsResult> {\n    return this.client.request<ModelCostsResult>(\"POST\", \"/v1/credits/model-costs\", {\n      body: { models: ids.slice(0, MODEL_COSTS_LIMIT) },\n    })\n  }\n\n  /**\n   * `POST /v1/credits/claim-signup-grant` → claims the account's free signup\n   * grant, once, with the browser signals of the page making the claim.\n   *\n   * Call it once per page load as soon as the session is known, and never\n   * wait on it for rendering: it is idempotent (a decided account answers\n   * with its state and `granted: false`), it costs the user nothing when it\n   * fails (the next load asks again), and the signals are what make the\n   * claim worth sending — collect them with `collectSignupKeys()` from\n   * `@nodaro/sdk/signup-signals` and pass whatever came back, `{}` included.\n   * Cloud-only route: a self-hosted instance answers 404.\n   */\n  claimSignupGrant(keys: SignupKeys = {}): Promise<SignupGrantClaimResult> {\n    return this.client.request<SignupGrantClaimResult>(\"POST\", \"/v1/credits/claim-signup-grant\", {\n      body: keys,\n    })\n  }\n\n  /**\n   * `POST /v1/credits/welcome-offer/claim` → the user's \"yes\" to the welcome\n   * offer, as ONE server action: the marketing-email consent is recorded,\n   * then the free signup grant is claimed with that consent. The abuse gate\n   * still decides — consent is necessary, not sufficient — so read `grant`:\n   * `\"granted\"` (the grant has landed: this call topped the subscription credits up to `credits` — not added on top — or it had landed before), `\"withheld\"` (refused), `\"revoked\"` (taken back earlier; nothing moves), `\"unclaimed\"` (nothing moved — treat as a failure and let the user retry).\n   * Pass the browser signals from `collectSignupKeys()` and your app's slug.\n   *\n   * **Browser session only.** Usable from a first-party web app signed in\n   * with a Supabase session (the consent is a person's choice in a browser);\n   * an API key or OAuth app token is refused with 403. 409\n   * `welcome_offer_disabled` while the deployment has the offer off — show\n   * it only when `balance().welcomeOffer` is present. Cloud-only route: a\n   * self-hosted instance answers 404.\n   */\n  claimWelcomeOffer(input: WelcomeOfferClaimInput = {}): Promise<WelcomeOfferClaimResult> {\n    return this.client.request<WelcomeOfferClaimResult>(\"POST\", \"/v1/credits/welcome-offer/claim\", {\n      body: input,\n    })\n  }\n\n  /**\n   * `POST /v1/credits/welcome-offer/seen` → records that the one-time welcome\n   * popup was shown, so `balance().welcomeOffer.popupSeen` turns true on every\n   * app. Idempotent (the first stamp wins); a failed call only means the popup\n   * may show once more, so callers usually ignore errors.\n   *\n   * **Browser session only**, like {@link claimWelcomeOffer}: 403 for an API\n   * key or OAuth app token, 409 `welcome_offer_disabled` while the offer is\n   * off, 404 on a self-hosted instance.\n   */\n  markWelcomeOfferSeen(): Promise<WelcomeOfferSeenResult> {\n    return this.client.request<WelcomeOfferSeenResult>(\"POST\", \"/v1/credits/welcome-offer/seen\")\n  }\n\n  // NOTE: no `estimate(...)` helper. The backend exposes\n  // `POST /v1/credits/estimate-workflow` (body `{ nodes }` → `{ data: {\n  // totalCredits, nodeCount, estimate?: true } }` — `estimate` when a metered\n  // LLM node's estimate is in the total), but no consumer has a settled shape for it\n  // yet (studio pre-checks `balance >= Σ modelCosts` client-side rather than\n  // calling an estimate endpoint). Adding it now would be inventing an API\n  // surface ahead of a real caller, so it's deliberately omitted — add it when\n  // a consumer needs it, shaped to that need.\n}\n"]}

package/dist/chunk-RQH6IKDC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/cast-swap.ts"],"names":[],"mappings":";AAgZO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASpB,GAAA,CAAI,QAAwB,OAAA,EAA6E;AACvG,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,eAAA,EAAiB;AAAA,MAClD,IAAA,EAAM,MAAA;AAAA,MACN,GAAI,OAAA,EAAS,cAAA,GAAiB,EAAE,OAAA,EAAS,EAAE,iBAAA,EAAmB,OAAA,CAAQ,cAAA,EAAe,EAAE,GAAI;AAAC,KAC7F,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,SAAS,MAAA,EAAmD;AAC1D,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,MAAA,EAAQ,0BAA0B,EAAE,IAAA,EAAM,QAAQ,CAAA;AAAA,EAC/E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,oBAAoB,KAAA,EAAqD;AACvE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,CAAA,cAAA,EAAiB,kBAAA,CAAmB,KAAK,CAAC,CAAA,sBAAA,CAAA,EAA0B,EAAE,IAAA,EAAM,IAAI,CAAA;AAAA,EACrH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,WAAA,CAAY,KAAA,EAAe,MAAA,GAAoC,EAAC,EAAuC;AACrG,IAAA,MAAM,IAAA,GAAO,OAAO,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,MAAA,CAAO,SAAA,EAAU,GAAI,EAAC;AACjF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,CAAA,cAAA,EAAiB,kBAAA,CAAmB,KAAK,CAAC,CAAA,aAAA,CAAA,EAAiB,EAAE,IAAA,EAAM,CAAA;AAAA,EACxG;AACF","file":"chunk-RQH6IKDC.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Cast Swap — replace the people, pets, products and/or the location in a\n * short video with your own references, keeping its motion, framing, timing\n * and sound (the clip's audio is kept, and the result is the clip's length).\n *\n * Before the video, each person, pet and product role's photos are turned\n * into one clean reference picture by an image model. This costs extra\n * credits (`breakdown.references` in the estimate), charged when it runs, even\n * if the video then fails; it adds about a minute, falls back to your own\n * photos if it fails, and is turned off with `prepareReferences: false`.\n * Locations are not prepared.\n *\n * Cloud edition only: `/v1/cast-swap` is served by the cloud plugin and 404s\n * on self-hosted installs. `run()` answers 202 with a job id; follow it with\n * `client.jobs.get(jobId)` / `client.jobs.getStatus(jobId)` like any other job.\n *\n * Repeats: pass `{ idempotencyKey }` to `run()` and it is sent as the\n * `Idempotency-Key` header. A repeat with the same key within the credit\n * guard's dedup window (about 10 s) answers 200 `{ jobId, deduped: true }` with\n * an `X-Dedup-Hit` header; a later one answers 202 with the first run's\n * `jobId`. Nothing new is started or charged.\n *\n * Refusals (thrown as a `NodaroError` subclass; body `{ error: { code, message } }`), before\n * anything is charged: 400 `validation_error` (the body: no role with images,\n * no reference and no `prePrompt` or `postPrompt`, more roles of a kind\n * than allowed, more than 30 images in all, `draft: true` above 480p, a\n * `prePrompt` or `postPrompt` over 4,000 characters, a `faceMasking` setting\n * out of range), `raw_reference_token` (also in a reference's `line`),\n * `invalid_role_mention` (also any `{role:N}` in a reference's `line`),\n * `unsafe_url`, `video_unreadable`, `clip_out_of_range` (4–30 s),\n * `preview_out_of_range`, `no_roles_in_preview` (a preview with every role\n * `inPreview: false`, always refused even with a prompt, or with no role kept\n * in it that has images and no `prePrompt` or `postPrompt`), `prompt_too_long`\n * (the prompt would build too long: a `{role:N}` reads as the role's name when\n * it sends no images); 401; 402 `insufficient_credits` (`run()` only); 404\n * (a `sessionId` you may not use, `run()` only); 422 `job_blocked` (`run()`\n * only); 503 `host_too_old` (both); 503 `estimate_unavailable` (`estimate()`\n * only).\n */\n\n/** Whether a swapped subject takes this trait from the references (`\"new\"`) or keeps the video's (`\"original\"`). */\nexport type CastSwapTraitSource = \"new\" | \"original\"\n\n/**\n * Preview-only settings, on every role kind; a full run (`preview` not `true`)\n * ignores both.\n */\nexport interface CastSwapRolePreviewSettings {\n  /** The name used instead of `name` in a preview. Same rules as `name` (1–200 characters). */\n  previewName?: string\n  /**\n   * `false` leaves this role out of the preview: its reference images are not\n   * sent, not prepared and not charged, and a `{role:N}` naming it reads as its\n   * `previewName`, else its `name`. Default `true`. A preview with every role\n   * left out (always refused, even with a prompt), or with no role kept in it\n   * that has images and no pre / post prompt, answers 400 `no_roles_in_preview`.\n   */\n  inPreview?: boolean\n}\n\n/** A person in the video to recast. */\nexport interface CastSwapPersonRole extends CastSwapRolePreviewSettings {\n  kind: \"person\"\n  /** How the person is told apart in the video, e.g. `\"the woman that attacks\"`. */\n  name: string\n  /** 0–3 images of ONE person. Empty or `null` keeps the original person. */\n  images: string[] | null\n  /** Body from the references or the video. Default `\"new\"`. */\n  body?: CastSwapTraitSource\n  /** Outfit from the references or the video. Default `\"new\"`. */\n  outfit?: CastSwapTraitSource\n  /** Hairstyle and haircut from the references or the video. Default `\"new\"`. */\n  hair?: CastSwapTraitSource\n}\n\n/** The place the video happens in. */\nexport interface CastSwapLocationRole extends CastSwapRolePreviewSettings {\n  kind: \"location\"\n  /** How the place is named. Default `\"the setting\"`. */\n  name?: string\n  /** 0–3 images of ONE place. Empty or `null` keeps the original place. */\n  images: string[] | null\n}\n\n/** An animal in the video to recast. */\nexport interface CastSwapPetRole extends CastSwapRolePreviewSettings {\n  kind: \"pet\"\n  /** How the animal is told apart in the video, e.g. `\"the dog\"`. */\n  name: string\n  /** 0–3 images of ONE animal. Empty or `null` keeps the original animal. */\n  images: string[] | null\n  /** Body (shape, size and build) from the references or the video. Default `\"new\"`. */\n  body?: CastSwapTraitSource\n  /** Coat (fur, colors and markings) from the references or the video. Default `\"new\"`. */\n  coat?: CastSwapTraitSource\n}\n\n/** An object in the video to recast. */\nexport interface CastSwapProductRole extends CastSwapRolePreviewSettings {\n  kind: \"product\"\n  /** How the object is told apart in the video, e.g. `\"the can\"`. */\n  name: string\n  /** 0–3 images of ONE product. Empty or `null` keeps the original object. */\n  images: string[] | null\n  /** Shape and proportions from the references or the video. Default `\"new\"`. */\n  shape?: CastSwapTraitSource\n  /** Finish (colors, materials, label and markings) from the references or the video. Default `\"new\"`. */\n  finish?: CastSwapTraitSource\n}\n\nexport type CastSwapRole = CastSwapPersonRole | CastSwapLocationRole | CastSwapPetRole | CastSwapProductRole\n\n/**\n * A fixed reference: 1–3 images of ONE thing that no role replaces, and the\n * line that says what it is (`\"the glass she drinks from\"`). Sent as given,\n * never prepared; its images count toward the 30.\n */\nexport interface CastSwapReference {\n  /** 1–3 http(s) image URLs of one thing. */\n  images: string[]\n  /**\n   * What it is, 1–500 characters. `{image}` in the line stands for this\n   * reference's first image (`\"Use {image} for the sky\"`); a line without it\n   * gets it appended. A `{role:N}` or a raw `{image:` / `{video:` / `{audio:`\n   * token answers 400.\n   */\n  line: string\n}\n\n/**\n * Margins of the frame, each 0–49 %: a face whose centre lies in a margin is\n * not masked, so only faces inside the inner rectangle are. A margin left out\n * of a zone that is given is 0. (A `zone` left out altogether is 10 % at the\n * left and right: see `CastSwapFaceMasking.zone`.)\n */\nexport interface CastSwapFaceMaskingZone {\n  /** % of the frame's width from the left edge. Default 0 in a zone that is given. */\n  leftPct?: number\n  /** % of the frame's width from the right edge. Default 0 in a zone that is given. */\n  rightPct?: number\n  /** % of the frame's height from the top edge. Default 0. */\n  topPct?: number\n  /** % of the frame's height from the bottom edge. Default 0. */\n  bottomPct?: number\n}\n\n/**\n * Face masking: the faces in the source clip are covered before the video\n * model sees it, keeping their movement and lip timing while the rest of the\n * clip is sent as it is.\n *\n * - `\"off\"` (the same as leaving `faceMasking` out): the clip is sent as it is.\n * - `\"always\"`: the faces are masked before the first attempt. Its credits are\n *   in the quote (`breakdown.masking`, counted in `totalCredits`).\n * - `\"auto\"`: the run starts unmasked; only if the video model refuses the\n *   source clip is it retried once with the faces masked. Any other failure is\n *   not retried. The extra credits, charged only when that retry runs, are the\n *   estimate's `maskingCredits` (not in `totalCredits`).\n *\n * A completed job's output carries `faceMasking: { applied, reason }`:\n * `applied` is whether the video was made from the masked clip, and `reason`\n * is `\"always\"` (masked before the first attempt), `\"input_refused\"` (`auto`\n * retried after the source clip was refused), `\"no_faces\"` (no face was left\n * to mask after the filters: an `always` run continues unmasked; an `auto`\n * run fails with the original refusal instead) or `\"off\"`.\n */\nexport interface CastSwapFaceMasking {\n  mode: \"off\" | \"always\" | \"auto\"\n  /** What covers a masked face: `\"blur\"` (default) or `\"depth\"` (a depth-color view of it). */\n  fill?: \"blur\" | \"depth\"\n  /** Mask only faces at least this % of the frame's height, 0–100. Default 15. */\n  minFaceHeightPct?: number\n  /**\n   * Mask only faces at most this % of the frame's height, 0–100. Default 0 (no\n   * limit). When above 0 it must be at least `minFaceHeightPct` (else 400).\n   */\n  maxFaceHeightPct?: number\n  /**\n   * Leave out faces near the edges of the frame. Default (left out):\n   * `{ leftPct: 10, rightPct: 10, topPct: 0, bottomPct: 0 }`, so people at the\n   * left and right edges are not masked. `null`, or all four margins 0, means\n   * no margins.\n   */\n  zone?: CastSwapFaceMaskingZone | null\n  /** The blur's strength, 0.1–5 % of the frame's width (`fill: \"blur\"`). Default 2. */\n  blurStrengthPct?: number\n  /** How sure the face finder must be, 0.05–0.95: lower finds more faces. Default 0.5. */\n  threshold?: number\n}\n\n/** The body of `POST /v1/cast-swap` and `POST /v1/cast-swap/estimate`. */\nexport interface CastSwapParams {\n  /** The source clip, 4–30 seconds. */\n  videoUrl: string\n  /**\n   * Who and what to swap: at most 6 person roles, 1 location role, 3 pet roles\n   * and 3 product roles, with at most 30 images in all. A role with no images\n   * is skipped (that subject or place stays as in the video). At least one role\n   * with images, or a `prePrompt` or `postPrompt`, is required.\n   */\n  roles: CastSwapRole[]\n  /**\n   * Fixed references (at most 5): things the video should show that no role\n   * replaces, each with the line that names it. Their images count toward the\n   * 30. A reference alone is enough for a run (no role needs images).\n   */\n  references?: CastSwapReference[]\n  /**\n   * Your own words placed at the start of the prompt, before the role\n   * instructions; at most 4,000 characters. Mention a role as `{role:N}`, as in\n   * `postPrompt`; the same 400 refusals apply (an N outside 1..`roles.length`,\n   * a raw `{image:` / `{video:` / `{audio:` token).\n   */\n  prePrompt?: string\n  /**\n   * Extra instructions in your own words, at most 4,000 characters. Mention a\n   * role as `{role:N}`, where N is its 1-based position in `roles`\n   * (`{role:1}` is `roles[0]`; empty roles count).\n   *\n   * The route answers 400, before charging, for an N outside 1..`roles.length`,\n   * for a raw `{image:` / `{video:` / `{audio:` token in the pre or post prompt\n   * or a role's `name`, for a clip outside 4–30 s, and for a preview past the clip's\n   * end (`previewStart + 4` > its length).\n   */\n  postPrompt?: string\n  /** `true` runs on 4 seconds of the clip, starting at `previewStart`: a cheap check of the roles and choices. */\n  preview?: boolean\n  /** Where the preview starts, in seconds. Default 0. */\n  previewStart?: number\n  /** The output resolution. Default `\"480p\"`. */\n  resolution?: \"480p\" | \"720p\" | \"1080p\"\n  /**\n   * Render as a draft. Defaults to `true` at 480p and `false` above it; `true`\n   * with `\"720p\"` or `\"1080p\"` answers 400 (draft is 480p only).\n   */\n  draft?: boolean\n  /**\n   * Turn each person, pet and product role's photos into one clean reference\n   * picture before the video (extra credits, shown in `breakdown.references`;\n   * about a minute longer; falls back to your own photos if it fails).\n   * Default `true`.\n   */\n  prepareReferences?: boolean\n  /** Mask the faces in the source clip (see {@link CastSwapFaceMasking}). Default: off. */\n  faceMasking?: CastSwapFaceMasking\n  /**\n   * `\"draft\"` means 480p draft.\n   * @deprecated use `resolution` + `draft`.\n   */\n  quality?: \"draft\"\n  /** A generation session to file the result in. */\n  sessionId?: string\n  /** The client app that sent the run (stored on the job as `input_data.origin`). */\n  origin?: string\n}\n\n/** What a run would cost, in credits. */\nexport interface CastSwapEstimate {\n  /**\n   * What is held when the run starts: `breakdown.castSwap +\n   * breakdown.seedance + breakdown.references`, plus `breakdown.masking` with\n   * face masking `\"always\"`. The run is charged what it actually costs, which\n   * is expected to be `expectedCredits`.\n   */\n  totalCredits: number\n  /**\n   * The charge the run is expected to come to: `breakdown.castSwap +\n   * breakdown.seedanceExpected + breakdown.references`, plus\n   * `breakdown.masking` with face masking `\"always\"` (the hold, with the video\n   * model's expected charge in place of its hold). Never above `totalCredits`.\n   * With `\"auto\"` the masking is in neither total (see `maskingCredits`).\n   * `totalCredits` is what is held when the run starts; the run is charged\n   * what it actually costs.\n   *\n   * Absent from an older Cast Swap engine: read `totalCredits` then.\n   */\n  expectedCredits?: number\n  /**\n   * The parts of the quote:\n   * - `castSwap`: the run itself;\n   * - `seedance`: what the video model it calls holds (the video's length is\n   *   left to the model, so it is held at the model's longest output);\n   * - `seedanceExpected`: what the video model is expected to be charged (the\n   *   clip in and about as much out), never above `seedance`. It takes\n   *   `seedance`'s place in `expectedCredits`; it is not added to it. Absent\n   *   from an older Cast Swap engine, like `expectedCredits`;\n   * - `references`: preparing the reference pictures (0 when\n   *   `prepareReferences` is off or there is nothing to prepare);\n   * - `masking`: masking the faces, present only when `faceMasking` is on.\n   *   With `\"always\"` it is in both totals; with `\"auto\"` it equals\n   *   `maskingCredits` and is in neither.\n   *\n   * So the parts sum to more than either total: `seedance` and\n   * `seedanceExpected` are alternatives, and `\"auto\"` masking is outside both.\n   */\n  breakdown: { castSwap: number; seedance: number; references: number; seedanceExpected?: number; masking?: number }\n  /**\n   * Face masking `\"auto\"` only: the extra credits charged if the source clip\n   * is refused and the run is retried with the faces masked. Not in\n   * `totalCredits` or `expectedCredits`; `run()` needs credits for both the\n   * hold and this (else 402).\n   */\n  maskingCredits?: number\n  /**\n   * `true` when the video is made at Auto length (every run today): the final\n   * charge is expected to come out lower than `totalCredits`, at about\n   * `expectedCredits`.\n   */\n  settlesLower: boolean\n}\n\n/** Per-call options for {@link CastSwapResource.run}. */\nexport interface CastSwapRunOptions {\n  /**\n   * Sent as the `Idempotency-Key` header, unchanged (the SDK checks nothing;\n   * an empty string sends no header, like no key).\n   * The server takes 8–200 characters and answers 400 for any other length.\n   * Reuse the same value when retrying the same run: within about 10 s the\n   * repeat answers 200 `{ jobId, deduped: true }`, later 202 with the first\n   * run's `jobId`. Nothing new is started or charged.\n   */\n  idempotencyKey?: string\n}\n\n/**\n * What finishing a draft at Full Quality would cost\n * (`POST /v1/cast-swap/:jobId/full-quality/estimate`).\n */\nexport interface CastSwapFullQualityEstimate {\n  /** The quote in credits: `breakdown.castSwap + breakdown.seedanceHd`. */\n  totalCredits: number\n  /**\n   * `castSwap`: the Full Quality job's own steps; `seedanceHd`: the 1080p\n   * render of the draft's take (0 when an earlier try of this draft already\n   * finished that render, which is then reused).\n   */\n  breakdown: { castSwap: number; seedanceHd: number }\n  /** ISO time until which the draft can be finished at Full Quality (7 days after it completed). */\n  availableUntil: string\n}\n\n/** Options for {@link CastSwapResource.fullQuality}. */\nexport interface CastSwapFullQualityParams {\n  /** A generation session to file the Full Quality result in. */\n  sessionId?: string\n}\n\n/** The Full Quality job (`POST /v1/cast-swap/:jobId/full-quality`). */\nexport interface CastSwapFullQualityResult {\n  jobId: string\n  /** `true` when this draft's Full Quality was already running or done: that job is answered, nothing new is started or charged. */\n  existing?: boolean\n}\n\n/**\n * The `code` of a Full Quality refusal (`NodaroError.code`), all before\n * anything is charged:\n * - `unauthorized` (401): no authenticated user;\n * - `not_found` (404): not your job, or not a Cast Swap run; also a\n *   `sessionId` you may not use;\n * - `not_completed` (409): the run has not finished;\n * - `not_a_draft` (409): the run was not made as a draft;\n * - `draft_expired` (410): more than 7 days after the draft completed, or\n *   the draft can no longer be finished at Full Quality;\n * - `full_quality_pending` (409, `details.retryable: true`): not final — an\n *   earlier try's 1080p render of this draft is being reviewed, or has not\n *   started yet; try again later (once the review ends). The only refusal\n *   that ends on its own;\n * - `full_quality_unavailable` (409): final — nothing kept to re-render, no\n *   readable completion time, or the 1080p finalize refuses this draft; on\n *   the start only, also \"failed too many times\" (every try failed) or no\n *   try can be started for this run;\n * - `insufficient_credits` (402), or in a workspace `budget_exceeded`,\n *   `member_cap_exceeded` or `user_allowance_exceeded`;\n * - `job_blocked` (422): the request was blocked by the job policy;\n * - `job_read_failed` (503, retryable), `estimate_unavailable` (503, try\n *   again shortly), `host_too_old` (503).\n *\n * Open-ended: a code not listed here may still arrive.\n */\nexport type CastSwapFullQualityRefusalCode =\n  | \"unauthorized\"\n  | \"not_found\"\n  | \"not_completed\"\n  | \"not_a_draft\"\n  | \"draft_expired\"\n  | \"full_quality_pending\"\n  | \"full_quality_unavailable\"\n  | \"insufficient_credits\"\n  | \"budget_exceeded\"\n  | \"member_cap_exceeded\"\n  | \"user_allowance_exceeded\"\n  | \"job_blocked\"\n  | \"job_read_failed\"\n  | \"estimate_unavailable\"\n  | \"host_too_old\"\n  | (string & {})\n\nexport class CastSwapResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Start a Cast Swap run (`POST /v1/cast-swap`, 202 `{ jobId }`). Returns the\n   * job to follow. With `options.idempotencyKey` (sent as the\n   * `Idempotency-Key` header; 8–200 characters, else 400) a repeat with the\n   * same key within about 10 s answers 200 `{ jobId, deduped: true }`, a later\n   * one 202 with the first run's `jobId`; nothing new starts.\n   */\n  run(params: CastSwapParams, options?: CastSwapRunOptions): Promise<{ jobId: string; deduped?: boolean }> {\n    return this.client.request(\"POST\", \"/v1/cast-swap\", {\n      body: params,\n      ...(options?.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}),\n    })\n  }\n\n  /** Quote a run before starting it (`POST /v1/cast-swap/estimate`); spends nothing. */\n  estimate(params: CastSwapParams): Promise<CastSwapEstimate> {\n    return this.client.request(\"POST\", \"/v1/cast-swap/estimate\", { body: params })\n  }\n\n  /**\n   * Quote finishing a draft at Full Quality (`POST\n   * /v1/cast-swap/:jobId/full-quality/estimate`); spends nothing. `jobId` is a\n   * finished DRAFT run (a Cast Swap or trend run made as a draft). The quote\n   * does not look for a Full Quality already running: when one is,\n   * {@link fullQuality} answers it (`existing: true`) and charges nothing.\n   * Refusals: {@link CastSwapFullQualityRefusalCode}.\n   */\n  fullQualityEstimate(jobId: string): Promise<CastSwapFullQualityEstimate> {\n    return this.client.request(\"POST\", `/v1/cast-swap/${encodeURIComponent(jobId)}/full-quality/estimate`, { body: {} })\n  }\n\n  /**\n   * Finish a draft at Full Quality (`POST /v1/cast-swap/:jobId/full-quality`):\n   * the same take re-rendered at 1080p, with the clip's audio, as a new job\n   * linked to the draft. SPENDS CREDITS: quote it first with\n   * {@link fullQualityEstimate}. Answers 202 `{ jobId }`, or 200\n   * `{ jobId, existing: true }` when this draft's Full Quality is already\n   * running or done (one per draft; a failed one may be asked again). Follow\n   * the job with `client.jobs.get(jobId)`. No `Idempotency-Key` is taken: the\n   * server keys the job by the draft. The new job keeps the draft's origin.\n   * Refusals: {@link CastSwapFullQualityRefusalCode}.\n   */\n  fullQuality(jobId: string, params: CastSwapFullQualityParams = {}): Promise<CastSwapFullQualityResult> {\n    const body = params.sessionId !== undefined ? { sessionId: params.sessionId } : {}\n    return this.client.request(\"POST\", `/v1/cast-swap/${encodeURIComponent(jobId)}/full-quality`, { body })\n  }\n}\n"]}