@lowdefy/shell 0.0.0-experimental-20261019052246

package/src/test/expoUiSwiftUi.js

@@ -0,0 +1,62 @@
+/*
+  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';
+import { Pressable, Text, View } from 'react-native';
+
+// Stand-ins for the @expo/ui SwiftUI views the blocks use, which need native modules Jest does not
+// have. ContextMenu draws its trigger, and its items as pressable buttons with the props the
+// block passes, so a test can press an item.
+
+function Host({ children, colorScheme, testID }) {
+  return (
+    <View colorScheme={colorScheme} testID={testID}>
+      {children}
+    </View>
+  );
+}
+
+function Slot({ children }) {
+  return <>{children}</>;
+}
+
+function ContextMenu({ children }) {
+  return <View testID="expo-ui-context-menu">{children}</View>;
+}
+ContextMenu.Items = function Items({ children }) {
+  return <View testID="expo-ui-context-menu-items">{children}</View>;
+};
+ContextMenu.Trigger = Slot;
+ContextMenu.Preview = Slot;
+
+function Button({ label, onPress, role, systemImage }) {
+  return (
+    <Pressable
+      onPress={onPress}
+      role={role}
+      systemImage={systemImage}
+      testID={`expo-ui-button-${label}`}
+    >
+      <Text>{label}</Text>
+    </Pressable>
+  );
+}
+
+function RNHostView({ children }) {
+  return children;
+}
+
+export { Button, ContextMenu, Host, RNHostView };

package/src/test/expoUiSwiftUiModifiers.js

@@ -0,0 +1,23 @@
+/*
+  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.
+*/
+
+// A stand-in for @expo/ui's SwiftUI modifiers, which reach the ExpoUI native module Jest does not
+// have: each modifier is its name and params, so a test reads what a block asked SwiftUI for.
+function font(params) {
+  return { $type: 'font', ...params };
+}
+
+export { font };

package/src/test/expoWebBrowser.js

@@ -0,0 +1,23 @@
+/*
+  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';
+
+// A stand-in for expo-web-browser, whose in-app browser needs a native module Jest does not have.
+// A test reads the addresses a block opened from openBrowserAsync's calls.
+const openBrowserAsync = jest.fn(async () => ({ type: 'dismiss' }));
+
+export { openBrowserAsync };

package/src/test/fixtures.js

@@ -0,0 +1,98 @@
+/*
+  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.
+*/
+
+const typeManifest = {
+  actions: {
+    SetState: { package: '@lowdefy/actions-core', version: 7 },
+  },
+  blocks: {
+    Box: { package: '@lowdefy/blocks-native', version: 7 },
+    Screen: { package: '@lowdefy/blocks-native', version: 7 },
+    Title: { package: '@lowdefy/blocks-native', version: 7 },
+  },
+  operators: {
+    _state: { package: '@lowdefy/operators-js', version: 7 },
+  },
+};
+
+const shell = { version: '7.4.0', typeManifest };
+
+const typeSets = {
+  carried: {
+    actions: [{ type: 'SetState', package: '@lowdefy/actions-core', version: 7 }],
+    blocks: [
+      { type: 'Screen', package: '@lowdefy/blocks-native', version: 7 },
+      { type: 'Title', package: '@lowdefy/blocks-native', version: 7 },
+    ],
+    operators: [{ type: '_state', package: '@lowdefy/operators-js', version: 7 }],
+  },
+  newBlock: {
+    actions: [],
+    blocks: [
+      { type: 'Screen', package: '@lowdefy/blocks-native', version: 7 },
+      { type: 'Map', package: '@lowdefy/blocks-native', version: 7 },
+    ],
+    operators: [],
+  },
+  nextMajor: {
+    actions: [],
+    blocks: [{ type: 'Title', package: '@lowdefy/blocks-native', version: 8 }],
+    operators: [],
+  },
+};
+
+function createPage(pageId, title = pageId) {
+  return {
+    id: `page:${pageId}`,
+    pageId,
+    blockId: pageId,
+    type: 'Screen',
+    properties: { title },
+    slots: { content: { blocks: [{ id: `block:${pageId}:t:0`, blockId: 't', type: 'Title' }] } },
+  };
+}
+
+function createRoot({ buildId = 'build-1', minShellVersion = null, pageIndex, ...rest } = {}) {
+  return {
+    events: {},
+    homePageId: 'today',
+    lowdefyApp: { slug: 'field', buildId },
+    lowdefyGlobal: {},
+    menus: {
+      tabs: [
+        { pageId: 'today', title: 'Today' },
+        { pageId: 'jobs', title: 'Jobs' },
+      ],
+    },
+    minShellVersion,
+    pageIndex: pageIndex ?? [
+      { path: 'today', pageId: 'today', hash: 'h-today-1', typesKey: 'carried' },
+      { path: 'jobs', pageId: 'jobs', hash: 'h-jobs-1', typesKey: 'carried' },
+      { path: 'jobs/{job_id}', pageId: 'job', hash: 'h-job-1', typesKey: 'carried' },
+    ],
+    typeSets,
+    theme: { light: {}, dark: {} },
+    ...rest,
+  };
+}
+
+function createPages(paths) {
+  return Object.fromEntries(
+    paths.map(([path, pageId, etag]) => [path, { pageConfig: createPage(pageId), etag }])
+  );
+}
+
+export { createPage, createPages, createRoot, shell, typeManifest, typeSets };

package/src/test/renderPageScreen.js

@@ -0,0 +1,109 @@
+/*
+  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';
+import { jest } from '@jest/globals';
+import { render } from '@testing-library/react-native';
+
+import createAppSession from '../session/createAppSession.js';
+import createCoreAuth from '../auth/createCoreAuth.js';
+import createFakeServer from './createFakeServer.js';
+import createMemoryCacheStore from './createMemoryCacheStore.js';
+import createMemoryStore from '../host/createMemoryStore.js';
+import createShellGlobals from '../host/createShellGlobals.js';
+import createShellLocale from '../locale/createShellLocale.js';
+import PageScreen from '../components/PageScreen.js';
+import ShellContext from '../ShellContext.js';
+import ShellThemeProvider from '../components/ShellThemeProvider.js';
+import { shell } from './fixtures.js';
+
+const apiBase = 'https://field.example.com';
+
+/**
+ * Renders a PageScreen at `path` as the shell does: one app's session synced with a fake server
+ * holding `root` and `pages` ({ [path]: { pageConfig, etag } }), its host with the shell's
+ * globals over in-memory stores, its locale, and the shell's theme provider. The test file mocks
+ * expo-router.
+ */
+async function renderPageScreen({
+  beforeRender = () => undefined,
+  deviceLocales = ['en-US'],
+  pages,
+  path,
+  query,
+  root,
+}) {
+  const server = createFakeServer({ root, rootEtag: '"r1"', pages });
+  const session = createAppSession({
+    apiBase,
+    app: { id: 'field' },
+    cacheStore: createMemoryCacheStore(),
+    fetch: server.fetch,
+    kv: createMemoryStore(),
+    tokenStore: { get: () => null },
+  });
+  await session.start();
+  const storage = createMemoryStore();
+  const clipboard = { setString: jest.fn(async () => undefined) };
+  const globals = createShellGlobals({
+    assign: jest.fn(),
+    clipboard,
+    fetch: server.fetch,
+    getInstanceId: session.getCurrentInstanceId,
+    getPath: session.getCurrentPath,
+    origin: apiBase,
+    storage,
+  });
+  const host = {
+    authTransport: 'bearer',
+    fetch: server.fetch,
+    globals,
+    onBuildChanged: jest.fn(),
+    onCallerChanged: jest.fn(),
+    router: { back: jest.fn(), push: jest.fn(), replace: jest.fn() },
+    sessionStorage: createMemoryStore(),
+    storage,
+    streamFetch: server.fetch,
+    tokenStore: { get: () => null, set: jest.fn(), clear: jest.fn() },
+    WebSocket: jest.fn(),
+    websocketUrl: (apiPath) => apiPath.replace(/^http/, 'ws'),
+  };
+  const locale = createShellLocale({
+    getDeviceLocales: () => deviceLocales,
+    globals,
+    session,
+    storage,
+  });
+  const auth = {
+    coreAuth: createCoreAuth({
+      apiBase,
+      fetch: server.fetch,
+      getSession: () => session,
+      tokenStore: host.tokenStore,
+    }),
+  };
+  beforeRender({ session });
+  await render(
+    <ShellContext.Provider value={{ auth, host, locale, session, shell }}>
+      <ShellThemeProvider>
+        <PageScreen path={path} query={query} />
+      </ShellThemeProvider>
+    </ShellContext.Provider>
+  );
+  return { clipboard, host, locale, server, session, storage };
+}
+
+export default renderPageScreen;

package/src/types/checkTypeSet.js

@@ -0,0 +1,39 @@
+/*
+  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.
+*/
+
+const CATEGORIES = ['actions', 'blocks', 'operators'];
+
+// The types of a page's type set (from the mobile root) this shell cannot render: each one the
+// manifest lacks, or carries from another package or another major version of it. A page renders
+// only when this is empty.
+function checkTypeSet({ manifest, typeSet }) {
+  const missing = [];
+  CATEGORIES.forEach((category) => {
+    (typeSet[category] ?? []).forEach((needed) => {
+      const carried = manifest[category]?.[needed.type];
+      if (
+        carried === undefined ||
+        carried.package !== needed.package ||
+        carried.version !== needed.version
+      ) {
+        missing.push({ category, ...needed });
+      }
+    });
+  });
+  return missing;
+}
+
+export default checkTypeSet;

package/src/types/collectPageTypes.js

@@ -0,0 +1,49 @@
+/*
+  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 { serializer, type } from '@lowdefy/helpers';
+
+function collectEventActions({ events, actions }) {
+  Object.values(events ?? {}).forEach((event) => {
+    [...(event?.try ?? []), ...(event?.catch ?? [])].forEach((action) => {
+      if (type.isString(action?.type)) actions.add(action.type);
+    });
+  });
+}
+
+function collectBlock({ block, blocks, actions }) {
+  if (type.isString(block.type)) blocks.add(block.type);
+  collectEventActions({ events: block.events, actions });
+  Object.values(block.slots ?? {}).forEach((slot) => {
+    (slot.blocks ?? []).forEach((child) => collectBlock({ block: child, blocks, actions }));
+  });
+}
+
+// The block and action types a page uses, read from its config. The dev server builds pages on
+// demand and sends no type set, so a dev shell checks a page's types when the page arrives, by
+// name only: a dev shell runs the same Lowdefy version as the dev server. Page config arrives
+// serialized (arrays as `{ '~arr': [...] }`), so it is deserialized before it is walked.
+function collectPageTypes(pageConfig) {
+  const blocks = new Set();
+  const actions = new Set();
+  collectBlock({ block: serializer.deserialize(pageConfig), blocks, actions });
+  return {
+    blocks: [...blocks].sort(),
+    actions: [...actions].sort(),
+  };
+}
+
+export default collectPageTypes;

package/src/types/collectPageTypes.test.js

@@ -0,0 +1,90 @@
+/*
+  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 collectPageTypes from './collectPageTypes.js';
+
+const page = {
+  id: 'page:today',
+  type: 'Screen',
+  slots: {
+    content: {
+      blocks: [
+        {
+          id: 'block:today:tap:0',
+          type: 'Button',
+          events: {
+            onClick: {
+              try: [{ id: 'go', type: 'Link', params: 'detail' }],
+              catch: [{ id: 'failed', type: 'SetState', params: {} }],
+            },
+          },
+        },
+        {
+          id: 'block:today:box:0',
+          type: 'Box',
+          slots: { content: { blocks: [{ id: 'block:today:text:0', type: 'Paragraph' }] } },
+        },
+      ],
+    },
+  },
+};
+
+const expected = {
+  blocks: ['Box', 'Button', 'Paragraph', 'Screen'],
+  actions: ['Link', 'SetState'],
+};
+
+test('collectPageTypes reads the block and action types of a page', () => {
+  expect(collectPageTypes(page)).toEqual(expected);
+});
+
+// The dev server sends page config serialized: an array that carries a config key comes as
+// { '~arr': [...], '~k': key }.
+test('collectPageTypes reads a serialized page as the dev server sends it', () => {
+  const serialized = {
+    id: 'page:today',
+    type: 'Screen',
+    slots: {
+      content: {
+        blocks: {
+          '~arr': [
+            {
+              id: 'block:today:tap:0',
+              type: 'Button',
+              events: {
+                onClick: {
+                  try: { '~arr': [{ id: 'go', type: 'Link', params: 'detail' }], '~k': 'k2' },
+                  catch: { '~arr': [{ id: 'failed', type: 'SetState', params: {} }], '~k': 'k3' },
+                },
+              },
+            },
+            {
+              id: 'block:today:box:0',
+              type: 'Box',
+              slots: {
+                content: {
+                  blocks: { '~arr': [{ id: 'block:today:text:0', type: 'Paragraph' }], '~k': 'k4' },
+                },
+              },
+            },
+          ],
+          '~k': 'k1',
+        },
+      },
+    },
+  };
+  expect(collectPageTypes(serialized)).toEqual(expected);
+});

package/src/types/findMissingPageTypes.js

@@ -0,0 +1,40 @@
+/*
+  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 checkTypeSet from './checkTypeSet.js';
+import collectPageTypes from './collectPageTypes.js';
+
+// The types a page needs that this shell lacks. A production root lists the page's type set under
+// its typesKey; a dev root lists none, so the page's own config is read when it has arrived.
+function findMissingPageTypes({ entry, manifest, page, root }) {
+  if (entry.typesKey !== undefined) {
+    return checkTypeSet({ manifest, typeSet: root.typeSets[entry.typesKey] ?? {} });
+  }
+  if (page === undefined) {
+    return [];
+  }
+  const used = collectPageTypes(page.pageConfig);
+  return [
+    ...used.blocks
+      .filter((name) => manifest.blocks[name] === undefined)
+      .map((name) => ({ category: 'blocks', type: name })),
+    ...used.actions
+      .filter((name) => manifest.actions[name] === undefined)
+      .map((name) => ({ category: 'actions', type: name })),
+  ];
+}
+
+export default findMissingPageTypes;

package/src/version/compareVersions.js

@@ -0,0 +1,38 @@
+/*
+  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 parseVersion(version) {
+  const [major = 0, minor = 0, patch = 0] = String(version)
+    .split('-')[0]
+    .split('.')
+    .map((part) => Number.parseInt(part, 10) || 0);
+  return [major, minor, patch];
+}
+
+// Compares two release versions ("7.4.0") by major, minor and patch: below 0 when a is older than
+// b, 0 when they match, above 0 when a is newer. A prerelease suffix is ignored.
+function compareVersions(a, b) {
+  const partsA = parseVersion(a);
+  const partsB = parseVersion(b);
+  for (let i = 0; i < 3; i += 1) {
+    if (partsA[i] !== partsB[i]) {
+      return partsA[i] - partsB[i];
+    }
+  }
+  return 0;
+}
+
+export default compareVersions;

package/src/version/isShellTooOld.js

@@ -0,0 +1,30 @@
+/*
+  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 compareVersions from './compareVersions.js';
+
+// mobile.minShellVersion blocks every page of an app on a shell older than it: it is for security
+// fixes a server cannot work around.
+function isShellTooOld({ minShellVersion, shellVersion }) {
+  if (type.isNone(minShellVersion)) {
+    return false;
+  }
+  return compareVersions(shellVersion, minShellVersion) < 0;
+}
+
+export default isShellTooOld;

package/src/version/shellVersion.js

@@ -0,0 +1,21 @@
+/*
+  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.
+*/
+
+// Generated by scripts/createShellVersion.mjs from package.json. Do not edit.
+
+const shellVersion = '0.0.0-experimental-20261019052246';
+
+export default shellVersion;

package/src/version/shellVersion.test.js

@@ -0,0 +1,32 @@
+/*
+  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 { execFileSync } from 'child_process';
+import path from 'path';
+
+import shellPackage from '../../package.json';
+import shellVersion from './shellVersion.js';
+
+// The committed version the bundle carries must be the package's: run
+// `pnpm --filter=@lowdefy/shell shell-version` after changing it. `pnpm release:version` does.
+test('src/version/shellVersion.js matches the @lowdefy/shell package version', () => {
+  expect(shellVersion).toBe(shellPackage.version);
+  expect(
+    execFileSync(process.execPath, [path.join(__dirname, '../../scripts/createShellVersion.mjs')], {
+      encoding: 'utf8',
+    })
+  ).toBe(shellVersion);
+});