Merge branch 'main' into 'isolate-demos'

LucDeCaf · LucDeCaf · commit 02677138e80f · 2025-12-11T11:55:16.000+02:00
diff --git a/.changeset/drizzle-driver-reorder-export-attributes.md b/.changeset/drizzle-driver-reorder-export-attributes.md
@@ -0,0 +1,5 @@
+---
+"@powersync/drizzle-driver": patch
+---
+
+Reorder export attributes to prevent "Error: Default condition should be last one".
diff --git a/.changeset/large-ravens-divide.md b/.changeset/large-ravens-divide.md
@@ -0,0 +1,8 @@
+---
+'@powersync/react-native': minor
+'@powersync/common': minor
+'@powersync/node': minor
+'@powersync/web': minor
+---
+
+Update PowerSync SQLite core to v0.4.10
diff --git a/.changeset/quick-lemons-switch.md b/.changeset/quick-lemons-switch.md
@@ -0,0 +1,6 @@
+---
+'@powersync/op-sqlite': patch
+'@powersync/capacitor': patch
+---
+
+Update PowerSync SQLite core to v0.4.10
diff --git a/.changeset/quiet-owls-flash.md b/.changeset/quiet-owls-flash.md
@@ -0,0 +1,20 @@
+---
+'@powersync/react-native': minor
+'@powersync/common': minor
+'@powersync/node': minor
+'@powersync/web': minor
+'@powersync/capacitor': minor
+---
+
+Added ability to specify `appMetadata` for sync/stream requests.
+
+Note: This requires a PowerSync service version `>=1.17.0` in order for logs to display metadata.
+
+```javascript
+powerSync.connect(connector, {
+  // This will be included in PowerSync service logs
+  appMetadata: {
+    app_version: MY_APP_VERSION
+  }
+});
+```
diff --git a/README.md b/README.md
@@ -2,7 +2,7 @@
   <a href="https://www.powersync.com" target="_blank"><img src="https://github.com/powersync-ja/.github/assets/7372448/d2538c43-c1a0-4c47-9a76-41462dba484f"/></a>
 </p>
 
-_[PowerSync](https://www.powersync.com) is a sync engine for building local-first apps with instantly-responsive UI/UX and simplified state transfer. Syncs between SQLite on the client-side and Postgres, MongoDB or MySQL on the server-side._
+_[PowerSync](https://www.powersync.com) is a sync engine for building local-first apps with instantly-responsive UI/UX and simplified state transfer. Syncs between SQLite on the client-side and Postgres, MongoDB, MySQL or SQL Server on the server-side._
 
 # PowerSync JavaScript SDKs
 
diff --git a/demos/django-react-native-todolist/ios/powersyncexample.xcodeproj/project.pbxproj b/demos/django-react-native-todolist/ios/powersyncexample.xcodeproj/project.pbxproj
@@ -300,7 +300,6 @@
 				"${PODS_CONFIGURATION_BUILD_DIR}/React-Core/React-Core_privacy.bundle",
 				"${PODS_CONFIGURATION_BUILD_DIR}/React-cxxreact/React-cxxreact_privacy.bundle",
 				"${PODS_CONFIGURATION_BUILD_DIR}/boost/boost_privacy.bundle",
-				"${PODS_CONFIGURATION_BUILD_DIR}/glog/glog_privacy.bundle",
 			);
 			name = "[CP] Copy Pods Resources";
 			outputPaths = (
@@ -330,7 +329,6 @@
 				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/React-Core_privacy.bundle",
 				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/React-cxxreact_privacy.bundle",
 				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/boost_privacy.bundle",
-				"${TARGET_BUILD_DIR}/${UNLOCALIZED_RESOURCES_FOLDER_PATH}/glog_privacy.bundle",
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 			shellPath = /bin/sh;
diff --git a/demos/example-nextjs/package.json b/demos/example-nextjs/package.json
@@ -14,7 +14,7 @@
     "@emotion/react": "^11.11.4",
     "@emotion/styled": "^11.11.5",
     "@fontsource/roboto": "^5.0.13",
-    "@journeyapps/wa-sqlite": "^1.3.2",
+    "@journeyapps/wa-sqlite": "^1.4.0",
     "@lexical/react": "^0.15.0",
     "@mui/icons-material": "^5.15.18",
     "@mui/material": "^5.15.18",
diff --git a/demos/example-node/src/main.ts b/demos/example-node/src/main.ts
@@ -10,10 +10,9 @@ import {
   SyncStreamConnectionMethod
 } from '@powersync/node';
 import { exit } from 'node:process';
+import { WorkerOpener } from 'node_modules/@powersync/node/src/db/options.js';
 import { AppSchema, DemoConnector } from './powersync.js';
 import { enableUncidiDiagnostics } from './UndiciDiagnostics.js';
-import { WorkerOpener } from 'node_modules/@powersync/node/src/db/options.js';
-import { LockContext } from 'node_modules/@powersync/node/dist/bundle.cjs';
 
 const main = async () => {
   const baseLogger = createBaseLogger();
@@ -59,10 +58,12 @@ const main = async () => {
     logger
   });
   console.log(await db.get('SELECT powersync_rs_version();'));
-
   await db.connect(new DemoConnector(), {
     connectionMethod: SyncStreamConnectionMethod.WEB_SOCKET,
-    clientImplementation: SyncClientImplementation.RUST
+    clientImplementation: SyncClientImplementation.RUST,
+    appMetadata: {
+      app_version: process.env.npm_package_version || 'unknown'
+    }
   });
   // Example using a proxy agent for more control over the connection:
   // const proxyAgent = new (await import('undici')).ProxyAgent({
diff --git a/demos/react-supabase-todolist/src/components/providers/SystemProvider.tsx b/demos/react-supabase-todolist/src/components/providers/SystemProvider.tsx
@@ -7,6 +7,8 @@ import { createBaseLogger, DifferentialWatchedQuery, LogLevel, PowerSyncDatabase
 import React, { Suspense } from 'react';
 import { NavigationPanelContextProvider } from '../navigation/NavigationPanelContext';
 
+declare const APP_VERSION: string;
+
 const SupabaseContext = React.createContext<SupabaseConnector | null>(null);
 export const useSupabase = () => React.useContext(SupabaseContext);
 
@@ -68,7 +70,11 @@ export const SystemProvider = ({ children }: { children: React.ReactNode }) => {
     const l = connector.registerListener({
       initialized: () => {},
       sessionStarted: () => {
-        powerSync.connect(connector);
+        powerSync.connect(connector, {
+          appMetadata: {
+            app_version: APP_VERSION
+          }
+        });
       }
     });
 
diff --git a/demos/react-supabase-todolist/vite.config.mts b/demos/react-supabase-todolist/vite.config.mts
@@ -1,9 +1,9 @@
-import wasm from 'vite-plugin-wasm';
-import topLevelAwait from 'vite-plugin-top-level-await';
 import { fileURLToPath, URL } from 'url';
+import topLevelAwait from 'vite-plugin-top-level-await';
+import wasm from 'vite-plugin-wasm';
 
-import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
+import { defineConfig } from 'vite';
 import { VitePWA } from 'vite-plugin-pwa';
 
 // https://vitejs.dev/config/
@@ -19,6 +19,9 @@ export default defineConfig({
   resolve: {
     alias: [{ find: '@', replacement: fileURLToPath(new URL('./src', import.meta.url)) }]
   },
+  define: {
+    APP_VERSION: JSON.stringify(process.env.npm_package_version)
+  },
   publicDir: '../public',
   envDir: '..', // Use this dir for env vars, not 'src'.
   optimizeDeps: {
diff --git a/packages/adapter-sql-js/package.json b/packages/adapter-sql-js/package.json
@@ -36,7 +36,7 @@
     "async-mutex": "^0.5.0"
   },
   "devDependencies": {
-    "@powersync/sql-js": "0.0.5",
+    "@powersync/sql-js": "0.0.7",
     "@powersync/web": "workspace:*",
     "@rollup/plugin-alias": "^5.1.0",
     "@types/sql.js": "^1.4.9",
diff --git a/packages/capacitor/PowersyncCapacitor.podspec b/packages/capacitor/PowersyncCapacitor.podspec
@@ -23,7 +23,7 @@ Pod::Spec.new do |s|
   s.ios.deployment_target = '14.0'
   s.dependency 'Capacitor'
   s.swift_version = '5.1'
-  s.dependency "powersync-sqlite-core", "~> 0.4.6"
+  s.dependency "powersync-sqlite-core", "~> 0.4.10"
    s.xcconfig = {
     'OTHER_CFLAGS' => '$(inherited) -DSQLITE_DBCONFIG_ENABLE_LOAD_EXTENSION=1',
     'HEADER_SEARCH_PATHS' => '$(inherited) "$(PODS_ROOT)/SQLCipher"'
diff --git a/packages/capacitor/README.md b/packages/capacitor/README.md
@@ -4,7 +4,7 @@
 
 # PowerSync SDK for Capacitor
 
-_[PowerSync](https://www.powersync.com) is a sync engine for building local-first apps with instantly-responsive UI/UX and simplified state transfer. Syncs between SQLite on the client-side and Postgres, MongoDB or MySQL on the server-side._
+_[PowerSync](https://www.powersync.com) is a sync engine for building local-first apps with instantly-responsive UI/UX and simplified state transfer. Syncs between SQLite on the client-side and Postgres, MongoDB, MySQL or SQL Server on the server-side._
 
 This package (`@powersync/capacitor`) is the PowerSync SDK for Capacitor apps. It wraps the [PowerSync Web SDK](https://www.npmjs.com/package/@powersync/web) for Capacitor PWAs and uses [Capacitor Community SQLite](https://github.com/capacitor-community/sqlite) as the database driver for Android and iOS.
 
diff --git a/packages/capacitor/android/build.gradle b/packages/capacitor/android/build.gradle
@@ -3,7 +3,7 @@ ext {
     androidxAppCompatVersion = project.hasProperty('androidxAppCompatVersion') ? rootProject.ext.androidxAppCompatVersion : '1.7.0'
     androidxJunitVersion = project.hasProperty('androidxJunitVersion') ? rootProject.ext.androidxJunitVersion : '1.2.1'
     androidxEspressoCoreVersion = project.hasProperty('androidxEspressoCoreVersion') ? rootProject.ext.androidxEspressoCoreVersion : '3.6.1'
-    powerSyncCoreVersion = project.hasProperty('powerSyncCoreVersion') ? rootProject.ext.powerSyncCoreVersion : '0.4.6'
+    powerSyncCoreVersion = project.hasProperty('powerSyncCoreVersion') ? rootProject.ext.powerSyncCoreVersion : '0.4.10'
 }
 
 buildscript {
diff --git a/packages/common/src/client/AbstractPowerSyncDatabase.ts b/packages/common/src/client/AbstractPowerSyncDatabase.ts
@@ -38,13 +38,13 @@ import {
   type PowerSyncConnectionOptions,
   type RequiredAdditionalConnectionOptions
 } from './sync/stream/AbstractStreamingSyncImplementation.js';
+import { CoreSyncStatus, coreStatusToJs } from './sync/stream/core-instruction.js';
+import { SyncStream } from './sync/sync-streams.js';
 import { TriggerManager } from './triggers/TriggerManager.js';
 import { TriggerManagerImpl } from './triggers/TriggerManagerImpl.js';
 import { DEFAULT_WATCH_THROTTLE_MS, WatchCompatibleQuery } from './watched/WatchedQuery.js';
 import { OnChangeQueryProcessor } from './watched/processors/OnChangeQueryProcessor.js';
 import { WatchedQueryComparator } from './watched/processors/comparators.js';
-import { coreStatusToJs, CoreSyncStatus } from './sync/stream/core-instruction.js';
-import { SyncStream } from './sync/sync-streams.js';
 
 export interface DisconnectAndClearOptions {
   /** When set to false, data in local-only tables is preserved. */
@@ -195,7 +195,7 @@ export abstract class AbstractPowerSyncDatabase extends BaseObserver<PowerSyncDB
 
   /**
    * The connector used to connect to the PowerSync service.
-   * 
+   *
    * @returns The connector used to connect to the PowerSync service or null if `connect()` has not been called.
    */
   get connector() {
@@ -204,7 +204,7 @@ export abstract class AbstractPowerSyncDatabase extends BaseObserver<PowerSyncDB
 
   /**
    * The resolved connection options used to connect to the PowerSync service.
-   * 
+   *
    * @returns The resolved connection options used to connect to the PowerSync service or null if `connect()` has not been called.
    */
   get connectionOptions() {
@@ -438,13 +438,13 @@ export abstract class AbstractPowerSyncDatabase extends BaseObserver<PowerSyncDB
         .map((n) => parseInt(n));
     } catch (e) {
       throw new Error(
-        `Unsupported powersync extension version. Need >=0.4.5 <1.0.0, got: ${this.sdkVersion}. Details: ${e.message}`
+        `Unsupported powersync extension version. Need >=0.4.10 <1.0.0, got: ${this.sdkVersion}. Details: ${e.message}`
       );
     }
 
-    // Validate >=0.4.5 <1.0.0
-    if (versionInts[0] != 0 || versionInts[1] < 4 || (versionInts[1] == 4 && versionInts[2] < 5)) {
-      throw new Error(`Unsupported powersync extension version. Need >=0.4.5 <1.0.0, got: ${this.sdkVersion}`);
+    // Validate >=0.4.10 <1.0.0
+    if (versionInts[0] != 0 || versionInts[1] < 4 || (versionInts[1] == 4 && versionInts[2] < 10)) {
+      throw new Error(`Unsupported powersync extension version. Need >=0.4.10 <1.0.0, got: ${this.sdkVersion}`);
     }
   }
 
diff --git a/packages/common/src/client/sync/stream/AbstractStreamingSyncImplementation.ts b/packages/common/src/client/sync/stream/AbstractStreamingSyncImplementation.ts
@@ -16,7 +16,7 @@ import {
 import { CrudEntry } from '../bucket/CrudEntry.js';
 import { SyncDataBucket } from '../bucket/SyncDataBucket.js';
 import { AbstractRemote, FetchStrategy, SyncStreamOptions } from './AbstractRemote.js';
-import { coreStatusToJs, EstablishSyncStream, Instruction, SyncPriorityStatus } from './core-instruction.js';
+import { EstablishSyncStream, Instruction, coreStatusToJs } from './core-instruction.js';
 import {
   BucketRequest,
   CrudUploadNotification,
@@ -129,6 +129,11 @@ export interface InternalConnectionOptions extends BaseConnectionOptions, Additi
 
 /** @internal */
 export interface BaseConnectionOptions {
+  /**
+   * A set of metadata to be included in service logs.
+   */
+  appMetadata?: Record<string, string>;
+
   /**
    * Whether to use a JavaScript implementation to handle received sync lines from the sync
    * service, or whether this work should be offloaded to the PowerSync core extension.
@@ -223,6 +228,7 @@ export const DEFAULT_STREAMING_SYNC_OPTIONS = {
 export type RequiredPowerSyncConnectionOptions = Required<BaseConnectionOptions>;
 
 export const DEFAULT_STREAM_CONNECTION_OPTIONS: RequiredPowerSyncConnectionOptions = {
+  appMetadata: {},
   connectionMethod: SyncStreamConnectionMethod.WEB_SOCKET,
   clientImplementation: DEFAULT_SYNC_CLIENT_IMPLEMENTATION,
   fetchStrategy: FetchStrategy.Buffered,
@@ -658,6 +664,16 @@ The next upload iteration will be delayed.`);
           ...DEFAULT_STREAM_CONNECTION_OPTIONS,
           ...(options ?? {})
         };
+
+        // Validate app metadata
+        const invalidMetadata = Object.entries(resolvedOptions.appMetadata).filter(
+          ([_, value]) => typeof value != 'string'
+        );
+        if (invalidMetadata.length > 0) {
+          throw new Error(
+            `Invalid appMetadata provided. Only string values are allowed. Invalid values: ${invalidMetadata.map(([key, value]) => `${key}: ${value}`).join(', ')}`
+          );
+        }
         const clientImplementation = resolvedOptions.clientImplementation;
         this.updateSyncStatus({ clientImplementation });
 
@@ -699,6 +715,7 @@ The next upload iteration will be delayed.`);
         include_checksum: true,
         raw_data: true,
         parameters: resolvedOptions.params,
+        app_metadata: resolvedOptions.appMetadata,
         client_id: clientId
       }
     };
@@ -1088,6 +1105,7 @@ The next upload iteration will be delayed.`);
     try {
       const options: any = {
         parameters: resolvedOptions.params,
+        app_metadata: resolvedOptions.appMetadata,
         active_streams: this.activeStreams,
         include_defaults: resolvedOptions.includeDefaultStreams
       };
diff --git a/packages/common/src/client/sync/stream/streaming-sync-types.ts b/packages/common/src/client/sync/stream/streaming-sync-types.ts
@@ -90,6 +90,11 @@ export interface StreamingSyncRequest {
    */
   parameters?: Record<string, StreamingSyncRequestParameterType>;
 
+  /**
+   * Application metadata to be included in service logs.
+   */
+  app_metadata?: Record<string, string>;
+
   client_id?: string;
 }
 
diff --git a/packages/drizzle-driver/package.json b/packages/drizzle-driver/package.json
@@ -9,12 +9,12 @@
   "exports": {
     ".": {
       "import": {
-        "default": "./lib/src/index.js",
-        "types": "./lib/src/index.d.ts"
+        "types": "./lib/src/index.d.ts",
+        "default": "./lib/src/index.js"
       },
       "require": {
-        "default": "./dist/index.cjs",
-        "types": "./dist/index.d.cts"
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
       }
     }
   },
@@ -47,8 +47,8 @@
     "drizzle-orm": "<1.0.0"
   },
   "devDependencies": {
+    "@journeyapps/wa-sqlite": "^1.4.0",
     "@powersync/web": "workspace:*",
-    "@journeyapps/wa-sqlite": "^1.3.2",
     "@types/node": "^20.17.6",
     "drizzle-orm": "^0.44.7",
     "vite": "^6.1.0",
diff --git a/packages/kysely-driver/package.json b/packages/kysely-driver/package.json
@@ -49,8 +49,8 @@
     "kysely": "^0.28.0"
   },
   "devDependencies": {
+    "@journeyapps/wa-sqlite": "^1.4.0",
     "@powersync/web": "workspace:*",
-    "@journeyapps/wa-sqlite": "^1.3.2",
     "@types/node": "^20.17.6",
     "vite": "^6.1.0",
     "vite-plugin-top-level-await": "^1.4.4",
diff --git a/packages/node/README.md b/packages/node/README.md
@@ -4,7 +4,7 @@
 
 # PowerSync SDK for Node.js
 
-_[PowerSync](https://www.powersync.com) is a sync engine for building local-first apps with instantly-responsive UI/UX and simplified state transfer. Syncs between SQLite on the client-side and Postgres, MongoDB or MySQL on the server-side._
+_[PowerSync](https://www.powersync.com) is a sync engine for building local-first apps with instantly-responsive UI/UX and simplified state transfer. Syncs between SQLite on the client-side and Postgres, MongoDB, MySQL or SQL Server on the server-side._
 
 This package (`packages/node`) is the PowerSync SDK for Node.js clients. It is an extension of `packages/common`.
 Using this package is not necessary for PowerSync on servers, see [our documentation](https://docs.powersync.com/installation/app-backend-setup) for more details on that.
diff --git a/packages/node/download_core.js b/packages/node/download_core.js
@@ -5,18 +5,18 @@ import { Readable } from 'node:stream';
 import { finished } from 'node:stream/promises';
 
 // When changing this version, run node download_core.js update_hashes
-const version = '0.4.6';
+const version = '0.4.10';
 const versionHashes = {
-  'powersync_x64.dll': '5efaa9ad4975094912a36843cb7b503376cacd233d21ae0956f0f4b42dcb457b',
-  'powersync_x86.dll': '4151ba8aa6f024b50b7aebe52ba59f2c5be54e3fed26f7f3f48e1127dcda027d',
-  'powersync_aarch64.dll': '3abe46074432593ff5cfc2098b186c592f020c5cfa81285f8e49962732a94bf5',
-  'libpowersync_x86.so': '1321a7de13fda0b2de7d2bc231a68cb5691f84010f3858e5cf02e47f88ba6f4a',
-  'libpowersync_x64.so': 'e9d78620d69d3cf7d57353891fe0bf85b79d326b42c4669b9500b9e610388f76',
-  'libpowersync_aarch64.so': '0d84c0dc0134fc89af65724d11e2c45e3c15569c575ecda52d0ec2fa2aeec495',
-  'libpowersync_armv7.so': 'c7887181ce9c524b68a7ac284ab447b8584511c87527ca26186e5874bf9ba3d6',
-  'libpowersync_riscv64gc.so': 'a89f3a71f22f707707d97517e9310e42e2a57dc5343cee08d09002a8cea048d5',
-  'libpowersync_x64.dylib': '9b484eaf361451f7758ca6ad53190a73563be930a8f8a39ccefd29390046ef6c',
-  'libpowersync_aarch64.dylib': 'bfb4f1ec207b298aff560f1825f8123d24316edaa27b6df3a17dd49466576b92'
+  'powersync_x64.dll': '9cffcd5e2393172523405c35021ce5db70f1d257a7973ca4210c67dbfd00c203',
+  'powersync_x86.dll': 'e809ca6c877bc011ce193441d922a9c9f7c8d43675c990c671c22983263aad41',
+  'powersync_aarch64.dll': '756c4b591562b468c4f7c4a2a6a9a910b52389760294bac0e02f1c25636e68cc',
+  'libpowersync_x86.linux.so': 'e0a4bf3e1228386fbdffafe4d8bc7d00b2e5d1f6340ec8db563a205bd3299121',
+  'libpowersync_x64.linux.so': '81ab16086e504cafc248969c44b53731bea937ea721b2f8cda78bcdc835de1f2',
+  'libpowersync_aarch64.linux.so': 'a2e87871ce8fd9418c6a4e6d29ba5b6024062f604dd48dc878022fd2be6884a3',
+  'libpowersync_armv7.linux.so': '857c673912db666ec4248f2fd5a942b8eec3c8a1830db2ece0dd8de171943f88',
+  'libpowersync_riscv64gc.linux.so': '45bf10394010f410f6ddb16299bbf326af1286b9146972b0c8e0aaa545aa9ddf',
+  'libpowersync_x64.macos.dylib': '21dedb45427e6abcc2dd080db82b4bf57a90ddc7ef811c87927a02dcd52188ac',
+  'libpowersync_aarch64.macos.dylib': 'cf8c2f6c3bb6ed18e58b415423d51db2ffbaadcc077cf3522ed7402ca56313ce'
 };
 
 const assets = Object.keys(versionHashes);
diff --git a/packages/node/package.json b/packages/node/package.json
@@ -5,7 +5,7 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "description": "PowerSync Node.js SDK. Sync Postgres, MongoDB or MySQL with SQLite in your Node.js app",
+  "description": "PowerSync Node.js SDK",
   "main": "lib/index.js",
   "files": [
     "lib",
diff --git a/packages/node/src/db/SqliteWorker.ts b/packages/node/src/db/SqliteWorker.ts
diff --git a/packages/node/tests/sync.test.ts b/packages/node/tests/sync.test.ts
diff --git a/packages/powersync-op-sqlite/android/build.gradle b/packages/powersync-op-sqlite/android/build.gradle
diff --git a/packages/powersync-op-sqlite/powersync-op-sqlite.podspec b/packages/powersync-op-sqlite/powersync-op-sqlite.podspec
diff --git a/packages/react-native/README.md b/packages/react-native/README.md
diff --git a/packages/react-native/package.json b/packages/react-native/package.json
diff --git a/packages/web/README.md b/packages/web/README.md
diff --git a/packages/web/package.json b/packages/web/package.json
diff --git a/packages/web/tests/src/db/AbstractPowerSyncDatabase.test.ts b/packages/web/tests/src/db/AbstractPowerSyncDatabase.test.ts

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +"@powersync/drizzle-driver": patch
 +---
++
 +Reorder export attributes to prevent "Error: Default condition should be last one".