@syncular/dialect-libsql 0.0.1-60

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @syncular/dialect-libsql - LibSQL/Turso dialect for sync
+ *
+ * Provides a Kysely dialect for LibSQL/Turso with SerializePlugin
+ * for automatic JSON serialization/deserialization.
+ * SQLite-compatible — use with @syncular/server-dialect-sqlite.
+ */
+import { SerializePlugin } from '@syncular/core';
+import { Kysely, SqliteDialect } from 'kysely';
+import Database from 'libsql';
+type LibsqlNativeOptions = NonNullable<ConstructorParameters<typeof Database>[1]>;
+export interface LibsqlOptions {
+    /** LibSQL URL or local SQLite filename (e.g. `:memory:` or `./data.db`). */
+    url: string;
+    /** Auth token for remote databases (e.g. Turso). */
+    authToken?: string;
+    /**
+     * Optional sync URL for embedded replicas.
+     *
+     * When set, `Database.sync()` is called once during initialization.
+     */
+    syncUrl?: string;
+    /** Pass-through options to libsql-js. */
+    nativeOptions?: LibsqlNativeOptions;
+}
+/**
+ * Create a Kysely instance with LibSQL dialect and SerializePlugin.
+ *
+ * @example
+ * // Turso cloud
+ * const db = createLibsqlDb<MyDb>({
+ *   url: 'libsql://my-db-org.turso.io',
+ *   authToken: 'your-token',
+ * });
+ *
+ * // Local file / memory
+ * const db = createLibsqlDb<MyDb>({ url: ':memory:' });
+ * const db = createLibsqlDb<MyDb>({ url: './data.db' });
+ */
+export declare function createLibsqlDb<T>(options: LibsqlOptions): Kysely<T>;
+/**
+ * Create the LibSQL dialect directly (without SerializePlugin).
+ */
+export declare function createLibsqlDialect(options: LibsqlOptions): SqliteDialect;
+export declare function createSerializePlugin(): SerializePlugin;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,QAAQ,MAAM,QAAQ,CAAC;AAE9B,KAAK,mBAAmB,GAAG,WAAW,CACpC,qBAAqB,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAC1C,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC;IAEZ,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yCAAyC;IACzC,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,CAKnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAezE;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/index.js

@@ -0,0 +1,50 @@
+/**
+ * @syncular/dialect-libsql - LibSQL/Turso dialect for sync
+ *
+ * Provides a Kysely dialect for LibSQL/Turso with SerializePlugin
+ * for automatic JSON serialization/deserialization.
+ * SQLite-compatible — use with @syncular/server-dialect-sqlite.
+ */
+import { SerializePlugin } from '@syncular/core';
+import { Kysely, SqliteDialect } from 'kysely';
+import Database from 'libsql';
+/**
+ * Create a Kysely instance with LibSQL dialect and SerializePlugin.
+ *
+ * @example
+ * // Turso cloud
+ * const db = createLibsqlDb<MyDb>({
+ *   url: 'libsql://my-db-org.turso.io',
+ *   authToken: 'your-token',
+ * });
+ *
+ * // Local file / memory
+ * const db = createLibsqlDb<MyDb>({ url: ':memory:' });
+ * const db = createLibsqlDb<MyDb>({ url: './data.db' });
+ */
+export function createLibsqlDb(options) {
+    return new Kysely({
+        dialect: createLibsqlDialect(options),
+        plugins: [new SerializePlugin()],
+    });
+}
+/**
+ * Create the LibSQL dialect directly (without SerializePlugin).
+ */
+export function createLibsqlDialect(options) {
+    const { url, authToken, syncUrl, nativeOptions } = options;
+    const mergedOptions = {
+        ...nativeOptions,
+        ...(syncUrl ? { syncUrl } : {}),
+        ...(authToken ? { authToken } : {}),
+    };
+    const database = new Database(url, mergedOptions);
+    if (syncUrl) {
+        database.sync();
+    }
+    return new SqliteDialect({ database });
+}
+export function createSerializePlugin() {
+    return new SerializePlugin();
+}
+//# 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;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,QAAQ,MAAM,QAAQ,CAAC;AAwB9B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAI,OAAsB,EAAa;IACnE,OAAO,IAAI,MAAM,CAAI;QACnB,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC;QACrC,OAAO,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC;KACjC,CAAC,CAAC;AAAA,CACJ;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAsB,EAAiB;IACzE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IAE3D,MAAM,aAAa,GAAiD;QAClE,GAAG,aAAa;QAChB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAClD,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,EAAE,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;AAAA,CACxC;AAED,MAAM,UAAU,qBAAqB,GAAoB;IACvD,OAAO,IAAI,eAAe,EAAE,CAAC;AAAA,CAC9B"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@syncular/dialect-libsql",
+  "version": "0.0.1-60",
+  "description": "LibSQL/Turso dialect for the Syncular client",
+  "license": "MIT",
+  "author": "Benjamin Kniffler",
+  "homepage": "https://syncular.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/syncular/syncular.git",
+    "directory": "packages/dialect-libsql"
+  },
+  "bugs": {
+    "url": "https://github.com/syncular/syncular/issues"
+  },
+  "keywords": [
+    "sync",
+    "offline-first",
+    "realtime",
+    "database",
+    "typescript",
+    "libsql",
+    "turso",
+    "sqlite"
+  ],
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "scripts": {
+    "tsgo": "tsgo --noEmit",
+    "build": "rm -rf dist && tsgo",
+    "release": "bun pm pack --destination . && npm publish ./*.tgz --tag latest && rm -f ./*.tgz"
+  },
+  "dependencies": {
+    "@syncular/core": "0.0.1",
+    "libsql": "^0.5.22"
+  },
+  "peerDependencies": {
+    "kysely": "^0.28.0"
+  },
+  "devDependencies": {
+    "@syncular/config": "0.0.0",
+    "kysely": "*"
+  },
+  "files": [
+    "dist",
+    "src"
+  ]
+}

package/src/index.ts

@@ -0,0 +1,78 @@
+/**
+ * @syncular/dialect-libsql - LibSQL/Turso dialect for sync
+ *
+ * Provides a Kysely dialect for LibSQL/Turso with SerializePlugin
+ * for automatic JSON serialization/deserialization.
+ * SQLite-compatible — use with @syncular/server-dialect-sqlite.
+ */
+
+import { SerializePlugin } from '@syncular/core';
+import { Kysely, SqliteDialect } from 'kysely';
+import Database from 'libsql';
+
+type LibsqlNativeOptions = NonNullable<
+  ConstructorParameters<typeof Database>[1]
+>;
+
+export interface LibsqlOptions {
+  /** LibSQL URL or local SQLite filename (e.g. `:memory:` or `./data.db`). */
+  url: string;
+
+  /** Auth token for remote databases (e.g. Turso). */
+  authToken?: string;
+
+  /**
+   * Optional sync URL for embedded replicas.
+   *
+   * When set, `Database.sync()` is called once during initialization.
+   */
+  syncUrl?: string;
+
+  /** Pass-through options to libsql-js. */
+  nativeOptions?: LibsqlNativeOptions;
+}
+
+/**
+ * Create a Kysely instance with LibSQL dialect and SerializePlugin.
+ *
+ * @example
+ * // Turso cloud
+ * const db = createLibsqlDb<MyDb>({
+ *   url: 'libsql://my-db-org.turso.io',
+ *   authToken: 'your-token',
+ * });
+ *
+ * // Local file / memory
+ * const db = createLibsqlDb<MyDb>({ url: ':memory:' });
+ * const db = createLibsqlDb<MyDb>({ url: './data.db' });
+ */
+export function createLibsqlDb<T>(options: LibsqlOptions): Kysely<T> {
+  return new Kysely<T>({
+    dialect: createLibsqlDialect(options),
+    plugins: [new SerializePlugin()],
+  });
+}
+
+/**
+ * Create the LibSQL dialect directly (without SerializePlugin).
+ */
+export function createLibsqlDialect(options: LibsqlOptions): SqliteDialect {
+  const { url, authToken, syncUrl, nativeOptions } = options;
+
+  const mergedOptions: LibsqlNativeOptions & { authToken?: string } = {
+    ...nativeOptions,
+    ...(syncUrl ? { syncUrl } : {}),
+    ...(authToken ? { authToken } : {}),
+  };
+
+  const database = new Database(url, mergedOptions);
+  if (syncUrl) {
+    database.sync();
+  }
+
+  return new SqliteDialect({ database });
+}
+
+export function createSerializePlugin(): SerializePlugin {
+  return new SerializePlugin();
+}