@ng-native/expo 0.13.0 → 0.15.0

package/dist/native.js

@@ -131,8 +131,9 @@ function nativeHalfMissing(module, platform) {
  * The Expo module a service needs.
  *
  * Where the module exists for the platform the app is on, a module that is missing is a mistake
- * the developer can fix, so this throws a `MissingModuleError` that says how - rather than leave a
- * feature that silently does nothing. Anywhere it cannot exist - an iOS-only module on Android, the
+ * the developer can fix, so using what this answers throws a `MissingModuleError` that says how -
+ * rather than leave a feature that silently does nothing. Using it, not asking for it: see
+ * `missing`. Anywhere it cannot exist - an iOS-only module on Android, the
  * web, and Node, where a test runs with no platform at all - this answers null, and the service
  * goes inert, as code shared across platforms needs it to.
  *
@@ -153,6 +154,63 @@ export function expoModule(module, load, platforms = ['ios', 'android']) {
     }
     if (platform === null || !platforms.includes(platform))
         return null;
-    throw new MissingModuleError(module, platform, failure);
+    return missing(new MissingModuleError(module, platform, failure));
+}
+/** What Angular asks of any injected value, and `await` of any value: never the module's. */
+const ASKED_OF_ANY = new Set(['then', 'ngOnDestroy', 'name']);
+/**
+ * A module that is not there, which throws `error` when it is used rather than when it is asked
+ * for. Thrown from a token's factory or a service's constructor, the error would be the one the
+ * first injection sees: Angular leaves the token marked as being made, and every injection after
+ * it fails with NG0200, "Circular dependency", which names nothing to install.
+ *
+ * Not thenable, and quiet to a symbol, so awaiting it or logging it does not throw, nor Angular
+ * asking an injected value whether it has an `ngOnDestroy` or is its own not-found marker, by
+ * `name`.
+ */
+function missing(error) {
+    const fail = () => {
+        throw error;
+    };
+    // A function, so calling it, or a member read off it, is a use that says so too.
+    const standIn = new Proxy(function standIn() { }, {
+        get: (_, key) => (typeof key === 'symbol' || ASKED_OF_ANY.has(key) ? undefined : fail()),
+        set: fail,
+        has: fail,
+        apply: fail,
+        construct: fail,
+        ownKeys: fail,
+        deleteProperty: fail,
+        defineProperty: fail,
+        getOwnPropertyDescriptor: fail,
+    });
+    missingErrors.set(standIn, error);
+    return standIn;
+}
+/** The error each stand-in for a missing module throws when it is used. */
+const missingErrors = new WeakMap();
+/** Whether `value` is the stand-in for a module missing from the build. */
+const isMissing = (value) => typeof value === 'function' && missingErrors.has(value);
+/**
+ * The module, or null where it is missing from the build: for what a service does as it is made,
+ * a listener or a first read, which is skipped then rather than thrown, so the service is made and
+ * what the app calls on it is what says the module is missing. See `missing`. A factory that
+ * builds over the module hands the stand-in on where it is missing (`if (!present(expo)) return
+ * expo as never`), for the same reason.
+ */
+export function present(value) {
+    return value == null || isMissing(value) ? null : value;
+}
+/**
+ * As `expoModule`, throwing at once where the module is missing: for a function an app calls
+ * itself, a player, a database or the splash screen, where no token is left marked and a failure
+ * after the call would be caught and lost.
+ */
+export function expoModuleNow(module, load, platforms) {
+    const found = expoModule(module, load, platforms);
+    const error = found && missingErrors.get(found);
+    if (error)
+        throw error;
+    return found;
 }
 //# sourceMappingURL=native.js.map

package/dist/native.js.map

@@ -1 +1 @@
-{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Reaching an Expo module without importing one.\n *\n * A static `import ... from 'expo-battery'` makes the file unloadable by Node, which is what used\n * to force every service into two files: the behaviour somewhere the test suite could reach, and\n * the binding somewhere it could not. A `require` inside a function has neither problem. Metro\n * still resolves the string literal at build time, so the module is bundled exactly as before and\n * an app that has not installed it still gets a build error rather than a surprise at runtime;\n * Node never evaluates the call at all, because nothing in a test asks for the real platform.\n *\n * The `catch` is doing two jobs, and only one of them is Node. In an ESM test `require` is not\n * defined, so calling it throws `ReferenceError` and the service goes inert - the same state as\n * a device that has no such sensor. On a device the throw is a module that is present but not\n * linked, which is the same answer for the same reason.\n */\n/**\n * Calls a listener the app gave. What it throws, or rejects with when it is asynchronous, goes to\n * `report`, so one failing listener does not stop what calls it.\n */\nexport function isolated(call: () => unknown, report: (failure: unknown) => void): void {\n  try {\n    const done = call();\n    if (done instanceof Promise) done.catch(report);\n  } catch (failure) {\n    report(failure);\n  }\n}\n\nexport function optional<T>(load: () => T): T | null {\n  try {\n    return load();\n  } catch {\n    return null;\n  }\n}\n\n/** The platforms an Expo module is written for. */\nexport type ModulePlatform = 'ios' | 'android' | 'web';\n\n/**\n * A module the app needs and does not have: the package is not installed, or it is and the app was\n * not rebuilt since, so its native half is not in the binary. Development builds and Expo Go carry\n * only the native modules they were built with.\n */\nexport class MissingModuleError extends Error {\n  override readonly name = 'MissingModuleError';\n  /** The package, as it is installed: `expo-haptics`. */\n  readonly module: string;\n\n  constructor(module: string, platform: ModulePlatform, cause?: unknown, message?: string) {\n    super(\n      message ??\n        (platform === 'web'\n          ? `${module} is not installed. Install it with \"npx expo install ${module}\", then restart the dev server.`\n          : `${module} is not in this build of the app. Install it with \"npx expo install ${module}\", ` +\n            `then rebuild the app (\"npx expo run:${platform}\", or a new EAS build): a development ` +\n            `build, and Expo Go, contain only the native modules they were built with.`),\n      { cause },\n    );\n    this.module = module;\n  }\n}\n\n/**\n * The `MissingModuleError` to throw where `expoModule` answered null: the module is installed or not, but there is\n * nothing to load it on. In Node, where a test runs, that is every native module, and \"install it\"\n * would be advice to do what is already done; `inTest` says what a test does instead. On a platform\n * the module does not support, it says that.\n */\nexport function unavailable(module: string, inTest: string): MissingModuleError {\n  const platform = currentPlatform();\n  const message =\n    platform === null\n      ? `[angular-native] ${module} has no native module to load in Node, where a test runs. ${inTest}`\n      : `[angular-native] ${module} is not available on ${platform}.`;\n  // The platform is only read for the default message, which this replaces.\n  return new MissingModuleError(module, platform ?? 'web', undefined, message);\n}\n\n/** The platform the app is running on, or null in Node, where there is none to ask. */\nexport function currentPlatform(): ModulePlatform | null {\n  return optional(\n    () => (require('react-native') as { Platform: { OS: string } }).Platform.OS as ModulePlatform,\n  );\n}\n\n/**\n * For each Expo package whose JavaScript requires a native module as it is evaluated, and so\n * throws when its native half is not in the build, one of those native modules. Any one of them\n * says whether the package's native half is there, and each of these is registered on both iOS and\n * Android.\n */\nconst NATIVE_MODULES: Readonly<Record<string, string>> = {\n  'expo-application': 'ExpoApplication',\n  'expo-asset': 'ExpoAsset',\n  'expo-audio': 'ExpoAudio',\n  'expo-background-task': 'ExpoBackgroundTask',\n  'expo-battery': 'ExpoBattery',\n  'expo-brightness': 'ExpoBrightness',\n  'expo-clipboard': 'ExpoClipboard',\n  'expo-crypto': 'ExpoCrypto',\n  'expo-device': 'ExpoDevice',\n  'expo-document-picker': 'ExpoDocumentPicker',\n  'expo-file-system': 'FileSystem',\n  'expo-foldables': 'ExpoFoldables',\n  'expo-font': 'ExpoFontLoader',\n  'expo-image-manipulator': 'ExpoImageManipulator',\n  'expo-image-picker': 'ExponentImagePicker',\n  'expo-keep-awake': 'ExpoKeepAwake',\n  'expo-local-authentication': 'ExpoLocalAuthentication',\n  'expo-local-llm': 'ExpoLocalLlm',\n  'expo-localization': 'ExpoLocalization',\n  'expo-location': 'ExpoLocation',\n  'expo-media-library': 'ExpoMediaLibrary',\n  'expo-network': 'ExpoNetwork',\n  'expo-notifications': 'ExpoNotificationPresenter',\n  'expo-screen-capture': 'ExpoScreenCapture',\n  'expo-screen-orientation': 'ExpoScreenOrientation',\n  'expo-secure-store': 'ExpoSecureStore',\n  'expo-sensors': 'ExponentAccelerometer',\n  'expo-sqlite': 'ExpoSQLite',\n  'expo-store-review': 'ExpoStoreReview',\n  'expo-tracking-transparency': 'ExpoTrackingTransparency',\n  'expo-updates': 'ExpoUpdates',\n  'expo-video': 'ExpoVideo',\n  'expo-web-browser': 'ExpoWebBrowser',\n};\n\n/**\n * Whether `module`'s native half is missing from the build on `platform`, asked of Expo before its\n * JavaScript is evaluated. That JavaScript throws while it is being evaluated when its native module\n * is not there, and Metro reports that as fatal, before any `catch` here, whenever it is not inside\n * another module's load: in a service's factory, say. Not on the web, where a package registers its\n * module only once it is evaluated.\n */\nfunction nativeHalfMissing(module: string, platform: ModulePlatform | null): boolean {\n  const name = NATIVE_MODULES[module];\n  if (!name || platform === null || platform === 'web') return false;\n  const core = optional(() => require('expo-modules-core') as typeof import('expo-modules-core'));\n  return core !== null && !core.requireOptionalNativeModule(name);\n}\n\n/**\n * The Expo module a service needs.\n *\n * Where the module exists for the platform the app is on, a module that is missing is a mistake\n * the developer can fix, so this throws a `MissingModuleError` that says how - rather than leave a\n * feature that silently does nothing. Anywhere it cannot exist - an iOS-only module on Android, the\n * web, and Node, where a test runs with no platform at all - this answers null, and the service\n * goes inert, as code shared across platforms needs it to.\n *\n * `load` answering null or undefined counts as missing too: `requireOptionalNativeModule` answers\n * null rather than throwing. So does a package whose native half is not in the build, which `load`\n * is not called for: see `nativeHalfMissing`.\n */\nexport function expoModule<T>(\n  module: string,\n  load: () => T | null | undefined,\n  platforms: readonly ModulePlatform[] = ['ios', 'android'],\n): T | null {\n  const platform = currentPlatform();\n  let failure: unknown;\n  try {\n    const loaded = nativeHalfMissing(module, platform) ? null : load();\n    if (loaded != null) return loaded;\n  } catch (error) {\n    failure = error;\n  }\n  if (platform === null || !platforms.includes(platform)) return null;\n  throw new MissingModuleError(module, platform, failure);\n}\n"]}
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Reaching an Expo module without importing one.\n *\n * A static `import ... from 'expo-battery'` makes the file unloadable by Node, which is what used\n * to force every service into two files: the behaviour somewhere the test suite could reach, and\n * the binding somewhere it could not. A `require` inside a function has neither problem. Metro\n * still resolves the string literal at build time, so the module is bundled exactly as before and\n * an app that has not installed it still gets a build error rather than a surprise at runtime;\n * Node never evaluates the call at all, because nothing in a test asks for the real platform.\n *\n * The `catch` is doing two jobs, and only one of them is Node. In an ESM test `require` is not\n * defined, so calling it throws `ReferenceError` and the service goes inert - the same state as\n * a device that has no such sensor. On a device the throw is a module that is present but not\n * linked, which is the same answer for the same reason.\n */\n/**\n * Calls a listener the app gave. What it throws, or rejects with when it is asynchronous, goes to\n * `report`, so one failing listener does not stop what calls it.\n */\nexport function isolated(call: () => unknown, report: (failure: unknown) => void): void {\n  try {\n    const done = call();\n    if (done instanceof Promise) done.catch(report);\n  } catch (failure) {\n    report(failure);\n  }\n}\n\nexport function optional<T>(load: () => T): T | null {\n  try {\n    return load();\n  } catch {\n    return null;\n  }\n}\n\n/** The platforms an Expo module is written for. */\nexport type ModulePlatform = 'ios' | 'android' | 'web';\n\n/**\n * A module the app needs and does not have: the package is not installed, or it is and the app was\n * not rebuilt since, so its native half is not in the binary. Development builds and Expo Go carry\n * only the native modules they were built with.\n */\nexport class MissingModuleError extends Error {\n  override readonly name = 'MissingModuleError';\n  /** The package, as it is installed: `expo-haptics`. */\n  readonly module: string;\n\n  constructor(module: string, platform: ModulePlatform, cause?: unknown, message?: string) {\n    super(\n      message ??\n        (platform === 'web'\n          ? `${module} is not installed. Install it with \"npx expo install ${module}\", then restart the dev server.`\n          : `${module} is not in this build of the app. Install it with \"npx expo install ${module}\", ` +\n            `then rebuild the app (\"npx expo run:${platform}\", or a new EAS build): a development ` +\n            `build, and Expo Go, contain only the native modules they were built with.`),\n      { cause },\n    );\n    this.module = module;\n  }\n}\n\n/**\n * The `MissingModuleError` to throw where `expoModule` answered null: the module is installed or not, but there is\n * nothing to load it on. In Node, where a test runs, that is every native module, and \"install it\"\n * would be advice to do what is already done; `inTest` says what a test does instead. On a platform\n * the module does not support, it says that.\n */\nexport function unavailable(module: string, inTest: string): MissingModuleError {\n  const platform = currentPlatform();\n  const message =\n    platform === null\n      ? `[angular-native] ${module} has no native module to load in Node, where a test runs. ${inTest}`\n      : `[angular-native] ${module} is not available on ${platform}.`;\n  // The platform is only read for the default message, which this replaces.\n  return new MissingModuleError(module, platform ?? 'web', undefined, message);\n}\n\n/** The platform the app is running on, or null in Node, where there is none to ask. */\nexport function currentPlatform(): ModulePlatform | null {\n  return optional(\n    () => (require('react-native') as { Platform: { OS: string } }).Platform.OS as ModulePlatform,\n  );\n}\n\n/**\n * For each Expo package whose JavaScript requires a native module as it is evaluated, and so\n * throws when its native half is not in the build, one of those native modules. Any one of them\n * says whether the package's native half is there, and each of these is registered on both iOS and\n * Android.\n */\nconst NATIVE_MODULES: Readonly<Record<string, string>> = {\n  'expo-application': 'ExpoApplication',\n  'expo-asset': 'ExpoAsset',\n  'expo-audio': 'ExpoAudio',\n  'expo-background-task': 'ExpoBackgroundTask',\n  'expo-battery': 'ExpoBattery',\n  'expo-brightness': 'ExpoBrightness',\n  'expo-clipboard': 'ExpoClipboard',\n  'expo-crypto': 'ExpoCrypto',\n  'expo-device': 'ExpoDevice',\n  'expo-document-picker': 'ExpoDocumentPicker',\n  'expo-file-system': 'FileSystem',\n  'expo-foldables': 'ExpoFoldables',\n  'expo-font': 'ExpoFontLoader',\n  'expo-image-manipulator': 'ExpoImageManipulator',\n  'expo-image-picker': 'ExponentImagePicker',\n  'expo-keep-awake': 'ExpoKeepAwake',\n  'expo-local-authentication': 'ExpoLocalAuthentication',\n  'expo-local-llm': 'ExpoLocalLlm',\n  'expo-localization': 'ExpoLocalization',\n  'expo-location': 'ExpoLocation',\n  'expo-media-library': 'ExpoMediaLibrary',\n  'expo-network': 'ExpoNetwork',\n  'expo-notifications': 'ExpoNotificationPresenter',\n  'expo-screen-capture': 'ExpoScreenCapture',\n  'expo-screen-orientation': 'ExpoScreenOrientation',\n  'expo-secure-store': 'ExpoSecureStore',\n  'expo-sensors': 'ExponentAccelerometer',\n  'expo-sqlite': 'ExpoSQLite',\n  'expo-store-review': 'ExpoStoreReview',\n  'expo-tracking-transparency': 'ExpoTrackingTransparency',\n  'expo-updates': 'ExpoUpdates',\n  'expo-video': 'ExpoVideo',\n  'expo-web-browser': 'ExpoWebBrowser',\n};\n\n/**\n * Whether `module`'s native half is missing from the build on `platform`, asked of Expo before its\n * JavaScript is evaluated. That JavaScript throws while it is being evaluated when its native module\n * is not there, and Metro reports that as fatal, before any `catch` here, whenever it is not inside\n * another module's load: in a service's factory, say. Not on the web, where a package registers its\n * module only once it is evaluated.\n */\nfunction nativeHalfMissing(module: string, platform: ModulePlatform | null): boolean {\n  const name = NATIVE_MODULES[module];\n  if (!name || platform === null || platform === 'web') return false;\n  const core = optional(() => require('expo-modules-core') as typeof import('expo-modules-core'));\n  return core !== null && !core.requireOptionalNativeModule(name);\n}\n\n/**\n * The Expo module a service needs.\n *\n * Where the module exists for the platform the app is on, a module that is missing is a mistake\n * the developer can fix, so using what this answers throws a `MissingModuleError` that says how -\n * rather than leave a feature that silently does nothing. Using it, not asking for it: see\n * `missing`. Anywhere it cannot exist - an iOS-only module on Android, the\n * web, and Node, where a test runs with no platform at all - this answers null, and the service\n * goes inert, as code shared across platforms needs it to.\n *\n * `load` answering null or undefined counts as missing too: `requireOptionalNativeModule` answers\n * null rather than throwing. So does a package whose native half is not in the build, which `load`\n * is not called for: see `nativeHalfMissing`.\n */\nexport function expoModule<T>(\n  module: string,\n  load: () => T | null | undefined,\n  platforms: readonly ModulePlatform[] = ['ios', 'android'],\n): T | null {\n  const platform = currentPlatform();\n  let failure: unknown;\n  try {\n    const loaded = nativeHalfMissing(module, platform) ? null : load();\n    if (loaded != null) return loaded;\n  } catch (error) {\n    failure = error;\n  }\n  if (platform === null || !platforms.includes(platform)) return null;\n  return missing(new MissingModuleError(module, platform, failure));\n}\n\n/** What Angular asks of any injected value, and `await` of any value: never the module's. */\nconst ASKED_OF_ANY = new Set(['then', 'ngOnDestroy', 'name']);\n\n/**\n * A module that is not there, which throws `error` when it is used rather than when it is asked\n * for. Thrown from a token's factory or a service's constructor, the error would be the one the\n * first injection sees: Angular leaves the token marked as being made, and every injection after\n * it fails with NG0200, \"Circular dependency\", which names nothing to install.\n *\n * Not thenable, and quiet to a symbol, so awaiting it or logging it does not throw, nor Angular\n * asking an injected value whether it has an `ngOnDestroy` or is its own not-found marker, by\n * `name`.\n */\nfunction missing<T>(error: MissingModuleError): T {\n  const fail = (): never => {\n    throw error;\n  };\n  // A function, so calling it, or a member read off it, is a use that says so too.\n  const standIn = new Proxy(function standIn() {}, {\n    get: (_, key) => (typeof key === 'symbol' || ASKED_OF_ANY.has(key) ? undefined : fail()),\n    set: fail,\n    has: fail,\n    apply: fail,\n    construct: fail,\n    ownKeys: fail,\n    deleteProperty: fail,\n    defineProperty: fail,\n    getOwnPropertyDescriptor: fail,\n  });\n  missingErrors.set(standIn, error);\n  return standIn as T;\n}\n\n/** The error each stand-in for a missing module throws when it is used. */\nconst missingErrors = new WeakMap<object, MissingModuleError>();\n\n/** Whether `value` is the stand-in for a module missing from the build. */\nconst isMissing = (value: unknown): boolean =>\n  typeof value === 'function' && missingErrors.has(value);\n\n/**\n * The module, or null where it is missing from the build: for what a service does as it is made,\n * a listener or a first read, which is skipped then rather than thrown, so the service is made and\n * what the app calls on it is what says the module is missing. See `missing`. A factory that\n * builds over the module hands the stand-in on where it is missing (`if (!present(expo)) return\n * expo as never`), for the same reason.\n */\nexport function present<T>(value: T | null | undefined): T | null {\n  return value == null || isMissing(value) ? null : value;\n}\n\n/**\n * As `expoModule`, throwing at once where the module is missing: for a function an app calls\n * itself, a player, a database or the splash screen, where no token is left marked and a failure\n * after the call would be caught and lost.\n */\nexport function expoModuleNow<T>(\n  module: string,\n  load: () => T | null | undefined,\n  platforms?: readonly ModulePlatform[],\n): T | null {\n  const found = expoModule(module, load, platforms);\n  const error = found && missingErrors.get(found as object);\n  if (error) throw error;\n  return found;\n}\n"]}

package/dist/network.js

@@ -8,7 +8,7 @@
  */
 import { InjectionToken, Service, computed, inject } from '@angular/core';
 import { observed, observedFrom } from "./observed.js";
-import { expoModule } from "./native.js";
+import { expoModule, present } from "./native.js";
 import * as i0 from "@angular/core";
 export const OFFLINE = { connected: false, type: 'unknown', reachable: null };
 const TYPES = {
@@ -28,6 +28,9 @@ export class Network {
             const expo = expoModule('expo-network', () => require('expo-network'));
             if (!expo)
                 return null;
+            // Missing from the build: the stand-in, to say so when it is used.
+            if (!present(expo))
+                return expo;
             const read = (state) => ({
                 connected: state.isConnected ?? false,
                 type: TYPES[state.type ?? 'UNKNOWN'] ?? 'unknown',

package/dist/network.js.map

@@ -1 +1 @@
-{"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAiB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;;AAYzC,MAAM,CAAC,MAAM,OAAO,GAAkB,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAE7F,MAAM,KAAK,GAAmC;IAC5C,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;CACf,CAAC;AAGF,MAAM,OAAO,OAAO;IAClB,4DAA4D;IAC5D,MAAM,CAAU,MAAM,GAAG,IAAI,cAAc,CACzC,8BAA8B,EAC9B;QACE,OAAO,EAAE,GAAG,EAAE;YACZ,MAAM,IAAI,GAAG,UAAU,CACrB,cAAc,EACd,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAkC,CAC/D,CAAC;YACF,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YAEvB,MAAM,IAAI,GAAG,CACX,KAAqF,EACtE,EAAE,CAAC,CAAC;gBACnB,SAAS,EAAE,KAAK,CAAC,WAAW,IAAI,KAAK;gBACrC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,SAAS;gBACjD,0FAA0F;gBAC1F,oDAAoD;gBACpD,SAAS,EAAE,KAAK,CAAC,mBAAmB,IAAI,IAAI;aAC7C,CAAC,CAAC;YAEH,OAAO,YAAY,CACjB,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC,EACnD,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAC7E,CAAC;QACJ,CAAC;KACF,CACF,CAAC;IAEO,MAAM,GAA0B,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAEnF,8FAA8F;IACrF,SAAS,GAAoB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS;kFAAC,CAAC;IAE9E,8EAA8E;IACrE,IAAI,GAA2B,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI;6EAAC,CAAC;IAE3E;;;OAGG;IACM,SAAS,GAA2B,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS;kFAAC,CAAC;uGA1C1E,OAAO;wGAAP,OAAO;;2FAAP,OAAO;kBADnB,OAAO","sourcesContent":["/**\n * `Network`, bound to `expo-network`.\n *\n * Whether the app can reach anything, which is not the same as whether it has a connection. A\n * phone on a captive-portal wifi is connected and reachable by nothing; a phone in a lift has a\n * connection type and no signal. `reachable` is the one worth branching on, and it is the one the\n * platform is least sure about - it stays `null` until something has actually been reached.\n */\nimport { InjectionToken, Service, computed, inject, type Signal } from '@angular/core';\nimport { observed, observedFrom, type Observed } from './observed.ts';\nimport { expoModule } from './native.ts';\n\nexport type ConnectionType =\n  'wifi' | 'cellular' | 'ethernet' | 'bluetooth' | 'vpn' | 'other' | 'none' | 'unknown';\n\nexport interface NetworkStatus {\n  readonly connected: boolean;\n  readonly type: ConnectionType;\n  /** Null while the platform has not established it, which is not the same as false. */\n  readonly reachable: boolean | null;\n}\n\nexport const OFFLINE: NetworkStatus = { connected: false, type: 'unknown', reachable: null };\n\nconst TYPES: Record<string, ConnectionType> = {\n  NONE: 'none',\n  UNKNOWN: 'unknown',\n  WIFI: 'wifi',\n  CELLULAR: 'cellular',\n  BLUETOOTH: 'bluetooth',\n  ETHERNET: 'ethernet',\n  VPN: 'vpn',\n  OTHER: 'other',\n};\n\n@Service()\nexport class Network {\n  /** Overridden in a test to go offline without a network. */\n  static readonly SOURCE = new InjectionToken<Observed<NetworkStatus> | null>(\n    'angular-native.networkSource',\n    {\n      factory: () => {\n        const expo = expoModule(\n          'expo-network',\n          () => require('expo-network') as typeof import('expo-network'),\n        );\n        if (!expo) return null;\n\n        const read = (\n          state: import('expo-network').NetworkState | import('expo-network').NetworkStateEvent,\n        ): NetworkStatus => ({\n          connected: state.isConnected ?? false,\n          type: TYPES[state.type ?? 'UNKNOWN'] ?? 'unknown',\n          // `undefined` means the platform has not established it; `null` is how that is said here,\n          // so a consumer cannot confuse \"not yet\" with \"no\".\n          reachable: state.isInternetReachable ?? null,\n        });\n\n        return observedFrom(\n          async () => read(await expo.getNetworkStateAsync()),\n          (listener) => expo.addNetworkStateListener((event) => listener(read(event))),\n        );\n      },\n    },\n  );\n\n  readonly status: Signal<NetworkStatus> = observed(inject(Network.SOURCE), OFFLINE);\n\n  /** Whether there is a connection of any kind. Say what you mean: this is not reachability. */\n  readonly connected: Signal<boolean> = computed(() => this.status().connected);\n\n  /** What the connection is over, for a screen that offers to wait for wifi. */\n  readonly type: Signal<ConnectionType> = computed(() => this.status().type);\n\n  /**\n   * Whether anything has actually been reached. Null until the platform knows, so a screen that\n   * shows an offline banner should treat null as \"not yet\" rather than as offline.\n   */\n  readonly reachable: Signal<boolean | null> = computed(() => this.status().reachable);\n}\n"]}
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../src/network.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAiB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;;AAYlD,MAAM,CAAC,MAAM,OAAO,GAAkB,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAE7F,MAAM,KAAK,GAAmC;IAC5C,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;CACf,CAAC;AAGF,MAAM,OAAO,OAAO;IAClB,4DAA4D;IAC5D,MAAM,CAAU,MAAM,GAAG,IAAI,cAAc,CACzC,8BAA8B,EAC9B;QACE,OAAO,EAAE,GAAG,EAAE;YACZ,MAAM,IAAI,GAAG,UAAU,CACrB,cAAc,EACd,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAkC,CAC/D,CAAC;YACF,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAC;YACvB,mEAAmE;YACnE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAa,CAAC;YAEzC,MAAM,IAAI,GAAG,CACX,KAAqF,EACtE,EAAE,CAAC,CAAC;gBACnB,SAAS,EAAE,KAAK,CAAC,WAAW,IAAI,KAAK;gBACrC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,SAAS;gBACjD,0FAA0F;gBAC1F,oDAAoD;gBACpD,SAAS,EAAE,KAAK,CAAC,mBAAmB,IAAI,IAAI;aAC7C,CAAC,CAAC;YAEH,OAAO,YAAY,CACjB,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC,EACnD,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAC7E,CAAC;QACJ,CAAC;KACF,CACF,CAAC;IAEO,MAAM,GAA0B,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAEnF,8FAA8F;IACrF,SAAS,GAAoB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS;kFAAC,CAAC;IAE9E,8EAA8E;IACrE,IAAI,GAA2B,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI;6EAAC,CAAC;IAE3E;;;OAGG;IACM,SAAS,GAA2B,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS;kFAAC,CAAC;uGA5C1E,OAAO;wGAAP,OAAO;;2FAAP,OAAO;kBADnB,OAAO","sourcesContent":["/**\n * `Network`, bound to `expo-network`.\n *\n * Whether the app can reach anything, which is not the same as whether it has a connection. A\n * phone on a captive-portal wifi is connected and reachable by nothing; a phone in a lift has a\n * connection type and no signal. `reachable` is the one worth branching on, and it is the one the\n * platform is least sure about - it stays `null` until something has actually been reached.\n */\nimport { InjectionToken, Service, computed, inject, type Signal } from '@angular/core';\nimport { observed, observedFrom, type Observed } from './observed.ts';\nimport { expoModule, present } from './native.ts';\n\nexport type ConnectionType =\n  'wifi' | 'cellular' | 'ethernet' | 'bluetooth' | 'vpn' | 'other' | 'none' | 'unknown';\n\nexport interface NetworkStatus {\n  readonly connected: boolean;\n  readonly type: ConnectionType;\n  /** Null while the platform has not established it, which is not the same as false. */\n  readonly reachable: boolean | null;\n}\n\nexport const OFFLINE: NetworkStatus = { connected: false, type: 'unknown', reachable: null };\n\nconst TYPES: Record<string, ConnectionType> = {\n  NONE: 'none',\n  UNKNOWN: 'unknown',\n  WIFI: 'wifi',\n  CELLULAR: 'cellular',\n  BLUETOOTH: 'bluetooth',\n  ETHERNET: 'ethernet',\n  VPN: 'vpn',\n  OTHER: 'other',\n};\n\n@Service()\nexport class Network {\n  /** Overridden in a test to go offline without a network. */\n  static readonly SOURCE = new InjectionToken<Observed<NetworkStatus> | null>(\n    'angular-native.networkSource',\n    {\n      factory: () => {\n        const expo = expoModule(\n          'expo-network',\n          () => require('expo-network') as typeof import('expo-network'),\n        );\n        if (!expo) return null;\n        // Missing from the build: the stand-in, to say so when it is used.\n        if (!present(expo)) return expo as never;\n\n        const read = (\n          state: import('expo-network').NetworkState | import('expo-network').NetworkStateEvent,\n        ): NetworkStatus => ({\n          connected: state.isConnected ?? false,\n          type: TYPES[state.type ?? 'UNKNOWN'] ?? 'unknown',\n          // `undefined` means the platform has not established it; `null` is how that is said here,\n          // so a consumer cannot confuse \"not yet\" with \"no\".\n          reachable: state.isInternetReachable ?? null,\n        });\n\n        return observedFrom(\n          async () => read(await expo.getNetworkStateAsync()),\n          (listener) => expo.addNetworkStateListener((event) => listener(read(event))),\n        );\n      },\n    },\n  );\n\n  readonly status: Signal<NetworkStatus> = observed(inject(Network.SOURCE), OFFLINE);\n\n  /** Whether there is a connection of any kind. Say what you mean: this is not reachability. */\n  readonly connected: Signal<boolean> = computed(() => this.status().connected);\n\n  /** What the connection is over, for a screen that offers to wait for wifi. */\n  readonly type: Signal<ConnectionType> = computed(() => this.status().type);\n\n  /**\n   * Whether anything has actually been reached. Null until the platform knows, so a screen that\n   * shows an offline banner should treat null as \"not yet\" rather than as offline.\n   */\n  readonly reachable: Signal<boolean | null> = computed(() => this.status().reachable);\n}\n"]}

package/dist/notifications.js

@@ -35,7 +35,7 @@
  * with fails silently: the push simply never arrives.
  */
 import { DestroyRef, InjectionToken, Service, inject, signal } from '@angular/core';
-import { expoModule } from "./native.js";
+import { currentPlatform, expoModule, optional, present } from "./native.js";
 import { Permission, UNAVAILABLE } from "./permissions.js";
 import * as i0 from "@angular/core";
 /**
@@ -55,7 +55,13 @@ export const TriggerType = {
 export class Notifications {
     /** Overridden in a test to deliver a notification nobody sent. */
     static SOURCE = new InjectionToken('angular-native.notificationsSource', {
-        factory: () => expoModule('expo-notifications', () => require('expo-notifications')),
+        factory: () => {
+            if (refusedByExpoGo()) {
+                console.warn(REFUSED_BY_EXPO_GO);
+                return null;
+            }
+            return expoModule('expo-notifications', () => require('expo-notifications'));
+        },
     });
     native = inject(Notifications.SOURCE);
     received = signal(null, /* @ts-ignore */
@@ -75,24 +81,26 @@ export class Notifications {
     constructor() {
         const native = this.native;
         this.permission = Permission.of(() => native?.getPermissionsAsync?.() ?? Promise.resolve(UNAVAILABLE), () => native?.requestPermissionsAsync?.() ?? Promise.resolve(UNAVAILABLE));
-        if (!native)
+        // Its listeners only where the module is there; missing, what the app calls says so.
+        const live = present(native);
+        if (!live)
             return;
         const subscriptions = [
-            native.addNotificationReceivedListener((notification) => this.received.set(notification)),
-            native.addNotificationResponseReceivedListener((response) => this.responded.set(response)),
+            live.addNotificationReceivedListener((notification) => this.received.set(notification)),
+            live.addNotificationResponseReceivedListener((response) => this.responded.set(response)),
             // Android drops notifications when too many arrive at once while the app is not running;
             // this is the only word that any went missing.
-            native.addNotificationsDroppedListener(() => this.drops.update((count) => count + 1)),
+            live.addNotificationsDroppedListener(() => this.drops.update((count) => count + 1)),
             // A device push token can be rolled by the platform while the app is running; the old one
             // then fails silently rather than delivering anything. This is the only way to find out.
-            native.addPushTokenListener((token) => this.rolled.set(token)),
+            live.addPushTokenListener((token) => this.rolled.set(token)),
         ];
         inject(DestroyRef).onDestroy(() => subscriptions.forEach((one) => one.remove()));
         // The response that launched the app happened before anything was listening, so it has to be
         // asked for rather than waited for. Without this a cold start from a notification does
         // nothing, which is the single most common way this is got wrong. A platform that cannot say
         // is the same as a launch without a notification.
-        void native
+        void live
             .getLastNotificationResponseAsync()
             .then((response) => {
             if (response && this.responded() === null)
@@ -291,4 +299,23 @@ export class Notifications {
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.2.0", ngImport: i0, type: Notifications, decorators: [{
             type: Service
         }], ctorParameters: () => [] });
+/**
+ * Whether this is Expo Go on Android, where `expo-notifications` cannot be imported.
+ *
+ * The package subscribes to push tokens as it is imported, and in Expo Go on Android, which has
+ * had no push since SDK 53, that subscription throws. So the import fails there, local
+ * notifications included, and no rebuild puts it right. Asked before the import and not caught
+ * after it: Metro reports a module that throws as it loads as a fatal error itself, so the red
+ * screen is up before anything here could catch it. With no module the service is what it is on
+ * the web, and the app gets past the first screen that injects it.
+ */
+function refusedByExpoGo() {
+    if (currentPlatform() !== 'android')
+        return false;
+    const expo = optional(() => require('expo'));
+    return expo?.isRunningInExpoGo?.() === true;
+}
+const REFUSED_BY_EXPO_GO = '[angular-native] Notifications does nothing here: expo-notifications cannot be loaded in Expo ' +
+    'Go on Android, which has had no push since SDK 53, so nothing is scheduled or received and ' +
+    'the permission is never granted. Use a development build.';
 //# sourceMappingURL=notifications.js.map

package/dist/notifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `Notifications`, bound to `expo-notifications`: everything the module does, as one injectable\n * service.\n *\n * ```ts\n * import { Notifications, TriggerType } from '@ng-native/expo/notifications';\n *\n * private readonly notifications = inject(Notifications);\n *\n * async remind(): Promise<void> {\n *   if (!(await this.notifications.permission.ensure())) return;\n *   await this.notifications.schedule({\n *     content: { title: 'Time to stretch' },\n *     trigger: { type: TriggerType.DAILY, hour: 9, minute: 0 },\n *   });\n * }\n *\n * constructor() {\n *   const tapped = this.notifications.take();\n *   if (tapped) this.router.navigateByUrl(routeFor(tapped));\n * }\n * ```\n *\n * The listeners are the part a hook used to be the only way to reach, and they are signals here.\n * *Received* is a notification arriving while the app is in front; the app usually decides whether\n * to show anything. *Responded* is the user having tapped one, which is a navigation instruction\n * and must not be missed - including the one that launched the app, which arrived before anything\n * was listening.\n *\n * The rest - permission, scheduling, what is on screen, the badge, Android's channels, the action\n * buttons of categories, the foreground handler, push tokens and topics, background tasks - is the\n * module's own functions under shorter names, with its own types. Without the module installed,\n * or in a test that provides nothing, every query answers empty and every change does nothing.\n * The push token methods ask for the permission first, since a token nobody can be shown anything\n * with fails silently: the push simply never arrives.\n */\nimport { DestroyRef, InjectionToken, Service, inject, signal, type Signal } from '@angular/core';\nimport type {\n  DevicePushToken,\n  Notification,\n  NotificationResponse,\n  SchedulableTriggerInputTypes,\n} from 'expo-notifications';\nimport { expoModule } from './native.ts';\nimport { Permission, UNAVAILABLE } from './permissions.ts';\n\ntype Expo = typeof import('expo-notifications');\n\n/**\n * The module's functions this service calls. The real module is one; a test provides a fake that\n * delivers notifications nobody sent.\n */\nexport type NativeNotifications = Pick<\n  Expo,\n  | 'addNotificationReceivedListener'\n  | 'addNotificationResponseReceivedListener'\n  | 'addNotificationsDroppedListener'\n  | 'addPushTokenListener'\n  | 'getLastNotificationResponseAsync'\n  | 'clearLastNotificationResponseAsync'\n  | 'getPermissionsAsync'\n  | 'requestPermissionsAsync'\n  | 'scheduleNotificationAsync'\n  | 'cancelScheduledNotificationAsync'\n  | 'cancelAllScheduledNotificationsAsync'\n  | 'getAllScheduledNotificationsAsync'\n  | 'getNextTriggerDateAsync'\n  | 'getPresentedNotificationsAsync'\n  | 'dismissNotificationAsync'\n  | 'dismissAllNotificationsAsync'\n  | 'getBadgeCountAsync'\n  | 'setBadgeCountAsync'\n  | 'getNotificationChannelsAsync'\n  | 'getNotificationChannelAsync'\n  | 'setNotificationChannelAsync'\n  | 'deleteNotificationChannelAsync'\n  | 'getNotificationChannelGroupsAsync'\n  | 'getNotificationChannelGroupAsync'\n  | 'setNotificationChannelGroupAsync'\n  | 'deleteNotificationChannelGroupAsync'\n  | 'getNotificationCategoriesAsync'\n  | 'setNotificationCategoryAsync'\n  | 'deleteNotificationCategoryAsync'\n  | 'setNotificationHandler'\n  | 'getExpoPushTokenAsync'\n  | 'getDevicePushTokenAsync'\n  | 'unregisterForNotificationsAsync'\n  | 'setAutoServerRegistrationEnabledAsync'\n  | 'subscribeToTopicAsync'\n  | 'unsubscribeFromTopicAsync'\n  | 'registerTaskAsync'\n  | 'unregisterTaskAsync'\n>;\n\ntype Args<K extends keyof NativeNotifications> = Parameters<NativeNotifications[K]>;\n\n/**\n * The kinds of trigger a schedule takes, as `expo-notifications`' own enum. Importing the enum\n * from the module loads the module, which a test in Node cannot; these are the same strings,\n * typed as the enum, so `{ type: TriggerType.DAILY, hour: 9, minute: 0 }` is accepted either way.\n */\nexport const TriggerType = {\n  CALENDAR: 'calendar',\n  DAILY: 'daily',\n  WEEKLY: 'weekly',\n  MONTHLY: 'monthly',\n  YEARLY: 'yearly',\n  DATE: 'date',\n  TIME_INTERVAL: 'timeInterval',\n} as unknown as typeof SchedulableTriggerInputTypes;\n\n@Service()\nexport class Notifications {\n  /** Overridden in a test to deliver a notification nobody sent. */\n  static readonly SOURCE = new InjectionToken<NativeNotifications | null>(\n    'angular-native.notificationsSource',\n    {\n      factory: () => expoModule('expo-notifications', () => require('expo-notifications') as Expo),\n    },\n  );\n\n  private readonly native = inject(Notifications.SOURCE);\n  private readonly received = signal<Notification | null>(null);\n  private readonly responded = signal<NotificationResponse | null>(null);\n  private readonly rolled = signal<DevicePushToken | null>(null);\n  private readonly drops = signal(0);\n  private readonly handled = new Set<string>();\n\n  /**\n   * The permission to show notifications. `ensure()` asks only if it has not been answered; for\n   * iOS's finer options (provisional, critical alerts), use {@link requestPermission}.\n   */\n  readonly permission: Permission;\n\n  constructor() {\n    const native = this.native;\n    this.permission = Permission.of(\n      () => native?.getPermissionsAsync?.() ?? Promise.resolve(UNAVAILABLE),\n      () => native?.requestPermissionsAsync?.() ?? Promise.resolve(UNAVAILABLE),\n    );\n    if (!native) return;\n    const subscriptions = [\n      native.addNotificationReceivedListener((notification) => this.received.set(notification)),\n      native.addNotificationResponseReceivedListener((response) => this.responded.set(response)),\n      // Android drops notifications when too many arrive at once while the app is not running;\n      // this is the only word that any went missing.\n      native.addNotificationsDroppedListener(() => this.drops.update((count) => count + 1)),\n      // A device push token can be rolled by the platform while the app is running; the old one\n      // then fails silently rather than delivering anything. This is the only way to find out.\n      native.addPushTokenListener((token) => this.rolled.set(token)),\n    ];\n    inject(DestroyRef).onDestroy(() => subscriptions.forEach((one) => one.remove()));\n    // The response that launched the app happened before anything was listening, so it has to be\n    // asked for rather than waited for. Without this a cold start from a notification does\n    // nothing, which is the single most common way this is got wrong. A platform that cannot say\n    // is the same as a launch without a notification.\n    void native\n      .getLastNotificationResponseAsync()\n      .then((response) => {\n        if (response && this.responded() === null) this.responded.set(response);\n      })\n      .catch(() => {});\n  }\n\n  /** The most recent notification that arrived while the app was in front. */\n  readonly latest: Signal<Notification | null> = this.received.asReadonly();\n\n  /**\n   * The most recent notification the user tapped, including the one that launched the app.\n   *\n   * A router usually wants `take()` instead: this stays set, so a screen that reacts to it will\n   * react again every time it is created.\n   */\n  readonly response: Signal<NotificationResponse | null> = this.responded.asReadonly();\n\n  /**\n   * The response, once.\n   *\n   * Routing on a tap is a one-off, and the signal is not: an effect on it fires again whenever\n   * its component is recreated, which sends the user back to a screen they navigated away from.\n   */\n  take(): NotificationResponse | null {\n    const response = this.responded();\n    if (!response) return null;\n\n    const id = response.notification.request.identifier + response.actionIdentifier;\n    if (this.handled.has(id)) return null;\n    this.handled.add(id);\n    return response;\n  }\n\n  /** Forgets the tap, here and in the module, so the next launch does not see it again. */\n  async clearResponse(): Promise<void> {\n    this.responded.set(null);\n    await this.native?.clearLastNotificationResponseAsync();\n  }\n\n  /** How many times Android has reported notifications dropped. Zero on iOS. */\n  readonly dropped: Signal<number> = this.drops.asReadonly();\n\n  /** Asks with iOS's finer options. The answer also updates {@link permission}. */\n  async requestPermission(...options: Args<'requestPermissionsAsync'>): Promise<boolean> {\n    if (!this.native) return false;\n    await this.native.requestPermissionsAsync(...options);\n    return this.permission.check();\n  }\n\n  /** Schedules a local notification, or shows it now with a null trigger. Null without the module. */\n  async schedule(...request: Args<'scheduleNotificationAsync'>): Promise<string | null> {\n    return (await this.native?.scheduleNotificationAsync(...request)) ?? null;\n  }\n\n  async cancel(identifier: string): Promise<void> {\n    await this.native?.cancelScheduledNotificationAsync(identifier);\n  }\n\n  async cancelAll(): Promise<void> {\n    await this.native?.cancelAllScheduledNotificationsAsync();\n  }\n\n  /** Every local notification still waiting for its trigger. */\n  async scheduled(): Promise<Awaited<ReturnType<Expo['getAllScheduledNotificationsAsync']>>> {\n    return (await this.native?.getAllScheduledNotificationsAsync()) ?? [];\n  }\n\n  /** When a trigger would next fire, in milliseconds since the epoch; null if it never will. */\n  async nextTriggerDate(...trigger: Args<'getNextTriggerDateAsync'>): Promise<number | null> {\n    return (await this.native?.getNextTriggerDateAsync(...trigger)) ?? null;\n  }\n\n  /** The notifications in the notification centre that are the app's. */\n  async presented(): Promise<Notification[]> {\n    return (await this.native?.getPresentedNotificationsAsync()) ?? [];\n  }\n\n  async dismiss(identifier: string): Promise<void> {\n    await this.native?.dismissNotificationAsync(identifier);\n  }\n\n  /** Clears every notification the app has on screen. A failure is ignored. */\n  dismissAll(): void {\n    void this.native?.dismissAllNotificationsAsync().catch(() => {});\n  }\n\n  async badge(): Promise<number> {\n    return (await this.native?.getBadgeCountAsync()) ?? 0;\n  }\n\n  /**\n   * iOS shows this on the icon; Android shows it where the launcher supports it. A failure is\n   * ignored.\n   */\n  setBadge(count: number): void {\n    void this.native?.setBadgeCountAsync(count).catch(() => {});\n  }\n\n  /** Android's notification channels. Empty on iOS, which has none. */\n  async channels(): Promise<Awaited<ReturnType<Expo['getNotificationChannelsAsync']>>> {\n    return (await this.native?.getNotificationChannelsAsync()) ?? [];\n  }\n\n  async channel(\n    identifier: string,\n  ): Promise<Awaited<ReturnType<Expo['getNotificationChannelAsync']>>> {\n    return (await this.native?.getNotificationChannelAsync(identifier)) ?? null;\n  }\n\n  /**\n   * Creates or updates an Android channel; a notification on Android 8 and later needs one to\n   * show at all. Null on iOS.\n   */\n  async setChannel(\n    ...channel: Args<'setNotificationChannelAsync'>\n  ): Promise<Awaited<ReturnType<Expo['setNotificationChannelAsync']>>> {\n    return (await this.native?.setNotificationChannelAsync(...channel)) ?? null;\n  }\n\n  async deleteChannel(identifier: string): Promise<void> {\n    await this.native?.deleteNotificationChannelAsync(identifier);\n  }\n\n  async channelGroups(): Promise<Awaited<ReturnType<Expo['getNotificationChannelGroupsAsync']>>> {\n    return (await this.native?.getNotificationChannelGroupsAsync()) ?? [];\n  }\n\n  async channelGroup(\n    identifier: string,\n  ): Promise<Awaited<ReturnType<Expo['getNotificationChannelGroupAsync']>>> {\n    return (await this.native?.getNotificationChannelGroupAsync(identifier)) ?? null;\n  }\n\n  async setChannelGroup(\n    ...group: Args<'setNotificationChannelGroupAsync'>\n  ): Promise<Awaited<ReturnType<Expo['setNotificationChannelGroupAsync']>>> {\n    return (await this.native?.setNotificationChannelGroupAsync(...group)) ?? null;\n  }\n\n  async deleteChannelGroup(identifier: string): Promise<void> {\n    await this.native?.deleteNotificationChannelGroupAsync(identifier);\n  }\n\n  /** The categories set: each a set of action buttons a notification opts into. */\n  async categories(): Promise<Awaited<ReturnType<Expo['getNotificationCategoriesAsync']>>> {\n    return (await this.native?.getNotificationCategoriesAsync()) ?? [];\n  }\n\n  /**\n   * Action buttons for notifications whose content names this category. A tap on one arrives as\n   * a response with the button's identifier, and the typed text as `userText` for a text input.\n   */\n  async setCategory(\n    ...category: Args<'setNotificationCategoryAsync'>\n  ): Promise<Awaited<ReturnType<Expo['setNotificationCategoryAsync']>> | null> {\n    return (await this.native?.setNotificationCategoryAsync(...category)) ?? null;\n  }\n\n  async deleteCategory(identifier: string): Promise<boolean> {\n    return (await this.native?.deleteNotificationCategoryAsync(identifier)) ?? false;\n  }\n\n  /**\n   * What a notification that arrives while the app is in front does: shown, silent, with a sound\n   * or a badge. Without a handler, it is not shown. Null removes the handler.\n   */\n  setHandler(...handler: Args<'setNotificationHandler'>): void {\n    this.native?.setNotificationHandler(...handler);\n  }\n\n  /**\n   * The token to hand a backend so it can send a push through Expo's service.\n   *\n   * Asks for the notification permission first - a token nobody can be shown anything with is not\n   * worth having. `projectId` defaults to the app's own EAS project; pass it explicitly for a bare\n   * workflow app, one still without EAS Build configured, or a token fetched outside\n   * `expo-notifications`' default resolution. Null without the permission or without the module.\n   */\n  async getExpoPushToken(projectId?: string): Promise<string | null> {\n    if (!this.native || !(await this.permission.ensure())) return null;\n    const token = await this.native.getExpoPushTokenAsync(projectId ? { projectId } : undefined);\n    return token.data;\n  }\n\n  /**\n   * The raw APNs (iOS) or FCM (Android) token, for a backend that talks to those services\n   * directly rather than through Expo's push service. Same permission and module rules as\n   * {@link getExpoPushToken}.\n   */\n  async getDevicePushToken(): Promise<DevicePushToken | null> {\n    if (!this.native || !(await this.permission.ensure())) return null;\n    return this.native.getDevicePushTokenAsync();\n  }\n\n  /**\n   * The device push token, each time the platform rolls it while the app is running.\n   *\n   * A rolled token is not the one a backend has on file, and sending to the old one fails\n   * silently - this is what tells an app to register the new one. Unset until a roll happens;\n   * most of an app's life this stays null.\n   */\n  readonly devicePushToken: Signal<DevicePushToken | null> = this.rolled.asReadonly();\n\n  /** Stops the device receiving pushes until a token is asked for again. */\n  async unregister(): Promise<void> {\n    await this.native?.unregisterForNotificationsAsync();\n  }\n\n  /** Whether Expo re-registers the device token with its push service by itself. */\n  async setAutoServerRegistration(enabled: boolean): Promise<void> {\n    await this.native?.setAutoServerRegistrationEnabledAsync(enabled);\n  }\n\n  /** Android: receive pushes sent to an FCM topic. */\n  async subscribeToTopic(topic: string): Promise<void> {\n    await this.native?.subscribeToTopicAsync(topic);\n  }\n\n  async unsubscribeFromTopic(topic: string): Promise<void> {\n    await this.native?.unsubscribeFromTopicAsync(topic);\n  }\n\n  /**\n   * Runs a task defined with `expo-task-manager` when a notification arrives in the background.\n   * The task itself is defined at the top level of `main.ts`, since it runs without the app.\n   */\n  async registerTask(name: string): Promise<void> {\n    await this.native?.registerTaskAsync(name);\n  }\n\n  async unregisterTask(name: string): Promise<void> {\n    await this.native?.unregisterTaskAsync(name);\n  }\n}\n"]}
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `Notifications`, bound to `expo-notifications`: everything the module does, as one injectable\n * service.\n *\n * ```ts\n * import { Notifications, TriggerType } from '@ng-native/expo/notifications';\n *\n * private readonly notifications = inject(Notifications);\n *\n * async remind(): Promise<void> {\n *   if (!(await this.notifications.permission.ensure())) return;\n *   await this.notifications.schedule({\n *     content: { title: 'Time to stretch' },\n *     trigger: { type: TriggerType.DAILY, hour: 9, minute: 0 },\n *   });\n * }\n *\n * constructor() {\n *   const tapped = this.notifications.take();\n *   if (tapped) this.router.navigateByUrl(routeFor(tapped));\n * }\n * ```\n *\n * The listeners are the part a hook used to be the only way to reach, and they are signals here.\n * *Received* is a notification arriving while the app is in front; the app usually decides whether\n * to show anything. *Responded* is the user having tapped one, which is a navigation instruction\n * and must not be missed - including the one that launched the app, which arrived before anything\n * was listening.\n *\n * The rest - permission, scheduling, what is on screen, the badge, Android's channels, the action\n * buttons of categories, the foreground handler, push tokens and topics, background tasks - is the\n * module's own functions under shorter names, with its own types. Without the module installed,\n * or in a test that provides nothing, every query answers empty and every change does nothing.\n * The push token methods ask for the permission first, since a token nobody can be shown anything\n * with fails silently: the push simply never arrives.\n */\nimport { DestroyRef, InjectionToken, Service, inject, signal, type Signal } from '@angular/core';\nimport type {\n  DevicePushToken,\n  Notification,\n  NotificationResponse,\n  SchedulableTriggerInputTypes,\n} from 'expo-notifications';\nimport { currentPlatform, expoModule, optional, present } from './native.ts';\nimport { Permission, UNAVAILABLE } from './permissions.ts';\n\ntype Expo = typeof import('expo-notifications');\n\n/**\n * The module's functions this service calls. The real module is one; a test provides a fake that\n * delivers notifications nobody sent.\n */\nexport type NativeNotifications = Pick<\n  Expo,\n  | 'addNotificationReceivedListener'\n  | 'addNotificationResponseReceivedListener'\n  | 'addNotificationsDroppedListener'\n  | 'addPushTokenListener'\n  | 'getLastNotificationResponseAsync'\n  | 'clearLastNotificationResponseAsync'\n  | 'getPermissionsAsync'\n  | 'requestPermissionsAsync'\n  | 'scheduleNotificationAsync'\n  | 'cancelScheduledNotificationAsync'\n  | 'cancelAllScheduledNotificationsAsync'\n  | 'getAllScheduledNotificationsAsync'\n  | 'getNextTriggerDateAsync'\n  | 'getPresentedNotificationsAsync'\n  | 'dismissNotificationAsync'\n  | 'dismissAllNotificationsAsync'\n  | 'getBadgeCountAsync'\n  | 'setBadgeCountAsync'\n  | 'getNotificationChannelsAsync'\n  | 'getNotificationChannelAsync'\n  | 'setNotificationChannelAsync'\n  | 'deleteNotificationChannelAsync'\n  | 'getNotificationChannelGroupsAsync'\n  | 'getNotificationChannelGroupAsync'\n  | 'setNotificationChannelGroupAsync'\n  | 'deleteNotificationChannelGroupAsync'\n  | 'getNotificationCategoriesAsync'\n  | 'setNotificationCategoryAsync'\n  | 'deleteNotificationCategoryAsync'\n  | 'setNotificationHandler'\n  | 'getExpoPushTokenAsync'\n  | 'getDevicePushTokenAsync'\n  | 'unregisterForNotificationsAsync'\n  | 'setAutoServerRegistrationEnabledAsync'\n  | 'subscribeToTopicAsync'\n  | 'unsubscribeFromTopicAsync'\n  | 'registerTaskAsync'\n  | 'unregisterTaskAsync'\n>;\n\ntype Args<K extends keyof NativeNotifications> = Parameters<NativeNotifications[K]>;\n\n/**\n * The kinds of trigger a schedule takes, as `expo-notifications`' own enum. Importing the enum\n * from the module loads the module, which a test in Node cannot; these are the same strings,\n * typed as the enum, so `{ type: TriggerType.DAILY, hour: 9, minute: 0 }` is accepted either way.\n */\nexport const TriggerType = {\n  CALENDAR: 'calendar',\n  DAILY: 'daily',\n  WEEKLY: 'weekly',\n  MONTHLY: 'monthly',\n  YEARLY: 'yearly',\n  DATE: 'date',\n  TIME_INTERVAL: 'timeInterval',\n} as unknown as typeof SchedulableTriggerInputTypes;\n\n@Service()\nexport class Notifications {\n  /** Overridden in a test to deliver a notification nobody sent. */\n  static readonly SOURCE = new InjectionToken<NativeNotifications | null>(\n    'angular-native.notificationsSource',\n    {\n      factory: () => {\n        if (refusedByExpoGo()) {\n          console.warn(REFUSED_BY_EXPO_GO);\n          return null;\n        }\n        return expoModule('expo-notifications', () => require('expo-notifications') as Expo);\n      },\n    },\n  );\n\n  private readonly native = inject(Notifications.SOURCE);\n  private readonly received = signal<Notification | null>(null);\n  private readonly responded = signal<NotificationResponse | null>(null);\n  private readonly rolled = signal<DevicePushToken | null>(null);\n  private readonly drops = signal(0);\n  private readonly handled = new Set<string>();\n\n  /**\n   * The permission to show notifications. `ensure()` asks only if it has not been answered; for\n   * iOS's finer options (provisional, critical alerts), use {@link requestPermission}.\n   */\n  readonly permission: Permission;\n\n  constructor() {\n    const native = this.native;\n    this.permission = Permission.of(\n      () => native?.getPermissionsAsync?.() ?? Promise.resolve(UNAVAILABLE),\n      () => native?.requestPermissionsAsync?.() ?? Promise.resolve(UNAVAILABLE),\n    );\n    // Its listeners only where the module is there; missing, what the app calls says so.\n    const live = present(native);\n    if (!live) return;\n    const subscriptions = [\n      live.addNotificationReceivedListener((notification) => this.received.set(notification)),\n      live.addNotificationResponseReceivedListener((response) => this.responded.set(response)),\n      // Android drops notifications when too many arrive at once while the app is not running;\n      // this is the only word that any went missing.\n      live.addNotificationsDroppedListener(() => this.drops.update((count) => count + 1)),\n      // A device push token can be rolled by the platform while the app is running; the old one\n      // then fails silently rather than delivering anything. This is the only way to find out.\n      live.addPushTokenListener((token) => this.rolled.set(token)),\n    ];\n    inject(DestroyRef).onDestroy(() => subscriptions.forEach((one) => one.remove()));\n    // The response that launched the app happened before anything was listening, so it has to be\n    // asked for rather than waited for. Without this a cold start from a notification does\n    // nothing, which is the single most common way this is got wrong. A platform that cannot say\n    // is the same as a launch without a notification.\n    void live\n      .getLastNotificationResponseAsync()\n      .then((response) => {\n        if (response && this.responded() === null) this.responded.set(response);\n      })\n      .catch(() => {});\n  }\n\n  /** The most recent notification that arrived while the app was in front. */\n  readonly latest: Signal<Notification | null> = this.received.asReadonly();\n\n  /**\n   * The most recent notification the user tapped, including the one that launched the app.\n   *\n   * A router usually wants `take()` instead: this stays set, so a screen that reacts to it will\n   * react again every time it is created.\n   */\n  readonly response: Signal<NotificationResponse | null> = this.responded.asReadonly();\n\n  /**\n   * The response, once.\n   *\n   * Routing on a tap is a one-off, and the signal is not: an effect on it fires again whenever\n   * its component is recreated, which sends the user back to a screen they navigated away from.\n   */\n  take(): NotificationResponse | null {\n    const response = this.responded();\n    if (!response) return null;\n\n    const id = response.notification.request.identifier + response.actionIdentifier;\n    if (this.handled.has(id)) return null;\n    this.handled.add(id);\n    return response;\n  }\n\n  /** Forgets the tap, here and in the module, so the next launch does not see it again. */\n  async clearResponse(): Promise<void> {\n    this.responded.set(null);\n    await this.native?.clearLastNotificationResponseAsync();\n  }\n\n  /** How many times Android has reported notifications dropped. Zero on iOS. */\n  readonly dropped: Signal<number> = this.drops.asReadonly();\n\n  /** Asks with iOS's finer options. The answer also updates {@link permission}. */\n  async requestPermission(...options: Args<'requestPermissionsAsync'>): Promise<boolean> {\n    if (!this.native) return false;\n    await this.native.requestPermissionsAsync(...options);\n    return this.permission.check();\n  }\n\n  /** Schedules a local notification, or shows it now with a null trigger. Null without the module. */\n  async schedule(...request: Args<'scheduleNotificationAsync'>): Promise<string | null> {\n    return (await this.native?.scheduleNotificationAsync(...request)) ?? null;\n  }\n\n  async cancel(identifier: string): Promise<void> {\n    await this.native?.cancelScheduledNotificationAsync(identifier);\n  }\n\n  async cancelAll(): Promise<void> {\n    await this.native?.cancelAllScheduledNotificationsAsync();\n  }\n\n  /** Every local notification still waiting for its trigger. */\n  async scheduled(): Promise<Awaited<ReturnType<Expo['getAllScheduledNotificationsAsync']>>> {\n    return (await this.native?.getAllScheduledNotificationsAsync()) ?? [];\n  }\n\n  /** When a trigger would next fire, in milliseconds since the epoch; null if it never will. */\n  async nextTriggerDate(...trigger: Args<'getNextTriggerDateAsync'>): Promise<number | null> {\n    return (await this.native?.getNextTriggerDateAsync(...trigger)) ?? null;\n  }\n\n  /** The notifications in the notification centre that are the app's. */\n  async presented(): Promise<Notification[]> {\n    return (await this.native?.getPresentedNotificationsAsync()) ?? [];\n  }\n\n  async dismiss(identifier: string): Promise<void> {\n    await this.native?.dismissNotificationAsync(identifier);\n  }\n\n  /** Clears every notification the app has on screen. A failure is ignored. */\n  dismissAll(): void {\n    void this.native?.dismissAllNotificationsAsync().catch(() => {});\n  }\n\n  async badge(): Promise<number> {\n    return (await this.native?.getBadgeCountAsync()) ?? 0;\n  }\n\n  /**\n   * iOS shows this on the icon; Android shows it where the launcher supports it. A failure is\n   * ignored.\n   */\n  setBadge(count: number): void {\n    void this.native?.setBadgeCountAsync(count).catch(() => {});\n  }\n\n  /** Android's notification channels. Empty on iOS, which has none. */\n  async channels(): Promise<Awaited<ReturnType<Expo['getNotificationChannelsAsync']>>> {\n    return (await this.native?.getNotificationChannelsAsync()) ?? [];\n  }\n\n  async channel(\n    identifier: string,\n  ): Promise<Awaited<ReturnType<Expo['getNotificationChannelAsync']>>> {\n    return (await this.native?.getNotificationChannelAsync(identifier)) ?? null;\n  }\n\n  /**\n   * Creates or updates an Android channel; a notification on Android 8 and later needs one to\n   * show at all. Null on iOS.\n   */\n  async setChannel(\n    ...channel: Args<'setNotificationChannelAsync'>\n  ): Promise<Awaited<ReturnType<Expo['setNotificationChannelAsync']>>> {\n    return (await this.native?.setNotificationChannelAsync(...channel)) ?? null;\n  }\n\n  async deleteChannel(identifier: string): Promise<void> {\n    await this.native?.deleteNotificationChannelAsync(identifier);\n  }\n\n  async channelGroups(): Promise<Awaited<ReturnType<Expo['getNotificationChannelGroupsAsync']>>> {\n    return (await this.native?.getNotificationChannelGroupsAsync()) ?? [];\n  }\n\n  async channelGroup(\n    identifier: string,\n  ): Promise<Awaited<ReturnType<Expo['getNotificationChannelGroupAsync']>>> {\n    return (await this.native?.getNotificationChannelGroupAsync(identifier)) ?? null;\n  }\n\n  async setChannelGroup(\n    ...group: Args<'setNotificationChannelGroupAsync'>\n  ): Promise<Awaited<ReturnType<Expo['setNotificationChannelGroupAsync']>>> {\n    return (await this.native?.setNotificationChannelGroupAsync(...group)) ?? null;\n  }\n\n  async deleteChannelGroup(identifier: string): Promise<void> {\n    await this.native?.deleteNotificationChannelGroupAsync(identifier);\n  }\n\n  /** The categories set: each a set of action buttons a notification opts into. */\n  async categories(): Promise<Awaited<ReturnType<Expo['getNotificationCategoriesAsync']>>> {\n    return (await this.native?.getNotificationCategoriesAsync()) ?? [];\n  }\n\n  /**\n   * Action buttons for notifications whose content names this category. A tap on one arrives as\n   * a response with the button's identifier, and the typed text as `userText` for a text input.\n   */\n  async setCategory(\n    ...category: Args<'setNotificationCategoryAsync'>\n  ): Promise<Awaited<ReturnType<Expo['setNotificationCategoryAsync']>> | null> {\n    return (await this.native?.setNotificationCategoryAsync(...category)) ?? null;\n  }\n\n  async deleteCategory(identifier: string): Promise<boolean> {\n    return (await this.native?.deleteNotificationCategoryAsync(identifier)) ?? false;\n  }\n\n  /**\n   * What a notification that arrives while the app is in front does: shown, silent, with a sound\n   * or a badge. Without a handler, it is not shown. Null removes the handler.\n   */\n  setHandler(...handler: Args<'setNotificationHandler'>): void {\n    this.native?.setNotificationHandler(...handler);\n  }\n\n  /**\n   * The token to hand a backend so it can send a push through Expo's service.\n   *\n   * Asks for the notification permission first - a token nobody can be shown anything with is not\n   * worth having. `projectId` defaults to the app's own EAS project; pass it explicitly for a bare\n   * workflow app, one still without EAS Build configured, or a token fetched outside\n   * `expo-notifications`' default resolution. Null without the permission or without the module.\n   */\n  async getExpoPushToken(projectId?: string): Promise<string | null> {\n    if (!this.native || !(await this.permission.ensure())) return null;\n    const token = await this.native.getExpoPushTokenAsync(projectId ? { projectId } : undefined);\n    return token.data;\n  }\n\n  /**\n   * The raw APNs (iOS) or FCM (Android) token, for a backend that talks to those services\n   * directly rather than through Expo's push service. Same permission and module rules as\n   * {@link getExpoPushToken}.\n   */\n  async getDevicePushToken(): Promise<DevicePushToken | null> {\n    if (!this.native || !(await this.permission.ensure())) return null;\n    return this.native.getDevicePushTokenAsync();\n  }\n\n  /**\n   * The device push token, each time the platform rolls it while the app is running.\n   *\n   * A rolled token is not the one a backend has on file, and sending to the old one fails\n   * silently - this is what tells an app to register the new one. Unset until a roll happens;\n   * most of an app's life this stays null.\n   */\n  readonly devicePushToken: Signal<DevicePushToken | null> = this.rolled.asReadonly();\n\n  /** Stops the device receiving pushes until a token is asked for again. */\n  async unregister(): Promise<void> {\n    await this.native?.unregisterForNotificationsAsync();\n  }\n\n  /** Whether Expo re-registers the device token with its push service by itself. */\n  async setAutoServerRegistration(enabled: boolean): Promise<void> {\n    await this.native?.setAutoServerRegistrationEnabledAsync(enabled);\n  }\n\n  /** Android: receive pushes sent to an FCM topic. */\n  async subscribeToTopic(topic: string): Promise<void> {\n    await this.native?.subscribeToTopicAsync(topic);\n  }\n\n  async unsubscribeFromTopic(topic: string): Promise<void> {\n    await this.native?.unsubscribeFromTopicAsync(topic);\n  }\n\n  /**\n   * Runs a task defined with `expo-task-manager` when a notification arrives in the background.\n   * The task itself is defined at the top level of `main.ts`, since it runs without the app.\n   */\n  async registerTask(name: string): Promise<void> {\n    await this.native?.registerTaskAsync(name);\n  }\n\n  async unregisterTask(name: string): Promise<void> {\n    await this.native?.unregisterTaskAsync(name);\n  }\n}\n\n/**\n * Whether this is Expo Go on Android, where `expo-notifications` cannot be imported.\n *\n * The package subscribes to push tokens as it is imported, and in Expo Go on Android, which has\n * had no push since SDK 53, that subscription throws. So the import fails there, local\n * notifications included, and no rebuild puts it right. Asked before the import and not caught\n * after it: Metro reports a module that throws as it loads as a fatal error itself, so the red\n * screen is up before anything here could catch it. With no module the service is what it is on\n * the web, and the app gets past the first screen that injects it.\n */\nfunction refusedByExpoGo(): boolean {\n  if (currentPlatform() !== 'android') return false;\n  const expo = optional(() => require('expo') as { isRunningInExpoGo?(): boolean });\n  return expo?.isRunningInExpoGo?.() === true;\n}\n\nconst REFUSED_BY_EXPO_GO =\n  '[angular-native] Notifications does nothing here: expo-notifications cannot be loaded in Expo ' +\n  'Go on Android, which has had no push since SDK 53, so nothing is scheduled or received and ' +\n  'the permission is never granted. Use a development build.';\n"]}

package/dist/observed.js

@@ -8,7 +8,8 @@
  * So this is that hook, as a signal: a value that starts at a stated default, is fetched once,
  * and follows the listener from then on.
  */
-import { DestroyRef, inject, signal } from '@angular/core';
+import { computed, DestroyRef, inject, signal } from '@angular/core';
+import { present } from "./native.js";
 /**
  * A signal fed by an `Observed`, subscribed until the injector it was made in is destroyed.
  *
@@ -25,6 +26,9 @@ export function observed(source, initial) {
     ...(ngDevMode ? [{ debugName: "value" }] : /* istanbul ignore next */ []));
     if (!source)
         return value.asReadonly();
+    // A module missing from the build says so when the value is read, not as it is subscribed.
+    if (!present(source))
+        return computed(() => source.current);
     // Failures are swallowed rather than surfaced: a device with no battery API is a device where
     // the default is the honest answer, and nothing on screen should break over it. The first
     // answer was asked for before anything was heard, so it is older than anything the listener

package/dist/observed.js.map

@@ -1 +1 @@
-{"version":3,"file":"observed.js","sourceRoot":"","sources":["../src/observed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AAQxE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAI,MAA0B,EAAE,OAAU;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO;8EAAC,CAAC;IAC9B,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC;IAEvC,8FAA8F;IAC9F,0FAA0F;IAC1F,4FAA4F;IAC5F,wDAAwD;IACxD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CACxB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EACpC,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;IACF,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAC1B,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,KAAK,GAAG,IAAI,CAAC;QACb,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC,CAAC,CACH,CAAC;IACF,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAyB,EACzB,SAA+D;IAE/D,OAAO;QACL,OAAO;QACP,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;YACzC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * The shape nearly every device-state module has, and the one part of it that is React-only.\n *\n * `getNetworkStateAsync` + `addNetworkStateListener` + `useNetworkState`. `getBatteryLevelAsync` +\n * `addBatteryLevelListener` + `useBatteryLevel`. The two functions are plain; the hook is React\n * state around them, and a hook is the only surface some of these offer for *reading over time*.\n *\n * So this is that hook, as a signal: a value that starts at a stated default, is fetched once,\n * and follows the listener from then on.\n */\nimport { DestroyRef, inject, signal, type Signal } from '@angular/core';\n\n/** A value the platform knows now and will say more about later. */\nexport interface Observed<T> {\n  current(): Promise<T>;\n  subscribe(listener: (value: T) => void): () => void;\n}\n\n/**\n * A signal fed by an `Observed`, subscribed until the injector it was made in is destroyed.\n *\n * Called in an injection context, as `inject()` is - a field initialiser or a constructor - so\n * that for a root service the subscription ends with the app. An app cares about the battery for\n * as long as it is running, and not after: one that is mounted and unmounted would otherwise leave\n * a listener behind each time.\n *\n * `initial` is what the value is before the platform has answered, which is always at least one\n * turn: every one of these getters is asynchronous even when the answer is already in memory.\n */\nexport function observed<T>(source: Observed<T> | null, initial: T): Signal<T> {\n  const value = signal(initial);\n  if (!source) return value.asReadonly();\n\n  // Failures are swallowed rather than surfaced: a device with no battery API is a device where\n  // the default is the honest answer, and nothing on screen should break over it. The first\n  // answer was asked for before anything was heard, so it is older than anything the listener\n  // has said by the time it arrives, and is dropped then.\n  let heard = false;\n  void source.current().then(\n    (first) => heard || value.set(first),\n    () => {},\n  );\n  inject(DestroyRef).onDestroy(\n    source.subscribe((next) => {\n      heard = true;\n      value.set(next);\n    }),\n  );\n  return value.asReadonly();\n}\n\n/**\n * An `Observed` from the pair of functions these modules always expose.\n *\n * Named for what it makes rather than `from`, which is what it was: the package index re-exports\n * everything, and a bare `from` in an app's import list says nothing about what it is from.\n */\nexport function observedFrom<T>(\n  current: () => Promise<T>,\n  subscribe: (listener: (value: T) => void) => { remove(): void },\n): Observed<T> {\n  return {\n    current,\n    subscribe: (listener) => {\n      const subscription = subscribe(listener);\n      return () => subscription.remove();\n    },\n  };\n}\n"]}
+{"version":3,"file":"observed.js","sourceRoot":"","sources":["../src/observed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAQtC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAI,MAA0B,EAAE,OAAU;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO;8EAAC,CAAC;IAC9B,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC;IACvC,2FAA2F;IAC3F,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAgB,CAAC,CAAC;IAErE,8FAA8F;IAC9F,0FAA0F;IAC1F,4FAA4F;IAC5F,wDAAwD;IACxD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CACxB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EACpC,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;IACF,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAC1B,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,KAAK,GAAG,IAAI,CAAC;QACb,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC,CAAC,CACH,CAAC;IACF,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,OAAyB,EACzB,SAA+D;IAE/D,OAAO;QACL,OAAO;QACP,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,MAAM,YAAY,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;YACzC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QACrC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * The shape nearly every device-state module has, and the one part of it that is React-only.\n *\n * `getNetworkStateAsync` + `addNetworkStateListener` + `useNetworkState`. `getBatteryLevelAsync` +\n * `addBatteryLevelListener` + `useBatteryLevel`. The two functions are plain; the hook is React\n * state around them, and a hook is the only surface some of these offer for *reading over time*.\n *\n * So this is that hook, as a signal: a value that starts at a stated default, is fetched once,\n * and follows the listener from then on.\n */\nimport { computed, DestroyRef, inject, signal, type Signal } from '@angular/core';\nimport { present } from './native.ts';\n\n/** A value the platform knows now and will say more about later. */\nexport interface Observed<T> {\n  current(): Promise<T>;\n  subscribe(listener: (value: T) => void): () => void;\n}\n\n/**\n * A signal fed by an `Observed`, subscribed until the injector it was made in is destroyed.\n *\n * Called in an injection context, as `inject()` is - a field initialiser or a constructor - so\n * that for a root service the subscription ends with the app. An app cares about the battery for\n * as long as it is running, and not after: one that is mounted and unmounted would otherwise leave\n * a listener behind each time.\n *\n * `initial` is what the value is before the platform has answered, which is always at least one\n * turn: every one of these getters is asynchronous even when the answer is already in memory.\n */\nexport function observed<T>(source: Observed<T> | null, initial: T): Signal<T> {\n  const value = signal(initial);\n  if (!source) return value.asReadonly();\n  // A module missing from the build says so when the value is read, not as it is subscribed.\n  if (!present(source)) return computed(() => source.current as never);\n\n  // Failures are swallowed rather than surfaced: a device with no battery API is a device where\n  // the default is the honest answer, and nothing on screen should break over it. The first\n  // answer was asked for before anything was heard, so it is older than anything the listener\n  // has said by the time it arrives, and is dropped then.\n  let heard = false;\n  void source.current().then(\n    (first) => heard || value.set(first),\n    () => {},\n  );\n  inject(DestroyRef).onDestroy(\n    source.subscribe((next) => {\n      heard = true;\n      value.set(next);\n    }),\n  );\n  return value.asReadonly();\n}\n\n/**\n * An `Observed` from the pair of functions these modules always expose.\n *\n * Named for what it makes rather than `from`, which is what it was: the package index re-exports\n * everything, and a bare `from` in an app's import list says nothing about what it is from.\n */\nexport function observedFrom<T>(\n  current: () => Promise<T>,\n  subscribe: (listener: (value: T) => void) => { remove(): void },\n): Observed<T> {\n  return {\n    current,\n    subscribe: (listener) => {\n      const subscription = subscribe(listener);\n      return () => subscription.remove();\n    },\n  };\n}\n"]}

package/dist/orientation.js

@@ -8,7 +8,7 @@
  */
 import { InjectionToken, Service, computed, inject } from '@angular/core';
 import { observed, observedFrom } from "./observed.js";
-import { expoModule } from "./native.js";
+import { expoModule, present } from "./native.js";
 import * as i0 from "@angular/core";
 const NOTHING = {
     reported: null,
@@ -22,6 +22,9 @@ export class DeviceOrientation {
             const expo = expoModule('expo-screen-orientation', () => require('expo-screen-orientation'));
             if (!expo)
                 return NOTHING;
+            // Missing from the build: stand-ins, to say so when they are used.
+            if (!present(expo))
+                return { reported: expo, lock: expo, unlock: expo };
             const ORIENTATIONS = {
                 [expo.Orientation.UNKNOWN]: 'unknown',
                 [expo.Orientation.PORTRAIT_UP]: 'portrait',

package/dist/orientation.js.map

@@ -1 +1 @@
-{"version":3,"file":"orientation.js","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `DeviceOrientation`, bound to `expo-screen-orientation`.\n *\n * Named for the device rather than the screen because that is what it reports: a layout asking\n * which way *it* is laid out wants the `orientation` media feature, which needs none of this.\n * This is what a camera preview or a video player needs - a screen locked to portrait still has a\n * phone that is sideways.\n */\nimport { InjectionToken, Service, computed, inject, type Signal } from '@angular/core';\nimport { observed, observedFrom, type Observed } from './observed.ts';\nimport { expoModule } from './native.ts';\n\nexport type Orientation =\n  'unknown' | 'portrait' | 'portrait-upside-down' | 'landscape-left' | 'landscape-right';\n\n/** What a screen may rotate to. `default` is portrait plus, on a phone, nothing else. */\nexport type OrientationLock = 'default' | 'all' | 'portrait' | 'landscape';\n\nexport interface OrientationSource {\n  readonly reported: Observed<Orientation> | null;\n  lock(lock: OrientationLock): Promise<void>;\n  unlock(): Promise<void>;\n}\n\nconst NOTHING: OrientationSource = {\n  reported: null,\n  lock: () => Promise.resolve(),\n  unlock: () => Promise.resolve(),\n};\n\n@Service()\nexport class DeviceOrientation {\n  /** Overridden in a test to rotate a device that is not there. */\n  static readonly SOURCE = new InjectionToken<OrientationSource>(\n    'angular-native.orientationSource',\n    {\n      factory: () => {\n        const expo = expoModule(\n          'expo-screen-orientation',\n          () => require('expo-screen-orientation') as typeof import('expo-screen-orientation'),\n        );\n        if (!expo) return NOTHING;\n\n        const ORIENTATIONS: Record<number, Orientation> = {\n          [expo.Orientation.UNKNOWN]: 'unknown',\n          [expo.Orientation.PORTRAIT_UP]: 'portrait',\n          [expo.Orientation.PORTRAIT_DOWN]: 'portrait-upside-down',\n          [expo.Orientation.LANDSCAPE_LEFT]: 'landscape-left',\n          [expo.Orientation.LANDSCAPE_RIGHT]: 'landscape-right',\n        };\n        const LOCKS: Record<OrientationLock, import('expo-screen-orientation').OrientationLock> = {\n          default: expo.OrientationLock.DEFAULT,\n          all: expo.OrientationLock.ALL,\n          portrait: expo.OrientationLock.PORTRAIT,\n          landscape: expo.OrientationLock.LANDSCAPE,\n        };\n\n        return {\n          reported: observedFrom(\n            async () => ORIENTATIONS[await expo.getOrientationAsync()] ?? 'unknown',\n            (listener) =>\n              expo.addOrientationChangeListener(({ orientationInfo }) =>\n                listener(ORIENTATIONS[orientationInfo.orientation] ?? 'unknown'),\n              ),\n          ),\n          lock: (lock) => expo.lockAsync(LOCKS[lock]),\n          unlock: () => expo.unlockAsync(),\n        };\n      },\n    },\n  );\n\n  private readonly source = inject(DeviceOrientation.SOURCE);\n\n  readonly orientation: Signal<Orientation> = observed(this.source.reported, 'unknown');\n\n  readonly landscape: Signal<boolean> = computed(() => this.orientation().startsWith('landscape'));\n\n  /**\n   * Pin the screen. Returns the function that unpins it, so a screen that wants landscape while\n   * it is up can hand it to `DestroyRef.onDestroy` and not think about it again.\n   */\n  lock(lock: OrientationLock): () => void {\n    // A stack, as the status bar's is: a screen pushed over one with a lock of its own releases\n    // only its own, and the lock beneath it comes back rather than the whole app unlocking.\n    const entry = { lock };\n    this.locks.push(entry);\n    void this.source.lock(lock);\n    return () => {\n      const at = this.locks.indexOf(entry);\n      if (at === -1) return;\n      this.locks.splice(at, 1);\n      if (at < this.locks.length) return;\n      const below = this.locks.at(-1);\n      void (below ? this.source.lock(below.lock) : this.source.unlock());\n    };\n  }\n\n  /** Every lock not yet released, the one in force last. */\n  private readonly locks: { readonly lock: OrientationLock }[] = [];\n}\n"]}
+{"version":3,"file":"orientation.js","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `DeviceOrientation`, bound to `expo-screen-orientation`.\n *\n * Named for the device rather than the screen because that is what it reports: a layout asking\n * which way *it* is laid out wants the `orientation` media feature, which needs none of this.\n * This is what a camera preview or a video player needs - a screen locked to portrait still has a\n * phone that is sideways.\n */\nimport { InjectionToken, Service, computed, inject, type Signal } from '@angular/core';\nimport { observed, observedFrom, type Observed } from './observed.ts';\nimport { expoModule, present } from './native.ts';\n\nexport type Orientation =\n  'unknown' | 'portrait' | 'portrait-upside-down' | 'landscape-left' | 'landscape-right';\n\n/** What a screen may rotate to. `default` is portrait plus, on a phone, nothing else. */\nexport type OrientationLock = 'default' | 'all' | 'portrait' | 'landscape';\n\nexport interface OrientationSource {\n  readonly reported: Observed<Orientation> | null;\n  lock(lock: OrientationLock): Promise<void>;\n  unlock(): Promise<void>;\n}\n\nconst NOTHING: OrientationSource = {\n  reported: null,\n  lock: () => Promise.resolve(),\n  unlock: () => Promise.resolve(),\n};\n\n@Service()\nexport class DeviceOrientation {\n  /** Overridden in a test to rotate a device that is not there. */\n  static readonly SOURCE = new InjectionToken<OrientationSource>(\n    'angular-native.orientationSource',\n    {\n      factory: () => {\n        const expo = expoModule(\n          'expo-screen-orientation',\n          () => require('expo-screen-orientation') as typeof import('expo-screen-orientation'),\n        );\n        if (!expo) return NOTHING;\n        // Missing from the build: stand-ins, to say so when they are used.\n        if (!present(expo)) return { reported: expo, lock: expo, unlock: expo } as never;\n\n        const ORIENTATIONS: Record<number, Orientation> = {\n          [expo.Orientation.UNKNOWN]: 'unknown',\n          [expo.Orientation.PORTRAIT_UP]: 'portrait',\n          [expo.Orientation.PORTRAIT_DOWN]: 'portrait-upside-down',\n          [expo.Orientation.LANDSCAPE_LEFT]: 'landscape-left',\n          [expo.Orientation.LANDSCAPE_RIGHT]: 'landscape-right',\n        };\n        const LOCKS: Record<OrientationLock, import('expo-screen-orientation').OrientationLock> = {\n          default: expo.OrientationLock.DEFAULT,\n          all: expo.OrientationLock.ALL,\n          portrait: expo.OrientationLock.PORTRAIT,\n          landscape: expo.OrientationLock.LANDSCAPE,\n        };\n\n        return {\n          reported: observedFrom(\n            async () => ORIENTATIONS[await expo.getOrientationAsync()] ?? 'unknown',\n            (listener) =>\n              expo.addOrientationChangeListener(({ orientationInfo }) =>\n                listener(ORIENTATIONS[orientationInfo.orientation] ?? 'unknown'),\n              ),\n          ),\n          lock: (lock) => expo.lockAsync(LOCKS[lock]),\n          unlock: () => expo.unlockAsync(),\n        };\n      },\n    },\n  );\n\n  private readonly source = inject(DeviceOrientation.SOURCE);\n\n  readonly orientation: Signal<Orientation> = observed(this.source.reported, 'unknown');\n\n  readonly landscape: Signal<boolean> = computed(() => this.orientation().startsWith('landscape'));\n\n  /**\n   * Pin the screen. Returns the function that unpins it, so a screen that wants landscape while\n   * it is up can hand it to `DestroyRef.onDestroy` and not think about it again.\n   */\n  lock(lock: OrientationLock): () => void {\n    // A stack, as the status bar's is: a screen pushed over one with a lock of its own releases\n    // only its own, and the lock beneath it comes back rather than the whole app unlocking.\n    const entry = { lock };\n    this.locks.push(entry);\n    void this.source.lock(lock);\n    return () => {\n      const at = this.locks.indexOf(entry);\n      if (at === -1) return;\n      this.locks.splice(at, 1);\n      if (at < this.locks.length) return;\n      const below = this.locks.at(-1);\n      void (below ? this.source.lock(below.lock) : this.source.unlock());\n    };\n  }\n\n  /** Every lock not yet released, the one in force last. */\n  private readonly locks: { readonly lock: OrientationLock }[] = [];\n}\n"]}

package/dist/player.d.ts

@@ -5,7 +5,7 @@
  * ```ts
  * protected readonly player = videoPlayer(this.source, { timeUpdate: 0.5 });
  *
- * // <expo-video [player]="player.native" />
+ * // <expo-video [player]="player.id" />
  * // {{ player.state().currentTime }}
  * ```
  *
@@ -91,8 +91,15 @@ export declare function watchAudioPlayer(player: NativePlayer | null): {
     stop: () => void;
 };
 export interface Player<T> {
-    /** The module's own player, for `play()`, `seekBy()`, and to hand to its view. */
+    /** The module's own player, for `play()`, `seekBy()` and the rest. */
     readonly native: T;
+    /**
+     * What `<expo-video [player]>` takes: the player's shared-object id. The view's `player` prop is
+     * a number on the native side, and `expo-video`'s own `VideoView` passes this id rather than the
+     * player; given the player itself, the view has no player and draws nothing, while the video
+     * keeps playing with nothing on screen.
+     */
+    readonly id: number | undefined;
     readonly state: Signal<PlayerState>;
 }
 /**

package/dist/player.js

@@ -5,7 +5,7 @@
  * ```ts
  * protected readonly player = videoPlayer(this.source, { timeUpdate: 0.5 });
  *
- * // <expo-video [player]="player.native" />
+ * // <expo-video [player]="player.id" />
  * // {{ player.state().currentTime }}
  * ```
  *
@@ -123,6 +123,7 @@ export function watchAudioPlayer(player) {
 export function ownPlayer(native, watch) {
     const { state, stop } = watch();
     inject(DestroyRef).onDestroy(stop);
-    return { native, state };
+    const id = native.__expo_shared_object_id__;
+    return { native, id, state };
 }
 //# sourceMappingURL=player.js.map

package/dist/player.js.map

@@ -1 +1 @@
-{"version":3,"file":"player.js","sourceRoot":"","sources":["../src/player.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * What `videoPlayer` (`@ng-native/expo/video`) and `audioPlayer` (`@ng-native/expo/audio`) share:\n * the `Player` each answers, its state, and the watchers that keep that state.\n *\n * ```ts\n * protected readonly player = videoPlayer(this.source, { timeUpdate: 0.5 });\n *\n * // <expo-video [player]=\"player.native\" />\n * // {{ player.state().currentTime }}\n * ```\n *\n * `useVideoPlayer` and `useAudioPlayer` are the documented way in, and the player they hand back\n * is not the React part - `createVideoPlayer` gives the same object. What the hooks add is the\n * two things a component actually needs and cannot get otherwise: the player is *released* when\n * the component goes, and its changing state is *readable*, because the player's own properties\n * are plain mutable fields that no template can watch.\n *\n * The player itself is passed straight through: it is a shared object with `play()`, `seekBy()`\n * and the rest already on it, and wrapping those would be a second place for each to be wrong.\n *\n * Each player has an entry point of its own because each needs its own native module: Metro fails\n * a build on a `require` it cannot resolve, so one entry point for both made an app install both.\n */\nimport { DestroyRef, inject, signal, type Signal } from '@angular/core';\n\n/** The player's own status, which is the same word in both modules. */\nexport type PlayerStatus = 'idle' | 'loading' | 'readyToPlay' | 'error';\n\n/** The slice of a player this reads. Both modules' players satisfy it structurally. */\nexport interface NativePlayer {\n  addListener(event: string, listener: (payload: never) => void): { remove(): void };\n  release?(): void;\n  /** Seconds between `timeUpdate` events. Zero, its default, means the event never fires. `expo-video` only. */\n  timeUpdateEventInterval?: number;\n  /** Read directly rather than from an event: `expo-audio`'s status carries no volume field. */\n  readonly volume?: number;\n  /** `expo-video` only, where an event says it only once it changes. */\n  readonly muted?: boolean;\n}\n\n/**\n * `expo-audio`'s one status event, `playbackStatusUpdate`. Unlike `expo-video`, which splits its\n * state across several named events, `AudioPlayer` reports everything - including errors - on a\n * single event, at the interval `updateInterval` was created with.\n */\nexport interface NativeAudioStatus {\n  readonly playing: boolean;\n  readonly mute: boolean;\n  readonly duration: number;\n  readonly currentTime: number;\n  readonly isLoaded: boolean;\n  readonly didJustFinish: boolean;\n  readonly error: string | null;\n}\n\nexport interface PlayerState {\n  readonly playing: boolean;\n  readonly status: PlayerStatus;\n  /** Seconds. Only moves while `timeUpdateEventInterval` is non-zero. */\n  readonly currentTime: number;\n  readonly duration: number;\n  readonly muted: boolean;\n  readonly volume: number;\n  /** Set once playback has run to the end, and cleared when it starts again. */\n  readonly ended: boolean;\n}\n\nconst INITIAL: PlayerState = {\n  playing: false,\n  status: 'idle',\n  currentTime: 0,\n  duration: 0,\n  muted: false,\n  volume: 1,\n  ended: false,\n};\n\n/**\n * Watch an `expo-video` player, and stop watching when the caller is done with it.\n *\n * `timeUpdate` defaults to off, so `currentTime` would never move. A caller that wants a progress\n * bar asks for one by passing an interval, and one that does not pays nothing: the event is the\n * most frequent thing the player emits.\n *\n * `expo-audio`'s player reports its state differently - one event, not several - so it is watched\n * by `watchAudioPlayer` below rather than this function.\n */\nexport function watchPlayer(\n  player: NativePlayer | null,\n  options: { timeUpdate?: number } = {},\n): { state: Signal<PlayerState>; stop: () => void } {\n  // Both are the player's own, set where it was made: no event says either until it changes.\n  const state = signal({\n    ...INITIAL,\n    muted: player?.muted ?? INITIAL.muted,\n    volume: player?.volume ?? INITIAL.volume,\n  });\n  if (!player) return { state: state.asReadonly(), stop: () => {} };\n\n  const patch = (change: Partial<PlayerState>) => state.update((last) => ({ ...last, ...change }));\n  const subscriptions = [\n    listen(player, 'statusChange', ({ status }: { status: PlayerStatus }) => patch({ status })),\n    listen(player, 'playingChange', ({ isPlaying }: { isPlaying: boolean }) =>\n      patch({ playing: isPlaying, ...(isPlaying ? { ended: false } : {}) }),\n    ),\n    listen(player, 'mutedChange', ({ muted }: { muted: boolean }) => patch({ muted })),\n    listen(player, 'volumeChange', ({ volume }: { volume: number }) => patch({ volume })),\n    listen(player, 'playToEnd', () => patch({ ended: true, playing: false })),\n    listen(player, 'timeUpdate', ({ currentTime }: { currentTime: number }) =>\n      patch({ currentTime }),\n    ),\n    // What was the old source's starts over. Muted and volume are the player's, and it keeps them.\n    listen(player, 'sourceChange', () =>\n      patch({ status: 'loading', playing: false, currentTime: 0, duration: 0, ended: false }),\n    ),\n    // The only event that says how long the video is: nothing else carries a duration.\n    listen(player, 'sourceLoad', ({ duration }: { duration: number }) => patch({ duration })),\n  ];\n\n  if (options.timeUpdate !== undefined) player.timeUpdateEventInterval = options.timeUpdate;\n\n  return {\n    state: state.asReadonly(),\n    stop: () => {\n      for (const subscription of subscriptions) subscription();\n      // Releasing is the half a hook does that nothing else will: a player left alive holds its\n      // decoder, its audio session and, on iOS, the now-playing controls.\n      player.release?.();\n    },\n  };\n}\n\nfunction listen<T>(player: NativePlayer, event: string, handler: (payload: T) => void): () => void {\n  const subscription = player.addListener(event, handler as (payload: never) => void);\n  return () => subscription.remove();\n}\n\n/**\n * Watch an `expo-audio` player, and stop watching when the caller is done with it.\n *\n * `AudioPlayer` reports its whole state on `playbackStatusUpdate`, at the interval it was created\n * with, rather than splitting it across the several events `expo-video` uses - so unlike\n * `watchPlayer`, there is one listener, not several, and nothing to reset on a source change: the\n * next status update carries the new source's own state.\n */\nexport function watchAudioPlayer(player: NativePlayer | null): {\n  state: Signal<PlayerState>;\n  stop: () => void;\n} {\n  const state = signal(INITIAL);\n  if (!player) return { state: state.asReadonly(), stop: () => {} };\n\n  const subscription = listen(player, 'playbackStatusUpdate', (status: NativeAudioStatus) =>\n    state.set({\n      playing: status.playing,\n      status: status.error !== null ? 'error' : status.isLoaded ? 'readyToPlay' : 'loading',\n      currentTime: status.currentTime,\n      duration: status.duration,\n      muted: status.mute,\n      // Not on the status event; the player's own property is the current value.\n      volume: player.volume ?? INITIAL.volume,\n      ended: status.didJustFinish,\n    }),\n  );\n\n  return {\n    state: state.asReadonly(),\n    stop: () => {\n      subscription();\n      // Releasing is the half a hook does that nothing else will: a player left alive holds its\n      // decoder, its audio session and, on iOS, the now-playing controls.\n      player.release?.();\n    },\n  };\n}\n\nexport interface Player<T> {\n  /** The module's own player, for `play()`, `seekBy()`, and to hand to its view. */\n  readonly native: T;\n  readonly state: Signal<PlayerState>;\n}\n\n/**\n * Tie a player's life to the component that made it.\n *\n * Called in an injection context, which is the same constraint the hooks have and for the same\n * reason: something has to know when the thing goes away.\n */\nexport function ownPlayer<T extends NativePlayer>(\n  native: T,\n  watch: () => { state: Signal<PlayerState>; stop: () => void },\n): Player<T> {\n  const { state, stop } = watch();\n  inject(DestroyRef).onDestroy(stop);\n  return { native, state };\n}\n"]}
+{"version":3,"file":"player.js","sourceRoot":"","sources":["../src/player.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAe,MAAM,eAAe,CAAC;AA4CxE,MAAM,OAAO,GAAgB;IAC3B,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,MAAM;IACd,WAAW,EAAE,CAAC;IACd,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,KAAK;CACb,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,MAA2B,EAC3B,UAAmC,EAAE;IAErC,2FAA2F;IAC3F,MAAM,KAAK,GAAG,MAAM,CAAC;QACnB,GAAG,OAAO;QACV,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK;QACrC,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,MAAM;KACzC;8EAAC,CAAC;IACH,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAElE,MAAM,KAAK,GAAG,CAAC,MAA4B,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC;IACjG,MAAM,aAAa,GAAG;QACpB,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAA4B,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3F,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,EAAE,SAAS,EAA0B,EAAE,EAAE,CACxE,KAAK,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CACtE;QACD,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EAAE,KAAK,EAAsB,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAClF,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE,MAAM,EAAsB,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAA2B,EAAE,EAAE,CACxE,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC,CACvB;QACD,+FAA+F;QAC/F,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,CAClC,KAAK,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CACxF;QACD,mFAAmF;QACnF,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,EAAE,QAAQ,EAAwB,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;KAC1F,CAAC;IAEF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;QAAE,MAAM,CAAC,uBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC;IAE1F,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE;QACzB,IAAI,EAAE,GAAG,EAAE;YACT,KAAK,MAAM,YAAY,IAAI,aAAa;gBAAE,YAAY,EAAE,CAAC;YACzD,0FAA0F;YAC1F,oEAAoE;YACpE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAI,MAAoB,EAAE,KAAa,EAAE,OAA6B;IACnF,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAmC,CAAC,CAAC;IACpF,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;AACrC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA2B;IAI1D,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO;8EAAC,CAAC;IAC9B,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAElE,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,EAAE,CAAC,MAAyB,EAAE,EAAE,CACxF,KAAK,CAAC,GAAG,CAAC;QACR,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;QACrF,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,IAAI;QAClB,2EAA2E;QAC3E,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM;QACvC,KAAK,EAAE,MAAM,CAAC,aAAa;KAC5B,CAAC,CACH,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE;QACzB,IAAI,EAAE,GAAG,EAAE;YACT,YAAY,EAAE,CAAC;YACf,0FAA0F;YAC1F,oEAAoE;YACpE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC;AAeD;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,MAAS,EACT,KAA6D;IAE7D,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;IAChC,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,EAAE,GAAI,MAAiD,CAAC,yBAAyB,CAAC;IACxF,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AAC/B,CAAC","sourcesContent":["/**\n * What `videoPlayer` (`@ng-native/expo/video`) and `audioPlayer` (`@ng-native/expo/audio`) share:\n * the `Player` each answers, its state, and the watchers that keep that state.\n *\n * ```ts\n * protected readonly player = videoPlayer(this.source, { timeUpdate: 0.5 });\n *\n * // <expo-video [player]=\"player.id\" />\n * // {{ player.state().currentTime }}\n * ```\n *\n * `useVideoPlayer` and `useAudioPlayer` are the documented way in, and the player they hand back\n * is not the React part - `createVideoPlayer` gives the same object. What the hooks add is the\n * two things a component actually needs and cannot get otherwise: the player is *released* when\n * the component goes, and its changing state is *readable*, because the player's own properties\n * are plain mutable fields that no template can watch.\n *\n * The player itself is passed straight through: it is a shared object with `play()`, `seekBy()`\n * and the rest already on it, and wrapping those would be a second place for each to be wrong.\n *\n * Each player has an entry point of its own because each needs its own native module: Metro fails\n * a build on a `require` it cannot resolve, so one entry point for both made an app install both.\n */\nimport { DestroyRef, inject, signal, type Signal } from '@angular/core';\n\n/** The player's own status, which is the same word in both modules. */\nexport type PlayerStatus = 'idle' | 'loading' | 'readyToPlay' | 'error';\n\n/** The slice of a player this reads. Both modules' players satisfy it structurally. */\nexport interface NativePlayer {\n  addListener(event: string, listener: (payload: never) => void): { remove(): void };\n  release?(): void;\n  /** Seconds between `timeUpdate` events. Zero, its default, means the event never fires. `expo-video` only. */\n  timeUpdateEventInterval?: number;\n  /** Read directly rather than from an event: `expo-audio`'s status carries no volume field. */\n  readonly volume?: number;\n  /** `expo-video` only, where an event says it only once it changes. */\n  readonly muted?: boolean;\n}\n\n/**\n * `expo-audio`'s one status event, `playbackStatusUpdate`. Unlike `expo-video`, which splits its\n * state across several named events, `AudioPlayer` reports everything - including errors - on a\n * single event, at the interval `updateInterval` was created with.\n */\nexport interface NativeAudioStatus {\n  readonly playing: boolean;\n  readonly mute: boolean;\n  readonly duration: number;\n  readonly currentTime: number;\n  readonly isLoaded: boolean;\n  readonly didJustFinish: boolean;\n  readonly error: string | null;\n}\n\nexport interface PlayerState {\n  readonly playing: boolean;\n  readonly status: PlayerStatus;\n  /** Seconds. Only moves while `timeUpdateEventInterval` is non-zero. */\n  readonly currentTime: number;\n  readonly duration: number;\n  readonly muted: boolean;\n  readonly volume: number;\n  /** Set once playback has run to the end, and cleared when it starts again. */\n  readonly ended: boolean;\n}\n\nconst INITIAL: PlayerState = {\n  playing: false,\n  status: 'idle',\n  currentTime: 0,\n  duration: 0,\n  muted: false,\n  volume: 1,\n  ended: false,\n};\n\n/**\n * Watch an `expo-video` player, and stop watching when the caller is done with it.\n *\n * `timeUpdate` defaults to off, so `currentTime` would never move. A caller that wants a progress\n * bar asks for one by passing an interval, and one that does not pays nothing: the event is the\n * most frequent thing the player emits.\n *\n * `expo-audio`'s player reports its state differently - one event, not several - so it is watched\n * by `watchAudioPlayer` below rather than this function.\n */\nexport function watchPlayer(\n  player: NativePlayer | null,\n  options: { timeUpdate?: number } = {},\n): { state: Signal<PlayerState>; stop: () => void } {\n  // Both are the player's own, set where it was made: no event says either until it changes.\n  const state = signal({\n    ...INITIAL,\n    muted: player?.muted ?? INITIAL.muted,\n    volume: player?.volume ?? INITIAL.volume,\n  });\n  if (!player) return { state: state.asReadonly(), stop: () => {} };\n\n  const patch = (change: Partial<PlayerState>) => state.update((last) => ({ ...last, ...change }));\n  const subscriptions = [\n    listen(player, 'statusChange', ({ status }: { status: PlayerStatus }) => patch({ status })),\n    listen(player, 'playingChange', ({ isPlaying }: { isPlaying: boolean }) =>\n      patch({ playing: isPlaying, ...(isPlaying ? { ended: false } : {}) }),\n    ),\n    listen(player, 'mutedChange', ({ muted }: { muted: boolean }) => patch({ muted })),\n    listen(player, 'volumeChange', ({ volume }: { volume: number }) => patch({ volume })),\n    listen(player, 'playToEnd', () => patch({ ended: true, playing: false })),\n    listen(player, 'timeUpdate', ({ currentTime }: { currentTime: number }) =>\n      patch({ currentTime }),\n    ),\n    // What was the old source's starts over. Muted and volume are the player's, and it keeps them.\n    listen(player, 'sourceChange', () =>\n      patch({ status: 'loading', playing: false, currentTime: 0, duration: 0, ended: false }),\n    ),\n    // The only event that says how long the video is: nothing else carries a duration.\n    listen(player, 'sourceLoad', ({ duration }: { duration: number }) => patch({ duration })),\n  ];\n\n  if (options.timeUpdate !== undefined) player.timeUpdateEventInterval = options.timeUpdate;\n\n  return {\n    state: state.asReadonly(),\n    stop: () => {\n      for (const subscription of subscriptions) subscription();\n      // Releasing is the half a hook does that nothing else will: a player left alive holds its\n      // decoder, its audio session and, on iOS, the now-playing controls.\n      player.release?.();\n    },\n  };\n}\n\nfunction listen<T>(player: NativePlayer, event: string, handler: (payload: T) => void): () => void {\n  const subscription = player.addListener(event, handler as (payload: never) => void);\n  return () => subscription.remove();\n}\n\n/**\n * Watch an `expo-audio` player, and stop watching when the caller is done with it.\n *\n * `AudioPlayer` reports its whole state on `playbackStatusUpdate`, at the interval it was created\n * with, rather than splitting it across the several events `expo-video` uses - so unlike\n * `watchPlayer`, there is one listener, not several, and nothing to reset on a source change: the\n * next status update carries the new source's own state.\n */\nexport function watchAudioPlayer(player: NativePlayer | null): {\n  state: Signal<PlayerState>;\n  stop: () => void;\n} {\n  const state = signal(INITIAL);\n  if (!player) return { state: state.asReadonly(), stop: () => {} };\n\n  const subscription = listen(player, 'playbackStatusUpdate', (status: NativeAudioStatus) =>\n    state.set({\n      playing: status.playing,\n      status: status.error !== null ? 'error' : status.isLoaded ? 'readyToPlay' : 'loading',\n      currentTime: status.currentTime,\n      duration: status.duration,\n      muted: status.mute,\n      // Not on the status event; the player's own property is the current value.\n      volume: player.volume ?? INITIAL.volume,\n      ended: status.didJustFinish,\n    }),\n  );\n\n  return {\n    state: state.asReadonly(),\n    stop: () => {\n      subscription();\n      // Releasing is the half a hook does that nothing else will: a player left alive holds its\n      // decoder, its audio session and, on iOS, the now-playing controls.\n      player.release?.();\n    },\n  };\n}\n\nexport interface Player<T> {\n  /** The module's own player, for `play()`, `seekBy()` and the rest. */\n  readonly native: T;\n  /**\n   * What `<expo-video [player]>` takes: the player's shared-object id. The view's `player` prop is\n   * a number on the native side, and `expo-video`'s own `VideoView` passes this id rather than the\n   * player; given the player itself, the view has no player and draws nothing, while the video\n   * keeps playing with nothing on screen.\n   */\n  readonly id: number | undefined;\n  readonly state: Signal<PlayerState>;\n}\n\n/**\n * Tie a player's life to the component that made it.\n *\n * Called in an injection context, which is the same constraint the hooks have and for the same\n * reason: something has to know when the thing goes away.\n */\nexport function ownPlayer<T extends NativePlayer>(\n  native: T,\n  watch: () => { state: Signal<PlayerState>; stop: () => void },\n): Player<T> {\n  const { state, stop } = watch();\n  inject(DestroyRef).onDestroy(stop);\n  const id = (native as { __expo_shared_object_id__?: number }).__expo_shared_object_id__;\n  return { native, id, state };\n}\n"]}