@superblocksteam/sdk-api 0.0.4

package/dist/runtime/execute.js

@@ -0,0 +1,84 @@
+/**
+ * Unified API execution function.
+ *
+ * Provides a single `execute()` function that handles both regular and streaming APIs,
+ * detecting the API type at runtime and returning appropriate result types.
+ */
+import { isStreamingApi } from "../api/streaming.js";
+import { executeApi } from "./executor.js";
+import { createStreamingApiGenerator } from "./streaming-executor.js";
+/**
+ * Execute any compiled API (regular or streaming).
+ *
+ * This unified function detects whether the API is streaming or regular
+ * and returns the appropriate result type:
+ *
+ * - **Regular APIs**: Returns `Promise<ExecuteApiResponse<TOutput>>`
+ * - **Streaming APIs**: Returns `AsyncGenerator<TChunk>`
+ *
+ * @param api - The compiled API definition (regular or streaming)
+ * @param request - The execution request
+ * @returns Promise for regular APIs, AsyncGenerator for streaming APIs
+ *
+ * @example Regular API
+ * ```typescript
+ * const response = await execute(myApi, {
+ *   input: { userId: '123' },
+ *   integrations: [...],
+ *   executionId: 'exec_abc',
+ *   env: {},
+ *   executeQuery: async (id, req) => orchestrator.execute(id, req),
+ * });
+ *
+ * if (response.success) {
+ *   console.log(response.output);
+ * }
+ * ```
+ *
+ * @example Streaming API
+ * ```typescript
+ * const stream = execute(myStreamingApi, {
+ *   input: { prompt: 'Hello' },
+ *   integrations: [...],
+ *   executionId: 'exec_abc',
+ *   env: {},
+ *   executeQuery: async (id, req) => orchestrator.execute(id, req),
+ *   executeStreamingQuery: (id, req) => orchestrator.stream(id, req),
+ * });
+ *
+ * for await (const chunk of stream) {
+ *   console.log(chunk.text);
+ * }
+ * ```
+ */
+export function execute(api, request) {
+    if (isStreamingApi(api)) {
+        // Streaming API - return generator directly
+        return createStreamingApiGenerator(api, request);
+    }
+    else {
+        // Regular API - return promise
+        return executeApi(api, request);
+    }
+}
+/**
+ * Type guard to check if an API is a streaming API.
+ *
+ * Use this to determine which result type you'll get from `execute()`.
+ *
+ * @param api - The API to check
+ * @returns `true` if the API is a streaming API
+ *
+ * @example
+ * ```typescript
+ * if (isStreamingApi(api)) {
+ *   const stream = execute(api, request);
+ *   for await (const chunk of stream) { ... }
+ * } else {
+ *   const response = await execute(api, request);
+ *   if (response.success) { ... }
+ * }
+ * ```
+ */
+export { isStreamingApi };
+//# sourceMappingURL=execute.js.map

package/dist/runtime/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/runtime/execute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAA6B,MAAM,qBAAqB,CAAC;AAIhF,OAAO,EAAE,UAAU,EAA2B,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AA8HtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,UAAU,OAAO,CACrB,GAAmB,EACnB,OAAiC;IAIjC,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,4CAA4C;QAC5C,OAAO,2BAA2B,CAChC,GAA6C,EAC7C,OAAO,CACR,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,+BAA+B;QAC/B,OAAO,UAAU,CAAC,GAAoC,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/runtime/executor.d.ts

@@ -0,0 +1,113 @@
+/**
+ * API execution engine.
+ *
+ * Provides the main entry point for executing compiled APIs,
+ * handling input/output validation and error management.
+ */
+import type { CompiledApi } from "../api/definition.js";
+import type { TraceMetadata } from "../integrations/registry.js";
+import type { IntegrationConfig } from "../integrations/types.js";
+import type { ApiUser } from "../types.js";
+import { type ErrorCodeType } from "./errors.js";
+/**
+ * Request to execute an API.
+ */
+export interface ExecuteApiRequest {
+    /** Raw input data to be validated */
+    input: unknown;
+    /** Available integration configurations */
+    integrations: IntegrationConfig[];
+    /** Unique execution ID for tracing */
+    executionId: string;
+    /** Environment variables available to the API */
+    env: Record<string, string>;
+    /** User information extracted from the Superblocks JWT */
+    user: ApiUser;
+    /**
+     * Function to execute integration operations.
+     * Called by integration clients to perform actual operations.
+     *
+     * The request object should match the protobuf Plugin schema for the
+     * specific integration type (e.g., postgresql.v1.Plugin for Postgres).
+     *
+     * For language plugins (Python, JavaScript), the bindings parameter should be
+     * passed to the API execution request as `input` or `inputs` field for
+     * binding resolution.
+     *
+     * @param integrationId - The integration ID
+     * @param request - Plugin-specific request object matching the proto schema
+     * @param bindings - Optional bindings data for binding resolution (e.g., Python/JavaScript bindings)
+     * @returns Promise resolving to the operation result
+     */
+    executeQuery: (integrationId: string, request: Record<string, unknown>, bindings?: Record<string, unknown>, metadata?: TraceMetadata) => Promise<unknown>;
+}
+/**
+ * Successful API execution response.
+ *
+ * @template TOutput - The output type from the API
+ */
+export interface ExecuteApiSuccessResponse<TOutput = unknown> {
+    success: true;
+    output: TOutput;
+}
+/**
+ * Failed API execution response.
+ */
+export interface ExecuteApiErrorResponse {
+    success: false;
+    error: {
+        code: ErrorCodeType;
+        message: string;
+        details?: unknown;
+    };
+}
+/**
+ * API execution response.
+ *
+ * @template TOutput - The output type from the API
+ */
+export type ExecuteApiResponse<TOutput = unknown> = ExecuteApiSuccessResponse<TOutput> | ExecuteApiErrorResponse;
+/**
+ * Executes a compiled API with the given request.
+ *
+ * This is the main entry point called by the orchestrator to execute
+ * TypeScript-based APIs. It handles:
+ *
+ * 1. Input validation against the API's Zod schema
+ * 2. Context creation with integration clients
+ * 3. API function execution
+ * 4. Output validation against the API's Zod schema
+ * 5. Error handling and categorization
+ *
+ * @param api - The compiled API definition
+ * @param request - The execution request with input and integrations
+ * @returns Promise resolving to success or error response
+ *
+ * @example
+ * ```typescript
+ * import { api, z } from '@superblocksteam/sdk-api';
+ * import { executeApi } from '@superblocksteam/sdk-api/runtime';
+ *
+ * const myApi = api({
+ *   input: z.object({ userId: z.string() }),
+ *   output: z.object({ name: z.string() }),
+ *   async run(ctx, { userId }) {
+ *     const [user] = await ctx.integrations.db.query(
+ *       'SELECT name FROM users WHERE id = $1',
+ *       [userId]
+ *     );
+ *     return { name: user.name };
+ *   },
+ * });
+ *
+ * const result = await executeApi(myApi, {
+ *   input: { userId: '123' },
+ *   integrations: [...],
+ *   executionId: 'exec_abc',
+ *   env: {},
+ *   executeQuery: orchestratorExecutor,
+ * });
+ * ```
+ */
+export declare function executeApi<TInput = unknown, TOutput = unknown>(api: CompiledApi<TInput, TOutput>, request: ExecuteApiRequest): Promise<ExecuteApiResponse<TOutput>>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/runtime/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/runtime/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IAEf,2CAA2C;IAC3C,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAElC,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B,0DAA0D;IAC1D,IAAI,EAAE,OAAO,CAAC;IAEd;;;;;;;;;;;;;;;OAeG;IACH,YAAY,EAAE,CACZ,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,CAAC,EAAE,aAAa,KACrB,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB,CAAC,OAAO,GAAG,OAAO;IAC1D,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE;QACL,IAAI,EAAE,aAAa,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,OAAO,GAAG,OAAO,IAC5C,yBAAyB,CAAC,OAAO,CAAC,GAClC,uBAAuB,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAsB,UAAU,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAClE,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAwEtC"}

package/dist/runtime/executor.js

@@ -0,0 +1,121 @@
+/**
+ * API execution engine.
+ *
+ * Provides the main entry point for executing compiled APIs,
+ * handling input/output validation and error management.
+ */
+import { getIntegrationDeclarations } from "../integrations/declarations.js";
+import { createApiContext } from "./context.js";
+import { SdkError, InputValidationError, OutputValidationError, ExecutionError, ErrorCode, } from "./errors.js";
+/**
+ * Executes a compiled API with the given request.
+ *
+ * This is the main entry point called by the orchestrator to execute
+ * TypeScript-based APIs. It handles:
+ *
+ * 1. Input validation against the API's Zod schema
+ * 2. Context creation with integration clients
+ * 3. API function execution
+ * 4. Output validation against the API's Zod schema
+ * 5. Error handling and categorization
+ *
+ * @param api - The compiled API definition
+ * @param request - The execution request with input and integrations
+ * @returns Promise resolving to success or error response
+ *
+ * @example
+ * ```typescript
+ * import { api, z } from '@superblocksteam/sdk-api';
+ * import { executeApi } from '@superblocksteam/sdk-api/runtime';
+ *
+ * const myApi = api({
+ *   input: z.object({ userId: z.string() }),
+ *   output: z.object({ name: z.string() }),
+ *   async run(ctx, { userId }) {
+ *     const [user] = await ctx.integrations.db.query(
+ *       'SELECT name FROM users WHERE id = $1',
+ *       [userId]
+ *     );
+ *     return { name: user.name };
+ *   },
+ * });
+ *
+ * const result = await executeApi(myApi, {
+ *   input: { userId: '123' },
+ *   integrations: [...],
+ *   executionId: 'exec_abc',
+ *   env: {},
+ *   executeQuery: orchestratorExecutor,
+ * });
+ * ```
+ */
+export async function executeApi(api, request) {
+    try {
+        // 1. Validate input
+        const inputResult = api.inputSchema.safeParse(request.input);
+        if (!inputResult.success) {
+            throw new InputValidationError("Input validation failed", {
+                issues: inputResult.error.issues,
+            });
+        }
+        // 2. Build integration map (keyed by id)
+        const integrations = new Map();
+        for (const config of request.integrations) {
+            integrations.set(config.id, config);
+        }
+        // 3. Create execution context
+        const ctx = createApiContext({
+            integrations,
+            integrationDeclarations: getIntegrationDeclarations(api),
+            executeQuery: request.executeQuery,
+            executionId: request.executionId,
+            env: request.env,
+            user: request.user,
+        });
+        // 4. Execute the API
+        let rawOutput;
+        try {
+            rawOutput = await api.run(ctx, inputResult.data);
+        }
+        catch (err) {
+            // Re-throw SDK errors as-is
+            if (err instanceof SdkError) {
+                throw err;
+            }
+            // Wrap user errors
+            const message = err instanceof Error ? err.message : String(err);
+            throw new ExecutionError(message, err);
+        }
+        // 5. Validate output
+        const outputResult = api.outputSchema.safeParse(rawOutput);
+        if (!outputResult.success) {
+            throw new OutputValidationError("Output validation failed", {
+                issues: outputResult.error.issues,
+            });
+        }
+        return {
+            success: true,
+            output: outputResult.data,
+        };
+    }
+    catch (err) {
+        // Handle SDK errors
+        if (err instanceof SdkError) {
+            return {
+                success: false,
+                error: err.toJSON(),
+            };
+        }
+        // Handle unexpected errors
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            error: {
+                code: ErrorCode.INTERNAL_ERROR,
+                message: `Unexpected error: ${message}`,
+                details: err instanceof Error ? { stack: err.stack } : undefined,
+            },
+        };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/runtime/executor.js.map

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

package/dist/runtime/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Runtime execution module.
+ *
+ * Provides the execution engine for running compiled APIs,
+ * including context creation, validation, and error handling.
+ */
+export { execute, isStreamingApi, type UnifiedExecuteApiRequest, type AnyCompiledApi, } from "./execute.js";
+export { executeApi, type ExecuteApiRequest, type ExecuteApiResponse, type ExecuteApiSuccessResponse, type ExecuteApiErrorResponse, } from "./executor.js";
+export { executeStreamingApi, createStreamingApiGenerator, type ExecuteStreamingApiRequest, type StreamingApiCallbacks, type StreamingApiError, type ExecuteStreamingApiResult, } from "./streaming-executor.js";
+export { createApiContext, type CreateContextOptions } from "./context.js";
+export { createStreamingApiContext, type CreateStreamingContextOptions, } from "./streaming-context.js";
+export { SdkError, InputValidationError, OutputValidationError, IntegrationNotFoundError, IntegrationError, ExecutionError, ErrorCode, type ErrorCodeType, } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,OAAO,EACP,cAAc,EACd,KAAK,wBAAwB,EAC7B,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC7B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,yBAAyB,EACzB,KAAK,6BAA6B,GACnC,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,18 @@
+/**
+ * Runtime execution module.
+ *
+ * Provides the execution engine for running compiled APIs,
+ * including context creation, validation, and error handling.
+ */
+// Unified executor (recommended)
+export { execute, isStreamingApi, } from "./execute.js";
+// Main executor (for non-streaming APIs)
+export { executeApi, } from "./executor.js";
+// Streaming executor (for streaming APIs)
+export { executeStreamingApi, createStreamingApiGenerator, } from "./streaming-executor.js";
+// Context factories
+export { createApiContext } from "./context.js";
+export { createStreamingApiContext, } from "./streaming-context.js";
+// Error types
+export { SdkError, InputValidationError, OutputValidationError, IntegrationNotFoundError, IntegrationError, ExecutionError, ErrorCode, } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iCAAiC;AACjC,OAAO,EACL,OAAO,EACP,cAAc,GAGf,MAAM,cAAc,CAAC;AAEtB,yCAAyC;AACzC,OAAO,EACL,UAAU,GAKX,MAAM,eAAe,CAAC;AAEvB,0CAA0C;AAC1C,OAAO,EACL,mBAAmB,EACnB,2BAA2B,GAK5B,MAAM,yBAAyB,CAAC;AAEjC,oBAAoB;AACpB,OAAO,EAAE,gBAAgB,EAA6B,MAAM,cAAc,CAAC;AAC3E,OAAO,EACL,yBAAyB,GAE1B,MAAM,wBAAwB,CAAC;AAEhC,cAAc;AACd,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,SAAS,GAEV,MAAM,aAAa,CAAC"}

package/dist/runtime/logger.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Default logger factory for API execution contexts.
+ *
+ * Provides a simple console-based logger implementation
+ * with structured output including timestamps and execution IDs.
+ */
+import type { Logger } from "../types.js";
+/**
+ * Creates a default logger that outputs to console.
+ *
+ * @param executionId - Execution ID for log correlation
+ * @returns A Logger instance using console output
+ */
+export declare function createDefaultLogger(executionId: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/runtime/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/runtime/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAyB/D"}

package/dist/runtime/logger.js

@@ -0,0 +1,34 @@
+/**
+ * Default logger factory for API execution contexts.
+ *
+ * Provides a simple console-based logger implementation
+ * with structured output including timestamps and execution IDs.
+ */
+/**
+ * Creates a default logger that outputs to console.
+ *
+ * @param executionId - Execution ID for log correlation
+ * @returns A Logger instance using console output
+ */
+export function createDefaultLogger(executionId) {
+    const formatMessage = (level, message, data) => {
+        const timestamp = new Date().toISOString();
+        const dataStr = data ? ` ${JSON.stringify(data)}` : "";
+        return `[${timestamp}] [${executionId}] [${level}] ${message}${dataStr}`;
+    };
+    return {
+        info(message, data) {
+            console.log(formatMessage("INFO", message, data));
+        },
+        warn(message, data) {
+            console.warn(formatMessage("WARN", message, data));
+        },
+        error(message, data) {
+            console.error(formatMessage("ERROR", message, data));
+        },
+        debug(message, data) {
+            console.debug(formatMessage("DEBUG", message, data));
+        },
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/runtime/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/runtime/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IACrD,MAAM,aAAa,GAAG,CACpB,KAAa,EACb,OAAe,EACf,IAA8B,EACtB,EAAE;QACV,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,SAAS,MAAM,WAAW,MAAM,KAAK,KAAK,OAAO,GAAG,OAAO,EAAE,CAAC;IAC3E,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,CAAC,OAAe,EAAE,IAA8B;YAClD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,OAAe,EAAE,IAA8B;YAClD,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,KAAK,CAAC,OAAe,EAAE,IAA8B;YACnD,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,CAAC,OAAe,EAAE,IAA8B;YACnD,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/streaming-context.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Streaming API execution context factory.
+ *
+ * Creates the context object for streaming API functions, providing
+ * access to integrations (with streaming support), logging, and environment.
+ */
+import type { ApiContext, ApiUser, Logger, AnyIntegrationRef } from "../types.js";
+import type { IntegrationConfig } from "../integrations/types.js";
+import type { IntegrationDeclaration } from "../integrations/declarations.js";
+import { type TraceMetadata } from "../integrations/registry.js";
+/**
+ * Options for creating a streaming API execution context.
+ */
+export interface CreateStreamingContextOptions {
+    /** Available integration configurations keyed by id */
+    integrations: Map<string, IntegrationConfig>;
+    /**
+     * Declared integrations from the API config.
+     */
+    integrationDeclarations: IntegrationDeclaration[];
+    /**
+     * Function to execute integration operations (non-streaming).
+     */
+    executeQuery: (integrationId: string, request: Record<string, unknown>, bindings?: Record<string, unknown>, metadata?: TraceMetadata) => Promise<unknown>;
+    /**
+     * Function to execute streaming integration operations.
+     * Optional - if not provided, streaming operations will throw an error.
+     */
+    executeStreamingQuery?: (integrationId: string, request: Record<string, unknown>, metadata?: TraceMetadata) => AsyncIterable<unknown>;
+    /** Execution ID for logging correlation */
+    executionId: string;
+    /** Environment variables */
+    env: Record<string, string>;
+    /** User information from JWT */
+    user: ApiUser;
+    /** Optional custom logger */
+    logger?: Logger;
+}
+/**
+ * Creates a streaming API execution context.
+ *
+ * Similar to createApiContext but supports streaming query execution
+ * for integration clients that support it.
+ *
+ * @param options - Context creation options
+ * @returns The API context for streaming API execution
+ */
+export declare function createStreamingApiContext(options: CreateStreamingContextOptions): ApiContext<Record<string, AnyIntegrationRef>>;
+//# sourceMappingURL=streaming-context.d.ts.map

package/dist/runtime/streaming-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-context.d.ts","sourceRoot":"","sources":["../../src/runtime/streaming-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,MAAM,EACN,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAGrC;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,uDAAuD;IACvD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAE7C;;OAEG;IACH,uBAAuB,EAAE,sBAAsB,EAAE,CAAC;IAElD;;OAEG;IACH,YAAY,EAAE,CACZ,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,CAAC,EAAE,aAAa,KACrB,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CACtB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,CAAC,EAAE,aAAa,KACrB,aAAa,CAAC,OAAO,CAAC,CAAC;IAE5B,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IAEpB,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5B,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAC;IAEd,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,6BAA6B,GACrC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAiF/C"}

package/dist/runtime/streaming-context.js

@@ -0,0 +1,71 @@
+/**
+ * Streaming API execution context factory.
+ *
+ * Creates the context object for streaming API functions, providing
+ * access to integrations (with streaming support), logging, and environment.
+ */
+import { createClient, } from "../integrations/registry.js";
+import { createDefaultLogger } from "./logger.js";
+/**
+ * Creates a streaming API execution context.
+ *
+ * Similar to createApiContext but supports streaming query execution
+ * for integration clients that support it.
+ *
+ * @param options - Context creation options
+ * @returns The API context for streaming API execution
+ */
+export function createStreamingApiContext(options) {
+    const { integrations, integrationDeclarations, executeQuery, executeStreamingQuery, executionId, env, user, logger, } = options;
+    // Cache for created integration clients
+    const clientCache = new Map();
+    // Create logger
+    const log = logger ?? createDefaultLogger(executionId);
+    /**
+     * Gets or creates a typed integration client by id and plugin ID.
+     * Supports streaming execution if provided.
+     */
+    function getTypedClient(id, pluginId) {
+        const cached = clientCache.get(id);
+        if (cached) {
+            return cached;
+        }
+        const config = integrations.get(id);
+        // Create executor bound to this integration
+        const boundExecutor = (request, bindings, metadata) => executeQuery(id, request, bindings, metadata);
+        // Create streaming executor if provided
+        const boundStreamingExecutor = executeStreamingQuery
+            ? (request, metadata) => executeStreamingQuery(id, request, metadata)
+            : undefined;
+        const clientConfig = config ?? {
+            id,
+            name: id,
+            pluginId,
+            configuration: {},
+        };
+        // Create client with streaming support
+        const client = createClient({
+            config: clientConfig,
+            executeQuery: boundExecutor,
+            executeStreamingQuery: boundStreamingExecutor,
+        });
+        clientCache.set(id, client);
+        return client;
+    }
+    // Build the integrations object from declarations
+    const integrationsObject = {};
+    for (const declaration of integrationDeclarations) {
+        Object.defineProperty(integrationsObject, declaration.key, {
+            get: () => getTypedClient(declaration.id, declaration.pluginId),
+            enumerable: true,
+            configurable: false,
+        });
+    }
+    return {
+        integrations: integrationsObject,
+        log,
+        env: Object.freeze({ ...env }),
+        user,
+    };
+}
+//# sourceMappingURL=streaming-context.js.map

package/dist/runtime/streaming-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-context.js","sourceRoot":"","sources":["../../src/runtime/streaming-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,EACL,YAAY,GAIb,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA+ClD;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAsC;IAEtC,MAAM,EACJ,YAAY,EACZ,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,GAAG,EACH,IAAI,EACJ,MAAM,GACP,GAAG,OAAO,CAAC;IAEZ,wCAAwC;IACxC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAiC,CAAC;IAE7D,gBAAgB;IAChB,MAAM,GAAG,GAAG,MAAM,IAAI,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAEvD;;;OAGG;IACH,SAAS,cAAc,CAAC,EAAU,EAAE,QAAgB;QAClD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEpC,4CAA4C;QAC5C,MAAM,aAAa,GAAkB,CACnC,OAAgC,EAChC,QAAkC,EAClC,QAAwB,EACxB,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEnD,wCAAwC;QACxC,MAAM,sBAAsB,GAC1B,qBAAqB;YACnB,CAAC,CAAC,CAAC,OAAgC,EAAE,QAAwB,EAAE,EAAE,CAC7D,qBAAqB,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC;YAChD,CAAC,CAAC,SAAS,CAAC;QAEhB,MAAM,YAAY,GAAsB,MAAM,IAAI;YAChD,EAAE;YACF,IAAI,EAAE,EAAE;YACR,QAAQ;YACR,aAAa,EAAE,EAAE;SAClB,CAAC;QAEF,uCAAuC;QACvC,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,MAAM,EAAE,YAAY;YACpB,YAAY,EAAE,aAAa;YAC3B,qBAAqB,EAAE,sBAAsB;SAC9C,CAAC,CAAC;QAEH,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kDAAkD;IAClD,MAAM,kBAAkB,GAA0C,EAAE,CAAC;IAErE,KAAK,MAAM,WAAW,IAAI,uBAAuB,EAAE,CAAC;QAClD,MAAM,CAAC,cAAc,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG,EAAE;YACzD,GAAG,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC;YAC/D,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,YAAY,EAAE,kBAEG;QACjB,GAAG;QACH,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC;QAC9B,IAAI;KACL,CAAC;AACJ,CAAC"}