@valbuild/server 0.147.0 → 0.148.0

package/dist/declarations/src/studioValidation.d.ts

@@ -0,0 +1,84 @@
+import { ModuleFilePath, SourcePath, ValidationError, ValidationFix } from "@valbuild/core";
+import type { Patch } from "@valbuild/core/patch";
+import { FixPatchRemainingError } from "./createFixPatch.js";
+import type { FixFiles } from "./fixFiles.js";
+import { type RemoteHostProblem, type RemoteNetwork } from "./remoteFileCheck.js";
+import { type PatchAnalysis, type Schemas, type Sources, type ValOps } from "./ValOps.js";
+/**
+ * The Studio's full check, one module at a time: what `/validate` and
+ * `/validate/fix` answer with. See `docs/plans/studio-validate.md`.
+ *
+ * Both take the sources the caller is looking at — base plus the patches it
+ * names — so an error is about the content on the editor's screen, and a fix
+ * is a patch on top of it.
+ */
+export type StudioCheckInput = {
+    moduleFilePath: ModuleFilePath;
+    schemas: Schemas;
+    sources: Sources;
+    fileLastUpdatedByPatchId: PatchAnalysis["fileLastUpdatedByPatchId"];
+    /** How remote hosts are asked about refs. Tests replace it. */
+    network?: RemoteNetwork;
+};
+export type StudioModuleCheck = {
+    status: "ok";
+    errors: Record<SourcePath, ValidationError[]>;
+    /** Hosts that did not serve this module's remote files. */
+    remoteHosts: RemoteHostProblem[];
+} | {
+    status: "unknown-module";
+} | {
+    status: "invalid-source";
+    message: string;
+};
+/**
+ * Every error in one module: its sources against its schema, and its local
+ * files against their bytes.
+ *
+ * Not filtered the way the publish gate filters (`partitionValidationErrors`):
+ * the errors the gate hides because "the server repairs them on save" are the
+ * ones this check exists to show, since nothing repairs them in http mode.
+ *
+ * Remote files are checked too: a stale ref is an error with a fix, and a
+ * host that does not serve them is reported once, as a host, rather than as
+ * an error on every image it holds (`checkRemoteFiles`).
+ *
+ * Not yet here: the media directories' own entries, step 5 of the plan.
+ */
+export declare function checkModuleForStudio(ops: ValOps, input: StudioCheckInput): Promise<StudioModuleCheck>;
+export type StudioFixResult = {
+    status: "ok";
+    patch: Patch;
+    remainingErrors: FixPatchRemainingError[];
+} | {
+    status: "unknown-module";
+} | {
+    status: "not-in-studio";
+} | {
+    status: "not-found";
+};
+/**
+ * The patch that fixes one error, built from the server's own reading of the
+ * module rather than from the error the caller saw.
+ *
+ * The caller names the error by where it is and which fix it wants; the error
+ * itself is found again here. That is what keeps a stale or hand-written
+ * request from steering `createFixPatch` (CLAUDE.md, "Adding a ValidationFix
+ * code"), and it is what lets an error reported at a FIELD be fixed at the
+ * media value it belongs to: `validateFiles` reports a wrong width at
+ * `…"hero"."width"`, while the fix rewrites `…"hero"`.
+ *
+ * Only {@link isStudioFix} codes are built. The others need a disk or a
+ * remote host this server may not have, and are the CLI's for now.
+ */
+export declare function fixForStudio(ops: ValOps, input: StudioCheckInput & {
+    sourcePath: SourcePath;
+    fix: ValidationFix;
+}): Promise<StudioFixResult>;
+/**
+ * {@link FixFiles} over whatever store this server has: the disk in fs mode,
+ * the content service in http mode. A file a pending patch wrote is read from
+ * that patch, as `validateFiles` reads it, so a fix is made from the bytes
+ * the check was made from.
+ */
+export declare function opsFixFiles(ops: ValOps, fileLastUpdatedByPatchId: PatchAnalysis["fileLastUpdatedByPatchId"]): FixFiles;

package/dist/declarations/src/uploadRemoteFile.d.ts

@@ -1,4 +1,4 @@
-export declare function uploadRemoteFile(contentHost: string, project: string, bucket: string, fileHash: string, fileExt: string, fileBuffer: Buffer, auth: {
+export declare function uploadRemoteFile(contentHost: string, project: string, bucket: string, fileHash: string, fileExt: string, fileBuffer: Uint8Array, auth: {
     pat: string;
 } | {
     apiKey: string;

package/dist/declarations/src/videosetFixes.d.ts

@@ -1,6 +1,7 @@
 import { type ModuleFilePath, type SerializedRecordSchema, type SerializedSchema, type SerializedVideoSchema, type Source, type SourcePath, type ValidationError } from "@valbuild/core";
 import { type Patch } from "@valbuild/core/patch";
 import type { FixPatchRemainingError } from "./createFixPatch.js";
+import type { FixFiles } from "./fixFiles.js";
 import type { FixHandlerContext, FixHandlerResult, ModulePatch } from "./fixHandlers.js";
 import { type GalleryEntryKey } from "./galleryEntryKey.js";
 import type { Service } from "./Service.js";
@@ -129,8 +130,8 @@ export declare function videosetCheckAllFilesPatch({ projectRoot, apply, sourceP
  * from the file at the entry's KEY, and write only that, one op per field —
  * `alt` and anything already there are someone's, and stay.
  */
-export declare function videosetAddMetadataPatch({ projectRoot, sourcePath, validationError, moduleSource, moduleSchema, }: {
-    projectRoot: string;
+export declare function videosetAddMetadataPatch({ files, sourcePath, validationError, moduleSource, moduleSchema, }: {
+    files: FixFiles;
     sourcePath: SourcePath;
     validationError: ValidationError;
     moduleSource: Source | undefined;

package/dist/{getJsonEntryAtCommit-df65d861.cjs.prod.js → getJsonEntryAtCommit-2e36e805.cjs.prod.js}

@@ -1,10 +1,9 @@
 'use strict';
 
 var ts = require('typescript');
-var ValRouterCore = require('./ValRouterCore-7ffcc08c.cjs.prod.js');
+var ValRouterCore = require('./ValRouterCore-42772c21.cjs.prod.js');
 var fp = require('@valbuild/core/fp');
 var jsonValuesModule = require('./jsonValuesModule-d1bb8d8f.cjs.prod.js');
-require('buffer');
 require('@valbuild/core');
 require('@valbuild/shared/internal');
 require('zod');
@@ -55,7 +54,7 @@ async function getJsonEntryAtCommit(ops, commitSha, moduleFilePath, key) {
   if (fp.result.isErr(moduleRes)) {
     return moduleRes;
   }
-  const entryPath = findEntryImportPath(moduleFilePath, moduleGitPath.value, moduleRes.value.toString("utf-8"), key);
+  const entryPath = findEntryImportPath(moduleFilePath, moduleGitPath.value, ValRouterCore.bytesToUtf8(moduleRes.value), key);
   if (fp.result.isErr(entryPath)) {
     return entryPath;
   }
@@ -73,7 +72,7 @@ async function getJsonEntryAtCommit(ops, commitSha, moduleFilePath, key) {
     return entryRes;
   }
   try {
-    return fp.result.ok(JSON.parse(entryRes.value.toString("utf-8")));
+    return fp.result.ok(JSON.parse(ValRouterCore.bytesToUtf8(entryRes.value)));
   } catch (err) {
     return fp.result.err({
       kind: "file-unavailable",

package/dist/{getJsonEntryAtCommit-1e08d724.esm.js → getJsonEntryAtCommit-40b6d9c1.esm.js}

@@ -1,8 +1,7 @@
 import ts from 'typescript';
-import { x as posixPath } from './ValRouterCore-f5004f8f.esm.js';
+import { F as bytesToUtf8, G as posixPath } from './ValRouterCore-7ca3dc68.esm.js';
 import { result } from '@valbuild/core/fp';
 import { a as analyzeValModule, c as analyzeJsonValuesEntries } from './jsonValuesModule-427d68c8.esm.js';
-import 'buffer';
 import '@valbuild/core';
 import '@valbuild/shared/internal';
 import 'zod';
@@ -49,7 +48,7 @@ async function getJsonEntryAtCommit(ops, commitSha, moduleFilePath, key) {
   if (result.isErr(moduleRes)) {
     return moduleRes;
   }
-  const entryPath = findEntryImportPath(moduleFilePath, moduleGitPath.value, moduleRes.value.toString("utf-8"), key);
+  const entryPath = findEntryImportPath(moduleFilePath, moduleGitPath.value, bytesToUtf8(moduleRes.value), key);
   if (result.isErr(entryPath)) {
     return entryPath;
   }
@@ -67,7 +66,7 @@ async function getJsonEntryAtCommit(ops, commitSha, moduleFilePath, key) {
     return entryRes;
   }
   try {
-    return result.ok(JSON.parse(entryRes.value.toString("utf-8")));
+    return result.ok(JSON.parse(bytesToUtf8(entryRes.value)));
   } catch (err) {
     return result.err({
       kind: "file-unavailable",

package/dist/{getJsonEntryAtCommit-e96beb9e.cjs.dev.js → getJsonEntryAtCommit-64f67a50.cjs.dev.js}

@@ -1,10 +1,9 @@
 'use strict';
 
 var ts = require('typescript');
-var ValRouterCore = require('./ValRouterCore-3fd3d444.cjs.dev.js');
+var ValRouterCore = require('./ValRouterCore-9bdaaf89.cjs.dev.js');
 var fp = require('@valbuild/core/fp');
 var jsonValuesModule = require('./jsonValuesModule-8ae503a8.cjs.dev.js');
-require('buffer');
 require('@valbuild/core');
 require('@valbuild/shared/internal');
 require('zod');
@@ -55,7 +54,7 @@ async function getJsonEntryAtCommit(ops, commitSha, moduleFilePath, key) {
   if (fp.result.isErr(moduleRes)) {
     return moduleRes;
   }
-  const entryPath = findEntryImportPath(moduleFilePath, moduleGitPath.value, moduleRes.value.toString("utf-8"), key);
+  const entryPath = findEntryImportPath(moduleFilePath, moduleGitPath.value, ValRouterCore.bytesToUtf8(moduleRes.value), key);
   if (fp.result.isErr(entryPath)) {
     return entryPath;
   }
@@ -73,7 +72,7 @@ async function getJsonEntryAtCommit(ops, commitSha, moduleFilePath, key) {
     return entryRes;
   }
   try {
-    return fp.result.ok(JSON.parse(entryRes.value.toString("utf-8")));
+    return fp.result.ok(JSON.parse(ValRouterCore.bytesToUtf8(entryRes.value)));
   } catch (err) {
     return fp.result.err({
       kind: "file-unavailable",