@lowdefy/server-dev 0.0.0-experimental-20260220143146 → 0.0.0-experimental-20260220145512

package/lib/client/BuildErrorPage.js

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

package/lib/client/Page.js

@@ -18,7 +18,6 @@ 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';
 
@@ -48,9 +47,6 @@ const Page = ({
       />
     );
   }
-  if (pageConfig.installing) {
-    return <InstallingPluginsPage packages={pageConfig.packages} />;
-  }
   if (resetContext.restarting) {
     return <RestartingPage />;
   }

package/lib/client/RestartingPage.js

@@ -26,8 +26,6 @@ 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/sentry/captureSentryError.js

@@ -0,0 +1,43 @@
+/*
+  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 * as Sentry from '@sentry/nextjs';
+
+function captureSentryError({ error, pageId, blockId, configLocation }) {
+  const tags = {};
+  const extra = {};
+
+  // Add Lowdefy-specific context
+  if (pageId) {
+    tags.pageId = pageId;
+  }
+
+  if (blockId) {
+    tags.blockId = blockId;
+  }
+
+  // Add config location context
+  if (configLocation) {
+    extra.configLocation = configLocation;
+  }
+
+  Sentry.captureException(error, {
+    tags,
+    extra,
+  });
+}
+
+export default captureSentryError;

package/lib/client/sentry/initSentryClient.js

@@ -0,0 +1,55 @@
+/*
+  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 * as Sentry from '@sentry/nextjs';
+
+let initialized = false;
+
+function initSentryClient({ sentryDsn, sentryConfig }) {
+  // No-op if already initialized
+  if (initialized) {
+    return;
+  }
+
+  // No-op if SENTRY_DSN not set
+  if (!sentryDsn) {
+    return;
+  }
+
+  // No-op if client logging is explicitly disabled
+  if (sentryConfig?.client === false) {
+    return;
+  }
+
+  const config = sentryConfig || {};
+
+  Sentry.init({
+    dsn: sentryDsn,
+    environment: config.environment || process.env.NODE_ENV || 'production',
+    tracesSampleRate: config.tracesSampleRate ?? 0.1,
+    replaysSessionSampleRate: config.replaysSessionSampleRate ?? 0,
+    replaysOnErrorSampleRate: config.replaysOnErrorSampleRate ?? 0.1,
+    integrations: [
+      Sentry.replayIntegration(),
+      ...(config.feedback ? [Sentry.feedbackIntegration({ colorScheme: 'system' })] : []),
+    ],
+  });
+
+  initialized = true;
+  console.log('Sentry enabled: client');
+}
+
+export default initSentryClient;

package/lib/client/sentry/setSentryUser.js

@@ -0,0 +1,41 @@
+/*
+  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 * as Sentry from '@sentry/nextjs';
+
+function setSentryUser({ user, sentryConfig }) {
+  // No-op if no user
+  if (!user) {
+    Sentry.setUser(null);
+    return;
+  }
+
+  const userFields = sentryConfig?.userFields || ['id', '_id'];
+  const sentryUser = {};
+
+  userFields.forEach((field) => {
+    if (user[field] !== undefined) {
+      sentryUser[field] = user[field];
+    }
+  });
+
+  // Only set user if we have at least one field
+  if (Object.keys(sentryUser).length > 0) {
+    Sentry.setUser(sentryUser);
+  }
+}
+
+export default setSentryUser;

package/lib/client/utils/request.js

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

package/lib/client/utils/usePageConfig.js

@@ -43,9 +43,6 @@ 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,7 +17,6 @@ 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';
@@ -25,11 +24,13 @@ 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 createHandleError from './log/createHandleError.js';
+import logError from './log/logError.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();
 
@@ -72,9 +73,6 @@ function apiWrapper(handler) {
       fileCache,
       headers: req?.headers,
       jsMap,
-      handleError: async (err) => {
-        console.error(err);
-      },
       logger: console,
       operators,
       req,
@@ -83,10 +81,14 @@ function apiWrapper(handler) {
     };
     try {
       context.logger = createLogger({ rid: context.rid });
-      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 });
@@ -95,14 +97,8 @@ function apiWrapper(handler) {
       // TODO: Log response time?
       return response;
     } catch (error) {
-      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);
+      await logError({ error, context });
+      res.status(500).json({ name: error.name, message: error.message });
     }
   };
 }

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.', { cause: error });
+      throw new Error(`Invalid JSON in LOWDEFY_DEV_USER environment variable: ${error.message}`);
     }
   } else {
     mockUser = authJson.dev?.mockUser;

package/lib/server/jitPageBuilder.js

@@ -85,14 +85,10 @@ 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',
@@ -107,11 +103,6 @@ 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;
 }
 
@@ -135,18 +126,11 @@ async function buildPageIfNeeded({ pageId, buildDirectory, configDirectory }) {
   try {
     const context = getBuildContext(buildDirectory, configDirectory);
     const startTime = Date.now();
-    const result = await buildPageJit({
+    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.`);
     return true;

package/lib/server/log/createLogger.js

@@ -14,7 +14,7 @@
   limitations under the License.
 */
 
-import { createNodeLogger } from '@lowdefy/logger/node';
+import { createNodeLogger, wrapErrorLogger } from '@lowdefy/logger/node';
 
 const logger = createNodeLogger({
   name: 'lowdefy_server',
@@ -23,7 +23,7 @@ const logger = createNodeLogger({
 });
 
 function createLogger(metadata = {}) {
-  return logger.child(metadata);
+  return wrapErrorLogger(logger.child(metadata));
 }
 
 export default createLogger;

package/lib/server/log/logError.js

@@ -0,0 +1,56 @@
+/*
+  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 { resolveErrorConfigLocation } from '@lowdefy/errors/build';
+
+import captureSentryError from '../sentry/captureSentryError.js';
+
+async function logError({ context, error }) {
+  try {
+    const isServiceError = error?.isServiceError === true;
+
+    // For service errors, don't resolve config location (not a config issue)
+    const location = isServiceError
+      ? null
+      : await resolveErrorConfigLocation({
+          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;
+    }
+
+    // Log error - logger handles source, name prefix, and received formatting
+    context.logger.error(error);
+
+    // Capture error to Sentry (no-op if Sentry not configured)
+    captureSentryError({
+      error,
+      context,
+      configLocation: location,
+    });
+  } catch (e) {
+    console.error(error);
+    console.error('An error occurred while logging the error.');
+    console.error(e);
+  }
+}
+
+export default logError;

package/lib/server/pageCache.mjs

@@ -86,6 +86,19 @@ class PageCache {
     }
   }
 
+  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;

package/lib/server/pageCache.test.mjs

@@ -47,6 +47,45 @@ test('invalidatePages removes specific pages', () => {
   expect(cache.isCompiled('settings')).toBe(false);
 });
 
+test('invalidateByFiles returns affected pages and invalidates them', () => {
+  const cache = new PageCache();
+  cache.markCompiled('home');
+  cache.markCompiled('dashboard');
+
+  const fileDependencyMap = new Map([
+    ['pages/home/blocks.yaml', new Set(['home'])],
+    ['shared/layout.yaml', new Set(['home', 'dashboard'])],
+  ]);
+
+  const affected = cache.invalidateByFiles(['pages/home/blocks.yaml'], fileDependencyMap);
+  expect(affected).toEqual(new Set(['home']));
+  expect(cache.isCompiled('home')).toBe(false);
+  expect(cache.isCompiled('dashboard')).toBe(true);
+});
+
+test('invalidateByFiles handles shared files affecting multiple pages', () => {
+  const cache = new PageCache();
+  cache.markCompiled('home');
+  cache.markCompiled('dashboard');
+
+  const fileDependencyMap = new Map([['shared/layout.yaml', new Set(['home', 'dashboard'])]]);
+
+  const affected = cache.invalidateByFiles(['shared/layout.yaml'], fileDependencyMap);
+  expect(affected).toEqual(new Set(['home', 'dashboard']));
+  expect(cache.isCompiled('home')).toBe(false);
+  expect(cache.isCompiled('dashboard')).toBe(false);
+});
+
+test('invalidateByFiles returns empty set for unknown files', () => {
+  const cache = new PageCache();
+  cache.markCompiled('home');
+
+  const fileDependencyMap = new Map();
+  const affected = cache.invalidateByFiles(['unknown.yaml'], fileDependencyMap);
+  expect(affected).toEqual(new Set());
+  expect(cache.isCompiled('home')).toBe(true);
+});
+
 test('acquireBuildLock returns true for first request', async () => {
   const cache = new PageCache();
   const shouldBuild = await cache.acquireBuildLock('home');

package/lib/server/sentry/captureSentryError.js

@@ -0,0 +1,57 @@
+/*
+  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 * as Sentry from '@sentry/nextjs';
+
+function captureSentryError({ error, context, configLocation }) {
+  // No-op if Sentry not initialized (DSN not set)
+  if (!process.env.SENTRY_DSN) {
+    return;
+  }
+
+  const tags = {};
+  const extra = {};
+
+  // Add Lowdefy-specific context
+  if (context?.pageId) {
+    tags.pageId = context.pageId;
+  }
+
+  if (error?.blockId) {
+    tags.blockId = error.blockId;
+  }
+
+  if (error?.isServiceError !== undefined) {
+    tags.isServiceError = error.isServiceError;
+  }
+
+  // Add config location context
+  if (configLocation) {
+    extra.configLocation = configLocation;
+  }
+
+  // Add config key for reference
+  if (error?.configKey) {
+    extra.configKey = error.configKey;
+  }
+
+  Sentry.captureException(error, {
+    tags,
+    extra,
+  });
+}
+
+export default captureSentryError;

package/lib/server/sentry/initSentry.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 * as Sentry from '@sentry/nextjs';
+
+import loggerConfig from '../../build/logger.js';
+
+function initSentryServer() {
+  // No-op if SENTRY_DSN not set
+  if (!process.env.SENTRY_DSN) {
+    return;
+  }
+
+  const sentryConfig = loggerConfig.sentry || {};
+
+  // No-op if server logging is explicitly disabled
+  if (sentryConfig.server === false) {
+    return;
+  }
+
+  Sentry.init({
+    dsn: process.env.SENTRY_DSN,
+    environment: sentryConfig.environment || process.env.NODE_ENV || 'production',
+    tracesSampleRate: sentryConfig.tracesSampleRate ?? 0.1,
+  });
+
+  console.log('Sentry enabled: server');
+}
+
+export default initSentryServer;
+export { initSentryServer };

package/lib/server/sentry/setSentryUser.js

@@ -0,0 +1,46 @@
+/*
+  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 * as Sentry from '@sentry/nextjs';
+
+function setSentryUser({ user, sentryConfig }) {
+  // No-op if Sentry not initialized (DSN not set)
+  if (!process.env.SENTRY_DSN) {
+    return;
+  }
+
+  // No-op if no user
+  if (!user) {
+    Sentry.setUser(null);
+    return;
+  }
+
+  const userFields = sentryConfig?.userFields || ['id', '_id'];
+  const sentryUser = {};
+
+  userFields.forEach((field) => {
+    if (user[field] !== undefined) {
+      sentryUser[field] = user[field];
+    }
+  });
+
+  // Only set user if we have at least one field
+  if (Object.keys(sentryUser).length > 0) {
+    Sentry.setUser(sentryUser);
+  }
+}
+
+export default setSentryUser;

package/manager/getContext.mjs

@@ -19,8 +19,7 @@ import path from 'path';
 import yargs from 'yargs';
 import { hideBin } from 'yargs/helpers';
 
-import pino from 'pino';
-import { createNodeLogger } from '@lowdefy/logger/node';
+import { createDevLogger as createLogger } from '@lowdefy/logger/dev';
 import checkMockUserWarning from './processes/checkMockUserWarning.mjs';
 import initialBuild from './processes/initialBuild.mjs';
 import installPlugins from './processes/installPlugins.mjs';
@@ -49,12 +48,7 @@ async function getContext() {
       config: path.resolve(argv.configDirectory ?? env.LOWDEFY_DIRECTORY_CONFIG ?? process.cwd()),
       server: process.cwd(),
     },
-    logger: createNodeLogger({
-      name: 'lowdefy build',
-      level: env.LOWDEFY_LOG_LEVEL ?? 'info',
-      base: { pid: undefined, hostname: undefined },
-      destination: pino.destination({ dest: 1, sync: true }),
-    }),
+    logger: createLogger({ level: env.LOWDEFY_LOG_LEVEL }),
     options: {
       port: argv.port ?? env.PORT ?? 3000,
       refResolver: argv.refResolver ?? env.LOWDEFY_BUILD_REF_RESOLVER,
@@ -70,6 +64,7 @@ async function getContext() {
     // JIT build state
     pageCache: new PageCache(),
     pageRegistry: null,
+    fileDependencyMap: null,
     buildContext: null,
   };
 
@@ -84,6 +79,7 @@ async function getContext() {
     const result = await buildFn();
     if (result) {
       context.pageRegistry = result.pageRegistry;
+      context.fileDependencyMap = result.fileDependencyMap;
       context.buildContext = result.context;
     }
   };