@superblocksteam/sdk-api 2.0.99-next.0 → 2.0.100-next.0

package/src/integrations/gcs/client.ts

@@ -127,11 +127,7 @@ export class GCSClientImpl implements GCSClient, IntegrationClientImpl {
         request.prefix = options.prefix;
       }
 
-      const result = await this.execute(
-        "LIST_BUCKET_OBJECTS",
-        request,
-        metadata,
-      );
+      const result = await this.execute("LIST_OBJECTS", request, metadata);
       return this.validate(result, schema, "listObjects");
     });
   }

package/src/integrations/index.ts

@@ -81,6 +81,7 @@ export {
   lakebase,
   snowflakePostgres,
   smtp,
+  restApiIntegration,
   // Utility functions
   extractIntegrationDeclarations,
   getIntegrationDeclarations,
@@ -157,6 +158,7 @@ export {
   type LakebaseRef,
   type SnowflakePostgresRef,
   type SmtpRef,
+  type RestApiIntegrationRef,
 } from "./declarations.js";
 
 // Registry and factory
@@ -467,4 +469,8 @@ export { SnowflakePostgresClientImpl } from "./snowflakepostgres/index.js";
 export type { SmtpClient, SmtpSendOptions } from "./smtp/index.js";
 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/python/client.test.ts

@@ -36,9 +36,11 @@ describe("PythonClientImpl", () => {
         z.object({ result: z.number() }),
       );
 
-      expect(mockExecutor).toHaveBeenCalledWith({
-        body: 'return {"result": 42}',
-      });
+      expect(mockExecutor).toHaveBeenCalledWith(
+        { body: 'return {"result": 42}' },
+        undefined,
+        undefined,
+      );
     });
 
     it("injects string bindings as Python variables", async () => {

package/src/integrations/redis/client.ts

@@ -103,7 +103,16 @@ export class RedisClientImpl implements RedisClient, IntegrationClientImpl {
     metadata?: TraceMetadata,
   ): Promise<T> {
     const request = buildRawRequest(command);
-    const result = await this.exec(request, "command", metadata);
+    const rawResult = await this.exec(request, "command", metadata);
+
+    // The Redis plugin wraps raw command results in { response: ... }.
+    // Unwrap to the actual value so callers can validate against the expected type.
+    const result =
+      rawResult !== null &&
+      typeof rawResult === "object" &&
+      "response" in (rawResult as object)
+        ? (rawResult as { response: unknown }).response
+        : rawResult;
 
     const parseResult = schema.safeParse(result);
 

package/src/integrations/registry.ts

@@ -71,6 +71,8 @@ import { SuperblocksOCRClientImpl } from "./superblocks-ocr/index.js";
 import { LakebaseClientImpl } from "./lakebase/index.js";
 import { SnowflakePostgresClientImpl } from "./snowflakepostgres/index.js";
 import { SmtpClientImpl } from "./smtp/index.js";
+// REST API plugins
+import { RestApiIntegrationPluginClientImpl } from "./restapiintegration/index.js";
 // Code execution clients
 import { PythonClientImpl } from "./python/index.js";
 
@@ -148,6 +150,8 @@ export const SUPPORTED_PLUGINS = {
   snowflakepostgres: "snowflakepostgres",
   // Email
   smtp: "smtp",
+  // REST API plugins
+  restapiintegration: "restapiintegration",
   // Code execution
   python: "python",
 } as const;
@@ -514,6 +518,13 @@ export function createClient(
     case SUPPORTED_PLUGINS.smtp:
       return new SmtpClientImpl(config, executeQuery);
 
+    case SUPPORTED_PLUGINS.restapiintegration:
+      return new RestApiIntegrationPluginClientImpl(
+        config,
+        executeQuery,
+        executeStreamingQuery,
+      );
+
     case SUPPORTED_PLUGINS.python:
       return new PythonClientImpl(config, executeQuery);
 

package/src/integrations/restapiintegration/client.ts

@@ -0,0 +1,21 @@
+/**
+ * REST API Integration client implementation.
+ *
+ * Uses the proto-generated REST API Integration Plugin type from @superblocksteam/types.
+ * This is the generic REST API Integration plugin that users configure with a base URL
+ * and authentication in the integrations page.
+ */
+
+import { RestApiIntegrationClient } from "../base/index.js";
+import type { RestApiIntegrationPluginClient } from "./types.js";
+
+/**
+ * Internal implementation of RestApiIntegrationPluginClient.
+ *
+ * Extends RestApiIntegrationClient to inherit the generic apiRequest() method.
+ * At runtime, the orchestrator handles base URL resolution, authentication,
+ * and API request execution.
+ */
+export class RestApiIntegrationPluginClientImpl
+  extends RestApiIntegrationClient
+  implements RestApiIntegrationPluginClient {}

package/src/integrations/restapiintegration/index.ts

@@ -0,0 +1,6 @@
+/**
+ * REST API Integration module.
+ */
+
+export type { RestApiIntegrationPluginClient } from "./types.js";
+export { RestApiIntegrationPluginClientImpl } from "./client.js";

package/src/integrations/restapiintegration/types.ts

@@ -0,0 +1,40 @@
+/**
+ * REST API Integration client types.
+ */
+
+import type { BaseIntegrationClient } from "../../types.js";
+import type {
+  SupportsApiRequest,
+  SupportsStreamingApiRequest,
+} from "../base/index.js";
+
+/**
+ * REST API Integration client for making HTTP requests to configured endpoints.
+ *
+ * This is the generic REST API Integration plugin. Use apiRequest() to make
+ * HTTP calls to any endpoint configured on the integration (base URL, auth, etc.).
+ *
+ * @example
+ * ```typescript
+ * // Declare in api(): integrations: { myApi: restApiIntegration(INTEGRATION_ID) }
+ * // In run(), access via: ctx.integrations.myApi
+ *
+ * const ResponseSchema = z.object({
+ *   data: z.array(z.object({ id: z.string(), name: z.string() })),
+ * });
+ *
+ * const result = await ctx.integrations.myApi.apiRequest(
+ *   {
+ *     method: 'GET',
+ *     path: '/users',
+ *     params: { limit: 10 },
+ *   },
+ *   { response: ResponseSchema },
+ * );
+ * ```
+ */
+export interface RestApiIntegrationPluginClient
+  extends
+    BaseIntegrationClient,
+    SupportsApiRequest,
+    SupportsStreamingApiRequest {}

package/src/integrations/snowflake/README.md

@@ -40,7 +40,7 @@ export default api({
   }),
   async run(ctx, { status }) {
     const users = await ctx.integrations.snowflake.query(
-      "SELECT ID, NAME, EMAIL, CREATED_AT FROM USERS WHERE STATUS = $1",
+      "SELECT ID, NAME, EMAIL, CREATED_AT FROM USERS WHERE STATUS = ?",
       UserSchema,
       [status],
     );
@@ -66,7 +66,7 @@ const users = await ctx.integrations.snowflake.query(
     NAME as "name",
     EMAIL as "email"
   FROM USERS
-  WHERE STATUS = $1`,
+  WHERE STATUS = ?`,
   UserSchema,
   ["active"],
 );
@@ -77,13 +77,13 @@ const users = await ctx.integrations.snowflake.query(
 ```typescript
 // INSERT
 await ctx.integrations.snowflake.execute(
-  "INSERT INTO USERS (NAME, EMAIL) VALUES ($1, $2)",
+  "INSERT INTO USERS (NAME, EMAIL) VALUES (?, ?)",
   ["John Doe", "john@example.com"],
 );
 
 // UPDATE
 const updateResult = await ctx.integrations.snowflake.execute(
-  "UPDATE USERS SET LAST_LOGIN = CURRENT_TIMESTAMP() WHERE ID = $1",
+  "UPDATE USERS SET LAST_LOGIN = CURRENT_TIMESTAMP() WHERE ID = ?",
   [userId],
 );
 console.log(`Updated ${updateResult.rowCount} rows`);
@@ -137,7 +137,7 @@ const events = await ctx.integrations.snowflake.query(
     EVENT_TYPE,
     PARSE_JSON(PAYLOAD) as PAYLOAD
   FROM EVENTS
-  WHERE EVENT_TYPE = $1`,
+  WHERE EVENT_TYPE = ?`,
   EventSchema,
   ["user_action"],
 );
@@ -212,7 +212,7 @@ const stats = await ctx.integrations.snowflake.query(
     SUM(AMOUNT) as TOTAL_REVENUE,
     AVG(AMOUNT) as AVG_ORDER_VALUE
   FROM ORDERS
-  WHERE CREATED_AT > $1`,
+  WHERE CREATED_AT > ?`,
   StatsSchema,
   [startDate],
 );
@@ -249,7 +249,7 @@ const users = await ctx.integrations.snowflake.query("SELECT * FROM USERS", [
 
 // CORRECT - Schema is required as second parameter
 const users = await ctx.integrations.snowflake.query(
-  "SELECT * FROM USERS WHERE ID = $1",
+  "SELECT * FROM USERS WHERE ID = ?",
   UserSchema,
   [userId],
 );

package/src/integrations/snowflake/types.ts

@@ -24,7 +24,7 @@ import type { TraceMetadata } from "../registry.js";
  * });
  *
  * const users = await snowflake.query(
- *   'SELECT * FROM users WHERE status = $1',
+ *   'SELECT * FROM users WHERE status = ?',
  *   UserSchema,
  *   ['active']
  * );
@@ -34,7 +34,7 @@ export interface SnowflakeClient extends BaseIntegrationClient {
   /**
    * Execute a SQL query and validate results against a Zod schema.
    *
-   * @param sql - SQL query string (use $1, $2, etc. for parameters)
+   * @param sql - SQL query string (use ? placeholders for parameters)
    * @param schema - Zod schema to validate the query results
    * @param params - Optional query parameters
    * @returns Promise resolving to validated query results
@@ -51,7 +51,7 @@ export interface SnowflakeClient extends BaseIntegrationClient {
    * });
    *
    * const users = await snowflake.query(
-   *   'SELECT * FROM users WHERE status = $1',
+   *   'SELECT * FROM users WHERE status = ?',
    *   UserSchema,
    *   ['active']
    * );
@@ -74,7 +74,7 @@ export interface SnowflakeClient extends BaseIntegrationClient {
    * @example
    * ```typescript
    * const result = await snowflake.execute(
-   *   'UPDATE users SET last_login = CURRENT_TIMESTAMP() WHERE id = $1',
+   *   'UPDATE users SET last_login = CURRENT_TIMESTAMP() WHERE id = ?',
    *   [userId]
    * );
    * console.log(`Updated ${result.rowCount} rows`);