lexmount 0.2.7 → 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";
 
@@ -1095,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(
@@ -1108,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);
     }
@@ -1125,6 +1125,7 @@ var Lexmount = class {
    * @internal
    */
   async _post(url, data, config2 = {}) {
+    await this.ensureRegionResolved();
     return this.request("POST", url, { ...config2, data });
   }
   /**
@@ -1133,6 +1134,7 @@ var Lexmount = class {
    * @internal
    */
   async _get(url, params, config2 = {}) {
+    await this.ensureRegionResolved();
     return this.request("GET", url, { ...config2, params });
   }
   /**
@@ -1141,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.
    *
@@ -1160,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,
@@ -1170,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;
@@ -1214,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,