@nodaro/sdk 2.28.0 → 2.31.0

package/dist/entries/audio.d.cts

@@ -0,0 +1,200 @@
+import { AudioFxPreset } from '@nodaro/shared/media';
+import { TranscribeProvider } from '@nodaro/shared/models';
+export { TranscribeProvider } from '@nodaro/shared/models';
+import { Transcript } from '@nodaro/shared/edl';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * One word of a {@link AudioResource.transcribe} result — caption-shaped, in
+ * MILLISECONDS, and structurally the `captions[]` entry `media.addCaptions()`
+ * takes, so a word list can be passed straight through. `speaker` is present
+ * only on a diarized `elevenlabs-stt` run.
+ */
+interface TranscribeWord {
+    text: string;
+    startMs: number;
+    endMs: number;
+    timestampMs?: number | null;
+    confidence?: number | null;
+    speaker?: string;
+}
+/**
+ * A completed transcribe job's `output_data` (read it off `jobs.get(jobId)`).
+ *
+ * Mind the units: `words` and `json.words` are in MILLISECONDS, while the
+ * top-level `segments` are in SECONDS (the raw per-utterance ranges) — present
+ * only on the legacy lanes; `elevenlabs-stt` returns none, so read `words`.
+ */
+interface TranscribeJobOutput {
+    /** The full transcript as one string. */
+    text: string;
+    /** Detected (or requested) language code. */
+    language?: string;
+    /** Per-word timings, ms — present on the word-level lanes. */
+    words?: TranscribeWord[];
+    /** The normalized {@link Transcript} (ms), the shape `edit.*` consumes. */
+    json?: Transcript;
+    /** Per-utterance ranges in SECONDS — not ms, unlike everything above. */
+    segments?: Array<{
+        start: number;
+        end: number;
+        text: string;
+    }>;
+}
+/**
+ * Audio primitives — the building blocks Voice Changer Pro composes internally
+ * (separation, isolation, effect, mix, level) plus speech-to-text, exposed
+ * standalone so a consumer can run any single step or assemble its own
+ * pipeline. Each returns a job id to poll (`jobs.get(jobId)`).
+ */
+declare class AudioResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * Separate an audio track into stems (`POST /v1/audio-separation`, Demucs).
+     * `mode` `"vocal_instrumental"` (default) splits voice from music/SFX;
+     * `"stems"` returns the full drums/bass/other/… breakdown. `quality`
+     * `auto` (default) / `fast` / `best`.
+     */
+    separate(input: {
+        audioUrl: string;
+        mode?: "vocal_instrumental" | "stems";
+        quality?: "auto" | "fast" | "best";
+    }): Promise<{
+        jobId: string;
+    }>;
+    /** Isolate the primary voice and strip background noise (`POST /v1/audio-isolation`, ElevenLabs). */
+    isolate(input: {
+        audioUrl: string;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Apply a reverb / echo / telephone / megaphone effect to an audio track
+     * (`POST /v1/audio-fx`) — the same presets VCP's `voiceFx` uses, standalone.
+     * `mix` (0–100) is the reverb wet/dry; `delayMs` + `decay` drive `echo`/`custom`;
+     * `eqLow`/`eqHigh` (dB) shape telephone/megaphone.
+     */
+    applyFx(input: {
+        audioUrl: string;
+        preset?: AudioFxPreset;
+        mix?: number;
+        delayMs?: number;
+        decay?: number;
+        eqLow?: number;
+        eqHigh?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Layer multiple audio tracks into one (`POST /v1/mix-audio`). `audioUrls`
+     * (2–20) are summed; optional `trackVolumes` (0–200% each, positionally) set
+     * per-track level. `duck` puts a music bed under speech: every track EXCEPT
+     * `duck.under` (the 0-based index of the voice track) dips while that track
+     * is loud and rises back in its pauses (sidechain compression). `amount`
+     * (0–100, default 75) is how hard; `thresholdDb` (-60–0, default -30),
+     * `ratio` (1–20, overrides `amount`), `attackMs` (1–2000, default 20) and
+     * `releaseMs` (10–9000, default 500) are optional fine controls. A ducked mix
+     * sums its tracks rather than averaging them, so the voice keeps its level;
+     * the price is the same with or without a duck. `endAt` (`"longest"`, the
+     * default, or `"voice"`) says where the mix ends: `"voice"` ends it when the
+     * voice (the `duck.under` track) ends (needs `duck`). A video URL is a track
+     * too: its audio is mixed, and a video with no sound is a silent track.
+     */
+    mix(input: {
+        audioUrls: string[];
+        trackVolumes?: number[];
+        duck?: {
+            under: number;
+            amount?: number;
+            thresholdDb?: number;
+            ratio?: number;
+            attackMs?: number;
+            releaseMs?: number;
+        };
+        endAt?: "longest" | "voice";
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Adjust an audio (or a video's audio) level (`POST /v1/adjust-volume`):
+     * `volume` % (default 100), `normalize` to loudnorm, and `fadeIn`/`fadeOut`
+     * seconds. Provide `audioUrl` or `videoUrl`.
+     */
+    adjustVolume(input: {
+        audioUrl?: string;
+        videoUrl?: string;
+        volume?: number;
+        normalize?: boolean;
+        fadeIn?: number;
+        fadeOut?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Shift pitch and/or change tempo with Rubber Band (`POST /v1/pitch-tempo`):
+     * `semitones` −12…+12 (default 0), `tempo` 0.5…2 with the pitch kept
+     * (default 1; fixed at 1 for a video), `preserveFormants` (default true).
+     * Provide exactly one of `audioUrl` or `videoUrl` — a video keeps its picture.
+     * Input up to 30 minutes, priced per started minute.
+     */
+    pitchTempo(input: {
+        audioUrl?: string;
+        videoUrl?: string;
+        semitones?: number;
+        tempo?: number;
+        preserveFormants?: boolean;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Concatenate audio segments end-to-end (`POST /v1/combine-audio`). Each
+     * segment is a `url` with an optional `[startTime, endTime]` sub-range.
+     */
+    combine(input: {
+        segments: Array<{
+            url: string;
+            startTime?: number;
+            endTime?: number;
+        }>;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Transcribe an audio (or video) track to text (`POST /v1/transcribe`).
+     *
+     * Three engines are accepted. `elevenlabs-stt` (Scribe) is always word-level,
+     * flag or not, and is the only lane that honours `diarize` (who spoke) and
+     * `tagAudioEvents` (laughter, applause, …); `incredibly-fast-whisper` returns
+     * word timings when you ask for them. `whisper` returns NO word timings at
+     * all — named explicitly or reached by OMITTING `provider`, which still falls
+     * back to it — so asking it for them (`wordTimestamps: true`) is rejected with
+     * a `400 validation_error` at ingress, before any credit is spent. A kinetic
+     * caption render therefore has to name one of the other two.
+     *
+     * Poll `jobs.get(jobId)`; the finished job's `output_data` is a
+     * {@link TranscribeJobOutput}: `text` (the whole transcript), `words`
+     * (caption-shaped, in MILLISECONDS), `json` (the normalized
+     * {@link Transcript}, also ms) — and a top-level `segments` array that is in
+     * SECONDS, not ms.
+     *
+     * `words` is the caption source for a kinetic burn-in: hand it to
+     * `media.addCaptions()` as `captions` with `autoTranscribe: false` and the
+     * render uses those exact words (correct the `text` of an entry in between
+     * and the fix is what burns in).
+     */
+    transcribe(input: {
+        audioUrl: string;
+        provider?: TranscribeProvider;
+        language?: string;
+        diarize?: boolean;
+        tagAudioEvents?: boolean;
+        wordTimestamps?: boolean;
+    }): Promise<{
+        jobId: string;
+    }>;
+}
+
+export { AudioResource, type TranscribeJobOutput, type TranscribeWord };

package/dist/entries/audio.d.ts

@@ -0,0 +1,200 @@
+import { AudioFxPreset } from '@nodaro/shared/media';
+import { TranscribeProvider } from '@nodaro/shared/models';
+export { TranscribeProvider } from '@nodaro/shared/models';
+import { Transcript } from '@nodaro/shared/edl';
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.js';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * One word of a {@link AudioResource.transcribe} result — caption-shaped, in
+ * MILLISECONDS, and structurally the `captions[]` entry `media.addCaptions()`
+ * takes, so a word list can be passed straight through. `speaker` is present
+ * only on a diarized `elevenlabs-stt` run.
+ */
+interface TranscribeWord {
+    text: string;
+    startMs: number;
+    endMs: number;
+    timestampMs?: number | null;
+    confidence?: number | null;
+    speaker?: string;
+}
+/**
+ * A completed transcribe job's `output_data` (read it off `jobs.get(jobId)`).
+ *
+ * Mind the units: `words` and `json.words` are in MILLISECONDS, while the
+ * top-level `segments` are in SECONDS (the raw per-utterance ranges) — present
+ * only on the legacy lanes; `elevenlabs-stt` returns none, so read `words`.
+ */
+interface TranscribeJobOutput {
+    /** The full transcript as one string. */
+    text: string;
+    /** Detected (or requested) language code. */
+    language?: string;
+    /** Per-word timings, ms — present on the word-level lanes. */
+    words?: TranscribeWord[];
+    /** The normalized {@link Transcript} (ms), the shape `edit.*` consumes. */
+    json?: Transcript;
+    /** Per-utterance ranges in SECONDS — not ms, unlike everything above. */
+    segments?: Array<{
+        start: number;
+        end: number;
+        text: string;
+    }>;
+}
+/**
+ * Audio primitives — the building blocks Voice Changer Pro composes internally
+ * (separation, isolation, effect, mix, level) plus speech-to-text, exposed
+ * standalone so a consumer can run any single step or assemble its own
+ * pipeline. Each returns a job id to poll (`jobs.get(jobId)`).
+ */
+declare class AudioResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * Separate an audio track into stems (`POST /v1/audio-separation`, Demucs).
+     * `mode` `"vocal_instrumental"` (default) splits voice from music/SFX;
+     * `"stems"` returns the full drums/bass/other/… breakdown. `quality`
+     * `auto` (default) / `fast` / `best`.
+     */
+    separate(input: {
+        audioUrl: string;
+        mode?: "vocal_instrumental" | "stems";
+        quality?: "auto" | "fast" | "best";
+    }): Promise<{
+        jobId: string;
+    }>;
+    /** Isolate the primary voice and strip background noise (`POST /v1/audio-isolation`, ElevenLabs). */
+    isolate(input: {
+        audioUrl: string;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Apply a reverb / echo / telephone / megaphone effect to an audio track
+     * (`POST /v1/audio-fx`) — the same presets VCP's `voiceFx` uses, standalone.
+     * `mix` (0–100) is the reverb wet/dry; `delayMs` + `decay` drive `echo`/`custom`;
+     * `eqLow`/`eqHigh` (dB) shape telephone/megaphone.
+     */
+    applyFx(input: {
+        audioUrl: string;
+        preset?: AudioFxPreset;
+        mix?: number;
+        delayMs?: number;
+        decay?: number;
+        eqLow?: number;
+        eqHigh?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Layer multiple audio tracks into one (`POST /v1/mix-audio`). `audioUrls`
+     * (2–20) are summed; optional `trackVolumes` (0–200% each, positionally) set
+     * per-track level. `duck` puts a music bed under speech: every track EXCEPT
+     * `duck.under` (the 0-based index of the voice track) dips while that track
+     * is loud and rises back in its pauses (sidechain compression). `amount`
+     * (0–100, default 75) is how hard; `thresholdDb` (-60–0, default -30),
+     * `ratio` (1–20, overrides `amount`), `attackMs` (1–2000, default 20) and
+     * `releaseMs` (10–9000, default 500) are optional fine controls. A ducked mix
+     * sums its tracks rather than averaging them, so the voice keeps its level;
+     * the price is the same with or without a duck. `endAt` (`"longest"`, the
+     * default, or `"voice"`) says where the mix ends: `"voice"` ends it when the
+     * voice (the `duck.under` track) ends (needs `duck`). A video URL is a track
+     * too: its audio is mixed, and a video with no sound is a silent track.
+     */
+    mix(input: {
+        audioUrls: string[];
+        trackVolumes?: number[];
+        duck?: {
+            under: number;
+            amount?: number;
+            thresholdDb?: number;
+            ratio?: number;
+            attackMs?: number;
+            releaseMs?: number;
+        };
+        endAt?: "longest" | "voice";
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Adjust an audio (or a video's audio) level (`POST /v1/adjust-volume`):
+     * `volume` % (default 100), `normalize` to loudnorm, and `fadeIn`/`fadeOut`
+     * seconds. Provide `audioUrl` or `videoUrl`.
+     */
+    adjustVolume(input: {
+        audioUrl?: string;
+        videoUrl?: string;
+        volume?: number;
+        normalize?: boolean;
+        fadeIn?: number;
+        fadeOut?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Shift pitch and/or change tempo with Rubber Band (`POST /v1/pitch-tempo`):
+     * `semitones` −12…+12 (default 0), `tempo` 0.5…2 with the pitch kept
+     * (default 1; fixed at 1 for a video), `preserveFormants` (default true).
+     * Provide exactly one of `audioUrl` or `videoUrl` — a video keeps its picture.
+     * Input up to 30 minutes, priced per started minute.
+     */
+    pitchTempo(input: {
+        audioUrl?: string;
+        videoUrl?: string;
+        semitones?: number;
+        tempo?: number;
+        preserveFormants?: boolean;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Concatenate audio segments end-to-end (`POST /v1/combine-audio`). Each
+     * segment is a `url` with an optional `[startTime, endTime]` sub-range.
+     */
+    combine(input: {
+        segments: Array<{
+            url: string;
+            startTime?: number;
+            endTime?: number;
+        }>;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Transcribe an audio (or video) track to text (`POST /v1/transcribe`).
+     *
+     * Three engines are accepted. `elevenlabs-stt` (Scribe) is always word-level,
+     * flag or not, and is the only lane that honours `diarize` (who spoke) and
+     * `tagAudioEvents` (laughter, applause, …); `incredibly-fast-whisper` returns
+     * word timings when you ask for them. `whisper` returns NO word timings at
+     * all — named explicitly or reached by OMITTING `provider`, which still falls
+     * back to it — so asking it for them (`wordTimestamps: true`) is rejected with
+     * a `400 validation_error` at ingress, before any credit is spent. A kinetic
+     * caption render therefore has to name one of the other two.
+     *
+     * Poll `jobs.get(jobId)`; the finished job's `output_data` is a
+     * {@link TranscribeJobOutput}: `text` (the whole transcript), `words`
+     * (caption-shaped, in MILLISECONDS), `json` (the normalized
+     * {@link Transcript}, also ms) — and a top-level `segments` array that is in
+     * SECONDS, not ms.
+     *
+     * `words` is the caption source for a kinetic burn-in: hand it to
+     * `media.addCaptions()` as `captions` with `autoTranscribe: false` and the
+     * render uses those exact words (correct the `text` of an entry in between
+     * and the fix is what burns in).
+     */
+    transcribe(input: {
+        audioUrl: string;
+        provider?: TranscribeProvider;
+        language?: string;
+        diarize?: boolean;
+        tagAudioEvents?: boolean;
+        wordTimestamps?: boolean;
+    }): Promise<{
+        jobId: string;
+    }>;
+}
+
+export { AudioResource, type TranscribeJobOutput, type TranscribeWord };

package/dist/entries/audio.js

@@ -0,0 +1,4 @@
+import '../chunk-HRXXGGSJ.js';
+export { AudioResource } from '../chunk-3QFTP5P5.js';
+//# sourceMappingURL=audio.js.map
+//# sourceMappingURL=audio.js.map

package/dist/entries/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"audio.js"}

package/dist/entries/billing.cjs

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

package/dist/entries/billing.cjs.map

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

package/dist/entries/billing.d.cts

@@ -0,0 +1,208 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * Plans and prices, the subscription, and the billing surface — the shapes of
+ * the `/v1/billing/*` routes an app may call. Mirrors the backend routes
+ * (`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.
+ */
+/** A sum of money in its currency's major unit (`12` = 12.00), with its ISO-4217 code (`"USD"`). */
+interface BillingMoney {
+    amount: number;
+    currency: string;
+}
+/** The credits a price grants, and how often. */
+interface BillingPriceCredits {
+    amount: number;
+    per: "month" | "year";
+}
+/** A monthly price, and what it grants. */
+interface BillingMonthlyPrice extends BillingMoney {
+    /** `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 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. */
+    credits: BillingPriceCredits | null;
+}
+interface BillingPlanPrices {
+    /** `null` = Stripe cannot sell this price right now: show it as unavailable, never as free. */
+    monthly: BillingMonthlyPrice | null;
+    yearly: BillingYearlyPrice | null;
+}
+/** One plan on sale. */
+interface BillingPlan {
+    /** `"free"`, `"basic"`, `"standard"`, … — the stable id. */
+    id: string;
+    name: string;
+    /** `null` for the free plan: there is nothing to pay. */
+    prices: BillingPlanPrices | null;
+    /** The free plan's one-time grant at sign-up; `null` on a paid plan, whose credits come with each price. */
+    signupCredits: number | null;
+    /** How many nodes of one workflow run at once. */
+    parallelism: number;
+    /** Storage for your media, in bytes. */
+    storageBytes: number;
+}
+/** A credit pack: this many credits for this price. */
+interface BillingTopUp {
+    id: string;
+    credits: number;
+    /** `null` when the pack's price cannot be stated right now: show it as unavailable. */
+    price: BillingMoney | null;
+}
+/** The answer of `GET /v1/billing/plans`. */
+interface BillingPlansResult {
+    /** The free plan first, then each paid plan from the smallest. */
+    data: BillingPlan[];
+    /** The credit packs, from the smallest. */
+    topUps: BillingTopUp[];
+    /** Any whole amount in this range can be loaded as credits, at the same rate as the packs. */
+    topUpRange: {
+        min: number;
+        max: number;
+        currency: string;
+    };
+}
+/** The account's latest subscription record. */
+interface BillingSubscription {
+    id: string;
+    stripe_subscription_id: string | null;
+    /** The plan id: `"basic"`, `"standard"`, … */
+    tier: string;
+    /** `"active"`, `"trialing"`, `"past_due"`, `"paused"`, `"canceled"`, `"incomplete"` or `"expired"`. */
+    status: string;
+    stripe_price_id: string | null;
+    /** ISO-8601. */
+    current_period_start: string | null;
+    /** ISO-8601: when the current period ends (and renews, unless cancelled). */
+    current_period_end: string | null;
+    /** True when the subscription ends at `current_period_end` instead of renewing. */
+    cancel_at_period_end: boolean;
+    /** ISO-8601: when a scheduled cancellation takes effect. */
+    cancel_at: string | null;
+    /** ISO-8601: when it was cancelled. */
+    canceled_at: string | null;
+}
+/** The answer of `GET /v1/billing/subscription`. */
+interface BillingSubscriptionResult {
+    /** `null` when the account never subscribed. */
+    data: BillingSubscription | null;
+    /**
+     * The tier the account's entitlements follow: usually a plan id from
+     * `plans()` (`"free"` included); `"payg"` — no subscription, but credits
+     * bought (every model, no watermark); or a tier that is not on sale, such
+     * as `"enterprise"`.
+     */
+    effectiveTier: string;
+}
+/** How this deployment bills, the same for every caller (`GET /v1/billing/surface`). */
+interface BillingSurface {
+    /** The billing-surface contract version (an integer). */
+    contract: number;
+    /** The registered billing provider; `"none"` = this deployment meters nothing. */
+    providerId: string;
+    /** The unit costs display in by default (`"credits"`, `"usd"`, or a deployment's own label). */
+    displayUnit: string;
+    canReport: boolean;
+    canQuote: boolean;
+    canAccount: boolean;
+    /** Whether a cost view belongs on this deployment. */
+    mountCostTab: boolean;
+    /** One billing account pays for every user here. */
+    deploymentPayer: boolean;
+}
+/** One row of {@link BillingAccountSummary.byCategory}. */
+interface BillingUsageCategory {
+    category: string;
+    count: number;
+    /** Spend in the display unit; `null` = unavailable, never 0. */
+    amount: number | null;
+    spent: BillingMoney | null;
+}
+/**
+ * The caller's account as the deployment's billing provider sees it
+ * (`GET /v1/billing/account`). Money and amounts are `null` when the provider
+ * could not say: show that distinctly, never as 0. A field the provider leaves
+ * out is a concept it does not have.
+ */
+interface BillingAccountSummary {
+    /** A plain string; `"unknown"` is a real answer. */
+    plan: string;
+    balance: number | null;
+    dailyAllowance: number | null;
+    unit: string;
+    /** `"external_wallet"` when the balance comes from a wallet outside Nodaro. */
+    balanceSource?: "external_wallet";
+    /** ISO-8601 start of the current usage period. */
+    periodStart?: string | null;
+    /** Generations this period. */
+    generations?: number | null;
+    /** Money spent this period. */
+    spent?: BillingMoney | null;
+    /** Pay-as-you-go state. */
+    payg?: {
+        enabled: boolean;
+        reserve: number | null;
+        rate: {
+            creditsPerUnit: number;
+            currency: string;
+        } | null;
+        monthlyCap: BillingMoney | null;
+    } | null;
+    /** The daily cap and when it resets; prefer it over `dailyAllowance` when present. `limit: 0` means blocked. */
+    daily?: {
+        limit: number;
+        used: number;
+        remaining: number;
+        resetsAt: string;
+    } | null;
+    /** Money value of the pay-as-you-go reserve. */
+    reserveValue?: BillingMoney | null;
+    byCategory?: BillingUsageCategory[] | null;
+    /** The total the balance is drawn from, where the provider grants each user an allocation. */
+    allocated?: number | null;
+}
+declare class BillingResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * `GET /v1/billing/plans` → the plans and credit packs on sale, with their
+     * prices. Public: works with no credential, the same for every caller.
+     * Nodaro Cloud only — a self-hosted instance answers 404. Throws on `403
+     * self_serve_disabled` (this deployment does not sell to its users) and on
+     * `503` (`stripe_not_configured`, or prices briefly unavailable).
+     */
+    plans(): Promise<BillingPlansResult>;
+    /**
+     * `GET /v1/billing/subscription` → the account's latest subscription
+     * (`null` when it never subscribed) and the tier its entitlements follow.
+     * Match `effectiveTier` to a {@link BillingPlan} `id` to mark the current
+     * plan (no match: pay-as-you-go, or a tier not on sale). Needs a signed-in
+     * session, a personal API token without a workflow limit, or an app's OAuth
+     * token. Nodaro Cloud only — a self-hosted instance answers 404.
+     */
+    subscription(): Promise<BillingSubscriptionResult>;
+    /**
+     * `GET /v1/billing/surface` → how this deployment bills: whether it meters
+     * at all (`providerId !== "none"`) and in which unit costs display. Public,
+     * every edition.
+     */
+    surface(): Promise<BillingSurface>;
+    /**
+     * `GET /v1/billing/account` → the caller's plan and balance as the
+     * deployment's billing provider reports them, in its display unit. `null`
+     * when the provider could not answer — not a zero balance. Every edition.
+     */
+    account(): Promise<BillingAccountSummary | null>;
+}
+
+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 };