@lowdefy/server-dev 0.0.0-experimental-20260720072521 → 0.0.0-experimental-20260720135014

package/lib/docs/screenshotPageClip.test.mjs

@@ -1,102 +0,0 @@
-/*
-  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 { jest } from '@jest/globals';
-
-// Covers the clip/scroll success path, which screenshotPage.test.mjs cannot
-// (it deliberately fails chromium.launch to test the "no browser" error
-// path). Mocking the whole ./getBrowser.js module — not just
-// playwright-core — means lib/build/config.js (which getBrowser.js reads at
-// import time) is never touched, so no fixture chdir is needed here.
-const mockScreenshot = jest.fn(async () => Buffer.from('fake-png'));
-const mockWaitForTimeout = jest.fn(async () => {});
-const mockEvaluate = jest.fn(async () => {});
-const mockPage = {
-  screenshot: mockScreenshot,
-  waitForTimeout: mockWaitForTimeout,
-  evaluate: mockEvaluate,
-};
-const mockContext = { close: jest.fn(async () => {}) };
-const mockOpenPage = jest.fn(async () => ({
-  context: mockContext,
-  page: mockPage,
-  url: 'http://localhost:3001/home',
-}));
-const mockGetBrowser = jest.fn(async () => ({}));
-
-jest.unstable_mockModule('./getBrowser.js', () => ({
-  getBrowser: mockGetBrowser,
-  openPage: mockOpenPage,
-  buildPageUrl: jest.fn(() => 'http://localhost:3001/home'),
-}));
-
-const { default: screenshotPage } = await import('./screenshotPage.js');
-
-test('screenshotPage with a valid clip scrolls to scrollX/scrollY and converts clip to document coordinates', async () => {
-  const result = await screenshotPage({
-    origin: 'http://localhost:3001',
-    pageId: 'home',
-    clip: { x: 220, y: 480, width: 96, height: 40 },
-    scrollX: 10,
-    scrollY: 340,
-  });
-
-  expect(result.error).toBeUndefined();
-  expect(mockEvaluate).toHaveBeenCalledWith(expect.any(Function), { x: 10, y: 340 });
-  expect(mockScreenshot).toHaveBeenCalledWith({
-    type: 'png',
-    clip: { x: 230, y: 820, width: 96, height: 40 },
-  });
-});
-
-test('screenshotPage without a clip takes a normal fullPage/viewport screenshot and never scrolls', async () => {
-  const result = await screenshotPage({
-    origin: 'http://localhost:3001',
-    pageId: 'home',
-    fullPage: true,
-  });
-
-  expect(result.error).toBeUndefined();
-  expect(mockEvaluate).not.toHaveBeenCalled();
-  expect(mockScreenshot).toHaveBeenCalledWith({ type: 'png', fullPage: true });
-});
-
-test('screenshotPage ignores a clip with non-positive dimensions and falls back to a viewport screenshot', async () => {
-  const result = await screenshotPage({
-    origin: 'http://localhost:3001',
-    pageId: 'home',
-    clip: { x: 0, y: 0, width: 0, height: 40 },
-  });
-
-  expect(result.error).toBeUndefined();
-  expect(mockEvaluate).not.toHaveBeenCalled();
-  expect(mockScreenshot).toHaveBeenCalledWith({ type: 'png', fullPage: false });
-});
-
-test('screenshotPage clip takes priority over fullPage when both are provided', async () => {
-  const result = await screenshotPage({
-    origin: 'http://localhost:3001',
-    pageId: 'home',
-    fullPage: true,
-    clip: { x: 1, y: 2, width: 3, height: 4 },
-  });
-
-  expect(result.error).toBeUndefined();
-  expect(mockScreenshot).toHaveBeenCalledWith({
-    type: 'png',
-    clip: { x: 1, y: 2, width: 3, height: 4 },
-  });
-});

package/lib/docs/searchDocs.js

@@ -1,67 +0,0 @@
-/*
-  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 fs from 'node:fs';
-import path from 'node:path';
-import { type } from '@lowdefy/helpers';
-
-import getDocsManifest from './getDocsManifest.js';
-
-const MAX_RESULTS = 20;
-const SNIPPET_RADIUS = 120;
-
-let contentCache = null;
-
-function getContents({ manifest }) {
-  if (contentCache !== null) {
-    return contentCache;
-  }
-  contentCache = manifest.docs.map((doc) => ({
-    doc,
-    content: fs.readFileSync(path.join(manifest.contentDir, doc.path), 'utf8'),
-  }));
-  return contentCache;
-}
-
-function searchDocs({ query }) {
-  if (!type.isString(query) || query.trim() === '') {
-    throw new Error('searchDocs requires a "query" string.');
-  }
-  const manifest = getDocsManifest();
-  if (type.isNone(manifest)) {
-    return [];
-  }
-  const lowerQuery = query.trim().toLowerCase();
-  const titleMatches = [];
-  const contentMatches = [];
-  for (const { doc, content } of getContents({ manifest })) {
-    if (doc.title.toLowerCase().includes(lowerQuery) || doc.slug.includes(lowerQuery)) {
-      titleMatches.push({ ...doc, snippet: content.slice(0, SNIPPET_RADIUS * 2) });
-      continue;
-    }
-    const index = content.toLowerCase().indexOf(lowerQuery);
-    if (index !== -1) {
-      const start = Math.max(0, index - SNIPPET_RADIUS);
-      contentMatches.push({
-        ...doc,
-        snippet: content.slice(start, index + lowerQuery.length + SNIPPET_RADIUS),
-      });
-    }
-  }
-  return [...titleMatches, ...contentMatches].slice(0, MAX_RESULTS);
-}
-
-export default searchDocs;

package/lib/docs/setupTestFixtures.mjs

@@ -1,335 +0,0 @@
-/*
-  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 fs from 'fs';
-import os from 'os';
-import path from 'path';
-
-// Writes a throwaway server directory (build artifacts + a fake installed
-// plugin in node_modules) for the docs service tests. Generated because a
-// committed node_modules fixture would be gitignored.
-function setupTestFixtures() {
-  const fixtureDir = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-docs-test-'));
-  const write = (relativePath, data) => {
-    const filePath = path.join(fixtureDir, relativePath);
-    fs.mkdirSync(path.dirname(filePath), { recursive: true });
-    fs.writeFileSync(filePath, typeof data === 'string' ? data : JSON.stringify(data));
-  };
-
-  write('package.json', { name: 'test-fixture-server', version: '1.0.0', type: 'module' });
-
-  // lib/build/config.js reads this at import time (screenshotPage → basePath).
-  write('build/config.json', {});
-
-  write('build/plugins/availableTypes.json', {
-    actions: {
-      SetState: { package: '@lowdefy/actions-core', originalTypeName: 'SetState', version: '5.0.0' },
-    },
-    agents: {},
-    auth: { adapters: {}, callbacks: {}, events: {}, providers: {} },
-    blocks: {
-      Button: { package: '@lowdefy/blocks-antd', originalTypeName: 'Button', version: '5.0.0' },
-      TestBlock: { package: 'test-plugin', originalTypeName: 'TestBlock', version: '1.0.0' },
-    },
-    connections: {
-      AxiosHttp: {
-        package: '@lowdefy/connection-axios-http',
-        originalTypeName: 'AxiosHttp',
-        version: '5.0.0',
-      },
-    },
-    notifications: {},
-    operators: {
-      client: {
-        _get: { package: '@lowdefy/operators-js', originalTypeName: '_get', version: '5.0.0' },
-      },
-      server: {
-        _get: { package: '@lowdefy/operators-js', originalTypeName: '_get', version: '5.0.0' },
-        _secret: { package: '@lowdefy/operators-js', originalTypeName: '_secret', version: '5.0.0' },
-      },
-    },
-    requests: {
-      AxiosHttp: {
-        package: '@lowdefy/connection-axios-http',
-        originalTypeName: 'AxiosHttp',
-        version: '5.0.0',
-      },
-    },
-    websockets: {},
-  });
-
-  write('build/types.json', {
-    actions: {},
-    agents: {},
-    auth: { adapters: {}, callbacks: {}, events: {}, providers: {} },
-    blocks: {
-      Button: {
-        package: '@lowdefy/blocks-antd',
-        originalTypeName: 'Button',
-        version: '5.0.0',
-        count: 3,
-      },
-    },
-    connections: {},
-    notifications: {},
-    operators: {
-      client: {
-        _get: {
-          package: '@lowdefy/operators-js',
-          originalTypeName: '_get',
-          version: '5.0.0',
-          count: 1,
-        },
-      },
-      server: {},
-    },
-    requests: {},
-    websockets: {},
-  });
-
-  write('build/plugins/blockSchemas.json', {
-    Button: { type: 'object', properties: { title: { type: 'string' } } },
-    TestBlock: { type: 'object', properties: {} },
-  });
-  write('build/plugins/blockMetas.json', {
-    Button: { category: 'display' },
-    TestBlock: { category: 'input', valueType: 'string' },
-  });
-  write('build/plugins/actionSchemas.json', { SetState: { type: 'object' } });
-  write('build/plugins/operatorSchemas.json', { _get: { params: { type: 'object' } } });
-  write('build/plugins/connectionSchemas.json', {
-    AxiosHttp: { schema: { type: 'object' }, requests: ['AxiosHttp'] },
-  });
-  write('build/plugins/requestSchemas.json', {
-    AxiosHttp: { schema: { type: 'object' }, meta: { checkRead: false, checkWrite: false } },
-    ReadOnlyRequest: { schema: { type: 'object' }, meta: { checkRead: true, checkWrite: false } },
-    WriteRequest: { schema: { type: 'object' }, meta: { checkRead: true, checkWrite: true } },
-    // No "meta" at all — some custom plugins don't declare it; treated as unknown.
-    UnknownMetaRequest: { schema: { type: 'object' } },
-  });
-  write('build/customTypesMap.json', {
-    blocks: { TestBlock: { package: 'test-plugin', originalTypeName: 'TestBlock', version: '1.0.0' } },
-  });
-  write('build/installedPluginPackages.json', [
-    '@lowdefy/blocks-antd',
-    '@lowdefy/actions-core',
-    '@lowdefy/operators-js',
-    '@lowdefy/connection-axios-http',
-    'test-plugin',
-  ]);
-
-  write('node_modules/test-plugin/package.json', { name: 'test-plugin', version: '1.0.0' });
-  write('node_modules/test-plugin/README.md', '# test-plugin\n\nA local test plugin.\n');
-  write(
-    'node_modules/test-plugin/dist/blocks/TestBlock/gallery.yaml',
-    '- id: example\n  type: TestBlock\n  properties:\n    title: Hello\n'
-  );
-
-  // Feedback-loop fixtures — build status, and a JIT-built page's registry,
-  // keyMap and refMap entries (see packages/build/src/build/addKeys.js for
-  // the key path format: `[index:id]` / `[index:id:Type]`).
-  write('build/buildStatus.json', {
-    status: 'ok',
-    timestamp: '2026-01-01T00:00:00.000Z',
-    errors: [],
-    warnings: [],
-  });
-
-  write('build/pageRegistry.json', {
-    home: { pageId: 'home', auth: null, refId: 'ref-home', refPath: 'pages/home.yaml' },
-    other: { pageId: 'other', auth: null, refId: 'ref-other', refPath: 'pages/other.yaml' },
-    legal: { pageId: 'legal', auth: null, refId: 'ref-legal', refPath: 'pages/legal.yaml' },
-    unbuilt: { pageId: 'unbuilt', auth: null, refId: 'ref-unbuilt', refPath: 'pages/unbuilt.yaml' },
-  });
-
-  // Mirrors the real dev keyMap shape: the skeleton build keys the whole
-  // config (`root.pages[N:id]` page stubs only), while each JIT page build
-  // runs addKeys on the page object itself — so page CONTENT keys are
-  // `root.blocks[...]` with no page segment, one `root`-keyed subtree per
-  // built page, distinguishable only via the ~k_parent chain. Tree roots
-  // reference a parent id that is never written to keyMap.
-  write('build/keyMap.json', {
-    'key-root': { key: 'root', '~k_parent': 'key-root-parent' },
-    'key-pages': { key: 'root.pages', '~k_parent': 'key-root', '~r': 'ref-home' },
-    'key-home-stub': {
-      key: 'root.pages[0:home]',
-      '~k_parent': 'key-pages',
-      '~r': 'ref-home',
-      '~l': 1,
-    },
-    'key-other-stub': {
-      key: 'root.pages[1:other]',
-      '~k_parent': 'key-pages',
-      '~r': 'ref-other',
-      '~l': 1,
-    },
-    // JIT subtree for page "home".
-    'key-home': { key: 'root', '~k_parent': 'key-home-jit-parent', '~r': 'ref-home', '~l': 1 },
-    'key-button': {
-      key: 'root.blocks[2:my_button:Button]',
-      '~k_parent': 'key-home',
-      '~r': 'ref-home',
-      '~l': 5,
-    },
-    // List item block — config ids inside lists carry the `$` placeholder;
-    // runtime block ids have array indices applied (`my_list.0.item_title`).
-    'key-list-item': {
-      key: 'root.blocks[3:my_list:List].blocks[0:my_list.$.item_title:Title]',
-      '~k_parent': 'key-home',
-      '~r': 'ref-home',
-      '~l': 9,
-    },
-    // JIT subtree for page "other" — holds a block id that also exists on
-    // home, with an IDENTICAL key shape. findConfig must scope pageId scans
-    // via the ~k_parent chain, not the key path.
-    'key-other': { key: 'root', '~k_parent': 'key-other-jit-parent', '~r': 'ref-other', '~l': 1 },
-    'key-other-button': {
-      key: 'root.blocks[0:my_button:Button]',
-      '~k_parent': 'key-other',
-      '~r': 'ref-other',
-      '~l': 4,
-    },
-    // Skeleton-built page (like the default 404) — content is keyed inside
-    // the global config tree with the page segment inline, and chains to the
-    // shared config root rather than a page-specific one.
-    'key-legal': {
-      key: 'root.pages[2:legal]',
-      '~k_parent': 'key-pages',
-      '~r': 'ref-legal',
-      '~l': 1,
-    },
-    'key-legal-button': {
-      key: 'root.pages[2:legal].blocks[0:legal_button:Button]',
-      '~k_parent': 'key-legal',
-      '~r': 'ref-legal',
-      '~l': 3,
-    },
-  });
-
-  write('build/refMap.json', {
-    'ref-home': { parent: null, path: 'pages/home.yaml' },
-    'ref-other': { parent: null, path: 'pages/other.yaml' },
-    'ref-legal': { parent: null, path: 'pages/legal.yaml' },
-  });
-
-  write('build/pages/home.json', {
-    pageId: 'home',
-    blocks: [
-      { id: 'my_button', type: 'Button', '~k': 'key-button' },
-      {
-        id: 'card',
-        type: 'Card',
-        slots: { content: { blocks: [{ id: 'nested_button', type: 'Button' }] } },
-      },
-    ],
-    requests: [
-      { id: 'request:home:req-read', requestId: 'req-read', payload: {} },
-      { id: 'request:home:req-write', requestId: 'req-write', payload: {} },
-      { id: 'request:home:req-unknown', requestId: 'req-unknown', payload: {} },
-    ],
-  });
-
-  write('build/pages/other.json', {
-    pageId: 'other',
-    blocks: [{ id: 'my_button', type: 'Button', '~k': 'key-other-button' }],
-    requests: [],
-  });
-
-  write('build/pages/legal.json', {
-    pageId: 'legal',
-    blocks: [{ id: 'legal_button', type: 'Button', '~k': 'key-legal-button' }],
-    requests: [],
-  });
-
-  // Per-request artifacts (packages/build/src/build/full/writeRequests.js
-  // strips type/connectionId/properties/auth off the page's `requests` array
-  // after writing these, so a request's type is only readable here).
-  write('build/pages/home/requests/req-read.json', {
-    id: 'request:home:req-read',
-    requestId: 'req-read',
-    pageId: 'home',
-    connectionId: 'axios',
-    type: 'ReadOnlyRequest',
-    payload: {},
-    properties: {},
-  });
-  write('build/pages/home/requests/req-write.json', {
-    id: 'request:home:req-write',
-    requestId: 'req-write',
-    pageId: 'home',
-    connectionId: 'axios',
-    type: 'WriteRequest',
-    payload: {},
-    properties: {},
-  });
-  write('build/pages/home/requests/req-unknown.json', {
-    id: 'request:home:req-unknown',
-    requestId: 'req-unknown',
-    pageId: 'home',
-    connectionId: 'axios',
-    type: 'UnknownMetaRequest',
-    payload: {},
-    properties: {},
-  });
-
-  write('build/connectionIds.json', ['axios']);
-  write('build/connections/axios.json', {
-    id: 'connection:axios',
-    connectionId: 'axios',
-    type: 'AxiosHttp',
-    properties: {},
-  });
-
-  write('build/menus.json', [
-    {
-      id: 'menu:default',
-      menuId: 'default',
-      links: [
-        {
-          id: 'menuitem:default:home',
-          menuItemId: 'home',
-          type: 'MenuLink',
-          pageId: 'home',
-          properties: { title: 'Home' },
-        },
-      ],
-    },
-  ]);
-
-  write('build/api/resolve_greeting.json', {
-    id: 'endpoint:resolve_greeting',
-    type: 'InternalApi',
-    routine: [],
-  });
-
-  write('build/agents/assistant.json', {
-    id: 'agent:assistant',
-    agentId: 'assistant',
-    type: 'OpenAiAgent',
-    connectionId: 'axios',
-  });
-
-  write('build/websocketIds.json', []);
-
-  // No cli.agentTools.allowWriteRequests — tests toggle this file directly
-  // (isWriteRequestsAllowed reads it fresh, no caching) to exercise the
-  // opt-in gate.
-  write('lowdefy.yaml', 'lowdefy: 5.0.0\n');
-
-  return fixtureDir;
-}
-
-export default setupTestFixtures;

package/lib/docs/snapshotState.js

@@ -1,59 +0,0 @@
-/*
-  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 { buildPageUrl } from './getBrowser.js';
-import inspectState from './inspectState.js';
-import { writeCheckpoint } from './checkpointStore.js';
-
-// Snapshots the running app (page state + recorded request/api responses)
-// into a checkpoint folder under .lowdefy — see checkpointStore.js for the
-// on-disk layout. Reuses inspectState.js's tab-first/headless-fallback
-// snapshot rather than driving a browser directly, so a snapshot always
-// reflects whatever a developer is actually looking at when one is
-// available.
-async function snapshotState({ origin, pageId, name, notes, source, overwrite }) {
-  if (type.isNone(pageId) || !type.isString(pageId)) {
-    return {
-      error: `snapshotState requires a "pageId" string. Received ${JSON.stringify(pageId)}.`,
-    };
-  }
-  if (type.isNone(name) || !type.isString(name)) {
-    return { error: `snapshotState requires a "name" string. Received ${JSON.stringify(name)}.` };
-  }
-
-  const snapshot = await inspectState({ origin, pageId, source });
-  if (snapshot?.error) {
-    return { error: snapshot.error };
-  }
-
-  const url = `${buildPageUrl({ origin, pageId })}${snapshot.urlQuery ?? ''}`;
-
-  try {
-    const { dir, parts } = writeCheckpoint({
-      name,
-      snapshot: { ...snapshot, url },
-      notes,
-      overwrite,
-    });
-    return { name, dir, parts, source: snapshot.source };
-  } catch (error) {
-    return { error: error.message };
-  }
-}
-
-export default snapshotState;