bigal 15.11.3 → 15.11.4

package/CHANGELOG.md

@@ -1,3 +1,5 @@
+## [15.11.4](https://github.com/bigalorm/bigal/compare/v15.11.3...v15.11.4) (2026-03-12)
+
 ## [15.11.3](https://github.com/bigalorm/bigal/compare/v15.11.2...v15.11.3) (2026-03-12)
 
 ## [15.11.2](https://github.com/bigalorm/bigal/compare/v15.11.1...v15.11.2) (2026-03-12)

package/docs/.vitepress/config.ts

@@ -1,11 +1,17 @@
 import { defineConfig } from 'vitepress';
 import llmstxt from 'vitepress-plugin-llms';
 
+const SITE_URL = 'https://bigalorm.github.io/bigal';
+const SITE_DESCRIPTION = 'A PostgreSQL-optimized, type-safe TypeScript ORM for Node.js';
+
 export default defineConfig({
   title: 'BigAl',
-  description: 'A PostgreSQL-optimized, type-safe TypeScript ORM for Node.js',
+  description: SITE_DESCRIPTION,
   base: '/bigal/',
   appearance: 'force-dark',
+  sitemap: {
+    hostname: SITE_URL,
+  },
   head: [
     ['link', { rel: 'preconnect', href: 'https://fonts.googleapis.com' }],
     ['link', { rel: 'preconnect', href: 'https://fonts.gstatic.com', crossorigin: '' }],
@@ -17,7 +23,25 @@ export default defineConfig({
       },
     ],
     ['link', { rel: 'llms-txt', href: '/bigal/llms.txt' }],
+    ['meta', { property: 'og:site_name', content: 'BigAl' }],
+    ['meta', { property: 'og:type', content: 'website' }],
+    ['meta', { name: 'twitter:card', content: 'summary' }],
   ],
+  transformPageData(pageData) {
+    const isHome = pageData.frontmatter.layout === 'home';
+    const title = isHome ? 'BigAl — PostgreSQL-optimized TypeScript ORM' : `${pageData.title} | BigAl`;
+    const description = pageData.frontmatter.description || SITE_DESCRIPTION;
+    const canonicalUrl = `${SITE_URL}/${pageData.relativePath}`.replace(/index\.md$/, '').replace(/\.md$/, '');
+
+    pageData.frontmatter.head ??= [];
+    pageData.frontmatter.head.push(
+      ['meta', { property: 'og:title', content: title }],
+      ['meta', { property: 'og:description', content: description }],
+      ['meta', { property: 'og:url', content: canonicalUrl }],
+      ['meta', { name: 'twitter:title', content: title }],
+      ['meta', { name: 'twitter:description', content: description }],
+    );
+  },
   themeConfig: {
     nav: [
       { text: 'Guide', link: '/getting-started' },

package/docs/advanced/bigal-vs-raw-sql.md

@@ -1,3 +1,7 @@
+---
+description: When to use BigAl vs raw SQL, with a side-by-side translation table mapping common SQL queries to BigAl's fluent API.
+---
+
 # BigAl vs Raw SQL
 
 ## When to use BigAl

package/docs/advanced/known-issues.md

@@ -1,3 +1,7 @@
+---
+description: Known issues and workarounds — optional collections, NotEntity for JSON objects with id fields, and DEBUG_BIGAL logging.
+---
+
 # Known Issues
 
 ## Entity collections must be optional

package/docs/getting-started.md

@@ -1,3 +1,7 @@
+---
+description: Install BigAl, define your first model with decorators, initialize a repository, and run type-safe PostgreSQL queries.
+---
+
 # Getting Started
 
 ## Install

package/docs/guide/crud-operations.md

@@ -1,3 +1,7 @@
+---
+description: Create, update, and destroy records with RETURNING support, query projection, and ON CONFLICT upserts.
+---
+
 # CRUD Operations
 
 BigAl repositories provide `create()`, `update()`, and `destroy()` methods. All three return affected records

package/docs/guide/models.md

@@ -1,3 +1,7 @@
+---
+description: Define PostgreSQL tables as TypeScript classes with decorators for columns, primary keys, relationships, and automatic timestamps.
+---
+
 # Models
 
 Models map TypeScript classes to PostgreSQL tables. Every model extends `Entity` and uses decorators for table and column configuration.

package/docs/guide/querying.md

@@ -1,3 +1,7 @@
+---
+description: Fluent query builder for find, findOne, and count with WHERE operators, JSONB querying, pagination, sorting, DISTINCT ON, and populate.
+---
+
 # Querying
 
 BigAl provides `findOne()`, `find()`, and `count()` methods on repositories. Queries use a fluent builder pattern —

package/docs/guide/relationships.md

@@ -1,3 +1,7 @@
+---
+description: Many-to-one, one-to-many, and many-to-many relationships with decorators, QueryResult type narrowing, and populate options.
+---
+
 # Relationships
 
 BigAl supports three relationship patterns via the `@column` decorator: many-to-one, one-to-many, and many-to-many.

package/docs/guide/subqueries-and-joins.md

@@ -1,3 +1,7 @@
+---
+description: Type-safe subqueries for WHERE IN, EXISTS, and scalar comparisons. Model joins, subquery joins, aggregates, GROUP BY, and HAVING.
+---
+
 # Subqueries and Joins
 
 BigAl supports subqueries for WHERE clauses, scalar comparisons, and joins. All subqueries are type-safe and composable.

package/docs/guide/views.md

@@ -1,3 +1,7 @@
+---
+description: Map PostgreSQL views to readonly models with ReadonlyRepository. Supports inheritance, schema options, and all query features.
+---
+
 # Views and Readonly Repositories
 
 BigAl does not distinguish between tables and views. Both use the `@table()` decorator. Setting `readonly: true` causes

package/docs/reference/api.md

@@ -1,3 +1,7 @@
+---
+description: Complete API reference for BigAl — initialize(), Repository, ReadonlyRepository, query builder methods, subquery(), decorators, and types.
+---
+
 # API Reference
 
 All public exports from `bigal`.

package/docs/reference/configuration.md

@@ -1,3 +1,7 @@
+---
+description: Configure connection pools (postgres-pool, pg, Neon), read replicas, multiple databases, and debug logging.
+---
+
 # Configuration
 
 ## Connection pools

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bigal",
-  "version": "15.11.3",
+  "version": "15.11.4",
   "description": "A type-safe PostgreSQL ORM for Node.js, written in TypeScript. Features a fluent query builder, decorator-based models, and immutable query state.",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",

package/release.config.mjs

@@ -12,7 +12,7 @@ export default {
       {
         preset: 'angular',
         releaseRules: [
-          { type: 'docs', release: 'patch' },
+          { type: 'docs', release: false },
           { type: 'feat', release: 'minor' },
           { type: 'fix', release: 'patch' },
           { type: 'test', release: 'patch' },