@ng-native/expo 0.0.1 → 0.1.1

package/dist/tracking.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `Tracking`, bound to `expo-tracking-transparency`: Apple's App Tracking Transparency permission.
+ *
+ * ```ts
+ * private readonly tracking = inject(Tracking);
+ *
+ * async startAnalytics(): Promise<void> {
+ *   const allowed = await this.tracking.permission.ensure();
+ *   this.analytics.start({ advertisingId: allowed ? this.tracking.advertisingId() : null });
+ * }
+ * ```
+ *
+ * iOS 14.5 and later ask before an app may track the user across other companies' apps and
+ * websites, and hand out the advertising identifier only once the user has said yes. The question
+ * is asked once: after an answer, the platform shows no dialog again, so `blocked()` is how an app
+ * knows to offer Settings instead. Android and the web have no such permission, and the module
+ * answers granted there. Without the module installed, the permission is refused and there is no
+ * identifier.
+ */
+import { InjectionToken } from '@angular/core';
+import { Permission } from './permissions.ts';
+import * as i0 from "@angular/core";
+type Expo = typeof import('expo-tracking-transparency');
+/** The module's functions this service calls. The real module is one; a test provides a fake. */
+export type NativeTracking = Pick<Expo, 'getTrackingPermissionsAsync' | 'requestTrackingPermissionsAsync' | 'isAvailable' | 'getAdvertisingId'>;
+export declare class Tracking {
+    /** Overridden in a test to answer a tracking prompt nobody was shown. */
+    static readonly SOURCE: InjectionToken<NativeTracking | null>;
+    private readonly native;
+    /**
+     * The permission to track. `ensure()` shows Apple's dialog only if it has not been answered;
+     * the text in it is `NSUserTrackingUsageDescription`, set through the module's config plugin.
+     */
+    readonly permission: Permission;
+    /** Whether the device has the tracking API. Where it does not, the permission answers granted. */
+    available(): boolean;
+    /**
+     * The advertising identifier: the IDFA on iOS, the advertising ID on Android. Null on iOS until
+     * tracking is allowed, in the simulator, and on Android with ad tracking limited.
+     */
+    advertisingId(): string | null;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Tracking, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+export {};

package/dist/tracking.js

@@ -0,0 +1,54 @@
+/**
+ * `Tracking`, bound to `expo-tracking-transparency`: Apple's App Tracking Transparency permission.
+ *
+ * ```ts
+ * private readonly tracking = inject(Tracking);
+ *
+ * async startAnalytics(): Promise<void> {
+ *   const allowed = await this.tracking.permission.ensure();
+ *   this.analytics.start({ advertisingId: allowed ? this.tracking.advertisingId() : null });
+ * }
+ * ```
+ *
+ * iOS 14.5 and later ask before an app may track the user across other companies' apps and
+ * websites, and hand out the advertising identifier only once the user has said yes. The question
+ * is asked once: after an answer, the platform shows no dialog again, so `blocked()` is how an app
+ * knows to offer Settings instead. Android and the web have no such permission, and the module
+ * answers granted there. Without the module installed, the permission is refused and there is no
+ * identifier.
+ */
+import { InjectionToken, Service, inject } from '@angular/core';
+import { expoModule } from "./native.js";
+import { Permission } from "./permissions.js";
+import * as i0 from "@angular/core";
+/** The permission answer without the module: nothing granted, and nothing to ask. */
+const UNAVAILABLE = { status: 'denied', granted: false, canAskAgain: false };
+export class Tracking {
+    /** Overridden in a test to answer a tracking prompt nobody was shown. */
+    static SOURCE = new InjectionToken('angular-native.trackingSource', {
+        factory: () => expoModule('expo-tracking-transparency', () => require('expo-tracking-transparency')),
+    });
+    native = inject(Tracking.SOURCE);
+    /**
+     * The permission to track. `ensure()` shows Apple's dialog only if it has not been answered;
+     * the text in it is `NSUserTrackingUsageDescription`, set through the module's config plugin.
+     */
+    permission = Permission.of(() => this.native?.getTrackingPermissionsAsync() ?? Promise.resolve(UNAVAILABLE), () => this.native?.requestTrackingPermissionsAsync() ?? Promise.resolve(UNAVAILABLE));
+    /** Whether the device has the tracking API. Where it does not, the permission answers granted. */
+    available() {
+        return this.native?.isAvailable() ?? false;
+    }
+    /**
+     * The advertising identifier: the IDFA on iOS, the advertising ID on Android. Null on iOS until
+     * tracking is allowed, in the simulator, and on Android with ad tracking limited.
+     */
+    advertisingId() {
+        return this.native?.getAdvertisingId() ?? null;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: Tracking, deps: [], target: i0.ɵɵFactoryTarget.Service });
+    static ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.0", ngImport: i0, type: Tracking });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: Tracking, decorators: [{
+            type: Service
+        }] });
+//# sourceMappingURL=tracking.js.map

package/dist/tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.js","sourceRoot":"","sources":["../src/tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAA2B,MAAM,kBAAkB,CAAC;;AAavE,qFAAqF;AACrF,MAAM,WAAW,GAAuB,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAGjG,MAAM,OAAO,QAAQ;IACnB,yEAAyE;IACzE,MAAM,CAAU,MAAM,GAAG,IAAI,cAAc,CACzC,+BAA+B,EAC/B;QACE,OAAO,EAAE,GAAG,EAAE,CACZ,UAAU,CACR,4BAA4B,EAC5B,GAAG,EAAE,CAAC,OAAO,CAAC,4BAA4B,CAAS,CACpD;KACJ,CACF,CAAC;IAEe,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAElD;;;OAGG;IACM,UAAU,GAAe,UAAU,CAAC,EAAE,CAC7C,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,2BAA2B,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAChF,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,+BAA+B,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CACrF,CAAC;IAEF,kGAAkG;IAClG,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,IAAI,CAAC;IACjD,CAAC;uGAnCU,QAAQ;wGAAR,QAAQ;;2FAAR,QAAQ;kBADpB,OAAO","sourcesContent":["/**\n * `Tracking`, bound to `expo-tracking-transparency`: Apple's App Tracking Transparency permission.\n *\n * ```ts\n * private readonly tracking = inject(Tracking);\n *\n * async startAnalytics(): Promise<void> {\n *   const allowed = await this.tracking.permission.ensure();\n *   this.analytics.start({ advertisingId: allowed ? this.tracking.advertisingId() : null });\n * }\n * ```\n *\n * iOS 14.5 and later ask before an app may track the user across other companies' apps and\n * websites, and hand out the advertising identifier only once the user has said yes. The question\n * is asked once: after an answer, the platform shows no dialog again, so `blocked()` is how an app\n * knows to offer Settings instead. Android and the web have no such permission, and the module\n * answers granted there. Without the module installed, the permission is refused and there is no\n * identifier.\n */\nimport { InjectionToken, Service, inject } from '@angular/core';\nimport { expoModule } from './native.ts';\nimport { Permission, type PermissionResponse } from './permissions.ts';\n\ntype Expo = typeof import('expo-tracking-transparency');\n\n/** The module's functions this service calls. The real module is one; a test provides a fake. */\nexport type NativeTracking = Pick<\n  Expo,\n  | 'getTrackingPermissionsAsync'\n  | 'requestTrackingPermissionsAsync'\n  | 'isAvailable'\n  | 'getAdvertisingId'\n>;\n\n/** The permission answer without the module: nothing granted, and nothing to ask. */\nconst UNAVAILABLE: PermissionResponse = { status: 'denied', granted: false, canAskAgain: false };\n\n@Service()\nexport class Tracking {\n  /** Overridden in a test to answer a tracking prompt nobody was shown. */\n  static readonly SOURCE = new InjectionToken<NativeTracking | null>(\n    'angular-native.trackingSource',\n    {\n      factory: () =>\n        expoModule(\n          'expo-tracking-transparency',\n          () => require('expo-tracking-transparency') as Expo,\n        ),\n    },\n  );\n\n  private readonly native = inject(Tracking.SOURCE);\n\n  /**\n   * The permission to track. `ensure()` shows Apple's dialog only if it has not been answered;\n   * the text in it is `NSUserTrackingUsageDescription`, set through the module's config plugin.\n   */\n  readonly permission: Permission = Permission.of(\n    () => this.native?.getTrackingPermissionsAsync() ?? Promise.resolve(UNAVAILABLE),\n    () => this.native?.requestTrackingPermissionsAsync() ?? Promise.resolve(UNAVAILABLE),\n  );\n\n  /** Whether the device has the tracking API. Where it does not, the permission answers granted. */\n  available(): boolean {\n    return this.native?.isAvailable() ?? false;\n  }\n\n  /**\n   * The advertising identifier: the IDFA on iOS, the advertising ID on Android. Null on iOS until\n   * tracking is allowed, in the simulator, and on Android with ad tracking limited.\n   */\n  advertisingId(): string | null {\n    return this.native?.getAdvertisingId() ?? null;\n  }\n}\n"]}

package/dist/transforms.d.ts

@@ -0,0 +1,2 @@
+export declare function optionalBoolean(value: unknown): boolean | undefined;
+export declare function optionalNumber(value: unknown): number | undefined;

package/dist/transforms.js

@@ -0,0 +1,13 @@
+/**
+ * Input transforms for numbers and switches written as static attributes, which arrive as
+ * strings, that keep an unset prop unset rather than sending `false` or `NaN`. The same pair
+ * exists in the components and router packages; this package does not depend on either.
+ */
+import { booleanAttribute, numberAttribute } from '@angular/core';
+export function optionalBoolean(value) {
+    return value === undefined ? undefined : booleanAttribute(value);
+}
+export function optionalNumber(value) {
+    return value === undefined ? undefined : numberAttribute(value);
+}
+//# sourceMappingURL=transforms.js.map

package/dist/transforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.js","sourceRoot":"","sources":["../src/transforms.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAElE,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC","sourcesContent":["/**\n * Input transforms for numbers and switches written as static attributes, which arrive as\n * strings, that keep an unset prop unset rather than sending `false` or `NaN`. The same pair\n * exists in the components and router packages; this package does not depend on either.\n */\nimport { booleanAttribute, numberAttribute } from '@angular/core';\n\nexport function optionalBoolean(value: unknown): boolean | undefined {\n  return value === undefined ? undefined : booleanAttribute(value);\n}\n\nexport function optionalNumber(value: unknown): number | undefined {\n  return value === undefined ? undefined : numberAttribute(value);\n}\n"]}

package/dist/updates.d.ts

@@ -0,0 +1,61 @@
+/**
+ * `Updates`, bound to `expo-updates`.
+ *
+ * ```ts
+ * private readonly updates = inject(Updates);
+ *
+ * // On foreground, where a restart costs the user nothing.
+ * async refresh() {
+ *   if (await this.updates.check()) await this.updates.apply();
+ * }
+ * ```
+ *
+ * The awkward part is not checking or downloading - both are plain promises - it is that applying
+ * one *restarts the app*. So the shape that matters is: know one is ready, and let the app choose
+ * a moment the user will not lose anything at. Nothing here does it on its own.
+ */
+import { InjectionToken, type Signal } from '@angular/core';
+import * as i0 from "@angular/core";
+export interface NativeUpdates {
+    readonly enabled: boolean;
+    check(): Promise<{
+        isAvailable: boolean;
+    }>;
+    fetch(): Promise<{
+        isNew: boolean;
+    }>;
+    reload(): Promise<void>;
+}
+export type UpdateState = 'idle' | 'checking' | 'downloading' | 'ready' | 'error';
+export declare class Updates {
+    /** Overridden in a test to offer an update without a server. */
+    static readonly SOURCE: InjectionToken<NativeUpdates | null>;
+    private readonly native;
+    private readonly current;
+    private readonly failure;
+    readonly state: Signal<UpdateState>;
+    readonly error: Signal<unknown>;
+    /** Downloaded and waiting. The only state in which `apply()` does anything. */
+    readonly ready: Signal<boolean>;
+    /**
+     * Disabled in development and in Expo Go, where the bundle comes from Metro. An app that shows
+     * an "update available" banner should hide it here rather than show one that can never resolve.
+     */
+    get enabled(): boolean;
+    /**
+     * Check, and download if there is one. Resolves to whether an update is now waiting.
+     *
+     * One method rather than two because there is nothing useful to do between them: an app that
+     * checks and does not download has learnt something it cannot act on.
+     */
+    check(): Promise<boolean>;
+    /**
+     * Restart into the downloaded update.
+     *
+     * **This restarts the app**, which is why it is never automatic: the moment to do it is one the
+     * app knows and this does not - not mid-form, not mid-upload, usually on next foreground.
+     */
+    apply(): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<Updates, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}

package/dist/updates.js

@@ -0,0 +1,97 @@
+/**
+ * `Updates`, bound to `expo-updates`.
+ *
+ * ```ts
+ * private readonly updates = inject(Updates);
+ *
+ * // On foreground, where a restart costs the user nothing.
+ * async refresh() {
+ *   if (await this.updates.check()) await this.updates.apply();
+ * }
+ * ```
+ *
+ * The awkward part is not checking or downloading - both are plain promises - it is that applying
+ * one *restarts the app*. So the shape that matters is: know one is ready, and let the app choose
+ * a moment the user will not lose anything at. Nothing here does it on its own.
+ */
+import { InjectionToken, Service, computed, inject, signal } from '@angular/core';
+import { expoModule } from "./native.js";
+import * as i0 from "@angular/core";
+export class Updates {
+    /** Overridden in a test to offer an update without a server. */
+    static SOURCE = new InjectionToken('angular-native.updatesSource', {
+        factory: () => {
+            const expo = expoModule('expo-updates', () => require('expo-updates'));
+            if (!expo)
+                return null;
+            return {
+                // False in development and in Expo Go, where the bundle comes from Metro. A banner shown
+                // there is one that can never resolve.
+                enabled: expo.isEnabled,
+                check: async () => ({ isAvailable: (await expo.checkForUpdateAsync()).isAvailable }),
+                fetch: async () => ({ isNew: (await expo.fetchUpdateAsync()).isNew }),
+                reload: () => expo.reloadAsync(),
+            };
+        },
+    });
+    native = inject(Updates.SOURCE);
+    current = signal('idle', /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "current" }] : /* istanbul ignore next */ []));
+    failure = signal(null, /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "failure" }] : /* istanbul ignore next */ []));
+    state = this.current.asReadonly();
+    error = this.failure.asReadonly();
+    /** Downloaded and waiting. The only state in which `apply()` does anything. */
+    ready = computed(() => this.current() === 'ready', /* @ts-ignore */
+    ...(ngDevMode ? [{ debugName: "ready" }] : /* istanbul ignore next */ []));
+    /**
+     * Disabled in development and in Expo Go, where the bundle comes from Metro. An app that shows
+     * an "update available" banner should hide it here rather than show one that can never resolve.
+     */
+    get enabled() {
+        return this.native?.enabled ?? false;
+    }
+    /**
+     * Check, and download if there is one. Resolves to whether an update is now waiting.
+     *
+     * One method rather than two because there is nothing useful to do between them: an app that
+     * checks and does not download has learnt something it cannot act on.
+     */
+    async check() {
+        if (!this.native?.enabled)
+            return false;
+        try {
+            this.current.set('checking');
+            const { isAvailable } = await this.native.check();
+            if (!isAvailable) {
+                this.current.set('idle');
+                return false;
+            }
+            this.current.set('downloading');
+            const { isNew } = await this.native.fetch();
+            this.current.set(isNew ? 'ready' : 'idle');
+            return isNew;
+        }
+        catch (error) {
+            this.failure.set(error);
+            this.current.set('error');
+            return false;
+        }
+    }
+    /**
+     * Restart into the downloaded update.
+     *
+     * **This restarts the app**, which is why it is never automatic: the moment to do it is one the
+     * app knows and this does not - not mid-form, not mid-upload, usually on next foreground.
+     */
+    async apply() {
+        if (this.current() === 'ready')
+            await this.native?.reload();
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: Updates, deps: [], target: i0.ɵɵFactoryTarget.Service });
+    static ɵprov = i0.ɵɵngDeclareService({ minVersion: "22.0.0", version: "22.2.0", ngImport: i0, type: Updates });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: Updates, decorators: [{
+            type: Service
+        }] });
+//# sourceMappingURL=updates.js.map

package/dist/updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updates.js","sourceRoot":"","sources":["../src/updates.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `Updates`, bound to `expo-updates`.\n *\n * ```ts\n * private readonly updates = inject(Updates);\n *\n * // On foreground, where a restart costs the user nothing.\n * async refresh() {\n *   if (await this.updates.check()) await this.updates.apply();\n * }\n * ```\n *\n * The awkward part is not checking or downloading - both are plain promises - it is that applying\n * one *restarts the app*. So the shape that matters is: know one is ready, and let the app choose\n * a moment the user will not lose anything at. Nothing here does it on its own.\n */\nimport { InjectionToken, Service, computed, inject, signal, type Signal } from '@angular/core';\nimport { expoModule } from './native.ts';\n\nexport interface NativeUpdates {\n  readonly enabled: boolean;\n  check(): Promise<{ isAvailable: boolean }>;\n  fetch(): Promise<{ isNew: boolean }>;\n  reload(): Promise<void>;\n}\n\nexport type UpdateState = 'idle' | 'checking' | 'downloading' | 'ready' | 'error';\n\n@Service()\nexport class Updates {\n  /** Overridden in a test to offer an update without a server. */\n  static readonly SOURCE = new InjectionToken<NativeUpdates | null>(\n    'angular-native.updatesSource',\n    {\n      factory: () => {\n        const expo = expoModule(\n          'expo-updates',\n          () => require('expo-updates') as typeof import('expo-updates'),\n        );\n        if (!expo) return null;\n        return {\n          // False in development and in Expo Go, where the bundle comes from Metro. A banner shown\n          // there is one that can never resolve.\n          enabled: expo.isEnabled,\n          check: async () => ({ isAvailable: (await expo.checkForUpdateAsync()).isAvailable }),\n          fetch: async () => ({ isNew: (await expo.fetchUpdateAsync()).isNew }),\n          reload: () => expo.reloadAsync(),\n        };\n      },\n    },\n  );\n\n  private readonly native = inject(Updates.SOURCE);\n  private readonly current = signal<UpdateState>('idle');\n  private readonly failure = signal<unknown>(null);\n\n  readonly state: Signal<UpdateState> = this.current.asReadonly();\n  readonly error: Signal<unknown> = this.failure.asReadonly();\n\n  /** Downloaded and waiting. The only state in which `apply()` does anything. */\n  readonly ready: Signal<boolean> = computed(() => this.current() === 'ready');\n\n  /**\n   * Disabled in development and in Expo Go, where the bundle comes from Metro. An app that shows\n   * an \"update available\" banner should hide it here rather than show one that can never resolve.\n   */\n  get enabled(): boolean {\n    return this.native?.enabled ?? false;\n  }\n\n  /**\n   * Check, and download if there is one. Resolves to whether an update is now waiting.\n   *\n   * One method rather than two because there is nothing useful to do between them: an app that\n   * checks and does not download has learnt something it cannot act on.\n   */\n  async check(): Promise<boolean> {\n    if (!this.native?.enabled) return false;\n\n    try {\n      this.current.set('checking');\n      const { isAvailable } = await this.native.check();\n      if (!isAvailable) {\n        this.current.set('idle');\n        return false;\n      }\n\n      this.current.set('downloading');\n      const { isNew } = await this.native.fetch();\n      this.current.set(isNew ? 'ready' : 'idle');\n      return isNew;\n    } catch (error) {\n      this.failure.set(error);\n      this.current.set('error');\n      return false;\n    }\n  }\n\n  /**\n   * Restart into the downloaded update.\n   *\n   * **This restarts the app**, which is why it is never automatic: the moment to do it is one the\n   * app knows and this does not - not mid-form, not mid-upload, usually on next foreground.\n   */\n  async apply(): Promise<void> {\n    if (this.current() === 'ready') await this.native?.reload();\n  }\n}\n"]}