@venturekit/data 0.0.0-dev.20260308002709 → 0.0.0-dev.20260310105525

package/README.md

@@ -0,0 +1,107 @@
+# @venturekit/data
+
+> **Warning:** This package is in active development and not production-ready. APIs may change without notice.
+
+Database and data layer for [VentureKit](https://venturekit.dev) — RDS configuration, migrations, query utilities, and transactions.
+
+## Installation
+
+```bash
+npm install @venturekit/data@dev
+```
+
+## Overview
+
+`@venturekit/data` provides:
+
+- **RDS configuration** — `createRdsConfig()`, `buildRdsConfig()` for PostgreSQL and MySQL
+- **Migration utilities** — `createMigrationConfig()`, Flyway environment helpers
+- **Query utilities** — `query()`, `getPool()`, `mapResults()`, `mapRow()`
+- **Transaction support** — `beginTransaction()`, `withTransaction()`, `buildTransaction()`
+
+## Query Utilities
+
+```typescript
+import { query, getPool, mapResults } from '@venturekit/data';
+
+// Simple query
+const result = await query('SELECT * FROM tasks WHERE id = $1', [taskId]);
+
+// Get the connection pool
+const pool = getPool();
+
+// Map results with a custom mapper
+const tasks = mapResults(result, row => ({
+  id: row.id,
+  title: row.title,
+  completed: row.completed,
+}));
+```
+
+## Transactions
+
+```typescript
+import { withTransaction, beginTransaction } from '@venturekit/data';
+
+// Automatic commit/rollback
+const result = await withTransaction(async (tx) => {
+  await tx.query('INSERT INTO tasks (title) VALUES ($1)', ['New task']);
+  await tx.query('UPDATE counters SET count = count + 1 WHERE name = $1', ['tasks']);
+  return { created: true };
+});
+
+// Manual transaction control
+const tx = await beginTransaction();
+try {
+  await tx.query('INSERT INTO tasks (title) VALUES ($1)', ['New task']);
+  await tx.commit();
+} catch (error) {
+  await tx.rollback();
+  throw error;
+}
+```
+
+### Transactional Handlers
+
+When used with `@venturekit/runtime`, enable automatic transactions per request:
+
+```typescript
+import { handler } from '@venturekit/runtime';
+
+export const main = handler(async (body, ctx, logger) => {
+  // ctx.tx is available — auto-commits on success, rolls back on error
+  await ctx.tx.query('INSERT INTO tasks (title) VALUES ($1)', [body.title]);
+  return { created: true };
+}, { scopes: ['tasks.write'], transactional: true });
+```
+
+## RDS Configuration
+
+```typescript
+import { createRdsConfig, DEFAULT_RDS_CONFIG } from '@venturekit/data';
+
+const rdsConfig = createRdsConfig({
+  engine: 'postgres',
+  instanceSize: 'small',
+  databaseName: 'mydb',
+});
+```
+
+## Migrations
+
+VentureKit uses [Drizzle Kit](https://orm.drizzle.team) for migrations. Use the CLI:
+
+```bash
+vk migrate generate   # Generate from schema changes
+vk migrate up         # Apply pending migrations
+vk migrate status     # Check migration status
+vk migrate studio     # Open Drizzle Studio GUI
+```
+
+## API Reference
+
+See the [API reference](https://venturekit.dev/api-reference/data) for full documentation.
+
+## License
+
+Apache-2.0 — see [LICENSE](../../LICENSE) for details.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venturekit/data",
-  "version": "0.0.0-dev.20260308002709",
+  "version": "0.0.0-dev.20260310105525",
   "description": "Database and data layer for VentureKit",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,7 +25,7 @@
     }
   },
   "dependencies": {
-    "@venturekit/core": "0.0.0-dev.20260308002709",
+    "@venturekit/core": "0.0.0-dev.20260310105525",
     "pg": "^8.12.0"
   },
   "devDependencies": {