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

package/dist/integrations/snowflake/client.d.ts

@@ -21,10 +21,10 @@ export declare class SnowflakeClientImpl implements SnowflakeClient, Integration
      * Builds a Snowflake request object from SQL and parameters.
      *
      * When params are provided, the SQL body is sent with placeholders intact
-     * (e.g. $1, $2) and the parameter values are passed via the `parameters`
+     * (e.g. ?) and the parameter values are passed via the `parameters`
      * field as a JSON-stringified array for server-side binding.
      *
-     * @param sql - The SQL query with optional $1, $2 placeholders
+     * @param sql - The SQL query with optional ? placeholders
      * @param params - Optional array of parameter values for server-side binding
      * @returns The plugin request object
      */

package/dist/integrations/snowflake/client.js

@@ -27,10 +27,10 @@ export class SnowflakeClientImpl {
      * Builds a Snowflake request object from SQL and parameters.
      *
      * When params are provided, the SQL body is sent with placeholders intact
-     * (e.g. $1, $2) and the parameter values are passed via the `parameters`
+     * (e.g. ?) and the parameter values are passed via the `parameters`
      * field as a JSON-stringified array for server-side binding.
      *
-     * @param sql - The SQL query with optional $1, $2 placeholders
+     * @param sql - The SQL query with optional ? placeholders
      * @param params - Optional array of parameter values for server-side binding
      * @returns The plugin request object
      */

package/dist/runtime/context.d.ts

@@ -24,7 +24,7 @@ export interface CreateContextOptions {
     /**
      * Function to execute integration operations.
      *
-     * For language plugins (Python, JavaScript), pass the bindings parameter
+     * For language plugins (JavaScript), pass the bindings parameter
      * to the API execution request as `input` field for binding resolution.
      */
     executeQuery: (integrationId: string, request: Record<string, unknown>, bindings?: Record<string, unknown>, metadata?: TraceMetadata) => Promise<unknown>;

package/dist/runtime/executor.d.ts

@@ -30,13 +30,13 @@ export interface ExecuteApiRequest {
      * The request object should match the protobuf Plugin schema for the
      * specific integration type (e.g., postgresql.v1.Plugin for Postgres).
      *
-     * For language plugins (Python, JavaScript), the bindings parameter should be
+     * For language plugins (JavaScript), the bindings parameter should be
      * passed to the API execution request as `input` or `inputs` field for
      * binding resolution.
      *
      * @param integrationId - The integration ID
      * @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 (e.g., JavaScript bindings)
      * @returns Promise resolving to the operation result
      */
     executeQuery: (integrationId: string, request: Record<string, unknown>, bindings?: Record<string, unknown>, metadata?: TraceMetadata) => Promise<unknown>;

package/dist/types.d.ts

@@ -37,10 +37,13 @@ import type { IntegrationRef, AnyIntegrationRef, IntegrationsMap } from "./integ
  *     if (users.length === 0) {
  *       throw new Error('User not found');
  *     }
- *     await ctx.integrations.notifier.postMessage({
- *       channel: '#alerts',
- *       text: `Fetched user ${users[0].name}`,
- *     });
+ *     const notifyResult = await ctx.integrations.notifier.apiRequest(
+ *       { method: 'POST', path: '/chat.postMessage', body: { channel: '#alerts', text: `Fetched user ${users[0].name}` } },
+ *       { response: z.object({ channel: z.string(), ts: z.string() }) }
+ *     );
+ *     if (!notifyResult.ok) {
+ *       throw new Error(`Slack API error: ${notifyResult.error}`);
+ *     }
  *     return { user: users[0] };
  *   },
  * });
@@ -70,7 +73,7 @@ export interface ApiConfig<TInput extends z.ZodType, TOutput extends z.ZodType,
      * ```typescript
      * integrations: {
      *   db: postgres('Production Postgres'),
-     *   cache: redis('Cache Redis'),
+     *   cache: mongodb('Cache MongoDB'),
      * }
      * ```
      */
@@ -129,7 +132,13 @@ export interface ApiContext<TIntegrations extends Record<string, AnyIntegrationR
      * const users = await ctx.integrations.db.query('SELECT * FROM users', UserSchema);
      *
      * // ctx.integrations.notifier is SlackClient
-     * await ctx.integrations.notifier.postMessage({ channel: '#alerts', text: 'Hello!' });
+     * const notifyResult = await ctx.integrations.notifier.apiRequest(
+     *   { method: 'POST', path: '/chat.postMessage', body: { channel: '#alerts', text: 'Hello!' } },
+     *   { response: z.object({ channel: z.string(), ts: z.string() }) }
+     * );
+     * if (!notifyResult.ok) {
+     *   throw new Error(`Slack API error: ${notifyResult.error}`);
+     * }
      * ```
      */
     readonly integrations: IntegrationsMap<TIntegrations>;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superblocksteam/sdk-api",
-  "version": "2.0.105",
+  "version": "2.0.106-next.0",
   "description": "Superblocks SDK for TypeScript-based API definitions",
   "license": "Superblocks Community Software License",
   "files": [
@@ -16,7 +16,7 @@
     "registry": "https://registry.npmjs.org"
   },
   "dependencies": {
-    "@superblocksteam/types": "1.196.0",
+    "@superblocksteam/types": "1.351.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {

package/src/api/definition.test.ts

@@ -9,7 +9,7 @@ import { z } from "zod";
 import {
   api,
   __setEntryPoint,
-  consumeEntryPoint,
+  getEntryPoint,
   type ExtractApiInput,
   type ExtractApiOutput,
 } from "./definition.js";
@@ -345,27 +345,52 @@ describe("entryPoint mechanism", () => {
     expect(compiled.entryPoint).toBe("server/apis/GetUsers/api.ts");
   });
 
-  it("consumeEntryPoint clears the pending value", () => {
-    __setEntryPoint("server/apis/Temp/api.ts");
-    const first = consumeEntryPoint();
-    const second = consumeEntryPoint();
+  it("entryPoint persists across multiple api() calls from the same file", () => {
+    __setEntryPoint("server/apis/slack/helper.ts");
+    const dashboard = api({
+      name: "SlackDashboard",
+      input: z.object({}),
+      output: z.object({}),
+      async run() {
+        return {};
+      },
+    });
+    const search = api({
+      name: "SlackSearch",
+      input: z.object({}),
+      output: z.object({}),
+      async run() {
+        return {};
+      },
+    });
+    const postMessage = api({
+      name: "SlackPostMessage",
+      input: z.object({}),
+      output: z.object({}),
+      async run() {
+        return {};
+      },
+    });
 
-    expect(first).toBe("server/apis/Temp/api.ts");
-    expect(second).toBeUndefined();
+    expect(dashboard.entryPoint).toBe("server/apis/slack/helper.ts");
+    expect(search.entryPoint).toBe("server/apis/slack/helper.ts");
+    expect(postMessage.entryPoint).toBe("server/apis/slack/helper.ts");
   });
 
-  it("entryPoint is consumed once — second api() call gets undefined", () => {
-    __setEntryPoint("server/apis/First/api.ts");
-    const first = api({
-      name: "First",
+  it("new __setEntryPoint overwrites previous value for a different file", () => {
+    __setEntryPoint("server/apis/slack/helper.ts");
+    const slackApi = api({
+      name: "SlackDashboard",
       input: z.object({}),
       output: z.object({}),
       async run() {
         return {};
       },
     });
-    const second = api({
-      name: "Second",
+
+    __setEntryPoint("server/apis/users/api.ts");
+    const usersApi = api({
+      name: "GetUsers",
       input: z.object({}),
       output: z.object({}),
       async run() {
@@ -373,7 +398,7 @@ describe("entryPoint mechanism", () => {
       },
     });
 
-    expect(first.entryPoint).toBe("server/apis/First/api.ts");
-    expect(second.entryPoint).toBeUndefined();
+    expect(slackApi.entryPoint).toBe("server/apis/slack/helper.ts");
+    expect(usersApi.entryPoint).toBe("server/apis/users/api.ts");
   });
 });

package/src/api/definition.ts

@@ -52,21 +52,28 @@ import type { ApiConfig, ApiContext, AnyIntegrationRef } from "../types.js";
 
 // ---------------------------------------------------------------------------
 // Entry point setter — used by the Vite plugin to stamp the source file path
-// onto the next api() call. ESM top-level execution is
-// synchronous, so the prepended __setEntryPoint() always runs before api().
+// onto every api()/streamingApi() call in a module.  ESM top-level execution
+// is synchronous, so the prepended __setEntryPoint() always runs before any
+// api() call in the same file.  The value is intentionally NOT cleared after
+// the first read so that multiple named-exported api() calls in a single file
+// all receive the same entry point.  The next file's __setEntryPoint() call
+// naturally overwrites the value.
 // ---------------------------------------------------------------------------
 
 let __pendingEntryPoint: string | undefined;
 
-/** Called by the Vite plugin to set the entry point for the next api() call. */
+/** Called by the Vite plugin to set the entry point for api() calls in this file. */
 export function __setEntryPoint(entryPoint: string): void {
   __pendingEntryPoint = entryPoint;
 }
 
-export function consumeEntryPoint(): string | undefined {
-  const ep = __pendingEntryPoint;
-  __pendingEntryPoint = undefined;
-  return ep;
+/**
+ * Returns the current pending entry point without clearing it.
+ * This allows multiple api() calls within the same file to share the same
+ * entry point (e.g. named exports from a single module).
+ */
+export function getEntryPoint(): string | undefined {
+  return __pendingEntryPoint;
 }
 
 /**
@@ -170,10 +177,10 @@ export interface CompiledApi<TInput = unknown, TOutput = unknown> {
  *       throw new Error('User not found');
  *     }
  *
- *     await ctx.integrations.notifier.postMessage({
- *       channel: '#user-lookups',
- *       text: `Fetched user ${user.name}`,
- *     });
+ *     await ctx.integrations.notifier.apiRequest(
+ *       { method: 'POST', path: '/chat.postMessage', body: { channel: '#user-lookups', text: `Fetched user ${user.name}` } },
+ *       { response: z.object({ ok: z.boolean() }) }
+ *     );
  *
  *     return { user };
  *   },
@@ -196,7 +203,7 @@ export function api<
   const compiled: CompiledApi<z.infer<TInput>, z.infer<TOutput>> = {
     name: config.name,
     description: config.description,
-    entryPoint: consumeEntryPoint(),
+    entryPoint: getEntryPoint(),
     inputSchema: config.input,
     outputSchema: config.output,
     run: config.run as (

package/src/errors.ts

@@ -53,7 +53,7 @@ export class QueryValidationError extends Error {
 }
 
 /**
- * Error thrown when Python/JavaScript code execution fails.
+ * Error thrown when code execution fails.
  *
  * Contains context about the code, bindings, and any validation errors
  * that occurred during execution.

package/src/index.ts

@@ -38,10 +38,14 @@
  *       throw new Error('User not found');
  *     }
  *
- *     await ctx.integrations.notifier.postMessage({
- *       channel: '#user-lookups',
- *       text: `Fetched user ${user.name}`,
- *     });
+ *     const notifyResult = await ctx.integrations.notifier.apiRequest(
+ *       { method: 'POST', path: '/chat.postMessage', body: { channel: '#user-lookups', text: `Fetched user ${user.name}` } },
+ *       { response: z.object({ channel: z.string(), ts: z.string() }) }
+ *     );
+ *
+ *     if (!notifyResult.ok) {
+ *       throw new Error(`Slack API error: ${notifyResult.error}`);
+ *     }
  *
  *     return { user };
  *   },
@@ -129,20 +133,13 @@ export {
   mongodb,
   dynamodb,
   cosmosdb,
-  couchbase,
   s3,
   gcs,
   googleSheets,
-  kafka,
-  kinesis,
   salesforce,
-  redis,
   superblocksOcr,
-  python,
   restApiIntegration,
   getIntegrationDeclarations,
-  confluent,
-  redpanda,
   lakebase,
   snowflakePostgres,
   smtp,
@@ -199,19 +196,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 RestApiIntegrationRef,
-  type ConfluentRef,
-  type RedpandaRef,
   type LakebaseRef,
   type SnowflakePostgresRef,
   type SmtpRef,
@@ -219,7 +209,11 @@ export {
 
 // Integration client types (for advanced use cases)
 export type { PostgresClient } from "./integrations/postgres/index.js";
-export type { SlackClient } from "./integrations/slack/index.js";
+export type {
+  SlackClient,
+  SlackResponse,
+  SlackErrorResponse,
+} from "./integrations/slack/index.js";
 export type { SnowflakeClient } from "./integrations/snowflake/index.js";
 export type { SnowflakeCortexClient } from "./integrations/snowflakecortex/index.js";
 export type { AirtableClient } from "./integrations/airtable/index.js";
@@ -259,29 +253,15 @@ export type {
   DynamoDBAttributeValue,
 } from "./integrations/dynamodb/index.js";
 export type { CosmosDBClient } from "./integrations/cosmosdb/index.js";
-export type {
-  CouchbaseClient,
-  CouchbaseIdentifier,
-} from "./integrations/couchbase/index.js";
-export type {
-  KinesisClient,
-  KinesisPutParams,
-  KinesisGetParams,
-  KinesisStreamIdentifier,
-  KinesisShardIteratorType,
-} from "./integrations/kinesis/index.js";
 export type {
   SalesforceClient,
   SalesforceCrudAction,
   SalesforceBulkAction,
 } from "./integrations/salesforce/index.js";
-export type { RedisClient } from "./integrations/redis/index.js";
-export type { KafkaClient } from "./integrations/kafka/index.js";
 export type { S3Client } from "./integrations/s3/index.js";
 export type { GCSClient } from "./integrations/gcs/index.js";
 export type { GoogleSheetsClient } from "./integrations/gsheets/index.js";
 export type { SuperblocksOCRClient } from "./integrations/superblocks-ocr/index.js";
-export type { PythonClient } from "./integrations/python/index.js";
 export type { RestApiIntegrationPluginClient } from "./integrations/restapiintegration/index.js";
 export type { LakebaseClient } from "./integrations/lakebase/index.js";
 export type { SnowflakePostgresClient } from "./integrations/snowflakepostgres/index.js";

package/src/integrations/asana/README.md

@@ -49,7 +49,7 @@ export default api({
     const result = await ctx.integrations.asana.apiRequest(
       {
         method: "POST",
-        path: "/api/1.0/tasks",
+        path: "/tasks",
         body: {
           data: {
             name: name,
@@ -88,7 +88,7 @@ const ListTasksResponseSchema = z.object({
 const result = await ctx.integrations.asana.apiRequest(
   {
     method: "GET",
-    path: `/api/1.0/projects/${projectId}/tasks`,
+    path: `/projects/${projectId}/tasks`,
     params: {
       opt_fields: "name,completed,due_on,assignee.name",
       completed_since: "now", // Only incomplete tasks
@@ -108,7 +108,7 @@ result.data.forEach((task) => {
 const result = await ctx.integrations.asana.apiRequest(
   {
     method: "PUT",
-    path: `/api/1.0/tasks/${taskId}`,
+    path: `/tasks/${taskId}`,
     body: {
       data: {
         completed: true,
@@ -126,7 +126,7 @@ const result = await ctx.integrations.asana.apiRequest(
 const result = await ctx.integrations.asana.apiRequest(
   {
     method: "PUT",
-    path: `/api/1.0/tasks/${taskId}`,
+    path: `/tasks/${taskId}`,
     body: {
       data: {
         assignee: userId, // User GID
@@ -154,7 +154,7 @@ const ListProjectsResponseSchema = z.object({
 const result = await ctx.integrations.asana.apiRequest(
   {
     method: "GET",
-    path: "/api/1.0/projects",
+    path: "/projects",
     params: {
       workspace: workspaceId,
       opt_fields: "name,archived,owner.name",
@@ -178,7 +178,7 @@ const CreateProjectResponseSchema = z.object({
 const result = await ctx.integrations.asana.apiRequest(
   {
     method: "POST",
-    path: "/api/1.0/projects",
+    path: "/projects",
     body: {
       data: {
         name: "Q1 Marketing Campaign",
@@ -207,7 +207,7 @@ const StoryResponseSchema = z.object({
 const result = await ctx.integrations.asana.apiRequest(
   {
     method: "POST",
-    path: `/api/1.0/tasks/${taskId}/stories`,
+    path: `/tasks/${taskId}/stories`,
     body: {
       data: {
         text: "Great progress on this task!",
@@ -233,7 +233,7 @@ const SearchResponseSchema = z.object({
 const result = await ctx.integrations.asana.apiRequest(
   {
     method: "GET",
-    path: "/api/1.0/workspaces/{workspace_gid}/tasks/search",
+    path: "/workspaces/{workspace_gid}/tasks/search",
     params: {
       "text.value": "urgent",
       completed: false,
@@ -252,7 +252,7 @@ const result = await ctx.integrations.asana.apiRequest(
 const result = await ctx.integrations.asana.apiRequest(
   {
     method: "GET",
-    path: `/api/1.0/tasks/${taskId}/subtasks`,
+    path: `/tasks/${taskId}/subtasks`,
     params: {
       opt_fields: "name,completed,assignee.name",
     },
@@ -276,7 +276,7 @@ await asana.getTasks({ ... });
 
 // CORRECT - Use apiRequest
 await ctx.integrations.asana.apiRequest(
-  { method: "POST", path: "/api/1.0/tasks", body: { data: { ... } } },
+  { method: "POST", path: "/tasks", body: { data: { ... } } },
   { response: CreateTaskResponseSchema }
 );
 ```
@@ -381,7 +381,7 @@ async function getAllTasks(asana: AsanaClient, projectId: string) {
     const result = await ctx.integrations.asana.apiRequest(
       {
         method: "GET",
-        path: `/api/1.0/projects/${projectId}/tasks`,
+        path: `/projects/${projectId}/tasks`,
         params: {
           limit: 100,
           ...(offset && { offset }),
@@ -405,7 +405,7 @@ import { RestApiValidationError } from "@superblocksteam/sdk-api";
 
 try {
   const result = await ctx.integrations.asana.apiRequest(
-    { method: "POST", path: "/api/1.0/tasks", body: { data: { ... } } },
+    { method: "POST", path: "/tasks", body: { data: { ... } } },
     { response: CreateTaskResponseSchema }
   );
 } catch (error) {

package/src/integrations/base/index.ts

@@ -2,8 +2,9 @@
  * Base clients for integrations.
  */
 
+export { RestApiClientBase } from "./rest-api-client-base.js";
 export { RestApiIntegrationClient } from "./rest-api-integration-client.js";
-export type { RestApiRequest } from "./rest-api-integration-client.js";
+export type { RestApiRequest } from "./rest-api-client-base.js";
 export { GraphQLIntegrationClient } from "./graphql-integration-client.js";
 export type {
   ApiRequestOptions,

package/src/integrations/base/rest-api-client-base.ts

@@ -0,0 +1,134 @@
+/**
+ * Abstract base for REST API Integration clients.
+ *
+ * Owns the shared infrastructure that every REST-API-backed integration
+ * needs: config storage, parameter helpers, body validation, request
+ * construction, and query execution. Subclasses add their own
+ * `apiRequest` with whatever response-handling strategy they need
+ * (e.g. direct Zod validation, discriminated-union wrapping).
+ */
+
+import type { PartialMessage } from "@bufbuild/protobuf";
+import { z } from "zod";
+
+import type { Property } from "@superblocksteam/types/dist/src/common/v1/plugin_pb";
+import type { Plugin as RestApiIntegrationPlugin } from "@superblocksteam/types/dist/src/plugins/restapiintegration/v1/plugin_pb";
+
+import { RestApiValidationError } from "../../errors.js";
+import type { QueryExecutor, TraceMetadata } from "../registry.js";
+import type { IntegrationConfig, IntegrationClientImpl } from "../types.js";
+import type { ApiRequestOptions } from "./types.js";
+
+export type RestApiRequest = PartialMessage<RestApiIntegrationPlugin>;
+
+/**
+ * Shared base for all REST API Integration clients.
+ *
+ * Provides config fields, parameter helpers, body validation, request
+ * building, and query execution. Does NOT define `apiRequest` — each
+ * concrete subclass supplies its own return-type contract.
+ */
+export abstract class RestApiClientBase implements IntegrationClientImpl {
+  readonly name: string;
+  readonly pluginId: string;
+  readonly config: IntegrationConfig;
+
+  protected readonly executeQuery: QueryExecutor;
+
+  constructor(config: IntegrationConfig, executeQuery: QueryExecutor) {
+    this.name = config.name;
+    this.pluginId = config.pluginId;
+    this.config = config;
+    this.executeQuery = executeQuery;
+  }
+
+  /**
+   * Create a Property object for query params / headers.
+   */
+  protected createParam(key: string, value: unknown): PartialMessage<Property> {
+    return {
+      key,
+      value: typeof value === "string" ? value : JSON.stringify(value),
+    };
+  }
+
+  /**
+   * Validate the request body, build the proto request, and execute it.
+   *
+   * Returns the raw (unvalidated) response from the orchestrator.
+   * Subclasses call this, then apply their own response handling.
+   *
+   * @param options - HTTP method, path, body, params, headers
+   * @param bodySchema - Optional Zod schema for body validation
+   * @param metadata - Optional trace metadata for observability
+   * @returns Raw response from the orchestrator
+   */
+  protected async executeApiRequest<TBody>(
+    options: ApiRequestOptions<TBody>,
+    bodySchema?: z.ZodSchema<TBody>,
+    metadata?: TraceMetadata,
+  ): Promise<unknown> {
+    // Validate request body if both body and schema are present.
+    if (options.body !== undefined && bodySchema) {
+      const bodyParseResult = bodySchema.safeParse(options.body);
+      if (!bodyParseResult.success) {
+        throw new RestApiValidationError(
+          `Request body validation failed: ${bodyParseResult.error.message}`,
+          {
+            zodError: bodyParseResult.error,
+            data: options.body,
+          },
+        );
+      }
+    }
+
+    const headers: PartialMessage<Property>[] = [];
+    if (options.headers) {
+      for (const [key, value] of Object.entries(options.headers)) {
+        headers.push(this.createParam(key, value));
+      }
+    }
+
+    const params: PartialMessage<Property>[] = [];
+    if (options.params) {
+      for (const [key, value] of Object.entries(options.params)) {
+        params.push(this.createParam(key, value));
+      }
+    }
+
+    const request: RestApiRequest = {
+      openApiAction: "genericHttpRequest",
+      httpMethod: options.method.toUpperCase(),
+      urlPath: options.path,
+      headers,
+      params,
+      responseType: "json",
+    };
+
+    if (options.body !== undefined) {
+      request.body = JSON.stringify(options.body);
+      request.bodyType = "jsonBody";
+    }
+
+    const result = await this.executeQuery(
+      request as Record<string, unknown>,
+      undefined,
+      metadata,
+    );
+
+    if (result === null || result === undefined) {
+      const nonNullResult = z.object({}).safeParse(result);
+      if (!nonNullResult.success) {
+        throw new RestApiValidationError(
+          `Integration query returned ${String(result)} — expected a JSON response object`,
+          {
+            zodError: nonNullResult.error,
+            data: result,
+          },
+        );
+      }
+    }
+
+    return result;
+  }
+}