@superblocksteam/sdk-api 2.0.89-next.0

package/dist/integrations/base/rest-api-integration-client.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Base client for REST API Integration (OpenAPI) based integrations.
+ *
+ * Provides common apiRequest() method for all OpenAPI-based plugins.
+ */
+import type { PartialMessage } from "@bufbuild/protobuf";
+import type { Plugin as RestApiIntegrationPlugin } from "@superblocksteam/types/dist/src/plugins/restapiintegration/v1/plugin_pb";
+import type { Property } from "@superblocksteam/types/dist/src/common/v1/plugin_pb";
+import type { IntegrationConfig, IntegrationClientImpl } from "../types.js";
+import type { QueryExecutor, StreamingQueryExecutor } from "../registry.js";
+import type { ApiRequestOptions, ApiRequestSchema, SupportsApiRequest, StreamApiRequestSchema, SupportsStreamingApiRequest } from "./types.js";
+import type { z } from "zod";
+export type RestApiRequest = PartialMessage<RestApiIntegrationPlugin>;
+/**
+ * Base implementation for REST API Integration clients.
+ *
+ * All OpenAPI-based integration clients extend this class to inherit
+ * the generic apiRequest() method with runtime schema validation.
+ * Also supports streaming API requests when a streaming executor is provided.
+ */
+export declare abstract class RestApiIntegrationClient implements IntegrationClientImpl, SupportsApiRequest, SupportsStreamingApiRequest {
+    readonly name: string;
+    readonly pluginId: string;
+    readonly config: IntegrationConfig;
+    protected readonly executeQuery: QueryExecutor;
+    protected readonly executeStreamingQuery?: StreamingQueryExecutor;
+    constructor(config: IntegrationConfig, executeQuery: QueryExecutor, executeStreamingQuery?: StreamingQueryExecutor);
+    /**
+     * Helper to create a Property object for params.
+     */
+    protected createParam(key: string, value: unknown): PartialMessage<Property>;
+    apiRequest<TBody, TResponse>(options: ApiRequestOptions<TBody>, schema: ApiRequestSchema<TBody, TResponse> & {
+        response: z.ZodSchema<TResponse>;
+    }): Promise<TResponse>;
+    /**
+     * Execute a streaming API request with type-safe chunk validation.
+     *
+     * Returns an AsyncIterable that yields validated chunks as they arrive.
+     * Each chunk is validated against the provided schema before being yielded.
+     *
+     * @param options - Request configuration including method, path, params, and body
+     * @param schema - Zod schemas for request body and chunk validation
+     * @returns AsyncIterable yielding validated chunks
+     *
+     * @example
+     * ```typescript
+     * const ChunkSchema = z.object({
+     *   id: z.string(),
+     *   choices: z.array(z.object({
+     *     delta: z.object({
+     *       content: z.string().optional(),
+     *     }),
+     *   })),
+     * });
+     *
+     * const stream = client.streamApiRequest(
+     *   {
+     *     method: 'POST',
+     *     path: '/v1/chat/completions',
+     *     body: {
+     *       model: 'gpt-4',
+     *       stream: true,
+     *       messages: [{ role: 'user', content: 'Hello!' }],
+     *     },
+     *   },
+     *   { chunk: ChunkSchema }
+     * );
+     *
+     * for await (const chunk of stream) {
+     *   console.log(chunk.choices[0]?.delta?.content);
+     * }
+     * ```
+     */
+    streamApiRequest<TBody, TChunk>(options: ApiRequestOptions<TBody>, schema: StreamApiRequestSchema<TBody, TChunk>): AsyncIterable<TChunk>;
+}
+//# sourceMappingURL=rest-api-integration-client.d.ts.map

package/dist/integrations/base/rest-api-integration-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-api-integration-client.d.ts","sourceRoot":"","sources":["../../../src/integrations/base/rest-api-integration-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,IAAI,wBAAwB,EAAE,MAAM,yEAAyE,CAAC;AAClI,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qDAAqD,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,wBAAwB,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,8BAAsB,wBACpB,YAAW,qBAAqB,EAAE,kBAAkB,EAAE,2BAA2B;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IAC/C,SAAS,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,sBAAsB,CAAC;gBAGhE,MAAM,EAAE,iBAAiB,EACzB,YAAY,EAAE,aAAa,EAC3B,qBAAqB,CAAC,EAAE,sBAAsB;IAShD;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC;IAOtE,UAAU,CAAC,KAAK,EAAE,SAAS,EAC/B,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACjC,MAAM,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG;QAAE,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;KAAE,GAChF,OAAO,CAAC,SAAS,CAAC;IAsFrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACI,gBAAgB,CAAC,KAAK,EAAE,MAAM,EACnC,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACjC,MAAM,EAAE,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,GAC5C,aAAa,CAAC,MAAM,CAAC;CAmGzB"}

package/dist/integrations/base/rest-api-integration-client.js

@@ -0,0 +1,221 @@
+/**
+ * Base client for REST API Integration (OpenAPI) based integrations.
+ *
+ * Provides common apiRequest() method for all OpenAPI-based plugins.
+ */
+import { RestApiValidationError, StreamChunkValidationError } from "../../errors.js";
+/**
+ * Base implementation for REST API Integration clients.
+ *
+ * All OpenAPI-based integration clients extend this class to inherit
+ * the generic apiRequest() method with runtime schema validation.
+ * Also supports streaming API requests when a streaming executor is provided.
+ */
+export class RestApiIntegrationClient {
+    name;
+    pluginId;
+    config;
+    executeQuery;
+    executeStreamingQuery;
+    constructor(config, executeQuery, executeStreamingQuery) {
+        this.name = config.name;
+        this.pluginId = config.pluginId;
+        this.config = config;
+        this.executeQuery = executeQuery;
+        this.executeStreamingQuery = executeStreamingQuery;
+    }
+    /**
+     * Helper to create a Property object for params.
+     */
+    createParam(key, value) {
+        return {
+            key,
+            value: typeof value === "string" ? value : JSON.stringify(value),
+        };
+    }
+    async apiRequest(options, schema) {
+        // Validate that body schema is provided if body is present
+        if (options.body !== undefined) {
+            if (!schema?.body) {
+                throw new RestApiValidationError("Body schema is required when body is provided in options", {
+                    zodError: {
+                        name: "ZodError",
+                        issues: [
+                            {
+                                code: "custom",
+                                path: ["body"],
+                                message: "Body provided but schema.body is null/undefined",
+                            },
+                        ],
+                    },
+                    data: options.body,
+                });
+            }
+            // Validate body against schema
+            const bodyParseResult = schema.body.safeParse(options.body);
+            if (!bodyParseResult.success) {
+                throw new RestApiValidationError(`Request body validation failed: ${bodyParseResult.error.message}`, {
+                    zodError: bodyParseResult.error,
+                    data: options.body,
+                });
+            }
+        }
+        // Convert headers to Property array
+        const headers = [];
+        if (options.headers) {
+            for (const [key, value] of Object.entries(options.headers)) {
+                headers.push(this.createParam(key, value));
+            }
+        }
+        // Convert query params to Property array
+        const params = [];
+        if (options.params) {
+            for (const [key, value] of Object.entries(options.params)) {
+                params.push(this.createParam(key, value));
+            }
+        }
+        // Build the request using raw HTTP mode
+        const request = {
+            openApiAction: "genericHttpRequest",
+            httpMethod: options.method.toUpperCase(),
+            urlPath: options.path,
+            headers,
+            params,
+            responseType: "json",
+        };
+        // Add body if provided
+        if (options.body !== undefined) {
+            request.body = JSON.stringify(options.body);
+            request.bodyType = "jsonBody";
+        }
+        // Execute the request
+        const result = await this.executeQuery(request);
+        // Response schema is REQUIRED - always validate
+        const responseParseResult = schema.response.safeParse(result);
+        if (!responseParseResult.success) {
+            throw new RestApiValidationError(`Response validation failed: ${responseParseResult.error.message}`, {
+                zodError: responseParseResult.error,
+                data: result,
+            });
+        }
+        return responseParseResult.data;
+    }
+    /**
+     * Execute a streaming API request with type-safe chunk validation.
+     *
+     * Returns an AsyncIterable that yields validated chunks as they arrive.
+     * Each chunk is validated against the provided schema before being yielded.
+     *
+     * @param options - Request configuration including method, path, params, and body
+     * @param schema - Zod schemas for request body and chunk validation
+     * @returns AsyncIterable yielding validated chunks
+     *
+     * @example
+     * ```typescript
+     * const ChunkSchema = z.object({
+     *   id: z.string(),
+     *   choices: z.array(z.object({
+     *     delta: z.object({
+     *       content: z.string().optional(),
+     *     }),
+     *   })),
+     * });
+     *
+     * const stream = client.streamApiRequest(
+     *   {
+     *     method: 'POST',
+     *     path: '/v1/chat/completions',
+     *     body: {
+     *       model: 'gpt-4',
+     *       stream: true,
+     *       messages: [{ role: 'user', content: 'Hello!' }],
+     *     },
+     *   },
+     *   { chunk: ChunkSchema }
+     * );
+     *
+     * for await (const chunk of stream) {
+     *   console.log(chunk.choices[0]?.delta?.content);
+     * }
+     * ```
+     */
+    async *streamApiRequest(options, schema) {
+        // Validate that streaming is supported
+        if (!this.executeStreamingQuery) {
+            throw new Error(`Streaming is not supported for integration "${this.name}". ` +
+                "The orchestrator must provide a streaming query executor.");
+        }
+        // Validate that body schema is provided if body is present
+        if (options.body !== undefined) {
+            if (!schema?.body) {
+                throw new RestApiValidationError("Body schema is required when body is provided in options", {
+                    zodError: {
+                        name: "ZodError",
+                        issues: [
+                            {
+                                code: "custom",
+                                path: ["body"],
+                                message: "Body provided but schema.body is null/undefined",
+                            },
+                        ],
+                    },
+                    data: options.body,
+                });
+            }
+            const bodyParseResult = schema.body.safeParse(options.body);
+            if (!bodyParseResult.success) {
+                throw new RestApiValidationError(`Request body validation failed: ${bodyParseResult.error.message}`, {
+                    zodError: bodyParseResult.error,
+                    data: options.body,
+                });
+            }
+        }
+        // Convert headers to Property array
+        const headers = [];
+        if (options.headers) {
+            for (const [key, value] of Object.entries(options.headers)) {
+                headers.push(this.createParam(key, value));
+            }
+        }
+        // Convert query params to Property array
+        const params = [];
+        if (options.params) {
+            for (const [key, value] of Object.entries(options.params)) {
+                params.push(this.createParam(key, value));
+            }
+        }
+        // Build the request using raw HTTP mode with streaming response
+        // Note: responseType must be "raw" for streaming - the orchestrator's
+        // Stream block expects SSE responses and only works with "raw" type.
+        const request = {
+            openApiAction: "genericHttpRequest",
+            httpMethod: options.method.toUpperCase(),
+            urlPath: options.path,
+            headers,
+            params,
+            responseType: "raw",
+        };
+        // Add body if provided
+        if (options.body !== undefined) {
+            request.body = JSON.stringify(options.body);
+            request.bodyType = "jsonBody";
+        }
+        // Execute the streaming request
+        const stream = this.executeStreamingQuery(request);
+        // Validate and yield each chunk
+        let chunkIndex = 0;
+        for await (const rawChunk of stream) {
+            const parseResult = schema.chunk.safeParse(rawChunk);
+            if (!parseResult.success) {
+                throw new StreamChunkValidationError(`Chunk validation failed at index ${chunkIndex}: ${parseResult.error.message}`, {
+                    chunkIndex,
+                    chunk: rawChunk,
+                    zodError: parseResult.error,
+                });
+            }
+            yield parseResult.data;
+            chunkIndex++;
+        }
+    }
+}
+//# sourceMappingURL=rest-api-integration-client.js.map

package/dist/integrations/base/rest-api-integration-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-api-integration-client.js","sourceRoot":"","sources":["../../../src/integrations/base/rest-api-integration-client.ts"],"names":[],"mappings":"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"}

package/dist/integrations/base/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Shared types for REST API Integration (OpenAPI) based clients.
+ */
+import type { z } from 'zod';
+/**
+ * Options for making a generic REST API request.
+ */
+export interface ApiRequestOptions<TBody = unknown> {
+    /**
+     * HTTP method for the request.
+     */
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+    /**
+     * API endpoint path (e.g., "/users", "/repos/owner/repo")
+     */
+    path: string;
+    /**
+     * Optional request body (for POST, PUT, PATCH requests).
+     * Type is inferred from bodySchema parameter.
+     */
+    body?: TBody;
+    /**
+     * Optional query parameters
+     */
+    params?: Record<string, unknown>;
+    /**
+     * Optional HTTP headers
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * Schema configuration for API request validation.
+ */
+export interface ApiRequestSchema<TBody = unknown, TResponse = unknown> {
+    /**
+     * Optional Zod schema for request body validation.
+     * Required if body is provided in options.
+     */
+    body?: z.ZodSchema<TBody>;
+    /**
+     * Optional Zod schema for response validation.
+     * If not provided, response is returned without validation.
+     */
+    response?: z.ZodSchema<TResponse>;
+}
+/**
+ * Interface for integration clients that support generic API requests.
+ *
+ * All API requests require response schema validation for type safety.
+ */
+export interface SupportsApiRequest {
+    /**
+     * Execute a generic API request with type-safe validation.
+     *
+     * @param options - Request configuration including method, path, params, and body
+     * @param schema - Zod schemas for request body and response validation (response schema REQUIRED)
+     * @returns Validated response data
+     *
+     * @example
+     * ```typescript
+     * const client = ctx.slack('Ops Slack');
+     *
+     * const ResponseSchema = z.object({
+     *   ts: z.string(),
+     *   channel: z.string(),
+     * });
+     *
+     * const result = await client.apiRequest(
+     *   {
+     *     method: 'POST',
+     *     path: '/chat.postMessage',
+     *     body: {
+     *       channel: '#alerts',
+     *       text: 'Hello!',
+     *     },
+     *   },
+     *   {
+     *     body: z.object({
+     *       channel: z.string(),
+     *       text: z.string(),
+     *     }),
+     *     response: ResponseSchema,
+     *   }
+     * );
+     * // result is typed as { ts: string; channel: string }
+     * ```
+     */
+    apiRequest<TBody, TResponse>(options: ApiRequestOptions<TBody>, schema: ApiRequestSchema<TBody, TResponse> & {
+        response: z.ZodSchema<TResponse>;
+    }): Promise<TResponse>;
+}
+/**
+ * Schema configuration for streaming API request validation.
+ */
+export interface StreamApiRequestSchema<TBody = unknown, TChunk = unknown> {
+    /**
+     * Optional Zod schema for request body validation.
+     * Required if body is provided in options.
+     */
+    body?: z.ZodSchema<TBody>;
+    /**
+     * Zod schema for validating each streamed chunk.
+     *
+     * Every chunk received from the stream is validated against this schema.
+     * Validation errors will terminate the stream.
+     */
+    chunk: z.ZodSchema<TChunk>;
+}
+/**
+ * Interface for integration clients that support streaming API requests.
+ *
+ * Streaming API requests return an AsyncIterable of validated chunks,
+ * enabling real-time data streaming from LLMs and other sources.
+ */
+export interface SupportsStreamingApiRequest {
+    /**
+     * Execute a streaming API request with type-safe chunk validation.
+     *
+     * Returns an AsyncIterable that yields validated chunks as they arrive.
+     * Each chunk is validated against the provided schema before being yielded.
+     *
+     * @param options - Request configuration including method, path, params, and body
+     * @param schema - Zod schemas for request body and chunk validation (chunk schema REQUIRED)
+     * @returns AsyncIterable yielding validated chunks
+     *
+     * @example
+     * ```typescript
+     * const ChunkSchema = z.object({
+     *   id: z.string(),
+     *   choices: z.array(z.object({
+     *     delta: z.object({
+     *       content: z.string().optional(),
+     *     }),
+     *   })),
+     * });
+     *
+     * const stream = client.streamApiRequest(
+     *   {
+     *     method: 'POST',
+     *     path: '/v1/chat/completions',
+     *     body: {
+     *       model: 'gpt-4',
+     *       stream: true,
+     *       messages: [{ role: 'user', content: 'Hello!' }],
+     *     },
+     *   },
+     *   { chunk: ChunkSchema }
+     * );
+     *
+     * for await (const chunk of stream) {
+     *   console.log(chunk.choices[0]?.delta?.content);
+     * }
+     * ```
+     */
+    streamApiRequest<TBody, TChunk>(options: ApiRequestOptions<TBody>, schema: StreamApiRequestSchema<TBody, TChunk>): AsyncIterable<TChunk>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/integrations/base/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/base/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,KAAK,GAAG,OAAO;IAChD;;OAEG;IACH,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAEzE;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO;IACpE;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,EACzB,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACjC,MAAM,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,GAAG;QAAE,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;KAAE,GAChF,OAAO,CAAC,SAAS,CAAC,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,KAAK,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IACvE;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAE1B;;;;;OAKG;IACH,KAAK,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsCG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAC5B,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,EACjC,MAAM,EAAE,sBAAsB,CAAC,KAAK,EAAE,MAAM,CAAC,GAC5C,aAAa,CAAC,MAAM,CAAC,CAAC;CAC1B"}

package/dist/integrations/base/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for REST API Integration (OpenAPI) based clients.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/integrations/base/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/integrations/base/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,37 @@
+/**
+ * BigQuery integration client implementation.
+ *
+ * Executes BigQuery queries through the Superblocks orchestrator with
+ * runtime validation using Zod schemas.
+ */
+import type { z } from 'zod';
+import type { IntegrationConfig, IntegrationClientImpl } from '../types.js';
+import type { QueryExecutor } from '../registry.js';
+import type { BigQueryClient } from './types.js';
+/**
+ * Internal implementation of the BigQuery client.
+ */
+export declare class BigQueryClientImpl implements BigQueryClient, IntegrationClientImpl {
+    readonly config: IntegrationConfig;
+    private readonly executeQuery;
+    constructor(config: IntegrationConfig, executeQuery: QueryExecutor);
+    get name(): string;
+    get pluginId(): string;
+    /**
+     * Builds a BigQuery request object from SQL and parameters.
+     *
+     * When params are provided, the SQL body is sent with placeholders intact
+     * 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 placeholders
+     * @param params - Optional array of parameter values for server-side binding
+     * @returns The plugin request object
+     */
+    private buildRequest;
+    query<T>(sql: string, schema: z.ZodSchema<T>, params?: unknown[]): Promise<T[]>;
+    execute(sql: string, params?: unknown[]): Promise<{
+        rowCount: number;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/integrations/bigquery/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/integrations/bigquery/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,qBAAa,kBAAmB,YAAW,cAAc,EAAE,qBAAqB;IAC9E,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;gBAEjC,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa;IAKlE,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,YAAY;IAYd,KAAK,CAAC,CAAC,EACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,CAAC,EAAE,CAAC;IAiDT,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAmB9E"}

package/dist/integrations/bigquery/client.js

@@ -0,0 +1,93 @@
+/**
+ * BigQuery integration client implementation.
+ *
+ * Executes BigQuery queries through the Superblocks orchestrator with
+ * runtime validation using Zod schemas.
+ */
+import { QueryValidationError } from '../../errors.js';
+import { IntegrationError } from '../../runtime/errors.js';
+import { describeType } from '../utils.js';
+/**
+ * Internal implementation of the BigQuery client.
+ */
+export class BigQueryClientImpl {
+    config;
+    executeQuery;
+    constructor(config, executeQuery) {
+        this.config = config;
+        this.executeQuery = executeQuery;
+    }
+    get name() {
+        return this.config.name;
+    }
+    get pluginId() {
+        return this.config.pluginId;
+    }
+    /**
+     * Builds a BigQuery request object from SQL and parameters.
+     *
+     * When params are provided, the SQL body is sent with placeholders intact
+     * 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 placeholders
+     * @param params - Optional array of parameter values for server-side binding
+     * @returns The plugin request object
+     */
+    buildRequest(sql, params) {
+        const hasParams = params && params.length > 0;
+        return {
+            body: sql,
+            parameters: hasParams ? JSON.stringify(params) : undefined,
+        };
+    }
+    async query(sql, schema, params) {
+        const request = this.buildRequest(sql, params);
+        try {
+            const result = await this.executeQuery(request);
+            if (!Array.isArray(result)) {
+                throw new IntegrationError(this.config.name, 'query', `Expected array result from BigQuery query, got: ${describeType(result)}`);
+            }
+            const validated = [];
+            for (let i = 0; i < result.length; i++) {
+                const row = result[i];
+                const parseResult = schema.safeParse(row);
+                if (!parseResult.success) {
+                    throw new QueryValidationError(`Row ${i} validation failed: ${parseResult.error.message}`, {
+                        rowIndex: i,
+                        errors: parseResult.error.errors.map((err) => ({
+                            path: err.path,
+                            message: err.message,
+                        })),
+                        row,
+                    });
+                }
+                validated.push(parseResult.data);
+            }
+            return validated;
+        }
+        catch (error) {
+            if (error instanceof QueryValidationError ||
+                error instanceof IntegrationError) {
+                throw error;
+            }
+            throw new IntegrationError(this.config.name, 'query', error);
+        }
+    }
+    async execute(sql, params) {
+        const request = this.buildRequest(sql, params);
+        try {
+            const result = await this.executeQuery(request);
+            if (typeof result === 'object' &&
+                result !== null &&
+                'rowCount' in result) {
+                return { rowCount: Number(result.rowCount) || 0 };
+            }
+            return { rowCount: 0 };
+        }
+        catch (error) {
+            throw new IntegrationError(this.config.name, 'execute', error);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/integrations/bigquery/client.js.map

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

package/dist/integrations/bigquery/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * BigQuery integration client.
+ *
+ * @module
+ */
+export type { BigQueryClient } from './types.js';
+export { BigQueryClientImpl } from './client.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/bigquery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/bigquery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/integrations/bigquery/index.js

@@ -0,0 +1,7 @@
+/**
+ * BigQuery integration client.
+ *
+ * @module
+ */
+export { BigQueryClientImpl } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/bigquery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/bigquery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}