@lowdefy/server-dev 0.0.0-experimental-20260223144039 → 0.0.0-experimental-20260304101313

package/lib/client/App.js

@@ -14,16 +14,18 @@
   limitations under the License.
 */
 
-import React from 'react';
+import React, { Suspense } from 'react';
 
 import { useRouter } from 'next/router';
 
 import Head from 'next/head';
 import Link from 'next/link';
 
+import BuildingPage from './BuildingPage.js';
 import Reload from './Reload.js';
 import Page from './Page.js';
 import setPageId from './setPageId.js';
+import { getReloadVersion } from './utils/useMutateCache.js';
 import useRootConfig from './utils/useRootConfig.js';
 
 import actions from '../../build/plugins/actions.js';
@@ -44,24 +46,26 @@ const App = ({ auth, lowdefy }) => {
   return (
     <Reload basePath={router.basePath} lowdefy={lowdefy}>
       {(resetContext) => (
-        <Page
-          auth={auth}
-          Components={{ Head, Link }}
-          config={{
-            rootConfig,
-          }}
-          jsMap={staticJsMap}
-          lowdefy={lowdefy}
-          pageId={pageId}
-          resetContext={resetContext}
-          router={router}
-          types={{
-            actions,
-            blocks,
-            icons,
-            operators,
-          }}
-        />
+        <Suspense key={`${pageId}_${getReloadVersion()}`} fallback={<BuildingPage />}>
+          <Page
+            auth={auth}
+            Components={{ Head, Link }}
+            config={{
+              rootConfig,
+            }}
+            jsMap={staticJsMap}
+            lowdefy={lowdefy}
+            pageId={pageId}
+            resetContext={resetContext}
+            router={router}
+            types={{
+              actions,
+              blocks,
+              icons,
+              operators,
+            }}
+          />
+        </Suspense>
       )}
     </Reload>
   );

package/lib/client/BuildErrorPage.js

@@ -21,7 +21,7 @@ const typeColors = {
   ConfigWarning: '#d48806',
   PluginError: '#531dab',
   ServiceError: '#096dd9',
-  LowdefyError: '#cf1322',
+  LowdefyInternalError: '#cf1322',
 };
 
 function getTypeColor(type) {
@@ -49,7 +49,7 @@ const ErrorItem = ({ type, message, source }) => {
       >
         {type}
       </span>
-      <p style={{ fontSize: 14, margin: '4px 0' }}>{message}</p>
+      <p style={{ fontSize: 14, margin: '4px 0', fontFamily: 'monospace' }}>{message}</p>
       {source && <p style={{ fontSize: 13, color: '#8c8c8c', margin: 0 }}>{source}</p>}
     </div>
   );
@@ -67,7 +67,8 @@ const BuildErrorPage = ({ errors, message, source }) => {
         flexDirection: 'column',
         alignItems: 'center',
         justifyContent: 'center',
-        fontFamily: 'monospace',
+        fontFamily:
+          "system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif",
         padding: '0 24px',
       }}
     >

package/lib/client/BuildingPage.js

@@ -0,0 +1,74 @@
+/*
+  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 React from 'react';
+
+const BuildingPage = () => {
+  return (
+    <div
+      style={{
+        height: '100vh',
+        textAlign: 'center',
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems: 'center',
+        justifyContent: 'center',
+        fontFamily:
+          "system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif",
+      }}
+    >
+      <style>
+        {`
+          @keyframes building-progress {
+            0% { transform: translateX(-100%); }
+            100% { transform: translateX(100%); }
+          }
+        `}
+      </style>
+      <div
+        style={{
+          position: 'fixed',
+          top: 0,
+          left: 0,
+          width: '100%',
+          height: 3,
+          backgroundColor: '#f0f0f0',
+          overflow: 'hidden',
+        }}
+      >
+        <div
+          style={{
+            width: '40%',
+            height: '100%',
+            backgroundColor: '#1890ff',
+            animation: 'building-progress 1.5s ease-in-out infinite',
+          }}
+        />
+      </div>
+      <div
+        style={{
+          verticalAlign: 'middle',
+          display: 'inline-block',
+        }}
+      >
+        <h3>Building page...</h3>
+        <p>The page will appear when the build completes.</p>
+      </div>
+    </div>
+  );
+};
+
+export default BuildingPage;

package/lib/client/InstallingPluginsPage.js

@@ -0,0 +1,50 @@
+/*
+  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 React from 'react';
+
+const InstallingPluginsPage = ({ packages }) => {
+  return (
+    <div
+      style={{
+        height: '100vh',
+        textAlign: 'center',
+        display: 'flex',
+        flexDirection: 'column',
+        alignItems: 'center',
+        justifyContent: 'center',
+        fontFamily:
+          "system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif",
+      }}
+    >
+      <div
+        style={{
+          verticalAlign: 'middle',
+          display: 'inline-block',
+        }}
+      >
+        <h3>Installing Plugin Packages</h3>
+        <p>
+          This page requires packages that are not yet installed:{' '}
+          <strong>{(packages ?? []).join(', ')}</strong>.
+        </p>
+        <p>The server will restart automatically. The page will reload when ready.</p>
+      </div>
+    </div>
+  );
+};
+
+export default InstallingPluginsPage;

package/lib/client/Page.js

@@ -18,6 +18,7 @@ import React from 'react';
 import Client from '@lowdefy/client';
 
 import BuildErrorPage from './BuildErrorPage.js';
+import InstallingPluginsPage from './InstallingPluginsPage.js';
 import RestartingPage from './RestartingPage.js';
 import usePageConfig from './utils/usePageConfig.js';
 
@@ -47,6 +48,9 @@ const Page = ({
       />
     );
   }
+  if (pageConfig.installing) {
+    return <InstallingPluginsPage packages={pageConfig.packages} />;
+  }
   if (resetContext.restarting) {
     return <RestartingPage />;
   }

package/lib/client/RestartingPage.js

@@ -26,6 +26,8 @@ const RestartingPage = () => {
         flexDirection: 'column',
         alignItems: 'center',
         justifyContent: 'center',
+        fontFamily:
+          "system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif",
       }}
     >
       <div

package/lib/client/utils/request.js

@@ -27,9 +27,7 @@ async function request({ url, method = 'GET', body }) {
   }
   if (!res.ok) {
     const body = await res.json();
-    console.log(res);
-    console.log(body);
-    throw new Error(body.message || 'Request error');
+    throw new Error(body?.['~e']?.message ?? body?.message ?? 'Request error');
   }
   return res.json();
 }

package/lib/client/utils/usePageConfig.js

@@ -43,6 +43,9 @@ async function fetchPageConfig(url) {
   if (data?.buildError) {
     return data;
   }
+  if (data?.installing) {
+    return data;
+  }
   if (!res.ok) {
     throw new Error(data.message || 'Request error');
   }

package/lib/server/apiWrapper.js

@@ -17,6 +17,7 @@ import fs from 'fs';
 import path from 'path';
 import { createApiContext } from '@lowdefy/api';
 import { getSecretsFromEnv } from '@lowdefy/node-utils';
+import { serializer } from '@lowdefy/helpers';
 import { v4 as uuid } from 'uuid';
 
 import config from '../build/config.js';
@@ -24,13 +25,11 @@ import connections from '../../build/plugins/connections.js';
 import createLogger from './log/createLogger.js';
 import fileCache from './fileCache.js';
 import getServerSession from './auth/getServerSession.js';
-import logError from './log/logError.js';
+import createHandleError from './log/createHandleError.js';
 import logRequest from './log/logRequest.js';
 import operators from '../../build/plugins/operators/server.js';
 import staticJsMap from '../../build/plugins/operators/serverJsMap.js';
 import getAuthOptions from './auth/getAuthOptions.js';
-import loggerConfig from '../build/logger.js';
-import setSentryUser from './sentry/setSentryUser.js';
 
 const secrets = getSecretsFromEnv();
 
@@ -73,6 +72,9 @@ function apiWrapper(handler) {
       fileCache,
       headers: req?.headers,
       jsMap,
+      handleError: async (err) => {
+        console.error(err);
+      },
       logger: console,
       operators,
       req,
@@ -80,15 +82,11 @@ function apiWrapper(handler) {
       secrets,
     };
     try {
-      context.logger = createLogger({ rid: context.rid });
+      context.logger = createLogger();
+      context.handleError = createHandleError({ context });
       context.authOptions = getAuthOptions(context);
       if (!req.url.startsWith('/api/auth')) {
         context.session = await getServerSession(context);
-        // Set Sentry user context for authenticated requests
-        setSentryUser({
-          user: context.session?.user,
-          sentryConfig: loggerConfig.sentry,
-        });
       }
       createApiContext(context);
       logRequest({ context });
@@ -97,8 +95,14 @@ function apiWrapper(handler) {
       // TODO: Log response time?
       return response;
     } catch (error) {
-      await logError({ error, context });
-      res.status(500).json({ name: error.name, message: error.message });
+      await context.handleError(error);
+      const serialized = serializer.serialize(error);
+      if (serialized?.['~e']) {
+        delete serialized['~e'].received;
+        delete serialized['~e'].stack;
+        delete serialized['~e'].configKey;
+      }
+      res.status(500).json(serialized);
     }
   };
 }

package/lib/server/auth/getMockSession.js

@@ -28,7 +28,7 @@ async function getMockSession() {
     try {
       mockUser = JSON.parse(mockUserJson);
     } catch (error) {
-      throw new Error(`Invalid JSON in LOWDEFY_DEV_USER environment variable: ${error.message}`);
+      throw new Error('Invalid JSON in LOWDEFY_DEV_USER environment variable.', { cause: error });
     }
   } else {
     mockUser = authJson.dev?.mockUser;

package/lib/server/jitPageBuilder.js

@@ -22,8 +22,12 @@ import { buildPageJit, createContext } from '@lowdefy/build/dev';
 import createLogger from './log/createLogger.js';
 import PageCache from './pageCache.mjs';
 
-const jitLogger = createLogger({ component: 'jit-build' });
+const jitLogger = createLogger({ name: 'jit-build' });
 
+function formatDuration(ms) {
+  if (ms < 1000) return `${ms}ms`;
+  return `${(ms / 1000).toFixed(2)}s`;
+}
 const pageCache = new PageCache();
 let cachedRegistryMtime = null;
 let cachedRegistry = null;
@@ -40,21 +44,17 @@ function readJsonFile(filePath) {
 }
 
 function checkPageInvalidations(buildDirectory) {
-  const invalidationPath = path.join(buildDirectory, 'invalidatePages.json');
+  const invalidatePath = path.join(buildDirectory, 'invalidatePages');
   try {
-    const stat = fs.statSync(invalidationPath);
+    const stat = fs.statSync(invalidatePath);
     if (lastInvalidationMtime && stat.mtimeMs === lastInvalidationMtime) {
       return;
     }
     lastInvalidationMtime = stat.mtimeMs;
-    const content = fs.readFileSync(invalidationPath, 'utf8');
-    const pageIds = JSON.parse(content);
-    if (Array.isArray(pageIds) && pageIds.length > 0) {
-      pageCache.invalidatePages(pageIds);
-      cachedBuildContext = null;
-    }
+    pageCache.invalidateAll();
+    cachedBuildContext = null;
   } catch {
-    // File doesn't exist yet or read error — nothing to invalidate
+    // File doesn't exist yet — nothing to invalidate
   }
 }
 
@@ -85,10 +85,14 @@ function getBuildContext(buildDirectory, configDirectory) {
   const jsMap = readJsonFile(path.join(buildDirectory, 'jsMap.json')) ?? { client: {}, server: {} };
   const connectionIds = readJsonFile(path.join(buildDirectory, 'connectionIds.json')) ?? [];
 
+  const customTypesMap = readJsonFile(path.join(buildDirectory, 'customTypesMap.json')) ?? {};
+
   cachedBuildContext = createContext({
+    customTypesMap,
     directories: {
       build: buildDirectory,
       config: configDirectory,
+      server: path.resolve(buildDirectory, '..'),
     },
     logger: jitLogger,
     stage: 'dev',
@@ -103,6 +107,11 @@ function getBuildContext(buildDirectory, configDirectory) {
     cachedBuildContext.connectionIds.add(id);
   }
 
+  // Load installed packages snapshot from skeleton build for missing-package detection
+  const installedPluginPackages =
+    readJsonFile(path.join(buildDirectory, 'installedPluginPackages.json')) ?? [];
+  cachedBuildContext.installedPluginPackages = new Set(installedPluginPackages);
+
   return cachedBuildContext;
 }
 
@@ -123,16 +132,27 @@ async function buildPageIfNeeded({ pageId, buildDirectory, configDirectory }) {
     return true;
   }
 
+  jitLogger.info({ spin: true }, `Building page "${pageId}"...`);
+  const startTime = Date.now();
   try {
     const context = getBuildContext(buildDirectory, configDirectory);
-    const startTime = Date.now();
-    await buildPageJit({
+    const result = await buildPageJit({
       pageId,
       pageRegistry: registry,
       context,
     });
+    if (result && result.installing) {
+      jitLogger.info(
+        `Installing plugin packages for page "${pageId}": ${result.packages.join(', ')}. ` +
+          'The page will be available after the server restarts.'
+      );
+      return result;
+    }
     pageCache.markCompiled(pageId);
-    jitLogger.info(`Built page "${pageId}" in ${Date.now() - startTime}ms.`);
+    jitLogger.info(
+      { succeed: true, color: 'white' },
+      `Built page "${pageId}" in ${formatDuration(Date.now() - startTime)}.`
+    );
     return true;
   } finally {
     pageCache.releaseBuildLock(pageId);
@@ -140,4 +160,3 @@ async function buildPageIfNeeded({ pageId, buildDirectory, configDirectory }) {
 }
 
 export default buildPageIfNeeded;
-export { pageCache };

package/lib/server/log/createHandleError.js

@@ -0,0 +1,47 @@
+/*
+  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 { LowdefyInternalError, loadAndResolveErrorLocation } from '@lowdefy/errors';
+
+function createHandleError({ context }) {
+  return async function handleError(error) {
+    try {
+      // For internal lowdefy errors, don't resolve config location
+      const location =
+        error instanceof LowdefyInternalError
+          ? null
+          : await loadAndResolveErrorLocation({
+              error,
+              readConfigFile: context.readConfigFile,
+              configDirectory: context.configDirectory,
+            });
+
+      // Attach resolved location to error for display layer
+      if (location) {
+        error.source = location.source;
+        error.config = location.config;
+      }
+
+      context.logger.error(error);
+    } catch (e) {
+      console.error(error);
+      console.error('An error occurred while logging the error.');
+      console.error(e);
+    }
+  };
+}
+
+export default createHandleError;

package/lib/server/log/createLogger.js

@@ -14,16 +14,16 @@
   limitations under the License.
 */
 
-import { createNodeLogger, wrapErrorLogger } from '@lowdefy/logger/node';
+import { createNodeLogger } from '@lowdefy/logger/node';
 
 const logger = createNodeLogger({
-  name: 'lowdefy_server',
+  name: 'lowdefy_server_dev',
   level: process.env.LOWDEFY_LOG_LEVEL ?? 'info',
   base: { pid: undefined, hostname: undefined },
 });
 
 function createLogger(metadata = {}) {
-  return wrapErrorLogger(logger.child(metadata));
+  return logger.child(metadata);
 }
 
 export default createLogger;

package/lib/server/pageCache.mjs

@@ -18,7 +18,6 @@ class PageCache {
   constructor() {
     this.compiledPages = new Set();
     this.buildLocks = new Map();
-    this.skeletonLock = null;
   }
 
   isCompiled(pageId) {
@@ -30,11 +29,6 @@ class PageCache {
   }
 
   async acquireBuildLock(pageId) {
-    // Wait for any skeleton rebuild first
-    if (this.skeletonLock) {
-      await this.skeletonLock;
-    }
-
     // If page build already in progress, wait for it
     if (this.buildLocks.has(pageId)) {
       await this.buildLocks.get(pageId);
@@ -59,46 +53,9 @@ class PageCache {
     }
   }
 
-  async acquireSkeletonLock() {
-    // Wait for all in-progress page builds to complete
-    await Promise.all(this.buildLocks.values());
-    let resolve;
-    this.skeletonLock = new Promise((r) => {
-      resolve = r;
-    });
-    this.skeletonLock.resolve = resolve;
-  }
-
-  releaseSkeletonLock() {
-    if (this.skeletonLock) {
-      this.skeletonLock.resolve();
-      this.skeletonLock = null;
-    }
-  }
-
   invalidateAll() {
     this.compiledPages.clear();
   }
-
-  invalidatePages(pageIds) {
-    for (const pageId of pageIds) {
-      this.compiledPages.delete(pageId);
-    }
-  }
-
-  invalidateByFiles(changedFiles, fileDependencyMap) {
-    const affectedPages = new Set();
-    for (const filePath of changedFiles) {
-      const pageIds = fileDependencyMap.get(filePath);
-      if (pageIds) {
-        for (const pageId of pageIds) {
-          affectedPages.add(pageId);
-        }
-      }
-    }
-    this.invalidatePages(affectedPages);
-    return affectedPages;
-  }
 }
 
 export default PageCache;