@symbiote-native/tracking-transparency 0.1.0 → 0.3.0

package/README.md

@@ -3,9 +3,9 @@
 A wrapper package for [SymbioteNative](../../README.md) that makes
 [`expo-tracking-transparency`](https://github.com/expo/expo/tree/main/packages/expo-tracking-transparency)
 — the iOS App Tracking Transparency prompt, permission get/request, and the advertising-ID getter
-— usable from **every** adapter, React, Vue, and Angular, not just React. Like
+— usable from **every** adapter, React, Vue, Svelte, Solid, and Angular, not just React. Like
 [`@symbiote-native/brightness`](../brightness), this package's surface is mostly stateless free
-async functions; only the permission surface gets its own lifecycle hook/composable/service,
+async functions; only the permission surface gets its own per-adapter lifecycle wrapper,
 mirroring upstream's own `usePermissions`. Built the same way as
 [`@symbiote-native/local-auth`](../local-auth), [`@symbiote-native/battery`](../battery), and
 [`@symbiote-native/brightness`](../brightness) — an `expo-modules-core`-based wrapper (see the
@@ -34,13 +34,13 @@ Unlike a plain RN native module, `expo-tracking-transparency`'s native code is d
 this repo use — this needs wiring into the native host app **once**, covering this package and
 every other `expo-modules-core` package with zero further changes:
 
-| Platform | Touches |
-|---|---|
-| iOS | `ios/Podfile` — add `use_expo_modules!` |
-| iOS | `AppDelegate.swift` — Expo's runtime-bootstrap hook |
-| iOS | `Info.plist` — `NSUserTrackingUsageDescription`, required to show the ATT prompt |
-| Android | `settings.gradle` / `app/build.gradle` — resolve and include the Expo Gradle projects |
-| Android | `MainApplication.kt` — Expo's bootstrap hook, plus a hand-written native-module name map (there's no `expo` meta-package here to auto-generate one) |
+| Platform | Touches                                                                                                                                             |
+| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
+| iOS      | `ios/Podfile` — add `use_expo_modules!`                                                                                                             |
+| iOS      | `AppDelegate.swift` — Expo's runtime-bootstrap hook                                                                                                 |
+| iOS      | `Info.plist` — `NSUserTrackingUsageDescription`, required to show the ATT prompt                                                                    |
+| Android  | `settings.gradle` / `app/build.gradle` — resolve and include the Expo Gradle projects                                                               |
+| Android  | `MainApplication.kt` — Expo's bootstrap hook, plus a hand-written native-module name map (there's no `expo` meta-package here to auto-generate one) |
 
 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. The Android
@@ -56,13 +56,16 @@ src/core/                 getAdvertisingId, get/requestTrackingPermissionsAsync,
                           expo-modules-core's requireNativeModule.
 src/react/hooks/           @symbiote-native/tracking-transparency/react   — usePermissions
 src/vue/composables/       @symbiote-native/tracking-transparency/vue     — usePermissions (same name)
+src/svelte/runes/          @symbiote-native/tracking-transparency/svelte  — usePermissions (same name)
+src/solid/primitives/      @symbiote-native/tracking-transparency/solid   — createPermissions
+                           (Solid reserves `use*` for consuming existing state)
 src/angular/services/      @symbiote-native/tracking-transparency/angular — PermissionsService
 ```
 
-Each adapter's hook/composable/service wraps the same one-shot `getTrackingPermissionsAsync`/
-`requestTrackingPermissionsAsync` pair in its own lifecycle idiom (auto-fetch on mount, exposed as
-a tuple/object/signal). `getAdvertisingId`/`isAvailable` are stateless free-function re-exports,
-written once in `core/` and shared verbatim by all three adapters.
+Each adapter's wrapper puts the same one-shot `getTrackingPermissionsAsync`/
+`requestTrackingPermissionsAsync` pair in its own lifecycle idiom (auto-fetch when the wrapper is
+created, exposed as a tuple/object/signal/accessor). `getAdvertisingId`/`isAvailable` are stateless
+free-function re-exports, written once in `core/` and shared verbatim by every adapter.
 
 Upstream's own `createPermissionHook`/`useTrackingPermissions` is **not** ported — that helper is
 React-only (built on `useState`/`useEffect`), and this repo's convention is for each adapter to
@@ -98,7 +101,8 @@ function TrackingScreen() {
 import { usePermissions } from '@symbiote-native/tracking-transparency/vue';
 import { getAdvertisingId } from '@symbiote-native/tracking-transparency';
 
-const { status: permissionStatus, request: requestPermission } = usePermissions();
+const { status: permissionStatus, request: requestPermission } =
+  usePermissions();
 </script>
 
 <template>
@@ -117,7 +121,10 @@ const { status: permissionStatus, request: requestPermission } = usePermissions(
 ```ts
 // Angular
 import { Component, inject } from '@angular/core';
-import { PermissionsService, getAdvertisingId } from '@symbiote-native/tracking-transparency/angular';
+import {
+  PermissionsService,
+  getAdvertisingId,
+} from '@symbiote-native/tracking-transparency/angular';
 
 @Component({
   selector: 'TrackingScreen',
@@ -128,7 +135,9 @@ import { PermissionsService, getAdvertisingId } from '@symbiote-native/tracking-
       <Pressable (press)="permissionsService.request()">
         <Text>Request tracking permission</Text>
       </Pressable>
-      <Pressable (press)="logAdvertisingId()"><Text>Log advertising ID</Text></Pressable>
+      <Pressable (press)="logAdvertisingId()"
+        ><Text>Log advertising ID</Text></Pressable
+      >
     </View>
   `,
 })
@@ -142,7 +151,30 @@ export class TrackingScreen {
 }
 ```
 
-All three examples mirror the real canary demo screens —
+```tsx
+// Solid — the accessors are CALLED; a Solid component body runs once, so a snapshot would freeze.
+import { createPermissions } from '@symbiote-native/tracking-transparency/solid';
+import { getAdvertisingId } from '@symbiote-native/tracking-transparency';
+
+function TrackingScreen() {
+  const { status: permissionStatus, request: requestPermission } =
+    createPermissions();
+
+  return (
+    <View>
+      <Text>{permissionStatus()?.status ?? 'checking…'}</Text>
+      <Pressable onPress={() => void requestPermission()}>
+        <Text>Request tracking permission</Text>
+      </Pressable>
+      <Pressable onPress={() => console.log(getAdvertisingId())}>
+        <Text>Log advertising ID</Text>
+      </Pressable>
+    </View>
+  );
+}
+```
+
+The examples above 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`,
@@ -168,26 +200,35 @@ Plus `PermissionStatus`/`PermissionResponse`/`PermissionExpiration`/`PermissionH
 re-exported verbatim from `expo-modules-core`, never the `expo` meta-package.
 
 ```ts
-import { getAdvertisingId, getTrackingPermissionsAsync } from '@symbiote-native/tracking-transparency';
+import {
+  getAdvertisingId,
+  getTrackingPermissionsAsync,
+} from '@symbiote-native/tracking-transparency';
 
-// framework-scoped entry points re-export the same free functions, plus a usePermissions
-// hook/composable/service:
+// framework-scoped entry points re-export the same free functions, plus a per-adapter
+// permission wrapper:
 import { usePermissions } from '@symbiote-native/tracking-transparency/react';
 import { usePermissions } from '@symbiote-native/tracking-transparency/vue';
+import { usePermissions } from '@symbiote-native/tracking-transparency/svelte';
+import { createPermissions } from '@symbiote-native/tracking-transparency/solid';
 import { PermissionsService } from '@symbiote-native/tracking-transparency/angular';
 ```
 
-`usePermissions` (React/Vue) auto-fetches the current permission status on mount and returns a
-`[status, request, get]` tuple (React) / `{ status, request, get }` object (Vue); Angular's
-`PermissionsService.connect()` does the same, returning a readonly `Signal`:
+`usePermissions` auto-fetches the current permission status on mount and returns a
+`[status, request, get, error]` tuple (React) / `{ status, error, request, get }` object
+(Vue/Svelte); Solid's `createPermissions` returns the same object with `Accessor`s instead of
+`Ref`s, and Angular's `PermissionsService.connect()` returns a readonly `Signal`:
 
 ```ts
 // React
 const [status, request] = usePermissions();
 
-// Vue
+// Vue / Svelte
 const { status, request } = usePermissions();
 
+// Solid — status is an accessor, called at the read site
+const { status, request } = createPermissions();
+
 // Angular
 readonly status = inject(PermissionsService).connect();
 ```
@@ -204,7 +245,7 @@ readonly status = inject(PermissionsService).connect();
 
 No Fabric/Descriptor angle at all — tracking-transparency is a pure async-function + permission
 surface, never a view. Tests inject a fake native-module object in place of the real
-`requireNativeModule` resolution (`src/core/*.test.ts`, `src/{react,vue,angular}/**/*.test.{ts,tsx}`,
+`requireNativeModule` resolution (`src/core/*.test.ts`, `src/{react,vue,svelte,solid,angular}/**/*.test.{ts,tsx}`,
 `vitest`), the same pattern `expo-tracking-transparency` itself uses upstream — no
 `installFabric()` for the core layer, no ViewConfig. Native rendering itself is verified on-device
 (see the parent [README](../../README.md) for the project's testing model).

package/build/angular/services/permissions.service/index.d.ts

@@ -2,6 +2,10 @@ import { type Signal } from '@angular/core';
 import { type PermissionResponse } from '../../../core';
 export declare class PermissionsService {
     private readonly status;
+    private readonly fetchError;
+    private isAutoFetchStarted;
+    /** Why the auto-fetch left `status` at null. Cleared by the next successful get()/request(). */
+    readonly error: Signal<Error | null>;
     connect(): Signal<PermissionResponse | null>;
     get(): Promise<PermissionResponse>;
     request(): Promise<PermissionResponse>;

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

@@ -39,6 +39,11 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
 //
 //   readonly status = inject(PermissionsService).connect();
 //   // template: {{ status()?.granted }}
+//
+// The auto-fetch has nobody to reject to, so its failure lands in the `error` signal instead of
+// escaping as an unhandled rejection: a null status with a non-null error is how a consumer tells
+// "the fetch failed" from "not fetched yet". get()/request() still reject to their direct caller —
+// only the automatic call is made safe.
 import { Injectable, signal } from '@angular/core';
 import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../../core/index.js';
 let PermissionsService = (() => {
@@ -56,20 +61,32 @@ let PermissionsService = (() => {
             __runInitializers(_classThis, _classExtraInitializers);
         }
         status = signal(null);
+        fetchError = signal(null);
+        isAutoFetchStarted = false;
+        /** Why the auto-fetch left `status` at null. Cleared by the next successful get()/request(). */
+        error = this.fetchError.asReadonly();
         connect() {
-            if (this.status() === null) {
-                void this.get();
+            // Latched rather than guarded on `status() === null`: a failed fetch leaves status null
+            // forever, so the old guard turned every later connect() into another native call — unbounded
+            // once connect() is reached from a change-detected expression instead of a field initializer.
+            if (!this.isAutoFetchStarted) {
+                this.isAutoFetchStarted = true;
+                this.get().catch((cause) => {
+                    this.fetchError.set(cause instanceof Error ? cause : new Error(String(cause)));
+                });
             }
             return this.status.asReadonly();
         }
         async get() {
             const response = await getTrackingPermissionsAsync();
             this.status.set(response);
+            this.fetchError.set(null);
             return response;
         }
         async request() {
             const response = await requestTrackingPermissionsAsync();
             this.status.set(response);
+            this.fetchError.set(null);
             return response;
         }
     };

package/build/core/tracking-transparency.js

@@ -5,7 +5,7 @@
 // NOT ported here — that helper is React-only (built on useState/useEffect), and this repo's
 // 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 { Platform, PermissionStatus, UnavailabilityError, } from 'expo-modules-core';
 import { expoTrackingTransparency } from './native-module.js';
 const NATIVE_MODULE_NAME = 'TrackingTransparency';
 /**

package/build/react/hooks/use-permissions/index.d.ts

@@ -2,5 +2,6 @@ import { type PermissionResponse } from '../../../core';
 export declare function usePermissions(): [
     PermissionResponse | null,
     () => Promise<PermissionResponse>,
-    () => Promise<PermissionResponse>
+    () => Promise<PermissionResponse>,
+    Error | null
 ];

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

@@ -2,29 +2,42 @@
 // auto-fetches the current permission status on mount, then exposes get/request as imperative
 // callbacks. Mirrors the shape @symbiote-native/cellular's own usePermissions ships in parallel,
 // so both stay byte-for-byte consistent.
+//
+// The mount fetch has nobody to reject to, so its failure lands in the 4th tuple slot (`error`)
+// instead of escaping as an unhandled rejection: a null status with a non-null error is how a
+// consumer tells "the fetch failed" from "not fetched yet". get()/request() still reject to their
+// direct caller — only the automatic call is made safe.
 import { useCallback, useEffect, useRef, useState } from 'react';
 import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../../core/index.js';
 export function usePermissions() {
     const isMounted = useRef(true);
     const [status, setStatus] = useState(null);
+    const [error, setError] = useState(null);
     const getPermission = useCallback(async () => {
         const response = await getTrackingPermissionsAsync();
-        if (isMounted.current)
+        if (isMounted.current) {
             setStatus(response);
+            setError(null);
+        }
         return response;
     }, []);
     const requestPermission = useCallback(async () => {
         const response = await requestTrackingPermissionsAsync();
-        if (isMounted.current)
+        if (isMounted.current) {
             setStatus(response);
+            setError(null);
+        }
         return response;
     }, []);
     useEffect(() => {
         isMounted.current = true;
-        void getPermission();
+        getPermission().catch((cause) => {
+            if (isMounted.current)
+                setError(cause instanceof Error ? cause : new Error(String(cause)));
+        });
         return () => {
             isMounted.current = false;
         };
     }, [getPermission]);
-    return [status, requestPermission, getPermission];
+    return [status, requestPermission, getPermission, error];
 }

package/build/solid/index.d.ts

@@ -0,0 +1,2 @@
+export { createPermissions } from './primitives/create-permissions';
+export * from '../core';

package/build/solid/index.js

@@ -0,0 +1,7 @@
+// @symbiote-native/tracking-transparency/solid: the Solid entry over the framework-agnostic core.
+// Same reasoning as the React, Vue and Svelte entries — only the permission surface gets a
+// lifecycle primitive, every other export is a plain re-export — mirrors the lifecycle-bucket
+// naming convention of adapters/solid/src/primitives (never `hooks/`/`composables/`/`runes/`,
+// those are React's, Vue's and Svelte's terms).
+export { createPermissions } from './primitives/create-permissions.js';
+export * from '../core/index.js';

package/build/solid/primitives/create-permissions.d.ts

@@ -0,0 +1,8 @@
+import { type Accessor } from 'solid-js';
+import { type PermissionResponse } from '../../core';
+export declare function createPermissions(): {
+    status: Accessor<PermissionResponse | null>;
+    error: Accessor<Error | null>;
+    request: () => Promise<PermissionResponse>;
+    get: () => Promise<PermissionResponse>;
+};

package/build/solid/primitives/create-permissions.js

@@ -0,0 +1,41 @@
+// createPermissions — the Solid twin of React's `usePermissions` hook, Vue's composable and
+// Svelte's rune, over the framework-agnostic core (core/tracking-transparency.ts). Auto-fetches
+// the current permission status, then exposes get/request as imperative callbacks.
+//
+// `primitives/` and `create*`, never `hooks/`+`use*`: Solid's ecosystem calls a composable
+// reactive function a PRIMITIVE and reserves `use*` for consuming something that already exists.
+// Full rationale in adapters/solid/src/primitives/create-color-scheme.ts.
+//
+// Returns ACCESSORS, never snapshots: a Solid component body runs ONCE, so returned values would
+// pin the caller to the null pre-fetch state forever.
+//
+// The auto-fetch fires from the primitive body rather than a mount effect — the shape
+// `createResource` uses, and the reason this primitive needs no lifecycle hook at all. Its failure
+// lands in `error` instead of escaping as an unhandled rejection: a null status with a non-null
+// error is how a consumer tells "the fetch failed" from "not fetched yet". get()/request() still
+// reject to their direct caller — only the automatic call is made safe.
+//
+// No isMounted guard around the late write, unlike React's hook: once the owning root is disposed
+// nothing is subscribed to these signals any more, so a resolution arriving afterwards is inert.
+import { createSignal } from 'solid-js';
+import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../core/index.js';
+export function createPermissions() {
+    const [status, setStatus] = createSignal(null);
+    const [error, setError] = createSignal(null);
+    const get = async () => {
+        const response = await getTrackingPermissionsAsync();
+        setStatus(response);
+        setError(null);
+        return response;
+    };
+    const request = async () => {
+        const response = await requestTrackingPermissionsAsync();
+        setStatus(response);
+        setError(null);
+        return response;
+    };
+    get().catch((cause) => {
+        setError(cause instanceof Error ? cause : new Error(String(cause)));
+    });
+    return { status, error, request, get };
+}

package/build/svelte/index.d.ts

@@ -0,0 +1,2 @@
+export { usePermissions } from './runes/use-permissions.svelte';
+export * from '../core';

package/build/svelte/index.js

@@ -0,0 +1,6 @@
+// @symbiote-native/tracking-transparency/svelte: the Svelte entry over the framework-agnostic core.
+// Same reasoning as the React and Vue entries — only the permission surface gets a lifecycle rune,
+// every other export is a plain re-export — mirrors the lifecycle-bucket naming convention of
+// adapters/svelte/src/runes (never `hooks/`/`composables/`, those are React's and Vue's terms).
+export { usePermissions } from './runes/use-permissions.svelte';
+export * from '../core/index.js';

package/build/svelte/runes/use-permissions.svelte.d.ts

@@ -0,0 +1,7 @@
+import { type PermissionResponse } from '../../core';
+export declare function usePermissions(): {
+    readonly status: PermissionResponse | null;
+    readonly error: Error | null;
+    request: () => Promise<PermissionResponse>;
+    get: () => Promise<PermissionResponse>;
+};

package/build/svelte/runes/use-permissions.svelte.js

@@ -0,0 +1,49 @@
+// Svelte lifecycle wiring over the framework-agnostic core (core/tracking-transparency.ts) —
+// auto-fetches the current permission status on mount, then exposes get/request as imperative
+// callbacks. Just a one-shot get with no ongoing subscription, so `$effect` needs no cleanup.
+//
+// `.svelte.ts` (not `.ts`): runes ($state/$effect) only work in files with this extension
+// outside an actual `.svelte` component. `status` is returned as a getter, NOT a bare
+// `$state`: Svelte 5 reactivity is lexically scoped to the declaring module and doesn't
+// survive being returned as a raw value from a plain function — mirrors how Vue's `Ref`
+// needs `.value` to unwrap.
+//
+// The mount fetch has nobody to reject to, so its failure lands in `error` (a second boxed getter,
+// same reason as `status`) instead of escaping as an unhandled rejection: a null status with a
+// non-null error is how a consumer tells "the fetch failed" from "not fetched yet".
+// get()/request() still reject to their direct caller — only the automatic call is made safe.
+import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../core/index.js';
+export function usePermissions() {
+    let status = $state(null);
+    let error = $state(null);
+    const get = async () => {
+        const response = await getTrackingPermissionsAsync();
+        status = response;
+        error = null;
+        return response;
+    };
+    const request = async () => {
+        const response = await requestTrackingPermissionsAsync();
+        status = response;
+        error = null;
+        return response;
+    };
+    $effect(() => {
+        // `get` is a plain closure, not reactive state, so the effect has an empty dependency set and
+        // runs exactly once on mount — the twin of Vue's onMounted. The catch runs after the effect
+        // has settled, so writing `error` there adds no dependency and does not re-arm it.
+        get().catch((cause) => {
+            error = cause instanceof Error ? cause : new Error(String(cause));
+        });
+    });
+    return {
+        get status() {
+            return status;
+        },
+        get error() {
+            return error;
+        },
+        request,
+        get,
+    };
+}

package/build/vue/composables/use-permissions/index.d.ts

@@ -2,6 +2,7 @@ import { type Ref } from '@vue/runtime-core';
 import { type PermissionResponse } from '../../../core';
 export declare function usePermissions(): {
     status: Ref<PermissionResponse | null>;
+    error: Ref<Error | null>;
     request: () => Promise<PermissionResponse>;
     get: () => Promise<PermissionResponse>;
 };

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

@@ -2,22 +2,32 @@
 // auto-fetches the current permission status on mount (mirrors use-battery-level's
 // 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.
+//
+// The mount fetch has nobody to reject to, so its failure lands in the `error` ref instead of
+// escaping as an unhandled rejection: a null status with a non-null error is how a consumer tells
+// "the fetch failed" from "not fetched yet". get()/request() still reject to their direct caller —
+// only the automatic call is made safe.
 import { onMounted, ref } from '@vue/runtime-core';
 import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../../core/index.js';
 export function usePermissions() {
     const status = ref(null);
+    const error = ref(null);
     const get = async () => {
         const response = await getTrackingPermissionsAsync();
         status.value = response;
+        error.value = null;
         return response;
     };
     const request = async () => {
         const response = await requestTrackingPermissionsAsync();
         status.value = response;
+        error.value = null;
         return response;
     };
     onMounted(() => {
-        void get();
+        get().catch((cause) => {
+            error.value = cause instanceof Error ? cause : new Error(String(cause));
+        });
     });
-    return { status, request, get };
+    return { status, error, request, get };
 }

package/build-ngc/angular/services/permissions.service/index.d.ts

@@ -3,6 +3,10 @@ import { type PermissionResponse } from '../../../core';
 import * as i0 from "@angular/core";
 export declare class PermissionsService {
     private readonly status;
+    private readonly fetchError;
+    private isAutoFetchStarted;
+    /** Why the auto-fetch left `status` at null. Cleared by the next successful get()/request(). */
+    readonly error: Signal<Error | null>;
     connect(): Signal<PermissionResponse | null>;
     get(): Promise<PermissionResponse>;
     request(): Promise<PermissionResponse>;

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

@@ -5,32 +5,50 @@
 //
 //   readonly status = inject(PermissionsService).connect();
 //   // template: {{ status()?.granted }}
+//
+// The auto-fetch has nobody to reject to, so its failure lands in the `error` signal instead of
+// escaping as an unhandled rejection: a null status with a non-null error is how a consumer tells
+// "the fetch failed" from "not fetched yet". get()/request() still reject to their direct caller —
+// only the automatic call is made safe.
 import { Injectable, signal } from '@angular/core';
 import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../../core';
 import * as i0 from "@angular/core";
 export class PermissionsService {
     status = signal(null, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "status" }] : /* istanbul ignore next */ []));
+    fetchError = signal(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "fetchError" }] : /* istanbul ignore next */ []));
+    isAutoFetchStarted = false;
+    /** Why the auto-fetch left `status` at null. Cleared by the next successful get()/request(). */
+    error = this.fetchError.asReadonly();
     connect() {
-        if (this.status() === null) {
-            void this.get();
+        // Latched rather than guarded on `status() === null`: a failed fetch leaves status null
+        // forever, so the old guard turned every later connect() into another native call — unbounded
+        // once connect() is reached from a change-detected expression instead of a field initializer.
+        if (!this.isAutoFetchStarted) {
+            this.isAutoFetchStarted = true;
+            this.get().catch((cause) => {
+                this.fetchError.set(cause instanceof Error ? cause : new Error(String(cause)));
+            });
         }
         return this.status.asReadonly();
     }
     async get() {
         const response = await getTrackingPermissionsAsync();
         this.status.set(response);
+        this.fetchError.set(null);
         return response;
     }
     async request() {
         const response = await requestTrackingPermissionsAsync();
         this.status.set(response);
+        this.fetchError.set(null);
         return response;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: PermissionsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: PermissionsService, providedIn: 'root' });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: PermissionsService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: PermissionsService, providedIn: 'root' });
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.5", ngImport: i0, type: PermissionsService, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.8", ngImport: i0, type: PermissionsService, decorators: [{
             type: Injectable,
             args: [{ providedIn: 'root' }]
         }] });

package/build-ngc/angular/services/permissions.service/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/angular/services/permissions.service/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,4FAA4F;AAC5F,yFAAyF;AACzF,+BAA+B;AAC/B,EAAE;AACF,4DAA4D;AAC5D,yCAAyC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AAChE,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAEhC,MAAM,eAAe,CAAC;;AAGvB,MAAM,OAAO,kBAAkB;IACZ,MAAM,GAAG,MAAM,CAA4B,IAAI;+EAAC,CAAC;IAElE,OAAO;QACL,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;QAClB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,MAAM,2BAA2B,EAAE,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,MAAM,+BAA+B,EAAE,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;uGApBU,kBAAkB;2GAAlB,kBAAkB,cADL,MAAM;;2FACnB,kBAAkB;kBAD9B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/angular/services/permissions.service/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,4FAA4F;AAC5F,yFAAyF;AACzF,+BAA+B;AAC/B,EAAE;AACF,4DAA4D;AAC5D,yCAAyC;AACzC,EAAE;AACF,gGAAgG;AAChG,kGAAkG;AAClG,mGAAmG;AACnG,wCAAwC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AAChE,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,GAEhC,MAAM,eAAe,CAAC;;AAGvB,MAAM,OAAO,kBAAkB;IACZ,MAAM,GAAG,MAAM,CAA4B,IAAI;+EAAC,CAAC;IACjD,UAAU,GAAG,MAAM,CAAe,IAAI;mFAAC,CAAC;IACjD,kBAAkB,GAAG,KAAK,CAAC;IAEnC,gGAAgG;IACvF,KAAK,GAAyB,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;IAEpE,OAAO;QACL,wFAAwF;QACxF,8FAA8F;QAC9F,8FAA8F;QAC9F,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;YAC/B,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CACjB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,MAAM,2BAA2B,EAAE,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,MAAM,+BAA+B,EAAE,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;uGAnCU,kBAAkB;2GAAlB,kBAAkB,cADL,MAAM;;2FACnB,kBAAkB;kBAD9B,UAAU;mBAAC,EAAE,UAAU,EAAE,MAAM,EAAE"}

package/build-ngc/core/native-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,sCAAsC,GAAG,0BAA0B,CAAC;AAe1E,MAAM,CAAC,MAAM,wBAAwB,GAAG,mBAAmB,CACzD,sCAAsC,CACvC,CAAC"}
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,sCAAsC,GAAG,0BAA0B,CAAC;AAe1E,MAAM,CAAC,MAAM,wBAAwB,GACnC,mBAAmB,CACjB,sCAAsC,CACvC,CAAC"}

package/build-ngc/core/tracking-transparency.js

@@ -5,7 +5,7 @@
 // NOT ported here — that helper is React-only (built on useState/useEffect), and this repo's
 // 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 { Platform, PermissionStatus, UnavailabilityError, } from 'expo-modules-core';
 import { expoTrackingTransparency } from './native-module';
 const NATIVE_MODULE_NAME = 'TrackingTransparency';
 /**

package/build-ngc/core/tracking-transparency.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracking-transparency.js","sourceRoot":"","sources":["../../src/core/tracking-transparency.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,6FAA6F;AAC7F,wFAAwF;AACxF,8FAA8F;AAC9F,6FAA6F;AAC7F,4FAA4F;AAC5F,8EAA8E;AAC9E,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,aAAa,GAAG,wBAAwB,CAAC,gBAAgB,EAAE,CAAC;IAClE,IAAI,aAAa,KAAK,sCAAsC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,gCAAgC,GAAuB;IAC3D,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE,gBAAgB,CAAC,OAAO;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B;IACnD,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,wBAAwB,CAAC,uBAAuB,EAAE,CAAC;QACtD,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,yBAAyB,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,MAAM,wBAAwB,CAAC,uBAAuB,EAAE,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B;IAC/C,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,wBAAwB,CAAC,mBAAmB,EAAE,CAAC;QAClD,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,MAAM,wBAAwB,CAAC,mBAAmB,EAAE,CAAC;AAC9D,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"tracking-transparency.js","sourceRoot":"","sources":["../../src/core/tracking-transparency.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,6FAA6F;AAC7F,wFAAwF;AACxF,8FAA8F;AAC9F,6FAA6F;AAC7F,4FAA4F;AAC5F,8EAA8E;AAC9E,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAElD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,aAAa,GAAG,wBAAwB,CAAC,gBAAgB,EAAE,CAAC;IAClE,IAAI,aAAa,KAAK,sCAAsC,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,gCAAgC,GAAuB;IAC3D,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,IAAI;IACjB,MAAM,EAAE,gBAAgB,CAAC,OAAO;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B;IACnD,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,wBAAwB,CAAC,uBAAuB,EAAE,CAAC;QACtD,MAAM,IAAI,mBAAmB,CAC3B,kBAAkB,EAClB,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,wBAAwB,CAAC,uBAAuB,EAAE,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B;IAC/C,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,wBAAwB,CAAC,mBAAmB,EAAE,CAAC;QAClD,MAAM,IAAI,mBAAmB,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,MAAM,wBAAwB,CAAC,mBAAmB,EAAE,CAAC;AAC9D,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAC3C,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@symbiote-native/tracking-transparency",
-  "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.",
+  "version": "0.3.0",
+  "description": "expo-tracking-transparency wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. iOS App Tracking Transparency prompt (permission get/request, always-granted on Android/web) plus the advertising-ID getter.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -30,6 +30,14 @@
       "types": "./build/react/index.d.ts",
       "default": "./build/react/index.js"
     },
+    "./svelte": {
+      "types": "./build/svelte/index.d.ts",
+      "default": "./build/svelte/index.js"
+    },
+    "./solid": {
+      "types": "./build/solid/index.d.ts",
+      "default": "./build/solid/index.js"
+    },
     "./angular": {
       "types": "./build-ngc/angular/index.d.ts",
       "react-native": "./build-ngc/angular/index.js",
@@ -53,15 +61,19 @@
     "expo-modules-core": "57.0.5"
   },
   "peerDependencies": {
+    "@symbiote-native/angular": ">=0.6.2",
     "@symbiote-native/engine": ">=0.1.7",
+    "@symbiote-native/react": ">=0.2.8",
+    "@symbiote-native/solid": ">=0.0.1",
+    "@symbiote-native/svelte": ">=0.1.0",
+    "@symbiote-native/vue": ">=0.3.8",
     "@angular/core": ">=20",
     "@vue/runtime-core": "^3.5.13",
     "react": ">=19.0.0",
     "react-native": ">=0.86",
-    "vue": ">=3.5.0",
-    "@symbiote-native/angular": "0.6.2",
-    "@symbiote-native/react": "0.2.8",
-    "@symbiote-native/vue": "0.3.8"
+    "solid-js": ">=1.9.0",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0"
   },
   "peerDependenciesMeta": {
     "@symbiote-native/angular": {
@@ -70,6 +82,12 @@
     "@symbiote-native/react": {
       "optional": true
     },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
     "@symbiote-native/vue": {
       "optional": true
     },
@@ -82,24 +100,34 @@
     "react": {
       "optional": true
     },
+    "solid-js": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
     "vue": {
       "optional": true
     }
   },
   "devDependencies": {
-    "@angular/compiler": "^22",
-    "@angular/compiler-cli": "^22",
-    "@angular/core": "^22",
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@angular/core": "~22.0.8",
     "@types/node": "^26.0.0",
     "@types/react": "^19.2.0",
     "@vue/runtime-core": "^3.5.13",
     "react": "19.2.3",
+    "solid-js": "^1.9.14",
+    "svelte": "^5.56.0",
     "typescript": "~6.0.0",
-    "@symbiote-native/angular": "0.6.2",
-    "@symbiote-native/engine": "0.1.7",
-    "@symbiote-native/react": "0.2.8",
-    "@symbiote-native/test-utils": "0.1.6",
-    "@symbiote-native/vue": "0.3.8"
+    "@symbiote-native/engine": "0.3.0",
+    "@symbiote-native/react": "0.4.0",
+    "@symbiote-native/angular": "0.8.0",
+    "@symbiote-native/solid": "0.1.0",
+    "@symbiote-native/svelte": "0.3.0",
+    "@symbiote-native/test-utils": "0.2.0",
+    "@symbiote-native/vue": "0.5.0"
   },
   "scripts": {
     "typecheck": "tsc --build",

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

@@ -5,6 +5,11 @@
 //
 //   readonly status = inject(PermissionsService).connect();
 //   // template: {{ status()?.granted }}
+//
+// The auto-fetch has nobody to reject to, so its failure lands in the `error` signal instead of
+// escaping as an unhandled rejection: a null status with a non-null error is how a consumer tells
+// "the fetch failed" from "not fetched yet". get()/request() still reject to their direct caller —
+// only the automatic call is made safe.
 import { Injectable, signal, type Signal } from '@angular/core';
 import {
   getTrackingPermissionsAsync,
@@ -15,10 +20,23 @@ import {
 @Injectable({ providedIn: 'root' })
 export class PermissionsService {
   private readonly status = signal<PermissionResponse | null>(null);
+  private readonly fetchError = signal<Error | null>(null);
+  private isAutoFetchStarted = false;
+
+  /** Why the auto-fetch left `status` at null. Cleared by the next successful get()/request(). */
+  readonly error: Signal<Error | null> = this.fetchError.asReadonly();
 
   connect(): Signal<PermissionResponse | null> {
-    if (this.status() === null) {
-      void this.get();
+    // Latched rather than guarded on `status() === null`: a failed fetch leaves status null
+    // forever, so the old guard turned every later connect() into another native call — unbounded
+    // once connect() is reached from a change-detected expression instead of a field initializer.
+    if (!this.isAutoFetchStarted) {
+      this.isAutoFetchStarted = true;
+      this.get().catch((cause: unknown) => {
+        this.fetchError.set(
+          cause instanceof Error ? cause : new Error(String(cause)),
+        );
+      });
     }
     return this.status.asReadonly();
   }
@@ -26,12 +44,14 @@ export class PermissionsService {
   async get(): Promise<PermissionResponse> {
     const response = await getTrackingPermissionsAsync();
     this.status.set(response);
+    this.fetchError.set(null);
     return response;
   }
 
   async request(): Promise<PermissionResponse> {
     const response = await requestTrackingPermissionsAsync();
     this.status.set(response);
+    this.fetchError.set(null);
     return response;
   }
 }

package/src/core/native-module.ts

@@ -16,6 +16,7 @@ export type INativeTrackingTransparencyModule = {
   getPermissionsAsync?(): Promise<PermissionResponse>;
 };
 
-export const expoTrackingTransparency = requireNativeModule<INativeTrackingTransparencyModule>(
-  EXPO_TRACKING_TRANSPARENCY_MODULE_NAME,
-);
+export const expoTrackingTransparency =
+  requireNativeModule<INativeTrackingTransparencyModule>(
+    EXPO_TRACKING_TRANSPARENCY_MODULE_NAME,
+  );

package/src/core/tracking-transparency.ts

@@ -5,7 +5,11 @@
 // NOT ported here — that helper is React-only (built on useState/useEffect), and this repo's
 // 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 {
+  Platform,
+  PermissionStatus,
+  UnavailabilityError,
+} from 'expo-modules-core';
 import type { PermissionResponse } from 'expo-modules-core';
 
 import { expoTrackingTransparency } from './native-module';
@@ -41,7 +45,10 @@ export async function requestTrackingPermissionsAsync(): Promise<PermissionRespo
     return Promise.resolve(androidAndWebPermissionsResponse);
   }
   if (!expoTrackingTransparency.requestPermissionsAsync) {
-    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'requestPermissionsAsync');
+    throw new UnavailabilityError(
+      NATIVE_MODULE_NAME,
+      'requestPermissionsAsync',
+    );
   }
   return await expoTrackingTransparency.requestPermissionsAsync();
 }

package/src/react/hooks/use-permissions/index.ts

@@ -2,6 +2,11 @@
 // auto-fetches the current permission status on mount, then exposes get/request as imperative
 // callbacks. Mirrors the shape @symbiote-native/cellular's own usePermissions ships in parallel,
 // so both stay byte-for-byte consistent.
+//
+// The mount fetch has nobody to reject to, so its failure lands in the 4th tuple slot (`error`)
+// instead of escaping as an unhandled rejection: a null status with a non-null error is how a
+// consumer tells "the fetch failed" from "not fetched yet". get()/request() still reject to their
+// direct caller — only the automatic call is made safe.
 import { useCallback, useEffect, useRef, useState } from 'react';
 import {
   getTrackingPermissionsAsync,
@@ -13,29 +18,40 @@ export function usePermissions(): [
   PermissionResponse | null,
   () => Promise<PermissionResponse>,
   () => Promise<PermissionResponse>,
+  Error | null,
 ] {
   const isMounted = useRef(true);
   const [status, setStatus] = useState<PermissionResponse | null>(null);
+  const [error, setError] = useState<Error | null>(null);
 
   const getPermission = useCallback(async () => {
     const response = await getTrackingPermissionsAsync();
-    if (isMounted.current) setStatus(response);
+    if (isMounted.current) {
+      setStatus(response);
+      setError(null);
+    }
     return response;
   }, []);
 
   const requestPermission = useCallback(async () => {
     const response = await requestTrackingPermissionsAsync();
-    if (isMounted.current) setStatus(response);
+    if (isMounted.current) {
+      setStatus(response);
+      setError(null);
+    }
     return response;
   }, []);
 
   useEffect(() => {
     isMounted.current = true;
-    void getPermission();
+    getPermission().catch((cause: unknown) => {
+      if (isMounted.current)
+        setError(cause instanceof Error ? cause : new Error(String(cause)));
+    });
     return () => {
       isMounted.current = false;
     };
   }, [getPermission]);
 
-  return [status, requestPermission, getPermission];
+  return [status, requestPermission, getPermission, error];
 }

package/src/solid/index.ts

@@ -0,0 +1,8 @@
+// @symbiote-native/tracking-transparency/solid: the Solid entry over the framework-agnostic core.
+// Same reasoning as the React, Vue and Svelte entries — only the permission surface gets a
+// lifecycle primitive, every other export is a plain re-export — mirrors the lifecycle-bucket
+// naming convention of adapters/solid/src/primitives (never `hooks/`/`composables/`/`runes/`,
+// those are React's, Vue's and Svelte's terms).
+
+export { createPermissions } from './primitives/create-permissions';
+export * from '../core';

package/src/solid/primitives/create-permissions.ts

@@ -0,0 +1,56 @@
+// createPermissions — the Solid twin of React's `usePermissions` hook, Vue's composable and
+// Svelte's rune, over the framework-agnostic core (core/tracking-transparency.ts). Auto-fetches
+// the current permission status, then exposes get/request as imperative callbacks.
+//
+// `primitives/` and `create*`, never `hooks/`+`use*`: Solid's ecosystem calls a composable
+// reactive function a PRIMITIVE and reserves `use*` for consuming something that already exists.
+// Full rationale in adapters/solid/src/primitives/create-color-scheme.ts.
+//
+// Returns ACCESSORS, never snapshots: a Solid component body runs ONCE, so returned values would
+// pin the caller to the null pre-fetch state forever.
+//
+// The auto-fetch fires from the primitive body rather than a mount effect — the shape
+// `createResource` uses, and the reason this primitive needs no lifecycle hook at all. Its failure
+// lands in `error` instead of escaping as an unhandled rejection: a null status with a non-null
+// error is how a consumer tells "the fetch failed" from "not fetched yet". get()/request() still
+// reject to their direct caller — only the automatic call is made safe.
+//
+// No isMounted guard around the late write, unlike React's hook: once the owning root is disposed
+// nothing is subscribed to these signals any more, so a resolution arriving afterwards is inert.
+
+import { createSignal, type Accessor } from 'solid-js';
+import {
+  getTrackingPermissionsAsync,
+  requestTrackingPermissionsAsync,
+  type PermissionResponse,
+} from '../../core';
+
+export function createPermissions(): {
+  status: Accessor<PermissionResponse | null>;
+  error: Accessor<Error | null>;
+  request: () => Promise<PermissionResponse>;
+  get: () => Promise<PermissionResponse>;
+} {
+  const [status, setStatus] = createSignal<PermissionResponse | null>(null);
+  const [error, setError] = createSignal<Error | null>(null);
+
+  const get = async (): Promise<PermissionResponse> => {
+    const response = await getTrackingPermissionsAsync();
+    setStatus(response);
+    setError(null);
+    return response;
+  };
+
+  const request = async (): Promise<PermissionResponse> => {
+    const response = await requestTrackingPermissionsAsync();
+    setStatus(response);
+    setError(null);
+    return response;
+  };
+
+  get().catch((cause: unknown) => {
+    setError(cause instanceof Error ? cause : new Error(String(cause)));
+  });
+
+  return { status, error, request, get };
+}

package/src/svelte/index.ts

@@ -0,0 +1,7 @@
+// @symbiote-native/tracking-transparency/svelte: the Svelte entry over the framework-agnostic core.
+// Same reasoning as the React and Vue entries — only the permission surface gets a lifecycle rune,
+// every other export is a plain re-export — mirrors the lifecycle-bucket naming convention of
+// adapters/svelte/src/runes (never `hooks/`/`composables/`, those are React's and Vue's terms).
+
+export { usePermissions } from './runes/use-permissions.svelte';
+export * from '../core';

package/src/svelte/runes/use-permissions.svelte.ts

@@ -0,0 +1,63 @@
+// Svelte lifecycle wiring over the framework-agnostic core (core/tracking-transparency.ts) —
+// auto-fetches the current permission status on mount, then exposes get/request as imperative
+// callbacks. Just a one-shot get with no ongoing subscription, so `$effect` needs no cleanup.
+//
+// `.svelte.ts` (not `.ts`): runes ($state/$effect) only work in files with this extension
+// outside an actual `.svelte` component. `status` is returned as a getter, NOT a bare
+// `$state`: Svelte 5 reactivity is lexically scoped to the declaring module and doesn't
+// survive being returned as a raw value from a plain function — mirrors how Vue's `Ref`
+// needs `.value` to unwrap.
+//
+// The mount fetch has nobody to reject to, so its failure lands in `error` (a second boxed getter,
+// same reason as `status`) instead of escaping as an unhandled rejection: a null status with a
+// non-null error is how a consumer tells "the fetch failed" from "not fetched yet".
+// get()/request() still reject to their direct caller — only the automatic call is made safe.
+import {
+  getTrackingPermissionsAsync,
+  requestTrackingPermissionsAsync,
+  type PermissionResponse,
+} from '../../core';
+
+export function usePermissions(): {
+  readonly status: PermissionResponse | null;
+  readonly error: Error | null;
+  request: () => Promise<PermissionResponse>;
+  get: () => Promise<PermissionResponse>;
+} {
+  let status = $state<PermissionResponse | null>(null);
+  let error = $state<Error | null>(null);
+
+  const get = async (): Promise<PermissionResponse> => {
+    const response = await getTrackingPermissionsAsync();
+    status = response;
+    error = null;
+    return response;
+  };
+
+  const request = async (): Promise<PermissionResponse> => {
+    const response = await requestTrackingPermissionsAsync();
+    status = response;
+    error = null;
+    return response;
+  };
+
+  $effect(() => {
+    // `get` is a plain closure, not reactive state, so the effect has an empty dependency set and
+    // runs exactly once on mount — the twin of Vue's onMounted. The catch runs after the effect
+    // has settled, so writing `error` there adds no dependency and does not re-arm it.
+    get().catch((cause: unknown) => {
+      error = cause instanceof Error ? cause : new Error(String(cause));
+    });
+  });
+
+  return {
+    get status(): PermissionResponse | null {
+      return status;
+    },
+    get error(): Error | null {
+      return error;
+    },
+    request,
+    get,
+  };
+}

package/src/svelte/svelte-ambient.d.ts

@@ -0,0 +1,6 @@
+// Pulls in svelte's ambient global declarations ($state/$effect/...) for this package's tsc
+// program. adapters/svelte gets these for free because render.ts does a real value import from
+// 'svelte' (any file in a program importing a module loads its ambient globals for the whole
+// program); this package has no such import, so a triple-slash reference does the same job
+// explicitly rather than relying on an incidental side-effect.
+/// <reference types="svelte" />

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

@@ -2,6 +2,11 @@
 // auto-fetches the current permission status on mount (mirrors use-battery-level's
 // 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.
+//
+// The mount fetch has nobody to reject to, so its failure lands in the `error` ref instead of
+// escaping as an unhandled rejection: a null status with a non-null error is how a consumer tells
+// "the fetch failed" from "not fetched yet". get()/request() still reject to their direct caller —
+// only the automatic call is made safe.
 import { onMounted, ref, type Ref } from '@vue/runtime-core';
 import {
   getTrackingPermissionsAsync,
@@ -11,26 +16,32 @@ import {
 
 export function usePermissions(): {
   status: Ref<PermissionResponse | null>;
+  error: Ref<Error | null>;
   request: () => Promise<PermissionResponse>;
   get: () => Promise<PermissionResponse>;
 } {
   const status = ref<PermissionResponse | null>(null);
+  const error = ref<Error | null>(null);
 
   const get = async () => {
     const response = await getTrackingPermissionsAsync();
     status.value = response;
+    error.value = null;
     return response;
   };
 
   const request = async () => {
     const response = await requestTrackingPermissionsAsync();
     status.value = response;
+    error.value = null;
     return response;
   };
 
   onMounted(() => {
-    void get();
+    get().catch((cause: unknown) => {
+      error.value = cause instanceof Error ? cause : new Error(String(cause));
+    });
   });
 
-  return { status, request, get };
+  return { status, error, request, get };
 }