Pull from master

Author: ox-harris

.github/workflows/publish 2.yml

@@ -0,0 +1,48 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: 'https://registry.npmjs.org/'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Determine npm tag
+        id: tag
+        run: |
+          # Extract tag name without "refs/tags/"
+          TAG_REF=${GITHUB_REF#refs/tags/}
+          echo "Detected Git tag: $TAG_REF"
+
+          # Determine npm tag
+          if [[ "$TAG_REF" == *-* ]]; then
+            # prerelease (contains a hyphen)
+            NPM_TAG=$(echo "$TAG_REF" | sed -E 's/^v[0-9]+\.[0-9]+\.[0-9]+-([a-zA-Z0-9]+).*/\1/')
+          else
+            NPM_TAG="latest"
+          fi
+          echo "npm publish will use tag: $NPM_TAG"
+          echo "tag=$NPM_TAG" >> $GITHUB_OUTPUT
+
+      - name: Publish to npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --tag ${{ steps.tag.outputs.tag }}

README.md

@@ -23,7 +23,7 @@ _A modern take on SQL and SQL databases_
 
 Try an advanced form of SQL right on your database.<br>
 **LinkedQL** is a database client (`client.query()`) that solves the modern database capability problem in a single interface — and in under `80 KiB min | zip`.<br>
-Relationships • JSON • Reactivity • Versioning • Offline → **SOLVED**
+Relationships • JSON • Schema • Reactivity • Versioning • Offline → **SOLVED**
 
 </div>
 
@@ -78,10 +78,10 @@ For PostgreSQL, MySQL, and MariaDB, it adapts seamlessly to each database throug
 
 | **Dialect**         | **Package**                    | **Docs**                                                                                   |
 | :------------------ | :----------------------------- | :----------------------------------------------------------------------------------------- |
-| PostgreSQL          | `@linked-db/linked-ql/pg`      | [Read → PG Docs](https://linked-db.github.io/linked-ql/entry/clients#11--postgresql)   |
-| MySQL               | `@linked-db/linked-ql/mysql`   | [Read → MySQL Docs](https://linked-db.github.io/linked-ql/entry/clients#12--mysql)     |
-| MariaDB             | `@linked-db/linked-ql/mariadb` | [Read → MariaDB Docs](https://linked-db.github.io/linked-ql/entry/clients#13--mariadb) |
-| FlashQL (In-Memory) | `@linked-db/linked-ql/flash`   | [Read → FlashQL Docs](https://linked-db.github.io/linked-ql/entry/clients#14--flashql) |
+| PostgreSQL          | `@linked-db/linked-ql/pg`      | [Read → PG Docs](https://linked-ql.netlify.app/docs/setup#postgresql)   |
+| MySQL               | `@linked-db/linked-ql/mysql`   | [Read → MySQL Docs](https://linked-ql.netlify.app/docs/setup#mysql)     |
+| MariaDB             | `@linked-db/linked-ql/mariadb` | [Read → MariaDB Docs](https://linked-ql.netlify.app/docs/setup#mariadb) |
+| FlashQL (In-Memory) | `@linked-db/linked-ql/flash`   | [Read → FlashQL Docs](https://linked-ql.netlify.app/docs/setup#flashql) |
 
 ---
 
@@ -121,9 +121,9 @@ LinkedQL automatically compiles your query down to the SQL your database underst
 
 | **Feature**       | **Summary**                                                                     | **Docs**                                                                          |
 | :---------------- | :------------------------------------------------------------------------------ | :-------------------------------------------------------------------------------- |
-| **DeepRefs**      | Follow relationships using simple arrow notation (`a ~> b ~> c`).               | [Read → DeepRefs Docs](https://linked-db.github.io/linked-ql/lang/deeprefs)      |
-| **JSON Literals** | Model JSON shapes directly in SQL using JSON literals (`{}`, `[]`).             | [Read → JSON Docs](https://linked-db.github.io/linked-ql/lang/json-literals)     |
-| **UPSERTS**       | Perform insert-or-update operations with a literal `UPSERT` statement.          | [Read → UPSERTS Docs](https://linked-db.github.io/linked-ql/lang/upsert)        |
+| **DeepRefs**      | Follow relationships using simple arrow notation (`a ~> b ~> c`).               | [Read → DeepRefs Docs](https://linked-ql.netlify.app/docs/capabilities/deeprefs)      |
+| **JSON Literals** | Model JSON shapes directly in SQL using JSON literals (`{}`, `[]`).             | [Read → JSON Docs](https://linked-ql.netlify.app/docs/capabilities/json-literals)     |
+| **UPSERTS**       | Perform insert-or-update operations with a literal `UPSERT` statement.          | [Read → UPSERTS Docs](https://linked-ql.netlify.app/docs/capabilities/upsert)        |
 
 ### Examples
 
@@ -194,7 +194,7 @@ Modern apps and modern workflows — solved.
 
 | **Feature**         | **Summary**                                                                                         | **Docs**                                                                           |
 | :------------------ | :-------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------- |
-| **Realtime SQL**    | Run live, self-updating queries right on your database.                                             | [Read → RealtimeSQL Docs](https://linked-db.github.io/linked-ql/proc/realtime-sql) |
+| **Realtime SQL**    | Run live, self-updating queries right on your database.                                             | [Read → RealtimeSQL Docs](https://linked-ql.netlify.app/docs/capabilities/realtime-sql) |
 | **Timeline Engine** | Get automatic database versioning on every DDL operation; bind queries to specific schema versions. | *(Coming soon)*                                                                    |
 
 ### Examples
@@ -271,9 +271,9 @@ It extends that with built-in support for **federation**, **materialization**, a
 
 | **Capability**      | **Summary**                                                  | **Docs**                                                                   |
 | :------------------ | :----------------------------------------------------------- | :------------------------------------------------------------------------- |
-| **Federation**      | Query across remote and local databases as a single surface. | [Read → FlashQL Docs](https://linked-db.github.io/linked-ql/flash#221-query-federation) |
-| **Materialization** | Materialize remote datasets locally for offline queries.     | [Read → FlashQL Docs](https://linked-db.github.io/linked-ql/flash#222-data-materialization) |
-| **Sync**            | Two-way synchronization between local and remote databases.  | [Read → FlashQL Docs](https://linked-db.github.io/linked-ql/flash#223-data-sync) |
+| **Federation**      | Query across remote and local databases as a single surface. | [Read → FlashQL Docs](https://linked-ql.netlify.app/docs/flashql) |
+| **Materialization** | Materialize remote datasets locally for offline queries.     | [Read → FlashQL Docs](https://linked-ql.netlify.app/docs/flashql) |
+| **Sync**            | Two-way synchronization between local and remote databases.  | [Read → FlashQL Docs](https://linked-ql.netlify.app/docs/flashql) |
 
 ### Examples
 
@@ -354,11 +354,11 @@ client.on('sync:change', e => console.log('Δ', e.table, e.type));
 
 | Feature           | Description                                                  | Wiki Page                                                                    |
 | :---------------- | :----------------------------------------------------------- | :--------------------------------------------------------------------------- |
-| **DeepRefs**      | Declarative relationship traversal across foreign keys.      | [DeepRefs →](https://linked-db.github.io/linked-ql/lang/deeprefs)           |
-| **JSON Literals** | Inline JSON modeling syntax — objects, arrays, aggregations. | [JSON Literals →](https://linked-db.github.io/linked-ql/lang/json-literals) |
-| **UPSERTS**       | Simplified `INSERT + UPDATE` hybrid statement.               | [UPSERTS →](https://linked-db.github.io/linked-ql/lang/upsert)              |
-| **RealtimeSQL**   | Live queries powered by the Realtime Engine.                 | [RealtimeSQL →](https://linked-db.github.io/linked-ql/proc/realtime-sql)    |
-| **FlashQL**       | In-memory SQL runtime for offline, edge, and hybrid apps.    | [FlashQL →](https://linked-db.github.io/linked-ql/flash)                    |
+| **DeepRefs**      | Declarative relationship traversal across foreign keys.      | [DeepRefs →](https://linked-ql.netlify.app/docs/capabilities/deeprefs)           |
+| **JSON Literals** | Inline JSON modeling syntax — objects, arrays, aggregations. | [JSON Literals →](https://linked-ql.netlify.app/docs/capabilities/json-literals) |
+| **UPSERTS**       | Simplified `INSERT + UPDATE` hybrid statement.               | [UPSERTS →](https://linked-ql.netlify.app/docs/capabilities/upsert)              |
+| **RealtimeSQL**   | Live queries powered by the Realtime Engine.                 | [RealtimeSQL →](https://linked-ql.netlify.app/docs/capabilities/realtime-sql)    |
+| **FlashQL**       | In-memory SQL runtime for offline, edge, and hybrid apps.    | [FlashQL →](https://linked-ql.netlify.app/docs/flashql)                    |
 
 ---