tenanso 0.1.0

package/dist/tenanso.js

@@ -0,0 +1,92 @@
+import { ConnectionPool } from "./connection-pool.js";
+import { TursoApi } from "./turso-api.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 function createTenanso(config) {
+    if (!config.databaseUrl.includes("{tenant}")) {
+        throw new Error(`databaseUrl must contain a {tenant} placeholder. Got: "${config.databaseUrl}"`);
+    }
+    const pool = new ConnectionPool(config);
+    const api = new TursoApi(config.turso, config.seed);
+    return {
+        async createTenant(name) {
+            await api.createDatabase(name);
+        },
+        async deleteTenant(name) {
+            await api.deleteDatabase(name);
+            pool.remove(name);
+        },
+        async listTenants() {
+            return api.listDatabases();
+        },
+        async tenantExists(name) {
+            return api.databaseExists(name);
+        },
+        dbFor(tenant) {
+            return pool.getDb(tenant);
+        },
+        async withTenant(tenant, fn) {
+            const db = pool.getDb(tenant);
+            return fn(db);
+        },
+    };
+}
+//# sourceMappingURL=tenanso.js.map

package/dist/tenanso.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenanso.js","sourceRoot":"","sources":["../src/tenanso.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CACb,0DAA0D,MAAM,CAAC,WAAW,GAAG,CAChF,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEpD,OAAO;QACL,KAAK,CAAC,YAAY,CAAC,IAAY;YAC7B,MAAM,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,IAAY;YAC7B,MAAM,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QAED,KAAK,CAAC,WAAW;YACf,OAAO,GAAG,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,IAAY;YAC7B,OAAO,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,KAAK,CAAC,MAAc;YAClB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAED,KAAK,CAAC,UAAU,CACd,MAAc,EACd,EAAiC;YAEjC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC9B,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/turso-api.d.ts

@@ -0,0 +1,13 @@
+import type { SeedConfig, TursoConfig } from "./types.js";
+export declare class TursoApi {
+    private readonly baseUrl;
+    private readonly apiToken;
+    private readonly group;
+    private readonly seed;
+    constructor(config: TursoConfig, seed: SeedConfig | undefined);
+    createDatabase(name: string): Promise<void>;
+    deleteDatabase(name: string): Promise<void>;
+    listDatabases(): Promise<string[]>;
+    databaseExists(name: string): Promise<boolean>;
+}
+//# sourceMappingURL=turso-api.d.ts.map

package/dist/turso-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turso-api.d.ts","sourceRoot":"","sources":["../src/turso-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAoB1D,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAyB;gBAElC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,SAAS;IAQvD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC3C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3C,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAelC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAerD"}

package/dist/turso-api.js

@@ -0,0 +1,83 @@
+const TENANT_NAME_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+function validateTenantName(name) {
+    if (!name || !TENANT_NAME_PATTERN.test(name)) {
+        throw new Error(`Invalid tenant name "${name}". Must match ${TENANT_NAME_PATTERN} (lowercase alphanumeric and hyphens, cannot start with a hyphen).`);
+    }
+}
+export class TursoApi {
+    baseUrl;
+    apiToken;
+    group;
+    seed;
+    constructor(config, seed) {
+        const base = config.baseUrl ?? "https://api.turso.tech";
+        this.baseUrl = `${base}/v1/organizations/${config.organizationSlug}`;
+        this.apiToken = config.apiToken;
+        this.group = config.group;
+        this.seed = seed;
+    }
+    async createDatabase(name) {
+        validateTenantName(name);
+        const body = {
+            name,
+            group: this.group,
+        };
+        if (this.seed) {
+            body["seed"] = {
+                type: "database",
+                name: this.seed.database,
+            };
+        }
+        const res = await fetch(`${this.baseUrl}/databases`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.apiToken}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Failed to create database "${name}": ${res.status} ${text}`);
+        }
+    }
+    async deleteDatabase(name) {
+        validateTenantName(name);
+        const res = await fetch(`${this.baseUrl}/databases/${name}`, {
+            method: "DELETE",
+            headers: {
+                Authorization: `Bearer ${this.apiToken}`,
+            },
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Failed to delete database "${name}": ${res.status} ${text}`);
+        }
+    }
+    async listDatabases() {
+        const res = await fetch(`${this.baseUrl}/databases`, {
+            headers: {
+                Authorization: `Bearer ${this.apiToken}`,
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`Failed to list databases: ${res.status}`);
+        }
+        const data = (await res.json());
+        return data.databases.map((db) => db.Name);
+    }
+    async databaseExists(name) {
+        const res = await fetch(`${this.baseUrl}/databases/${name}`, {
+            headers: {
+                Authorization: `Bearer ${this.apiToken}`,
+            },
+        });
+        if (res.ok)
+            return true;
+        if (res.status === 404)
+            return false;
+        const text = await res.text();
+        throw new Error(`Failed to check database "${name}": ${res.status} ${text}`);
+    }
+}
+//# sourceMappingURL=turso-api.js.map

package/dist/turso-api.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,349 @@
+import type { drizzle } from "drizzle-orm/libsql";
+/**
+ * Drizzle ORM database instance type.
+ *
+ * This is the return type of `drizzle()` from `drizzle-orm/libsql`.
+ * You can use this type to annotate variables or function parameters
+ * that accept a Drizzle database instance.
+ *
+ * @example
+ * ```typescript
+ * import type { DrizzleDb } from "tenanso";
+ *
+ * async function getUsers(db: DrizzleDb) {
+ *   return db.select().from(usersTable);
+ * }
+ * ```
+ */
+export type DrizzleDb = ReturnType<typeof drizzle>;
+/**
+ * Turso Platform API configuration.
+ *
+ * These credentials are used to manage tenant databases (create, delete, list)
+ * via the [Turso Platform API](https://docs.turso.tech/api-reference/introduction).
+ *
+ * @example
+ * ```typescript
+ * const tursoConfig: TursoConfig = {
+ *   organizationSlug: "my-org",
+ *   apiToken: process.env.TURSO_API_TOKEN!,
+ *   group: "my-app",
+ * };
+ * ```
+ */
+export interface TursoConfig {
+    /**
+     * Your Turso organization slug.
+     *
+     * Found in your Turso dashboard URL: `https://app.turso.tech/{organizationSlug}`
+     */
+    organizationSlug: string;
+    /**
+     * Turso Platform API token for managing databases.
+     *
+     * Generate one with:
+     * ```bash
+     * turso auth api-tokens mint tenanso
+     * ```
+     */
+    apiToken: string;
+    /**
+     * Database group name. All tenant databases are created within this group.
+     *
+     * Use a group per application to organize databases — especially important
+     * when your Turso account hosts multiple services.
+     *
+     * Create a group with:
+     * ```bash
+     * turso group create my-app --location nrt
+     * ```
+     */
+    group: string;
+    /**
+     * Override the Turso Platform API base URL.
+     *
+     * Defaults to `https://api.turso.tech`. Useful for testing with a
+     * mock server or for self-hosted Turso deployments.
+     *
+     * @defaultValue `"https://api.turso.tech"`
+     */
+    baseUrl?: string | undefined;
+}
+/**
+ * Seed database configuration.
+ *
+ * When configured, new tenant databases are created by cloning an existing
+ * "seed" database. This seed database should have your schema and any initial
+ * data already applied, so new tenants are ready instantly without running migrations.
+ *
+ * To set up a seed database:
+ * ```bash
+ * turso db create seed-db --group my-app
+ * npx drizzle-kit push --url libsql://seed-db-my-app-my-account.turso.io --auth-token $TURSO_GROUP_AUTH_TOKEN
+ * ```
+ *
+ * @example
+ * ```typescript
+ * const tenanso = createTenanso({
+ *   // ...
+ *   seed: { database: "seed-db" },
+ * });
+ *
+ * // New tenant is cloned from seed-db with schema ready
+ * await tenanso.createTenant("acme");
+ * ```
+ */
+export interface SeedConfig {
+    /**
+     * Name of an existing Turso database to clone when creating new tenants.
+     *
+     * This database should be in the same group as the tenant databases
+     * and have the current schema applied.
+     */
+    database: string;
+}
+/**
+ * Configuration for creating a tenanso instance.
+ *
+ * @example
+ * ```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" },
+ * });
+ * ```
+ */
+export interface TenansoConfig {
+    /** Turso Platform API configuration. See {@link TursoConfig}. */
+    turso: TursoConfig;
+    /**
+     * URL template with `{tenant}` placeholder.
+     *
+     * The `{tenant}` placeholder is replaced with the tenant name when creating connections.
+     * Turso database URLs follow the pattern `libsql://{database-name}-{app}-{account}.turso.io`.
+     *
+     * @example
+     * ```typescript
+     * databaseUrl: "libsql://{tenant}-my-app-my-account.turso.io"
+     * // For tenant "acme" → "libsql://acme-my-app-my-account.turso.io"
+     * ```
+     */
+    databaseUrl: string;
+    /**
+     * Turso group auth token.
+     *
+     * A single token that works for all databases in a group.
+     * Generate one with:
+     * ```bash
+     * turso group tokens create my-app
+     * ```
+     */
+    authToken: string;
+    /**
+     * Drizzle schema for type-safe queries.
+     *
+     * Pass your Drizzle table definitions so that the Drizzle instances
+     * created for each tenant support relational queries.
+     *
+     * @example
+     * ```typescript
+     * import * as schema from "./db/schema.js";
+     *
+     * const tenanso = createTenanso({
+     *   // ...
+     *   schema,
+     * });
+     * ```
+     */
+    schema: Record<string, unknown>;
+    /**
+     * Seed database configuration.
+     *
+     * When set, {@link TenansoInstance.createTenant} clones the seed database
+     * instead of creating an empty database. The seed database should have
+     * your schema and any initial data already applied.
+     *
+     * See {@link SeedConfig} for setup instructions.
+     */
+    seed?: SeedConfig | undefined;
+    /**
+     * Maximum number of cached Drizzle connections.
+     *
+     * When this limit is reached, the least recently used connection is evicted.
+     * Tune this based on your memory constraints and expected number of
+     * concurrently active tenants.
+     *
+     * @defaultValue 50
+     */
+    maxConnections?: number | undefined;
+}
+/**
+ * The main tenanso instance returned by {@link createTenanso}.
+ *
+ * Provides methods for tenant lifecycle management (create, delete, list)
+ * and tenant-scoped database access (dbFor, withTenant).
+ *
+ * @example
+ * ```typescript
+ * const tenanso = createTenanso({ ... });
+ *
+ * // Lifecycle
+ * await tenanso.createTenant("acme");
+ * const tenants = await tenanso.listTenants();
+ *
+ * // Database access
+ * const db = tenanso.dbFor("acme");
+ * await tenanso.withTenant("acme", async (db) => {
+ *   const users = await db.select().from(usersTable);
+ * });
+ * ```
+ */
+export interface TenansoInstance {
+    /**
+     * Create a new tenant database via Turso Platform API.
+     *
+     * If {@link TenansoConfig.seed} is configured, the new database is cloned
+     * from the seed database with the schema already applied.
+     * Otherwise, an empty database is created and you must apply migrations separately.
+     *
+     * @param name - Unique tenant identifier, used as the Turso database name.
+     *   Must be valid as a Turso database name (lowercase alphanumeric and hyphens).
+     * @throws Error if the Turso API call fails (e.g., database already exists, quota exceeded).
+     *
+     * @example
+     * ```typescript
+     * // During user signup
+     * await tenanso.createTenant("acme-corp");
+     *
+     * // Seed initial data
+     * await tenanso.withTenant("acme-corp", async (db) => {
+     *   await db.insert(usersTable).values({ name: "Admin", email: "admin@acme.com" });
+     * });
+     * ```
+     */
+    createTenant(name: string): Promise<void>;
+    /**
+     * Delete a tenant database via Turso Platform API and remove it from the connection pool.
+     *
+     * This permanently destroys the database and all its data. The cached
+     * connection is also removed from the pool.
+     *
+     * @param name - Tenant identifier to delete.
+     * @throws Error if the Turso API call fails (e.g., database not found).
+     *
+     * @example
+     * ```typescript
+     * await tenanso.deleteTenant("acme-corp");
+     * ```
+     */
+    deleteTenant(name: string): Promise<void>;
+    /**
+     * List all tenant database names via Turso Platform API.
+     *
+     * Returns the names of all databases in the configured Turso organization.
+     * Note that this includes all databases, not just those created by tenanso.
+     *
+     * This calls the Turso Platform API, so it has network latency (~100-200ms).
+     * For per-request tenant validation, consider caching the result or using
+     * a JWT-based approach where the tenant is embedded in the token.
+     *
+     * @returns Array of database names.
+     *
+     * @example
+     * ```typescript
+     * const tenants = await tenanso.listTenants();
+     * // ["acme-corp", "other-corp", "startup-inc"]
+     *
+     * // Iterate over all tenants
+     * for (const tenant of tenants) {
+     *   await tenanso.withTenant(tenant, async (db) => {
+     *     // Run migrations, aggregate stats, etc.
+     *   });
+     * }
+     * ```
+     */
+    listTenants(): Promise<string[]>;
+    /**
+     * Check if a tenant database exists.
+     *
+     * Calls {@link listTenants} under the hood, so it has the same
+     * network latency considerations.
+     *
+     * @param name - Tenant identifier to check.
+     * @returns `true` if the database exists, `false` otherwise.
+     *
+     * @example
+     * ```typescript
+     * if (await tenanso.tenantExists("acme-corp")) {
+     *   // Tenant exists
+     * }
+     * ```
+     */
+    tenantExists(name: string): Promise<boolean>;
+    /**
+     * Get a cached Drizzle db instance for a specific tenant.
+     *
+     * Returns an existing cached connection or creates a new one.
+     * The connection is cached in an LRU pool — the least recently used
+     * connection is evicted when {@link TenansoConfig.maxConnections} is reached.
+     *
+     * @param tenant - Tenant identifier.
+     * @returns A Drizzle database instance connected to the tenant's database.
+     *
+     * @example
+     * ```typescript
+     * const db = tenanso.dbFor("acme-corp");
+     * const users = await db.select().from(usersTable);
+     *
+     * // In a Hono handler (without middleware)
+     * app.get("/api/users", async (c) => {
+     *   const tenantId = c.get("jwtPayload").tenant;
+     *   const db = tenanso.dbFor(tenantId);
+     *   return c.json(await db.select().from(usersTable));
+     * });
+     * ```
+     */
+    dbFor(tenant: string): DrizzleDb;
+    /**
+     * Run a callback with a tenant-scoped Drizzle db instance.
+     *
+     * A convenience wrapper around {@link dbFor} that passes the db
+     * instance to a callback. Useful when you want to scope a block of
+     * operations to a specific tenant.
+     *
+     * @param tenant - Tenant identifier.
+     * @param fn - Async callback receiving the tenant's Drizzle db instance.
+     * @returns The return value of the callback.
+     *
+     * @example
+     * ```typescript
+     * // Signup flow: create tenant and seed data
+     * await tenanso.createTenant("acme-corp");
+     * await tenanso.withTenant("acme-corp", async (db) => {
+     *   await db.insert(usersTable).values({
+     *     name: "Admin",
+     *     email: "admin@acme.com",
+     *     role: "admin",
+     *   });
+     * });
+     *
+     * // Cross-tenant aggregation
+     * const stats = await tenanso.withTenant("acme-corp", async (db) => {
+     *   const users = await db.select().from(usersTable);
+     *   return { userCount: users.length };
+     * });
+     * ```
+     */
+    withTenant<T>(tenant: string, fn: (db: DrizzleDb) => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;;OAOG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;OAUG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,KAAK,EAAE,WAAW,CAAC;IACnB;;;;;;;;;;;OAWG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;;OAQG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEjC;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7C;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9E"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "tenanso",
+  "version": "0.1.0",
+  "description": "Multi-tenant SQLite with Drizzle ORM and Turso",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./hono": {
+      "import": "./dist/middleware/hono.js",
+      "types": "./dist/middleware/hono.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prepublishOnly": "pnpm build",
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "vitest run --config vitest.config.e2e.ts",
+    "docs:typedoc": "typedoc",
+    "docs:dev": "pnpm docs:typedoc && vitepress dev docs",
+    "docs:build": "pnpm docs:typedoc && vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "docs:deploy": "pnpm docs:build && wrangler deploy"
+  },
+  "keywords": [
+    "multi-tenant",
+    "sqlite",
+    "turso",
+    "drizzle",
+    "hono"
+  ],
+  "author": "yoshixi",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yoshixi/tenanso.git"
+  },
+  "homepage": "https://github.com/yoshixi/tenanso",
+  "license": "MIT",
+  "packageManager": "pnpm@10.12.1",
+  "dependencies": {
+    "@libsql/client": "^0.17.0",
+    "drizzle-orm": "^0.45.1"
+  },
+  "peerDependencies": {
+    "hono": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "hono": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@hono/node-server": "^1.19.11",
+    "hono": "^4.12.7",
+    "typedoc": "^0.28.17",
+    "typedoc-plugin-markdown": "^4.10.0",
+    "typedoc-vitepress-theme": "^1.1.2",
+    "typescript": "^5.9.3",
+    "vitepress": "^1.6.4",
+    "vitest": "^3.2.3",
+    "wrangler": "^4.73.0"
+  }
+}