@nodaro/sdk 2.51.0 → 2.53.0

package/dist/chunk-WYYDWJFF.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/billing.ts"],"names":[],"mappings":"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","file":"chunk-WYYDWJFF.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Plans and prices, the subscription, and the billing surface — the shapes of\n * the `/v1/billing/*` routes an app may call. Mirrors the backend routes\n * (`backend/src/ee/routes/billing.ts`, `backend/src/routes/billing-surface.ts`),\n * the source of truth: keep these in sync if they change.\n *\n * Buying, the plan, the payment settings, the receipts and the invoices answer\n * a SIGNED-IN SESSION only (`supabaseAuth`, the credential a first-party web\n * app holds): those routes refuse an API key and an app's OAuth token with\n * `403 forbidden` (`ForbiddenError`). Their methods are marked so below.\n */\n\n/** A sum of money in its currency's major unit (`12` = 12.00), with its ISO-4217 code (`\"USD\"`). */\nexport interface BillingMoney {\n  amount: number\n  currency: string\n}\n\n/** The credits a price grants, and how often. */\nexport interface BillingPriceCredits {\n  amount: number\n  per: \"month\" | \"year\"\n}\n\n/** A monthly price, and what it grants. */\nexport interface BillingMonthlyPrice extends BillingMoney {\n  /** `null` when the price does not state it. */\n  credits: BillingPriceCredits | null\n}\n\n/** A yearly price, what it comes to per month, and what it grants. */\nexport interface BillingYearlyPrice extends BillingMoney {\n  /** The yearly amount spread over the months it pays for; `null` when that cannot be said. */\n  perMonth: number | null\n  /** What the price grants — the plan's credits every month, as a monthly price; `null` when the price does not state it. */\n  credits: BillingPriceCredits | null\n}\n\nexport interface BillingPlanPrices {\n  /** `null` = Stripe cannot sell this price right now: show it as unavailable, never as free. */\n  monthly: BillingMonthlyPrice | null\n  yearly: BillingYearlyPrice | null\n}\n\n/** One plan on sale. */\nexport interface BillingPlan {\n  /** `\"free\"`, `\"basic\"`, `\"standard\"`, … — the stable id. */\n  id: string\n  name: string\n  /** `null` for the free plan: there is nothing to pay. */\n  prices: BillingPlanPrices | null\n  /** The free plan's one-time grant at sign-up; `null` on a paid plan, whose credits come with each price. */\n  signupCredits: number | null\n  /** How many nodes of one workflow run at once. */\n  parallelism: number\n  /** Storage for your media, in bytes. */\n  storageBytes: number\n}\n\n/** A credit pack: this many credits for this price. */\nexport interface BillingTopUp {\n  id: string\n  credits: number\n  /** `null` when the pack's price cannot be stated right now: show it as unavailable. */\n  price: BillingMoney | null\n}\n\n/** The answer of `GET /v1/billing/plans`. */\nexport interface BillingPlansResult {\n  /** The free plan first, then each paid plan from the smallest. */\n  data: BillingPlan[]\n  /** The credit packs, from the smallest. */\n  topUps: BillingTopUp[]\n  /** Any whole amount in this range can be loaded as credits, at the same rate as the packs. */\n  topUpRange: { min: number; max: number; currency: string }\n}\n\n/** The account's latest subscription record. */\nexport interface BillingSubscription {\n  id: string\n  stripe_subscription_id: string | null\n  /** The plan id: `\"basic\"`, `\"standard\"`, … */\n  tier: string\n  /** `\"active\"`, `\"trialing\"`, `\"past_due\"`, `\"paused\"`, `\"canceled\"`, `\"incomplete\"` or `\"expired\"`. */\n  status: string\n  stripe_price_id: string | null\n  /** ISO-8601. */\n  current_period_start: string | null\n  /** ISO-8601: when the current period ends (and renews, unless cancelled). */\n  current_period_end: string | null\n  /** True when the subscription ends at `current_period_end` instead of renewing. */\n  cancel_at_period_end: boolean\n  /** ISO-8601: when a scheduled cancellation takes effect. */\n  cancel_at: string | null\n  /** ISO-8601: when it was cancelled. */\n  canceled_at: string | null\n}\n\n/** The answer of `GET /v1/billing/subscription`. */\nexport interface BillingSubscriptionResult {\n  /** `null` when the account never subscribed. */\n  data: BillingSubscription | null\n  /**\n   * The tier the account's entitlements follow: usually a plan id from\n   * `plans()` (`\"free\"` included); `\"payg\"` — no subscription, but credits\n   * bought (every model, no watermark); or a tier that is not on sale, such\n   * as `\"enterprise\"`.\n   */\n  effectiveTier: string\n}\n\n/** How this deployment bills, the same for every caller (`GET /v1/billing/surface`). */\nexport interface BillingSurface {\n  /** The billing-surface contract version (an integer). */\n  contract: number\n  /** The registered billing provider; `\"none\"` = this deployment meters nothing. */\n  providerId: string\n  /** The unit costs display in by default (`\"credits\"`, `\"usd\"`, or a deployment's own label). */\n  displayUnit: string\n  canReport: boolean\n  canQuote: boolean\n  canAccount: boolean\n  /** Whether a cost view belongs on this deployment. */\n  mountCostTab: boolean\n  /** One billing account pays for every user here. */\n  deploymentPayer: boolean\n}\n\n/** One row of {@link BillingAccountSummary.byCategory}. */\nexport interface BillingUsageCategory {\n  category: string\n  count: number\n  /** Spend in the display unit; `null` = unavailable, never 0. */\n  amount: number | null\n  spent: BillingMoney | null\n}\n\n/**\n * The caller's account as the deployment's billing provider sees it\n * (`GET /v1/billing/account`). Money and amounts are `null` when the provider\n * could not say: show that distinctly, never as 0. A field the provider leaves\n * out is a concept it does not have.\n */\nexport interface BillingAccountSummary {\n  /** A plain string; `\"unknown\"` is a real answer. */\n  plan: string\n  balance: number | null\n  dailyAllowance: number | null\n  unit: string\n  /** `\"external_wallet\"` when the balance comes from a wallet outside Nodaro. */\n  balanceSource?: \"external_wallet\"\n  /** ISO-8601 start of the current usage period. */\n  periodStart?: string | null\n  /** Generations this period. */\n  generations?: number | null\n  /** Money spent this period. */\n  spent?: BillingMoney | null\n  /** Pay-as-you-go state. */\n  payg?: {\n    enabled: boolean\n    reserve: number | null\n    rate: { creditsPerUnit: number; currency: string } | null\n    monthlyCap: BillingMoney | null\n  } | null\n  /** The daily cap and when it resets; prefer it over `dailyAllowance` when present. `limit: 0` means blocked. */\n  daily?: { limit: number; used: number; remaining: number; resetsAt: string } | null\n  /** Money value of the pay-as-you-go reserve. */\n  reserveValue?: BillingMoney | null\n  byCategory?: BillingUsageCategory[] | null\n  /** The total the balance is drawn from, where the provider grants each user an allocation. */\n  allocated?: number | null\n}\n\nexport class BillingResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * `GET /v1/billing/plans` → the plans and credit packs on sale, with their\n   * prices. Public: works with no credential, the same for every caller.\n   * Nodaro Cloud only — a self-hosted instance answers 404. Throws on `403\n   * self_serve_disabled` (this deployment does not sell to its users) and on\n   * `503` (`stripe_not_configured`, or prices briefly unavailable).\n   */\n  plans(): Promise<BillingPlansResult> {\n    return this.client.request<BillingPlansResult>(\"GET\", \"/v1/billing/plans\")\n  }\n\n  /**\n   * `GET /v1/billing/subscription` → the account's latest subscription\n   * (`null` when it never subscribed) and the tier its entitlements follow.\n   * Match `effectiveTier` to a {@link BillingPlan} `id` to mark the current\n   * plan (no match: pay-as-you-go, or a tier not on sale). Needs a signed-in\n   * session, a personal API token without a workflow limit, or an app's OAuth\n   * token. Nodaro Cloud only — a self-hosted instance answers 404.\n   */\n  subscription(): Promise<BillingSubscriptionResult> {\n    return this.client.request<BillingSubscriptionResult>(\"GET\", \"/v1/billing/subscription\")\n  }\n\n  /**\n   * `GET /v1/billing/surface` → how this deployment bills: whether it meters\n   * at all (`providerId !== \"none\"`) and in which unit costs display. Public,\n   * every edition.\n   */\n  async surface(): Promise<BillingSurface> {\n    const res = await this.client.request<{ data: BillingSurface }>(\"GET\", \"/v1/billing/surface\")\n    return res.data\n  }\n\n  /**\n   * `GET /v1/billing/account` → the caller's plan and balance as the\n   * deployment's billing provider reports them, in its display unit. `null`\n   * when the provider could not answer — not a zero balance. Every edition.\n   */\n  async account(): Promise<BillingAccountSummary | null> {\n    const res = await this.client.request<{ data: BillingAccountSummary | null }>(\"GET\", \"/v1/billing/account\")\n    return res.data\n  }\n\n  // ── Signed-in session only (ForbiddenError on an API key or an app token) ──\n\n  /**\n   * `GET /v1/billing/transactions` → the account's credit purchases, newest\n   * first: subscription payments and credit packs, each with its Stripe\n   * receipt link when one was captured. **Signed-in session only.**\n   */\n  async purchases(): Promise<BillingPurchase[]> {\n    const res = await this.client.request<{ data: BillingPurchase[] }>(\"GET\", \"/v1/billing/transactions\")\n    return res.data\n  }\n\n  /**\n   * `GET /v1/billing/invoices` → every payment as a document, newest first:\n   * a Stripe invoice (with its PDF) for each subscription payment, a hosted\n   * receipt for each credit pack or load. **Signed-in session only.**\n   */\n  async invoices(): Promise<BillingDocument[]> {\n    const res = await this.client.request<{ data: BillingDocument[] }>(\"GET\", \"/v1/billing/invoices\")\n    return res.data\n  }\n\n  /**\n   * `GET /v1/billing/payment-method` → the card and the billing details on\n   * file with Stripe; both `null` for an account that has not bought yet\n   * (never an error). **Signed-in session only.**\n   */\n  async paymentMethod(): Promise<BillingPaymentMethod> {\n    const res = await this.client.request<{ data: BillingPaymentMethod }>(\"GET\", \"/v1/billing/payment-method\")\n    return res.data\n  }\n\n  /**\n   * `GET /v1/billing/auto-recharge` → the automatic top-up setting: when the\n   * balance falls under `thresholdCredits`, `amountUsd` is loaded from the\n   * saved card. **Signed-in session only.**\n   */\n  async autoRecharge(): Promise<BillingAutoRecharge> {\n    const res = await this.client.request<{ data: BillingAutoRecharge }>(\"GET\", \"/v1/billing/auto-recharge\")\n    return res.data\n  }\n\n  /**\n   * `PUT /v1/billing/auto-recharge` → changes the automatic top-up. Enabling\n   * needs both `thresholdCredits` (100–100,000) and `amountUsd` (a whole\n   * amount in the load range); the server answers `400` otherwise. A change\n   * clears the failure count. **Signed-in session only.**\n   */\n  async setAutoRecharge(input: BillingAutoRechargeInput): Promise<BillingAutoRechargeSaved> {\n    const res = await this.client.request<{ data: BillingAutoRechargeSaved }>(\"PUT\", \"/v1/billing/auto-recharge\", { body: input })\n    return res.data\n  }\n\n  /**\n   * `POST /v1/billing/create-checkout-session` → a Stripe Checkout page for a\n   * plan or a credit pack (`priceId` from {@link BillingPlansResult}): send\n   * the person to `url`. Pass `returnPath` (a path on your own origin, such\n   * as `\"/billing\"`) to have Stripe bring them back to your app with\n   * `checkout=success` or `checkout=cancelled` in the query; without it the\n   * Nodaro app's own pages are used. `ForbiddenError` with the code\n   * `self_serve_disabled` on a deployment that does not sell to its users.\n   * **Signed-in session only.**\n   */\n  async checkout(input: BillingCheckoutInput): Promise<BillingCheckoutSession> {\n    const res = await this.client.request<{ data: BillingCheckoutSession }>(\"POST\", \"/v1/billing/create-checkout-session\", { body: input })\n    return res.data\n  }\n\n  /**\n   * `POST /v1/billing/create-load-session` → a Stripe Checkout page that loads\n   * a whole amount (`amountUsd`, within {@link BillingPlansResult.topUpRange})\n   * as credits at the packs' rate; `credits` is what it will grant. The card\n   * is saved for auto top-up. `returnPath` as in {@link checkout}.\n   * **Signed-in session only.**\n   */\n  async loadCredits(input: BillingLoadInput): Promise<BillingLoadSession> {\n    const res = await this.client.request<{ data: BillingLoadSession }>(\"POST\", \"/v1/billing/create-load-session\", { body: input })\n    return res.data\n  }\n\n  /**\n   * `POST /v1/billing/manage-subscription` → a Stripe Customer Portal page\n   * (the card, the billing address, the invoices, cancelling): send the person\n   * to `url`; `returnPath` is where the portal's Back goes (default the app's\n   * `/billing`). `NotFoundError` before a first purchase — Stripe does not\n   * know the account yet. **Signed-in session only.**\n   */\n  async portal(input: BillingPortalInput = {}): Promise<BillingPortalSession> {\n    const res = await this.client.request<{ data: BillingPortalSession }>(\"POST\", \"/v1/billing/manage-subscription\", { body: input })\n    return res.data\n  }\n\n  /**\n   * `POST /v1/billing/change-plan` → moves the active subscription to another\n   * plan's price (`newPriceId`, a subscription price from the plans list),\n   * prorated by Stripe; the new tier applies at once. `NotFoundError` with no\n   * active subscription; `400` on a pack's price or the current one.\n   * **Signed-in session only.**\n   */\n  async changePlan(input: BillingChangePlanInput): Promise<BillingChangePlanResult> {\n    const res = await this.client.request<{ data: BillingChangePlanResult }>(\"POST\", \"/v1/billing/change-plan\", { body: input })\n    return res.data\n  }\n}\n\n// ── Types of the signed-in-session methods ──\n\n/** One credit purchase (`billing.purchases()`), as the `transactions` row names it. */\nexport interface BillingPurchase {\n  id: string\n  /** The Stripe payment or subscription id. */\n  stripe_transaction_id: string | null\n  /** `\"subscription\"` (a plan payment), `\"topup\"` (a credit pack or a load) or `\"refund\"` (money given back: `credits_granted` negative). */\n  type: string\n  /** What was paid, in US dollars (on a refund, the sum given back). */\n  amount_usd: number\n  /** Negative on a refund. */\n  credits_granted: number\n  /** The plan paid for, on a subscription payment. */\n  tier: string | null\n  /** ISO-8601. */\n  created_at: string\n  /** Stripe's hosted receipt; `null` when none was captured. */\n  receipt_url: string | null\n}\n\n/** A payment document: a Stripe invoice (a subscription payment) or a receipt (a credit purchase). */\nexport interface BillingDocument {\n  id: string\n  kind: \"invoice\" | \"receipt\"\n  /** The invoice number Stripe printed; `null` on a receipt. */\n  number: string | null\n  /** ISO-8601. */\n  at: string\n  amount: BillingMoney\n  /** The credits the payment granted; `null` on an invoice (the plan's credits come with the period). Negative on a refund. */\n  credits: number | null\n  /** `\"paid\"`, `\"open\"`, `\"void\"`, `\"uncollectible\"`, or `\"refunded\"` (a receipt for money given back: `amount` and `credits` negative). */\n  status: string\n  description: string | null\n  /** The PDF, on an invoice; `null` on a receipt. */\n  pdfUrl: string | null\n  /** The hosted page: Stripe's invoice page, or the receipt. */\n  url: string | null\n}\n\n/** The card on file, as Stripe shows it. */\nexport interface BillingCard {\n  /** `\"visa\"`, `\"mastercard\"`, … */\n  brand: string\n  last4: string\n  expMonth: number\n  expYear: number\n}\n\n/** The name, email and country on file. */\nexport interface BillingDetails {\n  name: string | null\n  email: string | null\n  /** ISO-3166 alpha-2. */\n  country: string | null\n}\n\n/** The answer of `billing.paymentMethod()`: both `null` before a first purchase. */\nexport interface BillingPaymentMethod {\n  card: BillingCard | null\n  billingDetails: BillingDetails | null\n}\n\n/** The automatic top-up setting (`billing.autoRecharge()`). */\nexport interface BillingAutoRecharge {\n  enabled: boolean\n  /** Load when the balance falls under this many credits; `null` when never set. */\n  thresholdCredits: number | null\n  /** The whole dollar amount loaded each time; `null` when never set. */\n  amountUsd: number | null\n  /** Failed attempts in a row; the server stops trying after a few, until the setting is saved again. */\n  failureCount: number\n  /** ISO-8601; `null` before the first attempt. */\n  lastAttemptAt: string | null\n  /** Whether a card is saved to charge; without one, enabling cannot work. */\n  hasSavedCard: boolean\n}\n\n/** What `billing.setAutoRecharge()` sends; `thresholdCredits` and `amountUsd` are both required to enable. */\nexport interface BillingAutoRechargeInput {\n  enabled: boolean\n  thresholdCredits?: number\n  amountUsd?: number\n}\n\n/** What `billing.setAutoRecharge()` answers: the fields as sent (`null` for one left out, even when a stored value remains); read {@link BillingResource.autoRecharge} for the whole setting. */\nexport interface BillingAutoRechargeSaved {\n  enabled: boolean\n  thresholdCredits: number | null\n  amountUsd: number | null\n}\n\n/** What `billing.checkout()` sends. */\nexport interface BillingCheckoutInput {\n  /** A plan's monthly or yearly price id, or a credit pack's (`BillingTopUp.id`). */\n  priceId: string\n  /** Inferred from the price when omitted. */\n  mode?: \"subscription\" | \"payment\"\n  /** A path on the calling origin Stripe brings the person back to (`\"/billing\"`, a query allowed): one leading `/`, no host, no `#`. Wins over `embedded`. */\n  returnPath?: string\n  /** Set by an embedded first-party surface: return to the app's public checkout-complete page. */\n  embedded?: boolean\n}\n\n/** A Stripe Checkout page to send the person to. */\nexport interface BillingCheckoutSession {\n  url: string | null\n}\n\n/** What `billing.loadCredits()` sends. */\nexport interface BillingLoadInput {\n  /** A whole dollar amount within `topUpRange`. */\n  amountUsd: number\n  /** As in {@link BillingCheckoutInput.returnPath}; wins over `embedded`. */\n  returnPath?: string\n  embedded?: boolean\n}\n\n/** A Stripe Checkout page for a load, and the credits it grants. */\nexport interface BillingLoadSession {\n  url: string | null\n  credits: number\n}\n\n/** What `billing.portal()` sends. */\nexport interface BillingPortalInput {\n  /** Where the portal's Back goes: a path on the calling origin; default the app's `/billing`. */\n  returnPath?: string\n}\n\n/** A Stripe Customer Portal page to send the person to. */\nexport interface BillingPortalSession {\n  url: string\n}\n\n/** What `billing.changePlan()` sends. */\nexport interface BillingChangePlanInput {\n  /** A subscription price id from the plans list. */\n  newPriceId: string\n}\n\n/** What `billing.changePlan()` answers. */\nexport interface BillingChangePlanResult {\n  subscriptionId: string\n  /** The plan now in force: `\"basic\"`, `\"standard\"`, … */\n  tier: string\n}\n"]}

package/dist/chunk-YXVMQEJX.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/resources/trends.ts"],"names":[],"mappings":";AA4DA,IAAM,cAAA,GAAmD;AAAA,EACvD,IAAA,EAAM,0BAAA;AAAA,EACN,IAAA,EAAM;AACR,CAAA;AAEA,SAAS,SAAA,CAAU,IAAA,EAAc,IAAA,GAAO,EAAA,EAAY;AAClD,EAAA,IAAI,MAAA,CAAO,MAAA,CAAO,cAAA,EAAgB,IAAI,CAAA,EAAG;AACvC,IAAA,MAAM,IAAI,UAAU,CAAA,CAAA,EAAI,IAAI,6CAA6C,cAAA,CAAe,IAAI,CAAC,CAAA,CAAA,CAAG,CAAA;AAAA,EAClG;AACA,EAAA,OAAO,CAAA,WAAA,EAAc,kBAAA,CAAmB,IAAI,CAAC,GAAG,IAAI,CAAA,CAAA;AACtD;AAkWO,IAAM,iBAAN,MAAqB;AAAA,EAC1B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,CAAK,MAAA,GAA2B,EAAC,EAAkC;AACjE,IAAA,MAAM,QAAgC,EAAC;AACvC,IAAA,IAAI,MAAA,CAAO,CAAA,EAAG,KAAA,CAAM,CAAA,GAAI,MAAA,CAAO,CAAA;AAC/B,IAAA,IAAI,MAAA,CAAO,GAAA,EAAK,KAAA,CAAM,GAAA,GAAM,MAAA,CAAO,GAAA;AACnC,IAAA,IAAI,MAAA,CAAO,SAAA,EAAW,KAAA,CAAM,SAAA,GAAY,GAAA;AACxC,IAAA,IAAI,MAAA,CAAO,MAAA,EAAQ,KAAA,CAAM,MAAA,GAAS,MAAA,CAAO,MAAA;AACzC,IAAA,IAAI,MAAA,CAAO,MAAA,EAAQ,KAAA,CAAM,MAAA,GAAS,MAAA,CAAO,MAAA;AACzC,IAAA,IAAI,OAAO,KAAA,KAAU,MAAA,QAAiB,KAAA,GAAQ,MAAA,CAAO,OAAO,KAAK,CAAA;AACjE,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,YAAA,EAAc,EAAE,OAAO,CAAA;AAAA,EAC3D;AAAA;AAAA,EAGA,MAAM,GAAA,CAAI,IAAA,EAAc,MAAA,GAA8B,EAAC,EAAyB;AAC9E,IAAA,MAAM,QAAgC,EAAC;AACvC,IAAA,IAAI,MAAA,CAAO,MAAA,EAAQ,KAAA,CAAM,MAAA,GAAS,MAAA,CAAO,MAAA;AACzC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAA+B,KAAA,EAAO,SAAA,CAAU,IAAI,CAAA,EAAG,EAAE,KAAA,EAAO,CAAA;AAC9F,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA,EAGA,MAAM,QAAA,CAAS,IAAA,EAAc,OAAA,EAAkD;AAC7E,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA;AAAA,MAC5B,MAAA;AAAA,MACA,SAAA,CAAU,MAAM,WAAW,CAAA;AAAA,MAC3B,EAAE,MAAM,OAAA;AAAQ,KAClB;AACA,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,GAAA,CAAI,IAAA,EAAc,OAAA,EAA0B,OAAA,EAAuD;AACvG,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA;AAAA,MAC5B,MAAA;AAAA,MACA,SAAA,CAAU,MAAM,OAAO,CAAA;AAAA,MACvB;AAAA,QACE,IAAA,EAAM,OAAA;AAAA,QACN,GAAI,OAAA,EAAS,cAAA,GAAiB,EAAE,OAAA,EAAS,EAAE,iBAAA,EAAmB,OAAA,CAAQ,cAAA,EAAe,EAAE,GAAI;AAAC;AAC9F,KACF;AACA,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,IAAA,CAAK,MAAA,GAA8B,EAAC,EAAiC;AACnE,IAAA,MAAM,QAAgC,EAAC;AACvC,IAAA,IAAI,MAAA,CAAO,KAAA,EAAO,KAAA,CAAM,KAAA,GAAQ,MAAA,CAAO,KAAA;AACvC,IAAA,IAAI,MAAA,CAAO,MAAA,EAAQ,KAAA,CAAM,MAAA,GAAS,MAAA,CAAO,MAAA;AACzC,IAAA,IAAI,OAAO,KAAA,KAAU,MAAA,QAAiB,KAAA,GAAQ,MAAA,CAAO,OAAO,KAAK,CAAA;AACjE,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA,CAAQ,OAAO,iBAAA,EAAmB,EAAE,OAAO,CAAA;AAAA,EAChE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAO,KAAA,EAAkC;AAC7C,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAA4B,OAAO,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,KAAK,CAAC,CAAA,CAAE,CAAA;AAC/G,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,IAAA,CAAK,MAAA,GAA8B,EAAC,EAAwB;AAChE,IAAA,MAAM,QAAgC,EAAC;AACvC,IAAA,IAAI,MAAA,CAAO,MAAA,EAAQ,KAAA,CAAM,MAAA,GAAS,MAAA,CAAO,MAAA;AACzC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,QAA8B,KAAA,EAAO,iBAAA,EAAmB,EAAE,KAAA,EAAO,CAAA;AAC/F,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA,EAGA,MAAM,SAAS,IAAA,EAA6B;AAC1C,IAAA,MAAM,KAAK,MAAA,CAAO,OAAA,CAAc,OAAO,SAAA,CAAU,IAAA,EAAM,WAAW,CAAC,CAAA;AAAA,EACrE;AAAA;AAAA,EAGA,MAAM,WAAW,IAAA,EAA6B;AAC5C,IAAA,MAAM,KAAK,MAAA,CAAO,OAAA,CAAc,UAAU,SAAA,CAAU,IAAA,EAAM,WAAW,CAAC,CAAA;AAAA,EACxE;AACF","file":"chunk-YXVMQEJX.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type { CastSwapEngine } from \"./cast-swap.js\"\n\n/**\n * Trends — ready-made Nodaro Motion recipes. A trend is a short clip with slots\n * (the people, pets, products and place you can replace); fill its slots with\n * your own pictures and run it to get the clip back with them in it.\n *\n * Cloud edition only: `/v1/trends` 404s on self-hosted installs. Only\n * published trends exist here: a draft, unpublished or unknown slug is a 404\n * on every route. `\"runs\"` and `\"tags\"` are never slugs (`/v1/trends/runs` is\n * the run list, `/v1/trends/tags` the tag list): the slug methods throw a\n * `TypeError` for them before any request. `run()` answers 202 with a job id; follow it with\n * `client.jobs.get(jobId)` / `client.jobs.getStatus(jobId)` like any other\n * job, or read it back as a trend run with `getRun(jobId)` / `runs()`.\n *\n * Repeats: pass `{ idempotencyKey }` to `run()` and it is sent as the\n * `Idempotency-Key` header. A repeat with the same key answers with the first\n * run's `jobId`; nothing new is started or charged.\n *\n * Refusals (thrown as a `NodaroError` subclass; body `{ error: { code, message } }`):\n * - 400 `validation_error` (the body, a query, or a bad `cursor`);\n *   `estimate()` / `run()` only, before anything is charged:\n *   `missing_slot` (a required slot without pictures, or an optional one\n *   left empty that the chosen example has no pictures for), `unknown_slot`,\n *   `invalid_choice` (a chip the slot's kind does not take),\n *   `chip_not_offered` (a chip of the kind that the slot's\n *   {@link TrendDetailSlot.chips} does not list: the trend fixes it),\n *   `example_out_of_range` (`example` names no example of the trend, or is\n *   sent at all on a trend with none), `preview_unavailable` (the trend offers no\n *   preview), `invalid_slot_mention` (a `{slot:<key>}` in `details` naming no\n *   slot), `prompt_too_long` (shorten `details`), `draft_unsupported`\n *   (`draft: true` on a trend whose `engine` has no draft: Nodaro Motion Pulse),\n *   `resolution_unsupported` (a `resolution` not in the trend's\n *   `resolutions`), `too_many_images` (a Nodaro Motion Pulse trend's run would send more\n *   than 10 pictures: send fewer per slot). The slot errors carry the\n *   slot's key as `slot` (in `NodaroError.details`), and `chip_not_offered`\n *   the chip as `chip` too.\n * - 401 `unauthorized`.\n * - 404 `not_found`: the trend is not published (every method), or `run()`'s\n *   `sessionId` is not a session you may use.\n * - 502 `engine_error` (`estimate()` / `run()`).\n * - 503 `engine_unsupported` (this platform version cannot run trends yet),\n *   `trend_unavailable` (`estimate()` / `run()`), `not_available` (this\n *   server has no trend catalog yet).\n * - `estimate()` / `run()` answer the video engine's refusals with the trend\n *   routes' OWN codes and fixed messages — never the engine's text or\n *   `issues`: 400 `trend_run_rejected` (the inputs could not run), or\n *   `clip_out_of_range` / `preview_out_of_range` / `video_unreadable` (this\n *   trend's clip), `unsafe_url` (a picture is not a public http(s) address),\n *   `raw_reference_token` (`details` holds `{image:` / `{video:` /\n *   `{audio:`); 402 `insufficient_credits` (or a workspace cap) as given;\n *   413 `storage_limit_exceeded`; 422 `job_blocked` (the job policy\n *   blocked it); 429 `rate_limited`; 503 `engine_unsupported`,\n *   `estimate_unavailable`; 502 `engine_error` for anything else. `run()`\n *   also answers 400 `validation_error` for an `idempotencyKey` outside\n *   8–200 characters.\n */\n\n/** `/v1/trends/runs` is the run list and `/v1/trends/tags` the tag list, so neither can be a trend's slug. */\nconst RESERVED_SLUGS: Readonly<Record<string, string>> = {\n  runs: \"the run list; use runs()\",\n  tags: \"the tag list; use tags()\",\n}\n\nfunction trendPath(slug: string, rest = \"\"): string {\n  if (Object.hasOwn(RESERVED_SLUGS, slug)) {\n    throw new TypeError(`\"${slug}\" is not a trend slug (it is reserved for ${RESERVED_SLUGS[slug]})`)\n  }\n  return `/v1/trends/${encodeURIComponent(slug)}${rest}`\n}\n\n/** What a slot holds. */\nexport type TrendSlotKind = \"person\" | \"location\" | \"product\" | \"pet\"\n\n/** A chip: make this trait anew from your pictures (`\"new\"`), or keep the clip's (`\"original\"`). */\nexport type TrendChoice = \"new\" | \"original\"\n\n/**\n * The chips a slot can take, by its kind: a person `body` / `outfit` / `hair`,\n * a pet `body` / `coat`, a product `shape` / `finish`, a location none.\n */\nexport interface TrendChips {\n  body?: TrendChoice\n  outfit?: TrendChoice\n  hair?: TrendChoice\n  coat?: TrendChoice\n  shape?: TrendChoice\n  finish?: TrendChoice\n}\n\n/** A chip's name: `body`, `outfit`, `hair`, `coat`, `shape` or `finish`. */\nexport type TrendChipKey = keyof TrendChips\n\nexport type TrendResolution = \"480p\" | \"720p\" | \"1080p\"\n\n/**\n * The engine a trend runs on, by its public id ({@link CastSwapEngine}):\n * `\"motion-prism\"` (Nodaro Motion Prism) or `\"motion-pulse\"` (Nodaro Motion Pulse).\n * The trend chooses it, never the person running it.\n */\nexport type TrendEngine = CastSwapEngine\n\n/** A trend in the catalog (`list()`). Text is in the resolved locale. */\nexport interface TrendCard {\n  id: string\n  slug: string\n  name: string\n  description?: string\n  tags: string[]\n  /** e.g. `\"trending\"`, `\"new\"`. */\n  badges: string[]\n  /**\n   * The trend's first example, else (a trend with no example) its original's\n   * display copy, as {@link TrendDetail.original}.\n   */\n  cover: { videoUrl: string; posterUrl?: string; width: number; height: number }\n  /** How many slots of each kind the trend has. */\n  needs: Record<TrendSlotKind, number>\n  /** The length of a full run, in seconds. */\n  durationSec: number\n  isFavorite: boolean\n}\n\n/** One slot of a trend: what it asks you for. */\nexport interface TrendDetailSlot {\n  /** The key to fill in {@link TrendRunRequest.slots}, and to mention in `details` as `{slot:<key>}`. */\n  key: string\n  label: string\n  kind: TrendSlotKind\n  /**\n   * A required slot needs pictures; an optional one left empty takes the\n   * chosen example's, or, on a trend with no example, stays as in the original.\n   */\n  required: boolean\n  hint?: string\n  /**\n   * A picture showing who or what this slot is in the original (e.g. a frame\n   * of that actor), when the trend has one. Show it on an empty slot; a run\n   * never sends it.\n   */\n  hintImageUrl?: string\n  /**\n   * The chips you may set on this slot, in its kind's order; `[]` = none (show\n   * no chips row). A chip of the kind that is not listed is fixed by the\n   * trend: sending it is refused with `400 chip_not_offered`.\n   */\n  chips: TrendChipKey[]\n  /** The starting value of the chips in {@link chips} (only those). */\n  defaults?: TrendChips\n}\n\n/** A finished run shown on a trend's page, with the pictures it used per slot. */\nexport interface TrendExample {\n  videoUrl: string\n  posterUrl?: string\n  width: number\n  height: number\n  /** Slot key → the pictures this example used for it. */\n  slots: Record<string, string[]>\n}\n\n/**\n * The clip a trend recasts, as you may show it: a browser-safe copy (H.264\n * MP4) of the clip every run starts from. Its fields parallel\n * {@link TrendExample}'s.\n */\nexport interface TrendOriginal {\n  videoUrl: string\n  posterUrl?: string\n  width: number\n  height: number\n  /** The copy's length, in seconds. */\n  durationSec: number\n  /**\n   * Where the 4-second preview starts in the clip, in seconds (`0` included),\n   * when the trend offers one ({@link TrendDetail.previewSec} is `4`); absent\n   * otherwise.\n   */\n  previewStartSec?: number\n}\n\n/** A trend's page (`get()`). */\nexport interface TrendDetail extends TrendCard {\n  /** The published version this page shows. */\n  version: number\n  /** `4` when the trend offers a 4-second preview run, else `null`. */\n  previewSec: 4 | null\n  /**\n   * The original clip every run starts from, to show beside the examples.\n   * Absent only on a version without a display copy (and from an older server).\n   */\n  original?: TrendOriginal\n  /** The engine every run of this trend uses. Absent (an older server) = `\"motion-prism\"`. */\n  engine?: TrendEngine\n  /** Its name to show: \"Nodaro Motion Prism\" or \"Nodaro Motion Pulse\". Absent from an older server. */\n  engineName?: string\n  /**\n   * The resolutions a run may ask for, the default first. Nodaro Motion Prism:\n   * `[\"480p\", \"720p\", \"1080p\"]`, where 480p is a draft (show it as one);\n   * Nodaro Motion Pulse: `[\"720p\", \"1080p\"]`, no draft. Offer exactly these.\n   */\n  resolutions: TrendResolution[]\n  slots: TrendDetailSlot[]\n  /** Finished runs to show beside the original; may be empty (a trend with only its original). */\n  examples: TrendExample[]\n}\n\n/** What you put in one slot of a run: 1–3 pictures, and the chips the slot offers ({@link TrendDetailSlot.chips}). */\nexport interface TrendRunSlot extends TrendChips {\n  images?: string[]\n}\n\n/** The body of `estimate()` and `run()`. */\nexport interface TrendRunRequest {\n  /**\n   * Slot key → what you put in it. Every required slot needs pictures; an\n   * optional slot left out takes the chosen example's, or, on a trend with no\n   * example, stays as in the original. 1–3 pictures per slot.\n   */\n  slots: Record<string, TrendRunSlot>\n  /**\n   * 1-based example whose pictures fill the optional slots you leave empty.\n   * Default 1. Leave it out on a trend with no examples: sending one there\n   * answers 400 `example_out_of_range` (and `0` is a `validation_error`).\n   */\n  example?: number\n  /** Your own words, at most 1,000 characters. Mention a slot as `{slot:<key>}`. */\n  details?: string\n  /** `true` runs a 4-second preview (only when the trend's `previewSec` is `4`). */\n  preview?: boolean\n  /**\n   * One of the trend's {@link TrendDetail.resolutions}; default its first\n   * (`\"480p\"` on Nodaro Motion Prism, `\"720p\"` on Nodaro Motion Pulse). Another answers 400\n   * `resolution_unsupported`.\n   */\n  resolution?: TrendResolution\n  /**\n   * A draft run, only at 480p on a Nodaro Motion Prism trend. Default `true` at\n   * 480p. `true` on a Nodaro Motion Pulse trend answers 400 `draft_unsupported`.\n   */\n  draft?: boolean\n  /**\n   * A generation session of yours. Accepted (and checked: one you may not use\n   * is a 404), but not yet applied: trend runs are not filed into sessions yet.\n   */\n  sessionId?: string\n  /** Accepted, but not used by the run today. */\n  projectId?: string\n  /**\n   * A full run's own preview: the `jobId` of a completed preview run of this\n   * trend that you started. When that preview needed the trend's retry (the\n   * clip refused at first), the full run is made that way from the start (the\n   * quote includes it). Any other job is ignored, without an error. Must be a uuid\n   * (else 400 `validation_error`).\n   */\n  previewJobId?: string\n  /**\n   * `run()`: your client app's slug (e.g. `\"tools\"`: lowercase letters,\n   * digits and `-`, 1–40 characters, starting with a letter or digit), as on\n   * any job: the run's job carries it as `input_data.origin`, so\n   * `client.jobs.list({ origin })` finds it. Not a slug is a 400\n   * `validation_error`; without it the run has no origin. `estimate()`\n   * ignores it.\n   */\n  origin?: string\n}\n\n/** What a run would cost, in credits (`estimate()`). */\nexport interface TrendEstimate {\n  /** The charge the run is expected to come to. */\n  expectedCredits: number\n  /** What is reserved when the run starts; the run is charged what it actually costs. */\n  holdCredits: number\n  /**\n   * The parts of the quote, by name, for display only: some are alternatives\n   * or sit outside the totals (`privacy`, the retry's, beside\n   * `privacyCredits`), so read `expectedCredits` and `holdCredits`, never\n   * their sum.\n   */\n  breakdown: Record<string, number>\n  /**\n   * Only on a trend that retries a clip the video model refuses: the extra\n   * credits charged if that retry runs. Not included in `expectedCredits` or\n   * `holdCredits`. 0 (or absent) when there is nothing extra to charge.\n   */\n  privacyCredits?: number\n  /** @deprecated read {@link privacyCredits} (an older server answered this name). */\n  maskingCredits?: number\n}\n\n/** Per-call options for {@link TrendsResource.run}. */\nexport interface TrendRunOptions {\n  /**\n   * Sent as the `Idempotency-Key` header, unchanged (an empty string sends no\n   * header). The server takes 8–200 characters and answers 400 for any other\n   * length. Reuse it when retrying the same run.\n   */\n  idempotencyKey?: string\n}\n\n/** One slot of a past run, as it was run. Labels are English. */\nexport interface TrendRunDisplaySlot extends TrendChips {\n  key: string\n  label: string\n  kind: TrendSlotKind\n  images: string[]\n  /**\n   * `true` when the slot was left empty and the example's pictures filled it.\n   * `false` with no `images`: left empty on a trend with no example, so it\n   * stayed as in the original.\n   */\n  fromExample: boolean\n}\n\n/**\n * One of your trend runs (`runs()`, `getRun()`). Stays readable after the\n * trend moves on or is unpublished.\n *\n * A Full Quality version of a draft is a run of its own, with its own status,\n * result and charge: `fullQualityOf` names the draft it was made from, and it\n * stays listed after that draft is deleted.\n */\nexport interface TrendRun {\n  jobId: string\n  status: string\n  progress: number | null\n  /**\n   * Why a failed or cancelled run did not finish; `null` otherwise. `code` is\n   * `safety-block` or `policy-block` when the job was blocked, `credits` when\n   * it ran out of credits partway (it was refunded: ask the person to top up,\n   * then run it again), else `cancelled` or `failed`. `message` is the same\n   * fixed sentence for every code — branch on `code`, not on the text.\n   */\n  error: { code?: string; message: string } | null\n  createdAt: string\n  completedAt: string | null\n  /** The trend and version it ran (name in English). */\n  trend: { id: string; slug: string; version: number; name: string }\n  /**\n   * The 1-based example used for empty optional slots; `0` = the trend had no\n   * example (none was used: never show it as \"Example 0\").\n   */\n  example: number\n  slots: TrendRunDisplaySlot[]\n  details?: string\n  preview: boolean\n  resolution: string\n  draft: boolean\n  /** The engine the run was made on. Absent (an older server) = `\"motion-prism\"`. */\n  engine?: TrendEngine\n  /** Its name to show: \"Nodaro Motion Prism\" or \"Nodaro Motion Pulse\". Absent from an older server. */\n  engineName?: string\n  /** The result, once completed. */\n  videoUrl: string | null\n  posterUrl: string | null\n  /**\n   * What the run was charged once settled, every step it ran included (its\n   * reference preparation, mask and video); `null` until the run's own hold\n   * settles. A step adds its charge once it settles.\n   */\n  creditsCharged: number | null\n  /** The run's hold: its own plus its steps'. Absent from an older server. */\n  creditsHeld?: number | null\n  /** What went back from `creditsHeld` once every hold in the run settled; `null` until then. Absent from an older server. */\n  creditsReleased?: number | null\n  /** A Full Quality version: the job id of the run (a draft, or a Nodaro Motion Pulse 720p run) it was made from. `null` for any other run. */\n  fullQualityOf: string | null\n  /**\n   * A draft's (or Nodaro Motion Pulse 720p run's) newest Full Quality try, if one was started: a pointer only,\n   * to know an upgrade exists and how it is going. Its video and charge are on\n   * that run, listed on its own (its `fullQualityOf` is this run's `jobId`) —\n   * read it there (`getRun(fullQuality.jobId)`). Older tries of the draft (a\n   * failed or cancelled one tried again) are not listed by `runs()`;\n   * `getRun()` still reads one by its id.\n   */\n  fullQuality: { jobId: string; status: string } | null\n  /**\n   * Until when a completed run can be redone in Full Quality — a Nodaro Motion\n   * Prism draft (the same take at 1080p) or a Nodaro Motion Pulse run at 720p (a new take at\n   * 1080p); `null` otherwise.\n   */\n  fullQualityUntil: string | null\n}\n\nexport interface ListTrendsParams {\n  /** Search text. */\n  q?: string\n  tag?: string\n  /** `true` lists only your favorites. */\n  favorites?: boolean\n  /** A platform language for names and descriptions; default your profile's, then English. */\n  locale?: string\n  /** The previous page's `next`. */\n  cursor?: string\n  /** Page size, 1–60 (server default 30). */\n  limit?: number\n}\n\nexport interface ListTrendRunsParams {\n  /** Only runs of this trend (its slug). */\n  trend?: string\n  /** The previous page's `next`. */\n  cursor?: string\n  /** Page size, 1–60 (server default 30). */\n  limit?: number\n}\n\n/** A tag in use on the published catalog (`tags()`). */\nexport interface TrendTag {\n  /** The tag itself: pass it as `list({ tag })`. */\n  tag: string\n  /** The tag's label in the resolved locale; the tag itself when it has none. */\n  label: string\n  /** How many published trends carry it. */\n  count: number\n}\n\nexport interface TrendPage<T> {\n  data: T[]\n  /** Pass back as `cursor` for the next page; `null` on the last one. */\n  next: string | null\n}\n\nexport class TrendsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** The published catalog in its curated order (`GET /v1/trends`), a page at a time. */\n  list(params: ListTrendsParams = {}): Promise<TrendPage<TrendCard>> {\n    const query: Record<string, string> = {}\n    if (params.q) query.q = params.q\n    if (params.tag) query.tag = params.tag\n    if (params.favorites) query.favorites = \"1\"\n    if (params.locale) query.locale = params.locale\n    if (params.cursor) query.cursor = params.cursor\n    if (params.limit !== undefined) query.limit = String(params.limit)\n    return this.client.request(\"GET\", \"/v1/trends\", { query })\n  }\n\n  /** A published trend's page (`GET /v1/trends/:slug`). */\n  async get(slug: string, params: { locale?: string } = {}): Promise<TrendDetail> {\n    const query: Record<string, string> = {}\n    if (params.locale) query.locale = params.locale\n    const res = await this.client.request<{ data: TrendDetail }>(\"GET\", trendPath(slug), { query })\n    return res.data\n  }\n\n  /** Quote a run before starting it (`POST /v1/trends/:slug/estimate`); spends nothing. */\n  async estimate(slug: string, request: TrendRunRequest): Promise<TrendEstimate> {\n    const res = await this.client.request<{ data: TrendEstimate }>(\n      \"POST\",\n      trendPath(slug, \"/estimate\"),\n      { body: request },\n    )\n    return res.data\n  }\n\n  /**\n   * Start a run (`POST /v1/trends/:slug/runs`, 202). Returns the job to follow.\n   * With `options.idempotencyKey` (sent as the `Idempotency-Key` header) a\n   * repeat with the same key answers with the first run's `jobId`.\n   */\n  async run(slug: string, request: TrendRunRequest, options?: TrendRunOptions): Promise<{ jobId: string }> {\n    const res = await this.client.request<{ data: { jobId: string } }>(\n      \"POST\",\n      trendPath(slug, \"/runs\"),\n      {\n        body: request,\n        ...(options?.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}),\n      },\n    )\n    return res.data\n  }\n\n  /**\n   * Your trend runs, newest first (`GET /v1/trends/runs`). A Full Quality\n   * version of a draft is listed as its own run (`fullQualityOf`).\n   */\n  runs(params: ListTrendRunsParams = {}): Promise<TrendPage<TrendRun>> {\n    const query: Record<string, string> = {}\n    if (params.trend) query.trend = params.trend\n    if (params.cursor) query.cursor = params.cursor\n    if (params.limit !== undefined) query.limit = String(params.limit)\n    return this.client.request(\"GET\", \"/v1/trends/runs\", { query })\n  }\n\n  /**\n   * One of your trend runs by its job id (`GET /v1/trends/runs/:jobId`), in\n   * the same shape as `runs()`. A job that is not your own trend run is a\n   * `NotFoundError`.\n   */\n  async getRun(jobId: string): Promise<TrendRun> {\n    const res = await this.client.request<{ data: TrendRun }>(\"GET\", `/v1/trends/runs/${encodeURIComponent(jobId)}`)\n    return res.data\n  }\n\n  /**\n   * The tags in use on the published catalog, each with its label in the\n   * resolved locale (`GET /v1/trends/tags`), most used first.\n   */\n  async tags(params: { locale?: string } = {}): Promise<TrendTag[]> {\n    const query: Record<string, string> = {}\n    if (params.locale) query.locale = params.locale\n    const res = await this.client.request<{ data: TrendTag[] }>(\"GET\", \"/v1/trends/tags\", { query })\n    return res.data\n  }\n\n  /** Add a trend to your favorites (`PUT /v1/trends/:slug/favorite`). */\n  async favorite(slug: string): Promise<void> {\n    await this.client.request<void>(\"PUT\", trendPath(slug, \"/favorite\"))\n  }\n\n  /** Remove a trend from your favorites (`DELETE /v1/trends/:slug/favorite`). */\n  async unfavorite(slug: string): Promise<void> {\n    await this.client.request<void>(\"DELETE\", trendPath(slug, \"/favorite\"))\n  }\n}\n"]}