@superblocksteam/sdk-api 0.0.4

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

@@ -0,0 +1,55 @@
+/**
+ * MariaDB integration client types.
+ *
+ * Provides typed methods for executing MariaDB queries with runtime validation.
+ */
+import type { z } from "zod";
+import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
+/**
+ * Client for executing MariaDB queries with type-safe validation.
+ *
+ * @example
+ * ```typescript
+ * // Declare in api(): integrations: { mariadb: mariadb(INTEGRATION_ID) }
+ * // In run(), access via ctx.integrations.mariadb
+ *
+ * // Query with validation
+ * const UserSchema = z.object({
+ *   id: z.number(),
+ *   name: z.string(),
+ *   email: z.string().email(),
+ * });
+ *
+ * const users = await mariadb.query(
+ *   'SELECT * FROM users WHERE status = $1',
+ *   UserSchema,
+ *   ['active']
+ * );
+ * ```
+ */
+export interface MariaDBClient 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[], metadata?: TraceMetadata): 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[], metadata?: TraceMetadata): Promise<{
+        rowCount: number;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/mariadb/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,aAAc,SAAQ,qBAAqB;IAC1D;;;;;;;;;;OAUG;IACH,KAAK,CAAC,CAAC,EACL,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,OAAO,EAAE,EAClB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAEhB;;;;;;OAMG;IACH,OAAO,CACL,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,EAClB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClC"}

package/dist/integrations/mariadb/types.js

@@ -0,0 +1,7 @@
+/**
+ * MariaDB integration client types.
+ *
+ * Provides typed methods for executing MariaDB queries with runtime validation.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Mistral client implementation.
+ *
+ * Uses the proto-generated REST API Integration Plugin type from @superblocksteam/types.
+ * Mistral integrations use the REST API Integration plugin under the hood.
+ */
+import { RestApiIntegrationClient } from "../base/index.js";
+import type { MistralClient } from "./types.js";
+/**
+ * Internal implementation of MistralClient.
+ *
+ * Extends RestApiIntegrationClient to inherit the generic apiRequest() method.
+ * This implementation communicates with the orchestrator to execute
+ * Mistral API calls. At runtime, the orchestrator handles authentication
+ * and API request execution.
+ */
+export declare class MistralClientImpl extends RestApiIntegrationClient implements MistralClient {
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/integrations/mistral/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;GAOG;AACH,qBAAa,iBACX,SAAQ,wBACR,YAAW,aAAa;CAEzB"}

package/dist/integrations/mistral/client.js

@@ -0,0 +1,18 @@
+/**
+ * Mistral client implementation.
+ *
+ * Uses the proto-generated REST API Integration Plugin type from @superblocksteam/types.
+ * Mistral integrations use the REST API Integration plugin under the hood.
+ */
+import { RestApiIntegrationClient } from "../base/index.js";
+/**
+ * Internal implementation of MistralClient.
+ *
+ * Extends RestApiIntegrationClient to inherit the generic apiRequest() method.
+ * This implementation communicates with the orchestrator to execute
+ * Mistral API calls. At runtime, the orchestrator handles authentication
+ * and API request execution.
+ */
+export class MistralClientImpl extends RestApiIntegrationClient {
+}
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/integrations/mistral/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAG5D;;;;;;;GAOG;AACH,MAAM,OAAO,iBACX,SAAQ,wBAAwB;CAGjC"}

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

@@ -0,0 +1,3 @@
+export { MistralClientImpl } from "./client.js";
+export type { MistralClient } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/mistral/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/integrations/mistral/index.js

@@ -0,0 +1,2 @@
+export { MistralClientImpl } from "./client.js";
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * Mistral client types.
+ */
+import type { BaseIntegrationClient } from "../../types.js";
+import type { SupportsApiRequest } from "../base/index.js";
+/**
+ * Mistral client for API interactions.
+ *
+ * Provides generic API request method for interacting with Mistral's API.
+ * Use apiRequest() to make calls to any Mistral API endpoint.
+ *
+ * @example
+ * ```typescript
+ * // Declare in api(): integrations: { mistral: mistral(INTEGRATION_ID) }
+ * // In run(), access via ctx.integrations.mistral
+ *
+ * // Make API requests
+ * const ResponseSchema = z.object({
+ *   // Define your response schema
+ * });
+ *
+ * const result = await mistral.apiRequest(
+ *   {
+ *     method: 'POST',
+ *     path: '/chat/completions',
+ *   },
+ *   { response: ResponseSchema }
+ * );
+ * ```
+ */
+export interface MistralClient extends BaseIntegrationClient, SupportsApiRequest {
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/mistral/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,aACf,SAAQ,qBAAqB,EAAE,kBAAkB;CAElD"}

package/dist/integrations/mistral/types.js

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

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * MongoDB client implementation.
+ *
+ * Uses the native MongoDB plugin type from @superblocksteam/types.
+ */
+import type { z } from "zod";
+import type { IntegrationConfig, IntegrationClientImpl } from "../types.js";
+import type { QueryExecutor, TraceMetadata } from "../registry.js";
+import type { MongoDBClient, MongoDBAction, MongoDBParams } from "./types.js";
+/**
+ * Internal implementation of MongoDBClient.
+ */
+export declare class MongoDBClientImpl implements MongoDBClient, IntegrationClientImpl {
+    readonly config: IntegrationConfig;
+    private readonly executeQuery;
+    constructor(config: IntegrationConfig, executeQuery: QueryExecutor);
+    get name(): string;
+    get pluginId(): string;
+    private buildRequest;
+    run<T>(collection: string, action: MongoDBAction, schema: z.ZodSchema<T>, params?: MongoDBParams, metadata?: TraceMetadata): Promise<T>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/integrations/mongodb/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;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,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGnE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9E;;GAEG;AACH,qBAAa,iBAAkB,YAAW,aAAa,EAAE,qBAAqB;IAC5E,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,OAAO,CAAC,YAAY;IA4Dd,GAAG,CAAC,CAAC,EACT,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,CAAC,CAAC;CAmCd"}

package/dist/integrations/mongodb/client.js

@@ -0,0 +1,95 @@
+/**
+ * MongoDB client implementation.
+ *
+ * Uses the native MongoDB plugin type from @superblocksteam/types.
+ */
+import { RestApiValidationError } from "../../errors.js";
+import { IntegrationError } from "../../runtime/errors.js";
+/**
+ * Internal implementation of MongoDBClient.
+ */
+export class MongoDBClientImpl {
+    config;
+    executeQuery;
+    constructor(config, executeQuery) {
+        this.config = config;
+        this.executeQuery = executeQuery;
+    }
+    get name() {
+        return this.config.name;
+    }
+    get pluginId() {
+        return this.config.pluginId;
+    }
+    buildRequest(collection, action, params) {
+        const request = {
+            resource: collection,
+            action,
+        };
+        if (params) {
+            // Query/filter
+            if (params.query) {
+                request.query = JSON.stringify(params.query);
+            }
+            if (params.filter) {
+                request.filter = JSON.stringify(params.filter);
+            }
+            // Document operations
+            if (params.document) {
+                request.document = JSON.stringify(params.document);
+            }
+            if (params.update) {
+                request.update = JSON.stringify(params.update);
+            }
+            // Aggregation
+            if (params.pipeline) {
+                request.pipeline = JSON.stringify(params.pipeline);
+            }
+            // Query modifiers
+            if (params.projection) {
+                request.projection = JSON.stringify(params.projection);
+            }
+            if (params.sort) {
+                request.sortby = JSON.stringify(params.sort);
+            }
+            if (params.limit !== undefined) {
+                request.limit = String(params.limit);
+            }
+            if (params.skip !== undefined) {
+                request.skip = String(params.skip);
+            }
+            // Distinct field
+            if (params.field) {
+                request.field = params.field;
+            }
+            // Additional options
+            if (params.options) {
+                request.options = JSON.stringify(params.options);
+            }
+        }
+        return request;
+    }
+    async run(collection, action, schema, params, metadata) {
+        const request = this.buildRequest(collection, action, params);
+        try {
+            const result = await this.executeQuery(request, undefined, metadata);
+            // Validate result against schema
+            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;
+        }
+        catch (error) {
+            if (error instanceof RestApiValidationError ||
+                error instanceof IntegrationError) {
+                throw error;
+            }
+            throw new IntegrationError(this.config.name, "run", error);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * MongoDB integration client.
+ *
+ * @module
+ */
+export type { MongoDBClient, MongoDBAction, MongoDBParams } from "./types.js";
+export { MongoDBClientImpl } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/integrations/mongodb/index.js

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

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

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

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

@@ -0,0 +1,83 @@
+/**
+ * MongoDB client types.
+ */
+import type { z } from "zod";
+import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
+/**
+ * MongoDB operation types.
+ */
+export type MongoDBAction = "aggregate" | "count" | "deleteOne" | "deleteMany" | "distinct" | "find" | "findOne" | "insertOne" | "insertMany" | "listCollections" | "replaceOne" | "updateOne" | "updateMany";
+/**
+ * Parameters for MongoDB operations.
+ */
+export interface MongoDBParams {
+    /** Filter/query object */
+    query?: Record<string, unknown>;
+    /** Filter object (alias for query) */
+    filter?: Record<string, unknown>;
+    /** Document to insert or replacement document */
+    document?: Record<string, unknown>;
+    /** Update operations */
+    update?: Record<string, unknown>;
+    /** Aggregation pipeline */
+    pipeline?: Record<string, unknown>[];
+    /** Fields to project */
+    projection?: Record<string, unknown>;
+    /** Sort specification */
+    sort?: Record<string, unknown>;
+    /** Maximum documents to return */
+    limit?: number;
+    /** Documents to skip */
+    skip?: number;
+    /** Field for distinct operation */
+    field?: string;
+    /** Additional options */
+    options?: Record<string, unknown>;
+}
+/**
+ * MongoDB client for database operations.
+ *
+ * Provides a generic run() method for executing any MongoDB operation.
+ *
+ * @example
+ * ```typescript
+ * // Declare in api(): integrations: { mongodb: mongodb(INTEGRATION_ID) }
+ * // In run(), access via ctx.integrations.mongodb
+ *
+ * const UserSchema = z.object({
+ *   _id: z.string(),
+ *   name: z.string(),
+ *   email: z.string(),
+ * });
+ *
+ * // Find documents
+ * const users = await mongodb.run(
+ *   'users',
+ *   'find',
+ *   UserSchema,
+ *   { query: { active: true }, limit: 10 }
+ * );
+ *
+ * // Insert a document
+ * const result = await mongodb.run(
+ *   'users',
+ *   'insertOne',
+ *   z.object({ insertedId: z.string() }),
+ *   { document: { name: 'John', email: 'john@example.com' } }
+ * );
+ * ```
+ */
+export interface MongoDBClient extends BaseIntegrationClient {
+    /**
+     * Execute a MongoDB operation.
+     *
+     * @param collection - Collection name (use empty string for listCollections)
+     * @param action - The operation to perform
+     * @param schema - Zod schema for validating the result
+     * @param params - Operation parameters
+     * @returns The validated result
+     */
+    run<T>(collection: string, action: MongoDBAction, schema: z.ZodSchema<T>, params?: MongoDBParams, metadata?: TraceMetadata): Promise<T>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/mongodb/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,OAAO,GACP,WAAW,GACX,YAAY,GACZ,UAAU,GACV,MAAM,GACN,SAAS,GACT,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,YAAY,GACZ,WAAW,GACX,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACrC,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,aAAc,SAAQ,qBAAqB;IAC1D;;;;;;;;OAQG;IACH,GAAG,CAAC,CAAC,EACH,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,MAAM,CAAC,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;CACf"}

package/dist/integrations/mongodb/types.js

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

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * MSSQL (Microsoft SQL Server) integration client implementation.
+ *
+ * Executes MSSQL 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, TraceMetadata } from "../registry.js";
+import type { MSSQLClient } from "./types.js";
+/**
+ * Internal implementation of the MSSQL client.
+ */
+export declare class MSSQLClientImpl implements MSSQLClient, IntegrationClientImpl {
+    readonly config: IntegrationConfig;
+    private readonly executeQuery;
+    constructor(config: IntegrationConfig, executeQuery: QueryExecutor);
+    get name(): string;
+    get pluginId(): string;
+    /**
+     * Builds a MSSQL request object from SQL and parameters.
+     *
+     * When params are provided, the SQL body is sent with placeholders intact
+     * (e.g. @PARAM_1, @PARAM_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 @PARAM_N 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[], metadata?: TraceMetadata): Promise<T[]>;
+    execute(sql: string, params?: unknown[], metadata?: TraceMetadata): Promise<{
+        rowCount: number;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/integrations/mssql/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,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAInE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;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;;;;;;;;;;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,EAClB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,CAAC,EAAE,CAAC;IAiDT,OAAO,CACX,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,OAAO,EAAE,EAClB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAmBjC"}

package/dist/integrations/mssql/client.js

@@ -0,0 +1,93 @@
+/**
+ * MSSQL (Microsoft SQL Server) integration client implementation.
+ *
+ * Executes MSSQL 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 MSSQL client.
+ */
+export class MSSQLClientImpl {
+    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 MSSQL request object from SQL and parameters.
+     *
+     * When params are provided, the SQL body is sent with placeholders intact
+     * (e.g. @PARAM_1, @PARAM_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 @PARAM_N 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, metadata) {
+        const request = this.buildRequest(sql, params);
+        try {
+            const result = await this.executeQuery(request, undefined, metadata);
+            if (!Array.isArray(result)) {
+                throw new IntegrationError(this.config.name, "query", `Expected array result from MSSQL 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, metadata) {
+        const request = this.buildRequest(sql, params);
+        try {
+            const result = await this.executeQuery(request, undefined, metadata);
+            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/mssql/client.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * MSSQL (Microsoft SQL Server) integration client.
+ *
+ * @module
+ */
+export type { MSSQLClient } from "./types.js";
+export { MSSQLClientImpl } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * MSSQL (Microsoft SQL Server) integration client.
+ *
+ * @module
+ */
+export { MSSQLClientImpl } from "./client.js";
+//# sourceMappingURL=index.js.map

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

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