@valbuild/shared 0.147.0 → 0.148.2

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-f6254b32.cjs.dev.js');
+var getSitemapTree = require('../../dist/getSitemapTree-a7f2cc6d.cjs.dev.js');
 var core = require('@valbuild/core');
 var zod = require('zod');
 var zodValidationError = require('zod-validation-error');
@@ -266,17 +266,17 @@ function convertImageNode(path, node, files, configDirectory, remoteOptions) {
         if (remoteRef) {
           noParamsUrl = decodeURIComponent(remoteRef);
         } else {
-          console.error("Remote image URL does not contain ref: " + url);
+          core.Internal.log.error("Remote image URL does not contain ref: " + url);
         }
       } else if (noParamsUrl.startsWith("/api/val/files/public")) {
         noParamsUrl = noParamsUrl.slice("/api/val/files".length);
       } else {
-        console.error("Patched image URL does not start with /api/val/files: " + url);
+        core.Internal.log.error("Patched image URL does not start with /api/val/files: " + url);
       }
-    } else if (remoteOptions && noParamsUrl.startsWith(remoteOptions.remoteHost)) ; else if (!noParamsUrl.startsWith("/public")) {
+    } else if (core.Internal.remote.splitRemoteRef(noParamsUrl).status === "success") ; else if (!noParamsUrl.startsWith("/public")) {
       noParamsUrl = "/public".concat(noParamsUrl);
     } else {
-      console.error("Unpatched image URL starts with /public: " + url);
+      core.Internal.log.error("Unpatched image URL starts with /public: " + url);
     }
     var tag = {
       tag: "img",
@@ -1054,6 +1054,10 @@ var PatchBlock = zod.z.object({
   parentRef: ParentRef$1
 });
 
+var SourcePath = zod.z.string().transform(function (path) {
+  return path;
+});
+
 function _objectWithoutPropertiesLoose(r, e) {
   if (null == r) return {};
   var t = {};
@@ -1076,10 +1080,6 @@ function _objectWithoutProperties(e, t) {
   return i;
 }
 
-var SourcePath = zod.z.string().transform(function (path) {
-  return path;
-});
-
 var ModuleFilePath$1 = zod.z.string().transform(function (path) {
   return path;
 });
@@ -1621,7 +1621,7 @@ var ValConfig = zod.z.object({
   gitCommit: zod.z.string().optional(),
   gitBranch: zod.z.string().optional()
 });
-var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("images:check-remote"), zod.z.literal("images:upload-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("video:add-metadata"), zod.z.literal("video:upload-remote"), zod.z.literal("video:download-remote"), zod.z.literal("videos:add-metadata"), zod.z.literal("videos:check-remote"), zod.z.literal("videos:upload-remote"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("files:check-remote"), zod.z.literal("files:upload-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("image:check-gallery"), zod.z.literal("file:check-gallery"), zod.z.literal("video:check-gallery"), zod.z.literal("router:check-route"), zod.z.literal("locale:check-locale"), zod.z.literal("router:check-locale-param"), zod.z.literal("record:fill-keys"), zod.z.literal("images:check-unique-folder"), zod.z.literal("files:check-unique-folder"), zod.z.literal("images:check-all-files"), zod.z.literal("files:check-all-files"), zod.z.literal("videos:check-unique-folder"), zod.z.literal("videos:check-all-files"), zod.z.literal("jsonValues:extract-entry"), zod.z.literal("view:check-module")]);
+var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("images:check-remote"), zod.z.literal("images:upload-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("video:add-metadata"), zod.z.literal("video:upload-remote"), zod.z.literal("video:download-remote"), zod.z.literal("videos:add-metadata"), zod.z.literal("videos:check-remote"), zod.z.literal("videos:upload-remote"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("files:check-remote"), zod.z.literal("files:upload-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("image:check-gallery"), zod.z.literal("file:check-gallery"), zod.z.literal("video:check-gallery"), zod.z.literal("router:check-route"), zod.z.literal("locale:check-locale"), zod.z.literal("router:check-locale-param"), zod.z.literal("record:fill-keys"), zod.z.literal("images:check-unique-folder"), zod.z.literal("files:check-unique-folder"), zod.z.literal("images:check-all-files"), zod.z.literal("files:check-all-files"), zod.z.literal("videos:check-unique-folder"), zod.z.literal("videos:check-all-files"), zod.z.literal("jsonValues:extract-entry"), zod.z.literal("view:check-module"), zod.z.literal("external:upload"), zod.z.literal("remote:rewrite-host")]);
 var ValidationError = zod.z.object({
   message: zod.z.string(),
   value: zod.z.unknown().optional(),
@@ -2023,7 +2023,13 @@ var Api = {
           coreVersion: zod.z.string(),
           remoteFileBuckets: zod.z.array(zod.z.object({
             bucket: zod.z.string()
-          }))
+          })),
+          /**
+           * The host new refs name, from the project's settings: its own
+           * address for a Hosted project whose files are in R2. Optional,
+           * for a content service that predates it.
+           */
+          remoteHost: zod.z.string().optional()
         })
       }), zod.z.object({
         status: zod.z.literal(400),
@@ -2769,6 +2775,105 @@ var Api = {
       })])
     }
   },
+  /**
+   * The Studio's full check, one module per request: its sources against its
+   * schema and its local files against their bytes, on the content the caller
+   * is looking at. See `docs/plans/studio-validate.md`.
+   */
+  "/validate": {
+    POST: {
+      req: {
+        body: zod.z.object({
+          moduleFilePath: ModuleFilePath,
+          /**
+           * The patches the caller is showing, applied over base. Omitted
+           * means every pending patch, as `/sources/~`; empty means base.
+           */
+          patchIds: zod.z.array(PatchId).optional()
+        }),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.union([unauthorizedResponse, notFoundResponse, zod.z.object({
+        status: zod.z.literal(500),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), /** No full check on this server (one running in a browser tab). */
+      zod.z.object({
+        status: zod.z.literal(501),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), zod.z.object({
+        status: zod.z.literal(200),
+        json: zod.z.object({
+          moduleFilePath: ModuleFilePath,
+          errors: zod.z.record(zod.z.string(), zod.z.array(ValidationError)),
+          /** Set when the module's source could not be read at all. */
+          invalidSource: zod.z.string().optional(),
+          /**
+           * Hosts that did not serve this module's remote files: one entry
+           * per host, however many files it holds. Optional so a server
+           * from before remote checks still parses.
+           */
+          remoteHosts: zod.z.array(zod.z.object({
+            host: zod.z.string(),
+            status: zod.z.union([zod.z.literal("missing"), zod.z.literal("unreachable")]),
+            details: zod.z.string(),
+            sourcePaths: zod.z.array(SourcePath)
+          })).optional()
+        })
+      })])
+    }
+  },
+  /**
+   * The patch that fixes one error the full check reported. The server finds
+   * the error again rather than trusting the caller's copy, and builds only the
+   * fixes `STUDIO_FIXES` lists. The patch is returned, not applied: the Studio
+   * adds it as a pending change like any edit.
+   */
+  "/validate/fix": {
+    POST: {
+      req: {
+        body: zod.z.object({
+          moduleFilePath: ModuleFilePath,
+          sourcePath: SourcePath,
+          fix: ValidationFixZ,
+          patchIds: zod.z.array(PatchId).optional()
+        }),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.union([unauthorizedResponse, notFoundResponse, zod.z.object({
+        status: zod.z.literal(400),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), zod.z.object({
+        status: zod.z.literal(500),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), /** No full check on this server (one running in a browser tab). */
+      zod.z.object({
+        status: zod.z.literal(501),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), zod.z.object({
+        status: zod.z.literal(200),
+        json: zod.z.object({
+          patch: Patch,
+          remainingErrors: zod.z.array(ValidationError.extend({
+            sourcePath: zod.z.string().optional()
+          }))
+        })
+      })])
+    }
+  },
   "/publish-job-prepare": {
     POST: {
       req: {
@@ -3823,7 +3928,7 @@ var createValClient = function createValClient(host, config, options) {
               _context2.n = 2;
               break;
             }
-            console.error("Got an invalid request body while validating client-side. This is most likely a Val bug.", {
+            core.Internal.log.error("Got an invalid request body while validating client-side. This is most likely a Val bug.", {
               path: path,
               method: method,
               body: anyReq.body,
@@ -3901,7 +4006,7 @@ var createValClient = function createValClient(host, config, options) {
                         _context.n = 4;
                         break;
                       }
-                      console.error("Server responded with an error", json);
+                      core.Internal.log.error("Server responded with an error", json);
                       message = getErrorMessageFromUnknownJson(json, "Unknown error");
                       return _context.a(2, {
                         status: 500,
@@ -4526,14 +4631,14 @@ function filterRoutesByPatterns(routes, includePattern, excludePattern) {
     try {
       includeRegex = new RegExp(includePattern.source, includePattern.flags);
     } catch (e) {
-      console.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
+      core.Internal.log.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
     }
   }
   if (excludePattern) {
     try {
       excludeRegex = new RegExp(excludePattern.source, excludePattern.flags);
     } catch (e) {
-      console.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
+      core.Internal.log.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
     }
   }
   return routes.filter(function (route) {
@@ -6312,6 +6417,16 @@ function partitionValidationErrors(validationErrors) {
     skipped: skipped
   };
 }
+
+/**
+ * Whether the Studio leaves this error to the server, which repairs it on
+ * save, rather than showing it and holding a publish back for it. One rule
+ * for every gate: `val publish` asks the same question, so the CLI does not
+ * refuse what the Studio would publish.
+ */
+function isRepairedOnSave(error) {
+  return isSkippedFix(error);
+}
 function isSkippedFix(error) {
   var _error$fixes;
   var fixes = (_error$fixes = error.fixes) !== null && _error$fixes !== void 0 ? _error$fixes : [];
@@ -6381,6 +6496,12 @@ function isSkippableFixCode(fix) {
       // under `val external upload` and never under a blanket `--fix`. Surfacing
       // it is the whole point: someone has to decide.
       return false;
+    case "remote:rewrite-host":
+      // Reported only by the server's full check (the Studio's Validate page,
+      // `val validate`), which asks the ref's host -- never by a schema, so
+      // the Studio's own validator never holds one. Were it to, a person has
+      // to see it: the host is gone, and nothing on save repoints the ref.
+      return false;
     default:
       {
         return false;
@@ -6420,6 +6541,33 @@ function filterBlockingValidationErrors(validationErrors, schemas, sources) {
   return partitionValidationErrors(resolved).surfaced;
 }
 
+/**
+ * The fixes the Studio's full check offers a **Fix** button for.
+ *
+ * Each is one `createFixPatch` can build without a disk: it reads a file's
+ * bytes through `FixFiles`, or needs no bytes at all. The server refuses any
+ * other code on `/validate/fix`, and the Studio shows those errors with the
+ * command to run instead of a button — so a code is added here when its fix
+ * can run in http mode and on the platform, not before. See
+ * `docs/plans/studio-validate.md`, "Order of work".
+ */
+var STUDIO_FIXES = ["image:add-metadata", "image:check-metadata", "file:add-metadata", "file:check-metadata", "video:add-metadata", "videos:add-metadata", "view:check-module",
+// A stale remote ref: re-read through `FixFiles.readRemoteFile`, rewritten
+// on the host it was already on.
+"image:check-remote", "file:check-remote",
+// One entry of an `s.imagedir()` / `s.filedir()`: removed when its file is
+// gone, rewritten from its bytes when they disagree. Built for that entry
+// alone, never the whole directory (`fixForStudio`).
+"images:check-all-files", "files:check-all-files",
+// A platform ref on a host that no longer serves its project, pointed at
+// the project's own `valstart.dev` address. Derived from the ref alone.
+"remote:rewrite-host"];
+function isStudioFix(fix) {
+  return STUDIO_FIXES.some(function (studioFix) {
+    return studioFix === fix;
+  });
+}
+
 /**
  * Every decision `encode` makes, with none of the pixels.
  *
@@ -8212,7 +8360,7 @@ function schemaTypesOfPath(schema, patchPath) {
       } else {
         var _unreachable = current;
         var unknownType = _unreachable.type;
-        console.error("Unexecpted resolved schema type: ".concat(unknownType, " in ").concat(patchPath.join("/"), " at ").concat(pathPart));
+        core.Internal.log.error("Unexecpted resolved schema type: ".concat(unknownType, " in ").concat(patchPath.join("/"), " at ").concat(pathPart));
         return new Set([unknownType]);
       }
     }
@@ -8551,9 +8699,9 @@ var PatchSets = /*#__PURE__*/function () {
       } catch (e) {
         // We might be in this situation if the schema changes, etc etc:
         if (e instanceof Error) {
-          console.error("Could not resolve path while creating patch set", e.message);
+          core.Internal.log.error("Could not resolve path while creating patch set", e.message);
         } else {
-          console.error("Could not resolve path while creating patch set", e);
+          core.Internal.log.error("Could not resolve path while creating patch set", e);
         }
         // "terminate" the entire module file path (i.e. all patches are their own patch set)
         this.insertPath(moduleFilePath, [], patchId, createdAt, author, op.op, [schema.type], op.path);
@@ -8838,6 +8986,7 @@ exports.RemirrorTextMark = RemirrorTextMark;
 exports.RestoreVerdict = RestoreVerdict;
 exports.RichTextOptions = RichTextOptions;
 exports.SCHEMA_SOURCE_FIXES = SCHEMA_SOURCE_FIXES;
+exports.STUDIO_FIXES = STUDIO_FIXES;
 exports.SerializedArraySchema = SerializedArraySchema;
 exports.SerializedBooleanSchema = SerializedBooleanSchema;
 exports.SerializedCodeSchema = SerializedCodeSchema;
@@ -8913,8 +9062,10 @@ exports.isInsidePatchSetPath = isInsidePatchSetPath;
 exports.isLocaleSchema = isLocaleSchema;
 exports.isMimeTypeAccepted = isMimeTypeAccepted;
 exports.isRemoteSchema = isRemoteSchema;
+exports.isRepairedOnSave = isRepairedOnSave;
 exports.isSchemaSourceFixError = isSchemaSourceFixError;
 exports.isSkippedSource = isSkippedSource;
+exports.isStudioFix = isStudioFix;
 exports.joinSharedChanges = joinSharedChanges;
 exports.keyOfRecordPath = keyOfRecordPath;
 exports.levenshtein = levenshtein;

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

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var getSitemapTree = require('../../dist/getSitemapTree-109be3b8.cjs.prod.js');
+var getSitemapTree = require('../../dist/getSitemapTree-40d76bf8.cjs.prod.js');
 var core = require('@valbuild/core');
 var zod = require('zod');
 var zodValidationError = require('zod-validation-error');
@@ -266,17 +266,17 @@ function convertImageNode(path, node, files, configDirectory, remoteOptions) {
         if (remoteRef) {
           noParamsUrl = decodeURIComponent(remoteRef);
         } else {
-          console.error("Remote image URL does not contain ref: " + url);
+          core.Internal.log.error("Remote image URL does not contain ref: " + url);
         }
       } else if (noParamsUrl.startsWith("/api/val/files/public")) {
         noParamsUrl = noParamsUrl.slice("/api/val/files".length);
       } else {
-        console.error("Patched image URL does not start with /api/val/files: " + url);
+        core.Internal.log.error("Patched image URL does not start with /api/val/files: " + url);
       }
-    } else if (remoteOptions && noParamsUrl.startsWith(remoteOptions.remoteHost)) ; else if (!noParamsUrl.startsWith("/public")) {
+    } else if (core.Internal.remote.splitRemoteRef(noParamsUrl).status === "success") ; else if (!noParamsUrl.startsWith("/public")) {
       noParamsUrl = "/public".concat(noParamsUrl);
     } else {
-      console.error("Unpatched image URL starts with /public: " + url);
+      core.Internal.log.error("Unpatched image URL starts with /public: " + url);
     }
     var tag = {
       tag: "img",
@@ -1054,6 +1054,10 @@ var PatchBlock = zod.z.object({
   parentRef: ParentRef$1
 });
 
+var SourcePath = zod.z.string().transform(function (path) {
+  return path;
+});
+
 function _objectWithoutPropertiesLoose(r, e) {
   if (null == r) return {};
   var t = {};
@@ -1076,10 +1080,6 @@ function _objectWithoutProperties(e, t) {
   return i;
 }
 
-var SourcePath = zod.z.string().transform(function (path) {
-  return path;
-});
-
 var ModuleFilePath$1 = zod.z.string().transform(function (path) {
   return path;
 });
@@ -1621,7 +1621,7 @@ var ValConfig = zod.z.object({
   gitCommit: zod.z.string().optional(),
   gitBranch: zod.z.string().optional()
 });
-var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("images:check-remote"), zod.z.literal("images:upload-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("video:add-metadata"), zod.z.literal("video:upload-remote"), zod.z.literal("video:download-remote"), zod.z.literal("videos:add-metadata"), zod.z.literal("videos:check-remote"), zod.z.literal("videos:upload-remote"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("files:check-remote"), zod.z.literal("files:upload-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("image:check-gallery"), zod.z.literal("file:check-gallery"), zod.z.literal("video:check-gallery"), zod.z.literal("router:check-route"), zod.z.literal("locale:check-locale"), zod.z.literal("router:check-locale-param"), zod.z.literal("record:fill-keys"), zod.z.literal("images:check-unique-folder"), zod.z.literal("files:check-unique-folder"), zod.z.literal("images:check-all-files"), zod.z.literal("files:check-all-files"), zod.z.literal("videos:check-unique-folder"), zod.z.literal("videos:check-all-files"), zod.z.literal("jsonValues:extract-entry"), zod.z.literal("view:check-module")]);
+var ValidationFixZ = zod.z.union([zod.z.literal("image:add-metadata"), zod.z.literal("image:check-metadata"), zod.z.literal("image:check-remote"), zod.z.literal("image:upload-remote"), zod.z.literal("image:download-remote"), zod.z.literal("images:check-remote"), zod.z.literal("images:upload-remote"), zod.z.literal("file:add-metadata"), zod.z.literal("video:add-metadata"), zod.z.literal("video:upload-remote"), zod.z.literal("video:download-remote"), zod.z.literal("videos:add-metadata"), zod.z.literal("videos:check-remote"), zod.z.literal("videos:upload-remote"), zod.z.literal("file:check-metadata"), zod.z.literal("file:check-remote"), zod.z.literal("file:upload-remote"), zod.z.literal("file:download-remote"), zod.z.literal("files:check-remote"), zod.z.literal("files:upload-remote"), zod.z.literal("keyof:check-keys"), zod.z.literal("image:check-gallery"), zod.z.literal("file:check-gallery"), zod.z.literal("video:check-gallery"), zod.z.literal("router:check-route"), zod.z.literal("locale:check-locale"), zod.z.literal("router:check-locale-param"), zod.z.literal("record:fill-keys"), zod.z.literal("images:check-unique-folder"), zod.z.literal("files:check-unique-folder"), zod.z.literal("images:check-all-files"), zod.z.literal("files:check-all-files"), zod.z.literal("videos:check-unique-folder"), zod.z.literal("videos:check-all-files"), zod.z.literal("jsonValues:extract-entry"), zod.z.literal("view:check-module"), zod.z.literal("external:upload"), zod.z.literal("remote:rewrite-host")]);
 var ValidationError = zod.z.object({
   message: zod.z.string(),
   value: zod.z.unknown().optional(),
@@ -2023,7 +2023,13 @@ var Api = {
           coreVersion: zod.z.string(),
           remoteFileBuckets: zod.z.array(zod.z.object({
             bucket: zod.z.string()
-          }))
+          })),
+          /**
+           * The host new refs name, from the project's settings: its own
+           * address for a Hosted project whose files are in R2. Optional,
+           * for a content service that predates it.
+           */
+          remoteHost: zod.z.string().optional()
         })
       }), zod.z.object({
         status: zod.z.literal(400),
@@ -2769,6 +2775,105 @@ var Api = {
       })])
     }
   },
+  /**
+   * The Studio's full check, one module per request: its sources against its
+   * schema and its local files against their bytes, on the content the caller
+   * is looking at. See `docs/plans/studio-validate.md`.
+   */
+  "/validate": {
+    POST: {
+      req: {
+        body: zod.z.object({
+          moduleFilePath: ModuleFilePath,
+          /**
+           * The patches the caller is showing, applied over base. Omitted
+           * means every pending patch, as `/sources/~`; empty means base.
+           */
+          patchIds: zod.z.array(PatchId).optional()
+        }),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.union([unauthorizedResponse, notFoundResponse, zod.z.object({
+        status: zod.z.literal(500),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), /** No full check on this server (one running in a browser tab). */
+      zod.z.object({
+        status: zod.z.literal(501),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), zod.z.object({
+        status: zod.z.literal(200),
+        json: zod.z.object({
+          moduleFilePath: ModuleFilePath,
+          errors: zod.z.record(zod.z.string(), zod.z.array(ValidationError)),
+          /** Set when the module's source could not be read at all. */
+          invalidSource: zod.z.string().optional(),
+          /**
+           * Hosts that did not serve this module's remote files: one entry
+           * per host, however many files it holds. Optional so a server
+           * from before remote checks still parses.
+           */
+          remoteHosts: zod.z.array(zod.z.object({
+            host: zod.z.string(),
+            status: zod.z.union([zod.z.literal("missing"), zod.z.literal("unreachable")]),
+            details: zod.z.string(),
+            sourcePaths: zod.z.array(SourcePath)
+          })).optional()
+        })
+      })])
+    }
+  },
+  /**
+   * The patch that fixes one error the full check reported. The server finds
+   * the error again rather than trusting the caller's copy, and builds only the
+   * fixes `STUDIO_FIXES` lists. The patch is returned, not applied: the Studio
+   * adds it as a pending change like any edit.
+   */
+  "/validate/fix": {
+    POST: {
+      req: {
+        body: zod.z.object({
+          moduleFilePath: ModuleFilePath,
+          sourcePath: SourcePath,
+          fix: ValidationFixZ,
+          patchIds: zod.z.array(PatchId).optional()
+        }),
+        cookies: {
+          val_session: zod.z.string().optional()
+        }
+      },
+      res: zod.z.union([unauthorizedResponse, notFoundResponse, zod.z.object({
+        status: zod.z.literal(400),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), zod.z.object({
+        status: zod.z.literal(500),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), /** No full check on this server (one running in a browser tab). */
+      zod.z.object({
+        status: zod.z.literal(501),
+        json: zod.z.object({
+          message: zod.z.string()
+        })
+      }), zod.z.object({
+        status: zod.z.literal(200),
+        json: zod.z.object({
+          patch: Patch,
+          remainingErrors: zod.z.array(ValidationError.extend({
+            sourcePath: zod.z.string().optional()
+          }))
+        })
+      })])
+    }
+  },
   "/publish-job-prepare": {
     POST: {
       req: {
@@ -3823,7 +3928,7 @@ var createValClient = function createValClient(host, config, options) {
               _context2.n = 2;
               break;
             }
-            console.error("Got an invalid request body while validating client-side. This is most likely a Val bug.", {
+            core.Internal.log.error("Got an invalid request body while validating client-side. This is most likely a Val bug.", {
               path: path,
               method: method,
               body: anyReq.body,
@@ -3901,7 +4006,7 @@ var createValClient = function createValClient(host, config, options) {
                         _context.n = 4;
                         break;
                       }
-                      console.error("Server responded with an error", json);
+                      core.Internal.log.error("Server responded with an error", json);
                       message = getErrorMessageFromUnknownJson(json, "Unknown error");
                       return _context.a(2, {
                         status: 500,
@@ -4526,14 +4631,14 @@ function filterRoutesByPatterns(routes, includePattern, excludePattern) {
     try {
       includeRegex = new RegExp(includePattern.source, includePattern.flags);
     } catch (e) {
-      console.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
+      core.Internal.log.warn("[Val] Invalid include pattern: /".concat(includePattern.source, "/").concat(includePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed include pattern.");
     }
   }
   if (excludePattern) {
     try {
       excludeRegex = new RegExp(excludePattern.source, excludePattern.flags);
     } catch (e) {
-      console.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
+      core.Internal.log.warn("[Val] Invalid exclude pattern: /".concat(excludePattern.source, "/").concat(excludePattern.flags), "\nError: ".concat(e instanceof Error ? e.message : String(e)), "\nAll routes will be filtered out due to malformed exclude pattern.");
     }
   }
   return routes.filter(function (route) {
@@ -6312,6 +6417,16 @@ function partitionValidationErrors(validationErrors) {
     skipped: skipped
   };
 }
+
+/**
+ * Whether the Studio leaves this error to the server, which repairs it on
+ * save, rather than showing it and holding a publish back for it. One rule
+ * for every gate: `val publish` asks the same question, so the CLI does not
+ * refuse what the Studio would publish.
+ */
+function isRepairedOnSave(error) {
+  return isSkippedFix(error);
+}
 function isSkippedFix(error) {
   var _error$fixes;
   var fixes = (_error$fixes = error.fixes) !== null && _error$fixes !== void 0 ? _error$fixes : [];
@@ -6381,6 +6496,12 @@ function isSkippableFixCode(fix) {
       // under `val external upload` and never under a blanket `--fix`. Surfacing
       // it is the whole point: someone has to decide.
       return false;
+    case "remote:rewrite-host":
+      // Reported only by the server's full check (the Studio's Validate page,
+      // `val validate`), which asks the ref's host -- never by a schema, so
+      // the Studio's own validator never holds one. Were it to, a person has
+      // to see it: the host is gone, and nothing on save repoints the ref.
+      return false;
     default:
       {
         return false;
@@ -6420,6 +6541,33 @@ function filterBlockingValidationErrors(validationErrors, schemas, sources) {
   return partitionValidationErrors(resolved).surfaced;
 }
 
+/**
+ * The fixes the Studio's full check offers a **Fix** button for.
+ *
+ * Each is one `createFixPatch` can build without a disk: it reads a file's
+ * bytes through `FixFiles`, or needs no bytes at all. The server refuses any
+ * other code on `/validate/fix`, and the Studio shows those errors with the
+ * command to run instead of a button — so a code is added here when its fix
+ * can run in http mode and on the platform, not before. See
+ * `docs/plans/studio-validate.md`, "Order of work".
+ */
+var STUDIO_FIXES = ["image:add-metadata", "image:check-metadata", "file:add-metadata", "file:check-metadata", "video:add-metadata", "videos:add-metadata", "view:check-module",
+// A stale remote ref: re-read through `FixFiles.readRemoteFile`, rewritten
+// on the host it was already on.
+"image:check-remote", "file:check-remote",
+// One entry of an `s.imagedir()` / `s.filedir()`: removed when its file is
+// gone, rewritten from its bytes when they disagree. Built for that entry
+// alone, never the whole directory (`fixForStudio`).
+"images:check-all-files", "files:check-all-files",
+// A platform ref on a host that no longer serves its project, pointed at
+// the project's own `valstart.dev` address. Derived from the ref alone.
+"remote:rewrite-host"];
+function isStudioFix(fix) {
+  return STUDIO_FIXES.some(function (studioFix) {
+    return studioFix === fix;
+  });
+}
+
 /**
  * Every decision `encode` makes, with none of the pixels.
  *
@@ -8212,7 +8360,7 @@ function schemaTypesOfPath(schema, patchPath) {
       } else {
         var _unreachable = current;
         var unknownType = _unreachable.type;
-        console.error("Unexecpted resolved schema type: ".concat(unknownType, " in ").concat(patchPath.join("/"), " at ").concat(pathPart));
+        core.Internal.log.error("Unexecpted resolved schema type: ".concat(unknownType, " in ").concat(patchPath.join("/"), " at ").concat(pathPart));
         return new Set([unknownType]);
       }
     }
@@ -8551,9 +8699,9 @@ var PatchSets = /*#__PURE__*/function () {
       } catch (e) {
         // We might be in this situation if the schema changes, etc etc:
         if (e instanceof Error) {
-          console.error("Could not resolve path while creating patch set", e.message);
+          core.Internal.log.error("Could not resolve path while creating patch set", e.message);
         } else {
-          console.error("Could not resolve path while creating patch set", e);
+          core.Internal.log.error("Could not resolve path while creating patch set", e);
         }
         // "terminate" the entire module file path (i.e. all patches are their own patch set)
         this.insertPath(moduleFilePath, [], patchId, createdAt, author, op.op, [schema.type], op.path);
@@ -8838,6 +8986,7 @@ exports.RemirrorTextMark = RemirrorTextMark;
 exports.RestoreVerdict = RestoreVerdict;
 exports.RichTextOptions = RichTextOptions;
 exports.SCHEMA_SOURCE_FIXES = SCHEMA_SOURCE_FIXES;
+exports.STUDIO_FIXES = STUDIO_FIXES;
 exports.SerializedArraySchema = SerializedArraySchema;
 exports.SerializedBooleanSchema = SerializedBooleanSchema;
 exports.SerializedCodeSchema = SerializedCodeSchema;
@@ -8913,8 +9062,10 @@ exports.isInsidePatchSetPath = isInsidePatchSetPath;
 exports.isLocaleSchema = isLocaleSchema;
 exports.isMimeTypeAccepted = isMimeTypeAccepted;
 exports.isRemoteSchema = isRemoteSchema;
+exports.isRepairedOnSave = isRepairedOnSave;
 exports.isSchemaSourceFixError = isSchemaSourceFixError;
 exports.isSkippedSource = isSkippedSource;
+exports.isStudioFix = isStudioFix;
 exports.joinSharedChanges = joinSharedChanges;
 exports.keyOfRecordPath = keyOfRecordPath;
 exports.levenshtein = levenshtein;