palbase 0.37.2 → 0.38.0

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

@@ -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.
@@ -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;
 };
@@ -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.
@@ -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;
 };
@@ -1520,6 +1534,11 @@ 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;
 };
 /**
  * The release a site serves; none before its first.
@@ -1567,7 +1586,7 @@ 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;
 };
@@ -1937,6 +1956,28 @@ 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;
+};
 /** Palbase Machines */
 export declare function client(t: Transport): {
     /**
@@ -1944,7 +1985,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 +2262,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 +2643,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 +2890,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 +2898,30 @@ 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>>;
 };
 export type Client = ReturnType<typeof client>;