@lizard-build/sdk 0.1.51 → 0.1.52

package/dist/index.d.mts

@@ -1520,6 +1520,7 @@ declare class RegionsAPI {
     list(): Promise<Region[]>;
 }
 
+/** Prepaid credits balance: old credits accounts (`plan: 'payg'`) until 1 November 2026, and enterprise usage. */
 interface Balance {
     plan: string;
     status: 'active' | 'grace' | 'frozen' | string;
@@ -1558,61 +1559,180 @@ interface ListTransactionsOpts {
     includeUsage?: boolean;
 }
 /**
- * Account balance and usage.
+ * `none`: no plan yet (creating anything answers 402). `pro`: the Pro subscription, see
+ * {@link Subscription.status}. `payg`: old prepaid credits, until 1 November 2026.
+ * `enterprise`: pay as you go, invoiced monthly.
+ */
+type Plan = 'none' | 'pro' | 'payg' | 'enterprise';
+/** Pro subscription status; `none` when there is no subscription. */
+type SubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'none';
+interface Subscription {
+    plan: Plan | (string & {});
+    status: SubscriptionStatus | (string & {});
+    /** False when read for a workspace the caller does not own; card and invoice fields are then null. */
+    isOwner: boolean;
+    /** 1900: $19/month. */
+    priceCents: number;
+    /** The price includes taxes. */
+    taxIncluded: boolean;
+    /** Credits included each paid month, in cents (1900). */
+    includedCents: number;
+    trial: {
+        /** The account can start a trial now. */
+        eligible: boolean;
+        /** Trial length it would get, or got. */
+        days: number | null;
+        /** Trial credits, in cents. */
+        creditCents: number | null;
+        /** Promo code held for the trial, if any. */
+        promoCode: string | null;
+        /** Trial end (ms); null when not trialing. */
+        endsAt: number | null;
+        /** Trial credits used (trialing only). */
+        usedCents: number | null;
+        remainingCents: number | null;
+    };
+    /** The current Pro period; null when there is none. */
+    period: {
+        kind: 'trial' | 'paid';
+        start: number;
+        end: number;
+        /** 500 in the trial, 1900 in a paid month. */
+        includedCents: number;
+        usedCents: number;
+        /** Paid month: usage above the included credits. */
+        overageCents: number;
+        /** Of the overage, already invoiced. */
+        billedOverageCents: number;
+        unbilledOverageCents: number;
+        /** Paid month: unbilled overage at which the next invoice goes out. */
+        nextOverageChargeAtCents: number | null;
+    } | null;
+    /** Null when there is none, or the subscription is cancelling. */
+    nextCharge: {
+        at: number | null;
+        amountCents: number;
+    } | null;
+    /** When a cancelled subscription ends (ms). */
+    cancelAt: number | null;
+    /** An invoice is unpaid. */
+    pastDue: boolean;
+    /** Stripe page that pays it (owner only). */
+    openInvoiceUrl: string | null;
+    paymentMethod: {
+        brand: string;
+        last4: string;
+        expMonth: number;
+        expYear: number;
+    } | null;
+    /** Pro only: `tier` is `trial` or `pro`. */
+    limits: {
+        tier: string;
+        replicasPerApp: number;
+    } | null;
+    /** Pro Checkout is open for this account. */
+    checkoutAvailable: boolean;
+}
+interface StartCheckoutOpts {
+    /** Dashboard path to come back to after Checkout, e.g. `/projects/abc`. */
+    returnUrl?: string;
+}
+interface CheckoutSession {
+    /** Stripe Checkout page. The user finishes it in a browser. */
+    url: string;
+    sessionId: string;
+    /** Null when the account already had a trial: Pro starts at once and charges $19. */
+    trialDays: number | null;
+    trialCreditCents: number | null;
+}
+interface StartProNowResult {
+    /**
+     * `active`: charged $19, the first paid month started. `requires_action`: the bank
+     * wants a confirmation (or declined); open `invoiceUrl`, the trial continues.
+     * `failed`: nothing changed, the trial continues.
+     */
+    status: 'active' | 'requires_action' | 'failed';
+    invoiceUrl?: string | null;
+}
+interface PromoRedemption {
+    /** `pending_payment_method`: held for the trial Checkout starts. `applied`: applied now. */
+    status: string;
+    code?: string;
+    /** The trial credits (older servers: the credit amount). */
+    creditCents: number;
+    expiresAt: number | null;
+    /** Kept for older clients. */
+    balanceCents: number;
+    /** Trial length the code gives. Missing from servers before Pro. */
+    trialDays?: number;
+    trialCreditCents?: number;
+    /** `next_checkout`: held for the trial `startCheckout` opens. `current_trial`: extended the running trial. */
+    appliesTo?: 'next_checkout' | 'current_trial';
+}
+/**
+ * The account's plan, balance and usage.
+ *
+ * Pro costs $19/month, taxes included, with $19 of credits each month; usage above that
+ * is pay as you go, invoiced as it builds up. A new account starts with a 7-day trial
+ * with $5 of credits. Enterprise is pay as you go, invoiced monthly. Old prepaid
+ * credits accounts (`plan: 'payg'`) keep {@link balance} and {@link transactions}
+ * until 1 November 2026.
  *
  * Billing is **account-scoped, not workspace-scoped**: every workspace you create for
  * a user bills to the account that owns the key. That is what makes per-user
- * workspaces a safe pattern — your users get isolation, you keep one bill — and also
- * what makes {@link Balance.runwayHours} worth watching before you provision more.
+ * workspaces a safe pattern — your users get isolation, you keep one bill.
  *
- * **Requires an unscoped key.** A scoped key is refused with 403
- * `ACCOUNT_SCOPE_REQUIRED`, because there is no workspace-scoped view of one shared
- * balance, ledger and set of saved cards — and because a scoped key is meant to be
- * handed to an end user, who should not be reading your card details or spending
- * against them. For per-workspace spend, use {@link MetricsAPI.cost} instead.
+ * **Requires an unscoped key**, except {@link subscription} with a `workspaceId` the
+ * key can reach. A scoped key is refused with 403 `ACCOUNT_SCOPE_REQUIRED`, because a
+ * scoped key is meant to be handed to an end user, who should not be reading your
+ * card details or changing your plan. For per-workspace spend, use
+ * {@link MetricsAPI.cost} instead.
+ *
+ * Checkout and invoices are web pages: methods return their URL for the user to open.
+ * Nothing here retries a payment.
  */
 declare class BillingAPI {
     private readonly client;
     constructor(client: PlatformClient);
-    /** Current balance, status, burn rate, and runway. */
+    /**
+     * The plan: trial, this month's credits, overage, next charge, cancel date. With
+     * `workspaceId`, the plan of that workspace's owner (`isOwner: false`, no card or
+     * invoice fields).
+     */
+    subscription(opts?: {
+        workspaceId?: string;
+    }): Promise<Subscription>;
+    /**
+     * Opens Stripe Checkout for Pro: the trial when the account can have one, otherwise
+     * Pro at once ($19 today). Returns the page for the user to finish; a second call
+     * while it is open returns the same session.
+     */
+    startCheckout(opts?: StartCheckoutOpts): Promise<CheckoutSession>;
+    /** Ends the trial now: charges $19 and starts the first paid month with $19 of credits. */
+    startProNow(): Promise<StartProNowResult>;
+    /** Cancels Pro at the end of the current month or trial. Cancelling in the trial costs nothing. */
+    cancel(): Promise<{
+        cancelAt: number | null;
+    }>;
+    /** Undoes {@link cancel}: Pro renews as usual. */
+    resume(): Promise<{
+        cancelAt: null;
+    }>;
+    /** Redeems a promo code: a longer trial with more trial credits. Works only before the first payment. */
+    redeemPromo(code: string): Promise<PromoRedemption>;
+    /** Prepaid credits balance, status, burn rate and runway (old `payg` accounts and enterprise). */
     balance(): Promise<Balance>;
-    /** A page of balance transactions, newest first. */
+    /** A page of balance transactions, newest first (old `payg` accounts and enterprise). */
     transactions(opts?: ListTransactionsOpts): Promise<TransactionPage>;
     /** Cost summary for the current billing period, broken down by resource. */
     summary(): Promise<unknown>;
     /** Live (not-yet-invoiced) usage accumulating right now. */
     live(): Promise<unknown>;
+    /** Saved cards. Cards are added in Checkout or on the Billing page. */
     paymentMethods(): Promise<{
         items: unknown[];
     }>;
-    setupPaymentMethod(returnUrl?: string): Promise<{
-        url: string;
-    }>;
     removePaymentMethod(id: string): Promise<void>;
-    purchase(creditCents: number, opts?: {
-        paymentMethod?: 'card' | 'crypto';
-        returnUrl?: string;
-    }): Promise<{
-        url: string;
-        sessionId?: string;
-    }>;
-    autoTopup(): Promise<unknown>;
-    setAutoTopup(opts: {
-        enabled: boolean;
-        thresholdCents: number;
-        amountCents: number;
-        paymentMethodIds: string[];
-    }): Promise<unknown>;
-    runAutoTopup(): Promise<unknown>;
-    redeemPromo(code: string): Promise<unknown>;
-    x402Quote(creditCents: number): Promise<unknown>;
-    paymentStatus(attemptId: string): Promise<unknown>;
-    /** Pay with the CLI's durable x402 journal. Requires CLI >= 4.0.8. Amounts are cents. */
-    payX402(creditCents: number, opts: {
-        maxTotalCents: number;
-        requestId?: string;
-        executable?: string;
-    }): Promise<unknown>;
 }
 
 interface VolumeInfo {
@@ -1896,6 +2016,34 @@ declare class ConflictError extends LizardError {
 declare class TimeoutError extends LizardError {
     constructor(message?: string);
 }
+/**
+ * The account has to pay before it can do this (HTTP 402). Every create call answers
+ * 402 when the account has no plan yet, its trial credits are used up, or an invoice
+ * is unpaid. Show {@link message} to the user as is and send them to {@link url}.
+ *
+ * Still a {@link LizardError}, so existing `catch` blocks keep working.
+ */
+declare class PaymentRequiredError extends LizardError {
+    /**
+     * Why payment is needed: `trial_available` (start the Pro trial),
+     * `subscription_required` (the trial was used: start Pro), `trial_credits_used`
+     * (start Pro now), `past_due` or `paused` (pay the open invoice), or, for accounts
+     * on the old prepaid credits, `grace`, `frozen`, `card_required` or
+     * `credits_required`. {@link LizardError.status} stays the HTTP status, 402.
+     */
+    paymentStatus?: string;
+    /** Billing page that starts the Pro trial, or Pro when the trial was used. */
+    subscribeUrl?: string;
+    /** The Billing page. */
+    billingUrl?: string;
+    /** The Credits page, for accounts on the old prepaid credits. */
+    topupUrl?: string;
+    /** Stripe page that pays an unpaid invoice (`code` `UNPAID_INVOICE`). */
+    invoiceUrl?: string;
+    constructor(message?: string);
+    /** The one page to open next for this {@link paymentStatus}. */
+    get url(): string | undefined;
+}
 
 /** A single output item produced during code execution. */
 type OutputItem = {
@@ -2070,4 +2218,4 @@ declare class LizardCLI {
     }): Promise<CLIResult>;
 }
 
-export { type Account, type Addon, type AddonType, AddonsAPI, type ApiKey, type ApiKeyScope, ApiKeysAPI, AuthenticationError, type Balance, BillingAPI, type CLIOptions, type CLIResult, type ClickOpts, type CodeContext, CodeSandbox, ConfigApplyError, type ConfigResult, ConflictError, type ConnectionOpts, type CostMetrics, type CreateAddonOpts, type CreateApiKeyOpts, type CreateContextOpts, type CreateProjectOpts, type CreateServiceOpts, type CreateVolumeOpts, type CreateWorkspaceOpts, type CreatedApiKey, type DeployEvent, DeployHandle, Desktop, type DesktopInfo, type DesktopStartOpts, type DomainInfo, type DomainStatus, DomainsAPI, Execution, ExecutionError, type ExposedPort, type FileInfo, type ForkResult, type FsEvent, type FsOpts, GitHubAPI, type ListTransactionsOpts, Lizard, LizardCLI, LizardError, type LizardOpts, type LogLine, type MetricPoint, type MetricRange, MetricsAPI, type MouseButton, NotFoundError, PlatformClient, type ProcessInfo, type ProcessOpts, type ProcessResult, type ProcessSignal, type Project, type ProjectConfig, type ProjectCost, ProjectsAPI, type RawMetrics, type Region, RegionsAPI, type RunCodeLanguage, type RunCodeOpts, Sandbox, type SandboxInfo, type SandboxOpts, type SandboxSnapshot, type ScaleOpts, type ScrollDirection, type Secret, SecretsAPI, type Service, type ServiceMetrics, type ServiceUpdate, ServicesAPI, type SetSecretOpts, type SnapshotOpts, type SnapshotWaitOpts, StorageAPI, type StreamEvent, TimeoutError, type Transaction, type TransactionPage, Volume, type VolumeInfo, type Workspace, WorkspacesAPI, resolveProjectId };
+export { type Account, type Addon, type AddonType, AddonsAPI, type ApiKey, type ApiKeyScope, ApiKeysAPI, AuthenticationError, type Balance, BillingAPI, type CLIOptions, type CLIResult, type CheckoutSession, type ClickOpts, type CodeContext, CodeSandbox, ConfigApplyError, type ConfigResult, ConflictError, type ConnectionOpts, type CostMetrics, type CreateAddonOpts, type CreateApiKeyOpts, type CreateContextOpts, type CreateProjectOpts, type CreateServiceOpts, type CreateVolumeOpts, type CreateWorkspaceOpts, type CreatedApiKey, type DeployEvent, DeployHandle, Desktop, type DesktopInfo, type DesktopStartOpts, type DomainInfo, type DomainStatus, DomainsAPI, Execution, ExecutionError, type ExposedPort, type FileInfo, type ForkResult, type FsEvent, type FsOpts, GitHubAPI, type ListTransactionsOpts, Lizard, LizardCLI, LizardError, type LizardOpts, type LogLine, type MetricPoint, type MetricRange, MetricsAPI, type MouseButton, NotFoundError, PaymentRequiredError, type Plan, PlatformClient, type ProcessInfo, type ProcessOpts, type ProcessResult, type ProcessSignal, type Project, type ProjectConfig, type ProjectCost, ProjectsAPI, type PromoRedemption, type RawMetrics, type Region, RegionsAPI, type RunCodeLanguage, type RunCodeOpts, Sandbox, type SandboxInfo, type SandboxOpts, type SandboxSnapshot, type ScaleOpts, type ScrollDirection, type Secret, SecretsAPI, type Service, type ServiceMetrics, type ServiceUpdate, ServicesAPI, type SetSecretOpts, type SnapshotOpts, type SnapshotWaitOpts, type StartCheckoutOpts, type StartProNowResult, StorageAPI, type StreamEvent, type Subscription, type SubscriptionStatus, TimeoutError, type Transaction, type TransactionPage, Volume, type VolumeInfo, type Workspace, WorkspacesAPI, resolveProjectId };

package/dist/index.d.ts

@@ -1520,6 +1520,7 @@ declare class RegionsAPI {
     list(): Promise<Region[]>;
 }
 
+/** Prepaid credits balance: old credits accounts (`plan: 'payg'`) until 1 November 2026, and enterprise usage. */
 interface Balance {
     plan: string;
     status: 'active' | 'grace' | 'frozen' | string;
@@ -1558,61 +1559,180 @@ interface ListTransactionsOpts {
     includeUsage?: boolean;
 }
 /**
- * Account balance and usage.
+ * `none`: no plan yet (creating anything answers 402). `pro`: the Pro subscription, see
+ * {@link Subscription.status}. `payg`: old prepaid credits, until 1 November 2026.
+ * `enterprise`: pay as you go, invoiced monthly.
+ */
+type Plan = 'none' | 'pro' | 'payg' | 'enterprise';
+/** Pro subscription status; `none` when there is no subscription. */
+type SubscriptionStatus = 'trialing' | 'active' | 'past_due' | 'canceled' | 'none';
+interface Subscription {
+    plan: Plan | (string & {});
+    status: SubscriptionStatus | (string & {});
+    /** False when read for a workspace the caller does not own; card and invoice fields are then null. */
+    isOwner: boolean;
+    /** 1900: $19/month. */
+    priceCents: number;
+    /** The price includes taxes. */
+    taxIncluded: boolean;
+    /** Credits included each paid month, in cents (1900). */
+    includedCents: number;
+    trial: {
+        /** The account can start a trial now. */
+        eligible: boolean;
+        /** Trial length it would get, or got. */
+        days: number | null;
+        /** Trial credits, in cents. */
+        creditCents: number | null;
+        /** Promo code held for the trial, if any. */
+        promoCode: string | null;
+        /** Trial end (ms); null when not trialing. */
+        endsAt: number | null;
+        /** Trial credits used (trialing only). */
+        usedCents: number | null;
+        remainingCents: number | null;
+    };
+    /** The current Pro period; null when there is none. */
+    period: {
+        kind: 'trial' | 'paid';
+        start: number;
+        end: number;
+        /** 500 in the trial, 1900 in a paid month. */
+        includedCents: number;
+        usedCents: number;
+        /** Paid month: usage above the included credits. */
+        overageCents: number;
+        /** Of the overage, already invoiced. */
+        billedOverageCents: number;
+        unbilledOverageCents: number;
+        /** Paid month: unbilled overage at which the next invoice goes out. */
+        nextOverageChargeAtCents: number | null;
+    } | null;
+    /** Null when there is none, or the subscription is cancelling. */
+    nextCharge: {
+        at: number | null;
+        amountCents: number;
+    } | null;
+    /** When a cancelled subscription ends (ms). */
+    cancelAt: number | null;
+    /** An invoice is unpaid. */
+    pastDue: boolean;
+    /** Stripe page that pays it (owner only). */
+    openInvoiceUrl: string | null;
+    paymentMethod: {
+        brand: string;
+        last4: string;
+        expMonth: number;
+        expYear: number;
+    } | null;
+    /** Pro only: `tier` is `trial` or `pro`. */
+    limits: {
+        tier: string;
+        replicasPerApp: number;
+    } | null;
+    /** Pro Checkout is open for this account. */
+    checkoutAvailable: boolean;
+}
+interface StartCheckoutOpts {
+    /** Dashboard path to come back to after Checkout, e.g. `/projects/abc`. */
+    returnUrl?: string;
+}
+interface CheckoutSession {
+    /** Stripe Checkout page. The user finishes it in a browser. */
+    url: string;
+    sessionId: string;
+    /** Null when the account already had a trial: Pro starts at once and charges $19. */
+    trialDays: number | null;
+    trialCreditCents: number | null;
+}
+interface StartProNowResult {
+    /**
+     * `active`: charged $19, the first paid month started. `requires_action`: the bank
+     * wants a confirmation (or declined); open `invoiceUrl`, the trial continues.
+     * `failed`: nothing changed, the trial continues.
+     */
+    status: 'active' | 'requires_action' | 'failed';
+    invoiceUrl?: string | null;
+}
+interface PromoRedemption {
+    /** `pending_payment_method`: held for the trial Checkout starts. `applied`: applied now. */
+    status: string;
+    code?: string;
+    /** The trial credits (older servers: the credit amount). */
+    creditCents: number;
+    expiresAt: number | null;
+    /** Kept for older clients. */
+    balanceCents: number;
+    /** Trial length the code gives. Missing from servers before Pro. */
+    trialDays?: number;
+    trialCreditCents?: number;
+    /** `next_checkout`: held for the trial `startCheckout` opens. `current_trial`: extended the running trial. */
+    appliesTo?: 'next_checkout' | 'current_trial';
+}
+/**
+ * The account's plan, balance and usage.
+ *
+ * Pro costs $19/month, taxes included, with $19 of credits each month; usage above that
+ * is pay as you go, invoiced as it builds up. A new account starts with a 7-day trial
+ * with $5 of credits. Enterprise is pay as you go, invoiced monthly. Old prepaid
+ * credits accounts (`plan: 'payg'`) keep {@link balance} and {@link transactions}
+ * until 1 November 2026.
  *
  * Billing is **account-scoped, not workspace-scoped**: every workspace you create for
  * a user bills to the account that owns the key. That is what makes per-user
- * workspaces a safe pattern — your users get isolation, you keep one bill — and also
- * what makes {@link Balance.runwayHours} worth watching before you provision more.
+ * workspaces a safe pattern — your users get isolation, you keep one bill.
  *
- * **Requires an unscoped key.** A scoped key is refused with 403
- * `ACCOUNT_SCOPE_REQUIRED`, because there is no workspace-scoped view of one shared
- * balance, ledger and set of saved cards — and because a scoped key is meant to be
- * handed to an end user, who should not be reading your card details or spending
- * against them. For per-workspace spend, use {@link MetricsAPI.cost} instead.
+ * **Requires an unscoped key**, except {@link subscription} with a `workspaceId` the
+ * key can reach. A scoped key is refused with 403 `ACCOUNT_SCOPE_REQUIRED`, because a
+ * scoped key is meant to be handed to an end user, who should not be reading your
+ * card details or changing your plan. For per-workspace spend, use
+ * {@link MetricsAPI.cost} instead.
+ *
+ * Checkout and invoices are web pages: methods return their URL for the user to open.
+ * Nothing here retries a payment.
  */
 declare class BillingAPI {
     private readonly client;
     constructor(client: PlatformClient);
-    /** Current balance, status, burn rate, and runway. */
+    /**
+     * The plan: trial, this month's credits, overage, next charge, cancel date. With
+     * `workspaceId`, the plan of that workspace's owner (`isOwner: false`, no card or
+     * invoice fields).
+     */
+    subscription(opts?: {
+        workspaceId?: string;
+    }): Promise<Subscription>;
+    /**
+     * Opens Stripe Checkout for Pro: the trial when the account can have one, otherwise
+     * Pro at once ($19 today). Returns the page for the user to finish; a second call
+     * while it is open returns the same session.
+     */
+    startCheckout(opts?: StartCheckoutOpts): Promise<CheckoutSession>;
+    /** Ends the trial now: charges $19 and starts the first paid month with $19 of credits. */
+    startProNow(): Promise<StartProNowResult>;
+    /** Cancels Pro at the end of the current month or trial. Cancelling in the trial costs nothing. */
+    cancel(): Promise<{
+        cancelAt: number | null;
+    }>;
+    /** Undoes {@link cancel}: Pro renews as usual. */
+    resume(): Promise<{
+        cancelAt: null;
+    }>;
+    /** Redeems a promo code: a longer trial with more trial credits. Works only before the first payment. */
+    redeemPromo(code: string): Promise<PromoRedemption>;
+    /** Prepaid credits balance, status, burn rate and runway (old `payg` accounts and enterprise). */
     balance(): Promise<Balance>;
-    /** A page of balance transactions, newest first. */
+    /** A page of balance transactions, newest first (old `payg` accounts and enterprise). */
     transactions(opts?: ListTransactionsOpts): Promise<TransactionPage>;
     /** Cost summary for the current billing period, broken down by resource. */
     summary(): Promise<unknown>;
     /** Live (not-yet-invoiced) usage accumulating right now. */
     live(): Promise<unknown>;
+    /** Saved cards. Cards are added in Checkout or on the Billing page. */
     paymentMethods(): Promise<{
         items: unknown[];
     }>;
-    setupPaymentMethod(returnUrl?: string): Promise<{
-        url: string;
-    }>;
     removePaymentMethod(id: string): Promise<void>;
-    purchase(creditCents: number, opts?: {
-        paymentMethod?: 'card' | 'crypto';
-        returnUrl?: string;
-    }): Promise<{
-        url: string;
-        sessionId?: string;
-    }>;
-    autoTopup(): Promise<unknown>;
-    setAutoTopup(opts: {
-        enabled: boolean;
-        thresholdCents: number;
-        amountCents: number;
-        paymentMethodIds: string[];
-    }): Promise<unknown>;
-    runAutoTopup(): Promise<unknown>;
-    redeemPromo(code: string): Promise<unknown>;
-    x402Quote(creditCents: number): Promise<unknown>;
-    paymentStatus(attemptId: string): Promise<unknown>;
-    /** Pay with the CLI's durable x402 journal. Requires CLI >= 4.0.8. Amounts are cents. */
-    payX402(creditCents: number, opts: {
-        maxTotalCents: number;
-        requestId?: string;
-        executable?: string;
-    }): Promise<unknown>;
 }
 
 interface VolumeInfo {
@@ -1896,6 +2016,34 @@ declare class ConflictError extends LizardError {
 declare class TimeoutError extends LizardError {
     constructor(message?: string);
 }
+/**
+ * The account has to pay before it can do this (HTTP 402). Every create call answers
+ * 402 when the account has no plan yet, its trial credits are used up, or an invoice
+ * is unpaid. Show {@link message} to the user as is and send them to {@link url}.
+ *
+ * Still a {@link LizardError}, so existing `catch` blocks keep working.
+ */
+declare class PaymentRequiredError extends LizardError {
+    /**
+     * Why payment is needed: `trial_available` (start the Pro trial),
+     * `subscription_required` (the trial was used: start Pro), `trial_credits_used`
+     * (start Pro now), `past_due` or `paused` (pay the open invoice), or, for accounts
+     * on the old prepaid credits, `grace`, `frozen`, `card_required` or
+     * `credits_required`. {@link LizardError.status} stays the HTTP status, 402.
+     */
+    paymentStatus?: string;
+    /** Billing page that starts the Pro trial, or Pro when the trial was used. */
+    subscribeUrl?: string;
+    /** The Billing page. */
+    billingUrl?: string;
+    /** The Credits page, for accounts on the old prepaid credits. */
+    topupUrl?: string;
+    /** Stripe page that pays an unpaid invoice (`code` `UNPAID_INVOICE`). */
+    invoiceUrl?: string;
+    constructor(message?: string);
+    /** The one page to open next for this {@link paymentStatus}. */
+    get url(): string | undefined;
+}
 
 /** A single output item produced during code execution. */
 type OutputItem = {
@@ -2070,4 +2218,4 @@ declare class LizardCLI {
     }): Promise<CLIResult>;
 }
 
-export { type Account, type Addon, type AddonType, AddonsAPI, type ApiKey, type ApiKeyScope, ApiKeysAPI, AuthenticationError, type Balance, BillingAPI, type CLIOptions, type CLIResult, type ClickOpts, type CodeContext, CodeSandbox, ConfigApplyError, type ConfigResult, ConflictError, type ConnectionOpts, type CostMetrics, type CreateAddonOpts, type CreateApiKeyOpts, type CreateContextOpts, type CreateProjectOpts, type CreateServiceOpts, type CreateVolumeOpts, type CreateWorkspaceOpts, type CreatedApiKey, type DeployEvent, DeployHandle, Desktop, type DesktopInfo, type DesktopStartOpts, type DomainInfo, type DomainStatus, DomainsAPI, Execution, ExecutionError, type ExposedPort, type FileInfo, type ForkResult, type FsEvent, type FsOpts, GitHubAPI, type ListTransactionsOpts, Lizard, LizardCLI, LizardError, type LizardOpts, type LogLine, type MetricPoint, type MetricRange, MetricsAPI, type MouseButton, NotFoundError, PlatformClient, type ProcessInfo, type ProcessOpts, type ProcessResult, type ProcessSignal, type Project, type ProjectConfig, type ProjectCost, ProjectsAPI, type RawMetrics, type Region, RegionsAPI, type RunCodeLanguage, type RunCodeOpts, Sandbox, type SandboxInfo, type SandboxOpts, type SandboxSnapshot, type ScaleOpts, type ScrollDirection, type Secret, SecretsAPI, type Service, type ServiceMetrics, type ServiceUpdate, ServicesAPI, type SetSecretOpts, type SnapshotOpts, type SnapshotWaitOpts, StorageAPI, type StreamEvent, TimeoutError, type Transaction, type TransactionPage, Volume, type VolumeInfo, type Workspace, WorkspacesAPI, resolveProjectId };
+export { type Account, type Addon, type AddonType, AddonsAPI, type ApiKey, type ApiKeyScope, ApiKeysAPI, AuthenticationError, type Balance, BillingAPI, type CLIOptions, type CLIResult, type CheckoutSession, type ClickOpts, type CodeContext, CodeSandbox, ConfigApplyError, type ConfigResult, ConflictError, type ConnectionOpts, type CostMetrics, type CreateAddonOpts, type CreateApiKeyOpts, type CreateContextOpts, type CreateProjectOpts, type CreateServiceOpts, type CreateVolumeOpts, type CreateWorkspaceOpts, type CreatedApiKey, type DeployEvent, DeployHandle, Desktop, type DesktopInfo, type DesktopStartOpts, type DomainInfo, type DomainStatus, DomainsAPI, Execution, ExecutionError, type ExposedPort, type FileInfo, type ForkResult, type FsEvent, type FsOpts, GitHubAPI, type ListTransactionsOpts, Lizard, LizardCLI, LizardError, type LizardOpts, type LogLine, type MetricPoint, type MetricRange, MetricsAPI, type MouseButton, NotFoundError, PaymentRequiredError, type Plan, PlatformClient, type ProcessInfo, type ProcessOpts, type ProcessResult, type ProcessSignal, type Project, type ProjectConfig, type ProjectCost, ProjectsAPI, type PromoRedemption, type RawMetrics, type Region, RegionsAPI, type RunCodeLanguage, type RunCodeOpts, Sandbox, type SandboxInfo, type SandboxOpts, type SandboxSnapshot, type ScaleOpts, type ScrollDirection, type Secret, SecretsAPI, type Service, type ServiceMetrics, type ServiceUpdate, ServicesAPI, type SetSecretOpts, type SnapshotOpts, type SnapshotWaitOpts, type StartCheckoutOpts, type StartProNowResult, StorageAPI, type StreamEvent, type Subscription, type SubscriptionStatus, TimeoutError, type Transaction, type TransactionPage, Volume, type VolumeInfo, type Workspace, WorkspacesAPI, resolveProjectId };

package/dist/index.js

@@ -36,6 +36,7 @@ __export(index_exports, {
   LizardError: () => LizardError,
   MetricsAPI: () => MetricsAPI,
   NotFoundError: () => NotFoundError,
+  PaymentRequiredError: () => PaymentRequiredError,
   PlatformClient: () => PlatformClient,
   ProjectsAPI: () => ProjectsAPI,
   RegionsAPI: () => RegionsAPI,
@@ -111,18 +112,44 @@ var TimeoutError = class extends LizardError {
     this.name = "TimeoutError";
   }
 };
+var PaymentRequiredError = class extends LizardError {
+  constructor(message = "Payment required") {
+    super(message);
+    this.name = "PaymentRequiredError";
+  }
+  /** The one page to open next for this {@link paymentStatus}. */
+  get url() {
+    const s = this.paymentStatus;
+    if (this.invoiceUrl) return this.invoiceUrl;
+    if ((s === "trial_available" || s === "subscription_required") && this.subscribeUrl) return this.subscribeUrl;
+    if (s && PREPAID_STATUSES.has(s) && this.topupUrl) return this.topupUrl;
+    return this.billingUrl ?? this.subscribeUrl ?? this.topupUrl;
+  }
+};
+var PREPAID_STATUSES = /* @__PURE__ */ new Set(["grace", "frozen", "card_required", "credits_required"]);
+var ERROR_CODE = /^[A-Z][A-Z0-9_]*$/;
 async function handleApiError(res) {
-  let message;
-  let code;
+  let body = {};
   try {
-    const body = await res.json();
-    message = body.error ?? res.statusText;
-    if (typeof body.code === "string") code = body.code;
+    const parsed = await res.json();
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) body = parsed;
   } catch {
-    message = res.statusText;
   }
+  const text = (key) => typeof body[key] === "string" && body[key] ? body[key] : void 0;
+  const error = text("error");
+  const errorIsCode = !!error && ERROR_CODE.test(error);
+  const message = (errorIsCode ? text("message") ?? error : error ?? text("message")) ?? res.statusText;
+  const code = text("code") ?? (errorIsCode ? error : void 0);
   let err;
-  if (res.status === 401 || res.status === 403) err = new AuthenticationError(message);
+  if (res.status === 402) {
+    const paid = new PaymentRequiredError(message);
+    paid.paymentStatus = text("status");
+    paid.subscribeUrl = text("subscribeUrl");
+    paid.billingUrl = text("billingUrl");
+    paid.topupUrl = text("topupUrl");
+    paid.invoiceUrl = text("invoiceUrl");
+    err = paid;
+  } else if (res.status === 401 || res.status === 403) err = new AuthenticationError(message);
   else if (res.status === 404) err = new NotFoundError(message);
   else if (res.status === 409) err = new ConflictError(message);
   else if (res.status === 408 || res.status === 504) err = new TimeoutError(message);
@@ -1672,88 +1699,54 @@ var RegionsAPI = class {
   }
 };
 
-// src/cli.ts
-var import_node_child_process = require("child_process");
-var LizardCLI = class {
-  constructor(opts = {}) {
-    this.opts = opts;
-  }
-  run(args, opts = {}) {
-    return new Promise((resolve, reject) => {
-      const env = { ...process.env };
-      if (this.opts.apiKey) {
-        env.LIZARD_API_KEY = this.opts.apiKey;
-        env.LIZARD_TOKEN = this.opts.apiKey;
-      }
-      if (this.opts.apiUrl) env.LIZARD_API_URL = this.opts.apiUrl;
-      const child = (0, import_node_child_process.spawn)(this.opts.executable ?? "lizard", ["--json", ...args], {
-        cwd: this.opts.cwd,
-        env,
-        shell: false,
-        stdio: "pipe",
-        signal: opts.signal,
-        timeout: this.opts.timeoutMs ?? 6e5
-      });
-      child.stdout.setEncoding("utf8");
-      child.stderr.setEncoding("utf8");
-      let stdout = "", stderr = "", bytes = 0;
-      const collect = (stream, data) => {
-        bytes += Buffer.byteLength(data);
-        if (bytes > 16 * 1024 * 1024) {
-          child.kill();
-          reject(new Error("CLI output exceeds 16 MiB"));
-          return;
-        }
-        if (stream === "stdout") stdout += data;
-        else stderr += data;
-      };
-      child.stdout.on("data", (data) => collect("stdout", data));
-      child.stderr.on("data", (data) => collect("stderr", data));
-      child.on("error", reject);
-      child.on("close", (code, signal) => {
-        if (signal) {
-          reject(new Error(`CLI ended with signal ${signal}`));
-          return;
-        }
-        let events = [];
-        try {
-          events = [JSON.parse(stdout)];
-        } catch {
-          events = stdout.split("\n").filter(Boolean).flatMap((line) => {
-            try {
-              return [JSON.parse(line)];
-            } catch {
-              return [];
-            }
-          });
-        }
-        resolve({ code: code ?? 1, stdout, stderr, events });
-      });
-      child.stdin.on("error", (error) => {
-        if (error.code !== "EPIPE") reject(error);
-      });
-      child.stdin.end(opts.stdin);
-    });
-  }
-};
-
 // src/platform/billing.ts
 var BillingAPI = class {
   constructor(client) {
     this.client = client;
   }
-  /** Current balance, status, burn rate, and runway. */
+  /**
+   * The plan: trial, this month's credits, overage, next charge, cancel date. With
+   * `workspaceId`, the plan of that workspace's owner (`isOwner: false`, no card or
+   * invoice fields).
+   */
+  subscription(opts) {
+    return this.client.get(query("/api/billing/subscription", { workspaceId: opts?.workspaceId }));
+  }
+  /**
+   * Opens Stripe Checkout for Pro: the trial when the account can have one, otherwise
+   * Pro at once ($19 today). Returns the page for the user to finish; a second call
+   * while it is open returns the same session.
+   */
+  startCheckout(opts = {}) {
+    return this.client.post("/api/billing/subscription/checkout", { returnUrl: opts.returnUrl });
+  }
+  /** Ends the trial now: charges $19 and starts the first paid month with $19 of credits. */
+  startProNow() {
+    return this.client.post("/api/billing/subscription/start-now", {});
+  }
+  /** Cancels Pro at the end of the current month or trial. Cancelling in the trial costs nothing. */
+  cancel() {
+    return this.client.post("/api/billing/subscription/cancel", {});
+  }
+  /** Undoes {@link cancel}: Pro renews as usual. */
+  resume() {
+    return this.client.post("/api/billing/subscription/resume", {});
+  }
+  /** Redeems a promo code: a longer trial with more trial credits. Works only before the first payment. */
+  redeemPromo(code) {
+    return this.client.post("/api/billing/promo/redeem", { code });
+  }
+  /** Prepaid credits balance, status, burn rate and runway (old `payg` accounts and enterprise). */
   balance() {
     return this.client.get("/api/billing/balance");
   }
-  /** A page of balance transactions, newest first. */
+  /** A page of balance transactions, newest first (old `payg` accounts and enterprise). */
   transactions(opts) {
-    const qs = new URLSearchParams();
-    if (opts?.limit !== void 0) qs.set("limit", String(opts.limit));
-    if (opts?.cursor) qs.set("cursor", opts.cursor);
-    if (opts?.includeUsage) qs.set("includeUsage", "1");
-    const q = qs.toString();
-    return this.client.get(`/api/billing/transactions${q ? `?${q}` : ""}`);
+    return this.client.get(query("/api/billing/transactions", {
+      limit: opts?.limit,
+      cursor: opts?.cursor || void 0,
+      includeUsage: opts?.includeUsage ? "1" : void 0
+    }));
   }
   /** Cost summary for the current billing period, broken down by resource. */
   summary() {
@@ -1763,46 +1756,13 @@ var BillingAPI = class {
   live() {
     return this.client.get("/api/billing/live");
   }
+  /** Saved cards. Cards are added in Checkout or on the Billing page. */
   paymentMethods() {
     return this.client.get("/api/billing/payment-methods");
   }
-  setupPaymentMethod(returnUrl) {
-    return this.client.post("/api/billing/payment-methods/setup", { returnUrl });
-  }
   removePaymentMethod(id) {
     return this.client.delete(`/api/billing/payment-methods/${encodeURIComponent(id)}`);
   }
-  purchase(creditCents, opts = {}) {
-    if (!Number.isSafeInteger(creditCents) || creditCents <= 0) throw new Error("creditCents must be a positive integer");
-    return this.client.post("/api/billing/purchase", { creditCents, paymentMethod: opts.paymentMethod ?? "card", returnUrl: opts.returnUrl });
-  }
-  autoTopup() {
-    return this.client.get("/api/billing/auto-topup");
-  }
-  setAutoTopup(opts) {
-    return this.client.put("/api/billing/auto-topup", opts);
-  }
-  runAutoTopup() {
-    return this.client.post("/api/billing/auto-topup/run", {});
-  }
-  redeemPromo(code) {
-    return this.client.post("/api/billing/promo/redeem", { code });
-  }
-  x402Quote(creditCents) {
-    return this.client.post("/api/billing/purchase/x402/quote", { creditCents });
-  }
-  paymentStatus(attemptId) {
-    return this.client.get(`/api/billing/purchase/x402/${encodeURIComponent(attemptId)}`);
-  }
-  /** Pay with the CLI's durable x402 journal. Requires CLI >= 4.0.8. Amounts are cents. */
-  async payX402(creditCents, opts) {
-    if (![creditCents, opts.maxTotalCents].every((n) => Number.isSafeInteger(n) && n > 0)) throw new Error("Payment amounts must be positive integer cents");
-    const args = ["credits", "topup", (creditCents / 100).toFixed(2), "--method", "x402", "--max-total", (opts.maxTotalCents / 100).toFixed(2), "--yes"];
-    if (opts.requestId) args.push("--request-id", opts.requestId);
-    const result = await new LizardCLI({ apiKey: this.client.config.apiKey, apiUrl: this.client.config.apiUrl, executable: opts.executable }).run(args);
-    if (result.code !== 0) throw new Error(`x402 CLI exited with code ${result.code}; inspect the payment journal or query paymentStatus before retrying`);
-    return result.events[0];
-  }
 };
 
 // src/volume/index.ts
@@ -2507,6 +2467,71 @@ function toBase64(text) {
   for (let i = 0; i < bytes.length; i += 32768) s += String.fromCharCode(...bytes.subarray(i, i + 32768));
   return btoa(s);
 }
+
+// src/cli.ts
+var import_node_child_process = require("child_process");
+var LizardCLI = class {
+  constructor(opts = {}) {
+    this.opts = opts;
+  }
+  run(args, opts = {}) {
+    return new Promise((resolve, reject) => {
+      const env = { ...process.env };
+      if (this.opts.apiKey) {
+        env.LIZARD_API_KEY = this.opts.apiKey;
+        env.LIZARD_TOKEN = this.opts.apiKey;
+      }
+      if (this.opts.apiUrl) env.LIZARD_API_URL = this.opts.apiUrl;
+      const child = (0, import_node_child_process.spawn)(this.opts.executable ?? "lizard", ["--json", ...args], {
+        cwd: this.opts.cwd,
+        env,
+        shell: false,
+        stdio: "pipe",
+        signal: opts.signal,
+        timeout: this.opts.timeoutMs ?? 6e5
+      });
+      child.stdout.setEncoding("utf8");
+      child.stderr.setEncoding("utf8");
+      let stdout = "", stderr = "", bytes = 0;
+      const collect = (stream, data) => {
+        bytes += Buffer.byteLength(data);
+        if (bytes > 16 * 1024 * 1024) {
+          child.kill();
+          reject(new Error("CLI output exceeds 16 MiB"));
+          return;
+        }
+        if (stream === "stdout") stdout += data;
+        else stderr += data;
+      };
+      child.stdout.on("data", (data) => collect("stdout", data));
+      child.stderr.on("data", (data) => collect("stderr", data));
+      child.on("error", reject);
+      child.on("close", (code, signal) => {
+        if (signal) {
+          reject(new Error(`CLI ended with signal ${signal}`));
+          return;
+        }
+        let events = [];
+        try {
+          events = [JSON.parse(stdout)];
+        } catch {
+          events = stdout.split("\n").filter(Boolean).flatMap((line) => {
+            try {
+              return [JSON.parse(line)];
+            } catch {
+              return [];
+            }
+          });
+        }
+        resolve({ code: code ?? 1, stdout, stderr, events });
+      });
+      child.stdin.on("error", (error) => {
+        if (error.code !== "EPIPE") reject(error);
+      });
+      child.stdin.end(opts.stdin);
+    });
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AddonsAPI,
@@ -2525,6 +2550,7 @@ function toBase64(text) {
   LizardError,
   MetricsAPI,
   NotFoundError,
+  PaymentRequiredError,
   PlatformClient,
   ProjectsAPI,
   RegionsAPI,

package/dist/index.mjs

@@ -59,18 +59,44 @@ var TimeoutError = class extends LizardError {
     this.name = "TimeoutError";
   }
 };
+var PaymentRequiredError = class extends LizardError {
+  constructor(message = "Payment required") {
+    super(message);
+    this.name = "PaymentRequiredError";
+  }
+  /** The one page to open next for this {@link paymentStatus}. */
+  get url() {
+    const s = this.paymentStatus;
+    if (this.invoiceUrl) return this.invoiceUrl;
+    if ((s === "trial_available" || s === "subscription_required") && this.subscribeUrl) return this.subscribeUrl;
+    if (s && PREPAID_STATUSES.has(s) && this.topupUrl) return this.topupUrl;
+    return this.billingUrl ?? this.subscribeUrl ?? this.topupUrl;
+  }
+};
+var PREPAID_STATUSES = /* @__PURE__ */ new Set(["grace", "frozen", "card_required", "credits_required"]);
+var ERROR_CODE = /^[A-Z][A-Z0-9_]*$/;
 async function handleApiError(res) {
-  let message;
-  let code;
+  let body = {};
   try {
-    const body = await res.json();
-    message = body.error ?? res.statusText;
-    if (typeof body.code === "string") code = body.code;
+    const parsed = await res.json();
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) body = parsed;
   } catch {
-    message = res.statusText;
   }
+  const text = (key) => typeof body[key] === "string" && body[key] ? body[key] : void 0;
+  const error = text("error");
+  const errorIsCode = !!error && ERROR_CODE.test(error);
+  const message = (errorIsCode ? text("message") ?? error : error ?? text("message")) ?? res.statusText;
+  const code = text("code") ?? (errorIsCode ? error : void 0);
   let err;
-  if (res.status === 401 || res.status === 403) err = new AuthenticationError(message);
+  if (res.status === 402) {
+    const paid = new PaymentRequiredError(message);
+    paid.paymentStatus = text("status");
+    paid.subscribeUrl = text("subscribeUrl");
+    paid.billingUrl = text("billingUrl");
+    paid.topupUrl = text("topupUrl");
+    paid.invoiceUrl = text("invoiceUrl");
+    err = paid;
+  } else if (res.status === 401 || res.status === 403) err = new AuthenticationError(message);
   else if (res.status === 404) err = new NotFoundError(message);
   else if (res.status === 409) err = new ConflictError(message);
   else if (res.status === 408 || res.status === 504) err = new TimeoutError(message);
@@ -1620,88 +1646,54 @@ var RegionsAPI = class {
   }
 };
 
-// src/cli.ts
-import { spawn } from "child_process";
-var LizardCLI = class {
-  constructor(opts = {}) {
-    this.opts = opts;
-  }
-  run(args, opts = {}) {
-    return new Promise((resolve, reject) => {
-      const env = { ...process.env };
-      if (this.opts.apiKey) {
-        env.LIZARD_API_KEY = this.opts.apiKey;
-        env.LIZARD_TOKEN = this.opts.apiKey;
-      }
-      if (this.opts.apiUrl) env.LIZARD_API_URL = this.opts.apiUrl;
-      const child = spawn(this.opts.executable ?? "lizard", ["--json", ...args], {
-        cwd: this.opts.cwd,
-        env,
-        shell: false,
-        stdio: "pipe",
-        signal: opts.signal,
-        timeout: this.opts.timeoutMs ?? 6e5
-      });
-      child.stdout.setEncoding("utf8");
-      child.stderr.setEncoding("utf8");
-      let stdout = "", stderr = "", bytes = 0;
-      const collect = (stream, data) => {
-        bytes += Buffer.byteLength(data);
-        if (bytes > 16 * 1024 * 1024) {
-          child.kill();
-          reject(new Error("CLI output exceeds 16 MiB"));
-          return;
-        }
-        if (stream === "stdout") stdout += data;
-        else stderr += data;
-      };
-      child.stdout.on("data", (data) => collect("stdout", data));
-      child.stderr.on("data", (data) => collect("stderr", data));
-      child.on("error", reject);
-      child.on("close", (code, signal) => {
-        if (signal) {
-          reject(new Error(`CLI ended with signal ${signal}`));
-          return;
-        }
-        let events = [];
-        try {
-          events = [JSON.parse(stdout)];
-        } catch {
-          events = stdout.split("\n").filter(Boolean).flatMap((line) => {
-            try {
-              return [JSON.parse(line)];
-            } catch {
-              return [];
-            }
-          });
-        }
-        resolve({ code: code ?? 1, stdout, stderr, events });
-      });
-      child.stdin.on("error", (error) => {
-        if (error.code !== "EPIPE") reject(error);
-      });
-      child.stdin.end(opts.stdin);
-    });
-  }
-};
-
 // src/platform/billing.ts
 var BillingAPI = class {
   constructor(client) {
     this.client = client;
   }
-  /** Current balance, status, burn rate, and runway. */
+  /**
+   * The plan: trial, this month's credits, overage, next charge, cancel date. With
+   * `workspaceId`, the plan of that workspace's owner (`isOwner: false`, no card or
+   * invoice fields).
+   */
+  subscription(opts) {
+    return this.client.get(query("/api/billing/subscription", { workspaceId: opts?.workspaceId }));
+  }
+  /**
+   * Opens Stripe Checkout for Pro: the trial when the account can have one, otherwise
+   * Pro at once ($19 today). Returns the page for the user to finish; a second call
+   * while it is open returns the same session.
+   */
+  startCheckout(opts = {}) {
+    return this.client.post("/api/billing/subscription/checkout", { returnUrl: opts.returnUrl });
+  }
+  /** Ends the trial now: charges $19 and starts the first paid month with $19 of credits. */
+  startProNow() {
+    return this.client.post("/api/billing/subscription/start-now", {});
+  }
+  /** Cancels Pro at the end of the current month or trial. Cancelling in the trial costs nothing. */
+  cancel() {
+    return this.client.post("/api/billing/subscription/cancel", {});
+  }
+  /** Undoes {@link cancel}: Pro renews as usual. */
+  resume() {
+    return this.client.post("/api/billing/subscription/resume", {});
+  }
+  /** Redeems a promo code: a longer trial with more trial credits. Works only before the first payment. */
+  redeemPromo(code) {
+    return this.client.post("/api/billing/promo/redeem", { code });
+  }
+  /** Prepaid credits balance, status, burn rate and runway (old `payg` accounts and enterprise). */
   balance() {
     return this.client.get("/api/billing/balance");
   }
-  /** A page of balance transactions, newest first. */
+  /** A page of balance transactions, newest first (old `payg` accounts and enterprise). */
   transactions(opts) {
-    const qs = new URLSearchParams();
-    if (opts?.limit !== void 0) qs.set("limit", String(opts.limit));
-    if (opts?.cursor) qs.set("cursor", opts.cursor);
-    if (opts?.includeUsage) qs.set("includeUsage", "1");
-    const q = qs.toString();
-    return this.client.get(`/api/billing/transactions${q ? `?${q}` : ""}`);
+    return this.client.get(query("/api/billing/transactions", {
+      limit: opts?.limit,
+      cursor: opts?.cursor || void 0,
+      includeUsage: opts?.includeUsage ? "1" : void 0
+    }));
   }
   /** Cost summary for the current billing period, broken down by resource. */
   summary() {
@@ -1711,46 +1703,13 @@ var BillingAPI = class {
   live() {
     return this.client.get("/api/billing/live");
   }
+  /** Saved cards. Cards are added in Checkout or on the Billing page. */
   paymentMethods() {
     return this.client.get("/api/billing/payment-methods");
   }
-  setupPaymentMethod(returnUrl) {
-    return this.client.post("/api/billing/payment-methods/setup", { returnUrl });
-  }
   removePaymentMethod(id) {
     return this.client.delete(`/api/billing/payment-methods/${encodeURIComponent(id)}`);
   }
-  purchase(creditCents, opts = {}) {
-    if (!Number.isSafeInteger(creditCents) || creditCents <= 0) throw new Error("creditCents must be a positive integer");
-    return this.client.post("/api/billing/purchase", { creditCents, paymentMethod: opts.paymentMethod ?? "card", returnUrl: opts.returnUrl });
-  }
-  autoTopup() {
-    return this.client.get("/api/billing/auto-topup");
-  }
-  setAutoTopup(opts) {
-    return this.client.put("/api/billing/auto-topup", opts);
-  }
-  runAutoTopup() {
-    return this.client.post("/api/billing/auto-topup/run", {});
-  }
-  redeemPromo(code) {
-    return this.client.post("/api/billing/promo/redeem", { code });
-  }
-  x402Quote(creditCents) {
-    return this.client.post("/api/billing/purchase/x402/quote", { creditCents });
-  }
-  paymentStatus(attemptId) {
-    return this.client.get(`/api/billing/purchase/x402/${encodeURIComponent(attemptId)}`);
-  }
-  /** Pay with the CLI's durable x402 journal. Requires CLI >= 4.0.8. Amounts are cents. */
-  async payX402(creditCents, opts) {
-    if (![creditCents, opts.maxTotalCents].every((n) => Number.isSafeInteger(n) && n > 0)) throw new Error("Payment amounts must be positive integer cents");
-    const args = ["credits", "topup", (creditCents / 100).toFixed(2), "--method", "x402", "--max-total", (opts.maxTotalCents / 100).toFixed(2), "--yes"];
-    if (opts.requestId) args.push("--request-id", opts.requestId);
-    const result = await new LizardCLI({ apiKey: this.client.config.apiKey, apiUrl: this.client.config.apiUrl, executable: opts.executable }).run(args);
-    if (result.code !== 0) throw new Error(`x402 CLI exited with code ${result.code}; inspect the payment journal or query paymentStatus before retrying`);
-    return result.events[0];
-  }
 };
 
 // src/volume/index.ts
@@ -2455,6 +2414,71 @@ function toBase64(text) {
   for (let i = 0; i < bytes.length; i += 32768) s += String.fromCharCode(...bytes.subarray(i, i + 32768));
   return btoa(s);
 }
+
+// src/cli.ts
+import { spawn } from "child_process";
+var LizardCLI = class {
+  constructor(opts = {}) {
+    this.opts = opts;
+  }
+  run(args, opts = {}) {
+    return new Promise((resolve, reject) => {
+      const env = { ...process.env };
+      if (this.opts.apiKey) {
+        env.LIZARD_API_KEY = this.opts.apiKey;
+        env.LIZARD_TOKEN = this.opts.apiKey;
+      }
+      if (this.opts.apiUrl) env.LIZARD_API_URL = this.opts.apiUrl;
+      const child = spawn(this.opts.executable ?? "lizard", ["--json", ...args], {
+        cwd: this.opts.cwd,
+        env,
+        shell: false,
+        stdio: "pipe",
+        signal: opts.signal,
+        timeout: this.opts.timeoutMs ?? 6e5
+      });
+      child.stdout.setEncoding("utf8");
+      child.stderr.setEncoding("utf8");
+      let stdout = "", stderr = "", bytes = 0;
+      const collect = (stream, data) => {
+        bytes += Buffer.byteLength(data);
+        if (bytes > 16 * 1024 * 1024) {
+          child.kill();
+          reject(new Error("CLI output exceeds 16 MiB"));
+          return;
+        }
+        if (stream === "stdout") stdout += data;
+        else stderr += data;
+      };
+      child.stdout.on("data", (data) => collect("stdout", data));
+      child.stderr.on("data", (data) => collect("stderr", data));
+      child.on("error", reject);
+      child.on("close", (code, signal) => {
+        if (signal) {
+          reject(new Error(`CLI ended with signal ${signal}`));
+          return;
+        }
+        let events = [];
+        try {
+          events = [JSON.parse(stdout)];
+        } catch {
+          events = stdout.split("\n").filter(Boolean).flatMap((line) => {
+            try {
+              return [JSON.parse(line)];
+            } catch {
+              return [];
+            }
+          });
+        }
+        resolve({ code: code ?? 1, stdout, stderr, events });
+      });
+      child.stdin.on("error", (error) => {
+        if (error.code !== "EPIPE") reject(error);
+      });
+      child.stdin.end(opts.stdin);
+    });
+  }
+};
 export {
   AddonsAPI,
   ApiKeysAPI,
@@ -2472,6 +2496,7 @@ export {
   LizardError,
   MetricsAPI,
   NotFoundError,
+  PaymentRequiredError,
   PlatformClient,
   ProjectsAPI,
   RegionsAPI,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lizard-build/sdk",
-  "version": "0.1.51",
+  "version": "0.1.52",
   "description": "TypeScript SDK for Lizard: Firecracker microVM sandboxes, code execution and cloud apps.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",