@happyrobot-ai/sdk 0.1.12 → 0.1.14

package/README.md

@@ -543,6 +543,8 @@ await client.mcp.refresh("mcp-id");
 | `create(body)`   | POST | `/mcp`             | Register a new MCP server           |
 | `refresh(mcpId)` | POST | `/mcp/:id/refresh` | Re-discover tools for an MCP server |
 
+**OAuth2 (`auth_type: "oauth2"`)**: set `oauth2_credential_id` to the UUID of an **OAuth 2.0** integration credential (same org) configured with your provider’s token URL. Do not send `auth_token`; the API fetches a short-lived access token when creating, listing refresh, or when workflows run.
+
 ---
 
 ## `client.billing`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyrobot-ai/sdk",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "TypeScript SDK for the HappyRobot Public API",
   "main": "./index.js",
   "module": "./index.mjs",

package/resources/integrations.d.ts

@@ -2,8 +2,9 @@
  * Integrations resource — client.integrations.*
  *
  * Maps to:
- *   GET  /integrations
- *   GET  /integrations/:integrationId
+ *   GET  /integrations                  — list integrations (paginated, filterable by category/provider)
+ *   GET  /integrations/categories       — category → providers map
+ *   GET  /integrations/:integrationId   — get single integration (supports composite IDs for delegated providers)
  *   POST /integrations/:integrationId/create-credential
  *
  * Integration-specific resources:
@@ -23,7 +24,7 @@
  *   GET /integrations/whatsapp/message-templates
  */
 import type { HttpClient } from "../core/http";
-import type { ListIntegrationsQuery, ListIntegrationsResponse, Integration, CreateCredentialBody, CreateCredentialResponse, CredentialIdQuery, GoogleSheetsWorksheetsQuery, GoogleSheetsColumnsQuery, GoogleSheetsRowsQuery, TeamsChannelsQuery, WhatsAppCredentialQuery, WhatsAppBusinessAccountsQuery, WhatsAppPhoneNumbersQuery, WhatsAppMessageTemplatesQuery, ResourceListResponse, ResourceListWithDescriptionResponse, WhatsAppTemplateListResponse } from "../types/integrations.types";
+import type { ListIntegrationsQuery, ListIntegrationsResponse, Integration, CreateCredentialBody, CreateCredentialResponse, CategoriesResponse, CredentialIdQuery, GoogleSheetsWorksheetsQuery, GoogleSheetsColumnsQuery, GoogleSheetsRowsQuery, TeamsChannelsQuery, WhatsAppCredentialQuery, WhatsAppBusinessAccountsQuery, WhatsAppPhoneNumbersQuery, WhatsAppMessageTemplatesQuery, ResourceListResponse, ResourceListWithDescriptionResponse, WhatsAppTemplateListResponse } from "../types/integrations.types";
 declare class GoogleSheetsResource {
     private readonly http;
     constructor(http: HttpClient);
@@ -91,5 +92,11 @@ export declare class IntegrationsResource {
     get(integrationId: string): Promise<Integration>;
     /** Create a credential for a form-based integration. */
     createCredential(integrationId: string, body: CreateCredentialBody): Promise<CreateCredentialResponse>;
+    /**
+     * List all categories with their providers.
+     * Returns a unified map of categories (internal groups + delegated categories)
+     * to the providers available in each.
+     */
+    categories(): Promise<CategoriesResponse>;
 }
 export {};

package/resources/integrations.js

@@ -3,8 +3,9 @@
  * Integrations resource — client.integrations.*
  *
  * Maps to:
- *   GET  /integrations
- *   GET  /integrations/:integrationId
+ *   GET  /integrations                  — list integrations (paginated, filterable by category/provider)
+ *   GET  /integrations/categories       — category → providers map
+ *   GET  /integrations/:integrationId   — get single integration (supports composite IDs for delegated providers)
  *   POST /integrations/:integrationId/create-credential
  *
  * Integration-specific resources:
@@ -212,6 +213,17 @@ class IntegrationsResource {
             body,
         });
     }
+    /**
+     * List all categories with their providers.
+     * Returns a unified map of categories (internal groups + delegated categories)
+     * to the providers available in each.
+     */
+    async categories() {
+        return this.http.request({
+            method: "GET",
+            path: "/integrations/categories",
+        });
+    }
 }
 exports.IntegrationsResource = IntegrationsResource;
 function enc(s) {

package/types/integrations.types.d.ts

@@ -3,7 +3,7 @@
  */
 import type { z } from "zod";
 import type { ResourceListResponseSchema, ResourceListWithDescriptionResponseSchema, WhatsAppTemplateListResponseSchema } from "../../routes/integrations/resources-schemas";
-import type { IntegrationSchema, EventSchema, CredentialSchema, ListIntegrationsQuerySchema, ListIntegrationsResponseSchema, CreateCredentialBodySchema, CreateCredentialResponseSchema } from "../../routes/integrations/schemas";
+import type { IntegrationSchema, EventSchema, CredentialSchema, ListIntegrationsQuerySchema, ListIntegrationsResponseSchema, CreateCredentialBodySchema, CreateCredentialResponseSchema, CategoriesResponseSchema, PaginationMetaSchema } from "../../routes/integrations/schemas";
 export type Integration = z.infer<typeof IntegrationSchema>;
 export type IntegrationEvent = z.infer<typeof EventSchema>;
 export type Credential = z.infer<typeof CredentialSchema>;
@@ -11,6 +11,8 @@ export type ListIntegrationsQuery = z.input<typeof ListIntegrationsQuerySchema>;
 export type ListIntegrationsResponse = z.infer<typeof ListIntegrationsResponseSchema>;
 export type CreateCredentialBody = z.infer<typeof CreateCredentialBodySchema>;
 export type CreateCredentialResponse = z.infer<typeof CreateCredentialResponseSchema>;
+export type PaginationMeta = z.infer<typeof PaginationMetaSchema>;
+export type CategoriesResponse = z.infer<typeof CategoriesResponseSchema>;
 export type ResourceListResponse = z.infer<typeof ResourceListResponseSchema>;
 export type ResourceListWithDescriptionResponse = z.infer<typeof ResourceListWithDescriptionResponseSchema>;
 export type WhatsAppTemplateListResponse = z.infer<typeof WhatsAppTemplateListResponseSchema>;