@nodaro/sdk 2.29.0 → 2.32.0

package/dist/chunk-43FVH6LJ.cjs

@@ -0,0 +1,123 @@
+'use strict';
+
+// src/resources/community.ts
+var CommunityResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * `GET /v1/community/browse` → a page of public listings plus a `nextCursor`.
+   * Pass the returned `nextCursor` back as `cursor` to fetch the next page.
+   */
+  browse(params = {}) {
+    const qs = new URLSearchParams();
+    if (params.entityType) qs.set("entityType", params.entityType);
+    if (params.q) qs.set("q", params.q);
+    if (params.category) qs.set("category", params.category);
+    if (params.sort) qs.set("sort", params.sort);
+    if (params.cursor) qs.set("cursor", params.cursor);
+    if (params.limit !== void 0) qs.set("limit", String(params.limit));
+    const query = qs.toString();
+    return this.client.request(
+      "GET",
+      `/v1/community/browse${query ? `?${query}` : ""}`
+    );
+  }
+  /** `GET /v1/community/detail/:slug` → a single listing by its slug. */
+  get(slug) {
+    return this.client.request(
+      "GET",
+      `/v1/community/detail/${encodeURIComponent(slug)}`
+    );
+  }
+  /**
+   * `GET /v1/community/detail/:slug/full` → the full read-only detail (card
+   * identity + the stored public snapshot). Like {@link get}, but includes the
+   * snapshot asset/voice/text blob needed to render the full cross-user view.
+   */
+  getFull(slug) {
+    return this.client.request(
+      "GET",
+      `/v1/community/detail/${encodeURIComponent(slug)}/full`
+    );
+  }
+  /** `GET /v1/community/favorites` → the listings you've favorited. */
+  favorites() {
+    return this.client.request("GET", "/v1/community/favorites");
+  }
+  /**
+   * `POST /v1/community/listings/:id/clone` → copy a listing into your library.
+   * Returns the new asset's `entityType` and `id`. Requires the `assets:write`
+   * scope when called with an OAuth app token.
+   */
+  clone(id, entityType) {
+    return this.client.request(
+      "POST",
+      `/v1/community/listings/${encodeURIComponent(id)}/clone`,
+      { body: { entityType } }
+    );
+  }
+  /**
+   * `POST /v1/community/listings/:id/favorite` → toggle a favorite. Returns the
+   * resulting `favorited` state (`true` after adding, `false` after removing).
+   */
+  favorite(id) {
+    return this.client.request(
+      "POST",
+      `/v1/community/listings/${encodeURIComponent(id)}/favorite`
+    );
+  }
+  /**
+   * `POST /v1/community/listings/:id/report` → flag a listing for moderation.
+   * `reason` must be one of {@link CommunityReportReason}.
+   */
+  report(id, reason) {
+    return this.client.request(
+      "POST",
+      `/v1/community/listings/${encodeURIComponent(id)}/report`,
+      { body: { reason } }
+    );
+  }
+  /**
+   * `POST /v1/admin/community/:entityType/:id/publish` → share one of YOUR
+   * entities to the community, returning the new listing's `slug` + `id`.
+   *
+   * **Requires an admin token** (the route is `requireAdmin`) AND the caller
+   * must own the source entity. Personal/OAuth tokens without admin role get a
+   * 401. For `character` listings, `params.likenessAttestation` must be `true`.
+   */
+  publish(entityType, entityId, params) {
+    return this.client.request(
+      "POST",
+      `/v1/admin/community/${encodeURIComponent(entityType)}/${encodeURIComponent(entityId)}/publish`,
+      { body: params }
+    );
+  }
+  /**
+   * `DELETE /v1/admin/community/listings/:id` → unshare (deactivate) a listing
+   * you published. **Requires an admin token** (the route is `requireAdmin`).
+   */
+  unpublish(listingId) {
+    return this.client.request(
+      "DELETE",
+      `/v1/admin/community/listings/${encodeURIComponent(listingId)}`
+    );
+  }
+  /**
+   * `GET /v1/admin/community/by-source/:entityType/:sourceId` → look up YOUR
+   * existing listing (if any) for a source entity. Returns `{ data: null }`
+   * when the entity hasn't been shared. **Requires an admin token** (the route
+   * is `requireAdmin`); only returns listings created by the caller.
+   */
+  sharedListing(entityType, sourceId) {
+    return this.client.request(
+      "GET",
+      `/v1/admin/community/by-source/${encodeURIComponent(entityType)}/${encodeURIComponent(sourceId)}`
+    );
+  }
+};
+
+exports.CommunityResource = CommunityResource;
+//# sourceMappingURL=chunk-43FVH6LJ.cjs.map
+//# sourceMappingURL=chunk-43FVH6LJ.cjs.map

package/dist/chunk-43FVH6LJ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/community.ts"],"names":[],"mappings":"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","file":"chunk-43FVH6LJ.cjs","sourcesContent":["import type { CommunityEntityType, CommunitySort, CommunityReportReason, CommunityCard, CommunityFullDetail, BrowseCommunityParams, BrowseCommunityResult, CloneListingResult, FavoriteListingResult, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing } from \"@nodaro/shared/apps\"\nexport type { CommunityEntityType, CommunitySort, CommunityReportReason, CommunityCard, CommunityFullDetail, BrowseCommunityParams, BrowseCommunityResult, CloneListingResult, FavoriteListingResult, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing } from \"@nodaro/shared/apps\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * The community-listing types are the single source of truth in\n * `@nodaro/shared` (re-used by the backend, frontend, and CLI). Re-export them\n * here so SDK consumers don't have to add `@nodaro/shared` as a second\n * dependency just to typecheck `browse`/`clone`/`favorite`/`report`.\n */\n\n/**\n * Community — browse, favorite, clone, and report shared characters,\n * locations, and objects.\n *\n * Publishing is intentionally NOT exposed here: it is admin-only via the\n * editor, and the publish route rejects personal access tokens (which is what\n * the SDK uses).\n */\nexport class CommunityResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * `GET /v1/community/browse` → a page of public listings plus a `nextCursor`.\n   * Pass the returned `nextCursor` back as `cursor` to fetch the next page.\n   */\n  browse(params: BrowseCommunityParams = {}): Promise<BrowseCommunityResult> {\n    const qs = new URLSearchParams()\n    if (params.entityType) qs.set(\"entityType\", params.entityType)\n    if (params.q) qs.set(\"q\", params.q)\n    if (params.category) qs.set(\"category\", params.category)\n    if (params.sort) qs.set(\"sort\", params.sort)\n    if (params.cursor) qs.set(\"cursor\", params.cursor)\n    if (params.limit !== undefined) qs.set(\"limit\", String(params.limit))\n    const query = qs.toString()\n    return this.client.request(\n      \"GET\",\n      `/v1/community/browse${query ? `?${query}` : \"\"}`,\n    )\n  }\n\n  /** `GET /v1/community/detail/:slug` → a single listing by its slug. */\n  get(slug: string): Promise<{ data: CommunityCard }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/community/detail/${encodeURIComponent(slug)}`,\n    )\n  }\n\n  /**\n   * `GET /v1/community/detail/:slug/full` → the full read-only detail (card\n   * identity + the stored public snapshot). Like {@link get}, but includes the\n   * snapshot asset/voice/text blob needed to render the full cross-user view.\n   */\n  getFull(slug: string): Promise<{ data: CommunityFullDetail }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/community/detail/${encodeURIComponent(slug)}/full`,\n    )\n  }\n\n  /** `GET /v1/community/favorites` → the listings you've favorited. */\n  favorites(): Promise<{ data: CommunityCard[] }> {\n    return this.client.request(\"GET\", \"/v1/community/favorites\")\n  }\n\n  /**\n   * `POST /v1/community/listings/:id/clone` → copy a listing into your library.\n   * Returns the new asset's `entityType` and `id`. Requires the `assets:write`\n   * scope when called with an OAuth app token.\n   */\n  clone(id: string, entityType: CommunityEntityType): Promise<CloneListingResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/community/listings/${encodeURIComponent(id)}/clone`,\n      { body: { entityType } },\n    )\n  }\n\n  /**\n   * `POST /v1/community/listings/:id/favorite` → toggle a favorite. Returns the\n   * resulting `favorited` state (`true` after adding, `false` after removing).\n   */\n  favorite(id: string): Promise<FavoriteListingResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/community/listings/${encodeURIComponent(id)}/favorite`,\n    )\n  }\n\n  /**\n   * `POST /v1/community/listings/:id/report` → flag a listing for moderation.\n   * `reason` must be one of {@link CommunityReportReason}.\n   */\n  report(id: string, reason: CommunityReportReason): Promise<ReportListingResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/community/listings/${encodeURIComponent(id)}/report`,\n      { body: { reason } },\n    )\n  }\n\n  /**\n   * `POST /v1/admin/community/:entityType/:id/publish` → share one of YOUR\n   * entities to the community, returning the new listing's `slug` + `id`.\n   *\n   * **Requires an admin token** (the route is `requireAdmin`) AND the caller\n   * must own the source entity. Personal/OAuth tokens without admin role get a\n   * 401. For `character` listings, `params.likenessAttestation` must be `true`.\n   */\n  publish(\n    entityType: CommunityEntityType,\n    entityId: string,\n    params: PublishListingParams,\n  ): Promise<PublishListingResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/admin/community/${encodeURIComponent(entityType)}/${encodeURIComponent(entityId)}/publish`,\n      { body: params },\n    )\n  }\n\n  /**\n   * `DELETE /v1/admin/community/listings/:id` → unshare (deactivate) a listing\n   * you published. **Requires an admin token** (the route is `requireAdmin`).\n   */\n  unpublish(listingId: string): Promise<{ ok: boolean }> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/admin/community/listings/${encodeURIComponent(listingId)}`,\n    )\n  }\n\n  /**\n   * `GET /v1/admin/community/by-source/:entityType/:sourceId` → look up YOUR\n   * existing listing (if any) for a source entity. Returns `{ data: null }`\n   * when the entity hasn't been shared. **Requires an admin token** (the route\n   * is `requireAdmin`); only returns listings created by the caller.\n   */\n  sharedListing(\n    entityType: CommunityEntityType,\n    sourceId: string,\n  ): Promise<{ data: SharedListing | null }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/admin/community/by-source/${encodeURIComponent(entityType)}/${encodeURIComponent(sourceId)}`,\n    )\n  }\n}\n"]}

package/dist/chunk-43NO4SGC.cjs

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

package/dist/chunk-43NO4SGC.cjs.map

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

package/dist/chunk-45CK55BH.cjs

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

package/dist/chunk-45CK55BH.cjs.map

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

package/dist/chunk-4CXB7RA6.js

@@ -0,0 +1,104 @@
+// src/resources/credits.ts
+var MODEL_COSTS_LIMIT = 50;
+var CreditsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * `GET /v1/user/credits` → the authenticated user's credit balance and tier
+   * info. Throws `UnauthorizedError` (401) when signed out, and the SDK's
+   * other typed errors on the usual statuses.
+   */
+  async balance() {
+    const res = await this.client.request(
+      "GET",
+      "/v1/user/credits"
+    );
+    return res.data;
+  }
+  /**
+   * `GET /v1/credits/transactions` → one page of the caller's credit
+   * transactions, newest first, with `nextCursor` for the next page (`null`
+   * at the end). Read `credits_charged` for what each run cost — it can be
+   * below the hold (`credits_reserved`) and is `null` while the hold is open.
+   * Cloud-only route: a self-hosted instance answers 404.
+   */
+  transactions(options = {}) {
+    return this.client.request("GET", "/v1/credits/transactions", {
+      query: { limit: options.limit, cursor: options.cursor }
+    });
+  }
+  /**
+   * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor
+   * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers
+   * (the route's request limit). Preserves the `{ data, missing, errors }`
+   * fault-isolation shape verbatim (see {@link ModelCostsResult}).
+   */
+  modelCosts(ids) {
+    return this.client.request("POST", "/v1/credits/model-costs", {
+      body: { models: ids.slice(0, MODEL_COSTS_LIMIT) }
+    });
+  }
+  /**
+   * `POST /v1/credits/claim-signup-grant` → claims the account's free signup
+   * grant, once, with the browser signals of the page making the claim.
+   *
+   * Call it once per page load as soon as the session is known, and never
+   * wait on it for rendering: it is idempotent (a decided account answers
+   * with its state and `granted: false`), it costs the user nothing when it
+   * fails (the next load asks again), and the signals are what make the
+   * claim worth sending — collect them with `collectSignupKeys()` from
+   * `@nodaro/sdk/signup-signals` and pass whatever came back, `{}` included.
+   * Cloud-only route: a self-hosted instance answers 404.
+   */
+  claimSignupGrant(keys = {}) {
+    return this.client.request("POST", "/v1/credits/claim-signup-grant", {
+      body: keys
+    });
+  }
+  /**
+   * `POST /v1/credits/welcome-offer/claim` → the user's "yes" to the welcome
+   * offer, as ONE server action: the marketing-email consent is recorded,
+   * then the free signup grant is claimed with that consent. The abuse gate
+   * still decides — consent is necessary, not sufficient — so read `grant`:
+   * `"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).
+   * Pass the browser signals from `collectSignupKeys()` and your app's slug.
+   *
+   * **Browser session only.** Usable from a first-party web app signed in
+   * with a Supabase session (the consent is a person's choice in a browser);
+   * an API key or OAuth app token is refused with 403. 409
+   * `welcome_offer_disabled` while the deployment has the offer off — show
+   * it only when `balance().welcomeOffer` is present. Cloud-only route: a
+   * self-hosted instance answers 404.
+   */
+  claimWelcomeOffer(input = {}) {
+    return this.client.request("POST", "/v1/credits/welcome-offer/claim", {
+      body: input
+    });
+  }
+  /**
+   * `POST /v1/credits/welcome-offer/seen` → records that the one-time welcome
+   * popup was shown, so `balance().welcomeOffer.popupSeen` turns true on every
+   * app. Idempotent (the first stamp wins); a failed call only means the popup
+   * may show once more, so callers usually ignore errors.
+   *
+   * **Browser session only**, like {@link claimWelcomeOffer}: 403 for an API
+   * key or OAuth app token, 409 `welcome_offer_disabled` while the offer is
+   * off, 404 on a self-hosted instance.
+   */
+  markWelcomeOfferSeen() {
+    return this.client.request("POST", "/v1/credits/welcome-offer/seen");
+  }
+  // NOTE: no `estimate(...)` helper. The backend exposes
+  // `POST /v1/credits/estimate-workflow` (body `{ nodes }` → `{ data: {
+  // totalCredits, nodeCount } }`), but no consumer has a settled shape for it
+  // yet (studio pre-checks `balance >= Σ modelCosts` client-side rather than
+  // calling an estimate endpoint). Adding it now would be inventing an API
+  // surface ahead of a real caller, so it's deliberately omitted — add it when
+  // a consumer needs it, shaped to that need.
+};
+
+export { CreditsResource };
+//# sourceMappingURL=chunk-4CXB7RA6.js.map
+//# sourceMappingURL=chunk-4CXB7RA6.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/credits.ts"],"names":[],"mappings":";AAmLA,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,EAQA,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;AASF","file":"chunk-4CXB7RA6.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\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 (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 } }`), 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-4NLVBYMW.js

@@ -0,0 +1,280 @@
+import { readSseStream } from './chunk-JMOKD6ZP.js';
+
+// src/resources/media.ts
+var MediaResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Download a social video (YouTube / TikTok / Instagram / X / Facebook) into
+   * your storage (`POST /v1/download-video`). `maxHeight` caps the resolution
+   * (default "best"); `sectionStartSec` + `sectionEndSec` (both-or-neither) fetch
+   * ONLY that time range instead of the whole video. A download that arrives
+   * with no audio stream FAILS by default (it is usually a degraded source
+   * response, and is retried through other routes first); pass
+   * `requireAudio: false` to accept a clip that really has no sound. Returns a
+   * `downloadId`; progress streams from
+   * `GET /v1/download-video/progress/:downloadId` (server-sent events) and the
+   * finished file lands in your library.
+   */
+  downloadVideo(input) {
+    return this.client.request("POST", "/v1/download-video", { body: input });
+  }
+  /**
+   * Stream the live progress of a {@link MediaResource.downloadVideo} import
+   * (`GET /v1/download-video/progress/:downloadId`, server-sent events) as an
+   * async iterable. Yields a {@link DownloadVideoProgress} roughly every 500ms
+   * until the download reaches `completed` (its event carries the stored
+   * `videoUrl`) or `failed` (its event carries `error`), then ends. The progress
+   * state expires server-side shortly after the download starts existing, so
+   * start iterating promptly after `downloadVideo` returns.
+   *
+   * No request timeout is applied (a large import legitimately takes minutes) —
+   * pass an `AbortSignal` to cancel from the caller.
+   */
+  async *downloadVideoProgress(downloadId, opts = {}) {
+    const url = `${this.client.baseUrl}/v1/download-video/progress/${encodeURIComponent(downloadId)}`;
+    const token = await this.client.auth.getToken();
+    const res = await this.client.fetch(url, {
+      headers: token ? { Authorization: `Bearer ${token}` } : {},
+      signal: opts.signal
+    });
+    yield* readSseStream(res, { label: "progress stream" });
+  }
+  /**
+   * Copy an external media URL into your Nodaro storage (`POST /v1/save-to-storage`)
+   * — a server-side fetch, so nothing round-trips through the client. Poll
+   * `jobs.get(jobId)`.
+   */
+  saveToStorage(input) {
+    return this.client.request("POST", "/v1/save-to-storage", { body: input });
+  }
+  /**
+   * Composite 2–30 images into ONE large 2K/4K collage (`POST /v1/image-collage`).
+   * `layout` `"smart"` (default — justified rows at each image's exact aspect
+   * ratio, no cropping; the output height floats) or `"grid"` (uniform,
+   * letterboxed cells). `imageSizes` is index-aligned with `imageUrls` and
+   * gives per-image RELATIVE size hints for the smart layout: `0` auto
+   * ("don't care", default), `1` big (~2× linear vs medium), `2` medium,
+   * `3` small (~½ linear). All-equal hints change nothing; grid ignores them.
+   * For storyboards, set `numbered` to stamp a 1-based sequence badge at each
+   * image's corner (top-left by default; `badgePosition: "top-right"` moves it;
+   * in `imageUrls` order) and pass `imageLabels`
+   * (index-aligned with `imageUrls`; `null`/`""`/omitted = no caption for that
+   * image) to caption images after the number, e.g. `3 · Close-up`. Badges are
+   * an overlay only — they never change the layout, the output size or the
+   * credit cost. Poll `jobs.get(jobId)` for the finished image.
+   */
+  imageCollage(input) {
+    return this.client.request("POST", "/v1/image-collage", { body: input });
+  }
+  /**
+   * Place 1–12 layers — pictures, real text, QR codes, shapes — on a base image,
+   * pixel-exactly (`POST /v1/image-overlay`) — local, deterministic, no AI.
+   * Every layer position/size is a PERCENT of the base image: `anchor` (nine
+   * positions, default `"center"`), `x`/`y` (offset from the anchor in % of
+   * the base width/height; negative on a right/bottom anchor moves inward),
+   * `width` (% of the base width, default 25 — height follows the layer's
+   * aspect unless `height` is set). Plus `opacity` (0..1), `rotation`
+   * (degrees), `blend` (`"over"` | `"multiply"` | `"screen"`), `fit`,
+   * `shadow` and `roundedCorners`. The output keeps the base's pixel size
+   * unless `canvas` is set. Flat credit cost. Poll `jobs.get(jobId)` for the
+   * finished image.
+   */
+  imageOverlay(input) {
+    return this.client.request("POST", "/v1/image-overlay", { body: input });
+  }
+  /**
+   * Ask a vision model WHERE one overlay layer should sit on a base image
+   * (`POST /v1/image-overlay/suggest-placement`) — it reads the picture and
+   * keeps the element off the faces, the subject and the busiest texture.
+   * The answer comes back in {@link MediaResource.imageOverlay}'s own percent
+   * units — `anchor`, `x`/`y` offsets, `width` — so it drops straight onto a
+   * layer (`const { reason, ...box } = placement`), plus a one-sentence
+   * `reason` you can show a user. Nothing is composited here: apply the
+   * placement yourself.
+   *
+   * `layerAspect` is the element's width / height (1 = square, the default) so
+   * the proposed box stays in proportion; `intent` says what the element is
+   * ("a logo", "a price badge"); `safeArea` is the always-visible region as
+   * fractions of the canvas (a platform preset's safe area), which the
+   * placement is kept inside. Unlike the other media calls this one answers
+   * synchronously — there is nothing to poll; `jobId` is the billing record
+   * (one image-to-text call).
+   */
+  suggestOverlayPlacement(input) {
+    return this.client.request(
+      "POST",
+      "/v1/image-overlay/suggest-placement",
+      { body: input }
+    );
+  }
+  /**
+   * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever
+   * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or
+   * `keepFirst`/`keepLastSeconds`. Poll `jobs.get(jobId)`.
+   */
+  trimVideo(input) {
+    return this.client.request("POST", "/v1/trim-video", { body: input });
+  }
+  /**
+   * Burn captions into a video (`POST /v1/add-captions`). Give the words as
+   * `text`, word-timed `captions[]`, or let it transcribe (`autoTranscribe`,
+   * the default when neither is set).
+   *
+   * `style: "subtitle"` renders statically (FFmpeg) UNLESS it carries a styling
+   * lever, in which case it — like the KINETIC styles (`word-highlight` /
+   * `karaoke` / `tiktok-words` / `word-pop` / `bouncy`) — renders via Remotion.
+   * `look` picks a preset — `outline` (Montserrat 900, UPPERCASE, black outline,
+   * yellow spoken word — the TikTok/Reels read) or `clean`; an UNSET look renders
+   * as `outline`. The explicit STYLING levers (`fontFamily`, `fontWeight`,
+   * `strokeColor`/`strokeWidth`, `uppercase`, `positionY`, `maxWordsPerLine`)
+   * override individual fields of it and now apply to `subtitle` too. Only
+   * `highlightColor` (the spoken-word cursor) and `animate` stay kinetic-only
+   * and are REJECTED on `subtitle`.
+   *
+   * `animate` (default true) freezes the per-word MOTION on the kinetic styles
+   * when set to false — the grouping, line-holding and spoken-word highlight
+   * stay; only the movement stops.
+   *
+   * `maxWordsPerLine` (1-20) caps how many words a line — or a `tiktok-words`
+   * page — may hold, on top of the width budget / sentence ends / pauses that
+   * already close one; it is inert on `word-pop`, which is always one word.
+   * Like every lever here it exists top-level AND per segment, and a segment
+   * that does not name its own inherits the top-level value.
+   *
+   * `segments[]` applies DIFFERENT treatments to non-overlapping time ranges in
+   * one call (e.g. a large top intro, then a small bottom body); a segment that
+   * names its own `look` starts fresh from that preset and does not inherit the
+   * top-level explicit levers. Poll `jobs.get(jobId)`.
+   *
+   * `word-highlight` shows ONE held line at a time and a word's
+   * `startMs`/`endMs` is its SPOKEN window (what times the highlight, not how
+   * long the text is on screen) — so `captions[]` can be handed over verbatim
+   * from an `audio.transcribe()` job's `output_data.words`, with
+   * `autoTranscribe: false`.
+   */
+  addCaptions(input) {
+    const { autoTranscribe, transcribeProvider, ...rest } = input;
+    const body = {
+      ...rest,
+      ...autoTranscribe !== void 0 ? { auto_transcribe: autoTranscribe } : {},
+      ...transcribeProvider !== void 0 ? { transcribe_provider: transcribeProvider } : {}
+    };
+    return this.client.request("POST", "/v1/add-captions", { body });
+  }
+  /**
+   * Trim (and extract) audio from a video or audio source
+   * (`POST /v1/trim-audio`) to `[startTime, endTime]` seconds, in `audioFormat`
+   * (`mp3` default / `wav` / `aac`). Poll `jobs.get(jobId)`.
+   */
+  trimAudio(input) {
+    return this.client.request("POST", "/v1/trim-audio", { body: input });
+  }
+  /**
+   * Cut a video and/or an audio file into consecutive parts
+   * (`POST /v1/split-media`). Every part is at most `chunkDuration` seconds and
+   * at least `minPartDuration` (default 4, never above `chunkDuration`) — a
+   * short leftover is evened out with the parts before it. Video is cut on
+   * whole frames with each part's sound matching its picture; audio parts are
+   * sample-exact, in `audioFormat` (`mp3` default / `wav` / `aac`). With both
+   * sources each is split on its own. At most 200 parts per input. Poll
+   * `jobs.get(jobId)`; the parts are on the completed job's `output_data` —
+   * see {@link SplitMediaOutput}.
+   */
+  splitMedia(input) {
+    return this.client.request("POST", "/v1/split-media", { body: input });
+  }
+  /**
+   * Turn one still image + one audio track into an MP4
+   * (`POST /v1/still-to-video`) — locally rendered (FFmpeg), no AI model,
+   * zero credits. The output duration IS the audio's duration; there is no
+   * duration field. Optional `motion` animates the still (zoom / pan /
+   * ken-burns) at `intensity` 1–10. `fit: "contain"` letterboxes with
+   * `padColor` instead of cropping. Poll `jobs.get(jobId)`.
+   */
+  stillToVideo(input) {
+    return this.client.request("POST", "/v1/still-to-video", { body: input });
+  }
+  /**
+   * Turn 2–100 images + one optional audio track into an MP4 slideshow
+   * (`POST /v1/slideshow`) — locally rendered (FFmpeg), zero credits. With
+   * audio, the output duration IS the audio's duration (equal split unless
+   * `imageDurations` pins rows — null entries = auto; mismatched pinned sums
+   * scale proportionally and the factor is disclosed in the job output).
+   * Without audio: N × `perImageDuration`, silent output. Transitions
+   * consume the outgoing slide, so totals stay exact. For a single image use
+   * `stillToVideo`. Poll `jobs.get(jobId)`.
+   */
+  slideshow(input) {
+    return this.client.request("POST", "/v1/slideshow", { body: input });
+  }
+  /**
+   * Place 1–20 timed image layers over a video (`POST /v1/video-overlay`) —
+   * rendered locally (FFmpeg) in one pass, no AI; the base audio is kept
+   * untouched. Each layer has an `imageUrl`, a `start` and an optional `end`
+   * in seconds (no `end` = to the end of the video) and a placement: a
+   * `preset` (`"card"`, `"corner-badge"` with a `corner`, `"full-frame"`) or
+   * an explicit box in {@link MediaResource.imageOverlay}'s percent vocabulary
+   * (`anchor`, `x`, `y`, `width`, `height`, `fit`) — an explicit box field
+   * overrides the preset, and a layer with neither is a corner badge
+   * (bottom-right, or the `corner` it names). `outputAspect` renders onto a
+   * 16:9 / 9:16 / 1:1 / 4:5 canvas
+   * (`baseFit` cover by default; `backgroundColor` pads `contain`). Poll
+   * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`, `width`,
+   * `height`, `durationSec` and `warnings[]` (a layer clipped or skipped at the
+   * video's end, an animated image's first frame, re-encoded audio).
+   */
+  videoOverlay(input) {
+    return this.client.request("POST", "/v1/video-overlay", { body: input });
+  }
+  /**
+   * Track a subject described in plain text through a video and get a
+   * black-and-white MASK VIDEO back (`POST /v1/video-mask`, SAM 3.1 by default,
+   * or `provider: "sam-3"` at half the price) — white = the subject. Clips up
+   * to 5 minutes at 30 fps (a faster clip counts
+   * proportionally longer), priced by the clip's length. Poll
+   * `jobs.get(jobId)`: the output carries `videoUrl` (the mask), `width`,
+   * `height`, `frames` and `coverage` (the fraction of pixels selected). Feed
+   * the mask to {@link MediaResource.maskComposite}.
+   */
+  videoMask(input) {
+    return this.client.request("POST", "/v1/video-mask", { body: input });
+  }
+  /**
+   * Place a foreground video over a background video through a mask video
+   * (`POST /v1/mask-composite`; white = foreground) — local FFmpeg, no AI.
+   * The result follows the foreground's size, frame rate and length; the
+   * background is fitted (`backgroundFit`, default cover) and loops when
+   * shorter; the mask holds its last frame when shorter. Optional
+   * `invertMask`, `feather` (0–20 px), `grow` (−10–10 px) and `audioSource`
+   * (foreground / background / mix / none). Priced per started 5 seconds of
+   * the result (foreground up to 300 s). Poll `jobs.get(jobId)` for `videoUrl`.
+   */
+  maskComposite(input) {
+    return this.client.request("POST", "/v1/mask-composite", { body: input });
+  }
+  /**
+   * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,
+   * dimensions, title, live status — WITHOUT downloading it. A direct read, not a
+   * job. Use it to decide whether to trim before importing.
+   */
+  videoMetadata(input) {
+    return this.client.request("POST", "/v1/video-metadata", { body: input });
+  }
+  /**
+   * Cut or crop a stored file (`POST /v1/media/process`) — synchronous and
+   * free, the source-preparation sibling of the priced `trimVideo` node.
+   * `trim` is `[startTime, endTime]` in seconds; `deleteSource: true` removes
+   * the source object afterwards when it is yours and nothing else references
+   * it ("the cut replaces the original"). Answers the stored file.
+   */
+  process(input) {
+    return this.client.request("POST", "/v1/media/process", { body: input });
+  }
+};
+
+export { MediaResource };
+//# sourceMappingURL=chunk-4NLVBYMW.js.map
+//# sourceMappingURL=chunk-4NLVBYMW.js.map