@symbiote-native/network 0.0.1 → 0.1.0

package/README.md

@@ -40,8 +40,8 @@ with zero further changes:
 
 Full mechanics — the Podfile pieces that normally ship inside the `expo` package, the `expo`
 peer-dependency exclusion list — live in the `symbiote-expo-native-module` skill. Reference
-implementation: `.examples/expo-react/ios/Podfile` and
-`.examples/expo-react/android/app/src/main/java/com/canary/MainApplication.kt`.
+implementation: `examples/expo-react/ios/Podfile` and
+`examples/expo-react/android/app/src/main/java/com/canaryexpo/MainApplication.kt`.
 
 No platform permission string is needed for network's surface — connection state, IP address, and
 airplane-mode detection all read system state with no runtime permission prompt on either

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/network",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "expo-network wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. Network state (type/connected/internet-reachable) with a change listener, device IP address, and airplane-mode detection.",
   "license": "MIT",
   "repository": {
@@ -40,7 +40,10 @@
     "src",
     "build",
     "build-ngc",
-    "native-link.json"
+    "native-link.json",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
   ],
   "publishConfig": {
     "access": "public"
@@ -56,7 +59,7 @@
     "react": ">=19.0.0",
     "react-native": ">=0.86",
     "vue": ">=3.5.0",
-    "@symbiote-native/angular": "0.6.1",
+    "@symbiote-native/angular": "0.6.2",
     "@symbiote-native/react": "0.2.8",
     "@symbiote-native/vue": "0.3.8"
   },
@@ -92,11 +95,11 @@
     "@vue/runtime-core": "^3.5.13",
     "react": "19.2.3",
     "typescript": "~6.0.0",
-    "@symbiote-native/angular": "0.6.1",
-    "@symbiote-native/react": "0.2.8",
+    "@symbiote-native/angular": "0.6.2",
     "@symbiote-native/engine": "0.1.7",
-    "@symbiote-native/vue": "0.3.8",
-    "@symbiote-native/test-utils": "0.1.6"
+    "@symbiote-native/react": "0.2.8",
+    "@symbiote-native/test-utils": "0.1.6",
+    "@symbiote-native/vue": "0.3.8"
   },
   "scripts": {
     "typecheck": "tsc --build",

package/src/angular/services/network-state.service/network-state.service.test.ts

@@ -1,103 +0,0 @@
-// Co-located Angular-driven test (ADR 0025) for NetworkStateService. See battery's
-// battery-state.service.test.ts for the shared rationale.
-
-import '@angular/compiler';
-import { Component, inject, type Signal } from '@angular/core';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { mount, unmount } from '@symbiote-native/angular';
-import { installFabric } from '@symbiote-native/test-utils';
-import { NetworkStateService } from './index';
-
-type INetworkState = { type?: string; isConnected?: boolean; isInternetReachable?: boolean };
-
-const addListenerMock = vi.fn();
-const removeMock = vi.fn();
-const getNetworkStateAsyncMock = vi.fn(async () => ({
-  type: 'WIFI',
-  isConnected: true,
-  isInternetReachable: true,
-}));
-
-vi.mock('../../../core', () => ({
-  addNetworkStateListener: (listener: (event: INetworkState) => void) => addListenerMock(listener),
-  getNetworkStateAsync: () => getNetworkStateAsyncMock(),
-}));
-
-const ROOT_TAG = 973;
-const fabric = installFabric();
-const tick = (): Promise<void> => new Promise(resolve => setTimeout(resolve, 0));
-
-let capturedResult: Signal<INetworkState> | undefined;
-let capturedListener: ((event: INetworkState) => void) | undefined;
-
-@Component({
-  selector: 'symbiote-network-state-host',
-  standalone: true,
-  template: '',
-})
-class NetworkStateHost {
-  readonly networkState = inject(NetworkStateService).connect();
-
-  constructor() {
-    capturedResult = this.networkState;
-  }
-}
-
-beforeEach(() => {
-  capturedResult = undefined;
-  capturedListener = undefined;
-  getNetworkStateAsyncMock.mockResolvedValue({
-    type: 'WIFI',
-    isConnected: true,
-    isInternetReachable: true,
-  });
-  addListenerMock.mockImplementation(listener => {
-    capturedListener = listener;
-    return { remove: removeMock };
-  });
-});
-
-afterEach(() => {
-  unmount(ROOT_TAG);
-  fabric.reset();
-  vi.clearAllMocks();
-});
-
-describe('NetworkStateService.connect', () => {
-  it('reports an empty object before the initial fetch resolves', async () => {
-    mount(ROOT_TAG, NetworkStateHost);
-
-    expect(capturedResult?.()).toEqual({});
-  });
-
-  it('reports the fetched state once getNetworkStateAsync() resolves', async () => {
-    mount(ROOT_TAG, NetworkStateHost);
-    await tick();
-
-    expect(capturedResult?.()).toEqual({
-      type: 'WIFI',
-      isConnected: true,
-      isInternetReachable: true,
-    });
-  });
-
-  it('updates the signal when the registered listener fires', async () => {
-    mount(ROOT_TAG, NetworkStateHost);
-    await tick();
-
-    if (capturedListener === undefined) throw new Error('addListener callback was not captured');
-    capturedListener({ type: 'CELLULAR', isConnected: true, isInternetReachable: false });
-
-    expect(capturedResult?.()?.type).toBe('CELLULAR');
-  });
-
-  it('removes the subscription when the host component is unmounted', async () => {
-    mount(ROOT_TAG, NetworkStateHost);
-    await tick();
-
-    unmount(ROOT_TAG);
-    await tick();
-
-    expect(removeMock).toHaveBeenCalledOnce();
-  });
-});

package/src/core/network.test.ts

@@ -1,103 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-
-const FAKE_NATIVE_NETWORK = {
-  getNetworkStateAsync: vi.fn(async () => ({
-    type: 'WIFI',
-    isConnected: true,
-    isInternetReachable: true,
-  })),
-  getIpAddressAsync: vi.fn(async () => '192.168.1.1'),
-  isAirplaneModeEnabledAsync: vi.fn(async () => false),
-  addListener: vi.fn(() => ({ remove: vi.fn() })),
-};
-
-// The real ExpoNetwork native module only exists on device — resolving it via
-// requireNativeModule() at import time would throw in this headless test run, so the
-// module-lookup file is faked in place of expo-modules-core's runtime resolution, same pattern
-// packages/battery/src/core/battery.test.ts uses for its native-module.
-vi.mock('./native-module', () => ({
-  expoNetwork: FAKE_NATIVE_NETWORK,
-}));
-
-// expo-modules-core's real entry transitively imports 'react-native' for Platform/
-// TurboModuleRegistry, whose Flow-typed source Vitest's Oxc transform can't parse — same fake
-// packages/haptics/src/core/haptics.test.ts uses.
-vi.mock('expo-modules-core', () => ({
-  UnavailabilityError: class UnavailabilityError extends Error {
-    constructor(moduleName: string, propertyName: string) {
-      super(`${propertyName} is not available on ${moduleName}`);
-    }
-  },
-}));
-
-const {
-  getNetworkStateAsync,
-  getIpAddressAsync,
-  isAirplaneModeEnabledAsync,
-  addNetworkStateListener,
-} = await import('./network');
-
-afterEach(() => {
-  vi.clearAllMocks();
-});
-
-describe('getNetworkStateAsync', () => {
-  it('delegates to the native module', async () => {
-    await expect(getNetworkStateAsync()).resolves.toEqual({
-      type: 'WIFI',
-      isConnected: true,
-      isInternetReachable: true,
-    });
-  });
-
-  it('throws UnavailabilityError when the native method is absent', async () => {
-    const { getNetworkStateAsync: native } = FAKE_NATIVE_NETWORK;
-    // @ts-expect-error -- simulating a platform where the native module has no such method
-    FAKE_NATIVE_NETWORK.getNetworkStateAsync = undefined;
-
-    await expect(getNetworkStateAsync()).rejects.toThrow();
-
-    FAKE_NATIVE_NETWORK.getNetworkStateAsync = native;
-  });
-});
-
-describe('getIpAddressAsync', () => {
-  it('delegates to the native module', async () => {
-    await expect(getIpAddressAsync()).resolves.toBe('192.168.1.1');
-  });
-
-  it('throws UnavailabilityError when the native method is absent', async () => {
-    const { getIpAddressAsync: native } = FAKE_NATIVE_NETWORK;
-    // @ts-expect-error -- simulating a platform where the native module has no such method
-    FAKE_NATIVE_NETWORK.getIpAddressAsync = undefined;
-
-    await expect(getIpAddressAsync()).rejects.toThrow();
-
-    FAKE_NATIVE_NETWORK.getIpAddressAsync = native;
-  });
-});
-
-describe('isAirplaneModeEnabledAsync', () => {
-  it('delegates to the native module', async () => {
-    await expect(isAirplaneModeEnabledAsync()).resolves.toBe(false);
-  });
-
-  it('throws UnavailabilityError when the native method is absent', async () => {
-    const { isAirplaneModeEnabledAsync: native } = FAKE_NATIVE_NETWORK;
-    // @ts-expect-error -- simulating a platform where the native module has no such method
-    FAKE_NATIVE_NETWORK.isAirplaneModeEnabledAsync = undefined;
-
-    await expect(isAirplaneModeEnabledAsync()).rejects.toThrow();
-
-    FAKE_NATIVE_NETWORK.isAirplaneModeEnabledAsync = native;
-  });
-});
-
-describe('addNetworkStateListener', () => {
-  it('subscribes through the onNetworkStateChanged event name', () => {
-    const listener = vi.fn();
-    addNetworkStateListener(listener);
-
-    expect(FAKE_NATIVE_NETWORK.addListener).toHaveBeenCalledWith('onNetworkStateChanged', listener);
-  });
-});

package/src/react/hooks/use-network-state/use-network-state.test.tsx

@@ -1,91 +0,0 @@
-// Co-located React-driven test (ADR 0025) for useNetworkState. See battery's
-// use-battery-state.test.tsx for the shared rationale (mocks `core`, not expo-modules-core
-// internals).
-
-import { createElement, type ReactElement } from 'react';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { mount, unmount, View } from '@symbiote-native/react';
-import { installFabric } from '@symbiote-native/test-utils';
-import { useNetworkState } from './index';
-
-type INetworkState = { type?: string; isConnected?: boolean; isInternetReachable?: boolean };
-
-const { addListener, getNetworkStateAsync, remove } = vi.hoisted(() => {
-  const remove = vi.fn();
-  return {
-    addListener: vi.fn((_listener: (event: INetworkState) => void) => ({ remove })),
-    getNetworkStateAsync: vi.fn(async () => ({
-      type: 'WIFI',
-      isConnected: true,
-      isInternetReachable: true,
-    })),
-    remove,
-  };
-});
-
-vi.mock('../../../core', () => ({
-  addNetworkStateListener: addListener,
-  getNetworkStateAsync,
-}));
-
-const ROOT_TAG = 953;
-
-const results: INetworkState[] = [];
-
-function Probe(): ReactElement {
-  results.push(useNetworkState());
-  return createElement(View);
-}
-
-const fabric = installFabric();
-
-beforeEach(() => {
-  fabric.reset();
-  results.length = 0;
-  vi.clearAllMocks();
-  getNetworkStateAsync.mockResolvedValue({
-    type: 'WIFI',
-    isConnected: true,
-    isInternetReachable: true,
-  });
-});
-
-afterEach(() => unmount(ROOT_TAG));
-
-describe('useNetworkState', () => {
-  it('reports an empty object before the initial fetch resolves', () => {
-    mount(ROOT_TAG, createElement(Probe));
-
-    expect(results[results.length - 1]).toEqual({});
-  });
-
-  it('reports the fetched state once the initial getNetworkStateAsync() resolves', async () => {
-    mount(ROOT_TAG, createElement(Probe));
-
-    await vi.waitFor(() =>
-      expect(results[results.length - 1]).toEqual({
-        type: 'WIFI',
-        isConnected: true,
-        isInternetReachable: true,
-      }),
-    );
-  });
-
-  it('updates when the native listener fires', async () => {
-    mount(ROOT_TAG, createElement(Probe));
-    await vi.waitFor(() => expect(results[results.length - 1].type).toBe('WIFI'));
-
-    const listener = addListener.mock.calls[0][0];
-    listener({ type: 'CELLULAR', isConnected: true, isInternetReachable: false });
-
-    await vi.waitFor(() => expect(results[results.length - 1].type).toBe('CELLULAR'));
-  });
-
-  it('unsubscribes from the native listener on unmount', () => {
-    mount(ROOT_TAG, createElement(Probe));
-
-    unmount(ROOT_TAG);
-
-    expect(remove).toHaveBeenCalledTimes(1);
-  });
-});

package/src/vue/composables/use-network-state/use-network-state.test.ts

@@ -1,100 +0,0 @@
-// Co-located Vue-driven test (ADR 0025) for useNetworkState. See battery's
-// use-battery-state.test.ts for the shared rationale.
-
-import { defineComponent, h, type Ref } from '@vue/runtime-core';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { mount, unmount } from '@symbiote-native/vue';
-import { installFabric } from '@symbiote-native/test-utils';
-import { useNetworkState } from './index';
-
-const ROOT_TAG = 9953;
-
-type INetworkState = { type?: string; isConnected?: boolean; isInternetReachable?: boolean };
-type IListener = (event: INetworkState) => void;
-
-let registeredListener: IListener | undefined;
-const removeMock = vi.fn();
-const addListenerMock = vi.fn((listener: IListener) => {
-  registeredListener = listener;
-  return { remove: removeMock };
-});
-const getNetworkStateAsyncMock = vi.fn(async () => ({
-  type: 'WIFI',
-  isConnected: true,
-  isInternetReachable: true,
-}));
-
-vi.mock('../../../core', () => ({
-  addNetworkStateListener: (listener: IListener) => addListenerMock(listener),
-  getNetworkStateAsync: () => getNetworkStateAsyncMock(),
-}));
-
-const fabric = installFabric();
-
-beforeEach(() => {
-  fabric.reset();
-  registeredListener = undefined;
-  addListenerMock.mockClear();
-  removeMock.mockClear();
-  getNetworkStateAsyncMock.mockClear();
-  getNetworkStateAsyncMock.mockResolvedValue({
-    type: 'WIFI',
-    isConnected: true,
-    isInternetReachable: true,
-  });
-});
-
-afterEach(() => unmount(ROOT_TAG));
-
-function mountNetworkState(): Ref<INetworkState> {
-  let networkState: Ref<INetworkState> | undefined;
-  mount(
-    ROOT_TAG,
-    defineComponent({
-      setup: () => {
-        networkState = useNetworkState();
-        return () => h('symbiote-text', {}, 'network');
-      },
-    }),
-  );
-  if (networkState === undefined) {
-    throw new Error('setup() did not run');
-  }
-  return networkState;
-}
-
-describe('useNetworkState (Vue)', () => {
-  it('starts at an empty object before the initial fetch resolves', () => {
-    const networkState = mountNetworkState();
-
-    expect(networkState.value).toEqual({});
-  });
-
-  it('updates to the fetched value once getNetworkStateAsync() resolves', async () => {
-    const networkState = mountNetworkState();
-
-    await vi.waitFor(() =>
-      expect(networkState.value).toEqual({
-        type: 'WIFI',
-        isConnected: true,
-        isInternetReachable: true,
-      }),
-    );
-  });
-
-  it('updates the ref when the native listener fires', async () => {
-    const networkState = mountNetworkState();
-    await vi.waitFor(() => expect(networkState.value.type).toBe('WIFI'));
-
-    registeredListener?.({ type: 'CELLULAR', isConnected: true, isInternetReachable: false });
-
-    expect(networkState.value.type).toBe('CELLULAR');
-  });
-
-  it('removes the subscription on unmount', () => {
-    mountNetworkState();
-    unmount(ROOT_TAG);
-
-    expect(removeMock).toHaveBeenCalledTimes(1);
-  });
-});