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

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/index.ts

@@ -66,18 +66,12 @@ export {
   mongodb,
   dynamodb,
   cosmosdb,
-  couchbase,
   s3,
   gcs,
   googleSheets,
-  kafka,
-  kinesis,
   salesforce,
   redis,
   superblocksOcr,
-  python,
-  confluent,
-  redpanda,
   lakebase,
   snowflakePostgres,
   smtp,
@@ -143,18 +137,12 @@ 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 +371,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 +397,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,
@@ -452,10 +413,6 @@ export { RedisClientImpl } from "./redis/index.js";
 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 +428,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)

package/src/integrations/registry.ts

@@ -57,12 +57,9 @@ import { OracleDBClientImpl } from "./oracledb/index.js";
 import { RedshiftClientImpl } from "./redshift/index.js";
 // REST API clients
 import { CosmosDBClientImpl } from "./cosmosdb/index.js";
-import { CouchbaseClientImpl } from "./couchbase/index.js";
 import { DynamoDBClientImpl } from "./dynamodb/index.js";
 import { GCSClientImpl } from "./gcs/index.js";
 import { GoogleSheetsClientImpl } from "./gsheets/index.js";
-import { KafkaClientImpl } from "./kafka/index.js";
-import { KinesisClientImpl } from "./kinesis/index.js";
 import { LakebaseClientImpl } from "./lakebase/index.js";
 import { MongoDBClientImpl } from "./mongodb/index.js";
 import { RedisClientImpl } from "./redis/index.js";
@@ -73,8 +70,6 @@ import { SnowflakePostgresClientImpl } from "./snowflakepostgres/index.js";
 import { SuperblocksOCRClientImpl } from "./superblocks-ocr/index.js";
 // REST API plugins
 import { RestApiIntegrationPluginClientImpl } from "./restapiintegration/index.js";
-// Code execution clients
-import { PythonClientImpl } from "./python/index.js";
 
 /**
  * Supported plugin IDs mapped to their client constructors.
@@ -133,18 +128,12 @@ export const SUPPORTED_PLUGINS = {
   mongodb: "mongodb",
   dynamodb: "dynamodb",
   cosmosdb: "cosmosdb",
-  couchbase: "couchbase",
   s3: "s3",
   gcs: "gcs",
   gsheets: "gsheets",
-  kafka: "kafka",
-  kinesis: "kinesis",
   salesforce: "salesforce",
   redis: "redis",
   "superblocks-ocr": "superblocks-ocr",
-  // Kafka-compatible streaming
-  confluent: "confluent",
-  redpanda: "redpanda",
   // SQL databases (continued)
   lakebase: "lakebase",
   snowflakepostgres: "snowflakepostgres",
@@ -152,8 +141,6 @@ export const SUPPORTED_PLUGINS = {
   smtp: "smtp",
   // REST API plugins
   restapiintegration: "restapiintegration",
-  // Code execution
-  python: "python",
 } as const;
 
 export type SupportedPluginId =
@@ -183,11 +170,8 @@ export interface TraceMetadata {
  * Accepts a plugin request object that matches the protobuf Plugin definition
  * for the specific integration type (e.g., postgresql.v1.Plugin, restapi.v1.Plugin).
  *
- * For language plugins (Python, JavaScript), the bindings parameter should be passed
- * to the API execution request as `input` or `inputs` field for binding resolution.
- *
  * @param request - Plugin-specific request object matching the proto schema
- * @param bindings - Optional bindings data for binding resolution (e.g., Python/JavaScript bindings)
+ * @param bindings - Optional bindings data for binding resolution
  * @param metadata - Optional trace metadata (label, description) for diagnostics
  * @returns Promise resolving to the operation result
  */
@@ -392,9 +376,6 @@ export function createClient(
     case SUPPORTED_PLUGINS.cosmosdb:
       return new CosmosDBClientImpl(config, executeQuery);
 
-    case SUPPORTED_PLUGINS.couchbase:
-      return new CouchbaseClientImpl(config, executeQuery);
-
     case SUPPORTED_PLUGINS.s3:
       return new S3ClientImpl(config, executeQuery);
 
@@ -404,12 +385,6 @@ export function createClient(
     case SUPPORTED_PLUGINS.gsheets:
       return new GoogleSheetsClientImpl(config, executeQuery);
 
-    case SUPPORTED_PLUGINS.kafka:
-      return new KafkaClientImpl(config, executeQuery);
-
-    case SUPPORTED_PLUGINS.kinesis:
-      return new KinesisClientImpl(config, executeQuery);
-
     case SUPPORTED_PLUGINS.salesforce:
       return new SalesforceClientImpl(config, executeQuery);
 
@@ -419,11 +394,6 @@ export function createClient(
     case SUPPORTED_PLUGINS["superblocks-ocr"]:
       return new SuperblocksOCRClientImpl(config, executeQuery);
 
-    // Confluent and Redpanda use the same Kafka plugin proto
-    case SUPPORTED_PLUGINS.confluent:
-    case SUPPORTED_PLUGINS.redpanda:
-      return new KafkaClientImpl(config, executeQuery);
-
     case SUPPORTED_PLUGINS.lakebase:
       return new LakebaseClientImpl(config, executeQuery);
 
@@ -436,9 +406,6 @@ export function createClient(
     case SUPPORTED_PLUGINS.restapiintegration:
       return new RestApiIntegrationPluginClientImpl(config, executeQuery);
 
-    case SUPPORTED_PLUGINS.python:
-      return new PythonClientImpl(config, executeQuery);
-
     default:
       throw new Error(
         `Unsupported plugin: ${config.pluginId}. ` +

package/src/integrations/salesforce/README.md

@@ -77,7 +77,7 @@ const opportunities = await ctx.integrations.salesforce.query(
 ### Create a Record
 
 ```typescript
-await salesforce.create("Account", {
+await ctx.integrations.salesforce.create("Account", {
   Name: "Acme Corp",
   Industry: "Technology",
   Website: "https://acme.example.com",
@@ -87,7 +87,7 @@ await salesforce.create("Account", {
 ### Read a Record by ID
 
 ```typescript
-const account = await salesforce.read(
+const account = await ctx.integrations.salesforce.read(
   "Account",
   "001xx000003DGb2AAG",
   z.object({
@@ -101,7 +101,7 @@ const account = await salesforce.read(
 ### Update a Record
 
 ```typescript
-await salesforce.update("Account", "001xx000003DGb2AAG", {
+await ctx.integrations.salesforce.update("Account", "001xx000003DGb2AAG", {
   Name: "Acme Corp (Updated)",
   Industry: "Software",
 });
@@ -116,7 +116,7 @@ await ctx.integrations.salesforce.remove("Account", "001xx000003DGb2AAG");
 ### Bulk Create
 
 ```typescript
-await salesforce.bulkCreate("Contact", [
+await ctx.integrations.salesforce.bulkCreate("Contact", [
   { FirstName: "Alice", LastName: "Smith", Email: "alice@example.com" },
   { FirstName: "Bob", LastName: "Jones", Email: "bob@example.com" },
   { FirstName: "Charlie", LastName: "Lee", Email: "charlie@example.com" },
@@ -126,7 +126,7 @@ await salesforce.bulkCreate("Contact", [
 ### Bulk Update
 
 ```typescript
-await salesforce.bulkUpdate("Contact", [
+await ctx.integrations.salesforce.bulkUpdate("Contact", [
   { Id: "003xx000004TmiQAAS", Email: "alice-new@example.com" },
   { Id: "003xx000004TmiRAAS", Email: "bob-new@example.com" },
 ]);
@@ -135,7 +135,7 @@ await salesforce.bulkUpdate("Contact", [
 ### Bulk Delete
 
 ```typescript
-await salesforce.bulkDelete("Contact", [
+await ctx.integrations.salesforce.bulkDelete("Contact", [
   { Id: "003xx000004TmiQAAS" },
   { Id: "003xx000004TmiRAAS" },
 ]);
@@ -144,7 +144,7 @@ await salesforce.bulkDelete("Contact", [
 ### Bulk Upsert
 
 ```typescript
-await salesforce.bulkUpsert(
+await ctx.integrations.salesforce.bulkUpsert(
   "Account",
   [
     { ExternalId__c: "EXT-001", Name: "Acme Corp", Industry: "Tech" },
@@ -198,12 +198,14 @@ Bulk update and delete records must include the `Id` field:
 
 ```typescript
 // CORRECT
-await salesforce.bulkUpdate("Contact", [
+await ctx.integrations.salesforce.bulkUpdate("Contact", [
   { Id: "003xx000004TmiQAAS", Email: "new@example.com" },
 ]);
 
 // WRONG - Missing Id field
-await salesforce.bulkUpdate("Contact", [{ Email: "new@example.com" }]);
+await ctx.integrations.salesforce.bulkUpdate("Contact", [
+  { Email: "new@example.com" },
+]);
 ```
 
 ## Error Handling

package/src/integrations/slack/README.md

@@ -16,7 +16,6 @@ Send messages, manage channels, and interact with Slack workspaces.
 import { api, z, slack } from "@superblocksteam/sdk-api";
 
 const PostMessageResponseSchema = z.object({
-  ok: z.boolean(),
   channel: z.string(),
   ts: z.string(), // Message timestamp (unique ID)
   message: z.object({
@@ -55,6 +54,10 @@ export default api({
       { response: PostMessageResponseSchema },
     );
 
+    if (!result.ok) {
+      throw new Error(`Slack API error: ${result.error}`);
+    }
+
     return { messageId: result.ts };
   },
 });
@@ -106,7 +109,6 @@ const result = await ctx.integrations.slack.apiRequest(
 
 ```typescript
 const ListChannelsResponseSchema = z.object({
-  ok: z.boolean(),
   channels: z.array(
     z.object({
       id: z.string(),
@@ -135,6 +137,10 @@ const result = await ctx.integrations.slack.apiRequest(
   { response: ListChannelsResponseSchema },
 );
 
+if (!result.ok) {
+  throw new Error(`Slack API error: ${result.error}`);
+}
+
 result.channels.forEach((channel) => {
   console.log(`#${channel.name} (${channel.id})`);
 });
@@ -144,7 +150,6 @@ result.channels.forEach((channel) => {
 
 ```typescript
 const UserInfoResponseSchema = z.object({
-  ok: z.boolean(),
   user: z.object({
     id: z.string(),
     name: z.string(),
@@ -167,6 +172,10 @@ const result = await ctx.integrations.slack.apiRequest(
   { response: UserInfoResponseSchema },
 );
 
+if (!result.ok) {
+  throw new Error(`Slack API error: ${result.error}`);
+}
+
 console.log(`User: ${result.user.real_name} (${result.user.profile.email})`);
 ```
 
@@ -174,7 +183,6 @@ console.log(`User: ${result.user.real_name} (${result.user.profile.email})`);
 
 ```typescript
 const FileUploadResponseSchema = z.object({
-  ok: z.boolean(),
   file: z.object({
     id: z.string(),
     name: z.string(),
@@ -197,6 +205,10 @@ const result = await ctx.integrations.slack.apiRequest(
   { response: FileUploadResponseSchema },
 );
 
+if (!result.ok) {
+  throw new Error(`Slack API error: ${result.error}`);
+}
+
 console.log(`File uploaded: ${result.file.permalink}`);
 ```
 
@@ -221,7 +233,6 @@ const result = await ctx.integrations.slack.apiRequest(
 
 ```typescript
 const UpdateMessageResponseSchema = z.object({
-  ok: z.boolean(),
   channel: z.string(),
   ts: z.string(),
   text: z.string(),
@@ -333,6 +344,10 @@ async function getAllChannels(slack: SlackClient) {
       { response: ListChannelsResponseSchema },
     );
 
+    if (!result.ok) {
+      throw new Error(`Slack API error: ${result.error}`);
+    }
+
     allChannels.push(...result.channels);
     cursor = result.response_metadata?.next_cursor;
   } while (cursor);
@@ -371,30 +386,58 @@ Code block
 
 ## Error Handling
 
+Slack returns API errors as HTTP 200 with `{ ok: false, error: "error_code" }` instead of HTTP error status codes. The SDK surfaces these as the `SlackErrorResponse` branch of a discriminated union (`SlackResponse<T>`) — no exceptions, just check `result.ok`:
+
 ```typescript
-import { RestApiValidationError } from "@superblocksteam/sdk-api";
+import type { SlackResponse } from "@superblocksteam/sdk-api";
+
+const result = await ctx.integrations.slack.apiRequest(
+  { method: "POST", path: "/chat.postMessage", body: { channel, text } },
+  { response: PostMessageResponseSchema },
+);
 
-try {
-  const result = await ctx.integrations.slack.apiRequest(
-    { method: "POST", path: "/chat.postMessage", body: { ... } },
-    { response: PostMessageResponseSchema }
-  );
+if (!result.ok) {
+  // TypeScript narrows to SlackErrorResponse
+  console.error(`Slack error: ${result.error}`);
+  //              e.g. "missing_scope", "channel_not_found", "not_authed"
 
-  // Slack returns ok: false for API errors (not HTTP errors)
-  if (!result.ok) {
-    console.error("Slack API error");
-  }
-} catch (error) {
-  if (error instanceof RestApiValidationError) {
-    console.error("Validation failed:", error.details.zodError);
+  if (result.needed) {
+    console.error(`Required scopes: ${result.needed}`);
+    // e.g. "chat:write"
   }
+  return;
 }
+
+// TypeScript narrows to T & { ok: true } — all success fields accessible
+console.log(`Sent message: ${result.ts}`);
 ```
 
+### SlackResponse\<T\>
+
+Every `apiRequest` call returns `SlackResponse<T>`, a discriminated union:
+
+| Branch  | Shape                | When                                                                       |
+| ------- | -------------------- | -------------------------------------------------------------------------- |
+| Success | `T & { ok: true }`   | Slack returned `ok: true`; response validated against your Zod schema      |
+| Error   | `SlackErrorResponse` | Slack returned `ok: false`; contains `error`, optional `needed`/`provided` |
+
+`T` is your payload schema output. Define payload fields only (do not include `ok` in your response schema) and the SDK injects `ok: true` for the discriminant on success.
+
+**`SlackErrorResponse` fields:**
+
+| Field      | Type      | Description                                                  |
+| ---------- | --------- | ------------------------------------------------------------ |
+| `ok`       | `false`   | Discriminant                                                 |
+| `error`    | `string`  | Slack error code (e.g. `missing_scope`, `channel_not_found`) |
+| `needed`   | `string?` | Required OAuth scopes (present on `missing_scope` errors)    |
+| `provided` | `string?` | Current token scopes (present on `missing_scope` errors)     |
+
+Schema validation errors (Zod mismatch on a _success_ response) still throw `RestApiValidationError`. Body validation errors also throw. Only Slack's own `ok: false` errors are returned as values.
+
 ## API Reference
 
 - [Slack API Documentation](https://api.slack.com/methods)
 - [chat.postMessage](https://api.slack.com/methods/chat.postMessage)
 - [conversations.list](https://api.slack.com/methods/conversations.list)
-- [Block Kit Builder](https://app.slack.com/block-kit-builder)
 - [OAuth Scopes](https://api.slack.com/scopes)
+- [Block Kit Builder](https://app.slack.com/block-kit-builder)