@nodaro/sdk 2.29.0 → 2.32.0

package/dist/chunk-4NLVBYMW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/media.ts"],"names":[],"mappings":"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","file":"chunk-4NLVBYMW.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` and `coverage` (the fraction of pixels selected). Feed\n   * the mask to {@link MediaResource.maskComposite}.\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) and `audioSource`\n   * (foreground / background / mix / none). Priced per started 5 seconds of\n   * the result (foreground up to 300 s). Poll `jobs.get(jobId)` for `videoUrl`.\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-4WRDR4GN.js

@@ -0,0 +1,102 @@
+// src/resources/collections.ts
+var CollectionsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** `GET /v1/collections` → your collections with their record counts, whether the server has collections at all, and your caps. */
+  list() {
+    return this.client.request("GET", "/v1/collections");
+  }
+  /** `GET /v1/collections/:id` → one collection. */
+  get(id) {
+    return this.client.request("GET", `/v1/collections/${encodeURIComponent(id)}`);
+  }
+  /** `POST /v1/collections` → a new collection (`409 name_taken` when you have one by that name, `403 collection_limit_reached` at your cap). */
+  create(input) {
+    return this.client.request("POST", "/v1/collections", { body: input });
+  }
+  /** `PATCH /v1/collections/:id` → rename or re-describe a collection. */
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/collections/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** `DELETE /v1/collections/:id` → remove a collection and every record in it. */
+  async delete(id) {
+    await this.client.request("DELETE", `/v1/collections/${encodeURIComponent(id)}`);
+  }
+  /**
+   * `GET /v1/collections/:id/records` → the records, newest first (`order: "oldest"`
+   * flips it). Narrow with `q` (words), `since` / `until` (ISO) and `usage`
+   * (`all`, `unused` — not used yet — or `used`); page with `cursor` / `limit`
+   * (1-100, default 50). Each record carries `usedAt` / `usedBy`, and its
+   * `source` the saving workflow's name and project when it is yours.
+   */
+  records(id, params = {}) {
+    return this.client.request("GET", `/v1/collections/${encodeURIComponent(id)}/records`, {
+      query: {
+        q: params.q,
+        since: params.since,
+        until: params.until,
+        usage: params.usage,
+        status: params.status,
+        order: params.order,
+        cursor: params.cursor,
+        offset: params.offset,
+        limit: params.limit
+      }
+    });
+  }
+  /** `POST /v1/collections/:id/records/:recordId/restore` → bring a record back from the Trash; the record. */
+  restoreRecord(id, recordId) {
+    return this.client.request("POST", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}/restore`);
+  }
+  /** `POST /v1/collections/:id/records/bulk` → move up to 100 records to the Trash, bring them back, or delete records already in the Trash for good, in one call. */
+  bulkRecords(id, input) {
+    return this.client.request("POST", `/v1/collections/${encodeURIComponent(id)}/records/bulk`, { body: input });
+  }
+  /**
+   * `PATCH /v1/collections/:id/records/:recordId` → mark a record used (or not
+   * used again). `source` says who is marking it (defaults to the API). A
+   * server before the usage release answers `503 not_available`.
+   */
+  setUsed(id, recordId, used, source) {
+    return this.client.request("PATCH", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}`, {
+      body: { used, ...source ? { source } : {} }
+    });
+  }
+  /**
+   * `POST /v1/collections/:id/records` → save one record. Give the fields, or
+   * `item` (any JSON — a feed post, a search result) and let the server map it;
+   * explicit fields win. `outcome` is `inserted`, `duplicate` (the same link or
+   * dedupe key is already there — the existing record comes back) or `replayed`
+   * (a write with the same `idempotencyKey` already happened).
+   */
+  addRecord(id, input, opts = {}) {
+    return this.client.request("POST", `/v1/collections/${encodeURIComponent(id)}/records`, {
+      body: input,
+      ...opts.idempotencyKey ? { headers: { "Idempotency-Key": opts.idempotencyKey } } : {}
+    });
+  }
+  /**
+   * `DELETE /v1/collections/:id/records/:recordId` → the record moves to the
+   * collection's Trash (`restoreRecord` brings it back; `deleteRecordForever`
+   * removes it for good).
+   */
+  async deleteRecord(id, recordId) {
+    await this.client.request("DELETE", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}`);
+  }
+  /** `DELETE /v1/collections/:id/records/:recordId/permanent` → a record already in the Trash is deleted for good (`409 not_in_trash` for a live one). */
+  async deleteRecordForever(id, recordId) {
+    await this.client.request("DELETE", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}/permanent`);
+  }
+  /** `GET /v1/collections/:id/export` → the whole collection as CSV (default) or JSON text, newest first; `since`, `until`, `usage` and `q` narrow it. */
+  export(id, params = {}) {
+    return this.client.requestText("GET", `/v1/collections/${encodeURIComponent(id)}/export`, {
+      query: { format: params.format, since: params.since, until: params.until, usage: params.usage, q: params.q }
+    });
+  }
+};
+
+export { CollectionsResource };
+//# sourceMappingURL=chunk-4WRDR4GN.js.map
+//# sourceMappingURL=chunk-4WRDR4GN.js.map

package/dist/chunk-4WRDR4GN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/collections.ts"],"names":[],"mappings":";AA6BO,IAAM,sBAAN,MAA0B;AAAA,EAC/B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,GAAuC;AACrC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA+B,KAAA,EAAO,iBAAiB,CAAA;AAAA,EAC5E;AAAA;AAAA,EAGA,IAAI,EAAA,EAAiC;AACnC,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAoB,KAAA,EAAO,mBAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EAC3F;AAAA;AAAA,EAGA,OAAO,KAAA,EAAmD;AACxD,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAoB,MAAA,EAAQ,mBAAmB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACnF;AAAA;AAAA,EAGA,MAAA,CAAO,IAAY,KAAA,EAAmD;AACpE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAoB,OAAA,EAAS,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA,EAAI,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,EAC9G;AAAA;AAAA,EAGA,MAAM,OAAO,EAAA,EAA2B;AACtC,IAAA,MAAM,IAAA,CAAK,OAAO,OAAA,CAA2B,QAAA,EAAU,mBAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACpG;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAA,CAAQ,EAAA,EAAY,MAAA,GAAsC,EAAC,EAAyC;AAClG,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAqC,KAAA,EAAO,mBAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,QAAA,CAAA,EAAY;AAAA,MAClH,KAAA,EAAO;AAAA,QACL,GAAG,MAAA,CAAO,CAAA;AAAA,QACV,OAAO,MAAA,CAAO,KAAA;AAAA,QACd,OAAO,MAAA,CAAO,KAAA;AAAA,QACd,OAAO,MAAA,CAAO,KAAA;AAAA,QACd,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,OAAO,MAAA,CAAO,KAAA;AAAA,QACd,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,OAAO,MAAA,CAAO;AAAA;AAChB,KACD,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,aAAA,CAAc,IAAY,QAAA,EAA6C;AACrE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA0B,MAAA,EAAQ,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,SAAA,EAAY,kBAAA,CAAmB,QAAQ,CAAC,CAAA,QAAA,CAAU,CAAA;AAAA,EAClJ;AAAA;AAAA,EAGA,WAAA,CAAY,IAAY,KAAA,EAAyE;AAC/F,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAqC,MAAA,EAAQ,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,aAAA,CAAA,EAAiB,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,EAC3I;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAAA,CAAQ,EAAA,EAAY,QAAA,EAAkB,IAAA,EAAe,MAAA,EAA4D;AAC/G,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA0B,OAAA,EAAS,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,SAAA,EAAY,kBAAA,CAAmB,QAAQ,CAAC,CAAA,CAAA,EAAI;AAAA,MACzI,IAAA,EAAM,EAAE,IAAA,EAAM,GAAI,SAAS,EAAE,MAAA,EAAO,GAAI,EAAC;AAAG,KAC7C,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,SAAA,CAAU,EAAA,EAAY,KAAA,EAAiC,IAAA,GAAoC,EAAC,EAAuC;AACjI,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAmC,MAAA,EAAQ,mBAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,QAAA,CAAA,EAAY;AAAA,MACjH,IAAA,EAAM,KAAA;AAAA,MACN,GAAI,IAAA,CAAK,cAAA,GAAiB,EAAE,OAAA,EAAS,EAAE,iBAAA,EAAmB,IAAA,CAAK,cAAA,EAAe,EAAE,GAAI;AAAC,KACtF,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,YAAA,CAAa,EAAA,EAAY,QAAA,EAAiC;AAC9D,IAAA,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAA2B,QAAA,EAAU,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,SAAA,EAAY,kBAAA,CAAmB,QAAQ,CAAC,CAAA,CAAE,CAAA;AAAA,EAC5I;AAAA;AAAA,EAGA,MAAM,mBAAA,CAAoB,EAAA,EAAY,QAAA,EAAiC;AACrE,IAAA,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAA2B,QAAA,EAAU,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,SAAA,EAAY,kBAAA,CAAmB,QAAQ,CAAC,CAAA,UAAA,CAAY,CAAA;AAAA,EACtJ;AAAA;AAAA,EAGA,MAAA,CAAO,EAAA,EAAY,MAAA,GAAmH,EAAC,EAAoB;AACzJ,IAAA,OAAO,IAAA,CAAK,OAAO,WAAA,CAAY,KAAA,EAAO,mBAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA,CAAA,EAAW;AAAA,MACxF,OAAO,EAAE,MAAA,EAAQ,MAAA,CAAO,MAAA,EAAQ,OAAO,MAAA,CAAO,KAAA,EAAO,KAAA,EAAO,MAAA,CAAO,OAAO,KAAA,EAAO,MAAA,CAAO,KAAA,EAAO,CAAA,EAAG,OAAO,CAAA;AAAE,KAC5G,CAAA;AAAA,EACH;AACF","file":"chunk-4WRDR4GN.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type {\n  AddCollectionRecordInput,\n  AddCollectionRecordResult,\n  BulkCollectionRecordsInput,\n  BulkCollectionRecordsResult,\n  Collection,\n  CollectionExportFormat,\n  CollectionRecord,\n  CollectionRecordSource,\n  CollectionUsage,\n  CreateCollectionInput,\n  ListCollectionRecordsParams,\n  ListCollectionRecordsResult,\n  ListCollectionsResult,\n  UpdateCollectionInput,\n} from \"@nodaro/shared/nodes\"\n\n/**\n * Collections — where a workflow's records live.\n *\n * A collection is a named set of records (a title, a text, a link, media\n * links, extra fields) that the Save to Collection node writes one record per\n * item into and the Read Collection node reads back; this resource browses,\n * searches, adds, removes and exports them from code. Text and links only,\n * never files. The same link saved twice is one record. Past the plan's cap the\n * oldest records are evicted after a write (the answer says how many).\n * OAuth app tokens need `assets:read` for reads and `assets:write` for writes.\n */\nexport class CollectionsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** `GET /v1/collections` → your collections with their record counts, whether the server has collections at all, and your caps. */\n  list(): Promise<ListCollectionsResult> {\n    return this.client.request<ListCollectionsResult>(\"GET\", \"/v1/collections\")\n  }\n\n  /** `GET /v1/collections/:id` → one collection. */\n  get(id: string): Promise<Collection> {\n    return this.client.request<Collection>(\"GET\", `/v1/collections/${encodeURIComponent(id)}`)\n  }\n\n  /** `POST /v1/collections` → a new collection (`409 name_taken` when you have one by that name, `403 collection_limit_reached` at your cap). */\n  create(input: CreateCollectionInput): Promise<Collection> {\n    return this.client.request<Collection>(\"POST\", \"/v1/collections\", { body: input })\n  }\n\n  /** `PATCH /v1/collections/:id` → rename or re-describe a collection. */\n  update(id: string, input: UpdateCollectionInput): Promise<Collection> {\n    return this.client.request<Collection>(\"PATCH\", `/v1/collections/${encodeURIComponent(id)}`, { body: input })\n  }\n\n  /** `DELETE /v1/collections/:id` → remove a collection and every record in it. */\n  async delete(id: string): Promise<void> {\n    await this.client.request<{ success: true }>(\"DELETE\", `/v1/collections/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * `GET /v1/collections/:id/records` → the records, newest first (`order: \"oldest\"`\n   * flips it). Narrow with `q` (words), `since` / `until` (ISO) and `usage`\n   * (`all`, `unused` — not used yet — or `used`); page with `cursor` / `limit`\n   * (1-100, default 50). Each record carries `usedAt` / `usedBy`, and its\n   * `source` the saving workflow's name and project when it is yours.\n   */\n  records(id: string, params: ListCollectionRecordsParams = {}): Promise<ListCollectionRecordsResult> {\n    return this.client.request<ListCollectionRecordsResult>(\"GET\", `/v1/collections/${encodeURIComponent(id)}/records`, {\n      query: {\n        q: params.q,\n        since: params.since,\n        until: params.until,\n        usage: params.usage,\n        status: params.status,\n        order: params.order,\n        cursor: params.cursor,\n        offset: params.offset,\n        limit: params.limit,\n      },\n    })\n  }\n\n  /** `POST /v1/collections/:id/records/:recordId/restore` → bring a record back from the Trash; the record. */\n  restoreRecord(id: string, recordId: string): Promise<CollectionRecord> {\n    return this.client.request<CollectionRecord>(\"POST\", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}/restore`)\n  }\n\n  /** `POST /v1/collections/:id/records/bulk` → move up to 100 records to the Trash, bring them back, or delete records already in the Trash for good, in one call. */\n  bulkRecords(id: string, input: BulkCollectionRecordsInput): Promise<BulkCollectionRecordsResult> {\n    return this.client.request<BulkCollectionRecordsResult>(\"POST\", `/v1/collections/${encodeURIComponent(id)}/records/bulk`, { body: input })\n  }\n\n  /**\n   * `PATCH /v1/collections/:id/records/:recordId` → mark a record used (or not\n   * used again). `source` says who is marking it (defaults to the API). A\n   * server before the usage release answers `503 not_available`.\n   */\n  setUsed(id: string, recordId: string, used: boolean, source?: CollectionRecordSource): Promise<CollectionRecord> {\n    return this.client.request<CollectionRecord>(\"PATCH\", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}`, {\n      body: { used, ...(source ? { source } : {}) },\n    })\n  }\n\n  /**\n   * `POST /v1/collections/:id/records` → save one record. Give the fields, or\n   * `item` (any JSON — a feed post, a search result) and let the server map it;\n   * explicit fields win. `outcome` is `inserted`, `duplicate` (the same link or\n   * dedupe key is already there — the existing record comes back) or `replayed`\n   * (a write with the same `idempotencyKey` already happened).\n   */\n  addRecord(id: string, input: AddCollectionRecordInput, opts: { idempotencyKey?: string } = {}): Promise<AddCollectionRecordResult> {\n    return this.client.request<AddCollectionRecordResult>(\"POST\", `/v1/collections/${encodeURIComponent(id)}/records`, {\n      body: input,\n      ...(opts.idempotencyKey ? { headers: { \"Idempotency-Key\": opts.idempotencyKey } } : {}),\n    })\n  }\n\n  /**\n   * `DELETE /v1/collections/:id/records/:recordId` → the record moves to the\n   * collection's Trash (`restoreRecord` brings it back; `deleteRecordForever`\n   * removes it for good).\n   */\n  async deleteRecord(id: string, recordId: string): Promise<void> {\n    await this.client.request<{ success: true }>(\"DELETE\", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}`)\n  }\n\n  /** `DELETE /v1/collections/:id/records/:recordId/permanent` → a record already in the Trash is deleted for good (`409 not_in_trash` for a live one). */\n  async deleteRecordForever(id: string, recordId: string): Promise<void> {\n    await this.client.request<{ success: true }>(\"DELETE\", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}/permanent`)\n  }\n\n  /** `GET /v1/collections/:id/export` → the whole collection as CSV (default) or JSON text, newest first; `since`, `until`, `usage` and `q` narrow it. */\n  export(id: string, params: { format?: CollectionExportFormat; since?: string; until?: string; usage?: CollectionUsage; q?: string } = {}): Promise<string> {\n    return this.client.requestText(\"GET\", `/v1/collections/${encodeURIComponent(id)}/export`, {\n      query: { format: params.format, since: params.since, until: params.until, usage: params.usage, q: params.q },\n    })\n  }\n}\n"]}

package/dist/chunk-4WWSHV5G.cjs

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

package/dist/chunk-4WWSHV5G.cjs.map

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

package/dist/chunk-53SXNN3A.js

@@ -0,0 +1,80 @@
+// src/resources/apps.ts
+var AppsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** List published apps. Public — no auth required for community apps. */
+  list(params = {}) {
+    const qs = new URLSearchParams();
+    if (params.search) qs.set("search", params.search);
+    if (params.limit !== void 0) qs.set("limit", String(params.limit));
+    if (params.cursor) qs.set("cursor", params.cursor);
+    if (params.category) qs.set("category", params.category);
+    const query = qs.toString();
+    return this.client.request("GET", `/v1/apps/browse${query ? `?${query}` : ""}`);
+  }
+  /** Get one app's metadata + input schema by slug. */
+  get(slug) {
+    return this.client.request("GET", `/v1/app/${encodeURIComponent(slug)}`);
+  }
+  /**
+   * Trigger an app run with the given input values. The keys in `inputs` must
+   * match the app's input-schema field names (see `get(slug).inputSchema`).
+   * `opts.inputOverrides` adds raw per-node overrides (see {@link RunAppOptions}).
+   * Returns the execution-id for status polling via client.executions.get().
+   */
+  run(slug, inputs = {}, opts = {}) {
+    return this.client.request("POST", `/v1/app/${encodeURIComponent(slug)}/run`, {
+      body: { inputs, ...opts.inputOverrides ? { inputOverrides: opts.inputOverrides } : {} }
+    });
+  }
+  /** List past runs for an app (the caller must own the app or the runs). */
+  listRuns(slug, params = {}) {
+    const qs = new URLSearchParams();
+    if (params.limit !== void 0) qs.set("limit", String(params.limit));
+    if (params.cursor) qs.set("cursor", params.cursor);
+    const query = qs.toString();
+    return this.client.request(
+      "GET",
+      `/v1/app/${encodeURIComponent(slug)}/runs${query ? `?${query}` : ""}`
+    );
+  }
+  /** Get one app-run by id. */
+  getRun(slug, runId) {
+    return this.client.request(
+      "GET",
+      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`
+    );
+  }
+  resume(slug, runId, opts = {}) {
+    return this.client.request(
+      "POST",
+      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}/resume`,
+      {
+        body: {
+          ...opts.dryRun ? { dryRun: true } : {},
+          ...opts.version !== void 0 ? { version: opts.version } : {}
+        }
+      }
+    );
+  }
+  /**
+   * Archive (soft-delete) a published-app run. The run is hidden from the
+   * default run list and can be restored or permanently deleted from the
+   * archive view at https://app.nodaro.ai/archived-runs.
+   *
+   * @param slug   The published app's slug (the last path segment of its URL).
+   * @param runId  The run's UUID.
+   */
+  deleteRun(slug, runId) {
+    return this.client.request(
+      "DELETE",
+      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`
+    );
+  }
+};
+
+export { AppsResource };
+//# sourceMappingURL=chunk-53SXNN3A.js.map
+//# sourceMappingURL=chunk-53SXNN3A.js.map

package/dist/chunk-53SXNN3A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/apps.ts"],"names":[],"mappings":"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","file":"chunk-53SXNN3A.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  /**\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-5ALNFATQ.cjs

@@ -0,0 +1,27 @@
+'use strict';
+
+// src/resources/templates.ts
+var TemplatesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Browse the public template marketplace (cursor-paginated, no auth required). */
+  browse(params = {}) {
+    return this.client.request("GET", "/v1/templates/browse", { query: { ...params } });
+  }
+  /** Fetch one public template by slug, including its full workflow snapshot. */
+  get(slug) {
+    return this.client.request("GET", `/v1/templates/${encodeURIComponent(slug)}`);
+  }
+  /** Clone a template into one of the caller's projects. Free — no credits charged. */
+  clone(slug, params) {
+    return this.client.request("POST", `/v1/templates/${encodeURIComponent(slug)}/clone`, {
+      body: params
+    });
+  }
+};
+
+exports.TemplatesResource = TemplatesResource;
+//# sourceMappingURL=chunk-5ALNFATQ.cjs.map
+//# sourceMappingURL=chunk-5ALNFATQ.cjs.map

package/dist/chunk-5ALNFATQ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/templates.ts"],"names":[],"mappings":";;;AAwGO,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-5ALNFATQ.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  /**\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-5UQNMNUE.cjs

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

package/dist/chunk-5UQNMNUE.cjs.map

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

package/dist/chunk-65E3JBFZ.js

@@ -0,0 +1,52 @@
+// src/resources/developer-apps.ts
+var DeveloperAppsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** List the authenticated user's developer apps. */
+  list() {
+    return this.client.request("GET", "/v1/developer-apps");
+  }
+  /** Get a developer app by ID. */
+  get(id) {
+    return this.client.request("GET", `/v1/developer-apps/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Create a new developer app. Returns the app PLUS a one-time `clientSecret`
+   * — store it now, the secret hash is the only copy kept server-side.
+   */
+  create(input) {
+    return this.client.request("POST", "/v1/developer-apps", { body: input });
+  }
+  /** Update a developer app's metadata, redirect URIs, origins, or requested scopes. */
+  update(id, input) {
+    return this.client.request(
+      "PATCH",
+      `/v1/developer-apps/${encodeURIComponent(id)}`,
+      { body: input }
+    );
+  }
+  /** Delete a developer app. Returns `{ success: true }`. Throws
+   *  `NotFoundError` when the id doesn't exist or isn't yours. */
+  delete(id) {
+    return this.client.request(
+      "DELETE",
+      `/v1/developer-apps/${encodeURIComponent(id)}`
+    );
+  }
+  /**
+   * Generate a new `clientSecret`. The previous secret is invalidated.
+   * Server returns ONLY the new secret, not the full app record.
+   */
+  rotateSecret(id) {
+    return this.client.request(
+      "POST",
+      `/v1/developer-apps/${encodeURIComponent(id)}/rotate-secret`
+    );
+  }
+};
+
+export { DeveloperAppsResource };
+//# sourceMappingURL=chunk-65E3JBFZ.js.map
+//# sourceMappingURL=chunk-65E3JBFZ.js.map

package/dist/chunk-65E3JBFZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/developer-apps.ts"],"names":[],"mappings":";AAwEO,IAAM,wBAAN,MAA4B;AAAA,EACjC,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,GAA0C;AACxC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,oBAAoB,CAAA;AAAA,EACxD;AAAA;AAAA,EAGA,IAAI,EAAA,EAA6C;AAC/C,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,KAAA,EAAO,sBAAsB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EAClF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,KAAA,EAA6E;AAClF,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,MAAA,EAAQ,sBAAsB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC1E;AAAA;AAAA,EAGA,MAAA,CAAO,IAAY,KAAA,EAAiE;AAClF,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,OAAA;AAAA,MACA,CAAA,mBAAA,EAAsB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA;AAAA,MAC5C,EAAE,MAAM,KAAA;AAAM,KAChB;AAAA,EACF;AAAA;AAAA;AAAA,EAIA,OAAO,EAAA,EAAwC;AAC7C,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,QAAA;AAAA,MACA,CAAA,mBAAA,EAAsB,kBAAA,CAAmB,EAAE,CAAC,CAAA;AAAA,KAC9C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa,EAAA,EAAyC;AACpD,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,MAAA;AAAA,MACA,CAAA,mBAAA,EAAsB,kBAAA,CAAmB,EAAE,CAAC,CAAA,cAAA;AAAA,KAC9C;AAAA,EACF;AACF","file":"chunk-65E3JBFZ.js","sourcesContent":["import type { OAuthScope } from \"@nodaro/shared/apps\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * OAuth scopes that a developer app may request — the server's own list\n * (`OAUTH_SCOPES` in `@nodaro/shared`), so it cannot fall behind.\n */\nexport type DeveloperAppScope = OAuthScope\n\nexport type DeveloperAppStatus = \"active\" | \"suspended\" | \"pending_review\"\n\n/**\n * How the app came to exist. `user` is an app someone registered by hand in\n * the dashboard; the others register themselves (MCP clients via Dynamic\n * Client Registration, first-party MCP, a connected community instance).\n * Only `user` apps count toward the per-user registration cap.\n */\nexport type DeveloperAppKind = \"user\" | \"dynamic_mcp\" | \"first_party_mcp\" | \"community_instance\"\n\nexport interface DeveloperApp {\n  id: string\n  name: string\n  description: string | null\n  logoUrl: string | null\n  homepageUrl: string | null\n  redirectUris: string[]\n  allowedOrigins: string[]\n  scopesRequested: DeveloperAppScope[]\n  clientId: string\n  status: DeveloperAppStatus\n  /** Absent from servers older than this field; treat missing as `\"user\"`. */\n  kind?: DeveloperAppKind | (string & {})\n  createdAt: string\n  updatedAt: string\n}\n\n/**\n * One-shot create response — `clientSecret` is returned exactly ONCE here.\n * Store it securely; subsequent `get`/`list` calls will not include it.\n */\nexport interface CreateDeveloperAppResult extends DeveloperApp {\n  clientSecret: string\n}\n\nexport interface CreateDeveloperAppInput {\n  name: string\n  description?: string\n  homepageUrl?: string\n  logoUrl?: string\n  /** At least 1, at most 10 redirect URIs. Each must be https or http://localhost. */\n  redirectUris: string[]\n  /** Up to 5 bare origins (no path/query/hash), e.g. \"https://example.com\". */\n  allowedOrigins?: string[]\n  /** At least 1 scope required. */\n  scopesRequested: DeveloperAppScope[]\n}\n\nexport interface UpdateDeveloperAppInput {\n  name?: string\n  description?: string\n  homepageUrl?: string\n  logoUrl?: string\n  redirectUris?: string[]\n  allowedOrigins?: string[]\n  scopesRequested?: DeveloperAppScope[]\n}\n\nexport interface RotateSecretResult {\n  /** New client secret. Returned exactly once — old secret is invalidated. */\n  clientSecret: string\n}\n\nexport class DeveloperAppsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** List the authenticated user's developer apps. */\n  list(): Promise<{ data: DeveloperApp[] }> {\n    return this.client.request(\"GET\", \"/v1/developer-apps\")\n  }\n\n  /** Get a developer app by ID. */\n  get(id: string): Promise<{ data: DeveloperApp }> {\n    return this.client.request(\"GET\", `/v1/developer-apps/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Create a new developer app. Returns the app PLUS a one-time `clientSecret`\n   * — store it now, the secret hash is the only copy kept server-side.\n   */\n  create(input: CreateDeveloperAppInput): Promise<{ data: CreateDeveloperAppResult }> {\n    return this.client.request(\"POST\", \"/v1/developer-apps\", { body: input })\n  }\n\n  /** Update a developer app's metadata, redirect URIs, origins, or requested scopes. */\n  update(id: string, input: UpdateDeveloperAppInput): Promise<{ data: DeveloperApp }> {\n    return this.client.request(\n      \"PATCH\",\n      `/v1/developer-apps/${encodeURIComponent(id)}`,\n      { body: input },\n    )\n  }\n\n  /** Delete a developer app. Returns `{ success: true }`. Throws\n   *  `NotFoundError` when the id doesn't exist or isn't yours. */\n  delete(id: string): Promise<{ success: true }> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/developer-apps/${encodeURIComponent(id)}`,\n    )\n  }\n\n  /**\n   * Generate a new `clientSecret`. The previous secret is invalidated.\n   * Server returns ONLY the new secret, not the full app record.\n   */\n  rotateSecret(id: string): Promise<RotateSecretResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/developer-apps/${encodeURIComponent(id)}/rotate-secret`,\n    )\n  }\n}\n"]}