@lowdefy/build 5.6.0 → 6.0.0

package/dist/dynamic/buildDynamicBlocks.js

@@ -0,0 +1,120 @@
+/*
+  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';
+import { ConfigError } from '@lowdefy/errors';
+import buildBlock from '../build/buildPages/buildBlock/buildBlock.js';
+import createCheckDuplicateId from '../utils/createCheckDuplicateId.js';
+import createCounter from '../utils/createCounter.js';
+// At build time, type counters feed types.json and import generation. At
+// runtime the client bundle is fixed, so the same counter calls become
+// membership checks against the bundled types instead.
+function createMembershipCounter({ category, allowed, dynamicBlockId, pageId }) {
+    return {
+        increment: (typeName)=>{
+            if (!allowed.has(typeName)) {
+                throw new ConfigError(`Dynamic block "${dynamicBlockId}" on page "${pageId}" resolved content uses ${category} type "${typeName}" which is not included in the app's client bundle. Declare it in the Dynamic block's properties.types.`);
+            }
+        }
+    };
+}
+// types.json is fileCache-cached (same object per server lifetime), so the
+// allowed-type sets are derived once per types object, not per Dynamic block.
+const allowedSetsCache = new WeakMap();
+function getAllowedSets(types) {
+    let sets = allowedSetsCache.get(types);
+    if (!sets) {
+        sets = {
+            actions: new Set(Object.keys(types.actions ?? {})),
+            blocks: new Set(Object.keys(types.blocks ?? {})),
+            operators: new Set(Object.keys(types.operators?.client ?? {}))
+        };
+        allowedSetsCache.set(types, sets);
+    }
+    return sets;
+}
+// Counter for categories dynamic content cannot reach (requests are forbidden,
+// so request types and server operators never occur in a valid fragment).
+const noopCounter = {
+    increment: ()=>{}
+};
+function buildDynamicBlocks({ blocks, pageId, dynamicBlockId, idPrefix, types, blockMetas }) {
+    if (!type.isArray(blocks)) {
+        throw new ConfigError(`Dynamic block "${dynamicBlockId}" on page "${pageId}" endpoint must return an object with a "blocks" array.`, {
+            received: blocks
+        });
+    }
+    const warnings = [];
+    const callApiActionRefs = [];
+    const requestActionRefs = [];
+    const allowed = getAllowedSets(types);
+    const pageContext = {
+        blockIdCounter: createCounter(),
+        // Namespace runtime ids under the resolving Dynamic block's built id —
+        // unique by construction, so they can never collide with static block ids.
+        blockIdPrefix: idPrefix,
+        callApiActionRefs,
+        checkDuplicateRequestId: createCheckDuplicateId({
+            message: 'Duplicate requestId "{{ id }}" on page "{{ pageId }}".'
+        }),
+        context: {
+            blockMetas,
+            handleWarning: (warning)=>{
+                warnings.push(warning);
+            }
+        },
+        // Pure sink — buildDynamicBlock pushes nested Dynamic refs here, but at
+        // runtime a bad endpointId surfaces through resolution, not ref checking.
+        dynamicBlockRefs: [],
+        forbidRequests: true,
+        linkActionRefs: [],
+        pageId,
+        requestActionRefs,
+        requests: [],
+        shortcutRefs: [],
+        typeCounters: {
+            actions: createMembershipCounter({
+                category: 'action',
+                allowed: allowed.actions,
+                dynamicBlockId,
+                pageId
+            }),
+            blocks: createMembershipCounter({
+                category: 'block',
+                allowed: allowed.blocks,
+                dynamicBlockId,
+                pageId
+            }),
+            operators: {
+                client: createMembershipCounter({
+                    category: 'operator',
+                    allowed: allowed.operators,
+                    dynamicBlockId,
+                    pageId
+                }),
+                server: noopCounter
+            },
+            requests: noopCounter
+        },
+        websocketActionRefs: []
+    };
+    blocks.forEach((block)=>buildBlock(block, pageContext));
+    return {
+        blocks,
+        callApiActionRefs,
+        requestActionRefs,
+        warnings
+    };
+}
+export default buildDynamicBlocks;

package/dist/index.js

@@ -22,17 +22,22 @@ import addDefaultPages from './build/addDefaultPages/addDefaultPages.js';
 import addKeys from './build/addKeys.js';
 import buildAgents from './build/buildAgents.js';
 import buildApp from './build/buildApp.js';
+import buildAppMeta from './build/buildAppMeta.js';
 import buildAuth from './build/buildAuth/buildAuth.js';
 import buildConnections from './build/buildConnections.js';
 import buildApi from './build/buildApi/buildApi.js';
 import buildImports from './build/buildImports/buildImports.js';
 import buildJs from './build/full/buildJs.js';
 import buildLogger from './build/buildLogger.js';
+import buildMcp from './build/buildMcp.js';
 import buildMenu from './build/buildMenu.js';
 import buildModuleDefs from './build/buildModuleDefs.js';
 import buildModules from './build/buildModules.js';
+import buildNotifications from './build/buildNotifications.js';
+import precomputeRuntimeOperators from './build/buildRefs/precomputeRuntimeOperators.js';
 import buildPages from './build/full/buildPages.js';
 import buildRefs from './build/buildRefs/buildRefs.js';
+import buildWebsockets from './build/buildWebsockets.js';
 import collectPageContent from './build/collectPageContent.js';
 import buildTypes from './build/buildTypes.js';
 import cleanBuildDirectory from './build/cleanBuildDirectory.js';
@@ -40,7 +45,9 @@ import copyAgentFileSystems from './build/copyAgentFileSystems.js';
 import copyPublicFolder from './build/copyPublicFolder.js';
 import testSchema from './build/testSchema.js';
 import updateServerPackageJson from './build/full/updateServerPackageJson.js';
+import validateCallAgentSteps from './build/validateCallAgentSteps.js';
 import validateConfig from './build/validateConfig.js';
+import validateRenderNotificationSteps from './build/validateRenderNotificationSteps.js';
 import writeAgents from './build/writeAgents.js';
 import writeApp from './build/writeApp.js';
 import writeAppMeta from './build/writeAppMeta.js';
@@ -49,6 +56,8 @@ import writeConfig from './build/writeConfig.js';
 import writeConnections from './build/writeConnections.js';
 import writeApi from './build/writeApi.js';
 import writeGlobal from './build/writeGlobal.js';
+import writeMcp from './build/writeMcp.js';
+import writeWebsockets from './build/writeWebsockets.js';
 import codegenI18nLocales from './build/codegenI18nLocales.js';
 import writeI18n from './build/writeI18n.js';
 import writeTheme from './build/writeTheme.js';
@@ -56,6 +65,7 @@ import writeJs from './build/buildJs/writeJs.js';
 import writeLogger from './build/writeLogger.js';
 import writeMaps from './build/writeMaps.js';
 import writeMenus from './build/writeMenus.js';
+import writeNotifications from './build/writeNotifications.js';
 import writePages from './build/full/writePages.js';
 import writePluginImports from './build/writePluginImports/writePluginImports.js';
 import writeRequests from './build/full/writeRequests.js';
@@ -66,6 +76,15 @@ async function build(options) {
     let context;
     try {
         context = createContext(options);
+        // Phase 0: Resolve root app metadata into context.appMeta before any
+        // operator evaluation. _app / _build.app read this, and buildModuleDefs
+        // (next) evaluates operators on root config, consumer vars, and connections.
+        await buildAppMeta({
+            context
+        });
+        // Surface bad root metadata (unsupported operators, failed _build.*) now,
+        // before module operators evaluate against it — avoids cascade errors.
+        logCollectedErrors(context);
         // Phase 1: Build module definitions
         // Parses lowdefy.yaml, resolves module refs, populates context.modules
         await buildModuleDefs({
@@ -92,6 +111,18 @@ async function build(options) {
             components,
             context
         });
+        // Phase 3.5: Pre-compute static runtime operators (_sum, _if, _string, etc.)
+        // whose arguments are fully static. This single fold covers components after
+        // module manifests are merged (replacing the old per-region folds in buildRefs,
+        // buildModuleDefs, and registerModules). Must run before addKeys so that ~k
+        // markers are added to the already-folded tree.
+        // context.rootRefDef is the lowdefy.yaml refDef stashed by buildRefs (Phase 2)
+        // so we can resolve error source file paths without allocating a new makeId entry.
+        components = precomputeRuntimeOperators({
+            context,
+            input: components,
+            refDef: context.rootRefDef
+        });
         // Build steps - collect all errors before stopping
         // addKeys runs first so testSchema has ~k markers for error location info
         tryBuildStep(addKeys, 'addKeys', {
@@ -110,6 +141,9 @@ async function build(options) {
             components,
             context
         });
+        // appMeta is computed in Phase 0; attach it here (where buildApp used to
+        // create it) so the following addKeys pass keys it identically.
+        components.appMeta = context.appMeta;
         tryBuildStep(buildLogger, 'buildLogger', {
             components,
             context
@@ -143,32 +177,39 @@ async function build(options) {
             components,
             context
         });
-        tryBuildStep(buildPages, 'buildPages', {
+        tryBuildStep(buildMcp, 'buildMcp', {
             components,
             context
         });
-        tryBuildStep(buildMenu, 'buildMenu', {
+        tryBuildStep(buildWebsockets, 'buildWebsockets', {
             components,
             context
         });
-        tryBuildStep(buildJs, 'buildJs', {
+        tryBuildStep(buildNotifications, 'buildNotifications', {
             components,
             context
         });
-        tryBuildStep(buildTypes, 'buildTypes', {
+        // Cross-config step validations — need buildApi (stepIds) and the
+        // buildAgents/buildNotifications id sets
+        tryBuildStep(validateCallAgentSteps, 'validateCallAgentSteps', {
             components,
             context
         });
-        tryBuildStep(buildImports, 'buildImports', {
+        tryBuildStep(validateRenderNotificationSteps, 'validateRenderNotificationSteps', {
             components,
             context
         });
-        // Final addKeys pass to ensure all objects (including those created by build steps) have ~k
-        tryBuildStep(addKeys, 'addKeys', {
+        tryBuildStep(buildPages, 'buildPages', {
+            components,
+            context
+        });
+        tryBuildStep(buildMenu, 'buildMenu', {
             components,
             context
         });
-        // Collect page content strings for Tailwind to scan
+        // Collect page content strings for Tailwind to scan. Must run before
+        // buildJs — jsMapParser replaces _js source with hashes, and class
+        // candidates used only inside _js source would otherwise never be scanned.
         context.tailwindContentMap = new Map();
         for (const page of components.pages ?? []){
             const content = collectPageContent([
@@ -178,6 +219,23 @@ async function build(options) {
                 context.tailwindContentMap.set(page.pageId, content);
             }
         }
+        tryBuildStep(buildJs, 'buildJs', {
+            components,
+            context
+        });
+        tryBuildStep(buildTypes, 'buildTypes', {
+            components,
+            context
+        });
+        tryBuildStep(buildImports, 'buildImports', {
+            components,
+            context
+        });
+        // Final addKeys pass to ensure all objects (including those created by build steps) have ~k
+        tryBuildStep(addKeys, 'addKeys', {
+            components,
+            context
+        });
         // Check if there are any collected errors before writing
         logCollectedErrors(context);
         // Write steps - only if no errors
@@ -208,6 +266,18 @@ async function build(options) {
             components,
             context
         });
+        await writeMcp({
+            components,
+            context
+        });
+        await writeWebsockets({
+            components,
+            context
+        });
+        await writeNotifications({
+            components,
+            context
+        });
         await writeRequests({
             components,
             context

package/dist/indexDev.js

@@ -14,8 +14,12 @@
   limitations under the License.
 */ export { default as buildModuleDefs } from './build/buildModuleDefs.js';
 export { default as buildModules } from './build/buildModules.js';
+export { default as generateClientJsModule } from './build/buildJs/generateClientJsModule.js';
+export { default as iconPackages } from './build/buildImports/iconPackages.js';
 export { default as shallowBuild } from './build/jit/shallowBuild.js';
 export { default as buildPageJit } from './build/jit/buildPageJit.js';
 export { default as createPageRegistry } from './build/jit/createPageRegistry.js';
 export { default as createContext } from './createContext.js';
 export { default as makeId } from './utils/makeId.js';
+export { default as serializeBuildException } from './utils/serializeBuildException.js';
+export { hydrateDeferredRecords } from './build/buildRefs/deferredRegistry.js';