@symbiote-native/keep-awake 0.0.1 → 0.1.0

package/build/angular/index.js

@@ -1,4 +1,4 @@
 // KeepAwakeService is the Angular-only lifecycle half; the free functions and event
 // subscription plumbing all live in core, shared with React/Vue.
-export { KeepAwakeService } from './services/keep-awake.service';
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from '../core';
+export { KeepAwakeService } from './services/keep-awake.service/index.js';
+export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from '../core/index.js';

package/build/angular/services/keep-awake.service/index.js

@@ -33,7 +33,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     return useValue ? value : void 0;
 };
 import { effect, inject, Injectable, Injector } from '@angular/core';
-import { activateKeepAwakeAsync, addListener, deactivateKeepAwake, } from '../../../core';
+import { activateKeepAwakeAsync, addListener, deactivateKeepAwake, } from '../../../core/index.js';
 // Angular twin of React's `useKeepAwake` hook and Vue's `useKeepAwake` composable. See
 // LowPowerModeService (packages/battery) for the `connect()`/`effect()` pattern rationale — same
 // wiring, but keep-awake has no value to surface as a Signal since it's a pure side effect for

package/build/core/index.js

@@ -1 +1 @@
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from './keep-awake';
+export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from './keep-awake.js';

package/build/core/keep-awake.js

@@ -4,7 +4,7 @@
 // upstream keep-awake throws from `addListener` when the native module lacks
 // `addListenerForTag`, matching local-auth/haptics's UnavailabilityError convention.
 import { UnavailabilityError } from 'expo-modules-core';
-import { expoKeepAwake } from './native-module';
+import { expoKeepAwake } from './native-module.js';
 export const ExpoKeepAwakeTag = 'ExpoKeepAwakeDefaultTag';
 /** Resolves with whether the keep-awake API is available on this device. */
 export async function isAvailableAsync() {

package/build/react/hooks/use-keep-awake/index.js

@@ -9,7 +9,7 @@
 // UnavailabilityError from `addListener` is swallowed by the trailing `.catch(() => {})` exactly
 // like a rejected `activateKeepAwakeAsync`, same net effect as upstream's own guard.
 import { useEffect, useId } from 'react';
-import { activateKeepAwakeAsync, addListener, deactivateKeepAwake, } from '../../../core';
+import { activateKeepAwakeAsync, addListener, deactivateKeepAwake, } from '../../../core/index.js';
 export function useKeepAwake(tag, options) {
     const defaultTag = useId();
     const tagOrDefault = tag ?? defaultTag;

package/build/react/index.js

@@ -1,5 +1,5 @@
 // @symbiote-native/keep-awake/react: the React entry over the framework-agnostic core. The
 // lifecycle bucket is `hooks/` (never `composables/`, that's Vue's term) — see
 // adapters/react/src/hooks for the same convention.
-export { useKeepAwake } from './hooks/use-keep-awake';
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from '../core';
+export { useKeepAwake } from './hooks/use-keep-awake/index.js';
+export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from '../core/index.js';

package/build/vue/composables/use-keep-awake/index.js

@@ -4,7 +4,7 @@
 // counter instead — simplest robust way to give each composable instance its own tag when the
 // caller doesn't supply one.
 import { onMounted, onUnmounted } from '@vue/runtime-core';
-import { activateKeepAwakeAsync, addListener, deactivateKeepAwake, } from '../../../core';
+import { activateKeepAwakeAsync, addListener, deactivateKeepAwake, } from '../../../core/index.js';
 let tagCounter = 0;
 export function useKeepAwake(tag, options) {
     const tagOrDefault = tag ?? `keep-awake-tag-${++tagCounter}`;

package/build/vue/index.js

@@ -1,5 +1,5 @@
 // @symbiote-native/keep-awake/vue: the Vue entry over the framework-agnostic core. The
 // lifecycle bucket is `composables/` (never `hooks/`, that's React's term) — see
 // adapters/vue/src/composables for the same convention.
-export { useKeepAwake } from './composables/use-keep-awake';
-export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from '../core';
+export { useKeepAwake } from './composables/use-keep-awake/index.js';
+export { ExpoKeepAwakeTag, isAvailableAsync, activateKeepAwakeAsync, deactivateKeepAwake, addListener, } from '../core/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/keep-awake",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "expo-keep-awake wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. Keeps the screen awake for the lifetime of a mounted component/composable/service, with an optional listener for keep-awake state changes.",
   "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,10 +95,10 @@
     "@vue/runtime-core": "^3.5.13",
     "react": "19.2.3",
     "typescript": "~6.0.0",
-    "@symbiote-native/test-utils": "0.1.6",
+    "@symbiote-native/angular": "0.6.2",
     "@symbiote-native/engine": "0.1.7",
     "@symbiote-native/react": "0.2.8",
-    "@symbiote-native/angular": "0.6.1",
+    "@symbiote-native/test-utils": "0.1.6",
     "@symbiote-native/vue": "0.3.8"
   },
   "scripts": {

package/src/angular/services/keep-awake.service/keep-awake.service.test.ts

@@ -1,98 +0,0 @@
-// Co-located Angular-driven test (ADR 0025) for KeepAwakeService. See battery's
-// low-power-mode.service.test.ts for the shared rationale.
-//
-// Two host classes rather than one @Input-driven host: Angular sets @Input-bound properties
-// AFTER construction, so a constructor-time `connect(this.tag)` read off an @Input would always
-// see `undefined` — the same field-initializer/constructor timing every other service host in
-// this repo relies on (see battery's own PermissionsHost/BatteryLevelHost).
-
-import '@angular/compiler';
-import { Component, inject } 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 { KeepAwakeService } from './index';
-
-const activateKeepAwakeAsyncMock = vi.fn(async (_tag: string) => undefined);
-const addListenerMock = vi.fn();
-const deactivateKeepAwakeMock = vi.fn(async (_tag: string) => undefined);
-
-vi.mock('../../../core', () => ({
-  activateKeepAwakeAsync: (tag: string) => activateKeepAwakeAsyncMock(tag),
-  addListener: (...args: unknown[]) => addListenerMock(...args),
-  deactivateKeepAwake: (tag: string) => deactivateKeepAwakeMock(tag),
-}));
-
-const ROOT_TAG = 974;
-const fabric = installFabric();
-const tick = (): Promise<void> => new Promise(resolve => setTimeout(resolve, 0));
-
-@Component({
-  selector: 'symbiote-keep-awake-default-host',
-  standalone: true,
-  template: '',
-})
-class KeepAwakeDefaultHost {
-  constructor() {
-    inject(KeepAwakeService).connect();
-  }
-}
-
-@Component({
-  selector: 'symbiote-keep-awake-custom-host',
-  standalone: true,
-  template: '',
-})
-class KeepAwakeCustomHost {
-  constructor() {
-    inject(KeepAwakeService).connect('custom-tag');
-  }
-}
-
-beforeEach(() => {
-  activateKeepAwakeAsyncMock.mockClear();
-  addListenerMock.mockClear();
-  deactivateKeepAwakeMock.mockClear();
-  activateKeepAwakeAsyncMock.mockResolvedValue(undefined);
-  deactivateKeepAwakeMock.mockResolvedValue(undefined);
-});
-
-afterEach(() => {
-  unmount(ROOT_TAG);
-  fabric.reset();
-  vi.clearAllMocks();
-});
-
-describe('KeepAwakeService.connect', () => {
-  it('activates a default tag on mount', async () => {
-    mount(ROOT_TAG, KeepAwakeDefaultHost);
-    await tick();
-
-    expect(activateKeepAwakeAsyncMock).toHaveBeenCalledTimes(1);
-    expect(typeof activateKeepAwakeAsyncMock.mock.calls[0][0]).toBe('string');
-  });
-
-  it('activates the explicit tag when one is given', async () => {
-    mount(ROOT_TAG, KeepAwakeCustomHost);
-    await tick();
-
-    expect(activateKeepAwakeAsyncMock).toHaveBeenCalledWith('custom-tag');
-  });
-
-  it('deactivates the same tag when the host component is unmounted', async () => {
-    mount(ROOT_TAG, KeepAwakeCustomHost);
-    await tick();
-
-    unmount(ROOT_TAG);
-    await tick();
-
-    expect(deactivateKeepAwakeMock).toHaveBeenCalledWith('custom-tag');
-  });
-
-  it('never touches addListener when no options are given', async () => {
-    mount(ROOT_TAG, KeepAwakeCustomHost);
-    await tick();
-
-    expect(addListenerMock).not.toHaveBeenCalled();
-  });
-});

package/src/core/keep-awake.test.ts

@@ -1,119 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-
-const FAKE_NATIVE_KEEP_AWAKE = {
-  isAvailableAsync: vi.fn(async () => true),
-  activate: vi.fn(async () => undefined),
-  deactivate: vi.fn(async () => undefined),
-  addListenerForTag: vi.fn(() => ({ remove: vi.fn() })),
-};
-
-// The real ExpoKeepAwake 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.
-vi.mock('./native-module', () => ({
-  expoKeepAwake: FAKE_NATIVE_KEEP_AWAKE,
-}));
-
-// 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. keep-awake.ts imports UnavailabilityError as a
-// real value (not just a type), so it needs mocking here too.
-vi.mock('expo-modules-core', () => ({
-  UnavailabilityError: class UnavailabilityError extends Error {
-    constructor(moduleName: string, propertyName: string) {
-      super(`${propertyName} is not available on ${moduleName}`);
-    }
-  },
-}));
-
-const {
-  ExpoKeepAwakeTag,
-  isAvailableAsync,
-  activateKeepAwakeAsync,
-  deactivateKeepAwake,
-  addListener,
-} = await import('./keep-awake');
-
-afterEach(() => {
-  vi.clearAllMocks();
-});
-
-describe('isAvailableAsync', () => {
-  it('delegates to the native module when isAvailableAsync exists', async () => {
-    await expect(isAvailableAsync()).resolves.toBe(true);
-  });
-
-  it('defaults to true when the native method is absent', async () => {
-    const { isAvailableAsync: native } = FAKE_NATIVE_KEEP_AWAKE;
-    // @ts-expect-error -- simulating a platform where the native module has no such method
-    FAKE_NATIVE_KEEP_AWAKE.isAvailableAsync = undefined;
-
-    await expect(isAvailableAsync()).resolves.toBe(true);
-
-    FAKE_NATIVE_KEEP_AWAKE.isAvailableAsync = native;
-  });
-});
-
-describe('activateKeepAwakeAsync', () => {
-  it('activates the default tag when none is given', async () => {
-    await activateKeepAwakeAsync();
-
-    expect(FAKE_NATIVE_KEEP_AWAKE.activate).toHaveBeenCalledWith(ExpoKeepAwakeTag);
-  });
-
-  it('activates an explicit tag', async () => {
-    await activateKeepAwakeAsync('custom-tag');
-
-    expect(FAKE_NATIVE_KEEP_AWAKE.activate).toHaveBeenCalledWith('custom-tag');
-  });
-});
-
-describe('deactivateKeepAwake', () => {
-  it('deactivates the default tag when none is given', async () => {
-    await deactivateKeepAwake();
-
-    expect(FAKE_NATIVE_KEEP_AWAKE.deactivate).toHaveBeenCalledWith(ExpoKeepAwakeTag);
-  });
-
-  it('deactivates an explicit tag', async () => {
-    await deactivateKeepAwake('custom-tag');
-
-    expect(FAKE_NATIVE_KEEP_AWAKE.deactivate).toHaveBeenCalledWith('custom-tag');
-  });
-});
-
-describe('addListener', () => {
-  it('subscribes the default tag when called with a bare listener', () => {
-    const listener = vi.fn();
-    addListener(listener);
-
-    expect(FAKE_NATIVE_KEEP_AWAKE.addListenerForTag).toHaveBeenCalledWith(
-      ExpoKeepAwakeTag,
-      listener,
-    );
-  });
-
-  it('subscribes an explicit tag when given tag + listener', () => {
-    const listener = vi.fn();
-    addListener('custom-tag', listener);
-
-    expect(FAKE_NATIVE_KEEP_AWAKE.addListenerForTag).toHaveBeenCalledWith('custom-tag', listener);
-  });
-
-  it('throws an UnavailabilityError-shaped error when addListenerForTag is absent', () => {
-    const { addListenerForTag: native } = FAKE_NATIVE_KEEP_AWAKE;
-    // @ts-expect-error -- simulating a platform where the native module has no such method
-    FAKE_NATIVE_KEEP_AWAKE.addListenerForTag = undefined;
-
-    expect(() => addListener(vi.fn())).toThrow(
-      'addListenerForTag is not available on ExpoKeepAwake',
-    );
-
-    FAKE_NATIVE_KEEP_AWAKE.addListenerForTag = native;
-  });
-
-  it('throws when no listener can be resolved', () => {
-    expect(() => addListener('custom-tag')).toThrow('addListener requires a listener function');
-  });
-});

package/src/react/hooks/use-keep-awake/use-keep-awake.test.tsx

@@ -1,70 +0,0 @@
-// Co-located React-driven test (ADR 0025) for useKeepAwake. See battery's
-// use-low-power-mode.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 { useKeepAwake } from './index';
-
-const { activateKeepAwakeAsync, addListener, deactivateKeepAwake } = vi.hoisted(() => ({
-  activateKeepAwakeAsync: vi.fn(async (_tag: string) => undefined),
-  addListener: vi.fn(),
-  deactivateKeepAwake: vi.fn(async (_tag: string) => undefined),
-}));
-
-vi.mock('../../../core', () => ({
-  activateKeepAwakeAsync,
-  addListener,
-  deactivateKeepAwake,
-}));
-
-const ROOT_TAG = 954;
-
-function Probe({ tag }: { tag?: string }): ReactElement {
-  useKeepAwake(tag);
-  return createElement(View);
-}
-
-const fabric = installFabric();
-
-beforeEach(() => {
-  fabric.reset();
-  vi.clearAllMocks();
-  activateKeepAwakeAsync.mockResolvedValue(undefined);
-  deactivateKeepAwake.mockResolvedValue(undefined);
-});
-
-afterEach(() => unmount(ROOT_TAG));
-
-describe('useKeepAwake', () => {
-  it('activates a default tag on mount', async () => {
-    mount(ROOT_TAG, createElement(Probe));
-
-    await vi.waitFor(() => expect(activateKeepAwakeAsync).toHaveBeenCalledTimes(1));
-    expect(typeof activateKeepAwakeAsync.mock.calls[0][0]).toBe('string');
-  });
-
-  it('activates the explicit tag when one is given', async () => {
-    mount(ROOT_TAG, createElement(Probe, { tag: 'custom-tag' }));
-
-    await vi.waitFor(() => expect(activateKeepAwakeAsync).toHaveBeenCalledWith('custom-tag'));
-  });
-
-  it('deactivates the same tag on unmount', async () => {
-    mount(ROOT_TAG, createElement(Probe, { tag: 'custom-tag' }));
-    await vi.waitFor(() => expect(activateKeepAwakeAsync).toHaveBeenCalledTimes(1));
-
-    unmount(ROOT_TAG);
-
-    expect(deactivateKeepAwake).toHaveBeenCalledWith('custom-tag');
-  });
-
-  it('never touches addListener when no options are given', async () => {
-    mount(ROOT_TAG, createElement(Probe, { tag: 'custom-tag' }));
-
-    await vi.waitFor(() => expect(activateKeepAwakeAsync).toHaveBeenCalledTimes(1));
-    expect(addListener).not.toHaveBeenCalled();
-  });
-});

package/src/vue/composables/use-keep-awake/use-keep-awake.test.ts

@@ -1,76 +0,0 @@
-// Co-located Vue-driven test (ADR 0025) for useKeepAwake. See battery's
-// use-low-power-mode.test.ts for the shared rationale.
-
-import { defineComponent, h } 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 { useKeepAwake } from './index';
-
-const ROOT_TAG = 9954;
-
-const activateKeepAwakeAsyncMock = vi.fn(async (_tag: string) => undefined);
-const addListenerMock = vi.fn();
-const deactivateKeepAwakeMock = vi.fn(async (_tag: string) => undefined);
-
-vi.mock('../../../core', () => ({
-  activateKeepAwakeAsync: (tag: string) => activateKeepAwakeAsyncMock(tag),
-  addListener: (...args: unknown[]) => addListenerMock(...args),
-  deactivateKeepAwake: (tag: string) => deactivateKeepAwakeMock(tag),
-}));
-
-const fabric = installFabric();
-
-beforeEach(() => {
-  fabric.reset();
-  activateKeepAwakeAsyncMock.mockClear();
-  addListenerMock.mockClear();
-  deactivateKeepAwakeMock.mockClear();
-  activateKeepAwakeAsyncMock.mockResolvedValue(undefined);
-  deactivateKeepAwakeMock.mockResolvedValue(undefined);
-});
-
-afterEach(() => unmount(ROOT_TAG));
-
-function mountKeepAwake(tag?: string): void {
-  mount(
-    ROOT_TAG,
-    defineComponent({
-      setup: () => {
-        useKeepAwake(tag);
-        return () => h('symbiote-text', {}, 'keep-awake');
-      },
-    }),
-  );
-}
-
-describe('useKeepAwake (Vue)', () => {
-  it('activates a default tag on mount', async () => {
-    mountKeepAwake();
-
-    await vi.waitFor(() => expect(activateKeepAwakeAsyncMock).toHaveBeenCalledTimes(1));
-    expect(typeof activateKeepAwakeAsyncMock.mock.calls[0][0]).toBe('string');
-  });
-
-  it('activates the explicit tag when one is given', async () => {
-    mountKeepAwake('custom-tag');
-
-    await vi.waitFor(() => expect(activateKeepAwakeAsyncMock).toHaveBeenCalledWith('custom-tag'));
-  });
-
-  it('deactivates the same tag on unmount', async () => {
-    mountKeepAwake('custom-tag');
-    await vi.waitFor(() => expect(activateKeepAwakeAsyncMock).toHaveBeenCalledTimes(1));
-
-    unmount(ROOT_TAG);
-
-    expect(deactivateKeepAwakeMock).toHaveBeenCalledWith('custom-tag');
-  });
-
-  it('never touches addListener when no options are given', async () => {
-    mountKeepAwake('custom-tag');
-
-    await vi.waitFor(() => expect(activateKeepAwakeAsyncMock).toHaveBeenCalledTimes(1));
-    expect(addListenerMock).not.toHaveBeenCalled();
-  });
-});