lexmount 0.2.6 → 0.5.1

package/dist/index.mjs

@@ -1,7 +1,5 @@
 // src/client.ts
-import {
-  isAxiosError
-} from "axios";
+import { isAxiosError } from "axios";
 import axios from "axios";
 import * as dotenv from "dotenv";
 
@@ -665,6 +663,18 @@ var SessionDownloadsDeleteResponse = class {
     this.deletedCount = shape.deletedCount;
   }
 };
+var SessionTargetInfo = class {
+  constructor(shape) {
+    this.id = shape.id;
+    this.title = shape.title;
+    this.type = shape.type;
+    this.url = shape.url;
+    this.description = shape.description;
+    this.inspectUrl = shape.inspectUrl;
+    this.webSocketDebuggerUrl = shape.webSocketDebuggerUrl;
+    this.webSocketDebuggerUrlTransformed = shape.webSocketDebuggerUrlTransformed;
+  }
+};
 var SessionDownloadsResource = class {
   constructor(client) {
     this.client = client;
@@ -895,6 +905,19 @@ var SessionsResource = class {
     }
     getLogger().info(`Session deleted successfully: ${options.sessionId}`);
   }
+  /**
+   * List target/page metadata for a session via `/json`.
+   */
+  async listTargets(sessionId) {
+    const response = await this.client._get(`${this.client.baseUrl}/json`, {
+      session_id: sessionId
+    });
+    if (response.status >= 400) {
+      this.handleListTargetsError(response, sessionId);
+    }
+    const result = Array.isArray(response.data) ? response.data : [];
+    return result.map((item) => this.mapSessionTarget(asRecord3(item)));
+  }
   /**
    * Fetch the debugger WebSocket URL for a session.
    *
@@ -990,6 +1013,24 @@ var SessionsResource = class {
       response: response.data
     });
   }
+  handleListTargetsError(response, sessionId) {
+    const errorData = asRecord3(response.data);
+    const errorMessage = getString3(errorData.error) ?? getString3(errorData.message) ?? "Unknown error";
+    if (response.status === 401) {
+      throw new AuthenticationError(
+        `Authentication failed: ${errorMessage}. Please check your API key and project ID.`
+      );
+    }
+    if (response.status === 404) {
+      throw new SessionNotFoundError(
+        `Session not found: ${errorMessage}. Session ID '${sessionId}' may not exist in this project.`
+      );
+    }
+    throw new APIError(`Failed to list session targets: ${errorMessage}`, {
+      statusCode: response.status,
+      response: response.data
+    });
+  }
   handleDeleteError(response, sessionId) {
     const errorData = asRecord3(response.data);
     const errorMessage = getString3(errorData.error) ?? getString3(errorData.message) ?? "Unknown error";
@@ -1023,6 +1064,18 @@ var SessionsResource = class {
       client: this.client
     });
   }
+  mapSessionTarget(raw) {
+    return new SessionTargetInfo({
+      id: getString3(raw.id) ?? "",
+      title: getString3(raw.title) ?? "",
+      type: getString3(raw.type) ?? "",
+      url: getString3(raw.url) ?? "",
+      description: getString3(raw.description) ?? "",
+      inspectUrl: getString3(raw.inspectUrl) ?? getString3(raw.inspect_url) ?? null,
+      webSocketDebuggerUrl: getString3(raw.webSocketDebuggerUrl) ?? getString3(raw.web_socket_debugger_url) ?? null,
+      webSocketDebuggerUrlTransformed: getString3(raw.webSocketDebuggerUrlTransformed) ?? getString3(raw.web_socket_debugger_url_transformed) ?? null
+    });
+  }
   async _getCreatedSession(sessionId, projectId) {
     try {
       return await this.get(sessionId, projectId);
@@ -1040,6 +1093,7 @@ var SessionsResource = class {
 dotenv.config();
 var Lexmount = class {
   constructor(config2 = {}) {
+    this.regionResolutionAttempted = false;
     this.apiKey = config2.apiKey ?? process.env.LEXMOUNT_API_KEY ?? "";
     if (!this.apiKey) {
       throw new ValidationError(
@@ -1053,6 +1107,7 @@ var Lexmount = class {
       );
     }
     this.baseUrl = (config2.baseUrl ?? process.env.LEXMOUNT_BASE_URL ?? "https://api.lexmount.cn").replace(/\/$/, "");
+    this.region = config2.region;
     if (config2.logLevel) {
       setLogLevel(config2.logLevel);
     }
@@ -1070,6 +1125,7 @@ var Lexmount = class {
    * @internal
    */
   async _post(url, data, config2 = {}) {
+    await this.ensureRegionResolved();
     return this.request("POST", url, { ...config2, data });
   }
   /**
@@ -1078,6 +1134,7 @@ var Lexmount = class {
    * @internal
    */
   async _get(url, params, config2 = {}) {
+    await this.ensureRegionResolved();
     return this.request("GET", url, { ...config2, params });
   }
   /**
@@ -1086,8 +1143,51 @@ var Lexmount = class {
    * @internal
    */
   async _delete(url, data, config2 = {}) {
+    await this.ensureRegionResolved();
     return this.request("DELETE", url, { ...config2, data });
   }
+  async regionInfo() {
+    await this.ensureRegionResolved();
+    return {
+      requestedRegion: this.region,
+      selectedRegion: this.selectedRegion,
+      baseUrl: this.baseUrl,
+      endpointBaseUrl: this.endpointBaseUrl,
+      host: this.selectedHost,
+      resolved: this.regionResolutionAttempted,
+      usingRegion: this.selectedRegion !== void 0
+    };
+  }
+  async catalogInfo() {
+    try {
+      const response = await this.httpClient.get(
+        `${this.baseUrl}/v1/regions/catalog`
+      );
+      if (response.status !== 200) {
+        return {
+          baseUrl: this.baseUrl,
+          available: false,
+          statusCode: response.status,
+          regions: []
+        };
+      }
+      const regions = Array.isArray(response.data?.regions) ? response.data.regions : [];
+      return {
+        baseUrl: this.baseUrl,
+        available: Array.isArray(response.data?.regions),
+        statusCode: response.status,
+        regions,
+        error: Array.isArray(response.data?.regions) ? void 0 : "invalid catalog regions"
+      };
+    } catch (error) {
+      return {
+        baseUrl: this.baseUrl,
+        available: false,
+        regions: [],
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
   /**
    * Close the client.
    *
@@ -1105,7 +1205,8 @@ var Lexmount = class {
   async request(method, url, config2) {
     const logger2 = getLogger();
     const startTime = Date.now();
-    logger2.debug(`${method} request to ${url}`);
+    const requestUrl = this.rewriteUrl(url);
+    logger2.debug(`${method} request to ${requestUrl}`);
     try {
       const headers = {
         api_key: this.apiKey,
@@ -1115,12 +1216,14 @@ var Lexmount = class {
       };
       const response = await this.httpClient.request({
         method,
-        url,
+        url: requestUrl,
         ...config2,
         headers
       });
       const elapsed = Date.now() - startTime;
-      logger2.debug(`${method} response: status=${response.status}, duration=${elapsed.toFixed(2)}ms`);
+      logger2.debug(
+        `${method} response: status=${response.status}, duration=${elapsed.toFixed(2)}ms`
+      );
       return response;
     } catch (error) {
       const elapsed = Date.now() - startTime;
@@ -1159,10 +1262,101 @@ var Lexmount = class {
       "Content-Type": "application/json"
     };
   }
+  async ensureRegionResolved() {
+    if (this.regionResolutionAttempted) {
+      return;
+    }
+    if (!this.regionResolutionPromise) {
+      this.regionResolutionPromise = this.resolveRegion().finally(() => {
+        this.regionResolutionAttempted = true;
+        this.regionResolutionPromise = void 0;
+      });
+    }
+    await this.regionResolutionPromise;
+  }
+  async resolveRegion() {
+    const logger2 = getLogger();
+    try {
+      const response = await this.httpClient.get(
+        `${this.baseUrl}/v1/regions/catalog`
+      );
+      if (response.status !== 200 || !Array.isArray(response.data?.regions)) {
+        logger2.debug(
+          `Region catalog unavailable, falling back to baseUrl: status=${response.status}`
+        );
+        return;
+      }
+      const selected = this.selectCatalogRegion(response.data.regions);
+      if (!selected) {
+        if (this.region) {
+          logger2.warn(`Requested region not found in catalog: ${this.region}`);
+        } else {
+          logger2.debug("No default catalog region, falling back to baseUrl");
+        }
+        return;
+      }
+      const endpointBaseUrl = await this.probeRegionHost(selected);
+      if (!endpointBaseUrl) {
+        logger2.debug("Region probe failed, falling back to baseUrl");
+        return;
+      }
+      this.selectedRegion = selected.region_id;
+      this.selectedHost = selected.host;
+      this.endpointBaseUrl = endpointBaseUrl;
+    } catch (error) {
+      logger2.debug("Region resolution failed, falling back to baseUrl:", error);
+    }
+  }
+  selectCatalogRegion(regions) {
+    if (this.region) {
+      return regions.find((region) => region.region_id === this.region);
+    }
+    const defaultRegions = regions.filter((region) => region.default === true);
+    return defaultRegions.length === 1 ? defaultRegions[0] : void 0;
+  }
+  async probeRegionHost(region) {
+    const logger2 = getLogger();
+    const host = String(region.host || "").trim();
+    if (!host) {
+      return void 0;
+    }
+    if (!this.isAllowedCatalogHost(host)) {
+      logger2.warn(`Ignoring invalid region catalog host: ${host}`);
+      return void 0;
+    }
+    const endpointBaseUrl = `https://${host}`;
+    const probePath = String(region.probe_path || "/v1/region/probe").replace(/^(?!\/)/, "/");
+    try {
+      const response = await this.httpClient.get(`${endpointBaseUrl}${probePath}`);
+      return response.status === 200 ? endpointBaseUrl : void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  isAllowedCatalogHost(host) {
+    let parsed;
+    try {
+      parsed = new URL(`https://${host}`);
+    } catch {
+      return false;
+    }
+    if (parsed.username || parsed.password || parsed.port || parsed.pathname !== "/" || parsed.search || parsed.hash) {
+      return false;
+    }
+    const hostname = parsed.hostname.toLowerCase();
+    const allowedDomains = ["lexmount.cn", "lexmount.com", "lexmount.net"];
+    return allowedDomains.some((domain) => hostname === domain || hostname.endsWith(`.${domain}`));
+  }
+  rewriteUrl(url) {
+    if (!this.endpointBaseUrl || !url.startsWith(this.baseUrl)) {
+      return url;
+    }
+    return `${this.endpointBaseUrl}${url.slice(this.baseUrl.length)}`;
+  }
 };
 
 // src/index.ts
-var VERSION = "0.2.5";
+var VERSION = "0.5.1";
 export {
   APIError,
   AuthenticationError,
@@ -1185,6 +1379,7 @@ export {
   SessionInfo,
   SessionListResponse,
   SessionNotFoundError,
+  SessionTargetInfo,
   SessionsResource,
   TimeoutError,
   VERSION,