@lowdefy/server-dev 4.5.1 → 4.6.0

package/manager/processes/checkMockUserWarning.mjs

@@ -0,0 +1,42 @@
+/*
+  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 { readFile } from 'fs/promises';
+import path from 'path';
+
+function checkMockUserWarning(context) {
+  return async () => {
+    // Check env var first
+    if (process.env.LOWDEFY_DEV_USER) {
+      context.logger.warn('Mock user active - login bypassed');
+      return;
+    }
+
+    // Check auth.json after build
+    try {
+      const authJsonPath = path.join(context.directories.build, 'auth.json');
+      const authJsonContent = await readFile(authJsonPath, 'utf8');
+      const authJson = JSON.parse(authJsonContent);
+      if (authJson.dev?.mockUser) {
+        context.logger.warn('Mock user active - login bypassed');
+      }
+    } catch {
+      // auth.json may not exist if auth is not configured
+    }
+  };
+}
+
+export default checkMockUserWarning;

package/manager/processes/initialBuild.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /*
-  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.
@@ -19,6 +19,7 @@ function initialBuild(context) {
   return async () => {
     context.readDotEnv();
     await context.lowdefyBuild();
+    await context.checkMockUserWarning();
     await context.installPlugins();
     await context.nextBuild();
   };

package/manager/processes/installPlugins.mjs

@@ -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.
@@ -18,7 +18,7 @@ import { spawnProcess } from '@lowdefy/node-utils';
 
 function installPlugins({ logger, packageManagerCmd }) {
   return async () => {
-    logger.info({ print: 'spin' }, 'Installing plugins...');
+    logger.info({ spin: 'start' }, 'Installing plugins...');
     await spawnProcess({
       processOptions: {
         // https://nodejs.org/en/blog/vulnerability/april-2024-security-releases-2#command-injection-via-args-parameter-of-child_processspawn-without-shell-option-enabled-on-windows-cve-2024-27980---high
@@ -28,7 +28,7 @@ function installPlugins({ logger, packageManagerCmd }) {
       args: ['install', '--no-frozen-lockfile'],
       stdOutLineHandler: (line) => logger.debug(line),
     });
-    logger.info({ print: 'log' }, 'Installed plugins.');
+    logger.info('Installed plugins.');
   };
 }
 

package/manager/processes/lowdefyBuild.mjs

@@ -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.
@@ -14,21 +14,32 @@
   limitations under the License.
 */
 
-import build from '@lowdefy/build';
+import { shallowBuild } from '@lowdefy/build/dev';
 import createCustomPluginTypesMap from '../utils/createCustomPluginTypesMap.mjs';
 
+function formatDuration(ms) {
+  if (ms < 1000) return `${ms}ms`;
+  return `${(ms / 1000).toFixed(2)}s`;
+}
+
 function lowdefyBuild({ directories, logger, options }) {
   return async () => {
-    logger.info({ print: 'spin' }, 'Building config...');
+    logger.info({ spin: 'start' }, 'Building config...');
+    const startTime = Date.now();
     const customTypesMap = await createCustomPluginTypesMap({ directories, logger });
-    await build({
+
+    const result = await shallowBuild({
       customTypesMap,
       directories,
       logger,
       refResolver: options.refResolver,
       stage: 'dev',
     });
-    logger.info({ print: 'log' }, 'Built config.');
+
+    // Return result so getContext can store registries
+    const duration = Date.now() - startTime;
+    logger.info({ spin: 'succeed' }, `Built config in ${formatDuration(duration)}.`);
+    return result;
   };
 }
 

package/manager/processes/nextBuild.mjs

@@ -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.
@@ -14,17 +14,36 @@
   limitations under the License.
 */
 
+import { BuildError } from '@lowdefy/errors';
 import { spawnProcess } from '@lowdefy/node-utils';
 
+function formatDuration(ms) {
+  if (ms < 1000) return `${ms}ms`;
+  return `${(ms / 1000).toFixed(2)}s`;
+}
+
 function nextBuild({ bin, logger }) {
   return async () => {
-    logger.info({ print: 'spin' }, 'Building app...');
-    await spawnProcess({
-      command: 'node',
-      args: [bin.next, 'build'],
-      stdOutLineHandler: (line) => logger.debug(line),
-    });
-    logger.info({ print: 'log' }, 'Built app.');
+    logger.info({ spin: 'start' }, 'Building app...');
+    const startTime = Date.now();
+    const errorLines = [];
+    try {
+      await spawnProcess({
+        command: 'node',
+        args: [bin.next, 'build'],
+        stdOutLineHandler: (line) => logger.debug(line),
+        stdErrLineHandler: (line) => {
+          logger.debug(line);
+          errorLines.push(line);
+        },
+      });
+    } catch (err) {
+      if (errorLines.length > 0) {
+        errorLines.forEach((line) => logger.error(line));
+      }
+      throw new BuildError('Next.js build failed. See above for details.');
+    }
+    logger.info({ spin: 'succeed' }, `Built app in ${formatDuration(Date.now() - startTime)}.`);
   };
 }
 

package/manager/processes/readDotEnv.mjs

@@ -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/manager/processes/reloadClients.mjs

@@ -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/manager/processes/restartServer.mjs

@@ -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.
@@ -19,9 +19,9 @@ import startServer from './startServer.mjs';
 function restartServer(context) {
   return () => {
     context.shutdownServer();
-    context.logger.info({ print: 'spin' }, 'Restarting server...');
+    context.logger.info({ spin: 'start' }, 'Restarting server...');
     startServer(context);
-    context.logger.info({ print: 'succeed' }, 'Restarted server.');
+    context.logger.info({ spin: 'succeed' }, 'Restarted server.');
   };
 }
 

package/manager/processes/shutdownServer.mjs

@@ -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.
@@ -21,7 +21,7 @@ function shutdownServer(context) {
         `Existing next server with pid ${context.nextServer.pid}, killed: ${context.nextServer.killed}`
       );
       if (!context.nextServer.killed) {
-        context.logger.info({ print: 'spin' }, 'Shutting down server...');
+        context.logger.info({ spin: 'start' }, 'Shutting down server...');
         context.nextServer.kill();
         context.logger.debug(
           `Killed next server with pid ${context.nextServer.pid}, killed: ${context.nextServer.killed}`

package/manager/processes/startServer.mjs

@@ -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.
@@ -14,26 +14,43 @@
   limitations under the License.
 */
 
-import { spawnProcess } from '@lowdefy/node-utils';
-import createStdOutLineHandler from '../utils/createStdOutLineHandler.mjs';
+import { spawn } from 'child_process';
+
+function createStdErrLineHandler({ context }) {
+  const port = context.options.port;
+  return function stdErrLineHandler(line) {
+    if (line.includes('EADDRINUSE')) {
+      context.logger.error(
+        `Port ${port} is already in use. Stop the other process or use a different port with --port.`
+      );
+      return;
+    }
+    context.logger.error(line);
+  };
+}
 
 function startServer(context) {
   context.shutdownServer();
 
-  const nextServer = spawnProcess({
-    stdOutLineHandler: createStdOutLineHandler({ context }),
-    stdErrLineHandler: (line) => context.logger.error(line),
-    command: 'node',
-    args: [context.bin.next, 'start'],
-    processOptions: {
-      env: {
-        ...process.env,
-        LOWDEFY_DIRECTORY_CONFIG: context.directories.config,
-        PORT: context.options.port,
-      },
+  const nextServer = spawn('node', [context.bin.next, 'start'], {
+    stdio: ['ignore', 'inherit', 'pipe'],
+    env: {
+      ...process.env,
+      LOWDEFY_DIRECTORY_CONFIG: context.directories.config,
+      PORT: context.options.port,
     },
-    returnProcess: true,
   });
+
+  const stdErrLineHandler = createStdErrLineHandler({ context });
+  nextServer.stderr.on('data', (data) => {
+    data
+      .toString('utf8')
+      .split('\n')
+      .forEach((line) => {
+        if (line) stdErrLineHandler(line);
+      });
+  });
+
   context.logger.debug(`Started next server with pid ${nextServer.pid}.`);
   nextServer.on('exit', (code, signal) => {
     context.logger.debug(`nextServer exit ${nextServer.pid}, signal: ${signal}, code: ${code}`);

package/manager/processes/startWatchers.mjs

@@ -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/manager/run.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /*
-  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.
@@ -19,6 +19,7 @@ import { wait } from '@lowdefy/helpers';
 import opener from 'opener';
 import getContext from './getContext.mjs';
 import startServer from './processes/startServer.mjs';
+import checkPortAvailable from './utils/checkPortAvailable.mjs';
 
 /*
 The run script does the following:
@@ -76,25 +77,16 @@ The run script does the following:
   pinging the /api/ping route, until it detects a new server has started, and then reloads the window.
  */
 
-/* TODO:
-Not killing server on errors properly
-when:
-- initial build fails
-*/
-
 const context = await getContext();
 
 try {
-  try {
-    await context.initialBuild();
-  } catch (error) {
-    context.logger.error(error);
-  }
+  await context.initialBuild();
 
   // We are not waiting for the startWatchers promise to resolve (all watchers have fired the ready event)
   // because chokidar sometimes doesn't fire this event, and it seems like there isn't an issue with not waiting.
   context.startWatchers();
 
+  await checkPortAvailable(context.options.port);
   startServer(context);
   await wait(800);
   if (process.env.LOWDEFY_SERVER_DEV_OPEN_BROWSER === 'true') {

package/manager/utils/BatchChanges.mjs

@@ -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/manager/utils/checkPortAvailable.mjs

@@ -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 { BuildError } from '@lowdefy/errors';
+import net from 'net';
+
+function checkPortAvailable(port) {
+  return new Promise((resolve, reject) => {
+    const server = net.createServer();
+    server.once('error', (err) => {
+      if (err.code === 'EADDRINUSE') {
+        reject(
+          new BuildError(
+            `Port ${port} is already in use. Stop the other process or use a different port with --port.`
+          )
+        );
+      } else {
+        reject(err);
+      }
+    });
+    server.once('listening', () => {
+      server.close(() => resolve());
+    });
+    server.listen(port);
+  });
+}
+
+export default checkPortAvailable;

package/manager/utils/createCustomPluginTypesMap.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /*
-  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/manager/utils/getLowdefyVersion.mjs

@@ -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.
@@ -17,10 +17,12 @@
 import path from 'path';
 import { type } from '@lowdefy/helpers';
 import { readFile } from '@lowdefy/node-utils';
+import { ConfigError } from '@lowdefy/errors';
 import YAML from 'yaml';
 
 async function getLowdefyVersion(context) {
-  let lowdefyYaml = await readFile(path.join(context.directories.config, 'lowdefy.yaml'));
+  const filePath = 'lowdefy.yaml';
+  let lowdefyYaml = await readFile(path.join(context.directories.config, filePath));
   if (!lowdefyYaml) {
     lowdefyYaml = await readFile(path.join(context.directories.config, 'lowdefy.yml'));
   }
@@ -31,7 +33,7 @@ async function getLowdefyVersion(context) {
   try {
     lowdefy = YAML.parse(lowdefyYaml);
   } catch (error) {
-    throw new Error(`Could not parse "lowdefy.yaml" file. Received error ${error.message}.`);
+    throw new ConfigError('Could not parse YAML.', { cause: error, filePath });
   }
   if (!lowdefy.lowdefy) {
     throw new Error(
@@ -39,10 +41,9 @@ async function getLowdefyVersion(context) {
     );
   }
   if (!type.isString(lowdefy.lowdefy)) {
-    throw new Error(
-      `Version number specified in "lowdefy.yaml" file should be a string. Received ${JSON.stringify(
-        lowdefy.lowdefy
-      )}.`
+    throw new ConfigError(
+      'Version number specified in "lowdefy.yaml" file should be a string.',
+      { received: lowdefy.lowdefy, filePath }
     );
   }
   return lowdefy.lowdefy;

package/manager/utils/getNextBin.mjs

@@ -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/manager/utils/setupWatcher.mjs

@@ -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/manager/watchers/envWatcher.mjs

@@ -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/manager/watchers/lowdefyBuildWatcher.mjs

@@ -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.
@@ -14,6 +14,7 @@
   limitations under the License.
 */
 
+import fs from 'fs';
 import path from 'path';
 import getLowdefyVersion from '../utils/getLowdefyVersion.mjs';
 import setupWatcher from '../utils/setupWatcher.mjs';
@@ -23,9 +24,13 @@ function lowdefyBuildWatcher(context) {
     path.isAbsolute(item) ? item : path.resolve(context.directories.config, item);
 
   const callback = async (filePaths) => {
-    const lowdefyYamlModified = filePaths
+    const changedFiles = filePaths
       .flat()
-      .some((filePath) => filePath.includes('lowdefy.yaml') || filePath.includes('lowdefy.yml'));
+      .map((filePath) => path.relative(context.directories.config, filePath));
+
+    const lowdefyYamlModified = changedFiles.some(
+      (filePath) => filePath === 'lowdefy.yaml' || filePath === 'lowdefy.yml'
+    );
     if (lowdefyYamlModified) {
       const lowdefyVersion = await getLowdefyVersion(context);
       if (lowdefyVersion !== context.version && lowdefyVersion !== 'local') {
@@ -35,8 +40,24 @@ function lowdefyBuildWatcher(context) {
       }
     }
 
-    await context.lowdefyBuild();
-    context.reloadClients();
+    try {
+      const isSkeletonChange =
+        lowdefyYamlModified ||
+        changedFiles.some((f) => !f.startsWith('pages/') && !f.startsWith('./'));
+
+      if (isSkeletonChange) {
+        await context.lowdefyBuild();
+      } else {
+        // Page-only changes: write signal file so the server invalidates its page cache
+        const invalidatePath = path.join(context.directories.build, 'invalidatePages');
+        fs.writeFileSync(invalidatePath, String(Date.now()));
+        context.logger.info('Page files changed, invalidated all pages.');
+      }
+    } catch (error) {
+      context.logger.error(error);
+    } finally {
+      await context.reloadClients();
+    }
   };
   return setupWatcher({
     callback,

package/manager/watchers/nextBuildWatcher.mjs

@@ -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.
@@ -86,7 +86,7 @@ async function nextBuildWatcher(context) {
       })
     );
     if (!build) {
-      context.logger.info({ print: 'succeed' }, 'Reloaded app.');
+      context.logger.info({ spin: 'succeed' }, 'Reloaded app.');
       return;
     }
 
@@ -94,6 +94,16 @@ async function nextBuildWatcher(context) {
     if (install) {
       context.logger.warn('Plugin dependencies have changed and will be reinstalled.');
       await context.installPlugins();
+      // Rebuild Lowdefy artifacts (blocks.js, icons.js, styles.less, etc.)
+      // so newly installed packages are included in the Next.js bundle.
+      await context.lowdefyBuild();
+      // Re-hash all tracked files to avoid detecting our own build output
+      // changes as new changes on the next watcher callback.
+      await Promise.all(
+        trackedFiles.map(async (filePath) => {
+          hashes[filePath] = await sha1(filePath);
+        })
+      );
     }
     await context.nextBuild();
     context.restartServer();

package/next.config.js

@@ -1,7 +1,7 @@
 const withLess = require('next-with-less');
 const lowdefyConfig = require('./build/config.json');
 
-module.exports = withLess({
+const nextConfig = withLess({
   basePath: lowdefyConfig.basePath,
   // reactStrictMode: true,
   webpack: (config, { isServer }) => {
@@ -19,7 +19,6 @@ module.exports = withLess({
     }
     return config;
   },
-  swcMinify: false,
   compress: false,
   outputFileTracing: false,
   poweredByHeader: false,
@@ -29,3 +28,5 @@ module.exports = withLess({
     ignoreDuringBuilds: true,
   },
 });
+
+module.exports = nextConfig;