@lowdefy/e2e-utils 0.0.0-experimental-20260311112138 → 4.7.0

package/dist/config.js

@@ -40,7 +40,12 @@ function createConfig({ appDir = './', buildDir = '.lowdefy/server/build', comma
         use: {
             baseURL: `http://localhost:${port}`,
             trace: 'on-first-retry',
-            screenshot
+            screenshot,
+            ...process.env.SLOW_MO && {
+                launchOptions: {
+                    slowMo: Number(process.env.SLOW_MO)
+                }
+            }
         },
         projects: [
             {
@@ -102,7 +107,12 @@ function createMultiAppConfig({ apps = [], commandPrefix = '', testDir = 'e2e',
         outputDir,
         use: {
             trace: 'on-first-retry',
-            screenshot
+            screenshot,
+            ...process.env.SLOW_MO && {
+                launchOptions: {
+                    slowMo: Number(process.env.SLOW_MO)
+                }
+            }
         },
         projects,
         webServer

package/dist/core/escapeId.js

@@ -0,0 +1,18 @@
+/*
+  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.
+*/ function escapeId(id) {
+    return id.replace(/([^\w-])/g, '\\$1');
+}
+export { escapeId };

package/dist/core/locators.js

@@ -12,7 +12,8 @@
   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.
-*/ function getBlock(page, blockId) {
-    return page.locator(`#bl-${blockId}`);
+*/ import { escapeId } from './escapeId.js';
+function getBlock(page, blockId) {
+    return page.locator(`#bl-${escapeId(blockId)}`);
 }
 export { getBlock };

package/dist/index.js

@@ -13,12 +13,14 @@
   See the License for the specific language governing permissions and
   limitations under the License.
 */ // Core helpers
+import { escapeId } from './core/escapeId.js';
 import { getBlock } from './core/locators.js';
 import { goto, waitForReady, expectNavigation, waitForPage } from './core/navigation.js';
 import { getRequestState, getRequestResponse, expectRequest } from './core/requests.js';
 import { getState, getBlockState, setState, expectState } from './core/state.js';
 import { getValidation, expectValidationStatus, expectValidationError, expectValidationWarning, expectValidationSuccess } from './core/validation.js';
 import { expectUrl, expectUrlQuery, setUrlQuery } from './core/url.js';
+export { escapeId };
 export { getBlock };
 export { goto, waitForReady, expectNavigation, waitForPage };
 export { getRequestState, getRequestResponse, expectRequest };

package/dist/init/generateFiles.js

@@ -66,10 +66,18 @@ function updatePackageJson({ appPath, cwd, useExperimental, useMongoDB }) {
         pkg.scripts.e2e = 'playwright test --config=e2e/playwright.config.js';
         updated = true;
     }
+    if (!pkg.scripts['e2e:headed']) {
+        pkg.scripts['e2e:headed'] = 'SLOW_MO=500 playwright test --headed --workers=1 --config=e2e/playwright.config.js';
+        updated = true;
+    }
     if (!pkg.scripts['e2e:ui']) {
         pkg.scripts['e2e:ui'] = 'playwright test --ui --config=e2e/playwright.config.js';
         updated = true;
     }
+    if (!pkg.scripts['e2e:server']) {
+        pkg.scripts['e2e:server'] = 'lowdefy build --server e2e && lowdefy start --port 3000 --log-level warn';
+        updated = true;
+    }
     // Add devDependencies
     const tag = useExperimental ? 'experimental' : 'latest';
     pkg.devDependencies = pkg.devDependencies || {};

package/dist/init/index.js

@@ -142,8 +142,10 @@ async function init() {
         const app = selectedApps[0];
         console.log(`Run tests from ${app.path}:`);
         console.log(`  cd ${app.path}`);
-        console.log('  pnpm e2e');
-        console.log('  pnpm e2e:ui  # for UI mode');
+        console.log('  pnpm e2e            # Run all tests');
+        console.log('  pnpm e2e:headed     # Run with visible browser');
+        console.log('  pnpm e2e:ui         # Playwright UI mode');
+        console.log('  pnpm e2e:server     # Start server for reuse');
     } else {
         console.log('Run tests from each app directory:');
         for (const app of selectedApps){

package/dist/init/templates/README.md.template

@@ -5,10 +5,32 @@ End-to-end tests for your Lowdefy app using Playwright.
 ## Running Tests
 
 ```bash
-pnpm e2e        # Run all tests
-pnpm e2e:ui     # Run in UI mode (interactive)
+pnpm e2e            # Run all tests
+pnpm e2e:headed     # Run with visible browser (slow motion)
+pnpm e2e:ui         # Playwright UI mode (interactive)
+pnpm e2e:server     # Start server for reuse (skip rebuilds)
 ```
 
+## Faster Test Runs
+
+By default, `pnpm e2e` does a full build before running tests. To skip the build during development:
+
+1. **Start the server once** in a separate terminal:
+
+   ```bash
+   pnpm e2e:server
+   ```
+
+2. **Run tests** in another terminal — the config has `reuseExistingServer: true`, so Playwright detects the running server and skips the build:
+
+   ```bash
+   pnpm e2e
+   ```
+
+This saves 60-90 seconds per run. Keep the server running while iterating on tests.
+
+> **Tip:** If port 3000 is already in use, change the port in both the `e2e:server` script in `package.json` and the `port` option in `playwright.config.js`.
+
 ## File Structure
 
 ```
@@ -136,6 +158,28 @@ await ldf.mock.request('fetch_user', {
 });
 ```
 
+## Common Patterns
+
+### Testing Page Navigation
+
+When a form submit navigates away from the page (e.g., `Link: back`, redirects), use `Promise.all` with `page.waitForURL()` and the click action:
+
+```javascript
+test('submits form and navigates back', async ({ ldf, page }) => {
+  await ldf.goto('/my-form');
+
+  await ldf.block('name_input').do.fill('Test');
+
+  // Wait for navigation and click simultaneously
+  await Promise.all([
+    page.waitForURL((url) => !url.pathname.includes('/my-form'), { timeout: 30000 }),
+    ldf.block('submit_btn').do.click(),
+  ]);
+});
+```
+
+**Why not `ldf.request().expect.toFinish()`?** When the page navigates away, the page context is destroyed. Any pending request assertions will fail because the Lowdefy runtime that tracks requests no longer exists. Use `page.waitForURL()` instead to assert that the navigation happened.
+
 ## Playwright Configuration
 
 Edit `playwright.config.js` to customize test behavior.
@@ -144,7 +188,7 @@ Edit `playwright.config.js` to customize test behavior.
 
 | Option | Default | Description |
 |--------|---------|-------------|
-| `appDir` | `'../'` | Path to your Lowdefy app root (relative to config file) |
+| `appDir` | `'./'` | Path to your Lowdefy app root (relative to cwd) |
 | `buildDir` | `'.lowdefy/server/build'` | Build output directory (relative to appDir) |
 | `mocksFile` | `'e2e/mocks.yaml'` | Static mocks file path (relative to appDir) |
 | `port` | `3000` | Port for the test server |
@@ -160,7 +204,7 @@ Edit `playwright.config.js` to customize test behavior.
 import { createConfig } from '@lowdefy/e2e-utils/config';
 
 export default createConfig({
-  appDir: '../',
+  appDir: './',
   port: 3001,                    // Use different port
   timeout: 300000,               // 5 min timeout for slow builds
   screenshot: 'on',              // Always capture screenshots
@@ -177,8 +221,8 @@ import { createMultiAppConfig } from '@lowdefy/e2e-utils/config';
 
 export default createMultiAppConfig({
   apps: [
-    { name: 'admin', appDir: '../apps/admin', port: 3001 },
-    { name: 'customer', appDir: '../apps/customer', port: 3002 },
+    { name: 'admin', appDir: './apps/admin', port: 3001 },
+    { name: 'customer', appDir: './apps/customer', port: 3002 },
   ],
   testDir: '.',
   timeout: 180000,

package/dist/init/templates/example.spec.js.template

@@ -1,10 +1,8 @@
 import { test, expect } from '@lowdefy/e2e-utils/fixtures';
 
-test('homepage loads', async ({ ldf }) => {
-  await ldf.goto('/');
-
-  // Replace with your own assertions
-  await expect(ldf.page).toHaveTitle(/./);
+test('app is running', async ({ ldf }) => {
+  const response = await ldf.page.goto('/api/auth/session');
+  expect(response.status()).toBe(200);
 });
 
 // Example: Testing a form

package/dist/init/templates/fixtures.js.template

@@ -1,5 +1,6 @@
 import { test as ldfTest, expect } from '@lowdefy/e2e-utils/fixtures';
-import { mdbFixture } from '@lowdefy/community-plugin-e2e-mdb';
+import { mdbFixtures } from '@lowdefy/community-plugin-e2e-mdb/fixtures';
+import { mergeTests } from '@playwright/test';
 
-export const test = ldfTest.extend(mdbFixture);
+export const test = mergeTests(ldfTest, mdbFixtures);
 export { expect };

package/dist/init/templates/playwright.config.js.template

@@ -1,7 +1,7 @@
 import { createConfig } from '@lowdefy/e2e-utils/config';
 
 export default createConfig({
-  appDir: '../', // Go up from e2e/ to app root
+  appDir: './', // Resolved relative to cwd (where pnpm e2e runs)
   testDir: '.', // Tests are in same dir as config
   port: 3000,
   // If your app needs environment variables (e.g., via infisical, dotenv-vault, aws-vault):

package/dist/testPrep/generateManifest.js

@@ -26,28 +26,16 @@ function generateManifest({ buildDir = '.lowdefy' }) {
         pages: {}
     };
     if (fs.existsSync(pagesDir)) {
-        // Recursively find all .json page config files under pages/
-        // Page artifacts are written as pages/{pageId}.json where pageId may contain slashes.
-        // Skip files inside /requests/ subdirectories (those are request artifacts).
-        function findPageFiles(dir, prefix) {
-            for (const entry of fs.readdirSync(dir, {
-                withFileTypes: true
-            })){
-                if (entry.isDirectory()) {
-                    if (entry.name === 'requests') continue;
-                    findPageFiles(path.join(dir, entry.name), prefix ? `${prefix}/${entry.name}` : entry.name);
-                } else if (entry.isFile() && entry.name.endsWith('.json')) {
-                    const pageId = prefix ? `${prefix}/${entry.name.replace(/\.json$/, '')}` : entry.name.replace(/\.json$/, '');
-                    const pageConfigPath = path.join(dir, entry.name);
-                    const pageConfig = JSON.parse(fs.readFileSync(pageConfigPath, 'utf-8'));
-                    manifest.pages[pageId] = extractBlockMap({
-                        pageConfig,
-                        typesBlocks: types.blocks ?? {}
-                    });
-                }
+        for (const pageId of fs.readdirSync(pagesDir)){
+            const pageConfigPath = path.join(pagesDir, pageId, `${pageId}.json`);
+            if (fs.existsSync(pageConfigPath)) {
+                const pageConfig = JSON.parse(fs.readFileSync(pageConfigPath, 'utf-8'));
+                manifest.pages[pageId] = extractBlockMap({
+                    pageConfig,
+                    typesBlocks: types.blocks ?? {}
+                });
             }
         }
-        findPageFiles(pagesDir, '');
     }
     const manifestPath = path.join(buildDir, 'e2e-manifest.json');
     const tempPath = path.join(buildDir, `e2e-manifest.${process.pid}.tmp`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/e2e-utils",
-  "version": "0.0.0-experimental-20260311112138",
+  "version": "4.7.0",
   "license": "Apache-2.0",
   "description": "Lowdefy E2E Testing Utilities for Playwright",
   "homepage": "https://lowdefy.com",
@@ -36,7 +36,7 @@
     "dist/*"
   ],
   "dependencies": {
-    "@lowdefy/helpers": "0.0.0-experimental-20260311112138",
+    "@lowdefy/helpers": "4.7.0",
     "js-yaml": "4.1.0",
     "prompts": "2.4.2"
   },
@@ -46,7 +46,8 @@
   "devDependencies": {
     "@swc/cli": "0.1.63",
     "@swc/core": "1.3.99",
-    "copyfiles": "2.4.1"
+    "copyfiles": "2.4.1",
+    "jest": "28.1.3"
   },
   "publishConfig": {
     "access": "public"
@@ -54,6 +55,7 @@
   "scripts": {
     "build": "swc src --out-dir dist --config-file ../../../.swcrc --delete-dir-on-start && pnpm copyfiles",
     "clean": "rm -rf dist",
-    "copyfiles": "copyfiles -u 1 \"./src/init/templates/*\" dist"
+    "copyfiles": "copyfiles -u 1 \"./src/init/templates/*\" dist",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js"
   }
 }