hornerosssp 0.3.1 → 0.4.0

package/README.md

@@ -0,0 +1,308 @@
+# HornerosSSP SDK
+
+SDK oficial para integrar HornerosSSP en tu aplicacion. Permite conectar usuarios de tu app a integraciones como Kommo CRM, Chatwoot, NotebookLM, MercadoPago, TiendaNube, Correo Argentino y ARCA.
+
+## Instalacion
+
+```bash
+npm install hornerosssp
+```
+
+## Inicio Rapido
+
+```typescript
+import { HornerosSSP } from "hornerosssp";
+
+// Inicializar cliente con tu API key
+const client = new HornerosSSP({
+  apiKey: "hsp_tu_api_key_aqui"
+});
+
+// Listar integraciones disponibles
+const mcps = await client.mcps.list();
+// [{ slug: "kommo-mcp", name: "Kommo CRM", ... }, ...]
+
+// Crear conexion para un usuario de tu app
+const conn = await client.connections.initiate({
+  mcpSlug: "kommo-mcp",
+  entityId: "user_123",  // ID del usuario en TU app
+  credentials: {
+    access_token: "token_del_usuario",
+    base_domain: "empresa.kommo.com"
+  }
+});
+
+// Ejecutar herramienta
+const result = await client.tools.execute({
+  mcpSlug: "kommo-mcp",
+  entityId: "user_123",
+  toolName: "get_leads",
+  arguments: { limit: 10 }
+});
+```
+
+## Conceptos Clave
+
+### API Key
+Tu API key (`hsp_xxx`) identifica a tu aplicacion. Obtenla desde el dashboard de HornerosSSP.
+
+### Entity ID
+El `entityId` es el identificador del usuario final en TU aplicacion. Cada usuario puede tener sus propias conexiones a diferentes integraciones.
+
+### Conexiones
+Una conexion almacena las credenciales de un usuario para una integracion especifica. Por ejemplo, si el usuario "user_123" conecta su cuenta de Kommo, las credenciales se guardan asociadas a ese entity.
+
+## API Reference
+
+### Listar MCPs Disponibles
+
+```typescript
+const mcps = await client.mcps.list();
+```
+
+Retorna todas las integraciones disponibles. No requiere configuracion previa.
+
+**Respuesta:**
+```typescript
+[
+  {
+    slug: "kommo-mcp",
+    name: "Kommo CRM",
+    description: "Gestiona leads, contactos y mensajes...",
+    requiredCredentials: ["access_token", "base_domain"],
+    toolCount: 11,
+    category: "CRM"
+  },
+  // ...
+]
+```
+
+### Obtener Detalle de un MCP
+
+```typescript
+const mcp = await client.mcps.get("kommo-mcp");
+```
+
+**Respuesta:**
+```typescript
+{
+  slug: "kommo-mcp",
+  name: "Kommo CRM",
+  description: "...",
+  requiredCredentials: ["access_token", "base_domain"],
+  tools: [
+    { name: "get_leads", description: "Obtiene lista de leads" },
+    // ...
+  ]
+}
+```
+
+### Crear Conexion
+
+```typescript
+const conn = await client.connections.initiate({
+  mcpSlug: "kommo-mcp",         // Requerido: slug del MCP
+  entityId: "user_123",          // Requerido: ID del usuario en tu app
+  credentials: {                 // Requerido: credenciales del usuario
+    access_token: "xxx",
+    base_domain: "empresa.kommo.com"
+  },
+  appName: "Mi App"              // Opcional: nombre descriptivo
+});
+```
+
+**Respuesta:**
+```typescript
+{
+  id: "conn_abc123",
+  mcpSlug: "kommo-mcp",
+  entityId: "user_123",
+  mcpUrl: "https://hornerosssp.com/api/mcp/kommo-mcp/conn_abc123",
+  token: "tok_xxxxx",  // Solo se muestra una vez
+  status: "active"
+}
+```
+
+### Listar Conexiones
+
+```typescript
+// Todas las conexiones
+const connections = await client.connections.list();
+
+// Filtrar por entity
+const userConns = await client.connections.list("user_123");
+
+// Filtrar por entity y MCP
+const specific = await client.connections.list("user_123", "kommo-mcp");
+```
+
+### Buscar Conexion por Entity
+
+```typescript
+const conn = await client.connections.getByEntity("user_123", "kommo-mcp");
+if (conn) {
+  // El usuario ya tiene conexion
+}
+```
+
+### Revocar Conexion
+
+```typescript
+await client.connections.revoke("conn_abc123");
+```
+
+### Ejecutar Herramienta
+
+Hay dos formas de identificar la conexion:
+
+**Opcion 1: Por entityId (recomendado)**
+```typescript
+const result = await client.tools.execute({
+  mcpSlug: "kommo-mcp",
+  entityId: "user_123",      // Busca la conexion automaticamente
+  toolName: "get_leads",
+  arguments: { limit: 10 }
+});
+```
+
+**Opcion 2: Por connectionId**
+```typescript
+const result = await client.tools.execute({
+  mcpSlug: "kommo-mcp",
+  connectionId: "conn_abc123",
+  toolName: "get_leads",
+  arguments: { limit: 10 }
+});
+```
+
+**Respuesta:**
+```typescript
+{
+  content: [
+    { type: "text", text: "[{\"id\": 1, \"name\": \"Lead 1\"}, ...]" }
+  ],
+  isError: false
+}
+```
+
+### Listar Herramientas de un MCP
+
+```typescript
+const tools = await client.tools.list("kommo-mcp");
+// [{ name: "get_leads", description: "...", inputSchema: {...} }, ...]
+```
+
+## Integraciones Disponibles
+
+| MCP | Descripcion | Credenciales |
+|-----|-------------|--------------|
+| `kommo-mcp` | CRM Kommo | access_token, base_domain |
+| `chatwoot-mcp` | Soporte Chatwoot | chatwoot_url, api_token, account_id |
+| `notebooklm-mcp` | Google NotebookLM | notebook_url, login_email, login_password |
+| `mercadopago-mcp` | Pagos MercadoPago | access_token |
+| `tiendanube-mcp` | E-commerce TiendaNube | access_token, store_id |
+| `correoargentino-mcp` | Envios Correo Argentino | api_key, environment |
+| `arca-mcp` | Facturacion AFIP | cuit, certificate, private_key, environment |
+
+## Ejemplo Completo
+
+```typescript
+import { HornerosSSP } from "hornerosssp";
+
+const client = new HornerosSSP({ apiKey: process.env.HORNEROS_API_KEY });
+
+async function connectUserToKommo(userId: string, kommoToken: string, domain: string) {
+  // Verificar si ya existe conexion
+  const existing = await client.connections.getByEntity(userId, "kommo-mcp");
+  if (existing) {
+    console.log("Usuario ya conectado a Kommo");
+    return existing;
+  }
+
+  // Crear nueva conexion
+  const conn = await client.connections.initiate({
+    mcpSlug: "kommo-mcp",
+    entityId: userId,
+    credentials: {
+      access_token: kommoToken,
+      base_domain: domain
+    }
+  });
+
+  console.log("Conexion creada:", conn.id);
+  return conn;
+}
+
+async function getLeadsForUser(userId: string) {
+  const result = await client.tools.execute({
+    mcpSlug: "kommo-mcp",
+    entityId: userId,
+    toolName: "get_leads",
+    arguments: { limit: 50 }
+  });
+
+  const leads = JSON.parse(result.content[0].text);
+  return leads;
+}
+
+// Uso
+await connectUserToKommo("user_123", "kommo_token", "empresa.kommo.com");
+const leads = await getLeadsForUser("user_123");
+console.log(`Found ${leads.length} leads`);
+```
+
+## Manejo de Errores
+
+```typescript
+import { HornerosError, HORNEROS_SDK_ERROR_CODES } from "hornerosssp";
+
+try {
+  await client.tools.execute({...});
+} catch (error) {
+  if (error instanceof HornerosError) {
+    switch (error.errorCode) {
+      case HORNEROS_SDK_ERROR_CODES.COMMON.CONNECTION_NOT_FOUND:
+        console.log("El usuario no tiene conexion. Crear una primero.");
+        break;
+      case HORNEROS_SDK_ERROR_CODES.COMMON.TOOL_NOT_FOUND:
+        console.log("Herramienta no existe");
+        break;
+      case HORNEROS_SDK_ERROR_CODES.COMMON.RATE_LIMITED:
+        console.log("Limite de requests alcanzado");
+        break;
+      default:
+        console.log("Error:", error.message);
+    }
+  }
+}
+```
+
+## Variables de Entorno
+
+El SDK puede leer configuracion de variables de entorno:
+
+```bash
+HORNEROS_API_KEY=hsp_xxx        # API key
+HORNEROS_BASE_URL=https://...   # URL base (opcional)
+```
+
+```typescript
+// Si las variables estan configuradas, no necesitas pasarlas
+const client = new HornerosSSP();
+```
+
+## TypeScript
+
+El SDK incluye tipos TypeScript completos:
+
+```typescript
+import type {
+  McpInfo,
+  McpDetail,
+  ConnectionInfo,
+  ToolDefinition,
+  ToolResult,
+  InitiateConnectionParams,
+  ExecuteToolParams
+} from "hornerosssp";
+```

package/dist/index.d.mts

@@ -4,7 +4,9 @@ interface McpInfo {
     description: string | null;
     requiredCredentials: string[];
     toolCount: number;
-    activeConnections: number;
+    category: string;
+    logoUrl: string;
+    color: string;
 }
 interface McpDetail extends McpInfo {
     tools: {
@@ -16,8 +18,8 @@ interface ConnectionInfo {
     id: string;
     mcpSlug: string;
     mcpName: string;
+    entityId: string | null;
     appName: string | null;
-    userId: string | null;
     mcpUrl: string;
     token: string;
     status: "active" | "revoked";
@@ -27,16 +29,35 @@ interface ConnectionInfo {
 }
 interface ConnectionRequestData {
     id: string;
+    mcpSlug: string;
+    entityId: string;
     mcpUrl: string | null;
     token: string | null;
     redirectUrl: string | null;
     status: "active" | "pending";
 }
+/**
+ * Parameters for creating a connection.
+ *
+ * - entityId: REQUIRED - The ID of the end user in YOUR app.
+ *   This is how you identify which user the connection belongs to.
+ *
+ * - mcpSlug: REQUIRED - The MCP to connect to (e.g., "kommo-mcp")
+ *
+ * - credentials: REQUIRED - The credentials for the MCP
+ *
+ * - appName: Optional - A name for this connection
+ */
 interface InitiateConnectionParams {
+    /** The MCP to connect to (e.g., "kommo-mcp") */
     mcpSlug: string;
+    /** REQUIRED: The ID of the end user in YOUR app */
+    entityId: string;
+    /** Optional: A name for this connection */
     appName?: string;
-    userId?: string;
+    /** The credentials for the MCP */
     credentials?: Record<string, string>;
+    /** Optional: Auth scheme for OAuth flows */
     authScheme?: ConnectionData;
 }
 interface ToolDefinition {
@@ -55,11 +76,26 @@ interface ToolResult {
     }>;
     isError?: boolean;
 }
+/**
+ * Parameters for executing a tool.
+ *
+ * You can identify the connection in two ways:
+ * 1. By connectionId: The ID returned when creating a connection
+ * 2. By entityId: The ID of the end user (will find the connection automatically)
+ *
+ * At least one of connectionId or entityId must be provided.
+ */
 interface ExecuteToolParams {
+    /** The MCP to use (e.g., "kommo-mcp") */
     mcpSlug: string;
-    connectionId: string;
+    /** The tool to execute */
     toolName: string;
+    /** Arguments to pass to the tool */
     arguments: Record<string, unknown>;
+    /** Option 1: The connection ID */
+    connectionId?: string;
+    /** Option 2: The entity ID (end user ID in your app) - will find connection automatically */
+    entityId?: string;
 }
 interface ConnectionData {
     type: string;
@@ -90,6 +126,8 @@ declare class Mcps {
 declare class ConnectionRequest {
     private client;
     readonly id: string;
+    readonly mcpSlug: string;
+    readonly entityId: string;
     readonly mcpUrl: string | null;
     readonly token: string | null;
     readonly redirectUrl: string | null;
@@ -106,16 +144,88 @@ declare class ConnectionRequest {
 declare class Connections {
     private client;
     constructor(client: HornerosSSP);
+    /**
+     * Create a connection for an end user (entity).
+     *
+     * @param params.mcpSlug - The MCP to connect to (e.g., "kommo-mcp")
+     * @param params.entityId - REQUIRED: The ID of the end user in YOUR app
+     * @param params.credentials - The credentials for the MCP
+     * @param params.appName - Optional name for this connection
+     *
+     * @example
+     * ```typescript
+     * const conn = await client.connections.initiate({
+     *   mcpSlug: "kommo-mcp",
+     *   entityId: "user_123",
+     *   credentials: { access_token: "...", base_domain: "..." }
+     * });
+     * ```
+     */
     initiate(params: InitiateConnectionParams): Promise<ConnectionRequest>;
-    list(): Promise<ConnectionInfo[]>;
+    /**
+     * List all connections.
+     *
+     * @param entityId - Optional: Filter by entity ID
+     * @param mcpSlug - Optional: Filter by MCP slug
+     */
+    list(entityId?: string, mcpSlug?: string): Promise<ConnectionInfo[]>;
+    /**
+     * Get a connection by ID.
+     */
     get(id: string): Promise<ConnectionInfo>;
+    /**
+     * Get a connection by entity ID and MCP slug.
+     * Returns null if not found.
+     *
+     * @example
+     * ```typescript
+     * const conn = await client.connections.getByEntity("user_123", "kommo-mcp");
+     * if (conn) {
+     *   // Connection exists, can execute tools
+     * }
+     * ```
+     */
+    getByEntity(entityId: string, mcpSlug: string): Promise<ConnectionInfo | null>;
+    /**
+     * Revoke a connection by ID.
+     */
     revoke(id: string): Promise<void>;
 }
 
 declare class Tools {
     private client;
     constructor(client: HornerosSSP);
+    /**
+     * List all tools available for an MCP.
+     */
     list(mcpSlug: string): Promise<ToolDefinition[]>;
+    /**
+     * Execute a tool on an MCP.
+     *
+     * You can identify the connection in two ways:
+     * 1. By connectionId: The ID returned when creating a connection
+     * 2. By entityId: The ID of the end user (will find the connection automatically)
+     *
+     * @example Using entityId (recommended)
+     * ```typescript
+     * const result = await client.tools.execute({
+     *   mcpSlug: "kommo-mcp",
+     *   entityId: "user_123",
+     *   toolName: "get_leads",
+     *   arguments: { limit: 10 }
+     * });
+     * ```
+     *
+     * @example Using connectionId
+     * ```typescript
+     * const result = await client.tools.execute({
+     *   mcpSlug: "kommo-mcp",
+     *   connectionId: "conn_abc123",
+     *   toolName: "get_leads",
+     *   arguments: { limit: 10 }
+     * });
+     * ```
+     */
     execute(params: ExecuteToolParams): Promise<ToolResult>;
 }
 
@@ -165,6 +275,7 @@ declare const HORNEROS_SDK_ERROR_CODES: {
         readonly BASE_URL_NOT_REACHABLE: "COMMON::BASE_URL_NOT_REACHABLE";
         readonly UNKNOWN: "COMMON::UNKNOWN";
         readonly INVALID_PARAMS: "COMMON::INVALID_PARAMS";
+        readonly VALIDATION_ERROR: "COMMON::VALIDATION_ERROR";
     };
     readonly SDK: {
         readonly NO_CONNECTED_ACCOUNT: "SDK::NO_CONNECTED_ACCOUNT";

package/dist/index.d.ts

@@ -4,7 +4,9 @@ interface McpInfo {
     description: string | null;
     requiredCredentials: string[];
     toolCount: number;
-    activeConnections: number;
+    category: string;
+    logoUrl: string;
+    color: string;
 }
 interface McpDetail extends McpInfo {
     tools: {
@@ -16,8 +18,8 @@ interface ConnectionInfo {
     id: string;
     mcpSlug: string;
     mcpName: string;
+    entityId: string | null;
     appName: string | null;
-    userId: string | null;
     mcpUrl: string;
     token: string;
     status: "active" | "revoked";
@@ -27,16 +29,35 @@ interface ConnectionInfo {
 }
 interface ConnectionRequestData {
     id: string;
+    mcpSlug: string;
+    entityId: string;
     mcpUrl: string | null;
     token: string | null;
     redirectUrl: string | null;
     status: "active" | "pending";
 }
+/**
+ * Parameters for creating a connection.
+ *
+ * - entityId: REQUIRED - The ID of the end user in YOUR app.
+ *   This is how you identify which user the connection belongs to.
+ *
+ * - mcpSlug: REQUIRED - The MCP to connect to (e.g., "kommo-mcp")
+ *
+ * - credentials: REQUIRED - The credentials for the MCP
+ *
+ * - appName: Optional - A name for this connection
+ */
 interface InitiateConnectionParams {
+    /** The MCP to connect to (e.g., "kommo-mcp") */
     mcpSlug: string;
+    /** REQUIRED: The ID of the end user in YOUR app */
+    entityId: string;
+    /** Optional: A name for this connection */
     appName?: string;
-    userId?: string;
+    /** The credentials for the MCP */
     credentials?: Record<string, string>;
+    /** Optional: Auth scheme for OAuth flows */
     authScheme?: ConnectionData;
 }
 interface ToolDefinition {
@@ -55,11 +76,26 @@ interface ToolResult {
     }>;
     isError?: boolean;
 }
+/**
+ * Parameters for executing a tool.
+ *
+ * You can identify the connection in two ways:
+ * 1. By connectionId: The ID returned when creating a connection
+ * 2. By entityId: The ID of the end user (will find the connection automatically)
+ *
+ * At least one of connectionId or entityId must be provided.
+ */
 interface ExecuteToolParams {
+    /** The MCP to use (e.g., "kommo-mcp") */
     mcpSlug: string;
-    connectionId: string;
+    /** The tool to execute */
     toolName: string;
+    /** Arguments to pass to the tool */
     arguments: Record<string, unknown>;
+    /** Option 1: The connection ID */
+    connectionId?: string;
+    /** Option 2: The entity ID (end user ID in your app) - will find connection automatically */
+    entityId?: string;
 }
 interface ConnectionData {
     type: string;
@@ -90,6 +126,8 @@ declare class Mcps {
 declare class ConnectionRequest {
     private client;
     readonly id: string;
+    readonly mcpSlug: string;
+    readonly entityId: string;
     readonly mcpUrl: string | null;
     readonly token: string | null;
     readonly redirectUrl: string | null;
@@ -106,16 +144,88 @@ declare class ConnectionRequest {
 declare class Connections {
     private client;
     constructor(client: HornerosSSP);
+    /**
+     * Create a connection for an end user (entity).
+     *
+     * @param params.mcpSlug - The MCP to connect to (e.g., "kommo-mcp")
+     * @param params.entityId - REQUIRED: The ID of the end user in YOUR app
+     * @param params.credentials - The credentials for the MCP
+     * @param params.appName - Optional name for this connection
+     *
+     * @example
+     * ```typescript
+     * const conn = await client.connections.initiate({
+     *   mcpSlug: "kommo-mcp",
+     *   entityId: "user_123",
+     *   credentials: { access_token: "...", base_domain: "..." }
+     * });
+     * ```
+     */
     initiate(params: InitiateConnectionParams): Promise<ConnectionRequest>;
-    list(): Promise<ConnectionInfo[]>;
+    /**
+     * List all connections.
+     *
+     * @param entityId - Optional: Filter by entity ID
+     * @param mcpSlug - Optional: Filter by MCP slug
+     */
+    list(entityId?: string, mcpSlug?: string): Promise<ConnectionInfo[]>;
+    /**
+     * Get a connection by ID.
+     */
     get(id: string): Promise<ConnectionInfo>;
+    /**
+     * Get a connection by entity ID and MCP slug.
+     * Returns null if not found.
+     *
+     * @example
+     * ```typescript
+     * const conn = await client.connections.getByEntity("user_123", "kommo-mcp");
+     * if (conn) {
+     *   // Connection exists, can execute tools
+     * }
+     * ```
+     */
+    getByEntity(entityId: string, mcpSlug: string): Promise<ConnectionInfo | null>;
+    /**
+     * Revoke a connection by ID.
+     */
     revoke(id: string): Promise<void>;
 }
 
 declare class Tools {
     private client;
     constructor(client: HornerosSSP);
+    /**
+     * List all tools available for an MCP.
+     */
     list(mcpSlug: string): Promise<ToolDefinition[]>;
+    /**
+     * Execute a tool on an MCP.
+     *
+     * You can identify the connection in two ways:
+     * 1. By connectionId: The ID returned when creating a connection
+     * 2. By entityId: The ID of the end user (will find the connection automatically)
+     *
+     * @example Using entityId (recommended)
+     * ```typescript
+     * const result = await client.tools.execute({
+     *   mcpSlug: "kommo-mcp",
+     *   entityId: "user_123",
+     *   toolName: "get_leads",
+     *   arguments: { limit: 10 }
+     * });
+     * ```
+     *
+     * @example Using connectionId
+     * ```typescript
+     * const result = await client.tools.execute({
+     *   mcpSlug: "kommo-mcp",
+     *   connectionId: "conn_abc123",
+     *   toolName: "get_leads",
+     *   arguments: { limit: 10 }
+     * });
+     * ```
+     */
     execute(params: ExecuteToolParams): Promise<ToolResult>;
 }
 
@@ -165,6 +275,7 @@ declare const HORNEROS_SDK_ERROR_CODES: {
         readonly BASE_URL_NOT_REACHABLE: "COMMON::BASE_URL_NOT_REACHABLE";
         readonly UNKNOWN: "COMMON::UNKNOWN";
         readonly INVALID_PARAMS: "COMMON::INVALID_PARAMS";
+        readonly VALIDATION_ERROR: "COMMON::VALIDATION_ERROR";
     };
     readonly SDK: {
         readonly NO_CONNECTED_ACCOUNT: "SDK::NO_CONNECTED_ACCOUNT";

package/dist/index.js

@@ -49,7 +49,8 @@ var HORNEROS_SDK_ERROR_CODES = {
     API_KEY_UNAVAILABLE: "COMMON::API_KEY_UNAVAILABLE",
     BASE_URL_NOT_REACHABLE: "COMMON::BASE_URL_NOT_REACHABLE",
     UNKNOWN: "COMMON::UNKNOWN",
-    INVALID_PARAMS: "COMMON::INVALID_PARAMS"
+    INVALID_PARAMS: "COMMON::INVALID_PARAMS",
+    VALIDATION_ERROR: "COMMON::VALIDATION_ERROR"
   },
   SDK: {
     NO_CONNECTED_ACCOUNT: "SDK::NO_CONNECTED_ACCOUNT",
@@ -132,6 +133,8 @@ var ConnectionRequest = class {
   constructor(client, data) {
     this.client = client;
     this.id = data.id;
+    this.mcpSlug = data.mcpSlug;
+    this.entityId = data.entityId;
     this.mcpUrl = data.mcpUrl;
     this.token = data.token;
     this.redirectUrl = data.redirectUrl;
@@ -171,12 +174,36 @@ var Connections = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Create a connection for an end user (entity).
+   *
+   * @param params.mcpSlug - The MCP to connect to (e.g., "kommo-mcp")
+   * @param params.entityId - REQUIRED: The ID of the end user in YOUR app
+   * @param params.credentials - The credentials for the MCP
+   * @param params.appName - Optional name for this connection
+   *
+   * @example
+   * ```typescript
+   * const conn = await client.connections.initiate({
+   *   mcpSlug: "kommo-mcp",
+   *   entityId: "user_123",
+   *   credentials: { access_token: "...", base_domain: "..." }
+   * });
+   * ```
+   */
   async initiate(params) {
+    if (!params.entityId) {
+      throw new HornerosError(
+        HORNEROS_SDK_ERROR_CODES.COMMON.VALIDATION_ERROR,
+        "entityId is required. This identifies the end user in your app.",
+        400
+      );
+    }
     const body = {
-      mcp_slug: params.mcpSlug
+      mcp_slug: params.mcpSlug,
+      entity_id: params.entityId
     };
     if (params.appName) body.app_name = params.appName;
-    if (params.userId) body.user_id = params.userId;
     if (params.credentials) body.credentials = params.credentials;
     if (params.authScheme) body.auth_scheme = params.authScheme;
     const res = await this.client.fetch(
@@ -185,16 +212,53 @@ var Connections = class {
     );
     return new ConnectionRequest(this.client, res.data);
   }
-  async list() {
-    const res = await this.client.fetch("/connections");
+  /**
+   * List all connections.
+   *
+   * @param entityId - Optional: Filter by entity ID
+   * @param mcpSlug - Optional: Filter by MCP slug
+   */
+  async list(entityId, mcpSlug) {
+    const params = new URLSearchParams();
+    if (entityId) params.set("entity_id", entityId);
+    if (mcpSlug) params.set("mcp_slug", mcpSlug);
+    const query = params.toString();
+    const path = query ? `/connections?${query}` : "/connections";
+    const res = await this.client.fetch(path);
     return res.data;
   }
+  /**
+   * Get a connection by ID.
+   */
   async get(id) {
     const res = await this.client.fetch(
       `/connections/${encodeURIComponent(id)}`
     );
     return res.data;
   }
+  /**
+   * Get a connection by entity ID and MCP slug.
+   * Returns null if not found.
+   *
+   * @example
+   * ```typescript
+   * const conn = await client.connections.getByEntity("user_123", "kommo-mcp");
+   * if (conn) {
+   *   // Connection exists, can execute tools
+   * }
+   * ```
+   */
+  async getByEntity(entityId, mcpSlug) {
+    try {
+      const connections = await this.list(entityId, mcpSlug);
+      return connections[0] || null;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Revoke a connection by ID.
+   */
   async revoke(id) {
     await this.client.fetch(
       `/connections/${encodeURIComponent(id)}`,
@@ -211,23 +275,65 @@ var Tools = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * List all tools available for an MCP.
+   */
   async list(mcpSlug) {
     const res = await this.client.fetch(
       `/mcps/${encodeURIComponent(mcpSlug)}/tools`
     );
     return res.data;
   }
+  /**
+   * Execute a tool on an MCP.
+   *
+   * You can identify the connection in two ways:
+   * 1. By connectionId: The ID returned when creating a connection
+   * 2. By entityId: The ID of the end user (will find the connection automatically)
+   *
+   * @example Using entityId (recommended)
+   * ```typescript
+   * const result = await client.tools.execute({
+   *   mcpSlug: "kommo-mcp",
+   *   entityId: "user_123",
+   *   toolName: "get_leads",
+   *   arguments: { limit: 10 }
+   * });
+   * ```
+   *
+   * @example Using connectionId
+   * ```typescript
+   * const result = await client.tools.execute({
+   *   mcpSlug: "kommo-mcp",
+   *   connectionId: "conn_abc123",
+   *   toolName: "get_leads",
+   *   arguments: { limit: 10 }
+   * });
+   * ```
+   */
   async execute(params) {
+    if (!params.connectionId && !params.entityId) {
+      throw new HornerosError(
+        HORNEROS_SDK_ERROR_CODES.COMMON.VALIDATION_ERROR,
+        "Either connectionId or entityId is required",
+        400
+      );
+    }
+    const body = {
+      mcp_slug: params.mcpSlug,
+      tool_name: params.toolName,
+      arguments: params.arguments
+    };
+    if (params.entityId) {
+      body.entity_id = params.entityId;
+    } else if (params.connectionId) {
+      body.connection_id = params.connectionId;
+    }
     const res = await this.client.fetch(
       "/tools/execute",
       {
         method: "POST",
-        body: JSON.stringify({
-          mcp_slug: params.mcpSlug,
-          connection_id: params.connectionId,
-          tool_name: params.toolName,
-          arguments: params.arguments
-        })
+        body: JSON.stringify(body)
       }
     );
     return res.data;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/mcps.ts","../src/connections.ts","../src/tools.ts","../src/client.ts","../src/auth-scheme.ts"],"sourcesContent":["export { HornerosSSP } from \"./client\";\nexport { AuthScheme } from \"./auth-scheme\";\nexport { Mcps } from \"./mcps\";\nexport { Connections, ConnectionRequest } from \"./connections\";\nexport { Tools } from \"./tools\";\n\n// Errors\nexport {\n  HornerosError,\n  NotFoundError,\n  ValidationError,\n  ConnectionTimeoutError,\n  HORNEROS_SDK_ERROR_CODES,\n} from \"./errors\";\n\n// Types\nexport type {\n  HornerosSSPConfig,\n  McpInfo,\n  McpDetail,\n  ConnectionInfo,\n  ConnectionRequestData,\n  InitiateConnectionParams,\n  ToolDefinition,\n  ToolResult,\n  ExecuteToolParams,\n  ConnectionData,\n  ApiResponse,\n  ApiError,\n} from \"./types\";\n","// ── Error codes ─────────────────────────────────────────────\n\nexport const HORNEROS_SDK_ERROR_CODES = {\n  BACKEND: {\n    NOT_FOUND: \"BACKEND::NOT_FOUND\",\n    RATE_LIMIT: \"BACKEND::RATE_LIMIT\",\n    BAD_REQUEST: \"BACKEND::BAD_REQUEST\",\n    UNAUTHORIZED: \"BACKEND::UNAUTHORIZED\",\n    SERVER_ERROR: \"BACKEND::SERVER_ERROR\",\n    SERVER_UNAVAILABLE: \"BACKEND::SERVER_UNAVAILABLE\",\n    UNKNOWN: \"BACKEND::UNKNOWN\",\n  },\n  COMMON: {\n    API_KEY_UNAVAILABLE: \"COMMON::API_KEY_UNAVAILABLE\",\n    BASE_URL_NOT_REACHABLE: \"COMMON::BASE_URL_NOT_REACHABLE\",\n    UNKNOWN: \"COMMON::UNKNOWN\",\n    INVALID_PARAMS: \"COMMON::INVALID_PARAMS\",\n  },\n  SDK: {\n    NO_CONNECTED_ACCOUNT: \"SDK::NO_CONNECTED_ACCOUNT\",\n    CONNECTION_TIMEOUT: \"SDK::CONNECTION_TIMEOUT\",\n    INVALID_PARAMETER: \"SDK::INVALID_PARAMETER\",\n  },\n} as const;\n\n// ── Base error ──────────────────────────────────────────────\n\nlet errorCounter = 0;\n\nexport class HornerosError extends Error {\n  public readonly errCode: string;\n  public readonly statusCode: number;\n  public readonly body: unknown;\n  public readonly description?: string;\n  public readonly possibleFix?: string;\n  public readonly errorId: string;\n  public readonly timestamp: string;\n\n  constructor(\n    errCode: string,\n    message: string,\n    statusCode: number,\n    body?: unknown,\n    description?: string,\n    possibleFix?: string\n  ) {\n    super(message);\n    this.name = \"HornerosError\";\n    this.errCode = errCode;\n    this.statusCode = statusCode;\n    this.body = body;\n    this.description = description;\n    this.possibleFix = possibleFix;\n    this.errorId = `horneros_${Date.now()}_${++errorCounter}`;\n    this.timestamp = new Date().toISOString();\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      errCode: this.errCode,\n      message: this.message,\n      statusCode: this.statusCode,\n      description: this.description,\n      possibleFix: this.possibleFix,\n      errorId: this.errorId,\n      timestamp: this.timestamp,\n      body: this.body,\n    };\n  }\n}\n\n// ── Specialized errors ──────────────────────────────────────\n\nexport class NotFoundError extends HornerosError {\n  constructor(message: string, body?: unknown) {\n    super(HORNEROS_SDK_ERROR_CODES.BACKEND.NOT_FOUND, message, 404, body);\n    this.name = \"NotFoundError\";\n  }\n}\n\nexport class ValidationError extends HornerosError {\n  constructor(message: string, body?: unknown) {\n    super(HORNEROS_SDK_ERROR_CODES.BACKEND.BAD_REQUEST, message, 400, body);\n    this.name = \"ValidationError\";\n  }\n}\n\nexport class ConnectionTimeoutError extends HornerosError {\n  constructor(message = \"Connection timed out waiting for activation\") {\n    super(\n      HORNEROS_SDK_ERROR_CODES.SDK.CONNECTION_TIMEOUT,\n      message,\n      408,\n      undefined,\n      \"The connection did not become active within the timeout period.\",\n      \"Increase the timeout value or check that the user completed the authentication flow.\"\n    );\n    this.name = \"ConnectionTimeoutError\";\n  }\n}\n","import type { HornerosSSP } from \"./client\";\nimport type { McpInfo, McpDetail, ApiResponse } from \"./types\";\n\nexport class Mcps {\n  constructor(private client: HornerosSSP) {}\n\n  async list(): Promise<McpInfo[]> {\n    const res = await this.client.fetch<ApiResponse<McpInfo[]>>(\"/mcps\");\n    return res.data;\n  }\n\n  async get(slug: string): Promise<McpDetail> {\n    const res = await this.client.fetch<ApiResponse<McpDetail>>(\n      `/mcps/${encodeURIComponent(slug)}`\n    );\n    return res.data;\n  }\n}\n","import type { HornerosSSP } from \"./client\";\nimport type {\n  ConnectionInfo,\n  ConnectionRequestData,\n  InitiateConnectionParams,\n  ApiResponse,\n} from \"./types\";\nimport { ConnectionTimeoutError } from \"./errors\";\n\nexport class ConnectionRequest {\n  public readonly id: string;\n  public readonly mcpUrl: string | null;\n  public readonly token: string | null;\n  public readonly redirectUrl: string | null;\n  public readonly status: \"active\" | \"pending\";\n\n  constructor(\n    private client: HornerosSSP,\n    data: ConnectionRequestData\n  ) {\n    this.id = data.id;\n    this.mcpUrl = data.mcpUrl;\n    this.token = data.token;\n    this.redirectUrl = data.redirectUrl;\n    this.status = data.status;\n  }\n\n  /**\n   * Polls the connection until it becomes active.\n   * Useful for OAuth/interactive flows where the user needs to\n   * complete authentication in a browser.\n   * @param timeout Max wait time in ms (default: 120000 = 2 min)\n   */\n  async waitForConnection(timeout = 120_000): Promise<ConnectionInfo> {\n    if (this.status === \"active\") {\n      const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n        `/connections/${encodeURIComponent(this.id)}`\n      );\n      return res.data;\n    }\n\n    const start = Date.now();\n    const interval = 2000;\n\n    while (Date.now() - start < timeout) {\n      await sleep(interval);\n      try {\n        const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n          `/connections/${encodeURIComponent(this.id)}`\n        );\n        if (res.data.status === \"active\") {\n          return res.data;\n        }\n      } catch {\n        // Connection not yet created, keep polling\n      }\n    }\n\n    throw new ConnectionTimeoutError();\n  }\n}\n\nexport class Connections {\n  constructor(private client: HornerosSSP) {}\n\n  async initiate(params: InitiateConnectionParams): Promise<ConnectionRequest> {\n    const body: Record<string, unknown> = {\n      mcp_slug: params.mcpSlug,\n    };\n\n    if (params.appName) body.app_name = params.appName;\n    if (params.userId) body.user_id = params.userId;\n    if (params.credentials) body.credentials = params.credentials;\n    if (params.authScheme) body.auth_scheme = params.authScheme;\n\n    const res = await this.client.fetch<ApiResponse<ConnectionRequestData>>(\n      \"/connections\",\n      { method: \"POST\", body: JSON.stringify(body) }\n    );\n\n    return new ConnectionRequest(this.client, res.data);\n  }\n\n  async list(): Promise<ConnectionInfo[]> {\n    const res =\n      await this.client.fetch<ApiResponse<ConnectionInfo[]>>(\"/connections\");\n    return res.data;\n  }\n\n  async get(id: string): Promise<ConnectionInfo> {\n    const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n      `/connections/${encodeURIComponent(id)}`\n    );\n    return res.data;\n  }\n\n  async revoke(id: string): Promise<void> {\n    await this.client.fetch<void>(\n      `/connections/${encodeURIComponent(id)}`,\n      { method: \"DELETE\" }\n    );\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import type { HornerosSSP } from \"./client\";\nimport type {\n  ToolDefinition,\n  ToolResult,\n  ExecuteToolParams,\n  ApiResponse,\n} from \"./types\";\n\nexport class Tools {\n  constructor(private client: HornerosSSP) {}\n\n  async list(mcpSlug: string): Promise<ToolDefinition[]> {\n    const res = await this.client.fetch<ApiResponse<ToolDefinition[]>>(\n      `/mcps/${encodeURIComponent(mcpSlug)}/tools`\n    );\n    return res.data;\n  }\n\n  async execute(params: ExecuteToolParams): Promise<ToolResult> {\n    const res = await this.client.fetch<ApiResponse<ToolResult>>(\n      \"/tools/execute\",\n      {\n        method: \"POST\",\n        body: JSON.stringify({\n          mcp_slug: params.mcpSlug,\n          connection_id: params.connectionId,\n          tool_name: params.toolName,\n          arguments: params.arguments,\n        }),\n      }\n    );\n    return res.data;\n  }\n}\n","import type { HornerosSSPConfig } from \"./types\";\nimport { HornerosError, HORNEROS_SDK_ERROR_CODES } from \"./errors\";\nimport { Mcps } from \"./mcps\";\nimport { Connections } from \"./connections\";\nimport { Tools } from \"./tools\";\n\n// ── Helpers ─────────────────────────────────────────────────\n\nfunction getEnvVariable(name: string): string | undefined {\n  if (typeof process !== \"undefined\" && process.env) {\n    return process.env[name];\n  }\n  return undefined;\n}\n\nconst DEFAULT_BASE_URL = \"http://localhost:3000\";\n\nfunction resolveConfig(config?: HornerosSSPConfig) {\n  const baseUrl =\n    config?.baseUrl ||\n    getEnvVariable(\"HORNEROS_BASE_URL\") ||\n    DEFAULT_BASE_URL;\n\n  const apiKey =\n    config?.apiKey ||\n    getEnvVariable(\"HORNEROS_API_KEY\") ||\n    \"\";\n\n  const runtime = config?.runtime || getEnvVariable(\"HORNEROS_RUNTIME\") || \"\";\n\n  return { baseUrl: baseUrl.replace(/\\/+$/, \"\"), apiKey, runtime };\n}\n\n// ── Main client ─────────────────────────────────────────────\n\nexport class HornerosSSP {\n  public readonly mcps: Mcps;\n  public readonly connections: Connections;\n  public readonly tools: Tools;\n\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly runtime: string;\n\n  constructor(config?: HornerosSSPConfig) {\n    const resolved = resolveConfig(config);\n\n    if (!resolved.apiKey) {\n      throw new HornerosError(\n        HORNEROS_SDK_ERROR_CODES.COMMON.API_KEY_UNAVAILABLE,\n        \"🔑 API Key is not provided\",\n        401,\n        undefined,\n        \"You need to provide an API key in the constructor or as the environment variable HORNEROS_API_KEY.\",\n        'Provide a valid API key: new HornerosSSP({ apiKey: \"hsp_xxx\" }) or set HORNEROS_API_KEY in your environment.'\n      );\n    }\n\n    this.baseUrl = resolved.baseUrl;\n    this.apiKey = resolved.apiKey;\n    this.runtime = resolved.runtime;\n\n    this.mcps = new Mcps(this);\n    this.connections = new Connections(this);\n    this.tools = new Tools(this);\n  }\n\n  /** @internal */\n  async fetch<T>(\n    path: string,\n    options: RequestInit = {}\n  ): Promise<T> {\n    const url = `${this.baseUrl}/api/v1${path}`;\n\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      \"X-Api-Key\": this.apiKey,\n      \"X-Source\": \"js_sdk\",\n      \"X-Runtime\": this.runtime,\n      ...(options.headers as Record<string, string>),\n    };\n\n    const res = await globalThis.fetch(url, {\n      ...options,\n      headers,\n    });\n\n    if (!res.ok) {\n      let body: unknown;\n      try {\n        body = await res.json();\n      } catch {\n        body = await res.text().catch(() => null);\n      }\n\n      const message =\n        (body && typeof body === \"object\" && \"error\" in body\n          ? (body as { error: string }).error\n          : null) || `HTTP ${res.status}`;\n\n      const errCode =\n        res.status === 404\n          ? HORNEROS_SDK_ERROR_CODES.BACKEND.NOT_FOUND\n          : res.status === 401\n            ? HORNEROS_SDK_ERROR_CODES.BACKEND.UNAUTHORIZED\n            : res.status === 429\n              ? HORNEROS_SDK_ERROR_CODES.BACKEND.RATE_LIMIT\n              : res.status === 400\n                ? HORNEROS_SDK_ERROR_CODES.BACKEND.BAD_REQUEST\n                : res.status >= 500\n                  ? HORNEROS_SDK_ERROR_CODES.BACKEND.SERVER_ERROR\n                  : HORNEROS_SDK_ERROR_CODES.BACKEND.UNKNOWN;\n\n      throw new HornerosError(errCode, message, res.status, body);\n    }\n\n    if (res.status === 204) {\n      return undefined as T;\n    }\n\n    return res.json() as Promise<T>;\n  }\n}\n","import type { ConnectionData } from \"./types\";\n\nexport class AuthScheme {\n  static APIKey(params: { api_key: string; [k: string]: string }): ConnectionData {\n    return { type: \"api_key\", data: params };\n  }\n\n  static Bearer(params: { token: string }): ConnectionData {\n    return { type: \"bearer\", data: params };\n  }\n\n  static Basic(params: { username: string; password: string }): ConnectionData {\n    return { type: \"basic\", data: params };\n  }\n\n  static OAuth2(params: {\n    access_token: string;\n    refresh_token?: string;\n  }): ConnectionData {\n    return {\n      type: \"oauth2\",\n      data: params as Record<string, string>,\n    };\n  }\n\n  static GoogleLogin(): ConnectionData {\n    return { type: \"google_login\", data: {} };\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/mcps.ts","../src/connections.ts","../src/tools.ts","../src/client.ts","../src/auth-scheme.ts"],"sourcesContent":["export { HornerosSSP } from \"./client\";\nexport { AuthScheme } from \"./auth-scheme\";\nexport { Mcps } from \"./mcps\";\nexport { Connections, ConnectionRequest } from \"./connections\";\nexport { Tools } from \"./tools\";\n\n// Errors\nexport {\n  HornerosError,\n  NotFoundError,\n  ValidationError,\n  ConnectionTimeoutError,\n  HORNEROS_SDK_ERROR_CODES,\n} from \"./errors\";\n\n// Types\nexport type {\n  HornerosSSPConfig,\n  McpInfo,\n  McpDetail,\n  ConnectionInfo,\n  ConnectionRequestData,\n  InitiateConnectionParams,\n  ToolDefinition,\n  ToolResult,\n  ExecuteToolParams,\n  ConnectionData,\n  ApiResponse,\n  ApiError,\n} from \"./types\";\n","// ── Error codes ─────────────────────────────────────────────\n\nexport const HORNEROS_SDK_ERROR_CODES = {\n  BACKEND: {\n    NOT_FOUND: \"BACKEND::NOT_FOUND\",\n    RATE_LIMIT: \"BACKEND::RATE_LIMIT\",\n    BAD_REQUEST: \"BACKEND::BAD_REQUEST\",\n    UNAUTHORIZED: \"BACKEND::UNAUTHORIZED\",\n    SERVER_ERROR: \"BACKEND::SERVER_ERROR\",\n    SERVER_UNAVAILABLE: \"BACKEND::SERVER_UNAVAILABLE\",\n    UNKNOWN: \"BACKEND::UNKNOWN\",\n  },\n  COMMON: {\n    API_KEY_UNAVAILABLE: \"COMMON::API_KEY_UNAVAILABLE\",\n    BASE_URL_NOT_REACHABLE: \"COMMON::BASE_URL_NOT_REACHABLE\",\n    UNKNOWN: \"COMMON::UNKNOWN\",\n    INVALID_PARAMS: \"COMMON::INVALID_PARAMS\",\n    VALIDATION_ERROR: \"COMMON::VALIDATION_ERROR\",\n  },\n  SDK: {\n    NO_CONNECTED_ACCOUNT: \"SDK::NO_CONNECTED_ACCOUNT\",\n    CONNECTION_TIMEOUT: \"SDK::CONNECTION_TIMEOUT\",\n    INVALID_PARAMETER: \"SDK::INVALID_PARAMETER\",\n  },\n} as const;\n\n// ── Base error ──────────────────────────────────────────────\n\nlet errorCounter = 0;\n\nexport class HornerosError extends Error {\n  public readonly errCode: string;\n  public readonly statusCode: number;\n  public readonly body: unknown;\n  public readonly description?: string;\n  public readonly possibleFix?: string;\n  public readonly errorId: string;\n  public readonly timestamp: string;\n\n  constructor(\n    errCode: string,\n    message: string,\n    statusCode: number,\n    body?: unknown,\n    description?: string,\n    possibleFix?: string\n  ) {\n    super(message);\n    this.name = \"HornerosError\";\n    this.errCode = errCode;\n    this.statusCode = statusCode;\n    this.body = body;\n    this.description = description;\n    this.possibleFix = possibleFix;\n    this.errorId = `horneros_${Date.now()}_${++errorCounter}`;\n    this.timestamp = new Date().toISOString();\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      errCode: this.errCode,\n      message: this.message,\n      statusCode: this.statusCode,\n      description: this.description,\n      possibleFix: this.possibleFix,\n      errorId: this.errorId,\n      timestamp: this.timestamp,\n      body: this.body,\n    };\n  }\n}\n\n// ── Specialized errors ──────────────────────────────────────\n\nexport class NotFoundError extends HornerosError {\n  constructor(message: string, body?: unknown) {\n    super(HORNEROS_SDK_ERROR_CODES.BACKEND.NOT_FOUND, message, 404, body);\n    this.name = \"NotFoundError\";\n  }\n}\n\nexport class ValidationError extends HornerosError {\n  constructor(message: string, body?: unknown) {\n    super(HORNEROS_SDK_ERROR_CODES.BACKEND.BAD_REQUEST, message, 400, body);\n    this.name = \"ValidationError\";\n  }\n}\n\nexport class ConnectionTimeoutError extends HornerosError {\n  constructor(message = \"Connection timed out waiting for activation\") {\n    super(\n      HORNEROS_SDK_ERROR_CODES.SDK.CONNECTION_TIMEOUT,\n      message,\n      408,\n      undefined,\n      \"The connection did not become active within the timeout period.\",\n      \"Increase the timeout value or check that the user completed the authentication flow.\"\n    );\n    this.name = \"ConnectionTimeoutError\";\n  }\n}\n","import type { HornerosSSP } from \"./client\";\nimport type { McpInfo, McpDetail, ApiResponse } from \"./types\";\n\nexport class Mcps {\n  constructor(private client: HornerosSSP) {}\n\n  async list(): Promise<McpInfo[]> {\n    const res = await this.client.fetch<ApiResponse<McpInfo[]>>(\"/mcps\");\n    return res.data;\n  }\n\n  async get(slug: string): Promise<McpDetail> {\n    const res = await this.client.fetch<ApiResponse<McpDetail>>(\n      `/mcps/${encodeURIComponent(slug)}`\n    );\n    return res.data;\n  }\n}\n","import type { HornerosSSP } from \"./client\";\nimport type {\n  ConnectionInfo,\n  ConnectionRequestData,\n  InitiateConnectionParams,\n  ApiResponse,\n} from \"./types\";\nimport { ConnectionTimeoutError, HornerosError, HORNEROS_SDK_ERROR_CODES } from \"./errors\";\n\nexport class ConnectionRequest {\n  public readonly id: string;\n  public readonly mcpSlug: string;\n  public readonly entityId: string;\n  public readonly mcpUrl: string | null;\n  public readonly token: string | null;\n  public readonly redirectUrl: string | null;\n  public readonly status: \"active\" | \"pending\";\n\n  constructor(\n    private client: HornerosSSP,\n    data: ConnectionRequestData\n  ) {\n    this.id = data.id;\n    this.mcpSlug = data.mcpSlug;\n    this.entityId = data.entityId;\n    this.mcpUrl = data.mcpUrl;\n    this.token = data.token;\n    this.redirectUrl = data.redirectUrl;\n    this.status = data.status;\n  }\n\n  /**\n   * Polls the connection until it becomes active.\n   * Useful for OAuth/interactive flows where the user needs to\n   * complete authentication in a browser.\n   * @param timeout Max wait time in ms (default: 120000 = 2 min)\n   */\n  async waitForConnection(timeout = 120_000): Promise<ConnectionInfo> {\n    if (this.status === \"active\") {\n      const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n        `/connections/${encodeURIComponent(this.id)}`\n      );\n      return res.data;\n    }\n\n    const start = Date.now();\n    const interval = 2000;\n\n    while (Date.now() - start < timeout) {\n      await sleep(interval);\n      try {\n        const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n          `/connections/${encodeURIComponent(this.id)}`\n        );\n        if (res.data.status === \"active\") {\n          return res.data;\n        }\n      } catch {\n        // Connection not yet created, keep polling\n      }\n    }\n\n    throw new ConnectionTimeoutError();\n  }\n}\n\nexport class Connections {\n  constructor(private client: HornerosSSP) {}\n\n  /**\n   * Create a connection for an end user (entity).\n   *\n   * @param params.mcpSlug - The MCP to connect to (e.g., \"kommo-mcp\")\n   * @param params.entityId - REQUIRED: The ID of the end user in YOUR app\n   * @param params.credentials - The credentials for the MCP\n   * @param params.appName - Optional name for this connection\n   *\n   * @example\n   * ```typescript\n   * const conn = await client.connections.initiate({\n   *   mcpSlug: \"kommo-mcp\",\n   *   entityId: \"user_123\",\n   *   credentials: { access_token: \"...\", base_domain: \"...\" }\n   * });\n   * ```\n   */\n  async initiate(params: InitiateConnectionParams): Promise<ConnectionRequest> {\n    // Validate entityId is provided\n    if (!params.entityId) {\n      throw new HornerosError(\n        HORNEROS_SDK_ERROR_CODES.COMMON.VALIDATION_ERROR,\n        \"entityId is required. This identifies the end user in your app.\",\n        400\n      );\n    }\n\n    const body: Record<string, unknown> = {\n      mcp_slug: params.mcpSlug,\n      entity_id: params.entityId,\n    };\n\n    if (params.appName) body.app_name = params.appName;\n    if (params.credentials) body.credentials = params.credentials;\n    if (params.authScheme) body.auth_scheme = params.authScheme;\n\n    const res = await this.client.fetch<ApiResponse<ConnectionRequestData>>(\n      \"/connections\",\n      { method: \"POST\", body: JSON.stringify(body) }\n    );\n\n    return new ConnectionRequest(this.client, res.data);\n  }\n\n  /**\n   * List all connections.\n   *\n   * @param entityId - Optional: Filter by entity ID\n   * @param mcpSlug - Optional: Filter by MCP slug\n   */\n  async list(entityId?: string, mcpSlug?: string): Promise<ConnectionInfo[]> {\n    const params = new URLSearchParams();\n    if (entityId) params.set(\"entity_id\", entityId);\n    if (mcpSlug) params.set(\"mcp_slug\", mcpSlug);\n\n    const query = params.toString();\n    const path = query ? `/connections?${query}` : \"/connections\";\n\n    const res = await this.client.fetch<ApiResponse<ConnectionInfo[]>>(path);\n    return res.data;\n  }\n\n  /**\n   * Get a connection by ID.\n   */\n  async get(id: string): Promise<ConnectionInfo> {\n    const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n      `/connections/${encodeURIComponent(id)}`\n    );\n    return res.data;\n  }\n\n  /**\n   * Get a connection by entity ID and MCP slug.\n   * Returns null if not found.\n   *\n   * @example\n   * ```typescript\n   * const conn = await client.connections.getByEntity(\"user_123\", \"kommo-mcp\");\n   * if (conn) {\n   *   // Connection exists, can execute tools\n   * }\n   * ```\n   */\n  async getByEntity(entityId: string, mcpSlug: string): Promise<ConnectionInfo | null> {\n    try {\n      const connections = await this.list(entityId, mcpSlug);\n      return connections[0] || null;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Revoke a connection by ID.\n   */\n  async revoke(id: string): Promise<void> {\n    await this.client.fetch<void>(\n      `/connections/${encodeURIComponent(id)}`,\n      { method: \"DELETE\" }\n    );\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import type { HornerosSSP } from \"./client\";\nimport type {\n  ToolDefinition,\n  ToolResult,\n  ExecuteToolParams,\n  ApiResponse,\n} from \"./types\";\nimport { HornerosError, HORNEROS_SDK_ERROR_CODES } from \"./errors\";\n\nexport class Tools {\n  constructor(private client: HornerosSSP) {}\n\n  /**\n   * List all tools available for an MCP.\n   */\n  async list(mcpSlug: string): Promise<ToolDefinition[]> {\n    const res = await this.client.fetch<ApiResponse<ToolDefinition[]>>(\n      `/mcps/${encodeURIComponent(mcpSlug)}/tools`\n    );\n    return res.data;\n  }\n\n  /**\n   * Execute a tool on an MCP.\n   *\n   * You can identify the connection in two ways:\n   * 1. By connectionId: The ID returned when creating a connection\n   * 2. By entityId: The ID of the end user (will find the connection automatically)\n   *\n   * @example Using entityId (recommended)\n   * ```typescript\n   * const result = await client.tools.execute({\n   *   mcpSlug: \"kommo-mcp\",\n   *   entityId: \"user_123\",\n   *   toolName: \"get_leads\",\n   *   arguments: { limit: 10 }\n   * });\n   * ```\n   *\n   * @example Using connectionId\n   * ```typescript\n   * const result = await client.tools.execute({\n   *   mcpSlug: \"kommo-mcp\",\n   *   connectionId: \"conn_abc123\",\n   *   toolName: \"get_leads\",\n   *   arguments: { limit: 10 }\n   * });\n   * ```\n   */\n  async execute(params: ExecuteToolParams): Promise<ToolResult> {\n    // Validate that at least one of connectionId or entityId is provided\n    if (!params.connectionId && !params.entityId) {\n      throw new HornerosError(\n        HORNEROS_SDK_ERROR_CODES.COMMON.VALIDATION_ERROR,\n        \"Either connectionId or entityId is required\",\n        400\n      );\n    }\n\n    const body: Record<string, unknown> = {\n      mcp_slug: params.mcpSlug,\n      tool_name: params.toolName,\n      arguments: params.arguments,\n    };\n\n    // Prefer entityId if provided\n    if (params.entityId) {\n      body.entity_id = params.entityId;\n    } else if (params.connectionId) {\n      body.connection_id = params.connectionId;\n    }\n\n    const res = await this.client.fetch<ApiResponse<ToolResult>>(\n      \"/tools/execute\",\n      {\n        method: \"POST\",\n        body: JSON.stringify(body),\n      }\n    );\n    return res.data;\n  }\n}\n","import type { HornerosSSPConfig } from \"./types\";\nimport { HornerosError, HORNEROS_SDK_ERROR_CODES } from \"./errors\";\nimport { Mcps } from \"./mcps\";\nimport { Connections } from \"./connections\";\nimport { Tools } from \"./tools\";\n\n// ── Helpers ─────────────────────────────────────────────────\n\nfunction getEnvVariable(name: string): string | undefined {\n  if (typeof process !== \"undefined\" && process.env) {\n    return process.env[name];\n  }\n  return undefined;\n}\n\nconst DEFAULT_BASE_URL = \"http://localhost:3000\";\n\nfunction resolveConfig(config?: HornerosSSPConfig) {\n  const baseUrl =\n    config?.baseUrl ||\n    getEnvVariable(\"HORNEROS_BASE_URL\") ||\n    DEFAULT_BASE_URL;\n\n  const apiKey =\n    config?.apiKey ||\n    getEnvVariable(\"HORNEROS_API_KEY\") ||\n    \"\";\n\n  const runtime = config?.runtime || getEnvVariable(\"HORNEROS_RUNTIME\") || \"\";\n\n  return { baseUrl: baseUrl.replace(/\\/+$/, \"\"), apiKey, runtime };\n}\n\n// ── Main client ─────────────────────────────────────────────\n\nexport class HornerosSSP {\n  public readonly mcps: Mcps;\n  public readonly connections: Connections;\n  public readonly tools: Tools;\n\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly runtime: string;\n\n  constructor(config?: HornerosSSPConfig) {\n    const resolved = resolveConfig(config);\n\n    if (!resolved.apiKey) {\n      throw new HornerosError(\n        HORNEROS_SDK_ERROR_CODES.COMMON.API_KEY_UNAVAILABLE,\n        \"🔑 API Key is not provided\",\n        401,\n        undefined,\n        \"You need to provide an API key in the constructor or as the environment variable HORNEROS_API_KEY.\",\n        'Provide a valid API key: new HornerosSSP({ apiKey: \"hsp_xxx\" }) or set HORNEROS_API_KEY in your environment.'\n      );\n    }\n\n    this.baseUrl = resolved.baseUrl;\n    this.apiKey = resolved.apiKey;\n    this.runtime = resolved.runtime;\n\n    this.mcps = new Mcps(this);\n    this.connections = new Connections(this);\n    this.tools = new Tools(this);\n  }\n\n  /** @internal */\n  async fetch<T>(\n    path: string,\n    options: RequestInit = {}\n  ): Promise<T> {\n    const url = `${this.baseUrl}/api/v1${path}`;\n\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      \"X-Api-Key\": this.apiKey,\n      \"X-Source\": \"js_sdk\",\n      \"X-Runtime\": this.runtime,\n      ...(options.headers as Record<string, string>),\n    };\n\n    const res = await globalThis.fetch(url, {\n      ...options,\n      headers,\n    });\n\n    if (!res.ok) {\n      let body: unknown;\n      try {\n        body = await res.json();\n      } catch {\n        body = await res.text().catch(() => null);\n      }\n\n      const message =\n        (body && typeof body === \"object\" && \"error\" in body\n          ? (body as { error: string }).error\n          : null) || `HTTP ${res.status}`;\n\n      const errCode =\n        res.status === 404\n          ? HORNEROS_SDK_ERROR_CODES.BACKEND.NOT_FOUND\n          : res.status === 401\n            ? HORNEROS_SDK_ERROR_CODES.BACKEND.UNAUTHORIZED\n            : res.status === 429\n              ? HORNEROS_SDK_ERROR_CODES.BACKEND.RATE_LIMIT\n              : res.status === 400\n                ? HORNEROS_SDK_ERROR_CODES.BACKEND.BAD_REQUEST\n                : res.status >= 500\n                  ? HORNEROS_SDK_ERROR_CODES.BACKEND.SERVER_ERROR\n                  : HORNEROS_SDK_ERROR_CODES.BACKEND.UNKNOWN;\n\n      throw new HornerosError(errCode, message, res.status, body);\n    }\n\n    if (res.status === 204) {\n      return undefined as T;\n    }\n\n    return res.json() as Promise<T>;\n  }\n}\n","import type { ConnectionData } from \"./types\";\n\nexport class AuthScheme {\n  static APIKey(params: { api_key: string; [k: string]: string }): ConnectionData {\n    return { type: \"api_key\", data: params };\n  }\n\n  static Bearer(params: { token: string }): ConnectionData {\n    return { type: \"bearer\", data: params };\n  }\n\n  static Basic(params: { username: string; password: string }): ConnectionData {\n    return { type: \"basic\", data: params };\n  }\n\n  static OAuth2(params: {\n    access_token: string;\n    refresh_token?: string;\n  }): ConnectionData {\n    return {\n      type: \"oauth2\",\n      data: params as Record<string, string>,\n    };\n  }\n\n  static GoogleLogin(): ConnectionData {\n    return { type: \"google_login\", data: {} };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -13,7 +13,8 @@ var HORNEROS_SDK_ERROR_CODES = {
     API_KEY_UNAVAILABLE: "COMMON::API_KEY_UNAVAILABLE",
     BASE_URL_NOT_REACHABLE: "COMMON::BASE_URL_NOT_REACHABLE",
     UNKNOWN: "COMMON::UNKNOWN",
-    INVALID_PARAMS: "COMMON::INVALID_PARAMS"
+    INVALID_PARAMS: "COMMON::INVALID_PARAMS",
+    VALIDATION_ERROR: "COMMON::VALIDATION_ERROR"
   },
   SDK: {
     NO_CONNECTED_ACCOUNT: "SDK::NO_CONNECTED_ACCOUNT",
@@ -96,6 +97,8 @@ var ConnectionRequest = class {
   constructor(client, data) {
     this.client = client;
     this.id = data.id;
+    this.mcpSlug = data.mcpSlug;
+    this.entityId = data.entityId;
     this.mcpUrl = data.mcpUrl;
     this.token = data.token;
     this.redirectUrl = data.redirectUrl;
@@ -135,12 +138,36 @@ var Connections = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Create a connection for an end user (entity).
+   *
+   * @param params.mcpSlug - The MCP to connect to (e.g., "kommo-mcp")
+   * @param params.entityId - REQUIRED: The ID of the end user in YOUR app
+   * @param params.credentials - The credentials for the MCP
+   * @param params.appName - Optional name for this connection
+   *
+   * @example
+   * ```typescript
+   * const conn = await client.connections.initiate({
+   *   mcpSlug: "kommo-mcp",
+   *   entityId: "user_123",
+   *   credentials: { access_token: "...", base_domain: "..." }
+   * });
+   * ```
+   */
   async initiate(params) {
+    if (!params.entityId) {
+      throw new HornerosError(
+        HORNEROS_SDK_ERROR_CODES.COMMON.VALIDATION_ERROR,
+        "entityId is required. This identifies the end user in your app.",
+        400
+      );
+    }
     const body = {
-      mcp_slug: params.mcpSlug
+      mcp_slug: params.mcpSlug,
+      entity_id: params.entityId
     };
     if (params.appName) body.app_name = params.appName;
-    if (params.userId) body.user_id = params.userId;
     if (params.credentials) body.credentials = params.credentials;
     if (params.authScheme) body.auth_scheme = params.authScheme;
     const res = await this.client.fetch(
@@ -149,16 +176,53 @@ var Connections = class {
     );
     return new ConnectionRequest(this.client, res.data);
   }
-  async list() {
-    const res = await this.client.fetch("/connections");
+  /**
+   * List all connections.
+   *
+   * @param entityId - Optional: Filter by entity ID
+   * @param mcpSlug - Optional: Filter by MCP slug
+   */
+  async list(entityId, mcpSlug) {
+    const params = new URLSearchParams();
+    if (entityId) params.set("entity_id", entityId);
+    if (mcpSlug) params.set("mcp_slug", mcpSlug);
+    const query = params.toString();
+    const path = query ? `/connections?${query}` : "/connections";
+    const res = await this.client.fetch(path);
     return res.data;
   }
+  /**
+   * Get a connection by ID.
+   */
   async get(id) {
     const res = await this.client.fetch(
       `/connections/${encodeURIComponent(id)}`
     );
     return res.data;
   }
+  /**
+   * Get a connection by entity ID and MCP slug.
+   * Returns null if not found.
+   *
+   * @example
+   * ```typescript
+   * const conn = await client.connections.getByEntity("user_123", "kommo-mcp");
+   * if (conn) {
+   *   // Connection exists, can execute tools
+   * }
+   * ```
+   */
+  async getByEntity(entityId, mcpSlug) {
+    try {
+      const connections = await this.list(entityId, mcpSlug);
+      return connections[0] || null;
+    } catch {
+      return null;
+    }
+  }
+  /**
+   * Revoke a connection by ID.
+   */
   async revoke(id) {
     await this.client.fetch(
       `/connections/${encodeURIComponent(id)}`,
@@ -175,23 +239,65 @@ var Tools = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * List all tools available for an MCP.
+   */
   async list(mcpSlug) {
     const res = await this.client.fetch(
       `/mcps/${encodeURIComponent(mcpSlug)}/tools`
     );
     return res.data;
   }
+  /**
+   * Execute a tool on an MCP.
+   *
+   * You can identify the connection in two ways:
+   * 1. By connectionId: The ID returned when creating a connection
+   * 2. By entityId: The ID of the end user (will find the connection automatically)
+   *
+   * @example Using entityId (recommended)
+   * ```typescript
+   * const result = await client.tools.execute({
+   *   mcpSlug: "kommo-mcp",
+   *   entityId: "user_123",
+   *   toolName: "get_leads",
+   *   arguments: { limit: 10 }
+   * });
+   * ```
+   *
+   * @example Using connectionId
+   * ```typescript
+   * const result = await client.tools.execute({
+   *   mcpSlug: "kommo-mcp",
+   *   connectionId: "conn_abc123",
+   *   toolName: "get_leads",
+   *   arguments: { limit: 10 }
+   * });
+   * ```
+   */
   async execute(params) {
+    if (!params.connectionId && !params.entityId) {
+      throw new HornerosError(
+        HORNEROS_SDK_ERROR_CODES.COMMON.VALIDATION_ERROR,
+        "Either connectionId or entityId is required",
+        400
+      );
+    }
+    const body = {
+      mcp_slug: params.mcpSlug,
+      tool_name: params.toolName,
+      arguments: params.arguments
+    };
+    if (params.entityId) {
+      body.entity_id = params.entityId;
+    } else if (params.connectionId) {
+      body.connection_id = params.connectionId;
+    }
     const res = await this.client.fetch(
       "/tools/execute",
       {
         method: "POST",
-        body: JSON.stringify({
-          mcp_slug: params.mcpSlug,
-          connection_id: params.connectionId,
-          tool_name: params.toolName,
-          arguments: params.arguments
-        })
+        body: JSON.stringify(body)
       }
     );
     return res.data;

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/mcps.ts","../src/connections.ts","../src/tools.ts","../src/client.ts","../src/auth-scheme.ts"],"sourcesContent":["// ── Error codes ─────────────────────────────────────────────\n\nexport const HORNEROS_SDK_ERROR_CODES = {\n  BACKEND: {\n    NOT_FOUND: \"BACKEND::NOT_FOUND\",\n    RATE_LIMIT: \"BACKEND::RATE_LIMIT\",\n    BAD_REQUEST: \"BACKEND::BAD_REQUEST\",\n    UNAUTHORIZED: \"BACKEND::UNAUTHORIZED\",\n    SERVER_ERROR: \"BACKEND::SERVER_ERROR\",\n    SERVER_UNAVAILABLE: \"BACKEND::SERVER_UNAVAILABLE\",\n    UNKNOWN: \"BACKEND::UNKNOWN\",\n  },\n  COMMON: {\n    API_KEY_UNAVAILABLE: \"COMMON::API_KEY_UNAVAILABLE\",\n    BASE_URL_NOT_REACHABLE: \"COMMON::BASE_URL_NOT_REACHABLE\",\n    UNKNOWN: \"COMMON::UNKNOWN\",\n    INVALID_PARAMS: \"COMMON::INVALID_PARAMS\",\n  },\n  SDK: {\n    NO_CONNECTED_ACCOUNT: \"SDK::NO_CONNECTED_ACCOUNT\",\n    CONNECTION_TIMEOUT: \"SDK::CONNECTION_TIMEOUT\",\n    INVALID_PARAMETER: \"SDK::INVALID_PARAMETER\",\n  },\n} as const;\n\n// ── Base error ──────────────────────────────────────────────\n\nlet errorCounter = 0;\n\nexport class HornerosError extends Error {\n  public readonly errCode: string;\n  public readonly statusCode: number;\n  public readonly body: unknown;\n  public readonly description?: string;\n  public readonly possibleFix?: string;\n  public readonly errorId: string;\n  public readonly timestamp: string;\n\n  constructor(\n    errCode: string,\n    message: string,\n    statusCode: number,\n    body?: unknown,\n    description?: string,\n    possibleFix?: string\n  ) {\n    super(message);\n    this.name = \"HornerosError\";\n    this.errCode = errCode;\n    this.statusCode = statusCode;\n    this.body = body;\n    this.description = description;\n    this.possibleFix = possibleFix;\n    this.errorId = `horneros_${Date.now()}_${++errorCounter}`;\n    this.timestamp = new Date().toISOString();\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      errCode: this.errCode,\n      message: this.message,\n      statusCode: this.statusCode,\n      description: this.description,\n      possibleFix: this.possibleFix,\n      errorId: this.errorId,\n      timestamp: this.timestamp,\n      body: this.body,\n    };\n  }\n}\n\n// ── Specialized errors ──────────────────────────────────────\n\nexport class NotFoundError extends HornerosError {\n  constructor(message: string, body?: unknown) {\n    super(HORNEROS_SDK_ERROR_CODES.BACKEND.NOT_FOUND, message, 404, body);\n    this.name = \"NotFoundError\";\n  }\n}\n\nexport class ValidationError extends HornerosError {\n  constructor(message: string, body?: unknown) {\n    super(HORNEROS_SDK_ERROR_CODES.BACKEND.BAD_REQUEST, message, 400, body);\n    this.name = \"ValidationError\";\n  }\n}\n\nexport class ConnectionTimeoutError extends HornerosError {\n  constructor(message = \"Connection timed out waiting for activation\") {\n    super(\n      HORNEROS_SDK_ERROR_CODES.SDK.CONNECTION_TIMEOUT,\n      message,\n      408,\n      undefined,\n      \"The connection did not become active within the timeout period.\",\n      \"Increase the timeout value or check that the user completed the authentication flow.\"\n    );\n    this.name = \"ConnectionTimeoutError\";\n  }\n}\n","import type { HornerosSSP } from \"./client\";\nimport type { McpInfo, McpDetail, ApiResponse } from \"./types\";\n\nexport class Mcps {\n  constructor(private client: HornerosSSP) {}\n\n  async list(): Promise<McpInfo[]> {\n    const res = await this.client.fetch<ApiResponse<McpInfo[]>>(\"/mcps\");\n    return res.data;\n  }\n\n  async get(slug: string): Promise<McpDetail> {\n    const res = await this.client.fetch<ApiResponse<McpDetail>>(\n      `/mcps/${encodeURIComponent(slug)}`\n    );\n    return res.data;\n  }\n}\n","import type { HornerosSSP } from \"./client\";\nimport type {\n  ConnectionInfo,\n  ConnectionRequestData,\n  InitiateConnectionParams,\n  ApiResponse,\n} from \"./types\";\nimport { ConnectionTimeoutError } from \"./errors\";\n\nexport class ConnectionRequest {\n  public readonly id: string;\n  public readonly mcpUrl: string | null;\n  public readonly token: string | null;\n  public readonly redirectUrl: string | null;\n  public readonly status: \"active\" | \"pending\";\n\n  constructor(\n    private client: HornerosSSP,\n    data: ConnectionRequestData\n  ) {\n    this.id = data.id;\n    this.mcpUrl = data.mcpUrl;\n    this.token = data.token;\n    this.redirectUrl = data.redirectUrl;\n    this.status = data.status;\n  }\n\n  /**\n   * Polls the connection until it becomes active.\n   * Useful for OAuth/interactive flows where the user needs to\n   * complete authentication in a browser.\n   * @param timeout Max wait time in ms (default: 120000 = 2 min)\n   */\n  async waitForConnection(timeout = 120_000): Promise<ConnectionInfo> {\n    if (this.status === \"active\") {\n      const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n        `/connections/${encodeURIComponent(this.id)}`\n      );\n      return res.data;\n    }\n\n    const start = Date.now();\n    const interval = 2000;\n\n    while (Date.now() - start < timeout) {\n      await sleep(interval);\n      try {\n        const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n          `/connections/${encodeURIComponent(this.id)}`\n        );\n        if (res.data.status === \"active\") {\n          return res.data;\n        }\n      } catch {\n        // Connection not yet created, keep polling\n      }\n    }\n\n    throw new ConnectionTimeoutError();\n  }\n}\n\nexport class Connections {\n  constructor(private client: HornerosSSP) {}\n\n  async initiate(params: InitiateConnectionParams): Promise<ConnectionRequest> {\n    const body: Record<string, unknown> = {\n      mcp_slug: params.mcpSlug,\n    };\n\n    if (params.appName) body.app_name = params.appName;\n    if (params.userId) body.user_id = params.userId;\n    if (params.credentials) body.credentials = params.credentials;\n    if (params.authScheme) body.auth_scheme = params.authScheme;\n\n    const res = await this.client.fetch<ApiResponse<ConnectionRequestData>>(\n      \"/connections\",\n      { method: \"POST\", body: JSON.stringify(body) }\n    );\n\n    return new ConnectionRequest(this.client, res.data);\n  }\n\n  async list(): Promise<ConnectionInfo[]> {\n    const res =\n      await this.client.fetch<ApiResponse<ConnectionInfo[]>>(\"/connections\");\n    return res.data;\n  }\n\n  async get(id: string): Promise<ConnectionInfo> {\n    const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n      `/connections/${encodeURIComponent(id)}`\n    );\n    return res.data;\n  }\n\n  async revoke(id: string): Promise<void> {\n    await this.client.fetch<void>(\n      `/connections/${encodeURIComponent(id)}`,\n      { method: \"DELETE\" }\n    );\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import type { HornerosSSP } from \"./client\";\nimport type {\n  ToolDefinition,\n  ToolResult,\n  ExecuteToolParams,\n  ApiResponse,\n} from \"./types\";\n\nexport class Tools {\n  constructor(private client: HornerosSSP) {}\n\n  async list(mcpSlug: string): Promise<ToolDefinition[]> {\n    const res = await this.client.fetch<ApiResponse<ToolDefinition[]>>(\n      `/mcps/${encodeURIComponent(mcpSlug)}/tools`\n    );\n    return res.data;\n  }\n\n  async execute(params: ExecuteToolParams): Promise<ToolResult> {\n    const res = await this.client.fetch<ApiResponse<ToolResult>>(\n      \"/tools/execute\",\n      {\n        method: \"POST\",\n        body: JSON.stringify({\n          mcp_slug: params.mcpSlug,\n          connection_id: params.connectionId,\n          tool_name: params.toolName,\n          arguments: params.arguments,\n        }),\n      }\n    );\n    return res.data;\n  }\n}\n","import type { HornerosSSPConfig } from \"./types\";\nimport { HornerosError, HORNEROS_SDK_ERROR_CODES } from \"./errors\";\nimport { Mcps } from \"./mcps\";\nimport { Connections } from \"./connections\";\nimport { Tools } from \"./tools\";\n\n// ── Helpers ─────────────────────────────────────────────────\n\nfunction getEnvVariable(name: string): string | undefined {\n  if (typeof process !== \"undefined\" && process.env) {\n    return process.env[name];\n  }\n  return undefined;\n}\n\nconst DEFAULT_BASE_URL = \"http://localhost:3000\";\n\nfunction resolveConfig(config?: HornerosSSPConfig) {\n  const baseUrl =\n    config?.baseUrl ||\n    getEnvVariable(\"HORNEROS_BASE_URL\") ||\n    DEFAULT_BASE_URL;\n\n  const apiKey =\n    config?.apiKey ||\n    getEnvVariable(\"HORNEROS_API_KEY\") ||\n    \"\";\n\n  const runtime = config?.runtime || getEnvVariable(\"HORNEROS_RUNTIME\") || \"\";\n\n  return { baseUrl: baseUrl.replace(/\\/+$/, \"\"), apiKey, runtime };\n}\n\n// ── Main client ─────────────────────────────────────────────\n\nexport class HornerosSSP {\n  public readonly mcps: Mcps;\n  public readonly connections: Connections;\n  public readonly tools: Tools;\n\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly runtime: string;\n\n  constructor(config?: HornerosSSPConfig) {\n    const resolved = resolveConfig(config);\n\n    if (!resolved.apiKey) {\n      throw new HornerosError(\n        HORNEROS_SDK_ERROR_CODES.COMMON.API_KEY_UNAVAILABLE,\n        \"🔑 API Key is not provided\",\n        401,\n        undefined,\n        \"You need to provide an API key in the constructor or as the environment variable HORNEROS_API_KEY.\",\n        'Provide a valid API key: new HornerosSSP({ apiKey: \"hsp_xxx\" }) or set HORNEROS_API_KEY in your environment.'\n      );\n    }\n\n    this.baseUrl = resolved.baseUrl;\n    this.apiKey = resolved.apiKey;\n    this.runtime = resolved.runtime;\n\n    this.mcps = new Mcps(this);\n    this.connections = new Connections(this);\n    this.tools = new Tools(this);\n  }\n\n  /** @internal */\n  async fetch<T>(\n    path: string,\n    options: RequestInit = {}\n  ): Promise<T> {\n    const url = `${this.baseUrl}/api/v1${path}`;\n\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      \"X-Api-Key\": this.apiKey,\n      \"X-Source\": \"js_sdk\",\n      \"X-Runtime\": this.runtime,\n      ...(options.headers as Record<string, string>),\n    };\n\n    const res = await globalThis.fetch(url, {\n      ...options,\n      headers,\n    });\n\n    if (!res.ok) {\n      let body: unknown;\n      try {\n        body = await res.json();\n      } catch {\n        body = await res.text().catch(() => null);\n      }\n\n      const message =\n        (body && typeof body === \"object\" && \"error\" in body\n          ? (body as { error: string }).error\n          : null) || `HTTP ${res.status}`;\n\n      const errCode =\n        res.status === 404\n          ? HORNEROS_SDK_ERROR_CODES.BACKEND.NOT_FOUND\n          : res.status === 401\n            ? HORNEROS_SDK_ERROR_CODES.BACKEND.UNAUTHORIZED\n            : res.status === 429\n              ? HORNEROS_SDK_ERROR_CODES.BACKEND.RATE_LIMIT\n              : res.status === 400\n                ? HORNEROS_SDK_ERROR_CODES.BACKEND.BAD_REQUEST\n                : res.status >= 500\n                  ? HORNEROS_SDK_ERROR_CODES.BACKEND.SERVER_ERROR\n                  : HORNEROS_SDK_ERROR_CODES.BACKEND.UNKNOWN;\n\n      throw new HornerosError(errCode, message, res.status, body);\n    }\n\n    if (res.status === 204) {\n      return undefined as T;\n    }\n\n    return res.json() as Promise<T>;\n  }\n}\n","import type { ConnectionData } from \"./types\";\n\nexport class AuthScheme {\n  static APIKey(params: { api_key: string; [k: string]: string }): ConnectionData {\n    return { type: \"api_key\", data: params };\n  }\n\n  static Bearer(params: { token: string }): ConnectionData {\n    return { type: \"bearer\", data: params };\n  }\n\n  static Basic(params: { username: string; password: string }): ConnectionData {\n    return { type: \"basic\", data: params };\n  }\n\n  static OAuth2(params: {\n    access_token: string;\n    refresh_token?: string;\n  }): ConnectionData {\n    return {\n      type: \"oauth2\",\n      data: params as Record<string, string>,\n    };\n  }\n\n  static GoogleLogin(): ConnectionData {\n    return { type: \"google_login\", data: {} };\n  }\n}\n"],"mappings":";AAEO,IAAM,2BAA2B;AAAA,EACtC,SAAS;AAAA,IACP,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,aAAa;AAAA,IACb,cAAc;AAAA,IACd,cAAc;AAAA,IACd,oBAAoB;AAAA,IACpB,SAAS;AAAA,EACX;AAAA,EACA,QAAQ;AAAA,IACN,qBAAqB;AAAA,IACrB,wBAAwB;AAAA,IACxB,SAAS;AAAA,IACT,gBAAgB;AAAA,EAClB;AAAA,EACA,KAAK;AAAA,IACH,sBAAsB;AAAA,IACtB,oBAAoB;AAAA,IACpB,mBAAmB;AAAA,EACrB;AACF;AAIA,IAAI,eAAe;AAEZ,IAAM,gBAAN,cAA4B,MAAM;AAAA,EASvC,YACE,SACA,SACA,YACA,MACA,aACA,aACA;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,UAAU;AACf,SAAK,aAAa;AAClB,SAAK,OAAO;AACZ,SAAK,cAAc;AACnB,SAAK,cAAc;AACnB,SAAK,UAAU,YAAY,KAAK,IAAI,CAAC,IAAI,EAAE,YAAY;AACvD,SAAK,aAAY,oBAAI,KAAK,GAAE,YAAY;AAAA,EAC1C;AAAA,EAEA,SAAkC;AAChC,WAAO;AAAA,MACL,MAAM,KAAK;AAAA,MACX,SAAS,KAAK;AAAA,MACd,SAAS,KAAK;AAAA,MACd,YAAY,KAAK;AAAA,MACjB,aAAa,KAAK;AAAA,MAClB,aAAa,KAAK;AAAA,MAClB,SAAS,KAAK;AAAA,MACd,WAAW,KAAK;AAAA,MAChB,MAAM,KAAK;AAAA,IACb;AAAA,EACF;AACF;AAIO,IAAM,gBAAN,cAA4B,cAAc;AAAA,EAC/C,YAAY,SAAiB,MAAgB;AAC3C,UAAM,yBAAyB,QAAQ,WAAW,SAAS,KAAK,IAAI;AACpE,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,kBAAN,cAA8B,cAAc;AAAA,EACjD,YAAY,SAAiB,MAAgB;AAC3C,UAAM,yBAAyB,QAAQ,aAAa,SAAS,KAAK,IAAI;AACtE,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,yBAAN,cAAqC,cAAc;AAAA,EACxD,YAAY,UAAU,+CAA+C;AACnE;AAAA,MACE,yBAAyB,IAAI;AAAA,MAC7B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AACA,SAAK,OAAO;AAAA,EACd;AACF;;;ACjGO,IAAM,OAAN,MAAW;AAAA,EAChB,YAAoB,QAAqB;AAArB;AAAA,EAAsB;AAAA,EAE1C,MAAM,OAA2B;AAC/B,UAAM,MAAM,MAAM,KAAK,OAAO,MAA8B,OAAO;AACnE,WAAO,IAAI;AAAA,EACb;AAAA,EAEA,MAAM,IAAI,MAAkC;AAC1C,UAAM,MAAM,MAAM,KAAK,OAAO;AAAA,MAC5B,SAAS,mBAAmB,IAAI,CAAC;AAAA,IACnC;AACA,WAAO,IAAI;AAAA,EACb;AACF;;;ACRO,IAAM,oBAAN,MAAwB;AAAA,EAO7B,YACU,QACR,MACA;AAFQ;AAGR,SAAK,KAAK,KAAK;AACf,SAAK,SAAS,KAAK;AACnB,SAAK,QAAQ,KAAK;AAClB,SAAK,cAAc,KAAK;AACxB,SAAK,SAAS,KAAK;AAAA,EACrB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,kBAAkB,UAAU,MAAkC;AAClE,QAAI,KAAK,WAAW,UAAU;AAC5B,YAAM,MAAM,MAAM,KAAK,OAAO;AAAA,QAC5B,gBAAgB,mBAAmB,KAAK,EAAE,CAAC;AAAA,MAC7C;AACA,aAAO,IAAI;AAAA,IACb;AAEA,UAAM,QAAQ,KAAK,IAAI;AACvB,UAAM,WAAW;AAEjB,WAAO,KAAK,IAAI,IAAI,QAAQ,SAAS;AACnC,YAAM,MAAM,QAAQ;AACpB,UAAI;AACF,cAAM,MAAM,MAAM,KAAK,OAAO;AAAA,UAC5B,gBAAgB,mBAAmB,KAAK,EAAE,CAAC;AAAA,QAC7C;AACA,YAAI,IAAI,KAAK,WAAW,UAAU;AAChC,iBAAO,IAAI;AAAA,QACb;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,UAAM,IAAI,uBAAuB;AAAA,EACnC;AACF;AAEO,IAAM,cAAN,MAAkB;AAAA,EACvB,YAAoB,QAAqB;AAArB;AAAA,EAAsB;AAAA,EAE1C,MAAM,SAAS,QAA8D;AAC3E,UAAM,OAAgC;AAAA,MACpC,UAAU,OAAO;AAAA,IACnB;AAEA,QAAI,OAAO,QAAS,MAAK,WAAW,OAAO;AAC3C,QAAI,OAAO,OAAQ,MAAK,UAAU,OAAO;AACzC,QAAI,OAAO,YAAa,MAAK,cAAc,OAAO;AAClD,QAAI,OAAO,WAAY,MAAK,cAAc,OAAO;AAEjD,UAAM,MAAM,MAAM,KAAK,OAAO;AAAA,MAC5B;AAAA,MACA,EAAE,QAAQ,QAAQ,MAAM,KAAK,UAAU,IAAI,EAAE;AAAA,IAC/C;AAEA,WAAO,IAAI,kBAAkB,KAAK,QAAQ,IAAI,IAAI;AAAA,EACpD;AAAA,EAEA,MAAM,OAAkC;AACtC,UAAM,MACJ,MAAM,KAAK,OAAO,MAAqC,cAAc;AACvE,WAAO,IAAI;AAAA,EACb;AAAA,EAEA,MAAM,IAAI,IAAqC;AAC7C,UAAM,MAAM,MAAM,KAAK,OAAO;AAAA,MAC5B,gBAAgB,mBAAmB,EAAE,CAAC;AAAA,IACxC;AACA,WAAO,IAAI;AAAA,EACb;AAAA,EAEA,MAAM,OAAO,IAA2B;AACtC,UAAM,KAAK,OAAO;AAAA,MAChB,gBAAgB,mBAAmB,EAAE,CAAC;AAAA,MACtC,EAAE,QAAQ,SAAS;AAAA,IACrB;AAAA,EACF;AACF;AAEA,SAAS,MAAM,IAA2B;AACxC,SAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AACzD;;;AClGO,IAAM,QAAN,MAAY;AAAA,EACjB,YAAoB,QAAqB;AAArB;AAAA,EAAsB;AAAA,EAE1C,MAAM,KAAK,SAA4C;AACrD,UAAM,MAAM,MAAM,KAAK,OAAO;AAAA,MAC5B,SAAS,mBAAmB,OAAO,CAAC;AAAA,IACtC;AACA,WAAO,IAAI;AAAA,EACb;AAAA,EAEA,MAAM,QAAQ,QAAgD;AAC5D,UAAM,MAAM,MAAM,KAAK,OAAO;AAAA,MAC5B;AAAA,MACA;AAAA,QACE,QAAQ;AAAA,QACR,MAAM,KAAK,UAAU;AAAA,UACnB,UAAU,OAAO;AAAA,UACjB,eAAe,OAAO;AAAA,UACtB,WAAW,OAAO;AAAA,UAClB,WAAW,OAAO;AAAA,QACpB,CAAC;AAAA,MACH;AAAA,IACF;AACA,WAAO,IAAI;AAAA,EACb;AACF;;;ACzBA,SAAS,eAAe,MAAkC;AACxD,MAAI,OAAO,YAAY,eAAe,QAAQ,KAAK;AACjD,WAAO,QAAQ,IAAI,IAAI;AAAA,EACzB;AACA,SAAO;AACT;AAEA,IAAM,mBAAmB;AAEzB,SAAS,cAAc,QAA4B;AACjD,QAAM,UACJ,QAAQ,WACR,eAAe,mBAAmB,KAClC;AAEF,QAAM,SACJ,QAAQ,UACR,eAAe,kBAAkB,KACjC;AAEF,QAAM,UAAU,QAAQ,WAAW,eAAe,kBAAkB,KAAK;AAEzE,SAAO,EAAE,SAAS,QAAQ,QAAQ,QAAQ,EAAE,GAAG,QAAQ,QAAQ;AACjE;AAIO,IAAM,cAAN,MAAkB;AAAA,EASvB,YAAY,QAA4B;AACtC,UAAM,WAAW,cAAc,MAAM;AAErC,QAAI,CAAC,SAAS,QAAQ;AACpB,YAAM,IAAI;AAAA,QACR,yBAAyB,OAAO;AAAA,QAChC;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,SAAK,UAAU,SAAS;AACxB,SAAK,SAAS,SAAS;AACvB,SAAK,UAAU,SAAS;AAExB,SAAK,OAAO,IAAI,KAAK,IAAI;AACzB,SAAK,cAAc,IAAI,YAAY,IAAI;AACvC,SAAK,QAAQ,IAAI,MAAM,IAAI;AAAA,EAC7B;AAAA;AAAA,EAGA,MAAM,MACJ,MACA,UAAuB,CAAC,GACZ;AACZ,UAAM,MAAM,GAAG,KAAK,OAAO,UAAU,IAAI;AAEzC,UAAM,UAAkC;AAAA,MACtC,gBAAgB;AAAA,MAChB,aAAa,KAAK;AAAA,MAClB,YAAY;AAAA,MACZ,aAAa,KAAK;AAAA,MAClB,GAAI,QAAQ;AAAA,IACd;AAEA,UAAM,MAAM,MAAM,WAAW,MAAM,KAAK;AAAA,MACtC,GAAG;AAAA,MACH;AAAA,IACF,CAAC;AAED,QAAI,CAAC,IAAI,IAAI;AACX,UAAI;AACJ,UAAI;AACF,eAAO,MAAM,IAAI,KAAK;AAAA,MACxB,QAAQ;AACN,eAAO,MAAM,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI;AAAA,MAC1C;AAEA,YAAM,WACH,QAAQ,OAAO,SAAS,YAAY,WAAW,OAC3C,KAA2B,QAC5B,SAAS,QAAQ,IAAI,MAAM;AAEjC,YAAM,UACJ,IAAI,WAAW,MACX,yBAAyB,QAAQ,YACjC,IAAI,WAAW,MACb,yBAAyB,QAAQ,eACjC,IAAI,WAAW,MACb,yBAAyB,QAAQ,aACjC,IAAI,WAAW,MACb,yBAAyB,QAAQ,cACjC,IAAI,UAAU,MACZ,yBAAyB,QAAQ,eACjC,yBAAyB,QAAQ;AAE/C,YAAM,IAAI,cAAc,SAAS,SAAS,IAAI,QAAQ,IAAI;AAAA,IAC5D;AAEA,QAAI,IAAI,WAAW,KAAK;AACtB,aAAO;AAAA,IACT;AAEA,WAAO,IAAI,KAAK;AAAA,EAClB;AACF;;;ACxHO,IAAM,aAAN,MAAiB;AAAA,EACtB,OAAO,OAAO,QAAkE;AAC9E,WAAO,EAAE,MAAM,WAAW,MAAM,OAAO;AAAA,EACzC;AAAA,EAEA,OAAO,OAAO,QAA2C;AACvD,WAAO,EAAE,MAAM,UAAU,MAAM,OAAO;AAAA,EACxC;AAAA,EAEA,OAAO,MAAM,QAAgE;AAC3E,WAAO,EAAE,MAAM,SAAS,MAAM,OAAO;AAAA,EACvC;AAAA,EAEA,OAAO,OAAO,QAGK;AACjB,WAAO;AAAA,MACL,MAAM;AAAA,MACN,MAAM;AAAA,IACR;AAAA,EACF;AAAA,EAEA,OAAO,cAA8B;AACnC,WAAO,EAAE,MAAM,gBAAgB,MAAM,CAAC,EAAE;AAAA,EAC1C;AACF;","names":[]}
+{"version":3,"sources":["../src/errors.ts","../src/mcps.ts","../src/connections.ts","../src/tools.ts","../src/client.ts","../src/auth-scheme.ts"],"sourcesContent":["// ── Error codes ─────────────────────────────────────────────\n\nexport const HORNEROS_SDK_ERROR_CODES = {\n  BACKEND: {\n    NOT_FOUND: \"BACKEND::NOT_FOUND\",\n    RATE_LIMIT: \"BACKEND::RATE_LIMIT\",\n    BAD_REQUEST: \"BACKEND::BAD_REQUEST\",\n    UNAUTHORIZED: \"BACKEND::UNAUTHORIZED\",\n    SERVER_ERROR: \"BACKEND::SERVER_ERROR\",\n    SERVER_UNAVAILABLE: \"BACKEND::SERVER_UNAVAILABLE\",\n    UNKNOWN: \"BACKEND::UNKNOWN\",\n  },\n  COMMON: {\n    API_KEY_UNAVAILABLE: \"COMMON::API_KEY_UNAVAILABLE\",\n    BASE_URL_NOT_REACHABLE: \"COMMON::BASE_URL_NOT_REACHABLE\",\n    UNKNOWN: \"COMMON::UNKNOWN\",\n    INVALID_PARAMS: \"COMMON::INVALID_PARAMS\",\n    VALIDATION_ERROR: \"COMMON::VALIDATION_ERROR\",\n  },\n  SDK: {\n    NO_CONNECTED_ACCOUNT: \"SDK::NO_CONNECTED_ACCOUNT\",\n    CONNECTION_TIMEOUT: \"SDK::CONNECTION_TIMEOUT\",\n    INVALID_PARAMETER: \"SDK::INVALID_PARAMETER\",\n  },\n} as const;\n\n// ── Base error ──────────────────────────────────────────────\n\nlet errorCounter = 0;\n\nexport class HornerosError extends Error {\n  public readonly errCode: string;\n  public readonly statusCode: number;\n  public readonly body: unknown;\n  public readonly description?: string;\n  public readonly possibleFix?: string;\n  public readonly errorId: string;\n  public readonly timestamp: string;\n\n  constructor(\n    errCode: string,\n    message: string,\n    statusCode: number,\n    body?: unknown,\n    description?: string,\n    possibleFix?: string\n  ) {\n    super(message);\n    this.name = \"HornerosError\";\n    this.errCode = errCode;\n    this.statusCode = statusCode;\n    this.body = body;\n    this.description = description;\n    this.possibleFix = possibleFix;\n    this.errorId = `horneros_${Date.now()}_${++errorCounter}`;\n    this.timestamp = new Date().toISOString();\n  }\n\n  toJSON(): Record<string, unknown> {\n    return {\n      name: this.name,\n      errCode: this.errCode,\n      message: this.message,\n      statusCode: this.statusCode,\n      description: this.description,\n      possibleFix: this.possibleFix,\n      errorId: this.errorId,\n      timestamp: this.timestamp,\n      body: this.body,\n    };\n  }\n}\n\n// ── Specialized errors ──────────────────────────────────────\n\nexport class NotFoundError extends HornerosError {\n  constructor(message: string, body?: unknown) {\n    super(HORNEROS_SDK_ERROR_CODES.BACKEND.NOT_FOUND, message, 404, body);\n    this.name = \"NotFoundError\";\n  }\n}\n\nexport class ValidationError extends HornerosError {\n  constructor(message: string, body?: unknown) {\n    super(HORNEROS_SDK_ERROR_CODES.BACKEND.BAD_REQUEST, message, 400, body);\n    this.name = \"ValidationError\";\n  }\n}\n\nexport class ConnectionTimeoutError extends HornerosError {\n  constructor(message = \"Connection timed out waiting for activation\") {\n    super(\n      HORNEROS_SDK_ERROR_CODES.SDK.CONNECTION_TIMEOUT,\n      message,\n      408,\n      undefined,\n      \"The connection did not become active within the timeout period.\",\n      \"Increase the timeout value or check that the user completed the authentication flow.\"\n    );\n    this.name = \"ConnectionTimeoutError\";\n  }\n}\n","import type { HornerosSSP } from \"./client\";\nimport type { McpInfo, McpDetail, ApiResponse } from \"./types\";\n\nexport class Mcps {\n  constructor(private client: HornerosSSP) {}\n\n  async list(): Promise<McpInfo[]> {\n    const res = await this.client.fetch<ApiResponse<McpInfo[]>>(\"/mcps\");\n    return res.data;\n  }\n\n  async get(slug: string): Promise<McpDetail> {\n    const res = await this.client.fetch<ApiResponse<McpDetail>>(\n      `/mcps/${encodeURIComponent(slug)}`\n    );\n    return res.data;\n  }\n}\n","import type { HornerosSSP } from \"./client\";\nimport type {\n  ConnectionInfo,\n  ConnectionRequestData,\n  InitiateConnectionParams,\n  ApiResponse,\n} from \"./types\";\nimport { ConnectionTimeoutError, HornerosError, HORNEROS_SDK_ERROR_CODES } from \"./errors\";\n\nexport class ConnectionRequest {\n  public readonly id: string;\n  public readonly mcpSlug: string;\n  public readonly entityId: string;\n  public readonly mcpUrl: string | null;\n  public readonly token: string | null;\n  public readonly redirectUrl: string | null;\n  public readonly status: \"active\" | \"pending\";\n\n  constructor(\n    private client: HornerosSSP,\n    data: ConnectionRequestData\n  ) {\n    this.id = data.id;\n    this.mcpSlug = data.mcpSlug;\n    this.entityId = data.entityId;\n    this.mcpUrl = data.mcpUrl;\n    this.token = data.token;\n    this.redirectUrl = data.redirectUrl;\n    this.status = data.status;\n  }\n\n  /**\n   * Polls the connection until it becomes active.\n   * Useful for OAuth/interactive flows where the user needs to\n   * complete authentication in a browser.\n   * @param timeout Max wait time in ms (default: 120000 = 2 min)\n   */\n  async waitForConnection(timeout = 120_000): Promise<ConnectionInfo> {\n    if (this.status === \"active\") {\n      const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n        `/connections/${encodeURIComponent(this.id)}`\n      );\n      return res.data;\n    }\n\n    const start = Date.now();\n    const interval = 2000;\n\n    while (Date.now() - start < timeout) {\n      await sleep(interval);\n      try {\n        const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n          `/connections/${encodeURIComponent(this.id)}`\n        );\n        if (res.data.status === \"active\") {\n          return res.data;\n        }\n      } catch {\n        // Connection not yet created, keep polling\n      }\n    }\n\n    throw new ConnectionTimeoutError();\n  }\n}\n\nexport class Connections {\n  constructor(private client: HornerosSSP) {}\n\n  /**\n   * Create a connection for an end user (entity).\n   *\n   * @param params.mcpSlug - The MCP to connect to (e.g., \"kommo-mcp\")\n   * @param params.entityId - REQUIRED: The ID of the end user in YOUR app\n   * @param params.credentials - The credentials for the MCP\n   * @param params.appName - Optional name for this connection\n   *\n   * @example\n   * ```typescript\n   * const conn = await client.connections.initiate({\n   *   mcpSlug: \"kommo-mcp\",\n   *   entityId: \"user_123\",\n   *   credentials: { access_token: \"...\", base_domain: \"...\" }\n   * });\n   * ```\n   */\n  async initiate(params: InitiateConnectionParams): Promise<ConnectionRequest> {\n    // Validate entityId is provided\n    if (!params.entityId) {\n      throw new HornerosError(\n        HORNEROS_SDK_ERROR_CODES.COMMON.VALIDATION_ERROR,\n        \"entityId is required. This identifies the end user in your app.\",\n        400\n      );\n    }\n\n    const body: Record<string, unknown> = {\n      mcp_slug: params.mcpSlug,\n      entity_id: params.entityId,\n    };\n\n    if (params.appName) body.app_name = params.appName;\n    if (params.credentials) body.credentials = params.credentials;\n    if (params.authScheme) body.auth_scheme = params.authScheme;\n\n    const res = await this.client.fetch<ApiResponse<ConnectionRequestData>>(\n      \"/connections\",\n      { method: \"POST\", body: JSON.stringify(body) }\n    );\n\n    return new ConnectionRequest(this.client, res.data);\n  }\n\n  /**\n   * List all connections.\n   *\n   * @param entityId - Optional: Filter by entity ID\n   * @param mcpSlug - Optional: Filter by MCP slug\n   */\n  async list(entityId?: string, mcpSlug?: string): Promise<ConnectionInfo[]> {\n    const params = new URLSearchParams();\n    if (entityId) params.set(\"entity_id\", entityId);\n    if (mcpSlug) params.set(\"mcp_slug\", mcpSlug);\n\n    const query = params.toString();\n    const path = query ? `/connections?${query}` : \"/connections\";\n\n    const res = await this.client.fetch<ApiResponse<ConnectionInfo[]>>(path);\n    return res.data;\n  }\n\n  /**\n   * Get a connection by ID.\n   */\n  async get(id: string): Promise<ConnectionInfo> {\n    const res = await this.client.fetch<ApiResponse<ConnectionInfo>>(\n      `/connections/${encodeURIComponent(id)}`\n    );\n    return res.data;\n  }\n\n  /**\n   * Get a connection by entity ID and MCP slug.\n   * Returns null if not found.\n   *\n   * @example\n   * ```typescript\n   * const conn = await client.connections.getByEntity(\"user_123\", \"kommo-mcp\");\n   * if (conn) {\n   *   // Connection exists, can execute tools\n   * }\n   * ```\n   */\n  async getByEntity(entityId: string, mcpSlug: string): Promise<ConnectionInfo | null> {\n    try {\n      const connections = await this.list(entityId, mcpSlug);\n      return connections[0] || null;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Revoke a connection by ID.\n   */\n  async revoke(id: string): Promise<void> {\n    await this.client.fetch<void>(\n      `/connections/${encodeURIComponent(id)}`,\n      { method: \"DELETE\" }\n    );\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import type { HornerosSSP } from \"./client\";\nimport type {\n  ToolDefinition,\n  ToolResult,\n  ExecuteToolParams,\n  ApiResponse,\n} from \"./types\";\nimport { HornerosError, HORNEROS_SDK_ERROR_CODES } from \"./errors\";\n\nexport class Tools {\n  constructor(private client: HornerosSSP) {}\n\n  /**\n   * List all tools available for an MCP.\n   */\n  async list(mcpSlug: string): Promise<ToolDefinition[]> {\n    const res = await this.client.fetch<ApiResponse<ToolDefinition[]>>(\n      `/mcps/${encodeURIComponent(mcpSlug)}/tools`\n    );\n    return res.data;\n  }\n\n  /**\n   * Execute a tool on an MCP.\n   *\n   * You can identify the connection in two ways:\n   * 1. By connectionId: The ID returned when creating a connection\n   * 2. By entityId: The ID of the end user (will find the connection automatically)\n   *\n   * @example Using entityId (recommended)\n   * ```typescript\n   * const result = await client.tools.execute({\n   *   mcpSlug: \"kommo-mcp\",\n   *   entityId: \"user_123\",\n   *   toolName: \"get_leads\",\n   *   arguments: { limit: 10 }\n   * });\n   * ```\n   *\n   * @example Using connectionId\n   * ```typescript\n   * const result = await client.tools.execute({\n   *   mcpSlug: \"kommo-mcp\",\n   *   connectionId: \"conn_abc123\",\n   *   toolName: \"get_leads\",\n   *   arguments: { limit: 10 }\n   * });\n   * ```\n   */\n  async execute(params: ExecuteToolParams): Promise<ToolResult> {\n    // Validate that at least one of connectionId or entityId is provided\n    if (!params.connectionId && !params.entityId) {\n      throw new HornerosError(\n        HORNEROS_SDK_ERROR_CODES.COMMON.VALIDATION_ERROR,\n        \"Either connectionId or entityId is required\",\n        400\n      );\n    }\n\n    const body: Record<string, unknown> = {\n      mcp_slug: params.mcpSlug,\n      tool_name: params.toolName,\n      arguments: params.arguments,\n    };\n\n    // Prefer entityId if provided\n    if (params.entityId) {\n      body.entity_id = params.entityId;\n    } else if (params.connectionId) {\n      body.connection_id = params.connectionId;\n    }\n\n    const res = await this.client.fetch<ApiResponse<ToolResult>>(\n      \"/tools/execute\",\n      {\n        method: \"POST\",\n        body: JSON.stringify(body),\n      }\n    );\n    return res.data;\n  }\n}\n","import type { HornerosSSPConfig } from \"./types\";\nimport { HornerosError, HORNEROS_SDK_ERROR_CODES } from \"./errors\";\nimport { Mcps } from \"./mcps\";\nimport { Connections } from \"./connections\";\nimport { Tools } from \"./tools\";\n\n// ── Helpers ─────────────────────────────────────────────────\n\nfunction getEnvVariable(name: string): string | undefined {\n  if (typeof process !== \"undefined\" && process.env) {\n    return process.env[name];\n  }\n  return undefined;\n}\n\nconst DEFAULT_BASE_URL = \"http://localhost:3000\";\n\nfunction resolveConfig(config?: HornerosSSPConfig) {\n  const baseUrl =\n    config?.baseUrl ||\n    getEnvVariable(\"HORNEROS_BASE_URL\") ||\n    DEFAULT_BASE_URL;\n\n  const apiKey =\n    config?.apiKey ||\n    getEnvVariable(\"HORNEROS_API_KEY\") ||\n    \"\";\n\n  const runtime = config?.runtime || getEnvVariable(\"HORNEROS_RUNTIME\") || \"\";\n\n  return { baseUrl: baseUrl.replace(/\\/+$/, \"\"), apiKey, runtime };\n}\n\n// ── Main client ─────────────────────────────────────────────\n\nexport class HornerosSSP {\n  public readonly mcps: Mcps;\n  public readonly connections: Connections;\n  public readonly tools: Tools;\n\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n  private readonly runtime: string;\n\n  constructor(config?: HornerosSSPConfig) {\n    const resolved = resolveConfig(config);\n\n    if (!resolved.apiKey) {\n      throw new HornerosError(\n        HORNEROS_SDK_ERROR_CODES.COMMON.API_KEY_UNAVAILABLE,\n        \"🔑 API Key is not provided\",\n        401,\n        undefined,\n        \"You need to provide an API key in the constructor or as the environment variable HORNEROS_API_KEY.\",\n        'Provide a valid API key: new HornerosSSP({ apiKey: \"hsp_xxx\" }) or set HORNEROS_API_KEY in your environment.'\n      );\n    }\n\n    this.baseUrl = resolved.baseUrl;\n    this.apiKey = resolved.apiKey;\n    this.runtime = resolved.runtime;\n\n    this.mcps = new Mcps(this);\n    this.connections = new Connections(this);\n    this.tools = new Tools(this);\n  }\n\n  /** @internal */\n  async fetch<T>(\n    path: string,\n    options: RequestInit = {}\n  ): Promise<T> {\n    const url = `${this.baseUrl}/api/v1${path}`;\n\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      \"X-Api-Key\": this.apiKey,\n      \"X-Source\": \"js_sdk\",\n      \"X-Runtime\": this.runtime,\n      ...(options.headers as Record<string, string>),\n    };\n\n    const res = await globalThis.fetch(url, {\n      ...options,\n      headers,\n    });\n\n    if (!res.ok) {\n      let body: unknown;\n      try {\n        body = await res.json();\n      } catch {\n        body = await res.text().catch(() => null);\n      }\n\n      const message =\n        (body && typeof body === \"object\" && \"error\" in body\n          ? (body as { error: string }).error\n          : null) || `HTTP ${res.status}`;\n\n      const errCode =\n        res.status === 404\n          ? HORNEROS_SDK_ERROR_CODES.BACKEND.NOT_FOUND\n          : res.status === 401\n            ? HORNEROS_SDK_ERROR_CODES.BACKEND.UNAUTHORIZED\n            : res.status === 429\n              ? HORNEROS_SDK_ERROR_CODES.BACKEND.RATE_LIMIT\n              : res.status === 400\n                ? HORNEROS_SDK_ERROR_CODES.BACKEND.BAD_REQUEST\n                : res.status >= 500\n                  ? HORNEROS_SDK_ERROR_CODES.BACKEND.SERVER_ERROR\n                  : HORNEROS_SDK_ERROR_CODES.BACKEND.UNKNOWN;\n\n      throw new HornerosError(errCode, message, res.status, body);\n    }\n\n    if (res.status === 204) {\n      return undefined as T;\n    }\n\n    return res.json() as Promise<T>;\n  }\n}\n","import type { ConnectionData } from \"./types\";\n\nexport class AuthScheme {\n  static APIKey(params: { api_key: string; [k: string]: string }): ConnectionData {\n    return { type: \"api_key\", data: params };\n  }\n\n  static Bearer(params: { token: string }): ConnectionData {\n    return { type: \"bearer\", data: params };\n  }\n\n  static Basic(params: { username: string; password: string }): ConnectionData {\n    return { type: \"basic\", data: params };\n  }\n\n  static OAuth2(params: {\n    access_token: string;\n    refresh_token?: string;\n  }): ConnectionData {\n    return {\n      type: \"oauth2\",\n      data: params as Record<string, string>,\n    };\n  }\n\n  static GoogleLogin(): ConnectionData {\n    return { type: \"google_login\", data: {} };\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hornerosssp",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "SDK and CLI for HornerosSSP - integrate MCPs into any app",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",