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

package/src/integrations/gcs/client.ts

@@ -4,19 +4,19 @@
  * Uses the native GCS plugin type from @superblocksteam/types.
  */
 
-import type { z } from 'zod';
-import type { PartialMessage } from '@bufbuild/protobuf';
-import type { Plugin as GCSPlugin } from '@superblocksteam/types/dist/src/plugins/gcs/v1/plugin_pb';
-import type { IntegrationConfig, IntegrationClientImpl } from '../types.js';
-import type { QueryExecutor } from '../registry.js';
-import { RestApiValidationError } from '../../errors.js';
-import { IntegrationError } from '../../runtime/errors.js';
+import type { z } from "zod";
+import type { PartialMessage } from "@bufbuild/protobuf";
+import type { Plugin as GCSPlugin } from "@superblocksteam/types/dist/src/plugins/gcs/v1/plugin_pb";
+import type { IntegrationConfig, IntegrationClientImpl } from "../types.js";
+import type { QueryExecutor } from "../registry.js";
+import { RestApiValidationError } from "../../errors.js";
+import { IntegrationError } from "../../runtime/errors.js";
 import type {
   GCSClient,
   GCSAction,
   GCSListObjectsOptions,
   GCSGetObjectOptions,
-} from './types.js';
+} from "./types.js";
 
 /**
  * Internal implementation of GCSClient.
@@ -98,9 +98,9 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
   }
 
   async listBuckets<T>(schema: z.ZodSchema<T>): Promise<T> {
-    return this.withErrorHandling('listBuckets', async () => {
-      const result = await this.execute('LIST_BUCKETS', {});
-      return this.validate(result, schema, 'listBuckets');
+    return this.withErrorHandling("listBuckets", async () => {
+      const result = await this.execute("LIST_BUCKETS", {});
+      return this.validate(result, schema, "listBuckets");
     });
   }
 
@@ -109,7 +109,7 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
     schema: z.ZodSchema<T>,
     options?: GCSListObjectsOptions,
   ): Promise<T> {
-    return this.withErrorHandling('listObjects', async () => {
+    return this.withErrorHandling("listObjects", async () => {
       const request: PartialMessage<GCSPlugin> = {
         resource: bucket,
       };
@@ -118,8 +118,8 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
         request.prefix = options.prefix;
       }
 
-      const result = await this.execute('LIST_BUCKET_OBJECTS', request);
-      return this.validate(result, schema, 'listObjects');
+      const result = await this.execute("LIST_BUCKET_OBJECTS", request);
+      return this.validate(result, schema, "listObjects");
     });
   }
 
@@ -129,7 +129,7 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
     schema: z.ZodSchema<T>,
     options?: GCSGetObjectOptions,
   ): Promise<T> {
-    return this.withErrorHandling('getObject', async () => {
+    return this.withErrorHandling("getObject", async () => {
       const request: PartialMessage<GCSPlugin> = {
         resource: bucket,
         path,
@@ -139,14 +139,14 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
         request.responseType = options.responseType;
       }
 
-      const result = await this.execute('GET_OBJECT', request);
-      return this.validate(result, schema, 'getObject');
+      const result = await this.execute("GET_OBJECT", request);
+      return this.validate(result, schema, "getObject");
     });
   }
 
   async deleteObject(bucket: string, path: string): Promise<void> {
-    return this.withErrorHandling('deleteObject', async () => {
-      await this.execute('DELETE_OBJECT', {
+    return this.withErrorHandling("deleteObject", async () => {
+      await this.execute("DELETE_OBJECT", {
         resource: bucket,
         path,
       });
@@ -158,8 +158,8 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
     path: string,
     body: string,
   ): Promise<void> {
-    return this.withErrorHandling('uploadObject', async () => {
-      await this.execute('UPLOAD_OBJECT', {
+    return this.withErrorHandling("uploadObject", async () => {
+      await this.execute("UPLOAD_OBJECT", {
         resource: bucket,
         path,
         body,
@@ -171,8 +171,8 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
     bucket: string,
     fileObjects: string,
   ): Promise<void> {
-    return this.withErrorHandling('uploadMultipleObjects', async () => {
-      await this.execute('UPLOAD_MULTIPLE_OBJECTS', {
+    return this.withErrorHandling("uploadMultipleObjects", async () => {
+      await this.execute("UPLOAD_MULTIPLE_OBJECTS", {
         resource: bucket,
         fileObjects,
       });
@@ -184,12 +184,12 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
     path: string,
     schema: z.ZodSchema<T>,
   ): Promise<T> {
-    return this.withErrorHandling('generateSignedUrl', async () => {
-      const result = await this.execute('GENERATE_PRESIGNED_URL', {
+    return this.withErrorHandling("generateSignedUrl", async () => {
+      const result = await this.execute("GENERATE_PRESIGNED_URL", {
         resource: bucket,
         path,
       });
-      return this.validate(result, schema, 'generateSignedUrl');
+      return this.validate(result, schema, "generateSignedUrl");
     });
   }
 }

package/src/integrations/gcs/index.ts

@@ -9,5 +9,5 @@ export type {
   GCSAction,
   GCSListObjectsOptions,
   GCSGetObjectOptions,
-} from './types.js';
-export { GCSClientImpl } from './client.js';
+} from "./types.js";
+export { GCSClientImpl } from "./client.js";

package/src/integrations/gcs/types.ts

@@ -2,21 +2,21 @@
  * GCS (Google Cloud Storage) client types.
  */
 
-import type { z } from 'zod';
-import type { BaseIntegrationClient } from '../../types.js';
+import type { z } from "zod";
+import type { BaseIntegrationClient } from "../../types.js";
 
 /**
  * GCS action types (used internally by the client).
  */
 export type GCSAction =
-  | 'LIST_OBJECTS'
-  | 'LIST_BUCKET_OBJECTS'
-  | 'GET_OBJECT'
-  | 'DELETE_OBJECT'
-  | 'UPLOAD_OBJECT'
-  | 'LIST_BUCKETS'
-  | 'UPLOAD_MULTIPLE_OBJECTS'
-  | 'GENERATE_PRESIGNED_URL';
+  | "LIST_OBJECTS"
+  | "LIST_BUCKET_OBJECTS"
+  | "GET_OBJECT"
+  | "DELETE_OBJECT"
+  | "UPLOAD_OBJECT"
+  | "LIST_BUCKETS"
+  | "UPLOAD_MULTIPLE_OBJECTS"
+  | "GENERATE_PRESIGNED_URL";
 
 /**
  * Options for listing objects in a bucket.
@@ -127,10 +127,7 @@ export interface GCSClient extends BaseIntegrationClient {
    * @param bucket - Bucket name
    * @param fileObjects - Serialized file objects
    */
-  uploadMultipleObjects(
-    bucket: string,
-    fileObjects: string,
-  ): Promise<void>;
+  uploadMultipleObjects(bucket: string, fileObjects: string): Promise<void>;
 
   /**
    * Generate a signed URL for an object.

package/src/integrations/gemini/README.md

@@ -4,8 +4,8 @@ Interact with Google's Gemini API for multimodal AI capabilities including text,
 
 ## Methods
 
-| Method | Description |
-| ------ | ----------- |
+| Method                        | Description                                        |
+| ----------------------------- | -------------------------------------------------- |
 | `apiRequest(options, schema)` | Make any Gemini API request with schema validation |
 
 ## Usage
@@ -13,7 +13,7 @@ Interact with Google's Gemini API for multimodal AI capabilities including text,
 ### Generate Content (Text)
 
 ```typescript
-import { api, z } from "@superblocksteam/sdk-api";
+import { api, z, gemini } from "@superblocksteam/sdk-api";
 
 // Integration ID from the integrations panel
 const PROD_GEMINI = "a1b2c3d4-5678-90ab-cdef-gemini000001";
@@ -25,7 +25,7 @@ const GenerateContentResponseSchema = z.object({
         parts: z.array(
           z.object({
             text: z.string(),
-          })
+          }),
         ),
         role: z.string(),
       }),
@@ -35,10 +35,10 @@ const GenerateContentResponseSchema = z.object({
           z.object({
             category: z.string(),
             probability: z.string(),
-          })
+          }),
         )
         .optional(),
-    })
+    }),
   ),
   usageMetadata: z.object({
     promptTokenCount: z.number(),
@@ -48,6 +48,9 @@ const GenerateContentResponseSchema = z.object({
 });
 
 export default api({
+  integrations: {
+    gemini: gemini(PROD_GEMINI),
+  },
   name: "GeminiExample",
   input: z.object({
     prompt: z.string(),
@@ -56,9 +59,7 @@ export default api({
     response: z.string(),
   }),
   async run(ctx, { prompt }) {
-    const gemini = ctx.gemini(PROD_GEMINI);
-
-    const result = await gemini.apiRequest(
+    const result = await ctx.integrations.gemini.apiRequest(
       {
         method: "POST",
         path: "/v1/models/gemini-1.5-pro:generateContent",
@@ -70,7 +71,7 @@ export default api({
           ],
         },
       },
-      { response: GenerateContentResponseSchema }
+      { response: GenerateContentResponseSchema },
     );
 
     const text = result.candidates[0]?.content.parts[0]?.text ?? "";
@@ -82,7 +83,7 @@ export default api({
 ### Multimodal (Image + Text)
 
 ```typescript
-const result = await gemini.apiRequest(
+const result = await ctx.integrations.gemini.apiRequest(
   {
     method: "POST",
     path: "/v1/models/gemini-1.5-pro:generateContent",
@@ -104,14 +105,14 @@ const result = await gemini.apiRequest(
       ],
     },
   },
-  { response: GenerateContentResponseSchema }
+  { response: GenerateContentResponseSchema },
 );
 ```
 
 ### Multi-turn Conversation
 
 ```typescript
-const result = await gemini.apiRequest(
+const result = await ctx.integrations.gemini.apiRequest(
   {
     method: "POST",
     path: "/v1/models/gemini-1.5-pro:generateContent",
@@ -123,7 +124,9 @@ const result = await gemini.apiRequest(
         },
         {
           role: "model",
-          parts: [{ text: "I'm Gemini, a large language model created by Google." }],
+          parts: [
+            { text: "I'm Gemini, a large language model created by Google." },
+          ],
         },
         {
           role: "user",
@@ -132,7 +135,7 @@ const result = await gemini.apiRequest(
       ],
     },
   },
-  { response: GenerateContentResponseSchema }
+  { response: GenerateContentResponseSchema },
 );
 ```
 
@@ -152,15 +155,15 @@ const FunctionCallResponseSchema = z.object({
                 args: z.record(z.unknown()),
               }),
             }),
-          ])
+          ]),
         ),
         role: z.string(),
       }),
-    })
+    }),
   ),
 });
 
-const result = await gemini.apiRequest(
+const result = await ctx.integrations.gemini.apiRequest(
   {
     method: "POST",
     path: "/v1/models/gemini-1.5-pro:generateContent",
@@ -192,14 +195,14 @@ const result = await gemini.apiRequest(
       ],
     },
   },
-  { response: FunctionCallResponseSchema }
+  { response: FunctionCallResponseSchema },
 );
 ```
 
 ### Generate with Safety Settings
 
 ```typescript
-const result = await gemini.apiRequest(
+const result = await ctx.integrations.gemini.apiRequest(
   {
     method: "POST",
     path: "/v1/models/gemini-1.5-pro:generateContent",
@@ -227,7 +230,7 @@ const result = await gemini.apiRequest(
       },
     },
   },
-  { response: GenerateContentResponseSchema }
+  { response: GenerateContentResponseSchema },
 );
 ```
 
@@ -238,7 +241,7 @@ const CountTokensResponseSchema = z.object({
   totalTokens: z.number(),
 });
 
-const result = await gemini.apiRequest(
+const result = await ctx.integrations.gemini.apiRequest(
   {
     method: "POST",
     path: "/v1/models/gemini-1.5-pro:countTokens",
@@ -250,7 +253,7 @@ const result = await gemini.apiRequest(
       ],
     },
   },
-  { response: CountTokensResponseSchema }
+  { response: CountTokensResponseSchema },
 );
 
 console.log(`Total tokens: ${result.totalTokens}`);
@@ -266,7 +269,7 @@ await gemini.generateContent({ ... });
 await gemini.chat({ ... });
 
 // CORRECT - Use apiRequest
-await gemini.apiRequest(
+await ctx.integrations.gemini.apiRequest(
   { method: "POST", path: "/v1/models/gemini-1.5-pro:generateContent", body: { ... } },
   { response: GenerateContentResponseSchema }
 );
@@ -278,7 +281,7 @@ The model name is part of the URL path, not the body:
 
 ```typescript
 // WRONG - Model in body
-await gemini.apiRequest(
+await ctx.integrations.gemini.apiRequest(
   {
     method: "POST",
     path: "/v1/generateContent",
@@ -291,7 +294,7 @@ await gemini.apiRequest(
 );
 
 // CORRECT - Model in path
-await gemini.apiRequest(
+await ctx.integrations.gemini.apiRequest(
   {
     method: "POST",
     path: "/v1/models/gemini-1.5-pro:generateContent", // Model in URL
@@ -347,7 +350,7 @@ const contents = [
 Responses may be blocked by safety filters. Check the `finishReason`:
 
 ```typescript
-const result = await gemini.apiRequest(...);
+const result = await ctx.integrations.gemini.apiRequest(...);
 
 if (result.candidates[0]?.finishReason === "SAFETY") {
   console.log("Response blocked by safety filters");
@@ -361,7 +364,7 @@ if (result.candidates[0]?.finishReason === "SAFETY") {
 import { RestApiValidationError } from "@superblocksteam/sdk-api";
 
 try {
-  const result = await gemini.apiRequest(
+  const result = await ctx.integrations.gemini.apiRequest(
     { method: "POST", path: "/v1/models/gemini-1.5-pro:generateContent", body: { ... } },
     { response: GenerateContentResponseSchema }
   );

package/src/integrations/gemini/client.ts

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

package/src/integrations/gemini/index.ts

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

package/src/integrations/gemini/types.ts

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