tenanso 0.1.0

package/dist/__tests__/turso-api.test.js

@@ -0,0 +1,103 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { TursoApi } from "../turso-api.js";
+const tursoConfig = {
+    organizationSlug: "test-org",
+    apiToken: "test-api-token",
+    group: "default",
+};
+describe("TursoApi", () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe("createDatabase", () => {
+        it("sends POST to Turso API without seed", async () => {
+            const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response(JSON.stringify({ database: { Name: "my-tenant" } }), {
+                status: 200,
+            }));
+            const api = new TursoApi(tursoConfig, undefined);
+            await api.createDatabase("my-tenant");
+            expect(fetchSpy).toHaveBeenCalledOnce();
+            const [url, opts] = fetchSpy.mock.calls[0];
+            expect(url).toBe("https://api.turso.tech/v1/organizations/test-org/databases");
+            expect(opts?.method).toBe("POST");
+            const body = JSON.parse(opts?.body);
+            expect(body).toEqual({ name: "my-tenant", group: "default" });
+        });
+        it("includes seed when configured", async () => {
+            const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response("{}", { status: 200 }));
+            const api = new TursoApi(tursoConfig, { database: "seed-db" });
+            await api.createDatabase("my-tenant");
+            const body = JSON.parse(fetchSpy.mock.calls[0][1]?.body);
+            expect(body).toEqual({
+                name: "my-tenant",
+                group: "default",
+                seed: {
+                    type: "database",
+                    name: "seed-db",
+                },
+            });
+        });
+        it("rejects invalid tenant names", async () => {
+            const api = new TursoApi(tursoConfig, undefined);
+            await expect(api.createDatabase("")).rejects.toThrow("Invalid tenant name");
+            await expect(api.createDatabase("My Tenant")).rejects.toThrow("Invalid tenant name");
+            await expect(api.createDatabase("-starts-with-hyphen")).rejects.toThrow("Invalid tenant name");
+            await expect(api.createDatabase("has/slash")).rejects.toThrow("Invalid tenant name");
+            await expect(api.createDatabase("has space")).rejects.toThrow("Invalid tenant name");
+        });
+        it("accepts valid tenant names", async () => {
+            vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response("{}", { status: 200 }));
+            const api = new TursoApi(tursoConfig, undefined);
+            await expect(api.createDatabase("valid-name")).resolves.not.toThrow();
+            await expect(api.createDatabase("tenant123")).resolves.not.toThrow();
+            await expect(api.createDatabase("a")).resolves.not.toThrow();
+        });
+        it("throws on API error", async () => {
+            vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response("quota exceeded", { status: 429 }));
+            const api = new TursoApi(tursoConfig, undefined);
+            await expect(api.createDatabase("my-tenant")).rejects.toThrow('Failed to create database "my-tenant": 429');
+        });
+    });
+    describe("deleteDatabase", () => {
+        it("sends DELETE to Turso API", async () => {
+            const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response("{}", { status: 200 }));
+            const api = new TursoApi(tursoConfig, undefined);
+            await api.deleteDatabase("my-tenant");
+            const [url, opts] = fetchSpy.mock.calls[0];
+            expect(url).toBe("https://api.turso.tech/v1/organizations/test-org/databases/my-tenant");
+            expect(opts?.method).toBe("DELETE");
+        });
+    });
+    describe("listDatabases", () => {
+        it("returns database names", async () => {
+            vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response(JSON.stringify({
+                databases: [{ Name: "tenant-a" }, { Name: "tenant-b" }],
+            }), { status: 200 }));
+            const api = new TursoApi(tursoConfig, undefined);
+            const result = await api.listDatabases();
+            expect(result).toEqual(["tenant-a", "tenant-b"]);
+        });
+    });
+    describe("databaseExists", () => {
+        it("returns true when database exists", async () => {
+            vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response(JSON.stringify({ database: { Name: "my-tenant" } }), {
+                status: 200,
+            }));
+            const api = new TursoApi(tursoConfig, undefined);
+            expect(await api.databaseExists("my-tenant")).toBe(true);
+            const [url] = vi.mocked(fetch).mock.calls[0];
+            expect(url).toBe("https://api.turso.tech/v1/organizations/test-org/databases/my-tenant");
+        });
+        it("returns false when database does not exist", async () => {
+            vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response("not found", { status: 404 }));
+            const api = new TursoApi(tursoConfig, undefined);
+            expect(await api.databaseExists("nonexistent")).toBe(false);
+        });
+        it("throws on non-404 errors", async () => {
+            vi.spyOn(globalThis, "fetch").mockResolvedValue(new Response("unauthorized", { status: 401 }));
+            const api = new TursoApi(tursoConfig, undefined);
+            await expect(api.databaseExists("my-tenant")).rejects.toThrow('Failed to check database "my-tenant": 401');
+        });
+    });
+});
+//# sourceMappingURL=turso-api.test.js.map

package/dist/__tests__/turso-api.test.js.map

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

package/dist/connection-pool.d.ts

@@ -0,0 +1,14 @@
+import type { DrizzleDb, TenansoConfig } from "./types.js";
+export declare class ConnectionPool {
+    private readonly cache;
+    private readonly databaseUrl;
+    private readonly authToken;
+    private readonly schema;
+    private readonly maxConnections;
+    constructor(config: TenansoConfig);
+    getDb(tenant: string): DrizzleDb;
+    remove(tenant: string): void;
+    get size(): number;
+    private evictIfNeeded;
+}
+//# sourceMappingURL=connection-pool.d.ts.map

package/dist/connection-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool.d.ts","sourceRoot":"","sources":["../src/connection-pool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQ3D,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,MAAM,EAAE,aAAa;IAOjC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;IAoBhC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ5B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,aAAa;CAiBtB"}

package/dist/connection-pool.js

@@ -0,0 +1,57 @@
+import { drizzle } from "drizzle-orm/libsql";
+import { createClient } from "@libsql/client";
+export class ConnectionPool {
+    cache = new Map();
+    databaseUrl;
+    authToken;
+    schema;
+    maxConnections;
+    constructor(config) {
+        this.databaseUrl = config.databaseUrl;
+        this.authToken = config.authToken || undefined;
+        this.schema = config.schema;
+        this.maxConnections = config.maxConnections ?? 50;
+    }
+    getDb(tenant) {
+        const existing = this.cache.get(tenant);
+        if (existing) {
+            existing.lastUsed = Date.now();
+            return existing.db;
+        }
+        this.evictIfNeeded();
+        const url = this.databaseUrl.replace("{tenant}", tenant);
+        const client = createClient({
+            url,
+            ...(this.authToken ? { authToken: this.authToken } : {}),
+        });
+        const db = drizzle(client, { schema: this.schema });
+        this.cache.set(tenant, { client, db, lastUsed: Date.now() });
+        return db;
+    }
+    remove(tenant) {
+        const entry = this.cache.get(tenant);
+        if (entry) {
+            entry.client.close();
+            this.cache.delete(tenant);
+        }
+    }
+    get size() {
+        return this.cache.size;
+    }
+    evictIfNeeded() {
+        if (this.cache.size < this.maxConnections)
+            return;
+        let oldestKey;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.cache) {
+            if (entry.lastUsed < oldestTime) {
+                oldestTime = entry.lastUsed;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.remove(oldestKey);
+        }
+    }
+}
+//# sourceMappingURL=connection-pool.js.map

package/dist/connection-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-pool.js","sourceRoot":"","sources":["../src/connection-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAe,MAAM,gBAAgB,CAAC;AAS3D,MAAM,OAAO,cAAc;IACR,KAAK,GAAG,IAAI,GAAG,EAAqB,CAAC;IACrC,WAAW,CAAS;IACpB,SAAS,CAAqB;IAC9B,MAAM,CAA0B;IAChC,cAAc,CAAS;IAExC,YAAY,MAAqB;QAC/B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,MAAc;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/B,OAAO,QAAQ,CAAC,EAAE,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,GAAG;YACH,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;QACH,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAEpD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,cAAc;YAAE,OAAO;QAElD,IAAI,SAA6B,CAAC;QAClC,IAAI,UAAU,GAAG,QAAQ,CAAC;QAE1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,QAAQ,GAAG,UAAU,EAAE,CAAC;gBAChC,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC;gBAC5B,SAAS,GAAG,GAAG,CAAC;YAClB,CAAC;QACH,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createTenanso } from "./tenanso.js";
+export type { TenansoConfig, TenansoInstance, TursoConfig, SeedConfig, DrizzleDb, } from "./types.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,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,aAAa,EACb,eAAe,EACf,WAAW,EACX,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createTenanso } from "./tenanso.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,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/middleware/hono.d.ts

@@ -0,0 +1,198 @@
+import type { TenansoInstance, DrizzleDb } from "../types.js";
+/**
+ * Hono environment type for tenanso middleware.
+ *
+ * Pass this as the generic to `new Hono<TenansoEnv>()` to get type-safe
+ * access to `c.var.tenant` and `c.var.db` in your route handlers.
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from "hono";
+ * import type { TenansoEnv } from "tenanso/hono";
+ *
+ * const app = new Hono<TenansoEnv>();
+ *
+ * app.get("/api/users", async (c) => {
+ *   const db = c.var.db;       // DrizzleDb — fully typed
+ *   const tenant = c.var.tenant; // string
+ * });
+ * ```
+ */
+export type TenansoEnv = {
+    Variables: {
+        /** Current tenant name, as resolved by {@link tenantMiddleware} */
+        tenant: string;
+        /** Drizzle db instance scoped to the current tenant */
+        db: DrizzleDb;
+    };
+};
+/**
+ * Options for {@link tenantMiddleware}.
+ */
+export interface TenantMiddlewareOptions {
+    /**
+     * Resolve the tenant identifier from the request context.
+     *
+     * This function is called on every request. It should extract the tenant
+     * identifier from a trusted source — typically a verified JWT claim,
+     * an auth provider's organization ID, or an API key lookup.
+     *
+     * Return `undefined` to reject the request with a 400 response.
+     *
+     * **Security note:** Never trust raw client-supplied values without
+     * authentication. The tenant should come from a verified source.
+     *
+     * @param c - A subset of the Hono context with request accessors.
+     * @returns The tenant identifier, or `undefined` to reject.
+     *
+     * @example From a request header
+     * ```typescript
+     * resolve: (c) => c.req.header("x-tenant-id")
+     * ```
+     *
+     * @example From a verified JWT payload (recommended)
+     * ```typescript
+     * resolve: (c) => {
+     *   const payload = c.get("jwtPayload") as { tenant: string };
+     *   return payload.tenant;
+     * }
+     * ```
+     *
+     * @example From a URL path parameter
+     * ```typescript
+     * // Route: /t/:tenantId/*
+     * resolve: (c) => c.req.param("tenantId")
+     * ```
+     *
+     * @example From a subdomain
+     * ```typescript
+     * resolve: (c) => {
+     *   const url = new URL(c.req.url);
+     *   const subdomain = url.hostname.split(".")[0];
+     *   return subdomain === "www" ? undefined : subdomain;
+     * }
+     * ```
+     *
+     * @example Async resolution (e.g., API key lookup)
+     * ```typescript
+     * resolve: async (c) => {
+     *   const apiKey = c.req.header("Authorization")?.slice(7);
+     *   return apiKey ? await lookupTenantByApiKey(apiKey) : undefined;
+     * }
+     * ```
+     */
+    resolve: (c: {
+        req: {
+            header: (name: string) => string | undefined;
+            param: (name: string) => string | undefined;
+            url: string;
+        };
+        get: (key: string) => unknown;
+    }) => string | undefined | Promise<string | undefined>;
+}
+/**
+ * Hono middleware that resolves the tenant from each request and sets
+ * `c.var.db` and `c.var.tenant`.
+ *
+ * This middleware:
+ * 1. Calls `options.resolve(c)` to extract the tenant identifier from the request
+ * 2. If `undefined`, responds with `400 { error: "Tenant not specified" }`
+ * 3. Otherwise, gets a Drizzle db instance via `tenanso.dbFor(tenant)`
+ * 4. Sets `c.var.tenant` and `c.var.db` for downstream handlers
+ *
+ * Combine with Hono's `contextStorage()` middleware to enable
+ * {@link getTenantDb} and {@link getTenantName} outside of handlers.
+ *
+ * @param tenanso - The tenanso instance created by `createTenanso()`.
+ * @param options - Middleware options. See {@link TenantMiddlewareOptions}.
+ * @returns A Hono middleware function.
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { Hono } from "hono";
+ * import { contextStorage } from "hono/context-storage";
+ * import { createTenanso } from "tenanso";
+ * import { tenantMiddleware, type TenansoEnv } from "tenanso/hono";
+ *
+ * const tenanso = createTenanso({ ... });
+ * const app = new Hono<TenansoEnv>();
+ *
+ * app.use(contextStorage());
+ * app.use("/api/*", tenantMiddleware(tenanso, {
+ *   resolve: (c) => c.req.header("x-tenant-id"),
+ * }));
+ *
+ * app.get("/api/users", async (c) => {
+ *   const users = await c.var.db.select().from(usersTable);
+ *   return c.json(users);
+ * });
+ * ```
+ *
+ * @example Scoped to specific routes
+ * ```typescript
+ * const app = new Hono();
+ *
+ * // No tenant needed
+ * app.get("/health", (c) => c.json({ status: "ok" }));
+ *
+ * // Tenant-scoped routes
+ * const api = new Hono<TenansoEnv>();
+ * api.use("*", tenantMiddleware(tenanso, {
+ *   resolve: (c) => c.get("jwtPayload").tenant,
+ * }));
+ * api.get("/users", async (c) => {
+ *   return c.json({ tenant: c.var.tenant });
+ * });
+ * app.route("/api", api);
+ * ```
+ */
+export declare function tenantMiddleware(tenanso: TenansoInstance, options: TenantMiddlewareOptions): import("hono").MiddlewareHandler<TenansoEnv, string, {}, Response>;
+/**
+ * Get the current tenant's Drizzle db from Hono's `contextStorage()`.
+ *
+ * This allows you to access the tenant-scoped database from anywhere
+ * in the async call stack — not just inside Hono route handlers.
+ * Requires Hono's `contextStorage()` middleware to be active.
+ *
+ * @returns The Drizzle database instance for the current tenant.
+ * @throws If called outside of a request context or without `contextStorage()` middleware.
+ *
+ * @example
+ * ```typescript
+ * import { getTenantDb } from "tenanso/hono";
+ *
+ * // Can be called from any async function during request handling
+ * async function getActiveUserCount(): Promise<number> {
+ *   const db = getTenantDb();
+ *   const users = await db.select().from(usersTable);
+ *   return users.length;
+ * }
+ *
+ * app.get("/api/stats", async (c) => {
+ *   const count = await getActiveUserCount();
+ *   return c.json({ activeUsers: count });
+ * });
+ * ```
+ */
+export declare function getTenantDb(): DrizzleDb;
+/**
+ * Get the current tenant name from Hono's `contextStorage()`.
+ *
+ * This allows you to access the current tenant identifier from anywhere
+ * in the async call stack — not just inside Hono route handlers.
+ * Requires Hono's `contextStorage()` middleware to be active.
+ *
+ * @returns The current tenant name as a string.
+ * @throws If called outside of a request context or without `contextStorage()` middleware.
+ *
+ * @example
+ * ```typescript
+ * import { getTenantName } from "tenanso/hono";
+ *
+ * function logAction(action: string) {
+ *   console.log(`[${getTenantName()}] ${action}`);
+ * }
+ * ```
+ */
+export declare function getTenantName(): string;
+//# sourceMappingURL=hono.d.ts.map

package/dist/middleware/hono.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../src/middleware/hono.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE;QACT,mEAAmE;QACnE,MAAM,EAAE,MAAM,CAAC;QACf,uDAAuD;QACvD,EAAE,EAAE,SAAS,CAAC;KACf,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDG;IACH,OAAO,EAAE,CAAC,CAAC,EAAE;QACX,GAAG,EAAE;YACH,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;YAC7C,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;YAC5C,GAAG,EAAE,MAAM,CAAC;SACb,CAAC;QACF,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;KAC/B,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,uBAAuB,sEAajC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,WAAW,IAAI,SAAS,CAEvC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/middleware/hono.js

@@ -0,0 +1,123 @@
+import { createMiddleware } from "hono/factory";
+import { getContext } from "hono/context-storage";
+/**
+ * Hono middleware that resolves the tenant from each request and sets
+ * `c.var.db` and `c.var.tenant`.
+ *
+ * This middleware:
+ * 1. Calls `options.resolve(c)` to extract the tenant identifier from the request
+ * 2. If `undefined`, responds with `400 { error: "Tenant not specified" }`
+ * 3. Otherwise, gets a Drizzle db instance via `tenanso.dbFor(tenant)`
+ * 4. Sets `c.var.tenant` and `c.var.db` for downstream handlers
+ *
+ * Combine with Hono's `contextStorage()` middleware to enable
+ * {@link getTenantDb} and {@link getTenantName} outside of handlers.
+ *
+ * @param tenanso - The tenanso instance created by `createTenanso()`.
+ * @param options - Middleware options. See {@link TenantMiddlewareOptions}.
+ * @returns A Hono middleware function.
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { Hono } from "hono";
+ * import { contextStorage } from "hono/context-storage";
+ * import { createTenanso } from "tenanso";
+ * import { tenantMiddleware, type TenansoEnv } from "tenanso/hono";
+ *
+ * const tenanso = createTenanso({ ... });
+ * const app = new Hono<TenansoEnv>();
+ *
+ * app.use(contextStorage());
+ * app.use("/api/*", tenantMiddleware(tenanso, {
+ *   resolve: (c) => c.req.header("x-tenant-id"),
+ * }));
+ *
+ * app.get("/api/users", async (c) => {
+ *   const users = await c.var.db.select().from(usersTable);
+ *   return c.json(users);
+ * });
+ * ```
+ *
+ * @example Scoped to specific routes
+ * ```typescript
+ * const app = new Hono();
+ *
+ * // No tenant needed
+ * app.get("/health", (c) => c.json({ status: "ok" }));
+ *
+ * // Tenant-scoped routes
+ * const api = new Hono<TenansoEnv>();
+ * api.use("*", tenantMiddleware(tenanso, {
+ *   resolve: (c) => c.get("jwtPayload").tenant,
+ * }));
+ * api.get("/users", async (c) => {
+ *   return c.json({ tenant: c.var.tenant });
+ * });
+ * app.route("/api", api);
+ * ```
+ */
+export function tenantMiddleware(tenanso, options) {
+    return createMiddleware(async (c, next) => {
+        const tenantName = await options.resolve(c);
+        if (!tenantName) {
+            return c.json({ error: "Tenant not specified" }, 400);
+        }
+        const db = tenanso.dbFor(tenantName);
+        c.set("tenant", tenantName);
+        c.set("db", db);
+        await next();
+    });
+}
+/**
+ * Get the current tenant's Drizzle db from Hono's `contextStorage()`.
+ *
+ * This allows you to access the tenant-scoped database from anywhere
+ * in the async call stack — not just inside Hono route handlers.
+ * Requires Hono's `contextStorage()` middleware to be active.
+ *
+ * @returns The Drizzle database instance for the current tenant.
+ * @throws If called outside of a request context or without `contextStorage()` middleware.
+ *
+ * @example
+ * ```typescript
+ * import { getTenantDb } from "tenanso/hono";
+ *
+ * // Can be called from any async function during request handling
+ * async function getActiveUserCount(): Promise<number> {
+ *   const db = getTenantDb();
+ *   const users = await db.select().from(usersTable);
+ *   return users.length;
+ * }
+ *
+ * app.get("/api/stats", async (c) => {
+ *   const count = await getActiveUserCount();
+ *   return c.json({ activeUsers: count });
+ * });
+ * ```
+ */
+export function getTenantDb() {
+    return getContext().var.db;
+}
+/**
+ * Get the current tenant name from Hono's `contextStorage()`.
+ *
+ * This allows you to access the current tenant identifier from anywhere
+ * in the async call stack — not just inside Hono route handlers.
+ * Requires Hono's `contextStorage()` middleware to be active.
+ *
+ * @returns The current tenant name as a string.
+ * @throws If called outside of a request context or without `contextStorage()` middleware.
+ *
+ * @example
+ * ```typescript
+ * import { getTenantName } from "tenanso/hono";
+ *
+ * function logAction(action: string) {
+ *   console.log(`[${getTenantName()}] ${action}`);
+ * }
+ * ```
+ */
+export function getTenantName() {
+    return getContext().var.tenant;
+}
+//# sourceMappingURL=hono.js.map

package/dist/middleware/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.js","sourceRoot":"","sources":["../../src/middleware/hono.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAgGlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAwB,EACxB,OAAgC;IAEhC,OAAO,gBAAgB,CAAa,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QACpD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,GAAG,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC5B,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChB,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,EAAc,CAAC,GAAG,CAAC,EAAE,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,EAAc,CAAC,GAAG,CAAC,MAAM,CAAC;AAC7C,CAAC"}

package/dist/tenanso.d.ts

@@ -0,0 +1,63 @@
+import type { TenansoConfig, TenansoInstance } from "./types.js";
+/**
+ * Create a tenanso instance for multi-tenant database management.
+ *
+ * This is the main entry point for the library. It returns a {@link TenansoInstance}
+ * that provides tenant lifecycle management and tenant-scoped database access.
+ *
+ * Internally, it creates:
+ * - A {@link ConnectionPool} that caches Drizzle instances per tenant with LRU eviction
+ * - A Turso Platform API client for creating, deleting, and listing tenant databases
+ *
+ * @param config - Configuration options. See {@link TenansoConfig}.
+ * @returns A {@link TenansoInstance} for managing tenants and accessing their databases.
+ *
+ * @example Basic setup
+ * ```typescript
+ * import { createTenanso } from "tenanso";
+ * import * as schema from "./db/schema.js";
+ *
+ * const tenanso = createTenanso({
+ *   turso: {
+ *     organizationSlug: "my-org",
+ *     apiToken: process.env.TURSO_API_TOKEN!,
+ *     group: "my-app",
+ *   },
+ *   databaseUrl: "libsql://{tenant}-my-app-my-account.turso.io",
+ *   authToken: process.env.TURSO_GROUP_AUTH_TOKEN!,
+ *   schema,
+ *   seed: { database: "seed-db" },
+ * });
+ * ```
+ *
+ * @example Tenant lifecycle
+ * ```typescript
+ * // Create a tenant (cloned from seed-db)
+ * await tenanso.createTenant("acme");
+ *
+ * // Query tenant's database
+ * await tenanso.withTenant("acme", async (db) => {
+ *   const users = await db.select().from(usersTable);
+ * });
+ *
+ * // Or get the db directly
+ * const db = tenanso.dbFor("acme");
+ * ```
+ *
+ * @example With Hono middleware
+ * ```typescript
+ * import { tenantMiddleware, type TenansoEnv } from "tenanso/hono";
+ *
+ * const app = new Hono<TenansoEnv>();
+ * app.use("/api/*", tenantMiddleware(tenanso, {
+ *   resolve: (c) => c.get("jwtPayload").tenant,
+ * }));
+ *
+ * app.get("/api/users", async (c) => {
+ *   const users = await c.var.db.select().from(usersTable);
+ *   return c.json(users);
+ * });
+ * ```
+ */
+export declare function createTenanso(config: TenansoConfig): TenansoInstance;
+//# sourceMappingURL=tenanso.d.ts.map

package/dist/tenanso.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenanso.d.ts","sourceRoot":"","sources":["../src/tenanso.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAa,MAAM,YAAY,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAwCpE"}