palbase 0.38.0 → 0.40.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).
      */
@@ -287,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`).
      */
@@ -384,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`).
      */
@@ -511,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.
      */
@@ -610,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.
      */
@@ -641,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.
@@ -965,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.
      */
@@ -1158,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;
     /**
@@ -1177,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.
      */
@@ -1247,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.
      */
@@ -1539,6 +1547,11 @@ export type Site = {
      * 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;
+    /**
+     * Its previews — its pull requests' and its branches' — are its team's alone (Vercel's Deployment Protection; true by default): a visitor signs in with Studio, or holds one of its share links. What a protected preview answers is kept by no CDN.
+     */
+    previews_protected: boolean;
 };
 /**
  * The release a site serves; none before its first.
@@ -1589,9 +1602,14 @@ export type SiteCreate = {
      * 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;
+    /**
+     * Whether its previews are its team's alone; none is true.
+     */
+    previews_protected?: boolean;
 };
 /**
- * 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;
@@ -1605,6 +1623,11 @@ export type SiteUpdate = {
      * Whether a fork's pull requests are previewed (Site.preview_forks).
      */
     preview_forks?: boolean;
+    server?: SiteServer;
+    /**
+     * Whether its previews are its team's alone from now on.
+     */
+    previews_protected?: boolean;
 };
 /**
  * One upload of a site's files.
@@ -1730,7 +1753,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.
      */
@@ -1803,6 +1826,10 @@ export type Preview = {
  */
 export type PreviewList = {
     previews: Preview[];
+    /**
+     * A site's branches' previews, newest first: none of a machine's.
+     */
+    branches?: BranchPreview[];
 };
 /**
  * One record of a domain's DNS.
@@ -1978,6 +2005,141 @@ export type DatabaseMove = {
      */
     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;
+/**
+ * What a directory of a repository is found to be, as Vercel's import finds it: a static web app (`static`: a site, its build in `build`), a web app that runs on a server (`server`: a machine, and a site with no files of its own whose server it is — the site's address and domains), or a backend (`backend`: a machine). A proposal: each of it is changed before the project is made; nothing is made here.
+ */
+export type ProjectDetection = {
+    repository: string;
+    branch: string;
+    path: string;
+    /**
+     * The branch's head it was read at.
+     */
+    commit: string;
+    kind: "static" | "server" | "backend";
+    /**
+     * next, nuxt, sveltekit, react-router, astro, vite, gatsby, docusaurus, vitepress, create-react-app, angular, vue, parcel — or empty for none known.
+     */
+    framework: string;
+    framework_name: string;
+    /**
+     * What told it.
+     */
+    why: string;
+    build?: SiteBuildSettings;
+    /**
+     * The Node.js line a static web app's build runs (its .nvmrc, .node-version or engines.node; 24 when none says).
+     */
+    node?: number;
+    /**
+     * A server or backend is built from its own Dockerfile; without one, its language is found as it builds.
+     */
+    dockerfile: boolean;
+    warnings: string[];
+};
+/**
+ * A site's preview of one of its repository's branches: a push to a branch other than its own, while it previews, builds that branch's head into a release of its own, answered at <name>-git-<branch>-<ref> until the branch is deleted or a month goes by without a push.
+ */
+export type BranchPreview = {
+    branch: string;
+    commit: string;
+    url: string;
+    state: "building" | "ready" | "failed" | "closed";
+    created_at: string;
+    updated_at: string;
+    closed_at: string | null;
+};
+/**
+ * Where a member goes with a pass: the https address of one of the site's open previews.
+ */
+export type PreviewPassAsk = {
+    to: string;
+};
+/**
+ * A member's pass to a site's previews, 12 hours: url is the preview's address with the pass in its query once (the edge moves it into a cookie of the preview's own host).
+ */
+export type PreviewPass = {
+    url: string;
+    expires_at: string;
+};
+/**
+ * A share link to make.
+ */
+export type PreviewLinkCreate = {
+    name?: string;
+    /**
+     * Days it opens the previews; 7 when none.
+     */
+    days?: number;
+};
+/**
+ * A share link of a site's previews: its token — given once, as it is made — opens any of them, added to its address as ?_palbase_pass=<token>. Deleting it closes them to it at once.
+ */
+export type PreviewLink = {
+    id: string;
+    name: string;
+    token?: string;
+    made_by: string;
+    expires_at: string;
+    created_at: string;
+};
+/**
+ * A site's share links that have not ended, newest first: 20 at most.
+ */
+export type PreviewLinkList = {
+    links: PreviewLinkListed[];
+};
+/**
+ * A share link as its site lists it — never its token.
+ */
+export type PreviewLinkListed = {
+    id: string;
+    name: string;
+    made_by: string;
+    expires_at: string;
+    created_at: string;
+};
 /** Palbase Machines */
 export declare function client(t: Transport): {
     /**
@@ -2735,7 +2897,7 @@ export declare function client(t: Transport): {
     /**
      * Finish a release
      *
-     * Finishes a release whose files are all kept — refused, naming them, while one is missing — and the site serves it at once. Finishing one finished before has the site serve it again.
+     * Finishes a release whose files are all kept — refused, naming them, while one is missing — and the site serves it at once. Finishing one finished before has the site serve it again. A release whose `/_redirects` or `/_headers` does not hold is refused (400 `invalid_rules`), the description naming the file, each line and why.
      */
     finishSiteRelease(input: {
         path: {
@@ -2923,5 +3085,159 @@ export declare function client(t: Transport): {
         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>>;
+    /**
+     * Tell what a repository's directory is
+     *
+     * Reads a directory of a repository one of the project's installations reaches, at its branch's head — its package.json, its framework's configuration, its lockfiles, its Node.js version file — and says what it is and how it is built, as Vercel's import does. Nothing is made: a static web app is then opened as a site (POST /sites, with this build), a web app that runs on a server as a machine (POST /machines) and a site whose server it is (POST /sites with `server`), a backend as a machine. `project_not_detected` (422) when nothing there says what it is.
+     */
+    detectProject(input: {
+        query: {
+            repository: string; /** Its branch, read at its head. */
+            branch: string; /** The directory in the repository; none for its root. */
+            path?: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, ProjectDetection>>;
+    /**
+     * Give a member a pass to a preview
+     *
+     * Makes a pass to the site's previews for the caller — Studio asks for one as a signed-in member comes from a protected preview (the edge sent them there) — and answers where to go with it: `to`, one of the site's open previews' addresses, with the pass in its query once. 12 hours.
+     */
+    createPreviewPass(input: {
+        path: {
+            name: string;
+        };
+        body: PreviewPassAsk; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<201, PreviewPass>>;
+    /**
+     * List a site's share links
+     *
+     * The site's share links that have not ended, newest first — never their tokens.
+     */
+    listPreviewLinks(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, PreviewLinkList>>;
+    /**
+     * Make a share link of a site's previews
+     *
+     * Makes a link that opens the site's protected previews to anyone holding it, for 1 to 30 days (7 when none): its token is in the answer alone. 20 at most (`too_many_links`, 409).
+     */
+    createPreviewLink(input: {
+        path: {
+            name: string;
+        };
+        body: PreviewLinkCreate; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<201, PreviewLink>>;
+    /**
+     * Delete a share link
+     *
+     * Deletes a share link: the site's previews close to it at once.
+     */
+    deletePreviewLink(input: {
+        path: {
+            name: string; /** The share link's id. */
+            link: 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>;