bigal 16.0.0-beta.3 → 16.0.1

package/.devcontainer/devcontainer.json

@@ -1,7 +1,7 @@
 {
   "name": "bigal",
   "features": {
-    "ghcr.io/devcontainers/features/node:1": {
+    "ghcr.io/devcontainers/features/node:2": {
       "version": "lts"
     }
   },

package/.vite-hooks/pre-commit

@@ -0,0 +1 @@
+vp staged

package/CHANGELOG.md

@@ -1,24 +1,44 @@
-## [16.0.0-beta.3](https://github.com/bigalorm/bigal/compare/v16.0.0-beta.2...v16.0.0-beta.3) (2026-04-08)
+## [16.0.1](https://github.com/bigalorm/bigal/compare/v16.0.0...v16.0.1) (2026-07-13)
 
-### Features
+### Bug Fixes
 
-- Readonly enum arrays, JSONB string operators, codemod improvements, and table() export ([81629fa](https://github.com/bigalorm/bigal/commit/81629fa9dea7d56b223c477a139ca46be1016f16))
+- **deps:** pin conventional-changelog-conventionalcommits to 9.x ([#474](https://github.com/bigalorm/bigal/issues/474)) ([05ac685](https://github.com/bigalorm/bigal/commit/05ac6852e93b5d929b198fe62839c2f2bffb096f))
 
-## [16.0.0-beta.2](https://github.com/bigalorm/bigal/compare/v16.0.0-beta.1...v16.0.0-beta.2) (2026-03-24)
+## [16.0.0](https://github.com/bigalorm/bigal/compare/v15.12.0...v16.0.0) (2026-07-13)
 
-### Features
+## [15.12.0](https://github.com/bigalorm/bigal/compare/v15.11.12...v15.12.0) (2026-07-12)
 
-- Type-safe populate, EntityOrId, and model registry ([1d68830](https://github.com/bigalorm/bigal/commit/1d688306e1574ae4f3275700c1325b7410daadf3))
+## [15.11.12](https://github.com/bigalorm/bigal/compare/v15.11.11...v15.11.12) (2026-07-11)
 
-## [16.0.0-beta.1](https://github.com/bigalorm/bigal/compare/v15.11.4...v16.0.0-beta.1) (2026-03-23)
+## [15.11.11](https://github.com/bigalorm/bigal/compare/v15.11.10...v15.11.11) (2026-07-11)
 
-### ⚠ BREAKING CHANGES
+## [15.11.10](https://github.com/bigalorm/bigal/compare/v15.11.9...v15.11.10) (2026-06-09)
 
-- Function-based schema API
+### Bug Fixes
 
-### Features
+- qualify base-table columns when a query has a join ([#435](https://github.com/bigalorm/bigal/issues/435)) ([667e1f3](https://github.com/bigalorm/bigal/commit/667e1f3d427f73713e30bb7bf18f5f7e61acd206))
+
+## [15.11.9](https://github.com/bigalorm/bigal/compare/v15.11.8...v15.11.9) (2026-05-19)
+
+## [15.11.8](https://github.com/bigalorm/bigal/compare/v15.11.7...v15.11.8) (2026-05-19)
+
+### Bug Fixes
+
+- prevent propertyName leak across where-clause iteration ([#403](https://github.com/bigalorm/bigal/issues/403)) ([0454e84](https://github.com/bigalorm/bigal/commit/0454e84d4c6fdf46fc14bdcf57ab409619ea8a03)), closes [#393](https://github.com/bigalorm/bigal/issues/393)
+
+## [15.11.7](https://github.com/bigalorm/bigal/compare/v15.11.6...v15.11.7) (2026-04-26)
+
+### Bug Fixes
+
+- Return Pick<QueryResult<T>> from chained .select() ([#390](https://github.com/bigalorm/bigal/issues/390)) ([89780a4](https://github.com/bigalorm/bigal/commit/89780a4068c312fcf59b8598eb35792e3b498918))
+
+## [15.11.6](https://github.com/bigalorm/bigal/compare/v15.11.5...v15.11.6) (2026-04-07)
+
+### Bug Fixes
+
+- Accept readonly arrays for column enum values ([4843e01](https://github.com/bigalorm/bigal/commit/4843e0117eedae2d0b601d9148ff2a885fad5f27))
 
-- Function-based schema API ([5b67b83](https://github.com/bigalorm/bigal/commit/5b67b83c29cfe7b53b725415c0eeff175445ffac))
+## [15.11.5](https://github.com/bigalorm/bigal/compare/v15.11.4...v15.11.5) (2026-03-23)
 
 ## [15.11.4](https://github.com/bigalorm/bigal/compare/v15.11.3...v15.11.4) (2026-03-12)
 

package/CLAUDE.md

@@ -14,10 +14,10 @@ BigAl is a type-safe PostgreSQL ORM for Node.js/TypeScript. It uses a fluent bui
 ## Build and Test Commands
 
 ```bash
-npm run build       # Build the project using unbuild
-npm test            # Type-check and run all tests with Vitest
-npm run lint        # Run oxlint, oxfmt, and markdownlint
-npm run check:types # Type-check without emitting files (tsgo --noEmit --skipLibCheck)
+pnpm run build       # Build the project using vp pack (Vite+)
+pnpm test            # Type-check and run all tests with Vitest
+pnpm run lint        # Run vp fmt, vp lint, and markdownlint
+pnpm run check:types # Type-check without emitting files (tsc --noEmit --skipLibCheck)
 ```
 
 ## Code Style Guidelines

package/README.md

@@ -4,10 +4,9 @@
 [![node version](https://img.shields.io/node/v/bigal.svg?style=flat)](https://nodejs.org)
 [![Known Vulnerabilities](https://snyk.io/test/npm/bigal/badge.svg)](https://snyk.io/test/npm/bigal)
 
-A PostgreSQL-optimized, type-safe TypeScript ORM for Node.js. BigAl uses a fluent builder
-pattern for queries, function-based schema definitions with PostgreSQL-native column builders,
-and immutable query state. Built exclusively for Postgres with native support for JSONB,
-DISTINCT ON, subquery joins, ON CONFLICT upserts, and pgvector.
+A PostgreSQL-optimized, type-safe TypeScript ORM for Node.js. BigAl uses a fluent builder pattern for queries,
+decorator-based models, and immutable query state. Built exclusively for Postgres — queries are tuned for
+Postgres performance with native support for JSONB, DISTINCT ON, subquery joins, ON CONFLICT upserts, and pgvector.
 
 ## Install
 
@@ -28,62 +27,49 @@ npm install pg
 npm install @neondatabase/serverless
 ```
 
-Requires Node.js >= 22.
-
 ## Quick Start
 
 ```ts
-import { initialize, defineTable as table, serial, text, integer, belongsTo, hasMany, createdAt, updatedAt } from 'bigal';
-import type { Repository } from 'bigal';
+import { column, primaryColumn, table, Entity, initialize, Repository } from 'bigal';
 import { Pool } from 'postgres-pool';
 
-// Define models with PostgreSQL-native column builders
-// Column names auto-derive from property keys (priceCents -> price_cents)
-const Product = table('products', {
-  id: serial().primaryKey(),
-  name: text().notNull(),
-  priceCents: integer().notNull(),
-  store: belongsTo('Store'),
-  createdAt: createdAt(),
-  updatedAt: updatedAt(),
-});
-
-const Store = table('stores', {
-  id: serial().primaryKey(),
-  name: text(),
-  products: hasMany('Product').via('store'),
-});
-
-// Initialize with typed destructuring -- no type assertions needed
+@table({ name: 'products' })
+class Product extends Entity {
+  @primaryColumn({ type: 'integer' })
+  public id!: number;
+
+  @column({ type: 'string', required: true })
+  public name!: string;
+
+  @column({ type: 'integer', required: true, name: 'price_cents' })
+  public priceCents!: number;
+}
+
 const pool = new Pool('postgres://localhost/mydb');
-const { Product, Store } = initialize({
-  pool,
-  models: { Product, Store },
-});
+const repos = initialize({ models: [Product], pool });
+const productRepository = repos.Product as Repository<Product>;
 
-// Fluent queries -- just await the chain
-const products = await Product.find()
+// Fluent queries — just await the chain
+const products = await productRepository
+  .find()
   .where({ priceCents: { '>=': 1000 }, name: { contains: 'widget' } })
   .sort('name asc')
   .limit(10);
 
 // Upserts with ON CONFLICT
-await Product.create({ name: 'Widget', priceCents: 999, store: 1 }, { onConflict: { action: 'merge', targets: ['name'], merge: ['priceCents'] } });
-
-// Inspect generated SQL without executing
-const { sql, params } = Product.find().where({ name: 'Widget' }).toSQL();
+await productRepository.create({ name: 'Widget', sku: 'WDG-001', priceCents: 999 }, { onConflict: { action: 'merge', targets: ['sku'], merge: ['priceCents'] } });
 ```
 
 ## Documentation
 
 Full documentation is available at **[bigalorm.github.io/bigal](https://bigalorm.github.io/bigal/)**.
 
-- [Getting Started](https://bigalorm.github.io/bigal/getting-started) -- install, first model, first query
-- [Models](https://bigalorm.github.io/bigal/guide/models) -- table definitions, column types, relationships
-- [Querying](https://bigalorm.github.io/bigal/guide/querying) -- operators, pagination, JSONB, DISTINCT ON
-- [CRUD Operations](https://bigalorm.github.io/bigal/guide/crud-operations) -- create, update, destroy, upserts
-- [Subqueries & Joins](https://bigalorm.github.io/bigal/guide/subqueries-and-joins) -- subquery builder, aggregates
-- [API Reference](https://bigalorm.github.io/bigal/reference/api) -- all exports and method signatures
+- [Getting Started](https://bigalorm.github.io/bigal/getting-started) — install, first model, first query
+- [Models](https://bigalorm.github.io/bigal/guide/models) — decorators, column options, relationships
+- [Querying](https://bigalorm.github.io/bigal/guide/querying) — operators, pagination, JSONB, DISTINCT ON
+- [CRUD Operations](https://bigalorm.github.io/bigal/guide/crud-operations) — create, update, destroy, upserts
+- [Subqueries & Joins](https://bigalorm.github.io/bigal/guide/subqueries-and-joins) — subquery builder, aggregates
+- [API Reference](https://bigalorm.github.io/bigal/reference/api) — all exports and method signatures
 
 ## Machine-Readable Documentation
 
@@ -105,7 +91,7 @@ npx skills add bigalorm/bigal
 ## Compatibility
 
 - [PostgreSQL](http://www.postgresql.org/) 14 or above
-- Node.js 22 or above
+- Node.js 22.11.0 or above
 
 ## License