@bricks-soft/capacitor-location-tracking 0.0.0-stage → 8.0.0

package/dist/esm/web/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../../src/web/device.ts"],"names":[],"mappings":"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","sourcesContent":["// Owned by Unit 1 (TS wrapper + web).\nimport type { DeviceInfo } from '../definitions';\n\n/** Keep in sync with `package.json` (a test checks this) and `PLUGIN_VERSION` in `android/build.gradle`. */\nexport const PLUGIN_VERSION = '8.0.0';\n\n/** Tokens after `Android x` that do not name a device ('K' is Chrome's reduced user agent). */\nconst NOT_A_MODEL = ['K', 'U', 'wv', 'Mobile', 'Tablet', 'HarmonyOS'];\n\ninterface OsInfo {\n  osVersion: string;\n  manufacturer: string;\n  model: string | undefined;\n}\n\n/** The device model among the `;`-separated tokens that follow `Android x` in the user agent's comment. */\nfunction androidModel(tokens: string[]): string | undefined {\n  for (const token of tokens) {\n    const model = token.replace(/\\s*Build\\/.*$/, '').trim();\n    const skip =\n      !model ||\n      NOT_A_MODEL.indexOf(model) >= 0 ||\n      /^[a-z]{2}(?:[-_][a-z]{2})?$/i.test(model) || // locale, e.g. en-us\n      /^(?:rv:|HMSCore)/.test(model);\n    if (!skip) {\n      return model;\n    }\n  }\n  return undefined;\n}\n\nfunction parseOs(ua: string): OsInfo {\n  let match = /\\(([^)]*?)Android\\s*([\\d.]*)([^)]*)\\)/.exec(ua);\n  if (match) {\n    return {\n      osVersion: match[2] ? `Android ${match[2]}` : 'Android',\n      manufacturer: 'unknown',\n      model: androidModel(match[3].split(';')),\n    };\n  }\n  match = /(iPhone|iPad|iPod).*?OS (\\d+(?:_\\d+)*)/.exec(ua);\n  if (match) {\n    return { osVersion: `iOS ${match[2].replace(/_/g, '.')}`, manufacturer: 'Apple', model: match[1] };\n  }\n  match = /Mac OS X (\\d+(?:[_.]\\d+)*)/.exec(ua);\n  if (match) {\n    return { osVersion: `macOS ${match[1].replace(/_/g, '.')}`, manufacturer: 'Apple', model: 'Macintosh' };\n  }\n  match = /Windows NT (\\d+(?:\\.\\d+)*)/.exec(ua);\n  if (match) {\n    return { osVersion: `Windows ${match[1]}`, manufacturer: 'unknown', model: undefined };\n  }\n  match = /CrOS \\S+ (\\d+(?:\\.\\d+)*)/.exec(ua);\n  if (match) {\n    return { osVersion: `ChromeOS ${match[1]}`, manufacturer: 'unknown', model: undefined };\n  }\n  if (/Linux/.test(ua)) {\n    return { osVersion: 'Linux', manufacturer: 'unknown', model: undefined };\n  }\n  return { osVersion: 'unknown', manufacturer: 'unknown', model: undefined };\n}\n\n/** Browser name and major version, e.g. `Chrome 120`. Order matters: many browsers also claim Chrome or Safari. */\nfunction parseBrowser(ua: string): string {\n  const browsers: [string, RegExp][] = [\n    ['Edge', /Edg(?:e|A|iOS)?\\/(\\d+)/],\n    ['Opera', /(?:OPR|Opera)\\/(\\d+)/],\n    ['Samsung Internet', /SamsungBrowser\\/(\\d+)/],\n    ['Huawei Browser', /HuaweiBrowser\\/(\\d+)/],\n    ['Firefox', /(?:Firefox|FxiOS)\\/(\\d+)/],\n    ['Chrome', /(?:Chrome|CriOS)\\/(\\d+)/],\n    ['Safari', /Version\\/(\\d+)[\\d.]*.*Safari\\//],\n    ['Node.js', /Node\\.js\\/(\\d+)/],\n  ];\n  for (const [name, pattern] of browsers) {\n    const match = pattern.exec(ua);\n    if (match) {\n      return `${name} ${match[1]}`;\n    }\n  }\n  return 'unknown';\n}\n\n/**\n * Best-effort `DeviceInfo` for a browser, parsed from `navigator.userAgent`.\n * `brand` is the browser, `model` the device when the user agent names one (else `navigator.platform`),\n * `osVersion` includes the OS name, and `sdkInt` is -1 because there is no Android API level.\n */\nexport function webDeviceInfo(userAgent: string, platform?: string): DeviceInfo {\n  const os = parseOs(userAgent);\n  return {\n    platform: 'web',\n    manufacturer: os.manufacturer,\n    model: os.model || platform || 'unknown',\n    brand: parseBrowser(userAgent),\n    osVersion: os.osVersion,\n    sdkInt: -1,\n    pluginVersion: PLUGIN_VERSION,\n    gmsAvailable: false,\n    hmsAvailable: false,\n    backend: 'web',\n    packagedProviders: [],\n  };\n}\n"]}

package/dist/esm/web/errors.d.ts

@@ -0,0 +1,14 @@
+import { CapacitorException } from '@capacitor/core';
+import type { ErrorCode } from '../definitions';
+/** The `{ code, message }` shape passed to a watch callback on error. */
+export interface WebErrorInfo {
+    code: ErrorCode;
+    message: string;
+}
+/** A rejection shaped like the native bridge's: a `CapacitorException` whose `code` is an `ErrorCode`. */
+export declare function webError(code: ErrorCode, message: string): CapacitorException;
+/** `GeolocationPositionError.code`: 1 = PERMISSION_DENIED, 2 = POSITION_UNAVAILABLE, 3 = TIMEOUT. */
+export declare function positionErrorInfo(error: {
+    code?: number;
+    message?: string;
+} | null | undefined): WebErrorInfo;

package/dist/esm/web/errors.js

@@ -0,0 +1,19 @@
+// Owned by Unit 1 (TS wrapper + web).
+import { CapacitorException } from '@capacitor/core';
+/** A rejection shaped like the native bridge's: a `CapacitorException` whose `code` is an `ErrorCode`. */
+export function webError(code, message) {
+    return new CapacitorException(message, code);
+}
+/** `GeolocationPositionError.code`: 1 = PERMISSION_DENIED, 2 = POSITION_UNAVAILABLE, 3 = TIMEOUT. */
+export function positionErrorInfo(error) {
+    const raw = error && typeof error.code === 'number' ? error.code : 0;
+    const code = raw === 1 ? 'PERMISSION_DENIED' : raw === 3 ? 'TIMEOUT' : 'UNAVAILABLE';
+    const fallback = code === 'PERMISSION_DENIED'
+        ? 'Location permission denied.'
+        : code === 'TIMEOUT'
+            ? 'Timed out waiting for a location.'
+            : 'Location unavailable.';
+    const message = error && typeof error.message === 'string' && error.message ? error.message : fallback;
+    return { code, message };
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/web/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/web/errors.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAWrD,0GAA0G;AAC1G,MAAM,UAAU,QAAQ,CAAC,IAAe,EAAE,OAAe;IACvD,OAAO,IAAI,kBAAkB,CAAC,OAAO,EAAE,IAAgC,CAAC,CAAC;AAC3E,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,iBAAiB,CAAC,KAA6D;IAC7F,MAAM,GAAG,GAAG,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,MAAM,IAAI,GAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC;IAChG,MAAM,QAAQ,GACZ,IAAI,KAAK,mBAAmB;QAC1B,CAAC,CAAC,6BAA6B;QAC/B,CAAC,CAAC,IAAI,KAAK,SAAS;YAClB,CAAC,CAAC,mCAAmC;YACrC,CAAC,CAAC,uBAAuB,CAAC;IAChC,MAAM,OAAO,GAAG,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC","sourcesContent":["// Owned by Unit 1 (TS wrapper + web).\nimport { CapacitorException } from '@capacitor/core';\nimport type { ExceptionCode } from '@capacitor/core';\n\nimport type { ErrorCode } from '../definitions';\n\n/** The `{ code, message }` shape passed to a watch callback on error. */\nexport interface WebErrorInfo {\n  code: ErrorCode;\n  message: string;\n}\n\n/** A rejection shaped like the native bridge's: a `CapacitorException` whose `code` is an `ErrorCode`. */\nexport function webError(code: ErrorCode, message: string): CapacitorException {\n  return new CapacitorException(message, code as unknown as ExceptionCode);\n}\n\n/** `GeolocationPositionError.code`: 1 = PERMISSION_DENIED, 2 = POSITION_UNAVAILABLE, 3 = TIMEOUT. */\nexport function positionErrorInfo(error: { code?: number; message?: string } | null | undefined): WebErrorInfo {\n  const raw = error && typeof error.code === 'number' ? error.code : 0;\n  const code: ErrorCode = raw === 1 ? 'PERMISSION_DENIED' : raw === 3 ? 'TIMEOUT' : 'UNAVAILABLE';\n  const fallback =\n    code === 'PERMISSION_DENIED'\n      ? 'Location permission denied.'\n      : code === 'TIMEOUT'\n        ? 'Timed out waiting for a location.'\n        : 'Location unavailable.';\n  const message = error && typeof error.message === 'string' && error.message ? error.message : fallback;\n  return { code, message };\n}\n"]}

package/dist/esm/web/geolocation.d.ts

@@ -0,0 +1,26 @@
+import type { PermissionState } from '@capacitor/core';
+export interface SampleOptions {
+    /** Number of fixes to take, at least 1. */
+    samples: number;
+    /** Overall deadline for all samples, ms. */
+    timeout: number;
+    /** Passed to the first request only, so the browser may answer it from its cache; later samples are fresh. */
+    maximumAge: number;
+    enableHighAccuracy: boolean;
+}
+/** Returns `navigator.geolocation`, or `undefined` when the browser has none. */
+export declare function browserGeolocation(): Geolocation | undefined;
+/**
+ * Takes up to `samples` fixes with consecutive `getCurrentPosition` calls and resolves the most accurate one.
+ * The whole run shares one deadline (`timeout`). When the deadline passes, or a later call fails, it resolves the
+ * best fix taken so far; with no fix it rejects with `TIMEOUT`, `PERMISSION_DENIED` or `UNAVAILABLE`.
+ */
+export declare function sampleBestPosition(geolocation: Geolocation, options: SampleOptions): Promise<GeolocationPosition>;
+/**
+ * Asks for one fix so the browser shows its permission prompt, and waits for the user's answer.
+ * Resolves `'denied'` on PERMISSION_DENIED and `'granted'` otherwise: the browser reports TIMEOUT and
+ * POSITION_UNAVAILABLE only after permission was granted. Resolves `'prompt'` if nothing happens within a minute.
+ */
+export declare function probeLocationPermission(geolocation: Geolocation): Promise<PermissionState>;
+/** State of the browser's `geolocation` permission, or `undefined` when the Permissions API cannot tell. */
+export declare function queryLocationPermission(): Promise<PermissionState | undefined>;

package/dist/esm/web/geolocation.js

@@ -0,0 +1,117 @@
+import { positionErrorInfo, webError } from './errors';
+/** Largest delay `setTimeout` accepts; longer delays would fire immediately. */
+const MAX_TIMER_MS = 2147483647;
+/** How long the permission probe waits for a fix once the user has answered the prompt. */
+const PROBE_TIMEOUT_MS = 10000;
+/** Overall limit for the permission probe: some browsers never call back when their prompt is dismissed. */
+const PROBE_DEADLINE_MS = 60000;
+/** Returns `navigator.geolocation`, or `undefined` when the browser has none. */
+export function browserGeolocation() {
+    return typeof navigator !== 'undefined' && navigator && navigator.geolocation ? navigator.geolocation : undefined;
+}
+/**
+ * Takes up to `samples` fixes with consecutive `getCurrentPosition` calls and resolves the most accurate one.
+ * The whole run shares one deadline (`timeout`). When the deadline passes, or a later call fails, it resolves the
+ * best fix taken so far; with no fix it rejects with `TIMEOUT`, `PERMISSION_DENIED` or `UNAVAILABLE`.
+ */
+export function sampleBestPosition(geolocation, options) {
+    return new Promise((resolve, reject) => {
+        const deadline = Date.now() + options.timeout;
+        let best = null;
+        let taken = 0;
+        let done = false;
+        let timer;
+        const finish = (error) => {
+            if (done) {
+                return;
+            }
+            done = true;
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
+            if (best) {
+                resolve(best);
+            }
+            else {
+                reject(error || webError('TIMEOUT', `No location within ${options.timeout} ms.`));
+            }
+        };
+        const next = () => {
+            if (done) {
+                return;
+            }
+            try {
+                geolocation.getCurrentPosition((position) => {
+                    if (done) {
+                        return;
+                    }
+                    taken++;
+                    if (!best || position.coords.accuracy <= best.coords.accuracy) {
+                        best = position;
+                    }
+                    if (taken >= options.samples) {
+                        finish();
+                    }
+                    else {
+                        next();
+                    }
+                }, (error) => {
+                    const info = positionErrorInfo(error);
+                    finish(webError(info.code, info.message));
+                }, {
+                    enableHighAccuracy: options.enableHighAccuracy,
+                    maximumAge: taken === 0 ? options.maximumAge : 0,
+                    timeout: Math.max(0, deadline - Date.now()),
+                });
+            }
+            catch (e) {
+                finish(webError('UNAVAILABLE', e instanceof Error ? e.message : String(e)));
+            }
+        };
+        // The browser's own timeout does not run while its permission prompt is open; this deadline does.
+        if (options.timeout <= MAX_TIMER_MS) {
+            timer = setTimeout(() => finish(), options.timeout);
+        }
+        next();
+    });
+}
+/**
+ * Asks for one fix so the browser shows its permission prompt, and waits for the user's answer.
+ * Resolves `'denied'` on PERMISSION_DENIED and `'granted'` otherwise: the browser reports TIMEOUT and
+ * POSITION_UNAVAILABLE only after permission was granted. Resolves `'prompt'` if nothing happens within a minute.
+ */
+export function probeLocationPermission(geolocation) {
+    return new Promise((resolve) => {
+        let done = false;
+        const finish = (state) => {
+            if (!done) {
+                done = true;
+                clearTimeout(timer);
+                resolve(state);
+            }
+        };
+        const timer = setTimeout(() => finish('prompt'), PROBE_DEADLINE_MS);
+        try {
+            geolocation.getCurrentPosition(() => finish('granted'), (error) => finish(positionErrorInfo(error).code === 'PERMISSION_DENIED' ? 'denied' : 'granted'), { enableHighAccuracy: false, maximumAge: Infinity, timeout: PROBE_TIMEOUT_MS });
+        }
+        catch (_a) {
+            finish('prompt');
+        }
+    });
+}
+/** State of the browser's `geolocation` permission, or `undefined` when the Permissions API cannot tell. */
+export async function queryLocationPermission() {
+    const permissions = typeof navigator !== 'undefined' && navigator ? navigator.permissions : undefined;
+    if (!permissions || typeof permissions.query !== 'function') {
+        return undefined;
+    }
+    try {
+        const status = await permissions.query({ name: 'geolocation' });
+        const state = status.state;
+        return state === 'granted' || state === 'denied' || state === 'prompt' ? state : 'prompt';
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+//# sourceMappingURL=geolocation.js.map

package/dist/esm/web/geolocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation.js","sourceRoot":"","sources":["../../../src/web/geolocation.ts"],"names":[],"mappings":"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","sourcesContent":["// Owned by Unit 1 (TS wrapper + web).\nimport type { CapacitorException } from '@capacitor/core';\nimport type { PermissionState } from '@capacitor/core';\n\nimport { positionErrorInfo, webError } from './errors';\n\n/** Largest delay `setTimeout` accepts; longer delays would fire immediately. */\nconst MAX_TIMER_MS = 2147483647;\n\n/** How long the permission probe waits for a fix once the user has answered the prompt. */\nconst PROBE_TIMEOUT_MS = 10000;\n\n/** Overall limit for the permission probe: some browsers never call back when their prompt is dismissed. */\nconst PROBE_DEADLINE_MS = 60000;\n\nexport interface SampleOptions {\n  /** Number of fixes to take, at least 1. */\n  samples: number;\n  /** Overall deadline for all samples, ms. */\n  timeout: number;\n  /** Passed to the first request only, so the browser may answer it from its cache; later samples are fresh. */\n  maximumAge: number;\n  enableHighAccuracy: boolean;\n}\n\n/** Returns `navigator.geolocation`, or `undefined` when the browser has none. */\nexport function browserGeolocation(): Geolocation | undefined {\n  return typeof navigator !== 'undefined' && navigator && navigator.geolocation ? navigator.geolocation : undefined;\n}\n\n/**\n * Takes up to `samples` fixes with consecutive `getCurrentPosition` calls and resolves the most accurate one.\n * The whole run shares one deadline (`timeout`). When the deadline passes, or a later call fails, it resolves the\n * best fix taken so far; with no fix it rejects with `TIMEOUT`, `PERMISSION_DENIED` or `UNAVAILABLE`.\n */\nexport function sampleBestPosition(geolocation: Geolocation, options: SampleOptions): Promise<GeolocationPosition> {\n  return new Promise<GeolocationPosition>((resolve, reject) => {\n    const deadline = Date.now() + options.timeout;\n    let best: GeolocationPosition | null = null;\n    let taken = 0;\n    let done = false;\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const finish = (error?: CapacitorException): void => {\n      if (done) {\n        return;\n      }\n      done = true;\n      if (timer !== undefined) {\n        clearTimeout(timer);\n      }\n      if (best) {\n        resolve(best);\n      } else {\n        reject(error || webError('TIMEOUT', `No location within ${options.timeout} ms.`));\n      }\n    };\n\n    const next = (): void => {\n      if (done) {\n        return;\n      }\n      try {\n        geolocation.getCurrentPosition(\n          (position) => {\n            if (done) {\n              return;\n            }\n            taken++;\n            if (!best || position.coords.accuracy <= best.coords.accuracy) {\n              best = position;\n            }\n            if (taken >= options.samples) {\n              finish();\n            } else {\n              next();\n            }\n          },\n          (error) => {\n            const info = positionErrorInfo(error);\n            finish(webError(info.code, info.message));\n          },\n          {\n            enableHighAccuracy: options.enableHighAccuracy,\n            maximumAge: taken === 0 ? options.maximumAge : 0,\n            timeout: Math.max(0, deadline - Date.now()),\n          },\n        );\n      } catch (e) {\n        finish(webError('UNAVAILABLE', e instanceof Error ? e.message : String(e)));\n      }\n    };\n\n    // The browser's own timeout does not run while its permission prompt is open; this deadline does.\n    if (options.timeout <= MAX_TIMER_MS) {\n      timer = setTimeout(() => finish(), options.timeout);\n    }\n    next();\n  });\n}\n\n/**\n * Asks for one fix so the browser shows its permission prompt, and waits for the user's answer.\n * Resolves `'denied'` on PERMISSION_DENIED and `'granted'` otherwise: the browser reports TIMEOUT and\n * POSITION_UNAVAILABLE only after permission was granted. Resolves `'prompt'` if nothing happens within a minute.\n */\nexport function probeLocationPermission(geolocation: Geolocation): Promise<PermissionState> {\n  return new Promise<PermissionState>((resolve) => {\n    let done = false;\n    const finish = (state: PermissionState): void => {\n      if (!done) {\n        done = true;\n        clearTimeout(timer);\n        resolve(state);\n      }\n    };\n    const timer = setTimeout(() => finish('prompt'), PROBE_DEADLINE_MS);\n    try {\n      geolocation.getCurrentPosition(\n        () => finish('granted'),\n        (error) => finish(positionErrorInfo(error).code === 'PERMISSION_DENIED' ? 'denied' : 'granted'),\n        { enableHighAccuracy: false, maximumAge: Infinity, timeout: PROBE_TIMEOUT_MS },\n      );\n    } catch {\n      finish('prompt');\n    }\n  });\n}\n\n/** State of the browser's `geolocation` permission, or `undefined` when the Permissions API cannot tell. */\nexport async function queryLocationPermission(): Promise<PermissionState | undefined> {\n  const permissions = typeof navigator !== 'undefined' && navigator ? navigator.permissions : undefined;\n  if (!permissions || typeof permissions.query !== 'function') {\n    return undefined;\n  }\n  try {\n    const status = await permissions.query({ name: 'geolocation' });\n    const state = status.state;\n    return state === 'granted' || state === 'denied' || state === 'prompt' ? state : 'prompt';\n  } catch {\n    return undefined;\n  }\n}\n"]}

package/dist/esm/web/location.d.ts

@@ -0,0 +1,7 @@
+import type { Location, RecordEvent } from '../definitions';
+/** A version 4 UUID: `crypto.randomUUID()`, else built from `crypto.getRandomValues()`, else from `Math.random()`. */
+export declare function uuid(): string;
+/** ISO-8601 UTC with milliseconds (`yyyy-MM-ddTHH:mm:ss.SSSZ`). Invalid input falls back to now. */
+export declare function isoTime(epochMs: number): string;
+/** Maps a browser fix to the plugin's `Location` record shape. `extras` is left out when empty. */
+export declare function toLocation(position: GeolocationPosition, event: RecordEvent, extras?: Record<string, unknown>): Location;

package/dist/esm/web/location.js

@@ -0,0 +1,70 @@
+/** A version 4 UUID: `crypto.randomUUID()`, else built from `crypto.getRandomValues()`, else from `Math.random()`. */
+export function uuid() {
+    const webCrypto = typeof crypto !== 'undefined' ? crypto : undefined;
+    if (webCrypto && typeof webCrypto.randomUUID === 'function') {
+        return webCrypto.randomUUID();
+    }
+    const bytes = new Uint8Array(16);
+    if (webCrypto && typeof webCrypto.getRandomValues === 'function') {
+        webCrypto.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < bytes.length; i++) {
+            bytes[i] = Math.floor(Math.random() * 256);
+        }
+    }
+    bytes[6] = (bytes[6] & 0x0f) | 0x40;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    let hex = '';
+    for (let i = 0; i < bytes.length; i++) {
+        hex += (bytes[i] + 0x100).toString(16).slice(1);
+    }
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+/** ISO-8601 UTC with milliseconds (`yyyy-MM-ddTHH:mm:ss.SSSZ`). Invalid input falls back to now. */
+export function isoTime(epochMs) {
+    const ms = typeof epochMs === 'number' && isFinite(epochMs) ? Math.round(epochMs) : Date.now();
+    return new Date(ms).toISOString();
+}
+/** Monotonic milliseconds since the page's time origin: the closest web equivalent of `elapsedRealtime`. */
+function elapsedMs() {
+    const hasClock = typeof performance !== 'undefined' && typeof performance.now === 'function';
+    return hasClock ? Math.round(performance.now()) : 0;
+}
+function numberOrNull(value) {
+    return typeof value === 'number' && isFinite(value) ? value : null;
+}
+/** Maps a browser fix to the plugin's `Location` record shape. `extras` is left out when empty. */
+export function toLocation(position, event, extras) {
+    const coords = position.coords;
+    const location = {
+        uuid: uuid(),
+        event,
+        timestamp: isoTime(position.timestamp),
+        recorded_at: isoTime(Date.now()),
+        elapsed_realtime_ms: elapsedMs(),
+        boot_count: -1,
+        is_moving: false,
+        odometer: 0,
+        mock: false,
+        coords: {
+            latitude: coords.latitude,
+            longitude: coords.longitude,
+            accuracy: coords.accuracy,
+            altitude: numberOrNull(coords.altitude),
+            altitude_accuracy: numberOrNull(coords.altitudeAccuracy),
+            speed: numberOrNull(coords.speed),
+            speed_accuracy: null,
+            heading: numberOrNull(coords.heading),
+            heading_accuracy: null,
+        },
+        activity: { type: 'unknown', confidence: 0 },
+        battery: { level: -1, is_charging: false },
+        backend: 'web',
+    };
+    if (extras && Object.keys(extras).length > 0) {
+        location.extras = extras;
+    }
+    return location;
+}
+//# sourceMappingURL=location.js.map

package/dist/esm/web/location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../../../src/web/location.ts"],"names":[],"mappings":"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","sourcesContent":["// Owned by Unit 1 (TS wrapper + web).\nimport type { Location, RecordEvent } from '../definitions';\n\n/** A version 4 UUID: `crypto.randomUUID()`, else built from `crypto.getRandomValues()`, else from `Math.random()`. */\nexport function uuid(): string {\n  const webCrypto: Crypto | undefined = typeof crypto !== 'undefined' ? crypto : undefined;\n  if (webCrypto && typeof webCrypto.randomUUID === 'function') {\n    return webCrypto.randomUUID();\n  }\n  const bytes = new Uint8Array(16);\n  if (webCrypto && typeof webCrypto.getRandomValues === 'function') {\n    webCrypto.getRandomValues(bytes);\n  } else {\n    for (let i = 0; i < bytes.length; i++) {\n      bytes[i] = Math.floor(Math.random() * 256);\n    }\n  }\n  bytes[6] = (bytes[6] & 0x0f) | 0x40;\n  bytes[8] = (bytes[8] & 0x3f) | 0x80;\n  let hex = '';\n  for (let i = 0; i < bytes.length; i++) {\n    hex += (bytes[i] + 0x100).toString(16).slice(1);\n  }\n  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;\n}\n\n/** ISO-8601 UTC with milliseconds (`yyyy-MM-ddTHH:mm:ss.SSSZ`). Invalid input falls back to now. */\nexport function isoTime(epochMs: number): string {\n  const ms = typeof epochMs === 'number' && isFinite(epochMs) ? Math.round(epochMs) : Date.now();\n  return new Date(ms).toISOString();\n}\n\n/** Monotonic milliseconds since the page's time origin: the closest web equivalent of `elapsedRealtime`. */\nfunction elapsedMs(): number {\n  const hasClock = typeof performance !== 'undefined' && typeof performance.now === 'function';\n  return hasClock ? Math.round(performance.now()) : 0;\n}\n\nfunction numberOrNull(value: number | null | undefined): number | null {\n  return typeof value === 'number' && isFinite(value) ? value : null;\n}\n\n/** Maps a browser fix to the plugin's `Location` record shape. `extras` is left out when empty. */\nexport function toLocation(\n  position: GeolocationPosition,\n  event: RecordEvent,\n  extras?: Record<string, unknown>,\n): Location {\n  const coords = position.coords;\n  const location: Location = {\n    uuid: uuid(),\n    event,\n    timestamp: isoTime(position.timestamp),\n    recorded_at: isoTime(Date.now()),\n    elapsed_realtime_ms: elapsedMs(),\n    boot_count: -1,\n    is_moving: false,\n    odometer: 0,\n    mock: false,\n    coords: {\n      latitude: coords.latitude,\n      longitude: coords.longitude,\n      accuracy: coords.accuracy,\n      altitude: numberOrNull(coords.altitude),\n      altitude_accuracy: numberOrNull(coords.altitudeAccuracy),\n      speed: numberOrNull(coords.speed),\n      speed_accuracy: null,\n      heading: numberOrNull(coords.heading),\n      heading_accuracy: null,\n    },\n    activity: { type: 'unknown', confidence: 0 },\n    battery: { level: -1, is_charging: false },\n    backend: 'web',\n  };\n  if (extras && Object.keys(extras).length > 0) {\n    location.extras = extras;\n  }\n  return location;\n}\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,164 @@
+import { WebPlugin } from '@capacitor/core';
+import type { BatteryOptimizationStatus, CallbackID, Config, CurrentPositionOptions, DeviceInfo, Geofence, HeartbeatStatus, InsertLocationInput, Location, LocationTrackingPlugin, LogLevel, LogQuery, PermissionStatus, PermissionType, PowerManagerInfo, ProviderState, ReadyOptions, Sensors, State, WatchPositionCallback, WatchPositionOptions } from './definitions';
+/**
+ * Web implementation. It covers `getCurrentPosition`, `watchPosition` and `clearWatch` (via `navigator.geolocation`),
+ * an in-memory config and state, permissions and device info. Nothing is persisted or uploaded, and tracking cannot
+ * be started. Every other method rejects with `UNIMPLEMENTED`.
+ *
+ * Like the Android bridge, methods other than `ready`, `getState`, `checkPermissions`, `requestPermissions` and
+ * `getDeviceInfo` reject with `NOT_READY` until `ready()` has resolved.
+ */
+export declare class LocationTrackingWeb extends WebPlugin implements LocationTrackingPlugin {
+    private config;
+    private isReady;
+    private lastPosition;
+    private watchSeq;
+    private readonly watches;
+    ready(options?: ReadyOptions): Promise<State>;
+    setConfig(options: {
+        config: Config;
+    }): Promise<State>;
+    reset(options?: {
+        config?: Config;
+    }): Promise<State>;
+    getState(): Promise<State>;
+    start(): Promise<State>;
+    startGeofences(): Promise<State>;
+    stop(): Promise<State>;
+    changePace(_options: {
+        isMoving: boolean;
+    }): Promise<void>;
+    /**
+     * Takes `samples` fixes within `timeout` and resolves the most accurate one. With `maximumAge > 0`, a fix this
+     * plugin received at most that long ago is returned right away. Like a persisted record on Android, the result is
+     * also emitted as a `location` event unless `persist` is false.
+     */
+    getCurrentPosition(options?: CurrentPositionOptions): Promise<Location>;
+    /**
+     * Starts `navigator.geolocation.watchPosition` and resolves its id. The callback gets each fix as a
+     * `watch_position` Location, or `(null, { code, message })` on error. `interval` is ignored: the browser decides
+     * how often fixes arrive. With `persist: true` each fix is also emitted as a `location` event.
+     */
+    watchPosition(options: WatchPositionOptions, callback: WatchPositionCallback): Promise<CallbackID>;
+    /** Stops a watch. Unknown ids are ignored. */
+    clearWatch(options: {
+        id: CallbackID;
+    }): Promise<void>;
+    getOdometer(): Promise<{
+        odometer: number;
+    }>;
+    setOdometer(_options: {
+        odometer: number;
+    }): Promise<{
+        odometer: number;
+    }>;
+    resetOdometer(): Promise<{
+        odometer: number;
+    }>;
+    getLocations(_options?: {
+        limit?: number;
+    }): Promise<{
+        locations: Location[];
+    }>;
+    getCount(): Promise<{
+        count: number;
+    }>;
+    insertLocation(_options: {
+        location: InsertLocationInput;
+    }): Promise<{
+        uuid: string;
+    }>;
+    destroyLocations(): Promise<{
+        count: number;
+    }>;
+    destroyLocation(_options: {
+        uuid: string;
+    }): Promise<{
+        deleted: boolean;
+    }>;
+    sync(): Promise<{
+        locations: Location[];
+    }>;
+    addGeofence(_options: {
+        geofence: Geofence;
+    }): Promise<void>;
+    addGeofences(_options: {
+        geofences: Geofence[];
+    }): Promise<void>;
+    removeGeofence(_options: {
+        identifier: string;
+    }): Promise<void>;
+    removeGeofences(_options?: {
+        identifiers?: string[];
+    }): Promise<void>;
+    getGeofences(): Promise<{
+        geofences: Geofence[];
+    }>;
+    getGeofence(_options: {
+        identifier: string;
+    }): Promise<{
+        geofence: Geofence | null;
+    }>;
+    geofenceExists(_options: {
+        identifier: string;
+    }): Promise<{
+        exists: boolean;
+    }>;
+    getHeartbeatStatus(): Promise<HeartbeatStatus>;
+    getProviderState(): Promise<ProviderState>;
+    isPowerSaveMode(): Promise<{
+        isPowerSaveMode: boolean;
+    }>;
+    getBatteryOptimizationStatus(): Promise<BatteryOptimizationStatus>;
+    openBatteryOptimizationSettings(): Promise<{
+        opened: boolean;
+    }>;
+    getPowerManagerInfo(): Promise<PowerManagerInfo>;
+    openPowerManagerSettings(): Promise<{
+        opened: boolean;
+    }>;
+    openLocationSettings(): Promise<{
+        opened: boolean;
+    }>;
+    openAppSettings(): Promise<{
+        opened: boolean;
+    }>;
+    /** Best-effort values parsed from `navigator.userAgent`; `platform` is `'web'`. */
+    getDeviceInfo(): Promise<DeviceInfo>;
+    getSensors(): Promise<Sensors>;
+    /** `location` comes from the Permissions API (`'prompt'` when it cannot tell); the other three are `'granted'`. */
+    checkPermissions(): Promise<PermissionStatus>;
+    /** When `location` is requested and still undecided, asks for a fix so the browser prompts, then reports. */
+    requestPermissions(options?: {
+        permissions?: PermissionType[];
+    }): Promise<PermissionStatus>;
+    log(_options: {
+        level: Exclude<LogLevel, 'off'>;
+        message: string;
+    }): Promise<void>;
+    getLog(_options?: LogQuery): Promise<{
+        log: string;
+    }>;
+    destroyLog(): Promise<void>;
+    uploadLog(_options: {
+        url: string;
+        headers?: Record<string, string>;
+        params?: Record<string, unknown>;
+    }): Promise<{
+        success: boolean;
+        status: number;
+    }>;
+    emailLog(_options: {
+        email: string;
+        subject?: string;
+    }): Promise<void>;
+    private requireReady;
+    private requireGeolocation;
+    /** `persistence.extras` merged with the call's extras (the call wins), like records created on Android. */
+    private recordExtras;
+    /**
+     * Like `notifyListeners`, but each listener gets its own copy of the payload (as on native, where every listener
+     * receives deserialized data), and a throwing listener neither skips the others nor fails the calling method.
+     */
+    private emit;
+}