@superblocksteam/sdk-api 0.0.5 → 0.0.7

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

@@ -1,43 +0,0 @@
-/**
- * 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, TraceMetadata } 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>, metadata?: TraceMetadata): Promise<T>;
-    get(key: string, metadata?: TraceMetadata): Promise<unknown>;
-    set(key: string, value: string, expirationMs?: number, metadata?: TraceMetadata): Promise<unknown>;
-    del(key: string, metadata?: TraceMetadata): Promise<unknown>;
-    keys(pattern: string, metadata?: TraceMetadata): Promise<unknown>;
-    hget(key: string, field: string, metadata?: TraceMetadata): Promise<unknown>;
-    hset(key: string, field: string, value: string, metadata?: TraceMetadata): Promise<unknown>;
-    hgetall(key: string, metadata?: TraceMetadata): Promise<unknown>;
-    hdel(key: string, field: string, metadata?: TraceMetadata): Promise<unknown>;
-    expire(key: string, seconds: number, metadata?: TraceMetadata): Promise<unknown>;
-    ttl(key: string, metadata?: TraceMetadata): Promise<unknown>;
-}
-//# sourceMappingURL=client.d.ts.map

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

@@ -1 +0,0 @@
-{"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,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGnE,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;IAmBZ,OAAO,CAAC,CAAC,EACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,CAAC,CAAC;IA4BP,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5D,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,OAAO,CAAC;IASb,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjE,IAAI,CACR,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,OAAO,CAAC;IAKb,IAAI,CACR,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,OAAO,CAAC;IAKb,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAKhE,IAAI,CACR,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,OAAO,CAAC;IAKb,MAAM,CACV,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,OAAO,CAAC;IAKb,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;CAInE"}

package/dist/integrations/redis/client.js

@@ -1,142 +0,0 @@
-/**
- * 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, metadata) {
-        try {
-            return await this.executeQuery(request, undefined, metadata);
-        }
-        catch (error) {
-            if (error instanceof RestApiValidationError ||
-                error instanceof IntegrationError) {
-                throw error;
-            }
-            throw new IntegrationError(this.config.name, operation, error);
-        }
-    }
-    async command(command, schema, metadata) {
-        const request = buildRawRequest(command);
-        const rawResult = await this.exec(request, "command", metadata);
-        // The Redis plugin wraps raw command results in { response: ... }.
-        // Unwrap to the actual value so callers can validate against the expected type.
-        const result = rawResult !== null &&
-            typeof rawResult === "object" &&
-            "response" in rawResult
-            ? rawResult.response
-            : rawResult;
-        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, metadata) {
-        const request = buildStructuredRequest("get", { key });
-        return this.exec(request, "get", metadata);
-    }
-    async set(key, value, expirationMs, metadata) {
-        const params = { key, value };
-        if (expirationMs !== undefined) {
-            params.expirationMs = expirationMs;
-        }
-        const request = buildStructuredRequest("set", params);
-        return this.exec(request, "set", metadata);
-    }
-    async del(key, metadata) {
-        const request = buildStructuredRequest("del", { key });
-        return this.exec(request, "del", metadata);
-    }
-    async keys(pattern, metadata) {
-        const request = buildStructuredRequest("keys", { pattern });
-        return this.exec(request, "keys", metadata);
-    }
-    async hget(key, field, metadata) {
-        const request = buildStructuredRequest("hget", { key, field });
-        return this.exec(request, "hget", metadata);
-    }
-    async hset(key, field, value, metadata) {
-        const request = buildStructuredRequest("hset", { key, field, value });
-        return this.exec(request, "hset", metadata);
-    }
-    async hgetall(key, metadata) {
-        const request = buildStructuredRequest("hgetall", { key });
-        return this.exec(request, "hgetall", metadata);
-    }
-    async hdel(key, field, metadata) {
-        const request = buildStructuredRequest("hdel", { key, field });
-        return this.exec(request, "hdel", metadata);
-    }
-    async expire(key, seconds, metadata) {
-        const request = buildStructuredRequest("expire", { key, seconds });
-        return this.exec(request, "expire", metadata);
-    }
-    async ttl(key, metadata) {
-        const request = buildStructuredRequest("ttl", { key });
-        return this.exec(request, "ttl", metadata);
-    }
-}
-//# sourceMappingURL=client.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,8 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,137 +0,0 @@
-/**
- * Redis client types.
- */
-import type { z } from "zod";
-import type { BaseIntegrationClient } from "../../types.js";
-import type { TraceMetadata } from "../registry.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
- * // Declare in api(): integrations: { redis: redis(INTEGRATION_ID) }
- * // In run(), access via ctx.integrations.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>, metadata?: TraceMetadata): Promise<T>;
-    /**
-     * Get the value of a key.
-     *
-     * @param key - The key to get
-     * @param metadata - Optional trace metadata for diagnostics
-     * @returns The value, or null if the key does not exist
-     */
-    get(key: string, metadata?: TraceMetadata): 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
-     * @param metadata - Optional trace metadata for diagnostics
-     * @returns The result (typically "OK")
-     */
-    set(key: string, value: string, expirationMs?: number, metadata?: TraceMetadata): Promise<unknown>;
-    /**
-     * Delete a key.
-     *
-     * @param key - The key to delete
-     * @param metadata - Optional trace metadata for diagnostics
-     * @returns The number of keys removed
-     */
-    del(key: string, metadata?: TraceMetadata): Promise<unknown>;
-    /**
-     * Find all keys matching a pattern.
-     *
-     * @param pattern - The glob-style pattern to match (e.g., "user:*")
-     * @param metadata - Optional trace metadata for diagnostics
-     * @returns Array of matching keys
-     */
-    keys(pattern: string, metadata?: TraceMetadata): Promise<unknown>;
-    /**
-     * Get the value of a hash field.
-     *
-     * @param key - The hash key
-     * @param field - The field name
-     * @param metadata - Optional trace metadata for diagnostics
-     * @returns The field value, or null if the field does not exist
-     */
-    hget(key: string, field: string, metadata?: TraceMetadata): 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
-     * @param metadata - Optional trace metadata for diagnostics
-     * @returns The number of fields that were added
-     */
-    hset(key: string, field: string, value: string, metadata?: TraceMetadata): Promise<unknown>;
-    /**
-     * Get all fields and values of a hash.
-     *
-     * @param key - The hash key
-     * @param metadata - Optional trace metadata for diagnostics
-     * @returns Object with all field-value pairs
-     */
-    hgetall(key: string, metadata?: TraceMetadata): Promise<unknown>;
-    /**
-     * Delete a hash field.
-     *
-     * @param key - The hash key
-     * @param field - The field to delete
-     * @param metadata - Optional trace metadata for diagnostics
-     * @returns The number of fields that were removed
-     */
-    hdel(key: string, field: string, metadata?: TraceMetadata): Promise<unknown>;
-    /**
-     * Set expiration on a key.
-     *
-     * @param key - The key to set expiration on
-     * @param seconds - Time to live in seconds
-     * @param metadata - Optional trace metadata for diagnostics
-     * @returns 1 if timeout was set, 0 if key does not exist
-     */
-    expire(key: string, seconds: number, metadata?: TraceMetadata): Promise<unknown>;
-    /**
-     * Get the remaining time to live of a key.
-     *
-     * @param key - The key to check
-     * @param metadata - Optional trace metadata for diagnostics
-     * @returns TTL in seconds, -2 if key does not exist, -1 if no expiration
-     */
-    ttl(key: string, metadata?: TraceMetadata): Promise<unknown>;
-}
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"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;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,WAAW,WAAY,SAAQ,qBAAqB;IACxD;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,EACP,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7D;;;;;;;;OAQG;IACH,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7D;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAElE;;;;;;;OAOG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7E;;;;;;;;OAQG;IACH,IAAI,CACF,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjE;;;;;;;OAOG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7E;;;;;;;OAOG;IACH,MAAM,CACJ,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9D"}

package/dist/integrations/redis/types.js

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

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

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

package/dist/runtime/execute.d.ts

@@ -1,128 +0,0 @@
-/**
- * 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 type { CompiledApi } from "../api/definition.js";
-import { isStreamingApi, type CompiledStreamingApi } from "../api/streaming.js";
-import type { TraceMetadata } from "../integrations/registry.js";
-import type { IntegrationConfig } from "../integrations/types.js";
-import type { ApiUser } from "../types.js";
-import { type ExecuteApiResponse } from "./executor.js";
-/**
- * Unified request for executing any API (regular or streaming).
- *
- * This interface combines the fields from both `ExecuteApiRequest` and
- * `ExecuteStreamingApiRequest` into a single type. The `executeStreamingQuery`
- * field is only required when executing streaming APIs that use streaming
- * integration support.
- */
-export interface UnifiedExecuteApiRequest {
-    /** 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 (non-streaming).
-     *
-     * @param integrationId - The integration ID
-     * @param request - Plugin-specific request object
-     * @param bindings - Optional bindings for language plugins
-     * @returns Promise resolving to the operation result
-     */
-    executeQuery: (integrationId: string, request: Record<string, unknown>, bindings?: Record<string, unknown>, metadata?: TraceMetadata) => Promise<unknown>;
-    /**
-     * Function to execute streaming integration operations.
-     * Optional - only needed for streaming APIs that use streaming integrations.
-     *
-     * @param integrationId - The integration ID
-     * @param request - Plugin-specific request object
-     * @param metadata - Optional trace metadata for diagnostics
-     * @returns AsyncIterable yielding raw chunks
-     */
-    executeStreamingQuery?: (integrationId: string, request: Record<string, unknown>, metadata?: TraceMetadata) => AsyncIterable<unknown>;
-}
-/**
- * Union type for any compiled API (regular or streaming).
- *
- * Note: This is a permissive type for runtime use. The `execute` function
- * provides overloads for proper type inference.
- */
-export type AnyCompiledApi = CompiledApi<any, any> | CompiledStreamingApi<any, any>;
-/**
- * Execute a regular (non-streaming) compiled API.
- *
- * @param api - The compiled API definition
- * @param request - The execution request
- * @returns Promise resolving to execution response with success/error and output
- *
- * @example
- * ```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);
- * } else {
- *   console.error(response.error);
- * }
- * ```
- */
-export declare function execute<TInput, TOutput>(api: CompiledApi<TInput, TOutput>, request: UnifiedExecuteApiRequest): Promise<ExecuteApiResponse<TOutput>>;
-/**
- * Execute a streaming compiled API.
- *
- * @param api - The compiled streaming API definition
- * @param request - The execution request
- * @returns AsyncGenerator that yields validated chunks
- *
- * @example
- * ```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 declare function execute<TInput, TChunk>(api: CompiledStreamingApi<TInput, TChunk>, request: UnifiedExecuteApiRequest): AsyncGenerator<TChunk, void, undefined>;
-/**
- * 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.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/runtime/execute.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChF,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;AAC3C,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGpE;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,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;;;;;;;OAOG;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;;;;;;;;OAQG;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;CAC7B;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAEtB,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,GAErB,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,OAAO,EACrC,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EACpC,GAAG,EAAE,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,OAAO,EAAE,wBAAwB,GAChC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAgE3C;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/runtime/execute.js

@@ -1,84 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/streaming-context.d.ts

@@ -1,49 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}