swarm-mail 1.2.2 → 1.4.0

package/dist/db/client.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Unified database client for swarm-mail.
+ *
+ * Wraps libSQL with Drizzle ORM and handles:
+ * - Schema initialization (CREATE TABLE IF NOT EXISTS)
+ * - Singleton pattern for production use
+ * - In-memory instances for testing
+ *
+ * @example
+ * ```typescript
+ * // Production - singleton
+ * const db = await getDb("file:./swarm.db");
+ *
+ * // Testing - fresh instance
+ * const db = await createInMemoryDb();
+ * ```
+ */
+import type { LibSQLDatabase } from "drizzle-orm/libsql";
+import * as schema from "./schema/index.js";
+/**
+ * Drizzle database instance type with full schema
+ */
+export type SwarmDb = LibSQLDatabase<typeof schema>;
+/**
+ * Create an in-memory database instance.
+ *
+ * Creates a fresh instance on each call - ideal for testing.
+ *
+ * @returns Fresh Drizzle database instance
+ *
+ * @example
+ * ```typescript
+ * const db = await createInMemoryDb();
+ * await db.insert(messages).values({ ... });
+ * ```
+ */
+export declare function createInMemoryDb(): Promise<SwarmDb>;
+/**
+ * Get the singleton database instance.
+ *
+ * Creates the instance on first call, returns cached instance on subsequent calls.
+ * Defaults to in-memory if no path provided.
+ *
+ * @param path - Database file path (optional). If omitted, uses in-memory.
+ * @returns Singleton Drizzle database instance
+ *
+ * @example
+ * ```typescript
+ * // In-memory (default)
+ * const db = await getDb();
+ *
+ * // File-based
+ * const db = await getDb("file:./swarm.db");
+ * ```
+ */
+export declare function getDb(path?: string): Promise<SwarmDb>;
+/**
+ * Close and cleanup database connection.
+ *
+ * Closes the underlying libSQL client and clears singleton.
+ *
+ * @example
+ * ```typescript
+ * await closeDb();
+ * ```
+ */
+export declare function closeDb(): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/db/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/db/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,MAAM,CAAC,CAAC;AA6BpD;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAOzD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAU3D;AAED;;;;;;;;;GASG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAM7C"}

package/dist/db/drizzle.d.ts

@@ -0,0 +1,24 @@
+import type { Client } from "@libsql/client";
+import * as schema from "./schema/index.js";
+/**
+ * Creates a Drizzle ORM client from a libSQL client instance.
+ *
+ * @param client - libSQL client (from createClient)
+ * @returns Drizzle database instance with schema
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from "@libsql/client";
+ * import { createDrizzleClient } from "./drizzle.js";
+ *
+ * const client = createClient({ url: ":memory:" });
+ * const db = createDrizzleClient(client);
+ *
+ * await db.select().from(schema.messages);
+ * ```
+ */
+export declare function createDrizzleClient(client: Client): import("drizzle-orm/libsql").LibSQLDatabase<typeof schema> & {
+    $client: Client;
+};
+export type DrizzleClient = ReturnType<typeof createDrizzleClient>;
+//# sourceMappingURL=drizzle.d.ts.map

package/dist/db/drizzle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.d.ts","sourceRoot":"","sources":["../../src/db/drizzle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM;;EAEjD;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/db/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Database module - unified libSQL + Drizzle client
+ *
+ * Exports:
+ * - Database client (getDb, createInMemoryDb, closeDb)
+ * - Database types (SwarmDb)
+ * - Drizzle schemas (re-exported from schema/index.ts)
+ *
+ * @example
+ * ```typescript
+ * import { getDb, createInMemoryDb } from "swarm-mail/db";
+ *
+ * // Production
+ * const db = await getDb("file:./swarm.db");
+ *
+ * // Testing
+ * const db = await createInMemoryDb();
+ * ```
+ */
+export { closeDb, createInMemoryDb, getDb } from "./client.js";
+export type { SwarmDb } from "./client.js";
+export { createDrizzleClient } from "./drizzle.js";
+export type { DrizzleClient } from "./drizzle.js";
+export * as schema from "./schema/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE/D,YAAY,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC"}

package/dist/db/migrate.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Drizzle migration runner with schema validation.
+ *
+ * Validates actual database schema matches Drizzle schema definitions.
+ * Detects and fixes schema drift (missing columns, wrong types).
+ *
+ * ## Strategy
+ *
+ * 1. **ALTER TABLE for missing columns** - Safe, preserves data
+ * 2. **DROP + CREATE for wrong types** - Only if table is empty
+ * 3. **Error for type mismatches with data** - Manual intervention required
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { migrateDatabase, validateSchema } from "./migrate.js";
+ * import { eventsTable, messagesTable } from "./schema/index.js";
+ *
+ * // Validate schema
+ * const validation = await validateSchema(client, { eventsTable, messagesTable });
+ * if (!validation.valid) {
+ *   console.error("Schema issues:", validation.issues);
+ * }
+ *
+ * // Apply migrations
+ * await migrateDatabase(client, { eventsTable, messagesTable });
+ * ```
+ *
+ * @module db/migrate
+ */
+import type { Client } from "@libsql/client";
+import type { SQLiteTableWithColumns } from "drizzle-orm/sqlite-core";
+/**
+ * Schema validation issue types
+ */
+export type SchemaIssueType = "missing_column" | "wrong_column_type" | "missing_table";
+/**
+ * Schema validation issue
+ */
+export interface SchemaIssue {
+    table: string;
+    type: SchemaIssueType;
+    column?: string;
+    expected?: string;
+    actual?: string;
+    message: string;
+}
+/**
+ * Schema validation result
+ */
+export interface SchemaValidationResult {
+    valid: boolean;
+    issues: SchemaIssue[];
+}
+/**
+ * Validates database schema against Drizzle schema definitions.
+ *
+ * Checks for:
+ * - Missing tables
+ * - Missing columns
+ * - Wrong column types
+ *
+ * @param client - libSQL client
+ * @param tables - Record of Drizzle table definitions
+ * @returns Validation result with issues
+ */
+export declare function validateSchema(client: Client, tables: Record<string, SQLiteTableWithColumns<any>>): Promise<SchemaValidationResult>;
+/**
+ * Applies migrations to fix schema drift.
+ *
+ * Strategy:
+ * - Missing columns → ALTER TABLE ADD COLUMN
+ * - Wrong types (empty table) → DROP + CREATE
+ * - Wrong types (with data) → Error (manual migration required)
+ *
+ * @param client - libSQL client
+ * @param tables - Record of Drizzle table definitions
+ * @throws Error if table has data and needs type change
+ */
+export declare function migrateDatabase(client: Client, tables: Record<string, SQLiteTableWithColumns<any>>): Promise<void>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/db/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/db/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGtE;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAcD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC,GAClD,OAAO,CAAC,sBAAsB,CAAC,CAiFjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC,CAqEf"}