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

package/src/integrations/snowflakepostgres/index.ts

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

package/src/integrations/snowflakepostgres/types.ts

@@ -5,8 +5,8 @@
  * queries via the `body` and `parameters` proto fields.
  */
 
-import type { z } from 'zod';
-import type { BaseIntegrationClient } from '../../types.js';
+import type { z } from "zod";
+import type { BaseIntegrationClient } from "../../types.js";
 
 /**
  * Snowflake Postgres client for SQL query and execute operations.
@@ -38,7 +38,11 @@ export interface SnowflakePostgresClient extends BaseIntegrationClient {
    * @param params - Optional query parameters for server-side binding
    * @returns Array of validated rows
    */
-  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).

package/src/integrations/stabilityai/README.md

@@ -4,8 +4,8 @@ Generate, edit, and upscale images using Stability AI's image generation models.
 
 ## Methods
 
-| Method | Description |
-| ------ | ----------- |
+| Method                        | Description                                              |
+| ----------------------------- | -------------------------------------------------------- |
 | `apiRequest(options, schema)` | Make any Stability AI API request with schema validation |
 
 ## Usage
@@ -13,7 +13,7 @@ Generate, edit, and upscale images using Stability AI's image generation models.
 ### Generate an Image (Text-to-Image)
 
 ```typescript
-import { api, z } from "@superblocksteam/sdk-api";
+import { api, z, stabilityai } from "@superblocksteam/sdk-api";
 
 // Integration ID from the integrations panel
 const PROD_STABILITY = "a1b2c3d4-5678-90ab-cdef-stabilit0001";
@@ -29,6 +29,9 @@ const GenerationResponseSchema = z.object({
 });
 
 export default api({
+  integrations: {
+    stability: stabilityai(PROD_STABILITY),
+  },
   name: "StabilityAIExample",
   input: z.object({
     prompt: z.string(),
@@ -37,24 +40,22 @@ export default api({
     height: z.number().default(1024),
   }),
   output: z.object({
-    images: z.array(z.object({
-      base64: z.string(),
-      seed: z.number(),
-    })),
+    images: z.array(
+      z.object({
+        base64: z.string(),
+        seed: z.number(),
+      }),
+    ),
   }),
   async run(ctx, { prompt, negativePrompt, width, height }) {
-    const stability = ctx.stabilityai(PROD_STABILITY);
-
-    const result = await stability.apiRequest(
+    const result = await ctx.integrations.stability.apiRequest(
       {
         method: "POST",
         path: "/v1/generation/stable-diffusion-xl-1024-v1-0/text-to-image",
         body: {
           text_prompts: [
             { text: prompt, weight: 1 },
-            ...(negativePrompt
-              ? [{ text: negativePrompt, weight: -1 }]
-              : []),
+            ...(negativePrompt ? [{ text: negativePrompt, weight: -1 }] : []),
           ],
           cfg_scale: 7,
           width: width,
@@ -63,7 +64,7 @@ export default api({
           steps: 30,
         },
       },
-      { response: GenerationResponseSchema }
+      { response: GenerationResponseSchema },
     );
 
     return {
@@ -81,7 +82,7 @@ export default api({
 ### Image-to-Image (Transform Existing Image)
 
 ```typescript
-const result = await stability.apiRequest(
+const result = await ctx.integrations.stability.apiRequest(
   {
     method: "POST",
     path: "/v1/generation/stable-diffusion-xl-1024-v1-0/image-to-image",
@@ -90,16 +91,14 @@ const result = await stability.apiRequest(
     },
     body: {
       init_image: sourceImageBase64,
-      text_prompts: [
-        { text: "A vibrant oil painting style", weight: 1 },
-      ],
+      text_prompts: [{ text: "A vibrant oil painting style", weight: 1 }],
       image_strength: 0.35, // How much to modify (0-1)
       cfg_scale: 7,
       samples: 1,
       steps: 30,
     },
   },
-  { response: GenerationResponseSchema }
+  { response: GenerationResponseSchema },
 );
 ```
 
@@ -112,11 +111,11 @@ const UpscaleResponseSchema = z.object({
       base64: z.string(),
       finishReason: z.string(),
       seed: z.number(),
-    })
+    }),
   ),
 });
 
-const result = await stability.apiRequest(
+const result = await ctx.integrations.stability.apiRequest(
   {
     method: "POST",
     path: "/v1/generation/esrgan-v1-x2plus/image-to-image/upscale",
@@ -128,7 +127,7 @@ const result = await stability.apiRequest(
       width: 2048, // Target width (optional)
     },
   },
-  { response: UpscaleResponseSchema }
+  { response: UpscaleResponseSchema },
 );
 
 const upscaledImage = result.artifacts[0].base64;
@@ -137,7 +136,7 @@ const upscaledImage = result.artifacts[0].base64;
 ### Inpainting (Edit Parts of an Image)
 
 ```typescript
-const result = await stability.apiRequest(
+const result = await ctx.integrations.stability.apiRequest(
   {
     method: "POST",
     path: "/v1/generation/stable-diffusion-xl-1024-v1-0/image-to-image/masking",
@@ -148,22 +147,20 @@ const result = await stability.apiRequest(
       init_image: sourceImageBase64,
       mask_image: maskImageBase64, // White areas will be regenerated
       mask_source: "MASK_IMAGE_WHITE",
-      text_prompts: [
-        { text: "A golden retriever sitting", weight: 1 },
-      ],
+      text_prompts: [{ text: "A golden retriever sitting", weight: 1 }],
       cfg_scale: 7,
       samples: 1,
       steps: 30,
     },
   },
-  { response: GenerationResponseSchema }
+  { response: GenerationResponseSchema },
 );
 ```
 
 ### Generate with Specific Style
 
 ```typescript
-const result = await stability.apiRequest(
+const result = await ctx.integrations.stability.apiRequest(
   {
     method: "POST",
     path: "/v1/generation/stable-diffusion-xl-1024-v1-0/text-to-image",
@@ -182,7 +179,7 @@ const result = await stability.apiRequest(
       seed: 12345, // For reproducibility
     },
   },
-  { response: GenerationResponseSchema }
+  { response: GenerationResponseSchema },
 );
 ```
 
@@ -193,12 +190,12 @@ const BalanceResponseSchema = z.object({
   credits: z.number(),
 });
 
-const result = await stability.apiRequest(
+const result = await ctx.integrations.stability.apiRequest(
   {
     method: "GET",
     path: "/v1/user/balance",
   },
-  { response: BalanceResponseSchema }
+  { response: BalanceResponseSchema },
 );
 
 console.log(`Available credits: ${result.credits}`);
@@ -218,12 +215,12 @@ const ListEnginesResponseSchema = z.object({
   engines: z.array(EngineSchema),
 });
 
-const result = await stability.apiRequest(
+const result = await ctx.integrations.stability.apiRequest(
   {
     method: "GET",
     path: "/v1/engines/list",
   },
-  { response: ListEnginesResponseSchema }
+  { response: ListEnginesResponseSchema },
 );
 
 result.engines.forEach((engine) => {
@@ -241,7 +238,7 @@ await stability.generateImage({ ... });
 await stability.upscale({ ... });
 
 // CORRECT - Use apiRequest
-await stability.apiRequest(
+await ctx.integrations.stability.apiRequest(
   { method: "POST", path: "/v1/generation/stable-diffusion-xl-1024-v1-0/text-to-image", body: { ... } },
   { response: GenerationResponseSchema }
 );
@@ -279,9 +276,7 @@ const body = {
 
 // CORRECT - Array of weighted prompts
 const body = {
-  text_prompts: [
-    { text: "A cat sitting on a couch", weight: 1 },
-  ],
+  text_prompts: [{ text: "A cat sitting on a couch", weight: 1 }],
 };
 
 // Negative prompts use negative weight
@@ -340,7 +335,7 @@ const body = {
 Check finishReason for filtered content:
 
 ```typescript
-const result = await stability.apiRequest(
+const result = await ctx.integrations.stability.apiRequest(
   { method: "POST", path: "/v1/generation/...", body: { ... } },
   { response: GenerationResponseSchema }
 );
@@ -442,7 +437,7 @@ const body = {
 import { RestApiValidationError } from "@superblocksteam/sdk-api";
 
 try {
-  const result = await stability.apiRequest(
+  const result = await ctx.integrations.stability.apiRequest(
     { method: "POST", path: "/v1/generation/...", body: { ... } },
     { response: GenerationResponseSchema }
   );

package/src/integrations/stabilityai/client.ts

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

package/src/integrations/stabilityai/index.ts

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

package/src/integrations/stabilityai/types.ts

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

package/src/integrations/stripe/README.md

@@ -4,8 +4,8 @@ Process payments, manage customers, and interact with Stripe's payment platform.
 
 ## Methods
 
-| Method | Description |
-| ------ | ----------- |
+| Method                        | Description                                        |
+| ----------------------------- | -------------------------------------------------- |
 | `apiRequest(options, schema)` | Make any Stripe API request with schema validation |
 
 ## Usage
@@ -13,7 +13,7 @@ Process payments, manage customers, and interact with Stripe's payment platform.
 ### Create a Customer
 
 ```typescript
-import { api, z } from "@superblocksteam/sdk-api";
+import { api, z, stripe } from "@superblocksteam/sdk-api";
 
 // Integration ID from the integrations panel
 const PROD_STRIPE = "a1b2c3d4-5678-90ab-cdef-stripe000001";
@@ -30,6 +30,9 @@ const CustomerSchema = z.object({
 
 export default api({
   name: "StripeExample",
+  integrations: {
+    stripe: stripe(PROD_STRIPE),
+  },
   input: z.object({
     email: z.string().email(),
     name: z.string(),
@@ -38,9 +41,7 @@ export default api({
     customerId: z.string(),
   }),
   async run(ctx, { email, name }) {
-    const stripe = ctx.stripe(PROD_STRIPE);
-
-    const result = await stripe.apiRequest(
+    const result = await ctx.integrations.stripe.apiRequest(
       {
         method: "POST",
         path: "/v1/customers",
@@ -52,7 +53,7 @@ export default api({
           },
         },
       },
-      { response: CustomerSchema }
+      { response: CustomerSchema },
     );
 
     return { customerId: result.id };
@@ -63,12 +64,12 @@ export default api({
 ### Get a Customer
 
 ```typescript
-const customer = await stripe.apiRequest(
+const customer = await ctx.integrations.stripe.apiRequest(
   {
     method: "GET",
     path: `/v1/customers/${customerId}`,
   },
-  { response: CustomerSchema }
+  { response: CustomerSchema },
 );
 
 console.log(`Customer: ${customer.name} (${customer.email})`);
@@ -88,7 +89,7 @@ const PaymentIntentSchema = z.object({
   metadata: z.record(z.string()),
 });
 
-const paymentIntent = await stripe.apiRequest(
+const paymentIntent = await ctx.integrations.stripe.apiRequest(
   {
     method: "POST",
     path: "/v1/payment_intents",
@@ -104,7 +105,7 @@ const paymentIntent = await stripe.apiRequest(
       },
     },
   },
-  { response: PaymentIntentSchema }
+  { response: PaymentIntentSchema },
 );
 
 // Return client_secret to frontend for Stripe.js
@@ -133,7 +134,7 @@ const ListChargesSchema = z.object({
   url: z.string(),
 });
 
-const charges = await stripe.apiRequest(
+const charges = await ctx.integrations.stripe.apiRequest(
   {
     method: "GET",
     path: "/v1/charges",
@@ -142,7 +143,7 @@ const charges = await stripe.apiRequest(
       limit: 10,
     },
   },
-  { response: ListChargesSchema }
+  { response: ListChargesSchema },
 );
 
 charges.data.forEach((charge) => {
@@ -165,12 +166,12 @@ const SubscriptionSchema = z.object({
       z.object({
         id: z.string(),
         price: z.object({ id: z.string() }),
-      })
+      }),
     ),
   }),
 });
 
-const subscription = await stripe.apiRequest(
+const subscription = await ctx.integrations.stripe.apiRequest(
   {
     method: "POST",
     path: "/v1/subscriptions",
@@ -181,7 +182,7 @@ const subscription = await stripe.apiRequest(
       expand: ["latest_invoice.payment_intent"],
     },
   },
-  { response: SubscriptionSchema }
+  { response: SubscriptionSchema },
 );
 ```
 
@@ -197,7 +198,7 @@ const RefundSchema = z.object({
   created: z.number(),
 });
 
-const refund = await stripe.apiRequest(
+const refund = await ctx.integrations.stripe.apiRequest(
   {
     method: "POST",
     path: "/v1/refunds",
@@ -207,7 +208,7 @@ const refund = await stripe.apiRequest(
       reason: "requested_by_customer",
     },
   },
-  { response: RefundSchema }
+  { response: RefundSchema },
 );
 ```
 
@@ -229,7 +230,7 @@ const ListProductsSchema = z.object({
   has_more: z.boolean(),
 });
 
-const products = await stripe.apiRequest(
+const products = await ctx.integrations.stripe.apiRequest(
   {
     method: "GET",
     path: "/v1/products",
@@ -238,7 +239,7 @@ const products = await stripe.apiRequest(
       limit: 25,
     },
   },
-  { response: ListProductsSchema }
+  { response: ListProductsSchema },
 );
 ```
 
@@ -255,7 +256,7 @@ const InvoiceSchema = z.object({
   hosted_invoice_url: z.string().nullable(),
 });
 
-const invoice = await stripe.apiRequest(
+const invoice = await ctx.integrations.stripe.apiRequest(
   {
     method: "POST",
     path: "/v1/invoices",
@@ -265,11 +266,11 @@ const invoice = await stripe.apiRequest(
       days_until_due: 30,
     },
   },
-  { response: InvoiceSchema }
+  { response: InvoiceSchema },
 );
 
 // Add line items
-await stripe.apiRequest(
+await ctx.integrations.stripe.apiRequest(
   {
     method: "POST",
     path: "/v1/invoiceitems",
@@ -281,16 +282,16 @@ await stripe.apiRequest(
       description: "Consulting services",
     },
   },
-  { response: z.object({ id: z.string() }) }
+  { response: z.object({ id: z.string() }) },
 );
 
 // Finalize and send
-await stripe.apiRequest(
+await ctx.integrations.stripe.apiRequest(
   {
     method: "POST",
     path: `/v1/invoices/${invoice.id}/finalize`,
   },
-  { response: InvoiceSchema }
+  { response: InvoiceSchema },
 );
 ```
 
@@ -304,7 +305,7 @@ await stripe.createCustomer({ ... });
 await stripe.createPaymentIntent({ ... });
 
 // CORRECT - Use apiRequest
-await stripe.apiRequest(
+await ctx.integrations.stripe.apiRequest(
   { method: "POST", path: "/v1/customers", body: { ... } },
   { response: CustomerSchema }
 );
@@ -315,7 +316,7 @@ await stripe.apiRequest(
 Stripe has API versions. Set the header for consistent behavior:
 
 ```typescript
-const result = await stripe.apiRequest(
+const result = await ctx.integrations.stripe.apiRequest(
   {
     method: "POST",
     path: "/v1/customers",
@@ -334,7 +335,7 @@ All amounts are in the smallest currency unit (cents for USD):
 
 ```typescript
 // WRONG - Dollar amount
-const body = { amount: 20.00 }; // $20.00
+const body = { amount: 20.0 }; // $20.00
 
 // CORRECT - Cents
 const body = { amount: 2000 }; // $20.00 = 2000 cents
@@ -360,7 +361,7 @@ const body = {
 For safe retries, use idempotency keys:
 
 ```typescript
-const result = await stripe.apiRequest(
+const result = await ctx.integrations.stripe.apiRequest(
   {
     method: "POST",
     path: "/v1/payment_intents",
@@ -383,7 +384,7 @@ async function getAllCustomers(stripe: StripeClient) {
   let startingAfter: string | undefined;
 
   while (true) {
-    const result = await stripe.apiRequest(
+    const result = await ctx.integrations.stripe.apiRequest(
       {
         method: "GET",
         path: "/v1/customers",
@@ -392,7 +393,7 @@ async function getAllCustomers(stripe: StripeClient) {
           ...(startingAfter && { starting_after: startingAfter }),
         },
       },
-      { response: ListCustomersSchema }
+      { response: ListCustomersSchema },
     );
 
     allCustomers.push(...result.data);
@@ -428,7 +429,7 @@ const metadata = {
 import { RestApiValidationError } from "@superblocksteam/sdk-api";
 
 try {
-  const result = await stripe.apiRequest(
+  const result = await ctx.integrations.stripe.apiRequest(
     { method: "POST", path: "/v1/customers", body: { ... } },
     { response: CustomerSchema }
   );

package/src/integrations/stripe/client.ts

@@ -5,8 +5,8 @@
  * Stripe integrations use the REST API Integration plugin under the hood.
  */
 
-import { RestApiIntegrationClient } from '../base/index.js';
-import type { StripeClient } from './types.js';
+import { RestApiIntegrationClient } from "../base/index.js";
+import type { StripeClient } from "./types.js";
 
 /**
  * Internal implementation of StripeClient.
@@ -16,7 +16,9 @@ import type { StripeClient } from './types.js';
  * Stripe API calls. At runtime, the orchestrator handles authentication
  * and API request execution.
  */
-export class StripeClientImpl extends RestApiIntegrationClient implements StripeClient {
+export class StripeClientImpl
+  extends RestApiIntegrationClient
+  implements StripeClient {
   // Inherits: name, pluginId, config, executeQuery, createParam(), apiRequest()
   // Can add Stripe-specific methods here in the future if needed
 }

package/src/integrations/stripe/index.ts

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

package/src/integrations/stripe/types.ts

@@ -2,8 +2,8 @@
  * Stripe 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";
 
 /**
  * Stripe client for payments and subscriptions.
@@ -15,7 +15,8 @@ import type { SupportsApiRequest } from '../base/index.js';
  * ```typescript
  * import { z } from 'zod';
  *
- * const stripe = ctx.integration('Production Stripe');
+ * // Declare in api(): integrations: { stripe: stripe(INTEGRATION_ID) }
+ * // In run(), access via ctx.integrations.stripe
  *
  * // Define schemas
  * const CustomerSchema = z.object({
@@ -31,7 +32,7 @@ import type { SupportsApiRequest } from '../base/index.js';
  * });
  *
  * // Get a customer
- * const customer = await stripe.apiRequest(
+ * const customer = await ctx.integrations.stripe.apiRequest(
  *   {
  *     method: 'GET',
  *     path: '/v1/customers/cus_123',
@@ -40,7 +41,7 @@ import type { SupportsApiRequest } from '../base/index.js';
  * );
  *
  * // Create a customer
- * const newCustomer = await stripe.apiRequest(
+ * const newCustomer = await ctx.integrations.stripe.apiRequest(
  *   {
  *     method: 'POST',
  *     path: '/v1/customers',
@@ -56,6 +57,7 @@ import type { SupportsApiRequest } from '../base/index.js';
  * );
  * ```
  */
-export interface StripeClient extends BaseIntegrationClient, SupportsApiRequest {
+export interface StripeClient
+  extends BaseIntegrationClient, SupportsApiRequest {
   // apiRequest() method inherited from SupportsApiRequest
 }