@valbuild/server 0.87.5 → 0.89.0

package/README.md

@@ -1,10 +1,9 @@
-# Environment variables
+# Val Server
 
-- VAL_API_KEY (Proxy)
-- VAL_SECRET (Proxy)
-- VAL_GIT_COMMIT
-- VAL_GIT_BRANCH
-- VAL_BUILD_URL
-- VAL_PROJECT (Proxy)
+This package contains Val's integrated server for handling content operations and evaluation.
 
-![val auth flow](val_auth.png "Val Auth flow")
+NOTE: do not use this directly, use the package corresponding to your meta-framework (e.g. Next) instead.
+
+## Contributors
+
+This package provides server-side Val functionality including module evaluation, file watching, and content validation.

package/dist/valbuild-server.cjs.dev.js

@@ -1220,7 +1220,7 @@ export const VERSION = "0.0.0";
       }
       if (modulePath === "@valbuild/react/stega") {
         return {
-          value: "export const useVal = () => { throw Error(`Cannot use 'useVal' in this type of file`) };export const fetchVal = () => { throw Error(`Cannot use 'fetchVal' in this type of file`) }; export const autoTagJSX = () => { /* ignore */ }; export const stegaClean = () => { throw Error(`Cannot use 'stegaClean' in this type of file`) }; export const stegaDecodeString = () => { throw Error(`Cannot use 'stegaDecodeString' in this type of file`) };  export const stegaEncode = () => { throw Error(`Cannot use 'stegaEncode' in this type of file`) }; "
+          value: "export const useVal = () => { throw Error(`Cannot use 'useVal' in this type of file`) };export const fetchVal = () => { throw Error(`Cannot use 'fetchVal' in this type of file`) }; export const autoTagJSX = () => { /* ignore */ }; export const stegaClean = () => { throw Error(`Cannot use 'stegaClean' in this type of file`) }; export const stegaDecodeStrings = () => { throw Error(`Cannot use 'stegaDecodeStrings' in this type of file`) };  export const stegaEncode = () => { throw Error(`Cannot use 'stegaEncode' in this type of file`) }; "
         };
       }
       if (modulePath.startsWith("next/navigation")) {
@@ -1849,6 +1849,52 @@ class ValOps {
         message: `Key '${key}' does not exist in ${sourcePath}.`
       };
     };
+    const checkRouteIsValid = async (route, includePattern, excludePattern) => {
+      // Find all router modules (record schemas with router property)
+      const routerModules = [];
+      for (const [moduleFilePath, schema] of Object.entries(schemas)) {
+        const serializedSchema = schema["executeSerialize"]();
+        if (serializedSchema.type === "record" && serializedSchema.router) {
+          const source = sources[moduleFilePath];
+          if (source && typeof source === "object") {
+            routerModules.push({
+              path: moduleFilePath,
+              routes: Object.keys(source)
+            });
+          }
+        }
+      }
+      if (routerModules.length === 0) {
+        return {
+          error: true,
+          message: `No router modules found. Route validation requires at least one s.record().router() module.`
+        };
+      }
+
+      // Check if route exists in any router module
+      const allRoutes = routerModules.flatMap(m => m.routes);
+      const routeExists = allRoutes.includes(route);
+      if (!routeExists) {
+        // Filter routes by include/exclude patterns for suggestions
+        const validRoutes = internal.filterRoutesByPatterns(allRoutes, includePattern, excludePattern);
+        return {
+          error: true,
+          message: `Route '${route}' does not exist in any router module. Available routes: ${validRoutes.slice(0, 10).join(", ")}${validRoutes.length > 10 ? "..." : ""}`
+        };
+      }
+
+      // Validate against include/exclude patterns
+      const patternValidation = internal.validateRoutePatterns(route, includePattern, excludePattern);
+      if (!patternValidation.valid) {
+        return {
+          error: true,
+          message: patternValidation.message
+        };
+      }
+      return {
+        error: false
+      };
+    };
     const errors = {};
     const files = {};
     const remoteFiles = {};
@@ -1893,7 +1939,7 @@ class ValOps {
         };
         if (validationErrors) {
           for (const validationError of validationErrors) {
-            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3;
+            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3, _validationError$fixe4;
             if (isOnlyFileCheckValidationError(validationError)) {
               if (files[sourcePath]) {
                 throw new Error("Cannot have multiple files with same path. Path: " + sourcePath + "; Module: " + path);
@@ -1944,6 +1990,38 @@ class ValOps {
                   }
                 }
               }
+            } else if ((_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.includes("router:check-route")) {
+              const TYPE_ERROR_MESSAGE = `This is most likely a Val version mismatch or Val bug.`;
+              if (!validationError.value) {
+                addError({
+                  message: `Could not find a value for route at ${sourcePath}. ${TYPE_ERROR_MESSAGE}`,
+                  typeError: true
+                });
+              } else {
+                if (typeof validationError.value !== "object") {
+                  addError({
+                    message: `Expected route validation error to have a 'value' property of type 'object'. Found: ${typeof validationError.value}. ${TYPE_ERROR_MESSAGE}`,
+                    typeError: true
+                  });
+                } else {
+                  const route = "route" in validationError.value && validationError.value.route;
+                  const includePattern = "include" in validationError.value && validationError.value.include;
+                  const excludePattern = "exclude" in validationError.value && validationError.value.exclude;
+                  if (typeof route !== "string") {
+                    addError({
+                      message: `Expected route validation error 'value' to have property 'route' of type 'string'. Found: ${typeof route}. ${TYPE_ERROR_MESSAGE}`,
+                      typeError: true
+                    });
+                  } else {
+                    const res = await checkRouteIsValid(route, includePattern && typeof includePattern === "object" && "source" in includePattern && "flags" in includePattern ? includePattern : undefined, excludePattern && typeof excludePattern === "object" && "source" in excludePattern && "flags" in excludePattern ? excludePattern : undefined);
+                    if (res.error) {
+                      addError({
+                        message: res.message
+                      });
+                    }
+                  }
+                }
+              }
             } else {
               addError(validationError);
             }
@@ -2279,8 +2357,8 @@ class ValOps {
   // #region abstract ops
 }
 function isOnlyFileCheckValidationError(validationError) {
-  var _validationError$fixe4;
-  if ((_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
+  var _validationError$fixe5;
+  if ((_validationError$fixe5 = validationError.fixes) !== null && _validationError$fixe5 !== void 0 && _validationError$fixe5.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
     return true;
   }
   return false;
@@ -4523,7 +4601,7 @@ function hasRemoteFileSchema(schema) {
       }
     }
     return false;
-  } else if (schema.type === "boolean" || schema.type === "number" || schema.type === "string" || schema.type === "literal" || schema.type === "date" || schema.type === "keyOf") {
+  } else if (schema.type === "boolean" || schema.type === "number" || schema.type === "string" || schema.type === "literal" || schema.type === "date" || schema.type === "keyOf" || schema.type === "route") {
     return false;
   } else {
     const exhaustiveCheck = schema;

package/dist/valbuild-server.cjs.prod.js

@@ -1220,7 +1220,7 @@ export const VERSION = "0.0.0";
       }
       if (modulePath === "@valbuild/react/stega") {
         return {
-          value: "export const useVal = () => { throw Error(`Cannot use 'useVal' in this type of file`) };export const fetchVal = () => { throw Error(`Cannot use 'fetchVal' in this type of file`) }; export const autoTagJSX = () => { /* ignore */ }; export const stegaClean = () => { throw Error(`Cannot use 'stegaClean' in this type of file`) }; export const stegaDecodeString = () => { throw Error(`Cannot use 'stegaDecodeString' in this type of file`) };  export const stegaEncode = () => { throw Error(`Cannot use 'stegaEncode' in this type of file`) }; "
+          value: "export const useVal = () => { throw Error(`Cannot use 'useVal' in this type of file`) };export const fetchVal = () => { throw Error(`Cannot use 'fetchVal' in this type of file`) }; export const autoTagJSX = () => { /* ignore */ }; export const stegaClean = () => { throw Error(`Cannot use 'stegaClean' in this type of file`) }; export const stegaDecodeStrings = () => { throw Error(`Cannot use 'stegaDecodeStrings' in this type of file`) };  export const stegaEncode = () => { throw Error(`Cannot use 'stegaEncode' in this type of file`) }; "
         };
       }
       if (modulePath.startsWith("next/navigation")) {
@@ -1849,6 +1849,52 @@ class ValOps {
         message: `Key '${key}' does not exist in ${sourcePath}.`
       };
     };
+    const checkRouteIsValid = async (route, includePattern, excludePattern) => {
+      // Find all router modules (record schemas with router property)
+      const routerModules = [];
+      for (const [moduleFilePath, schema] of Object.entries(schemas)) {
+        const serializedSchema = schema["executeSerialize"]();
+        if (serializedSchema.type === "record" && serializedSchema.router) {
+          const source = sources[moduleFilePath];
+          if (source && typeof source === "object") {
+            routerModules.push({
+              path: moduleFilePath,
+              routes: Object.keys(source)
+            });
+          }
+        }
+      }
+      if (routerModules.length === 0) {
+        return {
+          error: true,
+          message: `No router modules found. Route validation requires at least one s.record().router() module.`
+        };
+      }
+
+      // Check if route exists in any router module
+      const allRoutes = routerModules.flatMap(m => m.routes);
+      const routeExists = allRoutes.includes(route);
+      if (!routeExists) {
+        // Filter routes by include/exclude patterns for suggestions
+        const validRoutes = internal.filterRoutesByPatterns(allRoutes, includePattern, excludePattern);
+        return {
+          error: true,
+          message: `Route '${route}' does not exist in any router module. Available routes: ${validRoutes.slice(0, 10).join(", ")}${validRoutes.length > 10 ? "..." : ""}`
+        };
+      }
+
+      // Validate against include/exclude patterns
+      const patternValidation = internal.validateRoutePatterns(route, includePattern, excludePattern);
+      if (!patternValidation.valid) {
+        return {
+          error: true,
+          message: patternValidation.message
+        };
+      }
+      return {
+        error: false
+      };
+    };
     const errors = {};
     const files = {};
     const remoteFiles = {};
@@ -1893,7 +1939,7 @@ class ValOps {
         };
         if (validationErrors) {
           for (const validationError of validationErrors) {
-            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3;
+            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3, _validationError$fixe4;
             if (isOnlyFileCheckValidationError(validationError)) {
               if (files[sourcePath]) {
                 throw new Error("Cannot have multiple files with same path. Path: " + sourcePath + "; Module: " + path);
@@ -1944,6 +1990,38 @@ class ValOps {
                   }
                 }
               }
+            } else if ((_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.includes("router:check-route")) {
+              const TYPE_ERROR_MESSAGE = `This is most likely a Val version mismatch or Val bug.`;
+              if (!validationError.value) {
+                addError({
+                  message: `Could not find a value for route at ${sourcePath}. ${TYPE_ERROR_MESSAGE}`,
+                  typeError: true
+                });
+              } else {
+                if (typeof validationError.value !== "object") {
+                  addError({
+                    message: `Expected route validation error to have a 'value' property of type 'object'. Found: ${typeof validationError.value}. ${TYPE_ERROR_MESSAGE}`,
+                    typeError: true
+                  });
+                } else {
+                  const route = "route" in validationError.value && validationError.value.route;
+                  const includePattern = "include" in validationError.value && validationError.value.include;
+                  const excludePattern = "exclude" in validationError.value && validationError.value.exclude;
+                  if (typeof route !== "string") {
+                    addError({
+                      message: `Expected route validation error 'value' to have property 'route' of type 'string'. Found: ${typeof route}. ${TYPE_ERROR_MESSAGE}`,
+                      typeError: true
+                    });
+                  } else {
+                    const res = await checkRouteIsValid(route, includePattern && typeof includePattern === "object" && "source" in includePattern && "flags" in includePattern ? includePattern : undefined, excludePattern && typeof excludePattern === "object" && "source" in excludePattern && "flags" in excludePattern ? excludePattern : undefined);
+                    if (res.error) {
+                      addError({
+                        message: res.message
+                      });
+                    }
+                  }
+                }
+              }
             } else {
               addError(validationError);
             }
@@ -2279,8 +2357,8 @@ class ValOps {
   // #region abstract ops
 }
 function isOnlyFileCheckValidationError(validationError) {
-  var _validationError$fixe4;
-  if ((_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
+  var _validationError$fixe5;
+  if ((_validationError$fixe5 = validationError.fixes) !== null && _validationError$fixe5 !== void 0 && _validationError$fixe5.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
     return true;
   }
   return false;
@@ -4523,7 +4601,7 @@ function hasRemoteFileSchema(schema) {
       }
     }
     return false;
-  } else if (schema.type === "boolean" || schema.type === "number" || schema.type === "string" || schema.type === "literal" || schema.type === "date" || schema.type === "keyOf") {
+  } else if (schema.type === "boolean" || schema.type === "number" || schema.type === "string" || schema.type === "literal" || schema.type === "date" || schema.type === "keyOf" || schema.type === "route") {
     return false;
   } else {
     const exhaustiveCheck = schema;

package/dist/valbuild-server.esm.js

@@ -8,7 +8,7 @@ import path__default from 'path';
 import fs, { promises } from 'fs';
 import { transform } from 'sucrase';
 import { VAL_CSS_PATH, VAL_APP_ID, VAL_OVERLAY_ID } from '@valbuild/ui';
-import { Patch, ParentRef, VAL_ENABLE_COOKIE_NAME, VAL_STATE_COOKIE, VAL_SESSION_COOKIE, Api } from '@valbuild/shared/internal';
+import { filterRoutesByPatterns, validateRoutePatterns, Patch, ParentRef, VAL_ENABLE_COOKIE_NAME, VAL_STATE_COOKIE, VAL_SESSION_COOKIE, Api } from '@valbuild/shared/internal';
 import { createUIRequestHandler } from '@valbuild/ui/server';
 import crypto$1 from 'crypto';
 import { z } from 'zod';
@@ -1189,7 +1189,7 @@ export const VERSION = "0.0.0";
       }
       if (modulePath === "@valbuild/react/stega") {
         return {
-          value: "export const useVal = () => { throw Error(`Cannot use 'useVal' in this type of file`) };export const fetchVal = () => { throw Error(`Cannot use 'fetchVal' in this type of file`) }; export const autoTagJSX = () => { /* ignore */ }; export const stegaClean = () => { throw Error(`Cannot use 'stegaClean' in this type of file`) }; export const stegaDecodeString = () => { throw Error(`Cannot use 'stegaDecodeString' in this type of file`) };  export const stegaEncode = () => { throw Error(`Cannot use 'stegaEncode' in this type of file`) }; "
+          value: "export const useVal = () => { throw Error(`Cannot use 'useVal' in this type of file`) };export const fetchVal = () => { throw Error(`Cannot use 'fetchVal' in this type of file`) }; export const autoTagJSX = () => { /* ignore */ }; export const stegaClean = () => { throw Error(`Cannot use 'stegaClean' in this type of file`) }; export const stegaDecodeStrings = () => { throw Error(`Cannot use 'stegaDecodeStrings' in this type of file`) };  export const stegaEncode = () => { throw Error(`Cannot use 'stegaEncode' in this type of file`) }; "
         };
       }
       if (modulePath.startsWith("next/navigation")) {
@@ -1818,6 +1818,52 @@ class ValOps {
         message: `Key '${key}' does not exist in ${sourcePath}.`
       };
     };
+    const checkRouteIsValid = async (route, includePattern, excludePattern) => {
+      // Find all router modules (record schemas with router property)
+      const routerModules = [];
+      for (const [moduleFilePath, schema] of Object.entries(schemas)) {
+        const serializedSchema = schema["executeSerialize"]();
+        if (serializedSchema.type === "record" && serializedSchema.router) {
+          const source = sources[moduleFilePath];
+          if (source && typeof source === "object") {
+            routerModules.push({
+              path: moduleFilePath,
+              routes: Object.keys(source)
+            });
+          }
+        }
+      }
+      if (routerModules.length === 0) {
+        return {
+          error: true,
+          message: `No router modules found. Route validation requires at least one s.record().router() module.`
+        };
+      }
+
+      // Check if route exists in any router module
+      const allRoutes = routerModules.flatMap(m => m.routes);
+      const routeExists = allRoutes.includes(route);
+      if (!routeExists) {
+        // Filter routes by include/exclude patterns for suggestions
+        const validRoutes = filterRoutesByPatterns(allRoutes, includePattern, excludePattern);
+        return {
+          error: true,
+          message: `Route '${route}' does not exist in any router module. Available routes: ${validRoutes.slice(0, 10).join(", ")}${validRoutes.length > 10 ? "..." : ""}`
+        };
+      }
+
+      // Validate against include/exclude patterns
+      const patternValidation = validateRoutePatterns(route, includePattern, excludePattern);
+      if (!patternValidation.valid) {
+        return {
+          error: true,
+          message: patternValidation.message
+        };
+      }
+      return {
+        error: false
+      };
+    };
     const errors = {};
     const files = {};
     const remoteFiles = {};
@@ -1862,7 +1908,7 @@ class ValOps {
         };
         if (validationErrors) {
           for (const validationError of validationErrors) {
-            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3;
+            var _validationError$fixe, _validationError$fixe2, _validationError$fixe3, _validationError$fixe4;
             if (isOnlyFileCheckValidationError(validationError)) {
               if (files[sourcePath]) {
                 throw new Error("Cannot have multiple files with same path. Path: " + sourcePath + "; Module: " + path);
@@ -1913,6 +1959,38 @@ class ValOps {
                   }
                 }
               }
+            } else if ((_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.includes("router:check-route")) {
+              const TYPE_ERROR_MESSAGE = `This is most likely a Val version mismatch or Val bug.`;
+              if (!validationError.value) {
+                addError({
+                  message: `Could not find a value for route at ${sourcePath}. ${TYPE_ERROR_MESSAGE}`,
+                  typeError: true
+                });
+              } else {
+                if (typeof validationError.value !== "object") {
+                  addError({
+                    message: `Expected route validation error to have a 'value' property of type 'object'. Found: ${typeof validationError.value}. ${TYPE_ERROR_MESSAGE}`,
+                    typeError: true
+                  });
+                } else {
+                  const route = "route" in validationError.value && validationError.value.route;
+                  const includePattern = "include" in validationError.value && validationError.value.include;
+                  const excludePattern = "exclude" in validationError.value && validationError.value.exclude;
+                  if (typeof route !== "string") {
+                    addError({
+                      message: `Expected route validation error 'value' to have property 'route' of type 'string'. Found: ${typeof route}. ${TYPE_ERROR_MESSAGE}`,
+                      typeError: true
+                    });
+                  } else {
+                    const res = await checkRouteIsValid(route, includePattern && typeof includePattern === "object" && "source" in includePattern && "flags" in includePattern ? includePattern : undefined, excludePattern && typeof excludePattern === "object" && "source" in excludePattern && "flags" in excludePattern ? excludePattern : undefined);
+                    if (res.error) {
+                      addError({
+                        message: res.message
+                      });
+                    }
+                  }
+                }
+              }
             } else {
               addError(validationError);
             }
@@ -2248,8 +2326,8 @@ class ValOps {
   // #region abstract ops
 }
 function isOnlyFileCheckValidationError(validationError) {
-  var _validationError$fixe4;
-  if ((_validationError$fixe4 = validationError.fixes) !== null && _validationError$fixe4 !== void 0 && _validationError$fixe4.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
+  var _validationError$fixe5;
+  if ((_validationError$fixe5 = validationError.fixes) !== null && _validationError$fixe5 !== void 0 && _validationError$fixe5.every(f => f === "file:check-metadata" || f === "image:check-metadata")) {
     return true;
   }
   return false;
@@ -4492,7 +4570,7 @@ function hasRemoteFileSchema(schema) {
       }
     }
     return false;
-  } else if (schema.type === "boolean" || schema.type === "number" || schema.type === "string" || schema.type === "literal" || schema.type === "date" || schema.type === "keyOf") {
+  } else if (schema.type === "boolean" || schema.type === "number" || schema.type === "string" || schema.type === "literal" || schema.type === "date" || schema.type === "keyOf" || schema.type === "route") {
     return false;
   } else {
     const exhaustiveCheck = schema;

package/package.json

@@ -4,7 +4,7 @@
   "description": "Val - integrated server",
   "repository": {
     "type": "git",
-    "url": "https://github.com/valbuild/val.git"
+    "url": "git+https://github.com/valbuild/val.git"
   },
   "main": "dist/valbuild-server.cjs.js",
   "module": "dist/valbuild-server.esm.js",
@@ -16,7 +16,7 @@
     "./package.json": "./package.json"
   },
   "types": "dist/valbuild-server.cjs.d.ts",
-  "version": "0.87.5",
+  "version": "0.89.0",
   "scripts": {
     "typecheck": "tsc --noEmit",
     "test": "jest",
@@ -27,9 +27,9 @@
     "@types/jest": "^29.2.5"
   },
   "dependencies": {
-    "@valbuild/core": "~0.87.5",
-    "@valbuild/shared": "~0.87.5",
-    "@valbuild/ui": "~0.87.5",
+    "@valbuild/core": "~0.89.0",
+    "@valbuild/shared": "~0.89.0",
+    "@valbuild/ui": "~0.89.0",
     "chokidar": "^4.0.1",
     "image-size": "^1.0.2",
     "minimatch": "^3.0.4",