@fluixi/storage 0.1.0-alpha.0

package/dist/utils/copy.cjs

@@ -0,0 +1,38 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/copy.ts
+var copy_exports = {};
+__export(copy_exports, {
+  copyStorage: () => copyStorage
+});
+module.exports = __toCommonJS(copy_exports);
+var isAsync = (storage) => "encryption" in storage;
+var pick = (snapshot, keys) => {
+  const out = snapshot;
+  if (keys) {
+    for (const key of Object.keys(out)) if (!keys.includes(key)) delete out[key];
+  }
+  return out;
+};
+function copyStorage(from, to, options = {}) {
+  const restore = { overwrite: options.overwrite };
+  if (!isAsync(from) && !isAsync(to)) return to.restore(pick(from.snapshot(), options.keys), restore);
+  return (async () => to.restore(pick(await from.snapshot(), options.keys), restore))();
+}

package/dist/utils/copy.d.ts

@@ -0,0 +1,17 @@
+import type { AsyncTypedStorage, StorageSchema, TypedStorage } from '../core/types.js';
+type CopyOptions = {
+    keys?: string[];
+    overwrite?: boolean;
+};
+/**
+ * Copies items from one storage to another, metadata included: moving data to a new adapter,
+ * seeding a test, backing up a namespace. Existing keys in `to` are kept unless `overwrite`.
+ * Returns how many items were written; a promise when either storage is asynchronous.
+ *
+ * Encrypted items are read decrypted and written encrypted again with `to`'s key, so `to` needs
+ * encryption configured for them.
+ */
+export declare function copyStorage<S extends StorageSchema>(from: TypedStorage<S>, to: TypedStorage<S>, options?: CopyOptions): number;
+export declare function copyStorage<S extends StorageSchema>(from: TypedStorage<S> | AsyncTypedStorage<S>, to: TypedStorage<S> | AsyncTypedStorage<S>, options?: CopyOptions): Promise<number>;
+export {};
+//# sourceMappingURL=copy.d.ts.map

package/dist/utils/copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy.d.ts","sourceRoot":"","sources":["../../src/utils/copy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAmB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAExG,KAAK,WAAW,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAU5D;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;AAChI,wBAAgB,WAAW,CAAC,CAAC,SAAS,aAAa,EACjD,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAC5C,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAC1C,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,CAAC"}

package/dist/utils/copy.js

@@ -0,0 +1,15 @@
+const isAsync = (storage) => 'encryption' in storage;
+const pick = (snapshot, keys) => {
+    const out = snapshot;
+    if (keys)
+        for (const key of Object.keys(out))
+            if (!keys.includes(key))
+                delete out[key];
+    return out;
+};
+export function copyStorage(from, to, options = {}) {
+    const restore = { overwrite: options.overwrite };
+    if (!isAsync(from) && !isAsync(to))
+        return to.restore(pick(from.snapshot(), options.keys), restore);
+    return (async () => to.restore(pick(await from.snapshot(), options.keys), restore))();
+}

package/dist/utils/copy.mjs

@@ -0,0 +1,17 @@
+// src/utils/copy.ts
+var isAsync = (storage) => "encryption" in storage;
+var pick = (snapshot, keys) => {
+  const out = snapshot;
+  if (keys) {
+    for (const key of Object.keys(out)) if (!keys.includes(key)) delete out[key];
+  }
+  return out;
+};
+function copyStorage(from, to, options = {}) {
+  const restore = { overwrite: options.overwrite };
+  if (!isAsync(from) && !isAsync(to)) return to.restore(pick(from.snapshot(), options.keys), restore);
+  return (async () => to.restore(pick(await from.snapshot(), options.keys), restore))();
+}
+export {
+  copyStorage
+};

package/dist/utils/environment.cjs

@@ -0,0 +1,28 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/environment.ts
+var environment_exports = {};
+__export(environment_exports, {
+  hasWindow: () => hasWindow
+});
+module.exports = __toCommonJS(environment_exports);
+function hasWindow() {
+  return typeof window !== "undefined";
+}

package/dist/utils/environment.d.ts

@@ -0,0 +1,3 @@
+/** Lazy checks: nothing here reads a browser global until it is called. */
+export declare function hasWindow(): boolean;
+//# sourceMappingURL=environment.d.ts.map

package/dist/utils/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/utils/environment.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wBAAgB,SAAS,IAAI,OAAO,CAEnC"}

package/dist/utils/environment.js

@@ -0,0 +1,4 @@
+/** Lazy checks: nothing here reads a browser global until it is called. */
+export function hasWindow() {
+    return typeof window !== 'undefined';
+}

package/dist/utils/environment.mjs

@@ -0,0 +1,7 @@
+// src/utils/environment.ts
+function hasWindow() {
+  return typeof window !== "undefined";
+}
+export {
+  hasWindow
+};

package/dist/utils/keys.cjs

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/keys.ts
+var keys_exports = {};
+__export(keys_exports, {
+  joinNamespace: () => joinNamespace,
+  namespacePrefix: () => namespacePrefix
+});
+module.exports = __toCommonJS(keys_exports);
+function namespacePrefix(namespace) {
+  return namespace ? `${namespace}:` : "";
+}
+function joinNamespace(parent, child) {
+  if (!child) throw new TypeError("A namespace needs a name.");
+  return parent ? `${parent}:${child}` : child;
+}

package/dist/utils/keys.d.ts

@@ -0,0 +1,5 @@
+/** The prefix a namespace puts before its keys: `app` gives `app:`. */
+export declare function namespacePrefix(namespace: string | undefined): string;
+/** A nested namespace: `app` and `auth` give `app:auth`. */
+export declare function joinNamespace(parent: string | undefined, child: string): string;
+//# sourceMappingURL=keys.d.ts.map

package/dist/utils/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/utils/keys.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAErE;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/E"}

package/dist/utils/keys.js

@@ -0,0 +1,10 @@
+/** The prefix a namespace puts before its keys: `app` gives `app:`. */
+export function namespacePrefix(namespace) {
+    return namespace ? `${namespace}:` : '';
+}
+/** A nested namespace: `app` and `auth` give `app:auth`. */
+export function joinNamespace(parent, child) {
+    if (!child)
+        throw new TypeError('A namespace needs a name.');
+    return parent ? `${parent}:${child}` : child;
+}

package/dist/utils/keys.mjs

@@ -0,0 +1,12 @@
+// src/utils/keys.ts
+function namespacePrefix(namespace) {
+  return namespace ? `${namespace}:` : "";
+}
+function joinNamespace(parent, child) {
+  if (!child) throw new TypeError("A namespace needs a name.");
+  return parent ? `${parent}:${child}` : child;
+}
+export {
+  joinNamespace,
+  namespacePrefix
+};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@fluixi/storage",
+  "version": "0.1.0-alpha.0",
+  "license": "MIT",
+  "author": "Ibrahima Touré",
+  "private": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "description": "A universal storage abstraction: one typed API across browser, SSR, server and custom environments, with adapters, namespaces, expiry and versioned entries.",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    },
+    "./browser": {
+      "types": "./dist/browser/index.d.ts",
+      "import": "./dist/browser/index.mjs",
+      "require": "./dist/browser/index.cjs",
+      "default": "./dist/browser/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.cjs",
+      "default": "./dist/server/index.js"
+    }
+  },
+  "dependencies": {
+    "@fluixi/utils": "1.0.0-alpha.93"
+  },
+  "devDependencies": {
+    "@bambiste/mix-builder": "^0.4.0",
+    "cross-env": "^7.0.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fluixi/core.git",
+    "directory": "packages/storage"
+  },
+  "scripts": {
+    "build:typings": "tsc -p tsconfig.lib.json",
+    "build": "cross-env NODE_ENV=production mix-builder",
+    "dev": "tsc -w -p tsconfig.lib.json",
+    "test": "vitest run"
+  }
+}