@superblocksteam/sdk-api 2.0.93 → 2.0.94-next.1

package/src/integrations/launchdarkly/client.ts

@@ -5,8 +5,8 @@
  * LaunchDarkly integrations use the REST API Integration plugin under the hood.
  */
 
-import { RestApiIntegrationClient } from '../base/index.js';
-import type { LaunchDarklyClient } from './types.js';
+import { RestApiIntegrationClient } from "../base/index.js";
+import type { LaunchDarklyClient } from "./types.js";
 
 /**
  * Internal implementation of LaunchDarklyClient.
@@ -16,6 +16,8 @@ import type { LaunchDarklyClient } from './types.js';
  * LaunchDarkly API calls. At runtime, the orchestrator handles authentication
  * and API request execution.
  */
-export class LaunchDarklyClientImpl extends RestApiIntegrationClient implements LaunchDarklyClient {
+export class LaunchDarklyClientImpl
+  extends RestApiIntegrationClient
+  implements LaunchDarklyClient {
   // Inherits: name, pluginId, config, executeQuery, apiRequest()
 }

package/src/integrations/launchdarkly/index.ts

@@ -1,2 +1,2 @@
-export { LaunchDarklyClientImpl } from './client.js';
-export type { LaunchDarklyClient } from './types.js';
+export { LaunchDarklyClientImpl } from "./client.js";
+export type { LaunchDarklyClient } from "./types.js";

package/src/integrations/launchdarkly/types.ts

@@ -2,8 +2,8 @@
  * LaunchDarkly client types.
  */
 
-import type { BaseIntegrationClient } from '../../types.js';
-import type { SupportsApiRequest } from '../base/index.js';
+import type { BaseIntegrationClient } from "../../types.js";
+import type { SupportsApiRequest } from "../base/index.js";
 
 /**
  * LaunchDarkly client for API interactions.
@@ -13,7 +13,8 @@ import type { SupportsApiRequest } from '../base/index.js';
  *
  * @example
  * ```typescript
- * const launchdarkly = ctx.launchDarkly('My LaunchDarkly');
+ * // Declare in api(): integrations: { launchdarkly: launchdarkly(INTEGRATION_ID) }
+ * // In run(), access via ctx.integrations.launchdarkly
  *
  * // Make API requests
  * const ResponseSchema = z.object({
@@ -29,6 +30,7 @@ import type { SupportsApiRequest } from '../base/index.js';
  * );
  * ```
  */
-export interface LaunchDarklyClient extends BaseIntegrationClient, SupportsApiRequest {
+export interface LaunchDarklyClient
+  extends BaseIntegrationClient, SupportsApiRequest {
   // apiRequest() method inherited from SupportsApiRequest
 }

package/src/integrations/mariadb/README.md

@@ -4,17 +4,17 @@ Execute SQL queries and statements against MariaDB databases with full type safe
 
 ## Methods
 
-| Method | Description |
-| ------ | ----------- |
-| `query<T>(sql, schema, params?)` | Execute a SELECT query and return validated, typed results |
-| `execute(sql, params?)` | Execute a statement (INSERT, UPDATE, DELETE) and return affected row count |
+| Method                           | Description                                                                |
+| -------------------------------- | -------------------------------------------------------------------------- |
+| `query<T>(sql, schema, params?)` | Execute a SELECT query and return validated, typed results                 |
+| `execute(sql, params?)`          | Execute a statement (INSERT, UPDATE, DELETE) and return affected row count |
 
 ## Usage
 
 ### Basic Query with Schema Validation
 
 ```typescript
-import { api, z } from "@superblocksteam/sdk-api";
+import { api, z, mariadb } from "@superblocksteam/sdk-api";
 
 // Integration ID from the integrations panel
 const PROD_MARIADB = "a1b2c3d4-5678-90ab-cdef-mariadb00001";
@@ -27,6 +27,9 @@ const UserSchema = z.object({
 });
 
 export default api({
+  integrations: {
+    mariadb: mariadb(PROD_MARIADB),
+  },
   name: "MariaDBExample",
   input: z.object({
     status: z.string(),
@@ -35,12 +38,10 @@ export default api({
     users: z.array(UserSchema),
   }),
   async run(ctx, { status }) {
-    const mariadb = ctx.mariadb(PROD_MARIADB);
-
-    const users = await mariadb.query(
+    const users = await ctx.integrations.mariadb.query(
       "SELECT id, name, email, created_at FROM users WHERE status = $1",
       UserSchema,
-      [status]
+      [status],
     );
 
     return { users };
@@ -51,24 +52,22 @@ export default api({
 ### Executing INSERT, UPDATE, DELETE Statements
 
 ```typescript
-const mariadb = ctx.mariadb(PROD_MARIADB);
-
 // INSERT
-await mariadb.execute(
+await ctx.integrations.mariadb.execute(
   "INSERT INTO users (name, email) VALUES ($1, $2)",
-  ["John Doe", "john@example.com"]
+  ["John Doe", "john@example.com"],
 );
 
 // UPDATE
-const updateResult = await mariadb.execute(
+const updateResult = await ctx.integrations.mariadb.execute(
   "UPDATE users SET last_login = NOW() WHERE id = $1",
-  [userId]
+  [userId],
 );
 console.log(`Updated ${updateResult.rowCount} rows`);
 
 // DELETE
-const deleteResult = await mariadb.execute(
-  "DELETE FROM sessions WHERE expires_at < NOW()"
+const deleteResult = await ctx.integrations.mariadb.execute(
+  "DELETE FROM sessions WHERE expires_at < NOW()",
 );
 console.log(`Deleted ${deleteResult.rowCount} expired sessions`);
 ```
@@ -90,7 +89,10 @@ const schema = z.object({
 
 ```typescript
 // CORRECT - Schema is required
-const users = await mariadb.query("SELECT * FROM users", UserSchema);
+const users = await ctx.integrations.mariadb.query(
+  "SELECT * FROM users",
+  UserSchema,
+);
 ```
 
 ### NULL Handling
@@ -108,7 +110,10 @@ const schema = z.object({
 import { QueryValidationError } from "@superblocksteam/sdk-api";
 
 try {
-  const users = await mariadb.query("SELECT * FROM users", UserSchema);
+  const users = await ctx.integrations.mariadb.query(
+    "SELECT * FROM users",
+    UserSchema,
+  );
 } catch (error) {
   if (error instanceof QueryValidationError) {
     console.error("Row index:", error.details.rowIndex);

package/src/integrations/mariadb/client.ts

@@ -5,15 +5,15 @@
  * runtime validation using Zod schemas.
  */
 
-import type { z } from 'zod';
-import type { PartialMessage } from '@bufbuild/protobuf';
-import type { Plugin as MariaDBPlugin } from '@superblocksteam/types/dist/src/plugins/mariadb/v1/plugin_pb';
-import type { IntegrationConfig, IntegrationClientImpl } from '../types.js';
-import type { QueryExecutor } from '../registry.js';
-import { QueryValidationError } from '../../errors.js';
-import { IntegrationError } from '../../runtime/errors.js';
-import { describeType } from '../utils.js';
-import type { MariaDBClient } from './types.js';
+import type { z } from "zod";
+import type { PartialMessage } from "@bufbuild/protobuf";
+import type { Plugin as MariaDBPlugin } from "@superblocksteam/types/dist/src/plugins/mariadb/v1/plugin_pb";
+import type { IntegrationConfig, IntegrationClientImpl } from "../types.js";
+import type { QueryExecutor } from "../registry.js";
+import { QueryValidationError } from "../../errors.js";
+import { IntegrationError } from "../../runtime/errors.js";
+import { describeType } from "../utils.js";
+import type { MariaDBClient } from "./types.js";
 
 /**
  * Internal implementation of the MariaDB client.
@@ -71,7 +71,7 @@ export class MariaDBClientImpl implements MariaDBClient, IntegrationClientImpl {
       if (!Array.isArray(result)) {
         throw new IntegrationError(
           this.config.name,
-          'query',
+          "query",
           `Expected array result from MariaDB query, got: ${describeType(result)}`,
         );
       }
@@ -107,27 +107,30 @@ export class MariaDBClientImpl implements MariaDBClient, IntegrationClientImpl {
         throw error;
       }
 
-      throw new IntegrationError(this.config.name, 'query', error);
+      throw new IntegrationError(this.config.name, "query", error);
     }
   }
 
-  async execute(sql: string, params?: unknown[]): Promise<{ rowCount: number }> {
+  async execute(
+    sql: string,
+    params?: unknown[],
+  ): Promise<{ rowCount: number }> {
     const request = this.buildRequest(sql, params);
 
     try {
       const result = await this.executeQuery(request);
 
       if (
-        typeof result === 'object' &&
+        typeof result === "object" &&
         result !== null &&
-        'rowCount' in result
+        "rowCount" in result
       ) {
         return { rowCount: Number(result.rowCount) || 0 };
       }
 
       return { rowCount: 0 };
     } catch (error) {
-      throw new IntegrationError(this.config.name, 'execute', error);
+      throw new IntegrationError(this.config.name, "execute", error);
     }
   }
 }

package/src/integrations/mariadb/index.ts

@@ -4,5 +4,5 @@
  * @module
  */
 
-export type { MariaDBClient } from './types.js';
-export { MariaDBClientImpl } from './client.js';
+export type { MariaDBClient } from "./types.js";
+export { MariaDBClientImpl } from "./client.js";

package/src/integrations/mariadb/types.ts

@@ -4,15 +4,16 @@
  * Provides typed methods for executing MariaDB queries with runtime validation.
  */
 
-import type { z } from 'zod';
-import type { BaseIntegrationClient } from '../../types.js';
+import type { z } from "zod";
+import type { BaseIntegrationClient } from "../../types.js";
 
 /**
  * Client for executing MariaDB queries with type-safe validation.
  *
  * @example
  * ```typescript
- * const mariadb = ctx.mariadb('Production MariaDB');
+ * // Declare in api(): integrations: { mariadb: mariadb(INTEGRATION_ID) }
+ * // In run(), access via ctx.integrations.mariadb
  *
  * // Query with validation
  * const UserSchema = z.object({
@@ -40,7 +41,11 @@ export interface MariaDBClient extends BaseIntegrationClient {
    * @throws {QueryValidationError} If results don't match schema
    * @throws {IntegrationError} If query execution fails
    */
-  query<T>(sql: string, schema: z.ZodSchema<T>, params?: unknown[]): Promise<T[]>;
+  query<T>(
+    sql: string,
+    schema: z.ZodSchema<T>,
+    params?: unknown[],
+  ): Promise<T[]>;
 
   /**
    * Execute a SQL statement (INSERT, UPDATE, DELETE) without output validation.

package/src/integrations/mistral/README.md

@@ -4,8 +4,8 @@ Interact with Mistral AI's APIs for chat completions, embeddings, and code gener
 
 ## Methods
 
-| Method | Description |
-| ------ | ----------- |
+| Method                        | Description                                         |
+| ----------------------------- | --------------------------------------------------- |
 | `apiRequest(options, schema)` | Make any Mistral API request with schema validation |
 
 ## Usage
@@ -13,7 +13,7 @@ Interact with Mistral AI's APIs for chat completions, embeddings, and code gener
 ### Chat Completion
 
 ```typescript
-import { api, z } from "@superblocksteam/sdk-api";
+import { api, z, mistral } from "@superblocksteam/sdk-api";
 
 // Integration ID from the integrations panel
 const PROD_MISTRAL = "a1b2c3d4-5678-90ab-cdef-mistral00001";
@@ -31,7 +31,7 @@ const ChatCompletionResponseSchema = z.object({
         content: z.string(),
       }),
       finish_reason: z.string(),
-    })
+    }),
   ),
   usage: z.object({
     prompt_tokens: z.number(),
@@ -41,6 +41,9 @@ const ChatCompletionResponseSchema = z.object({
 });
 
 export default api({
+  integrations: {
+    mistral: mistral(PROD_MISTRAL),
+  },
   name: "MistralExample",
   input: z.object({
     prompt: z.string(),
@@ -49,9 +52,7 @@ export default api({
     response: z.string(),
   }),
   async run(ctx, { prompt }) {
-    const mistral = ctx.mistral(PROD_MISTRAL);
-
-    const result = await mistral.apiRequest(
+    const result = await ctx.integrations.mistral.apiRequest(
       {
         method: "POST",
         path: "/v1/chat/completions",
@@ -60,7 +61,7 @@ export default api({
           messages: [{ role: "user", content: prompt }],
         },
       },
-      { response: ChatCompletionResponseSchema }
+      { response: ChatCompletionResponseSchema },
     );
 
     return { response: result.choices[0]?.message.content ?? "" };
@@ -72,7 +73,7 @@ export default api({
 
 ```typescript
 // Mistral Large - Most capable
-const large = await mistral.apiRequest(
+const large = await ctx.integrations.mistral.apiRequest(
   {
     method: "POST",
     path: "/v1/chat/completions",
@@ -81,11 +82,11 @@ const large = await mistral.apiRequest(
       messages: [{ role: "user", content: "Complex analysis..." }],
     },
   },
-  { response: ChatCompletionResponseSchema }
+  { response: ChatCompletionResponseSchema },
 );
 
 // Mistral Medium - Balanced
-const medium = await mistral.apiRequest(
+const medium = await ctx.integrations.mistral.apiRequest(
   {
     method: "POST",
     path: "/v1/chat/completions",
@@ -94,11 +95,11 @@ const medium = await mistral.apiRequest(
       messages: [{ role: "user", content: "General task..." }],
     },
   },
-  { response: ChatCompletionResponseSchema }
+  { response: ChatCompletionResponseSchema },
 );
 
 // Mistral Small - Fast and efficient
-const small = await mistral.apiRequest(
+const small = await ctx.integrations.mistral.apiRequest(
   {
     method: "POST",
     path: "/v1/chat/completions",
@@ -107,11 +108,11 @@ const small = await mistral.apiRequest(
       messages: [{ role: "user", content: "Simple task..." }],
     },
   },
-  { response: ChatCompletionResponseSchema }
+  { response: ChatCompletionResponseSchema },
 );
 
 // Codestral - Optimized for code
-const codestral = await mistral.apiRequest(
+const codestral = await ctx.integrations.mistral.apiRequest(
   {
     method: "POST",
     path: "/v1/chat/completions",
@@ -120,7 +121,7 @@ const codestral = await mistral.apiRequest(
       messages: [{ role: "user", content: "Write a function to..." }],
     },
   },
-  { response: ChatCompletionResponseSchema }
+  { response: ChatCompletionResponseSchema },
 );
 ```
 
@@ -135,7 +136,7 @@ const EmbeddingsResponseSchema = z.object({
       object: z.string(),
       embedding: z.array(z.number()),
       index: z.number(),
-    })
+    }),
   ),
   model: z.string(),
   usage: z.object({
@@ -144,7 +145,7 @@ const EmbeddingsResponseSchema = z.object({
   }),
 });
 
-const result = await mistral.apiRequest(
+const result = await ctx.integrations.mistral.apiRequest(
   {
     method: "POST",
     path: "/v1/embeddings",
@@ -153,7 +154,7 @@ const result = await mistral.apiRequest(
       input: ["Hello world", "Bonjour le monde"],
     },
   },
-  { response: EmbeddingsResponseSchema }
+  { response: EmbeddingsResponseSchema },
 );
 
 result.data.forEach((item, i) => {
@@ -180,24 +181,22 @@ const FunctionCallResponseSchema = z.object({
                 name: z.string(),
                 arguments: z.string(),
               }),
-            })
+            }),
           )
           .optional(),
       }),
       finish_reason: z.string(),
-    })
+    }),
   ),
 });
 
-const result = await mistral.apiRequest(
+const result = await ctx.integrations.mistral.apiRequest(
   {
     method: "POST",
     path: "/v1/chat/completions",
     body: {
       model: "mistral-large-latest",
-      messages: [
-        { role: "user", content: "What's the weather in London?" },
-      ],
+      messages: [{ role: "user", content: "What's the weather in London?" }],
       tools: [
         {
           type: "function",
@@ -218,14 +217,14 @@ const result = await mistral.apiRequest(
       tool_choice: "auto",
     },
   },
-  { response: FunctionCallResponseSchema }
+  { response: FunctionCallResponseSchema },
 );
 ```
 
 ### JSON Mode
 
 ```typescript
-const result = await mistral.apiRequest(
+const result = await ctx.integrations.mistral.apiRequest(
   {
     method: "POST",
     path: "/v1/chat/completions",
@@ -240,7 +239,7 @@ const result = await mistral.apiRequest(
       response_format: { type: "json_object" },
     },
   },
-  { response: ChatCompletionResponseSchema }
+  { response: ChatCompletionResponseSchema },
 );
 
 const data = JSON.parse(result.choices[0]?.message.content ?? "{}");
@@ -256,7 +255,7 @@ await mistral.chat({ ... });
 await mistral.embed({ ... });
 
 // CORRECT - Use apiRequest
-await mistral.apiRequest(
+await ctx.integrations.mistral.apiRequest(
   { method: "POST", path: "/v1/chat/completions", body: { ... } },
   { response: ChatCompletionResponseSchema }
 );
@@ -282,7 +281,7 @@ const models = [
 Mistral has a safe mode for content moderation:
 
 ```typescript
-const result = await mistral.apiRequest(
+const result = await ctx.integrations.mistral.apiRequest(
   {
     method: "POST",
     path: "/v1/chat/completions",
@@ -292,7 +291,7 @@ const result = await mistral.apiRequest(
       safe_prompt: true, // Enable safety guardrails
     },
   },
-  { response: ChatCompletionResponseSchema }
+  { response: ChatCompletionResponseSchema },
 );
 ```
 
@@ -301,7 +300,7 @@ const result = await mistral.apiRequest(
 Mistral supports system messages:
 
 ```typescript
-const result = await mistral.apiRequest(
+const result = await ctx.integrations.mistral.apiRequest(
   {
     method: "POST",
     path: "/v1/chat/completions",
@@ -313,7 +312,7 @@ const result = await mistral.apiRequest(
       ],
     },
   },
-  { response: ChatCompletionResponseSchema }
+  { response: ChatCompletionResponseSchema },
 );
 ```
 
@@ -323,7 +322,7 @@ const result = await mistral.apiRequest(
 import { RestApiValidationError } from "@superblocksteam/sdk-api";
 
 try {
-  const result = await mistral.apiRequest(
+  const result = await ctx.integrations.mistral.apiRequest(
     { method: "POST", path: "/v1/chat/completions", body: { ... } },
     { response: ChatCompletionResponseSchema }
   );

package/src/integrations/mistral/client.ts

@@ -5,8 +5,8 @@
  * Mistral integrations use the REST API Integration plugin under the hood.
  */
 
-import { RestApiIntegrationClient } from '../base/index.js';
-import type { MistralClient } from './types.js';
+import { RestApiIntegrationClient } from "../base/index.js";
+import type { MistralClient } from "./types.js";
 
 /**
  * Internal implementation of MistralClient.
@@ -16,6 +16,8 @@ import type { MistralClient } from './types.js';
  * Mistral API calls. At runtime, the orchestrator handles authentication
  * and API request execution.
  */
-export class MistralClientImpl extends RestApiIntegrationClient implements MistralClient {
+export class MistralClientImpl
+  extends RestApiIntegrationClient
+  implements MistralClient {
   // Inherits: name, pluginId, config, executeQuery, apiRequest()
 }

package/src/integrations/mistral/index.ts

@@ -1,2 +1,2 @@
-export { MistralClientImpl } from './client.js';
-export type { MistralClient } from './types.js';
+export { MistralClientImpl } from "./client.js";
+export type { MistralClient } from "./types.js";

package/src/integrations/mistral/types.ts

@@ -2,8 +2,8 @@
  * Mistral client types.
  */
 
-import type { BaseIntegrationClient } from '../../types.js';
-import type { SupportsApiRequest } from '../base/index.js';
+import type { BaseIntegrationClient } from "../../types.js";
+import type { SupportsApiRequest } from "../base/index.js";
 
 /**
  * Mistral client for API interactions.
@@ -13,7 +13,8 @@ import type { SupportsApiRequest } from '../base/index.js';
  *
  * @example
  * ```typescript
- * const mistral = ctx.mistral('My Mistral');
+ * // Declare in api(): integrations: { mistral: mistral(INTEGRATION_ID) }
+ * // In run(), access via ctx.integrations.mistral
  *
  * // Make API requests
  * const ResponseSchema = z.object({
@@ -29,6 +30,7 @@ import type { SupportsApiRequest } from '../base/index.js';
  * );
  * ```
  */
-export interface MistralClient extends BaseIntegrationClient, SupportsApiRequest {
+export interface MistralClient
+  extends BaseIntegrationClient, SupportsApiRequest {
   // apiRequest() method inherited from SupportsApiRequest
 }