polystore 0.15.12 → 0.16.0

package/src/clients/Client.js

@@ -1,7 +0,0 @@
-export default class Client {
-  constructor(client) {
-    this.client = client;
-  }
-  encode = (val) => JSON.stringify(val, null, 2);
-  decode = (val) => (val ? JSON.parse(val) : null);
-}

package/src/clients/api.js

@@ -1,30 +0,0 @@
-import Client from "./Client.js";
-
-// Handle an API endpoint with fetch()
-export default class Api extends Client {
-  // Indicate that the file handler DOES handle expirations
-  EXPIRES = true;
-
-  static test = (client) =>
-    typeof client === "string" && /^https?:\/\//.test(client);
-
-  #api = async (key, opts = "", method = "GET", body) => {
-    const url = `${this.client.replace(/\/$/, "")}/${encodeURIComponent(key)}${opts}`;
-    const headers = { accept: "application/json" };
-    if (body) headers["content-type"] = "application/json";
-    const res = await fetch(url, { method, headers, body });
-    return res.ok ? res.json() : null;
-  };
-
-  get = (key) => this.#api(key);
-  set = (key, value, { expires } = {}) =>
-    this.#api(key, `?expires=${expires || ""}`, "PUT", this.encode(value));
-  del = (key) => this.#api(key, "", "DELETE");
-
-  async *iterate(prefix = "") {
-    const data = await this.#api("", `?prefix=${encodeURIComponent(prefix)}`);
-    for (let [key, value] of Object.entries(data || {})) {
-      yield [prefix + key, value];
-    }
-  }
-}

package/src/clients/cloudflare.js

@@ -1,56 +0,0 @@
-import Client from "./Client.js";
-
-// Use Cloudflare's KV store
-export default class Cloudflare extends Client {
-  // Indicate that the file handler does NOT handle expirations
-  EXPIRES = true;
-
-  // Check whether the given store is a FILE-type
-  static test = (client) =>
-    client?.constructor?.name === "KvNamespace" ||
-    client?.constructor?.name === "EdgeKVNamespace";
-
-  get = async (key) => this.decode(await this.client.get(key));
-  set = (key, value, { expires } = {}) => {
-    const expirationTtl = expires ? Math.round(expires) : undefined;
-    if (expirationTtl && expirationTtl < 60) {
-      throw new Error("Cloudflare's min expiration is '60s'");
-    }
-    return this.client.put(key, this.encode(value), { expirationTtl });
-  };
-
-  del = (key) => 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 value is read it could be gone!
-        if (value) yield [key, value];
-      }
-      cursor = raw.list_complete ? null : raw.cursor;
-    } while (cursor);
-  }
-
-  keys = async (prefix = "") => {
-    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;
-  };
-
-  entries = async (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]]);
-  };
-}

package/src/clients/cookie.js

@@ -1,51 +0,0 @@
-import Client from "./Client.js";
-
-// A client that uses a single file (JSON) as a store
-export default class Cookie extends Client {
-  // Indicate if this client handles expirations (true = it does)
-  EXPIRES = true;
-
-  // Check if this is the right class for the given client
-  static test = (client) => 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) => this.#read()[key] || null;
-
-  set = (key, data = null, { expires } = {}) => {
-    // Setting it to null deletes it
-    let expireStr = "";
-    // NOTE: 0 is already considered here!
-    if (expires !== null) {
-      const time = new Date(Date.now() + expires * 1000).toUTCString();
-      expireStr = `; expires=${time}`;
-    }
-
-    const value = encodeURIComponent(this.encode(data || ""));
-    document.cookie = encodeURIComponent(key) + "=" + value + expireStr;
-  };
-
-  del = (key) => this.set(key, "", { expires: -100 });
-
-  async *iterate(prefix = "") {
-    for (let [key, value] of Object.entries(this.#read())) {
-      if (!key.startsWith(prefix)) continue;
-      yield [key, value];
-    }
-  }
-}

package/src/clients/etcd.js

@@ -1,29 +0,0 @@
-import Client from "./Client.js";
-
-// Use a redis client to back up the store
-export default class Etcd extends Client {
-  // Check if this is the right class for the given client
-  static test = (client) => client?.constructor?.name === "Etcd3";
-
-  get = (key) => this.client.get(key).json();
-  set = (key, value) => this.client.put(key).value(this.encode(value));
-  del = (key) => this.client.delete().key(key).exec();
-
-  async *iterate(prefix = "") {
-    const keys = await this.client.getAll().prefix(prefix).keys();
-    for (const key of keys) {
-      yield [key, await this.get(key)];
-    }
-  }
-
-  keys = (prefix = "") => this.client.getAll().prefix(prefix).keys();
-  entries = async (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]]);
-  };
-  clear = async (prefix = "") => {
-    if (!prefix) return this.client.delete().all();
-    return this.client.delete().prefix(prefix);
-  };
-}

package/src/clients/file.js

@@ -1,70 +0,0 @@
-import Client from "./Client.js";
-
-// A client that uses a single file (JSON) as a store
-export default class File extends Client {
-  // Check if this is the right class for the given client
-  static test = (client) => {
-    if (client instanceof URL) client = client.href;
-    return (
-      typeof client === "string" &&
-      client.startsWith("file://") &&
-      client.includes(".")
-    );
-  };
-
-  // We want to make sure the file already exists, so attempt to
-  // create the folders and the file (but not OVERWRITE it, that's why the x flag)
-  // It fails if it already exists, hence the catch case
-  #promise = (async () => {
-    this.fsp = await import("node:fs/promises");
-    this.file = (this.client?.href || this.client).replace(/^file:\/\//, "");
-    const folder = this.file.split("/").slice(0, -1).join("/");
-    await this.fsp.mkdir(folder, { recursive: true }).catch(() => {});
-    await this.fsp.writeFile(this.file, "{}", { flag: "wx" }).catch(() => {});
-  })();
-
-  // Internal
-  #read = async () => {
-    const text = await this.fsp.readFile(this.file, "utf8");
-    return text ? JSON.parse(text) : {};
-  };
-
-  #write = async (data) => {
-    return this.fsp.writeFile(this.file, this.encode(data));
-  };
-
-  get = async (key) => {
-    const data = await this.#read();
-    return data[key] ?? null;
-  };
-
-  set = async (key, value) => {
-    const data = await this.#read();
-    if (value === null) {
-      delete data[key];
-    } else {
-      data[key] = value;
-    }
-    await this.#write(data);
-  };
-
-  async *iterate(prefix = "") {
-    const data = await this.#read();
-    const entries = Object.entries(data).filter((p) => p[0].startsWith(prefix));
-    for (const entry of entries) {
-      yield entry;
-    }
-  }
-
-  // Bulk updates are worth creating a custom method here
-  clearAll = () => this.#write({});
-  clear = async (prefix = "") => {
-    const data = await this.#read();
-    for (let key in data) {
-      if (key.startsWith(prefix)) {
-        delete data[key];
-      }
-    }
-    await this.#write(data);
-  };
-}

package/src/clients/folder.js

@@ -1,49 +0,0 @@
-import Client from "./Client.js";
-
-const noFileOk = (error) => {
-  if (error.code === "ENOENT") return null;
-  throw error;
-};
-
-// A client that uses a single file (JSON) as a store
-export default class Folder extends Client {
-  // Check if this is the right class for the given client
-  static test = (client) => {
-    if (client instanceof URL) client = client.href;
-    return (
-      typeof client === "string" &&
-      client.startsWith("file://") &&
-      client.endsWith("/")
-    );
-  };
-
-  // Make sure the folder already exists, so attempt to create it
-  // It fails if it already exists, hence the catch case
-  #promise = (async () => {
-    this.fsp = await import("node:fs/promises");
-    this.folder = (this.client?.href || this.client).replace(/^file:\/\//, "");
-    await this.fsp.mkdir(this.folder, { recursive: true }).catch(() => {});
-  })();
-
-  file = (key) => this.folder + key + ".json";
-
-  get = (key) => {
-    return this.fsp
-      .readFile(this.file(key), "utf8")
-      .then(this.decode, noFileOk);
-  };
-  set = (key, value) => {
-    return this.fsp.writeFile(this.file(key), this.encode(value), "utf8");
-  };
-  del = (key) => this.fsp.unlink(this.file(key)).catch(noFileOk);
-
-  async *iterate(prefix = "") {
-    const all = await this.fsp.readdir(this.folder);
-    const keys = all.filter((f) => f.startsWith(prefix) && f.endsWith(".json"));
-    for (const name of keys) {
-      const key = name.slice(0, -".json".length);
-      const data = await this.get(key);
-      yield [key, data];
-    }
-  }
-}

package/src/clients/forage.js

@@ -1,29 +0,0 @@
-import Client from "./Client.js";
-
-// Use localForage for managing the KV
-export default class Forage extends Client {
-  // Check if this is the right class for the given client
-  static test = (client) =>
-    client?.defineDriver && client?.dropInstance && client?.INDEXEDDB;
-
-  get = (key) => this.client.getItem(key);
-  set = (key, value) => this.client.setItem(key, value);
-  del = (key) => this.client.removeItem(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)];
-    }
-  }
-
-  entries = async (prefix = "") => {
-    const all = await this.client.keys();
-    const keys = all.filter((k) => k.startsWith(prefix));
-    const values = await Promise.all(keys.map((key) => this.get(key)));
-    return keys.map((key, i) => [key, values[i]]);
-  };
-
-  clearAll = () => this.client.clear();
-}

package/src/clients/index.js

@@ -1,25 +0,0 @@
-import api from "./api.js";
-import cloudflare from "./cloudflare.js";
-import cookie from "./cookie.js";
-import etcd from "./etcd.js";
-import file from "./file.js";
-import folder from "./folder.js";
-import forage from "./forage.js";
-import level from "./level.js";
-import memory from "./memory.js";
-import redis from "./redis.js";
-import storage from "./storage.js";
-
-export default {
-  api,
-  cloudflare,
-  cookie,
-  etcd,
-  file,
-  folder,
-  forage,
-  level,
-  memory,
-  redis,
-  storage,
-};

package/src/clients/level.js

@@ -1,40 +0,0 @@
-import Client from "./Client.js";
-
-const valueEncoding = "json";
-const notFound = (error) => {
-  if (error?.code === "LEVEL_NOT_FOUND") return null;
-  throw error;
-};
-
-// Level KV DB - https://github.com/Level/level
-export default class Level extends Client {
-  // Check if this is the right class for the given client
-  static test = (client) => client?.constructor?.name === "ClassicLevel";
-
-  get = (key) => this.client.get(key, { valueEncoding }).catch(notFound);
-  set = (key, value) => this.client.put(key, value, { valueEncoding });
-  del = (key) => 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)];
-    }
-  }
-
-  entries = async (prefix = "") => {
-    const keys = await this.client.keys().all();
-    const list = keys.filter((k) => k.startsWith(prefix));
-    return Promise.all(list.map(async (k) => [k, await this.get(k)]));
-  };
-
-  clearAll = () => this.client.clear();
-  clear = async (prefix = "") => {
-    const keys = await this.client.keys().all();
-    const list = keys.filter((k) => k.startsWith(prefix));
-    return this.client.batch(list.map((key) => ({ type: "del", key })));
-  };
-
-  close = () => this.client.close();
-}

package/src/clients/memory.js

@@ -1,19 +0,0 @@
-import Client from "./Client.js";
-
-// Use a Map() as an in-memory client
-export default class Memory extends Client {
-  // Check if this is the right class for the given client
-  static test = (client) => client instanceof Map;
-
-  get = (key) => this.client.get(key) ?? null;
-  set = (key, data) => this.client.set(key, data);
-  del = (key) => this.client.delete(key);
-
-  *iterate(prefix = "") {
-    for (const entry of this.client.entries()) {
-      if (entry[0].startsWith(prefix)) yield entry;
-    }
-  }
-
-  clearAll = () => this.client.clear();
-}

package/src/clients/redis.js

@@ -1,51 +0,0 @@
-import Client from "./Client.js";
-
-// Use a redis client to back up the store
-export default class Redis extends Client {
-  // Indicate if this client handles expirations (true = it does)
-  EXPIRES = true;
-
-  // Check if this is the right class for the given client
-  static test = (client) => client && client.pSubscribe && client.sSubscribe;
-
-  get = async (key) => this.decode(await this.client.get(key));
-  set = async (key, value, { expires } = {}) => {
-    const EX = expires ? Math.round(expires) : undefined;
-    return this.client.set(key, this.encode(value), { EX });
-  };
-  del = (key) => this.client.del(key);
-
-  has = async (key) => Boolean(await this.client.exists(key));
-
-  // 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);
-      // By the time this specific value is read, it could be gone!
-      if (!value) continue;
-      yield [key, value];
-    }
-  }
-
-  // Optimizing the retrieval of them by not getting their values
-  keys = async (prefix = "") => {
-    const MATCH = prefix + "*";
-    const keys = [];
-    for await (const key of this.client.scanIterator({ MATCH })) {
-      keys.push(key);
-    }
-    return keys;
-  };
-
-  // Optimizing the retrieval of them all in bulk by loading the values
-  // in parallel
-  entries = async (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]]);
-  };
-
-  clearAll = () => this.client.flushAll();
-  close = () => this.client.quit();
-}

package/src/clients/storage.js

@@ -1,25 +0,0 @@
-import Client from "./Client.js";
-
-// A client that uses a single file (JSON) as a store
-export default class WebStorage extends Client {
-  // Check if this is the right class for the given client
-  static test(client) {
-    if (typeof Storage === "undefined") return false;
-    return client instanceof Storage;
-  }
-
-  // Item methods
-  get = (key) => this.decode(this.client[key]);
-  set = (key, data) => this.client.setItem(key, this.encode(data));
-  del = (key) => this.client.removeItem(key);
-
-  *iterate(prefix = "") {
-    for (const key of Object.keys(this.client)) {
-      if (!key.startsWith(prefix)) continue;
-      const value = this.get(key);
-      if (value) yield [key, value];
-    }
-  }
-
-  clearAll = () => this.client.clear();
-}