@nodaro/sdk 2.60.0 → 2.61.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 (173) hide show
  1. package/dist/{chunk-Z3ZKFI2M.js → chunk-22XXTB2R.js} +2 -2
  2. package/dist/chunk-22XXTB2R.js.map +1 -0
  3. package/dist/{chunk-JJMQ2EVL.js → chunk-27LD2VRE.js} +22 -3
  4. package/dist/chunk-27LD2VRE.js.map +1 -0
  5. package/dist/chunk-2M4VYNSE.cjs +4 -0
  6. package/dist/chunk-2M4VYNSE.cjs.map +1 -0
  7. package/dist/{chunk-MWSD2FSG.cjs → chunk-5LI4CVJB.cjs} +2 -2
  8. package/dist/chunk-5LI4CVJB.cjs.map +1 -0
  9. package/dist/{chunk-X24USXOQ.js → chunk-A42R7UT7.js} +2 -2
  10. package/dist/chunk-A42R7UT7.js.map +1 -0
  11. package/dist/{chunk-GSE7SB3I.cjs → chunk-AMQZ5FAE.cjs} +23 -2
  12. package/dist/chunk-AMQZ5FAE.cjs.map +1 -0
  13. package/dist/{chunk-WMLVZMFN.js → chunk-DGGGVFTS.js} +29 -21
  14. package/dist/chunk-DGGGVFTS.js.map +1 -0
  15. package/dist/chunk-G2V5WUQX.js +25 -0
  16. package/dist/chunk-G2V5WUQX.js.map +1 -0
  17. package/dist/{chunk-23GZVMG6.cjs → chunk-G44XYWDA.cjs} +5 -5
  18. package/dist/{chunk-23GZVMG6.cjs.map → chunk-G44XYWDA.cjs.map} +1 -1
  19. package/dist/{chunk-COCKKMNP.cjs → chunk-G4AFHCNA.cjs} +2 -2
  20. package/dist/chunk-G4AFHCNA.cjs.map +1 -0
  21. package/dist/{chunk-TVPYDC5T.cjs → chunk-GGIWDFER.cjs} +2 -2
  22. package/dist/chunk-GGIWDFER.cjs.map +1 -0
  23. package/dist/{chunk-GWTKYJJO.cjs → chunk-HHVZD3TL.cjs} +36 -25
  24. package/dist/chunk-HHVZD3TL.cjs.map +1 -0
  25. package/dist/{chunk-DOMNKVKA.cjs → chunk-HIVIWAKA.cjs} +9 -9
  26. package/dist/{chunk-DOMNKVKA.cjs.map → chunk-HIVIWAKA.cjs.map} +1 -1
  27. package/dist/{chunk-K4RQOSJH.js → chunk-J2DBYYXC.js} +2 -2
  28. package/dist/chunk-J2DBYYXC.js.map +1 -0
  29. package/dist/{chunk-HCVJ7JQR.cjs → chunk-LB5WQZJA.cjs} +41 -33
  30. package/dist/chunk-LB5WQZJA.cjs.map +1 -0
  31. package/dist/{chunk-RCD4HDBI.js → chunk-LZUEVHZM.js} +3 -3
  32. package/dist/{chunk-RCD4HDBI.js.map → chunk-LZUEVHZM.js.map} +1 -1
  33. package/dist/chunk-M7TYOYFN.cjs +27 -0
  34. package/dist/chunk-M7TYOYFN.cjs.map +1 -0
  35. package/dist/{chunk-YYMX3VN7.js → chunk-MQO2SXSG.js} +3 -3
  36. package/dist/{chunk-YYMX3VN7.js.map → chunk-MQO2SXSG.js.map} +1 -1
  37. package/dist/{chunk-ALDXFMD7.js → chunk-N5ESAUSB.js} +17 -6
  38. package/dist/chunk-N5ESAUSB.js.map +1 -0
  39. package/dist/{chunk-KU3UITCU.cjs → chunk-ND46XQVL.cjs} +5 -5
  40. package/dist/{chunk-KU3UITCU.cjs.map → chunk-ND46XQVL.cjs.map} +1 -1
  41. package/dist/chunk-NMLYZWIW.cjs +4 -0
  42. package/dist/chunk-NMLYZWIW.cjs.map +1 -0
  43. package/dist/{chunk-3Y5TDB5K.cjs → chunk-NRTYE4VU.cjs} +11 -7
  44. package/dist/chunk-NRTYE4VU.cjs.map +1 -0
  45. package/dist/{chunk-DTYN7QAZ.js → chunk-P2C33IOF.js} +9 -4
  46. package/dist/chunk-P2C33IOF.js.map +1 -0
  47. package/dist/{chunk-ALTMF4ND.js → chunk-PDVMB2F6.js} +4 -4
  48. package/dist/{chunk-ALTMF4ND.js.map → chunk-PDVMB2F6.js.map} +1 -1
  49. package/dist/{chunk-GDUEOKBF.cjs → chunk-RDIZF74K.cjs} +4 -4
  50. package/dist/{chunk-GDUEOKBF.cjs.map → chunk-RDIZF74K.cjs.map} +1 -1
  51. package/dist/chunk-RKW3N463.cjs +83 -0
  52. package/dist/chunk-RKW3N463.cjs.map +1 -0
  53. package/dist/{chunk-TSM3S2QS.cjs → chunk-RZL3ZKKX.cjs} +5 -5
  54. package/dist/{chunk-TSM3S2QS.cjs.map → chunk-RZL3ZKKX.cjs.map} +1 -1
  55. package/dist/{chunk-MUHRK4OI.js → chunk-SIRIMRCW.js} +3 -3
  56. package/dist/{chunk-MUHRK4OI.js.map → chunk-SIRIMRCW.js.map} +1 -1
  57. package/dist/{chunk-ND7JMM5H.js → chunk-TKV2YTNW.js} +10 -6
  58. package/dist/chunk-TKV2YTNW.js.map +1 -0
  59. package/dist/chunk-TLTPIS2A.js +81 -0
  60. package/dist/chunk-TLTPIS2A.js.map +1 -0
  61. package/dist/chunk-UIBY7JVJ.js +3 -0
  62. package/dist/chunk-UIBY7JVJ.js.map +1 -0
  63. package/dist/{chunk-VTL4DBX4.js → chunk-ULFLA7YB.js} +3 -3
  64. package/dist/{chunk-VTL4DBX4.js.map → chunk-ULFLA7YB.js.map} +1 -1
  65. package/dist/{chunk-NOZWIS7M.cjs → chunk-UPGZTLK7.cjs} +9 -4
  66. package/dist/chunk-UPGZTLK7.cjs.map +1 -0
  67. package/dist/{chunk-ZVKEPVDQ.js → chunk-VQOUF4F5.js} +2 -2
  68. package/dist/chunk-VQOUF4F5.js.map +1 -0
  69. package/dist/{chunk-SBV5MWEL.cjs → chunk-VUTNNRDW.cjs} +2 -2
  70. package/dist/chunk-VUTNNRDW.cjs.map +1 -0
  71. package/dist/{chunk-GJH73EGF.cjs → chunk-WYX44JHE.cjs} +12 -2
  72. package/dist/chunk-WYX44JHE.cjs.map +1 -0
  73. package/dist/{chunk-4SZUSZXK.js → chunk-X4QICOOM.js} +12 -2
  74. package/dist/chunk-X4QICOOM.js.map +1 -0
  75. package/dist/chunk-XV4MDWHF.js +3 -0
  76. package/dist/chunk-XV4MDWHF.js.map +1 -0
  77. package/dist/entries/billing.cjs +2 -2
  78. package/dist/entries/billing.d.cts +5 -1
  79. package/dist/entries/billing.d.ts +5 -1
  80. package/dist/entries/billing.js +1 -1
  81. package/dist/entries/cast-swap.cjs +2 -2
  82. package/dist/entries/cast-swap.d.cts +53 -8
  83. package/dist/entries/cast-swap.d.ts +53 -8
  84. package/dist/entries/cast-swap.js +1 -1
  85. package/dist/entries/characters.d.cts +1 -1
  86. package/dist/entries/characters.d.ts +1 -1
  87. package/dist/entries/client.cjs +29 -27
  88. package/dist/entries/client.d.cts +7 -1
  89. package/dist/entries/client.d.ts +7 -1
  90. package/dist/entries/client.js +24 -22
  91. package/dist/entries/content-rights.cjs +13 -0
  92. package/dist/entries/content-rights.cjs.map +1 -0
  93. package/dist/entries/content-rights.d.cts +47 -0
  94. package/dist/entries/content-rights.d.ts +47 -0
  95. package/dist/entries/content-rights.js +4 -0
  96. package/dist/entries/content-rights.js.map +1 -0
  97. package/dist/entries/copilot.cjs +4 -4
  98. package/dist/entries/copilot.js +3 -3
  99. package/dist/entries/core.cjs +6 -6
  100. package/dist/entries/core.js +2 -2
  101. package/dist/entries/creatures.d.cts +1 -1
  102. package/dist/entries/creatures.d.ts +1 -1
  103. package/dist/entries/edit.cjs +7 -7
  104. package/dist/entries/edit.js +2 -2
  105. package/dist/entries/errors.cjs +34 -26
  106. package/dist/entries/errors.d.cts +27 -2
  107. package/dist/entries/errors.d.ts +27 -2
  108. package/dist/entries/errors.js +1 -1
  109. package/dist/entries/executions.cjs +4 -4
  110. package/dist/entries/executions.d.cts +8 -0
  111. package/dist/entries/executions.d.ts +8 -0
  112. package/dist/entries/executions.js +1 -1
  113. package/dist/entries/jobs.cjs +2 -2
  114. package/dist/entries/jobs.d.cts +50 -1
  115. package/dist/entries/jobs.d.ts +50 -1
  116. package/dist/entries/jobs.js +1 -1
  117. package/dist/entries/locations.d.cts +1 -1
  118. package/dist/entries/locations.d.ts +1 -1
  119. package/dist/entries/media.cjs +4 -4
  120. package/dist/entries/media.d.cts +8 -3
  121. package/dist/entries/media.d.ts +8 -3
  122. package/dist/entries/media.js +3 -3
  123. package/dist/entries/nodes.cjs +3 -3
  124. package/dist/entries/nodes.d.cts +1 -1
  125. package/dist/entries/nodes.d.ts +1 -1
  126. package/dist/entries/nodes.js +2 -2
  127. package/dist/entries/objects.d.cts +1 -1
  128. package/dist/entries/objects.d.ts +1 -1
  129. package/dist/entries/pipelines.cjs +2 -2
  130. package/dist/entries/pipelines.d.cts +7 -0
  131. package/dist/entries/pipelines.d.ts +7 -0
  132. package/dist/entries/pipelines.js +1 -1
  133. package/dist/entries/scene3d.d.cts +2 -2
  134. package/dist/entries/scene3d.d.ts +2 -2
  135. package/dist/entries/studio.cjs +5 -5
  136. package/dist/entries/studio.js +2 -2
  137. package/dist/entries/trend-radar.cjs +13 -0
  138. package/dist/entries/trend-radar.cjs.map +1 -0
  139. package/dist/entries/trend-radar.d.cts +243 -0
  140. package/dist/entries/trend-radar.d.ts +243 -0
  141. package/dist/entries/trend-radar.js +4 -0
  142. package/dist/entries/trend-radar.js.map +1 -0
  143. package/dist/entries/uploads.cjs +2 -2
  144. package/dist/entries/uploads.d.cts +8 -1
  145. package/dist/entries/uploads.d.ts +8 -1
  146. package/dist/entries/uploads.js +1 -1
  147. package/dist/index.cjs +135 -115
  148. package/dist/index.d.cts +6 -4
  149. package/dist/index.d.ts +6 -4
  150. package/dist/index.js +33 -29
  151. package/dist/{nodes-Cy6dmQEz.d.ts → nodes-BXL3qXlY.d.ts} +10 -2
  152. package/dist/{nodes-Di-Z7-vr.d.cts → nodes-Dx8rpU12.d.cts} +10 -2
  153. package/package.json +12 -2
  154. package/dist/chunk-3Y5TDB5K.cjs.map +0 -1
  155. package/dist/chunk-4SZUSZXK.js.map +0 -1
  156. package/dist/chunk-ALDXFMD7.js.map +0 -1
  157. package/dist/chunk-COCKKMNP.cjs.map +0 -1
  158. package/dist/chunk-DTYN7QAZ.js.map +0 -1
  159. package/dist/chunk-GJH73EGF.cjs.map +0 -1
  160. package/dist/chunk-GSE7SB3I.cjs.map +0 -1
  161. package/dist/chunk-GWTKYJJO.cjs.map +0 -1
  162. package/dist/chunk-HCVJ7JQR.cjs.map +0 -1
  163. package/dist/chunk-JJMQ2EVL.js.map +0 -1
  164. package/dist/chunk-K4RQOSJH.js.map +0 -1
  165. package/dist/chunk-MWSD2FSG.cjs.map +0 -1
  166. package/dist/chunk-ND7JMM5H.js.map +0 -1
  167. package/dist/chunk-NOZWIS7M.cjs.map +0 -1
  168. package/dist/chunk-SBV5MWEL.cjs.map +0 -1
  169. package/dist/chunk-TVPYDC5T.cjs.map +0 -1
  170. package/dist/chunk-WMLVZMFN.js.map +0 -1
  171. package/dist/chunk-X24USXOQ.js.map +0 -1
  172. package/dist/chunk-Z3ZKFI2M.js.map +0 -1
  173. package/dist/chunk-ZVKEPVDQ.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/resources/billing.ts"],"names":[],"mappings":"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","file":"chunk-ZVKEPVDQ.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 /** 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 /** 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 /** 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. `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"]}