@superblocksteam/sdk-api 0.0.4

package/dist/api/streaming.test.js

@@ -0,0 +1,364 @@
+/**
+ * Tests for streaming API definition.
+ */
+import { describe, it, expect, vi } from "vitest";
+import { z } from "zod";
+import { streamingApi, isStreamingApi } from "./streaming.js";
+import { api, __setEntryPoint } from "./definition.js";
+import { postgres, anthropic } from "../integrations/declarations.js";
+describe("streamingApi()", () => {
+    describe("basic creation", () => {
+        it("creates a streaming API with input and chunk schemas", () => {
+            const inputSchema = z.object({ prompt: z.string() });
+            const chunkSchema = z.object({ text: z.string() });
+            const streamingApiDef = streamingApi({
+                name: "TestStreamingApi",
+                input: inputSchema,
+                chunk: chunkSchema,
+                async *run() {
+                    yield { text: "Hello" };
+                    yield { text: " World" };
+                },
+            });
+            expect(streamingApiDef.inputSchema).toBe(inputSchema);
+            expect(streamingApiDef.chunkSchema).toBe(chunkSchema);
+            expect(streamingApiDef.isStreaming).toBe(true);
+            expect(typeof streamingApiDef.run).toBe("function");
+        });
+        it("creates a streaming API with integrations", () => {
+            const inputSchema = z.object({ prompt: z.string() });
+            const chunkSchema = z.object({ text: z.string() });
+            const streamingApiDef = streamingApi({
+                name: "TestStreamingApi",
+                integrations: {
+                    ai: anthropic("Production Anthropic"),
+                },
+                input: inputSchema,
+                chunk: chunkSchema,
+                async *run() {
+                    yield { text: "test" };
+                },
+            });
+            expect(streamingApiDef.integrations).toHaveLength(1);
+            expect(streamingApiDef.integrations[0]).toMatchObject({
+                key: "ai",
+                pluginId: "anthropic",
+                id: "Production Anthropic",
+            });
+        });
+        it("has empty integrations array when none declared", () => {
+            const streamingApiDef = streamingApi({
+                name: "TestStreamingApi",
+                input: z.object({ prompt: z.string() }),
+                chunk: z.object({ text: z.string() }),
+                async *run() {
+                    yield { text: "test" };
+                },
+            });
+            expect(streamingApiDef.integrations).toEqual([]);
+        });
+    });
+    describe("async generator execution", () => {
+        it("run function returns an async iterable", async () => {
+            const streamingApiDef = streamingApi({
+                name: "TestStreamingApi",
+                input: z.object({ prompt: z.string() }),
+                chunk: z.object({ text: z.string() }),
+                async *run() {
+                    yield { text: "Hello" };
+                    yield { text: " World" };
+                },
+            });
+            const mockContext = {
+                integrations: {},
+                log: {
+                    info: vi.fn(),
+                    warn: vi.fn(),
+                    error: vi.fn(),
+                    debug: vi.fn(),
+                },
+                env: {},
+            };
+            const iterator = streamingApiDef.run(mockContext, { prompt: "test" });
+            expect(Symbol.asyncIterator in iterator).toBe(true);
+            const chunks = [];
+            for await (const chunk of iterator) {
+                chunks.push(chunk);
+            }
+            expect(chunks).toEqual([{ text: "Hello" }, { text: " World" }]);
+        });
+        it("can access input in the run function", async () => {
+            const inputCapture = [];
+            const streamingApiDef = streamingApi({
+                name: "TestStreamingApi",
+                input: z.object({ prompt: z.string() }),
+                chunk: z.object({ text: z.string() }),
+                async *run(ctx, { prompt }) {
+                    inputCapture.push(prompt);
+                    yield { text: prompt };
+                },
+            });
+            const mockContext = {
+                integrations: {},
+                log: {
+                    info: vi.fn(),
+                    warn: vi.fn(),
+                    error: vi.fn(),
+                    debug: vi.fn(),
+                },
+                env: {},
+            };
+            const iterator = streamingApiDef.run(mockContext, { prompt: "Hello, AI!" });
+            const chunks = [];
+            for await (const chunk of iterator) {
+                chunks.push(chunk);
+            }
+            expect(inputCapture).toEqual(["Hello, AI!"]);
+            expect(chunks).toEqual([{ text: "Hello, AI!" }]);
+        });
+        it("yields multiple chunks over time", async () => {
+            const streamingApiDef = streamingApi({
+                name: "TestStreamingApi",
+                input: z.object({ count: z.number() }),
+                chunk: z.object({ index: z.number(), text: z.string() }),
+                async *run(ctx, { count }) {
+                    for (let i = 0; i < count; i++) {
+                        yield { index: i, text: `Chunk ${i}` };
+                    }
+                },
+            });
+            const mockContext = {
+                integrations: {},
+                log: {
+                    info: vi.fn(),
+                    warn: vi.fn(),
+                    error: vi.fn(),
+                    debug: vi.fn(),
+                },
+                env: {},
+            };
+            const iterator = streamingApiDef.run(mockContext, { count: 5 });
+            const chunks = [];
+            for await (const chunk of iterator) {
+                chunks.push(chunk);
+            }
+            expect(chunks).toHaveLength(5);
+            expect(chunks[0]).toEqual({ index: 0, text: "Chunk 0" });
+            expect(chunks[4]).toEqual({ index: 4, text: "Chunk 4" });
+        });
+    });
+    describe("readonly properties", () => {
+        it("inputSchema is readonly", () => {
+            const streamingApiDef = streamingApi({
+                name: "TestStreamingApi",
+                input: z.object({ prompt: z.string() }),
+                chunk: z.object({ text: z.string() }),
+                async *run() {
+                    yield { text: "test" };
+                },
+            });
+            expect(streamingApiDef.inputSchema).toBeDefined();
+        });
+        it("chunkSchema is readonly", () => {
+            const streamingApiDef = streamingApi({
+                name: "TestStreamingApi",
+                input: z.object({ prompt: z.string() }),
+                chunk: z.object({ text: z.string() }),
+                async *run() {
+                    yield { text: "test" };
+                },
+            });
+            expect(streamingApiDef.chunkSchema).toBeDefined();
+        });
+        it("isStreaming is always true", () => {
+            const streamingApiDef = streamingApi({
+                name: "TestStreamingApi",
+                input: z.object({ prompt: z.string() }),
+                chunk: z.object({ text: z.string() }),
+                async *run() {
+                    yield { text: "test" };
+                },
+            });
+            expect(streamingApiDef.isStreaming).toBe(true);
+        });
+    });
+});
+describe("isStreamingApi()", () => {
+    describe("with streaming APIs", () => {
+        it("returns true for streaming API", () => {
+            const streamingApiDef = streamingApi({
+                name: "TestStreamingApi",
+                input: z.object({ prompt: z.string() }),
+                chunk: z.object({ text: z.string() }),
+                async *run() {
+                    yield { text: "test" };
+                },
+            });
+            expect(isStreamingApi(streamingApiDef)).toBe(true);
+        });
+    });
+    describe("with regular APIs", () => {
+        it("returns false for regular API", () => {
+            const regularApi = api({
+                name: "RegularApi",
+                input: z.object({ userId: z.string() }),
+                output: z.object({ name: z.string() }),
+                async run() {
+                    return { name: "Test" };
+                },
+            });
+            expect(isStreamingApi(regularApi)).toBe(false);
+        });
+    });
+    describe("with non-API values", () => {
+        it("returns false for null", () => {
+            expect(isStreamingApi(null)).toBe(false);
+        });
+        it("returns false for undefined", () => {
+            expect(isStreamingApi(undefined)).toBe(false);
+        });
+        it("returns false for plain object", () => {
+            expect(isStreamingApi({ isStreaming: false })).toBe(false);
+        });
+        it("returns false for number", () => {
+            expect(isStreamingApi(42)).toBe(false);
+        });
+        it("returns false for string", () => {
+            expect(isStreamingApi("streaming")).toBe(false);
+        });
+        it("returns false for object without isStreaming property", () => {
+            expect(isStreamingApi({ inputSchema: z.string() })).toBe(false);
+        });
+        it("returns false for object with only isStreaming true but missing required fields", () => {
+            expect(isStreamingApi({ isStreaming: true })).toBe(false);
+        });
+        it("returns true for object with isStreaming true and all required fields", () => {
+            expect(isStreamingApi({
+                isStreaming: true,
+                inputSchema: z.string(),
+                chunkSchema: z.string(),
+                run: () => { },
+            })).toBe(true);
+        });
+    });
+});
+describe("type inference", () => {
+    it("infers input type from schema", () => {
+        const streamingApiDef = streamingApi({
+            name: "TestStreamingApi",
+            input: z.object({
+                prompt: z.string(),
+                maxTokens: z.number().optional(),
+            }),
+            chunk: z.object({ text: z.string() }),
+            async *run(ctx, { prompt, maxTokens }) {
+                const p = prompt;
+                const m = maxTokens;
+                yield { text: `${p} ${m ?? 100}` };
+            },
+        });
+        expect(streamingApiDef).toBeDefined();
+    });
+    it("infers chunk type from schema", () => {
+        const streamingApiDef = streamingApi({
+            name: "TestStreamingApi",
+            input: z.object({ prompt: z.string() }),
+            chunk: z.object({
+                type: z.literal("text-delta"),
+                text: z.string(),
+                index: z.number(),
+            }),
+            async *run() {
+                yield {
+                    type: "text-delta",
+                    text: "Hello",
+                    index: 0,
+                };
+            },
+        });
+        expect(streamingApiDef.chunkSchema).toBeDefined();
+    });
+    it("infers integration types", () => {
+        const streamingApiDef = streamingApi({
+            name: "TestStreamingApi",
+            integrations: {
+                ai: anthropic("AI Service"),
+                db: postgres("Database"),
+            },
+            input: z.object({ prompt: z.string() }),
+            chunk: z.object({ text: z.string() }),
+            async *run() {
+                yield { text: "test" };
+            },
+        });
+        expect(streamingApiDef.integrations).toHaveLength(2);
+    });
+});
+describe("entryPoint mechanism", () => {
+    it("streamingApi() has no entryPoint when __setEntryPoint was not called", () => {
+        const compiled = streamingApi({
+            name: "NoEntryPoint",
+            input: z.object({}),
+            chunk: z.object({ text: z.string() }),
+            async *run() {
+                yield { text: "hello" };
+            },
+        });
+        expect(compiled.entryPoint).toBeUndefined();
+    });
+    it("streamingApi() picks up entryPoint set via __setEntryPoint", () => {
+        __setEntryPoint("server/apis/Chat/api.ts");
+        const compiled = streamingApi({
+            name: "Chat",
+            input: z.object({ prompt: z.string() }),
+            chunk: z.object({ text: z.string() }),
+            async *run() {
+                yield { text: "hello" };
+            },
+        });
+        expect(compiled.entryPoint).toBe("server/apis/Chat/api.ts");
+    });
+    it("entryPoint is consumed once — second streamingApi() call gets undefined", () => {
+        __setEntryPoint("server/apis/Stream/api.ts");
+        const first = streamingApi({
+            name: "Stream",
+            input: z.object({}),
+            chunk: z.object({ text: z.string() }),
+            async *run() {
+                yield { text: "a" };
+            },
+        });
+        const second = streamingApi({
+            name: "Stream2",
+            input: z.object({}),
+            chunk: z.object({ text: z.string() }),
+            async *run() {
+                yield { text: "b" };
+            },
+        });
+        expect(first.entryPoint).toBe("server/apis/Stream/api.ts");
+        expect(second.entryPoint).toBeUndefined();
+    });
+    it("__setEntryPoint works across api() and streamingApi()", () => {
+        __setEntryPoint("server/apis/Mixed/api.ts");
+        const compiled = streamingApi({
+            name: "Mixed",
+            input: z.object({}),
+            chunk: z.object({ text: z.string() }),
+            async *run() {
+                yield { text: "mixed" };
+            },
+        });
+        expect(compiled.entryPoint).toBe("server/apis/Mixed/api.ts");
+        const afterConsume = api({
+            name: "After",
+            input: z.object({}),
+            output: z.object({}),
+            async run() {
+                return {};
+            },
+        });
+        expect(afterConsume.entryPoint).toBeUndefined();
+    });
+});
+//# sourceMappingURL=streaming.test.js.map

package/dist/api/streaming.test.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Error classes for SDK runtime errors.
+ */
+import type { z } from "zod";
+/**
+ * Error thrown when REST API response or request body validation fails.
+ *
+ * Contains the complete Zod error object and the actual data that failed validation,
+ * providing full context for debugging schema mismatches.
+ */
+export declare class RestApiValidationError extends Error {
+    readonly details: {
+        /** The complete Zod error object with all validation information */
+        zodError: z.ZodError;
+        /** The actual data that failed validation (request body or response) */
+        data: unknown;
+    };
+    constructor(message: string, details: {
+        /** The complete Zod error object with all validation information */
+        zodError: z.ZodError;
+        /** The actual data that failed validation (request body or response) */
+        data: unknown;
+    });
+}
+/**
+ * Error thrown when query results fail schema validation.
+ *
+ * Contains detailed information about which row failed validation
+ * and the specific field-level errors from Zod.
+ */
+export declare class QueryValidationError extends Error {
+    readonly details: {
+        /** Index of the row that failed validation (0-based) */
+        rowIndex: number;
+        /** Array of field-level validation errors from Zod */
+        errors: Array<{
+            path: (string | number)[];
+            message: string;
+        }>;
+        /** The raw row data that failed validation */
+        row: unknown;
+    };
+    constructor(message: string, details: {
+        /** Index of the row that failed validation (0-based) */
+        rowIndex: number;
+        /** Array of field-level validation errors from Zod */
+        errors: Array<{
+            path: (string | number)[];
+            message: string;
+        }>;
+        /** The raw row data that failed validation */
+        row: unknown;
+    });
+}
+/**
+ * Error thrown when Python/JavaScript code execution fails.
+ *
+ * Contains context about the code, bindings, and any validation errors
+ * that occurred during execution.
+ */
+export declare class CodeExecutionError extends Error {
+    readonly details?: {
+        /** The code that was executed */
+        code?: string;
+        /** Bindings that were passed to the code */
+        bindings?: Record<string, unknown>;
+        /** The actual result that failed validation */
+        result?: unknown;
+        /** Zod validation error if validation failed */
+        zodError?: z.ZodError;
+        /** Original error from the execution runtime */
+        originalError?: unknown;
+    } | undefined;
+    constructor(message: string, details?: {
+        /** The code that was executed */
+        code?: string;
+        /** Bindings that were passed to the code */
+        bindings?: Record<string, unknown>;
+        /** The actual result that failed validation */
+        result?: unknown;
+        /** Zod validation error if validation failed */
+        zodError?: z.ZodError;
+        /** Original error from the execution runtime */
+        originalError?: unknown;
+    } | undefined);
+}
+/**
+ * Error thrown when a streamed chunk fails validation.
+ *
+ * Contains information about the chunk index, the raw chunk data,
+ * and the Zod validation error details.
+ */
+export declare class StreamChunkValidationError extends Error {
+    readonly details: {
+        /** Index of the chunk that failed validation (0-based) */
+        chunkIndex: number;
+        /** The raw chunk data that failed validation */
+        chunk: unknown;
+        /** The complete Zod error object with all validation information */
+        zodError: z.ZodError;
+    };
+    constructor(message: string, details: {
+        /** Index of the chunk that failed validation (0-based) */
+        chunkIndex: number;
+        /** The raw chunk data that failed validation */
+        chunk: unknown;
+        /** The complete Zod error object with all validation information */
+        zodError: z.ZodError;
+    });
+}
+/**
+ * Error thrown when a streaming API encounters an error mid-stream.
+ *
+ * This error indicates that the stream was interrupted before completion.
+ * Contains context about where in the stream the error occurred.
+ */
+export declare class StreamError extends Error {
+    readonly details?: {
+        /** Number of chunks successfully received before the error */
+        chunksReceived?: number;
+        /** The original error that caused the stream to fail */
+        originalError?: unknown;
+    } | undefined;
+    constructor(message: string, details?: {
+        /** Number of chunks successfully received before the error */
+        chunksReceived?: number;
+        /** The original error that caused the stream to fail */
+        originalError?: unknown;
+    } | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -0,0 +1,84 @@
+/**
+ * Error classes for SDK runtime errors.
+ */
+/**
+ * Error thrown when REST API response or request body validation fails.
+ *
+ * Contains the complete Zod error object and the actual data that failed validation,
+ * providing full context for debugging schema mismatches.
+ */
+export class RestApiValidationError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "RestApiValidationError";
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, RestApiValidationError.prototype);
+    }
+}
+/**
+ * Error thrown when query results fail schema validation.
+ *
+ * Contains detailed information about which row failed validation
+ * and the specific field-level errors from Zod.
+ */
+export class QueryValidationError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "QueryValidationError";
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, QueryValidationError.prototype);
+    }
+}
+/**
+ * Error thrown when Python/JavaScript code execution fails.
+ *
+ * Contains context about the code, bindings, and any validation errors
+ * that occurred during execution.
+ */
+export class CodeExecutionError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "CodeExecutionError";
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, CodeExecutionError.prototype);
+    }
+}
+/**
+ * Error thrown when a streamed chunk fails validation.
+ *
+ * Contains information about the chunk index, the raw chunk data,
+ * and the Zod validation error details.
+ */
+export class StreamChunkValidationError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "StreamChunkValidationError";
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, StreamChunkValidationError.prototype);
+    }
+}
+/**
+ * Error thrown when a streaming API encounters an error mid-stream.
+ *
+ * This error indicates that the stream was interrupted before completion.
+ * Contains context about where in the stream the error occurred.
+ */
+export class StreamError extends Error {
+    details;
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = "StreamError";
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, StreamError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAG7B;IAFlB,YACE,OAAe,EACC,OAKf;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QAPC,YAAO,GAAP,OAAO,CAKtB;QAGD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAG3B;IAFlB,YACE,OAAe,EACC,OAOf;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QATC,YAAO,GAAP,OAAO,CAOtB;QAGD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAGzB;IAFlB,YACE,OAAe,EACC,OAWf;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QAbC,YAAO,GAAP,OAAO,CAWtB;QAGD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAGjC;IAFlB,YACE,OAAe,EACC,OAOf;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QATC,YAAO,GAAP,OAAO,CAOtB;QAGD,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGlB;IAFlB,YACE,OAAe,EACC,OAKf;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QAPC,YAAO,GAAP,OAAO,CAKtB;QAGD,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,sDAAsD;QACtD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF"}