@nodaro/sdk 2.71.0 → 2.73.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (97) hide show
  1. package/README.md +2 -1
  2. package/dist/{chunk-6JAILT34.cjs → chunk-47TWDFFJ.cjs} +3 -3
  3. package/dist/{chunk-6JAILT34.cjs.map → chunk-47TWDFFJ.cjs.map} +1 -1
  4. package/dist/{chunk-ZMSGJC7L.js → chunk-54NGEY45.js} +2 -2
  5. package/dist/chunk-54NGEY45.js.map +1 -0
  6. package/dist/{chunk-HRFLEHSS.cjs → chunk-6RH2SICN.cjs} +2 -2
  7. package/dist/chunk-6RH2SICN.cjs.map +1 -0
  8. package/dist/chunk-CHZBONJJ.js +3 -0
  9. package/dist/{chunk-IWASCR2O.js.map → chunk-CHZBONJJ.js.map} +1 -1
  10. package/dist/chunk-D5X3NKSI.js +59 -0
  11. package/dist/chunk-D5X3NKSI.js.map +1 -0
  12. package/dist/{chunk-MCXZV3CW.js → chunk-INRVOUKE.js} +2 -2
  13. package/dist/chunk-INRVOUKE.js.map +1 -0
  14. package/dist/chunk-JRQ5UV4U.js +3 -0
  15. package/dist/{chunk-7WS3VTUG.cjs.map → chunk-JRQ5UV4U.js.map} +1 -1
  16. package/dist/{chunk-MDTIPELE.js → chunk-JWWRUP6Z.js} +3 -3
  17. package/dist/{chunk-MDTIPELE.js.map → chunk-JWWRUP6Z.js.map} +1 -1
  18. package/dist/{chunk-P7UT2YH4.cjs → chunk-K7G4OYDH.cjs} +2 -2
  19. package/dist/chunk-K7G4OYDH.cjs.map +1 -0
  20. package/dist/chunk-KKH7QQAR.cjs +61 -0
  21. package/dist/chunk-KKH7QQAR.cjs.map +1 -0
  22. package/dist/{chunk-HRW5IGJ2.js → chunk-KKQKJD7K.js} +2 -2
  23. package/dist/chunk-KKQKJD7K.js.map +1 -0
  24. package/dist/{chunk-NLCZFLLJ.cjs → chunk-NZUF5U37.cjs} +20 -16
  25. package/dist/chunk-NZUF5U37.cjs.map +1 -0
  26. package/dist/{chunk-7WS3VTUG.cjs → chunk-RKYZY6NA.cjs} +2 -2
  27. package/dist/chunk-RKYZY6NA.cjs.map +1 -0
  28. package/dist/chunk-RUE3DNLT.cjs +4 -0
  29. package/dist/chunk-RUE3DNLT.cjs.map +1 -0
  30. package/dist/{chunk-JZO5WWKX.js → chunk-S5V37WYY.js} +27 -6
  31. package/dist/chunk-S5V37WYY.js.map +1 -0
  32. package/dist/{chunk-N7RR23PV.js → chunk-VHHLYDF5.js} +15 -11
  33. package/dist/chunk-VHHLYDF5.js.map +1 -0
  34. package/dist/{chunk-S5VSDJAM.cjs → chunk-WKNWJDF6.cjs} +27 -6
  35. package/dist/chunk-WKNWJDF6.cjs.map +1 -0
  36. package/dist/{chunk-XSYNVD3X.cjs → chunk-YDRNPIUC.cjs} +2 -2
  37. package/dist/chunk-YDRNPIUC.cjs.map +1 -0
  38. package/dist/entries/audio.d.cts +1 -1
  39. package/dist/entries/audio.d.ts +1 -1
  40. package/dist/entries/billing.cjs +2 -2
  41. package/dist/entries/billing.d.cts +1 -1
  42. package/dist/entries/billing.d.ts +1 -1
  43. package/dist/entries/billing.js +1 -1
  44. package/dist/entries/characters.d.cts +2 -1
  45. package/dist/entries/characters.d.ts +2 -1
  46. package/dist/entries/client.cjs +16 -15
  47. package/dist/entries/client.d.cts +5 -1
  48. package/dist/entries/client.d.ts +5 -1
  49. package/dist/entries/client.js +11 -10
  50. package/dist/entries/core.cjs +5 -5
  51. package/dist/entries/core.js +1 -1
  52. package/dist/entries/creatures.d.cts +2 -1
  53. package/dist/entries/creatures.d.ts +2 -1
  54. package/dist/entries/dubbing.cjs +13 -0
  55. package/dist/entries/dubbing.cjs.map +1 -0
  56. package/dist/entries/dubbing.d.cts +89 -0
  57. package/dist/entries/dubbing.d.ts +89 -0
  58. package/dist/entries/dubbing.js +4 -0
  59. package/dist/entries/dubbing.js.map +1 -0
  60. package/dist/entries/locations.d.cts +2 -1
  61. package/dist/entries/locations.d.ts +2 -1
  62. package/dist/entries/media.d.cts +2 -1
  63. package/dist/entries/media.d.ts +2 -1
  64. package/dist/entries/models.cjs +2 -2
  65. package/dist/entries/models.d.cts +7 -0
  66. package/dist/entries/models.d.ts +7 -0
  67. package/dist/entries/models.js +1 -1
  68. package/dist/entries/nodes.cjs +5 -5
  69. package/dist/entries/nodes.d.cts +2 -1
  70. package/dist/entries/nodes.d.ts +2 -1
  71. package/dist/entries/nodes.js +2 -2
  72. package/dist/entries/objects.d.cts +2 -1
  73. package/dist/entries/objects.d.ts +2 -1
  74. package/dist/entries/scene3d.d.cts +3 -2
  75. package/dist/entries/scene3d.d.ts +3 -2
  76. package/dist/entries/voices.cjs +2 -2
  77. package/dist/entries/voices.d.cts +54 -5
  78. package/dist/entries/voices.d.ts +54 -5
  79. package/dist/entries/voices.js +1 -1
  80. package/dist/index.cjs +51 -45
  81. package/dist/index.d.cts +5 -3
  82. package/dist/index.d.ts +5 -3
  83. package/dist/index.js +18 -16
  84. package/dist/{nodes-sULkr8Ez.d.ts → nodes-CB5hXtZV.d.ts} +74 -6
  85. package/dist/{nodes-BoYTazf4.d.cts → nodes-RenTt7e3.d.cts} +74 -6
  86. package/package.json +8 -3
  87. package/dist/chunk-HRFLEHSS.cjs.map +0 -1
  88. package/dist/chunk-HRW5IGJ2.js.map +0 -1
  89. package/dist/chunk-IWASCR2O.js +0 -3
  90. package/dist/chunk-JZO5WWKX.js.map +0 -1
  91. package/dist/chunk-MCXZV3CW.js.map +0 -1
  92. package/dist/chunk-N7RR23PV.js.map +0 -1
  93. package/dist/chunk-NLCZFLLJ.cjs.map +0 -1
  94. package/dist/chunk-P7UT2YH4.cjs.map +0 -1
  95. package/dist/chunk-S5VSDJAM.cjs.map +0 -1
  96. package/dist/chunk-XSYNVD3X.cjs.map +0 -1
  97. package/dist/chunk-ZMSGJC7L.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/resources/billing.ts"],"names":[],"mappings":"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","file":"chunk-XSYNVD3X.cjs","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 /** The Stripe price id: pass it to {@link BillingResource.checkout} or {@link BillingResource.changePlan}; match the subscription's `stripe_price_id` to it to learn the interval. */\n priceId: string\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 Stripe price id: pass it to {@link BillingResource.checkout} or {@link BillingResource.changePlan}; match the subscription's `stripe_price_id` to it to learn the interval. */\n priceId: string\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 /**\n * How many nodes of one workflow run at once. Once Nodaro Cloud enforces its\n * concurrency limits, the plan's limit on generations running at once,\n * shared by all of an account's runs.\n */\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 /** The pack's own id (`\"topup-25\"`), not a Stripe id. */\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 /** The Stripe price id for {@link BillingResource.checkout} (mode `\"payment\"`); `null` with the price. A pack can always be bought as a load of `price.amount` through {@link BillingResource.loadCredits}. */\n priceId: string | 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. Promotion codes apply to plans only. A\n * plan's checkout answers `409` while the account already has a\n * subscription: use {@link BillingResource.changePlan}. `ForbiddenError`\n * with the code `self_serve_disabled` on a deployment that does not sell to\n * its users. **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 * An upgrade charges the price difference for the rest of the billing\n * period at once and applies only when that payment succeeds; it adds the\n * difference between the two plans' monthly credits, once per billing\n * period. A downgrade applies at once and keeps the current credits until\n * the period ends. An upgrade invoice settled for 0 adds no credits, and a\n * monthly <-> yearly switch adds none either. `NotFoundError` with no\n * active subscription; `400` on a pack's price or the current one; `409`\n * when the subscription is not active. A `NodaroError` with status `409`\n * and code `plan_change_payment_required` when the upgrade waits on its\n * payment: the plan is unchanged and `details.invoiceUrl` is Stripe's page\n * for paying it. `RateLimitedError` after 5 plan-change requests from one\n * account in 24 hours. **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"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/resources/models.ts"],"names":[],"mappings":";AA4HO,IAAM,iBAAN,MAAqB;AAAA,EAC1B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA,EAKpB,IAAA,CAAK,IAAA,GAA0B,EAAC,EAA8B;AAC5D,IAAA,MAAM,EAAA,GAAK,IAAI,eAAA,EAAgB;AAC/B,IAAA,IAAI,KAAK,IAAA,EAAM,EAAA,CAAG,GAAA,CAAI,MAAA,EAAQ,KAAK,IAAI,CAAA;AACvC,IAAA,IAAI,KAAK,IAAA,EAAM,EAAA,CAAG,GAAA,CAAI,MAAA,EAAQ,KAAK,IAAI,CAAA;AACvC,IAAA,IAAI,KAAK,MAAA,EAAQ,EAAA,CAAG,GAAA,CAAI,QAAA,EAAU,KAAK,MAAM,CAAA;AAC7C,IAAA,IAAI,IAAA,CAAK,YAAA,EAAc,EAAA,CAAG,GAAA,CAAI,gBAAgB,MAAM,CAAA;AACpD,IAAA,MAAM,KAAA,GAAQ,GAAG,QAAA,EAAS;AAC1B,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,CAAA,UAAA,EAAa,QAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAE,CAAA,CAAE,CAAA;AAAA,EAC3E;AACF","file":"chunk-ZMSGJC7L.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * The company that made a model. `id` is stable — one id per company, the\n * company's name lowercased and hyphenated (`\"google\"`, `\"black-forest-labs\"`)\n * — so an app may key its own assets on it; a newer server can add makers, so\n * handle an id you do not know. `name` is the company's display name.\n */\nexport interface ModelMaker {\n id: string\n name: string\n}\n\n/**\n * Model-catalog types. Mirrors the backend's `GET /v1/models` projection\n * (itself shared with the MCP `list_models` tool) so the SDK stays\n * dependency-free — same convention as `PickerCatalog` / `NodeDescriptor`.\n */\nexport interface ModelSummary {\n id: string\n label: string\n /** The company that made the model. Not the same as the family it is\n * grouped under: a few families name a lab or a product line (Tongyi-MAI\n * and HappyHorse are Alibaba's, Depth Anything is ByteDance's). Absent on\n * a model the instance offers under its own label (it names no maker), and\n * on an older server. */\n maker?: ModelMaker\n /** The maker's official mark (an SVG) on this deployment's media CDN, or\n * null when the deployment does not publish one for this maker — draw a\n * fallback (the maker's name or initial) then — and null for a model the\n * instance offers under its own label (it names no maker). The address\n * carries its file's version, so a replaced mark arrives under a new\n * address. Absent on an older server. */\n logoUrl?: string | null\n description: string\n modes: string[]\n useCases: string[]\n /** Per-variant credit pricing: the credits a run of each variant is\n * charged, the figure on the node's Run button. Cloud only — editions\n * without a credit system (community/business) omit the field entirely. */\n pricing?: Array<{ identifier: string; credits: number; note?: string }>\n featured?: boolean\n features?: string[]\n aspectRatios?: string[]\n resolutions?: string[]\n /**\n * The aspect ratios at which the model renders fewer sizes than\n * `resolutions`, each with the sizes it renders there, in the spelling of\n * `resolutions` — e.g. GPT Image 2.5 `{ \"27:16\": [\"1K\"], \"16:27\": [\"1K\"],\n * \"9:8\": [\"1K\"], \"8:9\": [\"1K\"] }`. A ratio not listed renders every entry of\n * `resolutions`. Absent when every ratio renders every size (and on an\n * older server). A request for a size its ratio does not render runs, and\n * is charged, at the largest size the ratio renders at or below it; the\n * response's `adjustments` say so. A size menu offers, at the chosen ratio,\n * `resolutionsByAspectRatio?.[ratio] ?? resolutions`.\n */\n resolutionsByAspectRatio?: Record<string, string[]>\n qualities?: string[]\n /** The image background settings the model takes (`auto`, `opaque`, `transparent`). */\n backgrounds?: string[]\n /**\n * The one size a transparent background renders at, where the model limits\n * it (`\"1K\"` on GPT Image 2.5, and 2.6 Flare and Sunburst). A transparent\n * request at another size runs, and is charged, at this one. Absent when\n * the model sets no such limit (and on an older server).\n */\n transparentResolution?: string\n /**\n * `true` when the model takes a background setting only at\n * `transparentResolution` (GPT Image 2.5): at any other size the setting is\n * not sent, so `opaque` there renders as `auto`. Absent otherwise.\n */\n backgroundOnlyAtTransparentResolution?: true\n /** The files the model writes (`png`, `jpeg`, `webp`, `gif`, `svg`), its default first. Absent: a single format, not a setting. */\n outputFormats?: string[]\n /** The pixel size of every frame of a GIF the model writes (square). Present when `outputFormats` lists `gif`. */\n gifFrameSize?: number\n /** A GIF's frames: a whole number from `min` to `max`, or one of `values` where the model takes only some. */\n gifFrames?: { min: number; max: number; default: number; values?: number[] }\n /** How long each GIF frame shows, in ms: `min` to `max` in steps of `step`. */\n gifFrameDurationMs?: { min: number; max: number; step: number; default: number }\n /** The levels of detail an SVG is drawn at (`standard`, `detailed`, `max`), the default first. Present when `outputFormats` lists `svg`. */\n svgLevels?: string[]\n durations?: number[]\n /** The length (seconds) a request that names no `duration` renders and is\n * charged at, where the model has one. */\n defaultDuration?: number\n /** `true` when the model accepts `duration: -1`: it picks the length itself. */\n autoDuration?: true\n /**\n * The values `referenceTaskType` takes on this model (what a request's\n * reference media is for): `[\"reference\", \"edit\", \"extend\"]` on\n * `seedance-2-5`. Absent on a model that takes none (and on an older\n * server); `\"auto\"`, the default, is never listed.\n */\n referenceTaskTypes?: Array<\"reference\" | \"edit\" | \"extend\">\n /** Compact per-model prompting tips (present when a doctrine exists). */\n promptTips?: string[]\n /** TRUE only when a sourced per-family prompt doctrine exists for this\n * model — gate \"vendor doctrine · real rewrite\" badges on this and show\n * a generic label otherwise (never overclaim). */\n doctrineCovered: boolean\n}\n\nexport interface ModelFamilyGroup {\n family: string\n models: ModelSummary[]\n}\n\nexport interface ModelsListResult {\n sections: Array<{ kind: \"image\" | \"video\" | \"audio\"; families: ModelFamilyGroup[] }>\n recommendations: Array<{ id: string; title: string; modelIds: string[]; reason?: string } & Record<string, unknown>>\n totalModels: number\n}\n\nexport interface ListModelsOptions {\n kind?: \"image\" | \"video\" | \"audio\"\n /** Operation filter, e.g. \"t2v\", \"i2v\", \"t2i\". */\n mode?: string\n /** Vendor / lab name, e.g. \"Google\", \"Bytedance\". */\n family?: string\n featuredOnly?: boolean\n}\n\nexport class ModelsResource {\n constructor(private client: NodaroClientCore) {}\n\n /** Browse the models available on this instance — capability sheets,\n * per-variant credit pricing, prompt tips, and the `doctrineCovered`\n * truth flag. Public endpoint; cached 5 minutes. */\n list(opts: ListModelsOptions = {}): Promise<ModelsListResult> {\n const qs = new URLSearchParams()\n if (opts.kind) qs.set(\"kind\", opts.kind)\n if (opts.mode) qs.set(\"mode\", opts.mode)\n if (opts.family) qs.set(\"family\", opts.family)\n if (opts.featuredOnly) qs.set(\"featuredOnly\", \"true\")\n const query = qs.toString()\n return this.client.request(\"GET\", `/v1/models${query ? `?${query}` : \"\"}`)\n }\n}\n"]}