polystore 0.10.0 → 0.11.1

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "polystore",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "A small compatibility layer for many popular KV stores like localStorage, Redis, FileSystem, etc.",
   "homepage": "https://polystore.dev/",
   "repository": "https://github.com/franciscop/polystore.git",
   "bugs": "https://github.com/franciscop/polystore/issues",
   "funding": "https://www.paypal.me/franciscopresencia/19",
   "author": "Francisco Presencia <public@francisco.io> (https://francisco.io/)",
-  "main": "src/index.js",
   "type": "module",
+  "main": "src/index.js",
   "types": "src/index.d.ts",
+  "files": [
+    "src/"
+  ],
   "scripts": {
     "size": "echo $(gzip -c src/index.js | wc -c) bytes",
     "start": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch --coverage --detectOpenHandles",
@@ -24,6 +27,7 @@
     "value"
   ],
   "license": "MIT",
+  "dependencies": {},
   "devDependencies": {
     "@deno/kv": "^0.8.1",
     "check-dts": "^0.8.0",

package/readme.md

@@ -241,6 +241,26 @@ Remove a single key from the store and return the key itself:
 await store.del(key: string);
 ```
 
+It will ignore the operation if the key or value don't exist already (but won't thorw).
+
+### _Iterator_
+
+You can iterate over the whole store with an async iterator:
+
+```js
+for await (const [key, value] of store) {
+  // ...
+}
+```
+
+This is very useful for performance resons. You can also iterate on a subset of the entries with .prefix:
+
+```js
+for await (const [key, value] of store.prefix("session:")) {
+  // ...
+}
+```
+
 ### .keys()
 
 Get all of the keys in the store, optionally filtered by a prefix:
@@ -615,7 +635,7 @@ class MyClient {
   // Mandatory methods
   get (key): Promise<any>;
   set (key, value, { expires: null|number }): Promise<null>;
-  entries (prefix): Promise<[string, any][]>;
+  iterate(prefix): AyncIterator<[string, any]>
 
   // Optional item methods (for optimization or customization)
   add (prefix, data, { expires: null|number }): Promise<string>;
@@ -623,6 +643,7 @@ class MyClient {
   del (key): Promise<null>;
 
   // Optional group methods
+  entries (prefix): Promise<[string, any][]>;
   keys (prefix): Promise<string[]>;
   values (prefix): Promise<any[]>;
   clear (prefix): Promise<null>;
@@ -647,8 +668,9 @@ const value = await store.get("a");
 // client.get("hello:world:a");
 
 // User calls this, then the client is called with that:
-const value = await store.entries();
-// client.entries("hello:world:");
+for await (const entry of store.iterate()) {
+}
+// client.iterate("hello:world:");
 ```
 
 > Note: all of the _group methods_ that return keys, should return them **with the prefix**:
@@ -680,10 +702,12 @@ class MyClient {
   }
 
   // Filter them by the prefix, note that `prefix` will always be a string
-  entries(prefix) {
-    const entries = Object.entries(dataSource);
-    if (!prefix) return entries;
-    return entries.filter(([key, value]) => key.startsWith(prefix));
+  *iterate(prefix) {
+    for (const [key, value] of Object.entries(dataSource)) {
+      if (key.startsWith(prefix)) {
+        yield [key, value];
+      }
+    }
   }
 }
 ```

package/src/clients/cloudflare.js

@@ -31,9 +31,33 @@ export default class Cloudflare {
     return this.client.delete(key);
   }
 
+  // Since we have pagination, we don't want to get all of the
+  // keys at once if we can avoid it
+  async *iterate(prefix = "") {
+    let cursor;
+    do {
+      const raw = await this.client.list({ prefix, cursor });
+      const keys = raw.keys.map((k) => k.name);
+      for (let key of keys) {
+        const value = await this.get(key);
+        // By the time this specific value is read, it could
+        // already be gone!
+        if (!value) continue;
+        yield [key, value];
+      }
+      cursor = raw.list_complete ? null : raw.cursor;
+    } while (cursor);
+  }
+
   async keys(prefix = "") {
-    const raw = await this.client.list({ prefix });
-    return raw.keys.map((k) => k.name);
+    const keys = [];
+    let cursor;
+    do {
+      const raw = await this.client.list({ prefix, cursor });
+      keys.push(...raw.keys.map((k) => k.name));
+      cursor = raw.list_complete ? null : raw.cursor;
+    } while (cursor);
+    return keys;
   }
 
   async entries(prefix = "") {

package/src/clients/cookie.js

@@ -8,9 +8,25 @@ export default class Cookie {
     return client === "cookie" || client === "cookies";
   }
 
+  // Group methods
+  #read() {
+    const all = {};
+    for (let entry of document.cookie.split(";")) {
+      try {
+        const [rawKey, rawValue] = entry.split("=");
+        const key = decodeURIComponent(rawKey.trim());
+        const value = JSON.parse(decodeURIComponent(rawValue.trim()));
+        all[key] = value;
+      } catch (error) {
+        // no-op (some 3rd party can set cookies independently)
+      }
+    }
+    return all;
+  }
+
   // For cookies, an empty value is the same as null, even `""`
   get(key) {
-    return this.all()[key] || null;
+    return this.#read()[key] || null;
   }
 
   set(key, data = null, { expires } = {}) {
@@ -33,23 +49,10 @@ export default class Cookie {
     return key;
   }
 
-  // Group methods
-  all(prefix = "") {
-    const all = {};
-    for (let entry of document.cookie.split(";")) {
-      const [key, data] = entry.split("=");
-      const name = decodeURIComponent(key.trim());
-      if (!name.startsWith(prefix)) continue;
-      try {
-        all[name] = JSON.parse(decodeURIComponent(data.trim()));
-      } catch (error) {
-        // no-op (some 3rd party can set cookies independently)
-      }
+  async *iterate(prefix = "") {
+    for (let [key, value] of Object.entries(this.#read())) {
+      if (!key.startsWith(prefix)) continue;
+      yield [key, value];
     }
-    return all;
-  }
-
-  entries(prefix = "") {
-    return Object.entries(this.all(prefix));
   }
 }

package/src/clients/etcd.js

@@ -21,6 +21,13 @@ export default class Etcd {
     await this.client.put(key).value(JSON.stringify(value));
   }
 
+  async *iterate(prefix = "") {
+    const keys = await this.client.getAll().prefix(prefix).keys();
+    for (const key of keys) {
+      yield [key, await this.get(key)];
+    }
+  }
+
   async entries(prefix = "") {
     const keys = await this.client.getAll().prefix(prefix).keys();
     const values = await Promise.all(keys.map((k) => this.get(k)));

package/src/clients/file.js

@@ -53,10 +53,12 @@ export default class File {
     return key;
   }
 
-  // Group methods
-  async entries(prefix = "") {
+  async *iterate(prefix = "") {
     const data = await this.#read();
-    return Object.entries(data).filter((p) => p[0].startsWith(prefix));
+    const entries = Object.entries(data).filter((p) => p[0].startsWith(prefix));
+    for (const entry of entries) {
+      yield entry;
+    }
   }
 
   async clear(prefix = "") {

package/src/clients/forage.js

@@ -22,12 +22,18 @@ export default class Forage {
     return key;
   }
 
+  async *iterate(prefix = "") {
+    const keys = await this.client.keys();
+    const list = keys.filter((k) => k.startsWith(prefix));
+    for (const key of list) {
+      yield [key, await this.get(key)];
+    }
+  }
+
   async entries(prefix = "") {
     const all = await this.client.keys();
     const keys = all.filter((k) => k.startsWith(prefix));
-    const values = await Promise.all(
-      keys.map((key) => this.client.getItem(key))
-    );
+    const values = await Promise.all(keys.map((key) => this.get(key)));
     return keys.map((key, i) => [key, values[i]]);
   }
 

package/src/clients/level.js

@@ -26,6 +26,14 @@ export default class Level {
     return this.client.del(key);
   }
 
+  async *iterate(prefix = "") {
+    const keys = await this.client.keys().all();
+    const list = keys.filter((k) => k.startsWith(prefix));
+    for (const key of list) {
+      yield [key, await this.get(key)];
+    }
+  }
+
   async entries(prefix = "") {
     const keys = await this.client.keys().all();
     const list = keys.filter((k) => k.startsWith(prefix));

package/src/clients/memory.js

@@ -21,6 +21,14 @@ export default class Memory {
     this.client.delete(key);
   }
 
+  *iterate(prefix = "") {
+    const entries = this.entries();
+    for (const entry of entries) {
+      if (!entry[0].startsWith(prefix)) continue;
+      yield entry;
+    }
+  }
+
   // Group methods
   entries(prefix = "") {
     const entries = [...this.client.entries()];

package/src/clients/redis.js

@@ -37,12 +37,33 @@ export default class Redis {
     return this.client.keys(prefix + "*");
   }
 
+  // Go through each of the [key, value] in the set
+  async *iterate(prefix = "") {
+    const MATCH = prefix + "*";
+    for await (const key of this.client.scanIterator({ MATCH })) {
+      const value = await this.get(key);
+      yield [key, value];
+    }
+  }
+
+  // Optimizing the retrieval of them all in bulk by loading the values
+  // in parallel
   async entries(prefix = "") {
-    const keys = await this.client.keys(prefix + "*");
+    const keys = await this.keys(prefix);
     const values = await Promise.all(keys.map((k) => this.get(k)));
     return keys.map((k, i) => [k, values[i]]);
   }
 
+  // Optimizing the retrieval of them by not getting their values
+  async keys(prefix = "") {
+    const MATCH = prefix + "*";
+    const keys = [];
+    for await (const key of this.client.scanIterator({ MATCH })) {
+      keys.push(key);
+    }
+    return keys;
+  }
+
   async clear(prefix = "") {
     if (!prefix) return this.client.flushAll();
 

package/src/clients/storage.js

@@ -25,6 +25,13 @@ export default class WebStorage {
     return key;
   }
 
+  *iterate(prefix = "") {
+    const entries = this.entries(prefix);
+    for (const entry of entries) {
+      yield entry;
+    }
+  }
+
   // Group methods
   entries(prefix = "") {
     const entries = Object.entries(this.client);

package/src/index.js

@@ -43,9 +43,9 @@ class Store {
 
   // #region #validate()
   #validate(client) {
-    if (!client.set || !client.get || !client.entries) {
+    if (!client.set || !client.get || !client.iterate) {
       throw new Error(
-        "A client should have at least a .get(), .set() and .entries()"
+        "A client should have at least a .get(), .set() and .iterate()"
       );
     }
 
@@ -68,6 +68,31 @@ class Store {
     }
   }
 
+  #unix(expires) {
+    const now = new Date().getTime();
+    return expires === null ? null : now + expires * 1000;
+  }
+
+  // Check if the given data is fresh or not; if
+  #isFresh(data, key) {
+    // Should never happen, but COULD happen; schedule it for
+    // removal and mark it as stale
+    if (!data || !data.value || typeof data !== "object") {
+      if (key) this.del(key);
+      return false;
+    }
+
+    // It never expires, so keep it
+    if (data.expires === null) return true;
+
+    // It's fresh, keep it
+    if (data.expires > Date.now()) return true;
+
+    // It's expired, remove it
+    if (key) this.del(key);
+    return false;
+  }
+
   // #region .add()
   /**
    * Save the data on an autogenerated key, can add expiration as well:
@@ -94,9 +119,10 @@ class Store {
       }
 
       // In the data we need the timestamp since we need it "absolute":
-      const now = new Date().getTime();
-      const expDiff = expires === null ? null : now + expires * 1000;
-      return this.client.add(this.PREFIX, { expires: expDiff, value });
+      return this.client.add(this.PREFIX, {
+        expires: this.#unix(expires),
+        value,
+      });
     }
 
     const id = createId();
@@ -126,7 +152,7 @@ class Store {
     const expires = parse(options.expire ?? options.expires);
 
     // Quick delete
-    if (value === null) {
+    if (value === null || (typeof expires === "number" && expires <= 0)) {
       await this.del(id);
       return key;
     }
@@ -137,16 +163,8 @@ class Store {
       return key;
     }
 
-    // Already expired, then delete it
-    if (expires === 0) {
-      await this.del(id);
-      return key;
-    }
-
     // In the data we need the timestamp since we need it "absolute":
-    const now = new Date().getTime();
-    const expDiff = expires === null ? null : now + expires * 1000;
-    await this.client.set(id, { expires: expDiff, value });
+    await this.client.set(id, { expires: this.#unix(expires), value });
     return key;
   }
 
@@ -180,23 +198,8 @@ class Store {
     // so we can assume it's the raw user data
     if (this.client.EXPIRES) return data;
 
-    // Make sure that if there's no data by now, empty is returned
-    if (!data) return null;
-
-    // We manage expiration manually, so we know it should have this structure
-    // TODO: ADD A CHECK HERE
-    const { expires, value } = data;
-
-    // It never expires
-    if (expires === null) return value ?? null;
-
-    // Already expired! Return nothing, and remove the whole key
-    if (expires <= new Date().getTime()) {
-      await this.del(key);
-      return null;
-    }
-
-    return value;
+    if (!this.#isFresh(data, key)) return null;
+    return data.value;
   }
 
   // #region .has()
@@ -256,6 +259,19 @@ class Store {
     return key;
   }
 
+  async *[Symbol.asyncIterator]() {
+    await this.promise;
+
+    for await (const [name, data] of this.client.iterate(this.PREFIX)) {
+      const key = name.slice(this.PREFIX.length);
+      if (this.client.EXPIRES) {
+        yield [key, data];
+      } else if (this.#isFresh(data, key)) {
+        yield [key, data.value];
+      }
+    }
+  }
+
   // #region .entries()
   /**
    * Return an array of the entries, in the [key, value] format:
@@ -274,36 +290,25 @@ class Store {
   async entries() {
     await this.promise;
 
-    const entries = await this.client.entries(this.PREFIX);
-    const list = entries.map(([key, data]) => [
-      key.slice(this.PREFIX.length),
-      data,
-    ]);
+    let list = [];
+    if (this.client.entries) {
+      list = (await this.client.entries(this.PREFIX)).map(([key, value]) => [
+        key.slice(this.PREFIX.length),
+        value,
+      ]);
+    } else {
+      for await (const [key, value] of this.client.iterate(this.PREFIX)) {
+        list.push([key.slice(this.PREFIX.length), value]);
+      }
+    }
 
     // The client already manages the expiration, so we can assume
     // that at this point, all entries are not-expired
     if (this.client.EXPIRES) return list;
 
     // We need to do manual expiration checking
-    const now = new Date().getTime();
     return list
-      .filter(([key, data]) => {
-        // Should never happen
-        if (!data || data.value === null) return false;
-
-        // It never expires, so keep it
-        const { expires } = data;
-        if (expires === null) return true;
-
-        // It's expired, so remove it
-        if (expires <= now) {
-          this.del(key);
-          return false;
-        }
-
-        // It's not expired, keep it
-        return true;
-      })
+      .filter(([key, data]) => this.#isFresh(data, key))
       .map(([key, data]) => [key, data.value]);
   }
 
@@ -356,23 +361,8 @@ class Store {
     if (this.client.values) {
       const list = this.client.values(this.PREFIX);
       if (this.client.EXPIRES) return list;
-      const now = new Date().getTime();
       return list
-        .filter((data) => {
-          // There's no data, so remove this
-          if (!data || data.value === null) return false;
-
-          // It never expires, so keep it
-          const { expires } = data;
-          if (expires === null) return true;
-
-          // It's expired, so remove it
-          // We cannot unfortunately evict it since we don't know the key!
-          if (expires <= now) return false;
-
-          // It's not expired, keep it
-          return true;
-        })
+        .filter((data) => this.#isFresh(data))
         .map((data) => data.value);
     }
 

package/src/index.test.js

@@ -11,8 +11,6 @@ import kv from "./index.js";
 import customFull from "./test/customFull.js";
 import customSimple from "./test/customSimple.js";
 
-global.setImmediate = global.setImmediate || ((cb) => setTimeout(cb, 0));
-
 const stores = [];
 stores.push(["kv()", kv()]);
 stores.push(["kv(new Map())", kv(new Map())]);
@@ -30,6 +28,7 @@ if (process.env.REDIS) {
   stores.push(["kv(redis)", kv(createClient())]);
 }
 if (process.env.ETCD) {
+  // Note: need to add to .env "ETCD=true" and run `etcd` in the terminal
   stores.push(["kv(new Etcd3())", kv(new Etcd3())]);
 }
 
@@ -41,7 +40,7 @@ const delay = (t) => new Promise((done) => setTimeout(done, t));
 class Base {
   get() {}
   set() {}
-  entries() {}
+  *iterate() {}
 }
 
 global.console = {
@@ -56,7 +55,7 @@ describe("potato", () => {
 
   it("an empty object is not a valid store", async () => {
     await expect(() => kv({}).get("any")).rejects.toThrow({
-      message: "A client should have at least a .get(), .set() and .entries()",
+      message: "A client should have at least a .get(), .set() and .iterate()",
     });
   });
 
@@ -343,6 +342,42 @@ for (let [name, store] of stores) {
       expect(await store.get("a")).toBe("b");
     });
 
+    describe("iteration", () => {
+      beforeEach(async () => {
+        await store.clear();
+      });
+
+      it("supports raw iteration", async () => {
+        await store.set("a", "b");
+        await store.set("c", "d");
+
+        const entries = [];
+        for await (const entry of store) {
+          entries.push(entry);
+        }
+        expect(entries).toEqual([
+          ["a", "b"],
+          ["c", "d"],
+        ]);
+      });
+
+      it("supports raw prefix iteration", async () => {
+        await store.set("a:a", "b");
+        await store.set("b:a", "d");
+        await store.set("a:c", "d");
+        await store.set("b:c", "d");
+
+        const entries = [];
+        for await (const entry of store.prefix("a:")) {
+          entries.push(entry);
+        }
+        expect(entries.sort()).toEqual([
+          ["a", "b"],
+          ["c", "d"],
+        ]);
+      });
+    });
+
     describe("expires", () => {
       // The mock implementation does NOT support expiration 😪
       if (name === "kv(new KVNamespace())") return;

package/src/test/customFull.js

@@ -19,6 +19,13 @@ export default class MyClient {
     delete dataSource[key];
   }
 
+  *iterate(prefix) {
+    const entries = this.entries(prefix);
+    for (const entry of entries) {
+      yield entry;
+    }
+  }
+
   // Filter them by the prefix, note that `prefix` will always be a string
   entries(prefix) {
     const entries = Object.entries(dataSource);

package/src/test/customSimple.js

@@ -15,9 +15,13 @@ export default class MyClient {
   }
 
   // Filter them by the prefix, note that `prefix` will always be a string
-  entries(prefix) {
-    const entries = Object.entries(dataSource);
-    if (!prefix) return entries;
-    return entries.filter(([key, value]) => key.startsWith(prefix));
+  *iterate(prefix) {
+    const raw = Object.entries(dataSource);
+    const entries = prefix
+      ? raw.filter(([key, value]) => key.startsWith(prefix))
+      : raw;
+    for (const entry of entries) {
+      yield entry;
+    }
   }
 }

package/src/test/setup.js

@@ -14,3 +14,10 @@ if (typeof TextDecoder === "undefined") {
     value: util.TextDecoder,
   });
 }
+
+if (typeof setImmediate === "undefined") {
+  Object.defineProperty(window, "setImmediate", {
+    writable: true,
+    value: (cb) => setTimeout(cb, 0),
+  });
+}

package/.github/FUNDING.yml

@@ -1 +0,0 @@
-custom: https://www.paypal.me/franciscopresencia/19

package/.github/workflows/tests.yml

@@ -1,24 +0,0 @@
-name: tests
-
-on: [push]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [18.x, 20.x]
-
-    steps:
-      - uses: actions/checkout@v4
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-      - name: install dependencies
-        run: npm install
-      - name: npm test
-        run: npm test
-        env:
-          CI: true

package/assets/home.html

@@ -1,376 +0,0 @@
-<br />
-
-<section class="hero flex center nowrap">
-  <div>
-    <h1>Polystore</h1>
-    <p style="max-width: 620px">
-      A library to unify KV-stores. Allows you to write code that works on any
-      KV store, both on the front-end and backend. Supports substores and
-      intuitive expiration times. Get started:
-    </p>
-    <pre class="small">npm install polystore</pre>
-    <div class="buttons">
-      <a class="button" href="/documentation">Documentation</a>
-      <a
-        class="pseudo button"
-        href="https://superpeer.com/francisco/-/javascript-and-react-help"
-        >Professional JS help</a
-      >
-    </div>
-  </div>
-  <div style="width: 570px; max-width: 100%">
-    <pre><code class="language-js">import kv from &quot;polystore&quot;;
-import { createClient } from "redis";
-
-const REDIS = process.env.REDIS_URL;
-const store = kv(createClient(REDIS));
-
-await store.set(key, data, { expires: "1h" });
-console.log(await store.get(key));
-// { hello: &quot;world&quot; }</code></pre>
-  </div>
-</section>
-
-<div class="separator">
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 20">
-    <circle cx="10" cy="10" r="3" />
-    <line x1="20" y1="10" x2="260" y2="10" />
-    <circle cx="270" cy="10" r="3" />
-    <circle class="empty" cx="283" cy="10" r="3" />
-    <circle class="empty" cx="300" cy="10" r="5" />
-    <circle class="empty" cx="317" cy="10" r="3" />
-    <circle cx="330" cy="10" r="3" />
-    <line x1="340" y1="10" x2="580" y2="10" />
-    <circle cx="590" cy="10" r="3" />
-  </svg>
-</div>
-
-<section class="features flex one two-500 three-900">
-  <div>
-    <div class="feature">
-      <header>
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-          <path
-            d="M18 8h1a4 4 0 010 8h-1M2 8h16v9a4 4 0 01-4 4H6a4 4 0 01-4-4V8zM6 1v3M10 1v3M14 1v3"
-          />
-        </svg>
-        <h3>Easy peasy</h3>
-      </header>
-      <p>
-        It's a KV store. It has <code>add()</code>, <code>set()</code>,
-        <code>get()</code>, <code>has()</code>, <code>del()</code>
-        <a href="/documentation#api" target="_blank">and more</a>.
-      </p>
-    </div>
-  </div>
-
-  <div>
-    <div class="feature">
-      <header>
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-          <path d="M14 2H6a2 2 0 00-2 2v16a2 2 0 002 2h12a2 2 0 002-2V8z" />
-          <path d="M14 2v6h6M16 13H8M16 17H8M10 9H8" />
-        </svg>
-        <h3>Documented</h3>
-      </header>
-      <p>
-        <a href="/documentation#getting-started">Getting started</a>,
-        <a href="/documentation#api">API</a>,
-        <a href="/documentation#clients">Clients</a> and
-        <a href="/documentation#creating-a-store">custom stores</a> for your
-        convenience.
-      </p>
-    </div>
-  </div>
-  <div>
-    <div class="feature">
-      <header>
-        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
-          <path d="M22 11.08V12a10 10 0 1 1-5.93-9.14"></path>
-          <polyline points="22 4 12 14.01 9 11.01"></polyline>
-        </svg>
-        <h3>Tested and Typed</h3>
-      </header>
-      <p>
-        <a
-          href="https://github.com/franciscop/polystore/actions"
-          target="_blank"
-          >600+ tests</a
-        >, TS definitions and JSDocs for the best experience using the library.
-      </p>
-    </div>
-  </div>
-  <div>
-    <div class="feature">
-      <header>
-        <svg
-          xmlns="http://www.w3.org/2000/svg"
-          width="24"
-          height="24"
-          viewBox="0 0 24 24"
-          fill="none"
-          stroke="currentColor"
-          stroke-width="2"
-          stroke-linecap="round"
-          stroke-linejoin="round"
-          class="feather feather-globe"
-        >
-          <circle cx="12" cy="12" r="10"></circle>
-          <line x1="2" y1="12" x2="22" y2="12"></line>
-          <path
-            d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"
-          ></path>
-        </svg>
-        <h3>Universal Javascript</h3>
-      </header>
-      <p>
-        Use it with React, Angular, Plain JS, Node.js, Bun, Tauri, Electron,
-        etc.
-      </p>
-    </div>
-  </div>
-
-  <div>
-    <div class="feature">
-      <header>
-        <svg
-          xmlns="http://www.w3.org/2000/svg"
-          width="24"
-          height="24"
-          viewBox="0 0 24 24"
-          fill="none"
-          stroke="currentColor"
-          stroke-width="2"
-          stroke-linecap="round"
-          stroke-linejoin="round"
-        >
-          <path
-            d="M20.24 12.24a6 6 0 00-8.49-8.49L5 10.5V19h8.5zM16 8L2 22M17.5 15H9"
-          />
-        </svg>
-        <h3>Tiny Footprint</h3>
-      </header>
-      <p>
-        At
-        <a href="https://bundlephobia.com/package/polystore" target="_blank"
-          >just <strong>3kb</strong></a
-        >
-        (min+gzip), the impact on your app loading time is minimal.
-      </p>
-    </div>
-  </div>
-
-  <div>
-    <div class="feature">
-      <header>
-        <svg
-          xmlns="http://www.w3.org/2000/svg"
-          width="24"
-          height="24"
-          viewBox="0 0 24 24"
-          fill="none"
-          stroke="currentColor"
-          stroke-width="2"
-          stroke-linecap="round"
-          stroke-linejoin="round"
-          class="feather feather-clock"
-        >
-          <circle cx="12" cy="12" r="10"></circle>
-          <polyline points="12 6 12 12 16 14"></polyline>
-        </svg>
-        <h3>Intuitive expirations</h3>
-      </header>
-      <p>Write the expiration as <code>100s</code>, <code>1week</code>, etc.</p>
-      and forget time-related bugs.
-    </div>
-  </div>
-</section>
-
-<div class="separator">
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 20">
-    <circle cx="10" cy="10" r="3" />
-    <line x1="20" y1="10" x2="260" y2="10" />
-    <circle cx="270" cy="10" r="3" />
-    <circle class="empty" cx="283" cy="10" r="3" />
-    <circle class="empty" cx="300" cy="10" r="5" />
-    <circle class="empty" cx="317" cy="10" r="3" />
-    <circle cx="330" cy="10" r="3" />
-    <line x1="340" y1="10" x2="580" y2="10" />
-    <circle cx="590" cy="10" r="3" />
-  </svg>
-</div>
-
-<section class="hero flex one two-900 center">
-  <div>
-    <div class="content">
-      <h2>🧩 Support for many clients</h2>
-      <p>
-        We support 10+ clients with documentation for each of them. Adding your
-        own client is also easy, you only need to define 3 methods:
-        <code>.get()</code>, <code>.set()</code> and <code>.entries()</code>.
-      </p>
-      <p>
-        <a class="pseudo button" href="/documentation#clients">
-          Clients Docs
-        </a>
-      </p>
-    </div>
-  </div>
-  <div>
-    <pre><code class="language-js">import kv from &quot;polystore&quot;;
-
-const store1 = kv(new Map());
-const store2 = kv(localStorage);
-const store3 = kv(redisClient);
-const store4 = kv(&quot;cookie&quot;);
-const store5 = kv(&quot;file:///users/me/kv.json&quot;);
-const store6 = kv(yourOwnStore);</code></pre>
-  </div>
-</section>
-
-<br />
-
-<section class="hero flex one two-900 center">
-  <div>
-    <div class="content">
-      <h2>🏖️ Clean and intuitive API</h2>
-      <p>
-        A set of high-performance item operations with <code>.add()</code>,
-        <code>.set()</code>, <code>.get()</code>, <code>.has()</code> or
-        <code>.del()</code>. We also provide group operations to manage your
-        data easily.
-      </p>
-      <p>
-        <a class="pseudo button" href="/documentation#api">API Docs</a>
-      </p>
-    </div>
-  </div>
-  <div>
-    <pre><code class="language-js">import kv from "polystore";
-const store = kv(new Map());
-      
-const key1 = await store.add(&quot;value1&quot;);
-const key2 = await store.set(&quot;key2&quot;, &quot;value2&quot;);
-const val1 = await store.get(&quot;key1&quot;);
-const isthere = await store.has(&quot;key1&quot;);
-await store.del(key1);</code></pre>
-  </div>
-</section>
-
-<section class="hero flex one two-900 center">
-  <div>
-    <div class="content">
-      <h2>🛗 Create substores</h2>
-      <p>
-        Create a new substore with <code>.prefix()</code>, then you can ignore
-        anything related to the prefix and treat it as if it was a brand new
-        store.
-      </p>
-      <p>
-        <a class="pseudo button" href="/documentation#substores"
-          >Substore Docs
-        </a>
-      </p>
-    </div>
-  </div>
-  <div>
-    <pre><code class="language-js">const session = store.prefix("session:");
-session.set("key1", "value1");
-
-console.log(await session.all());
-// { "key1": "value1" }
-
-console.log(await store.all());
-// { "session:key1": "value1" }</code></pre>
-  </div>
-</section>
-
-<br />
-
-<section class="hero flex one two-900 center">
-  <div>
-    <div class="content">
-      <h2>⏰ Easy expiration time</h2>
-      <p>
-        Simply write <code>{ expires: "1day" }</code> with ANY client and forget
-        about calculating TTL, Unix time, seconds vs milliseconds bugs, etc.
-      </p>
-      <p>
-        <a class="pseudo button" href="/documentation#expiration-explained">
-          Documentation
-        </a>
-      </p>
-    </div>
-  </div>
-  <div>
-    <pre><code class="language-js">await store.get("key");  // null
-
-await store.set("key", "value", { expires: "1s" });
-await store.get("key");  // "value"
-
-await sleep(2000);
-
-await store.get("key");  // null</code></pre>
-  </div>
-</section>
-
-<br />
-
-<section class="hero flex one two-900 center">
-  <div>
-    <div class="content">
-      <h2>✨ Magic Autocomplete</h2>
-      <p>
-        Added jsdocs so the expected parameters and return value will be clearly
-        defined in your IDE/Code Editor.
-      </p>
-      <p>
-        We added the <em>description</em>, a representative <em>example</em> and
-        even a <em>link</em> for more information for
-        <strong>every one</strong> of the methods available! We want you to have
-        the best development experience possible with Polystore!
-      </p>
-    </div>
-  </div>
-  <div>
-    <div class="splash">
-      <img
-        width="535"
-        src="https://raw.githubusercontent.com/franciscop/polystore/master/assets/autocomplete.webp"
-      />
-    </div>
-  </div>
-</section>
-
-<div class="separator">
-  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 600 20">
-    <circle cx="10" cy="10" r="3" />
-    <line x1="20" y1="10" x2="260" y2="10" />
-    <circle cx="270" cy="10" r="3" />
-    <circle class="empty" cx="283" cy="10" r="3" />
-    <circle class="empty" cx="300" cy="10" r="5" />
-    <circle class="empty" cx="317" cy="10" r="3" />
-    <circle cx="330" cy="10" r="3" />
-    <line x1="340" y1="10" x2="580" y2="10" />
-    <circle cx="590" cy="10" r="3" />
-  </svg>
-</div>
-
-<div style="text-align: center">
-  <p>
-    Created by <a href="https://francisco.io/" target="_blank">Francisco</a> and
-    <a
-      href="https://github.com/franciscop/polystore/graphs/contributors"
-      target="_blank"
-      >other contributors</a
-    >.
-  </p>
-  <p>
-    Need help?
-    <a
-      href="https://superpeer.com/francisco/-/javascript-and-react-help"
-      target="_blank"
-      >Book a call</a
-    >.
-  </p>
-</div>

package/documentation.page.json

@@ -1,11 +0,0 @@
-{
-  "title": "🏬 Polystore - A universal library for standardizing any KV-store",
-  "home": "assets/home.html",
-  "homepage": "https://polystore.dev/",
-  "menu": {
-    "Documentation": "/documentation",
-    "Issues": "https://github.com/franciscop/polystore/issues",
-    "Get help": "https://superpeer.com/francisco/-/javascript-and-react-help",
-    "Github": "https://github.com/franciscop/polystore"
-  }
-}