remix 3.0.0-beta.0 → 3.0.0-beta.2

package/src/data-table-postgres/README.md

@@ -0,0 +1,74 @@
+# data-table-postgres
+
+PostgreSQL adapter for [`remix/data-table`](https://github.com/remix-run/remix/tree/main/packages/data-table).
+Use this package when you want `data-table` APIs backed by `pg`.
+
+## Features
+
+- **Native `pg` Integration**: Works with `pg` `Pool` and `PoolClient` instances
+- **Full `data-table` API Support**: Queries, relations, writes, and transactions
+- **Adapter-Owned Compiler**: SQL compilation lives in this adapter, with optional shared pure helpers from `data-table`
+- **Multi-Statement Migrations**: `executeScript()` runs `up.sql` / `down.sql` files natively via `pg`
+- **Postgres Capabilities Enabled By Default**:
+  - `returning: true`
+  - `savepoints: true`
+  - `upsert: true`
+  - `transactionalDdl: true`
+  - `migrationLock: true`
+
+## Installation
+
+```sh
+npm i remix pg
+```
+
+## Usage
+
+```ts
+import { Pool } from 'pg'
+import { createDatabase } from 'remix/data-table'
+import { createPostgresDatabaseAdapter } from 'remix/data-table/postgres'
+
+let pool = new Pool({
+  connectionString: process.env.DATABASE_URL,
+})
+
+let db = createDatabase(createPostgresDatabaseAdapter(pool))
+```
+
+Use `db.query(...)`, relation loading, and transactions from `remix/data-table`.
+Import any driver-specific types you need directly from `pg`.
+
+## Adapter Capabilities
+
+`data-table-postgres` reports this capability set by default:
+
+- `returning: true`
+- `savepoints: true`
+- `upsert: true`
+- `transactionalDdl: true`
+- `migrationLock: true`
+
+## Advanced Usage
+
+### Transaction Options
+
+Transaction options are passed through to the adapter as hints.
+
+```ts
+await db.transaction(async (txDb) => txDb.exec('select 1'), {
+  isolationLevel: 'serializable',
+  readOnly: false,
+})
+```
+
+## Related Packages
+
+- [`data-table`](https://github.com/remix-run/remix/tree/main/packages/data-table) - Core query/relations API
+- [`data-schema`](https://github.com/remix-run/remix/tree/main/packages/data-schema) - Schema parsing and validation
+- [`data-table-mysql`](https://github.com/remix-run/remix/tree/main/packages/data-table-mysql) - MySQL adapter
+- [`data-table-sqlite`](https://github.com/remix-run/remix/tree/main/packages/data-table-sqlite) - SQLite adapter
+
+## License
+
+See [LICENSE](https://github.com/remix-run/remix/blob/main/LICENSE)

package/src/data-table-sqlite/README.md

@@ -0,0 +1,84 @@
+# data-table-sqlite
+
+SQLite adapter for [`remix/data-table`](https://github.com/remix-run/remix/tree/main/packages/data-table).
+Use this package when you want `data-table` APIs backed by a synchronous SQLite client.
+
+## Features
+
+- **Native Runtime SQLite Support**: Works with Node's `node:sqlite` `DatabaseSync`, Bun's `bun:sqlite` `Database`, and compatible synchronous SQLite clients
+- **Full `data-table` API Support**: Queries, relations, writes, and transactions
+- **Adapter-Owned Compiler**: SQL compilation lives in this adapter, with optional shared pure helpers from `data-table`
+- **Multi-Statement Migrations**: `executeScript()` runs `up.sql` / `down.sql` files via `Database.exec()`
+- **SQLite Capabilities Enabled By Default**:
+  - `returning: true`
+  - `savepoints: true`
+  - `upsert: true`
+  - `transactionalDdl: true`
+  - `migrationLock: false`
+
+## Installation
+
+```sh
+npm i remix
+```
+
+## Usage
+
+### Node
+
+```ts
+import { DatabaseSync } from 'node:sqlite'
+import { createDatabase } from 'remix/data-table'
+import { createSqliteDatabaseAdapter } from 'remix/data-table/sqlite'
+
+let sqlite = new DatabaseSync('app.db')
+let db = createDatabase(createSqliteDatabaseAdapter(sqlite))
+```
+
+### Bun
+
+```ts
+import { Database } from 'bun:sqlite'
+import { createDatabase } from 'remix/data-table'
+import { createSqliteDatabaseAdapter } from 'remix/data-table/sqlite'
+
+let sqlite = new Database('app.db')
+let db = createDatabase(createSqliteDatabaseAdapter(sqlite))
+```
+
+This is a good fit for local development, embedded deployments, and single-node services.
+Import any driver-specific types you need directly from your runtime's SQLite module.
+
+## Adapter Capabilities
+
+`data-table-sqlite` reports this capability set by default:
+
+- `returning: true`
+- `savepoints: true`
+- `upsert: true`
+- `transactionalDdl: true`
+- `migrationLock: false`
+
+## Advanced Usage
+
+### In-Memory Database For Tests
+
+```ts
+import { DatabaseSync } from 'node:sqlite'
+import { createDatabase } from 'remix/data-table'
+import { createSqliteDatabaseAdapter } from 'remix/data-table/sqlite'
+
+let sqlite = new DatabaseSync(':memory:')
+let db = createDatabase(createSqliteDatabaseAdapter(sqlite))
+```
+
+## Related Packages
+
+- [`data-table`](https://github.com/remix-run/remix/tree/main/packages/data-table) - Core query/relations API
+- [`data-schema`](https://github.com/remix-run/remix/tree/main/packages/data-schema) - Schema parsing and validation
+- [`data-table-postgres`](https://github.com/remix-run/remix/tree/main/packages/data-table-postgres) - PostgreSQL adapter
+- [`data-table-mysql`](https://github.com/remix-run/remix/tree/main/packages/data-table-mysql) - MySQL adapter
+
+## License
+
+See [LICENSE](https://github.com/remix-run/remix/blob/main/LICENSE)

package/src/fetch-proxy/README.md

@@ -0,0 +1,46 @@
+# fetch-proxy
+
+HTTP proxy utilities built on the web [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).
+Use `fetch-proxy` to create `fetch` handlers that forward requests to target servers while optionally rewriting headers and cookies.
+
+## Features
+
+- **Web Standards** - Built on the standard [JavaScript Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API)
+- **Cookie Rewriting** - Supports rewriting `Set-Cookie` headers received from target server
+- **Forwarding Headers** - Supports `X-Forwarded-Proto`, `X-Forwarded-Host`, and `X-Forwarded-Port` headers
+- **Custom Fetch** - Supports custom `fetch` implementations
+
+## Installation
+
+```sh
+npm i remix
+```
+
+## Usage
+
+```ts
+import { createFetchProxy } from 'remix/fetch-proxy'
+
+// Create a proxy that sends all requests through to remix.run
+let proxy = createFetchProxy('https://remix.run')
+
+// This fetch handler is probably running as part of your server somewhere...
+function handleFetch(request: Request): Promise<Response> {
+  return proxy(request)
+}
+
+// Test it out by manually throwing a Request at it
+let response = await handleFetch(new Request('https://shopify.com'))
+
+let text = await response.text()
+let title = text.match(/<title>([^<]+)<\/title>/)[1]
+assert(title.includes('Remix'))
+```
+
+## Related Packages
+
+- [`node-fetch-server`](https://github.com/remix-run/remix/tree/main/packages/node-fetch-server) - Build HTTP servers for Node.js using the web fetch API
+
+## License
+
+See [LICENSE](https://github.com/remix-run/remix/blob/main/LICENSE)