Merge branch 'main' into bucket-priorities-in-yjs

Author: Chriztiaan

.changeset/friendly-chairs-camp.md

@@ -0,0 +1,7 @@
+---
+'@powersync/react-native': patch
+'@powersync/node': patch
+'@powersync/web': patch
+---
+
+Update package description

.changeset/grumpy-panthers-own.md

@@ -0,0 +1,5 @@
+---
+'@powersync/node': patch
+---
+
+Update readme to reflect alpha status.

.changeset/mighty-spies-fail.md

@@ -0,0 +1,5 @@
+---
+'@powersync/node': patch
+---
+
+Update readme to refer to Node.js docs

.changeset/tame-boats-hammer.md

@@ -18,6 +18,10 @@ _[PowerSync](https://www.powersync.com) is a sync engine for building local-firs
 
   - JS Web SDK implementation (extension of `packages/common`)
 
+- [packages/node](./packages/node/README.md)
+
+  - Node.js client implementation (extension of `packages/common`)
+
 - [packages/react](./packages/react/README.md)
 
   - React integration for PowerSync.
@@ -80,6 +84,10 @@ Demo applications are located in the [`demos/`](./demos/) directory. Also see ou
 
 - [demos/example-capacitor](./demos/example-capacitor/README.md) A Capacitor example app using the PowerSync Web SDK.
 
+### Node
+
+- [demos/example-node](./demos/example-node/README.md) A small CLI example built using the PowerSync SDK for Node.js.
+
 ## Tools
 
 - [tools/diagnostics-app](./tools/diagnostics-app): A standalone web app that presents stats about a user's local database (incl. tables and sync buckets).

.changeset/yellow-countries-warn.md

@@ -10,7 +10,7 @@
   "dependencies": {
     "@azure/core-asynciterator-polyfill": "^1.0.2",
     "@expo/vector-icons": "^14.0.0",
-    "@journeyapps/react-native-quick-sqlite": "^2.3.0",
+    "@journeyapps/react-native-quick-sqlite": "^2.4.2",
     "@powersync/common": "workspace:*",
     "@powersync/react": "workspace:*",
     "@powersync/react-native": "workspace:*",

README.md

@@ -0,0 +1,2 @@
+BACKEND=http://localhost:6060
+SYNC_SERVICE=http://localhost:8080

demos/django-react-native-todolist/package.json

@@ -0,0 +1,16 @@
+## Node.js Demo
+
+This demonstrates a small Node.js client opening a database and connecting PowerSync.
+
+This demo is configured to talk to an example backend [you can host yourself](https://github.com/powersync-ja/self-host-demo). To get started:
+
+1. Start one of the Node.js backend examples from [the self-host-demo repository](https://github.com/powersync-ja/self-host-demo).
+2. If necessary, change `.env` to point to the started backend and sync service.
+3. Run `pnpm install` and `pnpm build:packages` in the root of this repo.
+4. In this directory, run `pnpm run start`.
+
+This opens the local database, connects to PowerSync, waits for a first sync and then runs a simple query.
+Results from the query are printed every time it changes. Try:
+
+1. Updating a row in the backend database and see changes reflected in the running client.
+2. Enter `add('my list')` and see the new list show up in the backend database.

demos/example-node/.env

@@ -0,0 +1,20 @@
+{
+  "name": "example-node",
+  "version": "1.0.0",
+  "description": "",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "build": "tsc -b",
+    "watch": "tsc -b -w",
+    "start": "node --loader ts-node/esm -r dotenv/config src/main.ts"
+  },
+  "dependencies": {
+    "@powersync/node": "workspace:*",
+    "dotenv": "^16.4.7"
+  },
+  "devDependencies": {
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.2"
+  }
+}