@superblocksteam/sdk-api 2.0.89-next.0

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

@@ -0,0 +1,68 @@
+/**
+ * Python code execution client types.
+ */
+import type { z } from 'zod';
+import type { BaseIntegrationClient } from '../../types.js';
+/**
+ * Python code execution client.
+ *
+ * Executes Python scripts with type-safe inputs and outputs.
+ * Bindings are passed as a map and referenced in code using {{key}} syntax.
+ * The orchestrator resolves bindings before execution.
+ *
+ * @example
+ * ```typescript
+ * const python = ctx.python('Python Runtime');
+ *
+ * const result = await python.run(
+ *   `
+ *   import time
+ *
+ *   user_id = {{userId}}
+ *   current_time = int(time.time())
+ *
+ *   return {
+ *     "greeting": f"Hello user {user_id}!",
+ *     "timestamp": current_time
+ *   }
+ *   `,
+ *   z.object({
+ *     greeting: z.string(),
+ *     timestamp: z.number(),
+ *   }),
+ *   {
+ *     userId,
+ *   }
+ * );
+ * ```
+ */
+export interface PythonClient extends BaseIntegrationClient {
+    /**
+     * Execute Python code with validated output.
+     *
+     * The Python code must return a value using a `return` statement.
+     * Bindings are referenced using {{key}} syntax and resolved by the
+     * orchestrator before execution.
+     *
+     * @param code - Python script to execute (use {{key}} for bindings)
+     * @param schema - Zod schema for validating the return value
+     * @param bindings - Optional key/value pairs accessible via {{key}} in code
+     * @returns Validated result matching the schema
+     *
+     * @throws {CodeExecutionError} If execution fails or validation fails
+     *
+     * @example
+     * ```typescript
+     * const result = await python.run(
+     *   `
+     *   user_id = {{userId}}
+     *   return {"message": f"Hello {user_id}"}
+     *   `,
+     *   z.object({ message: z.string() }),
+     *   { userId: "123" }
+     * );
+     * ```
+     */
+    run<T>(code: string, schema: z.ZodSchema<T>, bindings?: Record<string, unknown>): Promise<T>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/python/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,YAAa,SAAQ,qBAAqB;IACzD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,GAAG,CAAC,CAAC,EACH,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC,CAAC;CACf"}

package/dist/integrations/python/types.js

@@ -0,0 +1,5 @@
+/**
+ * Python code execution client types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * Redis client implementation.
+ *
+ * Uses the native Redis plugin type from @superblocksteam/types.
+ * Supports raw Redis commands and typed structured operations
+ * (get, set, del, keys, hget, hset, hgetall, etc.).
+ *
+ * Request format matches the Redis plugin proto's oneof structure:
+ * - Raw: `{ raw: { singleton: { query: "..." } } }`
+ * - Structured: `{ structured: { set: { key: "...", value: "..." } } }`
+ */
+import type { z } from 'zod';
+import type { IntegrationConfig, IntegrationClientImpl } from '../types.js';
+import type { QueryExecutor } from '../registry.js';
+import type { RedisClient } from './types.js';
+/**
+ * Internal implementation of RedisClient.
+ *
+ * Provides both raw and structured Redis command execution.
+ */
+export declare class RedisClientImpl implements RedisClient, IntegrationClientImpl {
+    readonly config: IntegrationConfig;
+    private readonly executeQuery;
+    constructor(config: IntegrationConfig, executeQuery: QueryExecutor);
+    get name(): string;
+    get pluginId(): string;
+    /**
+     * Execute a request and wrap errors.
+     */
+    private exec;
+    command<T>(command: string, schema: z.ZodSchema<T>): Promise<T>;
+    get(key: string): Promise<unknown>;
+    set(key: string, value: string, expirationMs?: number): Promise<unknown>;
+    del(key: string): Promise<unknown>;
+    keys(pattern: string): Promise<unknown>;
+    hget(key: string, field: string): Promise<unknown>;
+    hset(key: string, field: string, value: string): Promise<unknown>;
+    hgetall(key: string): Promise<unknown>;
+    hdel(key: string, field: string): Promise<unknown>;
+    expire(key: string, seconds: number): Promise<unknown>;
+    ttl(key: string): Promise<unknown>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/integrations/redis/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAsC9C;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,WAAW,EAAE,qBAAqB;IACxE,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;;OAEG;YACW,IAAI;IAkBZ,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmB/D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASxE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKvC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAIzC"}

package/dist/integrations/redis/client.js

@@ -0,0 +1,135 @@
+/**
+ * Redis client implementation.
+ *
+ * Uses the native Redis plugin type from @superblocksteam/types.
+ * Supports raw Redis commands and typed structured operations
+ * (get, set, del, keys, hget, hset, hgetall, etc.).
+ *
+ * Request format matches the Redis plugin proto's oneof structure:
+ * - Raw: `{ raw: { singleton: { query: "..." } } }`
+ * - Structured: `{ structured: { set: { key: "...", value: "..." } } }`
+ */
+import { RestApiValidationError } from '../../errors.js';
+import { IntegrationError } from '../../runtime/errors.js';
+/**
+ * Build a raw Redis command request matching the proto JSON format.
+ *
+ * Proto structure: `oneof command_type { Raw raw = 3; }`
+ * Raw structure: `oneof action { Singleton singleton = 1; }`
+ */
+function buildRawRequest(command) {
+    return {
+        raw: {
+            singleton: {
+                query: command,
+            },
+        },
+    };
+}
+/**
+ * Build a structured Redis command request matching the proto JSON format.
+ *
+ * Proto structure: `oneof command_type { Structured structured = 4; }`
+ * Structured structure: `oneof action { Get get = 6; Set set = 7; ... }`
+ *
+ * @param actionName - The structured action name (e.g., 'get', 'set')
+ * @param value - The action-specific parameters
+ */
+function buildStructuredRequest(actionName, value) {
+    return {
+        structured: {
+            [actionName]: value,
+        },
+    };
+}
+/**
+ * Internal implementation of RedisClient.
+ *
+ * Provides both raw and structured Redis command execution.
+ */
+export class RedisClientImpl {
+    config;
+    executeQuery;
+    constructor(config, executeQuery) {
+        this.config = config;
+        this.executeQuery = executeQuery;
+    }
+    get name() {
+        return this.config.name;
+    }
+    get pluginId() {
+        return this.config.pluginId;
+    }
+    /**
+     * Execute a request and wrap errors.
+     */
+    async exec(request, operation) {
+        try {
+            return await this.executeQuery(request);
+        }
+        catch (error) {
+            if (error instanceof RestApiValidationError ||
+                error instanceof IntegrationError) {
+                throw error;
+            }
+            throw new IntegrationError(this.config.name, operation, error);
+        }
+    }
+    async command(command, schema) {
+        const request = buildRawRequest(command);
+        const result = await this.exec(request, 'command');
+        const parseResult = schema.safeParse(result);
+        if (!parseResult.success) {
+            throw new RestApiValidationError(`Result validation failed: ${parseResult.error.message}`, {
+                zodError: parseResult.error,
+                data: result,
+            });
+        }
+        return parseResult.data;
+    }
+    async get(key) {
+        const request = buildStructuredRequest('get', { key });
+        return this.exec(request, 'get');
+    }
+    async set(key, value, expirationMs) {
+        const params = { key, value };
+        if (expirationMs !== undefined) {
+            params.expirationMs = expirationMs;
+        }
+        const request = buildStructuredRequest('set', params);
+        return this.exec(request, 'set');
+    }
+    async del(key) {
+        const request = buildStructuredRequest('del', { key });
+        return this.exec(request, 'del');
+    }
+    async keys(pattern) {
+        const request = buildStructuredRequest('keys', { pattern });
+        return this.exec(request, 'keys');
+    }
+    async hget(key, field) {
+        const request = buildStructuredRequest('hget', { key, field });
+        return this.exec(request, 'hget');
+    }
+    async hset(key, field, value) {
+        const request = buildStructuredRequest('hset', { key, field, value });
+        return this.exec(request, 'hset');
+    }
+    async hgetall(key) {
+        const request = buildStructuredRequest('hgetall', { key });
+        return this.exec(request, 'hgetall');
+    }
+    async hdel(key, field) {
+        const request = buildStructuredRequest('hdel', { key, field });
+        return this.exec(request, 'hdel');
+    }
+    async expire(key, seconds) {
+        const request = buildStructuredRequest('expire', { key, seconds });
+        return this.exec(request, 'expire');
+    }
+    async ttl(key) {
+        const request = buildStructuredRequest('ttl', { key });
+        return this.exec(request, 'ttl');
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

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

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

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

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

package/dist/integrations/redis/index.js

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

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

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

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

@@ -0,0 +1,125 @@
+/**
+ * Redis client types.
+ */
+import type { z } from 'zod';
+import type { BaseIntegrationClient } from '../../types.js';
+/**
+ * Redis client for executing commands.
+ *
+ * Provides typed methods for common Redis operations as well as a
+ * generic command() method for executing raw Redis commands.
+ *
+ * @example
+ * ```typescript
+ * const redis = ctx.redis('Production Redis');
+ *
+ * // Typed string operations
+ * await redis.set('user:1', 'Alice');
+ * const name = await redis.get('user:1');
+ *
+ * // Typed hash operations
+ * await redis.hset('user:1', 'name', 'Alice');
+ * const val = await redis.hget('user:1', 'name');
+ * const all = await redis.hgetall('user:1');
+ *
+ * // Key operations
+ * await redis.del('user:1');
+ * const userKeys = await redis.keys('user:*');
+ *
+ * // Raw command for anything not covered by typed methods
+ * const result = await redis.command(
+ *   'LRANGE mylist 0 -1',
+ *   z.array(z.string())
+ * );
+ * ```
+ */
+export interface RedisClient extends BaseIntegrationClient {
+    /**
+     * Execute a raw Redis command.
+     *
+     * Use this for commands not covered by the typed methods.
+     *
+     * @param command - The Redis command string (e.g., "LRANGE mylist 0 -1")
+     * @param schema - Zod schema for validating the result
+     * @returns The validated result
+     */
+    command<T>(command: string, schema: z.ZodSchema<T>): Promise<T>;
+    /**
+     * Get the value of a key.
+     *
+     * @param key - The key to get
+     * @returns The value, or null if the key does not exist
+     */
+    get(key: string): Promise<unknown>;
+    /**
+     * Set the value of a key.
+     *
+     * @param key - The key to set
+     * @param value - The value to set
+     * @param expirationMs - Optional expiration time in milliseconds
+     * @returns The result (typically "OK")
+     */
+    set(key: string, value: string, expirationMs?: number): Promise<unknown>;
+    /**
+     * Delete a key.
+     *
+     * @param key - The key to delete
+     * @returns The number of keys removed
+     */
+    del(key: string): Promise<unknown>;
+    /**
+     * Find all keys matching a pattern.
+     *
+     * @param pattern - The glob-style pattern to match (e.g., "user:*")
+     * @returns Array of matching keys
+     */
+    keys(pattern: string): Promise<unknown>;
+    /**
+     * Get the value of a hash field.
+     *
+     * @param key - The hash key
+     * @param field - The field name
+     * @returns The field value, or null if the field does not exist
+     */
+    hget(key: string, field: string): Promise<unknown>;
+    /**
+     * Set the value of a hash field.
+     *
+     * @param key - The hash key
+     * @param field - The field name
+     * @param value - The value to set
+     * @returns The number of fields that were added
+     */
+    hset(key: string, field: string, value: string): Promise<unknown>;
+    /**
+     * Get all fields and values of a hash.
+     *
+     * @param key - The hash key
+     * @returns Object with all field-value pairs
+     */
+    hgetall(key: string): Promise<unknown>;
+    /**
+     * Delete a hash field.
+     *
+     * @param key - The hash key
+     * @param field - The field to delete
+     * @returns The number of fields that were removed
+     */
+    hdel(key: string, field: string): Promise<unknown>;
+    /**
+     * Set expiration on a key.
+     *
+     * @param key - The key to set expiration on
+     * @param seconds - Time to live in seconds
+     * @returns 1 if timeout was set, 0 if key does not exist
+     */
+    expire(key: string, seconds: number): Promise<unknown>;
+    /**
+     * Get the remaining time to live of a key.
+     *
+     * @param key - The key to check
+     * @returns TTL in seconds, -2 if key does not exist, -1 if no expiration
+     */
+    ttl(key: string): Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/redis/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,WAAY,SAAQ,qBAAqB;IACxD;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEhE;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;;;;;;OAOG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzE;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAExC;;;;;;OAMG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnD;;;;;;;OAOG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElE;;;;;OAKG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;;;;;OAMG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnD;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvD;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC"}

package/dist/integrations/redis/types.js

@@ -0,0 +1,5 @@
+/**
+ * Redis client types.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * Redshift integration client implementation.
+ *
+ * Executes Redshift 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 { RedshiftClient } from './types.js';
+/**
+ * Internal implementation of the Redshift client.
+ */
+export declare class RedshiftClientImpl implements RedshiftClient, IntegrationClientImpl {
+    readonly config: IntegrationConfig;
+    private readonly executeQuery;
+    constructor(config: IntegrationConfig, executeQuery: QueryExecutor);
+    get name(): string;
+    get pluginId(): string;
+    /**
+     * Builds a Redshift 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`
+     * field as a JSON-stringified array for server-side binding.
+     *
+     * @param sql - The SQL query with optional $1, $2 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/redshift/client.d.ts.map

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

@@ -0,0 +1,93 @@
+/**
+ * Redshift integration client implementation.
+ *
+ * Executes Redshift 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 Redshift client.
+ */
+export class RedshiftClientImpl {
+    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 Redshift 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`
+     * field as a JSON-stringified array for server-side binding.
+     *
+     * @param sql - The SQL query with optional $1, $2 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 Redshift 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/redshift/client.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/redshift/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/redshift/index.js

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

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

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

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

@@ -0,0 +1,53 @@
+/**
+ * Redshift integration client types.
+ *
+ * Provides typed methods for executing Redshift queries with runtime validation.
+ */
+import type { z } from 'zod';
+import type { BaseIntegrationClient } from '../../types.js';
+/**
+ * Client for executing Redshift queries with type-safe validation.
+ *
+ * @example
+ * ```typescript
+ * const redshift = ctx.redshift('Production Redshift');
+ *
+ * // Query with validation
+ * const UserSchema = z.object({
+ *   id: z.number(),
+ *   name: z.string(),
+ *   email: z.string().email(),
+ * });
+ *
+ * const users = await redshift.query(
+ *   'SELECT * FROM users WHERE status = $1',
+ *   UserSchema,
+ *   ['active']
+ * );
+ * ```
+ */
+export interface RedshiftClient 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 schema - Zod schema to validate the query results
+     * @param params - Optional query parameters
+     * @returns Promise resolving to validated query results
+     *
+     * @throws {QueryValidationError} If results don't match schema
+     * @throws {IntegrationError} If query execution fails
+     */
+    query<T>(sql: string, schema: z.ZodSchema<T>, params?: unknown[]): Promise<T[]>;
+    /**
+     * Execute a SQL statement (INSERT, UPDATE, DELETE) without output validation.
+     *
+     * @param sql - The SQL statement to execute
+     * @param params - Optional parameters for prepared statements
+     * @returns Promise resolving to execution result with row count
+     */
+    execute(sql: string, params?: unknown[]): Promise<{
+        rowCount: number;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map