@flighthq/geolocation 0.1.0

package/dist/geolocation.d.ts

@@ -0,0 +1,14 @@
+import type { GeolocationBackend, GeolocationErrorReason, GeolocationPermissionState, GeolocationRequestOptions, GeoPosition, GeoPositionResult } from '@flighthq/types';
+export declare function clearGeolocationWatch(id: number): void;
+export declare function createGeoPosition(): GeoPosition;
+export declare function createWebGeolocationBackend(): GeolocationBackend;
+export declare function getCurrentGeoPosition(options?: Readonly<GeolocationRequestOptions>): Promise<GeoPosition | null>;
+export declare function getCurrentGeoPositionResult(options?: Readonly<GeolocationRequestOptions>): Promise<GeoPositionResult>;
+export declare function getGeolocationBackend(): GeolocationBackend;
+export declare function getGeolocationPermission(): Promise<GeolocationPermissionState>;
+export declare function isGeolocationAvailable(): boolean;
+export declare function onGeolocationPermissionChange(listener: (state: GeolocationPermissionState) => void): () => void;
+export declare function requestGeolocationPermission(): Promise<boolean>;
+export declare function setGeolocationBackend(backend: GeolocationBackend | null): void;
+export declare function watchGeolocationPosition(handler: (position: Readonly<GeoPosition>) => void, options?: Readonly<GeolocationRequestOptions>, onError?: (reason: GeolocationErrorReason) => void): number;
+//# sourceMappingURL=geolocation.d.ts.map

package/dist/geolocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation.d.ts","sourceRoot":"","sources":["../src/geolocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,WAAW,EACX,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAGzB,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtD;AAGD,wBAAgB,iBAAiB,IAAI,WAAW,CAY/C;AAKD,wBAAgB,2BAA2B,IAAI,kBAAkB,CA4GhE;AAGD,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAEhH;AAID,wBAAgB,2BAA2B,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,yBAAyB,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAErH;AAGD,wBAAgB,qBAAqB,IAAI,kBAAkB,CAG1D;AAKD,wBAAgB,wBAAwB,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAE9E;AAID,wBAAgB,sBAAsB,IAAI,OAAO,CAIhD;AAKD,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GAAG,MAAM,IAAI,CAE/G;AAGD,wBAAgB,4BAA4B,IAAI,OAAO,CAAC,OAAO,CAAC,CAE/D;AAGD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAE9E;AAKD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK,IAAI,EAClD,OAAO,CAAC,EAAE,QAAQ,CAAC,yBAAyB,CAAC,EAC7C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,GACjD,MAAM,CAER"}

package/dist/geolocation.js

@@ -0,0 +1,219 @@
+// Cancels an active position watch. No-op when the id is unknown or the backend lacks watching.
+export function clearGeolocationWatch(id) {
+    getGeolocationBackend().clearWatch(id);
+}
+// Allocates a zeroed GeoPosition; use as a scratch value or when building a backend.
+export function createGeoPosition() {
+    return {
+        accuracy: 0,
+        altitude: 0,
+        altitudeAccuracy: 0,
+        floorLevel: 0,
+        heading: 0,
+        latitude: 0,
+        longitude: 0,
+        speed: 0,
+        timestamp: 0,
+    };
+}
+// Builds the default web backend over navigator.geolocation. Position reads resolve to null and
+// permission requests resolve to false when the API is absent (insecure context, jsdom) or the user
+// denies access — location access is not guaranteed.
+export function createWebGeolocationBackend() {
+    return {
+        clearWatch(id) {
+            const geo = getWebGeolocation();
+            if (geo === null || typeof geo.clearWatch !== 'function')
+                return;
+            try {
+                geo.clearWatch(id);
+            }
+            catch {
+                // Expected failure: the watch may already be gone or the host may deny access.
+            }
+        },
+        getCurrentPosition(options) {
+            return new Promise((resolve) => {
+                const geo = getWebGeolocation();
+                if (geo === null || typeof geo.getCurrentPosition !== 'function') {
+                    resolve(null);
+                    return;
+                }
+                try {
+                    geo.getCurrentPosition((position) => resolve(mapWebPosition(position)), () => resolve(null), toPositionOptions(options));
+                }
+                catch {
+                    resolve(null);
+                }
+            });
+        },
+        getCurrentPositionResult(options) {
+            return new Promise((resolve) => {
+                const geo = getWebGeolocation();
+                if (geo === null || typeof geo.getCurrentPosition !== 'function') {
+                    resolve({ position: null, reason: 'unavailable' });
+                    return;
+                }
+                try {
+                    geo.getCurrentPosition((position) => resolve({ position: mapWebPosition(position), reason: null }), (error) => resolve({ position: null, reason: mapWebPositionError(error) }), toPositionOptions(options));
+                }
+                catch {
+                    resolve({ position: null, reason: 'unavailable' });
+                }
+            });
+        },
+        async getPermission() {
+            const permissions = typeof navigator !== 'undefined' ? (navigator.permissions ?? null) : null;
+            if (permissions !== null && typeof permissions.query === 'function') {
+                try {
+                    const status = await permissions.query({ name: 'geolocation' });
+                    return status.state;
+                }
+                catch {
+                    // Fall through to prompt default.
+                }
+            }
+            return 'prompt';
+        },
+        async requestPermission() {
+            const permissions = typeof navigator !== 'undefined' ? (navigator.permissions ?? null) : null;
+            if (permissions !== null && typeof permissions.query === 'function') {
+                try {
+                    const status = await permissions.query({ name: 'geolocation' });
+                    return status.state === 'granted';
+                }
+                catch {
+                    // Fall through to a probe below.
+                }
+            }
+            return (await this.getCurrentPosition({})) !== null;
+        },
+        subscribePermission(listener) {
+            const permissions = typeof navigator !== 'undefined' ? (navigator.permissions ?? null) : null;
+            if (permissions === null || typeof permissions.query !== 'function')
+                return _noopUnsubscribe;
+            let status = null;
+            let handler = null;
+            permissions
+                .query({ name: 'geolocation' })
+                .then((s) => {
+                status = s;
+                handler = () => listener(s.state);
+                s.addEventListener('change', handler);
+            })
+                .catch(() => {
+                // Permissions API unavailable; subscription is a no-op.
+            });
+            return () => {
+                if (status !== null && handler !== null) {
+                    status.removeEventListener('change', handler);
+                    status = null;
+                    handler = null;
+                }
+            };
+        },
+        watchPosition(listener, options, onError) {
+            const geo = getWebGeolocation();
+            if (geo === null || typeof geo.watchPosition !== 'function')
+                return -1;
+            try {
+                return geo.watchPosition((position) => listener(mapWebPosition(position)), onError !== undefined ? (error) => onError(mapWebPositionError(error)) : () => { }, toPositionOptions(options));
+            }
+            catch {
+                return -1;
+            }
+        },
+    };
+}
+// Resolves the device's current position, or null when access is denied or unavailable.
+export function getCurrentGeoPosition(options) {
+    return getGeolocationBackend().getCurrentPosition(options ?? _emptyOptions);
+}
+// Resolves a GeoPositionResult carrying both the position and the error reason on failure.
+// Use when the caller needs to distinguish denied / unavailable / timeout rather than just null.
+export function getCurrentGeoPositionResult(options) {
+    return getGeolocationBackend().getCurrentPositionResult(options ?? _emptyOptions);
+}
+// The active geolocation backend, or a lazily-created web default. There is always a backend.
+export function getGeolocationBackend() {
+    if (_backend === null)
+        _backend = createWebGeolocationBackend();
+    return _backend;
+}
+// Resolves the current permission state without triggering a user prompt.
+// Returns 'granted', 'denied', or 'prompt' (the user has not yet been asked).
+// Falls back to 'prompt' when the Permissions API is absent.
+export function getGeolocationPermission() {
+    return getGeolocationBackend().getPermission();
+}
+// Returns true when the geolocation capability is available in the current context. Synchronous;
+// does not trigger a permission prompt. False on insecure context, jsdom, or missing navigator.
+export function isGeolocationAvailable() {
+    if (typeof navigator === 'undefined')
+        return false;
+    if (typeof window !== 'undefined' && window.isSecureContext === false)
+        return false;
+    return typeof navigator.geolocation !== 'undefined' && navigator.geolocation !== null;
+}
+// Subscribes to geolocation permission state changes. Invokes listener whenever the OS changes the
+// permission (e.g., the user revokes access in Settings mid-session). Returns an unsubscribe
+// function. No-op subscription when the Permissions API is absent.
+export function onGeolocationPermissionChange(listener) {
+    return getGeolocationBackend().subscribePermission(listener);
+}
+// Requests location permission. Resolves true when granted, false when denied or unavailable.
+export function requestGeolocationPermission() {
+    return getGeolocationBackend().requestPermission();
+}
+// Installs a native host geolocation backend; pass null to fall back to the web default.
+export function setGeolocationBackend(backend) {
+    _backend = backend;
+}
+// Starts a position watch, invoking handler on each update. Returns the watch id, or -1 when
+// watching is unavailable. Pair with clearGeolocationWatch.
+// Pass onError to receive ongoing failure reasons (e.g., permission revoked mid-watch).
+export function watchGeolocationPosition(handler, options, onError) {
+    return getGeolocationBackend().watchPosition(handler, options ?? _emptyOptions, onError);
+}
+let _backend = null;
+const _emptyOptions = {};
+const _noopUnsubscribe = () => { };
+function getWebGeolocation() {
+    if (typeof navigator === 'undefined')
+        return null;
+    return navigator.geolocation ?? null;
+}
+function mapWebPosition(position) {
+    const coords = position.coords;
+    return {
+        accuracy: coords.accuracy,
+        altitude: coords.altitude ?? 0,
+        altitudeAccuracy: coords.altitudeAccuracy ?? 0,
+        // floorLevel is non-standard: absent from the W3C GeolocationCoordinates type, but some hosts
+        // (indoor-positioning platforms) populate it. Read it when present rather than forcing 0.
+        floorLevel: coords.floorLevel ?? 0,
+        heading: coords.heading ?? 0,
+        latitude: coords.latitude,
+        longitude: coords.longitude,
+        speed: coords.speed ?? 0,
+        timestamp: position.timestamp,
+    };
+}
+function mapWebPositionError(error) {
+    switch (error.code) {
+        case 1:
+            return 'denied';
+        case 3:
+            return 'timeout';
+        default:
+            return 'unavailable';
+    }
+}
+function toPositionOptions(options) {
+    return {
+        enableHighAccuracy: options.enableHighAccuracy ?? false,
+        maximumAge: options.maximumAgeMs,
+        timeout: options.timeoutMs,
+    };
+}
+//# sourceMappingURL=geolocation.js.map

package/dist/geolocation.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './geolocation';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './geolocation';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@flighthq/geolocation",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Device geolocation (current position, watch, permission) over a swappable web/native backend",
+  "sideEffects": false
+}

package/src/geolocation.test.ts

@@ -0,0 +1,283 @@
+import type {
+  GeolocationBackend,
+  GeolocationErrorReason,
+  GeolocationPermissionState,
+  GeoPosition,
+} from '@flighthq/types';
+
+import {
+  clearGeolocationWatch,
+  createGeoPosition,
+  createWebGeolocationBackend,
+  getCurrentGeoPosition,
+  getCurrentGeoPositionResult,
+  getGeolocationBackend,
+  getGeolocationPermission,
+  isGeolocationAvailable,
+  onGeolocationPermissionChange,
+  requestGeolocationPermission,
+  setGeolocationBackend,
+  watchGeolocationPosition,
+} from './geolocation';
+
+function fakeBackend(): GeolocationBackend & { cleared: number[]; lastWatch: number } {
+  return {
+    cleared: [],
+    lastWatch: 0,
+    clearWatch(id) {
+      this.cleared.push(id);
+    },
+    async getCurrentPosition() {
+      const position = createGeoPosition();
+      position.latitude = 1;
+      position.longitude = 2;
+      return position;
+    },
+    async getCurrentPositionResult() {
+      const position = createGeoPosition();
+      position.latitude = 1;
+      position.longitude = 2;
+      return { position, reason: null };
+    },
+    async getPermission(): Promise<GeolocationPermissionState> {
+      return 'granted';
+    },
+    async requestPermission() {
+      return true;
+    },
+    subscribePermission(_listener: (state: GeolocationPermissionState) => void) {
+      return () => {};
+    },
+    watchPosition(listener, _options, onError) {
+      const position = createGeoPosition();
+      position.latitude = 3;
+      listener(position);
+      if (onError) onError('denied');
+      return ++this.lastWatch;
+    },
+  };
+}
+
+afterEach(() => setGeolocationBackend(null));
+
+describe('clearGeolocationWatch', () => {
+  it('does not throw on the web backend in jsdom', () => {
+    expect(() => clearGeolocationWatch(0)).not.toThrow();
+  });
+
+  it('forwards the id to the active backend', () => {
+    const backend = fakeBackend();
+    setGeolocationBackend(backend);
+    clearGeolocationWatch(7);
+    expect(backend.cleared).toEqual([7]);
+  });
+});
+
+describe('createGeoPosition', () => {
+  it('allocates a zeroed position', () => {
+    expect(createGeoPosition()).toEqual({
+      accuracy: 0,
+      altitude: 0,
+      altitudeAccuracy: 0,
+      floorLevel: 0,
+      heading: 0,
+      latitude: 0,
+      longitude: 0,
+      speed: 0,
+      timestamp: 0,
+    });
+  });
+});
+
+describe('createWebGeolocationBackend', () => {
+  it('resolves null and does not throw when geolocation is absent', async () => {
+    const backend = createWebGeolocationBackend();
+    expect(await backend.getCurrentPosition({})).toBeNull();
+    expect(typeof backend.watchPosition(() => {}, {})).toBe('number');
+    expect(() => backend.clearWatch(-1)).not.toThrow();
+    expect(typeof (await backend.requestPermission())).toBe('boolean');
+  });
+
+  it('getPermission returns a GeolocationPermissionState string', async () => {
+    const backend = createWebGeolocationBackend();
+    const state = await backend.getPermission();
+    expect(['granted', 'denied', 'prompt']).toContain(state);
+  });
+
+  it('getCurrentPositionResult returns unavailable reason when geolocation is absent', async () => {
+    const backend = createWebGeolocationBackend();
+    const result = await backend.getCurrentPositionResult({});
+    expect(result.position).toBeNull();
+    expect(result.reason).toBe('unavailable');
+  });
+
+  it('subscribePermission returns an unsubscribe function', () => {
+    const backend = createWebGeolocationBackend();
+    const unsubscribe = backend.subscribePermission(() => {});
+    expect(typeof unsubscribe).toBe('function');
+    expect(() => unsubscribe()).not.toThrow();
+  });
+
+  it('reads a host-provided floorLevel from coords', async () => {
+    const original = Object.getOwnPropertyDescriptor(navigator, 'geolocation');
+    Object.defineProperty(navigator, 'geolocation', {
+      configurable: true,
+      value: {
+        getCurrentPosition(success: (position: unknown) => void) {
+          success({
+            coords: {
+              accuracy: 5,
+              altitude: null,
+              altitudeAccuracy: null,
+              floorLevel: 3,
+              heading: null,
+              latitude: 1,
+              longitude: 2,
+              speed: null,
+            },
+            timestamp: 123,
+          });
+        },
+      },
+    });
+    try {
+      const backend = createWebGeolocationBackend();
+      const position = await backend.getCurrentPosition({});
+      expect(position?.floorLevel).toBe(3);
+    } finally {
+      if (original !== undefined) Object.defineProperty(navigator, 'geolocation', original);
+      else delete (navigator as { geolocation?: unknown }).geolocation;
+    }
+  });
+});
+
+describe('getCurrentGeoPosition', () => {
+  it('returns the backend position', async () => {
+    setGeolocationBackend(fakeBackend());
+    const position = (await getCurrentGeoPosition()) as GeoPosition;
+    expect(position.latitude).toBe(1);
+    expect(position.longitude).toBe(2);
+  });
+});
+
+describe('getCurrentGeoPositionResult', () => {
+  it('returns position and null reason on success', async () => {
+    setGeolocationBackend(fakeBackend());
+    const result = await getCurrentGeoPositionResult();
+    expect(result.position).not.toBeNull();
+    expect(result.position!.latitude).toBe(1);
+    expect(result.reason).toBeNull();
+  });
+
+  it('returns null position with a reason on failure (web backend in jsdom)', async () => {
+    const result = await getCurrentGeoPositionResult();
+    expect(result.position).toBeNull();
+    expect(result.reason).toBe('unavailable');
+  });
+});
+
+describe('getGeolocationBackend', () => {
+  it('falls back to a web backend', () => {
+    expect(getGeolocationBackend()).not.toBeNull();
+  });
+
+  it('returns the registered backend', () => {
+    const backend = fakeBackend();
+    setGeolocationBackend(backend);
+    expect(getGeolocationBackend()).toBe(backend);
+  });
+});
+
+describe('getGeolocationPermission', () => {
+  it('reflects the backend permission state', async () => {
+    setGeolocationBackend(fakeBackend());
+    expect(await getGeolocationPermission()).toBe('granted');
+  });
+
+  it('returns a GeolocationPermissionState string from the web backend', async () => {
+    const state = await getGeolocationPermission();
+    expect(['granted', 'denied', 'prompt']).toContain(state);
+  });
+});
+
+describe('isGeolocationAvailable', () => {
+  it('returns a boolean', () => {
+    expect(typeof isGeolocationAvailable()).toBe('boolean');
+  });
+
+  it('returns false in jsdom (no secure context / no navigator.geolocation)', () => {
+    // jsdom does not provide navigator.geolocation, so this is expected to be false.
+    expect(isGeolocationAvailable()).toBe(false);
+  });
+});
+
+describe('onGeolocationPermissionChange', () => {
+  it('returns an unsubscribe function', () => {
+    const unsubscribe = onGeolocationPermissionChange(() => {});
+    expect(typeof unsubscribe).toBe('function');
+    expect(() => unsubscribe()).not.toThrow();
+  });
+
+  it('uses the backend subscribePermission', () => {
+    let subscribed = false;
+    let unsubscribed = false;
+    const backend = fakeBackend();
+    backend.subscribePermission = (_listener) => {
+      subscribed = true;
+      return () => {
+        unsubscribed = true;
+      };
+    };
+    setGeolocationBackend(backend);
+    const unsub = onGeolocationPermissionChange(() => {});
+    expect(subscribed).toBe(true);
+    unsub();
+    expect(unsubscribed).toBe(true);
+  });
+});
+
+describe('requestGeolocationPermission', () => {
+  it('reflects the backend result', async () => {
+    setGeolocationBackend(fakeBackend());
+    expect(await requestGeolocationPermission()).toBe(true);
+  });
+
+  it('returns a boolean from the web backend without throwing', async () => {
+    expect(typeof (await requestGeolocationPermission())).toBe('boolean');
+  });
+});
+
+describe('setGeolocationBackend', () => {
+  it('clears back to the web fallback when passed null', () => {
+    setGeolocationBackend(fakeBackend());
+    setGeolocationBackend(null);
+    expect(getGeolocationBackend()).not.toBeNull();
+  });
+});
+
+describe('watchGeolocationPosition', () => {
+  it('delivers positions and returns a watch id', () => {
+    setGeolocationBackend(fakeBackend());
+    let seen = 0;
+    const id = watchGeolocationPosition((position) => {
+      seen = position.latitude;
+    });
+    expect(id).toBe(1);
+    expect(seen).toBe(3);
+  });
+
+  it('delivers error reasons when onError is provided', () => {
+    setGeolocationBackend(fakeBackend());
+    const errors: GeolocationErrorReason[] = [];
+    watchGeolocationPosition(
+      () => {},
+      {},
+      (reason) => errors.push(reason),
+    );
+    expect(errors).toEqual(['denied']);
+  });
+
+  it('returns -1 from the web backend when watching is unavailable', () => {
+    expect(watchGeolocationPosition(() => {})).toBe(-1);
+  });
+});