starti.app 2.0.21 → 2.0.35

package/dist/integrationWrapper.d.ts

@@ -6,7 +6,7 @@ type AsyncIntegrationResolverCallOptions<TMethodKey, TMethodResponse> = {
     methodName: TMethodKey;
     shouldResolve?: (value: TMethodResponse) => boolean;
 };
-declare class AsyncIntegrationResolver<TIntegrationKey extends keyof Integrations> {
+export declare class AsyncIntegrationResolver<TIntegrationKey extends keyof Integrations> {
     private integrationKey;
     promises: Record<string, Array<{
         resolve: PromiseResolve<any>;
@@ -38,6 +38,9 @@ declare class AsyncIntegrationResolver<TIntegrationKey extends keyof Integration
      * <integration>.listen("eventName", (args) => {
      *    console.log(args);
      * });
+     *
+     * // !!! Important to add .bind(this) when using the listen method like so !!!
+     * <integration>.listen("eventName", this.onEventName.bind(this));
      * ```
      */
     listen(eventName: string, listener: (...args: any[]) => void): Promise<void>;

package/dist/integrations/Biometrics/BiometricsIntegration.d.ts

@@ -37,7 +37,7 @@ export declare class Biometrics extends EventTarget {
     /**
      * Checks if there's a saved username and password.
      */
-    hasUsernameAndPassword(): Promise<BiometricsResultReponse<boolean>>;
+    hasUsernameAndPassword(): Promise<boolean>;
     /**
      *  Removes the saved username and password.
      */
@@ -54,7 +54,7 @@ export declare class Biometrics extends EventTarget {
      * Checks if there's secured content.
      * @returns Returns true if the secured content exists, false otherwise.
      */
-    hasSecuredContent(): Promise<BiometricsResultReponse<boolean>>;
+    hasSecuredContent(): Promise<boolean>;
     /**
      * Removes secured content.
      *

package/dist/integrations/Location/LocationIntegration.d.ts

@@ -1,6 +1,35 @@
+import { EventTargetWithType } from "../../EventTarget";
 import { Startiapp } from "../../startiapp";
-export declare class Location extends EventTarget {
+import { Location as LocationDto, LocationListeningOptions, LocationOptions } from "./types";
+export declare class Location extends EventTargetWithType<{
+    locationChanged: CustomEvent<LocationDto>;
+}> {
     private readonly startiapp;
     private locationIntegration;
     constructor(startiapp: Startiapp);
+    /**
+     * Retrieves the current location.
+     *
+     * @param options - The options for retrieving the location.
+     * @returns A promise that resolves to the current location.
+     */
+    getLocation(options?: LocationOptions): Promise<LocationDto>;
+    /**
+     * Starts the location listener.
+     *
+     * @param options - The options for location listening.
+     * @returns A promise that resolves when the location listener has started.
+     */
+    startLocationListener(options?: LocationListeningOptions): Promise<boolean>;
+    /**
+     * Checks if the location listener is active.
+     * @returns True if the location listener is active, false otherwise.
+     */
+    isLocationListenerActive(): Promise<boolean>;
+    /**
+     * Stops the location listener.
+     */
+    stopLocationListener(): Promise<void>;
+    private onListeningFailed;
+    private onLocationChanged;
 }

package/dist/integrations/Location/types.d.ts

@@ -0,0 +1,44 @@
+export interface Location {
+    latitude: number;
+    longitude: number;
+    altitude?: number | null;
+    accuracy?: number | null;
+    altitudeAccuracy?: number | null;
+    reducedAccuracy: boolean;
+    heading?: number | null;
+    speed?: number | null;
+    isFromMockProvider: boolean;
+    timestamp: string;
+}
+export interface LocationOptions {
+    /**
+     * The maximum time in milliseconds to wait for a location update.
+     */
+    timeoutInMs?: number;
+    /**
+     * The maximum age in milliseconds of a cached location that is acceptable to return.
+     */
+    maxAgeInMs?: number;
+    /**
+     * The desired accuracy of the location updates.
+     */
+    desiredAccuracy?: LocationAccuracyDto;
+}
+export interface LocationListeningOptions {
+    /**
+     * The minimum time in milliseconds between location updates.
+     */
+    minimumTimeInMs?: number;
+    /**
+     * The desired accuracy of the location updates.
+     */
+    desiredAccuracy?: LocationAccuracyDto;
+}
+export declare enum LocationAccuracyDto {
+    Default = "Default",
+    Lowest = "Lowest",
+    Low = "Low",
+    Medium = "Medium",
+    High = "High",
+    Best = "Best"
+}

package/dist/integrations.d.ts

@@ -1,6 +1,7 @@
 import { NavigationSpinnerOptions, RegexDto } from "./integrations/App/typings";
 import { BiometricsAuthenticationType, BiometricsResultReponse } from "./integrations/Biometrics/BiometricsIntegration";
 import { InApPurchasePurchaseType, InAppPurchaseGetProductResponse, InAppPurchaseProductResponse, InAppPurchaseResponse } from "./integrations/InAppPurchase/InAppPurchaseIntegration";
+import { Location, LocationListeningOptions, LocationOptions } from "./integrations/Location/types";
 import { ListenResponse, NetworkAccess } from "./integrations/Network/NetworkIntegration";
 import { SetStatusBarOptions } from "./startiapp";
 export type PushNotificationIntegration = {
@@ -107,7 +108,12 @@ type DeveloperIntegration = {
 type StorageIntegration = {
     clearWebData(): void;
 };
-type LocationIntegration = object;
+type LocationIntegration = {
+    getLocation(options?: LocationOptions): Location;
+    startLocationListener(options?: LocationListeningOptions): boolean;
+    stopLocationListener(): void;
+    isLocationListenerActive(): boolean;
+};
 export type Integrations = {
     "AppIntegration": AppIntegration;
     "DeviceIntegration": DeviceIntegration;

package/package.json

@@ -2,7 +2,7 @@
   "name": "starti.app",
   "author": "starti.app",
   "license": "MIT",
-  "version": "2.0.21",
+  "version": "2.0.35",
   "description": "Use this package for easy communication with the starti.app API.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",