palbase 0.37.2 → 0.39.0

package/types/internal/src/modules/machines.d.ts

@@ -160,9 +160,9 @@ export type Machine = {
      */
     running_version: number;
     /**
-     * The machine's size. A shared size has a fraction of a CPU as its ceiling and is put to sleep when it is idle; a dedicated size has whole CPUs of its own and never sleeps. shared-256: 0.2 vCPU, 256 MiB; shared-512: 0.5 vCPU, 512 MiB; shared-1024: 1 vCPU, 1024 MiB; dedicated-1x: 1 vCPU, 2048 MiB; dedicated-2x: 2 vCPU, 4096 MiB.
+     * The machine's size. shared-256 has a fraction of a CPU as its ceiling and is put to sleep when it is idle; a standard size never sleeps — its CPUs are its ceiling, a quarter of them reserved for it, the rest its node's when the other machines there leave them; a dedicated size has whole CPUs of its own and never sleeps. shared-256: 0.2 vCPU, 256 MiB (free); starter: 0.5 vCPU, 512 MiB; standard-1x: 1 vCPU, 2048 MiB; standard-2x: 2 vCPU, 4096 MiB; standard-4x: 4 vCPU, 8192 MiB; dedicated-1x: 1 vCPU of its own, 2048 MiB; dedicated-2x: 2 vCPU of its own, 4096 MiB. GET /machines/sizes lists each with its price. shared-512 and shared-1024 are retired: a machine that has one keeps it until it is moved to another size; none is opened at or moved to one.
      */
-    size: "dedicated-1x" | "dedicated-2x" | "shared-1024" | "shared-256" | "shared-512";
+    size: "dedicated-1x" | "dedicated-2x" | "shared-1024" | "shared-256" | "shared-512" | "standard-1x" | "standard-2x" | "standard-4x" | "starter";
     /**
      * building: no build of it runs yet (its first is on its way — waiting for its commit's checks too — or failed: `state_reason`); starting: on its way up; awake: answering; asleep: idle, and woken by the next request to its address; failed: it cannot start, or its first build failed or was skipped (`state_reason` says why).
      */
@@ -268,6 +268,11 @@ export type Machine = {
     contract_error?: string;
     environment?: EnvironmentRef;
     moving_to?: EnvironmentRef;
+    moved_from?: EnvironmentRef;
+    /**
+     * The addresses the machine had in the environments of its project it was bound to before it moved: it answers at them too, for good (the user's call of 2026-11-02).
+     */
+    former_urls?: string[];
 };
 /**
  * A machine to open.
@@ -282,9 +287,9 @@ export type MachineCreate = {
      */
     port?: number;
     /**
-     * The machine's size. A shared size has a fraction of a CPU as its ceiling and is put to sleep when it is idle; a dedicated size has whole CPUs of its own and never sleeps. shared-256: 0.2 vCPU, 256 MiB; shared-512: 0.5 vCPU, 512 MiB; shared-1024: 1 vCPU, 1024 MiB; dedicated-1x: 1 vCPU, 2048 MiB; dedicated-2x: 2 vCPU, 4096 MiB.
+     * The machine's size. shared-256 has a fraction of a CPU as its ceiling and is put to sleep when it is idle; a standard size never sleeps — its CPUs are its ceiling, a quarter of them reserved for it, the rest its node's when the other machines there leave them; a dedicated size has whole CPUs of its own and never sleeps. shared-256: 0.2 vCPU, 256 MiB (free); starter: 0.5 vCPU, 512 MiB; standard-1x: 1 vCPU, 2048 MiB; standard-2x: 2 vCPU, 4096 MiB; standard-4x: 4 vCPU, 8192 MiB; dedicated-1x: 1 vCPU of its own, 2048 MiB; dedicated-2x: 2 vCPU of its own, 4096 MiB. GET /machines/sizes lists each with its price.
      */
-    size: "dedicated-1x" | "dedicated-2x" | "shared-1024" | "shared-256" | "shared-512";
+    size: "dedicated-1x" | "dedicated-2x" | "shared-256" | "standard-1x" | "standard-2x" | "standard-4x" | "starter";
     /**
      * What the machine is started with in its environment, besides what the platform sets: PORT (where it listens), PALBASE_URL (its project's address, https://<ref>.<domain>), PALBASE_PROJECT_ID, PALBASE_REPLICAS (how many copies of it run) and, given a database, PALBASE_DB_URL and PALBASE_DB_CONNECTIONS (how many connections to it a copy may hold). PORT is refused here; the others, given here or among the machine's secrets, give way to the platform's. Names are environment variable names; 100 variables and 64 KiB at most. Keep secrets in the project's secrets and start the machine with them (`secrets`).
      */
@@ -350,7 +355,7 @@ export type MachineCreate = {
      */
     commit?: string;
     /**
-     * The ref of the project's environment the machine is bound to (environment_not_found for one the caller does not reach: an environment's own token or key makes what is bound to its environment alone). None: the environment called. Its name is the project's one: name_taken when another environment holds a machine of that name.
+     * The ref of the environment called, when given: a new machine is bound to the environment whose address it is made at (409 bound_to_environment for another — make it at that environment's address). Its name is the project's one: name_taken when another environment holds a machine of that name.
      */
     environment?: string;
 };
@@ -379,9 +384,9 @@ export type MachineUpdate = {
      */
     port?: number;
     /**
-     * The machine's size. A shared size has a fraction of a CPU as its ceiling and is put to sleep when it is idle; a dedicated size has whole CPUs of its own and never sleeps. shared-256: 0.2 vCPU, 256 MiB; shared-512: 0.5 vCPU, 512 MiB; shared-1024: 1 vCPU, 1024 MiB; dedicated-1x: 1 vCPU, 2048 MiB; dedicated-2x: 2 vCPU, 4096 MiB.
+     * The machine's size. shared-256 has a fraction of a CPU as its ceiling and is put to sleep when it is idle; a standard size never sleeps — its CPUs are its ceiling, a quarter of them reserved for it, the rest its node's when the other machines there leave them; a dedicated size has whole CPUs of its own and never sleeps. shared-256: 0.2 vCPU, 256 MiB (free); starter: 0.5 vCPU, 512 MiB; standard-1x: 1 vCPU, 2048 MiB; standard-2x: 2 vCPU, 4096 MiB; standard-4x: 4 vCPU, 8192 MiB; dedicated-1x: 1 vCPU of its own, 2048 MiB; dedicated-2x: 2 vCPU of its own, 4096 MiB. GET /machines/sizes lists each with its price.
      */
-    size?: "dedicated-1x" | "dedicated-2x" | "shared-1024" | "shared-256" | "shared-512";
+    size?: "dedicated-1x" | "dedicated-2x" | "shared-256" | "standard-1x" | "standard-2x" | "standard-4x" | "starter";
     /**
      * Replaces the machine's environment whole, besides PORT. Names are environment variable names; 100 variables and 64 KiB at most. Keep secrets in the project's secrets and start the machine with them (`secrets`).
      */
@@ -506,9 +511,9 @@ export type Database = {
      */
     pooled_port: number;
     /**
-     * The database's size. free: 0.25 vCPU, 512 MiB, 1 GB, put to sleep when idle (woken by the next connection in about 10 s), awake 400 hours a month at most, archived after a week asleep (its next connection brings it back from its backup); hobby: 0.25 vCPU, 512 MiB, 5 GB, put to sleep when idle, no monthly limit; shared-1g: 1 GiB, up to 1 vCPU, 10 GB; shared-2g: 2 GiB, up to 2 vCPU, 25 GB; shared-4g: 4 GiB, up to 2 vCPU, 50 GB; dedicated-1x: 1 vCPU of its own, 4 GiB, 25 GB; dedicated-2x: 2 vCPU of its own, 8 GiB, 50 GB. The shared and dedicated sizes never sleep and live on a Premium SSD v2 disk of their own; free and hobby on the platform's SAN. A database past its size's storage turns read-only. What a project's machines and databases reserve between them is held to its limit: a size that does not fit is refused (409 `machines_over_limit`). preview: a machine's pull request preview's own database — 0.25 vCPU, 512 MiB, 500 MB, put to sleep when idle — opened with its preview and deleted with it; no database is opened at or moved to it.
+     * The database's size. free: 0.25 vCPU, 512 MiB, 1 GB, put to sleep when idle (woken by the next connection in about 10 s), awake 400 hours a month at most, archived after a week asleep (its next connection brings it back from its backup); hobby: 0.25 vCPU, 512 MiB, 5 GB, put to sleep when idle, no monthly limit; starter: 1 GiB, up to 0.5 vCPU, 10 GB; standard-1x: 2 GiB, up to 1 vCPU, 25 GB; standard-2x: 4 GiB, up to 2 vCPU, 50 GB (a quarter of their CPU reserved for them); dedicated-1x: 1 vCPU of its own, 4 GiB, 25 GB; dedicated-2x: 2 vCPU of its own, 8 GiB, 50 GB. The standard and dedicated sizes never sleep and live on a Premium SSD v2 disk of their own; free and hobby on the platform's SAN. A database past its size's storage turns read-only. What a project's machines and databases reserve between them is held to its limit: a size that does not fit is refused (409 `machines_over_limit`). preview: a machine's pull request preview's own database — 0.25 vCPU, 512 MiB, 500 MB, put to sleep when idle — opened with its preview and deleted with it; no database is opened at or moved to it. shared-1g, shared-2g and shared-4g are retired: a database that has one keeps it until it moves to another size; none is opened at or moved to one.
      */
-    size: "dedicated-1x" | "dedicated-2x" | "free" | "hobby" | "preview" | "shared-1g" | "shared-2g" | "shared-4g";
+    size: "dedicated-1x" | "dedicated-2x" | "free" | "hobby" | "preview" | "shared-1g" | "shared-2g" | "shared-4g" | "standard-1x" | "standard-2x" | "starter";
     /**
      * Where its data lives, as its size says: san, the platform's SAN; premium, a Premium SSD v2 disk of its own.
      */
@@ -576,6 +581,15 @@ export type Database = {
      */
     traffic_limit_bytes?: number;
     environment?: EnvironmentRef;
+    moving_to?: EnvironmentRef;
+    /**
+     * Why the database's last move to another environment was not made, when it was not: the environment it was moving to holds a database of its name by then, or is gone.
+     */
+    move_note?: string;
+    /**
+     * The hosts the database had in the environments of its project it was bound to before it moved: it answers at them too, for good (the user's call of 2026-11-02).
+     */
+    former_hosts?: string[];
 };
 /**
  * A page of a project's databases, by name.
@@ -596,9 +610,9 @@ export type DatabaseCreate = {
      */
     name?: string;
     /**
-     * The database's size; `free` when left out. free: 0.25 vCPU, 512 MiB, 1 GB, put to sleep when idle (woken by the next connection in about 10 s), awake 400 hours a month at most, archived after a week asleep (its next connection brings it back from its backup); hobby: 0.25 vCPU, 512 MiB, 5 GB, put to sleep when idle, no monthly limit; shared-1g: 1 GiB, up to 1 vCPU, 10 GB; shared-2g: 2 GiB, up to 2 vCPU, 25 GB; shared-4g: 4 GiB, up to 2 vCPU, 50 GB; dedicated-1x: 1 vCPU of its own, 4 GiB, 25 GB; dedicated-2x: 2 vCPU of its own, 8 GiB, 50 GB. The shared and dedicated sizes never sleep and live on a Premium SSD v2 disk of their own; free and hobby on the platform's SAN. A database past its size's storage turns read-only. What a project's machines and databases reserve between them is held to its limit: a size that does not fit is refused (409 `machines_over_limit`).
+     * The database's size; `free` when left out. free: 0.25 vCPU, 512 MiB, 1 GB, put to sleep when idle (woken by the next connection in about 10 s), awake 400 hours a month at most, archived after a week asleep (its next connection brings it back from its backup); hobby: 0.25 vCPU, 512 MiB, 5 GB, put to sleep when idle, no monthly limit; starter: 1 GiB, up to 0.5 vCPU, 10 GB; standard-1x: 2 GiB, up to 1 vCPU, 25 GB; standard-2x: 4 GiB, up to 2 vCPU, 50 GB (a quarter of their CPU reserved for them); dedicated-1x: 1 vCPU of its own, 4 GiB, 25 GB; dedicated-2x: 2 vCPU of its own, 8 GiB, 50 GB. The standard and dedicated sizes never sleep and live on a Premium SSD v2 disk of their own; free and hobby on the platform's SAN. A database past its size's storage turns read-only. What a project's machines and databases reserve between them is held to its limit: a size that does not fit is refused (409 `machines_over_limit`).
      */
-    size?: "dedicated-1x" | "dedicated-2x" | "free" | "hobby" | "shared-1g" | "shared-2g" | "shared-4g";
+    size?: "dedicated-1x" | "dedicated-2x" | "free" | "hobby" | "standard-1x" | "standard-2x" | "starter";
     /**
      * Who may connect, as addresses or CIDRs (203.0.113.7, 203.0.113.0/24), 50 at most; anyone with the password when empty.
      */
@@ -608,7 +622,7 @@ export type DatabaseCreate = {
      */
     backup_days?: number;
     /**
-     * The ref of the project's environment the database is bound to (environment_not_found for one the caller does not reach: an environment's own token or key makes what is bound to its environment alone). None: the environment called. Its name is the project's one: name_taken when another environment holds a database of that name.
+     * The ref of the environment called, when given: a new database is bound to the environment whose address it is made at (409 bound_to_environment for another — make it at that environment's address). Its name is the project's one: name_taken when another environment holds a database of that name.
      */
     environment?: string;
 };
@@ -627,7 +641,7 @@ export type DatabaseUpdate = {
     /**
      * The database's size (see `Database.size`); one that is paid for is open to the platform's own project and those named for it alone, as it is opened (403 `size_not_available`). One of the same machine and disk and no larger volume — hobby to free — changes in place. Any other moves through an instance of the new size beside the one that serves, made where the new size lives (a disk of its own, or a SAN volume of its own), which then takes over: the database serves on meanwhile (`state` resizing); its sessions on the direct port end once, when its primary moves, and new logins and transactions wait a few seconds for it. One asleep is woken for its move — its awake hours or disk traffic spent or not, when the size it moves to has no such limit; to one whose it has spent, it sleeps — and the move's time counts against none of them. One down for want of room, moved to a size of a larger volume, is given that room first, in place, and moves once it serves. A move that has not come to its switchover within two hours, and a second for every 10 MB the database holds, is let go: the database stays its size, and `state_reason` says why until its size is changed again — as is one whose primary went down three times before it came to its switchover. One whose primary moves where the move did not ask is stopped, both its instances kept (`state_reason`); onto its instance of the new size, ready — as a node drained moves it — it has come to its switchover. One whose instance of the new size does not take over within five minutes of its switchover says so in `state_reason`, and moves on once it does. Its disk never shrinks. While it moves it serves with the connections of the one of the two sizes that takes fewer; the machines given it are rolled out to their share of the new size's — at once when it takes fewer, once it has moved when it takes more. A size smaller than what it holds is refused (409 `database_too_large`), as is one of a smaller quota while what it holds is not measured yet (409 `database_not_measured`, Retry-After), and so is one the project's limit has no room for (409 `machines_over_limit`), a second free database (409 `free_database_taken`), or one whose connections are too few for the copies the machines given it run (409 `database_connections_short`).
      */
-    size?: "dedicated-1x" | "dedicated-2x" | "free" | "hobby" | "shared-1g" | "shared-2g" | "shared-4g";
+    size?: "dedicated-1x" | "dedicated-2x" | "free" | "hobby" | "standard-1x" | "standard-2x" | "starter";
 };
 /**
  * Whose password is made new.
@@ -951,9 +965,9 @@ export type DatabaseCreated = {
      */
     pooled_port: number;
     /**
-     * The database's size. free: 0.25 vCPU, 512 MiB, 1 GB, put to sleep when idle (woken by the next connection in about 10 s), awake 400 hours a month at most, archived after a week asleep (its next connection brings it back from its backup); hobby: 0.25 vCPU, 512 MiB, 5 GB, put to sleep when idle, no monthly limit; shared-1g: 1 GiB, up to 1 vCPU, 10 GB; shared-2g: 2 GiB, up to 2 vCPU, 25 GB; shared-4g: 4 GiB, up to 2 vCPU, 50 GB; dedicated-1x: 1 vCPU of its own, 4 GiB, 25 GB; dedicated-2x: 2 vCPU of its own, 8 GiB, 50 GB. The shared and dedicated sizes never sleep and live on a Premium SSD v2 disk of their own; free and hobby on the platform's SAN. A database past its size's storage turns read-only. What a project's machines and databases reserve between them is held to its limit: a size that does not fit is refused (409 `machines_over_limit`).
+     * The database's size. free: 0.25 vCPU, 512 MiB, 1 GB, put to sleep when idle (woken by the next connection in about 10 s), awake 400 hours a month at most, archived after a week asleep (its next connection brings it back from its backup); hobby: 0.25 vCPU, 512 MiB, 5 GB, put to sleep when idle, no monthly limit; starter: 1 GiB, up to 0.5 vCPU, 10 GB; standard-1x: 2 GiB, up to 1 vCPU, 25 GB; standard-2x: 4 GiB, up to 2 vCPU, 50 GB (a quarter of their CPU reserved for them); dedicated-1x: 1 vCPU of its own, 4 GiB, 25 GB; dedicated-2x: 2 vCPU of its own, 8 GiB, 50 GB. The standard and dedicated sizes never sleep and live on a Premium SSD v2 disk of their own; free and hobby on the platform's SAN. A database past its size's storage turns read-only. What a project's machines and databases reserve between them is held to its limit: a size that does not fit is refused (409 `machines_over_limit`).
      */
-    size: "dedicated-1x" | "dedicated-2x" | "free" | "hobby" | "shared-1g" | "shared-2g" | "shared-4g";
+    size: "dedicated-1x" | "dedicated-2x" | "free" | "hobby" | "standard-1x" | "standard-2x" | "starter";
     /**
      * Where its data lives, as its size says: san, the platform's SAN; premium, a Premium SSD v2 disk of its own.
      */
@@ -1144,15 +1158,15 @@ export type MachineSize = {
      */
     name: string;
     /**
-     * shared: a fraction of a CPU as its ceiling, put to sleep when idle; dedicated: whole CPUs of its own, never asleep.
+     * shared: a fraction of a CPU as its ceiling, put to sleep when idle; standard: its CPUs as its ceiling, a quarter of them reserved for it, never asleep; dedicated: whole CPUs of its own, never asleep.
      */
-    class: "shared" | "dedicated";
+    class: "shared" | "standard" | "dedicated";
     /**
      * Its CPU ceiling, in CPUs.
      */
     vcpu: number;
     /**
-     * Its memory, its own in either class.
+     * Its memory, its own in every class.
      */
     memory_mib: number;
     /**
@@ -1163,6 +1177,10 @@ export type MachineSize = {
      * An idle machine of this size is put to sleep, and woken by its next request.
      */
     sleeps: boolean;
+    /**
+     * What an hour of a copy of this size costs on Pay as you go, in micro-USD (the price table's; a free size's past its free hours).
+     */
+    price_micros_per_hour: number;
     /**
      * A size open to every project; the others are paid for.
      */
@@ -1233,6 +1251,10 @@ export type DatabaseSize = {
      * How many transactions its pooled port (6543) runs at once, however many of its clients are connected: a transaction that finds none of them free within 20 s is refused (53300).
      */
     pooled_connections: number;
+    /**
+     * What an hour of a database of this size awake costs on Pay as you go, in micro-USD (the price table's; a free size's past its free hours).
+     */
+    price_micros_per_hour: number;
     /**
      * A size counted against the project's free databases; the others are paid for.
      */
@@ -1520,6 +1542,12 @@ export type Site = {
      */
     preview_forks: boolean;
     environment?: EnvironmentRef;
+    moving_to?: EnvironmentRef;
+    /**
+     * Why the site's last move to another environment was not made, when it was not: the environment it was moving to holds a site of its name by then, has one of its domains added, or is gone.
+     */
+    move_note?: string;
+    server: SiteServer;
 };
 /**
  * The release a site serves; none before its first.
@@ -1567,12 +1595,13 @@ export type SiteCreate = {
      */
     preview_forks?: boolean;
     /**
-     * The ref of the project's environment the site is bound to (environment_not_found for one the caller does not reach: an environment's own token or key makes what is bound to its environment alone). None: the environment called. Its name is the project's one: name_taken when another environment holds a site of that name.
+     * The ref of the environment called, when given: a new site is bound to the environment whose address it is made at (409 bound_to_environment for another — make it at that environment's address). Its name is the project's one: name_taken when another environment holds a site of that name.
      */
     environment?: string;
+    server?: SiteServer;
 };
 /**
- * What to change of a site; a field left out is unchanged.
+ * What to change of a site; a field left out is unchanged — in build too: each of its fields given changes alone, an empty one is found in the source again, and env, when given, is all of the build's settings from then on.
  */
 export type SiteUpdate = {
     spa?: boolean;
@@ -1586,6 +1615,7 @@ export type SiteUpdate = {
      * Whether a fork's pull requests are previewed (Site.preview_forks).
      */
     preview_forks?: boolean;
+    server?: SiteServer;
 };
 /**
  * One upload of a site's files.
@@ -1711,7 +1741,7 @@ export type SiteBuild = {
      * The commit's message, its first line.
      */
     message: string;
-    state: "queued" | "building" | "succeeded" | "failed";
+    state: "queued" | "building" | "succeeded" | "failed" | "cancelled";
     /**
      * Why it failed.
      */
@@ -1937,6 +1967,69 @@ export type MachineMove = {
      */
     environment: string;
 };
+/**
+ * Binds a site to another environment of its project.
+ */
+export type SiteMove = {
+    /**
+     * The ref of the environment of the project the site moves to.
+     */
+    environment: string;
+};
+/**
+ * Binds a database to another environment of its project.
+ */
+export type DatabaseMove = {
+    /**
+     * The ref of the environment of the project the database moves to.
+     */
+    environment: string;
+    /**
+     * Moves the machines of its environment that run its migrations with it, in one step: they move once it has, its migrations theirs where it moves. Without it, a move such machines would be left behind by is refused (migrations_where_kept).
+     */
+    with_machines?: boolean;
+};
+/**
+ * A deploy hook: a URL that builds the site's or machine's branch head when it is POSTed to, with no key — the URL is the secret, given once as the hook is made.
+ */
+export type DeployHook = {
+    id: string;
+    /**
+     * What calls it: a CMS, a schedule.
+     */
+    name: string;
+    /**
+     * Where it is POSTed to: https://deploy-hooks.<domain>/pbh_…, given once, as it is made.
+     */
+    url?: string;
+    created_at: string;
+    last_used_at: string | null;
+};
+/**
+ * A site's or machine's deploy hooks, oldest first: 5 at most.
+ */
+export type DeployHookList = {
+    hooks: DeployHook[];
+};
+/**
+ * A deploy hook to make.
+ */
+export type DeployHookCreate = {
+    /**
+     * What calls it: letters, digits, spaces, dots, dashes and underscores, 64 at most.
+     */
+    name: string;
+};
+/**
+ * A site's server: the machine of its environment that answers, on every address of the site, the paths `paths` names — each a prefix ending in /, an /api/ of the site's own — as it answers at its own address (woken, held to the environment's limits); none named, every path: a web app that runs on a server (Next.js, Nuxt, SvelteKit, Remix, Express), whose site is its address and domains. A pull request's preview of the site is answered by the machine's own preview of it once that is built. 10 paths at most; `/` is every path.
+ */
+export type SiteServer = ({
+    /**
+     * The machine's name; empty takes the server away (in a change).
+     */
+    machine: string;
+    paths: string[];
+}) | null;
 /** Palbase Machines */
 export declare function client(t: Transport): {
     /**
@@ -1944,7 +2037,7 @@ export declare function client(t: Transport): {
      *
      * Lists the project's machines, by name.
      *
-     * A project's machines, databases and sites are the project's, each bound to one of its environments: from any of its environments' addresses, one who reaches the project (a developer, an organization's token, an account token) lists every environment's, each naming its environment (environment). A name, in any request that names one (/machines/{name}/…), is found in the environment it is bound to and the request is answered there.
+     * A project's machines, databases and sites are the project's, each bound to one of its environments: from any of its environments' addresses, one who reaches the project (a developer, an organization's token, an account token) lists every environment's, each naming its environment (environment). A read that names one (GET /machines/{name}/…) is answered in the environment it is bound to, held to the caller's role there; a change is made at that environment's own address (409 bound_to_environment elsewhere), where a change to production is confirmed and audited.
      */
     listMachines(input?: {
         query?: {
@@ -2221,7 +2314,7 @@ export declare function client(t: Transport): {
      *
      * Lists the project's databases by name, deleted ones that may still be taken back among them.
      *
-     * A project's machines, databases and sites are the project's, each bound to one of its environments: from any of its environments' addresses, one who reaches the project (a developer, an organization's token, an account token) lists every environment's, each naming its environment (environment). A name, in any request that names one (/databases/{name}/…), is found in the environment it is bound to and the request is answered there.
+     * A project's machines, databases and sites are the project's, each bound to one of its environments: from any of its environments' addresses, one who reaches the project (a developer, an organization's token, an account token) lists every environment's, each naming its environment (environment). A read that names one (GET /databases/{name}/…) is answered in the environment it is bound to, held to the caller's role there; a change is made at that environment's own address (409 bound_to_environment elsewhere), where a change to production is confirmed and audited.
      */
     listDatabases(input?: {
         query?: {
@@ -2602,7 +2695,7 @@ export declare function client(t: Transport): {
      *
      * Lists the project's sites, by name: a project has 10 at most.
      *
-     * A project's machines, databases and sites are the project's, each bound to one of its environments: from any of its environments' addresses, one who reaches the project (a developer, an organization's token, an account token) lists every environment's, each naming its environment (environment). A name, in any request that names one (/sites/{name}/…), is found in the environment it is bound to and the request is answered there.
+     * A project's machines, databases and sites are the project's, each bound to one of its environments: from any of its environments' addresses, one who reaches the project (a developer, an organization's token, an account token) lists every environment's, each naming its environment (environment). A read that names one (GET /sites/{name}/…) is answered in the environment it is bound to, held to the caller's role there; a change is made at that environment's own address (409 bound_to_environment elsewhere), where a change to production is confirmed and audited.
      */
     listSites(input?: {
         query?: {
@@ -2849,7 +2942,7 @@ export declare function client(t: Transport): {
     /**
      * Move a machine to another environment of its project
      *
-     * Binds the machine to another environment of its project (the user's call of 2026-11-01): it takes that environment's settings, secrets and modules from its next start, and its address names it (<name>-<the environment's ref>). The operator moves it — out of the environment it leaves, into the new one at the version it serves — in its own pass: the machine says where it is moving (moving_to) until it has, a second or so. Its pull requests' previews are closed; a new push opens them in the new environment. The database it is given stays where it is kept, given across environments. Its name is the project's one (name_taken when the new environment holds a machine of that name); a machine with domains of its own does not move (machine_has_domains): they are removed first. It needs the admin role in both environments (environment_role_required); an environment's own token or key moves nothing out of it (environment_not_found).
+     * Binds the machine to another environment of its project (the user's call of 2026-11-01): it takes that environment's settings, secrets and modules from its next start, and its address names it (<name>-<the environment's ref>). The operator moves it — out of the environment it leaves, into the new one at the version it serves — in its own pass: the machine says where it is moving (moving_to) until it has, a second or so, and what ran where it left answers until it is up in the new one (moved_from; ten minutes at most). It answers at the address it had too, for good (former_urls; the user's call of 2026-11-02). Its domains of its own move with it, and answer throughout: none of them may be added in the new environment too (domain_in_environment), and the new environment must have room for them (too_many_domains). Its pull requests' previews are closed; a new push opens them in the new environment. The database it is given stays where it is kept, given across environments. Its name is the project's one (name_taken when the new environment holds a machine of that name). It needs the admin role in both environments (environment_role_required); an environment's own token or key moves nothing out of it (environment_not_found).
      */
     moveMachine(input: {
         path: {
@@ -2857,6 +2950,124 @@ export declare function client(t: Transport): {
         };
         body: MachineMove; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
-    }): Promise<Reply<202, Machine>>;
+    }): Promise<Reply<200, Machine> | Reply<202, Machine>>;
+    /**
+     * Move a site to another environment of its project
+     *
+     * Binds the site to another environment of its project (the user's call of 2026-11-01), as a machine moves: the operator copies its files and releases to the new environment while it serves on where it is, then moves it — its releases, its builds, its domains of its own — in one transaction, a few seconds after the request; its address names the new environment from then on (<name>-<the environment's ref>), and it answers at the one it had too, for good (urls; the user's call of 2026-11-02). Its pull requests' previews are closed; a new push opens them in the new environment. A build of it going on is stopped and built again there; the GitHub installation it is built through is linked to the new environment when it is not. Meanwhile a change of it is refused (409 site_moving), and a move to its own environment lets the move go. The new environment must have room for it (too_many_sites, sites_full, too_many_domains), no site of its name (name_taken) and none of its domains added too (domain_in_environment). A site the platform's operator took down moves nowhere (site_taken_down). It needs the admin role in both environments (environment_role_required); an environment's own token or key moves nothing out of it (environment_not_found). A move that cannot be made is let go of, and the site says why (move_note).
+     */
+    moveSite(input: {
+        path: {
+            name: string;
+        };
+        body: SiteMove; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Site> | Reply<202, Site>>;
+    /**
+     * Move a database to another environment of its project
+     *
+     * Binds the database to another environment of its project (the user's call of 2026-11-01): what it is — its row, what it is counted and paid for from then on, its address — becomes the new environment's, a few seconds after the request; what holds its data stays where it was made, so nothing is copied and it answers throughout. Its host names the new environment from then on (<name>-<the environment's ref>), and the one it had answers too, for good (former_hosts; the user's call of 2026-11-02); the machines given it are rolled out to the new host, beside the version that serves. Its migrations are the machines' of the environment that keeps it: the machines that run them move with it when with_machines says so — said to move in one step, each after the database — or the move is refused (migrations_where_kept, with the machines). A pull request preview's own database moves with nothing (preview_database); one being resized, restored or archived moves once that is done (database_busy). The new environment must have room for it as for a database opened there (free_database_taken, too_many_databases, size_not_available, backup_days_not_available) and no database of its name (name_taken). Meanwhile a change of it is refused (409 database_moving), and a move to its own environment lets the move go. It needs the admin role in both environments (environment_role_required); an environment's own token or key moves nothing out of it (environment_not_found). A move that cannot be made is let go of, and the database says why (move_note).
+     */
+    moveDatabase(input: {
+        path: {
+            name: string;
+        };
+        body: DatabaseMove; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Database> | Reply<202, Database>>;
+    /**
+     * Cancel a site's build
+     *
+     * Ends a build that is queued or building (`build_not_cancellable`, 409, for one that ended): its run is stopped, its commit's check says it was cancelled, and the site serves what it served. A push, a deploy or a deploy hook builds again.
+     */
+    cancelSiteBuild(input: {
+        path: {
+            name: string; /** The build's id. */
+            build: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, SiteBuild>>;
+    /**
+     * Cancel a build
+     *
+     * Ends a build that has not rolled out — queued, waiting for its checks or its configuration, building (`build_not_cancellable`, 409, for one being tested or ended): its run is stopped, its commit's check says it was cancelled, and the machine serves what it served. A push, a deploy or a deploy hook builds again.
+     */
+    cancelBuild(input: {
+        path: {
+            name: string; /** The build's id. */
+            build: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Build>>;
+    /**
+     * List a site's deploy hooks
+     *
+     * The site's deploy hooks, oldest first: their names and when each was last called, never their URLs.
+     */
+    listSiteHooks(input: {
+        path: {
+            name: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, DeployHookList>>;
+    /**
+     * Make a site deploy hook
+     *
+     * Makes a URL that builds the site's branch head when it is POSTed to (https://deploy-hooks.<domain>/<token>), held to the project's builds as a push is, at most once in five seconds. Its URL is in the answer alone: keep it as a secret, and delete the hook if it leaks. 5 at most (`too_many_hooks`, 409); a site built from no repository has none (409).
+     */
+    createSiteHook(input: {
+        path: {
+            name: string;
+        };
+        body: DeployHookCreate; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<201, DeployHook>>;
+    /**
+     * Delete a site deploy hook
+     *
+     * Deletes a deploy hook: its URL builds nothing from now on.
+     */
+    deleteSiteHook(input: {
+        path: {
+            name: string; /** The deploy hook's id. */
+            hook: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<204, undefined>>;
+    /**
+     * List a machine's deploy hooks
+     *
+     * The machine's deploy hooks, oldest first: their names and when each was last called, never their URLs.
+     */
+    listMachineHooks(input: {
+        path: {
+            name: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, DeployHookList>>;
+    /**
+     * Make a machine deploy hook
+     *
+     * Makes a URL that builds the machine's branch head when it is POSTed to (https://deploy-hooks.<domain>/<token>), held to the project's builds as a push is, at most once in five seconds. Its URL is in the answer alone: keep it as a secret, and delete the hook if it leaks. 5 at most (`too_many_hooks`, 409); a machine read with its caller's tokens has none (409).
+     */
+    createMachineHook(input: {
+        path: {
+            name: string;
+        };
+        body: DeployHookCreate; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<201, DeployHook>>;
+    /**
+     * Delete a machine deploy hook
+     *
+     * Deletes a deploy hook: its URL builds nothing from now on.
+     */
+    deleteMachineHook(input: {
+        path: {
+            name: string; /** The deploy hook's id. */
+            hook: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<204, undefined>>;
 };
 export type Client = ReturnType<typeof client>;