@webtypen/webframez-core 0.3.97 → 0.3.100

package/README.md

@@ -996,7 +996,10 @@ Metro consumers can call
 `require('@webtypen/webframez-core/build-cache').configureMetroCache(config)`.
 It applies `WEBFRAMEZ_BUILD_MAX_WORKERS` and `WEBFRAMEZ_METRO_CACHE_DIRECTORY`,
 preserving Expo's FileStore implementation and supporting old/new file-map option
-names. Do not pass Expo `--clear` on normal cached builds.
+names. Transform and file-map caches are separated by a stable hash of sorted
+`EXPO_PUBLIC_*`, `NODE_ENV` and `BABEL_ENV` values. The cache version also includes
+this hash for custom/remote stores; public values are not written into path names.
+Private registry credentials do not participate in this build identity. Do not pass Expo `--clear` on normal cached builds.
 
 
 ### Reusable build workspaces
@@ -1024,3 +1027,9 @@ Asset builds use a stable staging directory so bundler caches can reuse module p
 An exclusive per-output lock prevents concurrent builds overwriting that directory.
 After a killed local build, remove its `.webframez-build/.building-*.lock` directory
 only after confirming that no previous build is running. WSM Force Clear removes it.
+
+### Explicit HEAD routes
+
+`Route.head(path, handler, options)` registers metadata-only requests separately from GET.
+Group prefixes, middleware, domain filters and OPTIONS preflight resolution work as for other routes.
+Return headers with `res.header(...)` and finish with `res.end()`; no response body is needed.

package/build-cache.d.ts

@@ -1 +1 @@
-export function configureMetroCache<T extends {cacheStores?: any; maxWorkers?: number}>(config:T, env?:Record<string,string | undefined>):T;
+export function configureMetroCache<T extends {cacheVersion?: string; cacheStores?: any; maxWorkers?: number}>(config:T, env?:Record<string,string | undefined>):T;

package/build-cache.js

@@ -1,15 +1,26 @@
 const path = require("node:path");
 const fs = require("node:fs");
+const crypto = require("node:crypto");
 
 /** Preserve the platform's FileStore subclass (including Expo CSS handling). */
 function configureMetroCache(config, env = process.env) {
+    // Expo inlines public values into transforms. Metro's persistent cache must
+    // not share those transforms between origins or feature configurations.
+    const publicEnvironment = Object.keys(env)
+        .filter(key => key.startsWith("EXPO_PUBLIC_") || key === "NODE_ENV" || key === "BABEL_ENV")
+        .sort()
+        .map(key => [key, env[key]]);
+    const environmentKey = crypto.createHash("sha256").update(JSON.stringify(publicEnvironment)).digest("hex");
+    config.cacheVersion = `${config.cacheVersion || "1.0"}:webframez-public-env-v1:${environmentKey}`;
+
+
     if (env.WEBFRAMEZ_BUILD_MAX_WORKERS !== undefined) {
         const workers = Number(env.WEBFRAMEZ_BUILD_MAX_WORKERS);
         if (!Number.isInteger(workers) || workers < 1 || workers > 64) throw new Error("Invalid WEBFRAMEZ_BUILD_MAX_WORKERS");
         config.maxWorkers = workers;
     }
     if (!env.WEBFRAMEZ_METRO_CACHE_DIRECTORY) return config;
-    const root = path.resolve(env.WEBFRAMEZ_METRO_CACHE_DIRECTORY);
+    const root = path.join(path.resolve(env.WEBFRAMEZ_METRO_CACHE_DIRECTORY), `env-${environmentKey}`);
     const relocate = stores => stores.map((store, index) => {
         // Leave remote and custom stores untouched; their constructors need other options.
         if (!store || typeof store._root !== "string") return store;

package/dist/Router/Route.d.ts

@@ -27,6 +27,8 @@ export declare class RouteFacade {
      * @param options
      */
     get(path: string, component: any, options?: RouteRegistrationOptions): void;
+    /** Register a HEAD route, for metadata without a response body. */
+    head(path: string, component: any, options?: RouteRegistrationOptions): void;
     /** Register the existing DataBuilder POST protocol with request-local configuration. */
     databuilder(path: string, options?: DataBuilderRouteOptions): void;
     /** Register CSRF, model login, logout and refresh using the browser auth contract. */

package/dist/Router/Route.js

@@ -77,6 +77,10 @@ class RouteFacade {
     get(path, component, options) {
         this.registerWithGroupContext("GET", path, component, options);
     }
+    /** Register a HEAD route, for metadata without a response body. */
+    head(path, component, options) {
+        this.registerWithGroupContext("HEAD", path, component, options);
+    }
     /** Register the existing DataBuilder POST protocol with request-local configuration. */
     databuilder(path, options = {}) {
         this.registerWithGroupContext("POST", path, (0, DataBuilderRoute_1.dataBuilderRoute)(options), { middleware: options.middleware, domains: options.domains });

package/dist/Router/Router.d.ts

@@ -43,6 +43,10 @@ declare class RouterFacade {
     routesGET: {
         [key: string]: RouteObject[];
     };
+    /** Explicit HEAD routes, with the same middleware and domain matching as GET. */
+    routesHEAD: {
+        [key: string]: RouteObject[];
+    };
     /**
      * POST Route Store
      */

package/dist/Router/Router.js

@@ -53,6 +53,8 @@ class RouterFacade {
          * GET Route Store
          */
         this.routesGET = {};
+        /** Explicit HEAD routes, with the same middleware and domain matching as GET. */
+        this.routesHEAD = {};
         /**
          * POST Route Store
          */
@@ -86,6 +88,7 @@ class RouterFacade {
                 ? options.maxRequestBodySizeBytes
                 : 10 * 1024 * 1024;
         this.routesGET = {};
+        this.routesHEAD = {};
         this.routesPOST = {};
         this.routesPUT = {};
         this.routesPATCH = {};
@@ -153,6 +156,12 @@ class RouterFacade {
             }
             this.routesGET[path].push(routeConf);
         }
+        else if (type === "HEAD") {
+            if (!this.routesHEAD[path]) {
+                this.routesHEAD[path] = [];
+            }
+            this.routesHEAD[path].push(routeConf);
+        }
         else if (type === "POST") {
             if (!this.routesPOST[path]) {
                 this.routesPOST[path] = [];
@@ -196,6 +205,9 @@ class RouterFacade {
         if (req.method === "GET") {
             return this.dissolveRoute(this.routesGET, cleanUrl, req);
         }
+        else if (req.method === "HEAD") {
+            return this.dissolveRoute(this.routesHEAD, cleanUrl, req);
+        }
         else if (req.method === "POST") {
             return this.dissolveRoute(this.routesPOST, cleanUrl, req);
         }
@@ -212,6 +224,9 @@ class RouterFacade {
             if (req.headers["access-control-request-method"] === "GET") {
                 return this.dissolveRoute(this.routesGET, cleanUrl, req);
             }
+            else if (req.headers["access-control-request-method"] === "HEAD") {
+                return this.dissolveRoute(this.routesHEAD, cleanUrl, req);
+            }
             else if (req.headers["access-control-request-method"] === "POST") {
                 return this.dissolveRoute(this.routesPOST, cleanUrl, req);
             }

package/dist/index.d.ts

@@ -76,3 +76,4 @@ export { ModelForm, ModelFormContext, ModelFormConstructor } from "./DataBuilder
 export { Field, Validates, Forms, DataBuilderFieldOptions } from "./DataBuilder/decorators";
 export { DataBuilderRouteOptions } from "./DataBuilder/DataBuilderRoute";
 export { LegacyFieldTypeAdapter } from "./DataBuilder/LegacyFieldTypeAdapter";
+export { defaultFormFields } from "./DataBuilder/formScope";

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LegacyFieldTypeAdapter = exports.Forms = exports.Validates = exports.Field = exports.ModelForm = void 0;
+exports.defaultFormFields = exports.LegacyFieldTypeAdapter = exports.Forms = exports.Validates = exports.Field = exports.ModelForm = void 0;
 __exportStar(require("./Config"), exports);
 __exportStar(require("./Functions/DateFunctions"), exports);
 __exportStar(require("./Functions/FileFunctions"), exports);
@@ -96,3 +96,5 @@ Object.defineProperty(exports, "Validates", { enumerable: true, get: function ()
 Object.defineProperty(exports, "Forms", { enumerable: true, get: function () { return decorators_1.Forms; } });
 var LegacyFieldTypeAdapter_1 = require("./DataBuilder/LegacyFieldTypeAdapter");
 Object.defineProperty(exports, "LegacyFieldTypeAdapter", { enumerable: true, get: function () { return LegacyFieldTypeAdapter_1.LegacyFieldTypeAdapter; } });
+var formScope_1 = require("./DataBuilder/formScope");
+Object.defineProperty(exports, "defaultFormFields", { enumerable: true, get: function () { return formScope_1.defaultFormFields; } });

package/docs/databuilder.md

@@ -32,6 +32,11 @@ Metadata is inherited without mutating parent definitions. Decorated definitions
 
 Without registered forms or legacy `__forms`, decorated models get a default form containing their fields, including child layouts. Existing `__schema` still carries version, collection, hooks, aggregation, uniqueness, new-data and deletion behavior. Defining `static forms = () => [UserProfileForm]` is an alternative to `@Forms()`; the decorator takes precedence.
 
+For dynamic sections inside an explicit layout, import `defaultFormFields` from
+`@webtypen/webframez-core` and use `{ field: "attributes", fields: defaultFormFields(attributeSchema) }`.
+It recursively supplies the `fields` layouts for object and array schemas, including
+objects inside array entries. It does not modify the schema or populate data values.
+
 ## Server-side form classes
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@webtypen/webframez-core",
-    "version": "0.3.97",
+    "version": "0.3.100",
     "description": "The core package of the typescript based webframez (web-framework) by webtypen.de",
     "homepage": "https://webtypen.de/",
     "license": "MIT",