@superblocksteam/sdk-api 0.0.4

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

@@ -0,0 +1,97 @@
+/**
+ * Kinesis client types.
+ *
+ * Kinesis uses a dedicated plugin (not REST API) with PUT and GET operations.
+ */
+import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
+/**
+ * Stream identifier type for Kinesis operations.
+ */
+export type KinesisStreamIdentifier = "STREAM_NAME" | "STREAM_ARN";
+/**
+ * Shard iterator type for Kinesis GET operations.
+ */
+export type KinesisShardIteratorType = "AT_SEQUENCE_NUMBER" | "AFTER_SEQUENCE_NUMBER" | "AT_TIMESTAMP" | "TRIM_HORIZON" | "LATEST";
+/**
+ * Parameters for a Kinesis PUT operation.
+ */
+export interface KinesisPutParams {
+    /** The data payload (JSON string or raw string) */
+    data: string;
+    /** The partition key for the record */
+    partitionKey: string;
+    /** How to identify the stream */
+    streamIdentifierType?: KinesisStreamIdentifier;
+    /** Stream name (when streamIdentifierType is STREAM_NAME) */
+    streamName?: string;
+    /** Stream ARN (when streamIdentifierType is STREAM_ARN) */
+    streamArn?: string;
+}
+/**
+ * Parameters for a Kinesis GET operation.
+ */
+export interface KinesisGetParams {
+    /** The shard ID to read from */
+    shardId: string;
+    /** How to position the shard iterator */
+    shardIteratorType: KinesisShardIteratorType;
+    /** Maximum number of records to return */
+    limit?: number;
+    /** Polling cooldown in milliseconds */
+    pollingCooldownMs?: number;
+    /** Starting sequence number (for AT/AFTER_SEQUENCE_NUMBER) */
+    startingSequenceNumber?: string;
+    /** Timestamp (for AT_TIMESTAMP) */
+    timestamp?: string;
+    /** How to identify the stream */
+    streamIdentifierType?: KinesisStreamIdentifier;
+    /** Stream name (when streamIdentifierType is STREAM_NAME) */
+    streamName?: string;
+    /** Stream ARN (when streamIdentifierType is STREAM_ARN) */
+    streamArn?: string;
+}
+/**
+ * Kinesis client for Amazon Kinesis Data Streams.
+ *
+ * Provides methods for putting records to and getting records from Kinesis streams.
+ *
+ * @example
+ * ```typescript
+ * // Declare in api(): integrations: { kinesis: kinesis(INTEGRATION_ID) }
+ * // In run(), access via ctx.integrations.kinesis
+ *
+ * // Put a record
+ * await kinesis.putRecord({
+ *   data: JSON.stringify({ event: 'user_signup', userId: '123' }),
+ *   partitionKey: 'user-123',
+ *   streamName: 'user-events',
+ * });
+ *
+ * // Get records from a shard
+ * const records = await kinesis.getRecords({
+ *   shardId: 'shardId-000000000000',
+ *   shardIteratorType: 'LATEST',
+ *   streamName: 'user-events',
+ *   limit: 10,
+ * });
+ * ```
+ */
+export interface KinesisClient extends BaseIntegrationClient {
+    /**
+     * Put a record to a Kinesis stream.
+     *
+     * @param params - PUT operation parameters
+     * @returns The raw result from Kinesis (includes ShardId and SequenceNumber)
+     */
+    putRecord(params: KinesisPutParams, metadata?: TraceMetadata): Promise<unknown>;
+    /**
+     * Get records from a Kinesis stream shard.
+     *
+     * @param params - GET operation parameters
+     * @param metadata - Optional trace metadata for diagnostics
+     * @returns The raw result from Kinesis (includes Records array)
+     */
+    getRecords(params: KinesisGetParams, metadata?: TraceMetadata): Promise<unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/kinesis/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,aAAa,GAAG,YAAY,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAChC,oBAAoB,GACpB,uBAAuB,GACvB,cAAc,GACd,cAAc,GACd,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,oBAAoB,CAAC,EAAE,uBAAuB,CAAC;IAC/C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8DAA8D;IAC9D,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,oBAAoB,CAAC,EAAE,uBAAuB,CAAC;IAC/C,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,aAAc,SAAQ,qBAAqB;IAC1D;;;;;OAKG;IACH,SAAS,CACP,MAAM,EAAE,gBAAgB,EACxB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;OAMG;IACH,UAAU,CACR,MAAM,EAAE,gBAAgB,EACxB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB"}

package/dist/integrations/kinesis/types.js

@@ -0,0 +1,7 @@
+/**
+ * Kinesis client types.
+ *
+ * Kinesis uses a dedicated plugin (not REST API) with PUT and GET operations.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * Lakebase client implementation.
+ *
+ * Uses the native Lakebase plugin type from @superblocksteam/types.
+ * Supports server-side parameterized SQL queries via the `parameters` field.
+ */
+import type { z } from "zod";
+import type { IntegrationConfig, IntegrationClientImpl } from "../types.js";
+import type { QueryExecutor, TraceMetadata } from "../registry.js";
+import type { LakebaseClient } from "./types.js";
+/**
+ * Internal implementation of LakebaseClient.
+ *
+ * Communicates with the orchestrator to execute SQL queries.
+ * Uses server-side parameterization via the `parameters` field.
+ */
+export declare class LakebaseClientImpl implements LakebaseClient, IntegrationClientImpl {
+    readonly name: string;
+    readonly pluginId: string;
+    readonly config: IntegrationConfig;
+    private readonly executeQuery;
+    constructor(config: IntegrationConfig, executeQuery: QueryExecutor);
+    /**
+     * Builds a Lakebase plugin request object.
+     *
+     * Parameters are passed via the `parameters` field as a JSON-stringified
+     * array. The server performs parameter binding, avoiding client-side
+     * SQL interpolation.
+     */
+    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/lakebase/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/integrations/lakebase/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;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAUjD;;;;;GAKG;AACH,qBAAa,kBACX,YAAW,cAAc,EAAE,qBAAqB;IAEhD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;gBAEjC,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa;IAOlE;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IASd,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;IAkDT,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;CA2BjC"}

package/dist/integrations/lakebase/client.js

@@ -0,0 +1,90 @@
+/**
+ * Lakebase client implementation.
+ *
+ * Uses the native Lakebase plugin type from @superblocksteam/types.
+ * Supports server-side parameterized SQL queries via the `parameters` field.
+ */
+import { QueryValidationError } from "../../errors.js";
+import { IntegrationError } from "../../runtime/errors.js";
+import { describeType } from "../utils.js";
+/**
+ * Internal implementation of LakebaseClient.
+ *
+ * Communicates with the orchestrator to execute SQL queries.
+ * Uses server-side parameterization via the `parameters` field.
+ */
+export class LakebaseClientImpl {
+    name;
+    pluginId;
+    config;
+    executeQuery;
+    constructor(config, executeQuery) {
+        this.name = config.name;
+        this.pluginId = config.pluginId;
+        this.config = config;
+        this.executeQuery = executeQuery;
+    }
+    /**
+     * Builds a Lakebase plugin request object.
+     *
+     * Parameters are passed via the `parameters` field as a JSON-stringified
+     * array. The server performs parameter binding, avoiding client-side
+     * SQL interpolation.
+     */
+    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 Lakebase 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} failed validation: ${parseResult.error.message}`, {
+                        rowIndex: i,
+                        errors: parseResult.error.errors,
+                        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 };
+            }
+            if (Array.isArray(result)) {
+                return { rowCount: result.length };
+            }
+            return { rowCount: 0 };
+        }
+        catch (error) {
+            throw new IntegrationError(this.config.name, "execute", error);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Lakebase integration client.
+ *
+ * @module
+ */
+export type { LakebaseClient } from "./types.js";
+export { LakebaseClientImpl } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

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

@@ -0,0 +1,52 @@
+/**
+ * Lakebase client types.
+ *
+ * Lakebase is a SQL database integration that supports parameterized
+ * queries via the `body` and `parameters` proto fields.
+ */
+import type { z } from "zod";
+import type { BaseIntegrationClient } from "../../types.js";
+import type { TraceMetadata } from "../registry.js";
+/**
+ * Lakebase client for SQL query and execute operations.
+ *
+ * @example
+ * ```typescript
+ * const lb = ctx.integrations.db;
+ *
+ * // Parameterized query
+ * const users = await lb.query(
+ *   'SELECT * FROM users WHERE status = ?',
+ *   UserSchema,
+ *   ['active'],
+ * );
+ *
+ * // Execute a mutation
+ * const result = await lb.execute(
+ *   'INSERT INTO users (name, email) VALUES (?, ?)',
+ *   ['Alice', 'alice@example.com'],
+ * );
+ * ```
+ */
+export interface LakebaseClient extends BaseIntegrationClient {
+    /**
+     * Execute a SQL query and return validated rows.
+     *
+     * @param sql - SQL query string with `?` placeholders for parameters
+     * @param schema - Zod schema for validating each result row
+     * @param params - Optional query parameters for server-side binding
+     * @returns Array of validated rows
+     */
+    query<T>(sql: string, schema: z.ZodSchema<T>, params?: unknown[], metadata?: TraceMetadata): Promise<T[]>;
+    /**
+     * Execute a SQL statement (INSERT, UPDATE, DELETE).
+     *
+     * @param sql - SQL statement with `?` placeholders for parameters
+     * @param params - Optional query parameters for server-side binding
+     * @returns The affected row count
+     */
+    execute(sql: string, params?: unknown[], metadata?: TraceMetadata): Promise<{
+        rowCount: number;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/lakebase/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,cAAe,SAAQ,qBAAqB;IAC3D;;;;;;;OAOG;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/lakebase/types.js

@@ -0,0 +1,8 @@
+/**
+ * Lakebase client types.
+ *
+ * Lakebase is a SQL database integration that supports parameterized
+ * queries via the `body` and `parameters` proto fields.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

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

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

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

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

package/dist/integrations/launchdarkly/client.js

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

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

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

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

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

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

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

package/dist/integrations/launchdarkly/index.js

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/launchdarkly/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,kBACf,SAAQ,qBAAqB,EAAE,kBAAkB;CAElD"}

package/dist/integrations/launchdarkly/types.js

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

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * MariaDB integration client implementation.
+ *
+ * Executes MariaDB 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 { MariaDBClient } from "./types.js";
+/**
+ * Internal implementation of the MariaDB client.
+ */
+export declare class MariaDBClientImpl implements MariaDBClient, IntegrationClientImpl {
+    readonly config: IntegrationConfig;
+    private readonly executeQuery;
+    constructor(config: IntegrationConfig, executeQuery: QueryExecutor);
+    get name(): string;
+    get pluginId(): string;
+    /**
+     * Builds a MariaDB 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[], metadata?: TraceMetadata): Promise<T[]>;
+    execute(sql: string, params?: unknown[], metadata?: TraceMetadata): Promise<{
+        rowCount: number;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/integrations/mariadb/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,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;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;;;;;;;;;;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/mariadb/client.js

@@ -0,0 +1,93 @@
+/**
+ * MariaDB integration client implementation.
+ *
+ * Executes MariaDB 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 MariaDB client.
+ */
+export class MariaDBClientImpl {
+    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 MariaDB 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, 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 MariaDB 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/mariadb/client.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * MariaDB integration client.
+ *
+ * @module
+ */
+export type { MariaDBClient } from "./types.js";
+export { MariaDBClientImpl } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/integrations/mariadb/index.js

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

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

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