@fedify/sqlite 2.0.0-dev.1604 → 2.0.0-dev.1641

package/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/sqlite",
-  "version": "2.0.0-dev.1604+23a1ea67",
+  "version": "2.0.0-dev.1641+6b0c942c",
   "license": "MIT",
   "exports": {
     ".": "./src/mod.ts",

package/dist/_virtual/rolldown_runtime.cjs

@@ -0,0 +1,42 @@
+
+        const { Temporal } = require("@js-temporal/polyfill");
+      
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+Object.defineProperty(exports, '__commonJS', {
+  enumerable: true,
+  get: function () {
+    return __commonJS;
+  }
+});
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});

package/dist/_virtual/rolldown_runtime.js

@@ -1,6 +1,6 @@
 
-      import { Temporal } from "@js-temporal/polyfill";
-    
+        import { Temporal } from "@js-temporal/polyfill";
+      
 //#region rolldown:runtime
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/dist/adapter.d.cts

@@ -0,0 +1,45 @@
+//#region src/adapter.d.ts
+/**
+ * SQLite database adapter.
+ *
+ * An abstract interface for SQLite database for different runtime environments.
+ */
+interface SqliteDatabaseAdapter {
+  /**
+   * Prepares a SQL statement.
+   * @param sql - The SQL statement to prepare.
+   */
+  prepare(sql: string): SqliteStatementAdapter;
+  /**
+   * Executes a SQL statement.
+   * @param sql - The SQL statement to execute.
+   */
+  exec(sql: string): void;
+  /**
+   * Closes the database connection.
+   */
+  close(): void;
+}
+interface SqliteStatementAdapter {
+  /**
+   * Executes a SQL statement and returns the number of changes made to the database.
+   * @param params - The parameters to bind to the SQL statement.
+   */
+  run(...params: unknown[]): {
+    changes: number;
+    lastInsertRowid: number;
+  };
+  /**
+   * Executes a SQL statement and returns the first row of the result set.
+   * @param params - The parameters to bind to the SQL statement.
+   * @returns The first row of the result set, or `undefined` if the result set is empty.
+   */
+  get(...params: unknown[]): unknown | undefined;
+  /**
+   * Executes a SQL statement and returns all rows of the result set.
+   * @param params - The parameters to bind to the SQL statement.
+   */
+  all(...params: unknown[]): unknown[];
+}
+//#endregion
+export { SqliteDatabaseAdapter, SqliteStatementAdapter };

package/dist/dist/sqlite.node.d.cts

@@ -0,0 +1,2 @@
+import { DatabaseSync } from "node:sqlite";
+export { DatabaseSync };

package/dist/kv.cjs

@@ -0,0 +1,189 @@
+
+        const { Temporal } = require("@js-temporal/polyfill");
+      
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_index_esm = require('./node_modules/.pnpm/@js-temporal_polyfill@0.5.1/node_modules/@js-temporal/polyfill/dist/index.esm.cjs');
+const __sqlite = require_rolldown_runtime.__toESM(require("#sqlite"));
+const __logtape_logtape = require_rolldown_runtime.__toESM(require("@logtape/logtape"));
+const es_toolkit = require_rolldown_runtime.__toESM(require("es-toolkit"));
+
+//#region src/kv.ts
+const logger = (0, __logtape_logtape.getLogger)([
+	"fedify",
+	"sqlite",
+	"kv"
+]);
+/**
+* A key–value store that uses SQLite as the underlying storage.
+*
+* @example
+* ```ts
+* import { createFederation } from "@fedify/fedify";
+* import { SqliteKvStore } from "@fedify/sqlite";
+* import { DatabaseSync } from "node:sqlite";
+*
+* const db = new DatabaseSync(":memory:");
+* const federation = createFederation({
+*   // ...
+*   kv: new SqliteKvStore(db),
+* });
+* ```
+*/
+var SqliteKvStore = class SqliteKvStore {
+	static #defaultTableName = "fedify_kv";
+	static #tableNameRegex = /^[A-Za-z_][A-Za-z0-9_]{0,63}$/;
+	#db;
+	#tableName;
+	#initialized;
+	/**
+	* Creates a new SQLite key–value store.
+	* @param db The SQLite database to use. Supports `node:sqlite` and `bun:sqlite`.
+	* @param options The options for the key–value store.
+	*/
+	constructor(db, options = {}) {
+		this.db = db;
+		this.options = options;
+		this.#db = new __sqlite.SqliteDatabase(db);
+		this.#initialized = options.initialized ?? false;
+		this.#tableName = options.tableName ?? SqliteKvStore.#defaultTableName;
+		if (!SqliteKvStore.#tableNameRegex.test(this.#tableName)) throw new Error(`Invalid table name for the key–value store: ${this.#tableName}`);
+	}
+	/**
+	* {@inheritDoc KvStore.get}
+	*/
+	async get(key) {
+		this.initialize();
+		const encodedKey = this.#encodeKey(key);
+		const now = require_index_esm.qi.Now.instant().epochMilliseconds;
+		const result = this.#db.prepare(`
+      SELECT value 
+      FROM "${this.#tableName}" 
+      WHERE key = ? AND (expires IS NULL OR expires > ?)
+    `).get(encodedKey, now);
+		if (!result) return void 0;
+		return this.#decodeValue(result.value);
+	}
+	/**
+	* {@inheritDoc KvStore.set}
+	*/
+	async set(key, value, options) {
+		this.initialize();
+		if (value === void 0) return;
+		const encodedKey = this.#encodeKey(key);
+		const encodedValue = this.#encodeValue(value);
+		const now = require_index_esm.qi.Now.instant().epochMilliseconds;
+		const expiresAt = options?.ttl !== void 0 ? now + options.ttl.total({ unit: "milliseconds" }) : null;
+		this.#db.prepare(`INSERT INTO "${this.#tableName}" (key, value, created, expires)
+        VALUES (?, ?, ?, ?)
+        ON CONFLICT(key) DO UPDATE SET
+          value = excluded.value,
+          expires = excluded.expires`).run(encodedKey, encodedValue, now, expiresAt);
+		this.#expire();
+		return;
+	}
+	/**
+	* {@inheritDoc KvStore.delete}
+	*/
+	async delete(key) {
+		this.initialize();
+		const encodedKey = this.#encodeKey(key);
+		this.#db.prepare(`
+      DELETE FROM "${this.#tableName}" WHERE key = ?
+    `).run(encodedKey);
+		this.#expire();
+		return Promise.resolve();
+	}
+	/**
+	* {@inheritDoc KvStore.cas}
+	*/
+	async cas(key, expectedValue, newValue, options) {
+		this.initialize();
+		const encodedKey = this.#encodeKey(key);
+		const now = require_index_esm.qi.Now.instant().epochMilliseconds;
+		const expiresAt = options?.ttl !== void 0 ? now + options.ttl.total({ unit: "milliseconds" }) : null;
+		try {
+			this.#db.exec("BEGIN IMMEDIATE");
+			const currentResult = this.#db.prepare(`
+          SELECT value 
+          FROM "${this.#tableName}" 
+          WHERE key = ? AND (expires IS NULL OR expires > ?)
+        `).get(encodedKey, now);
+			const currentValue = currentResult === void 0 ? void 0 : this.#decodeValue(currentResult.value);
+			if (!(0, es_toolkit.isEqual)(currentValue, expectedValue)) {
+				this.#db.exec("ROLLBACK");
+				return false;
+			}
+			if (newValue === void 0) this.#db.prepare(`
+            DELETE FROM "${this.#tableName}" WHERE key = ?
+          `).run(encodedKey);
+			else {
+				const newValueJson = this.#encodeValue(newValue);
+				this.#db.prepare(`
+          INSERT INTO "${this.#tableName}" (key, value, created, expires)
+          VALUES (?, ?, ?, ?)
+          ON CONFLICT(key) DO UPDATE SET
+            value = excluded.value,
+            expires = excluded.expires
+          `).run(encodedKey, newValueJson, now, expiresAt);
+			}
+			this.#db.exec("COMMIT");
+			this.#expire();
+			return true;
+		} catch (error) {
+			this.#db.exec("ROLLBACK");
+			throw error;
+		}
+	}
+	/**
+	* Creates the table used by the key–value store if it does not already exist.
+	* Does nothing if the table already exists.
+	*/
+	initialize() {
+		if (this.#initialized) return;
+		logger.debug("Initializing the key–value store table {tableName}...", { tableName: this.#tableName });
+		this.#db.exec(`
+      CREATE TABLE IF NOT EXISTS "${this.#tableName}" (
+        key TEXT PRIMARY KEY,
+        value TEXT NOT NULL,
+        created INTEGER NOT NULL,
+        expires INTEGER
+      )
+    `);
+		this.#db.exec(`
+      CREATE INDEX IF NOT EXISTS "idx_${this.#tableName}_expires" 
+      ON "${this.#tableName}" (expires)
+    `);
+		this.#initialized = true;
+		logger.debug("Initialized the key–value store table {tableName}.", { tableName: this.#tableName });
+	}
+	#expire() {
+		const now = require_index_esm.qi.Now.instant().epochMilliseconds;
+		this.#db.prepare(`
+      DELETE FROM "${this.#tableName}"
+      WHERE expires IS NOT NULL AND expires <= ?
+    `).run(now);
+	}
+	/**
+	* Drops the table used by the key–value store.  Does nothing if the table
+	* does not exist.
+	*/
+	drop() {
+		this.#db.exec(`DROP TABLE IF EXISTS "${this.#tableName}"`);
+		this.#initialized = false;
+	}
+	#encodeKey(key) {
+		return JSON.stringify(key);
+	}
+	#decodeKey(key) {
+		return JSON.parse(key);
+	}
+	#encodeValue(value) {
+		return JSON.stringify(value);
+	}
+	#decodeValue(value) {
+		return JSON.parse(value);
+	}
+};
+
+//#endregion
+exports.SqliteKvStore = SqliteKvStore;

package/dist/kv.d.cts

@@ -0,0 +1,76 @@
+import { DatabaseSync } from "./dist/sqlite.node.cjs";
+import { KvKey, KvStore, KvStoreSetOptions } from "@fedify/fedify";
+
+//#region src/kv.d.ts
+/**
+ * Options for the SQLite key–value store.
+ */
+interface SqliteKvStoreOptions {
+  /**
+   * The table name to use for the key–value store.
+   * Only letters, digits, and underscores are allowed.
+   * `"fedify_kv"` by default.
+   * @default `"fedify_kv"`
+   */
+  tableName?: string;
+  /**
+   * Whether the table has been initialized.  `false` by default.
+   * @default `false`
+   */
+  initialized?: boolean;
+}
+/**
+ * A key–value store that uses SQLite as the underlying storage.
+ *
+ * @example
+ * ```ts
+ * import { createFederation } from "@fedify/fedify";
+ * import { SqliteKvStore } from "@fedify/sqlite";
+ * import { DatabaseSync } from "node:sqlite";
+ *
+ * const db = new DatabaseSync(":memory:");
+ * const federation = createFederation({
+ *   // ...
+ *   kv: new SqliteKvStore(db),
+ * });
+ * ```
+ */
+declare class SqliteKvStore implements KvStore {
+  #private;
+  readonly db: DatabaseSync;
+  readonly options: SqliteKvStoreOptions;
+  /**
+   * Creates a new SQLite key–value store.
+   * @param db The SQLite database to use. Supports `node:sqlite` and `bun:sqlite`.
+   * @param options The options for the key–value store.
+   */
+  constructor(db: DatabaseSync, options?: SqliteKvStoreOptions);
+  /**
+   * {@inheritDoc KvStore.get}
+   */
+  get<T = unknown>(key: KvKey): Promise<T | undefined>;
+  /**
+   * {@inheritDoc KvStore.set}
+   */
+  set(key: KvKey, value: unknown, options?: KvStoreSetOptions): Promise<void>;
+  /**
+   * {@inheritDoc KvStore.delete}
+   */
+  delete(key: KvKey): Promise<void>;
+  /**
+   * {@inheritDoc KvStore.cas}
+   */
+  cas(key: KvKey, expectedValue: unknown, newValue: unknown, options?: KvStoreSetOptions): Promise<boolean>;
+  /**
+   * Creates the table used by the key–value store if it does not already exist.
+   * Does nothing if the table already exists.
+   */
+  initialize(): void;
+  /**
+   * Drops the table used by the key–value store.  Does nothing if the table
+   * does not exist.
+   */
+  drop(): void;
+}
+//#endregion
+export { SqliteKvStore, SqliteKvStoreOptions };

package/dist/kv.js

@@ -1,6 +1,6 @@
 
-      import { Temporal } from "@js-temporal/polyfill";
-    
+        import { Temporal } from "@js-temporal/polyfill";
+      
 import { qi } from "./node_modules/.pnpm/@js-temporal_polyfill@0.5.1/node_modules/@js-temporal/polyfill/dist/index.esm.js";
 import { SqliteDatabase } from "#sqlite";
 import { getLogger } from "@logtape/logtape";

package/dist/mod.cjs

@@ -0,0 +1,6 @@
+
+        const { Temporal } = require("@js-temporal/polyfill");
+      
+const require_kv = require('./kv.cjs');
+
+exports.SqliteKvStore = require_kv.SqliteKvStore;

package/dist/mod.d.cts

@@ -0,0 +1,2 @@
+import { SqliteKvStore } from "./kv.cjs";
+export { SqliteKvStore };

package/dist/mod.js

@@ -1,6 +1,6 @@
 
-      import { Temporal } from "@js-temporal/polyfill";
-    
+        import { Temporal } from "@js-temporal/polyfill";
+      
 import { SqliteKvStore } from "./kv.js";
 
 export { SqliteKvStore };