@fedify/sqlite 2.0.0-dev.1690 → 2.0.0-dev.170

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright 2024–2025 Hong Minhee
+Copyright 2024–2026 Hong Minhee
 
 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

package/README.md

@@ -6,12 +6,12 @@
 
 This package provides a SQLite-based [`KvStore`] implementation for [Fedify].
 
-[JSR]: https://jsr.io/@fedify/sqlite
 [JSR badge]: https://jsr.io/badges/@fedify/sqlite
-[npm]: https://www.npmjs.com/package/@fedify/sqlite
+[JSR]: https://jsr.io/@fedify/sqlite
 [npm badge]: https://img.shields.io/npm/v/@fedify/sqlite?logo=npm
-[Fedify]: https://fedify.dev/
+[npm]: https://www.npmjs.com/package/@fedify/sqlite
 [`KvStore`]: https://jsr.io/@fedify/fedify/doc/federation/~/KvStore
+[Fedify]: https://fedify.dev/
 
 
 Usage

package/deno.json

@@ -1,14 +1,12 @@
 {
   "name": "@fedify/sqlite",
-  "version": "2.0.0-dev.1690+304896b8",
+  "version": "2.0.0-dev.170+a03fedcd",
   "license": "MIT",
   "exports": {
     ".": "./src/mod.ts",
     "./kv": "./src/kv.ts"
   },
   "imports": {
-    "@fedify/sqlite": "./src/mod.ts",
-    "@fedify/sqlite/": "./src/",
     "#sqlite": "./src/sqlite.node.ts"
   },
   "exclude": [
@@ -18,6 +16,7 @@
   ],
   "publish": {
     "exclude": [
+      "**/*.test.ts",
       "!dist/"
     ]
   },

package/dist/kv.cjs

@@ -3,7 +3,6 @@
       
 const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
 const __sqlite = require_rolldown_runtime.__toESM(require("#sqlite"));
-const __js_temporal_polyfill = require_rolldown_runtime.__toESM(require("@js-temporal/polyfill"));
 const __logtape_logtape = require_rolldown_runtime.__toESM(require("@logtape/logtape"));
 const es_toolkit = require_rolldown_runtime.__toESM(require("es-toolkit"));
 
@@ -54,10 +53,10 @@ var SqliteKvStore = class SqliteKvStore {
 	async get(key) {
 		this.initialize();
 		const encodedKey = this.#encodeKey(key);
-		const now = __js_temporal_polyfill.Temporal.Now.instant().epochMilliseconds;
+		const now = Temporal.Now.instant().epochMilliseconds;
 		const result = this.#db.prepare(`
-      SELECT value 
-      FROM "${this.#tableName}" 
+      SELECT value
+      FROM "${this.#tableName}"
       WHERE key = ? AND (expires IS NULL OR expires > ?)
     `).get(encodedKey, now);
 		if (!result) return void 0;
@@ -71,7 +70,7 @@ var SqliteKvStore = class SqliteKvStore {
 		if (value === void 0) return;
 		const encodedKey = this.#encodeKey(key);
 		const encodedValue = this.#encodeValue(value);
-		const now = __js_temporal_polyfill.Temporal.Now.instant().epochMilliseconds;
+		const now = Temporal.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 (?, ?, ?, ?)
@@ -99,13 +98,13 @@ var SqliteKvStore = class SqliteKvStore {
 	async cas(key, expectedValue, newValue, options) {
 		this.initialize();
 		const encodedKey = this.#encodeKey(key);
-		const now = __js_temporal_polyfill.Temporal.Now.instant().epochMilliseconds;
+		const now = Temporal.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}" 
+          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);
@@ -135,6 +134,36 @@ var SqliteKvStore = class SqliteKvStore {
 		}
 	}
 	/**
+	* {@inheritDoc KvStore.list}
+	* @since 1.10.0
+	*/
+	async *list(prefix) {
+		this.initialize();
+		const now = Temporal.Now.instant().epochMilliseconds;
+		let results;
+		if (prefix == null || prefix.length === 0) results = this.#db.prepare(`
+          SELECT key, value
+          FROM "${this.#tableName}"
+          WHERE expires IS NULL OR expires > ?
+          ORDER BY key
+        `).all(now);
+		else {
+			const pattern = JSON.stringify(prefix).slice(0, -1) + ",%";
+			const exactKey = JSON.stringify(prefix);
+			results = this.#db.prepare(`
+          SELECT key, value
+          FROM "${this.#tableName}"
+          WHERE (key LIKE ? ESCAPE '\\' OR key = ?)
+            AND (expires IS NULL OR expires > ?)
+          ORDER BY key
+        `).all(pattern, exactKey, now);
+		}
+		for (const row of results) yield {
+			key: this.#decodeKey(row.key),
+			value: this.#decodeValue(row.value)
+		};
+	}
+	/**
 	* Creates the table used by the key–value store if it does not already exist.
 	* Does nothing if the table already exists.
 	*/
@@ -150,14 +179,14 @@ var SqliteKvStore = class SqliteKvStore {
       )
     `);
 		this.#db.exec(`
-      CREATE INDEX IF NOT EXISTS "idx_${this.#tableName}_expires" 
+      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 = __js_temporal_polyfill.Temporal.Now.instant().epochMilliseconds;
+		const now = Temporal.Now.instant().epochMilliseconds;
 		this.#db.prepare(`
       DELETE FROM "${this.#tableName}"
       WHERE expires IS NOT NULL AND expires <= ?

package/dist/kv.d.cts

@@ -1,5 +1,5 @@
 import { DatabaseSync } from "./dist/sqlite.node.cjs";
-import { KvKey, KvStore, KvStoreSetOptions } from "@fedify/fedify";
+import { KvKey, KvStore, KvStoreListEntry, KvStoreSetOptions } from "@fedify/fedify";
 
 //#region src/kv.d.ts
 /**
@@ -12,12 +12,12 @@ interface SqliteKvStoreOptions {
    * `"fedify_kv"` by default.
    * @default `"fedify_kv"`
    */
-  tableName?: string;
+  readonly tableName?: string;
   /**
    * Whether the table has been initialized.  `false` by default.
    * @default `false`
    */
-  initialized?: boolean;
+  readonly initialized?: boolean;
 }
 /**
  * A key–value store that uses SQLite as the underlying storage.
@@ -61,6 +61,11 @@ declare class SqliteKvStore implements KvStore {
    * {@inheritDoc KvStore.cas}
    */
   cas(key: KvKey, expectedValue: unknown, newValue: unknown, options?: KvStoreSetOptions): Promise<boolean>;
+  /**
+   * {@inheritDoc KvStore.list}
+   * @since 1.10.0
+   */
+  list(prefix?: KvKey): AsyncIterable<KvStoreListEntry>;
   /**
    * Creates the table used by the key–value store if it does not already exist.
    * Does nothing if the table already exists.

package/dist/kv.d.ts

@@ -1,6 +1,6 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { PlatformDatabase } from "#sqlite";
-import { KvKey, KvStore, KvStoreSetOptions } from "@fedify/fedify";
+import { KvKey, KvStore, KvStoreListEntry, KvStoreSetOptions } from "@fedify/fedify";
 
 //#region src/kv.d.ts
 /**
@@ -13,12 +13,12 @@ interface SqliteKvStoreOptions {
    * `"fedify_kv"` by default.
    * @default `"fedify_kv"`
    */
-  tableName?: string;
+  readonly tableName?: string;
   /**
    * Whether the table has been initialized.  `false` by default.
    * @default `false`
    */
-  initialized?: boolean;
+  readonly initialized?: boolean;
 }
 /**
  * A key–value store that uses SQLite as the underlying storage.
@@ -62,6 +62,11 @@ declare class SqliteKvStore implements KvStore {
    * {@inheritDoc KvStore.cas}
    */
   cas(key: KvKey, expectedValue: unknown, newValue: unknown, options?: KvStoreSetOptions): Promise<boolean>;
+  /**
+   * {@inheritDoc KvStore.list}
+   * @since 1.10.0
+   */
+  list(prefix?: KvKey): AsyncIterable<KvStoreListEntry>;
   /**
    * Creates the table used by the key–value store if it does not already exist.
    * Does nothing if the table already exists.

package/dist/kv.js

@@ -2,7 +2,6 @@
         import { Temporal } from "@js-temporal/polyfill";
       
 import { SqliteDatabase } from "#sqlite";
-import { Temporal } from "@js-temporal/polyfill";
 import { getLogger } from "@logtape/logtape";
 import { isEqual } from "es-toolkit";
 
@@ -55,8 +54,8 @@ var SqliteKvStore = class SqliteKvStore {
 		const encodedKey = this.#encodeKey(key);
 		const now = Temporal.Now.instant().epochMilliseconds;
 		const result = this.#db.prepare(`
-      SELECT value 
-      FROM "${this.#tableName}" 
+      SELECT value
+      FROM "${this.#tableName}"
       WHERE key = ? AND (expires IS NULL OR expires > ?)
     `).get(encodedKey, now);
 		if (!result) return void 0;
@@ -103,8 +102,8 @@ var SqliteKvStore = class SqliteKvStore {
 		try {
 			this.#db.exec("BEGIN IMMEDIATE");
 			const currentResult = this.#db.prepare(`
-          SELECT value 
-          FROM "${this.#tableName}" 
+          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);
@@ -134,6 +133,36 @@ var SqliteKvStore = class SqliteKvStore {
 		}
 	}
 	/**
+	* {@inheritDoc KvStore.list}
+	* @since 1.10.0
+	*/
+	async *list(prefix) {
+		this.initialize();
+		const now = Temporal.Now.instant().epochMilliseconds;
+		let results;
+		if (prefix == null || prefix.length === 0) results = this.#db.prepare(`
+          SELECT key, value
+          FROM "${this.#tableName}"
+          WHERE expires IS NULL OR expires > ?
+          ORDER BY key
+        `).all(now);
+		else {
+			const pattern = JSON.stringify(prefix).slice(0, -1) + ",%";
+			const exactKey = JSON.stringify(prefix);
+			results = this.#db.prepare(`
+          SELECT key, value
+          FROM "${this.#tableName}"
+          WHERE (key LIKE ? ESCAPE '\\' OR key = ?)
+            AND (expires IS NULL OR expires > ?)
+          ORDER BY key
+        `).all(pattern, exactKey, now);
+		}
+		for (const row of results) yield {
+			key: this.#decodeKey(row.key),
+			value: this.#decodeValue(row.value)
+		};
+	}
+	/**
 	* Creates the table used by the key–value store if it does not already exist.
 	* Does nothing if the table already exists.
 	*/
@@ -149,7 +178,7 @@ var SqliteKvStore = class SqliteKvStore {
       )
     `);
 		this.#db.exec(`
-      CREATE INDEX IF NOT EXISTS "idx_${this.#tableName}_expires" 
+      CREATE INDEX IF NOT EXISTS "idx_${this.#tableName}_expires"
       ON "${this.#tableName}" (expires)
     `);
 		this.#initialized = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/sqlite",
-  "version": "2.0.0-dev.1690+304896b8",
+  "version": "2.0.0-dev.170+a03fedcd",
   "description": "SQLite drivers for Fedify",
   "keywords": [
     "fedify",
@@ -58,16 +58,16 @@
   },
   "dependencies": {
     "@js-temporal/polyfill": "^0.5.1",
-    "@logtape/logtape": "^1.0.0",
+    "@logtape/logtape": "^2.0.0",
     "es-toolkit": "^1.31.0"
   },
   "peerDependencies": {
-    "@fedify/fedify": "^2.0.0-dev.1690+304896b8"
+    "@fedify/fedify": "^2.0.0-dev.170+a03fedcd"
   },
   "devDependencies": {
     "@std/async": "npm:@jsr/std__async@^1.0.13",
     "tsdown": "^0.12.9",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.3"
   },
   "scripts": {
     "build": "tsdown",

package/src/kv.test.ts

@@ -1,9 +1,9 @@
 import { PlatformDatabase } from "#sqlite";
+import { SqliteKvStore } from "@fedify/sqlite/kv";
 import * as temporal from "@js-temporal/polyfill";
 import { delay } from "@std/async/delay";
 import assert from "node:assert/strict";
 import { test } from "node:test";
-import { SqliteKvStore } from "./kv.ts";
 
 let Temporal: typeof temporal.Temporal;
 if ("Temporal" in globalThis) {
@@ -31,7 +31,7 @@ test("SqliteKvStore.initialize()", async () => {
   try {
     await store.initialize();
     const result = await db.prepare(`
-      SELECT name FROM sqlite_master 
+      SELECT name FROM sqlite_master
       WHERE type='table' AND name=?
     `).get(tableName);
     assert(result !== undefined);
@@ -180,7 +180,7 @@ test("SqliteKvStore.drop()", async () => {
   try {
     await store.drop();
     const result = await db.prepare(`
-      SELECT name FROM sqlite_master 
+      SELECT name FROM sqlite_master
       WHERE type='table' AND name=?
     `).get(tableName);
     // Bun returns null, Node returns undefined
@@ -310,3 +310,96 @@ test("SqliteKvStore.set() - preserves created timestamp on update", async () =>
     await db.close();
   }
 });
+
+test("SqliteKvStore.list()", async () => {
+  const { db, store } = getStore();
+  try {
+    await store.set(["prefix", "a"], "value-a");
+    await store.set(["prefix", "b"], "value-b");
+    await store.set(["prefix", "nested", "c"], "value-c");
+    await store.set(["other", "x"], "value-x");
+
+    const entries: { key: readonly string[]; value: unknown }[] = [];
+    for await (const entry of store.list(["prefix"])) {
+      entries.push({ key: entry.key, value: entry.value });
+    }
+
+    assert.strictEqual(entries.length, 3);
+    assert(
+      entries.some((e) => e.key[1] === "a" && e.value === "value-a"),
+    );
+    assert(entries.some((e) => e.key[1] === "b"));
+    assert(entries.some((e) => e.key[1] === "nested"));
+  } finally {
+    await store.drop();
+    await db.close();
+  }
+});
+
+test("SqliteKvStore.list() - excludes expired", async () => {
+  const { db, tableName, store } = getStore();
+  try {
+    await store.initialize();
+    const now = Temporal.Now.instant().epochMilliseconds;
+
+    // Insert expired entry directly
+    db.prepare(`
+      INSERT INTO "${tableName}" (key, value, created, expires)
+      VALUES (?, ?, ?, ?)
+    `).run(
+      JSON.stringify(["list-test", "expired"]),
+      JSON.stringify("expired-value"),
+      now - 1000,
+      now - 500,
+    );
+    await store.set(["list-test", "valid"], "valid-value");
+
+    const entries: { key: readonly string[]; value: unknown }[] = [];
+    for await (const entry of store.list(["list-test"])) {
+      entries.push({ key: entry.key, value: entry.value });
+    }
+
+    assert.strictEqual(entries.length, 1);
+    assert.deepStrictEqual(entries[0].key, ["list-test", "valid"]);
+  } finally {
+    await store.drop();
+    await db.close();
+  }
+});
+
+test("SqliteKvStore.list() - single element key", async () => {
+  const { db, store } = getStore();
+  try {
+    await store.set(["a"], "value-a");
+    await store.set(["b"], "value-b");
+
+    const entries: { key: readonly string[]; value: unknown }[] = [];
+    for await (const entry of store.list(["a"])) {
+      entries.push({ key: entry.key, value: entry.value });
+    }
+
+    assert.strictEqual(entries.length, 1);
+  } finally {
+    await store.drop();
+    await db.close();
+  }
+});
+
+test("SqliteKvStore.list() - empty prefix", async () => {
+  const { db, store } = getStore();
+  try {
+    await store.set(["a"], "value-a");
+    await store.set(["b", "c"], "value-bc");
+    await store.set(["d", "e", "f"], "value-def");
+
+    const entries: { key: readonly string[]; value: unknown }[] = [];
+    for await (const entry of store.list()) {
+      entries.push({ key: entry.key, value: entry.value });
+    }
+
+    assert.strictEqual(entries.length, 3);
+  } finally {
+    await store.drop();
+    await db.close();
+  }
+});

package/src/kv.ts

@@ -1,6 +1,10 @@
 import { type PlatformDatabase, SqliteDatabase } from "#sqlite";
-import type { KvKey, KvStore, KvStoreSetOptions } from "@fedify/fedify";
-import { Temporal } from "@js-temporal/polyfill";
+import type {
+  KvKey,
+  KvStore,
+  KvStoreListEntry,
+  KvStoreSetOptions,
+} from "@fedify/fedify";
 import { getLogger } from "@logtape/logtape";
 import { isEqual } from "es-toolkit";
 import type { SqliteDatabaseAdapter } from "./adapter.ts";
@@ -17,13 +21,13 @@ export interface SqliteKvStoreOptions {
    * `"fedify_kv"` by default.
    * @default `"fedify_kv"`
    */
-  tableName?: string;
+  readonly tableName?: string;
 
   /**
    * Whether the table has been initialized.  `false` by default.
    * @default `false`
    */
-  initialized?: boolean;
+  readonly initialized?: boolean;
 }
 
 /**
@@ -81,8 +85,8 @@ export class SqliteKvStore implements KvStore {
 
     const result = this.#db
       .prepare(`
-      SELECT value 
-      FROM "${this.#tableName}" 
+      SELECT value
+      FROM "${this.#tableName}"
       WHERE key = ? AND (expires IS NULL OR expires > ?)
     `)
       .get(encodedKey, now);
@@ -170,8 +174,8 @@ export class SqliteKvStore implements KvStore {
 
       const currentResult = this.#db
         .prepare(`
-          SELECT value 
-          FROM "${this.#tableName}" 
+          SELECT value
+          FROM "${this.#tableName}"
           WHERE key = ? AND (expires IS NULL OR expires > ?)
         `)
         .get(encodedKey, now) as { value: string } | undefined;
@@ -213,6 +217,51 @@ export class SqliteKvStore implements KvStore {
     }
   }
 
+  /**
+   * {@inheritDoc KvStore.list}
+   * @since 1.10.0
+   */
+  async *list(prefix?: KvKey): AsyncIterable<KvStoreListEntry> {
+    this.initialize();
+
+    const now = Temporal.Now.instant().epochMilliseconds;
+
+    let results: { key: string; value: string }[];
+
+    if (prefix == null || prefix.length === 0) {
+      // Empty prefix: return all entries
+      results = this.#db
+        .prepare(`
+          SELECT key, value
+          FROM "${this.#tableName}"
+          WHERE expires IS NULL OR expires > ?
+          ORDER BY key
+        `)
+        .all(now) as { key: string; value: string }[];
+    } else {
+      // JSON pattern: '["prefix","' matches keys starting with prefix
+      const pattern = JSON.stringify(prefix).slice(0, -1) + ",%";
+      const exactKey = JSON.stringify(prefix);
+
+      results = this.#db
+        .prepare(`
+          SELECT key, value
+          FROM "${this.#tableName}"
+          WHERE (key LIKE ? ESCAPE '\\' OR key = ?)
+            AND (expires IS NULL OR expires > ?)
+          ORDER BY key
+        `)
+        .all(pattern, exactKey, now) as { key: string; value: string }[];
+    }
+
+    for (const row of results) {
+      yield {
+        key: this.#decodeKey(row.key),
+        value: this.#decodeValue(row.value),
+      };
+    }
+  }
+
   /**
    * Creates the table used by the key–value store if it does not already exist.
    * Does nothing if the table already exists.
@@ -236,7 +285,7 @@ export class SqliteKvStore implements KvStore {
     `);
 
     this.#db.exec(`
-      CREATE INDEX IF NOT EXISTS "idx_${this.#tableName}_expires" 
+      CREATE INDEX IF NOT EXISTS "idx_${this.#tableName}_expires"
       ON "${this.#tableName}" (expires)
     `);