supalite 0.5.7 → 0.7.0

package/.github/workflows/ci.yml

@@ -0,0 +1,41 @@
+name: ci
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_PASSWORD: postgres
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd="pg_isready -U postgres"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=5
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+
+      - run: npm ci
+      - name: Initialize test database
+        env:
+          PGPASSWORD: postgres
+        run: psql -h localhost -U postgres -f setup-postgres-test.sql
+
+      - run: npm run build
+      - run: npm test
+        env:
+          DB_CONNECTION: postgresql://testuser:testpassword@localhost:5432/testdb
+      - run: npm run lint

package/AGENTS.md

@@ -0,0 +1,39 @@
+# AGENTS
+
+Guidance for automated agents working in this repository.
+
+## Repo map (high level)
+- `src/postgres-client.ts`: core client, connection config, transactions, RPC, schema/foreign-key caches.
+- `src/query-builder.ts`: query builder, SQL generation, query execution.
+- `src/types.ts`: public types, schema typing helpers, result shapes.
+- `src/errors.ts`: `PostgresError` wrapper.
+- `src/client.ts`: `SupaliteClient` wrapper over `SupaLitePG`.
+- `src/__tests__`: Jest tests (some use a real Postgres DB).
+
+## Runtime behavior to keep in mind
+- QueryBuilder builds SQL and runs it via `pool.query`. Transaction state is tracked on `SupaLitePG`, but QueryBuilder does not currently switch to the transaction client; only schema metadata queries use the transaction client.
+- JSON/JSONB values are stringified on INSERT/UPDATE when the value is an array/object; native arrays (e.g. `text[]`) are passed through as arrays.
+- BigInt handling is configured via `bigintTransform` using pg type parsers.
+- `count: 'exact'` uses a window function and strips `exact_count` from result rows.
+- `head: true` returns `COUNT(*)` only and `data: []`.
+- `single()` / `maybeSingle()` enforce row count and return Supabase-like errors.
+- `or()` expects `col.op.value` segments and only supports a fixed set of operators.
+
+## Development workflow
+- Build: `npm run build`
+- Test: `npm test` (integration tests need `DB_CONNECTION` or other DB env vars)
+- Lint: `npm run lint`
+
+## Change checklist
+- If you add/modify query behavior:
+  - Update `src/query-builder.ts` and relevant types in `src/types.ts`.
+  - Add/adjust Jest tests in `src/__tests__` (raw SQL tests are preferred for SQL shape).
+  - Update `README.md` and `SPEC.md` to reflect the new behavior.
+- If you add/modify RPC behavior:
+  - Update `src/postgres-client.ts` and `src/__tests__/rpc.test.ts`.
+- If you touch JSON/BigInt behavior:
+  - Update conversion rules and document in `SPEC.md`.
+
+## Safe defaults
+- Prefer explicit, deterministic SQL generation (avoid relying on implicit column order).
+- Keep new docs and examples ASCII unless the file already uses Unicode.

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## [0.7.0] - 2026-01-17
+
+### ✨ Added
+- `supalite gen types` CLI to generate TypeScript Database types from PostgreSQL schemas.
+- BIGINT columns are emitted as `bigint` in the generated types.
+- `--date-as-date` option to map `date`/`timestamp` columns to `Date` in generated types.
+- `--include-relationships`, `--include-constraints`, `--include-indexes` options to emit schema metadata.
+- `--include-composite-types` and `--include-function-signatures` options for composite types and typed function signatures.
+- `--type-case` and `--function-case` options to control enum/composite and function key casing.
+- `--dump-functions-sql` option to export `CREATE FUNCTION/PROCEDURE` definitions to a local file.
+- Added gen-types seed/cleanup scripts and limitations docs.
+
+## [0.6.1] - 2026-01-16
+
+### ✨ Added
+- `count: 'planned' | 'estimated'`가 `EXPLAIN (FORMAT JSON)` 기반 추정치를 반환하도록 추가했습니다.
+
+### 🐞 Fixed
+- 트랜잭션 내 쿼리가 트랜잭션 클라이언트로 실행되도록 수정했습니다.
+- `in()`에 `null`이 포함될 때 `IS NULL`을 포함하도록 개선했습니다.
+
+## [0.6.0] - 2026-01-16
+
+### ✨ Added
+- PostgREST-style embed에 중첩 관계, `!inner`, 관계 테이블 필터(`table.column`) 지원을 추가했습니다.
+- `insert()`에 `onConflict`/`ignoreDuplicates` 옵션을 추가했습니다. (`ON CONFLICT DO NOTHING`)
+- `upsert()`에 `ignoreDuplicates` 옵션을 추가했습니다. (`ON CONFLICT DO NOTHING`)
+- `or()`에서 `now()`를 `NOW()`로 인라인 처리합니다.
+- README 영어화 및 `README.ko.md` 추가.
+- `or()`에 따옴표 값 파싱을 추가해 `,`/`.` 포함 값을 안전하게 처리합니다.
+
+### 🐞 Fixed
+- `single()`/`maybeSingle()`/RPC 내부 PGRST 에러에 `error.code`를 채워 분기 처리를 안정화했습니다.
+- RPC가 빈 결과에서 `data: []`를 반환하고, 스칼라 언랩은 스칼라 반환 함수에만 적용합니다.
+
 ## [0.5.7] - 2026-01-14
 
 ### ✨ Added