palbase 0.33.0 → 0.34.0

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

@@ -214,7 +214,7 @@ export type Machine = {
      */
     always_on: boolean;
     /**
-     * Whether a pull request opened against its branch is previewed: its head built into a machine of its own, <name>-pr<n>, in this environment, with this environment's settings and secrets, answering at <name>-pr<n>-<ref> until the pull request closes; the pull request is told where in a comment. Turn it on in an environment kept for previews, not production's: the pull request's code runs with the environment's secrets.
+     * Whether a pull request opened against its branch is previewed: its head built into a machine of its own, <name>-pr<n>, in this environment, with this environment's settings and secrets, answering at <name>-pr<n>-<ref> until the pull request closes; the pull request is told where in a comment. Any environment previews, production's too: the pull request's code runs with the environment's settings, secrets and users, with a database of its own when the machine runs its database's migrations.
      */
     previews: boolean;
     /**
@@ -307,7 +307,7 @@ export type MachineCreate = {
      */
     always_on?: boolean;
     /**
-     * Whether a pull request opened against its branch is previewed: its head built into a machine of its own, <name>-pr<n>, in this environment, with this environment's settings and secrets, answering at <name>-pr<n>-<ref> until the pull request closes; the pull request is told where in a comment. Turn it on in an environment kept for previews, not production's: the pull request's code runs with the environment's secrets. A machine read with a platform's tokens (source.access token) previews what its platform puts (PUT /machines/{name}/previews/{pull_request}), no comment written.
+     * Whether a pull request opened against its branch is previewed: its head built into a machine of its own, <name>-pr<n>, in this environment, with this environment's settings and secrets, answering at <name>-pr<n>-<ref> until the pull request closes; the pull request is told where in a comment. Any environment previews, production's too: the pull request's code runs with the environment's settings, secrets and users, with a database of its own when the machine runs its database's migrations. A machine read with a platform's tokens (source.access token) previews what its platform puts (PUT /machines/{name}/previews/{pull_request}), no comment written.
      */
     previews?: boolean;
     /**
@@ -802,6 +802,14 @@ export type DatabaseLimits = {
      * The connections it takes (Postgres' max_connections).
      */
     connections: number;
+    /**
+     * The sessions its direct port (5432) takes at once.
+     */
+    direct_connections: number;
+    /**
+     * The transactions its pooled port (6543) runs at once.
+     */
+    pooled_connections: number;
 };
 /**
  * One bucket of a database's usage.
@@ -1197,6 +1205,14 @@ export type DatabaseSize = {
      * A week asleep, its volume is taken back and its next connection brings it back from its backup.
      */
     archives: boolean;
+    /**
+     * How many sessions its direct port (5432) takes at once: a session holds one until it ends, and a client past them is refused (53300).
+     */
+    direct_connections: number;
+    /**
+     * 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;
     /**
      * A size counted against the project's free databases; the others are paid for.
      */
@@ -1476,7 +1492,7 @@ export type Site = {
     source: SiteSourceView;
     build: SiteBuildSettings;
     /**
-     * Whether a pull request opened against its source's branch is previewed: its head built, with this environment's build settings, into a release of its own that answers at <name>-pr<n>-<ref> until the pull request closes — never what the site serves, none of its releases; the pull request is told where in a comment. Turn it on in an environment kept for previews, not production's.
+     * Whether a pull request opened against its source's branch is previewed: its head built, with this environment's build settings, into a release of its own that answers at <name>-pr<n>-<ref> until the pull request closes — never what the site serves, none of its releases; the pull request is told where in a comment. Any environment previews, production's too: the pull request's build runs with the environment's settings.
      */
     previews: boolean;
     /**
@@ -1522,7 +1538,7 @@ export type SiteCreate = {
     source?: SiteSource;
     build?: SiteBuildSettings;
     /**
-     * Whether a pull request opened against its source's branch is previewed: its head built, with this environment's build settings, into a release of its own that answers at <name>-pr<n>-<ref> until the pull request closes — never what the site serves, none of its releases; the pull request is told where in a comment. Turn it on in an environment kept for previews, not production's.
+     * Whether a pull request opened against its source's branch is previewed: its head built, with this environment's build settings, into a release of its own that answers at <name>-pr<n>-<ref> until the pull request closes — never what the site serves, none of its releases; the pull request is told where in a comment. Any environment previews, production's too: the pull request's build runs with the environment's settings.
      */
     previews?: boolean;
     /**
@@ -1858,7 +1874,7 @@ export type PreviewOpened = {
     commit: string;
 };
 /**
- * A platform's pull request: its branch — one of the machine's repository's own — the head its machine's preview builds, and the token it is read with.
+ * A platform's pull request: its branch — one of the machine's repository's own — the head its machine's preview builds, and, for a machine read with a platform's tokens, the token it is read with.
  */
 export type PreviewDeploy = {
     /**
@@ -1870,9 +1886,9 @@ export type PreviewDeploy = {
      */
     commit?: string;
     /**
-     * A GitHub App installation's token (ghs_…) for the machine's repository alone, read-only: used once, never kept.
+     * For a machine read with a platform's tokens (source.access token), and required for one: a GitHub App installation's token (ghs_…) for the machine's repository alone, read-only, used once, never kept. A machine read with Palbase's GitHub App takes none (400 token_not_taken): its branch is read with the project's installation.
      */
-    git_access_token: string;
+    git_access_token?: string;
 };
 /** Palbase Machines */
 export declare function client(t: Transport): {
@@ -2044,7 +2060,7 @@ export declare function client(t: Transport): {
     /**
      * Open or update a platform's pull request preview
      *
-     * For a machine read with a platform's tokens (source.access token: PalCore's, whose repositories have no Palbase App, so no pull request is heard here): opens the preview of the pull request at the head of its branch — one of the machine's repository's own: a fork's is not built — its own machine, <name>-pr<n>, and a database of its own when the machine runs its database's migrations — or builds the open one at it, and opens one that went idle again. The branch is read with git_access_token, a GitHub App installation's token for the machine's repository alone (ghs_…), once; a commit named must be the branch's head (409 commit_not_head). Its address and state are read with GET /machines/{name}/previews; the platform tells its pull request itself. Refused in a production environment (409 previews_in_production), for a machine read with Palbase's GitHub App (409 previews_from_github), with previews off (409 previews_off), and when the environment's limits refuse the preview (409 preview_refused, with why).
+     * For a platform — PalCore — that previews its product's machine itself: one read with its tokens (source.access token), whose pull requests are not heard here, or one read with Palbase's GitHub App, whose numbers then are the platform's (a pull request GitHub told of keeps its own: 409 preview_taken). Opens the preview of the pull request at the head of its branch — one of the machine's repository's own: a fork's is not built — its own machine, <name>-pr<n>, and a database of its own when the machine runs its database's migrations — or builds the open one at it, and opens one that went idle again. A machine read with tokens has its branch read with git_access_token, a GitHub App installation's token for the machine's repository alone (ghs_…), once (400 token_required without); one read with Palbase's App, with the project's installation (400 token_not_taken with one). A commit named must be the branch's head (409 commit_not_head). Any environment previews, production's too: the preview runs with its settings, secrets and users. Its address and state are read with GET /machines/{name}/previews; the platform tells its pull request itself. Refused with previews off (409 previews_off), and when the environment's limits refuse the preview (409 preview_refused, with why).
      */
     putMachinePreview(input: {
         path: {
@@ -2057,7 +2073,7 @@ export declare function client(t: Transport): {
     /**
      * Close a platform's pull request preview
      *
-     * For a machine read with a platform's tokens: closes the preview of the pull request, its pull request closed — its machine and its own database are deleted at once. A machine read with Palbase's GitHub App has its previews closed as GitHub tells (409 previews_from_github).
+     * Closes a preview its platform put (PUT): its machine and its own database are deleted at once. A preview GitHub told of closes as its pull request does (409 previews_from_github).
      */
     deleteMachinePreview(input: {
         path: {