@scalix-world/sdk 1.3.4 → 1.4.0

package/dist/esm/generated/types.gen.d.ts

@@ -83,6 +83,50 @@ export type BandwidthStat = {
 export type BatchSqlRequest = {
     queries: Array<SqlRequest>;
 };
+/**
+ * Connection endpoint of the branch's compute worker.
+ */
+export type BranchTimelineEndpoint = {
+    host: string;
+    port: number;
+};
+/**
+ * Request to branch a timeline.
+ */
+export type BranchTimelineRequest = {
+    /**
+     * Explicit id (UUID) for the new branch timeline; server-generated when
+     * omitted.
+     */
+    new_timeline_id?: string | null;
+    /**
+     * LSN to branch at; `0` (the default) branches at the latest recoverable
+     * point.
+     */
+    branch_lsn?: number;
+};
+/**
+ * A created branch, routed and ready.
+ */
+export type BranchTimelineResponse = {
+    /**
+     * The new branch timeline id.
+     */
+    timeline_id: string;
+    /**
+     * The timeline the branch was taken from.
+     */
+    parent_timeline_id: string;
+    /**
+     * LSN the branch was taken at (`0` = latest).
+     */
+    branch_lsn: number;
+    endpoint: BranchTimelineEndpoint;
+    /**
+     * Always `ready` on success.
+     */
+    status: string;
+};
 /**
  * Plan allowances.
  */
@@ -187,6 +231,146 @@ export type ComputeDeployRequest = {
 export type ComputeStat = {
     hours_used: number;
 };
+/**
+ * Request body for creating a Computer.
+ */
+export type ComputerCreateRequest = {
+    /**
+     * Lowercase DNS label, max 63 characters. Unique per account.
+     */
+    name: string;
+    /**
+     * Guest image. `ubuntu24` is the only image available today.
+     */
+    image?: string | null;
+    resources?: null | ComputerResources;
+    /**
+     * OpenSSH public keys authorised for `root`, one per array entry, max 32.
+     * Optional — `exec` and the browser terminal work without one. Send the
+     * public half only (the `.pub` file); a private key is rejected.
+     */
+    ssh_keys?: Array<string> | null;
+};
+/**
+ * Request body for running a command inside a Computer.
+ */
+export type ComputerExecRequest = {
+    command: string;
+    args?: Array<string> | null;
+    /**
+     * Working directory inside the guest.
+     */
+    cwd?: string | null;
+    env?: {
+        [key: string]: unknown;
+    };
+    /**
+     * 1000..600000, default 60000.
+     */
+    timeout_ms?: number | null;
+};
+/**
+ * Result of a command executed inside a Computer.
+ */
+export type ComputerExecResult = {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+};
+/**
+ * One file read out of a Computer.
+ */
+export type ComputerFileRead = {
+    exists: boolean;
+    /**
+     * Base64-encoded contents. Empty when `exists` is false.
+     */
+    content_b64: string;
+    /**
+     * Size in bytes, as a string.
+     */
+    size: string;
+};
+/**
+ * One file to write into a Computer.
+ */
+export type ComputerFileWrite = {
+    path: string;
+    /**
+     * Base64-encoded contents.
+     */
+    content_b64: string;
+    /**
+     * Unix mode, default 0644.
+     */
+    mode?: number | null;
+};
+/**
+ * A Computer as returned by create/get/list.
+ */
+export type ComputerInfo = {
+    id: string;
+    name: string;
+    image: string;
+    /**
+     * CREATING | RUNNING | STOPPING | STOPPED | STARTING | DELETING | FAILED
+     */
+    status: string;
+    /**
+     * Human-readable reason for the current status (set on FAILED).
+     */
+    statusReason?: string | null;
+    /**
+     * Private address inside your network. Reserved for the Computer's
+     * lifetime — the same address comes back after a stop/start.
+     */
+    ipAddress?: string | null;
+    vcpus: number;
+    memoryMb: number;
+    diskGb: number;
+    /**
+     * The OpenSSH public keys currently authorised for `root`. Public halves
+     * only — there is nothing secret to withhold here, and being able to read
+     * back what is installed is how you confirm a revocation took.
+     */
+    sshKeys?: Array<string>;
+    createdAt: string;
+    updatedAt: string;
+};
+/**
+ * Resource shape for a Computer. Fixed at create in v1 — disks do not grow.
+ */
+export type ComputerResources = {
+    /**
+     * 1..16
+     */
+    vcpus?: number | null;
+    /**
+     * 512..32768
+     */
+    memory_mb?: number | null;
+    /**
+     * 5..200. Billed per GB-month for as long as the Computer exists,
+     * running or stopped.
+     */
+    disk_gb?: number | null;
+};
+/**
+ * Request body for replacing a Computer's authorised ssh keys.
+ */
+export type ComputerSshKeysRequest = {
+    /**
+     * The complete list, max 32. Not a patch: whatever you send becomes the
+     * whole of `authorized_keys`, and an empty array removes every key.
+     */
+    ssh_keys: Array<string>;
+};
+/**
+ * Request body for writing files into a Computer. Max 64 files per call.
+ */
+export type ComputerWriteFilesRequest = {
+    files: Array<ComputerFileWrite>;
+};
 /**
  * A recorded GDPR consent decision.
  */
@@ -202,6 +386,47 @@ export type CrawlerPolicy = {
     action: ShieldAction;
     rate_limit_per_min?: number | null;
 };
+/**
+ * Request to create a ScalixNova database.
+ */
+export type CreateDatabaseRequest = {
+    /**
+     * Display name, unique within the org.
+     */
+    name: string;
+    /**
+     * PostgreSQL major version: `"16"` (default), `"17"`, or `"18"`. Accepts a
+     * string or number. Fixed for the life of the database — branches and
+     * point-in-time restores keep this major. Unsupported values return 400
+     * listing the supported set.
+     */
+    pg_version?: string | null;
+    /**
+     * Isolation tier: `"shared"` (default) or `"dedicated"` (Firecracker
+     * microVM; PostgreSQL 16 only, returns 501 where the tier isn't
+     * provisioned).
+     */
+    isolation?: string | null;
+};
+/**
+ * Response from creating a database.
+ */
+export type CreateDatabaseResponse = {
+    id: string;
+    name: string;
+    pg_database: string;
+    tenant_id: string;
+    /**
+     * Postgres connection string (replace `YOUR_API_KEY` with an API key).
+     */
+    connection_string: string;
+    status: string;
+    isolation: string;
+    /**
+     * PostgreSQL major version the database was created on.
+     */
+    pg_version: string;
+};
 export type CreateGdprRequest = {
     subject_email: string;
     request_type: GdprRequestType;
@@ -298,6 +523,47 @@ export type DataSubjectRequest = {
     created_at: string;
     completed_at?: string | null;
 };
+/**
+ * A ScalixNova database record.
+ */
+export type DatabaseJson = {
+    /**
+     * Database id (UUID).
+     */
+    id: string;
+    /**
+     * Display name.
+     */
+    name: string;
+    /**
+     * Physical PostgreSQL database name (`db_<hex>`).
+     */
+    pg_database?: string | null;
+    /**
+     * Tenant id backing this database on the compute plane.
+     */
+    tenant_id?: string | null;
+    /**
+     * `active` or `deleting` (soft-deleted, inside the recovery grace window).
+     */
+    status: string;
+    /**
+     * RFC 3339 creation time.
+     */
+    created_at?: string | null;
+    /**
+     * Isolation tier: `shared` or `dedicated`.
+     */
+    isolation: string;
+    /**
+     * PostgreSQL major version this database runs (`16`, `17`, or `18`).
+     */
+    pg_version: string;
+    /**
+     * Soft-delete timestamp, when `status` is `deleting`.
+     */
+    deleted_at?: string | null;
+};
 export type DdosStats = {
     global_rps: number;
     tracked_ips: number;
@@ -546,6 +812,16 @@ export type KvSetRequest = {
      */
     ttl?: number | null;
 };
+/**
+ * Databases in the project.
+ */
+export type ListDatabasesResponse = {
+    databases: Array<DatabaseJson>;
+    /**
+     * Days a soft-deleted database stays restorable.
+     */
+    delete_grace_days?: number | null;
+};
 /**
  * Response for `GET /v1/domains` — all custom domains for the project.
  */
@@ -629,6 +905,111 @@ export type RecordConsentRequest = {
     granted: boolean;
 };
 export type RequestStatus = 'pending' | 'in_progress' | 'completed' | 'rejected';
+/**
+ * Request body for running a command inside a sandbox.
+ */
+export type SandboxCommandRequest = {
+    cmd: string;
+    args?: Array<string> | null;
+    /**
+     * Working directory inside the guest.
+     */
+    cwd?: string | null;
+    env?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Run without waiting for completion.
+     */
+    detached?: boolean | null;
+};
+/**
+ * Result of a synchronous command execution.
+ */
+export type SandboxCommandResult = {
+    exit_code: number;
+    stdout: string;
+    stderr: string;
+    duration_ms: number;
+};
+/**
+ * Request body for creating an ephemeral sandbox.
+ */
+export type SandboxCreateRequest = {
+    /**
+     * Runtime image. `node22` is available today; other values are rolling
+     * out and fail placement until their images ship.
+     */
+    runtime?: string | null;
+    /**
+     * Resource shape. Defaults: 1 vCPU, 512 MB memory, 5 GB disk.
+     */
+    resources?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Hard lifetime in milliseconds (60000..86400000, default 300000). The
+     * sandbox also stops earlier at its idle timeout.
+     */
+    timeout_ms?: number | null;
+    /**
+     * Guest ports to expose.
+     */
+    ports?: Array<number> | null;
+    /**
+     * `{type: "git", url, branch?}` clones a repository into the sandbox.
+     */
+    source?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Environment variables for the guest.
+     */
+    env?: {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Request body for extending a sandbox's hard deadline.
+ */
+export type SandboxExtendRequest = {
+    /**
+     * Milliseconds to add to the current expiry.
+     */
+    duration_ms: number;
+};
+/**
+ * A sandbox as returned by create/get/list.
+ */
+export type SandboxInfo = {
+    id: string;
+    runtime: string;
+    /**
+     * PROVISIONING | RUNNING | STOPPING | STOPPED | FAILED | EXPIRED
+     */
+    status: string;
+    /**
+     * Human-readable reason for the current status (set on FAILED and
+     * idle-stop transitions).
+     */
+    status_reason?: string | null;
+    vcpus: number;
+    memory_mb: number;
+    disk_gb: number;
+    expires_at: string;
+};
+/**
+ * Request body for writing files into a sandbox. Writable roots inside the
+ * guest are `/app`, `/scalix`, `/build`, and `/tmp`.
+ */
+export type SandboxWriteFilesRequest = {
+    /**
+     * Files to write: `[{path, content}]`.
+     */
+    files: Array<{
+        [key: string]: unknown;
+    }>;
+};
 export type ScopeConfig = {
     enabled?: boolean;
     /**
@@ -685,6 +1066,44 @@ export type SignUpRequest = {
     } | null;
     captcha_token?: string | null;
 };
+/**
+ * One column of a SQL result set.
+ */
+export type SqlColumnInfo = {
+    /**
+     * Column name.
+     */
+    name: string;
+    /**
+     * PostgreSQL type OID.
+     */
+    type_oid: number;
+    /**
+     * PostgreSQL type name.
+     */
+    type_name: string;
+};
+/**
+ * Per-query resource cost breakdown.
+ */
+export type SqlQueryCost = {
+    /**
+     * Compute time consumed, in milliseconds.
+     */
+    compute_ms: number;
+    /**
+     * Pages read to serve the query.
+     */
+    pages_read: number;
+    /**
+     * Bytes transferred to the client.
+     */
+    bytes_transferred: number;
+    /**
+     * Estimated cost in USD.
+     */
+    estimated_usd: number;
+};
 /**
  * A parameterized SQL query to execute against the tenant's database.
  */
@@ -701,13 +1120,15 @@ export type SqlRequest = {
     } | null;
 };
 /**
- * Result set returned by a SQL query.
+ * Result set returned by a SQL query. Matches the wire shape produced by
+ * `http.rs::SqlResponse` - `columns` entries are objects (name + Postgres
+ * type), not bare strings.
  */
 export type SqlResponse = {
     /**
-     * Column names, in result order.
+     * Result-set columns, in result order.
      */
-    columns: Array<string>;
+    columns: Array<SqlColumnInfo>;
     /**
      * Rows; each row is an array of cell values aligned to `columns`.
      */
@@ -718,10 +1139,18 @@ export type SqlResponse = {
      * Number of rows returned (or affected).
      */
     row_count: number;
+    /**
+     * The SQL command tag (e.g. `SELECT`, `INSERT`).
+     */
+    command: string;
     /**
      * Server-side execution time in milliseconds.
      */
     duration_ms: number;
+    /**
+     * Resource cost of this query.
+     */
+    cost: SqlQueryCost;
 };
 /**
  * Response for `GET /v1/user/stats`.
@@ -1503,6 +1932,10 @@ export type RestorePitrErrors = {
      * Missing or invalid API key
      */
     401: ErrorResponse;
+    /**
+     * Recovery target is beyond the archived WAL — retry with an earlier target, or omit the target to restore the latest recoverable point
+     */
+    409: ErrorResponse;
     /**
      * Internal error
      */
@@ -1565,6 +1998,55 @@ export type RealtimeWebsocketErrors = {
     500: ErrorResponse;
 };
 export type RealtimeWebsocketError = RealtimeWebsocketErrors[keyof RealtimeWebsocketErrors];
+export type BranchTimelineData = {
+    body: BranchTimelineRequest;
+    path: {
+        /**
+         * Tenant id (UUID)
+         */
+        tenant_id: string;
+        /**
+         * Parent timeline id (UUID), or `main` for the primary timeline
+         */
+        timeline_id: string;
+    };
+    query?: never;
+    url: '/api/v1/tenants/{tenant_id}/timelines/{timeline_id}/branch';
+};
+export type BranchTimelineErrors = {
+    /**
+     * Invalid tenant, timeline, or new_timeline_id
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Branch LSN is beyond the archived WAL
+     */
+    409: ErrorResponse;
+    /**
+     * Internal error
+     */
+    500: ErrorResponse;
+    /**
+     * Durability is not configured for this deployment
+     */
+    501: ErrorResponse;
+    /**
+     * No compute capacity for the branch worker
+     */
+    503: ErrorResponse;
+};
+export type BranchTimelineError = BranchTimelineErrors[keyof BranchTimelineErrors];
+export type BranchTimelineResponses = {
+    /**
+     * Branch created and routed
+     */
+    201: BranchTimelineResponse;
+};
+export type BranchTimelineResponse2 = BranchTimelineResponses[keyof BranchTimelineResponses];
 export type BatchUpsertVectorsData = {
     body: VectorUpsertRequest;
     path: {
@@ -4019,17 +4501,343 @@ export type ListDeploymentVersionsErrors = {
      */
     401: ErrorResponse;
     /**
-     * Internal error
+     * Internal error
+     */
+    500: ErrorResponse;
+};
+export type ListDeploymentVersionsError = ListDeploymentVersionsErrors[keyof ListDeploymentVersionsErrors];
+export type ListDeploymentVersionsResponses = {
+    /**
+     * Deployment versions
+     */
+    200: unknown;
+};
+export type ComputerListData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/computers';
+};
+export type ComputerListErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+export type ComputerListError = ComputerListErrors[keyof ComputerListErrors];
+export type ComputerListResponses = {
+    /**
+     * Your Computers, newest first
+     */
+    200: Array<ComputerInfo>;
+};
+export type ComputerListResponse = ComputerListResponses[keyof ComputerListResponses];
+export type ComputerCreateData = {
+    body: ComputerCreateRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/computers';
+};
+export type ComputerCreateErrors = {
+    /**
+     * Invalid name or resource shape
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Credit exhausted or plan limit reached
+     */
+    402: ErrorResponse;
+    /**
+     * A Computer with that name already exists
+     */
+    409: ErrorResponse;
+    /**
+     * No host has capacity for the requested resources
+     */
+    503: ErrorResponse;
+};
+export type ComputerCreateError = ComputerCreateErrors[keyof ComputerCreateErrors];
+export type ComputerCreateResponses = {
+    /**
+     * Computer created (initially CREATING)
+     */
+    201: ComputerInfo;
+};
+export type ComputerCreateResponse = ComputerCreateResponses[keyof ComputerCreateResponses];
+export type ComputerGetOrCreateByNameData = {
+    body: ComputerCreateRequest;
+    path: {
+        /**
+         * Lowercase DNS label, max 63 characters
+         */
+        name: string;
+    };
+    query?: never;
+    url: '/v1/computers/by-name/{name}';
+};
+export type ComputerGetOrCreateByNameErrors = {
+    /**
+     * Invalid name or resource shape
+     */
+    400: ErrorResponse;
+    /**
+     * No host has capacity for the requested resources
+     */
+    503: ErrorResponse;
+};
+export type ComputerGetOrCreateByNameError = ComputerGetOrCreateByNameErrors[keyof ComputerGetOrCreateByNameErrors];
+export type ComputerGetOrCreateByNameResponses = {
+    /**
+     * The existing Computer
+     */
+    200: ComputerInfo;
+    /**
+     * Computer created
+     */
+    201: ComputerInfo;
+};
+export type ComputerGetOrCreateByNameResponse = ComputerGetOrCreateByNameResponses[keyof ComputerGetOrCreateByNameResponses];
+export type ComputerDeleteData = {
+    body?: never;
+    path: {
+        /**
+         * Computer id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/computers/{id}';
+};
+export type ComputerDeleteErrors = {
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+};
+export type ComputerDeleteError = ComputerDeleteErrors[keyof ComputerDeleteErrors];
+export type ComputerDeleteResponses = {
+    /**
+     * Computer and its disk deleted
+     */
+    204: void;
+};
+export type ComputerDeleteResponse = ComputerDeleteResponses[keyof ComputerDeleteResponses];
+export type ComputerGetData = {
+    body?: never;
+    path: {
+        /**
+         * Computer id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/computers/{id}';
+};
+export type ComputerGetErrors = {
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+};
+export type ComputerGetError = ComputerGetErrors[keyof ComputerGetErrors];
+export type ComputerGetResponses = {
+    /**
+     * The Computer
+     */
+    200: ComputerInfo;
+};
+export type ComputerGetResponse = ComputerGetResponses[keyof ComputerGetResponses];
+export type ComputerExecData = {
+    body: ComputerExecRequest;
+    path: {
+        /**
+         * Computer id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/computers/{id}/exec';
+};
+export type ComputerExecErrors = {
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+    /**
+     * The Computer is not RUNNING
+     */
+    409: ErrorResponse;
+};
+export type ComputerExecError = ComputerExecErrors[keyof ComputerExecErrors];
+export type ComputerExecResponses = {
+    /**
+     * Command finished
+     */
+    200: ComputerExecResult;
+};
+export type ComputerExecResponse = ComputerExecResponses[keyof ComputerExecResponses];
+export type ComputerReadFileData = {
+    body?: never;
+    path: {
+        /**
+         * Computer id
+         */
+        id: string;
+    };
+    query: {
+        /**
+         * Absolute path inside the guest
+         */
+        path: string;
+    };
+    url: '/v1/computers/{id}/files';
+};
+export type ComputerReadFileErrors = {
+    /**
+     * Missing `path` query parameter
+     */
+    400: ErrorResponse;
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+    /**
+     * The Computer is not RUNNING
+     */
+    409: ErrorResponse;
+};
+export type ComputerReadFileError = ComputerReadFileErrors[keyof ComputerReadFileErrors];
+export type ComputerReadFileResponses = {
+    /**
+     * File contents, base64-encoded
+     */
+    200: ComputerFileRead;
+};
+export type ComputerReadFileResponse = ComputerReadFileResponses[keyof ComputerReadFileResponses];
+export type ComputerWriteFilesData = {
+    body: ComputerWriteFilesRequest;
+    path: {
+        /**
+         * Computer id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/computers/{id}/files';
+};
+export type ComputerWriteFilesErrors = {
+    /**
+     * No files, or more than 64
+     */
+    400: ErrorResponse;
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+    /**
+     * The Computer is not RUNNING
+     */
+    409: ErrorResponse;
+};
+export type ComputerWriteFilesError = ComputerWriteFilesErrors[keyof ComputerWriteFilesErrors];
+export type ComputerWriteFilesResponses = {
+    /**
+     * Files written
+     */
+    204: void;
+};
+export type ComputerWriteFilesResponse = ComputerWriteFilesResponses[keyof ComputerWriteFilesResponses];
+export type ComputerSetSshKeysData = {
+    body: ComputerSshKeysRequest;
+    path: {
+        /**
+         * Computer id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/computers/{id}/ssh-keys';
+};
+export type ComputerSetSshKeysErrors = {
+    /**
+     * Not an OpenSSH public key, or more than 32
+     */
+    400: ErrorResponse;
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+    /**
+     * The keys could not be delivered to the running machine
+     */
+    502: ErrorResponse;
+};
+export type ComputerSetSshKeysError = ComputerSetSshKeysErrors[keyof ComputerSetSshKeysErrors];
+export type ComputerSetSshKeysResponses = {
+    /**
+     * The Computer, with the new key list
+     */
+    200: ComputerInfo;
+};
+export type ComputerSetSshKeysResponse = ComputerSetSshKeysResponses[keyof ComputerSetSshKeysResponses];
+export type ComputerStartData = {
+    body?: never;
+    path: {
+        /**
+         * Computer id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/computers/{id}/start';
+};
+export type ComputerStartErrors = {
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+    /**
+     * The Computer's host is unavailable
+     */
+    503: ErrorResponse;
+};
+export type ComputerStartError = ComputerStartErrors[keyof ComputerStartErrors];
+export type ComputerStartResponses = {
+    /**
+     * The Computer, now RUNNING
+     */
+    200: ComputerInfo;
+};
+export type ComputerStartResponse = ComputerStartResponses[keyof ComputerStartResponses];
+export type ComputerStopData = {
+    body?: never;
+    path: {
+        /**
+         * Computer id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/computers/{id}/stop';
+};
+export type ComputerStopErrors = {
+    /**
+     * Not found
      */
-    500: ErrorResponse;
+    404: ErrorResponse;
 };
-export type ListDeploymentVersionsError = ListDeploymentVersionsErrors[keyof ListDeploymentVersionsErrors];
-export type ListDeploymentVersionsResponses = {
+export type ComputerStopError = ComputerStopErrors[keyof ComputerStopErrors];
+export type ComputerStopResponses = {
     /**
-     * Deployment versions
+     * The Computer, now STOPPED
      */
-    200: unknown;
+    200: ComputerInfo;
 };
+export type ComputerStopResponse = ComputerStopResponses[keyof ComputerStopResponses];
 export type ListCronSchedulesData = {
     body?: never;
     path?: never;
@@ -4226,6 +5034,167 @@ export type TriggerCronScheduleResponses = {
      */
     200: unknown;
 };
+export type ListDatabasesData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Also return soft-deleted databases restorable within the grace window
+         */
+        include_deleted?: boolean;
+    };
+    url: '/v1/databases';
+};
+export type ListDatabasesErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+export type ListDatabasesError = ListDatabasesErrors[keyof ListDatabasesErrors];
+export type ListDatabasesResponses = {
+    /**
+     * Databases in the project
+     */
+    200: ListDatabasesResponse;
+};
+export type ListDatabasesResponse2 = ListDatabasesResponses[keyof ListDatabasesResponses];
+export type CreateDatabaseData = {
+    body: CreateDatabaseRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/databases';
+};
+export type CreateDatabaseErrors = {
+    /**
+     * Invalid name, isolation, or pg_version (message lists the supported versions)
+     */
+    400: ErrorResponse;
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * A database with this name already exists in the org
+     */
+    409: ErrorResponse;
+    /**
+     * Dedicated tier not provisionable on this deployment
+     */
+    501: ErrorResponse;
+};
+export type CreateDatabaseError = CreateDatabaseErrors[keyof CreateDatabaseErrors];
+export type CreateDatabaseResponses = {
+    /**
+     * Database created
+     */
+    201: CreateDatabaseResponse;
+};
+export type CreateDatabaseResponse2 = CreateDatabaseResponses[keyof CreateDatabaseResponses];
+export type ProvisionDatabaseData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/databases/provision';
+};
+export type ProvisionDatabaseErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+export type ProvisionDatabaseError = ProvisionDatabaseErrors[keyof ProvisionDatabaseErrors];
+export type ProvisionDatabaseResponses = {
+    /**
+     * Connection info for the project's default database
+     */
+    200: unknown;
+};
+export type DeleteDatabaseData = {
+    body?: never;
+    path: {
+        /**
+         * Database id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/databases/{id}';
+};
+export type DeleteDatabaseErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Database not found
+     */
+    404: ErrorResponse;
+};
+export type DeleteDatabaseError = DeleteDatabaseErrors[keyof DeleteDatabaseErrors];
+export type DeleteDatabaseResponses = {
+    /**
+     * Database scheduled for deletion
+     */
+    200: unknown;
+};
+export type GetDatabaseData = {
+    body?: never;
+    path: {
+        /**
+         * Database id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/databases/{id}';
+};
+export type GetDatabaseErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Database not found
+     */
+    404: ErrorResponse;
+};
+export type GetDatabaseError = GetDatabaseErrors[keyof GetDatabaseErrors];
+export type GetDatabaseResponses = {
+    /**
+     * The database
+     */
+    200: DatabaseJson;
+};
+export type GetDatabaseResponse = GetDatabaseResponses[keyof GetDatabaseResponses];
+export type RestoreDatabaseData = {
+    body?: never;
+    path: {
+        /**
+         * Database id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/databases/{id}/restore';
+};
+export type RestoreDatabaseErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Database not found or past the grace window
+     */
+    404: ErrorResponse;
+};
+export type RestoreDatabaseError = RestoreDatabaseErrors[keyof RestoreDatabaseErrors];
+export type RestoreDatabaseResponses = {
+    /**
+     * Database restored to active
+     */
+    200: unknown;
+};
 export type ListDomainsData = {
     body?: never;
     path?: never;
@@ -6226,6 +7195,232 @@ export type RollbackServiceResponses = {
      */
     200: unknown;
 };
+export type SandboxListData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/sandboxes';
+};
+export type SandboxListErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+};
+export type SandboxListError = SandboxListErrors[keyof SandboxListErrors];
+export type SandboxListResponses = {
+    /**
+     * `{sandboxes: [...], total}`
+     */
+    200: unknown;
+};
+export type SandboxCreateData = {
+    body: SandboxCreateRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/sandboxes';
+};
+export type SandboxCreateErrors = {
+    /**
+     * Missing or invalid API key
+     */
+    401: ErrorResponse;
+    /**
+     * Credit exhausted or plan limit reached
+     */
+    402: ErrorResponse;
+    /**
+     * No capacity for the requested resources
+     */
+    503: ErrorResponse;
+};
+export type SandboxCreateError = SandboxCreateErrors[keyof SandboxCreateErrors];
+export type SandboxCreateResponses = {
+    /**
+     * Sandbox created (initially PROVISIONING)
+     */
+    201: SandboxInfo;
+};
+export type SandboxCreateResponse = SandboxCreateResponses[keyof SandboxCreateResponses];
+export type SandboxDeleteData = {
+    body?: never;
+    path: {
+        /**
+         * Sandbox id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/sandboxes/{id}';
+};
+export type SandboxDeleteErrors = {
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+};
+export type SandboxDeleteError = SandboxDeleteErrors[keyof SandboxDeleteErrors];
+export type SandboxDeleteResponses = {
+    /**
+     * Deleted
+     */
+    204: void;
+};
+export type SandboxDeleteResponse = SandboxDeleteResponses[keyof SandboxDeleteResponses];
+export type SandboxGetData = {
+    body?: never;
+    path: {
+        /**
+         * Sandbox id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/sandboxes/{id}';
+};
+export type SandboxGetErrors = {
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+};
+export type SandboxGetError = SandboxGetErrors[keyof SandboxGetErrors];
+export type SandboxGetResponses = {
+    /**
+     * Sandbox details
+     */
+    200: SandboxInfo;
+};
+export type SandboxGetResponse = SandboxGetResponses[keyof SandboxGetResponses];
+export type SandboxRunCommandData = {
+    body: SandboxCommandRequest;
+    path: {
+        /**
+         * Sandbox id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/sandboxes/{id}/commands';
+};
+export type SandboxRunCommandErrors = {
+    /**
+     * Sandbox is not running
+     */
+    400: ErrorResponse;
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+};
+export type SandboxRunCommandError = SandboxRunCommandErrors[keyof SandboxRunCommandErrors];
+export type SandboxRunCommandResponses = {
+    /**
+     * Command result
+     */
+    200: SandboxCommandResult;
+};
+export type SandboxRunCommandResponse = SandboxRunCommandResponses[keyof SandboxRunCommandResponses];
+export type SandboxExtendData = {
+    body: SandboxExtendRequest;
+    path: {
+        /**
+         * Sandbox id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/sandboxes/{id}/extend';
+};
+export type SandboxExtendErrors = {
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+};
+export type SandboxExtendError = SandboxExtendErrors[keyof SandboxExtendErrors];
+export type SandboxExtendResponses = {
+    /**
+     * Updated sandbox
+     */
+    200: SandboxInfo;
+};
+export type SandboxExtendResponse = SandboxExtendResponses[keyof SandboxExtendResponses];
+export type SandboxWriteFilesData = {
+    body: SandboxWriteFilesRequest;
+    path: {
+        /**
+         * Sandbox id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/sandboxes/{id}/files';
+};
+export type SandboxWriteFilesErrors = {
+    /**
+     * Not found
+     */
+    404: ErrorResponse;
+    /**
+     * Path outside the allowed guest roots
+     */
+    502: ErrorResponse;
+};
+export type SandboxWriteFilesError = SandboxWriteFilesErrors[keyof SandboxWriteFilesErrors];
+export type SandboxWriteFilesResponses = {
+    /**
+     * Files written
+     */
+    204: void;
+};
+export type SandboxWriteFilesResponse = SandboxWriteFilesResponses[keyof SandboxWriteFilesResponses];
+export type SandboxReadFileData = {
+    body?: never;
+    path: {
+        /**
+         * Sandbox id
+         */
+        id: string;
+        /**
+         * Guest file path, e.g. `app/output.json`
+         */
+        path: string;
+    };
+    query?: never;
+    url: '/v1/sandboxes/{id}/files/{path}';
+};
+export type SandboxReadFileErrors = {
+    /**
+     * File or sandbox not found
+     */
+    404: ErrorResponse;
+};
+export type SandboxReadFileError = SandboxReadFileErrors[keyof SandboxReadFileErrors];
+export type SandboxReadFileResponses = {
+    /**
+     * File content (application/octet-stream)
+     */
+    200: unknown;
+};
+export type SandboxSnapshotData = {
+    body?: never;
+    path: {
+        /**
+         * Sandbox id
+         */
+        id: string;
+    };
+    query?: never;
+    url: '/v1/sandboxes/{id}/snapshot';
+};
+export type SandboxSnapshotErrors = {
+    /**
+     * Snapshots are not available for ephemeral sandboxes
+     */
+    501: ErrorResponse;
+};
+export type SandboxSnapshotError = SandboxSnapshotErrors[keyof SandboxSnapshotErrors];
 export type SearchIndexData = {
     body?: never;
     path?: never;