@nodaro/sdk 2.49.0 → 2.52.0

package/dist/chunk-ZVKEPVDQ.js.map

@@ -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"]}

package/dist/entries/billing.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-IS26FJO7.cjs');
-var chunkNGKODS3J_cjs = require('../chunk-NGKODS3J.cjs');
+var chunkTVPYDC5T_cjs = require('../chunk-TVPYDC5T.cjs');
 
 
 
 Object.defineProperty(exports, "BillingResource", {
   enumerable: true,
-  get: function () { return chunkNGKODS3J_cjs.BillingResource; }
+  get: function () { return chunkTVPYDC5T_cjs.BillingResource; }
 });
 //# sourceMappingURL=billing.cjs.map
 //# sourceMappingURL=billing.cjs.map

package/dist/entries/billing.d.cts

@@ -8,8 +8,10 @@ import '@nodaro/shared/organizations';
  * (`backend/src/ee/routes/billing.ts`, `backend/src/routes/billing-surface.ts`),
  * the source of truth: keep these in sync if they change.
  *
- * Buying, changing the plan and the payment settings stay in the Nodaro app:
- * those routes refuse API and app tokens, so they have no method here.
+ * Buying, the plan, the payment settings, the receipts and the invoices answer
+ * a SIGNED-IN SESSION only (`supabaseAuth`, the credential a first-party web
+ * app holds): those routes refuse an API key and an app's OAuth token with
+ * `403 forbidden` (`ForbiddenError`). Their methods are marked so below.
  */
 /** A sum of money in its currency's major unit (`12` = 12.00), with its ISO-4217 code (`"USD"`). */
 interface BillingMoney {
@@ -23,11 +25,15 @@ interface BillingPriceCredits {
 }
 /** A monthly price, and what it grants. */
 interface BillingMonthlyPrice extends BillingMoney {
+    /** 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. */
+    priceId: string;
     /** `null` when the price does not state it. */
     credits: BillingPriceCredits | null;
 }
 /** A yearly price, what it comes to per month, and what it grants. */
 interface BillingYearlyPrice extends BillingMoney {
+    /** 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. */
+    priceId: string;
     /** The yearly amount spread over the months it pays for; `null` when that cannot be said. */
     perMonth: number | null;
     /** What the price grants — the plan's credits every month, as a monthly price; `null` when the price does not state it. */
@@ -54,10 +60,13 @@ interface BillingPlan {
 }
 /** A credit pack: this many credits for this price. */
 interface BillingTopUp {
+    /** The pack's own id (`"topup-25"`), not a Stripe id. */
     id: string;
     credits: number;
     /** `null` when the pack's price cannot be stated right now: show it as unavailable. */
     price: BillingMoney | null;
+    /** 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}. */
+    priceId: string | null;
 }
 /** The answer of `GET /v1/billing/plans`. */
 interface BillingPlansResult {
@@ -203,6 +212,203 @@ declare class BillingResource {
      * when the provider could not answer — not a zero balance. Every edition.
      */
     account(): Promise<BillingAccountSummary | null>;
+    /**
+     * `GET /v1/billing/transactions` → the account's credit purchases, newest
+     * first: subscription payments and credit packs, each with its Stripe
+     * receipt link when one was captured. **Signed-in session only.**
+     */
+    purchases(): Promise<BillingPurchase[]>;
+    /**
+     * `GET /v1/billing/invoices` → every payment as a document, newest first:
+     * a Stripe invoice (with its PDF) for each subscription payment, a hosted
+     * receipt for each credit pack or load. **Signed-in session only.**
+     */
+    invoices(): Promise<BillingDocument[]>;
+    /**
+     * `GET /v1/billing/payment-method` → the card and the billing details on
+     * file with Stripe; both `null` for an account that has not bought yet
+     * (never an error). **Signed-in session only.**
+     */
+    paymentMethod(): Promise<BillingPaymentMethod>;
+    /**
+     * `GET /v1/billing/auto-recharge` → the automatic top-up setting: when the
+     * balance falls under `thresholdCredits`, `amountUsd` is loaded from the
+     * saved card. **Signed-in session only.**
+     */
+    autoRecharge(): Promise<BillingAutoRecharge>;
+    /**
+     * `PUT /v1/billing/auto-recharge` → changes the automatic top-up. Enabling
+     * needs both `thresholdCredits` (100–100,000) and `amountUsd` (a whole
+     * amount in the load range); the server answers `400` otherwise. A change
+     * clears the failure count. **Signed-in session only.**
+     */
+    setAutoRecharge(input: BillingAutoRechargeInput): Promise<BillingAutoRechargeSaved>;
+    /**
+     * `POST /v1/billing/create-checkout-session` → a Stripe Checkout page for a
+     * plan or a credit pack (`priceId` from {@link BillingPlansResult}): send
+     * the person to `url`. Pass `returnPath` (a path on your own origin, such
+     * as `"/billing"`) to have Stripe bring them back to your app with
+     * `checkout=success` or `checkout=cancelled` in the query; without it the
+     * Nodaro app's own pages are used. `ForbiddenError` with the code
+     * `self_serve_disabled` on a deployment that does not sell to its users.
+     * **Signed-in session only.**
+     */
+    checkout(input: BillingCheckoutInput): Promise<BillingCheckoutSession>;
+    /**
+     * `POST /v1/billing/create-load-session` → a Stripe Checkout page that loads
+     * a whole amount (`amountUsd`, within {@link BillingPlansResult.topUpRange})
+     * as credits at the packs' rate; `credits` is what it will grant. The card
+     * is saved for auto top-up. `returnPath` as in {@link checkout}.
+     * **Signed-in session only.**
+     */
+    loadCredits(input: BillingLoadInput): Promise<BillingLoadSession>;
+    /**
+     * `POST /v1/billing/manage-subscription` → a Stripe Customer Portal page
+     * (the card, the billing address, the invoices, cancelling): send the person
+     * to `url`; `returnPath` is where the portal's Back goes (default the app's
+     * `/billing`). `NotFoundError` before a first purchase — Stripe does not
+     * know the account yet. **Signed-in session only.**
+     */
+    portal(input?: BillingPortalInput): Promise<BillingPortalSession>;
+    /**
+     * `POST /v1/billing/change-plan` → moves the active subscription to another
+     * plan's price (`newPriceId`, a subscription price from the plans list),
+     * prorated by Stripe; the new tier applies at once. `NotFoundError` with no
+     * active subscription; `400` on a pack's price or the current one.
+     * **Signed-in session only.**
+     */
+    changePlan(input: BillingChangePlanInput): Promise<BillingChangePlanResult>;
+}
+/** One credit purchase (`billing.purchases()`), as the `transactions` row names it. */
+interface BillingPurchase {
+    id: string;
+    /** The Stripe payment or subscription id. */
+    stripe_transaction_id: string | null;
+    /** `"subscription"` (a plan payment), `"topup"` (a credit pack or a load) or `"refund"` (money given back: `credits_granted` negative). */
+    type: string;
+    /** What was paid, in US dollars (on a refund, the sum given back). */
+    amount_usd: number;
+    /** Negative on a refund. */
+    credits_granted: number;
+    /** The plan paid for, on a subscription payment. */
+    tier: string | null;
+    /** ISO-8601. */
+    created_at: string;
+    /** Stripe's hosted receipt; `null` when none was captured. */
+    receipt_url: string | null;
+}
+/** A payment document: a Stripe invoice (a subscription payment) or a receipt (a credit purchase). */
+interface BillingDocument {
+    id: string;
+    kind: "invoice" | "receipt";
+    /** The invoice number Stripe printed; `null` on a receipt. */
+    number: string | null;
+    /** ISO-8601. */
+    at: string;
+    amount: BillingMoney;
+    /** The credits the payment granted; `null` on an invoice (the plan's credits come with the period). Negative on a refund. */
+    credits: number | null;
+    /** `"paid"`, `"open"`, `"void"`, `"uncollectible"`, or `"refunded"` (a receipt for money given back: `amount` and `credits` negative). */
+    status: string;
+    description: string | null;
+    /** The PDF, on an invoice; `null` on a receipt. */
+    pdfUrl: string | null;
+    /** The hosted page: Stripe's invoice page, or the receipt. */
+    url: string | null;
+}
+/** The card on file, as Stripe shows it. */
+interface BillingCard {
+    /** `"visa"`, `"mastercard"`, … */
+    brand: string;
+    last4: string;
+    expMonth: number;
+    expYear: number;
+}
+/** The name, email and country on file. */
+interface BillingDetails {
+    name: string | null;
+    email: string | null;
+    /** ISO-3166 alpha-2. */
+    country: string | null;
+}
+/** The answer of `billing.paymentMethod()`: both `null` before a first purchase. */
+interface BillingPaymentMethod {
+    card: BillingCard | null;
+    billingDetails: BillingDetails | null;
+}
+/** The automatic top-up setting (`billing.autoRecharge()`). */
+interface BillingAutoRecharge {
+    enabled: boolean;
+    /** Load when the balance falls under this many credits; `null` when never set. */
+    thresholdCredits: number | null;
+    /** The whole dollar amount loaded each time; `null` when never set. */
+    amountUsd: number | null;
+    /** Failed attempts in a row; the server stops trying after a few, until the setting is saved again. */
+    failureCount: number;
+    /** ISO-8601; `null` before the first attempt. */
+    lastAttemptAt: string | null;
+    /** Whether a card is saved to charge; without one, enabling cannot work. */
+    hasSavedCard: boolean;
+}
+/** What `billing.setAutoRecharge()` sends; `thresholdCredits` and `amountUsd` are both required to enable. */
+interface BillingAutoRechargeInput {
+    enabled: boolean;
+    thresholdCredits?: number;
+    amountUsd?: number;
+}
+/** 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. */
+interface BillingAutoRechargeSaved {
+    enabled: boolean;
+    thresholdCredits: number | null;
+    amountUsd: number | null;
+}
+/** What `billing.checkout()` sends. */
+interface BillingCheckoutInput {
+    /** A plan's monthly or yearly price id, or a credit pack's (`BillingTopUp.id`). */
+    priceId: string;
+    /** Inferred from the price when omitted. */
+    mode?: "subscription" | "payment";
+    /** A path on the calling origin Stripe brings the person back to (`"/billing"`, a query allowed): one leading `/`, no host, no `#`. Wins over `embedded`. */
+    returnPath?: string;
+    /** Set by an embedded first-party surface: return to the app's public checkout-complete page. */
+    embedded?: boolean;
+}
+/** A Stripe Checkout page to send the person to. */
+interface BillingCheckoutSession {
+    url: string | null;
+}
+/** What `billing.loadCredits()` sends. */
+interface BillingLoadInput {
+    /** A whole dollar amount within `topUpRange`. */
+    amountUsd: number;
+    /** As in {@link BillingCheckoutInput.returnPath}; wins over `embedded`. */
+    returnPath?: string;
+    embedded?: boolean;
+}
+/** A Stripe Checkout page for a load, and the credits it grants. */
+interface BillingLoadSession {
+    url: string | null;
+    credits: number;
+}
+/** What `billing.portal()` sends. */
+interface BillingPortalInput {
+    /** Where the portal's Back goes: a path on the calling origin; default the app's `/billing`. */
+    returnPath?: string;
+}
+/** A Stripe Customer Portal page to send the person to. */
+interface BillingPortalSession {
+    url: string;
+}
+/** What `billing.changePlan()` sends. */
+interface BillingChangePlanInput {
+    /** A subscription price id from the plans list. */
+    newPriceId: string;
+}
+/** What `billing.changePlan()` answers. */
+interface BillingChangePlanResult {
+    subscriptionId: string;
+    /** The plan now in force: `"basic"`, `"standard"`, … */
+    tier: string;
 }
 
-export { type BillingAccountSummary, type BillingMoney, type BillingMonthlyPrice, type BillingPlan, type BillingPlanPrices, type BillingPlansResult, type BillingPriceCredits, BillingResource, type BillingSubscription, type BillingSubscriptionResult, type BillingSurface, type BillingTopUp, type BillingUsageCategory, type BillingYearlyPrice };
+export { type BillingAccountSummary, type BillingAutoRecharge, type BillingAutoRechargeInput, type BillingAutoRechargeSaved, type BillingCard, type BillingChangePlanInput, type BillingChangePlanResult, type BillingCheckoutInput, type BillingCheckoutSession, type BillingDetails, type BillingDocument, type BillingLoadInput, type BillingLoadSession, type BillingMoney, type BillingMonthlyPrice, type BillingPaymentMethod, type BillingPlan, type BillingPlanPrices, type BillingPlansResult, type BillingPortalInput, type BillingPortalSession, type BillingPriceCredits, type BillingPurchase, BillingResource, type BillingSubscription, type BillingSubscriptionResult, type BillingSurface, type BillingTopUp, type BillingUsageCategory, type BillingYearlyPrice };

package/dist/entries/billing.d.ts

@@ -8,8 +8,10 @@ import '@nodaro/shared/organizations';
  * (`backend/src/ee/routes/billing.ts`, `backend/src/routes/billing-surface.ts`),
  * the source of truth: keep these in sync if they change.
  *
- * Buying, changing the plan and the payment settings stay in the Nodaro app:
- * those routes refuse API and app tokens, so they have no method here.
+ * Buying, the plan, the payment settings, the receipts and the invoices answer
+ * a SIGNED-IN SESSION only (`supabaseAuth`, the credential a first-party web
+ * app holds): those routes refuse an API key and an app's OAuth token with
+ * `403 forbidden` (`ForbiddenError`). Their methods are marked so below.
  */
 /** A sum of money in its currency's major unit (`12` = 12.00), with its ISO-4217 code (`"USD"`). */
 interface BillingMoney {
@@ -23,11 +25,15 @@ interface BillingPriceCredits {
 }
 /** A monthly price, and what it grants. */
 interface BillingMonthlyPrice extends BillingMoney {
+    /** 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. */
+    priceId: string;
     /** `null` when the price does not state it. */
     credits: BillingPriceCredits | null;
 }
 /** A yearly price, what it comes to per month, and what it grants. */
 interface BillingYearlyPrice extends BillingMoney {
+    /** 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. */
+    priceId: string;
     /** The yearly amount spread over the months it pays for; `null` when that cannot be said. */
     perMonth: number | null;
     /** What the price grants — the plan's credits every month, as a monthly price; `null` when the price does not state it. */
@@ -54,10 +60,13 @@ interface BillingPlan {
 }
 /** A credit pack: this many credits for this price. */
 interface BillingTopUp {
+    /** The pack's own id (`"topup-25"`), not a Stripe id. */
     id: string;
     credits: number;
     /** `null` when the pack's price cannot be stated right now: show it as unavailable. */
     price: BillingMoney | null;
+    /** 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}. */
+    priceId: string | null;
 }
 /** The answer of `GET /v1/billing/plans`. */
 interface BillingPlansResult {
@@ -203,6 +212,203 @@ declare class BillingResource {
      * when the provider could not answer — not a zero balance. Every edition.
      */
     account(): Promise<BillingAccountSummary | null>;
+    /**
+     * `GET /v1/billing/transactions` → the account's credit purchases, newest
+     * first: subscription payments and credit packs, each with its Stripe
+     * receipt link when one was captured. **Signed-in session only.**
+     */
+    purchases(): Promise<BillingPurchase[]>;
+    /**
+     * `GET /v1/billing/invoices` → every payment as a document, newest first:
+     * a Stripe invoice (with its PDF) for each subscription payment, a hosted
+     * receipt for each credit pack or load. **Signed-in session only.**
+     */
+    invoices(): Promise<BillingDocument[]>;
+    /**
+     * `GET /v1/billing/payment-method` → the card and the billing details on
+     * file with Stripe; both `null` for an account that has not bought yet
+     * (never an error). **Signed-in session only.**
+     */
+    paymentMethod(): Promise<BillingPaymentMethod>;
+    /**
+     * `GET /v1/billing/auto-recharge` → the automatic top-up setting: when the
+     * balance falls under `thresholdCredits`, `amountUsd` is loaded from the
+     * saved card. **Signed-in session only.**
+     */
+    autoRecharge(): Promise<BillingAutoRecharge>;
+    /**
+     * `PUT /v1/billing/auto-recharge` → changes the automatic top-up. Enabling
+     * needs both `thresholdCredits` (100–100,000) and `amountUsd` (a whole
+     * amount in the load range); the server answers `400` otherwise. A change
+     * clears the failure count. **Signed-in session only.**
+     */
+    setAutoRecharge(input: BillingAutoRechargeInput): Promise<BillingAutoRechargeSaved>;
+    /**
+     * `POST /v1/billing/create-checkout-session` → a Stripe Checkout page for a
+     * plan or a credit pack (`priceId` from {@link BillingPlansResult}): send
+     * the person to `url`. Pass `returnPath` (a path on your own origin, such
+     * as `"/billing"`) to have Stripe bring them back to your app with
+     * `checkout=success` or `checkout=cancelled` in the query; without it the
+     * Nodaro app's own pages are used. `ForbiddenError` with the code
+     * `self_serve_disabled` on a deployment that does not sell to its users.
+     * **Signed-in session only.**
+     */
+    checkout(input: BillingCheckoutInput): Promise<BillingCheckoutSession>;
+    /**
+     * `POST /v1/billing/create-load-session` → a Stripe Checkout page that loads
+     * a whole amount (`amountUsd`, within {@link BillingPlansResult.topUpRange})
+     * as credits at the packs' rate; `credits` is what it will grant. The card
+     * is saved for auto top-up. `returnPath` as in {@link checkout}.
+     * **Signed-in session only.**
+     */
+    loadCredits(input: BillingLoadInput): Promise<BillingLoadSession>;
+    /**
+     * `POST /v1/billing/manage-subscription` → a Stripe Customer Portal page
+     * (the card, the billing address, the invoices, cancelling): send the person
+     * to `url`; `returnPath` is where the portal's Back goes (default the app's
+     * `/billing`). `NotFoundError` before a first purchase — Stripe does not
+     * know the account yet. **Signed-in session only.**
+     */
+    portal(input?: BillingPortalInput): Promise<BillingPortalSession>;
+    /**
+     * `POST /v1/billing/change-plan` → moves the active subscription to another
+     * plan's price (`newPriceId`, a subscription price from the plans list),
+     * prorated by Stripe; the new tier applies at once. `NotFoundError` with no
+     * active subscription; `400` on a pack's price or the current one.
+     * **Signed-in session only.**
+     */
+    changePlan(input: BillingChangePlanInput): Promise<BillingChangePlanResult>;
+}
+/** One credit purchase (`billing.purchases()`), as the `transactions` row names it. */
+interface BillingPurchase {
+    id: string;
+    /** The Stripe payment or subscription id. */
+    stripe_transaction_id: string | null;
+    /** `"subscription"` (a plan payment), `"topup"` (a credit pack or a load) or `"refund"` (money given back: `credits_granted` negative). */
+    type: string;
+    /** What was paid, in US dollars (on a refund, the sum given back). */
+    amount_usd: number;
+    /** Negative on a refund. */
+    credits_granted: number;
+    /** The plan paid for, on a subscription payment. */
+    tier: string | null;
+    /** ISO-8601. */
+    created_at: string;
+    /** Stripe's hosted receipt; `null` when none was captured. */
+    receipt_url: string | null;
+}
+/** A payment document: a Stripe invoice (a subscription payment) or a receipt (a credit purchase). */
+interface BillingDocument {
+    id: string;
+    kind: "invoice" | "receipt";
+    /** The invoice number Stripe printed; `null` on a receipt. */
+    number: string | null;
+    /** ISO-8601. */
+    at: string;
+    amount: BillingMoney;
+    /** The credits the payment granted; `null` on an invoice (the plan's credits come with the period). Negative on a refund. */
+    credits: number | null;
+    /** `"paid"`, `"open"`, `"void"`, `"uncollectible"`, or `"refunded"` (a receipt for money given back: `amount` and `credits` negative). */
+    status: string;
+    description: string | null;
+    /** The PDF, on an invoice; `null` on a receipt. */
+    pdfUrl: string | null;
+    /** The hosted page: Stripe's invoice page, or the receipt. */
+    url: string | null;
+}
+/** The card on file, as Stripe shows it. */
+interface BillingCard {
+    /** `"visa"`, `"mastercard"`, … */
+    brand: string;
+    last4: string;
+    expMonth: number;
+    expYear: number;
+}
+/** The name, email and country on file. */
+interface BillingDetails {
+    name: string | null;
+    email: string | null;
+    /** ISO-3166 alpha-2. */
+    country: string | null;
+}
+/** The answer of `billing.paymentMethod()`: both `null` before a first purchase. */
+interface BillingPaymentMethod {
+    card: BillingCard | null;
+    billingDetails: BillingDetails | null;
+}
+/** The automatic top-up setting (`billing.autoRecharge()`). */
+interface BillingAutoRecharge {
+    enabled: boolean;
+    /** Load when the balance falls under this many credits; `null` when never set. */
+    thresholdCredits: number | null;
+    /** The whole dollar amount loaded each time; `null` when never set. */
+    amountUsd: number | null;
+    /** Failed attempts in a row; the server stops trying after a few, until the setting is saved again. */
+    failureCount: number;
+    /** ISO-8601; `null` before the first attempt. */
+    lastAttemptAt: string | null;
+    /** Whether a card is saved to charge; without one, enabling cannot work. */
+    hasSavedCard: boolean;
+}
+/** What `billing.setAutoRecharge()` sends; `thresholdCredits` and `amountUsd` are both required to enable. */
+interface BillingAutoRechargeInput {
+    enabled: boolean;
+    thresholdCredits?: number;
+    amountUsd?: number;
+}
+/** 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. */
+interface BillingAutoRechargeSaved {
+    enabled: boolean;
+    thresholdCredits: number | null;
+    amountUsd: number | null;
+}
+/** What `billing.checkout()` sends. */
+interface BillingCheckoutInput {
+    /** A plan's monthly or yearly price id, or a credit pack's (`BillingTopUp.id`). */
+    priceId: string;
+    /** Inferred from the price when omitted. */
+    mode?: "subscription" | "payment";
+    /** A path on the calling origin Stripe brings the person back to (`"/billing"`, a query allowed): one leading `/`, no host, no `#`. Wins over `embedded`. */
+    returnPath?: string;
+    /** Set by an embedded first-party surface: return to the app's public checkout-complete page. */
+    embedded?: boolean;
+}
+/** A Stripe Checkout page to send the person to. */
+interface BillingCheckoutSession {
+    url: string | null;
+}
+/** What `billing.loadCredits()` sends. */
+interface BillingLoadInput {
+    /** A whole dollar amount within `topUpRange`. */
+    amountUsd: number;
+    /** As in {@link BillingCheckoutInput.returnPath}; wins over `embedded`. */
+    returnPath?: string;
+    embedded?: boolean;
+}
+/** A Stripe Checkout page for a load, and the credits it grants. */
+interface BillingLoadSession {
+    url: string | null;
+    credits: number;
+}
+/** What `billing.portal()` sends. */
+interface BillingPortalInput {
+    /** Where the portal's Back goes: a path on the calling origin; default the app's `/billing`. */
+    returnPath?: string;
+}
+/** A Stripe Customer Portal page to send the person to. */
+interface BillingPortalSession {
+    url: string;
+}
+/** What `billing.changePlan()` sends. */
+interface BillingChangePlanInput {
+    /** A subscription price id from the plans list. */
+    newPriceId: string;
+}
+/** What `billing.changePlan()` answers. */
+interface BillingChangePlanResult {
+    subscriptionId: string;
+    /** The plan now in force: `"basic"`, `"standard"`, … */
+    tier: string;
 }
 
-export { type BillingAccountSummary, type BillingMoney, type BillingMonthlyPrice, type BillingPlan, type BillingPlanPrices, type BillingPlansResult, type BillingPriceCredits, BillingResource, type BillingSubscription, type BillingSubscriptionResult, type BillingSurface, type BillingTopUp, type BillingUsageCategory, type BillingYearlyPrice };
+export { type BillingAccountSummary, type BillingAutoRecharge, type BillingAutoRechargeInput, type BillingAutoRechargeSaved, type BillingCard, type BillingChangePlanInput, type BillingChangePlanResult, type BillingCheckoutInput, type BillingCheckoutSession, type BillingDetails, type BillingDocument, type BillingLoadInput, type BillingLoadSession, type BillingMoney, type BillingMonthlyPrice, type BillingPaymentMethod, type BillingPlan, type BillingPlanPrices, type BillingPlansResult, type BillingPortalInput, type BillingPortalSession, type BillingPriceCredits, type BillingPurchase, BillingResource, type BillingSubscription, type BillingSubscriptionResult, type BillingSurface, type BillingTopUp, type BillingUsageCategory, type BillingYearlyPrice };

package/dist/entries/billing.js

@@ -1,4 +1,4 @@
 import '../chunk-M6Y5TOYE.js';
-export { BillingResource } from '../chunk-J4WFSKY6.js';
+export { BillingResource } from '../chunk-ZVKEPVDQ.js';
 //# sourceMappingURL=billing.js.map
 //# sourceMappingURL=billing.js.map

package/dist/entries/client.cjs

@@ -1,7 +1,8 @@
 'use strict';
 
-var chunkPPP6VZ3I_cjs = require('../chunk-PPP6VZ3I.cjs');
+var chunkAY7XKACE_cjs = require('../chunk-AY7XKACE.cjs');
 require('../chunk-JTOEHQQJ.cjs');
+require('../chunk-UIDVH3GP.cjs');
 require('../chunk-W5VHATSR.cjs');
 require('../chunk-R63TTR35.cjs');
 require('../chunk-3B47IHB3.cjs');
@@ -43,14 +44,14 @@ require('../chunk-43FVH6LJ.cjs');
 require('../chunk-YFS2LMG4.cjs');
 require('../chunk-OSMKIRKI.cjs');
 require('../chunk-FRQJNGJS.cjs');
-var chunkNOBQQTAG_cjs = require('../chunk-NOBQQTAG.cjs');
+var chunkFDTE4C5W_cjs = require('../chunk-FDTE4C5W.cjs');
 require('../chunk-FM2KM5TY.cjs');
 require('../chunk-HGCVWOGK.cjs');
-require('../chunk-FIMBPKIH.cjs');
+require('../chunk-4BAHF762.cjs');
 require('../chunk-A3S55XGF.cjs');
 require('../chunk-JOXZ4ZIF.cjs');
 require('../chunk-GA4LZZKQ.cjs');
-require('../chunk-NGKODS3J.cjs');
+require('../chunk-TVPYDC5T.cjs');
 require('../chunk-TY2S25W5.cjs');
 require('../chunk-BPWUWUZ3.cjs');
 require('../chunk-HAKYPZLB.cjs');
@@ -59,23 +60,23 @@ require('../chunk-HAKYPZLB.cjs');
 
 Object.defineProperty(exports, "NodaroClient", {
   enumerable: true,
-  get: function () { return chunkPPP6VZ3I_cjs.NodaroClient; }
+  get: function () { return chunkAY7XKACE_cjs.NodaroClient; }
 });
 Object.defineProperty(exports, "createClient", {
   enumerable: true,
-  get: function () { return chunkPPP6VZ3I_cjs.createClient; }
+  get: function () { return chunkAY7XKACE_cjs.createClient; }
 });
 Object.defineProperty(exports, "CallbackAuth", {
   enumerable: true,
-  get: function () { return chunkNOBQQTAG_cjs.CallbackAuth; }
+  get: function () { return chunkFDTE4C5W_cjs.CallbackAuth; }
 });
 Object.defineProperty(exports, "StaticTokenAuth", {
   enumerable: true,
-  get: function () { return chunkNOBQQTAG_cjs.StaticTokenAuth; }
+  get: function () { return chunkFDTE4C5W_cjs.StaticTokenAuth; }
 });
 Object.defineProperty(exports, "supabaseAuth", {
   enumerable: true,
-  get: function () { return chunkNOBQQTAG_cjs.supabaseAuth; }
+  get: function () { return chunkFDTE4C5W_cjs.supabaseAuth; }
 });
 //# sourceMappingURL=client.cjs.map
 //# sourceMappingURL=client.cjs.map

package/dist/entries/client.d.cts

@@ -25,6 +25,7 @@ import { MediaResource } from './media.cjs';
 import { AudioResource } from './audio.cjs';
 import { CreditsResource } from './credits.cjs';
 import { BillingResource } from './billing.cjs';
+import { UserSettingsResource } from './user-settings.cjs';
 import { UploadsResource } from './uploads.cjs';
 import { LibraryResource } from './library.cjs';
 import { GalleryResource } from './gallery.cjs';
@@ -105,6 +106,8 @@ declare class NodaroClient extends NodaroClientCore {
     readonly media: MediaResource;
     readonly audio: AudioResource;
     readonly credits: CreditsResource;
+    /** The signed-in person's own settings (the interface language, the monthly statement opt-in, …). */
+    readonly userSettings: UserSettingsResource;
     /** Plans and prices, the subscription, and how this deployment bills. */
     readonly billing: BillingResource;
     readonly uploads: UploadsResource;