@archildata/api-types 0.0.49 → 0.0.51

package/index.d.ts

@@ -13,7 +13,7 @@ export interface paths {
         };
         /**
          * Get billing summary
-         * @description Returns the selected account's billing state and available actions.
+         * @description Returns the selected account's billing state and available actions. Accounts that share billing also share subscription and open-invoice information.
          */
         get: operations["getBillingSummary"];
         put?: never;
@@ -74,8 +74,8 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Start card setup with Stripe Elements
-         * @description Confirm the returned SetupIntent with Stripe Elements in the client.
+         * Start card setup
+         * @description Use the returned clientSecret to confirm card details in the client's payment form.
          */
         post: operations["createBillingSetupIntent"];
         delete?: never;
@@ -93,8 +93,8 @@ export interface paths {
         };
         get?: never;
         /**
-         * Set the default method for customer invoices and the current subscription
-         * @description Provide a saved method ID or a succeeded SetupIntent ID. The method must belong to the authenticated account's Stripe customer. Existing invoice debt is not paid by this action. Accounts with multiple billable subscriptions require support review.
+         * Set the default payment method
+         * @description Provide a saved payment method ID or a completed card setup ID. The payment method must belong to the selected account. This action does not pay outstanding invoices. Accounts with multiple billable subscriptions must contact support.
          */
         put: operations["setBillingDefaultPaymentMethod"];
         post?: never;
@@ -111,17 +111,57 @@ export interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Get invoice billing details from Stripe */
+        /** Get invoice billing details */
         get: operations["getBillingProfile"];
         put?: never;
         post?: never;
         delete?: never;
         options?: never;
         head?: never;
-        /** Update invoice billing details in Stripe */
+        /** Update invoice billing details */
         patch: operations["updateBillingProfile"];
         trace?: never;
     };
+    "/api/billing/invoices": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List account invoices
+         * @description Returns invoice summaries for the selected account's billing profile. Accounts that share billing have the same invoice history. The default page size is 24; use limit to request between 1 and 100 invoices. When nextCursor is returned, pass its value as cursor to fetch the next page.
+         */
+        get: operations["listBillingInvoices"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/billing/invoices/{invoiceID}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get invoice details and a PDF download link
+         * @description Returns invoice details and an optional invoicePdf download link. Line items and credit notes are paginated independently; limit applies to each section and defaults to 24, with values from 1 to 100 accepted. A true partialData value means at least one section has more items. To continue a section, pass its lineNextCursor as lineCursor or its creditNoteNextCursor as creditNoteCursor. Retrieve a new PDF link when needed rather than storing it for later use.
+         */
+        get: operations["getBillingInvoice"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/activity": {
         parameters: {
             query?: never;
@@ -801,13 +841,14 @@ export interface paths {
         /**
          * Set a sandbox's timeouts
          * @description Replaces one or both sandbox timeout settings. Updating `timeout` while
-         *     the sandbox is running resets its hard expiration deadline to that many
-         *     seconds from now. Updating `idle_ttl_seconds` resets the idle
-         *     countdown when no direct process connection is active; zero disables
-         *     idle expiry. Omitted settings remain unchanged. Updates are retained
-         *     across later stops and starts. For an inactive sandbox, they apply to
-         *     the next powered-on session. Sandboxes that are starting or shutting
-         *     down, or whose timeout changes concurrently, return 409.
+         *     the sandbox is running moves its hard expiration deadline to that many
+         *     seconds from now, but never past 24 hours after the session started.
+         *     Updating `idle_ttl_seconds` resets the idle countdown when no direct
+         *     process connection is active; zero disables idle expiry. Omitted
+         *     settings remain unchanged. Updates are retained across later stops and
+         *     starts. For an inactive sandbox, they apply to the next powered-on
+         *     session. Sandboxes that are starting or shutting down, or whose timeout
+         *     changes concurrently, return 409.
          */
         post: operations["setSandboxTimeout"];
         delete?: never;
@@ -877,7 +918,7 @@ export interface components {
             code?: string;
         };
         BillingOwner: {
-            /** @description Selected account ID; linked accounts may share a Stripe customer. */
+            /** @description Selected account ID. */
             accountId: string;
             /** @enum {string} */
             type: "personal" | "organization";
@@ -930,7 +971,7 @@ export interface components {
             billingMode: "not_setup" | "self_serve" | "managed";
             /** @enum {string} */
             plan: "developer" | "team" | "enterprise" | "unknown";
-            /** @description Stripe subscription status, `none`, or `managed`. */
+            /** @description Current subscription status, `none`, or `managed`. */
             subscriptionStatus: string;
             billingPeriod?: components["schemas"]["BillingPeriod"];
             /**
@@ -1038,6 +1079,87 @@ export interface components {
             success: boolean;
             data: components["schemas"]["BillingProfile"];
         };
+        BillingInvoiceSummary: {
+            id: string;
+            number: string;
+            /** Format: int64 */
+            date: number;
+            status: string;
+            currency: string;
+            /** Format: int64 */
+            totalCents: number;
+            /** Format: int64 */
+            amountDueCents: number;
+            /** Format: int64 */
+            amountPaidCents: number;
+            /** Format: int64 */
+            amountRemainingCents: number;
+        };
+        ApiResponse_BillingInvoices: {
+            success: boolean;
+            data: components["schemas"]["BillingInvoiceSummary"][];
+            nextCursor?: string;
+        };
+        BillingInvoiceTax: {
+            /** Format: int64 */
+            amountCents: number;
+            /** Format: int64 */
+            taxableAmountCents: number;
+            type: string;
+        };
+        BillingInvoiceCredit: {
+            /** Format: int64 */
+            amountCents: number;
+            type: string;
+        };
+        BillingInvoiceLine: {
+            id: string;
+            description: string;
+            /** Format: int64 */
+            amountCents: number;
+            currency: string;
+            /** Format: int64 */
+            quantity: number;
+            period?: components["schemas"]["BillingPeriod"];
+            taxes: components["schemas"]["BillingInvoiceTax"][];
+            pretaxCredits: components["schemas"]["BillingInvoiceCredit"][];
+        };
+        BillingCreditNote: {
+            id: string;
+            number: string;
+            /** Format: int64 */
+            date: number;
+            status: string;
+            type: string;
+            currency: string;
+            /** Format: int64 */
+            totalCents: number;
+            /** Format: int64 */
+            prePaymentAmountCents: number;
+            /** Format: int64 */
+            postPaymentAmountCents: number;
+        };
+        BillingInvoiceDetail: components["schemas"]["BillingInvoiceSummary"] & {
+            /** Format: int64 */
+            subtotalCents: number;
+            /** Format: int64 */
+            prePaymentCreditNotesAmountCents: number;
+            /** Format: int64 */
+            postPaymentCreditNotesAmountCents: number;
+            taxes: components["schemas"]["BillingInvoiceTax"][];
+            pretaxCredits: components["schemas"]["BillingInvoiceCredit"][];
+            lines: components["schemas"]["BillingInvoiceLine"][];
+            creditNotes: components["schemas"]["BillingCreditNote"][];
+            lineNextCursor?: string;
+            creditNoteNextCursor?: string;
+            partialData: boolean;
+            /** Format: uri */
+            invoicePdf?: string;
+        };
+        ApiResponse_BillingInvoiceDetail: {
+            success: boolean;
+            data: components["schemas"]["BillingInvoiceDetail"];
+        };
         ActivityEvent: {
             accountId: string;
             /**
@@ -1120,7 +1242,7 @@ export interface components {
             egress?: components["schemas"]["SandboxEgressPolicy"];
         };
         SandboxTimeoutRequest: {
-            /** @description Seconds from now until a running sandbox expires, and the lifetime budget for its next powered-on session. */
+            /** @description Seconds from now until a running sandbox expires, capped at 24 hours after its session started, and the lifetime budget for its next powered-on session. */
             timeout?: number;
             /** @description Seconds without a direct process connection before the sandbox pauses. Zero disables idle expiry. */
             idle_ttl_seconds?: number;
@@ -1133,7 +1255,7 @@ export interface components {
             status: components["schemas"]["SandboxState"];
             vcpu_count: number;
             mem_size_mib: number;
-            /** @description Lifetime budget applied independently to each powered-on session. Expiry pauses the sandbox, preserving memory and processes for resume. Defaults to 24 hours and can be reset with the timeout endpoint. */
+            /** @description Lifetime budget applied independently to each powered-on session. Expiry pauses the sandbox, preserving memory and processes for resume. Defaults to 24 hours. The timeout endpoint can move the deadline, but no session runs longer than 24 hours. */
             max_ttl_seconds: number;
             /** @description Seconds without a direct process connection before the sandbox pauses, preserving memory and processes for resume. Zero disables idle expiry. */
             idle_ttl_seconds: number;
@@ -2398,7 +2520,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Updated safe method details */
+            /** @description Updated payment method details */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2431,7 +2553,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description SetupIntent for client-side confirmation */
+            /** @description Card setup ID and client secret for confirmation */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2485,7 +2607,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description Stripe defaults were fetched again and verified */
+            /** @description Default payment method updated */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2572,6 +2694,81 @@ export interface operations {
             502: components["responses"]["InternalError"];
         };
     };
+    listBillingInvoices: {
+        parameters: {
+            query?: {
+                limit?: number;
+                /** @description Pagination cursor from a previous response */
+                cursor?: components["parameters"]["Cursor"];
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Invoice summaries and an optional next-page cursor */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_BillingInvoices"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            /** @description Billing is managed by Archil (`managed_billing`) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            502: components["responses"]["InternalError"];
+        };
+    };
+    getBillingInvoice: {
+        parameters: {
+            query?: {
+                limit?: number;
+                lineCursor?: string;
+                creditNoteCursor?: string;
+            };
+            header?: never;
+            path: {
+                invoiceID: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Invoice details with paginated line items and credit notes */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ApiResponse_BillingInvoiceDetail"];
+                };
+            };
+            400: components["responses"]["ValidationError"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            /** @description Billing is managed by Archil (`managed_billing`) */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
+            502: components["responses"]["InternalError"];
+        };
+    };
     listActivity: {
         parameters: {
             query?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archildata/api-types",
-  "version": "0.0.49",
+  "version": "0.0.51",
   "description": "API types for the Archil control plane",
   "type": "module",
   "types": "index.d.ts",