@symbiote-native/location 0.1.0

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

@@ -0,0 +1,160 @@
+import type { PermissionResponse } from 'expo-modules-core';
+export declare enum LocationAccuracy {
+    Lowest = 1,
+    Low = 2,
+    Balanced = 3,
+    High = 4,
+    Highest = 5,
+    BestForNavigation = 6
+}
+export declare enum LocationActivityType {
+    Other = 1,
+    AutomotiveNavigation = 2,
+    Fitness = 3,
+    OtherNavigation = 4,
+    /** @platform ios */
+    Airborne = 5
+}
+export declare enum LocationGeofencingEventType {
+    Enter = 1,
+    Exit = 2
+}
+export declare enum LocationGeofencingRegionState {
+    Unknown = 0,
+    Inside = 1,
+    Outside = 2
+}
+export type ILocationOptions = {
+    accuracy?: LocationAccuracy;
+    /** @platform android */
+    mayShowUserSettingsDialog?: boolean;
+    /** @platform android */
+    timeInterval?: number;
+    distanceInterval?: number;
+};
+export type ILocationLastKnownOptions = {
+    maxAge?: number;
+    requiredAccuracy?: number;
+};
+export type ILocationTaskServiceOptions = {
+    notificationTitle: string;
+    notificationBody: string;
+    notificationColor?: string;
+    killServiceOnDestroy?: boolean;
+};
+export type ILocationTaskOptions = ILocationOptions & {
+    /** @platform ios */
+    showsBackgroundLocationIndicator?: boolean;
+    deferredUpdatesDistance?: number;
+    deferredUpdatesTimeout?: number;
+    deferredUpdatesInterval?: number;
+    /** @platform ios */
+    activityType?: LocationActivityType;
+    /** @platform ios */
+    pausesUpdatesAutomatically?: boolean;
+    foregroundService?: ILocationTaskServiceOptions;
+};
+export type ILocationRegion = {
+    identifier?: string;
+    latitude: number;
+    longitude: number;
+    radius: number;
+    /** @default true */
+    notifyOnEnter?: boolean;
+    /** @default true */
+    notifyOnExit?: boolean;
+    state?: LocationGeofencingRegionState;
+};
+export type ILocationObjectCoords = {
+    latitude: number;
+    longitude: number;
+    altitude: number | null;
+    accuracy: number | null;
+    altitudeAccuracy: number | null;
+    heading: number | null;
+    speed: number | null;
+};
+export type ILocationObject = {
+    coords: ILocationObjectCoords;
+    timestamp: number;
+    /** @platform android */
+    mocked?: boolean;
+};
+export type ILocationCallback = (location: ILocationObject) => unknown;
+export type ILocationErrorCallback = (reason: string) => void;
+export type ILocationProviderStatus = {
+    locationServicesEnabled: boolean;
+    backgroundModeEnabled: boolean;
+    /** @platform android */
+    gpsAvailable?: boolean;
+    /** @platform android */
+    networkAvailable?: boolean;
+    /** @platform android */
+    passiveAvailable?: boolean;
+};
+export type ILocationHeadingObject = {
+    trueHeading: number;
+    magHeading: number;
+    /** 0 none, 1 low, 2 medium, 3 high */
+    accuracy: number;
+};
+export type ILocationHeadingCallback = (heading: ILocationHeadingObject) => unknown;
+export type ILocationGeocodedLocation = {
+    latitude: number;
+    longitude: number;
+    altitude?: number;
+    accuracy?: number;
+};
+export type ILocationGeocodedAddress = {
+    city: string | null;
+    district: string | null;
+    streetNumber: string | null;
+    street: string | null;
+    region: string | null;
+    subregion: string | null;
+    country: string | null;
+    postalCode: string | null;
+    name: string | null;
+    isoCountryCode: string | null;
+    /** @platform ios */
+    timezone: string | null;
+    /** @platform android */
+    formattedAddress: string | null;
+};
+export type ILocationSubscription = {
+    remove: () => void;
+};
+export type IPermissionDetailsLocationIOS = {
+    scope: 'whenInUse' | 'always' | 'none';
+    accuracy: 'full' | 'reduced';
+};
+export type IPermissionDetailsLocationAndroid = {
+    accuracy: 'fine' | 'coarse' | 'none';
+};
+export type ILocationPermissionResponse = PermissionResponse & {
+    ios?: IPermissionDetailsLocationIOS;
+    android?: IPermissionDetailsLocationAndroid;
+};
+export type { PermissionResponse };
+export declare enum MotionActivityConfidence {
+    Low = 0,
+    Medium = 1,
+    High = 2
+}
+export declare enum MotionActivityType {
+    Automotive = "automotive",
+    Cycling = "cycling",
+    Running = "running",
+    Walking = "walking",
+    Stationary = "stationary",
+    Unknown = "unknown"
+}
+export type IMotionActivityState = {
+    detected: boolean;
+    confidence: MotionActivityConfidence;
+};
+export type IMotionActivityObject = {
+    activities: Record<MotionActivityType, IMotionActivityState>;
+    timestamp: number;
+};
+export type IMotionActivityCallback = (activity: IMotionActivityObject) => unknown;

package/build-ngc/core/types.js

@@ -0,0 +1,45 @@
+export var LocationAccuracy;
+(function (LocationAccuracy) {
+    LocationAccuracy[LocationAccuracy["Lowest"] = 1] = "Lowest";
+    LocationAccuracy[LocationAccuracy["Low"] = 2] = "Low";
+    LocationAccuracy[LocationAccuracy["Balanced"] = 3] = "Balanced";
+    LocationAccuracy[LocationAccuracy["High"] = 4] = "High";
+    LocationAccuracy[LocationAccuracy["Highest"] = 5] = "Highest";
+    LocationAccuracy[LocationAccuracy["BestForNavigation"] = 6] = "BestForNavigation";
+})(LocationAccuracy || (LocationAccuracy = {}));
+export var LocationActivityType;
+(function (LocationActivityType) {
+    LocationActivityType[LocationActivityType["Other"] = 1] = "Other";
+    LocationActivityType[LocationActivityType["AutomotiveNavigation"] = 2] = "AutomotiveNavigation";
+    LocationActivityType[LocationActivityType["Fitness"] = 3] = "Fitness";
+    LocationActivityType[LocationActivityType["OtherNavigation"] = 4] = "OtherNavigation";
+    /** @platform ios */
+    LocationActivityType[LocationActivityType["Airborne"] = 5] = "Airborne";
+})(LocationActivityType || (LocationActivityType = {}));
+export var LocationGeofencingEventType;
+(function (LocationGeofencingEventType) {
+    LocationGeofencingEventType[LocationGeofencingEventType["Enter"] = 1] = "Enter";
+    LocationGeofencingEventType[LocationGeofencingEventType["Exit"] = 2] = "Exit";
+})(LocationGeofencingEventType || (LocationGeofencingEventType = {}));
+export var LocationGeofencingRegionState;
+(function (LocationGeofencingRegionState) {
+    LocationGeofencingRegionState[LocationGeofencingRegionState["Unknown"] = 0] = "Unknown";
+    LocationGeofencingRegionState[LocationGeofencingRegionState["Inside"] = 1] = "Inside";
+    LocationGeofencingRegionState[LocationGeofencingRegionState["Outside"] = 2] = "Outside";
+})(LocationGeofencingRegionState || (LocationGeofencingRegionState = {}));
+export var MotionActivityConfidence;
+(function (MotionActivityConfidence) {
+    MotionActivityConfidence[MotionActivityConfidence["Low"] = 0] = "Low";
+    MotionActivityConfidence[MotionActivityConfidence["Medium"] = 1] = "Medium";
+    MotionActivityConfidence[MotionActivityConfidence["High"] = 2] = "High";
+})(MotionActivityConfidence || (MotionActivityConfidence = {}));
+export var MotionActivityType;
+(function (MotionActivityType) {
+    MotionActivityType["Automotive"] = "automotive";
+    MotionActivityType["Cycling"] = "cycling";
+    MotionActivityType["Running"] = "running";
+    MotionActivityType["Walking"] = "walking";
+    MotionActivityType["Stationary"] = "stationary";
+    MotionActivityType["Unknown"] = "unknown";
+})(MotionActivityType || (MotionActivityType = {}));
+//# 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":"AAEA,MAAM,CAAN,IAAY,gBAOX;AAPD,WAAY,gBAAgB;IAC1B,2DAAU,CAAA;IACV,qDAAO,CAAA;IACP,+DAAY,CAAA;IACZ,uDAAQ,CAAA;IACR,6DAAW,CAAA;IACX,iFAAqB,CAAA;AACvB,CAAC,EAPW,gBAAgB,KAAhB,gBAAgB,QAO3B;AAED,MAAM,CAAN,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC9B,iEAAS,CAAA;IACT,+FAAwB,CAAA;IACxB,qEAAW,CAAA;IACX,qFAAmB,CAAA;IACnB,oBAAoB;IACpB,uEAAY,CAAA;AACd,CAAC,EAPW,oBAAoB,KAApB,oBAAoB,QAO/B;AAED,MAAM,CAAN,IAAY,2BAGX;AAHD,WAAY,2BAA2B;IACrC,+EAAS,CAAA;IACT,6EAAQ,CAAA;AACV,CAAC,EAHW,2BAA2B,KAA3B,2BAA2B,QAGtC;AAED,MAAM,CAAN,IAAY,6BAIX;AAJD,WAAY,6BAA6B;IACvC,uFAAW,CAAA;IACX,qFAAU,CAAA;IACV,uFAAW,CAAA;AACb,CAAC,EAJW,6BAA6B,KAA7B,6BAA6B,QAIxC;AAsID,MAAM,CAAN,IAAY,wBAIX;AAJD,WAAY,wBAAwB;IAClC,qEAAO,CAAA;IACP,2EAAU,CAAA;IACV,uEAAQ,CAAA;AACV,CAAC,EAJW,wBAAwB,KAAxB,wBAAwB,QAInC;AAED,MAAM,CAAN,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B,+CAAyB,CAAA;IACzB,yCAAmB,CAAA;IACnB,yCAAmB,CAAA;IACnB,yCAAmB,CAAA;IACnB,+CAAyB,CAAA;IACzB,yCAAmB,CAAA;AACrB,CAAC,EAPW,kBAAkB,KAAlB,kBAAkB,QAO7B"}

package/native-link.json

@@ -0,0 +1,40 @@
+{
+  "android": {
+    "gradleProjectName": "expo-location",
+    "modules": [
+      {
+        "importPath": "expo.modules.location.LocationModule",
+        "className": "LocationModule",
+        "nativeName": "ExpoLocation"
+      }
+    ],
+    "optionalManifestBundles": [
+      {
+        "id": "background",
+        "label": "Background location tracking",
+        "warning": "Requesting ACCESS_BACKGROUND_LOCATION and the location foreground-service permissions triggers Play Console policy review — Google requires a clear, prominent in-app disclosure and justification before you can publish.",
+        "nextSteps": "Pass a `foregroundService` option to `startLocationUpdatesAsync` (notification title/body) so the OS keeps tracking alive outside the app. expo-location's own LocationTaskService is already declared in its AndroidManifest.xml and merges automatically — this only adds the permissions it needs.",
+        "manifestPermissions": [
+          "android.permission.ACCESS_BACKGROUND_LOCATION",
+          "android.permission.FOREGROUND_SERVICE",
+          "android.permission.FOREGROUND_SERVICE_LOCATION"
+        ]
+      }
+    ]
+  },
+  "ios": {
+    "infoPlistKeys": {
+      "NSLocationAlwaysAndWhenInUseUsageDescription": "Allow $(PRODUCT_NAME) to access your location.",
+      "NSLocationAlwaysUsageDescription": "Allow $(PRODUCT_NAME) to access your location.",
+      "NSLocationWhenInUseUsageDescription": "Allow $(PRODUCT_NAME) to access your location.",
+      "NSMotionUsageDescription": "Allow $(PRODUCT_NAME) to detect your current motion activity."
+    },
+    "infoPlistArrayKeys": { "UIBackgroundModes": ["location"] }
+  },
+  "reviewedNonIntrospectableMods": [
+    {
+      "mod": "android.dangerous",
+      "note": "withForegroundServiceIcon's dangerous half runs unconditionally with icon:null by default (expo-location's withLocation.js: `withForegroundServiceIcon(config, { icon: androidForegroundServiceIcon ?? null })`) — with icon:null it only unlinks a previously-written foreground-service icon PNG if one exists (existsSync-gated in removeForegroundServiceIconImageFiles). No-op for every consumer: this repo never sets androidForegroundServiceIcon anywhere."
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,151 @@
+{
+  "name": "@symbiote-native/location",
+  "version": "0.1.0",
+  "description": "expo-location wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, Svelte, Solid, and Angular adapters. Foreground/background position and heading, geocoding, motion activity, and geofencing.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/location"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/location#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "keywords": [
+    "react-native",
+    "symbiote-native",
+    "expo-location",
+    "react",
+    "vue",
+    "svelte",
+    "solid",
+    "angular",
+    "geolocation",
+    "geocoding",
+    "geofencing"
+  ],
+  "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/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./react": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./svelte": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./solid": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/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",
+    "!src/**/*.test.*",
+    "!src/**/*.spec.*",
+    "!src/**/*.detox.*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-location": "57.0.15",
+    "expo-modules-core": "57.0.5"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "solid-js": ">=1.9.0",
+    "svelte": ">=5.56.0",
+    "vue": ">=3.5.0",
+    "@symbiote-native/engine": "^1.3.0",
+    "@symbiote-native/react": "^3.0.2",
+    "@symbiote-native/angular": "^3.1.0",
+    "@symbiote-native/solid": "^3.0.2",
+    "@symbiote-native/svelte": "^3.0.2",
+    "@symbiote-native/vue": "^3.0.2"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/solid": {
+      "optional": true
+    },
+    "@symbiote-native/svelte": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "~22.0.8",
+    "@angular/compiler-cli": "~22.0.8",
+    "@angular/core": "~22.0.8",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "solid-js": "^1.9.14",
+    "svelte": "^5.56.0",
+    "typescript": "~6.0.0",
+    "@symbiote-native/angular": "3.1.0",
+    "@symbiote-native/engine": "1.3.0",
+    "@symbiote-native/solid": "3.0.2",
+    "@symbiote-native/svelte": "3.0.2",
+    "@symbiote-native/test-utils": "0.4.2",
+    "@symbiote-native/vue": "3.0.2",
+    "@symbiote-native/react": "3.0.2"
+  },
+  "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/location/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/index.ts

@@ -0,0 +1,17 @@
+export {
+  PermissionStatus,
+  type PermissionHookOptions,
+  type PermissionExpiration,
+} from 'expo-modules-core';
+
+export { getCurrentWatchId } from './subscribers';
+
+export * from './location';
+export * from './types';
+
+export {
+  LocationAccuracy as Accuracy,
+  LocationActivityType as ActivityType,
+  LocationGeofencingEventType as GeofencingEventType,
+  LocationGeofencingRegionState as GeofencingRegionState,
+} from './types';