cooper-stack 0.1.0

package/dist/cron.js

@@ -0,0 +1,26 @@
+import { registry } from "./registry.js";
+/**
+ * Declare a cron job.
+ *
+ * ```ts
+ * export const cleanup = cron("cleanup", {
+ *   schedule: "every 1 hour",
+ *   handler: async () => {
+ *     await db.query("DELETE FROM sessions WHERE expires_at < NOW()");
+ *   },
+ * });
+ * ```
+ */
+export function cron(name, config) {
+    registry.registerCron(name, {
+        name,
+        schedule: config.schedule,
+        handler: config.handler,
+    });
+    return {
+        _cooper_type: "cron",
+        name,
+        schedule: config.schedule,
+    };
+}
+//# sourceMappingURL=cron.js.map

package/dist/cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.js","sourceRoot":"","sources":["../src/cron.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOzC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,MAAkB;IACnD,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE;QAC1B,IAAI;QACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC;IAEH,OAAO;QACL,YAAY,EAAE,MAAe;QAC7B,IAAI;QACJ,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,46 @@
+export interface DatabaseConfig {
+    engine?: "postgres" | "mysql" | "mongodb" | "dynamodb";
+    migrations?: string;
+    partitionKey?: string;
+    sortKey?: string;
+}
+export interface TransactionClient {
+    /** Run a query returning multiple rows */
+    query<T = any>(sql: string, params?: any[]): Promise<T[]>;
+    /** Run a query returning a single row or null */
+    queryRow<T = any>(sql: string, params?: any[]): Promise<T | null>;
+    /** Run a query returning affected row count */
+    exec(sql: string, params?: any[]): Promise<{
+        rowCount: number;
+    }>;
+    /** Insert and return the inserted row */
+    insert<T = any>(table: string, data: Record<string, any>): Promise<T>;
+    /** Access the underlying connection (single client, not pool) */
+    conn: any;
+}
+export interface DatabaseClient {
+    /** Run a query returning multiple rows */
+    query<T = any>(sql: string, params?: any[]): Promise<T[]>;
+    /** Run a query returning a single row or null */
+    queryRow<T = any>(sql: string, params?: any[]): Promise<T | null>;
+    /** Run a query returning affected row count */
+    exec(sql: string, params?: any[]): Promise<{
+        rowCount: number;
+    }>;
+    /** Insert and return the inserted row */
+    insert<T = any>(table: string, data: Record<string, any>): Promise<T>;
+    /** Run a callback inside a transaction — auto-commits on success, rolls back on error */
+    transaction<R = any>(fn: (tx: TransactionClient) => Promise<R>): Promise<R>;
+    /** Access the underlying connection pool (for ORMs like Drizzle) */
+    pool: any;
+}
+/**
+ * Declare a database.
+ *
+ * ```ts
+ * export const db = database("main", { migrations: "./migrations" });
+ * const user = await db.queryRow<User>("SELECT * FROM users WHERE id = $1", [id]);
+ * ```
+ */
+export declare function database(name: string, config?: DatabaseConfig): DatabaseClient;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1D,iDAAiD;IACjD,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClE,+CAA+C;IAC/C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,yCAAyC;IACzC,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,iEAAiE;IACjE,IAAI,EAAE,GAAG,CAAC;CACX;AAED,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1D,iDAAiD;IACjD,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClE,+CAA+C;IAC/C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,yCAAyC;IACzC,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtE,yFAAyF;IACzF,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5E,oEAAoE;IACpE,IAAI,EAAE,GAAG,CAAC;CACX;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,cAAc,CAqK9E"}

package/dist/db.js

@@ -0,0 +1,158 @@
+import { registry } from "./registry.js";
+/**
+ * Declare a database.
+ *
+ * ```ts
+ * export const db = database("main", { migrations: "./migrations" });
+ * const user = await db.queryRow<User>("SELECT * FROM users WHERE id = $1", [id]);
+ * ```
+ */
+export function database(name, config) {
+    const engine = config?.engine ?? "postgres";
+    // Connection details injected by the Rust runtime via env vars
+    const connStr = process.env[`COOPER_DB_${name.toUpperCase()}_URL`]
+        ?? `postgres://cooper:cooper@localhost:5432/cooper_${name}`;
+    let pool = null;
+    const ensurePool = async () => {
+        if (pool)
+            return pool;
+        if (engine === "postgres") {
+            const pg = await import("pg");
+            pool = new pg.default.Pool({ connectionString: connStr });
+            return pool;
+        }
+        if (engine === "mysql") {
+            const mysql = await import("mysql2/promise");
+            pool = await mysql.createPool(connStr);
+            return pool;
+        }
+        throw new Error(`Database engine "${engine}" not yet supported in JS runtime`);
+    };
+    const client = {
+        async query(sql, params) {
+            const p = await ensurePool();
+            if (engine === "postgres") {
+                const res = await p.query(sql, params);
+                return res.rows;
+            }
+            if (engine === "mysql") {
+                const [rows] = await p.execute(sql, params);
+                return rows;
+            }
+            return [];
+        },
+        async queryRow(sql, params) {
+            const rows = await client.query(sql, params);
+            return rows[0] ?? null;
+        },
+        async exec(sql, params) {
+            const p = await ensurePool();
+            if (engine === "postgres") {
+                const res = await p.query(sql, params);
+                return { rowCount: res.rowCount ?? 0 };
+            }
+            if (engine === "mysql") {
+                const [result] = await p.execute(sql, params);
+                return { rowCount: result.affectedRows ?? 0 };
+            }
+            return { rowCount: 0 };
+        },
+        async insert(table, data) {
+            const keys = Object.keys(data);
+            const values = Object.values(data);
+            const placeholders = keys.map((_, i) => engine === "postgres" ? `$${i + 1}` : "?");
+            const sql = `INSERT INTO ${table} (${keys.join(", ")}) VALUES (${placeholders.join(", ")}) RETURNING *`;
+            const row = await client.queryRow(sql, values);
+            return row;
+        },
+        async transaction(fn) {
+            const p = await ensurePool();
+            if (engine === "postgres") {
+                const pgClient = await p.connect();
+                try {
+                    await pgClient.query("BEGIN");
+                    const tx = {
+                        async query(sql, params) {
+                            const res = await pgClient.query(sql, params);
+                            return res.rows;
+                        },
+                        async queryRow(sql, params) {
+                            const res = await pgClient.query(sql, params);
+                            return res.rows[0] ?? null;
+                        },
+                        async exec(sql, params) {
+                            const res = await pgClient.query(sql, params);
+                            return { rowCount: res.rowCount ?? 0 };
+                        },
+                        async insert(table, data) {
+                            const keys = Object.keys(data);
+                            const values = Object.values(data);
+                            const placeholders = keys.map((_, i) => `$${i + 1}`);
+                            const sql = `INSERT INTO ${table} (${keys.join(", ")}) VALUES (${placeholders.join(", ")}) RETURNING *`;
+                            const res = await pgClient.query(sql, values);
+                            return res.rows[0];
+                        },
+                        get conn() { return pgClient; },
+                    };
+                    const result = await fn(tx);
+                    await pgClient.query("COMMIT");
+                    return result;
+                }
+                catch (err) {
+                    await pgClient.query("ROLLBACK");
+                    throw err;
+                }
+                finally {
+                    pgClient.release();
+                }
+            }
+            if (engine === "mysql") {
+                const conn = await p.getConnection();
+                try {
+                    await conn.beginTransaction();
+                    const tx = {
+                        async query(sql, params) {
+                            const [rows] = await conn.execute(sql, params);
+                            return rows;
+                        },
+                        async queryRow(sql, params) {
+                            const [rows] = await conn.execute(sql, params);
+                            return rows[0] ?? null;
+                        },
+                        async exec(sql, params) {
+                            const [result] = await conn.execute(sql, params);
+                            return { rowCount: result.affectedRows ?? 0 };
+                        },
+                        async insert(table, data) {
+                            const keys = Object.keys(data);
+                            const values = Object.values(data);
+                            const placeholders = keys.map(() => "?");
+                            const sql = `INSERT INTO ${table} (${keys.join(", ")}) VALUES (${placeholders.join(", ")})`;
+                            await conn.execute(sql, values);
+                            const [rows] = await conn.execute(`SELECT * FROM ${table} WHERE id = LAST_INSERT_ID()`);
+                            return rows[0];
+                        },
+                        get conn() { return conn; },
+                    };
+                    const result = await fn(tx);
+                    await conn.commit();
+                    return result;
+                }
+                catch (err) {
+                    await conn.rollback();
+                    throw err;
+                }
+                finally {
+                    conn.release();
+                }
+            }
+            throw new Error(`Transactions not supported for engine "${engine}"`);
+        },
+        get pool() {
+            return pool;
+        },
+    };
+    registry.registerDatabase(name, { name, engine, pool: client });
+    return client;
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/error.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Structured error codes with automatic HTTP status mapping.
+ */
+export type ErrorCode = "NOT_FOUND" | "UNAUTHORIZED" | "PERMISSION_DENIED" | "RATE_LIMITED" | "INVALID_ARGUMENT" | "VALIDATION_FAILED" | "INTERNAL";
+export declare class CooperError extends Error {
+    readonly code: ErrorCode;
+    readonly statusCode: number;
+    retryAfter?: number;
+    constructor(code: ErrorCode, message: string);
+    toJSON(): {
+        error: {
+            retryAfter?: number | undefined;
+            code: ErrorCode;
+            message: string;
+        };
+    };
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,cAAc,GACd,mBAAmB,GACnB,cAAc,GACd,kBAAkB,GAClB,mBAAmB,GACnB,UAAU,CAAC;AAYf,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,SAAS,CAAC;IAChC,SAAgB,UAAU,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEf,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM;IAO5C,MAAM;;;;;;;CASP"}

package/dist/error.js

@@ -0,0 +1,30 @@
+const STATUS_MAP = {
+    NOT_FOUND: 404,
+    UNAUTHORIZED: 401,
+    PERMISSION_DENIED: 403,
+    RATE_LIMITED: 429,
+    INVALID_ARGUMENT: 400,
+    VALIDATION_FAILED: 422,
+    INTERNAL: 500,
+};
+export class CooperError extends Error {
+    code;
+    statusCode;
+    retryAfter;
+    constructor(code, message) {
+        super(message);
+        this.name = "CooperError";
+        this.code = code;
+        this.statusCode = STATUS_MAP[code] ?? 500;
+    }
+    toJSON() {
+        return {
+            error: {
+                code: this.code,
+                message: this.message,
+                ...(this.retryAfter !== undefined && { retryAfter: this.retryAfter }),
+            },
+        };
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,GAA8B;IAC5C,SAAS,EAAE,GAAG;IACd,YAAY,EAAE,GAAG;IACjB,iBAAiB,EAAE,GAAG;IACtB,YAAY,EAAE,GAAG;IACjB,gBAAgB,EAAE,GAAG;IACrB,iBAAiB,EAAE,GAAG;IACtB,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpB,IAAI,CAAY;IAChB,UAAU,CAAS;IAC5B,UAAU,CAAU;IAE3B,YAAY,IAAe,EAAE,OAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;IAC5C,CAAC;IAED,MAAM;QACJ,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;aACtE;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { api } from "./api.js";
+export { CooperError, type ErrorCode } from "./error.js";
+export { database, type DatabaseClient, type TransactionClient } from "./db.js";
+export { middleware, cooper } from "./middleware.js";
+export { authHandler } from "./auth.js";
+export { topic, type Topic } from "./pubsub.js";
+export { closeNats } from "./nats.js";
+export { cron } from "./cron.js";
+export { cache, type CacheClient } from "./cache.js";
+export { bucket, type BucketClient } from "./storage.js";
+export { secret } from "./secrets.js";
+export { queue, type QueueClient } from "./queue.js";
+export { page, layout, pageLoader, Suspense } from "./ssr.js";
+export { island } from "./islands.js";
+export { vectorStore, llmGateway } from "./ai.js";
+export { rateLimit, type RateLimitConfig } from "./rateLimit.js";
+export { registry } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+export { api } from "./api.js";
+export { CooperError } from "./error.js";
+export { database } from "./db.js";
+export { middleware, cooper } from "./middleware.js";
+export { authHandler } from "./auth.js";
+export { topic } from "./pubsub.js";
+export { closeNats } from "./nats.js";
+export { cron } from "./cron.js";
+export { cache } from "./cache.js";
+export { bucket } from "./storage.js";
+export { secret } from "./secrets.js";
+export { queue } from "./queue.js";
+export { page, layout, pageLoader, Suspense } from "./ssr.js";
+export { island } from "./islands.js";
+export { vectorStore, llmGateway } from "./ai.js";
+export { rateLimit } from "./rateLimit.js";
+export { registry } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAkB,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,QAAQ,EAA+C,MAAM,SAAS,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,KAAK,EAAc,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAoB,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,MAAM,EAAqB,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,KAAK,EAAoB,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,SAAS,EAAwB,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/islands.d.ts

@@ -0,0 +1,16 @@
+export type HydrationStrategy = "load" | "visible" | "idle" | "interaction" | "none";
+/**
+ * Mark a component as an island — it will be hydrated on the client.
+ *
+ * ```tsx
+ * // islands/LikeButton.island.tsx
+ * export default island(function LikeButton({ userId, initialCount }) {
+ *   const [count, setCount] = useState(initialCount);
+ *   return <button onClick={...}>Like ({count})</button>;
+ * });
+ * ```
+ */
+export declare function island<P = any>(component: (props: P) => any): (props: P & {
+    hydrate?: HydrationStrategy;
+}) => any;
+//# sourceMappingURL=islands.d.ts.map

package/dist/islands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"islands.d.ts","sourceRoot":"","sources":["../src/islands.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;AAErF;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,CAAC,GAAG,GAAG,EAC5B,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,GAC3B,CAAC,KAAK,EAAE,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAAE,KAAK,GAAG,CAYrD"}

package/dist/islands.js

@@ -0,0 +1,23 @@
+/**
+ * Mark a component as an island — it will be hydrated on the client.
+ *
+ * ```tsx
+ * // islands/LikeButton.island.tsx
+ * export default island(function LikeButton({ userId, initialCount }) {
+ *   const [count, setCount] = useState(initialCount);
+ *   return <button onClick={...}>Like ({count})</button>;
+ * });
+ * ```
+ */
+export function island(component) {
+    // Mark the component for the bundler
+    const wrapper = (props) => {
+        // Server-side: render the component to HTML
+        // Client-side: hydrate based on strategy
+        return component(props);
+    };
+    wrapper._cooper_island = true;
+    wrapper._cooper_hydrate = "load"; // default strategy
+    return wrapper;
+}
+//# sourceMappingURL=islands.js.map

package/dist/islands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"islands.js","sourceRoot":"","sources":["../src/islands.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,MAAM,CACpB,SAA4B;IAE5B,qCAAqC;IACrC,MAAM,OAAO,GAAG,CAAC,KAA0C,EAAE,EAAE;QAC7D,4CAA4C;QAC5C,yCAAyC;QACzC,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC;IAED,OAAe,CAAC,cAAc,GAAG,IAAI,CAAC;IACtC,OAAe,CAAC,eAAe,GAAG,MAAM,CAAC,CAAC,mBAAmB;IAE9D,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,20 @@
+import { type MiddlewareFn } from "./registry.js";
+/**
+ * Define a middleware function.
+ *
+ * ```ts
+ * const rateLimiter = middleware(async (req, next) => {
+ *   const count = await userCache.increment(`rate:${req.ip}`, { ttl: "1m" });
+ *   if (count > 100) throw new CooperError("RATE_LIMITED");
+ *   return next(req);
+ * });
+ * ```
+ */
+export declare function middleware(fn: MiddlewareFn): MiddlewareFn;
+/**
+ * Cooper instance for global middleware registration.
+ */
+export declare const cooper: {
+    use(...middlewares: MiddlewareFn[]): void;
+};
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,YAAY,CAEzD;AAED;;GAEG;AACH,eAAO,MAAM,MAAM;wBACG,YAAY,EAAE;CAKnC,CAAC"}

package/dist/middleware.js

@@ -0,0 +1,26 @@
+import { registry } from "./registry.js";
+/**
+ * Define a middleware function.
+ *
+ * ```ts
+ * const rateLimiter = middleware(async (req, next) => {
+ *   const count = await userCache.increment(`rate:${req.ip}`, { ttl: "1m" });
+ *   if (count > 100) throw new CooperError("RATE_LIMITED");
+ *   return next(req);
+ * });
+ * ```
+ */
+export function middleware(fn) {
+    return fn;
+}
+/**
+ * Cooper instance for global middleware registration.
+ */
+export const cooper = {
+    use(...middlewares) {
+        for (const mw of middlewares) {
+            registry.addGlobalMiddleware(mw);
+        }
+    },
+};
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAqB,MAAM,eAAe,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CAAC,EAAgB;IACzC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,CAAC,GAAG,WAA2B;QAChC,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;YAC7B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/nats.d.ts

@@ -0,0 +1,46 @@
+/**
+ * NATS Connection Manager — singleton lazy connection to embedded NATS.
+ *
+ * JetStream is used for durable pub/sub with delivery guarantees.
+ * Falls back gracefully if NATS is unavailable (logs warning once).
+ */
+import { type NatsConnection, type JetStreamClient, type JetStreamManager } from "nats";
+declare const jc: import("nats").Codec<unknown>;
+export declare function ensureConnected(): Promise<boolean>;
+export declare function getJetStream(): JetStreamClient | null;
+export declare function getJetStreamManager(): JetStreamManager | null;
+export declare function getConnection(): NatsConnection | null;
+export { jc as jsonCodec };
+/**
+ * Sanitize a topic name into a valid NATS stream name.
+ * NATS streams: alphanumeric + dash + underscore only.
+ */
+export declare function streamName(topicName: string): string;
+/**
+ * Sanitize a subscriber name into a valid NATS durable consumer name.
+ */
+export declare function consumerName(subscriberName: string): string;
+/**
+ * Ensure a JetStream stream exists for a topic.
+ * Creates it if missing, no-ops if it already exists.
+ */
+export declare function ensureStream(topicName: string, config?: {
+    dedup?: boolean;
+}): Promise<void>;
+/**
+ * Ensure a JetStream stream exists for a job queue.
+ * Uses WorkQueue retention — each message consumed by exactly one worker.
+ */
+export declare function ensureQueueStream(queueName: string, config?: {
+    dedup?: boolean;
+}): Promise<void>;
+/**
+ * Ensure a JetStream stream exists for a dead-letter queue.
+ * Uses Limits retention — messages stay until explicitly purged.
+ */
+export declare function ensureDLQStream(dlqName: string): Promise<void>;
+/**
+ * Graceful shutdown — drain and close the connection.
+ */
+export declare function closeNats(): Promise<void>;
+//# sourceMappingURL=nats.d.ts.map

package/dist/nats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats.d.ts","sourceRoot":"","sources":["../src/nats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAKtB,MAAM,MAAM,CAAC;AAQd,QAAA,MAAM,EAAE,+BAAc,CAAC;AA0BvB,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAOxD;AAED,wBAAgB,YAAY,IAAI,eAAe,GAAG,IAAI,CAErD;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,GAAG,IAAI,CAE7D;AAED,wBAAgB,aAAa,IAAI,cAAc,GAAG,IAAI,CAErD;AAED,OAAO,EAAE,EAAE,IAAI,SAAS,EAAE,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBpE;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAI/C"}