@symbiote-native/tracking-transparency 0.0.1 → 0.1.0

package/README.md

@@ -142,6 +142,12 @@ export class TrackingScreen {
 }
 ```
 
+All three examples mirror the real canary demo screens —
+`examples/expo-react/screens/TrackingTransparencyScreen.tsx`,
+`examples/expo-vue-sfc/screens/TrackingTransparencyScreen.vue`,
+`examples/expo-vue-tsx/screens/TrackingTransparencyScreen.tsx`,
+`examples/expo-angular/src/screens/TrackingTransparencyScreen.ts`.
+
 ## API
 
 ```ts
@@ -205,6 +211,5 @@ surface, never a view. Tests inject a fake native-module object in place of the
 
 ## Known gaps
 
-- Not yet wired into any `examples/expo-*` canary.
 - Tests exercise the JS layer only (fake native module, `vitest`) — no on-device/simulator
   automated smoke test yet, only manual verification.

package/build/angular/index.js

@@ -1,4 +1,4 @@
 // PermissionsService is the Angular-only lifecycle half; getAdvertisingId/isAvailable are
 // stateless free functions, shared with React/Vue.
-export { PermissionsService } from './services/permissions.service';
-export * from '../core';
+export { PermissionsService } from './services/permissions.service/index.js';
+export * from '../core/index.js';

package/build/angular/services/permissions.service/index.js

@@ -40,7 +40,7 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
 //   readonly status = inject(PermissionsService).connect();
 //   // template: {{ status()?.granted }}
 import { Injectable, signal } from '@angular/core';
-import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../../core';
+import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../../core/index.js';
 let PermissionsService = (() => {
     let _classDecorators = [Injectable({ providedIn: 'root' })];
     let _classDescriptor;

package/build/core/index.js

@@ -1,2 +1,2 @@
-export { getAdvertisingId, requestTrackingPermissionsAsync, getTrackingPermissionsAsync, isAvailable, } from './tracking-transparency';
+export { getAdvertisingId, requestTrackingPermissionsAsync, getTrackingPermissionsAsync, isAvailable, } from './tracking-transparency.js';
 export { PermissionStatus, } from 'expo-modules-core';

package/build/core/tracking-transparency.js

@@ -6,7 +6,7 @@
 // convention is for each adapter to hand-roll its own permission hook instead (react/hooks,
 // vue/composables, angular/services), same as brightness/cellular already do.
 import { Platform, PermissionStatus, UnavailabilityError } from 'expo-modules-core';
-import { expoTrackingTransparency } from './native-module';
+import { expoTrackingTransparency } from './native-module.js';
 const NATIVE_MODULE_NAME = 'TrackingTransparency';
 /**
  * Gets the advertising ID, a UUID string intended only for advertising. Returns `null` on the

package/build/react/hooks/use-permissions/index.js

@@ -3,7 +3,7 @@
 // callbacks. Mirrors the shape @symbiote-native/cellular's own usePermissions ships in parallel,
 // so both stay byte-for-byte consistent.
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../../core';
+import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../../core/index.js';
 export function usePermissions() {
     const isMounted = useRef(true);
     const [status, setStatus] = useState(null);

package/build/react/index.js

@@ -2,5 +2,5 @@
 // core. Only the permission surface gets a lifecycle hook (there is per-instance state to seed
 // and refresh); getAdvertisingId/isAvailable are stateless, re-exported verbatim — mirrors the
 // lifecycle-bucket naming convention of adapters/react/src/hooks.
-export { usePermissions } from './hooks/use-permissions';
-export * from '../core';
+export { usePermissions } from './hooks/use-permissions/index.js';
+export * from '../core/index.js';

package/build/vue/composables/use-permissions/index.js

@@ -3,7 +3,7 @@
 // onMounted/onUnmounted style, but there is no ongoing subscription to tear down here, just a
 // one-shot get), then exposes get/request as imperative callbacks.
 import { onMounted, ref } from '@vue/runtime-core';
-import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../../core';
+import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../../core/index.js';
 export function usePermissions() {
     const status = ref(null);
     const get = async () => {

package/build/vue/index.js

@@ -2,5 +2,5 @@
 // Same reasoning as the React entry — only the permission surface gets a lifecycle composable,
 // every other export is a plain re-export — mirrors the lifecycle-bucket naming convention of
 // adapters/vue/src/composables (never `hooks/`, that's React's term).
-export { usePermissions } from './composables/use-permissions';
-export * from '../core';
+export { usePermissions } from './composables/use-permissions/index.js';
+export * from '../core/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbiote-native/tracking-transparency",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "expo-tracking-transparency wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. iOS App Tracking Transparency prompt (permission get/request, always-granted on Android/web) plus the advertising-ID getter.",
   "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/angular": "0.6.2",
     "@symbiote-native/engine": "0.1.7",
-    "@symbiote-native/vue": "0.3.8",
+    "@symbiote-native/react": "0.2.8",
     "@symbiote-native/test-utils": "0.1.6",
-    "@symbiote-native/react": "0.2.8"
+    "@symbiote-native/vue": "0.3.8"
   },
   "scripts": {
     "typecheck": "tsc --build",

package/src/angular/services/permissions.service/permissions.service.test.ts

@@ -1,107 +0,0 @@
-// Co-located Angular-driven test (ADR 0025) for PermissionsService. 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 { PermissionsService } from './index';
-import { PermissionStatus, type PermissionResponse } from '../../../core';
-
-const { getTrackingPermissionsAsync, requestTrackingPermissionsAsync } = vi.hoisted(() => ({
-  getTrackingPermissionsAsync: vi.fn(),
-  requestTrackingPermissionsAsync: vi.fn(),
-}));
-
-// Same enum-shaped-object mock trick packages/battery/src/angular/services/battery-state.service's
-// test uses for BatteryState.
-vi.mock('../../../core', () => ({
-  getTrackingPermissionsAsync,
-  requestTrackingPermissionsAsync,
-  PermissionStatus: { GRANTED: 'granted', DENIED: 'denied', UNDETERMINED: 'undetermined' },
-}));
-
-const GRANTED: PermissionResponse = {
-  status: PermissionStatus.GRANTED,
-  granted: true,
-  canAskAgain: true,
-  expires: 'never',
-};
-const DENIED: PermissionResponse = {
-  status: PermissionStatus.DENIED,
-  granted: false,
-  canAskAgain: true,
-  expires: 'never',
-};
-
-const ROOT_TAG = 974;
-const fabric = installFabric();
-const tick = (): Promise<void> => new Promise(resolve => setTimeout(resolve, 0));
-
-let capturedStatus: Signal<PermissionResponse | null> | undefined;
-let capturedService: PermissionsService | undefined;
-
-@Component({
-  selector: 'symbiote-permissions-host',
-  standalone: true,
-  template: '',
-})
-class PermissionsHost {
-  readonly service = inject(PermissionsService);
-  readonly status = this.service.connect();
-
-  constructor() {
-    capturedStatus = this.status;
-    capturedService = this.service;
-  }
-}
-
-beforeEach(() => {
-  capturedStatus = undefined;
-  capturedService = undefined;
-  vi.clearAllMocks();
-  getTrackingPermissionsAsync.mockResolvedValue(GRANTED);
-  requestTrackingPermissionsAsync.mockResolvedValue(GRANTED);
-});
-
-afterEach(() => {
-  unmount(ROOT_TAG);
-  fabric.reset();
-});
-
-describe('PermissionsService.connect', () => {
-  it('reports null before the initial fetch resolves', () => {
-    mount(ROOT_TAG, PermissionsHost);
-
-    expect(capturedStatus?.()).toBe(null);
-  });
-
-  it('reports the fetched status once getTrackingPermissionsAsync() resolves', async () => {
-    mount(ROOT_TAG, PermissionsHost);
-    await tick();
-
-    expect(capturedStatus?.()).toEqual(GRANTED);
-    expect(getTrackingPermissionsAsync).toHaveBeenCalledTimes(1);
-  });
-
-  it('request() delegates to requestTrackingPermissionsAsync and updates the signal', async () => {
-    mount(ROOT_TAG, PermissionsHost);
-    await tick();
-
-    requestTrackingPermissionsAsync.mockResolvedValueOnce(DENIED);
-    await capturedService?.request();
-
-    expect(capturedStatus?.()).toEqual(DENIED);
-  });
-
-  it('get() re-fetches and updates the signal', async () => {
-    mount(ROOT_TAG, PermissionsHost);
-    await tick();
-
-    getTrackingPermissionsAsync.mockResolvedValueOnce(DENIED);
-    await capturedService?.get();
-
-    expect(capturedStatus?.()).toEqual(DENIED);
-  });
-});

package/src/core/tracking-transparency.test.ts

@@ -1,137 +0,0 @@
-import { afterEach, describe, expect, it, vi } from 'vitest';
-
-const FAKE_NATIVE_TRACKING_TRANSPARENCY = {
-  getAdvertisingId: vi.fn(() => 'E9228286-4C4E-4789-9D95-15827DCB291B'),
-  requestPermissionsAsync: vi.fn(async () => ({ status: 'granted', granted: true })),
-  getPermissionsAsync: vi.fn(async () => ({ status: 'granted', granted: true })),
-};
-
-// The real ExpoTrackingTransparency 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/brightness/src/core/brightness.test.ts and packages/device/src/core/device.test.ts use.
-vi.mock('./native-module', () => ({
-  expoTrackingTransparency: FAKE_NATIVE_TRACKING_TRANSPARENCY,
-}));
-
-// 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/brightness/src/core/brightness.test.ts uses, since Platform.OS gates the
-// Android/web-vs-iOS branch here.
-const fakePlatform = { OS: 'ios' as 'ios' | 'android' };
-
-vi.mock('expo-modules-core', () => ({
-  Platform: fakePlatform,
-  PermissionStatus: { GRANTED: 'granted', DENIED: 'denied', UNDETERMINED: 'undetermined' },
-  UnavailabilityError: class UnavailabilityError extends Error {
-    constructor(moduleName: string, propertyName: string) {
-      super(`${propertyName} is not available on ${moduleName}`);
-    }
-  },
-}));
-
-const {
-  getAdvertisingId,
-  requestTrackingPermissionsAsync,
-  getTrackingPermissionsAsync,
-  isAvailable,
-} = await import('./tracking-transparency');
-
-afterEach(() => {
-  fakePlatform.OS = 'ios';
-  vi.clearAllMocks();
-});
-
-describe('getAdvertisingId', () => {
-  it('returns the advertising ID straight from the native module', () => {
-    expect(getAdvertisingId()).toBe('E9228286-4C4E-4789-9D95-15827DCB291B');
-  });
-
-  it('maps the all-zero UUID sentinel to null', () => {
-    FAKE_NATIVE_TRACKING_TRANSPARENCY.getAdvertisingId.mockReturnValueOnce(
-      '00000000-0000-0000-0000-000000000000',
-    );
-
-    expect(getAdvertisingId()).toBeNull();
-  });
-});
-
-describe('requestTrackingPermissionsAsync', () => {
-  it('always resolves granted on Android without calling the native module', async () => {
-    fakePlatform.OS = 'android';
-
-    await expect(requestTrackingPermissionsAsync()).resolves.toEqual({
-      granted: true,
-      expires: 'never',
-      canAskAgain: true,
-      status: 'granted',
-    });
-    expect(FAKE_NATIVE_TRACKING_TRANSPARENCY.requestPermissionsAsync).not.toHaveBeenCalled();
-  });
-
-  it('delegates to the native module on iOS', async () => {
-    fakePlatform.OS = 'ios';
-
-    await expect(requestTrackingPermissionsAsync()).resolves.toEqual({
-      status: 'granted',
-      granted: true,
-    });
-    expect(FAKE_NATIVE_TRACKING_TRANSPARENCY.requestPermissionsAsync).toHaveBeenCalledTimes(1);
-  });
-
-  it('throws an UnavailabilityError-shaped error on iOS when the native method is absent', async () => {
-    fakePlatform.OS = 'ios';
-    const { requestPermissionsAsync: native } = FAKE_NATIVE_TRACKING_TRANSPARENCY;
-    // @ts-expect-error -- simulating a native module build missing this method
-    FAKE_NATIVE_TRACKING_TRANSPARENCY.requestPermissionsAsync = undefined;
-
-    await expect(requestTrackingPermissionsAsync()).rejects.toThrow(
-      'requestPermissionsAsync is not available on TrackingTransparency',
-    );
-
-    FAKE_NATIVE_TRACKING_TRANSPARENCY.requestPermissionsAsync = native;
-  });
-});
-
-describe('getTrackingPermissionsAsync', () => {
-  it('always resolves granted on Android without calling the native module', async () => {
-    fakePlatform.OS = 'android';
-
-    await expect(getTrackingPermissionsAsync()).resolves.toEqual({
-      granted: true,
-      expires: 'never',
-      canAskAgain: true,
-      status: 'granted',
-    });
-    expect(FAKE_NATIVE_TRACKING_TRANSPARENCY.getPermissionsAsync).not.toHaveBeenCalled();
-  });
-
-  it('delegates to the native module on iOS', async () => {
-    fakePlatform.OS = 'ios';
-
-    await expect(getTrackingPermissionsAsync()).resolves.toEqual({
-      status: 'granted',
-      granted: true,
-    });
-    expect(FAKE_NATIVE_TRACKING_TRANSPARENCY.getPermissionsAsync).toHaveBeenCalledTimes(1);
-  });
-
-  it('throws an UnavailabilityError-shaped error on iOS when the native method is absent', async () => {
-    fakePlatform.OS = 'ios';
-    const { getPermissionsAsync: native } = FAKE_NATIVE_TRACKING_TRANSPARENCY;
-    // @ts-expect-error -- simulating a native module build missing this method
-    FAKE_NATIVE_TRACKING_TRANSPARENCY.getPermissionsAsync = undefined;
-
-    await expect(getTrackingPermissionsAsync()).rejects.toThrow(
-      'getPermissionsAsync is not available on TrackingTransparency',
-    );
-
-    FAKE_NATIVE_TRACKING_TRANSPARENCY.getPermissionsAsync = native;
-  });
-});
-
-describe('isAvailable', () => {
-  it('resolves true when the native module resolved', () => {
-    expect(isAvailable()).toBe(true);
-  });
-});

package/src/react/hooks/use-permissions/use-permissions.test.tsx

@@ -1,100 +0,0 @@
-// Co-located React-driven test (ADR 0025) for usePermissions. 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 { usePermissions } from './index';
-import { PermissionStatus, type PermissionResponse } from '../../../core';
-
-const { getTrackingPermissionsAsync, requestTrackingPermissionsAsync } = vi.hoisted(() => ({
-  getTrackingPermissionsAsync: vi.fn(),
-  requestTrackingPermissionsAsync: vi.fn(),
-}));
-
-// Same enum-shaped-object mock trick packages/battery/src/react/hooks/use-battery-state's test
-// uses for BatteryState — the mock factory's runtime object stands in for the real enum
-// (imported here purely for its type), so `PermissionStatus.GRANTED` still type-checks.
-vi.mock('../../../core', () => ({
-  getTrackingPermissionsAsync,
-  requestTrackingPermissionsAsync,
-  PermissionStatus: { GRANTED: 'granted', DENIED: 'denied', UNDETERMINED: 'undetermined' },
-}));
-
-const ROOT_TAG = 954;
-
-const GRANTED: PermissionResponse = {
-  status: PermissionStatus.GRANTED,
-  granted: true,
-  canAskAgain: true,
-  expires: 'never',
-};
-const DENIED: PermissionResponse = {
-  status: PermissionStatus.DENIED,
-  granted: false,
-  canAskAgain: true,
-  expires: 'never',
-};
-
-const results: (PermissionResponse | null)[] = [];
-let latestRequest: (() => Promise<PermissionResponse>) | undefined;
-let latestGet: (() => Promise<PermissionResponse>) | undefined;
-
-function Probe(): ReactElement {
-  const [status, request, get] = usePermissions();
-  results.push(status);
-  latestRequest = request;
-  latestGet = get;
-  return createElement(View);
-}
-
-const fabric = installFabric();
-
-beforeEach(() => {
-  fabric.reset();
-  results.length = 0;
-  latestRequest = undefined;
-  latestGet = undefined;
-  vi.clearAllMocks();
-  getTrackingPermissionsAsync.mockResolvedValue(GRANTED);
-  requestTrackingPermissionsAsync.mockResolvedValue(GRANTED);
-});
-
-afterEach(() => unmount(ROOT_TAG));
-
-describe('usePermissions', () => {
-  it('starts at null before the initial fetch resolves', () => {
-    mount(ROOT_TAG, createElement(Probe));
-
-    expect(results[results.length - 1]).toBe(null);
-  });
-
-  it('fetches the permission status once on mount', async () => {
-    mount(ROOT_TAG, createElement(Probe));
-
-    await vi.waitFor(() => expect(results[results.length - 1]).toEqual(GRANTED));
-    expect(getTrackingPermissionsAsync).toHaveBeenCalledTimes(1);
-  });
-
-  it('request() delegates to requestTrackingPermissionsAsync and updates the status', async () => {
-    mount(ROOT_TAG, createElement(Probe));
-    await vi.waitFor(() => expect(results[results.length - 1]).toEqual(GRANTED));
-
-    requestTrackingPermissionsAsync.mockResolvedValueOnce(DENIED);
-    await latestRequest?.();
-
-    await vi.waitFor(() => expect(results[results.length - 1]).toEqual(DENIED));
-  });
-
-  it('get() re-fetches and updates the status', async () => {
-    mount(ROOT_TAG, createElement(Probe));
-    await vi.waitFor(() => expect(results[results.length - 1]).toEqual(GRANTED));
-
-    getTrackingPermissionsAsync.mockResolvedValueOnce(DENIED);
-    await latestGet?.();
-
-    await vi.waitFor(() => expect(results[results.length - 1]).toEqual(DENIED));
-  });
-});

package/src/vue/composables/use-permissions/use-permissions.test.ts

@@ -1,99 +0,0 @@
-// Co-located Vue-driven test (ADR 0025) for usePermissions. See battery's
-// use-battery-state.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 { usePermissions } from './index';
-import { PermissionStatus, type PermissionResponse } from '../../../core';
-
-const { getTrackingPermissionsAsync, requestTrackingPermissionsAsync } = vi.hoisted(() => ({
-  getTrackingPermissionsAsync: vi.fn(),
-  requestTrackingPermissionsAsync: vi.fn(),
-}));
-
-// Same enum-shaped-object mock trick packages/battery/src/vue/composables/use-battery-state's
-// test uses for BatteryState.
-vi.mock('../../../core', () => ({
-  getTrackingPermissionsAsync,
-  requestTrackingPermissionsAsync,
-  PermissionStatus: { GRANTED: 'granted', DENIED: 'denied', UNDETERMINED: 'undetermined' },
-}));
-
-const GRANTED: PermissionResponse = {
-  status: PermissionStatus.GRANTED,
-  granted: true,
-  canAskAgain: true,
-  expires: 'never',
-};
-const DENIED: PermissionResponse = {
-  status: PermissionStatus.DENIED,
-  granted: false,
-  canAskAgain: true,
-  expires: 'never',
-};
-
-const ROOT_TAG = 9954;
-const fabric = installFabric();
-
-beforeEach(() => {
-  fabric.reset();
-  vi.clearAllMocks();
-  getTrackingPermissionsAsync.mockResolvedValue(GRANTED);
-  requestTrackingPermissionsAsync.mockResolvedValue(GRANTED);
-});
-
-afterEach(() => unmount(ROOT_TAG));
-
-function mountPermissions(): ReturnType<typeof usePermissions> {
-  let result: ReturnType<typeof usePermissions> | undefined;
-  mount(
-    ROOT_TAG,
-    defineComponent({
-      setup: () => {
-        result = usePermissions();
-        return () => h('symbiote-text', {}, 'tracking-transparency');
-      },
-    }),
-  );
-  if (result === undefined) {
-    throw new Error('setup() did not run');
-  }
-  return result;
-}
-
-describe('usePermissions (Vue)', () => {
-  it('starts at null before the initial fetch resolves', () => {
-    const { status } = mountPermissions();
-
-    expect(status.value).toBe(null);
-  });
-
-  it('fetches the permission status once on mount', async () => {
-    const { status } = mountPermissions();
-
-    await vi.waitFor(() => expect(status.value).toEqual(GRANTED));
-    expect(getTrackingPermissionsAsync).toHaveBeenCalledTimes(1);
-  });
-
-  it('request() delegates to requestTrackingPermissionsAsync and updates the status', async () => {
-    const { status, request } = mountPermissions();
-    await vi.waitFor(() => expect(status.value).toEqual(GRANTED));
-
-    requestTrackingPermissionsAsync.mockResolvedValueOnce(DENIED);
-    await request();
-
-    expect(status.value).toEqual(DENIED);
-  });
-
-  it('get() re-fetches and updates the status', async () => {
-    const { status, get } = mountPermissions();
-    await vi.waitFor(() => expect(status.value).toEqual(GRANTED));
-
-    getTrackingPermissionsAsync.mockResolvedValueOnce(DENIED);
-    await get();
-
-    expect(status.value).toEqual(DENIED);
-  });
-});