@lowdefy/build 4.5.2 → 4.6.0

package/dist/build/jit/shallowBuild.js

@@ -0,0 +1,245 @@
+/* eslint-disable no-console */ /*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { BuildError, LowdefyInternalError } from '@lowdefy/errors';
+import createContext from '../../createContext.js';
+import logCollectedErrors from '../../utils/logCollectedErrors.js';
+import makeId from '../../utils/makeId.js';
+import tryBuildStep from '../../utils/tryBuildStep.js';
+import addDefaultPages from '../addDefaultPages/addDefaultPages.js';
+import addKeys from '../addKeys.js';
+import buildApp from '../buildApp.js';
+import buildAuth from '../buildAuth/buildAuth.js';
+import buildConnections from '../buildConnections.js';
+import buildApi from '../buildApi/buildApi.js';
+import buildLogger from '../buildLogger.js';
+import buildImports from '../buildImports/buildImports.js';
+import buildMenu from '../buildMenu.js';
+import buildRefs from '../buildRefs/buildRefs.js';
+import buildTypes from '../buildTypes.js';
+import cleanBuildDirectory from '../cleanBuildDirectory.js';
+import copyPublicFolder from '../copyPublicFolder.js';
+import testSchema from '../testSchema.js';
+import validateConfig from '../validateConfig.js';
+import writeApp from '../writeApp.js';
+import writeAuth from '../writeAuth.js';
+import writeConfig from '../writeConfig.js';
+import writeConnections from '../writeConnections.js';
+import writeApi from '../writeApi.js';
+import writeGlobal from '../writeGlobal.js';
+import writeJs from '../buildJs/writeJs.js';
+import writeLogger from '../writeLogger.js';
+import writeMaps from '../writeMaps.js';
+import updateServerPackageJson from '../full/updateServerPackageJson.js';
+import writeMenus from '../writeMenus.js';
+import writePageRegistry from './writePageRegistry.js';
+import writePluginImports from '../writePluginImports/writePluginImports.js';
+import addInstalledTypes from './addInstalledTypes.js';
+import buildJsShallow from './buildJsShallow.js';
+import buildShallowPages from './buildShallowPages.js';
+import stripPageContent from './stripPageContent.js';
+import writeSourcelessPages from './writeSourcelessPages.js';
+async function shallowBuild(options) {
+    makeId.reset();
+    let context;
+    try {
+        context = createContext(options);
+        let components;
+        try {
+            components = await buildRefs({
+                context,
+                shallowOptions: true
+            });
+        } catch (err) {
+            if (err.isLowdefyError) {
+                context.handleError(err);
+                throw new BuildError('Build failed with 1 error(s). See above for details.');
+            }
+            throw err;
+        }
+        // addKeys + testSchema first for error location info
+        tryBuildStep(addKeys, 'addKeys', {
+            components,
+            context
+        });
+        stripPageContent({
+            components
+        });
+        tryBuildStep(testSchema, 'testSchema', {
+            components,
+            context
+        });
+        logCollectedErrors(context);
+        // Build skeleton steps (everything except page content)
+        tryBuildStep(buildApp, 'buildApp', {
+            components,
+            context
+        });
+        tryBuildStep(buildLogger, 'buildLogger', {
+            components,
+            context
+        });
+        tryBuildStep(validateConfig, 'validateConfig', {
+            components,
+            context
+        });
+        tryBuildStep(addDefaultPages, 'addDefaultPages', {
+            components,
+            context
+        });
+        tryBuildStep(addKeys, 'addKeys', {
+            components,
+            context
+        });
+        tryBuildStep(buildAuth, 'buildAuth', {
+            components,
+            context
+        });
+        tryBuildStep(buildConnections, 'buildConnections', {
+            components,
+            context
+        });
+        tryBuildStep(buildApi, 'buildApi', {
+            components,
+            context
+        });
+        const { pageRegistry, sourcelessPageArtifacts } = buildShallowPages({
+            components,
+            context
+        });
+        tryBuildStep(buildJsShallow, 'buildJsShallow', {
+            components,
+            context
+        });
+        tryBuildStep(buildMenu, 'buildMenu', {
+            components,
+            context
+        });
+        tryBuildStep(buildTypes, 'buildTypes', {
+            components,
+            context
+        });
+        // Update server package.json before addInstalledTypes so that addInstalledTypes
+        // sees the full set of dependencies on every run (not just after the first build).
+        // This prevents plugin import files from differing between the initial and
+        // subsequent builds, which would trigger unnecessary Next.js rebuilds.
+        await updateServerPackageJson({
+            components,
+            context
+        });
+        tryBuildStep(addInstalledTypes, 'addInstalledTypes', {
+            components,
+            context
+        });
+        tryBuildStep(buildImports, 'buildImports', {
+            components,
+            context
+        });
+        tryBuildStep(addKeys, 'addKeys', {
+            components,
+            context
+        });
+        logCollectedErrors(context);
+        // Write all build artifacts
+        await cleanBuildDirectory({
+            context
+        });
+        await writeSourcelessPages({
+            sourcelessPageArtifacts,
+            context
+        });
+        await writeApp({
+            components,
+            context
+        });
+        await writeAuth({
+            components,
+            context
+        });
+        await writeConnections({
+            components,
+            context
+        });
+        await writeApi({
+            components,
+            context
+        });
+        await writeConfig({
+            components,
+            context
+        });
+        await writeGlobal({
+            components,
+            context
+        });
+        await writeLogger({
+            components,
+            context
+        });
+        await writeMaps({
+            context
+        });
+        await context.writeBuildArtifact('connectionIds.json', JSON.stringify([
+            ...context.connectionIds
+        ]));
+        await writeMenus({
+            components,
+            context
+        });
+        await writeJs({
+            context
+        });
+        await context.writeBuildArtifact('jsMap.json', JSON.stringify(context.jsMap));
+        await context.writeBuildArtifact('customTypesMap.json', JSON.stringify(options.customTypesMap ?? {}));
+        // Persist snapshot of installed packages for JIT missing-package detection.
+        // Written as a build artifact so JIT builds compare against the skeleton
+        // build state, not a potentially-updated package.json (race condition).
+        await context.writeBuildArtifact('installedPluginPackages.json', JSON.stringify([
+            ...context.installedPackages ?? []
+        ]));
+        await writePluginImports({
+            components,
+            context
+        });
+        await writePageRegistry({
+            pageRegistry,
+            context
+        });
+        await copyPublicFolder({
+            components,
+            context
+        });
+        return {
+            components,
+            pageRegistry,
+            context
+        };
+    } catch (err) {
+        if (err instanceof BuildError) {
+            throw err;
+        }
+        // Unexpected internal error - preserve Lowdefy errors as-is, wrap plain errors
+        const lowdefyErr = err.isLowdefyError ? err : new LowdefyInternalError(err.message, {
+            cause: err
+        });
+        if (context) {
+            context.handleError(lowdefyErr);
+        } else {
+            const logger = options.logger ?? console;
+            logger.error(lowdefyErr);
+        }
+        throw new BuildError('Build failed due to internal error. See above for details.');
+    }
+}
+export default shallowBuild;

package/dist/build/jit/stripPageContent.js

@@ -0,0 +1,23 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import PAGE_CONTENT_KEYS from './pageContentKeys.js';
+function stripPageContent({ components }) {
+    for (const page of components.pages ?? []){
+        for (const key of PAGE_CONTENT_KEYS){
+            delete page[key];
+        }
+    }
+}
+export default stripPageContent;

package/dist/build/jit/updateServerPackageJsonJit.js

@@ -0,0 +1,33 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import path from 'path';
+import { readFile, writeFile } from '@lowdefy/node-utils';
+async function updateServerPackageJsonJit({ directories, missingPackages }) {
+    const filePath = path.join(directories.server, 'package.json');
+    const packageJsonContent = await readFile(filePath);
+    const packageJson = JSON.parse(packageJsonContent);
+    const dependencies = packageJson.dependencies ?? {};
+    for (const [packageName, { version }] of missingPackages){
+        dependencies[packageName] = version;
+    }
+    // Sort dependencies alphabetically
+    packageJson.dependencies = {};
+    Object.keys(dependencies).sort().forEach((name)=>{
+        packageJson.dependencies[name] = dependencies[name];
+    });
+    const newPackageJsonContent = JSON.stringify(packageJson, null, 2).concat('\n');
+    await writeFile(filePath, newPackageJsonContent);
+}
+export default updateServerPackageJsonJit;

package/dist/build/jit/validatePageTypes.js

@@ -0,0 +1,73 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { ConfigError, ConfigWarning } from '@lowdefy/errors';
+import findSimilarString from '../../utils/findSimilarString.js';
+function validateTypeClass({ context, counter, definitions, typeClass, warnIfMissing = false }) {
+    const counts = counter.getCounts();
+    const definedTypes = Object.keys(definitions);
+    for (const typeName of Object.keys(counts)){
+        if (!definitions[typeName]) {
+            const configKey = counter.getLocation(typeName);
+            let message = `${typeClass} type "${typeName}" was used but is not defined.`;
+            const suggestion = findSimilarString({
+                input: typeName,
+                candidates: definedTypes
+            });
+            if (suggestion) {
+                message += ` Did you mean "${suggestion}"?`;
+            }
+            if (warnIfMissing) {
+                context.handleWarning(new ConfigWarning(message, {
+                    configKey,
+                    checkSlug: 'types'
+                }));
+                continue;
+            }
+            throw new ConfigError(message, {
+                configKey
+            });
+        }
+    }
+}
+function validatePageTypes({ context }) {
+    const { typeCounters, typesMap } = context;
+    validateTypeClass({
+        context,
+        counter: typeCounters.blocks,
+        definitions: typesMap.blocks,
+        typeClass: 'Block'
+    });
+    validateTypeClass({
+        context,
+        counter: typeCounters.actions,
+        definitions: typesMap.actions,
+        typeClass: 'Action'
+    });
+    validateTypeClass({
+        context,
+        counter: typeCounters.operators.client,
+        definitions: typesMap.operators.client,
+        typeClass: 'Operator',
+        warnIfMissing: true
+    });
+    validateTypeClass({
+        context,
+        counter: typeCounters.operators.server,
+        definitions: typesMap.operators.server,
+        typeClass: 'Operator',
+        warnIfMissing: true
+    });
+}
+export default validatePageTypes;

package/dist/build/jit/writePageJit.js

@@ -0,0 +1,44 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { serializer, type } from '@lowdefy/helpers';
+import writeJs from '../buildJs/writeJs.js';
+async function writePageJit({ page, context }) {
+    // Write page JSON
+    await context.writeBuildArtifact(`pages/${page.pageId}/${page.pageId}.json`, serializer.serializeToString(page ?? {}));
+    // Write page request JSONs
+    const requests = page.requests ?? [];
+    for (const request of requests){
+        await context.writeBuildArtifact(`pages/${page.pageId}/requests/${request.requestId}.json`, serializer.serializeToString(request ?? {}));
+        // Clean up request after writing (same as writeRequests)
+        delete request.properties;
+        delete request.type;
+        delete request.connectionId;
+        delete request.auth;
+    }
+    // Write updated keyMap and refMap (JIT build adds new entries)
+    if (!type.isObject(context.keyMap)) {
+        throw new Error('keyMap is not an object.');
+    }
+    if (!type.isObject(context.refMap)) {
+        throw new Error('refMap is not an object.');
+    }
+    await context.writeBuildArtifact('keyMap.json', serializer.serializeToString(context.keyMap));
+    await context.writeBuildArtifact('refMap.json', serializer.serializeToString(context.refMap));
+    // Write updated JS map files (JIT build extracts page-level _js functions)
+    await writeJs({
+        context
+    });
+}
+export default writePageJit;

package/dist/build/jit/writePageRegistry.js

@@ -0,0 +1,23 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { serializer } from '@lowdefy/helpers';
+async function writePageRegistry({ pageRegistry, context }) {
+    const entries = {};
+    for (const [pageId, entry] of pageRegistry){
+        entries[pageId] = entry;
+    }
+    await context.writeBuildArtifact('pageRegistry.json', serializer.serializeToString(entries));
+}
+export default writePageRegistry;

package/dist/build/jit/writeSourcelessPages.js

@@ -0,0 +1,23 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ async function writeSourcelessPages({ sourcelessPageArtifacts, context }) {
+    for (const artifact of sourcelessPageArtifacts){
+        await context.writeBuildArtifact(`pages/${artifact.pageId}/${artifact.pageId}.json`, artifact.pageJson);
+        for (const request of artifact.requests){
+            await context.writeBuildArtifact(`pages/${artifact.pageId}/requests/${request.requestId}.json`, request.requestJson);
+        }
+    }
+}
+export default writeSourcelessPages;

package/dist/build/testSchema.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -13,8 +13,9 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ import { validate } from '@lowdefy/ajv';
+import { ConfigError, shouldSuppressBuildCheck } from '@lowdefy/errors';
+import findConfigKey from '../utils/findConfigKey.js';
 import lowdefySchema from '../lowdefySchema.js';
-import formatErrorMessage from '../utils/formatErrorMessage.js';
 function testSchema({ components, context }) {
     const { valid, errors } = validate({
         schema: lowdefySchema,
@@ -22,11 +23,48 @@ function testSchema({ components, context }) {
         returnErrors: true
     });
     if (!valid) {
-        context.logger.warn('Schema not valid.');
-        errors.map((error)=>context.logger.warn(formatErrorMessage({
-                error,
-                components
-            })));
+        // Filter out anyOf/oneOf cascade errors - these are always accompanied by
+        // more specific validation errors and just add noise
+        let filteredErrors = errors.filter((error)=>error.keyword !== 'anyOf' && error.keyword !== 'oneOf');
+        // Hierarchical deduplication: if an error exists at a child path,
+        // filter out errors at parent paths (prefer more specific errors)
+        filteredErrors = filteredErrors.filter((error)=>{
+            const hasChildError = filteredErrors.some((other)=>other !== error && other.instancePath.startsWith(error.instancePath + '/'));
+            return !hasChildError;
+        });
+        // Same-path deduplication: only show first error per unique path
+        // (multiple errors at same path are usually cascade errors from schema branches)
+        const seenPaths = new Set();
+        filteredErrors = filteredErrors.filter((error)=>{
+            if (seenPaths.has(error.instancePath)) {
+                return false;
+            }
+            seenPaths.add(error.instancePath);
+            return true;
+        });
+        filteredErrors.forEach((error)=>{
+            const instancePath = error.instancePath.split('/').slice(1).filter(Boolean);
+            const configKey = findConfigKey({
+                components,
+                instancePath
+            });
+            let message = error.message;
+            if (error.params?.additionalProperty) {
+                message = `${message} - "${error.params.additionalProperty}"`;
+            }
+            const configError = new ConfigError(message, {
+                configKey,
+                checkSlug: 'schema'
+            });
+            if (!shouldSuppressBuildCheck(configError, context.keyMap)) {
+                if (!context.errors) {
+                    // If no error collection array, throw immediately (fallback for tests)
+                    throw configError;
+                }
+                // Collect error object - logging happens at checkpoints in index.js
+                context.errors.push(configError);
+            }
+        });
     }
 }
 export default testSchema;

package/dist/build/validateConfig.js

@@ -1,5 +1,5 @@
 /* eslint-disable no-param-reassign */ /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -22,7 +22,7 @@ function validateConfig({ components }) {
     }
     if (type.isString(components.config.basePath)) {
         if (components.config.basePath[0] !== '/') {
-            throw Error('Base path must start with "/".');
+            throw new Error('Base path must start with "/".');
         }
     }
     return components;

package/dist/build/validateOperatorsDynamic.js

@@ -0,0 +1,28 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+function validateOperatorsDynamic({ operators }) {
+    const missingDynamic = [];
+    Object.entries(operators).forEach(([operatorName, operatorFn])=>{
+        if (!type.isFunction(operatorFn)) return;
+        if (!type.isBoolean(operatorFn.dynamic)) {
+            missingDynamic.push(operatorName);
+        }
+    });
+    if (missingDynamic.length > 0) {
+        throw new Error(`Operator validation failed: The following operators are missing the 'dynamic' property: ${missingDynamic.join(', ')}. ` + `All operators must have a 'dynamic' boolean property (true for runtime-only, false for build-time safe).`);
+    }
+}
+export default validateOperatorsDynamic;

package/dist/build/writeApi.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.

package/dist/build/writeApp.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.

package/dist/build/writeAuth.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.

package/dist/build/writeConfig.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.

package/dist/build/writeConnections.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.

package/dist/build/writeGlobal.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.

package/dist/build/writeLogger.js

@@ -0,0 +1,19 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { serializer } from '@lowdefy/helpers';
+async function writeLogger({ components, context }) {
+    await context.writeBuildArtifact('logger.json', serializer.serializeToString(components.logger ?? {}));
+}
+export default writeLogger;

package/dist/build/writeMaps.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.

package/dist/build/writeMenus.js

@@ -1,5 +1,5 @@
 /*
-  Copyright 2020-2024 Lowdefy, Inc
+  Copyright 2020-2026 Lowdefy, Inc
 
   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.