extra-disk-store 0.5.1 → 0.7.0

package/lib/disk-store.js

@@ -1,45 +1,92 @@
+import path from 'path';
+import Database from 'better-sqlite3';
+import { findMigrationFilenames, readMigrationFile } from 'migration-files';
+import { migrate } from '@blackglory/better-sqlite3-migrations';
+import { go, assert } from '@blackglory/prelude';
+import { map } from 'extra-promise';
+import { findUpPackageFilename } from 'extra-filesystem';
 import * as Iter from 'iterable-operator';
-import * as LMDB from 'lmdb';
-import { createTempNameSync, remove } from 'extra-filesystem';
-import { isUndefined } from '@blackglory/prelude';
+import { withLazyStatic, lazyStatic } from 'extra-lazy';
+import { fileURLToPath } from 'url';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
 export class DiskStore {
-    constructor(dirname) {
-        if (isUndefined(dirname)) {
-            this._dirname = createTempNameSync();
-            this.isTempPathname = true;
-        }
-        else {
-            this._dirname = dirname;
-            this.isTempPathname = false;
-        }
-        this._db = LMDB.open(this._dirname, {
-            encoding: 'binary',
-            compression: false
+    constructor(_db) {
+        this._db = _db;
+        this.has = withLazyStatic((key) => {
+            const row = lazyStatic(() => this._db.prepare(`
+      SELECT EXISTS(
+               SELECT *
+                 FROM store
+                WHERE key = $key
+             ) AS item_exists
+    `), [this._db]).get({ key });
+            return row.item_exists === 1;
+        });
+        this.get = withLazyStatic((key) => {
+            const row = lazyStatic(() => this._db.prepare(`
+      SELECT value
+        FROM store
+       WHERE key = $key
+    `), [this._db]).get({ key });
+            return row === null || row === void 0 ? void 0 : row.value;
+        });
+        this.set = withLazyStatic((key, value) => {
+            lazyStatic(() => this._db.prepare(`
+      INSERT INTO store (
+                    key
+                  , value
+                  )
+           VALUES ($key, $value)
+               ON CONFLICT(key)
+               DO UPDATE SET value = $value
+    `), [this._db]).run({
+                key,
+                value
+            });
+        });
+        this.delete = withLazyStatic((key) => {
+            lazyStatic(() => this._db.prepare(`
+      DELETE FROM store
+       WHERE key = $key
+    `), [this._db]).run({ key });
+        });
+        this.clear = withLazyStatic(() => {
+            lazyStatic(() => this._db.prepare(`
+      DELETE FROM store
+    `), [this._db]).run();
+        });
+        this.keys = withLazyStatic(() => {
+            const iter = lazyStatic(() => this._db.prepare(`
+      SELECT key
+        FROM store
+    `), [this._db]).iterate();
+            return Iter.map(iter, ({ key }) => key);
         });
     }
-    async close() {
-        await this._db.close();
-        if (this.isTempPathname) {
-            await remove(this._dirname);
+    static async create(filename) {
+        const db = await go(async () => {
+            const db = new Database(filename !== null && filename !== void 0 ? filename : ':memory:');
+            await migrateDatabase(db);
+            db.unsafeMode(true);
+            return db;
+        });
+        return new this(db);
+        async function migrateDatabase(db) {
+            const packageFilename = await findUpPackageFilename(__dirname);
+            assert(packageFilename, 'package.json not found');
+            const packageRoot = path.dirname(packageFilename);
+            const migrationsPath = path.join(packageRoot, 'migrations');
+            const migrationFilenames = await findMigrationFilenames(migrationsPath);
+            const migrations = await map(migrationFilenames, readMigrationFile);
+            migrate(db, migrations);
         }
     }
-    has(key) {
-        return this._db.doesExist(key);
-    }
-    get(key) {
-        return this._db.getBinary(key);
-    }
-    async set(key, value) {
-        await this._db.put(key, value);
-    }
-    async delete(key) {
-        await this._db.remove(key);
-    }
-    async clear() {
-        await this._db.clearAsync();
-    }
-    keys() {
-        return Iter.map(this._db.getKeys(), key => key);
+    close() {
+        this._db.exec(`
+      PRAGMA analysis_limit=400;
+      PRAGMA optimize;
+    `);
+        this._db.close();
     }
 }
 //# sourceMappingURL=disk-store.js.map

package/lib/disk-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"disk-store.js","sourceRoot":"","sources":["../src/disk-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAA;AACzC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEjD,MAAM,OAAO,SAAS;IAKpB,YAAY,OAAgB;QAC1B,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE;YACxB,IAAI,CAAC,QAAQ,GAAG,kBAAkB,EAAE,CAAA;YACpC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;SAC3B;aAAM;YACL,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAA;YACvB,IAAI,CAAC,cAAc,GAAG,KAAK,CAAA;SAC5B;QAED,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAiB,IAAI,CAAC,QAAQ,EAAE;YAGlD,QAAQ,EAAE,QAAQ;YAClB,WAAW,EAAE,KAAK;SACnB,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;QAEtB,IAAI,IAAI,CAAC,cAAc,EAAE;YACvB,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;SAC5B;IACH,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAChC,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAa;QAClC,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAChC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAA;IAC7B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,GAAa,CAAC,CAAA;IAC3D,CAAC;CACF"}
+{"version":3,"file":"disk-store.js","sourceRoot":"","sources":["../src/disk-store.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -1,4 +1,6 @@
 export * from './disk-store.js';
-export { DiskStoreWithCache, ICache } from './disk-store-with-cache.js';
-export { DiskStoreView, IKeyConverter, IValueConverter } from './disk-store-view.js';
+export * from './disk-store-with-cache.js';
+export * from './disk-store-view.js';
+export * from './disk-store-async-view.js';
+export * from './types.js';
 export * from './converters/index.js';

package/lib/index.js

@@ -1,5 +1,7 @@
 export * from './disk-store.js';
-export { DiskStoreWithCache } from './disk-store-with-cache.js';
-export { DiskStoreView } from './disk-store-view.js';
+export * from './disk-store-with-cache.js';
+export * from './disk-store-view.js';
+export * from './disk-store-async-view.js';
+export * from './types.js';
 export * from './converters/index.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,kBAAkB,EAAU,MAAM,4BAA4B,CAAA;AACvE,OAAO,EAAE,aAAa,EAAkC,MAAM,sBAAsB,CAAA;AACpF,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,YAAY,CAAA;AAC1B,cAAc,uBAAuB,CAAA"}

package/lib/types.d.ts

@@ -1,16 +1,18 @@
 /// <reference types="node" resolution-mode="require"/>
 import { Awaitable } from '@blackglory/prelude';
-export interface ICache {
-    set(key: string, value: Buffer | boolean | undefined): void;
-    get(key: string): Buffer | boolean | undefined;
-    delete(key: string): void;
-    clear(): void;
-}
 export interface IKeyConverter<T> {
+    toString: (value: T) => string;
+    fromString: (value: string) => T | undefined;
+}
+export interface IValueConverter<T> {
+    toBuffer: (value: T) => Buffer;
+    fromBuffer: (value: Buffer) => T;
+}
+export interface IKeyAsyncConverter<T> {
     toString: (value: T) => Awaitable<string>;
     fromString: (value: string) => Awaitable<T | undefined>;
 }
-export interface IValueConverter<T> {
+export interface IValueAsyncConverter<T> {
     toBuffer: (value: T) => Awaitable<Buffer>;
     fromBuffer: (value: Buffer) => Awaitable<T>;
 }

package/migrations/001-initial.sql

@@ -0,0 +1,19 @@
+--------------------------------------------------------------------------------
+-- Up
+--------------------------------------------------------------------------------
+
+-- 在WAL模式下, better-sqlite3可充分发挥性能
+PRAGMA journal_mode = WAL;
+
+CREATE TABLE store (
+  key          TEXT    NOT NULL UNIQUE
+, value        BLOB    NOT NULL
+) STRICT;
+
+--------------------------------------------------------------------------------
+-- Down
+--------------------------------------------------------------------------------
+
+PRAGMA journal_mode = DELETE;
+
+DROP TABLE store;

package/migrations/schema.sql

@@ -0,0 +1,7 @@
+-- 在WAL模式下, better-sqlite3可充分发挥性能
+PRAGMA journal_mode = WAL;
+
+CREATE TABLE store (
+  key          TEXT    NOT NULL UNIQUE
+, value        BLOB    NOT NULL
+) STRICT;

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "extra-disk-store",
-  "version": "0.5.1",
+  "version": "0.7.0",
   "description": "",
   "keywords": [],
   "files": [
     "lib",
-    "src"
+    "src",
+    "migrations"
   ],
   "type": "module",
   "main": "lib/index.js",
@@ -15,17 +16,16 @@
   "license": "MIT",
   "sideEffects": false,
   "engines": {
-    "node": ">=16"
+    "node": ">=18.17.0"
   },
   "scripts": {
     "prepare": "ts-patch install -s",
     "lint": "eslint --ext .js,.jsx,.ts,.tsx --quiet src __tests__",
-    "test": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --config jest.config.cjs",
-    "test:coverage": "cross-env NODE_OPTIONS=--experimental-vm-modules jest --coverage --config jest.config.cjs",
+    "test": "vitest --run",
     "prepublishOnly": "run-s prepare clean build",
     "clean": "rimraf lib",
     "build": "tsc --project tsconfig.build.json",
-    "bench": "ts-node --esm --require tsconfig-paths/register benches/index.ts",
+    "bench": "tsx benches/index.ts",
     "release": "standard-version"
   },
   "husky": {
@@ -35,39 +35,39 @@
     }
   },
   "devDependencies": {
-    "@blackglory/jest-resolver": "^0.3.0",
-    "@blackglory/structures": "^0.13.1",
-    "@commitlint/cli": "^17.4.4",
-    "@commitlint/config-conventional": "^17.4.4",
-    "@types/jest": "^29.4.0",
-    "@types/node": "16",
-    "@typescript-eslint/eslint-plugin": "^5.54.1",
-    "@typescript-eslint/parser": "^5.54.1",
+    "@blackglory/structures": "^0.13.4",
+    "@commitlint/cli": "^18.6.1",
+    "@commitlint/config-conventional": "^18.6.2",
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/node": "18",
+    "@typescript-eslint/eslint-plugin": "^7.0.1",
+    "@typescript-eslint/parser": "^7.0.1",
     "cross-env": "^7.0.3",
-    "eslint": "^8.36.0",
+    "eslint": "^8.56.0",
     "husky": "^4.3.0",
-    "jest": "^29.5.0",
-    "jest-resolve": "^29.5.0",
     "npm-run-all": "^4.1.5",
-    "pretty-bytes": "6.1.0",
-    "rimraf": "^3.0.2",
+    "rimraf": "^5.0.5",
     "standard-version": "^9.5.0",
-    "ts-jest": "^29.0.5",
-    "ts-node": "^10.9.1",
-    "ts-patch": "^2.1.0",
-    "tsconfig-paths": "^4.1.2",
-    "typescript": "4.8",
-    "typescript-transform-paths": "^3.4.6"
+    "ts-patch": "^3.1.2",
+    "tsx": "^4.7.1",
+    "typescript": "5.3.3",
+    "typescript-transform-paths": "^3.4.6",
+    "vite": "^5.4.7",
+    "vite-tsconfig-paths": "^5.0.1",
+    "vitest": "^2.1.1"
   },
   "dependencies": {
-    "@blackglory/prelude": "^0.3.1",
-    "@mongodb-js/zstd": "^1.1.0",
-    "extra-benchmark": "^0.2.2",
-    "extra-filesystem": "^0.4.10",
-    "extra-promise": "^6.0.3",
-    "extra-utils": "^5.1.0",
-    "iterable-operator": "^4.0.3",
-    "lmdb": "^2.7.10",
-    "lz4-wasm-nodejs": "^0.9.2"
+    "@blackglory/better-sqlite3-migrations": "^0.1.18",
+    "@blackglory/prelude": "^0.3.4",
+    "@mongodb-js/zstd": "^1.2.0",
+    "better-sqlite3": "^11.3.0",
+    "extra-benchmark": "^0.2.3",
+    "extra-filesystem": "^0.5.1",
+    "extra-lazy": "^2.0.2",
+    "extra-promise": "^6.2.0",
+    "extra-utils": "^5.6.0",
+    "iterable-operator": "^5.0.0",
+    "lz4-wasm-nodejs": "^0.9.2",
+    "migration-files": "^0.4.3"
   }
 }

package/src/converters/lz4-value-converter.ts

@@ -1,11 +1,27 @@
 import * as lz4 from 'lz4-wasm-nodejs'
-import { IValueConverter } from '@src/types.js'
+import { IValueConverter, IValueAsyncConverter } from '@src/types.js'
 
 export class LZ4ValueConverter<T> implements IValueConverter<T> {
   constructor(
     private valueConverter: IValueConverter<T>
   ) {}
 
+  toBuffer(value: T): Buffer {
+    const buffer = this.valueConverter.toBuffer(value)
+    return Buffer.from(lz4.compress(buffer))
+  }
+
+  fromBuffer(value: Buffer): T {
+    const buffer = Buffer.from(lz4.decompress(value))
+    return this.valueConverter.fromBuffer(buffer)
+  }
+}
+
+export class LZ4ValueAsyncConverter<T> implements IValueAsyncConverter<T> {
+  constructor(
+    private valueConverter: IValueConverter<T> | IValueAsyncConverter<T>
+  ) {}
+
   async toBuffer(value: T): Promise<Buffer> {
     const buffer = await this.valueConverter.toBuffer(value)
     return Buffer.from(lz4.compress(buffer))

package/src/converters/prefix-key-converter.ts

@@ -1,11 +1,32 @@
-import { IKeyConverter } from '@src/types.js'
+import { IKeyConverter, IKeyAsyncConverter } from '@src/types.js'
 
-export class PrefixKeyConverter<T> implements IKeyConverter<T> {
+export class PrefixKeyConverter<T> implements IKeyConverter<T>, IKeyAsyncConverter<T> {
   constructor(
     private keyConverter: IKeyConverter<T>
   , private prefix: string
   ) {}
 
+  toString(value: T): string {
+    const key = this.keyConverter.toString(value)
+    return this.prefix + key
+  }
+
+  fromString(value: string): T | undefined {
+    if (value.startsWith(this.prefix)) {
+      const key = this.keyConverter.fromString(value.slice(this.prefix.length))
+      return key
+    } else {
+      return undefined
+    }
+  }
+}
+
+export class PrefixKeyAsyncConverter<T> implements IKeyAsyncConverter<T> {
+  constructor(
+    private keyConverter: IKeyConverter<T> | IKeyAsyncConverter<T>
+  , private prefix: string
+  ) {}
+
   async toString(value: T): Promise<string> {
     const key = await this.keyConverter.toString(value)
     return this.prefix + key

package/src/converters/zstandard-value-converter.ts

@@ -1,9 +1,9 @@
 import * as zstd from '@mongodb-js/zstd'
-import { IValueConverter } from '@src/types.js'
+import { IValueConverter, IValueAsyncConverter } from '@src/types.js'
 
-export class ZstandardValueConverter<T> implements IValueConverter<T> {
+export class ZstandardValueAsyncConverter<T> implements IValueAsyncConverter<T> {
   constructor(
-    private valueConverter: IValueConverter<T>
+    private valueConverter: IValueConverter<T> | IValueAsyncConverter<T>
   , private level: number
   ) {}
 

package/src/disk-store-async-view.ts

@@ -0,0 +1,53 @@
+import { DiskStore } from '@src/disk-store.js'
+import { DiskStoreWithCache } from '@src/disk-store-with-cache.js'
+import { pipe } from 'extra-utils'
+import { mapAsync, filterAsync } from 'iterable-operator'
+import { isntUndefined } from '@blackglory/prelude'
+import { IKeyAsyncConverter, IValueAsyncConverter } from './types.js'
+
+export class DiskStoreAsyncView<K, V> {
+  constructor(
+    private store: DiskStore | DiskStoreWithCache
+  , private keyConverter: IKeyAsyncConverter<K>
+  , private valueConverter: IValueAsyncConverter<V>
+  ) {}
+
+  async has(key: K): Promise<boolean> {
+    return this.store.has(await this.keyConverter.toString(key))
+  }
+
+  async get(key: K): Promise<V | undefined> {
+    const buffer = this.store.get(await this.keyConverter.toString(key))
+
+    if (buffer) {
+      return this.valueConverter.fromBuffer(buffer)
+    } else {
+      return undefined
+    }
+  }
+
+  async set(key: K, value: V): Promise<void> {
+    this.store.set(
+      ...await Promise.all([
+        await this.keyConverter.toString(key)
+      , await this.valueConverter.toBuffer(value)
+      ])
+    )
+  }
+
+  async delete(key: K): Promise<void> {
+    this.store.delete(await this.keyConverter.toString(key))
+  }
+
+  clear(): void {
+    this.store.clear()
+  }
+
+  keys(): AsyncIterableIterator<K> {
+    return pipe(
+      this.store.keys()
+    , iter => mapAsync(iter, key => this.keyConverter.fromString(key))
+    , iter => filterAsync<Awaited<K> | undefined, Awaited<Awaited<K>>>(iter, isntUndefined)
+    )
+  }
+}

package/src/disk-store-view.ts

@@ -1,18 +1,9 @@
 import { DiskStore } from '@src/disk-store.js'
 import { DiskStoreWithCache } from '@src/disk-store-with-cache.js'
 import { pipe } from 'extra-utils'
-import { mapAsync, filterAsync } from 'iterable-operator'
-import { Awaitable, isntUndefined } from '@blackglory/prelude'
-
-export interface IKeyConverter<T> {
-  toString: (value: T) => Awaitable<string>
-  fromString: (value: string) => Awaitable<T | undefined>
-}
-
-export interface IValueConverter<T> {
-  toBuffer: (value: T) => Awaitable<Buffer>
-  fromBuffer: (value: Buffer) => Awaitable<T>
-}
+import { map, filter } from 'iterable-operator'
+import { isntUndefined } from '@blackglory/prelude'
+import { IKeyConverter, IValueConverter } from './types.js'
 
 export class DiskStoreView<K, V> {
   constructor(
@@ -21,12 +12,12 @@ export class DiskStoreView<K, V> {
   , private valueConverter: IValueConverter<V>
   ) {}
 
-  async has(key: K): Promise<boolean> {
-    return this.store.has(await this.keyConverter.toString(key))
+  has(key: K): boolean {
+    return this.store.has(this.keyConverter.toString(key))
   }
 
-  async get(key: K): Promise<V | undefined> {
-    const buffer = this.store.get(await this.keyConverter.toString(key))
+  get(key: K): V | undefined {
+    const buffer = this.store.get(this.keyConverter.toString(key))
 
     if (buffer) {
       return this.valueConverter.fromBuffer(buffer)
@@ -35,28 +26,26 @@ export class DiskStoreView<K, V> {
     }
   }
 
-  async set(key: K, value: V): Promise<void> {
-    await this.store.set(
-      ...await Promise.all([
-        await this.keyConverter.toString(key)
-      , await this.valueConverter.toBuffer(value)
-      ])
+  set(key: K, value: V): void {
+    this.store.set(
+      this.keyConverter.toString(key)
+    , this.valueConverter.toBuffer(value)
     )
   }
 
-  async delete(key: K): Promise<void> {
-    await this.store.delete(await this.keyConverter.toString(key))
+  delete(key: K): void {
+    this.store.delete(this.keyConverter.toString(key))
   }
 
-  async clear(): Promise<void> {
-    await this.store.clear()
+  clear(): void {
+    this.store.clear()
   }
 
-  keys(): AsyncIterableIterator<K> {
+  keys(): IterableIterator<K> {
     return pipe(
       this.store.keys()
-    , iter => mapAsync(iter, async key => await this.keyConverter.fromString(key))
-    , iter => filterAsync(iter, isntUndefined)
+    , iter => map(iter, key => this.keyConverter.fromString(key))
+    , iter => filter<K | undefined, K>(iter, isntUndefined)
     )
   }
 }

package/src/disk-store-with-cache.ts

@@ -14,8 +14,8 @@ export class DiskStoreWithCache {
   , private cache: ICache
   ) {}
 
-  async close(): Promise<void> {
-    await this.store.close()
+  close(): void {
+    this.store.close()
   }
 
   has(key: string): boolean {
@@ -54,20 +54,20 @@ export class DiskStoreWithCache {
     }
   }
 
-  async set(key: string, value: Buffer): Promise<void> {
-    await this.store.set(key, value)
+  set(key: string, value: Buffer): void {
+    this.store.set(key, value)
 
     this.cache.delete(key)
   }
 
-  async delete(key: string): Promise<void> {
-    await this.store.delete(key)
+  delete(key: string): void {
+    this.store.delete(key)
 
     this.cache.delete(key)
   }
 
-  async clear(): Promise<void> {
-    await this.store.clear()
+  clear(): void {
+    this.store.clear()
 
     this.cache.clear()
   }