cooper-stack 0.5.2

package/dist/registry.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Internal registry — Cooper's Rust runtime communicates with JS workers
+ * by referencing registered handlers by name. This module tracks all
+ * declarations (routes, topics, crons, queues, etc.) so the bridge
+ * can look them up at runtime.
+ */
+export interface RegisteredRoute {
+    method: string;
+    path: string;
+    auth: boolean;
+    stream?: "sse" | "websocket";
+    validate?: any;
+    middleware: MiddlewareFn[];
+    handler: Function;
+    exportName: string;
+    sourceFile: string;
+}
+export interface RegisteredTopic {
+    name: string;
+    subscribers: Map<string, {
+        handler: Function;
+        options: any;
+    }>;
+}
+export interface RegisteredCron {
+    name: string;
+    schedule: string;
+    handler: Function;
+}
+export interface RegisteredQueue {
+    name: string;
+    options: any;
+    worker?: {
+        name: string;
+        handler: Function;
+        onFailure?: Function;
+    };
+}
+export interface RegisteredDatabase {
+    name: string;
+    engine: string;
+    pool: any;
+}
+export interface RegisteredCache {
+    name: string;
+    options: any;
+}
+export interface RegisteredBucket {
+    name: string;
+    options: any;
+}
+export type MiddlewareFn = (req: any, next: (req: any) => Promise<any>) => Promise<any>;
+export type AuthHandlerFn = (token: string) => Promise<Record<string, any>>;
+declare class Registry {
+    routes: Map<string, RegisteredRoute>;
+    topics: Map<string, RegisteredTopic>;
+    crons: Map<string, RegisteredCron>;
+    queues: Map<string, RegisteredQueue>;
+    databases: Map<string, RegisteredDatabase>;
+    caches: Map<string, RegisteredCache>;
+    buckets: Map<string, RegisteredBucket>;
+    secrets: Map<string, () => Promise<string>>;
+    globalMiddleware: MiddlewareFn[];
+    authHandler: AuthHandlerFn | null;
+    registerRoute(key: string, route: RegisteredRoute): void;
+    registerTopic(name: string, topic: RegisteredTopic): void;
+    registerCron(name: string, cron: RegisteredCron): void;
+    registerQueue(name: string, queue: RegisteredQueue): void;
+    registerDatabase(name: string, db: RegisteredDatabase): void;
+    setAuthHandler(handler: AuthHandlerFn): void;
+    addGlobalMiddleware(mw: MiddlewareFn): void;
+}
+export declare const registry: Registry;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

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

package/dist/registry.js

@@ -0,0 +1,41 @@
+/**
+ * Internal registry — Cooper's Rust runtime communicates with JS workers
+ * by referencing registered handlers by name. This module tracks all
+ * declarations (routes, topics, crons, queues, etc.) so the bridge
+ * can look them up at runtime.
+ */
+class Registry {
+    routes = new Map();
+    topics = new Map();
+    crons = new Map();
+    queues = new Map();
+    databases = new Map();
+    caches = new Map();
+    buckets = new Map();
+    secrets = new Map();
+    globalMiddleware = [];
+    authHandler = null;
+    registerRoute(key, route) {
+        this.routes.set(key, route);
+    }
+    registerTopic(name, topic) {
+        this.topics.set(name, topic);
+    }
+    registerCron(name, cron) {
+        this.crons.set(name, cron);
+    }
+    registerQueue(name, queue) {
+        this.queues.set(name, queue);
+    }
+    registerDatabase(name, db) {
+        this.databases.set(name, db);
+    }
+    setAuthHandler(handler) {
+        this.authHandler = handler;
+    }
+    addGlobalMiddleware(mw) {
+        this.globalMiddleware.push(mw);
+    }
+}
+export const registry = new Registry();
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmDH,MAAM,QAAQ;IACZ,MAAM,GAAiC,IAAI,GAAG,EAAE,CAAC;IACjD,MAAM,GAAiC,IAAI,GAAG,EAAE,CAAC;IACjD,KAAK,GAAgC,IAAI,GAAG,EAAE,CAAC;IAC/C,MAAM,GAAiC,IAAI,GAAG,EAAE,CAAC;IACjD,SAAS,GAAoC,IAAI,GAAG,EAAE,CAAC;IACvD,MAAM,GAAiC,IAAI,GAAG,EAAE,CAAC;IACjD,OAAO,GAAkC,IAAI,GAAG,EAAE,CAAC;IACnD,OAAO,GAAuC,IAAI,GAAG,EAAE,CAAC;IACxD,gBAAgB,GAAmB,EAAE,CAAC;IACtC,WAAW,GAAyB,IAAI,CAAC;IAEzC,aAAa,CAAC,GAAW,EAAE,KAAsB;QAC/C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,aAAa,CAAC,IAAY,EAAE,KAAsB;QAChD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,YAAY,CAAC,IAAY,EAAE,IAAoB;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,aAAa,CAAC,IAAY,EAAE,KAAsB;QAChD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,gBAAgB,CAAC,IAAY,EAAE,EAAsB;QACnD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,cAAc,CAAC,OAAsB;QACnC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;IAC7B,CAAC;IAED,mBAAmB,CAAC,EAAgB;QAClC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC"}

package/dist/secrets.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Declare a secret — fetched at runtime, never in .env or source code.
+ *
+ * ```ts
+ * const stripeKey = secret("stripe-api-key");
+ * const client = new Stripe(await stripeKey());
+ * ```
+ */
+export declare function secret(name: string): () => Promise<string>;
+//# sourceMappingURL=secrets.d.ts.map

package/dist/secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.d.ts","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CA+B1D"}

package/dist/secrets.js

@@ -0,0 +1,35 @@
+/**
+ * Declare a secret — fetched at runtime, never in .env or source code.
+ *
+ * ```ts
+ * const stripeKey = secret("stripe-api-key");
+ * const client = new Stripe(await stripeKey());
+ * ```
+ */
+export function secret(name) {
+    let cached = null;
+    const resolve = async () => {
+        if (cached !== null)
+            return cached;
+        // 1. Check env var (set by `cooper secrets set`)
+        const envKey = `COOPER_SECRET_${name.toUpperCase().replace(/-/g, "_")}`;
+        const envVal = process.env[envKey];
+        if (envVal) {
+            cached = envVal;
+            return envVal;
+        }
+        // 2. Check .cooper/secrets/<env>/<name>
+        const fs = require("node:fs");
+        const path = require("node:path");
+        const env = process.env.COOPER_ENV ?? "local";
+        const secretPath = path.join(".cooper", "secrets", env, name);
+        if (fs.existsSync(secretPath)) {
+            const val = fs.readFileSync(secretPath, "utf-8").trim();
+            cached = val;
+            return val;
+        }
+        throw new Error(`Secret "${name}" not found. Set it with: cooper secrets set ${name} --env ${env}`);
+    };
+    return resolve;
+}
+//# sourceMappingURL=secrets.js.map

package/dist/secrets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../src/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,IAAI,MAAM,GAAkB,IAAI,CAAC;IAEjC,MAAM,OAAO,GAAG,KAAK,IAAqB,EAAE;QAC1C,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAEnC,iDAAiD;QACjD,MAAM,MAAM,GAAG,iBAAiB,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,GAAG,MAAM,CAAC;YAChB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,wCAAwC;QACxC,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAClC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC;QAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAW,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAChE,MAAM,GAAG,GAAG,CAAC;YACb,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,gDAAgD,IAAI,UAAU,GAAG,EAAE,CACnF,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/ssr.d.ts

@@ -0,0 +1,53 @@
+export interface PageConfig {
+    cache?: string;
+    auth?: boolean;
+}
+export interface PageContext {
+    params: Record<string, string>;
+    req?: any;
+    data?: any;
+}
+/**
+ * Define a server-rendered page.
+ *
+ * ```ts
+ * export default page(async ({ params }) => {
+ *   const { user } = await UsersService.getUser({ id: params.id });
+ *   return <div><h1>{user.name}</h1></div>;
+ * });
+ * ```
+ */
+export declare function page<T = any>(render: (ctx: PageContext) => Promise<T>): {
+    _cooper_type: "page";
+    render: typeof render;
+};
+/**
+ * Define a layout that wraps pages.
+ *
+ * ```ts
+ * export default layout(({ children }) => (
+ *   <div><Nav /><main>{children}</main><Footer /></div>
+ * ));
+ * ```
+ */
+export declare function layout<T = any>(render: (props: {
+    children: any;
+}) => T): {
+    _cooper_type: "layout";
+    render: typeof render;
+};
+/**
+ * Define a page data loader — runs on the server, data passed to the page.
+ */
+export declare function pageLoader<T>(loader: (ctx: PageContext) => Promise<T>): {
+    _cooper_type: "loader";
+    loader: typeof loader;
+};
+/**
+ * Suspense boundary for streaming SSR.
+ */
+export declare function Suspense(_props: {
+    fallback: any;
+    children: any;
+}): null;
+//# sourceMappingURL=ssr.d.ts.map

package/dist/ssr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.d.ts","sourceRoot":"","sources":["../src/ssr.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,CAAC,GAAG,GAAG,EAC1B,MAAM,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACvC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,MAAM,CAAA;CAAE,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,GAAG,GAAG,EAC5B,MAAM,EAAE,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAA;CAAE,KAAK,CAAC,GACtC;IAAE,YAAY,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,OAAO,MAAM,CAAA;CAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,MAAM,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GACvC;IAAE,YAAY,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,OAAO,MAAM,CAAA;CAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,GAAG,CAAC;IAAC,QAAQ,EAAE,GAAG,CAAA;CAAE,QAGhE"}

package/dist/ssr.js

@@ -0,0 +1,39 @@
+/**
+ * Define a server-rendered page.
+ *
+ * ```ts
+ * export default page(async ({ params }) => {
+ *   const { user } = await UsersService.getUser({ id: params.id });
+ *   return <div><h1>{user.name}</h1></div>;
+ * });
+ * ```
+ */
+export function page(render) {
+    return { _cooper_type: "page", render };
+}
+/**
+ * Define a layout that wraps pages.
+ *
+ * ```ts
+ * export default layout(({ children }) => (
+ *   <div><Nav /><main>{children}</main><Footer /></div>
+ * ));
+ * ```
+ */
+export function layout(render) {
+    return { _cooper_type: "layout", render };
+}
+/**
+ * Define a page data loader — runs on the server, data passed to the page.
+ */
+export function pageLoader(loader) {
+    return { _cooper_type: "loader", loader };
+}
+/**
+ * Suspense boundary for streaming SSR.
+ */
+export function Suspense(_props) {
+    // Handled by the SSR renderer — this is a marker component
+    return null;
+}
+//# sourceMappingURL=ssr.js.map

package/dist/ssr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr.js","sourceRoot":"","sources":["../src/ssr.ts"],"names":[],"mappings":"AAWA;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAClB,MAAwC;IAExC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CACpB,MAAuC;IAEvC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,MAAwC;IAExC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAwC;IAC/D,2DAA2D;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/storage.d.ts

@@ -0,0 +1,28 @@
+export interface BucketConfig {
+    public?: boolean;
+}
+export interface BucketClient {
+    upload(key: string, data: Buffer | Uint8Array, opts?: {
+        contentType?: string;
+    }): Promise<void>;
+    download(key: string): Promise<Buffer>;
+    signedUrl(key: string, opts?: {
+        ttl?: string;
+    }): Promise<string>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string): Promise<{
+        key: string;
+        size: number;
+        lastModified: Date;
+    }[]>;
+}
+/**
+ * Declare an object storage bucket.
+ *
+ * ```ts
+ * export const avatars = bucket("avatars", { public: true });
+ * await avatars.upload("user-123/avatar.png", buffer, { contentType: "image/png" });
+ * ```
+ */
+export declare function bucket(name: string, config?: BucketConfig): BucketClient;
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/F,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,IAAI,CAAA;KAAE,EAAE,CAAC,CAAC;CACrF;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,CA0DxE"}

package/dist/storage.js

@@ -0,0 +1,61 @@
+/**
+ * Declare an object storage bucket.
+ *
+ * ```ts
+ * export const avatars = bucket("avatars", { public: true });
+ * await avatars.upload("user-123/avatar.png", buffer, { contentType: "image/png" });
+ * ```
+ */
+export function bucket(name, config) {
+    const fs = require("node:fs");
+    const path = require("node:path");
+    // Local storage directory — in production this maps to S3/GCS/Azure Blob
+    const localDir = path.join(process.env.COOPER_STORAGE_DIR ?? ".cooper/storage", name);
+    return {
+        async upload(key, data, opts) {
+            const fullPath = path.join(localDir, key);
+            fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+            fs.writeFileSync(fullPath, data);
+        },
+        async download(key) {
+            const fullPath = path.join(localDir, key);
+            return fs.readFileSync(fullPath);
+        },
+        async signedUrl(key, opts) {
+            // In local dev, return a direct file path
+            // In production, generate a presigned S3/GCS URL
+            return `http://localhost:9400/storage/${name}/${key}`;
+        },
+        async delete(key) {
+            const fullPath = path.join(localDir, key);
+            if (fs.existsSync(fullPath))
+                fs.unlinkSync(fullPath);
+        },
+        async list(prefix) {
+            const dir = prefix ? path.join(localDir, prefix) : localDir;
+            if (!fs.existsSync(dir))
+                return [];
+            const entries = [];
+            const walk = (d, rel) => {
+                for (const entry of fs.readdirSync(d, { withFileTypes: true })) {
+                    const fullPath = path.join(d, entry.name);
+                    const relPath = rel ? `${rel}/${entry.name}` : entry.name;
+                    if (entry.isDirectory()) {
+                        walk(fullPath, relPath);
+                    }
+                    else {
+                        const stat = fs.statSync(fullPath);
+                        entries.push({
+                            key: relPath,
+                            size: stat.size,
+                            lastModified: stat.mtime,
+                        });
+                    }
+                }
+            };
+            walk(dir, "");
+            return entries;
+        },
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "cooper-stack",
+  "version": "0.5.2",
+  "description": "The backend framework for TypeScript",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./api": "./dist/api.js",
+    "./db": "./dist/db.js",
+    "./middleware": "./dist/middleware.js",
+    "./auth": "./dist/auth.js",
+    "./pubsub": "./dist/pubsub.js",
+    "./cron": "./dist/cron.js",
+    "./cache": "./dist/cache.js",
+    "./storage": "./dist/storage.js",
+    "./secrets": "./dist/secrets.js",
+    "./queue": "./dist/queue.js",
+    "./ssr": "./dist/ssr.js",
+    "./islands": "./dist/islands.js",
+    "./ai": "./dist/ai.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "pg": "^8.13.0",
+    "mysql2": "^3.11.0",
+    "ioredis": "^5.4.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "@types/pg": "^8.11.0"
+  }
+}

package/src/ai.ts

@@ -0,0 +1,99 @@
+export interface VectorStoreConfig {
+  dimensions: number;
+  similarity?: "cosine" | "euclidean" | "dot";
+}
+
+export interface VectorStoreClient {
+  upsert(id: string, vector: number[], metadata?: Record<string, any>): Promise<void>;
+  search(vector: number[], opts?: { topK?: number; filter?: Record<string, any> }): Promise<{ id: string; score: number; metadata?: any }[]>;
+  delete(id: string): Promise<void>;
+}
+
+export interface LLMGatewayConfig {
+  primary: { provider: string; model: string };
+  fallback?: { provider: string; model: string };
+  budget?: { dailyLimit: string };
+}
+
+export interface LLMGatewayClient {
+  chat(messages: { role: string; content: string }[]): Promise<string>;
+  embed(text: string): Promise<number[]>;
+}
+
+/**
+ * Declare a vector store.
+ *
+ * ```ts
+ * export const embeddings = vectorStore("product-embeddings", {
+ *   dimensions: 1536,
+ *   similarity: "cosine",
+ * });
+ * ```
+ */
+export function vectorStore(name: string, config: VectorStoreConfig): VectorStoreClient {
+  // Local dev: pgvector extension on embedded Postgres
+  // Production: Pinecone, Weaviate, or pgvector on managed Postgres
+  const store = new Map<string, { vector: number[]; metadata?: any }>();
+
+  const cosineSimilarity = (a: number[], b: number[]): number => {
+    let dot = 0, magA = 0, magB = 0;
+    for (let i = 0; i < a.length; i++) {
+      dot += a[i] * b[i];
+      magA += a[i] * a[i];
+      magB += b[i] * b[i];
+    }
+    return dot / (Math.sqrt(magA) * Math.sqrt(magB));
+  };
+
+  return {
+    async upsert(id, vector, metadata) {
+      store.set(id, { vector, metadata });
+    },
+
+    async search(vector, opts) {
+      const topK = opts?.topK ?? 10;
+      const results: { id: string; score: number; metadata?: any }[] = [];
+
+      for (const [id, entry] of store) {
+        const score = cosineSimilarity(vector, entry.vector);
+        results.push({ id, score, metadata: entry.metadata });
+      }
+
+      results.sort((a, b) => b.score - a.score);
+      return results.slice(0, topK);
+    },
+
+    async delete(id) {
+      store.delete(id);
+    },
+  };
+}
+
+/**
+ * Declare an LLM gateway with cost tracking and fallbacks.
+ *
+ * ```ts
+ * export const llm = llmGateway({
+ *   primary: { provider: "openai", model: "gpt-4o" },
+ *   fallback: { provider: "anthropic", model: "claude-sonnet-4-20250514" },
+ *   budget: { dailyLimit: "$50" },
+ * });
+ * ```
+ */
+export function llmGateway(config: LLMGatewayConfig): LLMGatewayClient {
+  return {
+    async chat(messages) {
+      // Route to the configured provider
+      // Track cost, apply rate limits, handle fallback
+      throw new Error(
+        `LLM gateway not yet connected. Configure API keys via: cooper secrets set ${config.primary.provider}-api-key --env local`
+      );
+    },
+
+    async embed(text) {
+      throw new Error(
+        `LLM gateway not yet connected. Configure API keys via: cooper secrets set ${config.primary.provider}-api-key --env local`
+      );
+    },
+  };
+}

package/src/api.ts

@@ -0,0 +1,56 @@
+import { registry, type MiddlewareFn } from "./registry.js";
+import { CooperError } from "./error.js";
+
+export interface ApiConfig {
+  method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+  path: string;
+  auth?: boolean;
+  stream?: "sse" | "websocket";
+  validate?: any; // Zod schema
+  middleware?: MiddlewareFn[];
+}
+
+/**
+ * Define an API endpoint.
+ *
+ * ```ts
+ * export const getUser = api(
+ *   { method: "GET", path: "/users/:id", auth: true },
+ *   async ({ id }, principal) => {
+ *     const user = await db.queryRow("SELECT * FROM users WHERE id = $1", [id]);
+ *     if (!user) throw new CooperError("NOT_FOUND", "User not found");
+ *     return { user };
+ *   }
+ * );
+ * ```
+ */
+export function api<TInput = any, TOutput = any>(
+  config: ApiConfig,
+  handler: (input: TInput, principal?: any) => Promise<TOutput>
+): { _cooper_type: "api"; config: ApiConfig; handler: typeof handler } {
+  const method = config.method ?? "GET";
+  const key = `${method}:${config.path}`;
+
+  const descriptor = {
+    _cooper_type: "api" as const,
+    config,
+    handler,
+  };
+
+  // Register for the bridge to find at runtime
+  registry.registerRoute(key, {
+    method,
+    path: config.path,
+    auth: config.auth ?? false,
+    stream: config.stream,
+    validate: config.validate,
+    middleware: config.middleware ?? [],
+    handler,
+    exportName: "", // filled in by bridge during module scan
+    sourceFile: "",
+  });
+
+  return descriptor;
+}
+
+export { CooperError };

package/src/auth.ts

@@ -0,0 +1,16 @@
+import { registry, type AuthHandlerFn } from "./registry.js";
+
+/**
+ * Register an auth handler that verifies tokens and returns a principal.
+ *
+ * ```ts
+ * export const auth = authHandler(async (token) => {
+ *   const payload = await verifyJWT(token);
+ *   return { userId: payload.sub, role: payload.role };
+ * });
+ * ```
+ */
+export function authHandler(handler: AuthHandlerFn) {
+  registry.setAuthHandler(handler);
+  return handler;
+}