bigal 15.11.3 → 15.11.5

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [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)
+
 ## [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: '' }],
@@ -13,11 +19,29 @@ export default defineConfig({
       'link',
       {
         rel: 'stylesheet',
-        href: 'https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,400;0,9..40,500;0,9..40,600;0,9..40,700;1,9..40,400&family=JetBrains+Mono:wght@400;500&family=Source+Sans+3:wght@400;500;600&display=swap',
+        href: 'https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,400;0,9..40,500;0,9..40,600;0,9..40,700;1,9..40,400&family=Source+Code+Pro:wght@400;500&family=Source+Sans+3:wght@400;500;600&display=swap',
       },
     ],
     ['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/.vitepress/theme/custom.css

@@ -26,7 +26,7 @@
   /* Typography */
   --bigal-font-display: 'DM Sans', sans-serif;
   --bigal-font-body: 'Source Sans 3', sans-serif;
-  --bigal-font-mono: 'JetBrains Mono', 'Fira Code', monospace;
+  --bigal-font-mono: 'Source Code Pro', monospace;
 }
 
 /* Map to VitePress theme variables */
@@ -101,12 +101,57 @@
   color: var(--bigal-text-muted);
 }
 
-/* Move search from left side to right, just before the nav menu items */
+/* Vite-style nav: title + links left, search + social right */
+.VPNavBarTitle .title {
+  color: var(--bigal-accent-text);
+  font-family: var(--bigal-font-display);
+  font-size: 1.375rem;
+  font-weight: 700;
+}
+
+.VPNavBarMenu {
+  order: -1;
+  padding-left: 16px;
+  font-size: 1.1rem;
+}
+
 .VPNavBarSearch {
   flex-grow: 1;
   justify-content: flex-end;
 }
 
+/* Full-width nav above sidebar (vite.dev style) —
+   !important needed to override VitePress scoped [data-v-*] selectors */
+@media (min-width: 960px) {
+  /* Target the wrapper div (not the <a> link which also has class .title) */
+  .VPNavBar.has-sidebar div.title {
+    position: static !important;
+    width: auto !important;
+    padding: 0 0 0 32px !important;
+    height: auto !important;
+    border-bottom: none !important;
+    background-color: var(--bigal-bg) !important;
+  }
+
+  /* Remove the sidebar-width divider border that VitePress puts
+     under the title link on has-sidebar pages, and restore full height
+     so the title text is vertically centered in the nav bar */
+  .VPNavBarTitle.has-sidebar a.title {
+    border-bottom: none !important;
+    padding-left: 0 !important;
+    height: var(--vp-nav-height, 64px) !important;
+  }
+
+  .VPNavBar.has-sidebar .content {
+    padding-left: 0 !important;
+    padding-right: 32px !important;
+  }
+
+  .VPNavBar.has-sidebar .divider {
+    padding-left: 0 !important;
+  }
+}
+
 /* Sidebar refinements */
 .VPSidebar {
   font-family: var(--bigal-font-body);
@@ -133,3 +178,27 @@
 .vp-doc table tr:nth-child(even) {
   background: var(--bigal-bg-deep);
 }
+
+/* Thin scrollbars (vite.dev style) */
+* {
+  scrollbar-width: thin;
+  scrollbar-color: var(--bigal-border) transparent;
+}
+
+::-webkit-scrollbar {
+  width: 6px;
+  height: 6px;
+}
+
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+::-webkit-scrollbar-thumb {
+  background: var(--bigal-border);
+  border-radius: 3px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: var(--bigal-text-faint);
+}

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 —
@@ -164,6 +168,24 @@ await repo.find().where({ bar: { a: { b: { c: 'value' } } } });
 // SQL: WHERE "bar"->'a'->'b'->>'c'=$1
 ```
 
+### Null checks
+
+Check if a JSONB property is null or not null:
+
+```ts
+await repo.find().where({ bar: { theme: null } });
+// SQL: WHERE "bar"->>'theme' IS NULL
+
+await repo.find().where({ bar: { theme: { '!': null } } });
+// SQL: WHERE "bar"->>'theme' IS NOT NULL
+```
+
+Note that `IS NULL` on a JSONB property is true both when the key is missing from the object and when it is
+explicitly set to `null`. This matches PostgreSQL's behavior — the `->>` operator returns `NULL` in both cases.
+
+Properties set to `undefined` in a where clause are silently ignored (standard JavaScript — `undefined` values are
+dropped by `Object.entries`). To query for missing or null properties, always use `null` explicitly.
+
 ### JSONB containment
 
 Combine `contains` with property access:

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/index.md

@@ -1,7 +1,6 @@
 ---
 layout: home
 hero:
-  name: BigAl
   text: PostgreSQL-optimized TypeScript ORM
   tagline: Built exclusively for Postgres. Type-safe fluent query builder, decorator-based models, and queries tuned for Postgres performance.
   actions:

package/docs/package-lock.json

@@ -7,7 +7,7 @@
       "name": "bigal-docs",
       "devDependencies": {
         "vitepress": "1.6.4",
-        "vitepress-plugin-llms": "1.11.0"
+        "vitepress-plugin-llms": "1.12.0"
       }
     },
     "node_modules/@algolia/abtesting": {
@@ -289,9 +289,9 @@
       }
     },
     "node_modules/@babel/parser": {
-      "version": "7.29.0",
-      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.0.tgz",
-      "integrity": "sha512-IyDgFV5GeDUVX4YdF/3CPULtVGSXXMLh1xVIgdCgxApktqnQV0r7/8Nqthg+8YLGaAtdyIlo2qIdZrbCv4+7ww==",
+      "version": "7.29.2",
+      "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.2.tgz",
+      "integrity": "sha512-4GgRzy/+fsBa72/RZVJmGKPmZu9Byn8o4MoLpmNe1m8ZfYnz5emHLQz3U4gLud6Zwl0RZIcgiLD7Uq7ySFuDLA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -761,9 +761,9 @@
       }
     },
     "node_modules/@iconify-json/simple-icons": {
-      "version": "1.2.73",
-      "resolved": "https://registry.npmjs.org/@iconify-json/simple-icons/-/simple-icons-1.2.73.tgz",
-      "integrity": "sha512-nQZTwul4c2zBqH/aLP4zMOiElj93T6HawbrP+sFQKpxmBdS5x1duCK3cAnkj6dntHz84EYkzaQRM83V2pj4qxA==",
+      "version": "1.2.74",
+      "resolved": "https://registry.npmjs.org/@iconify-json/simple-icons/-/simple-icons-1.2.74.tgz",
+      "integrity": "sha512-yqaohfY6jnYjTVpuTkaBQHrWbdUrQyWXhau0r/0EZiNWYXPX/P8WWwl1DoLH5CbvDjjcWQw5J0zADhgCUklOqA==",
       "dev": true,
       "license": "CC0-1.0",
       "dependencies": {
@@ -785,9 +785,9 @@
       "license": "MIT"
     },
     "node_modules/@rollup/rollup-android-arm-eabi": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.59.0.tgz",
-      "integrity": "sha512-upnNBkA6ZH2VKGcBj9Fyl9IGNPULcjXRlg0LLeaioQWueH30p6IXtJEbKAgvyv+mJaMxSm1l6xwDXYjpEMiLMg==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.60.0.tgz",
+      "integrity": "sha512-WOhNW9K8bR3kf4zLxbfg6Pxu2ybOUbB2AjMDHSQx86LIF4rH4Ft7vmMwNt0loO0eonglSNy4cpD3MKXXKQu0/A==",
       "cpu": [
         "arm"
       ],
@@ -799,9 +799,9 @@
       ]
     },
     "node_modules/@rollup/rollup-android-arm64": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.59.0.tgz",
-      "integrity": "sha512-hZ+Zxj3SySm4A/DylsDKZAeVg0mvi++0PYVceVyX7hemkw7OreKdCvW2oQ3T1FMZvCaQXqOTHb8qmBShoqk69Q==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.60.0.tgz",
+      "integrity": "sha512-u6JHLll5QKRvjciE78bQXDmqRqNs5M/3GVqZeMwvmjaNODJih/WIrJlFVEihvV0MiYFmd+ZyPr9wxOVbPAG2Iw==",
       "cpu": [
         "arm64"
       ],
@@ -813,9 +813,9 @@
       ]
     },
     "node_modules/@rollup/rollup-darwin-arm64": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.59.0.tgz",
-      "integrity": "sha512-W2Psnbh1J8ZJw0xKAd8zdNgF9HRLkdWwwdWqubSVk0pUuQkoHnv7rx4GiF9rT4t5DIZGAsConRE3AxCdJ4m8rg==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.60.0.tgz",
+      "integrity": "sha512-qEF7CsKKzSRc20Ciu2Zw1wRrBz4g56F7r/vRwY430UPp/nt1x21Q/fpJ9N5l47WWvJlkNCPJz3QRVw008fi7yA==",
       "cpu": [
         "arm64"
       ],
@@ -827,9 +827,9 @@
       ]
     },
     "node_modules/@rollup/rollup-darwin-x64": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.59.0.tgz",
-      "integrity": "sha512-ZW2KkwlS4lwTv7ZVsYDiARfFCnSGhzYPdiOU4IM2fDbL+QGlyAbjgSFuqNRbSthybLbIJ915UtZBtmuLrQAT/w==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.60.0.tgz",
+      "integrity": "sha512-WADYozJ4QCnXCH4wPB+3FuGmDPoFseVCUrANmA5LWwGmC6FL14BWC7pcq+FstOZv3baGX65tZ378uT6WG8ynTw==",
       "cpu": [
         "x64"
       ],
@@ -841,9 +841,9 @@
       ]
     },
     "node_modules/@rollup/rollup-freebsd-arm64": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.59.0.tgz",
-      "integrity": "sha512-EsKaJ5ytAu9jI3lonzn3BgG8iRBjV4LxZexygcQbpiU0wU0ATxhNVEpXKfUa0pS05gTcSDMKpn3Sx+QB9RlTTA==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.60.0.tgz",
+      "integrity": "sha512-6b8wGHJlDrGeSE3aH5mGNHBjA0TTkxdoNHik5EkvPHCt351XnigA4pS7Wsj/Eo9Y8RBU6f35cjN9SYmCFBtzxw==",
       "cpu": [
         "arm64"
       ],
@@ -855,9 +855,9 @@
       ]
     },
     "node_modules/@rollup/rollup-freebsd-x64": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.59.0.tgz",
-      "integrity": "sha512-d3DuZi2KzTMjImrxoHIAODUZYoUUMsuUiY4SRRcJy6NJoZ6iIqWnJu9IScV9jXysyGMVuW+KNzZvBLOcpdl3Vg==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.60.0.tgz",
+      "integrity": "sha512-h25Ga0t4jaylMB8M/JKAyrvvfxGRjnPQIR8lnCayyzEjEOx2EJIlIiMbhpWxDRKGKF8jbNH01NnN663dH638mA==",
       "cpu": [
         "x64"
       ],
@@ -869,9 +869,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.59.0.tgz",
-      "integrity": "sha512-t4ONHboXi/3E0rT6OZl1pKbl2Vgxf9vJfWgmUoCEVQVxhW6Cw/c8I6hbbu7DAvgp82RKiH7TpLwxnJeKv2pbsw==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.60.0.tgz",
+      "integrity": "sha512-RzeBwv0B3qtVBWtcuABtSuCzToo2IEAIQrcyB/b2zMvBWVbjo8bZDjACUpnaafaxhTw2W+imQbP2BD1usasK4g==",
       "cpu": [
         "arm"
       ],
@@ -883,9 +883,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm-musleabihf": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.59.0.tgz",
-      "integrity": "sha512-CikFT7aYPA2ufMD086cVORBYGHffBo4K8MQ4uPS/ZnY54GKj36i196u8U+aDVT2LX4eSMbyHtyOh7D7Zvk2VvA==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.60.0.tgz",
+      "integrity": "sha512-Sf7zusNI2CIU1HLzuu9Tc5YGAHEZs5Lu7N1ssJG4Tkw6e0MEsN7NdjUDDfGNHy2IU+ENyWT+L2obgWiguWibWQ==",
       "cpu": [
         "arm"
       ],
@@ -897,9 +897,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm64-gnu": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.59.0.tgz",
-      "integrity": "sha512-jYgUGk5aLd1nUb1CtQ8E+t5JhLc9x5WdBKew9ZgAXg7DBk0ZHErLHdXM24rfX+bKrFe+Xp5YuJo54I5HFjGDAA==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.60.0.tgz",
+      "integrity": "sha512-DX2x7CMcrJzsE91q7/O02IJQ5/aLkVtYFryqCjduJhUfGKG6yJV8hxaw8pZa93lLEpPTP/ohdN4wFz7yp/ry9A==",
       "cpu": [
         "arm64"
       ],
@@ -911,9 +911,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-arm64-musl": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.59.0.tgz",
-      "integrity": "sha512-peZRVEdnFWZ5Bh2KeumKG9ty7aCXzzEsHShOZEFiCQlDEepP1dpUl/SrUNXNg13UmZl+gzVDPsiCwnV1uI0RUA==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.60.0.tgz",
+      "integrity": "sha512-09EL+yFVbJZlhcQfShpswwRZ0Rg+z/CsSELFCnPt3iK+iqwGsI4zht3secj5vLEs957QvFFXnzAT0FFPIxSrkQ==",
       "cpu": [
         "arm64"
       ],
@@ -925,9 +925,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-loong64-gnu": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.59.0.tgz",
-      "integrity": "sha512-gbUSW/97f7+r4gHy3Jlup8zDG190AuodsWnNiXErp9mT90iCy9NKKU0Xwx5k8VlRAIV2uU9CsMnEFg/xXaOfXg==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.60.0.tgz",
+      "integrity": "sha512-i9IcCMPr3EXm8EQg5jnja0Zyc1iFxJjZWlb4wr7U2Wx/GrddOuEafxRdMPRYVaXjgbhvqalp6np07hN1w9kAKw==",
       "cpu": [
         "loong64"
       ],
@@ -939,9 +939,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-loong64-musl": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.59.0.tgz",
-      "integrity": "sha512-yTRONe79E+o0FWFijasoTjtzG9EBedFXJMl888NBEDCDV9I2wGbFFfJQQe63OijbFCUZqxpHz1GzpbtSFikJ4Q==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.60.0.tgz",
+      "integrity": "sha512-DGzdJK9kyJ+B78MCkWeGnpXJ91tK/iKA6HwHxF4TAlPIY7GXEvMe8hBFRgdrR9Ly4qebR/7gfUs9y2IoaVEyog==",
       "cpu": [
         "loong64"
       ],
@@ -953,9 +953,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-ppc64-gnu": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.59.0.tgz",
-      "integrity": "sha512-sw1o3tfyk12k3OEpRddF68a1unZ5VCN7zoTNtSn2KndUE+ea3m3ROOKRCZxEpmT9nsGnogpFP9x6mnLTCaoLkA==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.60.0.tgz",
+      "integrity": "sha512-RwpnLsqC8qbS8z1H1AxBA1H6qknR4YpPR9w2XX0vo2Sz10miu57PkNcnHVaZkbqyw/kUWfKMI73jhmfi9BRMUQ==",
       "cpu": [
         "ppc64"
       ],
@@ -967,9 +967,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-ppc64-musl": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.59.0.tgz",
-      "integrity": "sha512-+2kLtQ4xT3AiIxkzFVFXfsmlZiG5FXYW7ZyIIvGA7Bdeuh9Z0aN4hVyXS/G1E9bTP/vqszNIN/pUKCk/BTHsKA==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.60.0.tgz",
+      "integrity": "sha512-Z8pPf54Ly3aqtdWC3G4rFigZgNvd+qJlOE52fmko3KST9SoGfAdSRCwyoyG05q1HrrAblLbk1/PSIV+80/pxLg==",
       "cpu": [
         "ppc64"
       ],
@@ -981,9 +981,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-riscv64-gnu": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.59.0.tgz",
-      "integrity": "sha512-NDYMpsXYJJaj+I7UdwIuHHNxXZ/b/N2hR15NyH3m2qAtb/hHPA4g4SuuvrdxetTdndfj9b1WOmy73kcPRoERUg==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.60.0.tgz",
+      "integrity": "sha512-3a3qQustp3COCGvnP4SvrMHnPQ9d1vzCakQVRTliaz8cIp/wULGjiGpbcqrkv0WrHTEp8bQD/B3HBjzujVWLOA==",
       "cpu": [
         "riscv64"
       ],
@@ -995,9 +995,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-riscv64-musl": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.59.0.tgz",
-      "integrity": "sha512-nLckB8WOqHIf1bhymk+oHxvM9D3tyPndZH8i8+35p/1YiVoVswPid2yLzgX7ZJP0KQvnkhM4H6QZ5m0LzbyIAg==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.60.0.tgz",
+      "integrity": "sha512-pjZDsVH/1VsghMJ2/kAaxt6dL0psT6ZexQVrijczOf+PeP2BUqTHYejk3l6TlPRydggINOeNRhvpLa0AYpCWSQ==",
       "cpu": [
         "riscv64"
       ],
@@ -1009,9 +1009,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-s390x-gnu": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.59.0.tgz",
-      "integrity": "sha512-oF87Ie3uAIvORFBpwnCvUzdeYUqi2wY6jRFWJAy1qus/udHFYIkplYRW+wo+GRUP4sKzYdmE1Y3+rY5Gc4ZO+w==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.60.0.tgz",
+      "integrity": "sha512-3ObQs0BhvPgiUVZrN7gqCSvmFuMWvWvsjG5ayJ3Lraqv+2KhOsp+pUbigqbeWqueGIsnn+09HBw27rJ+gYK4VQ==",
       "cpu": [
         "s390x"
       ],
@@ -1023,9 +1023,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-x64-gnu": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.59.0.tgz",
-      "integrity": "sha512-3AHmtQq/ppNuUspKAlvA8HtLybkDflkMuLK4DPo77DfthRb71V84/c4MlWJXixZz4uruIH4uaa07IqoAkG64fg==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.60.0.tgz",
+      "integrity": "sha512-EtylprDtQPdS5rXvAayrNDYoJhIz1/vzN2fEubo3yLE7tfAw+948dO0g4M0vkTVFhKojnF+n6C8bDNe+gDRdTg==",
       "cpu": [
         "x64"
       ],
@@ -1037,9 +1037,9 @@
       ]
     },
     "node_modules/@rollup/rollup-linux-x64-musl": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.59.0.tgz",
-      "integrity": "sha512-2UdiwS/9cTAx7qIUZB/fWtToJwvt0Vbo0zmnYt7ED35KPg13Q0ym1g442THLC7VyI6JfYTP4PiSOWyoMdV2/xg==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.60.0.tgz",
+      "integrity": "sha512-k09oiRCi/bHU9UVFqD17r3eJR9bn03TyKraCrlz5ULFJGdJGi7VOmm9jl44vOJvRJ6P7WuBi/s2A97LxxHGIdw==",
       "cpu": [
         "x64"
       ],
@@ -1051,9 +1051,9 @@
       ]
     },
     "node_modules/@rollup/rollup-openbsd-x64": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.59.0.tgz",
-      "integrity": "sha512-M3bLRAVk6GOwFlPTIxVBSYKUaqfLrn8l0psKinkCFxl4lQvOSz8ZrKDz2gxcBwHFpci0B6rttydI4IpS4IS/jQ==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.60.0.tgz",
+      "integrity": "sha512-1o/0/pIhozoSaDJoDcec+IVLbnRtQmHwPV730+AOD29lHEEo4F5BEUB24H0OBdhbBBDwIOSuf7vgg0Ywxdfiiw==",
       "cpu": [
         "x64"
       ],
@@ -1065,9 +1065,9 @@
       ]
     },
     "node_modules/@rollup/rollup-openharmony-arm64": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.59.0.tgz",
-      "integrity": "sha512-tt9KBJqaqp5i5HUZzoafHZX8b5Q2Fe7UjYERADll83O4fGqJ49O1FsL6LpdzVFQcpwvnyd0i+K/VSwu/o/nWlA==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.60.0.tgz",
+      "integrity": "sha512-pESDkos/PDzYwtyzB5p/UoNU/8fJo68vcXM9ZW2V0kjYayj1KaaUfi1NmTUTUpMn4UhU4gTuK8gIaFO4UGuMbA==",
       "cpu": [
         "arm64"
       ],
@@ -1079,9 +1079,9 @@
       ]
     },
     "node_modules/@rollup/rollup-win32-arm64-msvc": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.59.0.tgz",
-      "integrity": "sha512-V5B6mG7OrGTwnxaNUzZTDTjDS7F75PO1ae6MJYdiMu60sq0CqN5CVeVsbhPxalupvTX8gXVSU9gq+Rx1/hvu6A==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.60.0.tgz",
+      "integrity": "sha512-hj1wFStD7B1YBeYmvY+lWXZ7ey73YGPcViMShYikqKT1GtstIKQAtfUI6yrzPjAy/O7pO0VLXGmUVWXQMaYgTQ==",
       "cpu": [
         "arm64"
       ],
@@ -1093,9 +1093,9 @@
       ]
     },
     "node_modules/@rollup/rollup-win32-ia32-msvc": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.59.0.tgz",
-      "integrity": "sha512-UKFMHPuM9R0iBegwzKF4y0C4J9u8C6MEJgFuXTBerMk7EJ92GFVFYBfOZaSGLu6COf7FxpQNqhNS4c4icUPqxA==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.60.0.tgz",
+      "integrity": "sha512-SyaIPFoxmUPlNDq5EHkTbiKzmSEmq/gOYFI/3HHJ8iS/v1mbugVa7dXUzcJGQfoytp9DJFLhHH4U3/eTy2Bq4w==",
       "cpu": [
         "ia32"
       ],
@@ -1107,9 +1107,9 @@
       ]
     },
     "node_modules/@rollup/rollup-win32-x64-gnu": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.59.0.tgz",
-      "integrity": "sha512-laBkYlSS1n2L8fSo1thDNGrCTQMmxjYY5G0WFWjFFYZkKPjsMBsgJfGf4TLxXrF6RyhI60L8TMOjBMvXiTcxeA==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.60.0.tgz",
+      "integrity": "sha512-RdcryEfzZr+lAr5kRm2ucN9aVlCCa2QNq4hXelZxb8GG0NJSazq44Z3PCCc8wISRuCVnGs0lQJVX5Vp6fKA+IA==",
       "cpu": [
         "x64"
       ],
@@ -1121,9 +1121,9 @@
       ]
     },
     "node_modules/@rollup/rollup-win32-x64-msvc": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.59.0.tgz",
-      "integrity": "sha512-2HRCml6OztYXyJXAvdDXPKcawukWY2GpR5/nxKp4iBgiO3wcoEGkAaqctIbZcNB6KlUQBIqt8VYkNSj2397EfA==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.60.0.tgz",
+      "integrity": "sha512-PrsWNQ8BuE00O3Xsx3ALh2Df8fAj9+cvvX9AIA6o4KpATR98c9mud4XtDWVvsEuyia5U4tVSTKygawyJkjm60w==",
       "cpu": [
         "x64"
       ],
@@ -1222,9 +1222,9 @@
       "license": "MIT"
     },
     "node_modules/@types/debug": {
-      "version": "4.1.12",
-      "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.12.tgz",
-      "integrity": "sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ==",
+      "version": "4.1.13",
+      "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.13.tgz",
+      "integrity": "sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -3159,9 +3159,9 @@
       "license": "MIT"
     },
     "node_modules/rollup": {
-      "version": "4.59.0",
-      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.59.0.tgz",
-      "integrity": "sha512-2oMpl67a3zCH9H79LeMcbDhXW/UmWG/y2zuqnF2jQq5uq9TbM9TVyXvA4+t+ne2IIkBdrLpAaRQAvo7YI/Yyeg==",
+      "version": "4.60.0",
+      "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.60.0.tgz",
+      "integrity": "sha512-yqjxruMGBQJ2gG4HtjZtAfXArHomazDHoFwFFmZZl0r7Pdo7qCIXKqKHZc8yeoMgzJJ+pO6pEEHa+V7uzWlrAQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -3175,31 +3175,31 @@
         "npm": ">=8.0.0"
       },
       "optionalDependencies": {
-        "@rollup/rollup-android-arm-eabi": "4.59.0",
-        "@rollup/rollup-android-arm64": "4.59.0",
-        "@rollup/rollup-darwin-arm64": "4.59.0",
-        "@rollup/rollup-darwin-x64": "4.59.0",
-        "@rollup/rollup-freebsd-arm64": "4.59.0",
-        "@rollup/rollup-freebsd-x64": "4.59.0",
-        "@rollup/rollup-linux-arm-gnueabihf": "4.59.0",
-        "@rollup/rollup-linux-arm-musleabihf": "4.59.0",
-        "@rollup/rollup-linux-arm64-gnu": "4.59.0",
-        "@rollup/rollup-linux-arm64-musl": "4.59.0",
-        "@rollup/rollup-linux-loong64-gnu": "4.59.0",
-        "@rollup/rollup-linux-loong64-musl": "4.59.0",
-        "@rollup/rollup-linux-ppc64-gnu": "4.59.0",
-        "@rollup/rollup-linux-ppc64-musl": "4.59.0",
-        "@rollup/rollup-linux-riscv64-gnu": "4.59.0",
-        "@rollup/rollup-linux-riscv64-musl": "4.59.0",
-        "@rollup/rollup-linux-s390x-gnu": "4.59.0",
-        "@rollup/rollup-linux-x64-gnu": "4.59.0",
-        "@rollup/rollup-linux-x64-musl": "4.59.0",
-        "@rollup/rollup-openbsd-x64": "4.59.0",
-        "@rollup/rollup-openharmony-arm64": "4.59.0",
-        "@rollup/rollup-win32-arm64-msvc": "4.59.0",
-        "@rollup/rollup-win32-ia32-msvc": "4.59.0",
-        "@rollup/rollup-win32-x64-gnu": "4.59.0",
-        "@rollup/rollup-win32-x64-msvc": "4.59.0",
+        "@rollup/rollup-android-arm-eabi": "4.60.0",
+        "@rollup/rollup-android-arm64": "4.60.0",
+        "@rollup/rollup-darwin-arm64": "4.60.0",
+        "@rollup/rollup-darwin-x64": "4.60.0",
+        "@rollup/rollup-freebsd-arm64": "4.60.0",
+        "@rollup/rollup-freebsd-x64": "4.60.0",
+        "@rollup/rollup-linux-arm-gnueabihf": "4.60.0",
+        "@rollup/rollup-linux-arm-musleabihf": "4.60.0",
+        "@rollup/rollup-linux-arm64-gnu": "4.60.0",
+        "@rollup/rollup-linux-arm64-musl": "4.60.0",
+        "@rollup/rollup-linux-loong64-gnu": "4.60.0",
+        "@rollup/rollup-linux-loong64-musl": "4.60.0",
+        "@rollup/rollup-linux-ppc64-gnu": "4.60.0",
+        "@rollup/rollup-linux-ppc64-musl": "4.60.0",
+        "@rollup/rollup-linux-riscv64-gnu": "4.60.0",
+        "@rollup/rollup-linux-riscv64-musl": "4.60.0",
+        "@rollup/rollup-linux-s390x-gnu": "4.60.0",
+        "@rollup/rollup-linux-x64-gnu": "4.60.0",
+        "@rollup/rollup-linux-x64-musl": "4.60.0",
+        "@rollup/rollup-openbsd-x64": "4.60.0",
+        "@rollup/rollup-openharmony-arm64": "4.60.0",
+        "@rollup/rollup-win32-arm64-msvc": "4.60.0",
+        "@rollup/rollup-win32-ia32-msvc": "4.60.0",
+        "@rollup/rollup-win32-x64-gnu": "4.60.0",
+        "@rollup/rollup-win32-x64-msvc": "4.60.0",
         "fsevents": "~2.3.2"
       }
     },
@@ -3631,26 +3631,29 @@
       }
     },
     "node_modules/vitepress-plugin-llms": {
-      "version": "1.11.0",
-      "resolved": "https://registry.npmjs.org/vitepress-plugin-llms/-/vitepress-plugin-llms-1.11.0.tgz",
-      "integrity": "sha512-n6fjWzBNKy40p8cij+d2cHiC2asNW1eQKdmc06gX9VAv7vWppIoVLH/f7Ht1bK0vSpGzzW2QimvNfbfv1oCdJw==",
+      "version": "1.12.0",
+      "resolved": "https://registry.npmjs.org/vitepress-plugin-llms/-/vitepress-plugin-llms-1.12.0.tgz",
+      "integrity": "sha512-zuzL7a8UJuGl46le5cAy/QxKMGlpSylcsLjDDn6BYPc1u+eP3nzoQk9ne9XFBqrE7exoJlIYJELVN8HMgYlFKQ==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
         "gray-matter": "^4.0.3",
         "markdown-it": "^14.1.0",
         "markdown-title": "^1.0.2",
-        "mdast-util-from-markdown": "^2.0.2",
+        "mdast-util-from-markdown": "^2.0.3",
         "millify": "^6.1.0",
-        "minimatch": "^10.1.1",
+        "minimatch": "^10.2.4",
         "path-to-regexp": "^6.3.0",
         "picocolors": "^1.1.1",
         "pretty-bytes": "^7.1.0",
         "remark": "^15.0.1",
         "remark-frontmatter": "^5.0.0",
-        "tokenx": "^1.2.1",
+        "tokenx": "^1.3.0",
         "unist-util-remove": "^4.0.0",
-        "unist-util-visit": "^5.0.0"
+        "unist-util-visit": "^5.1.0"
+      },
+      "engines": {
+        "node": ">=18.0.0"
       },
       "funding": {
         "url": "https://github.com/sponsors/okineadev"

package/docs/package.json

@@ -9,6 +9,6 @@
   },
   "devDependencies": {
     "vitepress": "1.6.4",
-    "vitepress-plugin-llms": "1.11.0"
+    "vitepress-plugin-llms": "1.12.0"
   }
 }

package/{context7.json → docs/public/context7.json}

@@ -3,5 +3,7 @@
   "description": "Type-safe PostgreSQL ORM for Node.js/TypeScript with fluent query builder, decorator-based models, and immutable query state.",
   "folders": ["docs/", "src/", "README.md"],
   "excludeFolders": ["internal/", "tests/", "node_modules/"],
-  "excludeFiles": ["*.test.ts", "*.spec.ts"]
+  "excludeFiles": ["*.test.ts", "*.spec.ts"],
+  "url": "https://context7.com/websites/bigalorm_github_io_bigal",
+  "public_key": "pk_zVEcoyB1XDzPT2mrbBDG3"
 }

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.5",
   "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",
@@ -48,22 +48,23 @@
     "@semantic-release/npm": "13.1.5",
     "@semantic-release/release-notes-generator": "14.1.0",
     "@types/node": ">=22",
-    "@typescript/native-preview": "7.0.0-dev.20260312.1",
+    "@typescript/native-preview": "7.0.0-dev.20260322.1",
+    "conventional-changelog-conventionalcommits": "9.3.0",
     "eslint-plugin-vitest": "0.5.4",
     "husky": "9.1.7",
-    "lint-staged": "16.3.3",
+    "lint-staged": "16.4.0",
     "markdownlint-cli": "0.48.0",
     "npm-run-all2": "8.0.4",
-    "oxfmt": "0.39.0",
-    "oxlint": "1.54.0",
-    "oxlint-tsgolint": "0.16.0",
+    "oxfmt": "0.41.0",
+    "oxlint": "1.56.0",
+    "oxlint-tsgolint": "0.17.1",
     "pinst": "3.0.0",
     "postgres-pool": "11.0.4",
     "semantic-release": "25.0.3",
     "strict-event-emitter-types": "2.0.0",
     "typescript": "5.9.3",
     "unbuild": "3.6.1",
-    "vitest": "4.0.18"
+    "vitest": "4.1.0"
   },
   "scripts": {
     "build": "unbuild",

package/release.config.mjs

@@ -10,23 +10,26 @@ export default {
     [
       '@semantic-release/commit-analyzer',
       {
-        preset: 'angular',
+        preset: 'conventionalcommits',
         releaseRules: [
-          { type: 'docs', release: 'patch' },
+          { breaking: true, release: 'major' },
+          { revert: true, release: 'patch' },
+          { type: 'docs', release: false },
           { type: 'feat', release: 'minor' },
           { type: 'fix', release: 'patch' },
           { type: 'test', release: 'patch' },
           { type: 'chore', release: 'patch' },
           { type: 'chore', scope: 'deps', release: false },
+          { type: 'chore', scope: 'docs', release: false },
         ],
-        parserOpts: {
-          // eslint-disable-next-line security/detect-unsafe-regex
-          headerPattern: /^(\w+)(?:\(([^)]+)\))?: (.+)$/,
-          headerCorrespondence: ['type', 'scope', 'subject'],
-        },
       },
     ],
-    '@semantic-release/release-notes-generator',
+    [
+      '@semantic-release/release-notes-generator',
+      {
+        preset: 'conventionalcommits',
+      },
+    ],
     [
       '@semantic-release/changelog',
       {

package/.agents/skills/enforcing-typescript-standards/SKILL.md

@@ -1,412 +0,0 @@
----
-name: enforcing-typescript-standards
-description: Enforces the project's core TypeScript standards including explicit typing, import organization, class member ordering, and code safety rules. ALWAYS apply when creating, modifying, or reviewing any TypeScript (.ts/.tsx) file.
----
-
-# Enforcing TypeScript Standards
-
-Enforces the project's core TypeScript standards including explicit typing, import organization, class member ordering, and code safety rules.
-
-## Triggers
-
-Activate this skill when the user says or implies any of these:
-
-- "write", "create", "implement", "add", "build" (new TypeScript code)
-- "fix", "update", "change", "modify", "refactor" (existing TypeScript code)
-- "review", "check", "improve", "clean up" (code quality)
-- Any request involving `.ts` or `.tsx` files
-
-Specific triggers:
-
-- Creating a new `.ts` or `.tsx` file
-- Modifying existing TypeScript code
-- Reviewing TypeScript code for compliance
-
-## Core Standards
-
-### Type Safety
-
-- **Explicit return types**: Prefer explicit return types when practical; omit when inference is obvious and adds no clarity
-- **Explicit member accessibility**: Class members require `public`, `private`, or `protected`
-- **Type-only imports**: Use `import type` for types: `import type { Foo } from './foo.js'`
-- **Sorted type constituents**: Union/intersection types must be alphabetically sorted
-- **Only throw Error objects**: Never throw strings or other primitives
-- **Avoid `any` and type assertions**: Prefer proper typing over `any` or `as` casts; use them only when truly necessary
-- **Type JSON fields explicitly**: Use `Record<string, unknown>` or specific interfaces for JSON data, never `any`
-- **Use Number() for conversion**: Prefer `Number(value)` over `parseInt(value, 10)` or `parseFloat(value)`
-- **Reuse existing types**: Before defining a new interface, search for existing types that can be reused directly, extended, or derived using `Pick`, `Omit`, `Partial`, or other utility types
-
-#### Alternatives to Type Assertions
-
-Before using `as`, try these approaches in order:
-
-1. Proper typing at the source
-2. Type guards (`typeof`, `instanceof`)
-3. Type narrowing through control flow
-4. Custom type predicate functions
-5. Discriminated unions
-
-```ts
-// Bad
-const user = data as User;
-
-// Good
-function isUser(data: unknown): data is User {
-  return typeof data === 'object' && data !== null && 'id' in data;
-}
-if (isUser(data)) {
-  // data is now typed as User
-}
-```
-
-### Import Organization
-
-- **Import order**: built-in → external → internal → parent → sibling → index (alphabetized within groups)
-- **No duplicate imports**: Consolidate imports from the same module
-- **Newline after imports**: Empty line required after import block
-
-### Class Member Ordering
-
-1. Signatures (call/construct)
-2. Fields: private → public → protected
-3. Constructors: public → protected → private
-4. Methods: public → protected → private
-
-### Code Style
-
-- **Simplicity over cleverness**: Straightforward, readable code is better than clever one-liners
-- **Early returns**: Use guard clauses to reduce nesting; return early for edge cases
-- **Nullish coalescing**: Prefer `??` over `||` for defaults (avoids false positives on `0` or `''`)
-- **Optional chaining**: Use `?.` for safe property access
-- **Match existing patterns**: Follow conventions already established in the codebase
-- **Meaningful identifiers**: Names must be descriptive (exceptions: `_`, `i`, `j`, `k`, `e`, `x`, `y`)
-- **Function declarations**: Use `function foo()` not `const foo = function()`
-- **Prefer const**: Use `const` unless reassignment is needed
-- **No var**: Always use `const` or `let`
-- **Object shorthand**: Use `{ foo }` not `{ foo: foo }`
-- **Template literals**: Use `` `Hello ${name}` `` not `'Hello ' + name`
-- **Strict equality**: Use `===` except for null comparisons
-- **One class per file**: Maximum one class definition per file
-- **Avoid `reduce`**: Prefer `for...of` loops or other array methods for clarity
-- **Functions over classes**: Prefer exported functions over classes with static methods (unless state is needed)
-- **No nested functions**: Define helper functions at module level, not inside other functions
-- **Immutability**: Create new objects/arrays instead of mutating existing ones
-
-### Naming Conventions
-
-- **Enum members**: Use `PascalCase` (e.g., `MyValue`)
-- **No trailing underscores**: Identifiers cannot end with `_`
-
-### Comments
-
-- **No redundant comments**: Never comment what the code already expresses clearly
-- **No duplicate comments**: Don't repeat information from function names, types, or nearby comments
-- **Meaningful only**: Only add comments to explain _why_, not _what_ — the code shows what it does
-
-### Boolean Expressions
-
-- **Prefer truthiness checks**: Use implicit truthy/falsy checks over explicit comparisons
-- **Exception**: Use explicit checks when distinguishing `0`/`''` (valid values) from `null`/`undefined` is semantically important
-
-### Testing
-
-- **Minimize mocking**: Avoid mocking everything; use real implementations and data generators when available
-- **Test real behavior**: Testing mocks provides little value — test actual code paths
-- **Don't be lazy**: Write thorough tests that cover edge cases, not just happy paths
-
-### Error Handling
-
-- **Specific error types**: Prefer specific error types over generic `Error` when meaningful
-- **Avoid silent failures**: Don't swallow errors with empty catch blocks
-- **Handle rejections**: Always handle promise rejections
-- **Let errors propagate**: Don't catch errors just to re-throw or log — let them bubble up to error handlers
-
-## Negative Knowledge
-
-Avoid these antipatterns:
-
-- `console.log()` statements in production code
-- `eval()` or `Function()` constructor
-- Nested ternary operators
-- `await` inside loops when `Promise.all` would be simpler (sequential awaits are fine when order matters or parallelism adds complexity)
-- Empty interfaces
-- Variable shadowing
-- Functions defined inside loops
-- `@ts-ignore` without explanation (use `@ts-expect-error` with 10+ char description)
-- Comments that restate the code: `// increment counter` above `counter++`
-- Comments that duplicate type information: `// returns a string` when return type is `: string`
-- Commented-out code (delete it; use version control)
-- Verbose boolean comparisons: `arr.length > 0`, `str !== ''`, `obj !== null && obj !== undefined`
-- Disabling linter rules via comments (fix the code instead)
-- Overuse of `any` type or `as` type assertions
-- Over-mocking in tests instead of using real implementations or data generators
-- Empty catch blocks that silently swallow errors
-- Using `||` for defaults when `??` is more appropriate
-- Deep nesting when early returns would simplify
-- Catching errors just to re-throw or log them
-- Nested function definitions inside other functions
-- Mutating objects/arrays instead of creating new ones
-- TOCTOU: Checking file/resource existence before operating (try and handle errors instead)
-- Classes with only static methods (use plain functions instead)
-- Duplicating existing interfaces instead of reusing or deriving with `Pick`/`Omit`/`Partial`
-
-## Verification Workflow
-
-1. **Analyze**: Compare the code change against these TypeScript standards
-2. **Generate/Refactor**: Write or modify code to comply with all rules above
-3. **Simplify**: Review for opportunities to simplify — prefer clear, straightforward code over clever solutions
-4. **Review naming**: Verify variable and function names still make sense in context after changes
-5. **Build**: Verify types compile without errors (e.g., `npm run build` or `npx tsc --noEmit`)
-6. **Lint**: Run `npm run lint` to confirm compliance before completing the task
-
-## Examples
-
-### Comments Examples
-
-```ts
-// Standard
-// Retry with exponential backoff to handle transient network failures
-async function fetchWithRetry(url: string, attempts = 3): Promise<Response> {
-  for (let i = 0; i < attempts; i++) {
-    try {
-      return await fetch(url);
-    } catch {
-      await sleep(2 ** i * 100);
-    }
-  }
-  throw new Error(`Failed after ${attempts} attempts`);
-}
-
-// Non-Standard
-/**
- * Fetches data from a URL with retry logic
- * @param url - The URL to fetch from
- * @param attempts - Number of attempts (default 3)
- * @returns A Promise that resolves to a Response
- */
-async function fetchWithRetry(url: string, attempts = 3): Promise<Response> {
-  // Loop through attempts
-  for (let i = 0; i < attempts; i++) {
-    try {
-      // Try to fetch the URL
-      return await fetch(url);
-    } catch {
-      // Wait before retrying
-      await sleep(2 ** i * 100);
-    }
-  }
-  // Throw error if all attempts fail
-  throw new Error(`Failed after ${attempts} attempts`);
-}
-```
-
-### Boolean Expressions Examples
-
-```ts
-// Standard
-if (myArray.length) {
-}
-if (myString) {
-}
-if (myObject) {
-}
-if (!value) {
-}
-
-// Non-Standard
-if (myArray.length !== 0) {
-}
-if (myArray.length > 0) {
-}
-if (myString !== '') {
-}
-if (myObject !== null && myObject !== undefined) {
-}
-if (value === null || value === undefined) {
-}
-```
-
-### Early Return Examples
-
-```ts
-// Standard
-function processUser(user: User | null): Result {
-  if (!user) {
-    return { error: 'No user provided' };
-  }
-  if (!user.isActive) {
-    return { error: 'User is inactive' };
-  }
-  return { data: transform(user) };
-}
-
-// Non-Standard
-function processUser(user: User | null): Result {
-  if (user) {
-    if (user.isActive) {
-      return { data: transform(user) };
-    } else {
-      return { error: 'User is inactive' };
-    }
-  } else {
-    return { error: 'No user provided' };
-  }
-}
-```
-
-### Functions Over Classes Examples
-
-```ts
-// Standard
-export function calculateTotal(items: Item[]): number {
-  return items.reduce((sum, item) => sum + item.price, 0);
-}
-
-export function formatCurrency(amount: number): string {
-  return `$${amount.toFixed(2)}`;
-}
-
-// Non-Standard
-export class Calculator {
-  static calculateTotal(items: Item[]): number {
-    return items.reduce((sum, item) => sum + item.price, 0);
-  }
-
-  static formatCurrency(amount: number): string {
-    return `$${amount.toFixed(2)}`;
-  }
-}
-```
-
-### No Nested Functions Examples
-
-```ts
-// Standard
-function transformItem(item: Item): TransformedItem {
-  return { id: item.id, name: item.name.toUpperCase() };
-}
-
-async function processItems(items: Item[]): Promise<TransformedItem[]> {
-  return items.map(transformItem);
-}
-
-// Non-Standard
-async function processItems(items: Item[]): Promise<TransformedItem[]> {
-  function transformItem(item: Item): TransformedItem {
-    return { id: item.id, name: item.name.toUpperCase() };
-  }
-  return items.map(transformItem);
-}
-```
-
-### Immutability Examples
-
-```ts
-// Standard
-function addItem(items: Item[], newItem: Item): Item[] {
-  return [...items, newItem];
-}
-
-function removeItem(items: Item[], id: string): Item[] {
-  return items.filter((item) => item.id !== id);
-}
-
-function updateItem(items: Item[], id: string, updates: Partial<Item>): Item[] {
-  return items.map((item) => (item.id === id ? { ...item, ...updates } : item));
-}
-
-// Non-Standard
-function addItem(items: Item[], newItem: Item): Item[] {
-  items.push(newItem);
-  return items;
-}
-
-function removeItem(items: Item[], id: string): Item[] {
-  const index = items.findIndex((item) => item.id === id);
-  items.splice(index, 1);
-  return items;
-}
-```
-
-### Error Propagation Examples
-
-```ts
-// Standard
-async function getUser(id: string): Promise<User> {
-  return userService.findById(id);
-}
-
-// Non-Standard
-async function getUser(id: string): Promise<User> {
-  try {
-    return await userService.findById(id);
-  } catch (error) {
-    console.error(error);
-    throw error;
-  }
-}
-```
-
-### TOCTOU Examples
-
-```ts
-// Standard
-async function readConfig(path: string): Promise<Config> {
-  try {
-    const content = await readFile(path, 'utf-8');
-    return JSON.parse(content);
-  } catch (error) {
-    if (isNotFoundError(error)) {
-      return defaultConfig;
-    }
-    throw error;
-  }
-}
-
-// Non-Standard
-async function readConfig(path: string): Promise<Config> {
-  if (await fileExists(path)) {
-    const content = await readFile(path, 'utf-8');
-    return JSON.parse(content);
-  }
-  return defaultConfig;
-}
-```
-
-### Type Reuse Examples
-
-```ts
-// Given an existing type
-interface User {
-  id: string;
-  email: string;
-  name: string;
-  passwordHash: string;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-// Standard - derive from existing type
-type PublicUser = Omit<User, 'passwordHash'>;
-type UserSummary = Pick<User, 'id' | 'name'>;
-type UserUpdate = Partial<Pick<User, 'email' | 'name'>>;
-
-// Non-Standard - duplicating fields that already exist
-interface PublicUser {
-  id: string;
-  email: string;
-  name: string;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-interface UserSummary {
-  id: string;
-  name: string;
-}
-
-interface UserUpdate {
-  email?: string;
-  name?: string;
-}
-```