@multisetai/vps 1.0.7-beta.0 → 1.0.7-beta.2

package/README.md

@@ -110,7 +110,7 @@ await controller.initialize();
 ### 4. Capture and localize
 
 ```typescript
-const result = await controller.captureFrame();
+const result = await controller.localizeFrame();
 if (result?.localizeData?.poseFound) {
   console.log('Position:', result.localizeData.position);
   console.log('Rotation:', result.localizeData.rotation);
@@ -136,11 +136,14 @@ interface IMultisetSdkConfig {
   // Core
   clientId: string;                    // Your MultiSet client ID
   clientSecret: string;                // Your MultiSet client secret
-  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)
+  /** Map or map-set code used for localization. */
+  code: string;                        // e.g., 'MAP_XXXXX'
+  /** Map or map-set type ('map' or 'map-set'). */
+  mapType: 'map' | 'map-set';
+  /** Override default API endpoints if needed. */
+  endpoints?: Partial<IMultisetSdkEndpoints>;
+  /** If true, show the VPS map mesh in the AR session (map-only). */
+  showMesh?: boolean;
 
   // Localization behavior
   /** If true, automatically start a localization run when the AR session starts. */
@@ -151,21 +154,16 @@ interface IMultisetSdkConfig {
   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;
+  /** Max time in ms to wait for a valid viewer pose before failing. Default: 10000. */
+  localizationTrackingTimeoutMs?: number;
 
   // 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
@@ -206,7 +204,7 @@ The client and controller emit events through callback functions:
 
 `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.
+- **Multiple attempts per run**: `localizeFrame` performs several internal single-frame attempts and picks the best result.
 - **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.
@@ -250,24 +248,9 @@ const arButton = await controller.initialize(buttonContainer);
 
 **Returns**: The created AR button element.
 
-##### `captureFrame(): Promise<ILocalizeAndMapDetails | null>`
-
-Captures the current camera frame and performs localization.
-
-```typescript
-const result = await controller.captureFrame();
-if (result?.localizeData?.poseFound) {
-  const { position, rotation, confidence } = result.localizeData;
-  console.log('Localized at:', position);
-}
-```
-
-**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`:
+Captures one frame from the active AR session and localizes against the configured map. Waits for a valid viewer pose up to `localizationTrackingTimeoutMs` before failing.
 
 ```typescript
 const result = await controller.localizeFrame();
@@ -279,7 +262,8 @@ if (result?.localizeData?.poseFound) {
 This method:
 
 - Fires `onLocalizationInit` at the start of the run
-- Performs multiple attempts and picks the best result by confidence
+- Waits for a valid viewer pose (up to `localizationTrackingTimeoutMs`, default 10 s)
+- Captures the camera frame and calls the localization API
 - Applies the confidence threshold when `confidenceCheck` is enabled
 - Calls `onLocalizationSuccess` or `onLocalizationFailure` accordingly
 
@@ -338,6 +322,7 @@ All TypeScript types are exported from the main entry points:
 // Core types
 import type {
   IMultisetSdkConfig,
+  IMultisetPublicConfig,
   IMultisetSdkEndpoints,
   IFrameCaptureEvent,
   ICameraIntrinsicsEvent,
@@ -378,8 +363,6 @@ const client = new MultisetClient({
   relocalization: true,
   confidenceCheck: true,
   confidenceThreshold: 0.5,
-  requestAttempts: 3,
-  localizationInterval: 2,
   passGeoPose: true,
   geoCoordinatesInResponse: true,
   onAuthorize: (token) => console.log('Authorized:', token),
@@ -408,7 +391,7 @@ cube.position.set(0, 0, -0.4);
 scene.add(cube);
 
 // Capture and localize
-const result = await controller.captureFrame();
+const result = await controller.localizeFrame();
 if (result?.localizeData?.poseFound) {
   console.log('Position:', result.localizeData.position);
 }
@@ -463,7 +446,7 @@ export default function App() {
   };
 
   const handleCapture = async () => {
-    const result = await controllerRef.current!.captureFrame();
+    const result = await controllerRef.current!.localizeFrame();
     if (result?.localizeData?.poseFound) {
       console.log('Localized!', result.localizeData.position);
     }

package/dist/core/index.d.ts

@@ -17,8 +17,11 @@ interface ILocalizeResponse {
     retrieval_scores: number[];
     num_matches: number[];
     confidence: number;
-    retrieved_imgs: string[];
+    retreived_imgs: string[];
+    retrieved_imgs?: string[];
     mapIds: string[];
+    mapCodes: string[];
+    responseTime: number;
 }
 interface IMapLocation {
     type: string;
@@ -127,9 +130,9 @@ interface ILocalizeAndMapDetails {
     mapDetails?: IGetMapsDetailsResponse;
 }
 
+/** The subset of config that is safe to expose publicly (no credentials). */
+type IMultisetPublicConfig = Omit<IMultisetSdkConfig, 'clientId' | 'clientSecret'>;
 interface IMultisetSdkConfig {
-    mapId?: string;
-    mapSetId?: string;
     clientId: string;
     clientSecret: string;
     /** Map or map-set code used for localization. */
@@ -137,6 +140,8 @@ interface IMultisetSdkConfig {
     /** Map or map-set type ('map' or 'map-set'). */
     mapType: MapType;
     endpoints?: Partial<IMultisetSdkEndpoints>;
+    /** If true, show the mesh in the AR session. Default is false. */
+    showMesh?: boolean;
     /** 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. */
@@ -153,6 +158,8 @@ interface IMultisetSdkConfig {
     passGeoPose?: boolean;
     /** Request geo coordinates in the localization response (if supported by backend). */
     geoCoordinatesInResponse?: boolean;
+    /** Max time in ms to wait for a valid viewer pose before failing. Default 10000. */
+    localizationTrackingTimeoutMs?: number;
     /** Invoked at the start of a localization run. */
     onLocalizationInit?: () => void;
     /** Invoked after a successful localization that meets confidence criteria (if enabled). */
@@ -214,12 +221,15 @@ interface ILocalizeResultEvent {
 declare const DEFAULT_ENDPOINTS: IMultisetSdkEndpoints;
 
 declare class MultisetClient {
+    private readonly credentials;
     private readonly config;
     private readonly endpoints;
     private accessToken;
-    constructor(config: IMultisetSdkConfig);
+    private mapDetailsCache;
+    constructor(input: IMultisetSdkConfig);
     get token(): string | null;
-    getConfig(): IMultisetSdkConfig;
+    getConfig(): IMultisetPublicConfig;
+    downloadFile(key: string): Promise<string>;
     authorize(): Promise<string>;
     private handleError;
     localizeWithFrame(frame: IFrameCaptureEvent, intrinsics: ICameraIntrinsicsEvent): Promise<ILocalizeAndMapDetails | null>;
@@ -229,4 +239,4 @@ declare class MultisetClient {
     private fetchMapSetDetails;
 }
 
-export { DEFAULT_ENDPOINTS, type ICameraIntrinsicsEvent, type IFrameCaptureEvent, type IGetMapsDetailsResponse, type ILocalizeAndMapDetails, type ILocalizeResponse, type ILocalizeResultEvent, type IMapSetMapsResponse, type IMultisetSdkConfig as IMultisetClientOptions, type IMultisetSdkConfig, type IMultisetSdkEndpoints, type IPoseResultEvent, type MapType, MultisetClient };
+export { DEFAULT_ENDPOINTS, type ICameraIntrinsicsEvent, type IFrameCaptureEvent, type IGetMapsDetailsResponse, type ILocalizeAndMapDetails, type ILocalizeResponse, type ILocalizeResultEvent, type IMapSetMapsResponse, type IMultisetSdkConfig as IMultisetClientOptions, type IMultisetPublicConfig, type IMultisetSdkConfig, type IMultisetSdkEndpoints, type IPoseResultEvent, type MapType, MultisetClient };

package/dist/core/index.js

@@ -9,13 +9,15 @@ var DEFAULT_ENDPOINTS = {
   fileDownloadUrl: "https://api.multiset.ai/v1/file"
 };
 var MultisetClient = class {
-  constructor(config) {
-    this.config = config;
+  constructor(input) {
     this.accessToken = null;
-    this.config = config;
+    this.mapDetailsCache = {};
+    const { clientId, clientSecret, ...rest } = input;
+    this.credentials = { clientId, clientSecret };
+    this.config = rest;
     this.endpoints = {
       ...DEFAULT_ENDPOINTS,
-      ...config.endpoints
+      ...rest.endpoints
     };
   }
   get token() {
@@ -24,6 +26,25 @@ var MultisetClient = class {
   getConfig() {
     return this.config;
   }
+  async downloadFile(key) {
+    if (!this.accessToken || !key) {
+      return "";
+    }
+    try {
+      const response = await axios.get(
+        `${this.endpoints.fileDownloadUrl}?key=${encodeURIComponent(key)}`,
+        {
+          headers: {
+            Authorization: `Bearer ${this.accessToken}`
+          }
+        }
+      );
+      return response.status === 200 ? response.data.url : "";
+    } catch (error) {
+      this.handleError(error);
+      return "";
+    }
+  }
   async authorize() {
     var _a, _b, _c, _d, _e;
     try {
@@ -32,8 +53,8 @@ var MultisetClient = class {
         {},
         {
           auth: {
-            username: this.config.clientId,
-            password: this.config.clientSecret
+            username: this.credentials.clientId,
+            password: this.credentials.clientSecret
           }
         }
       );
@@ -85,16 +106,14 @@ var MultisetClient = class {
       });
       const { latitude, longitude, altitude } = position.coords;
       const safeAltitude = typeof altitude === "number" && !Number.isNaN(altitude) ? altitude : 0;
-      return [latitude, longitude, safeAltitude];
+      return { latitude, longitude, altitude: safeAltitude };
     } catch {
       return null;
     }
   }
   async queryLocalization(frame, intrinsics) {
-    var _a, _b, _c;
+    var _a;
     const formData = new FormData();
-    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 {
@@ -114,7 +133,7 @@ var MultisetClient = class {
     if (this.config.passGeoPose) {
       const components = await this.getGeoPoseComponents();
       if (components) {
-        const [latitude, longitude, altitude] = components;
+        const { latitude, longitude, altitude } = components;
         const geoHint = `${latitude},${longitude},${altitude}`;
         formData.append("geoHint", geoHint);
       }
@@ -136,10 +155,17 @@ var MultisetClient = class {
       const result = {
         localizeData: data
       };
-      if ((_c = data.mapIds) == null ? void 0 : _c.length) {
-        const mapDetails = await this.fetchMapDetails(data.mapIds[0]);
-        if (mapDetails) {
-          result.mapDetails = mapDetails;
+      if (this.config.showMesh && this.config.mapType === "map" && ((_a = data.mapCodes) == null ? void 0 : _a.length)) {
+        const mapCode = data.mapCodes[0];
+        const cached = this.mapDetailsCache[mapCode];
+        if (cached) {
+          result.mapDetails = cached;
+        } else {
+          const mapDetails = await this.fetchMapDetails(mapCode);
+          if (mapDetails) {
+            this.mapDetailsCache[mapCode] = mapDetails;
+            result.mapDetails = mapDetails;
+          }
         }
       }
       return result;
@@ -148,10 +174,10 @@ var MultisetClient = class {
       return null;
     }
   }
-  async fetchMapDetails(mapId) {
+  async fetchMapDetails(mapCode) {
     try {
       const response = await axios.get(
-        `${this.endpoints.mapDetailsUrl}${mapId}`,
+        `${this.endpoints.mapDetailsUrl}${mapCode}`,
         {
           headers: {
             Authorization: `Bearer ${this.accessToken}`

package/dist/core/index.js.map

@@ -1 +1 @@
-{"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"]}
+{"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\n/** The subset of config that is safe to expose publicly (no credentials). */\nexport type IMultisetPublicConfig = Omit<IMultisetSdkConfig, 'clientId' | 'clientSecret'>;\n\nexport interface IMultisetSdkConfig {\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  /** If true, show the mesh in the AR session. Default is false. */\n  showMesh?: boolean;\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  /** Max time in ms to wait for a valid viewer pose before failing. Default 10000. */\n  localizationTrackingTimeoutMs?: number;\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  IMultisetPublicConfig,\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 credentials: { clientId: string; clientSecret: string };\n  private readonly config: IMultisetPublicConfig;\n  private readonly endpoints: IMultisetSdkEndpoints;\n  private accessToken: string | null = null;\n  private mapDetailsCache: Record<string, IGetMapsDetailsResponse> = {};\n\n  constructor(input: IMultisetSdkConfig) {\n    const { clientId, clientSecret, ...rest } = input;\n    this.credentials = { clientId, clientSecret };\n    this.config = rest;\n    this.endpoints = {\n      ...DEFAULT_ENDPOINTS,\n      ...rest.endpoints,\n    };\n  }\n\n  get token(): string | null {\n    return this.accessToken;\n  }\n\n  getConfig(): IMultisetPublicConfig {\n    return this.config;\n  }\n\n  async downloadFile(key: string): Promise<string> {\n    if (!this.accessToken || !key) {\n      return '';\n    }\n\n    try {\n      const response = await axios.get<{ url: string }>(\n        `${this.endpoints.fileDownloadUrl}?key=${encodeURIComponent(key)}`,\n        {\n          headers: {\n            Authorization: `Bearer ${this.accessToken}`,\n          },\n        }\n      );\n\n      return response.status === 200 ? response.data.url : '';\n    } catch (error) {\n      this.handleError(error);\n      return '';\n    }\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.credentials.clientId,\n            password: this.credentials.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, altitude: 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    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 (\n        this.config.showMesh &&\n        this.config.mapType === 'map' &&\n        data.mapCodes?.length\n      ) {\n        const mapCode = data.mapCodes[0];\n        const cached = this.mapDetailsCache[mapCode];\n        if (cached) {\n          result.mapDetails = cached;\n        } else {\n          const mapDetails = await this.fetchMapDetails(mapCode);\n          if (mapDetails) {\n            this.mapDetailsCache[mapCode] = mapDetails;\n            result.mapDetails = mapDetails;\n          }\n        }\n      }\n\n      return result;\n    } catch (error) {\n      this.handleError(error);\n      return null;\n    }\n  }\n\n  private async fetchMapDetails(mapCode: string): Promise<IGetMapsDetailsResponse | null> {\n    try {\n      const response = await axios.get<IGetMapsDetailsResponse>(\n        `${this.endpoints.mapDetailsUrl}${mapCode}`,\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, IMultisetSdkConfig as IMultisetClientOptions, IMultisetSdkConfig, IMultisetSdkEndpoints, IPoseResultEvent, MapType, MultisetClient } from './core/index.js';
+export { DEFAULT_ENDPOINTS, ICameraIntrinsicsEvent, IFrameCaptureEvent, IGetMapsDetailsResponse, ILocalizeAndMapDetails, ILocalizeResponse, ILocalizeResultEvent, IMapSetMapsResponse, IMultisetClientOptions, IMultisetPublicConfig, IMultisetClientOptions as IMultisetSdkConfig, IMultisetSdkEndpoints, IPoseResultEvent, MapType, MultisetClient } from './core/index.js';
 export { IWebxrControllerOptions, WebxrController } from './webxr/index.js';
 import 'three';