@symbiote-native/application 0.0.1

package/build-ngc/core/application.js

@@ -0,0 +1,120 @@
+import { Platform, UnavailabilityError } from 'expo-modules-core';
+import { expoApplication } from './native-module';
+const NATIVE_MODULE_NAME = 'expo-application';
+/**
+ * The human-readable version of the native application that may be displayed in the app store.
+ * On Android, this is the version name set by `version` in the app config; on iOS, the
+ * `Info.plist` value for `CFBundleShortVersionString`.
+ * @example `"2.11.0"`
+ */
+export const nativeApplicationVersion = expoApplication.nativeApplicationVersion ?? null;
+/**
+ * The internal build version of the native application that the app stores may use to
+ * distinguish between different binaries. On Android, this is `android.versionCode`; on iOS,
+ * the `Info.plist` value for `CFBundleVersion` (`ios.buildNumber` in the app config).
+ * @example `"114"`
+ */
+export const nativeBuildVersion = expoApplication.nativeBuildVersion ?? null;
+/**
+ * The human-readable name of the application, displayed with the app's icon on the device's
+ * home screen.
+ * @example `"Expo"`, `"Yelp"`, `"Instagram"`
+ */
+export const applicationName = expoApplication.applicationName ?? null;
+/**
+ * The ID of the application. On Android, this is the application ID. On iOS, this is the
+ * bundle ID.
+ * @example `"com.cocoacasts.scribbles"`, `"com.apple.Pages"`
+ */
+export const applicationId = expoApplication.applicationId ?? null;
+/**
+ * Gets the value of `Settings.Secure.ANDROID_ID` — a hexadecimal string unique to each
+ * combination of app-signing key, user, and device. The value may change if a factory reset is
+ * performed on the device or if an APK signing key changes.
+ * @example `Application.getAndroidId(); // "dd96dec43fb81c97"`
+ * @platform android
+ */
+export function getAndroidId() {
+    if (Platform.OS !== 'android') {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'androidId');
+    }
+    if (!expoApplication.androidId) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'androidId');
+    }
+    return expoApplication.androidId;
+}
+/**
+ * Gets the referrer URL of the installed app with the Install Referrer API from the Google Play
+ * Store. In practice, the referrer URL may not be a complete, absolute URL.
+ * @example `await Application.getInstallReferrerAsync(); // "utm_source=google-play&utm_medium=organic"`
+ * @platform android
+ */
+export async function getInstallReferrerAsync() {
+    if (!expoApplication.getInstallReferrerAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getInstallReferrerAsync');
+    }
+    return expoApplication.getInstallReferrerAsync();
+}
+/**
+ * Gets the iOS "identifier for vendor" (IDFV) — a string ID that uniquely identifies a device to
+ * the app's vendor. May resolve `null`, in which case wait and call again later (this can happen
+ * when the device was restarted before the user unlocked it). The OS changes the vendor
+ * identifier once every app from the current vendor has been uninstalled.
+ * @example `await Application.getIosIdForVendorAsync(); // "68753A44-4D6F-1226-9C60-0050E4C00067"`
+ * @platform ios
+ */
+export async function getIosIdForVendorAsync() {
+    if (!expoApplication.getIosIdForVendorAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getIosIdForVendorAsync');
+    }
+    return expoApplication.getIosIdForVendorAsync();
+}
+/**
+ * Gets the iOS application release type.
+ * @platform ios
+ */
+export async function getIosApplicationReleaseTypeAsync() {
+    if (!expoApplication.getApplicationReleaseTypeAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getApplicationReleaseTypeAsync');
+    }
+    return expoApplication.getApplicationReleaseTypeAsync();
+}
+/**
+ * Gets the current Apple Push Notification (APN) service environment.
+ * @return Either `'development'` or `'production'`, or `null` on the simulator (which does not
+ * support registering with APNs).
+ * @platform ios
+ */
+export async function getIosPushNotificationServiceEnvironmentAsync() {
+    if (!expoApplication.getPushNotificationServiceEnvironmentAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getPushNotificationServiceEnvironmentAsync');
+    }
+    return expoApplication.getPushNotificationServiceEnvironmentAsync();
+}
+/**
+ * Gets the time the app was installed onto the device, not counting subsequent updates. If the
+ * app is uninstalled and reinstalled, this returns the time of the reinstall.
+ * - Android: `PackageInfo.firstInstallTime`.
+ * - iOS: the `NSFileCreationDate` of the app's document root directory.
+ * @example `await Application.getInstallationTimeAsync(); // 2019-07-18T18:08:26.121Z`
+ */
+export async function getInstallationTimeAsync() {
+    if (!expoApplication.getInstallationTimeAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getInstallationTimeAsync');
+    }
+    const installationTime = await expoApplication.getInstallationTimeAsync();
+    return new Date(installationTime);
+}
+/**
+ * Gets the last time the app was updated from the Google Play Store.
+ * @example `await Application.getLastUpdateTimeAsync(); // 2019-07-18T21:20:16.887Z`
+ * @platform android
+ */
+export async function getLastUpdateTimeAsync() {
+    if (!expoApplication.getLastUpdateTimeAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getLastUpdateTimeAsync');
+    }
+    const lastUpdateTime = await expoApplication.getLastUpdateTimeAsync();
+    return new Date(lastUpdateTime);
+}
+//# sourceMappingURL=application.js.map

package/build-ngc/core/application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../../src/core/application.ts"],"names":[],"mappings":"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"}

package/build-ngc/core/index.d.ts

@@ -0,0 +1,2 @@
+export { nativeApplicationVersion, nativeBuildVersion, applicationName, applicationId, getAndroidId, getInstallReferrerAsync, getIosIdForVendorAsync, getIosApplicationReleaseTypeAsync, getIosPushNotificationServiceEnvironmentAsync, getInstallationTimeAsync, getLastUpdateTimeAsync, } from './application';
+export { ApplicationReleaseType, type PushNotificationServiceEnvironment } from './types';

package/build-ngc/core/index.js

@@ -0,0 +1,3 @@
+export { nativeApplicationVersion, nativeBuildVersion, applicationName, applicationId, getAndroidId, getInstallReferrerAsync, getIosIdForVendorAsync, getIosApplicationReleaseTypeAsync, getIosPushNotificationServiceEnvironmentAsync, getInstallationTimeAsync, getLastUpdateTimeAsync, } from './application';
+export { ApplicationReleaseType } from './types';
+//# sourceMappingURL=index.js.map

package/build-ngc/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,sBAAsB,EACtB,iCAAiC,EACjC,6CAA6C,EAC7C,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,sBAAsB,EAA2C,MAAM,SAAS,CAAC"}

package/build-ngc/core/native-module.d.ts

@@ -0,0 +1,15 @@
+import type { ApplicationReleaseType, PushNotificationServiceEnvironment } from './types';
+export type INativeApplicationModule = {
+    nativeApplicationVersion?: string | null;
+    nativeBuildVersion?: string | null;
+    applicationName?: string | null;
+    applicationId?: string | null;
+    androidId?: string;
+    getInstallReferrerAsync?(): Promise<string>;
+    getIosIdForVendorAsync?(): Promise<string | null>;
+    getApplicationReleaseTypeAsync?(): Promise<ApplicationReleaseType>;
+    getPushNotificationServiceEnvironmentAsync?(): Promise<PushNotificationServiceEnvironment>;
+    getInstallationTimeAsync?(): Promise<number>;
+    getLastUpdateTimeAsync?(): Promise<number>;
+};
+export declare const expoApplication: INativeApplicationModule;

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

@@ -0,0 +1,4 @@
+import { requireNativeModule } from 'expo-modules-core';
+const EXPO_APPLICATION_MODULE_NAME = 'ExpoApplication';
+export const expoApplication = requireNativeModule(EXPO_APPLICATION_MODULE_NAME);
+//# sourceMappingURL=native-module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native-module.js","sourceRoot":"","sources":["../../src/core/native-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,4BAA4B,GAAG,iBAAiB,CAAC;AAoBvD,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAChD,4BAA4B,CAC7B,CAAC"}

package/build-ngc/core/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The type of release for the app that is currently running.
+ * @platform ios
+ */
+export declare enum ApplicationReleaseType {
+    UNKNOWN = 0,
+    SIMULATOR = 1,
+    ENTERPRISE = 2,
+    DEVELOPMENT = 3,
+    AD_HOC = 4,
+    APP_STORE = 5
+}
+/**
+ * Maps to the `aps-environment` key in the native target's registered entitlements.
+ * @platform ios
+ */
+export type PushNotificationServiceEnvironment = 'development' | 'production' | null;

package/build-ngc/core/types.js

@@ -0,0 +1,17 @@
+// Upstream ships two iOS-only types describing the shape of a running app build — the
+// release channel it was built through and the current APN environment. Ported verbatim
+// from expo-application's Application.types.ts (sdk-57).
+/**
+ * The type of release for the app that is currently running.
+ * @platform ios
+ */
+export var ApplicationReleaseType;
+(function (ApplicationReleaseType) {
+    ApplicationReleaseType[ApplicationReleaseType["UNKNOWN"] = 0] = "UNKNOWN";
+    ApplicationReleaseType[ApplicationReleaseType["SIMULATOR"] = 1] = "SIMULATOR";
+    ApplicationReleaseType[ApplicationReleaseType["ENTERPRISE"] = 2] = "ENTERPRISE";
+    ApplicationReleaseType[ApplicationReleaseType["DEVELOPMENT"] = 3] = "DEVELOPMENT";
+    ApplicationReleaseType[ApplicationReleaseType["AD_HOC"] = 4] = "AD_HOC";
+    ApplicationReleaseType[ApplicationReleaseType["APP_STORE"] = 5] = "APP_STORE";
+})(ApplicationReleaseType || (ApplicationReleaseType = {}));
+//# sourceMappingURL=types.js.map

package/build-ngc/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,wFAAwF;AACxF,yDAAyD;AAEzD;;;GAGG;AACH,MAAM,CAAN,IAAY,sBAOX;AAPD,WAAY,sBAAsB;IAChC,yEAAW,CAAA;IACX,6EAAa,CAAA;IACb,+EAAc,CAAA;IACd,iFAAe,CAAA;IACf,uEAAU,CAAA;IACV,6EAAa,CAAA;AACf,CAAC,EAPW,sBAAsB,KAAtB,sBAAsB,QAOjC"}

package/native-link.json

@@ -0,0 +1,12 @@
+{
+  "android": {
+    "gradleProjectName": "expo-application",
+    "modules": [
+      {
+        "importPath": "expo.modules.application.ApplicationModule",
+        "className": "ApplicationModule",
+        "nativeName": "ExpoApplication"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,107 @@
+{
+  "name": "@symbiote-native/application",
+  "version": "0.0.1",
+  "description": "expo-application wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. Native app version/build/name/ID constants, the Android ID, install-referrer and install/update-time lookups, and the iOS vendor ID, release type, and push-notification-service environment.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/application"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/application#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./vue": {
+      "types": "./build/vue/index.d.ts",
+      "default": "./build/vue/index.js"
+    },
+    "./react": {
+      "types": "./build/react/index.d.ts",
+      "default": "./build/react/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-application": "57.0.2",
+    "expo-modules-core": "57.0.5"
+  },
+  "peerDependencies": {
+    "@symbiote-native/engine": ">=0.1.7",
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "vue": ">=3.5.0",
+    "@symbiote-native/angular": "0.6.1",
+    "@symbiote-native/react": "0.2.8",
+    "@symbiote-native/vue": "0.3.8"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "^22",
+    "@angular/compiler-cli": "^22",
+    "@angular/core": "^22",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "typescript": "~6.0.0",
+    "@symbiote-native/angular": "0.6.1",
+    "@symbiote-native/engine": "0.1.7",
+    "@symbiote-native/react": "0.2.8",
+    "@symbiote-native/test-utils": "0.1.6",
+    "@symbiote-native/vue": "0.3.8"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,4 @@
+// @symbiote-native/application/angular: the Angular entry over the framework-agnostic core.
+// Same reasoning as the React/Vue entries — no per-instance state or event stream to wrap in a
+// service, so this is a plain re-export.
+export * from '../core';

package/src/core/application.test.ts

@@ -0,0 +1,150 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+const FAKE_NATIVE_APPLICATION = {
+  nativeApplicationVersion: '2.11.0',
+  nativeBuildVersion: '114',
+  applicationName: 'Canary',
+  applicationId: 'com.symbiote.canary',
+  androidId: 'dd96dec43fb81c97',
+  getInstallReferrerAsync: vi.fn(async () => 'utm_source=google-play&utm_medium=organic'),
+  getIosIdForVendorAsync: vi.fn(async () => '68753A44-4D6F-1226-9C60-0050E4C00067'),
+  getApplicationReleaseTypeAsync: vi.fn(async () => 5),
+  getPushNotificationServiceEnvironmentAsync: vi.fn(async () => 'production' as const),
+  getInstallationTimeAsync: vi.fn(async () => 1_563_473_306_121),
+  getLastUpdateTimeAsync: vi.fn(async () => 1_563_484_816_887),
+};
+
+const fakePlatform = { OS: 'android' as 'ios' | 'android' };
+
+// The real ExpoApplication native module only exists on device — resolving it via
+// requireNativeModule() at import time would throw in this headless test run, so the
+// module-lookup file is faked in place of expo-modules-core's runtime resolution, the same
+// pattern packages/local-auth/src/core/local-authentication.test.ts uses.
+vi.mock('./native-module', () => ({
+  expoApplication: FAKE_NATIVE_APPLICATION,
+}));
+
+// expo-modules-core's real entry transitively imports 'react-native' for Platform/
+// TurboModuleRegistry, whose Flow-typed source Vitest's Oxc transform can't parse — same fake
+// packages/local-auth/src/core/local-authentication.test.ts uses.
+vi.mock('expo-modules-core', () => ({
+  Platform: fakePlatform,
+  UnavailabilityError: class UnavailabilityError extends Error {
+    constructor(moduleName: string, propertyName: string) {
+      super(`${propertyName} is not available on ${moduleName}`);
+    }
+  },
+}));
+
+const {
+  nativeApplicationVersion,
+  nativeBuildVersion,
+  applicationName,
+  applicationId,
+  getAndroidId,
+  getInstallReferrerAsync,
+  getIosIdForVendorAsync,
+  getIosApplicationReleaseTypeAsync,
+  getIosPushNotificationServiceEnvironmentAsync,
+  getInstallationTimeAsync,
+  getLastUpdateTimeAsync,
+} = await import('./application');
+
+afterEach(() => {
+  fakePlatform.OS = 'android';
+  vi.clearAllMocks();
+});
+
+describe('constants', () => {
+  it('resolves eagerly from the native module', () => {
+    expect(nativeApplicationVersion).toBe('2.11.0');
+    expect(nativeBuildVersion).toBe('114');
+    expect(applicationName).toBe('Canary');
+    expect(applicationId).toBe('com.symbiote.canary');
+  });
+});
+
+describe('getAndroidId', () => {
+  it('returns the native androidId on android', () => {
+    expect(getAndroidId()).toBe('dd96dec43fb81c97');
+  });
+
+  it('throws an UnavailabilityError-shaped error on a non-android platform', () => {
+    fakePlatform.OS = 'ios';
+    expect(() => getAndroidId()).toThrow('androidId is not available on expo-application');
+  });
+});
+
+describe('getInstallReferrerAsync', () => {
+  it('delegates to the native module', async () => {
+    await expect(getInstallReferrerAsync()).resolves.toBe(
+      'utm_source=google-play&utm_medium=organic',
+    );
+  });
+
+  it('throws an UnavailabilityError-shaped error when the native method is absent', async () => {
+    const { getInstallReferrerAsync: native } = FAKE_NATIVE_APPLICATION;
+    // @ts-expect-error -- simulating a platform where the native module has no such method
+    FAKE_NATIVE_APPLICATION.getInstallReferrerAsync = undefined;
+
+    await expect(getInstallReferrerAsync()).rejects.toThrow(
+      'getInstallReferrerAsync is not available on expo-application',
+    );
+
+    FAKE_NATIVE_APPLICATION.getInstallReferrerAsync = native;
+  });
+});
+
+describe('getIosIdForVendorAsync', () => {
+  it('delegates to the native module', async () => {
+    await expect(getIosIdForVendorAsync()).resolves.toBe('68753A44-4D6F-1226-9C60-0050E4C00067');
+  });
+});
+
+describe('getIosApplicationReleaseTypeAsync', () => {
+  it('delegates to the native module', async () => {
+    await expect(getIosApplicationReleaseTypeAsync()).resolves.toBe(5);
+  });
+
+  it('throws an UnavailabilityError-shaped error when the native method is absent', async () => {
+    const { getApplicationReleaseTypeAsync: native } = FAKE_NATIVE_APPLICATION;
+    // @ts-expect-error -- simulating a platform where the native module has no such method
+    FAKE_NATIVE_APPLICATION.getApplicationReleaseTypeAsync = undefined;
+
+    await expect(getIosApplicationReleaseTypeAsync()).rejects.toThrow(
+      'getApplicationReleaseTypeAsync is not available on expo-application',
+    );
+
+    FAKE_NATIVE_APPLICATION.getApplicationReleaseTypeAsync = native;
+  });
+});
+
+describe('getIosPushNotificationServiceEnvironmentAsync', () => {
+  it('delegates to the native module', async () => {
+    await expect(getIosPushNotificationServiceEnvironmentAsync()).resolves.toBe('production');
+  });
+});
+
+describe('getInstallationTimeAsync', () => {
+  it('wraps the native epoch-ms number into a Date', async () => {
+    await expect(getInstallationTimeAsync()).resolves.toEqual(new Date(1_563_473_306_121));
+  });
+});
+
+describe('getLastUpdateTimeAsync', () => {
+  it('wraps the native epoch-ms number into a Date', async () => {
+    await expect(getLastUpdateTimeAsync()).resolves.toEqual(new Date(1_563_484_816_887));
+  });
+
+  it('throws an UnavailabilityError-shaped error when the native method is absent', async () => {
+    const { getLastUpdateTimeAsync: native } = FAKE_NATIVE_APPLICATION;
+    // @ts-expect-error -- simulating iOS, where getLastUpdateTimeAsync has no native implementation
+    FAKE_NATIVE_APPLICATION.getLastUpdateTimeAsync = undefined;
+
+    await expect(getLastUpdateTimeAsync()).rejects.toThrow(
+      'getLastUpdateTimeAsync is not available on expo-application',
+    );
+
+    FAKE_NATIVE_APPLICATION.getLastUpdateTimeAsync = native;
+  });
+});

package/src/core/application.ts

@@ -0,0 +1,134 @@
+import { Platform, UnavailabilityError } from 'expo-modules-core';
+
+import { expoApplication } from './native-module';
+import type { ApplicationReleaseType, PushNotificationServiceEnvironment } from './types';
+
+const NATIVE_MODULE_NAME = 'expo-application';
+
+/**
+ * The human-readable version of the native application that may be displayed in the app store.
+ * On Android, this is the version name set by `version` in the app config; on iOS, the
+ * `Info.plist` value for `CFBundleShortVersionString`.
+ * @example `"2.11.0"`
+ */
+export const nativeApplicationVersion: string | null =
+  expoApplication.nativeApplicationVersion ?? null;
+
+/**
+ * The internal build version of the native application that the app stores may use to
+ * distinguish between different binaries. On Android, this is `android.versionCode`; on iOS,
+ * the `Info.plist` value for `CFBundleVersion` (`ios.buildNumber` in the app config).
+ * @example `"114"`
+ */
+export const nativeBuildVersion: string | null = expoApplication.nativeBuildVersion ?? null;
+
+/**
+ * The human-readable name of the application, displayed with the app's icon on the device's
+ * home screen.
+ * @example `"Expo"`, `"Yelp"`, `"Instagram"`
+ */
+export const applicationName: string | null = expoApplication.applicationName ?? null;
+
+/**
+ * The ID of the application. On Android, this is the application ID. On iOS, this is the
+ * bundle ID.
+ * @example `"com.cocoacasts.scribbles"`, `"com.apple.Pages"`
+ */
+export const applicationId: string | null = expoApplication.applicationId ?? null;
+
+/**
+ * Gets the value of `Settings.Secure.ANDROID_ID` — a hexadecimal string unique to each
+ * combination of app-signing key, user, and device. The value may change if a factory reset is
+ * performed on the device or if an APK signing key changes.
+ * @example `Application.getAndroidId(); // "dd96dec43fb81c97"`
+ * @platform android
+ */
+export function getAndroidId(): string {
+  if (Platform.OS !== 'android') {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'androidId');
+  }
+  if (!expoApplication.androidId) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'androidId');
+  }
+  return expoApplication.androidId;
+}
+
+/**
+ * Gets the referrer URL of the installed app with the Install Referrer API from the Google Play
+ * Store. In practice, the referrer URL may not be a complete, absolute URL.
+ * @example `await Application.getInstallReferrerAsync(); // "utm_source=google-play&utm_medium=organic"`
+ * @platform android
+ */
+export async function getInstallReferrerAsync(): Promise<string> {
+  if (!expoApplication.getInstallReferrerAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getInstallReferrerAsync');
+  }
+  return expoApplication.getInstallReferrerAsync();
+}
+
+/**
+ * Gets the iOS "identifier for vendor" (IDFV) — a string ID that uniquely identifies a device to
+ * the app's vendor. May resolve `null`, in which case wait and call again later (this can happen
+ * when the device was restarted before the user unlocked it). The OS changes the vendor
+ * identifier once every app from the current vendor has been uninstalled.
+ * @example `await Application.getIosIdForVendorAsync(); // "68753A44-4D6F-1226-9C60-0050E4C00067"`
+ * @platform ios
+ */
+export async function getIosIdForVendorAsync(): Promise<string | null> {
+  if (!expoApplication.getIosIdForVendorAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getIosIdForVendorAsync');
+  }
+  return expoApplication.getIosIdForVendorAsync();
+}
+
+/**
+ * Gets the iOS application release type.
+ * @platform ios
+ */
+export async function getIosApplicationReleaseTypeAsync(): Promise<ApplicationReleaseType> {
+  if (!expoApplication.getApplicationReleaseTypeAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getApplicationReleaseTypeAsync');
+  }
+  return expoApplication.getApplicationReleaseTypeAsync();
+}
+
+/**
+ * Gets the current Apple Push Notification (APN) service environment.
+ * @return Either `'development'` or `'production'`, or `null` on the simulator (which does not
+ * support registering with APNs).
+ * @platform ios
+ */
+export async function getIosPushNotificationServiceEnvironmentAsync(): Promise<PushNotificationServiceEnvironment> {
+  if (!expoApplication.getPushNotificationServiceEnvironmentAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getPushNotificationServiceEnvironmentAsync');
+  }
+  return expoApplication.getPushNotificationServiceEnvironmentAsync();
+}
+
+/**
+ * Gets the time the app was installed onto the device, not counting subsequent updates. If the
+ * app is uninstalled and reinstalled, this returns the time of the reinstall.
+ * - Android: `PackageInfo.firstInstallTime`.
+ * - iOS: the `NSFileCreationDate` of the app's document root directory.
+ * @example `await Application.getInstallationTimeAsync(); // 2019-07-18T18:08:26.121Z`
+ */
+export async function getInstallationTimeAsync(): Promise<Date> {
+  if (!expoApplication.getInstallationTimeAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getInstallationTimeAsync');
+  }
+  const installationTime = await expoApplication.getInstallationTimeAsync();
+  return new Date(installationTime);
+}
+
+/**
+ * Gets the last time the app was updated from the Google Play Store.
+ * @example `await Application.getLastUpdateTimeAsync(); // 2019-07-18T21:20:16.887Z`
+ * @platform android
+ */
+export async function getLastUpdateTimeAsync(): Promise<Date> {
+  if (!expoApplication.getLastUpdateTimeAsync) {
+    throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getLastUpdateTimeAsync');
+  }
+  const lastUpdateTime = await expoApplication.getLastUpdateTimeAsync();
+  return new Date(lastUpdateTime);
+}

package/src/core/index.ts

@@ -0,0 +1,14 @@
+export {
+  nativeApplicationVersion,
+  nativeBuildVersion,
+  applicationName,
+  applicationId,
+  getAndroidId,
+  getInstallReferrerAsync,
+  getIosIdForVendorAsync,
+  getIosApplicationReleaseTypeAsync,
+  getIosPushNotificationServiceEnvironmentAsync,
+  getInstallationTimeAsync,
+  getLastUpdateTimeAsync,
+} from './application';
+export { ApplicationReleaseType, type PushNotificationServiceEnvironment } from './types';

package/src/core/native-module.ts

@@ -0,0 +1,26 @@
+import { requireNativeModule } from 'expo-modules-core';
+import type { ApplicationReleaseType, PushNotificationServiceEnvironment } from './types';
+
+const EXPO_APPLICATION_MODULE_NAME = 'ExpoApplication';
+
+// Every method is optional — each call site checks for its presence before calling through and
+// throws an UnavailabilityError itself, matching upstream's own per-platform capability checks
+// rather than assuming the native module implements the whole surface. Same convention as
+// packages/local-auth/src/core/native-module.ts.
+export type INativeApplicationModule = {
+  nativeApplicationVersion?: string | null;
+  nativeBuildVersion?: string | null;
+  applicationName?: string | null;
+  applicationId?: string | null;
+  androidId?: string;
+  getInstallReferrerAsync?(): Promise<string>;
+  getIosIdForVendorAsync?(): Promise<string | null>;
+  getApplicationReleaseTypeAsync?(): Promise<ApplicationReleaseType>;
+  getPushNotificationServiceEnvironmentAsync?(): Promise<PushNotificationServiceEnvironment>;
+  getInstallationTimeAsync?(): Promise<number>;
+  getLastUpdateTimeAsync?(): Promise<number>;
+};
+
+export const expoApplication = requireNativeModule<INativeApplicationModule>(
+  EXPO_APPLICATION_MODULE_NAME,
+);