@lowdefy/shell 3.23.3 → 7.2.0

package/src/dev/connection/parseServerInput.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 parseDevLink from './parseDevLink.js';
+import parseServerUrl from './parseServerUrl.js';
+
+/**
+ * What a developer typed or pasted on the connect screen: a server URL (`192.168.1.20:3000`,
+ * `http://...`) or the whole link `lowdefy dev --lan` prints. Returns `{ url, host, pair }`, or
+ * `{ error }`.
+ */
+function parseServerInput({ input, scheme }) {
+  const link = parseDevLink({ link: input?.trim(), scheme });
+  if (link?.kind === 'connect') {
+    return { url: link.url, host: link.host, pair: link.pair };
+  }
+  if (link?.kind === 'invalid') {
+    return { error: link.reason };
+  }
+  const server = parseServerUrl(input);
+  if (server === null) {
+    return { error: 'Enter the address lowdefy dev prints, like http://192.168.1.20:3000.' };
+  }
+  return { url: server.url, host: server.host, pair: null };
+}
+
+export default parseServerInput;

package/src/dev/connection/parseServerUrl.js

@@ -0,0 +1,45 @@
+/*
+  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';
+
+// The host excludes "@" and a backslash: a URL with userinfo (http://localhost@evil.example)
+// names a different host than its text starts with, and would pass for a loopback server.
+const SERVER_URL = /^(https?):\/\/([^/\\?#\s@]+)(\/[^?#\s]*)?$/i;
+
+/**
+ * A dev server's URL as Lowdefy Dev keeps it: `{ url, host }`, the url without a trailing slash,
+ * or null when it is not an http(s) URL. A bare `host:port` is read as http, the way lowdefy dev
+ * serves.
+ */
+function parseServerUrl(input) {
+  if (!type.isString(input)) {
+    return null;
+  }
+  const trimmed = input.trim();
+  const withScheme = /^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed) ? trimmed : `http://${trimmed}`;
+  const match = SERVER_URL.exec(withScheme);
+  if (match === null) {
+    return null;
+  }
+  const [, scheme, host, pathname = ''] = match;
+  return {
+    url: `${scheme.toLowerCase()}://${host}${pathname.replace(/\/+$/, '')}`,
+    host,
+  };
+}
+
+export default parseServerUrl;

package/src/dev/devStyles.js

@@ -0,0 +1,97 @@
+/*
+  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 { StyleSheet } from 'react-native';
+
+const devStyles = StyleSheet.create({
+  screen: {
+    flexGrow: 1,
+    padding: 24,
+    gap: 12,
+  },
+  heading: {
+    fontSize: 24,
+    fontWeight: '600',
+  },
+  hint: {
+    fontSize: 14,
+    color: '#8c8c8c',
+  },
+  error: {
+    fontSize: 14,
+    color: '#cf1322',
+  },
+  input: {
+    borderWidth: 1,
+    borderColor: '#d9d9d9',
+    borderRadius: 8,
+    paddingHorizontal: 12,
+    paddingVertical: 10,
+    fontSize: 16,
+  },
+  button: {
+    alignItems: 'center',
+    paddingHorizontal: 20,
+    paddingVertical: 12,
+    borderRadius: 8,
+    backgroundColor: '#1677ff',
+  },
+  buttonText: {
+    color: '#ffffff',
+    fontSize: 16,
+    fontWeight: '600',
+  },
+  secondaryButton: {
+    alignItems: 'center',
+    paddingHorizontal: 20,
+    paddingVertical: 12,
+    borderRadius: 8,
+    backgroundColor: '#f0f0f0',
+  },
+  secondaryButtonText: {
+    fontSize: 16,
+  },
+  row: {
+    padding: 16,
+    borderRadius: 12,
+    backgroundColor: '#f0f0f0',
+  },
+  rowText: {
+    fontSize: 17,
+  },
+  backdrop: {
+    flex: 1,
+    justifyContent: 'flex-end',
+    backgroundColor: 'rgba(0,0,0,0.3)',
+  },
+  sheet: {
+    padding: 24,
+    gap: 12,
+    borderTopLeftRadius: 16,
+    borderTopRightRadius: 16,
+    backgroundColor: '#ffffff',
+  },
+  sheetTitle: {
+    fontSize: 20,
+    fontWeight: '600',
+  },
+  mono: {
+    fontFamily: 'Menlo',
+    fontSize: 12,
+  },
+});
+
+export default devStyles;

package/src/dev/index.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.
+*/
+
+// Lowdefy Dev's developer features: connecting to a dev server, the shake menu and the dev-tab
+// client. A release shell's bundle resolves this module to an empty one (metro.config.js), so
+// every export here is undefined there and the boot files fall back to the plain shell.
+export { default as DevShell } from './DevShell.js';
+export { default as redirectDevLink } from './redirectDevLink.js';

package/src/dev/inject/createDeviceInjections.js

@@ -0,0 +1,188 @@
+/*
+  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 injectPush from './injectPush.js';
+import injectShare from './injectShare.js';
+
+const NEXT_READ_KINDS = ['scan', 'photo', 'nfc', 'transcript'];
+const PERMISSION_ANSWERS = ['granted', 'denied'];
+const NETWORK_STATES = ['online', 'offline'];
+const KINDS = [...NEXT_READ_KINDS, 'location', 'permission', 'network', 'push', 'share', 'clear'];
+
+function describe(value) {
+  return JSON.stringify(value);
+}
+
+function isTranscript(value) {
+  if (!type.isObject(value)) {
+    return false;
+  }
+  if (!type.isUndefined(value.error)) {
+    return type.isString(value.error) && value.error !== '';
+  }
+  return (
+    type.isString(value.final) &&
+    (type.isUndefined(value.partials) ||
+      (type.isArray(value.partials) && value.partials.every(type.isString)))
+  );
+}
+
+function isLocation(value) {
+  return type.isObject(value) && type.isNumber(value.latitude) && type.isNumber(value.longitude);
+}
+
+// Checks one injection's value, throwing the message the agent gets back.
+function validateInjection({ kind, name, value }) {
+  if (!KINDS.includes(kind)) {
+    throw new Error(`An injection kind is one of ${KINDS.join(', ')}. Received ${describe(kind)}.`);
+  }
+  if (kind === 'scan' && !(type.isObject(value) && type.isString(value.data))) {
+    throw new Error(`A scan injection needs { data }. Received ${describe(value)}.`);
+  }
+  if (kind === 'photo' && !(type.isObject(value) && type.isString(value.base64))) {
+    throw new Error(`A photo injection needs { base64 }. Received ${describe(value)}.`);
+  }
+  if (kind === 'nfc' && !type.isObject(value)) {
+    throw new Error(
+      `An nfc injection needs the tag read as an object. Received ${describe(value)}.`
+    );
+  }
+  if (kind === 'transcript' && !isTranscript(value)) {
+    throw new Error(
+      `A transcript injection needs { final } with optional { partials } (a list of strings), or { error }. Received ${describe(
+        value
+      )}.`
+    );
+  }
+  if (kind === 'location') {
+    const route = type.isArray(value) ? value : [value];
+    if (route.length === 0 || !route.every(isLocation)) {
+      throw new Error(
+        `A location injection needs { latitude, longitude }, or a route as a list of them. Received ${describe(
+          value
+        )}.`
+      );
+    }
+  }
+  if (kind === 'permission') {
+    if (!type.isString(name) || name === '') {
+      throw new Error(
+        `A permission injection needs the permission's name. Received ${describe(name)}.`
+      );
+    }
+    if (!PERMISSION_ANSWERS.includes(value)) {
+      throw new Error(`A permission answer is "granted" or "denied". Received ${describe(value)}.`);
+    }
+  }
+  if (kind === 'network' && !NETWORK_STATES.includes(value)) {
+    throw new Error(`A network injection is "online" or "offline". Received ${describe(value)}.`);
+  }
+}
+
+/**
+ * The device results an agent or journey told Lowdefy Dev to fake, through the dev-tab client's
+ * `inject` requests. Device actions read them with `injected(name)` (src/device/injected.js), which
+ * calls take.
+ *
+ * - `scan`, `photo` and `nfc` queue: each read takes the next one, and none is left once taken.
+ * - `transcript` queues the same way: each dictation session takes the next one and "hears" its
+ *   `partials`, then its `final`, or ends with its `error` (blocks-native's
+ *   installDictationSource plays it).
+ * - `location` queues too, so a list of locations plays a route one read at a time, but the last
+ *   one taken stays: the phone is still there for the next read and for geofences.
+ * - `permission` sets the standing answer for one permission, as the phone remembers a choice.
+ * - `network: 'offline'` makes the app's every fetch fail as offline (createOfflineFetch) and
+ *   takes the shell offline (networkStatus), which shows the NoConnection banner and fires the
+ *   app's `offline` events, until `network: 'online'`.
+ * - `clear` drops every injection and goes back online.
+ * - `push` shows a notification now, and can tap it or press a button (injectPush).
+ * - `share` shares text, a link or files into the app (injectShare).
+ *
+ * @param {Object} params
+ * @param {{ setInjectedOffline: (offline: boolean) => void }} params.networkStatus The shell's
+ *   online state (host/networkStatus.js).
+ */
+function createDeviceInjections({ networkStatus }) {
+  let queues = new Map();
+  let standing = new Map();
+  let offline = false;
+
+  function setOffline(next) {
+    offline = next;
+    networkStatus.setInjectedOffline(next);
+  }
+
+  function queue(kind) {
+    if (!queues.has(kind)) {
+      queues.set(kind, []);
+    }
+    return queues.get(kind);
+  }
+
+  function inject({ kind, name, value }) {
+    validateInjection({ kind, name, value });
+    switch (kind) {
+      case 'clear':
+        queues = new Map();
+        standing = new Map();
+        setOffline(false);
+        return { ok: true, kind };
+      case 'network':
+        setOffline(value === 'offline');
+        return { ok: true, kind, network: value };
+      case 'permission':
+        standing.set(`permission:${name}`, value);
+        return { ok: true, kind, name, answer: value };
+      case 'location':
+        queue(kind).push(...(type.isArray(value) ? value : [value]));
+        return { ok: true, kind, pending: queue(kind).length };
+      case 'push':
+        return injectPush(value);
+      case 'share':
+        return injectShare(value);
+      default:
+        queue(kind).push(value);
+        return { ok: true, kind, pending: queue(kind).length };
+    }
+  }
+
+  function take(name) {
+    if (name.startsWith('permission:')) {
+      return standing.get(name);
+    }
+    if (name === 'location') {
+      const next = queue(name).shift();
+      if (next !== undefined) {
+        standing.set(name, next);
+      }
+      return standing.get(name);
+    }
+    if (!NEXT_READ_KINDS.includes(name)) {
+      throw new Error(
+        `injected() reads ${[...NEXT_READ_KINDS, 'location', 'permission:<name>'].join(
+          ', '
+        )}. Received ${describe(name)}.`
+      );
+    }
+    return queue(name).shift();
+  }
+
+  return { inject, isOffline: () => offline, take };
+}
+
+export default createDeviceInjections;

package/src/dev/inject/createDeviceInjections.test.js

@@ -0,0 +1,224 @@
+/*
+  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 createDeviceInjections from './createDeviceInjections.js';
+import createFakeNetwork from '../../test/createFakeNetwork.js';
+import createNetworkStatus from '../../host/createNetworkStatus.js';
+
+function createInjections() {
+  const networkStatus = createNetworkStatus({ network: createFakeNetwork() });
+  return createDeviceInjections({ networkStatus });
+}
+
+const fixtureImage = { base64: 'iVBORw0KGgo=', mimeType: 'image/png', width: 1, height: 1 };
+
+test('scan, photo and nfc results are each taken once, in the order they were injected', () => {
+  const injections = createInjections();
+  expect(injections.inject({ kind: 'scan', value: { data: 'JOB-1', type: 'qr' } })).toEqual({
+    ok: true,
+    kind: 'scan',
+    pending: 1,
+  });
+  injections.inject({ kind: 'scan', value: { data: 'JOB-2', type: 'code128' } });
+  injections.inject({ kind: 'photo', value: fixtureImage });
+  injections.inject({ kind: 'nfc', value: { id: '04:A2:19', records: [] } });
+  expect(injections.take('scan')).toEqual({ data: 'JOB-1', type: 'qr' });
+  expect(injections.take('photo')).toEqual(fixtureImage);
+  expect(injections.take('scan')).toEqual({ data: 'JOB-2', type: 'code128' });
+  expect(injections.take('scan')).toBeUndefined();
+  expect(injections.take('photo')).toBeUndefined();
+  expect(injections.take('nfc')).toEqual({ id: '04:A2:19', records: [] });
+  expect(injections.take('nfc')).toBeUndefined();
+});
+
+test('transcripts queue, each dictation session taking the next one, and clear drops them', () => {
+  const injections = createInjections();
+  expect(
+    injections.inject({
+      kind: 'transcript',
+      value: { partials: ['for', 'for Sam'], final: 'for Sam, can you look' },
+    })
+  ).toEqual({ ok: true, kind: 'transcript', pending: 1 });
+  expect(injections.inject({ kind: 'transcript', value: { error: 'not-allowed' } })).toEqual({
+    ok: true,
+    kind: 'transcript',
+    pending: 2,
+  });
+  injections.inject({ kind: 'permission', name: 'microphone', value: 'denied' });
+  expect(injections.take('transcript')).toEqual({
+    partials: ['for', 'for Sam'],
+    final: 'for Sam, can you look',
+  });
+  expect(injections.take('permission:microphone')).toBe('denied');
+  expect(injections.take('transcript')).toEqual({ error: 'not-allowed' });
+  expect(injections.take('transcript')).toBeUndefined();
+  injections.inject({ kind: 'transcript', value: { final: 'ship it' } });
+  injections.inject({ kind: 'clear' });
+  expect(injections.take('transcript')).toBeUndefined();
+});
+
+test('a location stays after it is read, and a route plays one location per read', () => {
+  const injections = createInjections();
+  expect(injections.take('location')).toBeUndefined();
+  injections.inject({ kind: 'location', value: { latitude: -33.92, longitude: 18.42 } });
+  expect(injections.take('location')).toEqual({ latitude: -33.92, longitude: 18.42 });
+  expect(injections.take('location')).toEqual({ latitude: -33.92, longitude: 18.42 });
+  expect(
+    injections.inject({
+      kind: 'location',
+      value: [
+        { latitude: -33.9, longitude: 18.4 },
+        { latitude: -33.8, longitude: 18.5, accuracy: 5 },
+      ],
+    })
+  ).toEqual({ ok: true, kind: 'location', pending: 2 });
+  expect(injections.take('location')).toEqual({ latitude: -33.9, longitude: 18.4 });
+  expect(injections.take('location')).toEqual({ latitude: -33.8, longitude: 18.5, accuracy: 5 });
+  expect(injections.take('location')).toEqual({ latitude: -33.8, longitude: 18.5, accuracy: 5 });
+});
+
+test('a permission answer stands for that permission until it changes', () => {
+  const injections = createInjections();
+  expect(injections.take('permission:camera')).toBeUndefined();
+  injections.inject({ kind: 'permission', name: 'camera', value: 'denied' });
+  expect(injections.take('permission:camera')).toBe('denied');
+  expect(injections.take('permission:camera')).toBe('denied');
+  expect(injections.take('permission:location')).toBeUndefined();
+  injections.inject({ kind: 'permission', name: 'camera', value: 'granted' });
+  expect(injections.take('permission:camera')).toBe('granted');
+});
+
+test('network offline holds until the network is turned back on', () => {
+  const injections = createInjections();
+  expect(injections.isOffline()).toBe(false);
+  expect(injections.inject({ kind: 'network', value: 'offline' })).toEqual({
+    ok: true,
+    kind: 'network',
+    network: 'offline',
+  });
+  expect(injections.isOffline()).toBe(true);
+  injections.inject({ kind: 'network', value: 'online' });
+  expect(injections.isOffline()).toBe(false);
+});
+
+// The NoConnection banner and the app's online and offline events read the shell's online state.
+test('network offline takes the shell offline, and online or clear brings it back', () => {
+  const networkStatus = createNetworkStatus({ network: createFakeNetwork() });
+  const injections = createDeviceInjections({ networkStatus });
+  injections.inject({ kind: 'network', value: 'offline' });
+  expect(networkStatus.isOnline()).toBe(false);
+  injections.inject({ kind: 'network', value: 'online' });
+  expect(networkStatus.isOnline()).toBe(true);
+  injections.inject({ kind: 'network', value: 'offline' });
+  injections.inject({ kind: 'clear' });
+  expect(networkStatus.isOnline()).toBe(true);
+});
+
+test('clear drops every injection and goes back online', () => {
+  const injections = createInjections();
+  injections.inject({ kind: 'scan', value: { data: 'JOB-1' } });
+  injections.inject({ kind: 'location', value: { latitude: 1, longitude: 2 } });
+  injections.take('location');
+  injections.inject({ kind: 'permission', name: 'location', value: 'denied' });
+  injections.inject({ kind: 'network', value: 'offline' });
+  expect(injections.inject({ kind: 'clear' })).toEqual({ ok: true, kind: 'clear' });
+  expect(injections.take('scan')).toBeUndefined();
+  expect(injections.take('location')).toBeUndefined();
+  expect(injections.take('permission:location')).toBeUndefined();
+  expect(injections.isOffline()).toBe(false);
+});
+
+test('a push injection without a title or body is refused with its shape', async () => {
+  const injections = createInjections();
+  await expect(injections.inject({ kind: 'push', value: { data: {} } })).rejects.toThrow(
+    'A push injection needs { title, body, data?, categoryId?, open?, actionId?, text? }.'
+  );
+});
+
+test('a push injection shows the notification now', async () => {
+  const injections = createInjections();
+  await expect(injections.inject({ kind: 'push', value: { title: 'New job' } })).resolves.toEqual({
+    ok: true,
+    kind: 'push',
+    id: 'notification-id',
+  });
+});
+
+test('a share injection without text, a url or files is refused', async () => {
+  const injections = createInjections();
+  await expect(injections.inject({ kind: 'share', value: {} })).rejects.toThrow(
+    'A share injection needs { text?, url?, files? }.'
+  );
+});
+
+test.each([
+  [
+    { kind: 'beep' },
+    'An injection kind is one of scan, photo, nfc, transcript, location, permission, network, push, share, clear. Received "beep".',
+  ],
+  [{ kind: 'scan', value: 'JOB-1' }, 'A scan injection needs { data }. Received "JOB-1".'],
+  [{ kind: 'photo', value: {} }, 'A photo injection needs { base64 }. Received {}.'],
+  [
+    { kind: 'nfc', value: 'tag' },
+    'An nfc injection needs the tag read as an object. Received "tag".',
+  ],
+  [
+    { kind: 'transcript', value: 'for Sam' },
+    'A transcript injection needs { final } with optional { partials } (a list of strings), or { error }. Received "for Sam".',
+  ],
+  [
+    { kind: 'transcript', value: { partials: ['for'] } },
+    'A transcript injection needs { final } with optional { partials } (a list of strings), or { error }. Received {"partials":["for"]}.',
+  ],
+  [
+    { kind: 'transcript', value: { partials: 'for', final: 'for Sam' } },
+    'A transcript injection needs { final } with optional { partials } (a list of strings), or { error }. Received {"partials":"for","final":"for Sam"}.',
+  ],
+  [
+    { kind: 'transcript', value: { error: '' } },
+    'A transcript injection needs { final } with optional { partials } (a list of strings), or { error }. Received {"error":""}.',
+  ],
+  [
+    { kind: 'location', value: { latitude: '1', longitude: 2 } },
+    'A location injection needs { latitude, longitude }, or a route as a list of them. Received {"latitude":"1","longitude":2}.',
+  ],
+  [
+    { kind: 'location', value: [] },
+    'A location injection needs { latitude, longitude }, or a route as a list of them. Received [].',
+  ],
+  [
+    { kind: 'permission', value: 'granted' },
+    "A permission injection needs the permission's name. Received undefined.",
+  ],
+  [
+    { kind: 'permission', name: 'camera', value: 'yes' },
+    'A permission answer is "granted" or "denied". Received "yes".',
+  ],
+  [
+    { kind: 'network', value: false },
+    'A network injection is "online" or "offline". Received false.',
+  ],
+])('an invalid injection is refused with what was wrong: %j', (injection, message) => {
+  const injections = createInjections();
+  expect(() => injections.inject(injection)).toThrow(message);
+});
+
+test('reading an injection by a name no device action uses throws', () => {
+  const injections = createInjections();
+  expect(() => injections.take('barcode')).toThrow(
+    'injected() reads scan, photo, nfc, transcript, location, permission:<name>. Received "barcode".'
+  );
+});

package/src/dev/inject/createOfflineFetch.js

@@ -0,0 +1,35 @@
+/*
+  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.
+*/
+
+/**
+ * The app's fetch while Lowdefy Dev pretends to be offline (createDeviceInjections): every call
+ * fails as React Native's fetch fails with no network. The dev-tab client keeps its own fetch, so
+ * an agent can still turn the network back on.
+ *
+ * @param {Object} params
+ * @param {Function} params.fetch The Fetch API.
+ * @param {() => boolean} params.isOffline
+ */
+function createOfflineFetch({ fetch, isOffline }) {
+  return function offlineFetch(url, init) {
+    if (isOffline()) {
+      return Promise.reject(new TypeError('Network request failed'));
+    }
+    return fetch(url, init);
+  };
+}
+
+export default createOfflineFetch;