keyv-dir-store 0.0.6 → 0.0.7

package/KeyvDirStoreAsJSON.ts

@@ -0,0 +1,10 @@
+import type { DeserializedData } from "keyv";
+
+export const KeyvDirStoreAsJSON = {
+  serialize({ value }: DeserializedData<any>): string {
+    return JSON.stringify(value, null, 2);
+  },
+  deserialize(str: string): DeserializedData<any> {
+    return { value: JSON.parse(str), expires: undefined };
+  },
+};

package/KeyvDirStoreAsYaml.ts

@@ -0,0 +1,11 @@
+import type { DeserializedData } from "keyv";
+import yaml from "yaml";
+
+export const KeyvDirStoreAsYaml = {
+  serialize({ value }: DeserializedData<any>): string {
+    return yaml.stringify(value);
+  },
+  deserialize(str: string): DeserializedData<any> {
+    return { value: yaml.parse(str), expires: undefined };
+  },
+};

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 snomiao
-
-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.
+MIT License
+
+Copyright (c) 2024 snomiao
+
+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

@@ -1,34 +1,34 @@
-# Keyv Directory Store
-
-Store key into a file per value
-
-## Usages
-
-```ts
-// Default: Store each value with JSON in format "{value: ..., expires: ...}"
-new Keyv({
-  store: new KeyvDirStore(".cache/kv")
-});
-
-// Store each value with CSV
-new Keyv({
-  store: new KeyvDirStore(".cache/kv", { ext: ".csv" }),
-  serialize: ({ value }) => d3.csvFormat(value),
-  deserialize: (str) => ({ value: d3.csvParse(str), expires: undefined }),
-});
-
-// Store each value with YAML
-new Keyv({
-  store: new KeyvDirStore(".cache/kv", { ext: ".json" }),
-  serialize: ({ value }) => yaml.stringify(value),
-  deserialize: (str) => ({ value: yaml.parse(str), expires: undefined }),
-});
-
-// Store each value with JSON
-new Keyv({
-  store: new KeyvDirStore(".cache/kv", { ext: ".json" }),
-  serialize: ({ value }) => JSON.stringify(value, null, 2),
-  deserialize: (str) => ({ value: JSON.parse(str), expires: undefined }),
-});
-
+# Keyv Directory Store
+
+Store key into a file per value
+
+## Usages
+
+```ts
+// Default: Store each value with JSON in format "{value: ..., expires: ...}"
+new Keyv({
+  store: new KeyvDirStore(".cache/kv")
+});
+
+// Store each value with CSV
+new Keyv({
+  store: new KeyvDirStore(".cache/kv", { ext: ".csv" }),
+  serialize: ({ value }) => d3.csvFormat(value),
+  deserialize: (str) => ({ value: d3.csvParse(str), expires: undefined }),
+});
+
+// Store each value with YAML
+new Keyv({
+  store: new KeyvDirStore(".cache/kv", { ext: ".json" }),
+  serialize: ({ value }) => yaml.stringify(value),
+  deserialize: (str) => ({ value: yaml.parse(str), expires: undefined }),
+});
+
+// Store each value with JSON
+new Keyv({
+  store: new KeyvDirStore(".cache/kv", { ext: ".json" }),
+  serialize: ({ value }) => JSON.stringify(value, null, 2),
+  deserialize: (str) => ({ value: JSON.parse(str), expires: undefined }),
+});
+
 ```

package/dist/index.js

@@ -343,7 +343,7 @@ class KeyvDirStore {
     this.ext = ext ?? this.ext;
   }
   #defaultFilename(key) {
-    const readableName = import_sanitize_filename.default(key).slice(4, 16);
+    const readableName = import_sanitize_filename.default(key).slice(0, 16);
     const hashName = import_md5.default(key + "+SALT-poS1djRa4M2jXsWi").slice(0, 16);
     const name = `${readableName}-${hashName}`;
     return name;
@@ -352,15 +352,16 @@ class KeyvDirStore {
     return path.join(this.#dir, import_sanitize_filename.default(this.#filename(key) + this.ext));
   }
   async get(key) {
-    const cached = this.#cache.get(key);
-    if (cached) {
-      if (cached.expires && cached.expires < Date.now()) {
+    const memCached = this.#cache.get(key);
+    if (memCached) {
+      if (memCached.expires && memCached.expires < Date.now()) {
         await this.delete(key);
       } else {
-        return cached.value;
+        return memCached.value;
       }
     }
-    const stats = await stat(this.#path(key)).catch(() => null);
+    const path2 = this.#path(key);
+    const stats = await stat(path2).catch(() => null);
     if (!stats)
       return;
     const expires = +stats.mtime;
@@ -371,7 +372,7 @@ class KeyvDirStore {
         return;
       }
     }
-    return await readFile(this.#path(key), "utf8").catch(() => {
+    return await readFile(path2, "utf8").catch(() => {
       return;
     });
   }
@@ -381,6 +382,7 @@ class KeyvDirStore {
     const expires = ttl ? Date.now() + ttl : 0;
     this.#cache.set(key, { value, expires });
     await this.#ready;
+    await mkdir(this.#dir, { recursive: true });
     await writeFile(this.#path(key), value);
     await utimes(this.#path(key), new Date, new Date(expires ?? 0));
     return true;
@@ -394,7 +396,6 @@ class KeyvDirStore {
     await rm(this.#dir, { recursive: true }).catch(() => {
       return;
     });
-    await mkdir(this.#dir, { recursive: true });
   }
   async has(key) {
     return await this.get(key) !== undefined;

package/{index.test.ts → index.spec.ts}

@@ -1,55 +1,67 @@
-import Keyv from "keyv";
-import { KeyvDirStore } from ".";
-
-it("KeyvDirStore works", async () => {
-  // store test
-  const kv = new Keyv<number | string | { obj: boolean }>({
-    store: new KeyvDirStore(".cache/test1"),
-    deserialize: KeyvDirStore.deserialize,
-    serialize: KeyvDirStore.serialize,
-  });
-  await kv.clear();
-  await kv.set("a", 1234, -86400e3); // already expired
-  expect(await kv.get("a")).toEqual(undefined); // will delete file before get
-  await kv.set("b", 1234); // never expired
-  expect(await kv.get("b")).toEqual(1234);
-  await kv.set("c", "b", 86400e3); // 1 day
-  expect(await kv.get("c")).toEqual("b");
-  await kv.set("d", { obj: false }, 86400e3); // obj store
-  expect(await kv.get("d")).toEqual({ obj: false });
-
-  // new instance with no cache Obj, to test file cache
-  const kv2 = new Keyv<number | string | { obj: boolean }>({
-    store: new KeyvDirStore(".cache/test1"),
-    deserialize: KeyvDirStore.deserialize,
-    serialize: KeyvDirStore.serialize,
-  });
-  expect(await kv2.get("a")).toEqual(undefined); // will delete file before get
-  expect(await kv2.get("b")).toEqual(1234);
-  expect(await kv2.get("c")).toEqual("b");
-  expect(await kv2.get("d")).toEqual({ obj: false });
-});
-it("KeyvDirStore works with only store", async () => {
-  // store test
-  const kv = new Keyv<number | string | { obj: boolean }>({
-    store: new KeyvDirStore(".cache/test2"),
-  });
-  await kv.clear();
-  await kv.set("a", 1234, -86400e3); // already expired
-  expect(await kv.get("a")).toEqual(undefined); // will delete file before get
-  await kv.set("b", 1234); // never expired
-  expect(await kv.get("b")).toEqual(1234);
-  await kv.set("c", "b", 86400e3); // 1 day
-  expect(await kv.get("c")).toEqual("b");
-  await kv.set("d", { obj: false }, 86400e3); // obj store
-  expect(await kv.get("d")).toEqual({ obj: false });
-
-  // new instance with no cache Obj, to test file cache
-  const kv2 = new Keyv<number | string | { obj: boolean }>({
-    store: new KeyvDirStore(".cache/test2"),
-  });
-  expect(await kv2.get("a")).toEqual(undefined); // will delete file before get
-  expect(await kv2.get("b")).toEqual(1234);
-  expect(await kv2.get("c")).toEqual("b");
-  expect(await kv2.get("d")).toEqual({ obj: false });
-});
+import { existsSync } from "fs";
+import Keyv from "keyv";
+import { KeyvDirStore } from ".";
+import { KeyvDirStoreAsJSON } from "./KeyvDirStoreAsJSON";
+
+it("KeyvDirStore works", async () => {
+  // store test
+  const kv = new Keyv<number | string | { obj: boolean }>({
+    store: new KeyvDirStore(".cache/test1", { filename: (x) => x }),
+    namespace: "",
+    deserialize: KeyvDirStore.deserialize,
+    serialize: KeyvDirStore.serialize,
+  });
+  await kv.clear();
+  await kv.set("a", 1234, -86400e3); // already expired
+
+  expect(existsSync(".cache/test1/a.json")).toEqual(true);
+  expect(await kv.get("a")).toEqual(undefined); // will delete file before get
+  expect(existsSync(".cache/test1/a.json")).toEqual(false);
+
+  expect(existsSync(".cache/test1/b.json")).toEqual(false);
+  await kv.set("b", 1234); // never expired
+  expect(existsSync(".cache/test1/b.json")).toEqual(true);
+  expect(await kv.get("b")).toEqual(1234);
+
+  await kv.set("c", "b", 86400e3); // 1 day
+  expect(await kv.get("c")).toEqual("b");
+  await kv.set("d", { obj: false }, 86400e3); // obj store
+  expect(await kv.get("d")).toEqual({ obj: false });
+
+  // new instance with no cache Obj, to test file cache
+  const kv2 = new Keyv<number | string | { obj: boolean }>({
+    store: new KeyvDirStore(".cache/test1", { filename: (x) => x }),
+    namespace: "",
+    ...KeyvDirStoreAsJSON,
+  });
+  expect(await kv2.get("a")).toEqual(undefined); // will delete file before get
+  expect(await kv2.get("b")).toEqual(1234);
+  expect(await kv2.get("c")).toEqual("b");
+  expect(await kv2.get("d")).toEqual({ obj: false });
+});
+it("KeyvDirStore works without deserialize", async () => {
+  // store test
+  const kv = new Keyv<number | string | { obj: boolean }>({
+    store: new KeyvDirStore(".cache/test2", { filename: (x) => x }),
+    namespace: "",
+  });
+  await kv.clear();
+  await kv.set("a", 1234, -86400e3); // already expired
+  expect(await kv.get("a")).toEqual(undefined); // will delete file before get
+  await kv.set("b", 1234); // never expired
+  expect(await kv.get("b")).toEqual(1234);
+  await kv.set("c", "b", 86400e3); // 1 day
+  expect(await kv.get("c")).toEqual("b");
+  await kv.set("d", { obj: false }, 86400e3); // obj store
+  expect(await kv.get("d")).toEqual({ obj: false });
+
+  // new instance with no cache Obj, to test file cache
+  const kv2 = new Keyv<number | string | { obj: boolean }>({
+    store: new KeyvDirStore(".cache/test2", { filename: (x) => x }),
+    namespace: "",
+  });
+  expect(await kv2.get("a")).toEqual(undefined); // will delete file before get
+  expect(await kv2.get("b")).toEqual(1234);
+  expect(await kv2.get("c")).toEqual("b");
+  expect(await kv2.get("d")).toEqual({ obj: false });
+});

package/index.ts

@@ -1,118 +1,120 @@
-import type { DeserializedData, default as Keyv } from "keyv";
-import md5 from "md5";
-import { mkdir, readFile, rm, stat, utimes, writeFile } from "node:fs/promises";
-import path from "path";
-import sanitizeFilename from "sanitize-filename";
-type Value = any;
-type CacheMap<Value> = Map<string, DeserializedData<Value>>;
-/**
- * KeyvDirStore is a Keyv.Store<string> implementation that stores data in files.
- * @example
- * const kv = new Keyv<number | string | { obj: boolean }>({
- *   store: new KeyvDirStore("cache/test"),
- *   deserialize: KeyvDirStore.deserialize,
- *   serialize: KeyvDirStore.serialize,
- * });
- * await kv.set("a", 1234, -86400e3); // already expired
- * expect(await kv.get("a")).toEqual(undefined); // will delete file before get
- * await kv.set("b", 1234); // never expired
- * expect(await kv.get("b")).toEqual(1234);
- */
-export class KeyvDirStore implements Keyv.Store<string> {
-  #dir: string;
-  #cache: CacheMap<Value>;
-  #ready: Promise<unknown>;
-  #filename: (key: string) => string;
-  ext = ".json";
-  constructor(
-    dir: string,
-    {
-      cache = new Map(),
-      filename,
-      ext,
-    }: {
-      cache?: CacheMap<Value>;
-      filename?: (key: string) => string;
-      ext?: string;
-    } = {}
-  ) {
-    this.#ready = mkdir(dir, { recursive: true });
-    this.#cache = cache;
-    this.#dir = dir;
-    this.#filename = filename ?? this.#defaultFilename;
-    this.ext = ext ?? this.ext;
-  }
-  #defaultFilename(key: string) {
-    // use dir as hash salt to avoid collisions
-    const readableName = sanitizeFilename(key).slice(4, 16);
-    const hashName = md5(key + "+SALT-poS1djRa4M2jXsWi").slice(0, 16);
-    const name = `${readableName}-${hashName}`;
-    return name;
-  }
-  #path(key: string) {
-    return path.join(
-      this.#dir,
-      sanitizeFilename(this.#filename(key) + this.ext)
-    );
-  }
-  async get(key: string) {
-    // read memory
-    const cached = this.#cache.get(key);
-    if (cached) {
-      // console.log("memory cache hit but expired", key, cached.expires, Date.now());
-      if (cached.expires && cached.expires < Date.now()) {
-        await this.delete(key);
-      } else {
-        return cached.value;
-      }
-    }
-    // read file cache
-    const stats = await stat(this.#path(key)).catch(() => null);
-    if (!stats) return undefined; // stat not found
-    const expires = +stats.mtime;
-    if (expires !== 0) {
-      const expired = +stats.mtime < +Date.now();
-      if (expired) {
-        //   console.log("file cache hit expired", key, expires, Date.now(), expired);
-        await this.delete(key);
-        return undefined;
-      }
-    }
-    // return this.#parse(await readFile(this.#path(key), "utf8"));
-    return await readFile(this.#path(key), "utf8").catch(() => undefined);
-  }
-  async set(key: string, value: Value, ttl?: number) {
-    if (!value) return await this.delete(key);
-    // const { value, expires } = JSON.parse(stored) as DeserializedData<Value>;
-    const expires = ttl ? Date.now() + ttl : 0;
-    // save to memory
-    this.#cache.set(key, { value, expires });
-    // save to file
-    await this.#ready;
-    // console.log({ key, value, expires });
-    await writeFile(this.#path(key), value); // create a expired file
-    await utimes(this.#path(key), new Date(), new Date(expires ?? 0)); // set a future expires time (0 as never expired)
-    return true;
-  }
-  async delete(key: string) {
-    // delete memory
-    this.#cache.delete(key);
-    await rm(this.#path(key), { force: true });
-    return true;
-  }
-  async clear() {
-    await rm(this.#dir, { recursive: true }).catch(() => void 0);
-    await mkdir(this.#dir, { recursive: true });
-  }
-  async has(key: string) {
-    return undefined !== (await this.get(key));
-  }
-
-  // Save expires into mtime, and value into file
-  static serialize({ value }: DeserializedData<Value>): string {
-    return JSON.stringify(value, null, 2);
-  }
-  static deserialize(str: string): DeserializedData<Value> {
-    return { value: JSON.parse(str), expires: undefined };
-  }
-}
+import type { DeserializedData, default as Keyv } from "keyv";
+import md5 from "md5";
+import { mkdir, readFile, rm, stat, utimes, writeFile } from "node:fs/promises";
+import path from "path";
+import sanitizeFilename from "sanitize-filename";
+
+type CacheMap<Value> = Map<string, DeserializedData<Value>>;
+/**
+ * KeyvDirStore is a Keyv.Store<string> implementation that stores data in files.
+ * @example
+ * const kv = new Keyv<number | string | { obj: boolean }>({
+ *   store: new KeyvDirStore("cache/test"),
+ *   deserialize: KeyvDirStore.deserialize,
+ *   serialize: KeyvDirStore.serialize,
+ * });
+ * await kv.set("a", 1234, -86400e3); // already expired
+ * expect(await kv.get("a")).toEqual(undefined); // will delete file before get
+ * await kv.set("b", 1234); // never expired
+ * expect(await kv.get("b")).toEqual(1234);
+ */
+export class KeyvDirStore<Value extends string> implements Keyv.Store<string> {
+  #dir: string;
+  #cache: CacheMap<Value>;
+  #ready: Promise<unknown>;
+  #filename: (key: string) => string;
+  ext = ".json";
+  constructor(
+    dir: string,
+    {
+      cache = new Map(),
+      filename,
+      ext,
+    }: {
+      cache?: CacheMap<Value>;
+      filename?: (key: string) => string;
+      ext?: string;
+    } = {}
+  ) {
+    this.#ready = mkdir(dir, { recursive: true });
+    this.#cache = cache;
+    this.#dir = dir;
+    this.#filename = filename ?? this.#defaultFilename;
+    this.ext = ext ?? this.ext;
+  }
+  #defaultFilename(key: string) {
+    // use dir as hash salt to avoid collisions
+    const readableName = sanitizeFilename(key).slice(0, 16);
+    const hashName = md5(key + "+SALT-poS1djRa4M2jXsWi").slice(0, 16);
+    const name = `${readableName}-${hashName}`;
+    return name;
+  }
+  #path(key: string) {
+    return path.join(
+      this.#dir,
+      sanitizeFilename(this.#filename(key) + this.ext)
+    );
+  }
+  async get(key: string) {
+    // read memory
+    const memCached = this.#cache.get(key);
+    if (memCached) {
+      // console.log("memory cache hit but expired", key, cached.expires, Date.now());
+      if (memCached.expires && memCached.expires < Date.now()) {
+        await this.delete(key);
+      } else {
+        return memCached.value;
+      }
+    }
+    // read file cache
+    const path = this.#path(key);
+    const stats = await stat(path).catch(() => null);
+    if (!stats) return undefined; // stat not found
+    const expires = +stats.mtime;
+    if (expires !== 0) {
+      const expired = +stats.mtime < +Date.now();
+      if (expired) {
+        //   console.log("file cache hit expired", key, expires, Date.now(), expired);
+        await this.delete(key);
+        return undefined;
+      }
+    }
+    return await readFile(path, "utf8").catch(() => undefined);
+  }
+  async set(key: string, value: Value, ttl?: number) {
+    if (!value) return await this.delete(key);
+    // const { value, expires } = JSON.parse(stored) as DeserializedData<Value>;
+    const expires = ttl ? Date.now() + ttl : 0;
+    // save to memory
+    this.#cache.set(key, { value, expires });
+    // save to file
+    await this.#ready;
+    // console.log({ key, value, expires });
+    await mkdir(this.#dir, { recursive: true });
+    await writeFile(this.#path(key), value); // create a expired file
+    await utimes(this.#path(key), new Date(), new Date(expires ?? 0)); // set expires time as mtime (0 as never expired)
+    return true;
+  }
+  async delete(key: string) {
+    // delete memory
+    this.#cache.delete(key);
+    await rm(this.#path(key), { force: true });
+    return true;
+  }
+  async clear() {
+    await rm(this.#dir, { recursive: true }).catch(() => void 0);
+  }
+  async has(key: string) {
+    return undefined !== (await this.get(key));
+  }
+
+  // Save expires into mtime, and value into file
+  /** @deprecated use KeyvDirStoreJSON */
+  static serialize({ value }: DeserializedData<any>): string {
+    return JSON.stringify(value, null, 2);
+  }
+  /** @deprecated use KeyvDirStoreJSON */
+  static deserialize(str: string): DeserializedData<any> {
+    return { value: JSON.parse(str), expires: undefined };
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keyv-dir-store",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "author": "snomiao <snomiao@gmail.com>",
   "type": "module",
   "exports": {
@@ -22,7 +22,8 @@
   "dependencies": {
     "@types/node": "^20.14.2",
     "md5": "^2.3.0",
-    "sanitize-filename": "^1.6.3"
+    "sanitize-filename": "^1.6.3",
+    "yaml": "^2.4.5"
   },
   "devDependencies": {
     "@types/bun": "^1.1.3",

package/CHANGELOG.md

@@ -1,31 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
-
-### [0.0.6](https://github.com/snomiao/keyv-dir-store/compare/v0.0.5...v0.0.6) (2024-06-27)
-
-
-### Bug Fixes
-
-* - [`fs.utimes` doesn't support `number` or `string` on Windows · Issue [#33227](https://github.com/snomiao/keyv-dir-store/issues/33227) · nodejs/node]( https://github.com/nodejs/node/issues/33227 ) ([ff4981c](https://github.com/snomiao/keyv-dir-store/commit/ff4981cde2564eb9e49350d97149653d0066f850))
-
-### [0.0.5](https://github.com/snomiao/keyv-dir-store/compare/v0.0.4...v0.0.5) (2024-06-26)
-
-
-### Bug Fixes
-
-* **main:** sanitize ([ae7b162](https://github.com/snomiao/keyv-dir-store/commit/ae7b162cb8835bccda3c81769009ac0a78c7fac0))
-* **main:** stage ([86d9193](https://github.com/snomiao/keyv-dir-store/commit/86d9193f5aa095ac77d006f081a3b0e801c1327e))
-
-### [0.0.4](https://github.com/snomiao/keyv-dir-store/compare/v0.0.3...v0.0.4) (2024-06-26)
-
-### [0.0.3](https://github.com/snomiao/keyv-dir-store/compare/v0.0.2...v0.0.3) (2024-06-12)
-
-
-### Features
-
-* **kds:** init ([7ef5f68](https://github.com/snomiao/keyv-dir-store/commit/7ef5f68430657a81dcace597148c7641032ed6ab))
-
-### [0.0.2](https://github.com/snomiao/keyv-dir-store/compare/v0.0.1...v0.0.2) (2024-06-12)
-
-### 0.0.1 (2024-06-12)