@superblocksteam/sdk-api 2.0.105 → 2.0.106-next.0

package/src/integrations/declarations.ts

@@ -24,7 +24,7 @@
  *   output: z.object({ name: z.string() }),
  *   async run(ctx) {
  *     const users = await ctx.integrations.pg.query(...);
- *     await ctx.integrations.notifier.postMessage(...);
+ *     await ctx.integrations.notifier.apiRequest(...);
  *     return { name: users[0].name };
  *   },
  * });
@@ -43,7 +43,6 @@ import type { CockroachDBClient } from "./cockroachdb/index.js";
 import type { CohereClient } from "./cohere/index.js";
 import type { ConfluenceClient } from "./confluence/index.js";
 import type { CosmosDBClient } from "./cosmosdb/index.js";
-import type { CouchbaseClient } from "./couchbase/index.js";
 import type { DatabricksClient } from "./databricks/index.js";
 import type { DatadogClient } from "./datadog/index.js";
 import type { DropboxClient } from "./dropbox/index.js";
@@ -62,8 +61,6 @@ import type { GoogleSheetsClient } from "./gsheets/index.js";
 import type { HubSpotClient } from "./hubspot/index.js";
 import type { IntercomClient } from "./intercom/index.js";
 import type { JiraClient } from "./jira/index.js";
-import type { KafkaClient } from "./kafka/index.js";
-import type { KinesisClient } from "./kinesis/index.js";
 import type { LakebaseClient } from "./lakebase/index.js";
 import type { LaunchDarklyClient } from "./launchdarkly/index.js";
 import type { MariaDBClient } from "./mariadb/index.js";
@@ -77,8 +74,6 @@ import type { OracleDBClient } from "./oracledb/index.js";
 import type { PagerDutyClient } from "./pagerduty/index.js";
 import type { PerplexityClient } from "./perplexity/index.js";
 import type { PostgresClient } from "./postgres/index.js";
-import type { PythonClient } from "./python/index.js";
-import type { RedisClient } from "./redis/index.js";
 import type { RedshiftClient } from "./redshift/index.js";
 import type { RestApiIntegrationPluginClient } from "./restapiintegration/index.js";
 import type { S3Client } from "./s3/index.js";
@@ -313,9 +308,6 @@ export type DynamoDBRef = IntegrationRef<"dynamodb", DynamoDBClient>;
 /** Reference to a CosmosDB integration */
 export type CosmosDBRef = IntegrationRef<"cosmosdb", CosmosDBClient>;
 
-/** Reference to a Couchbase integration */
-export type CouchbaseRef = IntegrationRef<"couchbase", CouchbaseClient>;
-
 /** Reference to an S3 integration */
 export type S3Ref = IntegrationRef<"s3", S3Client>;
 
@@ -325,33 +317,15 @@ export type GCSRef = IntegrationRef<"gcs", GCSClient>;
 /** Reference to a Google Sheets integration */
 export type GoogleSheetsRef = IntegrationRef<"gsheets", GoogleSheetsClient>;
 
-/** Reference to a Kafka integration */
-export type KafkaRef = IntegrationRef<"kafka", KafkaClient>;
-
-/** Reference to a Kinesis integration */
-export type KinesisRef = IntegrationRef<"kinesis", KinesisClient>;
-
 /** Reference to a Salesforce integration */
 export type SalesforceRef = IntegrationRef<"salesforce", SalesforceClient>;
 
-/** Reference to a Redis integration */
-export type RedisRef = IntegrationRef<"redis", RedisClient>;
-
 /** Reference to a Superblocks OCR integration */
 export type SuperblocksOCRRef = IntegrationRef<
   "superblocks-ocr",
   SuperblocksOCRClient
 >;
 
-/** Reference to a Python integration */
-export type PythonRef = IntegrationRef<"python", PythonClient>;
-
-/** Reference to a Confluent integration (Kafka-compatible) */
-export type ConfluentRef = IntegrationRef<"confluent", KafkaClient>;
-
-/** Reference to a Redpanda integration (Kafka-compatible) */
-export type RedpandaRef = IntegrationRef<"redpanda", KafkaClient>;
-
 /** Reference to a Lakebase integration */
 export type LakebaseRef = IntegrationRef<"lakebase", LakebaseClient>;
 
@@ -426,10 +400,10 @@ export function postgres<T extends string>(id: LiteralString<T>): PostgresRef {
  *   input: z.object({ message: z.string() }),
  *   output: z.object({ sent: z.boolean() }),
  *   async run(ctx, { message }) {
- *     await ctx.integrations.notifier.postMessage({
- *       channel: '#alerts',
- *       text: message,
- *     });
+ *     await ctx.integrations.notifier.apiRequest(
+ *       { method: 'POST', path: '/chat.postMessage', body: { channel: '#alerts', text: message } },
+ *       { response: z.object({ ok: z.boolean() }) }
+ *     );
  *     return { sent: true };
  *   },
  * });
@@ -971,18 +945,6 @@ export function cosmosdb<T extends string>(id: LiteralString<T>): CosmosDBRef {
   return createRef<"cosmosdb", CosmosDBClient, T>("cosmosdb", id);
 }
 
-/**
- * Declare a Couchbase integration.
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function couchbase<T extends string>(
-  id: LiteralString<T>,
-): CouchbaseRef {
-  return createRef<"couchbase", CouchbaseClient, T>("couchbase", id);
-}
-
 /**
  * Declare an S3 integration.
  *
@@ -1015,26 +977,6 @@ export function googleSheets<T extends string>(
   return createRef<"gsheets", GoogleSheetsClient, T>("gsheets", id);
 }
 
-/**
- * Declare a Kafka integration.
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function kafka<T extends string>(id: LiteralString<T>): KafkaRef {
-  return createRef<"kafka", KafkaClient, T>("kafka", id);
-}
-
-/**
- * Declare a Kinesis integration.
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function kinesis<T extends string>(id: LiteralString<T>): KinesisRef {
-  return createRef<"kinesis", KinesisClient, T>("kinesis", id);
-}
-
 /**
  * Declare a Salesforce integration.
  *
@@ -1047,16 +989,6 @@ export function salesforce<T extends string>(
   return createRef<"salesforce", SalesforceClient, T>("salesforce", id);
 }
 
-/**
- * Declare a Redis integration.
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function redis<T extends string>(id: LiteralString<T>): RedisRef {
-  return createRef<"redis", RedisClient, T>("redis", id);
-}
-
 /**
  * Declare a Superblocks OCR integration.
  *
@@ -1072,38 +1004,6 @@ export function superblocksOcr<T extends string>(
   );
 }
 
-/**
- * Declare a Python integration.
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function python<T extends string>(id: LiteralString<T>): PythonRef {
-  return createRef<"python", PythonClient, T>("python", id);
-}
-
-/**
- * Declare a Confluent integration (Kafka-compatible).
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function confluent<T extends string>(
-  id: LiteralString<T>,
-): ConfluentRef {
-  return createRef<"confluent", KafkaClient, T>("confluent", id);
-}
-
-/**
- * Declare a Redpanda integration (Kafka-compatible).
- *
- * @param id - The integration ID (UUID)
- * @returns An integration reference for use in the API config
- */
-export function redpanda<T extends string>(id: LiteralString<T>): RedpandaRef {
-  return createRef<"redpanda", KafkaClient, T>("redpanda", id);
-}
-
 /**
  * Declare a Lakebase integration.
  *

package/src/integrations/documentation.test.ts

@@ -15,9 +15,7 @@ type PlaceholderDocsCase = {
 };
 
 const DOC_DIRECTORY_ALIASES = {
-  confluent: "kafka",
   graphqlintegration: "graphql",
-  redpanda: "kafka",
 } as const;
 
 const DOC_DIRECTORY_EXCLUSIONS = new Set(["base"]);

package/src/integrations/googledrive/README.md

@@ -71,7 +71,7 @@ export default api({
     const result = await ctx.integrations.drive.apiRequest(
       {
         method: "GET",
-        path: "/drive/v3/files",
+        path: "/files",
         params: {
           q: query,
           pageSize: pageSize,
@@ -99,7 +99,7 @@ export default api({
 const file = await ctx.integrations.drive.apiRequest(
   {
     method: "GET",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     params: {
       fields:
         "id,name,mimeType,size,createdTime,modifiedTime,parents,webViewLink,webContentLink,owners",
@@ -120,7 +120,7 @@ const DownloadResponseSchema = z.string(); // Raw content
 const content = await ctx.integrations.drive.apiRequest(
   {
     method: "GET",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     params: {
       alt: "media",
     },
@@ -134,7 +134,7 @@ const ExportResponseSchema = z.string();
 const docContent = await ctx.integrations.drive.apiRequest(
   {
     method: "GET",
-    path: `/drive/v3/files/${fileId}/export`,
+    path: `/files/${fileId}/export`,
     params: {
       mimeType: "text/plain", // or application/pdf, text/html, etc.
     },
@@ -149,7 +149,7 @@ const docContent = await ctx.integrations.drive.apiRequest(
 const folder = await ctx.integrations.drive.apiRequest(
   {
     method: "POST",
-    path: "/drive/v3/files",
+    path: "/files",
     body: {
       name: "New Folder",
       mimeType: "application/vnd.google-apps.folder",
@@ -194,7 +194,7 @@ const uploadedFile = await ctx.integrations.drive.apiRequest(
 const updatedFile = await ctx.integrations.drive.apiRequest(
   {
     method: "PATCH",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     body: {
       name: "Renamed File.txt",
       description: "Updated description",
@@ -210,7 +210,7 @@ const updatedFile = await ctx.integrations.drive.apiRequest(
 const movedFile = await ctx.integrations.drive.apiRequest(
   {
     method: "PATCH",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     params: {
       addParents: newFolderId,
       removeParents: oldFolderId,
@@ -226,7 +226,7 @@ const movedFile = await ctx.integrations.drive.apiRequest(
 const result = await ctx.integrations.drive.apiRequest(
   {
     method: "GET",
-    path: "/drive/v3/files",
+    path: "/files",
     params: {
       q: "name contains 'report' and mimeType = 'application/pdf' and trashed = false",
       pageSize: 25,
@@ -250,7 +250,7 @@ const PermissionSchema = z.object({
 const permission = await ctx.integrations.drive.apiRequest(
   {
     method: "POST",
-    path: `/drive/v3/files/${fileId}/permissions`,
+    path: `/files/${fileId}/permissions`,
     body: {
       type: "user", // user, group, domain, anyone
       role: "reader", // reader, writer, commenter, owner
@@ -271,7 +271,7 @@ const permission = await ctx.integrations.drive.apiRequest(
 await ctx.integrations.drive.apiRequest(
   {
     method: "PATCH",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     body: {
       trashed: true,
     },
@@ -283,7 +283,7 @@ await ctx.integrations.drive.apiRequest(
 await ctx.integrations.drive.apiRequest(
   {
     method: "DELETE",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
   },
   { response: z.void() },
 );
@@ -304,7 +304,7 @@ await drive.uploadFile({ ... });
 
 // CORRECT - Use apiRequest
 await ctx.integrations.drive.apiRequest(
-  { method: "GET", path: "/drive/v3/files", params: { ... } },
+  { method: "GET", path: "/files", params: { ... } },
   { response: ListFilesResponseSchema }
 );
 ```
@@ -316,7 +316,7 @@ By default, only basic fields are returned. Use the `fields` parameter:
 ```typescript
 // WRONG - Missing fields, gets minimal data
 const file = await ctx.integrations.drive.apiRequest(
-  { method: "GET", path: `/drive/v3/files/${fileId}` },
+  { method: "GET", path: `/files/${fileId}` },
   { response: FileSchema },
 );
 // file.size, file.owners, etc. will be undefined
@@ -325,7 +325,7 @@ const file = await ctx.integrations.drive.apiRequest(
 const file = await ctx.integrations.drive.apiRequest(
   {
     method: "GET",
-    path: `/drive/v3/files/${fileId}`,
+    path: `/files/${fileId}`,
     params: {
       fields: "id,name,mimeType,size,createdTime,modifiedTime,owners",
     },
@@ -367,10 +367,10 @@ Google Docs, Sheets, etc. must be exported, not downloaded directly:
 
 ```typescript
 // Regular files - use alt=media
-const path = `/drive/v3/files/${fileId}?alt=media`;
+const path = `/files/${fileId}?alt=media`;
 
 // Google Docs - use export endpoint
-const path = `/drive/v3/files/${fileId}/export?mimeType=text/plain`;
+const path = `/files/${fileId}/export?mimeType=text/plain`;
 
 // Export formats for Google Docs
 // Documents: text/plain, text/html, application/pdf, application/vnd.oasis.opendocument.text
@@ -396,14 +396,17 @@ const sizeMB = sizeBytes / (1024 * 1024);
 
 ### Upload Path vs Regular Path
 
-File uploads use a different base path:
+The base URL already includes `/drive/v3`, so regular API paths omit this prefix. However, uploads use a different URL root (`/upload/drive/v3/...` instead of `/drive/v3/...`) and require the full path:
 
 ```typescript
-// Regular API calls
-const path = "/drive/v3/files";
+// Regular API calls (base URL already has /drive/v3)
+const path = "/files";
 
-// Upload calls
+// Upload calls use a different URL root — include the full path
 const path = "/upload/drive/v3/files";
+
+// WRONG - Duplicates base URL prefix for regular calls
+const path = "/drive/v3/files";
 ```
 
 ### Folder MIME Type
@@ -436,7 +439,7 @@ async function getAllFiles(drive: GoogleDriveClient, folderId: string) {
     const result = await ctx.integrations.drive.apiRequest(
       {
         method: "GET",
-        path: "/drive/v3/files",
+        path: "/files",
         params: {
           q: `'${folderId}' in parents and trashed = false`,
           pageSize: 100,
@@ -463,7 +466,7 @@ import { RestApiValidationError } from "@superblocksteam/sdk-api";
 
 try {
   const result = await ctx.integrations.drive.apiRequest(
-    { method: "GET", path: "/drive/v3/files", params: { ... } },
+    { method: "GET", path: "/files", params: { ... } },
     { response: ListFilesResponseSchema }
   );
 } catch (error) {

package/src/integrations/googledrive/types.ts

@@ -24,7 +24,7 @@ import type { SupportsApiRequest } from "../base/index.js";
  * const result = await googleDrive.apiRequest(
  *   {
  *     method: 'GET',
- *     path: '/drive/v3/files',
+ *     path: '/files',
  *   },
  *   { response: ResponseSchema }
  * );

package/src/integrations/graphql/README.md

@@ -112,7 +112,7 @@ const CreateUserResponseSchema = z.object({
   }),
 });
 
-const result = await graphql.mutation(
+const result = await ctx.integrations.graphql.mutation(
   `mutation CreateUser($input: CreateUserInput!) {
     createUser(input: $input) {
       id
@@ -150,7 +150,7 @@ const UpdateOrderResponseSchema = z.object({
   }),
 });
 
-const result = await graphql.mutation(
+const result = await ctx.integrations.graphql.mutation(
   `mutation UpdateOrder($id: ID!, $input: UpdateOrderInput!) {
     updateOrder(id: $id, input: $input) {
       id

package/src/integrations/groq/README.md

@@ -87,7 +87,7 @@ export default api({
         method: "POST",
         path: "/v1/chat/completions",
         body: {
-          model: "llama-3.1-70b-versatile",
+          model: "llama-3.3-70b-versatile",
           messages: [
             { role: "system", content: "You are a helpful assistant." },
             { role: "user", content: prompt },
@@ -105,13 +105,13 @@ export default api({
 ### Using Different Models
 
 ```typescript
-// Llama 3.1 70B - Best balance of speed and quality
+// Llama 3.3 70B - Best balance of speed and quality
 const llama70b = await ctx.integrations.groq.apiRequest(
   {
     method: "POST",
     path: "/v1/chat/completions",
     body: {
-      model: "llama-3.1-70b-versatile",
+      model: "llama-3.3-70b-versatile",
       messages: [{ role: "user", content: "Hello" }],
     },
   },
@@ -131,13 +131,13 @@ const llama8b = await ctx.integrations.groq.apiRequest(
   { response: ChatCompletionResponseSchema },
 );
 
-// Mixtral 8x7B - Good for code and reasoning
-const mixtral = await ctx.integrations.groq.apiRequest(
+// GPT-OSS 120B - Good for code and reasoning
+const gptOss = await ctx.integrations.groq.apiRequest(
   {
     method: "POST",
     path: "/v1/chat/completions",
     body: {
-      model: "mixtral-8x7b-32768",
+      model: "openai/gpt-oss-120b",
       messages: [{ role: "user", content: "Hello" }],
     },
   },
@@ -178,7 +178,7 @@ const result = await ctx.integrations.groq.apiRequest(
     method: "POST",
     path: "/v1/chat/completions",
     body: {
-      model: "llama-3.1-70b-versatile",
+      model: "llama-3.3-70b-versatile",
       messages: [{ role: "user", content: "What's the weather in Tokyo?" }],
       tools: [
         {
@@ -228,7 +228,7 @@ const result = await ctx.integrations.groq.apiRequest(
     method: "POST",
     path: "/v1/chat/completions",
     body: {
-      model: "llama-3.1-70b-versatile",
+      model: "llama-3.3-70b-versatile",
       messages: [
         {
           role: "user",

package/src/integrations/index.ts

@@ -66,18 +66,11 @@ export {
   mongodb,
   dynamodb,
   cosmosdb,
-  couchbase,
   s3,
   gcs,
   googleSheets,
-  kafka,
-  kinesis,
   salesforce,
-  redis,
   superblocksOcr,
-  python,
-  confluent,
-  redpanda,
   lakebase,
   snowflakePostgres,
   smtp,
@@ -143,18 +136,11 @@ export {
   type MongoDBRef,
   type DynamoDBRef,
   type CosmosDBRef,
-  type CouchbaseRef,
   type S3Ref,
   type GCSRef,
   type GoogleSheetsRef,
-  type KafkaRef,
-  type KinesisRef,
   type SalesforceRef,
-  type RedisRef,
   type SuperblocksOCRRef,
-  type PythonRef,
-  type ConfluentRef,
-  type RedpandaRef,
   type LakebaseRef,
   type SnowflakePostgresRef,
   type SmtpRef,
@@ -383,13 +369,6 @@ export { DynamoDBClientImpl } from "./dynamodb/index.js";
 export type { CosmosDBClient, CosmosDBQueryOptions } from "./cosmosdb/index.js";
 export { CosmosDBClientImpl } from "./cosmosdb/index.js";
 
-// Couchbase client
-export type {
-  CouchbaseClient,
-  CouchbaseIdentifier,
-} from "./couchbase/index.js";
-export { CouchbaseClientImpl } from "./couchbase/index.js";
-
 // S3 client
 export type {
   S3Client,
@@ -416,26 +395,6 @@ export type {
 } from "./gsheets/index.js";
 export { GoogleSheetsClientImpl } from "./gsheets/index.js";
 
-// Kafka client
-export type {
-  KafkaClient,
-  KafkaOperation,
-  KafkaSeek,
-  KafkaConsumeParams,
-  KafkaProduceParams,
-} from "./kafka/index.js";
-export { KafkaClientImpl } from "./kafka/index.js";
-
-// Kinesis client
-export type {
-  KinesisClient,
-  KinesisPutParams,
-  KinesisGetParams,
-  KinesisStreamIdentifier,
-  KinesisShardIteratorType,
-} from "./kinesis/index.js";
-export { KinesisClientImpl } from "./kinesis/index.js";
-
 // Salesforce client
 export type {
   SalesforceClient,
@@ -444,18 +403,10 @@ export type {
 } from "./salesforce/index.js";
 export { SalesforceClientImpl } from "./salesforce/index.js";
 
-// Redis client
-export type { RedisClient } from "./redis/index.js";
-export { RedisClientImpl } from "./redis/index.js";
-
 // Superblocks OCR client
 export type { SuperblocksOCRClient } from "./superblocks-ocr/index.js";
 export { SuperblocksOCRClientImpl } from "./superblocks-ocr/index.js";
 
-// Python client
-export type { PythonClient } from "./python/index.js";
-export { PythonClientImpl } from "./python/index.js";
-
 // Lakebase client
 export type { LakebaseClient } from "./lakebase/index.js";
 export { LakebaseClientImpl } from "./lakebase/index.js";
@@ -471,5 +422,3 @@ export { SmtpClientImpl } from "./smtp/index.js";
 // REST API Integration client
 export type { RestApiIntegrationPluginClient } from "./restapiintegration/index.js";
 export { RestApiIntegrationPluginClientImpl } from "./restapiintegration/index.js";
-
-// Confluent and Redpanda reuse the Kafka client (same proto)