palbase 0.28.0 → 0.29.0

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

@@ -1714,9 +1714,9 @@ export type Preview = {
      */
     url: string;
     /**
-     * building, ready, failed — or closed: its pull request closed, and its address answers no more.
+     * authorization_required — a fork's head waiting for an admin of the environment to authorize it (fork protection): nothing of it is built until one does, and each push asks again —, building, ready, failed — or closed: its pull request closed, its address answers no more.
      */
-    state: "building" | "ready" | "failed" | "closed";
+    state: "authorization_required" | "building" | "ready" | "failed" | "closed";
     /**
      * A machine's preview: its own machine, by name.
      */
@@ -1724,6 +1724,15 @@ export type Preview = {
     created_at: string;
     updated_at: string;
     closed_at?: string;
+    /**
+     * The fork's head an admin last authorized.
+     */
+    authorized_commit?: string;
+    /**
+     * Who authorized it: a developer's id, or the credential the call presented.
+     */
+    authorized_by?: string;
+    authorized_at?: string;
 };
 /**
  * A site's or a machine's previews, the fifty newest first.
@@ -1735,12 +1744,12 @@ export type PreviewList = {
  * One record of a domain's DNS.
  */
 export type DNSRecord = {
-    type: "CNAME" | "TXT";
+    type: "A" | "CNAME" | "TXT";
     name: string;
     value: string;
 };
 /**
- * A domain of the customer's own a site or a machine answers at too. Its owner adds its records to its DNS: the CNAME points it at the platform (at the apex, where DNS takes no CNAME: an ALIAS, ANAME or flattened CNAME to the same target), the TXT shows it is this environment's. It answers once Cloudflare has its certificate and the TXT record is there. A domain is one environment's, platform-wide, until it is deleted there.
+ * A domain of the customer's own a site or a machine answers at too. Its owner adds its records to its DNS: a subdomain's CNAME points it at the platform through Cloudflare; an apex's A record names the platform's address for apexes, which any DNS host takes (its certificate the edge's, from Let's Encrypt) — or, where its DNS host has one, an ALIAS, ANAME or flattened CNAME to the subdomains' target keeps it behind Cloudflare. The TXT shows it is this environment's. It answers once its certificate is issued and the TXT record is there. A domain may send its visitors to another domain of the same site or machine (redirect_to). A domain is one environment's, platform-wide, until it is deleted there.
  */
 export type Domain = {
     /**
@@ -1752,9 +1761,21 @@ export type Domain = {
      */
     state: "pending" | "active";
     /**
-     * A domain of its own, not a subdomain: most DNS hosts take no CNAME there.
+     * A domain of its own, not a subdomain: its DNS takes an A record at the platform's address for apexes (records), or an ALIAS, ANAME or flattened CNAME to the subdomains' target.
      */
     apex: boolean;
+    /**
+     * How it reaches the platform, as last read: cdn through Cloudflare (its certificate Cloudflare's), ip an apex's A record at the platform's address for apexes (its certificate Let's Encrypt's); null while its DNS says neither.
+     */
+    via: ("cdn" | "ip") | null;
+    /**
+     * Another domain of the same site or machine its visitors are sent to, the same path and query there (Vercel's "Redirect to"); null when it answers itself.
+     */
+    redirect_to: string | null;
+    /**
+     * The redirect's status: 308 unless said; null with redirect_to.
+     */
+    redirect_status: (301 | 302 | 307 | 308) | null;
     /**
      * What its owner adds to its DNS.
      */
@@ -1774,13 +1795,50 @@ export type DomainList = {
     domains: Domain[];
 };
 /**
- * A domain to add.
+ * A domain to add — sending its visitors to another of the same site's or machine's when redirect_to names one.
  */
 export type DomainCreate = {
     /**
      * The domain: www.example.com, or example.com — none of the platform's own.
      */
     host: string;
+    /**
+     * Another domain of the same site or machine, added before, its visitors are sent to (an apex to its www, or a www to its apex). It may not redirect itself, and this one may not be another's target.
+     */
+    redirect_to?: string;
+    /**
+     * The redirect's status, with redirect_to: 308 unless said.
+     */
+    redirect_status?: 301 | 302 | 307 | 308;
+};
+/**
+ * Where a domain sends its visitors: another domain of the same site or machine, or null to have it answer itself. It holds at once.
+ */
+export type DomainUpdate = {
+    /**
+     * Another domain of the same site or machine (one that redirects nowhere itself), or null.
+     */
+    redirect_to: string | null;
+    /**
+     * The redirect's status, with redirect_to: 308 unless said.
+     */
+    redirect_status?: 301 | 302 | 307 | 308;
+};
+/**
+ * The fork's head an admin authorizes: the one they looked at, which must be the pull request's newest.
+ */
+export type PreviewAuthorize = {
+    /**
+     * The pull request's head, as its preview says (Preview.commit).
+     */
+    commit: string;
+};
+/**
+ * An authorization taken: the preview is being built at the commit.
+ */
+export type PreviewAuthorized = {
+    pull_request: number;
+    commit: string;
 };
 /** Palbase Machines */
 export declare function client(t: Transport): {
@@ -1975,7 +2033,7 @@ export declare function client(t: Transport): {
     /**
      * Delete a machine's domain
      *
-     * Takes a domain away: it answers no more at once, and another environment may add it.
+     * Takes a domain away: it answers no more at once, and another environment may add it. One another domain redirects to is kept (409 domain_redirected_to): change that one's redirect first.
      */
     deleteMachineDomain(input: {
         path: {
@@ -1984,6 +2042,19 @@ export declare function client(t: Transport): {
         }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<204, undefined>>;
+    /**
+     * Set where a machine's domain redirects
+     *
+     * Sends the domain's visitors to another domain of the same machine — the same path and query there, with redirect_status (308 unless said) — or, redirect_to null, has it answer itself. It holds at the edge at once. A domain redirects to one that redirects nowhere, and one others redirect to answers itself.
+     */
+    updateMachineDomain(input: {
+        path: {
+            name: string; /** The domain. */
+            host: string;
+        };
+        body: DomainUpdate; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Domain>>;
     /**
      * Read a build
      *
@@ -2570,7 +2641,7 @@ export declare function client(t: Transport): {
     /**
      * Delete a site's domain
      *
-     * Takes a domain away: it answers no more at once, and another environment may add it.
+     * Takes a domain away: it answers no more at once, and another environment may add it. One another domain redirects to is kept (409 domain_redirected_to): change that one's redirect first.
      */
     deleteSiteDomain(input: {
         path: {
@@ -2579,6 +2650,19 @@ export declare function client(t: Transport): {
         }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<204, undefined>>;
+    /**
+     * Set where a site's domain redirects
+     *
+     * Sends the domain's visitors to another domain of the same site — the same path and query there, with redirect_status (308 unless said) — or, redirect_to null, has it answer itself. It holds at the edge at once. A domain redirects to one that redirects nowhere, and one others redirect to answers itself.
+     */
+    updateSiteDomain(input: {
+        path: {
+            name: string; /** The domain. */
+            host: string;
+        };
+        body: DomainUpdate; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, Domain>>;
     /**
      * Get a site's build
      *
@@ -2591,5 +2675,31 @@ export declare function client(t: Transport): {
         }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<200, SiteBuild>>;
+    /**
+     * Authorize a fork's pull request's preview
+     *
+     * Builds the preview of a pull request from a fork at the head an admin looked at (fork protection, Vercel's Git Fork Protection: a fork's code runs with the environment's settings and secrets). The head must be the pull request's newest: a push since answers 409 preview_head_moved. Each new push asks again.
+     */
+    authorizeSitePreview(input: {
+        path: {
+            name: string; /** The pull request's number. */
+            pull_request: number;
+        };
+        body: PreviewAuthorize; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<202, PreviewAuthorized>>;
+    /**
+     * Authorize a fork's pull request's preview
+     *
+     * Builds the preview of a pull request from a fork at the head an admin looked at (fork protection, Vercel's Git Fork Protection: a fork's code runs with the environment's settings and secrets). The head must be the pull request's newest: a push since answers 409 preview_head_moved. Each new push asks again.
+     */
+    authorizeMachinePreview(input: {
+        path: {
+            name: string; /** The pull request's number. */
+            pull_request: number;
+        };
+        body: PreviewAuthorize; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<202, PreviewAuthorized>>;
 };
 export type Client = ReturnType<typeof client>;

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

@@ -868,9 +868,9 @@ export type Message = {
      */
     attachments: Attachment[];
     /**
-     * What a call message keeps of its call (kind call): written as the call starts, and again as it is answered and as it ends. It counts as no unread message.
+     * What a call message keeps of its call (kind call): written as the call starts, and again as it is answered and as it ends. It counts as no unread message. Always sent (null on any other message); absent (an answer kept from before it was): null.
      */
-    call: CallRecord | null;
+    call?: CallRecord | null;
     /**
      * The writer's app's own id of it.
      */