@zm2231/kysely-powersync-dialect 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zain
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# @zm2231/kysely-powersync-dialect
+
+A small Kysely dialect for PowerSync Node clients.
+
+PowerSync gives Node apps a local SQLite replica plus an upload queue. Kysely expects one database connection. This dialect splits the path:
+
+- read queries use the local SQLite replica through `better-sqlite3`
+- writes go through `PowerSyncDatabase.execute()`, or through a remote write endpoint
+- PowerSync credentials and uploads use explicit URLs by default
+- auth, upload, read classification, and write routing can be replaced with hooks
+
+This is intentionally only the dialect layer. It does not ship app schemas, migrations, CRM tables, sync rules, or schema engines.
+
+## Install
+
+```bash
+npm install @zm2231/kysely-powersync-dialect kysely @powersync/common @powersync/node better-sqlite3
+```
+
+## Examples
+
+- [Examples index](examples/README.md)
+- [Local PowerSync database](examples/local-powersync.md)
+- [Remote writes](examples/remote-writes.md)
+- [Extension hooks](examples/extension-hooks.md)
+
+## Limitations
+
+- The dialect is designed for PowerSync's local-first model. Reads inside Kysely transactions still read from the local replica, so they are useful for read-only transactional code but should not be treated as read-your-write guarantees after queued PowerSync writes.
+- Kysely transactions are read-only in this dialect. Writes inside a Kysely transaction throw instead of pretending the split read/write paths are atomic.
+- Raw SQL read/write routing is conservative. Override `readQueryClassifier` when your app has SQL forms the default classifier should not decide.
+- The package does not delete SQLite `-wal` or `-shm` sidecars. Those files can contain uncheckpointed data. Handle recovery explicitly in your app if you need it.
+- Users provide their own PowerSync schema. No built-in tables are created for you.
+- `RETURNING` rows are passed through when the underlying PowerSync SDK returns rows. If your PowerSync runtime does not return rows for a write, Kysely receives an empty row list.
+
+## Why this exists
+
+PowerSync's web SDK has Kysely-friendly patterns, but Node apps need a small bridge between Kysely's dialect API and PowerSync's local replica/write queue split. This package is that bridge.

package/dist/auth.d.ts

@@ -0,0 +1,9 @@
+import type { PowerSyncConfig, TokenResponse } from "./types.js";
+export interface PowerSyncConfigValidationOptions {
+    requireAuthUrl?: boolean;
+    requireUploadUrl?: boolean;
+}
+export declare function validatePowerSyncConfig(config: PowerSyncConfig, options?: PowerSyncConfigValidationOptions): void;
+export declare function fetchPowerSyncToken(config: PowerSyncConfig): Promise<TokenResponse>;
+export declare function cfHeaders(config: PowerSyncConfig): Record<string, string>;
+export declare function parseTokenResponse(payload: unknown): TokenResponse;

package/dist/auth.js

@@ -0,0 +1,75 @@
+export function validatePowerSyncConfig(config, options = {}) {
+    const requireAuthUrl = options.requireAuthUrl ?? true;
+    const requireUploadUrl = options.requireUploadUrl ?? true;
+    validateHttpUrl("powersync_url", config.powersync_url);
+    if (config.auth_url) {
+        validateHttpUrl("auth_url", config.auth_url);
+    }
+    else if (requireAuthUrl) {
+        throw new Error("PowerSync auth_url is required unless fetchCredentials is provided");
+    }
+    if (config.upload_url) {
+        validateHttpUrl("upload_url", config.upload_url);
+    }
+    else if (requireUploadUrl) {
+        throw new Error("PowerSync upload_url is required unless uploadTransaction is provided");
+    }
+    if (!config.user_id.trim()) {
+        throw new Error("PowerSync user_id is required");
+    }
+    if (!config.db_path.trim()) {
+        throw new Error("PowerSync db_path is required");
+    }
+    const hasCfId = Boolean(config.cf_access_client_id);
+    const hasCfSecret = Boolean(config.cf_access_client_secret);
+    if (hasCfId !== hasCfSecret) {
+        throw new Error("PowerSync Cloudflare Access config requires both client id and client secret");
+    }
+}
+export async function fetchPowerSyncToken(config) {
+    validatePowerSyncConfig(config, { requireAuthUrl: true, requireUploadUrl: false });
+    const url = new URL(config.auth_url);
+    url.searchParams.set("user_id", config.user_id);
+    const response = await fetch(url, { headers: cfHeaders(config) });
+    if (!response.ok) {
+        throw new Error(`PowerSync auth failed: ${response.status} ${response.statusText}`);
+    }
+    return parseTokenResponse(await response.json());
+}
+export function cfHeaders(config) {
+    const headers = {};
+    if (config.cf_access_client_id && config.cf_access_client_secret) {
+        headers["CF-Access-Client-Id"] = config.cf_access_client_id;
+        headers["CF-Access-Client-Secret"] = config.cf_access_client_secret;
+    }
+    return headers;
+}
+function validateHttpUrl(field, value) {
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        throw new Error(`PowerSync ${field} must be a valid URL`);
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error(`PowerSync ${field} must use http or https`);
+    }
+}
+export function parseTokenResponse(payload) {
+    if (!payload || typeof payload !== "object") {
+        throw new Error("PowerSync auth response must be a JSON object");
+    }
+    const response = payload;
+    if (typeof response.token !== "string" || response.token.trim().length === 0) {
+        throw new Error("PowerSync auth response is missing token");
+    }
+    if (typeof response.expires_at !== "number" || !Number.isFinite(response.expires_at)) {
+        throw new Error("PowerSync auth response is missing numeric expires_at");
+    }
+    return {
+        token: response.token,
+        expires_at: response.expires_at,
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/connect.d.ts

@@ -0,0 +1,7 @@
+import { PowerSyncDatabase } from "@powersync/node";
+import type { Schema } from "@powersync/common";
+import type { CreatePowerSyncDatabaseOptions, PowerSyncConfig, PowerSyncCrudTransaction, PowerSyncUploadContext } from "./types.js";
+export declare function createConnectedPowerSyncDatabase(config: PowerSyncConfig, schema: Schema, options?: CreatePowerSyncDatabaseOptions): Promise<PowerSyncDatabase>;
+export declare function defaultUploadTransaction(transaction: PowerSyncCrudTransaction, context: PowerSyncUploadContext): Promise<{
+    checkpoint?: string;
+} | void>;

package/dist/connect.js

@@ -0,0 +1,115 @@
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { Agent } from "undici";
+import { PowerSyncDatabase } from "@powersync/node";
+import { cfHeaders, fetchPowerSyncToken, validatePowerSyncConfig } from "./auth.js";
+import { ensureSqliteFileExists } from "./dialect.js";
+export async function createConnectedPowerSyncDatabase(config, schema, options) {
+    validatePowerSyncConfig(config, {
+        requireAuthUrl: !options?.fetchCredentials,
+        requireUploadUrl: !options?.uploadTransaction,
+    });
+    mkdirSync(dirname(config.db_path), { recursive: true });
+    ensureSqliteFileExists(config.db_path);
+    const db = new PowerSyncDatabase({
+        schema,
+        database: { dbFilename: config.db_path },
+    });
+    const headers = cfHeaders(config);
+    const dispatcher = Object.keys(headers).length > 0
+        ? new Agent({
+            interceptors: {
+                Pool: [(dispatch) => (opts, handler) => {
+                        if (opts.headers && typeof opts.headers === "object" && !Array.isArray(opts.headers)) {
+                            Object.assign(opts.headers, headers);
+                        }
+                        else {
+                            opts.headers = { ...(opts.headers ?? {}), ...headers };
+                        }
+                        return dispatch(opts, handler);
+                    }],
+            },
+        })
+        : undefined;
+    if (options?.onStatusChanged) {
+        db.registerListener({
+            statusChanged: (status) => {
+                options.onStatusChanged?.(status);
+            },
+        });
+    }
+    const connector = {
+        async fetchCredentials() {
+            if (options?.fetchCredentials) {
+                return await options.fetchCredentials(config);
+            }
+            const credentials = await fetchPowerSyncToken(config);
+            return {
+                endpoint: config.powersync_url,
+                token: credentials.token,
+                expiresAt: new Date(credentials.expires_at * 1000),
+            };
+        },
+        async uploadData() {
+            await flushCrud(db, config, headers, options?.uploadTransaction);
+        },
+    };
+    await db.connect(connector, {
+        fetchOptions: { headers },
+        ...(dispatcher ? { dispatcher } : {}),
+    });
+    options?.onStatusChanged?.(db.currentStatus);
+    return db;
+}
+async function flushCrud(db, config, headers, uploadTransaction = defaultUploadTransaction) {
+    while (true) {
+        const tx = await db.getNextCrudTransaction();
+        if (!tx)
+            return;
+        try {
+            const result = await uploadTransaction(tx, { config, headers });
+            await tx.complete(result?.checkpoint);
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+}
+export async function defaultUploadTransaction(transaction, context) {
+    if (!context.config.upload_url) {
+        throw new Error("PowerSync upload_url is required for defaultUploadTransaction");
+    }
+    const response = await fetch(context.config.upload_url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            ...context.headers,
+        },
+        body: JSON.stringify({
+            transactionId: transaction.transactionId,
+            operations: transaction.crud.map(serializeCrudEntry),
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`PowerSync upload failed: ${response.status} ${await response.text()}`);
+    }
+    if (response.status === 204)
+        return;
+    const contentType = response.headers.get("content-type") ?? "";
+    if (!contentType.includes("application/json"))
+        return;
+    const payload = await response.json();
+    if (payload.checkpoint !== undefined && typeof payload.checkpoint !== "string") {
+        throw new Error("PowerSync upload response checkpoint must be a string");
+    }
+    return payload.checkpoint ? { checkpoint: payload.checkpoint } : undefined;
+}
+function serializeCrudEntry(op) {
+    return {
+        table: op.table,
+        id: op.id,
+        data: op.opData,
+        op: op.op,
+    };
+}
+//# sourceMappingURL=connect.js.map

package/dist/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"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"}

package/dist/dialect.d.ts

@@ -0,0 +1,41 @@
+import BetterSqlite3 from "better-sqlite3";
+import { CompiledQuery, Kysely, type DatabaseConnection, type DatabaseIntrospector, type Dialect, type DialectAdapter, type Driver, type QueryCompiler, type QueryResult, type TransactionSettings } from "kysely";
+import type { PowerSyncDialectConfig, ReadQueryClassifier } from "./types.js";
+export interface WriteExecutor {
+    executeQuery<R>(compiledQuery: CompiledQuery): Promise<QueryResult<R>>;
+    destroy(): Promise<void>;
+}
+export interface SplitPowerSyncDriverConfig {
+    readDatabase: BetterSqlite3.Database | (() => Promise<BetterSqlite3.Database> | BetterSqlite3.Database);
+    createWriteExecutor: () => Promise<WriteExecutor>;
+    readQueryClassifier?: ReadQueryClassifier;
+    onCreateConnection?: (connection: DatabaseConnection) => Promise<void>;
+}
+export declare class PowerSyncDialect implements Dialect {
+    #private;
+    constructor(config: PowerSyncDialectConfig);
+    createDriver(): Driver;
+    createQueryCompiler(): QueryCompiler;
+    createAdapter(): DialectAdapter;
+    createIntrospector(db: Kysely<unknown>): DatabaseIntrospector;
+}
+export declare function openPowerSyncReadDatabase(dbPath: string): Promise<BetterSqlite3.Database>;
+export declare function isPowerSyncReadQuery(sqlText: string): boolean;
+export declare const defaultReadQueryClassifier: ReadQueryClassifier;
+export declare class SplitPowerSyncDriver implements Driver {
+    #private;
+    constructor(config: SplitPowerSyncDriverConfig);
+    init(): Promise<void>;
+    acquireConnection(): Promise<DatabaseConnection>;
+    beginTransaction(connection: DatabaseConnection, _settings: TransactionSettings): Promise<void>;
+    commitTransaction(connection: DatabaseConnection): Promise<void>;
+    rollbackTransaction(connection: DatabaseConnection): Promise<void>;
+    savepoint(connection: DatabaseConnection, savepointName: string): Promise<void>;
+    rollbackToSavepoint(connection: DatabaseConnection, savepointName: string): Promise<void>;
+    releaseSavepoint(connection: DatabaseConnection, savepointName: string): Promise<void>;
+    releaseConnection(_connection: DatabaseConnection): Promise<void>;
+    destroy(): Promise<void>;
+}
+export declare function resolveValue<T>(value: T | (() => T | Promise<T>) | Promise<T>): Promise<T>;
+export declare function normalizeRemoteResult<R>(payload: unknown): QueryResult<R>;
+export declare function ensureSqliteFileExists(dbPath: string): void;

package/dist/dialect.js

@@ -0,0 +1,291 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import BetterSqlite3 from "better-sqlite3";
+import { SelectQueryNode, SqliteAdapter, SqliteIntrospector, SqliteQueryCompiler, } from "kysely";
+const READ_QUERY_REGEX = /^(SELECT|EXPLAIN)\b/i;
+const READ_PRAGMA_REGEX = /^PRAGMA\s+(table_info|table_xinfo|index_info|index_xinfo|index_list|foreign_key_list|database_list|quick_check|integrity_check|user_version|application_id|schema_version)\b/i;
+export class PowerSyncDialect {
+    #config;
+    constructor(config) {
+        this.#config = Object.freeze({ ...config });
+    }
+    createDriver() {
+        return new SplitPowerSyncDriver({
+            readDatabase: this.#config.readDatabase,
+            createWriteExecutor: async () => new LocalPowerSyncWriteExecutor(await resolveValue(this.#config.writeDatabase)),
+            readQueryClassifier: this.#config.readQueryClassifier,
+            onCreateConnection: this.#config.onCreateConnection,
+        });
+    }
+    createQueryCompiler() {
+        return new SqliteQueryCompiler();
+    }
+    createAdapter() {
+        return new SqliteAdapter();
+    }
+    createIntrospector(db) {
+        return new SqliteIntrospector(db);
+    }
+}
+export async function openPowerSyncReadDatabase(dbPath) {
+    ensureSqliteFileExists(dbPath);
+    return new BetterSqlite3(dbPath, { readonly: true, fileMustExist: true });
+}
+export function isPowerSyncReadQuery(sqlText) {
+    return isReadSql(sqlText);
+}
+export const defaultReadQueryClassifier = (compiledQuery) => {
+    if (SelectQueryNode.is(compiledQuery.query))
+        return true;
+    return isReadSql(compiledQuery.sql);
+};
+export class SplitPowerSyncDriver {
+    #config;
+    #connectionMutex = new ConnectionMutex();
+    #readDb;
+    #writeExecutor;
+    #connection;
+    constructor(config) {
+        this.#config = Object.freeze({ ...config });
+    }
+    async init() {
+        this.#readDb = await resolveValue(this.#config.readDatabase);
+        this.#writeExecutor = await this.#config.createWriteExecutor();
+        this.#connection = new SplitPowerSyncConnection(this.#readDb, this.#writeExecutor, this.#config.readQueryClassifier ?? defaultReadQueryClassifier);
+        if (this.#config.onCreateConnection) {
+            await this.#config.onCreateConnection(this.#connection);
+        }
+    }
+    async acquireConnection() {
+        if (!this.#connection)
+            throw new Error("PowerSync driver has not been initialized");
+        await this.#connectionMutex.lock();
+        return this.#connection;
+    }
+    async beginTransaction(connection, _settings) {
+        if (!(connection instanceof SplitPowerSyncConnection)) {
+            throw new Error("Unsupported PowerSync connection instance");
+        }
+        connection.enterTransaction();
+        try {
+            await connection.beginReadTransaction();
+        }
+        catch (error) {
+            connection.exitTransaction();
+            throw error;
+        }
+    }
+    async commitTransaction(connection) {
+        if (!(connection instanceof SplitPowerSyncConnection)) {
+            throw new Error("Unsupported PowerSync connection instance");
+        }
+        try {
+            await connection.commitReadTransaction();
+        }
+        finally {
+            connection.exitTransaction();
+        }
+    }
+    async rollbackTransaction(connection) {
+        if (!(connection instanceof SplitPowerSyncConnection)) {
+            throw new Error("Unsupported PowerSync connection instance");
+        }
+        try {
+            await connection.rollbackReadTransaction();
+        }
+        finally {
+            connection.exitTransaction();
+        }
+    }
+    async savepoint(connection, savepointName) {
+        if (!(connection instanceof SplitPowerSyncConnection)) {
+            throw new Error("Unsupported PowerSync connection instance");
+        }
+        await connection.savepoint(savepointName);
+    }
+    async rollbackToSavepoint(connection, savepointName) {
+        if (!(connection instanceof SplitPowerSyncConnection)) {
+            throw new Error("Unsupported PowerSync connection instance");
+        }
+        await connection.rollbackToSavepoint(savepointName);
+    }
+    async releaseSavepoint(connection, savepointName) {
+        if (!(connection instanceof SplitPowerSyncConnection)) {
+            throw new Error("Unsupported PowerSync connection instance");
+        }
+        await connection.releaseSavepoint(savepointName);
+    }
+    async releaseConnection(_connection) {
+        this.#connectionMutex.unlock();
+    }
+    async destroy() {
+        await this.#writeExecutor?.destroy();
+        this.#readDb?.close();
+    }
+}
+class SplitPowerSyncConnection {
+    #readDb;
+    #writeExecutor;
+    #readQueryClassifier;
+    #transactionDepth = 0;
+    constructor(readDb, writeExecutor, readQueryClassifier) {
+        this.#readDb = readDb;
+        this.#writeExecutor = writeExecutor;
+        this.#readQueryClassifier = readQueryClassifier;
+    }
+    enterTransaction() {
+        this.#transactionDepth += 1;
+    }
+    exitTransaction() {
+        this.#transactionDepth = Math.max(0, this.#transactionDepth - 1);
+    }
+    async executeQuery(compiledQuery) {
+        if (this.#readQueryClassifier(compiledQuery)) {
+            return this.#executeReadQuery(compiledQuery);
+        }
+        if (this.#transactionDepth > 0) {
+            throw new Error("PowerSync dialect only supports read queries inside Kysely transactions");
+        }
+        return this.#writeExecutor.executeQuery(compiledQuery);
+    }
+    async beginReadTransaction() {
+        this.#readDb.exec("begin");
+    }
+    async commitReadTransaction() {
+        this.#readDb.exec("commit");
+    }
+    async rollbackReadTransaction() {
+        this.#readDb.exec("rollback");
+    }
+    async savepoint(savepointName) {
+        this.#readDb.exec(`savepoint ${quoteIdentifier(savepointName)}`);
+    }
+    async rollbackToSavepoint(savepointName) {
+        this.#readDb.exec(`rollback to ${quoteIdentifier(savepointName)}`);
+    }
+    async releaseSavepoint(savepointName) {
+        this.#readDb.exec(`release ${quoteIdentifier(savepointName)}`);
+    }
+    async *streamQuery(compiledQuery) {
+        if (!SelectQueryNode.is(compiledQuery.query)) {
+            throw new Error("PowerSync dialect only supports streaming select queries");
+        }
+        const stmt = this.#readDb.prepare(compiledQuery.sql);
+        const iter = stmt.iterate(compiledQuery.parameters);
+        for (const row of iter) {
+            yield { rows: [row] };
+        }
+    }
+    #executeReadQuery(compiledQuery) {
+        const stmt = this.#readDb.prepare(compiledQuery.sql);
+        const rows = stmt.all(compiledQuery.parameters);
+        return { rows };
+    }
+}
+class LocalPowerSyncWriteExecutor {
+    #db;
+    constructor(db) {
+        this.#db = db;
+    }
+    async executeQuery(compiledQuery) {
+        const result = await this.#db.execute(compiledQuery.sql, [...compiledQuery.parameters]);
+        const rows = result.rows;
+        return {
+            rows: Array.isArray(rows) ? rows : [],
+            numAffectedRows: typeof result.rowsAffected === "number" ? BigInt(result.rowsAffected) : undefined,
+            insertId: toBigInt(result.insertId),
+        };
+    }
+    async destroy() {
+        await this.#db.disconnect();
+    }
+}
+export async function resolveValue(value) {
+    if (typeof value === "function") {
+        return await value();
+    }
+    return await value;
+}
+export function normalizeRemoteResult(payload) {
+    if (!payload || typeof payload !== "object") {
+        return { rows: [] };
+    }
+    const result = payload;
+    return {
+        rows: Array.isArray(result.rows) ? result.rows : [],
+        numAffectedRows: toBigInt(result.numAffectedRows),
+        insertId: toBigInt(result.insertId),
+    };
+}
+export function ensureSqliteFileExists(dbPath) {
+    if (existsSync(dbPath))
+        return;
+    mkdirSync(dirname(dbPath), { recursive: true });
+    const bootstrap = new BetterSqlite3(dbPath);
+    bootstrap.pragma("journal_mode = WAL");
+    bootstrap.close();
+}
+function toBigInt(value) {
+    if (value === null || value === undefined)
+        return undefined;
+    if (typeof value === "bigint")
+        return value;
+    if (typeof value === "number")
+        return BigInt(value);
+    if (typeof value === "string" && value.length > 0)
+        return BigInt(value);
+    return undefined;
+}
+function isReadSql(sqlText) {
+    const normalized = stripLeadingSqlTrivia(sqlText);
+    if (READ_QUERY_REGEX.test(normalized))
+        return true;
+    const statement = stripTrailingStatementTerminators(normalized);
+    if (READ_PRAGMA_REGEX.test(statement) && !/=/.test(statement))
+        return true;
+    if (!/^WITH\b/i.test(statement))
+        return false;
+    return /\bSELECT\b/i.test(statement) &&
+        !/\b(INSERT|UPDATE|DELETE|REPLACE|UPSERT|CREATE|ALTER|DROP)\b/i.test(statement);
+}
+function stripLeadingSqlTrivia(sqlText) {
+    let remaining = sqlText.trimStart();
+    while (true) {
+        if (remaining.startsWith("--")) {
+            const nextLine = remaining.indexOf("\n");
+            remaining = nextLine === -1 ? "" : remaining.slice(nextLine + 1).trimStart();
+            continue;
+        }
+        if (remaining.startsWith("/*")) {
+            const close = remaining.indexOf("*/");
+            remaining = close === -1 ? "" : remaining.slice(close + 2).trimStart();
+            continue;
+        }
+        return remaining;
+    }
+}
+function stripTrailingStatementTerminators(sqlText) {
+    return sqlText.replace(/;\s*$/, "");
+}
+function quoteIdentifier(identifier) {
+    return `"${identifier.replaceAll("\"", "\"\"")}"`;
+}
+class ConnectionMutex {
+    #promise;
+    #resolve;
+    async lock() {
+        while (this.#promise) {
+            await this.#promise;
+        }
+        this.#promise = new Promise((resolve) => {
+            this.#resolve = resolve;
+        });
+    }
+    unlock() {
+        const resolve = this.#resolve;
+        this.#promise = undefined;
+        this.#resolve = undefined;
+        resolve?.();
+    }
+}
+//# sourceMappingURL=dialect.js.map

package/dist/dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect.js","sourceRoot":"","sources":["../src/dialect.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { PowerSyncDialect, SplitPowerSyncDriver, defaultReadQueryClassifier, ensureSqliteFileExists, isPowerSyncReadQuery, normalizeRemoteResult, openPowerSyncReadDatabase, resolveValue, } from "./dialect.js";
+export { RemotePowerSyncDialect } from "./remote-dialect.js";
+export { createConnectedPowerSyncDatabase, defaultUploadTransaction } from "./connect.js";
+export { cfHeaders, fetchPowerSyncToken, parseTokenResponse, validatePowerSyncConfig } from "./auth.js";
+export type { SplitPowerSyncDriverConfig, WriteExecutor } from "./dialect.js";
+export type { CreatePowerSyncDatabaseOptions, PowerSyncCredentials, PowerSyncConfig, PowerSyncCrudEntry, PowerSyncCrudTransaction, PowerSyncDialectConfig, PowerSyncMode, PowerSyncRuntimeStatus, PowerSyncUploadContext, ReadQueryClassifier, RemotePowerSyncDialectConfig, TokenResponse, } from "./types.js";

package/dist/index.js

@@ -0,0 +1,5 @@
+export { PowerSyncDialect, SplitPowerSyncDriver, defaultReadQueryClassifier, ensureSqliteFileExists, isPowerSyncReadQuery, normalizeRemoteResult, openPowerSyncReadDatabase, resolveValue, } from "./dialect.js";
+export { RemotePowerSyncDialect } from "./remote-dialect.js";
+export { createConnectedPowerSyncDatabase, defaultUploadTransaction } from "./connect.js";
+export { cfHeaders, fetchPowerSyncToken, parseTokenResponse, validatePowerSyncConfig } from "./auth.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,gCAAgC,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC"}

package/dist/remote-dialect.d.ts

@@ -0,0 +1,10 @@
+import { Kysely, type DatabaseIntrospector, type Dialect, type DialectAdapter, type Driver, type QueryCompiler } from "kysely";
+import type { RemotePowerSyncDialectConfig } from "./types.js";
+export declare class RemotePowerSyncDialect implements Dialect {
+    #private;
+    constructor(config: RemotePowerSyncDialectConfig);
+    createDriver(): Driver;
+    createQueryCompiler(): QueryCompiler;
+    createAdapter(): DialectAdapter;
+    createIntrospector(db: Kysely<unknown>): DatabaseIntrospector;
+}

package/dist/remote-dialect.js

@@ -0,0 +1,70 @@
+import { SqliteAdapter, SqliteIntrospector, SqliteQueryCompiler, } from "kysely";
+import { normalizeRemoteResult, SplitPowerSyncDriver } from "./dialect.js";
+const TRANSACTION_SQL_REGEX = /^\s*(BEGIN|COMMIT|ROLLBACK|SAVEPOINT|RELEASE)\b/i;
+export class RemotePowerSyncDialect {
+    #config;
+    constructor(config) {
+        this.#config = Object.freeze({ ...config });
+    }
+    createDriver() {
+        return new SplitPowerSyncDriver({
+            readDatabase: this.#config.readDatabase,
+            createWriteExecutor: async () => new RemotePowerSyncWriteExecutor(this.#config),
+            readQueryClassifier: this.#config.readQueryClassifier,
+            onCreateConnection: this.#config.onCreateConnection,
+        });
+    }
+    createQueryCompiler() {
+        return new SqliteQueryCompiler();
+    }
+    createAdapter() {
+        return new SqliteAdapter();
+    }
+    createIntrospector(db) {
+        return new SqliteIntrospector(db);
+    }
+}
+class RemotePowerSyncWriteExecutor {
+    #config;
+    constructor(config) {
+        this.#config = config;
+    }
+    async executeQuery(compiledQuery) {
+        if (TRANSACTION_SQL_REGEX.test(compiledQuery.sql)) {
+            throw new Error("RemotePowerSyncDialect does not support remote transaction control statements");
+        }
+        const body = this.#config.writeBody
+            ? this.#config.writeBody(compiledQuery.sql, compiledQuery.parameters)
+            : { sql: compiledQuery.sql, params: compiledQuery.parameters };
+        const response = await fetch(this.#config.writeEndpoint, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                ...(this.#config.writeHeaders ?? {}),
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new Error(`Remote PowerSync write failed: ${response.status} ${await response.text()}`);
+        }
+        const payload = await readResponsePayload(response);
+        if (this.#config.mapResult)
+            return this.#config.mapResult(payload);
+        return normalizeRemoteResult(payload);
+    }
+    async destroy() {
+        return;
+    }
+}
+async function readResponsePayload(response) {
+    if (response.status === 204)
+        return undefined;
+    const text = await response.text();
+    if (text.length === 0)
+        return undefined;
+    const contentType = response.headers.get("content-type") ?? "";
+    if (!contentType.includes("application/json"))
+        return text;
+    return JSON.parse(text);
+}
+//# sourceMappingURL=remote-dialect.js.map

package/dist/remote-dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-dialect.js","sourceRoot":"","sources":["../src/remote-dialect.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+import type BetterSqlite3 from "better-sqlite3";
+import type { CompiledQuery, DatabaseConnection, QueryResult } from "kysely";
+import type { PowerSyncDatabase } from "@powersync/node";
+export type PowerSyncMode = "daemon" | "in-process" | "auto";
+export type ReadQueryClassifier = (compiledQuery: CompiledQuery) => boolean;
+export interface PowerSyncConfig {
+    type?: "powersync";
+    mode?: PowerSyncMode;
+    powersync_url: string;
+    auth_url?: string;
+    upload_url?: string;
+    user_id: string;
+    db_path: string;
+    cf_access_client_id?: string;
+    cf_access_client_secret?: string;
+}
+export interface PowerSyncDialectConfig {
+    readDatabase: BetterSqlite3.Database | (() => Promise<BetterSqlite3.Database> | BetterSqlite3.Database);
+    writeDatabase: PowerSyncDatabase | (() => Promise<PowerSyncDatabase> | PowerSyncDatabase);
+    readQueryClassifier?: ReadQueryClassifier;
+    onCreateConnection?: (connection: DatabaseConnection) => Promise<void>;
+}
+export interface RemotePowerSyncDialectConfig {
+    readDatabase: BetterSqlite3.Database | (() => Promise<BetterSqlite3.Database> | BetterSqlite3.Database);
+    writeEndpoint: string;
+    writeHeaders?: Record<string, string>;
+    writeBody?: (sql: string, parameters: readonly unknown[]) => unknown;
+    mapResult?: <R>(payload: unknown) => QueryResult<R>;
+    readQueryClassifier?: ReadQueryClassifier;
+    onCreateConnection?: (connection: DatabaseConnection) => Promise<void>;
+}
+export interface PowerSyncRuntimeStatus {
+    connected?: boolean;
+    connecting?: boolean;
+    hasSynced?: boolean;
+    lastSyncedAt?: string | Date | null;
+    downloading?: boolean;
+    uploading?: boolean;
+}
+export interface CreatePowerSyncDatabaseOptions {
+    onStatusChanged?: (status: PowerSyncRuntimeStatus) => void;
+    fetchCredentials?: (config: PowerSyncConfig) => Promise<PowerSyncCredentials>;
+    uploadTransaction?: (transaction: PowerSyncCrudTransaction, context: PowerSyncUploadContext) => Promise<PowerSyncUploadResult | void>;
+}
+export interface TokenResponse {
+    token: string;
+    expires_at: number;
+}
+export interface PowerSyncCredentials {
+    endpoint: string;
+    token: string;
+    expiresAt: Date;
+}
+export interface PowerSyncCrudEntry {
+    op: "PUT" | "PATCH" | "DELETE" | string;
+    table: string;
+    id: string;
+    opData?: Record<string, unknown>;
+}
+export interface PowerSyncCrudTransaction {
+    crud: PowerSyncCrudEntry[];
+    complete: (checkpoint?: string) => Promise<void>;
+    transactionId?: number;
+}
+export interface PowerSyncUploadContext {
+    config: PowerSyncConfig;
+    headers: Record<string, string>;
+}
+export interface PowerSyncUploadResult {
+    checkpoint?: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/examples/README.md

@@ -0,0 +1,8 @@
+# Examples
+
+These examples are intentionally small. They show the package surface without shipping app schemas, migrations, sync rules, or backend code.
+
+- [Local PowerSync database](local-powersync.md): connect a PowerSync Node database and read from the local SQLite replica through Kysely.
+- [Remote writes](remote-writes.md): read locally while forwarding writes to an HTTP service.
+- [Extension hooks](extension-hooks.md): replace auth, upload, and read/write routing behavior.
+

package/examples/extension-hooks.md

@@ -0,0 +1,62 @@
+# Extension Hooks
+
+The high-level helper is hookable for custom auth and upload flows. When both hooks are provided, `auth_url` and `upload_url` are not required:
+
+```ts
+import {
+  createConnectedPowerSyncDatabase,
+  type PowerSyncConfig,
+} from "@zm2231/kysely-powersync-dialect";
+
+const appUploadEndpoint = "https://api.example.com/powersync/upload";
+const config: PowerSyncConfig = {
+  powersync_url: "https://powersync.example.com",
+  user_id: "user-123",
+  db_path: "./data/powersync.db",
+};
+
+const writeDatabase = await createConnectedPowerSyncDatabase(config, schema, {
+  async fetchCredentials(config) {
+    return {
+      endpoint: config.powersync_url,
+      token: await getTokenFromYourAuthProvider(),
+      expiresAt: new Date(Date.now() + 60 * 60 * 1000),
+    };
+  },
+  async uploadTransaction(transaction, context) {
+    const response = await fetch(appUploadEndpoint, {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        ...context.headers,
+      },
+      body: JSON.stringify({
+        transactionId: transaction.transactionId,
+        operations: transaction.crud,
+      }),
+    });
+    if (!response.ok) {
+      throw new Error(`Upload failed: ${response.status} ${await response.text()}`);
+    }
+    const payload = await response.json() as { checkpoint?: string };
+    return { checkpoint: payload.checkpoint };
+  },
+});
+```
+
+If you only replace upload, keep `auth_url` in `config`. If you only replace auth, keep `upload_url` in `config`.
+
+For lower-level routing, import `SplitPowerSyncDriver`, `WriteExecutor`, and `defaultReadQueryClassifier` and compose your own Kysely `Dialect`. Pass `readQueryClassifier` to `PowerSyncDialect` or `RemotePowerSyncDialect` when your app needs different read/write routing.
+
+The default classifier uses Kysely's select AST when available, then falls back to SQL text after stripping leading comments.
+
+The default uploader sends a whole PowerSync CRUD transaction in one `POST`:
+
+```json
+{
+  "transactionId": 123,
+  "operations": [
+    { "op": "PUT", "table": "todos", "id": "todo-1", "data": { "title": "Ship it" } }
+  ]
+}
+```

package/examples/local-powersync.md

@@ -0,0 +1,50 @@
+# Local PowerSync Database
+
+Use this path when your process owns the PowerSync Node client.
+
+```ts
+import { Kysely } from "kysely";
+import { Schema, Table, column } from "@powersync/common";
+import {
+  PowerSyncDialect,
+  createConnectedPowerSyncDatabase,
+  openPowerSyncReadDatabase,
+} from "@zm2231/kysely-powersync-dialect";
+
+interface DB {
+  todos: {
+    id: string;
+    title: string;
+    done: number;
+  };
+}
+
+const schema = new Schema({
+  todos: new Table({
+    title: column.text,
+    done: column.integer,
+  }),
+});
+
+const config = {
+  powersync_url: "https://powersync.example.com",
+  auth_url: "https://api.example.com/api/auth/token",
+  upload_url: "https://api.example.com/api/data",
+  user_id: "user-123",
+  db_path: "./data/powersync.db",
+};
+
+const writeDatabase = await createConnectedPowerSyncDatabase(config, schema);
+const readDatabase = await openPowerSyncReadDatabase(config.db_path);
+
+const db = new Kysely<DB>({
+  dialect: new PowerSyncDialect({
+    readDatabase,
+    writeDatabase,
+  }),
+});
+
+const rows = await db.selectFrom("todos").selectAll().execute();
+```
+
+`createConnectedPowerSyncDatabase()` uses `auth_url` for credentials and `upload_url` for the default CRUD upload handler. Use [extension hooks](extension-hooks.md) when your app already owns those flows.

package/examples/remote-writes.md

@@ -0,0 +1,32 @@
+# Remote Writes
+
+Use `RemotePowerSyncDialect` when the process can read a local replica but writes must go through an HTTP service.
+
+```ts
+import { Kysely } from "kysely";
+import {
+  RemotePowerSyncDialect,
+  openPowerSyncReadDatabase,
+} from "@zm2231/kysely-powersync-dialect";
+
+const db = new Kysely({
+  dialect: new RemotePowerSyncDialect({
+    readDatabase: await openPowerSyncReadDatabase("./data/powersync.db"),
+    writeEndpoint: "https://api.example.com/kysely-write",
+    writeHeaders: { authorization: `Bearer ${token}` },
+  }),
+});
+```
+
+Kysely transactions are read-only in this dialect. Writes inside a Kysely transaction throw instead of pretending the split read/write paths are atomic.
+
+The default remote write body is:
+
+```json
+{
+  "sql": "insert into todos (id, title) values (?, ?)",
+  "params": ["todo-1", "Ship it"]
+}
+```
+
+Use `writeBody` and `mapResult` when your service needs a different protocol.

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@zm2231/kysely-powersync-dialect",
+  "version": "0.1.0",
+  "description": "A Kysely dialect for PowerSync Node clients backed by a local SQLite read replica.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Zain",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepack": "npm run build",
+    "pretest": "npm run build",
+    "test": "node --test test/*.test.js"
+  },
+  "engines": {
+    "node": ">=20.18.1"
+  },
+  "peerDependencies": {
+    "kysely": "^0.28.0"
+  },
+  "dependencies": {
+    "@powersync/common": "^1.50.0",
+    "@powersync/node": "^0.18.2",
+    "@types/better-sqlite3": "^7.6.13",
+    "better-sqlite3": "^12.8.0",
+    "cross-fetch": "^4.1.0",
+    "undici": "^7.11.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "kysely": "^0.28.8",
+    "typescript": "^5.9.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zm2231/kysely-powersync-dialect.git"
+  },
+  "homepage": "https://github.com/zm2231/kysely-powersync-dialect#readme",
+  "bugs": {
+    "url": "https://github.com/zm2231/kysely-powersync-dialect/issues"
+  },
+  "keywords": [
+    "kysely",
+    "kysely-dialect",
+    "powersync",
+    "sqlite",
+    "better-sqlite3",
+    "sync",
+    "offline-first"
+  ]
+}