@multisetai/vps 1.0.6 → 1.0.7-beta.0

package/README.md

@@ -24,11 +24,13 @@ npm install @multisetai/vps three
 
 ### Runtime Requirements
 
-- **HTTPS**: WebXR requires a secure context. Use HTTPS in production or `https://localhost` for local development.
-- **WebXR-capable device**: Android device with ARCore or iOS device with ARKit (via WebXR Viewer or Safari)
-- **Modern browser**: Chrome/Edge (Android) or Safari (iOS 15+)
+- **HTTPS**: WebXR requires a secure context. Use HTTPS in production or `http://localhost` for local development.
+- **WebXR-capable device**: Android device with ARCore
+- **Modern browser**: Chrome or Edge on Android
 - **Three.js**: Version 0.176.0 or higher (peer dependency)
 
+> **iOS is not supported.** This SDK requires the `camera-access` WebXR feature to capture frames for localization. Safari on iOS does not implement `camera-access`, so the AR session will fail to start on any iOS browser.
+
 ### Development Requirements
 
 - Node.js 16+ and npm
@@ -55,7 +57,7 @@ Since this SDK makes direct API calls to MultiSet servers from browser-based app
 Add entries for both your local development and production environments:
 
 **Local Development:**
-- **Format:** `http://localhost:PORT` (e.g., `http://localhost:3000`, `http://localhost:5173`)
+- **Format:** `https://localhost:PORT` (e.g., `https://localhost:3000`, `https://localhost:5173`)
 - **Note:** Use the exact port your development server runs on
 
 **Production:**
@@ -81,7 +83,7 @@ import { WebxrController } from '@multisetai/vps/webxr';
 const client = new MultisetClient({
   clientId: 'CLIENT_ID',
   clientSecret: 'CLIENT_SECRET',
-  code: 'MAP_OUR_MAPSET_CODE',
+  code: 'MAP_OR_MAPSET_CODE',
   mapType: 'map', // or 'map-set'
   endpoints: DEFAULT_ENDPOINTS,
   onAuthorize: (token) => console.log('Authorized:', token),
@@ -131,11 +133,42 @@ new MultisetClient(config: IMultisetSdkConfig)
 
 ```typescript
 interface IMultisetSdkConfig {
+  // Core
   clientId: string;                    // Your MultiSet client ID
   clientSecret: string;                // Your MultiSet client secret
-  code: string;                        // Map code (e.g., 'MAP_XXXXX')
+  code: string;                        // Map or map-set code (e.g., 'MAP_XXXXX')
   mapType: 'map' | 'map-set';         // Type of map to use
   endpoints?: Partial<IMultisetSdkEndpoints>; // Optional custom endpoints
+  mapId?: string;                      // Optional map ID (overrides code-based lookup)
+  mapSetId?: string;                   // Optional map-set ID (overrides code-based lookup)
+
+  // Localization behavior
+  /** If true, automatically start a localization run when the AR session starts. */
+  autoLocalize?: boolean;
+  /** If true, automatically re-localize when tracking is lost and then recovered. */
+  relocalization?: boolean;
+  /** When enabled, only accept a localization result if confidence >= confidenceThreshold. */
+  confidenceCheck?: boolean;
+  /** Minimum confidence (0.2–0.8) required when confidenceCheck is enabled. */
+  confidenceThreshold?: number;
+  /** Total single-frame attempts per localization run (1–5). */
+  requestAttempts?: number;
+  /** Time in seconds between attempts in a localization run (1–5). */
+  localizationInterval?: number;
+  /** Include device geo pose as a hint in localization requests. */
+  passGeoPose?: boolean;
+  /** Request geo coordinates in the localization response (if supported by backend). */
+  geoCoordinatesInResponse?: boolean;
+
+  // Localization lifecycle callbacks
+  /** Invoked at the start of a localization run. */
+  onLocalizationInit?: () => void;
+  /** Invoked after a successful localization that meets confidence criteria (if enabled). */
+  onLocalizationSuccess?: (result: ILocalizeAndMapDetails) => void;
+  /** Invoked when all attempts fail or the best result is below the confidence threshold. */
+  onLocalizationFailure?: (reason?: string) => void;
+
+  // Core callbacks
   onAuthorize?: (token: string) => void;
   onFrameCaptured?: (payload: IFrameCaptureEvent) => void;
   onCameraIntrinsics?: (intrinsics: ICameraIntrinsicsEvent) => void;
@@ -156,15 +189,28 @@ const token = await client.authorize();
 
 **Returns**: The access token as a string.
 
-#### Events
+#### Events and callbacks
 
-The client emits events through callback functions:
+The client and controller emit events through callback functions:
 
 - **`onAuthorize`**: Called when authorization succeeds with the access token
 - **`onFrameCaptured`**: Called when a camera frame is captured for localization
 - **`onCameraIntrinsics`**: Called with camera intrinsic parameters
 - **`onPoseResult`**: Called with localization results (pose found/not found)
-- **`onError`**: Called when any error occurs
+- **`onLocalizationInit`**: Called at the start of a localization run
+- **`onLocalizationSuccess`**: Called when a localization run succeeds (optionally after confidence checks)
+- **`onLocalizationFailure`**: Called when a localization run fails or the best result is below the confidence threshold
+- **`onError`**: Called when any error occurs during authorization or localization
+
+### Advanced localization behavior
+
+`MultisetClient` together with `WebxrController` supports a higher-level localization flow similar to the Unity SingleFrameLocalizationManager:
+
+- **Multiple attempts per run**: `requestAttempts` and `localizationInterval` control how many single-frame attempts are made and how long to wait between them.
+- **Confidence-based acceptance**: When `confidenceCheck` is `true`, only results with `confidence >= confidenceThreshold` (0.2–0.8) are treated as successful.
+- **Auto-localize**: When `autoLocalize` is `true`, a localization run is started automatically when the AR session starts.
+- **Re-localize on tracking loss**: When `relocalization` is `true`, the controller automatically tries to re-localize after tracking has been lost for a short period.
+- **Geo hint**: When `passGeoPose` is `true`, the SDK uses the browser Geolocation API to compute a `geoHint` string `"lat,lon,alt"` and sends it with the localization request. When `geoCoordinatesInResponse` is `true`, the backend may include geo coordinates in the response (if supported).
 
 ## WebXR Controller API
 
@@ -216,7 +262,26 @@ if (result?.localizeData?.poseFound) {
 }
 ```
 
-**Returns**: Object with `localizeData` and optional `mapDetails`, or `null` if capture fails.
+**Returns**: Object with `localizeData` and optional `mapDetails`, or `null` if no pose is found or capture fails.
+
+##### `localizeFrame(): Promise<ILocalizeAndMapDetails | null>`
+
+Runs a full localization cycle using the configured `requestAttempts`, `localizationInterval`,
+`confidenceCheck`, and `confidenceThreshold`:
+
+```typescript
+const result = await controller.localizeFrame();
+if (result?.localizeData?.poseFound) {
+  console.log('Localized at:', result.localizeData.position);
+}
+```
+
+This method:
+
+- Fires `onLocalizationInit` at the start of the run
+- Performs multiple attempts and picks the best result by confidence
+- Applies the confidence threshold when `confidenceCheck` is enabled
+- Calls `onLocalizationSuccess` or `onLocalizationFailure` accordingly
 
 ##### `getScene(): THREE.Scene`
 
@@ -308,6 +373,15 @@ const client = new MultisetClient({
   code: 'MAP_OR_MAPSET_CODE',
   mapType: 'map',
   endpoints: DEFAULT_ENDPOINTS,
+  // Optional advanced behavior
+  autoLocalize: true,
+  relocalization: true,
+  confidenceCheck: true,
+  confidenceThreshold: 0.5,
+  requestAttempts: 3,
+  localizationInterval: 2,
+  passGeoPose: true,
+  geoCoordinatesInResponse: true,
   onAuthorize: (token) => console.log('Authorized:', token),
   onError: (error) => console.error('Error:', error),
 });

package/dist/core/index.d.ts

@@ -128,15 +128,46 @@ interface ILocalizeAndMapDetails {
 }
 
 interface IMultisetSdkConfig {
+    mapId?: string;
+    mapSetId?: string;
     clientId: string;
     clientSecret: string;
+    /** Map or map-set code used for localization. */
     code: string;
+    /** Map or map-set type ('map' or 'map-set'). */
     mapType: MapType;
     endpoints?: Partial<IMultisetSdkEndpoints>;
+    /** If true, automatically start a localization run when the AR session starts. */
+    autoLocalize?: boolean;
+    /** If true, automatically re-localize when tracking is lost and then recovered. */
+    relocalization?: boolean;
+    /** When enabled, only accept a localization result if confidence >= confidenceThreshold. */
+    confidenceCheck?: boolean;
+    /** Minimum confidence (0.2–0.8) required when confidenceCheck is enabled. */
+    confidenceThreshold?: number;
+    /** Total single-frame attempts per localization run (1–5). */
+    requestAttempts?: number;
+    /** Time in seconds between attempts in a localization run (1–5). */
+    localizationInterval?: number;
+    /** Include device geo pose as a hint in localization requests. */
+    passGeoPose?: boolean;
+    /** Request geo coordinates in the localization response (if supported by backend). */
+    geoCoordinatesInResponse?: boolean;
+    /** Invoked at the start of a localization run. */
+    onLocalizationInit?: () => void;
+    /** Invoked after a successful localization that meets confidence criteria (if enabled). */
+    onLocalizationSuccess?: (result: ILocalizeAndMapDetails) => void;
+    /** Invoked when all attempts fail or the best result is below the confidence threshold. */
+    onLocalizationFailure?: (reason?: string) => void;
+    /** Called after a successful authorization with the access token. */
     onAuthorize?: (token: string) => void;
+    /** Called whenever a camera frame is captured and sent for localization. */
     onFrameCaptured?: (payload: IFrameCaptureEvent) => void;
+    /** Called with the camera intrinsics used for a localization request. */
     onCameraIntrinsics?: (intrinsics: ICameraIntrinsicsEvent) => void;
+    /** Called with the raw pose/localization result returned by the backend. */
     onPoseResult?: (payload: IPoseResultEvent) => void;
+    /** Called when any error occurs during authorization or localization. */
     onError?: (error: unknown) => void;
 }
 interface IMultisetSdkEndpoints {
@@ -181,18 +212,18 @@ interface ILocalizeResultEvent {
     response: ILocalizeAndMapDetails | null;
 }
 declare const DEFAULT_ENDPOINTS: IMultisetSdkEndpoints;
-/**
- * Placeholder class to be implemented by porting logic from multiset-webxr-sdk.
- */
+
 declare class MultisetClient {
     private readonly config;
     private readonly endpoints;
     private accessToken;
     constructor(config: IMultisetSdkConfig);
     get token(): string | null;
+    getConfig(): IMultisetSdkConfig;
     authorize(): Promise<string>;
     private handleError;
     localizeWithFrame(frame: IFrameCaptureEvent, intrinsics: ICameraIntrinsicsEvent): Promise<ILocalizeAndMapDetails | null>;
+    private getGeoPoseComponents;
     private queryLocalization;
     private fetchMapDetails;
     private fetchMapSetDetails;

package/dist/core/index.js

@@ -1,6 +1,6 @@
 import axios from 'axios';
 
-// src/lib/core/index.ts
+// src/lib/core/config.ts
 var DEFAULT_ENDPOINTS = {
   authUrl: "https://api.multiset.ai/v1/m2m/token",
   queryUrl: "https://api.multiset.ai/v1/vps/map/query-form",
@@ -21,6 +21,9 @@ var MultisetClient = class {
   get token() {
     return this.accessToken;
   }
+  getConfig() {
+    return this.config;
+  }
   async authorize() {
     var _a, _b, _c, _d, _e;
     try {
@@ -68,22 +71,54 @@ var MultisetClient = class {
     }
     return queryResult;
   }
+  async getGeoPoseComponents() {
+    if (typeof navigator === "undefined" || !("geolocation" in navigator) || !navigator.geolocation) {
+      return null;
+    }
+    try {
+      const position = await new Promise((resolve, reject) => {
+        navigator.geolocation.getCurrentPosition(resolve, reject, {
+          enableHighAccuracy: true,
+          timeout: 1e4,
+          maximumAge: 0
+        });
+      });
+      const { latitude, longitude, altitude } = position.coords;
+      const safeAltitude = typeof altitude === "number" && !Number.isNaN(altitude) ? altitude : 0;
+      return [latitude, longitude, safeAltitude];
+    } catch {
+      return null;
+    }
+  }
   async queryLocalization(frame, intrinsics) {
-    var _a;
+    var _a, _b, _c;
     const formData = new FormData();
-    formData.append("isRightHanded", "true");
-    formData.append("width", `${frame.width}`);
-    formData.append("height", `${frame.height}`);
-    formData.append("px", `${intrinsics.px}`);
-    formData.append("py", `${intrinsics.py}`);
-    formData.append("fx", `${intrinsics.fx}`);
-    formData.append("fy", `${intrinsics.fy}`);
-    formData.append("queryImage", frame.blob);
+    formData.append("mapId", (_a = this.config.mapId) != null ? _a : "");
+    formData.append("mapSetId", (_b = this.config.mapSetId) != null ? _b : "");
     if (this.config.mapType === "map") {
       formData.append("mapCode", this.config.code);
     } else {
       formData.append("mapSetCode", this.config.code);
     }
+    formData.append("isRightHanded", "true");
+    formData.append("fx", `${intrinsics.fx}`);
+    formData.append("fy", `${intrinsics.fy}`);
+    formData.append("px", `${intrinsics.px}`);
+    formData.append("py", `${intrinsics.py}`);
+    formData.append("width", `${frame.width}`);
+    formData.append("height", `${frame.height}`);
+    formData.append("queryImage", frame.blob);
+    if (this.config.geoCoordinatesInResponse) {
+      formData.append("geoCoordinatesInResponse", "true");
+    }
+    if (this.config.passGeoPose) {
+      const components = await this.getGeoPoseComponents();
+      if (components) {
+        const [latitude, longitude, altitude] = components;
+        const geoHint = `${latitude},${longitude},${altitude}`;
+        formData.append("geoHint", geoHint);
+      }
+    }
     try {
       const response = await axios.post(
         this.endpoints.queryUrl,
@@ -101,7 +136,7 @@ var MultisetClient = class {
       const result = {
         localizeData: data
       };
-      if ((_a = data.mapIds) == null ? void 0 : _a.length) {
+      if ((_c = data.mapIds) == null ? void 0 : _c.length) {
         const mapDetails = await this.fetchMapDetails(data.mapIds[0]);
         if (mapDetails) {
           result.mapDetails = mapDetails;

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/core/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import axios, { AxiosError } from 'axios';\nimport type {\n  ILocalizeAndMapDetails,\n  ILocalizeResponse,\n  MapType,\n  IGetMapsDetailsResponse,\n  IMapSetMapsResponse,\n} from './types';\n\nexport interface IMultisetSdkConfig {\n  clientId: string;\n  clientSecret: string;\n  code: string;\n  mapType: MapType;\n  endpoints?: Partial<IMultisetSdkEndpoints>;\n  onAuthorize?: (token: string) => void;\n  onFrameCaptured?: (payload: IFrameCaptureEvent) => void;\n  onCameraIntrinsics?: (intrinsics: ICameraIntrinsicsEvent) => void;\n  onPoseResult?: (payload: IPoseResultEvent) => void;\n  onError?: (error: unknown) => void;\n}\n\nexport interface IMultisetSdkEndpoints {\n  authUrl: string;\n  queryUrl: string;\n  mapDetailsUrl: string;\n  fileDownloadUrl: string;\n  mapSetDetailsUrl: string;\n}\n\nexport interface IFrameCaptureEvent {\n  blob: Blob;\n  width: number;\n  height: number;\n}\n\nexport interface ICameraIntrinsicsEvent {\n  fx: number;\n  fy: number;\n  px: number;\n  py: number;\n  width: number;\n  height: number;\n}\n\nexport interface IPoseResultEvent {\n  poseFound: boolean;\n  position: {\n    x: number;\n    y: number;\n    z: number;\n  };\n  rotation: {\n    x: number;\n    y: number;\n    z: number;\n    w: number;\n  };\n  mapIds: string[];\n  confidence?: number;\n}\n\nexport interface ILocalizeResultEvent {\n  frame: IFrameCaptureEvent;\n  intrinsics: ICameraIntrinsicsEvent;\n  response: ILocalizeAndMapDetails | null;\n}\n\nexport const DEFAULT_ENDPOINTS: IMultisetSdkEndpoints = {\n  authUrl: 'https://api.multiset.ai/v1/m2m/token',\n  queryUrl: 'https://api.multiset.ai/v1/vps/map/query-form',\n  mapDetailsUrl: 'https://api.multiset.ai/v1/vps/map/',\n  mapSetDetailsUrl: 'https://api.multiset.ai/v1/vps/map-set/',\n  fileDownloadUrl: 'https://api.multiset.ai/v1/file',\n};\n\n/**\n * Placeholder class to be implemented by porting logic from multiset-webxr-sdk.\n */\nexport class MultisetClient {\n  private readonly endpoints: IMultisetSdkEndpoints;\n  private accessToken: string | null = null;\n\n  constructor(private readonly config: IMultisetSdkConfig) {\n    this.config = config;\n    this.endpoints = {\n      ...DEFAULT_ENDPOINTS,\n      ...config.endpoints,\n    };\n  }\n\n  get token(): string | null {\n    return this.accessToken;\n  }\n\n  async authorize(): Promise<string> {\n    try {\n      const response = await axios.post(\n        this.endpoints.authUrl,\n        {},\n        {\n          auth: {\n            username: this.config.clientId,\n            password: this.config.clientSecret,\n          },\n        }\n      );\n\n      const token: string | undefined =\n        response.data?.token ?? response.data?.access_token;\n\n      if (!token) {\n        throw new Error('Authorization succeeded but no token was returned.');\n      }\n\n      this.accessToken = token;\n      this.config.onAuthorize?.(token);\n      return token;\n    } catch (error) {\n      this.handleError(error);\n      throw error;\n    }\n  }\n\n  private handleError(error: unknown): void {\n    if (axios.isAxiosError(error)) {\n      const axiosError = error as AxiosError;\n      this.config.onError?.(axiosError);\n    } else {\n      this.config.onError?.(error);\n    }\n  }\n\n  async localizeWithFrame(\n    frame: IFrameCaptureEvent,\n    intrinsics: ICameraIntrinsicsEvent\n  ): Promise<ILocalizeAndMapDetails | null> {\n    if (!this.accessToken) {\n      throw new Error('Access token is missing. Call authorize() first.');\n    }\n\n    this.config.onFrameCaptured?.(frame);\n    this.config.onCameraIntrinsics?.(intrinsics);\n\n    const queryResult = await this.queryLocalization(frame, intrinsics);\n\n    if (queryResult?.localizeData?.poseFound) {\n      this.config.onPoseResult?.(queryResult.localizeData);\n    }\n\n    return queryResult;\n  }\n\n  private async queryLocalization(\n    frame: IFrameCaptureEvent,\n    intrinsics: ICameraIntrinsicsEvent\n  ): Promise<ILocalizeAndMapDetails | null> {\n    const formData = new FormData();\n    formData.append('isRightHanded', 'true');\n    formData.append('width', `${frame.width}`);\n    formData.append('height', `${frame.height}`);\n    formData.append('px', `${intrinsics.px}`);\n    formData.append('py', `${intrinsics.py}`);\n    formData.append('fx', `${intrinsics.fx}`);\n    formData.append('fy', `${intrinsics.fy}`);\n    formData.append('queryImage', frame.blob);\n\n    if (this.config.mapType === 'map') {\n      formData.append('mapCode', this.config.code);\n    } else {\n      formData.append('mapSetCode', this.config.code);\n    }\n\n    try {\n      const response = await axios.post<ILocalizeResponse>(\n        this.endpoints.queryUrl,\n        formData,\n        {\n          headers: {\n            Authorization: `Bearer ${this.accessToken}`,\n          },\n        }\n      );\n\n      const data = response.data;\n      if (!data.poseFound) {\n        return null;\n      }\n\n      const result: ILocalizeAndMapDetails = {\n        localizeData: data,\n      };\n\n      if (data.mapIds?.length) {\n        const mapDetails = await this.fetchMapDetails(data.mapIds[0]);\n        if (mapDetails) {\n          result.mapDetails = mapDetails;\n        }\n      }\n\n      return result;\n    } catch (error) {\n      this.handleError(error);\n      return null;\n    }\n  }\n\n  private async fetchMapDetails(mapId: string): Promise<IGetMapsDetailsResponse | null> {\n    try {\n      const response = await axios.get<IGetMapsDetailsResponse>(\n        `${this.endpoints.mapDetailsUrl}${mapId}`,\n        {\n          headers: {\n            Authorization: `Bearer ${this.accessToken}`,\n          },\n        }\n      );\n      return response.data;\n    } catch (error) {\n      this.handleError(error);\n      return null;\n    }\n  }\n\n  private async fetchMapSetDetails(mapSetId: string): Promise<IMapSetMapsResponse | null> {\n    try {\n      const response = await axios.get<IMapSetMapsResponse>(\n        `${this.endpoints.mapSetDetailsUrl}${mapSetId}`,\n        {\n          headers: {\n            Authorization: `Bearer ${this.accessToken}`,\n          },\n        }\n      );\n      return response.data;\n    } catch (error) {\n      this.handleError(error);\n      return null;\n    }\n  }\n}\n\nexport type { IMultisetSdkConfig as IMultisetClientOptions };\nexport type {\n  MapType,\n  ILocalizeResponse,\n  ILocalizeAndMapDetails,\n  IGetMapsDetailsResponse,\n  IMapSetMapsResponse,\n} from './types';\n\n"]}
+{"version":3,"sources":["../../src/lib/core/config.ts","../../src/lib/core/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { ILocalizeAndMapDetails, MapType } from './types';\n\nexport interface IMultisetSdkConfig {\n  mapId?: string;\n  mapSetId?: string;\n  clientId: string;\n  clientSecret: string;\n  /** Map or map-set code used for localization. */\n  code: string;\n  /** Map or map-set type ('map' or 'map-set'). */\n  mapType: MapType;\n  endpoints?: Partial<IMultisetSdkEndpoints>;\n\n  /** If true, automatically start a localization run when the AR session starts. */\n  autoLocalize?: boolean;\n  /** If true, automatically re-localize when tracking is lost and then recovered. */\n  relocalization?: boolean;\n  /** When enabled, only accept a localization result if confidence >= confidenceThreshold. */\n  confidenceCheck?: boolean;\n  /** Minimum confidence (0.2–0.8) required when confidenceCheck is enabled. */\n  confidenceThreshold?: number;\n  /** Total single-frame attempts per localization run (1–5). */\n  requestAttempts?: number;\n  /** Time in seconds between attempts in a localization run (1–5). */\n  localizationInterval?: number;\n  /** Include device geo pose as a hint in localization requests. */\n  passGeoPose?: boolean;\n  /** Request geo coordinates in the localization response (if supported by backend). */\n  geoCoordinatesInResponse?: boolean;\n\n  /** Invoked at the start of a localization run. */\n  onLocalizationInit?: () => void;\n  /** Invoked after a successful localization that meets confidence criteria (if enabled). */\n  onLocalizationSuccess?: (result: ILocalizeAndMapDetails) => void;\n  /** Invoked when all attempts fail or the best result is below the confidence threshold. */\n  onLocalizationFailure?: (reason?: string) => void;\n\n  /** Called after a successful authorization with the access token. */\n  onAuthorize?: (token: string) => void;\n  /** Called whenever a camera frame is captured and sent for localization. */\n  onFrameCaptured?: (payload: IFrameCaptureEvent) => void;\n  /** Called with the camera intrinsics used for a localization request. */\n  onCameraIntrinsics?: (intrinsics: ICameraIntrinsicsEvent) => void;\n  /** Called with the raw pose/localization result returned by the backend. */\n  onPoseResult?: (payload: IPoseResultEvent) => void;\n  /** Called when any error occurs during authorization or localization. */\n  onError?: (error: unknown) => void;\n}\n\nexport interface IMultisetSdkEndpoints {\n  authUrl: string;\n  queryUrl: string;\n  mapDetailsUrl: string;\n  fileDownloadUrl: string;\n  mapSetDetailsUrl: string;\n}\n\nexport interface IFrameCaptureEvent {\n  blob: Blob;\n  width: number;\n  height: number;\n}\n\nexport interface ICameraIntrinsicsEvent {\n  fx: number;\n  fy: number;\n  px: number;\n  py: number;\n  width: number;\n  height: number;\n}\n\nexport interface IPoseResultEvent {\n  poseFound: boolean;\n  position: {\n    x: number;\n    y: number;\n    z: number;\n  };\n  rotation: {\n    x: number;\n    y: number;\n    z: number;\n    w: number;\n  };\n  mapIds: string[];\n  confidence?: number;\n}\n\nexport interface ILocalizeResultEvent {\n  frame: IFrameCaptureEvent;\n  intrinsics: ICameraIntrinsicsEvent;\n  response: ILocalizeAndMapDetails | null;\n}\n\nexport const DEFAULT_ENDPOINTS: IMultisetSdkEndpoints = {\n  authUrl: 'https://api.multiset.ai/v1/m2m/token',\n  queryUrl: 'https://api.multiset.ai/v1/vps/map/query-form',\n  mapDetailsUrl: 'https://api.multiset.ai/v1/vps/map/',\n  mapSetDetailsUrl: 'https://api.multiset.ai/v1/vps/map-set/',\n  fileDownloadUrl: 'https://api.multiset.ai/v1/file',\n};\n","import axios, { AxiosError } from 'axios';\nimport type {\n  IMultisetSdkConfig,\n  IMultisetSdkEndpoints,\n  IFrameCaptureEvent,\n  ICameraIntrinsicsEvent,\n} from './config';\nimport { DEFAULT_ENDPOINTS } from './config';\nimport type {\n  ILocalizeAndMapDetails,\n  ILocalizeResponse,\n  IGetMapsDetailsResponse,\n  IMapSetMapsResponse,\n} from './types';\n\nexport class MultisetClient {\n  private readonly endpoints: IMultisetSdkEndpoints;\n  private accessToken: string | null = null;\n\n  constructor(private readonly config: IMultisetSdkConfig) {\n    this.config = config;\n    this.endpoints = {\n      ...DEFAULT_ENDPOINTS,\n      ...config.endpoints,\n    };\n  }\n\n  get token(): string | null {\n    return this.accessToken;\n  }\n\n  getConfig(): IMultisetSdkConfig {\n    return this.config;\n  }\n\n  async authorize(): Promise<string> {\n    try {\n      const response = await axios.post(\n        this.endpoints.authUrl,\n        {},\n        {\n          auth: {\n            username: this.config.clientId,\n            password: this.config.clientSecret,\n          },\n        }\n      );\n\n      const token: string | undefined =\n        response.data?.token ?? response.data?.access_token;\n\n      if (!token) {\n        throw new Error('Authorization succeeded but no token was returned.');\n      }\n\n      this.accessToken = token;\n      this.config.onAuthorize?.(token);\n      return token;\n    } catch (error) {\n      this.handleError(error);\n      throw error;\n    }\n  }\n\n  private handleError(error: unknown): void {\n    if (axios.isAxiosError(error)) {\n      const axiosError = error as AxiosError;\n      this.config.onError?.(axiosError);\n    } else {\n      this.config.onError?.(error);\n    }\n  }\n\n  async localizeWithFrame(\n    frame: IFrameCaptureEvent,\n    intrinsics: ICameraIntrinsicsEvent\n  ): Promise<ILocalizeAndMapDetails | null> {\n    if (!this.accessToken) {\n      throw new Error('Access token is missing. Call authorize() first.');\n    }\n\n    this.config.onFrameCaptured?.(frame);\n    this.config.onCameraIntrinsics?.(intrinsics);\n\n    const queryResult = await this.queryLocalization(frame, intrinsics);\n\n    if (queryResult?.localizeData?.poseFound) {\n      this.config.onPoseResult?.(queryResult.localizeData);\n    }\n\n    return queryResult;\n  }\n\n  private async getGeoPoseComponents(): Promise<\n    [latitude: number, longitude: number, altitude: number] | null\n  > {\n    if (\n      typeof navigator === 'undefined' ||\n      !('geolocation' in navigator) ||\n      !navigator.geolocation\n    ) {\n      return null;\n    }\n\n    try {\n      const position = await new Promise<GeolocationPosition>((resolve, reject) => {\n        navigator.geolocation.getCurrentPosition(resolve, reject, {\n          enableHighAccuracy: true,\n          timeout: 10000,\n          maximumAge: 0,\n        });\n      });\n\n      const { latitude, longitude, altitude } = position.coords;\n      const safeAltitude =\n        typeof altitude === 'number' && !Number.isNaN(altitude) ? altitude : 0.0;\n\n      return [latitude, longitude, safeAltitude];\n    } catch {\n      return null;\n    }\n  }\n\n  private async queryLocalization(\n    frame: IFrameCaptureEvent,\n    intrinsics: ICameraIntrinsicsEvent\n  ): Promise<ILocalizeAndMapDetails | null> {\n    const formData = new FormData();\n\n    formData.append('mapId', this.config.mapId ?? '');\n    formData.append('mapSetId', this.config.mapSetId ?? '');\n    if (this.config.mapType === 'map') {\n      formData.append('mapCode', this.config.code);\n    } else {\n      formData.append('mapSetCode', this.config.code);\n    }\n    formData.append('isRightHanded', 'true');\n    formData.append('fx', `${intrinsics.fx}`);\n    formData.append('fy', `${intrinsics.fy}`);\n    formData.append('px', `${intrinsics.px}`);\n    formData.append('py', `${intrinsics.py}`);\n    formData.append('width', `${frame.width}`);\n    formData.append('height', `${frame.height}`);\n    formData.append('queryImage', frame.blob);\n    if (this.config.geoCoordinatesInResponse) {\n      formData.append('geoCoordinatesInResponse', 'true');\n    }\n    if (this.config.passGeoPose) {\n      const components = await this.getGeoPoseComponents();\n      if (components) {\n        const [latitude, longitude, altitude] = components;\n        const geoHint = `${latitude},${longitude},${altitude}`;\n        formData.append('geoHint', geoHint);\n      }\n    }\n\n    try {\n      const response = await axios.post<ILocalizeResponse>(\n        this.endpoints.queryUrl,\n        formData,\n        {\n          headers: {\n            Authorization: `Bearer ${this.accessToken}`,\n          },\n        }\n      );\n\n      const data = response.data;\n      if (!data.poseFound) {\n        return null;\n      }\n\n      const result: ILocalizeAndMapDetails = {\n        localizeData: data,\n      };\n\n      if (data.mapIds?.length) {\n        const mapDetails = await this.fetchMapDetails(data.mapIds[0]);\n        if (mapDetails) {\n          result.mapDetails = mapDetails;\n        }\n      }\n\n      return result;\n    } catch (error) {\n      this.handleError(error);\n      return null;\n    }\n  }\n\n  private async fetchMapDetails(mapId: string): Promise<IGetMapsDetailsResponse | null> {\n    try {\n      const response = await axios.get<IGetMapsDetailsResponse>(\n        `${this.endpoints.mapDetailsUrl}${mapId}`,\n        {\n          headers: {\n            Authorization: `Bearer ${this.accessToken}`,\n          },\n        }\n      );\n      return response.data;\n    } catch (error) {\n      this.handleError(error);\n      return null;\n    }\n  }\n\n  private async fetchMapSetDetails(mapSetId: string): Promise<IMapSetMapsResponse | null> {\n    try {\n      const response = await axios.get<IMapSetMapsResponse>(\n        `${this.endpoints.mapSetDetailsUrl}${mapSetId}`,\n        {\n          headers: {\n            Authorization: `Bearer ${this.accessToken}`,\n          },\n        }\n      );\n      return response.data;\n    } catch (error) {\n      this.handleError(error);\n      return null;\n    }\n  }\n}\n"]}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { DEFAULT_ENDPOINTS, ICameraIntrinsicsEvent, IFrameCaptureEvent, IGetMapsDetailsResponse, ILocalizeAndMapDetails, ILocalizeResponse, ILocalizeResultEvent, IMapSetMapsResponse, IMultisetClientOptions, IMultisetClientOptions as IMultisetSdkConfig, IMultisetSdkEndpoints, IPoseResultEvent, MapType, MultisetClient } from './core/index.js';
+export { DEFAULT_ENDPOINTS, ICameraIntrinsicsEvent, IFrameCaptureEvent, IGetMapsDetailsResponse, ILocalizeAndMapDetails, ILocalizeResponse, ILocalizeResultEvent, IMapSetMapsResponse, IMultisetSdkConfig as IMultisetClientOptions, IMultisetSdkConfig, IMultisetSdkEndpoints, IPoseResultEvent, MapType, MultisetClient } from './core/index.js';
 export { IWebxrControllerOptions, WebxrController } from './webxr/index.js';
 import 'three';