@webtypen/webframez-core 0.3.96 → 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/BuildCompiler.js

@@ -18,7 +18,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const node_crypto_1 = __importDefault(require("node:crypto"));
 /** A separate process releases the compiler AST before runtime copies and bundling. */
 function compile({ projectRoot, tsconfig, outDir, buildRoot, root, stagingDir }) {
-    var _a;
+    var _a, _b;
     return __awaiter(this, void 0, void 0, function* () {
         const ts = require(require.resolve("typescript", { paths: [projectRoot, __dirname] }));
         const scope = node_crypto_1.default.createHash("sha256").update(tsconfig).digest("hex").slice(0, 24);
@@ -33,21 +33,32 @@ function compile({ projectRoot, tsconfig, outDir, buildRoot, root, stagingDir })
         // Compact runners may place the source checkout inside the shared cache root.
         const generated = [outDir, buildRoot, inside(root, projectRoot) ? cache : root, parsed.options.outDir].filter(Boolean);
         const files = parsed.fileNames.filter((file) => !generated.some(directory => inside(directory, file)));
-        const key = node_crypto_1.default.createHash("sha256").update(JSON.stringify([files, parsed.options, ts.version])).digest("hex");
+        const key = node_crypto_1.default.createHash("sha256").update(JSON.stringify(["bounded-generated-imports-v1", files, parsed.options, ts.version])).digest("hex");
         const previous = yield promises_1.default.readFile(node_path_1.default.join(cache, "key"), "utf8").catch(() => "");
         if (previous !== key)
             yield promises_1.default.rm(cache, { recursive: true, force: true });
         yield promises_1.default.mkdir(output, { recursive: true });
         console.log(`[webframez] TypeScript cache: ${previous === key ? "reuse" : "cold"} (${files.length} source files)`);
         try {
-            const builder = ts.createIncrementalProgram({ rootNames: files, options: Object.assign(Object.assign({}, parsed.options), { outDir: output, incremental: true, tsBuildInfoFile: node_path_1.default.join(cache, "build.tsbuildinfo") }), projectReferences: parsed.projectReferences });
+            const options = Object.assign(Object.assign({}, parsed.options), { outDir: output, incremental: true, tsBuildInfoFile: node_path_1.default.join(cache, "build.tsbuildinfo") });
+            const host = ts.createIncrementalCompilerHost(options);
+            // JavaScript scripts may require the previous build for smoke checks.
+            // Do not let those imports pull generated code and a second dependency
+            // tree back into compilation. The last good output remains untouched.
+            const hidden = (file) => file !== options.tsBuildInfoFile && generated.some(directory => inside(directory, node_path_1.default.resolve(file)));
+            for (const name of ["fileExists", "directoryExists", "readFile"]) {
+                const original = (_a = host[name]) === null || _a === void 0 ? void 0 : _a.bind(host);
+                if (original)
+                    host[name] = (file) => hidden(file) ? (name === "readFile" ? undefined : false) : original(file);
+            }
+            const builder = ts.createIncrementalProgram({ rootNames: files, options, host, projectReferences: parsed.projectReferences });
             const diagnostics = [...(loaded.error ? [loaded.error] : []), ...parsed.errors, ...builder.getOptionsDiagnostics(), ...builder.getGlobalDiagnostics(), ...builder.getSyntacticDiagnostics(), ...builder.getSemanticDiagnostics()];
             if (diagnostics.length)
                 console.error(ts.formatDiagnosticsWithColorAndContext(diagnostics, { getCanonicalFileName: (name) => name, getCurrentDirectory: () => projectRoot, getNewLine: () => "\n" }));
             if (diagnostics.some((entry) => entry.category === ts.DiagnosticCategory.Error))
                 throw new Error("tsc exited with code 1");
             const emitted = builder.emit();
-            if ((_a = emitted.diagnostics) === null || _a === void 0 ? void 0 : _a.length) {
+            if ((_b = emitted.diagnostics) === null || _b === void 0 ? void 0 : _b.length) {
                 console.error(ts.formatDiagnosticsWithColorAndContext(emitted.diagnostics, { getCanonicalFileName: (name) => name, getCurrentDirectory: () => projectRoot, getNewLine: () => "\n" }));
                 if (emitted.diagnostics.some((entry) => entry.category === ts.DiagnosticCategory.Error))
                     throw new Error("tsc exited with code 1");

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.96",
+    "version": "0.3.100",
     "description": "The core package of the typescript based webframez (web-framework) by webtypen.de",
     "homepage": "https://webtypen.de/",
     "license": "MIT",