polystore 0.1.1 → 0.3.0

package/index.min.js

@@ -1,2 +1,2 @@
-var l={},g=/(-?(?:\d+\.?\d*|\d*\.?\d+)(?:e[-+]?\d+)?)\s*([\p{L}]*)/iu;t.millisecond=t.ms=1;t.second=t.sec=t.s=t[""]=t.ms*1e3;t.minute=t.min=t.m=t.s*60;t.hour=t.hr=t.h=t.m*60;t.day=t.d=t.h*24;t.week=t.wk=t.w=t.d*7;t.year=t.yr=t.y=t.d*365.25;t.month=t.b=t.y/12;function t(e){if(e==null)return null;if(typeof e=="number")return e;e=e.toLowerCase().replace(/[,_]/g,"");let[u,y,i]=g.exec(e)||[];if(!i)return null;let c=t[i]||t[i.replace(/s$/,"")];if(!c)return null;let d=c*parseFloat(y,10);return Math.abs(Math.round(d))}l.expire=e=>{let u=async n=>{if(!await e.has(n))return null;let{data:a,expire:o}=await e.get(n);return o===null?a:o-new Date().getTime()<=0?null:a},y=async(n,a,{expire:o=null}={})=>{let r=t(o),f=r!==null?new Date().getTime()+r:null;return e.set(n,{expire:f,data:a})},i=async n=>await e.get(n)!==null,c=e.del,d=e.keys,s=e.clear;return{get:u,set:y,has:i,del:c,keys:d,clear:s}};l.memory=e=>({get:async n=>e.get(n)||null,set:async(n,a)=>e.set(n,a),has:async n=>e.has(n),del:async n=>e.delete(n),keys:async(n="")=>[...await e.keys()].filter(a=>a.startsWith(n)),clear:()=>e.clear()});l.localStorage=e=>({get:async n=>e[n]?JSON.parse(e[n]):null,set:async(n,a)=>e.setItem(n,JSON.stringify(a)),has:async n=>n in e,del:async n=>e.removeItem(n),keys:async(n="")=>Object.keys(e).filter(a=>a.startsWith(n)),clear:()=>e.clear()});l.cookie=()=>{let e=async s=>{let n=document.cookie.split("; ").filter(Boolean).find(a=>a.startsWith(s+"="))?.split("=")[1]||null;return JSON.parse(decodeURIComponent(n))},u=async(s,n,{expire:a=null}={})=>{let o=t(a),r=new Date().getTime(),f=o!==null?`; expires=${new Date(r+o).toUTCString()}`:"",p=encodeURIComponent(JSON.stringify(n));document.cookie=s+"="+p+f},y=async s=>(await c()).includes(s),i=async s=>u(s,"",{expire:-100}),c=async(s="")=>document.cookie.split(";").map(n=>n.split("=")[0].trim()).filter(Boolean).filter(n=>n.startsWith(s));return{get:e,set:u,has:y,del:i,keys:c,clear:async()=>{await Promise.all((await c()).map(i))}}};l.redis=e=>{let u=async a=>{let r=await(await e).get(a);return r?JSON.parse(r):null},y=async(a,o,{expire:r=null}={})=>{if(o===null||r===0)return c(a);let f=await e,p=t(r),m=p?Math.round(p/1e3):void 0;return f.set(a,JSON.stringify(o),{EX:m})},i=async a=>!!await(await e).exists(a),c=async a=>(await e).del(a);return{get:u,set:y,has:i,del:c,keys:async(a="")=>(await e).keys(a+"*"),clear:async()=>(await e).flushAll(),close:async()=>(await e).quit()}};function w(e){return!e||e instanceof Map?l.expire(l.memory(e||new Map)):typeof localStorage<"u"&&e===localStorage||typeof sessionStorage<"u"&&e===sessionStorage?l.expire(l.localStorage(e)):e==="cookie"?l.cookie():l.redis(e)}export{w as default};
+var o={},m=/(-?(?:\d+\.?\d*|\d*\.?\d+)(?:e[-+]?\d+)?)\s*([\p{L}]*)/iu;n.millisecond=n.ms=1;n.second=n.sec=n.s=n[""]=n.ms*1e3;n.minute=n.min=n.m=n.s*60;n.hour=n.hr=n.h=n.m*60;n.day=n.d=n.h*24;n.week=n.wk=n.w=n.d*7;n.year=n.yr=n.y=n.d*365.25;n.month=n.b=n.y/12;function n(t){if(t==null)return null;if(typeof t=="number")return t;t=t.toLowerCase().replace(/[,_]/g,"");let[u,l,r]=m.exec(t)||[];if(!r)return null;let c=n[r]||n[r.replace(/s$/,"")];if(!c)return null;let w=c*parseFloat(l,10);return Math.abs(Math.round(w))}o.expire=t=>{let u=async e=>{if(!await t.has(e))return null;let{data:a,expire:d}=await t.get(e);return d===null?a:d-new Date().getTime()<=0?null:a},l=async(e,a,{expire:d=null}={})=>{let s=n(d),i=s!==null?new Date().getTime()+s:null;return t.set(e,{expire:i,data:a})},r=async e=>await t.get(e)!==null,c=t.del,w=t.keys,y=t.clear;return{get:u,set:l,has:r,del:c,keys:w,clear:y}};o.memory=t=>({get:async e=>t.get(e)||null,set:async(e,a)=>t.set(e,a),has:async e=>t.has(e),del:async e=>t.delete(e),keys:async(e="")=>[...await t.keys()].filter(a=>a.startsWith(e)),clear:()=>t.clear()});o.storage=t=>({get:async e=>t[e]?JSON.parse(t[e]):null,set:async(e,a)=>t.setItem(e,JSON.stringify(a)),has:async e=>e in t,del:async e=>t.removeItem(e),keys:async(e="")=>Object.keys(t).filter(a=>a.startsWith(e)),clear:()=>t.clear()});o.cookie=()=>{let t=async y=>{let e=document.cookie.split("; ").filter(Boolean).find(a=>a.startsWith(y+"="))?.split("=")[1]||null;return JSON.parse(decodeURIComponent(e))},u=async(y,e,{expire:a=null}={})=>{let d=n(a),s=new Date().getTime(),i=d!==null?`; expires=${new Date(s+d).toUTCString()}`:"",f=encodeURIComponent(JSON.stringify(e));document.cookie=y+"="+f+i},l=async y=>(await c()).includes(y),r=async y=>u(y,"",{expire:-100}),c=async(y="")=>document.cookie.split(";").map(e=>e.split("=")[0].trim()).filter(Boolean).filter(e=>e.startsWith(y));return{get:t,set:u,has:l,del:r,keys:c,clear:async()=>{await Promise.all((await c()).map(r))}}};o.redis=t=>{let u=async a=>{let s=await(await t).get(a);return s?JSON.parse(s):null},l=async(a,d,{expire:s=null}={})=>{if(d===null||s===0)return c(a);let i=await t,f=n(s),p=f?Math.round(f/1e3):void 0;return i.set(a,JSON.stringify(d),{EX:p})},r=async a=>!!await(await t).exists(a),c=async a=>(await t).del(a);return{get:u,set:l,has:r,del:c,keys:async(a="")=>(await t).keys(a+"*"),clear:async()=>(await t).flushAll(),close:async()=>(await t).quit()}};o.localForage=t=>{let u=e=>t.getItem(e);return{get:u,set:(e,a)=>t.setItem(e,a),has:async e=>await u(e)!==null,del:e=>t.removeItem(e),keys:async(e="")=>(await t.keys()).filter(a=>a.startsWith(e)),clear:()=>t.clear()}};o.file=t=>{let u=(async()=>{let i=await import("node:fs/promises");return await i.writeFile(t,"{}",{flag:"wx"}).catch(f=>{if(f.code!=="EEXIST")throw f}),i})(),l=async()=>{let i=await(await u).readFile(t,"utf8");return i?JSON.parse(i):{}},r=async s=>{await(await u).writeFile(t,JSON.stringify(s,null,2))},c=async s=>(await l())[s]??null;return{get:c,set:async(s,i)=>{let f=await l();f[s]=i,await r(f)},has:async s=>await c(s)!==null,del:async s=>{let i=await l();delete i[s],await r(i)},keys:async(s="")=>{let i=await l();return Object.keys(i).filter(f=>f.startsWith(s))},clear:async()=>{await r({})}}};var g=async t=>t instanceof Map?o.expire(o.memory(t)):typeof localStorage<"u"&&t===localStorage||typeof sessionStorage<"u"&&t===sessionStorage?o.expire(o.storage(t)):t==="cookie"?o.cookie():t.defineDriver&&t.dropInstance&&t.INDEXEDDB?o.expire(o.localForage(t)):t.protocol&&t.protocol==="file:"?o.expire(o.file(t)):t.pSubscribe&&t.sSubscribe?o.redis(t):null;function h(t=new Map){return new Proxy({},{get:(u,l)=>async(...r)=>{let c=await g(await t);if(!c)throw new Error("Store is not valid");return!c[l]&&l==="close"?null:c[l](...r)}})}export{h as default};
 //# sourceMappingURL=index.min.js.map

package/index.min.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["src/index.js"],
-  "sourcesContent": ["const layers = {};\n\nconst times = /(-?(?:\\d+\\.?\\d*|\\d*\\.?\\d+)(?:e[-+]?\\d+)?)\\s*([\\p{L}]*)/iu;\n\nparse.millisecond = parse.ms = 1;\nparse.second = parse.sec = parse.s = parse[\"\"] = parse.ms * 1000;\nparse.minute = parse.min = parse.m = parse.s * 60;\nparse.hour = parse.hr = parse.h = parse.m * 60;\nparse.day = parse.d = parse.h * 24;\nparse.week = parse.wk = parse.w = parse.d * 7;\nparse.year = parse.yr = parse.y = parse.d * 365.25;\nparse.month = parse.b = parse.y / 12;\n\nfunction parse(str) {\n  if (str === null || str === undefined) return null;\n  if (typeof str === \"number\") return str;\n  // ignore commas/placeholders\n  str = str.toLowerCase().replace(/[,_]/g, \"\");\n  let [_, value, units] = times.exec(str) || [];\n  if (!units) return null;\n  const unitValue = parse[units] || parse[units.replace(/s$/, \"\")];\n  if (!unitValue) return null;\n  const result = unitValue * parseFloat(value, 10);\n  return Math.abs(Math.round(result));\n}\n\nlayers.expire = (store) => {\n  // Item methods\n  const get = async (key) => {\n    if (!(await store.has(key))) return null;\n    const { data, expire } = await store.get(key);\n    if (expire === null) return data;\n    const diff = expire - new Date().getTime();\n    if (diff <= 0) return null;\n    return data;\n  };\n  const set = async (key, data, { expire = null } = {}) => {\n    const time = parse(expire);\n    const expDiff = time !== null ? new Date().getTime() + time : null;\n    return store.set(key, { expire: expDiff, data });\n  };\n  const has = async (key) => (await store.get(key)) !== null;\n  const del = store.del;\n\n  // Group methods\n  const keys = store.keys;\n  const clear = store.clear;\n\n  return { get, set, has, del, keys, clear };\n};\n\nlayers.memory = (store) => {\n  // Item methods\n  const get = async (key) => store.get(key) || null;\n  const set = async (key, data) => store.set(key, data);\n  const has = async (key) => store.has(key);\n  const del = async (key) => store.delete(key);\n\n  // Group methods\n  const keys = async (prefix = \"\") =>\n    [...(await store.keys())].filter((k) => k.startsWith(prefix)); // \uD83E\uDD37\u200D\u2642\uFE0F\n  const clear = () => store.clear();\n\n  return { get, set, has, del, keys, clear };\n};\n\nlayers.localStorage = (store) => {\n  // Item methods\n  const get = async (key) => (store[key] ? JSON.parse(store[key]) : null);\n  const set = async (key, data) => store.setItem(key, JSON.stringify(data));\n  const has = async (key) => key in store;\n  const del = async (key) => store.removeItem(key);\n\n  // Group methods\n  const keys = async (prefix = \"\") =>\n    Object.keys(store).filter((k) => k.startsWith(prefix));\n  const clear = () => store.clear();\n\n  return { get, set, has, del, keys, clear };\n};\n\nlayers.cookie = () => {\n  const get = async (key) => {\n    const value =\n      document.cookie\n        .split(\"; \")\n        .filter(Boolean)\n        .find((row) => row.startsWith(key + \"=\"))\n        ?.split(\"=\")[1] || null;\n    return JSON.parse(decodeURIComponent(value));\n  };\n\n  const set = async (key, data, { expire = null } = {}) => {\n    const time = parse(expire);\n    const now = new Date().getTime();\n    const expireStr =\n      time !== null ? `; expires=${new Date(now + time).toUTCString()}` : \"\";\n    const value = encodeURIComponent(JSON.stringify(data));\n    document.cookie = key + \"=\" + value + expireStr;\n  };\n  const has = async (key) => (await keys()).includes(key);\n  const del = async (key) => set(key, \"\", { expire: -100 });\n\n  // Group methods\n  const keys = async (prefix = \"\") =>\n    document.cookie\n      .split(\";\")\n      .map((l) => l.split(\"=\")[0].trim())\n      .filter(Boolean)\n      .filter((k) => k.startsWith(prefix));\n  const clear = async () => {\n    await Promise.all((await keys()).map(del));\n  };\n\n  return { get, set, has, del, keys, clear };\n};\n\nlayers.redis = (store) => {\n  const get = async (key) => {\n    const client = await store;\n    const value = await client.get(key);\n    if (!value) return null;\n    return JSON.parse(value);\n  };\n  const set = async (key, value, { expire = null } = {}) => {\n    if (value === null || expire === 0) return del(key);\n    const client = await store;\n    const exp = parse(expire);\n    const EX = exp ? Math.round(exp / 1000) : undefined;\n    return client.set(key, JSON.stringify(value), { EX });\n  };\n  const has = async (key) => Boolean(await (await store).exists(key));\n  const del = async (key) => (await store).del(key);\n\n  const keys = async (prefix = \"\") => (await store).keys(prefix + \"*\");\n  const clear = async () => (await store).flushAll();\n  const close = async () => (await store).quit();\n\n  return { get, set, has, del, keys, clear, close };\n};\n\nexport default function compat(store) {\n  if (!store || store instanceof Map) {\n    // Convert it to the normalized kv, then add the expiry layer on top\n    return layers.expire(layers.memory(store || new Map()));\n  }\n  if (typeof localStorage !== \"undefined\" && store === localStorage) {\n    return layers.expire(layers.localStorage(store));\n  }\n  if (typeof sessionStorage !== \"undefined\" && store === sessionStorage) {\n    return layers.expire(layers.localStorage(store));\n  }\n  if (store === \"cookie\") {\n    return layers.cookie();\n  }\n  return layers.redis(store);\n}\n"],
-  "mappings": "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",
-  "names": ["layers", "times", "parse", "str", "_", "value", "units", "unitValue", "result", "store", "get", "key", "data", "expire", "set", "time", "expDiff", "has", "del", "keys", "clear", "prefix", "k", "row", "now", "expireStr", "l", "client", "exp", "EX", "compat"]
+  "sourcesContent": ["const layers = {};\n\nconst times = /(-?(?:\\d+\\.?\\d*|\\d*\\.?\\d+)(?:e[-+]?\\d+)?)\\s*([\\p{L}]*)/iu;\n\nparse.millisecond = parse.ms = 1;\nparse.second = parse.sec = parse.s = parse[\"\"] = parse.ms * 1000;\nparse.minute = parse.min = parse.m = parse.s * 60;\nparse.hour = parse.hr = parse.h = parse.m * 60;\nparse.day = parse.d = parse.h * 24;\nparse.week = parse.wk = parse.w = parse.d * 7;\nparse.year = parse.yr = parse.y = parse.d * 365.25;\nparse.month = parse.b = parse.y / 12;\n\nfunction parse(str) {\n  if (str === null || str === undefined) return null;\n  if (typeof str === \"number\") return str;\n  // ignore commas/placeholders\n  str = str.toLowerCase().replace(/[,_]/g, \"\");\n  let [_, value, units] = times.exec(str) || [];\n  if (!units) return null;\n  const unitValue = parse[units] || parse[units.replace(/s$/, \"\")];\n  if (!unitValue) return null;\n  const result = unitValue * parseFloat(value, 10);\n  return Math.abs(Math.round(result));\n}\n\nlayers.expire = (store) => {\n  // Item methods\n  const get = async (key) => {\n    if (!(await store.has(key))) return null;\n    const { data, expire } = await store.get(key);\n    if (expire === null) return data;\n    const diff = expire - new Date().getTime();\n    if (diff <= 0) return null;\n    return data;\n  };\n  const set = async (key, data, { expire = null } = {}) => {\n    const time = parse(expire);\n    const expDiff = time !== null ? new Date().getTime() + time : null;\n    return store.set(key, { expire: expDiff, data });\n  };\n  const has = async (key) => (await store.get(key)) !== null;\n  const del = store.del;\n\n  // Group methods\n  const keys = store.keys;\n  const clear = store.clear;\n\n  return { get, set, has, del, keys, clear };\n};\n\nlayers.memory = (store) => {\n  // Item methods\n  const get = async (key) => store.get(key) || null;\n  const set = async (key, data) => store.set(key, data);\n  const has = async (key) => store.has(key);\n  const del = async (key) => store.delete(key);\n\n  // Group methods\n  const keys = async (prefix = \"\") =>\n    [...(await store.keys())].filter((k) => k.startsWith(prefix));\n  const clear = () => store.clear();\n\n  return { get, set, has, del, keys, clear };\n};\n\nlayers.storage = (store) => {\n  // Item methods\n  const get = async (key) => (store[key] ? JSON.parse(store[key]) : null);\n  const set = async (key, data) => store.setItem(key, JSON.stringify(data));\n  const has = async (key) => key in store;\n  const del = async (key) => store.removeItem(key);\n\n  // Group methods\n  const keys = async (prefix = \"\") =>\n    Object.keys(store).filter((k) => k.startsWith(prefix));\n  const clear = () => store.clear();\n\n  return { get, set, has, del, keys, clear };\n};\n\nlayers.cookie = () => {\n  const get = async (key) => {\n    const value =\n      document.cookie\n        .split(\"; \")\n        .filter(Boolean)\n        .find((row) => row.startsWith(key + \"=\"))\n        ?.split(\"=\")[1] || null;\n    return JSON.parse(decodeURIComponent(value));\n  };\n\n  const set = async (key, data, { expire = null } = {}) => {\n    const time = parse(expire);\n    const now = new Date().getTime();\n    const expireStr =\n      time !== null ? `; expires=${new Date(now + time).toUTCString()}` : \"\";\n    const value = encodeURIComponent(JSON.stringify(data));\n    document.cookie = key + \"=\" + value + expireStr;\n  };\n  const has = async (key) => (await keys()).includes(key);\n  const del = async (key) => set(key, \"\", { expire: -100 });\n\n  // Group methods\n  const keys = async (prefix = \"\") =>\n    document.cookie\n      .split(\";\")\n      .map((l) => l.split(\"=\")[0].trim())\n      .filter(Boolean)\n      .filter((k) => k.startsWith(prefix));\n  const clear = async () => {\n    await Promise.all((await keys()).map(del));\n  };\n\n  return { get, set, has, del, keys, clear };\n};\n\nlayers.redis = (store) => {\n  const get = async (key) => {\n    const client = await store;\n    const value = await client.get(key);\n    if (!value) return null;\n    return JSON.parse(value);\n  };\n  const set = async (key, value, { expire = null } = {}) => {\n    if (value === null || expire === 0) return del(key);\n    const client = await store;\n    const exp = parse(expire);\n    const EX = exp ? Math.round(exp / 1000) : undefined;\n    return client.set(key, JSON.stringify(value), { EX });\n  };\n  const has = async (key) => Boolean(await (await store).exists(key));\n  const del = async (key) => (await store).del(key);\n\n  const keys = async (prefix = \"\") => (await store).keys(prefix + \"*\");\n  const clear = async () => (await store).flushAll();\n  const close = async () => (await store).quit();\n\n  return { get, set, has, del, keys, clear, close };\n};\n\nlayers.localForage = (store) => {\n  const get = (key) => store.getItem(key);\n  const set = (key, value) => store.setItem(key, value);\n  const has = async (key) => (await get(key)) !== null;\n  const del = (key) => store.removeItem(key);\n\n  const keys = async (prefix = \"\") =>\n    (await store.keys()).filter((k) => k.startsWith(prefix));\n  const clear = () => store.clear();\n\n  return { get, set, has, del, keys, clear };\n};\n\nlayers.file = (file) => {\n  const fsProm = (async () => {\n    // For the bundler, it doesn't like it otherwise\n    const lib = \"node:fs/promises\";\n    const fsp = await import(lib);\n    // We want to make sure the file already exists, so attempt to\n    // create it (but not OVERWRITE it, that's why the x flag) and\n    // it fails if it already exists\n    await fsp.writeFile(file, \"{}\", { flag: \"wx\" }).catch((err) => {\n      if (err.code !== \"EEXIST\") throw err;\n    });\n    return fsp;\n  })();\n  const getContent = async () => {\n    const fsp = await fsProm;\n    const text = await fsp.readFile(file, \"utf8\");\n    if (!text) return {};\n    return JSON.parse(text);\n  };\n  const setContent = async (data) => {\n    const fsp = await fsProm;\n    await fsp.writeFile(file, JSON.stringify(data, null, 2));\n  };\n  const get = async (key) => {\n    const data = await getContent();\n    return data[key] ?? null;\n  };\n  const set = async (key, value) => {\n    const data = await getContent();\n    data[key] = value;\n    await setContent(data);\n  };\n  const has = async (key) => (await get(key)) !== null;\n  const del = async (key) => {\n    const data = await getContent();\n    delete data[key];\n    await setContent(data);\n  };\n  const keys = async (prefix = \"\") => {\n    const data = await getContent();\n    return Object.keys(data).filter((k) => k.startsWith(prefix));\n  };\n  const clear = async () => {\n    await setContent({});\n  };\n  return { get, set, has, del, keys, clear };\n};\n\nconst getStore = async (store) => {\n  // Convert it to the normalized kv, then add the expiry layer on top\n  if (store instanceof Map) {\n    return layers.expire(layers.memory(store));\n  }\n\n  if (typeof localStorage !== \"undefined\" && store === localStorage) {\n    return layers.expire(layers.storage(store));\n  }\n\n  if (typeof sessionStorage !== \"undefined\" && store === sessionStorage) {\n    return layers.expire(layers.storage(store));\n  }\n\n  if (store === \"cookie\") {\n    return layers.cookie();\n  }\n\n  if (store.defineDriver && store.dropInstance && store.INDEXEDDB) {\n    return layers.expire(layers.localForage(store));\n  }\n\n  if (store.protocol && store.protocol === \"file:\") {\n    return layers.expire(layers.file(store));\n  }\n\n  if (store.pSubscribe && store.sSubscribe) {\n    return layers.redis(store);\n  }\n\n  // \u00AF\\_(\u30C4)_/\u00AF\n  return null;\n};\n\nexport default function compat(storeClient = new Map()) {\n  return new Proxy(\n    {},\n    {\n      get: (_, key) => {\n        return async (...args) => {\n          const store = await getStore(await storeClient);\n          // Throw at the first chance when the store failed to init:\n          if (!store) {\n            throw new Error(\"Store is not valid\");\n          }\n          // The store.close() is the only one allowed to be called even\n          // if it doesn't exist, since it's optional in some stores\n          if (!store[key] && key === \"close\") return null;\n          return store[key](...args);\n        };\n      },\n    }\n  );\n}\n"],
+  "mappings": "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",
+  "names": ["layers", "times", "parse", "str", "_", "value", "units", "unitValue", "result", "store", "get", "key", "data", "expire", "set", "time", "expDiff", "has", "del", "keys", "clear", "prefix", "k", "row", "now", "expireStr", "l", "client", "exp", "EX", "file", "fsProm", "fsp", "err", "getContent", "text", "setContent", "getStore", "compat", "storeClient", "args"]
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "polystore",
-  "version": "0.1.1",
-  "description": "Add a unified API for any KV store like localStorage, Redis, FileSystem, etc.",
+  "version": "0.3.0",
+  "description": "A small compatibility layer for many popular KV stores like localStorage, Redis, FileSystem, etc.",
   "homepage": "https://github.com/franciscop/polystore",
   "repository": "https://github.com/franciscop/polystore.git",
   "bugs": "https://github.com/franciscop/polystore/issues",
@@ -24,10 +24,14 @@
     "esbuild": "^0.19.4",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
+    "localforage": "^1.10.0",
     "redis": "^4.6.10"
   },
   "jest": {
     "testEnvironment": "jsdom",
-    "transform": {}
+    "transform": {},
+    "modulePathIgnorePatterns": [
+      "src/test/"
+    ]
   }
 }

package/readme.md

@@ -1,6 +1,6 @@
 # Polystore [![npm install polystore](https://img.shields.io/badge/npm%20install-polystore-blue.svg)](https://www.npmjs.com/package/polystore) [![test badge](https://github.com/franciscop/polystore/workflows/tests/badge.svg "test badge")](https://github.com/franciscop/polystore/blob/master/.github/workflows/tests.yml) [![gzip size](https://img.badgesize.io/franciscop/polystore/master/index.min.js.svg?compression=gzip)](https://github.com/franciscop/polystore/blob/master/index.min.js)
 
-Add a unified API for any KV store like localStorage, Redis, FileSystem, etc:
+A small compatibility layer for many KV stores like localStorage, Redis, FileSystem, etc:
 
 ```js
 import kv from "polystore";
@@ -15,9 +15,10 @@ This is the [API](#api) with all of the methods (they are all `async`):
 - `.get(key): any`: retrieve a single value, or `null` if it doesn't exist or is expired.
 - `.set(key, value, options?)`: save a single value, which can be anything that is serializable.
 - `.has(key): boolean`: check whether the key is in the store or not.
-- `.del(key): void`: delete a single value from the store.
+- `.del(key)`: delete a single value from the store.
 - `.keys(prefix?): string[]`: get a list of all the available strings in the store.
 - `.clear()`: delete ALL of the data in the store, effectively resetting it.
+- `.close()`: (only _some_ stores) ends the connection to the store.
 
 Available stores:
 
@@ -25,26 +26,22 @@ Available stores:
 - **Local Storage** `localStorage` (fe): persist the data in the browser's localStorage
 - **Session Storage** `sessionStorage` (fe): persist the data in the browser's sessionStorage
 - **Cookies** `"cookie"` (fe): persist the data using cookies
-- (WIP) **LocalForage** `localForage` (fe): persist the data on IndexedDB
-- **Redis Client** `redisClient` (be): persist the data in the Redis instance that you connect to.
-- (WIP) **FS File** `fs.open(pathToFile)` (be): store the data in a single file
-- (WIP) **FS Folder** `fs.opendir(pathToFolder)` (be): store the data in files inside the folder
+- **LocalForage** `localForage` (fe): persist the data on IndexedDB
+- **Redis Client** `redisClient` (be): persist the data in the Redis instance that you connect to
+- **FS File** `new URL('file:///...')` (be): store the data in a single JSON file
 - (WIP) **Cloudflare KV** `env.KV_NAMESPACE` (be): use Cloudflare's KV store
+- (WIP) **Consul KV** `new Consul()` (fe+be): use Hashicorp's Consul KV store (https://www.npmjs.com/package/consul#kv)
 
-It main usage is for _libraries using this library_, so that _your_ library can easily accept many cache stores! For example, let's say you create an API library, then you can accept the stores from your client:
+I build this library to be used as a "building block" of other libraries, so that _your library_ can accept many cache stores effortlessly! It's isomorphic (Node.js and the Browser) and tiny (1~2KB). For example, let's say you create an API library, then you can accept the stores from your client:
 
 ```js
 import MyApi from "my-api";
 
-MyApi({ cache: new Map() });
-// OR
-MyApi({ cache: localStorage });
-// OR
-MyApi({ cache: fs.opendir("./data/") });
-// OR
-MyApi({ cache: redisClient });
-// OR
-MyApi({ cache: env.KV_NAMESPACE });
+MyApi({ cache: new Map() }); // OR
+MyApi({ cache: localStorage }); // OR
+MyApi({ cache: redisClient }); // OR
+MyApi({ cache: env.KV_NAMESPACE }); // OR
+// ...
 ```
 
 ## API
@@ -54,13 +51,13 @@ See how to initialize each store [in the Stores list documentation](#stores). Bu
 ```js
 import kv from "polystore";
 
-// Initialize it
+// Initialize it; NO "new"; NO "await", just a plain function wrap:
 const store = kv(MyClientOrStoreInstance);
 
 // use the store
 ```
 
-While you can keep a reference and access it directly, we strongly recommend if you are going to use a store, to only access it through `polystore`, since we do add custom serialization, etc:
+While you can keep a reference to the store and access it directly, we strongly recommend if you are going to use a store, to only access it through `polystore`, since we do add custom serialization and extra properties for e.g. expiration time:
 
 ```js
 const map = new Map();
@@ -112,14 +109,14 @@ The value can be a simple type like `boolean`, `string` or `number`, or it can b
 
 #### Expire
 
-When the expire is set, it can be a number (ms) or a string representing some time:
+When the `expire` option is set, it can be a number (ms) or a string representing some time:
 
 ```js
 // Valid "expire" values:
-0 - expire immediately
+0 - expire immediately (AKA delete it)
 100 - expire after 100ms
-3_600_000 - expire after 1h
 60 * 60 * 1000 - expire after 1h
+3_600_000 - expire after 1h
 "10s" - expire after 10 seconds
 "2minutes" - expire after 2 minutes
 "5d" - expire after 5 days
@@ -161,12 +158,46 @@ Remove all of the data from the store:
 await store.clear();
 ```
 
+### .prefix() (TODO) (unstable)
+
+Create a sub-store where all the operations use the given prefix:
+
+```js
+const store = kv(new Map());
+const sub = store.prefix("session:");
+
+const sub = kv(new Map(), { prefix: "session:" });
+```
+
+Then all of the operations will be converted internally to add the prefix when reading, writing, etc:
+
+```js
+const val = await sub.get("key1"); // .get('session:key1');
+await sub.set("key2", "some data"); // .set('session:key2', ...);
+const val = await sub.has("key3"); // .has('session:key3');
+await sub.del("key4"); // .del('session:key4');
+await sub.keys(); // .keys('session:');
+// ['key1', 'key2', ...]   Note no prefix here
+await sub.clear(); // delete only keys with the prefix
+```
+
+This will probably never be stable given the nature of some engines, so as an alternative please consider using two stores instead of prefixes:
+
+```js
+const store = kv(new Map());
+const sessionStore = kv(new Map());
+```
+
+The main reason this is not stable is because [_some_ store engines don't allow for atomic deletion of keys given a prefix](https://stackoverflow.com/q/4006324/938236). While we do still clear them internally in those cases, that is a non-atomic operation and it could have some trouble if some other thread is reading/writing the data _at the same time_.
+
 ## Stores
 
-Accepts directly the store, or a promise that resolves into a store:
+Accepts directly the store, or a promise that resolves into a store. All of the stores, including those that natively _don't_ support it, are enhanced with `Promises` and `expire` times, so they all work the same way.
 
 ### Memory
 
+An in-memory KV store, with promises and expiration time:
+
 ```js
 import kv from "polystore";
 
@@ -184,6 +215,8 @@ console.log(await store.get("key1"));
 
 ### Local Storage
 
+The traditional localStorage that we all know and love, this time with a unified API, and promises:
+
 ```js
 import kv from "polystore";
 
@@ -192,8 +225,12 @@ await store.set("key1", "Hello world");
 console.log(await store.get("key1"));
 ```
 
+Same limitations as always apply to localStorage, if you think you are going to use too much storage try instead our integration with [Local Forage](#local-forage)!
+
 ### Session Storage
 
+Same as localStorage, but now for the session only:
+
 ```js
 import kv from "polystore";
 
@@ -204,6 +241,8 @@ console.log(await store.get("key1"));
 
 ### Cookies
 
+Supports native browser cookies, including setting the expire time:
+
 ```js
 import kv from "polystore";
 
@@ -212,40 +251,50 @@ await store.set("key1", "Hello world");
 console.log(await store.get("key1"));
 ```
 
-> Note: the cookie expire resolution is unfortunately in the seconds. While it still expects you to pass the number of ms as with the other methods (or a string like `1h`), times shorter than 1 second like `expire: 200` (ms) don't make sense for this storage method and won't properly save them.
+It is fairly limited for how powerful cookies are, but in exchange it has the same API as any other method or KV store. It works with browser-side Cookies (no http-only).
+
+> Note: the cookie expire resolution is in the seconds. While it still expects you to pass the number of ms as with the other methods (or [a string like `1h`](#expire)), times shorter than 1 second like `expire: 200` (ms) don't make sense for this storage method and won't properly save them.
 
 ### Local Forage
 
+Supports localForage (with any driver it uses) so that you have a unified API. It also _adds_ the `expire` option to the setters!
+
 ```js
 import kv from "polystore";
-// TODO
+import localForage from "localforage";
+
+const store = kv(localForage);
+await store.set("key1", "Hello world", { expire: "1h" });
+console.log(await store.get("key1"));
 ```
 
 ### Redis Client
 
+Supports the official Node Redis Client. You can pass either the client or the promise:
+
 ```js
 import kv from "polystore";
 import { createClient } from "redis";
 
+// Note: no need for await or similar
 const store = kv(createClient().connect());
 await store.set("key1", "Hello world");
 console.log(await store.get("key1"));
 ```
 
-> Note: the Redis client expire resolution is unfortunately in the seconds. While it still expects you to pass the number of ms as with the other methods (or a string like `1h`), times shorter than 1 second like `expire: 200` (ms) don't make sense for this storage method and won't properly save them.
+> Note: the Redis client expire resolution is in the seconds. While it still expects you to pass the number of ms as with the other methods (or [a string like `1h`](#expire)), times shorter than 1 second like `expire: 200` (ms) don't make sense for this storage method and won't properly save them.
 
 ### FS File
 
 ```js
 import kv from "polystore";
-// TODO
-```
 
-### FS Folder
+// Create a url with the file protocol:
+const store = kv(new URL("file:///Users/me/project/cache.json"));
 
-```js
-import kv from "polystore";
-// TODO
+// Paths need to be absolute, but you can use process.cwd() to make
+// it relative to the current process:
+const store = kv(new URL(`file://${process.cwd()}/cache.json`));
 ```
 
 ### Cloudflare KV

package/src/index.js

@@ -58,13 +58,13 @@ layers.memory = (store) => {
 
   // Group methods
   const keys = async (prefix = "") =>
-    [...(await store.keys())].filter((k) => k.startsWith(prefix)); // 🤷‍♂️
+    [...(await store.keys())].filter((k) => k.startsWith(prefix));
   const clear = () => store.clear();
 
   return { get, set, has, del, keys, clear };
 };
 
-layers.localStorage = (store) => {
+layers.storage = (store) => {
   // Item methods
   const get = async (key) => (store[key] ? JSON.parse(store[key]) : null);
   const set = async (key, data) => store.setItem(key, JSON.stringify(data));
@@ -139,19 +139,118 @@ layers.redis = (store) => {
   return { get, set, has, del, keys, clear, close };
 };
 
-export default function compat(store) {
-  if (!store || store instanceof Map) {
-    // Convert it to the normalized kv, then add the expiry layer on top
-    return layers.expire(layers.memory(store || new Map()));
+layers.localForage = (store) => {
+  const get = (key) => store.getItem(key);
+  const set = (key, value) => store.setItem(key, value);
+  const has = async (key) => (await get(key)) !== null;
+  const del = (key) => store.removeItem(key);
+
+  const keys = async (prefix = "") =>
+    (await store.keys()).filter((k) => k.startsWith(prefix));
+  const clear = () => store.clear();
+
+  return { get, set, has, del, keys, clear };
+};
+
+layers.file = (file) => {
+  const fsProm = (async () => {
+    // For the bundler, it doesn't like it otherwise
+    const lib = "node:fs/promises";
+    const fsp = await import(lib);
+    // We want to make sure the file already exists, so attempt to
+    // create it (but not OVERWRITE it, that's why the x flag) and
+    // it fails if it already exists
+    await fsp.writeFile(file, "{}", { flag: "wx" }).catch((err) => {
+      if (err.code !== "EEXIST") throw err;
+    });
+    return fsp;
+  })();
+  const getContent = async () => {
+    const fsp = await fsProm;
+    const text = await fsp.readFile(file, "utf8");
+    if (!text) return {};
+    return JSON.parse(text);
+  };
+  const setContent = async (data) => {
+    const fsp = await fsProm;
+    await fsp.writeFile(file, JSON.stringify(data, null, 2));
+  };
+  const get = async (key) => {
+    const data = await getContent();
+    return data[key] ?? null;
+  };
+  const set = async (key, value) => {
+    const data = await getContent();
+    data[key] = value;
+    await setContent(data);
+  };
+  const has = async (key) => (await get(key)) !== null;
+  const del = async (key) => {
+    const data = await getContent();
+    delete data[key];
+    await setContent(data);
+  };
+  const keys = async (prefix = "") => {
+    const data = await getContent();
+    return Object.keys(data).filter((k) => k.startsWith(prefix));
+  };
+  const clear = async () => {
+    await setContent({});
+  };
+  return { get, set, has, del, keys, clear };
+};
+
+const getStore = async (store) => {
+  // Convert it to the normalized kv, then add the expiry layer on top
+  if (store instanceof Map) {
+    return layers.expire(layers.memory(store));
   }
+
   if (typeof localStorage !== "undefined" && store === localStorage) {
-    return layers.expire(layers.localStorage(store));
+    return layers.expire(layers.storage(store));
   }
+
   if (typeof sessionStorage !== "undefined" && store === sessionStorage) {
-    return layers.expire(layers.localStorage(store));
+    return layers.expire(layers.storage(store));
   }
+
   if (store === "cookie") {
     return layers.cookie();
   }
-  return layers.redis(store);
+
+  if (store.defineDriver && store.dropInstance && store.INDEXEDDB) {
+    return layers.expire(layers.localForage(store));
+  }
+
+  if (store.protocol && store.protocol === "file:") {
+    return layers.expire(layers.file(store));
+  }
+
+  if (store.pSubscribe && store.sSubscribe) {
+    return layers.redis(store);
+  }
+
+  // ¯\_(ツ)_/¯
+  return null;
+};
+
+export default function compat(storeClient = new Map()) {
+  return new Proxy(
+    {},
+    {
+      get: (_, key) => {
+        return async (...args) => {
+          const store = await getStore(await storeClient);
+          // Throw at the first chance when the store failed to init:
+          if (!store) {
+            throw new Error("Store is not valid");
+          }
+          // The store.close() is the only one allowed to be called even
+          // if it doesn't exist, since it's optional in some stores
+          if (!store[key] && key === "close") return null;
+          return store[key](...args);
+        };
+      },
+    }
+  );
 }

package/src/index.test.js

@@ -1,5 +1,6 @@
 import "dotenv/config";
 
+import localForage from "localforage";
 import { createClient } from "redis";
 
 import kv from "./";
@@ -11,6 +12,9 @@ stores.push(["kv()", kv()]);
 stores.push(["kv(new Map())", kv(new Map())]);
 stores.push(["kv(localStorage)", kv(localStorage)]);
 stores.push(["kv(sessionStorage)", kv(sessionStorage)]);
+stores.push(["kv(localForage)", kv(localForage)]);
+const path = `file://${process.cwd()}/src/test/data.json`;
+stores.push([`kv(new URL("${path}"))`, kv(new URL(path))]);
 if (process.env.REDIS) {
   stores.push(["kv(redis)", kv(createClient().connect())]);
 }
@@ -18,6 +22,12 @@ stores.push(["kv('cookie')", kv("cookie")]);
 
 const delay = (t) => new Promise((done) => setTimeout(done, t));
 
+describe("potato", () => {
+  it("a potato is not a valid store", async () => {
+    await expect(() => kv("potato").get("any")).rejects.toThrow();
+  });
+});
+
 for (let [name, store] of stores) {
   describe(name, () => {
     beforeEach(async () => {
@@ -25,6 +35,7 @@ for (let [name, store] of stores) {
     });
 
     afterAll(async () => {
+      await store.clear();
       if (store.close) {
         await store.close();
       }

package/src/test/data.json

@@ -0,0 +1 @@
+{}