@typedb/driver-http 3.10.0 → 3.11.1

package/dist/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// ../../../../../../../../../execroot/_main/bazel-out/k8-opt/bin/http-ts/src/params.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// ../../../../../../../../../execroot/_main/bazel-out/k8-opt/bin/http-ts/src/params.ts
 function isBasicParams(params) {
   return `addresses` in params;
 }
@@ -9,11 +9,52 @@ function remoteOrigin(params) {
   if (isBasicParams(params)) return `${params.addresses[0]}`;
   else return `${params.translatedAddresses[0].external}`;
 }
+function hostPortFromOrigin(origin) {
+  try {
+    const url = new URL(origin);
+    return url.host;
+  } catch (e) {
+    return origin;
+  }
+}
+function resolveOrigin(params, primaryAddress) {
+  if (isBasicParams(params)) {
+    for (const addr of params.addresses) {
+      if (hostPortFromOrigin(addr) === primaryAddress) return addr;
+    }
+    return deriveOriginWithScheme(params.addresses[0], primaryAddress);
+  } else {
+    for (const ta of params.translatedAddresses) {
+      if (hostPortFromOrigin(ta.internal) === primaryAddress || hostPortFromOrigin(ta.external) === primaryAddress) {
+        return ta.external;
+      }
+    }
+    return deriveOriginWithScheme(params.translatedAddresses[0].external, primaryAddress);
+  }
+}
+function deriveOriginWithScheme(referenceUrl, hostPort) {
+  try {
+    const url = new URL(referenceUrl);
+    return `${url.protocol}//${hostPort}`;
+  } catch (e2) {
+    return `https://${hostPort}`;
+  }
+}
+function allOrigins(params) {
+  if (isBasicParams(params)) return params.addresses;
+  else return params.translatedAddresses.map((ta) => ta.external);
+}
 
 // ../../../../../../../../../execroot/_main/bazel-out/k8-opt/bin/http-ts/src/response.ts
 function isApiError(err) {
   return err != null && typeof err.code === "string" && typeof err.message === "string";
 }
+function isMisdirectedError(err) {
+  return err != null && typeof err.code === "string" && typeof err.message === "string" && typeof err.primaryAddress === "string";
+}
+function driverError(code, message) {
+  return { err: { code, message }, status: 503 };
+}
 function isOkResponse(res) {
   return typeof res === "object" && "ok" in res;
 }
@@ -31,9 +72,18 @@ function getVariableName(structure, variable) {
 
 // ../../../../../../../../../execroot/_main/bazel-out/k8-opt/bin/http-ts/src/index.ts
 var HTTP_UNAUTHORIZED = 401;
+var HTTP_MISDIRECTED = 421;
+var TRANSIENT_SIGNIN_ERROR_CODES = /* @__PURE__ */ new Set(["HDR2", "SRV14"]);
+function isApiErrResp(value) {
+  return value !== null && "err" in value;
+}
+function tokenErrToResult(tokenResp) {
+  return TRANSIENT_SIGNIN_ERROR_CODES.has(tokenResp.err.code) ? null : tokenResp;
+}
 var TypeDBHttpDriver = class {
   constructor(params) {
     this.params = params;
+    this.currentOrigin = remoteOrigin(params);
   }
   getDatabases() {
     return this.apiGet(`/v1/databases`);
@@ -98,6 +148,9 @@ var TypeDBHttpDriver = class {
   version() {
     return this.apiGet(`/v1/version`);
   }
+  getServers() {
+    return this.apiGet(`/v1/servers`);
+  }
   async apiGetString(path, options) {
     return this.stringApiReq("GET", path, options);
   }
@@ -135,21 +188,98 @@ var TypeDBHttpDriver = class {
     }
   }
   async apiReq(method, path, body, options) {
-    const url = `${remoteOrigin(this.params)}${path}`;
+    const initial = await this.tryApiReq(method, path, body, options);
+    if (isApiErrResp(initial)) return initial;
+    let result = initial;
+    if (result !== null && result.status === HTTP_MISDIRECTED) {
+      const redirected = await this.followMisdirected(result, method, path, body, options);
+      if (isApiErrResp(redirected)) return redirected;
+      result = redirected;
+    }
+    if (result === null || !result.ok) {
+      const startOrigin = this.currentOrigin;
+      const fallback = await this.tryFallbackOrigins(method, path, body, options);
+      if (isApiErrResp(fallback)) return fallback;
+      if (fallback !== null && (result === null || fallback.ok)) {
+        result = fallback;
+      } else if (result !== null) {
+        this.switchOrigin(startOrigin);
+      }
+    }
+    return _nullishCoalesce(result, () => ( driverError("HDR1", "Cannot connect to any server")));
+  }
+  async tryApiReq(method, path, body, options) {
+    const url = `${this.currentOrigin}${path}`;
     let tokenResp = await this.getToken();
-    if ("err" in tokenResp) return tokenResp;
-    let bodyString = void 0;
-    if (body !== void 0) bodyString = JSON.stringify(body);
-    let headers = Object.assign({ "Authorization": `Bearer ${tokenResp.ok.token}`, "Content-Type": "application/json" }, _optionalChain([options, 'optionalAccess', _4 => _4.headers]) || {});
-    let resp = await fetch(url, { method, body: bodyString, headers });
+    if ("err" in tokenResp) return tokenErrToResult(tokenResp);
+    const bodyString = body !== void 0 ? JSON.stringify(body) : void 0;
+    let headers = this.authHeaders(tokenResp.ok.token, options);
+    let resp;
+    try {
+      resp = await fetch(url, { method, body: bodyString, headers });
+    } catch (e3) {
+      return null;
+    }
     if (resp.status === HTTP_UNAUTHORIZED) {
       tokenResp = await this.refreshToken();
-      if ("err" in tokenResp) return tokenResp;
-      headers = Object.assign({ "Authorization": `Bearer ${tokenResp.ok.token}`, "Content-Type": "application/json" }, _optionalChain([options, 'optionalAccess', _5 => _5.headers]) || {});
-      resp = await fetch(url, { method, body: bodyString, headers });
+      if ("err" in tokenResp) return tokenErrToResult(tokenResp);
+      headers = this.authHeaders(tokenResp.ok.token, options);
+      try {
+        resp = await fetch(url, { method, body: bodyString, headers });
+      } catch (e4) {
+        return null;
+      }
     }
     return resp;
   }
+  async followMisdirected(resp, method, path, body, options) {
+    if (await this.switchToRedirectTarget(resp)) {
+      return await this.tryApiReq(method, path, body, options);
+    }
+    return null;
+  }
+  async switchToRedirectTarget(resp) {
+    let json;
+    try {
+      json = await resp.json();
+    } catch (e5) {
+      return false;
+    }
+    if (!isMisdirectedError(json)) return false;
+    const newOrigin = resolveOrigin(this.params, json.primaryAddress);
+    if (newOrigin === this.currentOrigin) return false;
+    this.switchOrigin(newOrigin);
+    return true;
+  }
+  async tryFallbackOrigins(method, path, body, options) {
+    const origins = allOrigins(this.params);
+    const failedOrigin = this.currentOrigin;
+    let lastError = null;
+    for (const origin of origins) {
+      if (origin === failedOrigin) continue;
+      this.switchOrigin(origin);
+      const initial = await this.tryApiReq(method, path, body, options);
+      if (initial === null) continue;
+      if (isApiErrResp(initial)) return initial;
+      let result = initial;
+      if (result.status === HTTP_MISDIRECTED) {
+        const redirected = await this.followMisdirected(result, method, path, body, options);
+        if (redirected === null) continue;
+        if (isApiErrResp(redirected)) return redirected;
+        result = redirected;
+      }
+      if (result.ok) return result;
+      lastError = result;
+    }
+    return lastError;
+  }
+  switchOrigin(origin) {
+    this.currentOrigin = origin;
+    this.token = void 0;
+  }
+  authHeaders(token, options) {
+    return { "Authorization": `Bearer ${token}`, "Content-Type": "application/json", ..._optionalChain([options, 'optionalAccess', _4 => _4.headers]) };
+  }
   getToken() {
     if (this.token) {
       const resp = { ok: { token: this.token } };
@@ -157,16 +287,24 @@ var TypeDBHttpDriver = class {
     } else return this.refreshToken();
   }
   async refreshToken() {
-    const url = `${remoteOrigin(this.params)}/v1/signin`;
+    return this.signinOnce();
+  }
+  async signinOnce() {
+    const url = `${this.currentOrigin}/v1/signin`;
     const body = { username: this.params.username, password: this.params.password };
-    const resp = await fetch(url, { method: "POST", body: JSON.stringify(body), headers: { "Content-Type": "application/json" } });
+    let resp;
+    try {
+      resp = await fetch(url, { method: "POST", body: JSON.stringify(body), headers: { "Content-Type": "application/json" } });
+    } catch (e6) {
+      return driverError("HDR2", `Cannot connect to server at ${this.currentOrigin}`);
+    }
     const json = await this.jsonOrNull(resp);
     if (resp.ok) {
       this.token = json.token;
       return { ok: json };
-    } else if (isApiError(json)) {
-      return { err: json, status: resp.status };
-    } else throw resp;
+    }
+    if (isApiError(json)) return { err: json, status: resp.status };
+    throw resp;
   }
   async jsonOrNull(resp) {
     const contentLengthRaw = resp.headers.get("Content-Length");
@@ -193,5 +331,10 @@ var TypeDBHttpDriver = class {
 
 
 
-exports.TypeDBHttpDriver = TypeDBHttpDriver; exports.getVariableName = getVariableName; exports.isApiError = isApiError; exports.isApiErrorResponse = isApiErrorResponse; exports.isBasicParams = isBasicParams; exports.isOkResponse = isOkResponse; exports.isQueryResponseLegacy = isQueryResponseLegacy; exports.isTranslatedParams = isTranslatedParams; exports.remoteOrigin = remoteOrigin;
+
+
+
+
+
+exports.TypeDBHttpDriver = TypeDBHttpDriver; exports.allOrigins = allOrigins; exports.driverError = driverError; exports.getVariableName = getVariableName; exports.hostPortFromOrigin = hostPortFromOrigin; exports.isApiError = isApiError; exports.isApiErrorResponse = isApiErrorResponse; exports.isBasicParams = isBasicParams; exports.isMisdirectedError = isMisdirectedError; exports.isOkResponse = isOkResponse; exports.isQueryResponseLegacy = isQueryResponseLegacy; exports.isTranslatedParams = isTranslatedParams; exports.remoteOrigin = remoteOrigin; exports.resolveOrigin = resolveOrigin;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -16,6 +16,12 @@ type DriverParams = DriverParamsBasic | DriverParamsTranslated;
 declare function isBasicParams(params: DriverParams): params is DriverParamsBasic;
 declare function isTranslatedParams(params: DriverParams): params is DriverParamsTranslated;
 declare function remoteOrigin(params: DriverParams): string;
+/** Extract host:port from a URL string. "https://127.0.0.1:18000" → "127.0.0.1:18000" */
+declare function hostPortFromOrigin(origin: string): string;
+/** Resolve a bare primaryAddress (host:port) to a full URL using configured params. */
+declare function resolveOrigin(params: DriverParams, primaryAddress: string): string;
+/** Return all configured origins for connection error fallback. */
+declare function allOrigins(params: DriverParams): string[];
 
 type TypeKind = "entityType" | "relationType" | "attributeType" | "roleType";
 type ThingKind = "entity" | "relation" | "attribute";
@@ -374,6 +380,19 @@ interface DatabasesListResponse {
 interface UsersListResponse {
     users: User[];
 }
+type ReplicationRole = "primary" | "candidate" | "secondary";
+interface ReplicationStatus {
+    id: number;
+    role: ReplicationRole | null;
+    term: number | null;
+}
+interface Server {
+    address: string | null;
+    replicationStatus: ReplicationStatus | null;
+}
+interface ServersListResponse {
+    servers: Server[];
+}
 interface TransactionOpenResponse {
     transactionId: string;
 }
@@ -424,6 +443,13 @@ interface ApiErrorResponse {
     status: number;
 }
 declare function isApiError(err: any): err is ApiError;
+interface MisdirectedError {
+    code: string;
+    message: string;
+    primaryAddress: string;
+}
+declare function isMisdirectedError(err: any): err is MisdirectedError;
+declare function driverError(code: string, message: string): ApiErrorResponse;
 type ApiResponse<OK_RES = {} | null> = ApiOkResponse<OK_RES> | ApiErrorResponse;
 declare function isOkResponse<OK_RES>(res: ApiResponse<OK_RES>): res is ApiOkResponse<OK_RES>;
 declare function isApiErrorResponse(res: ApiResponse): res is ApiErrorResponse;
@@ -432,6 +458,7 @@ declare function isQueryResponseLegacy(res: ConceptRowsQueryResponse | ConceptRo
 declare class TypeDBHttpDriver {
     private params;
     private token?;
+    private currentOrigin;
     constructor(params: DriverParams);
     getDatabases(): Promise<ApiResponse<DatabasesListResponse>>;
     getDatabase(name: string): Promise<ApiResponse<Database>>;
@@ -454,6 +481,7 @@ declare class TypeDBHttpDriver {
     oneShotQuery(query: string, commit: boolean, databaseName: string, transactionType: TransactionType, transactionOptions?: TransactionOptions, queryOptions?: QueryOptions): Promise<ApiResponse<QueryResponse>>;
     health(): Promise<ApiResponse>;
     version(): Promise<ApiResponse<VersionResponse>>;
+    getServers(): Promise<ApiResponse<ServersListResponse>>;
     private apiGetString;
     private apiGet;
     private apiDelete;
@@ -463,8 +491,15 @@ declare class TypeDBHttpDriver {
     private jsonApiReq;
     private stringApiReq;
     private apiReq;
+    private tryApiReq;
+    private followMisdirected;
+    private switchToRedirectTarget;
+    private tryFallbackOrigins;
+    private switchOrigin;
+    private authHeaders;
     private getToken;
     private refreshToken;
+    private signinOnce;
     private jsonOrNull;
     private stringOrNull;
 }
@@ -488,4 +523,4 @@ interface User {
     username: string;
 }
 
-export { type AnalyzeOptions, type AnalyzeResponse, type AnalyzedConjunction, type AnalyzedFetch, type AnalyzedFunction, type AnalyzedPipeline, type Answer, type AnswerType, type ApiError, type ApiErrorResponse, type ApiOkResponse, type ApiResponse, type Attribute, type AttributeType, type Concept, type ConceptDocument, type ConceptDocumentsQueryResponse, type ConceptRow, type ConceptRowAnswer, type ConceptRowsQueryResponse, type ConceptRowsQueryResponseLegacy, type ConjunctionAnnotations, type ConstraintAny, type ConstraintComparison, type ConstraintExpression, type ConstraintExpressionLegacy, type ConstraintFunction, type ConstraintHas, type ConstraintIid, type ConstraintIs, type ConstraintIsa, type ConstraintIsaExact, type ConstraintKind, type ConstraintLabel, type ConstraintLinks, type ConstraintLinksLegacy, type ConstraintNot, type ConstraintOr, type ConstraintOwns, type ConstraintPlays, type ConstraintRelates, type ConstraintSpan, type ConstraintSub, type ConstraintSubExact, type ConstraintTry, type ConstraintValue, type ConstraintVertexAny, type ConstraintVertexLabel, type ConstraintVertexNamedRole, type ConstraintVertexValue, type ConstraintVertexVariable, type Database, type DatabasesListResponse, type Distribution, type DriverParams, type DriverParamsBasic, type DriverParamsTranslated, type EdgeKind, type Entity, type EntityType, type FetchAnnotationFieldEntry, type FunctionReturnStructure, type FunctionSingleReturnSelector, type InstantiableType, type OkQueryResponse, type PipelineStage, type QueryConjunctionLegacy, type QueryOptions, type QueryResponse, type QueryResponseBase, type QueryStructureLegacy, type QueryType, type Reducer, type Relation, type RelationType, type RoleType, type SignInResponse, type ThingKind, type TransactionOpenResponse, type TransactionOptions, type TransactionType, type TranslatedAddress, type Type, TypeDBHttpDriver, type TypeKind, type User, type UsersListResponse, type Value, type ValueKind, type ValueType, type VariableAnnotations, type VariableId, type VariableInfo, type VersionResponse, getVariableName, isApiError, isApiErrorResponse, isBasicParams, isOkResponse, isQueryResponseLegacy, isTranslatedParams, remoteOrigin };
+export { type AnalyzeOptions, type AnalyzeResponse, type AnalyzedConjunction, type AnalyzedFetch, type AnalyzedFunction, type AnalyzedPipeline, type Answer, type AnswerType, type ApiError, type ApiErrorResponse, type ApiOkResponse, type ApiResponse, type Attribute, type AttributeType, type Concept, type ConceptDocument, type ConceptDocumentsQueryResponse, type ConceptRow, type ConceptRowAnswer, type ConceptRowsQueryResponse, type ConceptRowsQueryResponseLegacy, type ConjunctionAnnotations, type ConstraintAny, type ConstraintComparison, type ConstraintExpression, type ConstraintExpressionLegacy, type ConstraintFunction, type ConstraintHas, type ConstraintIid, type ConstraintIs, type ConstraintIsa, type ConstraintIsaExact, type ConstraintKind, type ConstraintLabel, type ConstraintLinks, type ConstraintLinksLegacy, type ConstraintNot, type ConstraintOr, type ConstraintOwns, type ConstraintPlays, type ConstraintRelates, type ConstraintSpan, type ConstraintSub, type ConstraintSubExact, type ConstraintTry, type ConstraintValue, type ConstraintVertexAny, type ConstraintVertexLabel, type ConstraintVertexNamedRole, type ConstraintVertexValue, type ConstraintVertexVariable, type Database, type DatabasesListResponse, type Distribution, type DriverParams, type DriverParamsBasic, type DriverParamsTranslated, type EdgeKind, type Entity, type EntityType, type FetchAnnotationFieldEntry, type FunctionReturnStructure, type FunctionSingleReturnSelector, type InstantiableType, type MisdirectedError, type OkQueryResponse, type PipelineStage, type QueryConjunctionLegacy, type QueryOptions, type QueryResponse, type QueryResponseBase, type QueryStructureLegacy, type QueryType, type Reducer, type Relation, type RelationType, type ReplicationRole, type ReplicationStatus, type RoleType, type Server, type ServersListResponse, type SignInResponse, type ThingKind, type TransactionOpenResponse, type TransactionOptions, type TransactionType, type TranslatedAddress, type Type, TypeDBHttpDriver, type TypeKind, type User, type UsersListResponse, type Value, type ValueKind, type ValueType, type VariableAnnotations, type VariableId, type VariableInfo, type VersionResponse, allOrigins, driverError, getVariableName, hostPortFromOrigin, isApiError, isApiErrorResponse, isBasicParams, isMisdirectedError, isOkResponse, isQueryResponseLegacy, isTranslatedParams, remoteOrigin, resolveOrigin };

package/dist/index.mjs

@@ -9,11 +9,52 @@ function remoteOrigin(params) {
   if (isBasicParams(params)) return `${params.addresses[0]}`;
   else return `${params.translatedAddresses[0].external}`;
 }
+function hostPortFromOrigin(origin) {
+  try {
+    const url = new URL(origin);
+    return url.host;
+  } catch {
+    return origin;
+  }
+}
+function resolveOrigin(params, primaryAddress) {
+  if (isBasicParams(params)) {
+    for (const addr of params.addresses) {
+      if (hostPortFromOrigin(addr) === primaryAddress) return addr;
+    }
+    return deriveOriginWithScheme(params.addresses[0], primaryAddress);
+  } else {
+    for (const ta of params.translatedAddresses) {
+      if (hostPortFromOrigin(ta.internal) === primaryAddress || hostPortFromOrigin(ta.external) === primaryAddress) {
+        return ta.external;
+      }
+    }
+    return deriveOriginWithScheme(params.translatedAddresses[0].external, primaryAddress);
+  }
+}
+function deriveOriginWithScheme(referenceUrl, hostPort) {
+  try {
+    const url = new URL(referenceUrl);
+    return `${url.protocol}//${hostPort}`;
+  } catch {
+    return `https://${hostPort}`;
+  }
+}
+function allOrigins(params) {
+  if (isBasicParams(params)) return params.addresses;
+  else return params.translatedAddresses.map((ta) => ta.external);
+}
 
 // ../../../../../../../../../execroot/_main/bazel-out/k8-opt/bin/http-ts/src/response.ts
 function isApiError(err) {
   return err != null && typeof err.code === "string" && typeof err.message === "string";
 }
+function isMisdirectedError(err) {
+  return err != null && typeof err.code === "string" && typeof err.message === "string" && typeof err.primaryAddress === "string";
+}
+function driverError(code, message) {
+  return { err: { code, message }, status: 503 };
+}
 function isOkResponse(res) {
   return typeof res === "object" && "ok" in res;
 }
@@ -31,9 +72,18 @@ function getVariableName(structure, variable) {
 
 // ../../../../../../../../../execroot/_main/bazel-out/k8-opt/bin/http-ts/src/index.ts
 var HTTP_UNAUTHORIZED = 401;
+var HTTP_MISDIRECTED = 421;
+var TRANSIENT_SIGNIN_ERROR_CODES = /* @__PURE__ */ new Set(["HDR2", "SRV14"]);
+function isApiErrResp(value) {
+  return value !== null && "err" in value;
+}
+function tokenErrToResult(tokenResp) {
+  return TRANSIENT_SIGNIN_ERROR_CODES.has(tokenResp.err.code) ? null : tokenResp;
+}
 var TypeDBHttpDriver = class {
   constructor(params) {
     this.params = params;
+    this.currentOrigin = remoteOrigin(params);
   }
   getDatabases() {
     return this.apiGet(`/v1/databases`);
@@ -98,6 +148,9 @@ var TypeDBHttpDriver = class {
   version() {
     return this.apiGet(`/v1/version`);
   }
+  getServers() {
+    return this.apiGet(`/v1/servers`);
+  }
   async apiGetString(path, options) {
     return this.stringApiReq("GET", path, options);
   }
@@ -135,21 +188,98 @@ var TypeDBHttpDriver = class {
     }
   }
   async apiReq(method, path, body, options) {
-    const url = `${remoteOrigin(this.params)}${path}`;
+    const initial = await this.tryApiReq(method, path, body, options);
+    if (isApiErrResp(initial)) return initial;
+    let result = initial;
+    if (result !== null && result.status === HTTP_MISDIRECTED) {
+      const redirected = await this.followMisdirected(result, method, path, body, options);
+      if (isApiErrResp(redirected)) return redirected;
+      result = redirected;
+    }
+    if (result === null || !result.ok) {
+      const startOrigin = this.currentOrigin;
+      const fallback = await this.tryFallbackOrigins(method, path, body, options);
+      if (isApiErrResp(fallback)) return fallback;
+      if (fallback !== null && (result === null || fallback.ok)) {
+        result = fallback;
+      } else if (result !== null) {
+        this.switchOrigin(startOrigin);
+      }
+    }
+    return result ?? driverError("HDR1", "Cannot connect to any server");
+  }
+  async tryApiReq(method, path, body, options) {
+    const url = `${this.currentOrigin}${path}`;
     let tokenResp = await this.getToken();
-    if ("err" in tokenResp) return tokenResp;
-    let bodyString = void 0;
-    if (body !== void 0) bodyString = JSON.stringify(body);
-    let headers = Object.assign({ "Authorization": `Bearer ${tokenResp.ok.token}`, "Content-Type": "application/json" }, options?.headers || {});
-    let resp = await fetch(url, { method, body: bodyString, headers });
+    if ("err" in tokenResp) return tokenErrToResult(tokenResp);
+    const bodyString = body !== void 0 ? JSON.stringify(body) : void 0;
+    let headers = this.authHeaders(tokenResp.ok.token, options);
+    let resp;
+    try {
+      resp = await fetch(url, { method, body: bodyString, headers });
+    } catch {
+      return null;
+    }
     if (resp.status === HTTP_UNAUTHORIZED) {
       tokenResp = await this.refreshToken();
-      if ("err" in tokenResp) return tokenResp;
-      headers = Object.assign({ "Authorization": `Bearer ${tokenResp.ok.token}`, "Content-Type": "application/json" }, options?.headers || {});
-      resp = await fetch(url, { method, body: bodyString, headers });
+      if ("err" in tokenResp) return tokenErrToResult(tokenResp);
+      headers = this.authHeaders(tokenResp.ok.token, options);
+      try {
+        resp = await fetch(url, { method, body: bodyString, headers });
+      } catch {
+        return null;
+      }
     }
     return resp;
   }
+  async followMisdirected(resp, method, path, body, options) {
+    if (await this.switchToRedirectTarget(resp)) {
+      return await this.tryApiReq(method, path, body, options);
+    }
+    return null;
+  }
+  async switchToRedirectTarget(resp) {
+    let json;
+    try {
+      json = await resp.json();
+    } catch {
+      return false;
+    }
+    if (!isMisdirectedError(json)) return false;
+    const newOrigin = resolveOrigin(this.params, json.primaryAddress);
+    if (newOrigin === this.currentOrigin) return false;
+    this.switchOrigin(newOrigin);
+    return true;
+  }
+  async tryFallbackOrigins(method, path, body, options) {
+    const origins = allOrigins(this.params);
+    const failedOrigin = this.currentOrigin;
+    let lastError = null;
+    for (const origin of origins) {
+      if (origin === failedOrigin) continue;
+      this.switchOrigin(origin);
+      const initial = await this.tryApiReq(method, path, body, options);
+      if (initial === null) continue;
+      if (isApiErrResp(initial)) return initial;
+      let result = initial;
+      if (result.status === HTTP_MISDIRECTED) {
+        const redirected = await this.followMisdirected(result, method, path, body, options);
+        if (redirected === null) continue;
+        if (isApiErrResp(redirected)) return redirected;
+        result = redirected;
+      }
+      if (result.ok) return result;
+      lastError = result;
+    }
+    return lastError;
+  }
+  switchOrigin(origin) {
+    this.currentOrigin = origin;
+    this.token = void 0;
+  }
+  authHeaders(token, options) {
+    return { "Authorization": `Bearer ${token}`, "Content-Type": "application/json", ...options?.headers };
+  }
   getToken() {
     if (this.token) {
       const resp = { ok: { token: this.token } };
@@ -157,16 +287,24 @@ var TypeDBHttpDriver = class {
     } else return this.refreshToken();
   }
   async refreshToken() {
-    const url = `${remoteOrigin(this.params)}/v1/signin`;
+    return this.signinOnce();
+  }
+  async signinOnce() {
+    const url = `${this.currentOrigin}/v1/signin`;
     const body = { username: this.params.username, password: this.params.password };
-    const resp = await fetch(url, { method: "POST", body: JSON.stringify(body), headers: { "Content-Type": "application/json" } });
+    let resp;
+    try {
+      resp = await fetch(url, { method: "POST", body: JSON.stringify(body), headers: { "Content-Type": "application/json" } });
+    } catch {
+      return driverError("HDR2", `Cannot connect to server at ${this.currentOrigin}`);
+    }
     const json = await this.jsonOrNull(resp);
     if (resp.ok) {
       this.token = json.token;
       return { ok: json };
-    } else if (isApiError(json)) {
-      return { err: json, status: resp.status };
-    } else throw resp;
+    }
+    if (isApiError(json)) return { err: json, status: resp.status };
+    throw resp;
   }
   async jsonOrNull(resp) {
     const contentLengthRaw = resp.headers.get("Content-Length");
@@ -185,13 +323,18 @@ var TypeDBHttpDriver = class {
 };
 export {
   TypeDBHttpDriver,
+  allOrigins,
+  driverError,
   getVariableName,
+  hostPortFromOrigin,
   isApiError,
   isApiErrorResponse,
   isBasicParams,
+  isMisdirectedError,
   isOkResponse,
   isQueryResponseLegacy,
   isTranslatedParams,
-  remoteOrigin
+  remoteOrigin,
+  resolveOrigin
 };
 //# sourceMappingURL=index.mjs.map

package/package.json

@@ -1 +1 @@
-{"name": "@typedb/driver-http", "version": "3.10.0", "description": "TypeDB HTTP Driver", "author": "TypeDB Community <community@typedb.com>", "license": "Apache-2.0", "homepage": "https://typedb.com", "repository": {"type": "git", "url": "https://github.com/typedb/typedb-driver"}, "bugs": {"url": "https://github.com/typedb/typedb-driver/issues"}, "keywords": ["database", "typedb"], "main": "dist/index.cjs", "module": "dist/index.mjs", "types": "dist/index.d.ts", "type": "module", "exports": {".": {"types": "./dist/index.d.ts", "import": "./dist/index.mjs", "require": "./dist/index.cjs"}}, "scripts": {"build:dev": "tsc", "build": "tsup", "test": "cucumber-js", "docs": "typedoc"}, "packageManager": "pnpm@8.15.9", "packageConfig": {"access": "public"}, "devDependencies": {"@cucumber/cucumber": "9.0.0", "@types/node": "24.0.12", "tsup": "8.5.0", "typedoc": "^0.28.7", "typescript": "5.8.3"}}
+{"name": "@typedb/driver-http", "version": "3.11.1", "description": "TypeDB HTTP Driver", "author": "TypeDB Community <community@typedb.com>", "license": "Apache-2.0", "homepage": "https://typedb.com", "repository": {"type": "git", "url": "https://github.com/typedb/typedb-driver"}, "bugs": {"url": "https://github.com/typedb/typedb-driver/issues"}, "keywords": ["database", "typedb"], "main": "dist/index.cjs", "module": "dist/index.mjs", "types": "dist/index.d.ts", "type": "module", "exports": {".": {"types": "./dist/index.d.ts", "import": "./dist/index.mjs", "require": "./dist/index.cjs"}}, "scripts": {"build:dev": "tsc", "build": "tsup", "test": "cucumber-js", "docs": "typedoc"}, "packageManager": "pnpm@8.15.9", "packageConfig": {"access": "public"}, "devDependencies": {"@cucumber/cucumber": "9.0.0", "@types/node": "24.0.12", "tsup": "8.5.0", "typedoc": "^0.28.7", "typescript": "5.8.3"}}