@kontext-dev/js-sdk 0.3.0 → 1.1.0

package/dist/client/index.d.cts

@@ -1,6 +1,7 @@
 import { KontextMcp } from '../mcp/index.cjs';
 import { K as KontextStorage } from '../types-RIzHnRpk.cjs';
 import { KontextError } from '../errors.cjs';
+export { translateError } from '../errors.cjs';
 import '@modelcontextprotocol/sdk/client/index.js';
 import '@modelcontextprotocol/sdk/types.js';
 
@@ -108,6 +109,7 @@ interface KontextClient {
      */
     readonly mcp: KontextMcp;
 }
+
 declare function createSingleEndpointKontextClient(config: KontextClientConfig): KontextClient;
 /**
  * Primary SDK client entrypoint.

package/dist/client/index.d.ts

@@ -1,6 +1,7 @@
 import { KontextMcp } from '../mcp/index.js';
 import { K as KontextStorage } from '../types-RIzHnRpk.js';
 import { KontextError } from '../errors.js';
+export { translateError } from '../errors.js';
 import '@modelcontextprotocol/sdk/client/index.js';
 import '@modelcontextprotocol/sdk/types.js';
 
@@ -108,6 +109,7 @@ interface KontextClient {
      */
     readonly mcp: KontextMcp;
 }
+
 declare function createSingleEndpointKontextClient(config: KontextClientConfig): KontextClient;
 /**
  * Primary SDK client entrypoint.

package/dist/client/index.js

@@ -1,6 +1,6 @@
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
-import { UrlElicitationRequiredError, ElicitRequestSchema, ElicitationCompleteNotificationSchema } from '@modelcontextprotocol/sdk/types.js';
+import { ErrorCode, UrlElicitationRequiredError, ElicitRequestSchema, ElicitationCompleteNotificationSchema } from '@modelcontextprotocol/sdk/types.js';
 import { randomBytes } from 'crypto';
 
 // src/mcp/client.ts
@@ -67,8 +67,6 @@ var StorageKeys = {
 function resourceTokenKey(resource) {
   return `${StorageKeys.RESOURCE_TOKENS}:${resource}`;
 }
-
-// src/errors.ts
 var KontextError = class extends Error {
   /** Brand field for type narrowing without instanceof */
   kontextError = true;
@@ -188,15 +186,90 @@ function isNetworkError(err) {
     if (typeof causeCode === "string" && NETWORK_ERROR_CODES.has(causeCode))
       return true;
   }
+  if (err.name === "TypeError") {
+    const msg = err.message.toLowerCase();
+    if (msg === "failed to fetch" || msg === "load failed" || msg.includes("networkerror")) {
+      return true;
+    }
+  }
   return false;
 }
 function isUnauthorizedError(err) {
   const props = errorProps(err);
   if (props.statusCode === 401 || props.status === 401) return true;
+  if (props.code === 401) return true;
   if (err.name === "UnauthorizedError") return true;
+  if (err.constructor?.name === "UnauthorizedError") return true;
   if (err.message === "Unauthorized") return true;
   return false;
 }
+var MCP_CODE_MAP = {
+  [ErrorCode.ParseError]: { code: "kontext_mcp_parse_error" },
+  [ErrorCode.InvalidRequest]: { code: "kontext_mcp_invalid_request" },
+  [ErrorCode.MethodNotFound]: { code: "kontext_mcp_method_not_found" },
+  [ErrorCode.InvalidParams]: { code: "kontext_mcp_invalid_params" },
+  [ErrorCode.InternalError]: {
+    code: "kontext_mcp_internal_error",
+    statusCode: 500
+  },
+  [ErrorCode.RequestTimeout]: {
+    code: "kontext_mcp_session_expired",
+    statusCode: 401
+  },
+  [ErrorCode.ConnectionClosed]: { code: "kontext_mcp_session_error" }
+};
+function translateError(err) {
+  if (isKontextError(err)) return err;
+  if (!(err instanceof Error)) {
+    return new KontextError(String(err), "kontext_unknown_error");
+  }
+  const props = err;
+  if (props.code === ErrorCode.UrlElicitationRequired) {
+    const elicitations = props.elicitations ?? props.data?.elicitations;
+    const elicitation = elicitations?.[0];
+    return new IntegrationConnectionRequiredError(
+      elicitation?.integrationId ?? "unknown",
+      {
+        integrationName: elicitation?.integrationName,
+        connectUrl: elicitation?.url,
+        message: elicitation?.message,
+        cause: err
+      }
+    );
+  }
+  if (typeof props.code === "number" && props.code < 0) {
+    const entry = MCP_CODE_MAP[props.code];
+    if (entry) {
+      return new KontextError(err.message, entry.code, {
+        statusCode: entry.statusCode,
+        cause: err
+      });
+    }
+    return new KontextError(err.message, "kontext_mcp_error", {
+      cause: err,
+      meta: { mcpCode: props.code }
+    });
+  }
+  const statusCode = props.statusCode ?? props.status ?? (typeof props.code === "number" && props.code >= 400 && props.code < 600 ? props.code : void 0);
+  if (typeof statusCode === "number" && statusCode >= 400) {
+    if (statusCode === 401) {
+      return new AuthorizationRequiredError(err.message, { cause: err });
+    }
+    return new KontextError(err.message, "kontext_server_error", {
+      statusCode,
+      cause: err
+    });
+  }
+  if (isUnauthorizedError(err)) {
+    return new AuthorizationRequiredError(err.message, { cause: err });
+  }
+  if (isNetworkError(err)) {
+    return new NetworkError(err.message, { cause: err });
+  }
+  return new KontextError(err.message, "kontext_unknown_error", {
+    cause: err
+  });
+}
 
 // src/oauth/provider.ts
 var KontextOAuthProvider = class {
@@ -634,7 +707,22 @@ var KontextMcp = class {
       const url = typeof item.url === "string" ? item.url : "";
       if (!id || !url) return null;
       const category = item.category === "internal_mcp_credentials" ? "internal_mcp_credentials" : "gateway_remote_mcp";
-      const connectType = item.connectType === "credentials" || item.connectType === "oauth" || item.connectType === "none" ? item.connectType : category === "internal_mcp_credentials" ? "credentials" : item.authMode === "oauth" ? "oauth" : "none";
+      const rawConnectType = item.connectType;
+      if (typeof rawConnectType !== "string") {
+        throw new KontextError(
+          "Runtime integration connectType is required in API response.",
+          "kontext_runtime_integrations_invalid_response",
+          { meta: { integrationId: id, connectType: rawConnectType } }
+        );
+      }
+      const connectType = rawConnectType === "credentials" || rawConnectType === "oauth" || rawConnectType === "user_token" || rawConnectType === "none" ? rawConnectType : null;
+      if (!connectType) {
+        throw new KontextError(
+          `Unknown runtime integration connectType "${rawConnectType}".`,
+          "kontext_runtime_integrations_invalid_response",
+          { meta: { integrationId: id, connectType: rawConnectType } }
+        );
+      }
       const rawConnection = item.connection && typeof item.connection === "object" ? item.connection : void 0;
       const connected = rawConnection && typeof rawConnection.connected === "boolean" ? rawConnection.connected : false;
       const status = rawConnection?.status === "connected" ? "connected" : "disconnected";
@@ -645,6 +733,9 @@ var KontextMcp = class {
         category,
         connectType,
         authMode: item.authMode === "oauth" || item.authMode === "user_token" || item.authMode === "server_token" || item.authMode === "none" ? item.authMode : void 0,
+        tokenLabel: typeof item.tokenLabel === "string" ? item.tokenLabel : void 0,
+        tokenHelpUrl: typeof item.tokenHelpUrl === "string" ? item.tokenHelpUrl : void 0,
+        tokenPlaceholder: typeof item.tokenPlaceholder === "string" ? item.tokenPlaceholder : void 0,
         credentialSchema: item.credentialSchema,
         requiresOauth: typeof item.requiresOauth === "boolean" ? item.requiresOauth : void 0,
         connection: rawConnection ? {
@@ -1346,35 +1437,21 @@ async function withTransientRetry(operation, maxRetries = 1) {
 function toKontextError(err, context) {
   const contextMeta = context ? { ...context } : void 0;
   const mergeMeta = (base) => contextMeta ? { ...base ?? {}, ...contextMeta } : base ?? {};
-  if (isKontextError(err)) {
-    if (!contextMeta) {
-      return err;
-    }
-    const cloned = Object.create(Object.getPrototypeOf(err));
-    Object.defineProperties(cloned, Object.getOwnPropertyDescriptors(err));
-    Object.defineProperty(cloned, "meta", {
-      value: mergeMeta(err.meta),
-      enumerable: true,
-      writable: true,
-      configurable: true
-    });
-    return cloned;
+  const translated = translateError(err);
+  if (!contextMeta) {
+    return translated;
   }
-  if (err instanceof Error) {
-    if (isUnauthorizedError(err)) {
-      return new AuthorizationRequiredError(err.message, {
-        meta: mergeMeta(),
-        cause: err
-      });
-    }
-    return new KontextError(err.message, "kontext_unknown_error", {
-      meta: mergeMeta(),
-      cause: err
-    });
-  }
-  return new KontextError(String(err), "kontext_unknown_error", {
-    meta: mergeMeta()
+  const cloned = Object.create(
+    Object.getPrototypeOf(translated)
+  );
+  Object.defineProperties(cloned, Object.getOwnPropertyDescriptors(translated));
+  Object.defineProperty(cloned, "meta", {
+    value: mergeMeta(translated.meta),
+    enumerable: true,
+    writable: true,
+    configurable: true
   });
+  return cloned;
 }
 function isAuthorizationRequired(err) {
   if (err instanceof AuthorizationRequiredError) return true;
@@ -2088,45 +2165,6 @@ function extractTextContent(result) {
   }
   return JSON.stringify(result);
 }
-function translateError(err) {
-  if (isKontextError(err)) return err;
-  if (!(err instanceof Error)) {
-    return new KontextError(String(err), "kontext_unknown_error");
-  }
-  const props = err;
-  if (props.code === -32042) {
-    const elicitations = props.elicitations ?? props.data?.elicitations;
-    const elicitation = elicitations?.[0];
-    return new IntegrationConnectionRequiredError(
-      elicitation?.integrationId ?? "unknown",
-      {
-        integrationName: elicitation?.integrationName,
-        connectUrl: elicitation?.url,
-        message: elicitation?.message,
-        cause: err
-      }
-    );
-  }
-  const statusCode = props.statusCode ?? props.status;
-  if (typeof statusCode === "number" && statusCode >= 400) {
-    if (statusCode === 401) {
-      return new AuthorizationRequiredError(err.message, { cause: err });
-    }
-    return new KontextError(err.message, "kontext_server_error", {
-      statusCode,
-      cause: err
-    });
-  }
-  if (isUnauthorizedError(err)) {
-    return new AuthorizationRequiredError(err.message, { cause: err });
-  }
-  if (isNetworkError(err)) {
-    return new NetworkError(err.message, { cause: err });
-  }
-  return new KontextError(err.message, "kontext_unknown_error", {
-    cause: err
-  });
-}
 function createSingleEndpointKontextClient(config) {
   if (!config.clientId) {
     throw new ConfigError(
@@ -2413,6 +2451,6 @@ function createKontextClient(config) {
   return createKontextOrchestrator(config);
 }
 
-export { createKontextClient, createSingleEndpointKontextClient };
+export { createKontextClient, createSingleEndpointKontextClient, translateError };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map