@symbiote-native/tracking-transparency 0.2.0 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -25
- package/build/core/tracking-transparency.js +1 -1
- package/build/solid/index.d.ts +2 -0
- package/build/solid/index.js +7 -0
- package/build/solid/primitives/create-permissions.d.ts +8 -0
- package/build/solid/primitives/create-permissions.js +41 -0
- package/build-ngc/angular/services/permissions.service/index.js.map +1 -1
- package/build-ngc/core/native-module.js.map +1 -1
- package/build-ngc/core/tracking-transparency.js +1 -1
- package/build-ngc/core/tracking-transparency.js.map +1 -1
- package/package.json +22 -8
- package/src/angular/services/permissions.service/index.ts +3 -1
- package/src/core/native-module.ts +4 -3
- package/src/core/tracking-transparency.ts +9 -2
- package/src/react/hooks/use-permissions/index.ts +2 -1
- package/src/solid/index.ts +8 -0
- package/src/solid/primitives/create-permissions.ts +56 -0
package/README.md
CHANGED
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
A wrapper package for [SymbioteNative](../../README.md) that makes
|
|
4
4
|
[`expo-tracking-transparency`](https://github.com/expo/expo/tree/main/packages/expo-tracking-transparency)
|
|
5
5
|
— the iOS App Tracking Transparency prompt, permission get/request, and the advertising-ID getter
|
|
6
|
-
— usable from **every** adapter, React, Vue, and Angular, not just React. Like
|
|
6
|
+
— usable from **every** adapter, React, Vue, Svelte, Solid, and Angular, not just React. Like
|
|
7
7
|
[`@symbiote-native/brightness`](../brightness), this package's surface is mostly stateless free
|
|
8
|
-
async functions; only the permission surface gets its own lifecycle
|
|
8
|
+
async functions; only the permission surface gets its own per-adapter lifecycle wrapper,
|
|
9
9
|
mirroring upstream's own `usePermissions`. Built the same way as
|
|
10
10
|
[`@symbiote-native/local-auth`](../local-auth), [`@symbiote-native/battery`](../battery), and
|
|
11
11
|
[`@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
|
|
|
34
34
|
this repo use — this needs wiring into the native host app **once**, covering this package and
|
|
35
35
|
every other `expo-modules-core` package with zero further changes:
|
|
36
36
|
|
|
37
|
-
| Platform | Touches
|
|
38
|
-
|
|
39
|
-
| iOS
|
|
40
|
-
| iOS
|
|
41
|
-
| iOS
|
|
42
|
-
| Android
|
|
43
|
-
| Android
|
|
37
|
+
| Platform | Touches |
|
|
38
|
+
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
39
|
+
| iOS | `ios/Podfile` — add `use_expo_modules!` |
|
|
40
|
+
| iOS | `AppDelegate.swift` — Expo's runtime-bootstrap hook |
|
|
41
|
+
| iOS | `Info.plist` — `NSUserTrackingUsageDescription`, required to show the ATT prompt |
|
|
42
|
+
| Android | `settings.gradle` / `app/build.gradle` — resolve and include the Expo Gradle projects |
|
|
43
|
+
| 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) |
|
|
44
44
|
|
|
45
45
|
Full mechanics — the Podfile pieces that normally ship inside the `expo` package, the `expo`
|
|
46
46
|
peer-dependency exclusion list — live in the `symbiote-expo-native-module` skill. The Android
|
|
@@ -56,13 +56,16 @@ src/core/ getAdvertisingId, get/requestTrackingPermissionsAsync,
|
|
|
56
56
|
expo-modules-core's requireNativeModule.
|
|
57
57
|
src/react/hooks/ @symbiote-native/tracking-transparency/react — usePermissions
|
|
58
58
|
src/vue/composables/ @symbiote-native/tracking-transparency/vue — usePermissions (same name)
|
|
59
|
+
src/svelte/runes/ @symbiote-native/tracking-transparency/svelte — usePermissions (same name)
|
|
60
|
+
src/solid/primitives/ @symbiote-native/tracking-transparency/solid — createPermissions
|
|
61
|
+
(Solid reserves `use*` for consuming existing state)
|
|
59
62
|
src/angular/services/ @symbiote-native/tracking-transparency/angular — PermissionsService
|
|
60
63
|
```
|
|
61
64
|
|
|
62
|
-
Each adapter's
|
|
63
|
-
`requestTrackingPermissionsAsync` pair in its own lifecycle idiom (auto-fetch
|
|
64
|
-
a tuple/object/signal). `getAdvertisingId`/`isAvailable` are stateless
|
|
65
|
-
written once in `core/` and shared verbatim by
|
|
65
|
+
Each adapter's wrapper puts the same one-shot `getTrackingPermissionsAsync`/
|
|
66
|
+
`requestTrackingPermissionsAsync` pair in its own lifecycle idiom (auto-fetch when the wrapper is
|
|
67
|
+
created, exposed as a tuple/object/signal/accessor). `getAdvertisingId`/`isAvailable` are stateless
|
|
68
|
+
free-function re-exports, written once in `core/` and shared verbatim by every adapter.
|
|
66
69
|
|
|
67
70
|
Upstream's own `createPermissionHook`/`useTrackingPermissions` is **not** ported — that helper is
|
|
68
71
|
React-only (built on `useState`/`useEffect`), and this repo's convention is for each adapter to
|
|
@@ -98,7 +101,8 @@ function TrackingScreen() {
|
|
|
98
101
|
import { usePermissions } from '@symbiote-native/tracking-transparency/vue';
|
|
99
102
|
import { getAdvertisingId } from '@symbiote-native/tracking-transparency';
|
|
100
103
|
|
|
101
|
-
const { status: permissionStatus, request: requestPermission } =
|
|
104
|
+
const { status: permissionStatus, request: requestPermission } =
|
|
105
|
+
usePermissions();
|
|
102
106
|
</script>
|
|
103
107
|
|
|
104
108
|
<template>
|
|
@@ -117,7 +121,10 @@ const { status: permissionStatus, request: requestPermission } = usePermissions(
|
|
|
117
121
|
```ts
|
|
118
122
|
// Angular
|
|
119
123
|
import { Component, inject } from '@angular/core';
|
|
120
|
-
import {
|
|
124
|
+
import {
|
|
125
|
+
PermissionsService,
|
|
126
|
+
getAdvertisingId,
|
|
127
|
+
} from '@symbiote-native/tracking-transparency/angular';
|
|
121
128
|
|
|
122
129
|
@Component({
|
|
123
130
|
selector: 'TrackingScreen',
|
|
@@ -128,7 +135,9 @@ import { PermissionsService, getAdvertisingId } from '@symbiote-native/tracking-
|
|
|
128
135
|
<Pressable (press)="permissionsService.request()">
|
|
129
136
|
<Text>Request tracking permission</Text>
|
|
130
137
|
</Pressable>
|
|
131
|
-
<Pressable (press)="logAdvertisingId()"
|
|
138
|
+
<Pressable (press)="logAdvertisingId()"
|
|
139
|
+
><Text>Log advertising ID</Text></Pressable
|
|
140
|
+
>
|
|
132
141
|
</View>
|
|
133
142
|
`,
|
|
134
143
|
})
|
|
@@ -142,7 +151,30 @@ export class TrackingScreen {
|
|
|
142
151
|
}
|
|
143
152
|
```
|
|
144
153
|
|
|
145
|
-
|
|
154
|
+
```tsx
|
|
155
|
+
// Solid — the accessors are CALLED; a Solid component body runs once, so a snapshot would freeze.
|
|
156
|
+
import { createPermissions } from '@symbiote-native/tracking-transparency/solid';
|
|
157
|
+
import { getAdvertisingId } from '@symbiote-native/tracking-transparency';
|
|
158
|
+
|
|
159
|
+
function TrackingScreen() {
|
|
160
|
+
const { status: permissionStatus, request: requestPermission } =
|
|
161
|
+
createPermissions();
|
|
162
|
+
|
|
163
|
+
return (
|
|
164
|
+
<View>
|
|
165
|
+
<Text>{permissionStatus()?.status ?? 'checking…'}</Text>
|
|
166
|
+
<Pressable onPress={() => void requestPermission()}>
|
|
167
|
+
<Text>Request tracking permission</Text>
|
|
168
|
+
</Pressable>
|
|
169
|
+
<Pressable onPress={() => console.log(getAdvertisingId())}>
|
|
170
|
+
<Text>Log advertising ID</Text>
|
|
171
|
+
</Pressable>
|
|
172
|
+
</View>
|
|
173
|
+
);
|
|
174
|
+
}
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
The examples above mirror the real canary demo screens —
|
|
146
178
|
`examples/expo-react/screens/TrackingTransparencyScreen.tsx`,
|
|
147
179
|
`examples/expo-vue-sfc/screens/TrackingTransparencyScreen.vue`,
|
|
148
180
|
`examples/expo-vue-tsx/screens/TrackingTransparencyScreen.tsx`,
|
|
@@ -168,26 +200,35 @@ Plus `PermissionStatus`/`PermissionResponse`/`PermissionExpiration`/`PermissionH
|
|
|
168
200
|
re-exported verbatim from `expo-modules-core`, never the `expo` meta-package.
|
|
169
201
|
|
|
170
202
|
```ts
|
|
171
|
-
import {
|
|
203
|
+
import {
|
|
204
|
+
getAdvertisingId,
|
|
205
|
+
getTrackingPermissionsAsync,
|
|
206
|
+
} from '@symbiote-native/tracking-transparency';
|
|
172
207
|
|
|
173
|
-
// framework-scoped entry points re-export the same free functions, plus a
|
|
174
|
-
//
|
|
208
|
+
// framework-scoped entry points re-export the same free functions, plus a per-adapter
|
|
209
|
+
// permission wrapper:
|
|
175
210
|
import { usePermissions } from '@symbiote-native/tracking-transparency/react';
|
|
176
211
|
import { usePermissions } from '@symbiote-native/tracking-transparency/vue';
|
|
212
|
+
import { usePermissions } from '@symbiote-native/tracking-transparency/svelte';
|
|
213
|
+
import { createPermissions } from '@symbiote-native/tracking-transparency/solid';
|
|
177
214
|
import { PermissionsService } from '@symbiote-native/tracking-transparency/angular';
|
|
178
215
|
```
|
|
179
216
|
|
|
180
|
-
`usePermissions`
|
|
181
|
-
`[status, request, get]` tuple (React) / `{ status, request, get }` object
|
|
182
|
-
|
|
217
|
+
`usePermissions` auto-fetches the current permission status on mount and returns a
|
|
218
|
+
`[status, request, get, error]` tuple (React) / `{ status, error, request, get }` object
|
|
219
|
+
(Vue/Svelte); Solid's `createPermissions` returns the same object with `Accessor`s instead of
|
|
220
|
+
`Ref`s, and Angular's `PermissionsService.connect()` returns a readonly `Signal`:
|
|
183
221
|
|
|
184
222
|
```ts
|
|
185
223
|
// React
|
|
186
224
|
const [status, request] = usePermissions();
|
|
187
225
|
|
|
188
|
-
// Vue
|
|
226
|
+
// Vue / Svelte
|
|
189
227
|
const { status, request } = usePermissions();
|
|
190
228
|
|
|
229
|
+
// Solid — status is an accessor, called at the read site
|
|
230
|
+
const { status, request } = createPermissions();
|
|
231
|
+
|
|
191
232
|
// Angular
|
|
192
233
|
readonly status = inject(PermissionsService).connect();
|
|
193
234
|
```
|
|
@@ -204,7 +245,7 @@ readonly status = inject(PermissionsService).connect();
|
|
|
204
245
|
|
|
205
246
|
No Fabric/Descriptor angle at all — tracking-transparency is a pure async-function + permission
|
|
206
247
|
surface, never a view. Tests inject a fake native-module object in place of the real
|
|
207
|
-
`requireNativeModule` resolution (`src/core/*.test.ts`, `src/{react,vue,angular}/**/*.test.{ts,tsx}`,
|
|
248
|
+
`requireNativeModule` resolution (`src/core/*.test.ts`, `src/{react,vue,svelte,solid,angular}/**/*.test.{ts,tsx}`,
|
|
208
249
|
`vitest`), the same pattern `expo-tracking-transparency` itself uses upstream — no
|
|
209
250
|
`installFabric()` for the core layer, no ViewConfig. Native rendering itself is verified on-device
|
|
210
251
|
(see the parent [README](../../README.md) for the project's testing model).
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
// NOT ported here — that helper is React-only (built on useState/useEffect), and this repo's
|
|
6
6
|
// convention is for each adapter to hand-roll its own permission hook instead (react/hooks,
|
|
7
7
|
// vue/composables, angular/services), same as brightness/cellular already do.
|
|
8
|
-
import { Platform, PermissionStatus, UnavailabilityError } from 'expo-modules-core';
|
|
8
|
+
import { Platform, PermissionStatus, UnavailabilityError, } from 'expo-modules-core';
|
|
9
9
|
import { expoTrackingTransparency } from './native-module.js';
|
|
10
10
|
const NATIVE_MODULE_NAME = 'TrackingTransparency';
|
|
11
11
|
/**
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
// @symbiote-native/tracking-transparency/solid: the Solid entry over the framework-agnostic core.
|
|
2
|
+
// Same reasoning as the React, Vue and Svelte entries — only the permission surface gets a
|
|
3
|
+
// lifecycle primitive, every other export is a plain re-export — mirrors the lifecycle-bucket
|
|
4
|
+
// naming convention of adapters/solid/src/primitives (never `hooks/`/`composables/`/`runes/`,
|
|
5
|
+
// those are React's, Vue's and Svelte's terms).
|
|
6
|
+
export { createPermissions } from './primitives/create-permissions.js';
|
|
7
|
+
export * from '../core/index.js';
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { type Accessor } from 'solid-js';
|
|
2
|
+
import { type PermissionResponse } from '../../core';
|
|
3
|
+
export declare function createPermissions(): {
|
|
4
|
+
status: Accessor<PermissionResponse | null>;
|
|
5
|
+
error: Accessor<Error | null>;
|
|
6
|
+
request: () => Promise<PermissionResponse>;
|
|
7
|
+
get: () => Promise<PermissionResponse>;
|
|
8
|
+
};
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
// createPermissions — the Solid twin of React's `usePermissions` hook, Vue's composable and
|
|
2
|
+
// Svelte's rune, over the framework-agnostic core (core/tracking-transparency.ts). Auto-fetches
|
|
3
|
+
// the current permission status, then exposes get/request as imperative callbacks.
|
|
4
|
+
//
|
|
5
|
+
// `primitives/` and `create*`, never `hooks/`+`use*`: Solid's ecosystem calls a composable
|
|
6
|
+
// reactive function a PRIMITIVE and reserves `use*` for consuming something that already exists.
|
|
7
|
+
// Full rationale in adapters/solid/src/primitives/create-color-scheme.ts.
|
|
8
|
+
//
|
|
9
|
+
// Returns ACCESSORS, never snapshots: a Solid component body runs ONCE, so returned values would
|
|
10
|
+
// pin the caller to the null pre-fetch state forever.
|
|
11
|
+
//
|
|
12
|
+
// The auto-fetch fires from the primitive body rather than a mount effect — the shape
|
|
13
|
+
// `createResource` uses, and the reason this primitive needs no lifecycle hook at all. Its failure
|
|
14
|
+
// lands in `error` instead of escaping as an unhandled rejection: a null status with a non-null
|
|
15
|
+
// error is how a consumer tells "the fetch failed" from "not fetched yet". get()/request() still
|
|
16
|
+
// reject to their direct caller — only the automatic call is made safe.
|
|
17
|
+
//
|
|
18
|
+
// No isMounted guard around the late write, unlike React's hook: once the owning root is disposed
|
|
19
|
+
// nothing is subscribed to these signals any more, so a resolution arriving afterwards is inert.
|
|
20
|
+
import { createSignal } from 'solid-js';
|
|
21
|
+
import { getTrackingPermissionsAsync, requestTrackingPermissionsAsync, } from '../../core/index.js';
|
|
22
|
+
export function createPermissions() {
|
|
23
|
+
const [status, setStatus] = createSignal(null);
|
|
24
|
+
const [error, setError] = createSignal(null);
|
|
25
|
+
const get = async () => {
|
|
26
|
+
const response = await getTrackingPermissionsAsync();
|
|
27
|
+
setStatus(response);
|
|
28
|
+
setError(null);
|
|
29
|
+
return response;
|
|
30
|
+
};
|
|
31
|
+
const request = async () => {
|
|
32
|
+
const response = await requestTrackingPermissionsAsync();
|
|
33
|
+
setStatus(response);
|
|
34
|
+
setError(null);
|
|
35
|
+
return response;
|
|
36
|
+
};
|
|
37
|
+
get().catch((cause) => {
|
|
38
|
+
setError(cause instanceof Error ? cause : new Error(String(cause)));
|
|
39
|
+
});
|
|
40
|
+
return { status, error, request, get };
|
|
41
|
+
}
|
|
@@ -1 +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,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,
|
|
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,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"}
|
|
@@ -1 +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,
|
|
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,GACnC,mBAAmB,CACjB,sCAAsC,CACvC,CAAC"}
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
// NOT ported here — that helper is React-only (built on useState/useEffect), and this repo's
|
|
6
6
|
// convention is for each adapter to hand-roll its own permission hook instead (react/hooks,
|
|
7
7
|
// vue/composables, angular/services), same as brightness/cellular already do.
|
|
8
|
-
import { Platform, PermissionStatus, UnavailabilityError } from 'expo-modules-core';
|
|
8
|
+
import { Platform, PermissionStatus, UnavailabilityError, } from 'expo-modules-core';
|
|
9
9
|
import { expoTrackingTransparency } from './native-module';
|
|
10
10
|
const NATIVE_MODULE_NAME = 'TrackingTransparency';
|
|
11
11
|
/**
|
|
@@ -1 +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,
|
|
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,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
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@symbiote-native/tracking-transparency",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"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.",
|
|
3
|
+
"version": "0.3.0",
|
|
4
|
+
"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.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
7
7
|
"type": "git",
|
|
@@ -34,6 +34,10 @@
|
|
|
34
34
|
"types": "./build/svelte/index.d.ts",
|
|
35
35
|
"default": "./build/svelte/index.js"
|
|
36
36
|
},
|
|
37
|
+
"./solid": {
|
|
38
|
+
"types": "./build/solid/index.d.ts",
|
|
39
|
+
"default": "./build/solid/index.js"
|
|
40
|
+
},
|
|
37
41
|
"./angular": {
|
|
38
42
|
"types": "./build-ngc/angular/index.d.ts",
|
|
39
43
|
"react-native": "./build-ngc/angular/index.js",
|
|
@@ -60,12 +64,14 @@
|
|
|
60
64
|
"@symbiote-native/angular": ">=0.6.2",
|
|
61
65
|
"@symbiote-native/engine": ">=0.1.7",
|
|
62
66
|
"@symbiote-native/react": ">=0.2.8",
|
|
67
|
+
"@symbiote-native/solid": ">=0.0.1",
|
|
63
68
|
"@symbiote-native/svelte": ">=0.1.0",
|
|
64
69
|
"@symbiote-native/vue": ">=0.3.8",
|
|
65
70
|
"@angular/core": ">=20",
|
|
66
71
|
"@vue/runtime-core": "^3.5.13",
|
|
67
72
|
"react": ">=19.0.0",
|
|
68
73
|
"react-native": ">=0.86",
|
|
74
|
+
"solid-js": ">=1.9.0",
|
|
69
75
|
"svelte": ">=5.56.0",
|
|
70
76
|
"vue": ">=3.5.0"
|
|
71
77
|
},
|
|
@@ -76,6 +82,9 @@
|
|
|
76
82
|
"@symbiote-native/react": {
|
|
77
83
|
"optional": true
|
|
78
84
|
},
|
|
85
|
+
"@symbiote-native/solid": {
|
|
86
|
+
"optional": true
|
|
87
|
+
},
|
|
79
88
|
"@symbiote-native/svelte": {
|
|
80
89
|
"optional": true
|
|
81
90
|
},
|
|
@@ -91,6 +100,9 @@
|
|
|
91
100
|
"react": {
|
|
92
101
|
"optional": true
|
|
93
102
|
},
|
|
103
|
+
"solid-js": {
|
|
104
|
+
"optional": true
|
|
105
|
+
},
|
|
94
106
|
"svelte": {
|
|
95
107
|
"optional": true
|
|
96
108
|
},
|
|
@@ -106,14 +118,16 @@
|
|
|
106
118
|
"@types/react": "^19.2.0",
|
|
107
119
|
"@vue/runtime-core": "^3.5.13",
|
|
108
120
|
"react": "19.2.3",
|
|
121
|
+
"solid-js": "^1.9.14",
|
|
109
122
|
"svelte": "^5.56.0",
|
|
110
123
|
"typescript": "~6.0.0",
|
|
111
|
-
"@symbiote-native/
|
|
112
|
-
"@symbiote-native/
|
|
113
|
-
"@symbiote-native/
|
|
114
|
-
"@symbiote-native/
|
|
115
|
-
"@symbiote-native/
|
|
116
|
-
"@symbiote-native/
|
|
124
|
+
"@symbiote-native/engine": "0.3.0",
|
|
125
|
+
"@symbiote-native/react": "0.4.0",
|
|
126
|
+
"@symbiote-native/angular": "0.8.0",
|
|
127
|
+
"@symbiote-native/solid": "0.1.0",
|
|
128
|
+
"@symbiote-native/svelte": "0.3.0",
|
|
129
|
+
"@symbiote-native/test-utils": "0.2.0",
|
|
130
|
+
"@symbiote-native/vue": "0.5.0"
|
|
117
131
|
},
|
|
118
132
|
"scripts": {
|
|
119
133
|
"typecheck": "tsc --build",
|
|
@@ -33,7 +33,9 @@ export class PermissionsService {
|
|
|
33
33
|
if (!this.isAutoFetchStarted) {
|
|
34
34
|
this.isAutoFetchStarted = true;
|
|
35
35
|
this.get().catch((cause: unknown) => {
|
|
36
|
-
this.fetchError.set(
|
|
36
|
+
this.fetchError.set(
|
|
37
|
+
cause instanceof Error ? cause : new Error(String(cause)),
|
|
38
|
+
);
|
|
37
39
|
});
|
|
38
40
|
}
|
|
39
41
|
return this.status.asReadonly();
|
|
@@ -16,6 +16,7 @@ export type INativeTrackingTransparencyModule = {
|
|
|
16
16
|
getPermissionsAsync?(): Promise<PermissionResponse>;
|
|
17
17
|
};
|
|
18
18
|
|
|
19
|
-
export const expoTrackingTransparency =
|
|
20
|
-
|
|
21
|
-
|
|
19
|
+
export const expoTrackingTransparency =
|
|
20
|
+
requireNativeModule<INativeTrackingTransparencyModule>(
|
|
21
|
+
EXPO_TRACKING_TRANSPARENCY_MODULE_NAME,
|
|
22
|
+
);
|
|
@@ -5,7 +5,11 @@
|
|
|
5
5
|
// NOT ported here — that helper is React-only (built on useState/useEffect), and this repo's
|
|
6
6
|
// convention is for each adapter to hand-roll its own permission hook instead (react/hooks,
|
|
7
7
|
// vue/composables, angular/services), same as brightness/cellular already do.
|
|
8
|
-
import {
|
|
8
|
+
import {
|
|
9
|
+
Platform,
|
|
10
|
+
PermissionStatus,
|
|
11
|
+
UnavailabilityError,
|
|
12
|
+
} from 'expo-modules-core';
|
|
9
13
|
import type { PermissionResponse } from 'expo-modules-core';
|
|
10
14
|
|
|
11
15
|
import { expoTrackingTransparency } from './native-module';
|
|
@@ -41,7 +45,10 @@ export async function requestTrackingPermissionsAsync(): Promise<PermissionRespo
|
|
|
41
45
|
return Promise.resolve(androidAndWebPermissionsResponse);
|
|
42
46
|
}
|
|
43
47
|
if (!expoTrackingTransparency.requestPermissionsAsync) {
|
|
44
|
-
throw new UnavailabilityError(
|
|
48
|
+
throw new UnavailabilityError(
|
|
49
|
+
NATIVE_MODULE_NAME,
|
|
50
|
+
'requestPermissionsAsync',
|
|
51
|
+
);
|
|
45
52
|
}
|
|
46
53
|
return await expoTrackingTransparency.requestPermissionsAsync();
|
|
47
54
|
}
|
|
@@ -45,7 +45,8 @@ export function usePermissions(): [
|
|
|
45
45
|
useEffect(() => {
|
|
46
46
|
isMounted.current = true;
|
|
47
47
|
getPermission().catch((cause: unknown) => {
|
|
48
|
-
if (isMounted.current)
|
|
48
|
+
if (isMounted.current)
|
|
49
|
+
setError(cause instanceof Error ? cause : new Error(String(cause)));
|
|
49
50
|
});
|
|
50
51
|
return () => {
|
|
51
52
|
isMounted.current = false;
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
// @symbiote-native/tracking-transparency/solid: the Solid entry over the framework-agnostic core.
|
|
2
|
+
// Same reasoning as the React, Vue and Svelte entries — only the permission surface gets a
|
|
3
|
+
// lifecycle primitive, every other export is a plain re-export — mirrors the lifecycle-bucket
|
|
4
|
+
// naming convention of adapters/solid/src/primitives (never `hooks/`/`composables/`/`runes/`,
|
|
5
|
+
// those are React's, Vue's and Svelte's terms).
|
|
6
|
+
|
|
7
|
+
export { createPermissions } from './primitives/create-permissions';
|
|
8
|
+
export * from '../core';
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
// createPermissions — the Solid twin of React's `usePermissions` hook, Vue's composable and
|
|
2
|
+
// Svelte's rune, over the framework-agnostic core (core/tracking-transparency.ts). Auto-fetches
|
|
3
|
+
// the current permission status, then exposes get/request as imperative callbacks.
|
|
4
|
+
//
|
|
5
|
+
// `primitives/` and `create*`, never `hooks/`+`use*`: Solid's ecosystem calls a composable
|
|
6
|
+
// reactive function a PRIMITIVE and reserves `use*` for consuming something that already exists.
|
|
7
|
+
// Full rationale in adapters/solid/src/primitives/create-color-scheme.ts.
|
|
8
|
+
//
|
|
9
|
+
// Returns ACCESSORS, never snapshots: a Solid component body runs ONCE, so returned values would
|
|
10
|
+
// pin the caller to the null pre-fetch state forever.
|
|
11
|
+
//
|
|
12
|
+
// The auto-fetch fires from the primitive body rather than a mount effect — the shape
|
|
13
|
+
// `createResource` uses, and the reason this primitive needs no lifecycle hook at all. Its failure
|
|
14
|
+
// lands in `error` instead of escaping as an unhandled rejection: a null status with a non-null
|
|
15
|
+
// error is how a consumer tells "the fetch failed" from "not fetched yet". get()/request() still
|
|
16
|
+
// reject to their direct caller — only the automatic call is made safe.
|
|
17
|
+
//
|
|
18
|
+
// No isMounted guard around the late write, unlike React's hook: once the owning root is disposed
|
|
19
|
+
// nothing is subscribed to these signals any more, so a resolution arriving afterwards is inert.
|
|
20
|
+
|
|
21
|
+
import { createSignal, type Accessor } from 'solid-js';
|
|
22
|
+
import {
|
|
23
|
+
getTrackingPermissionsAsync,
|
|
24
|
+
requestTrackingPermissionsAsync,
|
|
25
|
+
type PermissionResponse,
|
|
26
|
+
} from '../../core';
|
|
27
|
+
|
|
28
|
+
export function createPermissions(): {
|
|
29
|
+
status: Accessor<PermissionResponse | null>;
|
|
30
|
+
error: Accessor<Error | null>;
|
|
31
|
+
request: () => Promise<PermissionResponse>;
|
|
32
|
+
get: () => Promise<PermissionResponse>;
|
|
33
|
+
} {
|
|
34
|
+
const [status, setStatus] = createSignal<PermissionResponse | null>(null);
|
|
35
|
+
const [error, setError] = createSignal<Error | null>(null);
|
|
36
|
+
|
|
37
|
+
const get = async (): Promise<PermissionResponse> => {
|
|
38
|
+
const response = await getTrackingPermissionsAsync();
|
|
39
|
+
setStatus(response);
|
|
40
|
+
setError(null);
|
|
41
|
+
return response;
|
|
42
|
+
};
|
|
43
|
+
|
|
44
|
+
const request = async (): Promise<PermissionResponse> => {
|
|
45
|
+
const response = await requestTrackingPermissionsAsync();
|
|
46
|
+
setStatus(response);
|
|
47
|
+
setError(null);
|
|
48
|
+
return response;
|
|
49
|
+
};
|
|
50
|
+
|
|
51
|
+
get().catch((cause: unknown) => {
|
|
52
|
+
setError(cause instanceof Error ? cause : new Error(String(cause)));
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
return { status, error, request, get };
|
|
56
|
+
}
|