Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 0 additions & 5 deletions .changeset/compiled-module-value-plans.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/compiler-javascript-line-endings.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/compiler-runtime-plan-provenance.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/explicit-json-inputs.md

This file was deleted.

8 changes: 0 additions & 8 deletions .changeset/fix-fragment-list-plan-evidence.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/immutable-json-plan-shapes.md

This file was deleted.

6 changes: 0 additions & 6 deletions .changeset/json-document-parameters.md

This file was deleted.

7 changes: 0 additions & 7 deletions .changeset/json-native-policy-evidence.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/json-schema-declarations.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/json-validation-allocations.md

This file was deleted.

7 changes: 0 additions & 7 deletions .changeset/legacy-query-value-plans.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/mysql-owned-json-wire.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/mysql-structured-json.md

This file was deleted.

7 changes: 0 additions & 7 deletions .changeset/native-json-output-guards.md

This file was deleted.

11 changes: 0 additions & 11 deletions .changeset/portable-buffered-adapters.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/portable-query-byte-limits.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/portable-vite-factories.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/postgres-array-null-elements.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/postgres-nested-json-shapes.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/postgres-planned-json-wire.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/postgres-structured-json-operations.md

This file was deleted.

4 changes: 4 additions & 0 deletions .changeset/pre.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"mode": "pre",
"tag": "rc"
}
5 changes: 0 additions & 5 deletions .changeset/query-validation-ownership.md

This file was deleted.

6 changes: 0 additions & 6 deletions .changeset/query-value-plans.md

This file was deleted.

6 changes: 0 additions & 6 deletions .changeset/raw-json-runtime-validation.md

This file was deleted.

13 changes: 0 additions & 13 deletions .changeset/sql-content-mapper.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/sql-factory-static-fragments.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/sql-loader-node-patch.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/sqlite-planned-values.md

This file was deleted.

7 changes: 0 additions & 7 deletions .changeset/sqlite-row-allocation.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/sqlite-structured-json.md

This file was deleted.

5 changes: 0 additions & 5 deletions .changeset/structured-json-contract.md

This file was deleted.

10 changes: 0 additions & 10 deletions .changeset/verified-structural-runtime-plans.md

This file was deleted.

52 changes: 52 additions & 0 deletions .github/release-notes/2.3.0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# typed-sql 2.3.0

typed-sql 2.3 adds shared JSON contracts, portable execution adapters, and compiled runtime value
plans. SQL syntax, coercions and diagnostics remain owned by the selected grammar.

## Highlights

- PostgreSQL, MySQL and SQLite carry bounded JSON shapes through constructors, aggregation,
paths and supported mutations. Application declarations narrow types only when runtime
validation is available. JSON null and SQL NULL remain separate at transport boundaries.
- `@typed-sql/adapters` adds explicit D1, libSQL, Neon HTTP/WebSocket and postgres.js entrypoints.
Applications own their database drivers and client lifetimes. Adapters expose only native
transaction, batch and control capabilities they can support.
- SQL-file factories and the Vite frontend attach executable value plans. Generated runtime
imports resolve through portable grammar entrypoints without an extra application dependency
on Core. Conditional and repeated SQL structures are checked against compiled evidence.
- Query composition preserves result validators. Copies that discard query metadata and generic
executors without a transport contract cannot bypass compiled validation.
- Immutable plan preparation, row decoding and JSON validation allocate less. Repeated plans
share owned immutable JSON shapes without relaxing expansion limits.
- Reproducible raw-driver and Reylo comparisons include cold and warm paths, prepared execution,
concurrency, CPU and allocation evidence. Runtime validation has a measurable cost; these
results do not establish a universal speed advantage.

## Compatibility

The stable runtime and compiler require Node.js 22.11 or newer. The optional `node:sqlite` adapter
requires Node.js 22.13 or newer. The optional Node SQL-file loader requires Node.js 24.11.1 or
newer on the Node 24 line, Node 25.1 or newer on the Node 25 line, or a supported later line.
PostgreSQL, MySQL, and SQLite are stable dialect packages.

The ordinary compiler uses TypeScript 7.0.2. The isolated experimental editor backend uses
TypeScript 7.1.0-beta. Editor artifacts are exercised on Linux, macOS and Windows.

Dynamic repeated-fragment result properties remain conservatively nullable unknown. SQLite's
reviewed catalog range is 3.39.0–3.53.4; a newer bundled library, including SQLite 3.54 in Node 26,
retains conservative inference rather than inheriting unreviewed language guarantees.

See the [compatibility matrix](https://lojhan.github.io/typed-sql/reference/compatibility),
[portable adapters](https://lojhan.github.io/typed-sql/reference/portable-adapters), and
[upgrade guide](https://lojhan.github.io/typed-sql/guides/upgrading-from-v1).

## Package tracks

The stable package train contains `@typed-sql/core`, `@typed-sql/opentelemetry`, `@typed-sql/ast`,
`@typed-sql/schema`, `@typed-sql/config`, `@typed-sql/compiler`, `@typed-sql/conformance`,
`@typed-sql/postgres`, `@typed-sql/mysql`, `@typed-sql/sqlite`, `@typed-sql/cli`, and
`@typed-sql/adapters`.

`@typed-sql/ts-bridge`, `@typed-sql/language-server`, and the editor integrations remain
experimental. A shared release-candidate version does not promote their preview contracts;
stable packages do not depend on them.
26 changes: 26 additions & 0 deletions packages/adapters/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1 +1,27 @@
# @typed-sql/adapters

## 2.3.0-rc.0

### Minor Changes

- b24279d: Add explicit buffered adapters for D1, libSQL/Turso, Neon HTTP, Neon WebSocket, and Postgres.js.
Adapters enforce compiled value plans, transport precision, and truthful batch/transaction
capabilities while leaving drivers application-owned. Add portable grammar query entrypoints and
logical value descriptors without changing existing runtime entrypoint exports.

### Patch Changes

- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [19f37d9]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [19f37d9]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- @typed-sql/core@2.3.0-rc.0
2 changes: 1 addition & 1 deletion packages/adapters/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@typed-sql/adapters",
"version": "2.2.0",
"version": "2.3.0-rc.0",
"description": "Explicit buffered database adapters for D1, libSQL, Neon and Postgres.js.",
"license": "MIT",
"author": "Lojhan",
Expand Down
6 changes: 6 additions & 0 deletions packages/ast/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
# @typed-sql/ast

## 2.3.0-rc.0

### Patch Changes

- Publish the coherent 2.3.0-rc.0 release-candidate train.

## 2.2.0

This release promotes the changes documented in 2.2.0-rc.0 to stable.
Expand Down
2 changes: 1 addition & 1 deletion packages/ast/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@typed-sql/ast",
"version": "2.2.0",
"version": "2.3.0-rc.0",
"description": "Grammar-neutral SQL source ranges, tokenizer profiles, bounded cursors, and parser utilities for typed-sql.",
"license": "MIT",
"author": "Lojhan",
Expand Down
27 changes: 27 additions & 0 deletions packages/cli/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,32 @@
# @typed-sql/cli

## 2.3.0-rc.0

### Patch Changes

- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [702bc16]
- Updated dependencies [b24279d]
- Updated dependencies [19f37d9]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- Updated dependencies [19f37d9]
- Updated dependencies [b24279d]
- Updated dependencies [b24279d]
- @typed-sql/compiler@2.3.0-rc.0
- @typed-sql/core@2.3.0-rc.0
- @typed-sql/schema@2.3.0-rc.0
- @typed-sql/config@2.3.0-rc.0

## 2.2.0

This release promotes the changes documented in 2.2.0-rc.0 to stable.
Expand Down
2 changes: 1 addition & 1 deletion packages/cli/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@typed-sql/cli",
"version": "2.2.0",
"version": "2.3.0-rc.0",
"description": "Config-driven typed-sql generation, checking, verification, and migration compatibility CLI.",
"license": "MIT",
"author": "Lojhan",
Expand Down
Loading
Loading