@parsrun/database 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# @parsrun/database
+
+Database utilities for Pars with Drizzle ORM helpers and multi-runtime support.
+
+## Features
+
+- **Drizzle ORM**: Type-safe database operations
+- **Multi-Adapter**: PostgreSQL, Neon, Cloudflare D1
+- **Edge-Compatible**: Works on Cloudflare Workers, Deno
+- **Migrations**: Schema migration utilities
+
+## Installation
+
+```bash
+pnpm add @parsrun/database drizzle-orm
+```
+
+## Quick Start
+
+```typescript
+import { createDatabase } from '@parsrun/database';
+
+const db = createDatabase({
+  adapter: 'postgres',
+  connectionString: process.env.DATABASE_URL,
+});
+```
+
+## API Overview
+
+### Adapters
+
+#### PostgreSQL
+
+```typescript
+import { createPostgresAdapter } from '@parsrun/database/adapters/postgres';
+
+const db = createPostgresAdapter({
+  connectionString: 'postgres://...',
+});
+```
+
+#### Neon (Serverless PostgreSQL)
+
+```typescript
+import { createNeonAdapter } from '@parsrun/database/adapters/neon';
+
+const db = createNeonAdapter({
+  connectionString: process.env.DATABASE_URL,
+});
+```
+
+#### Cloudflare D1
+
+```typescript
+import { createD1Adapter } from '@parsrun/database/adapters/d1';
+
+// In Cloudflare Worker
+const db = createD1Adapter({
+  database: env.DB,
+});
+```
+
+### Database Operations
+
+```typescript
+import { users } from './schema';
+
+// Insert
+await db.insert(users).values({ name: 'John' });
+
+// Select
+const allUsers = await db.select().from(users);
+
+// Update
+await db.update(users).set({ name: 'Jane' }).where(eq(users.id, 1));
+
+// Delete
+await db.delete(users).where(eq(users.id, 1));
+```
+
+### With Multi-Tenancy
+
+```typescript
+import { withTenant } from '@parsrun/database';
+
+// Automatically filter by tenant
+const tenantDb = withTenant(db, tenantId);
+const users = await tenantDb.select().from(users);
+```
+
+## Exports
+
+```typescript
+import { ... } from '@parsrun/database';                  // Main exports
+import { ... } from '@parsrun/database/adapters/postgres'; // PostgreSQL
+import { ... } from '@parsrun/database/adapters/neon';     // Neon
+import { ... } from '@parsrun/database/adapters/d1';       // Cloudflare D1
+```
+
+## License
+
+MIT

package/dist/adapters/d1.d.ts

@@ -0,0 +1,56 @@
+import { drizzle } from 'drizzle-orm/d1';
+import { a as DatabaseAdapter, c as D1Config, f as DatabaseHealth, d as D1Database } from '../types-DgBIyTeZ.js';
+
+/**
+ * @parsrun/database - Cloudflare D1 Adapter
+ * Cloudflare D1 (SQLite) adapter - native edge database
+ */
+
+/**
+ * Cloudflare D1 Database Adapter
+ * Native SQLite database for Cloudflare Workers
+ *
+ * @example
+ * ```typescript
+ * // In Cloudflare Worker
+ * export default {
+ *   async fetch(request, env) {
+ *     const db = createD1Adapter({
+ *       type: 'd1',
+ *       binding: env.DB, // D1 binding from wrangler.toml
+ *     });
+ *
+ *     const users = await db.drizzle().select().from(usersTable);
+ *     return new Response(JSON.stringify(users));
+ *   }
+ * }
+ * ```
+ */
+declare class D1Adapter implements DatabaseAdapter {
+    readonly type: "d1";
+    private binding;
+    private db;
+    constructor(config: D1Config);
+    execute<T = unknown>(sql: string): Promise<T[]>;
+    ping(): Promise<boolean>;
+    health(): Promise<DatabaseHealth>;
+    drizzle(): ReturnType<typeof drizzle>;
+    close(): Promise<void>;
+    /**
+     * Get the raw D1 binding
+     */
+    getBinding(): D1Database;
+    /**
+     * Execute a batch of statements
+     */
+    batch<T = unknown>(statements: Array<{
+        sql: string;
+        params?: unknown[];
+    }>): Promise<T[][]>;
+}
+/**
+ * Create a D1 adapter
+ */
+declare function createD1Adapter(config: D1Config): D1Adapter;
+
+export { D1Adapter, createD1Adapter };

package/dist/adapters/d1.js

@@ -0,0 +1,115 @@
+// src/adapters/d1.ts
+import { drizzle } from "drizzle-orm/d1";
+
+// src/types.ts
+var DatabaseError = class extends Error {
+  constructor(message, code, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+    this.name = "DatabaseError";
+  }
+};
+var DatabaseErrorCodes = {
+  CONNECTION_FAILED: "CONNECTION_FAILED",
+  QUERY_FAILED: "QUERY_FAILED",
+  TRANSACTION_FAILED: "TRANSACTION_FAILED",
+  MIGRATION_FAILED: "MIGRATION_FAILED",
+  INVALID_CONFIG: "INVALID_CONFIG",
+  ADAPTER_NOT_AVAILABLE: "ADAPTER_NOT_AVAILABLE",
+  TIMEOUT: "TIMEOUT",
+  CONSTRAINT_VIOLATION: "CONSTRAINT_VIOLATION",
+  NOT_FOUND: "NOT_FOUND"
+};
+
+// src/adapters/d1.ts
+var D1Adapter = class {
+  type = "d1";
+  binding;
+  db;
+  constructor(config) {
+    this.binding = config.binding;
+    const drizzleConfig = {};
+    if (config.logging !== void 0) {
+      drizzleConfig.logger = config.logging;
+    }
+    this.db = drizzle(this.binding, drizzleConfig);
+  }
+  async execute(sql) {
+    try {
+      const result = await this.binding.exec(sql);
+      return result.results ?? [];
+    } catch (err) {
+      throw new DatabaseError(
+        `Query failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        DatabaseErrorCodes.QUERY_FAILED,
+        err
+      );
+    }
+  }
+  async ping() {
+    try {
+      await this.binding.prepare("SELECT 1").first();
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async health() {
+    const start = Date.now();
+    try {
+      await this.binding.prepare("SELECT 1").first();
+      const latencyMs = Date.now() - start;
+      const versionResult = await this.binding.prepare("SELECT sqlite_version() as version").first();
+      return {
+        healthy: true,
+        latencyMs,
+        version: versionResult ? `SQLite ${versionResult.version}` : void 0
+      };
+    } catch (err) {
+      return {
+        healthy: false,
+        latencyMs: Date.now() - start,
+        error: err instanceof Error ? err.message : "Unknown error"
+      };
+    }
+  }
+  drizzle() {
+    return this.db;
+  }
+  async close() {
+  }
+  /**
+   * Get the raw D1 binding
+   */
+  getBinding() {
+    return this.binding;
+  }
+  /**
+   * Execute a batch of statements
+   */
+  async batch(statements) {
+    try {
+      const prepared = statements.map((stmt) => {
+        const p = this.binding.prepare(stmt.sql);
+        return stmt.params ? p.bind(...stmt.params) : p;
+      });
+      const results = await this.binding.batch(prepared);
+      return results.map((r) => r.results ?? []);
+    } catch (err) {
+      throw new DatabaseError(
+        `Batch execution failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        DatabaseErrorCodes.QUERY_FAILED,
+        err
+      );
+    }
+  }
+};
+function createD1Adapter(config) {
+  return new D1Adapter(config);
+}
+export {
+  D1Adapter,
+  createD1Adapter
+};
+//# sourceMappingURL=d1.js.map

package/dist/adapters/d1.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/d1.ts","../../src/types.ts"],"sourcesContent":["/**\n * @parsrun/database - Cloudflare D1 Adapter\n * Cloudflare D1 (SQLite) adapter - native edge database\n */\n\nimport { drizzle } from \"drizzle-orm/d1\";\nimport type {\n  D1Config,\n  D1Database,\n  DatabaseAdapter,\n  DatabaseHealth,\n} from \"../types.js\";\nimport { DatabaseError, DatabaseErrorCodes } from \"../types.js\";\n\n/**\n * Cloudflare D1 Database Adapter\n * Native SQLite database for Cloudflare Workers\n *\n * @example\n * ```typescript\n * // In Cloudflare Worker\n * export default {\n *   async fetch(request, env) {\n *     const db = createD1Adapter({\n *       type: 'd1',\n *       binding: env.DB, // D1 binding from wrangler.toml\n *     });\n *\n *     const users = await db.drizzle().select().from(usersTable);\n *     return new Response(JSON.stringify(users));\n *   }\n * }\n * ```\n */\nexport class D1Adapter implements DatabaseAdapter {\n  readonly type = \"d1\" as const;\n\n  private binding: D1Database;\n  private db: ReturnType<typeof drizzle>;\n\n  constructor(config: D1Config) {\n    this.binding = config.binding;\n\n    const drizzleConfig: Parameters<typeof drizzle>[1] = {};\n    if (config.logging !== undefined) {\n      drizzleConfig.logger = config.logging;\n    }\n\n    this.db = drizzle(this.binding as Parameters<typeof drizzle>[0], drizzleConfig);\n  }\n\n  async execute<T = unknown>(sql: string): Promise<T[]> {\n    try {\n      const result = await this.binding.exec<T>(sql);\n      return result.results ?? [];\n    } catch (err) {\n      throw new DatabaseError(\n        `Query failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        DatabaseErrorCodes.QUERY_FAILED,\n        err\n      );\n    }\n  }\n\n  async ping(): Promise<boolean> {\n    try {\n      await this.binding.prepare(\"SELECT 1\").first();\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async health(): Promise<DatabaseHealth> {\n    const start = Date.now();\n\n    try {\n      await this.binding.prepare(\"SELECT 1\").first();\n      const latencyMs = Date.now() - start;\n\n      // Get SQLite version\n      const versionResult = await this.binding\n        .prepare(\"SELECT sqlite_version() as version\")\n        .first<{ version: string }>();\n\n      return {\n        healthy: true,\n        latencyMs,\n        version: versionResult ? `SQLite ${versionResult.version}` : undefined,\n      };\n    } catch (err) {\n      return {\n        healthy: false,\n        latencyMs: Date.now() - start,\n        error: err instanceof Error ? err.message : \"Unknown error\",\n      };\n    }\n  }\n\n  drizzle(): ReturnType<typeof drizzle> {\n    return this.db;\n  }\n\n  async close(): Promise<void> {\n    // D1 bindings are managed by Cloudflare, nothing to close\n  }\n\n  /**\n   * Get the raw D1 binding\n   */\n  getBinding(): D1Database {\n    return this.binding;\n  }\n\n  /**\n   * Execute a batch of statements\n   */\n  async batch<T = unknown>(\n    statements: Array<{ sql: string; params?: unknown[] }>\n  ): Promise<T[][]> {\n    try {\n      const prepared = statements.map((stmt) => {\n        const p = this.binding.prepare(stmt.sql);\n        return stmt.params ? p.bind(...stmt.params) : p;\n      });\n\n      const results = await this.binding.batch<T>(prepared);\n      return results.map((r) => r.results ?? []);\n    } catch (err) {\n      throw new DatabaseError(\n        `Batch execution failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        DatabaseErrorCodes.QUERY_FAILED,\n        err\n      );\n    }\n  }\n}\n\n/**\n * Create a D1 adapter\n */\nexport function createD1Adapter(config: D1Config): D1Adapter {\n  return new D1Adapter(config);\n}\n","/**\n * @parsrun/database - Type Definitions\n * Database types and interfaces\n */\n\n/**\n * Database adapter type\n */\nexport type DatabaseAdapterType = \"postgres\" | \"neon\" | \"d1\" | \"custom\";\n\n/**\n * Base database configuration\n */\nexport interface BaseDatabaseConfig {\n  /** Adapter type */\n  type: DatabaseAdapterType;\n  /** Enable query logging */\n  logging?: boolean | undefined;\n  /** Connection pool size */\n  poolSize?: number | undefined;\n}\n\n/**\n * PostgreSQL configuration\n */\nexport interface PostgresConfig extends BaseDatabaseConfig {\n  type: \"postgres\";\n  /** Database host */\n  host: string;\n  /** Database port */\n  port: number;\n  /** Database user */\n  user: string;\n  /** Database password */\n  password: string;\n  /** Database name */\n  database: string;\n  /** SSL configuration */\n  ssl?: boolean | { rejectUnauthorized: boolean } | undefined;\n}\n\n/**\n * Neon serverless configuration\n */\nexport interface NeonConfig extends BaseDatabaseConfig {\n  type: \"neon\";\n  /** Connection string */\n  connectionString: string;\n  /** Use pooled connection */\n  pooled?: boolean | undefined;\n}\n\n/**\n * Cloudflare D1 configuration\n */\nexport interface D1Config extends BaseDatabaseConfig {\n  type: \"d1\";\n  /** D1 binding */\n  binding: D1Database;\n}\n\n/**\n * Cloudflare D1 Database binding type\n */\nexport interface D1Database {\n  prepare(query: string): D1PreparedStatement;\n  batch<T>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;\n  dump(): Promise<ArrayBuffer>;\n  exec<T>(query: string): Promise<D1Result<T>>;\n}\n\ninterface D1PreparedStatement {\n  bind(...values: unknown[]): D1PreparedStatement;\n  first<T = unknown>(column?: string): Promise<T | null>;\n  run<T = unknown>(): Promise<D1Result<T>>;\n  all<T = unknown>(): Promise<D1Result<T>>;\n  raw<T = unknown>(): Promise<T[]>;\n}\n\ninterface D1Result<T> {\n  results?: T[];\n  success: boolean;\n  error?: string;\n  meta?: D1Meta;\n}\n\ninterface D1Meta {\n  duration: number;\n  rows_read: number;\n  rows_written: number;\n}\n\n/**\n * Combined database configuration\n */\nexport type DatabaseConfig = PostgresConfig | NeonConfig | D1Config;\n\n/**\n * Migration status\n */\nexport interface MigrationStatus {\n  /** Whether migrations need to be run */\n  needsMigration: boolean;\n  /** Whether database is up to date */\n  upToDate: boolean;\n  /** Number of pending migrations */\n  pendingCount: number;\n  /** Number of applied migrations */\n  appliedCount: number;\n  /** Error message if check failed */\n  error?: string | undefined;\n}\n\n/**\n * Migration result\n */\nexport interface MigrationResult {\n  /** Whether migration succeeded */\n  success: boolean;\n  /** Number of migrations applied */\n  appliedCount?: number | undefined;\n  /** Error message if migration failed */\n  error?: string | undefined;\n}\n\n/**\n * Transaction options\n */\nexport interface TransactionOptions {\n  /** Isolation level */\n  isolationLevel?: \"read uncommitted\" | \"read committed\" | \"repeatable read\" | \"serializable\" | undefined;\n  /** Access mode */\n  accessMode?: \"read only\" | \"read write\" | undefined;\n  /** Deferrable (PostgreSQL) */\n  deferrable?: boolean | undefined;\n}\n\n/**\n * Query options\n */\nexport interface QueryOptions {\n  /** Query timeout in milliseconds */\n  timeout?: number | undefined;\n  /** Transform result rows */\n  transform?: \"camelCase\" | \"snakeCase\" | undefined;\n}\n\n/**\n * Database health status\n */\nexport interface DatabaseHealth {\n  /** Whether database is healthy */\n  healthy: boolean;\n  /** Connection latency in milliseconds */\n  latencyMs: number;\n  /** Database version */\n  version?: string | undefined;\n  /** Error message if unhealthy */\n  error?: string | undefined;\n}\n\n/**\n * Database adapter interface\n */\nexport interface DatabaseAdapter {\n  /** Adapter type */\n  readonly type: DatabaseAdapterType;\n\n  /**\n   * Execute raw SQL query\n   */\n  execute<T = unknown>(sql: string): Promise<T[]>;\n\n  /**\n   * Check connection health\n   */\n  ping(): Promise<boolean>;\n\n  /**\n   * Get connection health with details\n   */\n  health(): Promise<DatabaseHealth>;\n\n  /**\n   * Get the underlying Drizzle instance\n   */\n  drizzle(): unknown;\n\n  /**\n   * Close database connection\n   */\n  close(): Promise<void>;\n}\n\n/**\n * Database error\n */\nexport class DatabaseError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly cause?: unknown\n  ) {\n    super(message);\n    this.name = \"DatabaseError\";\n  }\n}\n\n/**\n * Common database error codes\n */\nexport const DatabaseErrorCodes = {\n  CONNECTION_FAILED: \"CONNECTION_FAILED\",\n  QUERY_FAILED: \"QUERY_FAILED\",\n  TRANSACTION_FAILED: \"TRANSACTION_FAILED\",\n  MIGRATION_FAILED: \"MIGRATION_FAILED\",\n  INVALID_CONFIG: \"INVALID_CONFIG\",\n  ADAPTER_NOT_AVAILABLE: \"ADAPTER_NOT_AVAILABLE\",\n  TIMEOUT: \"TIMEOUT\",\n  CONSTRAINT_VIOLATION: \"CONSTRAINT_VIOLATION\",\n  NOT_FOUND: \"NOT_FOUND\",\n} as const;\n"],"mappings":";AAKA,SAAS,eAAe;;;ACgMjB,IAAM,gBAAN,cAA4B,MAAM;AAAA,EACvC,YACE,SACgB,MACA,OAChB;AACA,UAAM,OAAO;AAHG;AACA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,qBAAqB;AAAA,EAChC,mBAAmB;AAAA,EACnB,cAAc;AAAA,EACd,oBAAoB;AAAA,EACpB,kBAAkB;AAAA,EAClB,gBAAgB;AAAA,EAChB,uBAAuB;AAAA,EACvB,SAAS;AAAA,EACT,sBAAsB;AAAA,EACtB,WAAW;AACb;;;AD3LO,IAAM,YAAN,MAA2C;AAAA,EACvC,OAAO;AAAA,EAER;AAAA,EACA;AAAA,EAER,YAAY,QAAkB;AAC5B,SAAK,UAAU,OAAO;AAEtB,UAAM,gBAA+C,CAAC;AACtD,QAAI,OAAO,YAAY,QAAW;AAChC,oBAAc,SAAS,OAAO;AAAA,IAChC;AAEA,SAAK,KAAK,QAAQ,KAAK,SAA0C,aAAa;AAAA,EAChF;AAAA,EAEA,MAAM,QAAqB,KAA2B;AACpD,QAAI;AACF,YAAM,SAAS,MAAM,KAAK,QAAQ,KAAQ,GAAG;AAC7C,aAAO,OAAO,WAAW,CAAC;AAAA,IAC5B,SAAS,KAAK;AACZ,YAAM,IAAI;AAAA,QACR,iBAAiB,eAAe,QAAQ,IAAI,UAAU,eAAe;AAAA,QACrE,mBAAmB;AAAA,QACnB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,OAAyB;AAC7B,QAAI;AACF,YAAM,KAAK,QAAQ,QAAQ,UAAU,EAAE,MAAM;AAC7C,aAAO;AAAA,IACT,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,SAAkC;AACtC,UAAM,QAAQ,KAAK,IAAI;AAEvB,QAAI;AACF,YAAM,KAAK,QAAQ,QAAQ,UAAU,EAAE,MAAM;AAC7C,YAAM,YAAY,KAAK,IAAI,IAAI;AAG/B,YAAM,gBAAgB,MAAM,KAAK,QAC9B,QAAQ,oCAAoC,EAC5C,MAA2B;AAE9B,aAAO;AAAA,QACL,SAAS;AAAA,QACT;AAAA,QACA,SAAS,gBAAgB,UAAU,cAAc,OAAO,KAAK;AAAA,MAC/D;AAAA,IACF,SAAS,KAAK;AACZ,aAAO;AAAA,QACL,SAAS;AAAA,QACT,WAAW,KAAK,IAAI,IAAI;AAAA,QACxB,OAAO,eAAe,QAAQ,IAAI,UAAU;AAAA,MAC9C;AAAA,IACF;AAAA,EACF;AAAA,EAEA,UAAsC;AACpC,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAM,QAAuB;AAAA,EAE7B;AAAA;AAAA;AAAA;AAAA,EAKA,aAAyB;AACvB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,MACJ,YACgB;AAChB,QAAI;AACF,YAAM,WAAW,WAAW,IAAI,CAAC,SAAS;AACxC,cAAM,IAAI,KAAK,QAAQ,QAAQ,KAAK,GAAG;AACvC,eAAO,KAAK,SAAS,EAAE,KAAK,GAAG,KAAK,MAAM,IAAI;AAAA,MAChD,CAAC;AAED,YAAM,UAAU,MAAM,KAAK,QAAQ,MAAS,QAAQ;AACpD,aAAO,QAAQ,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAAA,IAC3C,SAAS,KAAK;AACZ,YAAM,IAAI;AAAA,QACR,2BAA2B,eAAe,QAAQ,IAAI,UAAU,eAAe;AAAA,QAC/E,mBAAmB;AAAA,QACnB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AAKO,SAAS,gBAAgB,QAA6B;AAC3D,SAAO,IAAI,UAAU,MAAM;AAC7B;","names":[]}

package/dist/adapters/neon.d.ts

@@ -0,0 +1,49 @@
+import * as _neondatabase_serverless from '@neondatabase/serverless';
+import { a as DatabaseAdapter, N as NeonConfig, f as DatabaseHealth } from '../types-DgBIyTeZ.js';
+
+type NeonClient = ReturnType<typeof _neondatabase_serverless.neon>;
+/**
+ * Neon Serverless Database Adapter
+ * Optimized for edge environments (Cloudflare Workers, Vercel Edge, etc.)
+ *
+ * @example
+ * ```typescript
+ * const db = await createNeonAdapter({
+ *   type: 'neon',
+ *   connectionString: process.env.DATABASE_URL,
+ * });
+ *
+ * // Execute queries
+ * const users = await db.drizzle().select().from(usersTable);
+ * ```
+ */
+declare class NeonAdapter implements DatabaseAdapter {
+    readonly type: "neon";
+    private client;
+    private db;
+    private config;
+    constructor(config: NeonConfig);
+    /**
+     * Initialize the connection
+     */
+    connect(): Promise<void>;
+    execute<T = unknown>(sql: string): Promise<T[]>;
+    ping(): Promise<boolean>;
+    health(): Promise<DatabaseHealth>;
+    drizzle(): any;
+    close(): Promise<void>;
+    /**
+     * Get the raw Neon client
+     */
+    getClient(): NeonClient | null;
+}
+/**
+ * Create a Neon adapter
+ */
+declare function createNeonAdapter(config: NeonConfig): Promise<NeonAdapter>;
+/**
+ * Create a Neon adapter from connection string
+ */
+declare function createNeonFromUrl(connectionString: string, options?: Omit<NeonConfig, "type" | "connectionString">): Promise<NeonAdapter>;
+
+export { NeonAdapter, createNeonAdapter, createNeonFromUrl };

package/dist/adapters/neon.js

@@ -0,0 +1,145 @@
+// src/adapters/neon.ts
+import { drizzle } from "drizzle-orm/neon-http";
+
+// src/types.ts
+var DatabaseError = class extends Error {
+  constructor(message, code, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+    this.name = "DatabaseError";
+  }
+};
+var DatabaseErrorCodes = {
+  CONNECTION_FAILED: "CONNECTION_FAILED",
+  QUERY_FAILED: "QUERY_FAILED",
+  TRANSACTION_FAILED: "TRANSACTION_FAILED",
+  MIGRATION_FAILED: "MIGRATION_FAILED",
+  INVALID_CONFIG: "INVALID_CONFIG",
+  ADAPTER_NOT_AVAILABLE: "ADAPTER_NOT_AVAILABLE",
+  TIMEOUT: "TIMEOUT",
+  CONSTRAINT_VIOLATION: "CONSTRAINT_VIOLATION",
+  NOT_FOUND: "NOT_FOUND"
+};
+
+// src/adapters/neon.ts
+var NeonAdapter = class {
+  type = "neon";
+  client = null;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  db = null;
+  config;
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Initialize the connection
+   */
+  async connect() {
+    if (this.client) return;
+    try {
+      const { neon } = await import("@neondatabase/serverless");
+      this.client = neon(this.config.connectionString, {
+        fetchOptions: {
+          cache: "no-store"
+        }
+      });
+      const drizzleOpts = {};
+      if (this.config.logging !== void 0) {
+        drizzleOpts.logger = this.config.logging;
+      }
+      this.db = drizzle(this.client, drizzleOpts);
+    } catch (err) {
+      throw new DatabaseError(
+        `Failed to connect to Neon: ${err instanceof Error ? err.message : "Unknown error"}`,
+        DatabaseErrorCodes.CONNECTION_FAILED,
+        err
+      );
+    }
+  }
+  async execute(sql) {
+    if (!this.client) {
+      await this.connect();
+    }
+    try {
+      const result = await this.client(sql);
+      if (Array.isArray(result) && result.rows) {
+        return result.rows;
+      }
+      return result;
+    } catch (err) {
+      throw new DatabaseError(
+        `Query failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        DatabaseErrorCodes.QUERY_FAILED,
+        err
+      );
+    }
+  }
+  async ping() {
+    try {
+      await this.execute("SELECT 1");
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async health() {
+    const start = Date.now();
+    try {
+      if (!this.client) {
+        await this.connect();
+      }
+      const result = await this.execute("SELECT version()");
+      const latencyMs = Date.now() - start;
+      return {
+        healthy: true,
+        latencyMs,
+        version: result[0]?.version
+      };
+    } catch (err) {
+      return {
+        healthy: false,
+        latencyMs: Date.now() - start,
+        error: err instanceof Error ? err.message : "Unknown error"
+      };
+    }
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  drizzle() {
+    if (!this.db) {
+      throw new DatabaseError(
+        "Database not connected. Call connect() first.",
+        DatabaseErrorCodes.CONNECTION_FAILED
+      );
+    }
+    return this.db;
+  }
+  async close() {
+    this.client = null;
+    this.db = null;
+  }
+  /**
+   * Get the raw Neon client
+   */
+  getClient() {
+    return this.client;
+  }
+};
+async function createNeonAdapter(config) {
+  const adapter = new NeonAdapter(config);
+  await adapter.connect();
+  return adapter;
+}
+async function createNeonFromUrl(connectionString, options) {
+  return createNeonAdapter({
+    type: "neon",
+    connectionString,
+    ...options
+  });
+}
+export {
+  NeonAdapter,
+  createNeonAdapter,
+  createNeonFromUrl
+};
+//# sourceMappingURL=neon.js.map

package/dist/adapters/neon.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/neon.ts","../../src/types.ts"],"sourcesContent":["/**\n * @parsrun/database - Neon Serverless Adapter\n * Neon serverless PostgreSQL adapter - perfect for edge environments\n */\n\nimport { drizzle } from \"drizzle-orm/neon-http\";\nimport type {\n  DatabaseAdapter,\n  DatabaseHealth,\n  NeonConfig,\n} from \"../types.js\";\nimport { DatabaseError, DatabaseErrorCodes } from \"../types.js\";\n\n// Type for Neon client\ntype NeonClient = ReturnType<typeof import(\"@neondatabase/serverless\").neon>;\n\n/**\n * Neon Serverless Database Adapter\n * Optimized for edge environments (Cloudflare Workers, Vercel Edge, etc.)\n *\n * @example\n * ```typescript\n * const db = await createNeonAdapter({\n *   type: 'neon',\n *   connectionString: process.env.DATABASE_URL,\n * });\n *\n * // Execute queries\n * const users = await db.drizzle().select().from(usersTable);\n * ```\n */\nexport class NeonAdapter implements DatabaseAdapter {\n  readonly type = \"neon\" as const;\n\n  private client: NeonClient | null = null;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private db: any = null;\n  private config: NeonConfig;\n\n  constructor(config: NeonConfig) {\n    this.config = config;\n  }\n\n  /**\n   * Initialize the connection\n   */\n  async connect(): Promise<void> {\n    if (this.client) return;\n\n    try {\n      const { neon } = await import(\"@neondatabase/serverless\");\n\n      this.client = neon(this.config.connectionString, {\n        fetchOptions: {\n          cache: \"no-store\",\n        },\n      });\n\n      // Build drizzle config - use any to avoid complex type issues\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      const drizzleOpts: any = {};\n      if (this.config.logging !== undefined) {\n        drizzleOpts.logger = this.config.logging;\n      }\n\n      this.db = drizzle(this.client, drizzleOpts);\n    } catch (err) {\n      throw new DatabaseError(\n        `Failed to connect to Neon: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        DatabaseErrorCodes.CONNECTION_FAILED,\n        err\n      );\n    }\n  }\n\n  async execute<T = unknown>(sql: string): Promise<T[]> {\n    if (!this.client) {\n      await this.connect();\n    }\n\n    try {\n      const result = await this.client!(sql);\n      // Neon can return different formats depending on how it's called\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      if (Array.isArray(result) && (result as any).rows) {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        return (result as any).rows as T[];\n      }\n      return result as T[];\n    } catch (err) {\n      throw new DatabaseError(\n        `Query failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        DatabaseErrorCodes.QUERY_FAILED,\n        err\n      );\n    }\n  }\n\n  async ping(): Promise<boolean> {\n    try {\n      await this.execute(\"SELECT 1\");\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  async health(): Promise<DatabaseHealth> {\n    const start = Date.now();\n\n    try {\n      if (!this.client) {\n        await this.connect();\n      }\n\n      const result = await this.execute<{ version: string }>(\"SELECT version()\");\n      const latencyMs = Date.now() - start;\n\n      return {\n        healthy: true,\n        latencyMs,\n        version: result[0]?.version,\n      };\n    } catch (err) {\n      return {\n        healthy: false,\n        latencyMs: Date.now() - start,\n        error: err instanceof Error ? err.message : \"Unknown error\",\n      };\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  drizzle(): any {\n    if (!this.db) {\n      throw new DatabaseError(\n        \"Database not connected. Call connect() first.\",\n        DatabaseErrorCodes.CONNECTION_FAILED\n      );\n    }\n    return this.db;\n  }\n\n  async close(): Promise<void> {\n    // Neon serverless connections are stateless, nothing to close\n    this.client = null;\n    this.db = null;\n  }\n\n  /**\n   * Get the raw Neon client\n   */\n  getClient(): NeonClient | null {\n    return this.client;\n  }\n}\n\n/**\n * Create a Neon adapter\n */\nexport async function createNeonAdapter(\n  config: NeonConfig\n): Promise<NeonAdapter> {\n  const adapter = new NeonAdapter(config);\n  await adapter.connect();\n  return adapter;\n}\n\n/**\n * Create a Neon adapter from connection string\n */\nexport async function createNeonFromUrl(\n  connectionString: string,\n  options?: Omit<NeonConfig, \"type\" | \"connectionString\">\n): Promise<NeonAdapter> {\n  return createNeonAdapter({\n    type: \"neon\",\n    connectionString,\n    ...options,\n  });\n}\n","/**\n * @parsrun/database - Type Definitions\n * Database types and interfaces\n */\n\n/**\n * Database adapter type\n */\nexport type DatabaseAdapterType = \"postgres\" | \"neon\" | \"d1\" | \"custom\";\n\n/**\n * Base database configuration\n */\nexport interface BaseDatabaseConfig {\n  /** Adapter type */\n  type: DatabaseAdapterType;\n  /** Enable query logging */\n  logging?: boolean | undefined;\n  /** Connection pool size */\n  poolSize?: number | undefined;\n}\n\n/**\n * PostgreSQL configuration\n */\nexport interface PostgresConfig extends BaseDatabaseConfig {\n  type: \"postgres\";\n  /** Database host */\n  host: string;\n  /** Database port */\n  port: number;\n  /** Database user */\n  user: string;\n  /** Database password */\n  password: string;\n  /** Database name */\n  database: string;\n  /** SSL configuration */\n  ssl?: boolean | { rejectUnauthorized: boolean } | undefined;\n}\n\n/**\n * Neon serverless configuration\n */\nexport interface NeonConfig extends BaseDatabaseConfig {\n  type: \"neon\";\n  /** Connection string */\n  connectionString: string;\n  /** Use pooled connection */\n  pooled?: boolean | undefined;\n}\n\n/**\n * Cloudflare D1 configuration\n */\nexport interface D1Config extends BaseDatabaseConfig {\n  type: \"d1\";\n  /** D1 binding */\n  binding: D1Database;\n}\n\n/**\n * Cloudflare D1 Database binding type\n */\nexport interface D1Database {\n  prepare(query: string): D1PreparedStatement;\n  batch<T>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;\n  dump(): Promise<ArrayBuffer>;\n  exec<T>(query: string): Promise<D1Result<T>>;\n}\n\ninterface D1PreparedStatement {\n  bind(...values: unknown[]): D1PreparedStatement;\n  first<T = unknown>(column?: string): Promise<T | null>;\n  run<T = unknown>(): Promise<D1Result<T>>;\n  all<T = unknown>(): Promise<D1Result<T>>;\n  raw<T = unknown>(): Promise<T[]>;\n}\n\ninterface D1Result<T> {\n  results?: T[];\n  success: boolean;\n  error?: string;\n  meta?: D1Meta;\n}\n\ninterface D1Meta {\n  duration: number;\n  rows_read: number;\n  rows_written: number;\n}\n\n/**\n * Combined database configuration\n */\nexport type DatabaseConfig = PostgresConfig | NeonConfig | D1Config;\n\n/**\n * Migration status\n */\nexport interface MigrationStatus {\n  /** Whether migrations need to be run */\n  needsMigration: boolean;\n  /** Whether database is up to date */\n  upToDate: boolean;\n  /** Number of pending migrations */\n  pendingCount: number;\n  /** Number of applied migrations */\n  appliedCount: number;\n  /** Error message if check failed */\n  error?: string | undefined;\n}\n\n/**\n * Migration result\n */\nexport interface MigrationResult {\n  /** Whether migration succeeded */\n  success: boolean;\n  /** Number of migrations applied */\n  appliedCount?: number | undefined;\n  /** Error message if migration failed */\n  error?: string | undefined;\n}\n\n/**\n * Transaction options\n */\nexport interface TransactionOptions {\n  /** Isolation level */\n  isolationLevel?: \"read uncommitted\" | \"read committed\" | \"repeatable read\" | \"serializable\" | undefined;\n  /** Access mode */\n  accessMode?: \"read only\" | \"read write\" | undefined;\n  /** Deferrable (PostgreSQL) */\n  deferrable?: boolean | undefined;\n}\n\n/**\n * Query options\n */\nexport interface QueryOptions {\n  /** Query timeout in milliseconds */\n  timeout?: number | undefined;\n  /** Transform result rows */\n  transform?: \"camelCase\" | \"snakeCase\" | undefined;\n}\n\n/**\n * Database health status\n */\nexport interface DatabaseHealth {\n  /** Whether database is healthy */\n  healthy: boolean;\n  /** Connection latency in milliseconds */\n  latencyMs: number;\n  /** Database version */\n  version?: string | undefined;\n  /** Error message if unhealthy */\n  error?: string | undefined;\n}\n\n/**\n * Database adapter interface\n */\nexport interface DatabaseAdapter {\n  /** Adapter type */\n  readonly type: DatabaseAdapterType;\n\n  /**\n   * Execute raw SQL query\n   */\n  execute<T = unknown>(sql: string): Promise<T[]>;\n\n  /**\n   * Check connection health\n   */\n  ping(): Promise<boolean>;\n\n  /**\n   * Get connection health with details\n   */\n  health(): Promise<DatabaseHealth>;\n\n  /**\n   * Get the underlying Drizzle instance\n   */\n  drizzle(): unknown;\n\n  /**\n   * Close database connection\n   */\n  close(): Promise<void>;\n}\n\n/**\n * Database error\n */\nexport class DatabaseError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly cause?: unknown\n  ) {\n    super(message);\n    this.name = \"DatabaseError\";\n  }\n}\n\n/**\n * Common database error codes\n */\nexport const DatabaseErrorCodes = {\n  CONNECTION_FAILED: \"CONNECTION_FAILED\",\n  QUERY_FAILED: \"QUERY_FAILED\",\n  TRANSACTION_FAILED: \"TRANSACTION_FAILED\",\n  MIGRATION_FAILED: \"MIGRATION_FAILED\",\n  INVALID_CONFIG: \"INVALID_CONFIG\",\n  ADAPTER_NOT_AVAILABLE: \"ADAPTER_NOT_AVAILABLE\",\n  TIMEOUT: \"TIMEOUT\",\n  CONSTRAINT_VIOLATION: \"CONSTRAINT_VIOLATION\",\n  NOT_FOUND: \"NOT_FOUND\",\n} as const;\n"],"mappings":"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","names":[]}

package/dist/adapters/postgres.d.ts

@@ -0,0 +1,59 @@
+import { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import { a as DatabaseAdapter, P as PostgresConfig, f as DatabaseHealth } from '../types-DgBIyTeZ.js';
+
+/**
+ * @parsrun/database - PostgreSQL Adapter
+ * PostgreSQL adapter using postgres.js
+ */
+
+/**
+ * PostgreSQL Database Adapter
+ *
+ * @example
+ * ```typescript
+ * const db = await createPostgresAdapter({
+ *   type: 'postgres',
+ *   host: 'localhost',
+ *   port: 5432,
+ *   user: 'postgres',
+ *   password: 'password',
+ *   database: 'mydb',
+ * });
+ *
+ * // Execute queries
+ * const users = await db.drizzle().select().from(usersTable);
+ *
+ * // Close when done
+ * await db.close();
+ * ```
+ */
+declare class PostgresAdapter implements DatabaseAdapter {
+    readonly type: "postgres";
+    private client;
+    private db;
+    private config;
+    constructor(config: PostgresConfig);
+    /**
+     * Initialize the connection
+     */
+    connect(): Promise<void>;
+    execute<T = unknown>(sql: string): Promise<T[]>;
+    ping(): Promise<boolean>;
+    health(): Promise<DatabaseHealth>;
+    drizzle(): PostgresJsDatabase<any>;
+    close(): Promise<void>;
+    /**
+     * Get the raw postgres client
+     */
+    getClient(): unknown;
+}
+/**
+ * Create a PostgreSQL adapter
+ */
+declare function createPostgresAdapter(config: PostgresConfig): Promise<PostgresAdapter>;
+/**
+ * Create a PostgreSQL adapter from connection string
+ */
+declare function createPostgresFromUrl(connectionString: string, options?: Omit<PostgresConfig, "type" | "host" | "port" | "user" | "password" | "database">): Promise<PostgresAdapter>;
+
+export { PostgresAdapter, createPostgresAdapter, createPostgresFromUrl };