@valbuild/shared 0.150.16 → 0.150.18

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @valbuild/shared
 
+## 0.150.18
+
+### Patch Changes
+
+- [#994](https://github.com/valbuild/val/pull/994) [`43f72c8`](https://github.com/valbuild/val/commit/43f72c85c2114fe9a0ce536204858d2d3c05f962) Thanks [@freekh](https://github.com/freekh)! - **Proposals can be built by Val Build instead of in your browser.** When Val Build builds your project's proposals, the design tab's **Build** and the assistant's `build_proposal` in the design tab ask it to build the proposal, and the Studio waits until the build is served at the proposal's address. A small code change is built, checked and on the proposal's page in a few seconds, against around twenty for the build alone in the browser. Nothing is downloaded first, no builder tab opens on an iPhone or in Safari, and closing the tab does not stop the build.
+
+  Val Build is turning this on project by project, in the design tab first. Until it is on for yours, Build works as before, in the browser, and so does Build in the proposals bar.
+
+## 0.150.17
+
+### Patch Changes
+
+- [#992](https://github.com/valbuild/val/pull/992) [`ea3bf9b`](https://github.com/valbuild/val/commit/ea3bf9bbacd22bbb5485fd798d6b3a2d5916be81) Thanks [@freekh](https://github.com/freekh)! - Content analytics now counts on self-hosted sites (Custom hosting), not only on sites Val hosts.
+
+  A self-hosted app's own Val server now hands each analytics beacon on to Val's ingest, which counts it. To turn it on:
+
+  - Run the app with Val's content service: `VAL_API_KEY`, `VAL_SECRET` and `VAL_PROJECT` set. Most deployed apps already do.
+  - Set `VAL_ANALYTICS=true`. In TanStack Start, read it in your layout's loader (`{ enabled: process.env.VAL_ANALYTICS === "true" }`) and pass the result to `<ValProvider analytics>`. A self-hosted site has no platform to pass it for you.
+  - Switch analytics on for the project in Val's admin. While it is off there, the script on your pages is told so and stops sending.
+
+  The server forwards only same-origin beacons from a browser. It passes on the visitor's User-Agent and, where your host provides one (Vercel, Cloudflare or CloudFront), their country. It never passes on their IP address. If the api key is not accepted, the server logs one warning naming `VAL_API_KEY` and `VAL_PROJECT`. Local development (fs mode) works as before and counts nothing.
+
+  `VAL_ANALYTICS_INGEST_URL` overrides where beacons are sent. You will normally not need it.
+
 ## 0.150.16
 
 ### Patch Changes

package/dist/declarations/src/internal/ApiRoutes.d.ts

@@ -176,6 +176,13 @@ export declare const Api: {
         POST: {
             req: {
                 body: z.ZodUnknown;
+                headers: {
+                    "sec-fetch-site": z.ZodOptional<z.ZodString>;
+                    "user-agent": z.ZodOptional<z.ZodString>;
+                    "x-vercel-ip-country": z.ZodOptional<z.ZodString>;
+                    "cf-ipcountry": z.ZodOptional<z.ZodString>;
+                    "cloudfront-viewer-country": z.ZodOptional<z.ZodString>;
+                };
             };
             res: z.ZodUnion<readonly [z.ZodObject<{
                 status: z.ZodLiteral<200>;
@@ -187,6 +194,11 @@ export declare const Api: {
                 json: z.ZodObject<{
                     message: z.ZodString;
                 }, z.core.$strip>;
+            }, z.core.$strip>, z.ZodObject<{
+                status: z.ZodLiteral<410>;
+                json: z.ZodObject<{
+                    message: z.ZodString;
+                }, z.core.$strip>;
             }, z.core.$strip>]>;
         };
     };

package/dist/declarations/src/publish/buildProposal.d.ts

@@ -10,6 +10,16 @@ export type BuiltProposal = {
         hash: string;
         inputs?: string | null;
     } | null;
+    /**
+     * A build the platform was asked for and has not served
+     * (`buildProposalOnServer`): `pending`, or `failed` with why. Absent from
+     * content that does not build.
+     */
+    serverBuild?: {
+        state: "pending" | "failed";
+        inputs: string;
+        error: string | null;
+    } | null;
 };
 /** The calls a build of a proposal makes. An error carries content's `status`. */
 export type ProposalBuildClient<P extends BuiltProposal> = {
@@ -119,3 +129,55 @@ export declare function buildProposal<P extends BuiltProposal>(deps: {
     now?: () => number;
     sleep?: (ms: number) => Promise<void>;
 }): Promise<ProposalBuildOutcome<P>>;
+/** What content answers, in `details.code`, for a project it does not build yet. */
+export declare const SERVER_BUILDS_OFF = "server-builds-off";
+/** How often the proposal is read while the platform builds it. */
+export declare const SERVER_BUILD_POLL_MS = 1000;
+/**
+ * How long a build by the platform is waited for. It is seconds
+ * (valbuild/home `docs/plans/server-builds.md`); this is for the platform not
+ * answering, never for a build that is merely slow.
+ */
+export declare const SERVER_BUILD_WAIT_MS: number;
+/**
+ * Where a build by the platform is (`buildProposalOnServer`): reading what is
+ * staged, then Val Build building, rendering and serving it. Its own type,
+ * not `ProposalBuildStep`'s, which every page that runs `buildProposal`
+ * switches over.
+ */
+export type ServerBuildStep = {
+    kind: "reading";
+} | {
+    kind: "on-server";
+    since: number;
+};
+/** The calls a build by the platform makes. An error carries content's `status`. */
+export type ServerBuildClient<P extends BuiltProposal> = Pick<ProposalBuildClient<P>, "get"> & {
+    /** Ask the platform to build the staged files `inputs` names: `/build` without a publish. */
+    askBuild(name: string, inputs: string): Promise<P>;
+};
+/**
+ * Have the platform build the proposal's staged files and serve the build at
+ * its address (valbuild/home `docs/plans/server-builds.md`): nothing is built
+ * in this tab, so no bundler is loaded, no builder tab is opened, and a tab
+ * that closes meanwhile loses nothing.
+ *
+ * Content answers at once and builds in a job; the proposal is read until it
+ * says the build of these inputs is served, or why it is not. `off` when
+ * content does not build this project yet: `buildProposal` builds it in the
+ * tab, as before.
+ *
+ * A cancel stops the waiting, not the build: the platform finishes it, and
+ * the proposal's address serves it when it renders.
+ */
+export declare function buildProposalOnServer<P extends BuiltProposal>(deps: {
+    name: string;
+    client: ServerBuildClient<P>;
+    onStep?: (step: ServerBuildStep) => void;
+    signal?: AbortSignal;
+    /** For tests: the clock, and waiting on it. */
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<ProposalBuildOutcome<P> | {
+    status: "off";
+}>;

package/dist/declarations/src/publish/index.d.ts

@@ -19,6 +19,6 @@ export { DEPLOY_STOPPED_MESSAGE, carriedInto, runStudioDeploy, splitBinaryFiles,
 export { STUDIO_OUT_OF_DATE, STUDIO_OUT_OF_DATE_MESSAGE, layerMoved, loadedLayer, markStudioOutOfDate, readLiveLayer, rememberLoadedLayer, resetLoadedLayerForTests, siteMovedSinceLoad, studioOutOfDateRefusals, subscribeStudioOutOfDate, type LayerReading, } from "./loadedLayer.js";
 export { MergePrepareAnswer, createStudioJobClient, isMergeChange, type PreparedJob, type StudioJobClient, } from "./jobClient.js";
 export { RENEW_EVERY_MS, runJobToEnd, runStudioJob, type JobPhase, type StudioJobResult, } from "./runStudioJob.js";
-export { BUILD_CANCELLED_MESSAGE, SERVE_POLL_MS, SERVE_WAIT_MS, buildProposal, withoutLockfiles, type BuiltProposal, type ProposalBuildClient, type ProposalBuildOutcome, type ProposalBuildStep, } from "./buildProposal.js";
+export { BUILD_CANCELLED_MESSAGE, SERVER_BUILDS_OFF, SERVER_BUILD_POLL_MS, SERVER_BUILD_WAIT_MS, SERVE_POLL_MS, SERVE_WAIT_MS, buildProposal, buildProposalOnServer, withoutLockfiles, type BuiltProposal, type ServerBuildClient, type ServerBuildStep, type ProposalBuildClient, type ProposalBuildOutcome, type ProposalBuildStep, } from "./buildProposal.js";
 export { proposalProject } from "./proposalProject.js";
 export { buildQuickPreview, clientFilesOf, type QuickPreviewOutcome, } from "./buildQuickPreview.js";

package/internal/dist/valbuild-shared-internal.cjs.dev.js

@@ -1754,11 +1754,22 @@ var Api = {
       // Parsed by the handler rather than here, so a beacon of a version this
       // server does not know is ignored instead of refused.
       req: {
-        body: zod.z.unknown()
+        body: zod.z.unknown(),
+        // What a server that forwards beacons to Val's ingest has to check
+        // and pass on itself: a forward loses the browser's own headers. The
+        // visitor's IP is deliberately not one of them.
+        headers: {
+          "sec-fetch-site": zod.z.string().optional(),
+          "user-agent": zod.z.string().optional(),
+          "x-vercel-ip-country": zod.z.string().optional(),
+          "cf-ipcountry": zod.z.string().optional(),
+          "cloudfront-viewer-country": zod.z.string().optional()
+        }
       },
       res: zod.z.union([
-      // `counted` is false wherever nothing stores the counts -- every
-      // server but the hosted platform's, for now.
+      // `counted` is true only where the beacon was handed to Val's ingest
+      // and it counted it: the hosted platform, or a self-hosted server in
+      // http mode. False everywhere else, local dev included.
       zod.z.object({
         status: zod.z.literal(200),
         json: zod.z.object({
@@ -1767,6 +1778,12 @@ var Api = {
       }), zod.z.object({
         status: zod.z.literal(400),
         json: GenericError
+      }),
+      // Analytics is switched off for this project in Val's admin. The
+      // browser script stops sending when it sees this.
+      zod.z.object({
+        status: zod.z.literal(410),
+        json: GenericError
       })])
     }
   },

package/internal/dist/valbuild-shared-internal.cjs.prod.js

@@ -1754,11 +1754,22 @@ var Api = {
       // Parsed by the handler rather than here, so a beacon of a version this
       // server does not know is ignored instead of refused.
       req: {
-        body: zod.z.unknown()
+        body: zod.z.unknown(),
+        // What a server that forwards beacons to Val's ingest has to check
+        // and pass on itself: a forward loses the browser's own headers. The
+        // visitor's IP is deliberately not one of them.
+        headers: {
+          "sec-fetch-site": zod.z.string().optional(),
+          "user-agent": zod.z.string().optional(),
+          "x-vercel-ip-country": zod.z.string().optional(),
+          "cf-ipcountry": zod.z.string().optional(),
+          "cloudfront-viewer-country": zod.z.string().optional()
+        }
       },
       res: zod.z.union([
-      // `counted` is false wherever nothing stores the counts -- every
-      // server but the hosted platform's, for now.
+      // `counted` is true only where the beacon was handed to Val's ingest
+      // and it counted it: the hosted platform, or a self-hosted server in
+      // http mode. False everywhere else, local dev included.
       zod.z.object({
         status: zod.z.literal(200),
         json: zod.z.object({
@@ -1767,6 +1778,12 @@ var Api = {
       }), zod.z.object({
         status: zod.z.literal(400),
         json: GenericError
+      }),
+      // Analytics is switched off for this project in Val's admin. The
+      // browser script stops sending when it sees this.
+      zod.z.object({
+        status: zod.z.literal(410),
+        json: GenericError
       })])
     }
   },

package/internal/dist/valbuild-shared-internal.esm.js

@@ -1747,11 +1747,22 @@ var Api = {
       // Parsed by the handler rather than here, so a beacon of a version this
       // server does not know is ignored instead of refused.
       req: {
-        body: z.unknown()
+        body: z.unknown(),
+        // What a server that forwards beacons to Val's ingest has to check
+        // and pass on itself: a forward loses the browser's own headers. The
+        // visitor's IP is deliberately not one of them.
+        headers: {
+          "sec-fetch-site": z.string().optional(),
+          "user-agent": z.string().optional(),
+          "x-vercel-ip-country": z.string().optional(),
+          "cf-ipcountry": z.string().optional(),
+          "cloudfront-viewer-country": z.string().optional()
+        }
       },
       res: z.union([
-      // `counted` is false wherever nothing stores the counts -- every
-      // server but the hosted platform's, for now.
+      // `counted` is true only where the beacon was handed to Val's ingest
+      // and it counted it: the hosted platform, or a self-hosted server in
+      // http mode. False everywhere else, local dev included.
       z.object({
         status: z.literal(200),
         json: z.object({
@@ -1760,6 +1771,12 @@ var Api = {
       }), z.object({
         status: z.literal(400),
         json: GenericError
+      }),
+      // Analytics is switched off for this project in Val's admin. The
+      // browser script stops sending when it sees this.
+      z.object({
+        status: z.literal(410),
+        json: GenericError
       })])
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valbuild/shared",
-  "version": "0.150.16",
+  "version": "0.150.18",
   "private": false,
   "description": "Val shared types and utilities",
   "repository": {

package/publish/dist/valbuild-shared-publish.cjs.dev.js

@@ -2309,6 +2309,8 @@ var SERVE_POLL_MS = 5000;
 function buildProposal(_x) {
   return _buildProposal.apply(this, arguments);
 }
+
+/** What content answers, in `details.code`, for a project it does not build yet. */
 function _buildProposal() {
   _buildProposal = createForOfIteratorHelper._asyncToGenerator(/*#__PURE__*/createForOfIteratorHelper._regenerator().m(function _callee3(deps) {
     var _deps$now, _deps$sleep, _deps$onStep;
@@ -2569,6 +2571,257 @@ function _buildProposal() {
   }));
   return _buildProposal.apply(this, arguments);
 }
+var SERVER_BUILDS_OFF = "server-builds-off";
+
+/** How often the proposal is read while the platform builds it. */
+var SERVER_BUILD_POLL_MS = 1000;
+
+/**
+ * How long a build by the platform is waited for. It is seconds
+ * (valbuild/home `docs/plans/server-builds.md`); this is for the platform not
+ * answering, never for a build that is merely slow.
+ */
+var SERVER_BUILD_WAIT_MS = 4 * 60000;
+
+/**
+ * Where a build by the platform is (`buildProposalOnServer`): reading what is
+ * staged, then Val Build building, rendering and serving it. Its own type,
+ * not `ProposalBuildStep`'s, which every page that runs `buildProposal`
+ * switches over.
+ */
+
+/** The calls a build by the platform makes. An error carries content's `status`. */
+
+/**
+ * Whether an error is content saying it does not build this project yet --
+ * or not knowing the request: content from before it built anything refuses
+ * a build without a publish as an invalid body (400). Either way the tab
+ * builds it, as it always did.
+ */
+function serverBuildsOff(error) {
+  var status = statusOf(error);
+  if (status === 400) return true;
+  if (status !== 409) return false;
+  var body = createForOfIteratorHelper._typeof(error) === "object" && error !== null && "body" in error ? error.body : null;
+  var details = createForOfIteratorHelper._typeof(body) === "object" && body !== null && "details" in body ? body.details : null;
+  return createForOfIteratorHelper._typeof(details) === "object" && details !== null && "code" in details && details.code === SERVER_BUILDS_OFF;
+}
+
+/**
+ * Have the platform build the proposal's staged files and serve the build at
+ * its address (valbuild/home `docs/plans/server-builds.md`): nothing is built
+ * in this tab, so no bundler is loaded, no builder tab is opened, and a tab
+ * that closes meanwhile loses nothing.
+ *
+ * Content answers at once and builds in a job; the proposal is read until it
+ * says the build of these inputs is served, or why it is not. `off` when
+ * content does not build this project yet: `buildProposal` builds it in the
+ * tab, as before.
+ *
+ * A cancel stops the waiting, not the build: the platform finishes it, and
+ * the proposal's address serves it when it renders.
+ */
+function buildProposalOnServer(_x2) {
+  return _buildProposalOnServer.apply(this, arguments);
+}
+function _buildProposalOnServer() {
+  _buildProposalOnServer = createForOfIteratorHelper._asyncToGenerator(/*#__PURE__*/createForOfIteratorHelper._regenerator().m(function _callee4(deps) {
+    var _deps$now2, _deps$sleep2, _deps$onStep2;
+    var now, sleep, step, signal, read, staged, inputs, settled, asked, since, first, proposal, outcome, _t8, _t9, _t0, _t1, _t10;
+    return createForOfIteratorHelper._regenerator().w(function (_context4) {
+      while (1) switch (_context4.p = _context4.n) {
+        case 0:
+          now = (_deps$now2 = deps.now) !== null && _deps$now2 !== void 0 ? _deps$now2 : Date.now;
+          sleep = (_deps$sleep2 = deps.sleep) !== null && _deps$sleep2 !== void 0 ? _deps$sleep2 : function (ms) {
+            return new Promise(function (resolve) {
+              return setTimeout(resolve, ms);
+            });
+          };
+          step = (_deps$onStep2 = deps.onStep) !== null && _deps$onStep2 !== void 0 ? _deps$onStep2 : function () {};
+          signal = deps.signal;
+          step({
+            kind: "reading"
+          });
+          // The proposal says what is staged: its files are not needed here
+          _context4.p = 1;
+          _context4.n = 2;
+          return orAborted(deps.client.get(deps.name), signal);
+        case 2:
+          read = _context4.v;
+          _context4.n = 4;
+          break;
+        case 3:
+          _context4.p = 3;
+          _t8 = _context4.v;
+          return _context4.a(2, {
+            status: "failed",
+            message: messageOf(_t8)
+          });
+        case 4:
+          if (!(read === ABORTED || signal !== null && signal !== void 0 && signal.aborted)) {
+            _context4.n = 5;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 5:
+          staged = read.staged;
+          if (!(!staged || staged.inputs === null)) {
+            _context4.n = 6;
+            break;
+          }
+          return _context4.a(2, {
+            status: "nothing-staged"
+          });
+        case 6:
+          if (staged.buildRequired) {
+            _context4.n = 7;
+            break;
+          }
+          return _context4.a(2, {
+            status: "already-built",
+            hash: null
+          });
+        case 7:
+          inputs = staged.inputs;
+          /** Where the proposal is: served, failed, replaced, or still being built. */
+          settled = function settled(proposal) {
+            var _proposal$built3, _proposal$serverBuild;
+            if (((_proposal$built3 = proposal.built) === null || _proposal$built3 === void 0 ? void 0 : _proposal$built3.inputs) === inputs && proposal.built.hash) {
+              return {
+                status: "built",
+                hash: proposal.built.hash,
+                proposal: proposal
+              };
+            }
+            if (((_proposal$serverBuild = proposal.serverBuild) === null || _proposal$serverBuild === void 0 ? void 0 : _proposal$serverBuild.inputs) === inputs && proposal.serverBuild.state === "failed") {
+              var _proposal$serverBuild2;
+              return {
+                status: "failed",
+                message: (_proposal$serverBuild2 = proposal.serverBuild.error) !== null && _proposal$serverBuild2 !== void 0 ? _proposal$serverBuild2 : "Val Build could not build it."
+              };
+            }
+            // Staged again since (by anyone): this build is not the one to wait for
+            if (proposal.staged && proposal.staged.inputs !== inputs) {
+              return {
+                status: "failed",
+                message: "The proposal's files changed while it was being built. Build it again."
+              };
+            }
+            return null;
+          };
+          _context4.p = 8;
+          _context4.n = 9;
+          return orAborted(deps.client.askBuild(deps.name, inputs), signal);
+        case 9:
+          asked = _context4.v;
+          _context4.n = 12;
+          break;
+        case 10:
+          _context4.p = 10;
+          _t9 = _context4.v;
+          if (!serverBuildsOff(_t9)) {
+            _context4.n = 11;
+            break;
+          }
+          return _context4.a(2, {
+            status: "off"
+          });
+        case 11:
+          return _context4.a(2, {
+            status: "failed",
+            message: messageOf(_t9)
+          });
+        case 12:
+          if (!(asked === ABORTED)) {
+            _context4.n = 13;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 13:
+          // Said only now: a project Val Build does not build never was building there
+          since = now();
+          step({
+            kind: "on-server",
+            since: since
+          });
+          first = settled(asked);
+          if (!(first !== null)) {
+            _context4.n = 14;
+            break;
+          }
+          return _context4.a(2, first);
+        case 14:
+          if (!(now() - since < SERVER_BUILD_WAIT_MS)) {
+            _context4.n = 24;
+            break;
+          }
+          _context4.n = 15;
+          return orAborted(sleep(SERVER_BUILD_POLL_MS), signal);
+        case 15:
+          _t0 = _context4.v;
+          _t1 = ABORTED;
+          if (!(_t0 === _t1)) {
+            _context4.n = 16;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 16:
+          proposal = void 0;
+          _context4.p = 17;
+          _context4.n = 18;
+          return orAborted(deps.client.get(deps.name), signal);
+        case 18:
+          proposal = _context4.v;
+          _context4.n = 21;
+          break;
+        case 19:
+          _context4.p = 19;
+          _t10 = _context4.v;
+          if (gatewayGaveUp(_t10)) {
+            _context4.n = 20;
+            break;
+          }
+          return _context4.a(2, {
+            status: "failed",
+            message: messageOf(_t10)
+          });
+        case 20:
+          step({
+            kind: "on-server",
+            since: since
+          });
+          return _context4.a(3, 14);
+        case 21:
+          if (!(proposal === ABORTED)) {
+            _context4.n = 22;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 22:
+          // Said again, so a watchdog sees it waiting, not stalled.
+          step({
+            kind: "on-server",
+            since: since
+          });
+          outcome = settled(proposal);
+          if (!(outcome !== null)) {
+            _context4.n = 23;
+            break;
+          }
+          return _context4.a(2, outcome);
+        case 23:
+          _context4.n = 14;
+          break;
+        case 24:
+          return _context4.a(2, {
+            status: "failed",
+            message: "Val Build did not finish the build in ".concat(Math.round(SERVER_BUILD_WAIT_MS / 60000), " minutes. Try again.")
+          });
+      }
+    }, _callee4, null, [[17, 19], [8, 10], [1, 3]]);
+  }));
+  return _buildProposalOnServer.apply(this, arguments);
+}
 
 /*
  * A quick preview's files: the proposal's app bundled in the tab, for the
@@ -2782,6 +3035,9 @@ exports.BUILD_CANCELLED_MESSAGE = BUILD_CANCELLED_MESSAGE;
 exports.DEPLOY_STOPPED_MESSAGE = DEPLOY_STOPPED_MESSAGE;
 exports.MergePrepareAnswer = MergePrepareAnswer;
 exports.RENEW_EVERY_MS = RENEW_EVERY_MS;
+exports.SERVER_BUILDS_OFF = SERVER_BUILDS_OFF;
+exports.SERVER_BUILD_POLL_MS = SERVER_BUILD_POLL_MS;
+exports.SERVER_BUILD_WAIT_MS = SERVER_BUILD_WAIT_MS;
 exports.SERVE_POLL_MS = SERVE_POLL_MS;
 exports.SERVE_WAIT_MS = SERVE_WAIT_MS;
 exports.STUDIO_OUT_OF_DATE = STUDIO_OUT_OF_DATE;
@@ -2789,6 +3045,7 @@ exports.STUDIO_OUT_OF_DATE_MESSAGE = STUDIO_OUT_OF_DATE_MESSAGE;
 exports.StudioPublishError = StudioPublishError;
 exports.StudioUploadError = StudioUploadError;
 exports.buildProposal = buildProposal;
+exports.buildProposalOnServer = buildProposalOnServer;
 exports.buildQuickPreview = buildQuickPreview;
 exports.callJson = callJson;
 exports.carriedInto = carriedInto;

package/publish/dist/valbuild-shared-publish.cjs.prod.js

@@ -2309,6 +2309,8 @@ var SERVE_POLL_MS = 5000;
 function buildProposal(_x) {
   return _buildProposal.apply(this, arguments);
 }
+
+/** What content answers, in `details.code`, for a project it does not build yet. */
 function _buildProposal() {
   _buildProposal = createForOfIteratorHelper._asyncToGenerator(/*#__PURE__*/createForOfIteratorHelper._regenerator().m(function _callee3(deps) {
     var _deps$now, _deps$sleep, _deps$onStep;
@@ -2569,6 +2571,257 @@ function _buildProposal() {
   }));
   return _buildProposal.apply(this, arguments);
 }
+var SERVER_BUILDS_OFF = "server-builds-off";
+
+/** How often the proposal is read while the platform builds it. */
+var SERVER_BUILD_POLL_MS = 1000;
+
+/**
+ * How long a build by the platform is waited for. It is seconds
+ * (valbuild/home `docs/plans/server-builds.md`); this is for the platform not
+ * answering, never for a build that is merely slow.
+ */
+var SERVER_BUILD_WAIT_MS = 4 * 60000;
+
+/**
+ * Where a build by the platform is (`buildProposalOnServer`): reading what is
+ * staged, then Val Build building, rendering and serving it. Its own type,
+ * not `ProposalBuildStep`'s, which every page that runs `buildProposal`
+ * switches over.
+ */
+
+/** The calls a build by the platform makes. An error carries content's `status`. */
+
+/**
+ * Whether an error is content saying it does not build this project yet --
+ * or not knowing the request: content from before it built anything refuses
+ * a build without a publish as an invalid body (400). Either way the tab
+ * builds it, as it always did.
+ */
+function serverBuildsOff(error) {
+  var status = statusOf(error);
+  if (status === 400) return true;
+  if (status !== 409) return false;
+  var body = createForOfIteratorHelper._typeof(error) === "object" && error !== null && "body" in error ? error.body : null;
+  var details = createForOfIteratorHelper._typeof(body) === "object" && body !== null && "details" in body ? body.details : null;
+  return createForOfIteratorHelper._typeof(details) === "object" && details !== null && "code" in details && details.code === SERVER_BUILDS_OFF;
+}
+
+/**
+ * Have the platform build the proposal's staged files and serve the build at
+ * its address (valbuild/home `docs/plans/server-builds.md`): nothing is built
+ * in this tab, so no bundler is loaded, no builder tab is opened, and a tab
+ * that closes meanwhile loses nothing.
+ *
+ * Content answers at once and builds in a job; the proposal is read until it
+ * says the build of these inputs is served, or why it is not. `off` when
+ * content does not build this project yet: `buildProposal` builds it in the
+ * tab, as before.
+ *
+ * A cancel stops the waiting, not the build: the platform finishes it, and
+ * the proposal's address serves it when it renders.
+ */
+function buildProposalOnServer(_x2) {
+  return _buildProposalOnServer.apply(this, arguments);
+}
+function _buildProposalOnServer() {
+  _buildProposalOnServer = createForOfIteratorHelper._asyncToGenerator(/*#__PURE__*/createForOfIteratorHelper._regenerator().m(function _callee4(deps) {
+    var _deps$now2, _deps$sleep2, _deps$onStep2;
+    var now, sleep, step, signal, read, staged, inputs, settled, asked, since, first, proposal, outcome, _t8, _t9, _t0, _t1, _t10;
+    return createForOfIteratorHelper._regenerator().w(function (_context4) {
+      while (1) switch (_context4.p = _context4.n) {
+        case 0:
+          now = (_deps$now2 = deps.now) !== null && _deps$now2 !== void 0 ? _deps$now2 : Date.now;
+          sleep = (_deps$sleep2 = deps.sleep) !== null && _deps$sleep2 !== void 0 ? _deps$sleep2 : function (ms) {
+            return new Promise(function (resolve) {
+              return setTimeout(resolve, ms);
+            });
+          };
+          step = (_deps$onStep2 = deps.onStep) !== null && _deps$onStep2 !== void 0 ? _deps$onStep2 : function () {};
+          signal = deps.signal;
+          step({
+            kind: "reading"
+          });
+          // The proposal says what is staged: its files are not needed here
+          _context4.p = 1;
+          _context4.n = 2;
+          return orAborted(deps.client.get(deps.name), signal);
+        case 2:
+          read = _context4.v;
+          _context4.n = 4;
+          break;
+        case 3:
+          _context4.p = 3;
+          _t8 = _context4.v;
+          return _context4.a(2, {
+            status: "failed",
+            message: messageOf(_t8)
+          });
+        case 4:
+          if (!(read === ABORTED || signal !== null && signal !== void 0 && signal.aborted)) {
+            _context4.n = 5;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 5:
+          staged = read.staged;
+          if (!(!staged || staged.inputs === null)) {
+            _context4.n = 6;
+            break;
+          }
+          return _context4.a(2, {
+            status: "nothing-staged"
+          });
+        case 6:
+          if (staged.buildRequired) {
+            _context4.n = 7;
+            break;
+          }
+          return _context4.a(2, {
+            status: "already-built",
+            hash: null
+          });
+        case 7:
+          inputs = staged.inputs;
+          /** Where the proposal is: served, failed, replaced, or still being built. */
+          settled = function settled(proposal) {
+            var _proposal$built3, _proposal$serverBuild;
+            if (((_proposal$built3 = proposal.built) === null || _proposal$built3 === void 0 ? void 0 : _proposal$built3.inputs) === inputs && proposal.built.hash) {
+              return {
+                status: "built",
+                hash: proposal.built.hash,
+                proposal: proposal
+              };
+            }
+            if (((_proposal$serverBuild = proposal.serverBuild) === null || _proposal$serverBuild === void 0 ? void 0 : _proposal$serverBuild.inputs) === inputs && proposal.serverBuild.state === "failed") {
+              var _proposal$serverBuild2;
+              return {
+                status: "failed",
+                message: (_proposal$serverBuild2 = proposal.serverBuild.error) !== null && _proposal$serverBuild2 !== void 0 ? _proposal$serverBuild2 : "Val Build could not build it."
+              };
+            }
+            // Staged again since (by anyone): this build is not the one to wait for
+            if (proposal.staged && proposal.staged.inputs !== inputs) {
+              return {
+                status: "failed",
+                message: "The proposal's files changed while it was being built. Build it again."
+              };
+            }
+            return null;
+          };
+          _context4.p = 8;
+          _context4.n = 9;
+          return orAborted(deps.client.askBuild(deps.name, inputs), signal);
+        case 9:
+          asked = _context4.v;
+          _context4.n = 12;
+          break;
+        case 10:
+          _context4.p = 10;
+          _t9 = _context4.v;
+          if (!serverBuildsOff(_t9)) {
+            _context4.n = 11;
+            break;
+          }
+          return _context4.a(2, {
+            status: "off"
+          });
+        case 11:
+          return _context4.a(2, {
+            status: "failed",
+            message: messageOf(_t9)
+          });
+        case 12:
+          if (!(asked === ABORTED)) {
+            _context4.n = 13;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 13:
+          // Said only now: a project Val Build does not build never was building there
+          since = now();
+          step({
+            kind: "on-server",
+            since: since
+          });
+          first = settled(asked);
+          if (!(first !== null)) {
+            _context4.n = 14;
+            break;
+          }
+          return _context4.a(2, first);
+        case 14:
+          if (!(now() - since < SERVER_BUILD_WAIT_MS)) {
+            _context4.n = 24;
+            break;
+          }
+          _context4.n = 15;
+          return orAborted(sleep(SERVER_BUILD_POLL_MS), signal);
+        case 15:
+          _t0 = _context4.v;
+          _t1 = ABORTED;
+          if (!(_t0 === _t1)) {
+            _context4.n = 16;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 16:
+          proposal = void 0;
+          _context4.p = 17;
+          _context4.n = 18;
+          return orAborted(deps.client.get(deps.name), signal);
+        case 18:
+          proposal = _context4.v;
+          _context4.n = 21;
+          break;
+        case 19:
+          _context4.p = 19;
+          _t10 = _context4.v;
+          if (gatewayGaveUp(_t10)) {
+            _context4.n = 20;
+            break;
+          }
+          return _context4.a(2, {
+            status: "failed",
+            message: messageOf(_t10)
+          });
+        case 20:
+          step({
+            kind: "on-server",
+            since: since
+          });
+          return _context4.a(3, 14);
+        case 21:
+          if (!(proposal === ABORTED)) {
+            _context4.n = 22;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 22:
+          // Said again, so a watchdog sees it waiting, not stalled.
+          step({
+            kind: "on-server",
+            since: since
+          });
+          outcome = settled(proposal);
+          if (!(outcome !== null)) {
+            _context4.n = 23;
+            break;
+          }
+          return _context4.a(2, outcome);
+        case 23:
+          _context4.n = 14;
+          break;
+        case 24:
+          return _context4.a(2, {
+            status: "failed",
+            message: "Val Build did not finish the build in ".concat(Math.round(SERVER_BUILD_WAIT_MS / 60000), " minutes. Try again.")
+          });
+      }
+    }, _callee4, null, [[17, 19], [8, 10], [1, 3]]);
+  }));
+  return _buildProposalOnServer.apply(this, arguments);
+}
 
 /*
  * A quick preview's files: the proposal's app bundled in the tab, for the
@@ -2782,6 +3035,9 @@ exports.BUILD_CANCELLED_MESSAGE = BUILD_CANCELLED_MESSAGE;
 exports.DEPLOY_STOPPED_MESSAGE = DEPLOY_STOPPED_MESSAGE;
 exports.MergePrepareAnswer = MergePrepareAnswer;
 exports.RENEW_EVERY_MS = RENEW_EVERY_MS;
+exports.SERVER_BUILDS_OFF = SERVER_BUILDS_OFF;
+exports.SERVER_BUILD_POLL_MS = SERVER_BUILD_POLL_MS;
+exports.SERVER_BUILD_WAIT_MS = SERVER_BUILD_WAIT_MS;
 exports.SERVE_POLL_MS = SERVE_POLL_MS;
 exports.SERVE_WAIT_MS = SERVE_WAIT_MS;
 exports.STUDIO_OUT_OF_DATE = STUDIO_OUT_OF_DATE;
@@ -2789,6 +3045,7 @@ exports.STUDIO_OUT_OF_DATE_MESSAGE = STUDIO_OUT_OF_DATE_MESSAGE;
 exports.StudioPublishError = StudioPublishError;
 exports.StudioUploadError = StudioUploadError;
 exports.buildProposal = buildProposal;
+exports.buildProposalOnServer = buildProposalOnServer;
 exports.buildQuickPreview = buildQuickPreview;
 exports.callJson = callJson;
 exports.carriedInto = carriedInto;

package/publish/dist/valbuild-shared-publish.esm.js

@@ -2306,6 +2306,8 @@ var SERVE_POLL_MS = 5000;
 function buildProposal(_x) {
   return _buildProposal.apply(this, arguments);
 }
+
+/** What content answers, in `details.code`, for a project it does not build yet. */
 function _buildProposal() {
   _buildProposal = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(deps) {
     var _deps$now, _deps$sleep, _deps$onStep;
@@ -2566,6 +2568,257 @@ function _buildProposal() {
   }));
   return _buildProposal.apply(this, arguments);
 }
+var SERVER_BUILDS_OFF = "server-builds-off";
+
+/** How often the proposal is read while the platform builds it. */
+var SERVER_BUILD_POLL_MS = 1000;
+
+/**
+ * How long a build by the platform is waited for. It is seconds
+ * (valbuild/home `docs/plans/server-builds.md`); this is for the platform not
+ * answering, never for a build that is merely slow.
+ */
+var SERVER_BUILD_WAIT_MS = 4 * 60000;
+
+/**
+ * Where a build by the platform is (`buildProposalOnServer`): reading what is
+ * staged, then Val Build building, rendering and serving it. Its own type,
+ * not `ProposalBuildStep`'s, which every page that runs `buildProposal`
+ * switches over.
+ */
+
+/** The calls a build by the platform makes. An error carries content's `status`. */
+
+/**
+ * Whether an error is content saying it does not build this project yet --
+ * or not knowing the request: content from before it built anything refuses
+ * a build without a publish as an invalid body (400). Either way the tab
+ * builds it, as it always did.
+ */
+function serverBuildsOff(error) {
+  var status = statusOf(error);
+  if (status === 400) return true;
+  if (status !== 409) return false;
+  var body = _typeof(error) === "object" && error !== null && "body" in error ? error.body : null;
+  var details = _typeof(body) === "object" && body !== null && "details" in body ? body.details : null;
+  return _typeof(details) === "object" && details !== null && "code" in details && details.code === SERVER_BUILDS_OFF;
+}
+
+/**
+ * Have the platform build the proposal's staged files and serve the build at
+ * its address (valbuild/home `docs/plans/server-builds.md`): nothing is built
+ * in this tab, so no bundler is loaded, no builder tab is opened, and a tab
+ * that closes meanwhile loses nothing.
+ *
+ * Content answers at once and builds in a job; the proposal is read until it
+ * says the build of these inputs is served, or why it is not. `off` when
+ * content does not build this project yet: `buildProposal` builds it in the
+ * tab, as before.
+ *
+ * A cancel stops the waiting, not the build: the platform finishes it, and
+ * the proposal's address serves it when it renders.
+ */
+function buildProposalOnServer(_x2) {
+  return _buildProposalOnServer.apply(this, arguments);
+}
+function _buildProposalOnServer() {
+  _buildProposalOnServer = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(deps) {
+    var _deps$now2, _deps$sleep2, _deps$onStep2;
+    var now, sleep, step, signal, read, staged, inputs, settled, asked, since, first, proposal, outcome, _t8, _t9, _t0, _t1, _t10;
+    return _regenerator().w(function (_context4) {
+      while (1) switch (_context4.p = _context4.n) {
+        case 0:
+          now = (_deps$now2 = deps.now) !== null && _deps$now2 !== void 0 ? _deps$now2 : Date.now;
+          sleep = (_deps$sleep2 = deps.sleep) !== null && _deps$sleep2 !== void 0 ? _deps$sleep2 : function (ms) {
+            return new Promise(function (resolve) {
+              return setTimeout(resolve, ms);
+            });
+          };
+          step = (_deps$onStep2 = deps.onStep) !== null && _deps$onStep2 !== void 0 ? _deps$onStep2 : function () {};
+          signal = deps.signal;
+          step({
+            kind: "reading"
+          });
+          // The proposal says what is staged: its files are not needed here
+          _context4.p = 1;
+          _context4.n = 2;
+          return orAborted(deps.client.get(deps.name), signal);
+        case 2:
+          read = _context4.v;
+          _context4.n = 4;
+          break;
+        case 3:
+          _context4.p = 3;
+          _t8 = _context4.v;
+          return _context4.a(2, {
+            status: "failed",
+            message: messageOf(_t8)
+          });
+        case 4:
+          if (!(read === ABORTED || signal !== null && signal !== void 0 && signal.aborted)) {
+            _context4.n = 5;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 5:
+          staged = read.staged;
+          if (!(!staged || staged.inputs === null)) {
+            _context4.n = 6;
+            break;
+          }
+          return _context4.a(2, {
+            status: "nothing-staged"
+          });
+        case 6:
+          if (staged.buildRequired) {
+            _context4.n = 7;
+            break;
+          }
+          return _context4.a(2, {
+            status: "already-built",
+            hash: null
+          });
+        case 7:
+          inputs = staged.inputs;
+          /** Where the proposal is: served, failed, replaced, or still being built. */
+          settled = function settled(proposal) {
+            var _proposal$built3, _proposal$serverBuild;
+            if (((_proposal$built3 = proposal.built) === null || _proposal$built3 === void 0 ? void 0 : _proposal$built3.inputs) === inputs && proposal.built.hash) {
+              return {
+                status: "built",
+                hash: proposal.built.hash,
+                proposal: proposal
+              };
+            }
+            if (((_proposal$serverBuild = proposal.serverBuild) === null || _proposal$serverBuild === void 0 ? void 0 : _proposal$serverBuild.inputs) === inputs && proposal.serverBuild.state === "failed") {
+              var _proposal$serverBuild2;
+              return {
+                status: "failed",
+                message: (_proposal$serverBuild2 = proposal.serverBuild.error) !== null && _proposal$serverBuild2 !== void 0 ? _proposal$serverBuild2 : "Val Build could not build it."
+              };
+            }
+            // Staged again since (by anyone): this build is not the one to wait for
+            if (proposal.staged && proposal.staged.inputs !== inputs) {
+              return {
+                status: "failed",
+                message: "The proposal's files changed while it was being built. Build it again."
+              };
+            }
+            return null;
+          };
+          _context4.p = 8;
+          _context4.n = 9;
+          return orAborted(deps.client.askBuild(deps.name, inputs), signal);
+        case 9:
+          asked = _context4.v;
+          _context4.n = 12;
+          break;
+        case 10:
+          _context4.p = 10;
+          _t9 = _context4.v;
+          if (!serverBuildsOff(_t9)) {
+            _context4.n = 11;
+            break;
+          }
+          return _context4.a(2, {
+            status: "off"
+          });
+        case 11:
+          return _context4.a(2, {
+            status: "failed",
+            message: messageOf(_t9)
+          });
+        case 12:
+          if (!(asked === ABORTED)) {
+            _context4.n = 13;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 13:
+          // Said only now: a project Val Build does not build never was building there
+          since = now();
+          step({
+            kind: "on-server",
+            since: since
+          });
+          first = settled(asked);
+          if (!(first !== null)) {
+            _context4.n = 14;
+            break;
+          }
+          return _context4.a(2, first);
+        case 14:
+          if (!(now() - since < SERVER_BUILD_WAIT_MS)) {
+            _context4.n = 24;
+            break;
+          }
+          _context4.n = 15;
+          return orAborted(sleep(SERVER_BUILD_POLL_MS), signal);
+        case 15:
+          _t0 = _context4.v;
+          _t1 = ABORTED;
+          if (!(_t0 === _t1)) {
+            _context4.n = 16;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 16:
+          proposal = void 0;
+          _context4.p = 17;
+          _context4.n = 18;
+          return orAborted(deps.client.get(deps.name), signal);
+        case 18:
+          proposal = _context4.v;
+          _context4.n = 21;
+          break;
+        case 19:
+          _context4.p = 19;
+          _t10 = _context4.v;
+          if (gatewayGaveUp(_t10)) {
+            _context4.n = 20;
+            break;
+          }
+          return _context4.a(2, {
+            status: "failed",
+            message: messageOf(_t10)
+          });
+        case 20:
+          step({
+            kind: "on-server",
+            since: since
+          });
+          return _context4.a(3, 14);
+        case 21:
+          if (!(proposal === ABORTED)) {
+            _context4.n = 22;
+            break;
+          }
+          return _context4.a(2, abortedOutcome(signal));
+        case 22:
+          // Said again, so a watchdog sees it waiting, not stalled.
+          step({
+            kind: "on-server",
+            since: since
+          });
+          outcome = settled(proposal);
+          if (!(outcome !== null)) {
+            _context4.n = 23;
+            break;
+          }
+          return _context4.a(2, outcome);
+        case 23:
+          _context4.n = 14;
+          break;
+        case 24:
+          return _context4.a(2, {
+            status: "failed",
+            message: "Val Build did not finish the build in ".concat(Math.round(SERVER_BUILD_WAIT_MS / 60000), " minutes. Try again.")
+          });
+      }
+    }, _callee4, null, [[17, 19], [8, 10], [1, 3]]);
+  }));
+  return _buildProposalOnServer.apply(this, arguments);
+}
 
 /*
  * A quick preview's files: the proposal's app bundled in the tab, for the
@@ -2774,4 +3027,4 @@ function contentTypeOf(name) {
   return (_CONTENT_TYPES$extens = CONTENT_TYPES[extension]) !== null && _CONTENT_TYPES$extens !== void 0 ? _CONTENT_TYPES$extens : "application/octet-stream";
 }
 
-export { BUILD_CANCELLED_MESSAGE, DEPLOY_STOPPED_MESSAGE, MergePrepareAnswer, RENEW_EVERY_MS, SERVE_POLL_MS, SERVE_WAIT_MS, STUDIO_OUT_OF_DATE, STUDIO_OUT_OF_DATE_MESSAGE, StudioPublishError, StudioUploadError, buildProposal, buildQuickPreview, callJson, carriedInto, clientFilesOf, createStudioJobClient, createStudioPublishClient, isExpiredSlot, isMergeChange, isTransientPublishError, layerMoved, loadedLayer, markStudioOutOfDate, onPublishRefusal, publishApiOf, readLiveLayer, rememberLoadedLayer, resetLoadedLayerForTests, runJobToEnd, runStudioDeploy, runStudioJob, runStudioPublish, siteMovedSinceLoad, splitBinaryFiles, studioOutOfDateRefusals, subscribeStudioOutOfDate, withCommittedFiles, withoutLockfiles };
+export { BUILD_CANCELLED_MESSAGE, DEPLOY_STOPPED_MESSAGE, MergePrepareAnswer, RENEW_EVERY_MS, SERVER_BUILDS_OFF, SERVER_BUILD_POLL_MS, SERVER_BUILD_WAIT_MS, SERVE_POLL_MS, SERVE_WAIT_MS, STUDIO_OUT_OF_DATE, STUDIO_OUT_OF_DATE_MESSAGE, StudioPublishError, StudioUploadError, buildProposal, buildProposalOnServer, buildQuickPreview, callJson, carriedInto, clientFilesOf, createStudioJobClient, createStudioPublishClient, isExpiredSlot, isMergeChange, isTransientPublishError, layerMoved, loadedLayer, markStudioOutOfDate, onPublishRefusal, publishApiOf, readLiveLayer, rememberLoadedLayer, resetLoadedLayerForTests, runJobToEnd, runStudioDeploy, runStudioJob, runStudioPublish, siteMovedSinceLoad, splitBinaryFiles, studioOutOfDateRefusals, subscribeStudioOutOfDate, withCommittedFiles, withoutLockfiles };