taon-storage 21.0.15 → 21.0.18

package/lib-prod/storage.ts

@@ -0,0 +1,591 @@
+/* taon-storage (native, SSR-safe) */
+import { ___NS__add, ___NS__after, ___NS__ary, ___NS__assign, ___NS__assignIn, ___NS__assignInWith, ___NS__assignWith, ___NS__at, ___NS__attempt, ___NS__before, ___NS__bind, ___NS__bindAll, ___NS__bindKey, ___NS__camelCase, ___NS__capitalize, ___NS__castArray, ___NS__ceil, ___NS__chain, ___NS__chunk, ___NS__clamp, ___NS__clone, ___NS__cloneDeep, ___NS__cloneDeepWith, ___NS__cloneWith, ___NS__compact, ___NS__concat, ___NS__cond, ___NS__conforms, ___NS__conformsTo, ___NS__constant, ___NS__countBy, ___NS__create, ___NS__curry, ___NS__curryRight, ___NS__debounce, ___NS__deburr, ___NS__defaults, ___NS__defaultsDeep, ___NS__defaultTo, ___NS__defer, ___NS__delay, ___NS__difference, ___NS__differenceBy, ___NS__differenceWith, ___NS__divide, ___NS__drop, ___NS__dropRight, ___NS__dropRightWhile, ___NS__dropWhile, ___NS__each, ___NS__eachRight, ___NS__endsWith, ___NS__entries, ___NS__entriesIn, ___NS__eq, ___NS__escape, ___NS__escapeRegExp, ___NS__every, ___NS__extend, ___NS__extendWith, ___NS__fill, ___NS__filter, ___NS__find, ___NS__findIndex, ___NS__findKey, ___NS__findLast, ___NS__findLastIndex, ___NS__findLastKey, ___NS__first, ___NS__flatMap, ___NS__flatMapDeep, ___NS__flatMapDepth, ___NS__flatten, ___NS__flattenDeep, ___NS__flattenDepth, ___NS__flip, ___NS__floor, ___NS__flow, ___NS__flowRight, ___NS__forEach, ___NS__forEachRight, ___NS__forIn, ___NS__forInRight, ___NS__forOwn, ___NS__forOwnRight, ___NS__fromPairs, ___NS__functions, ___NS__functionsIn, ___NS__get, ___NS__groupBy, ___NS__gt, ___NS__gte, ___NS__has, ___NS__hasIn, ___NS__head, ___NS__identity, ___NS__includes, ___NS__indexOf, ___NS__initial, ___NS__inRange, ___NS__intersection, ___NS__intersectionBy, ___NS__intersectionWith, ___NS__invert, ___NS__invertBy, ___NS__invoke, ___NS__invokeMap, ___NS__isArguments, ___NS__isArray, ___NS__isArrayBuffer, ___NS__isArrayLike, ___NS__isArrayLikeObject, ___NS__isBoolean, ___NS__isBuffer, ___NS__isDate, ___NS__isElement, ___NS__isEmpty, ___NS__isEqual, ___NS__isEqualWith, ___NS__isError, ___NS__isFinite, ___NS__isFunction, ___NS__isInteger, ___NS__isLength, ___NS__isMap, ___NS__isMatch, ___NS__isMatchWith, ___NS__isNaN, ___NS__isNative, ___NS__isNil, ___NS__isNull, ___NS__isNumber, ___NS__isObject, ___NS__isObjectLike, ___NS__isPlainObject, ___NS__isRegExp, ___NS__isSafeInteger, ___NS__isSet, ___NS__isString, ___NS__isSymbol, ___NS__isTypedArray, ___NS__isUndefined, ___NS__isWeakMap, ___NS__isWeakSet, ___NS__iteratee, ___NS__join, ___NS__kebabCase, ___NS__keyBy, ___NS__keys, ___NS__keysIn, ___NS__last, ___NS__lastIndexOf, ___NS__lowerCase, ___NS__lowerFirst, ___NS__lt, ___NS__lte, ___NS__map, ___NS__mapKeys, ___NS__mapValues, ___NS__matches, ___NS__matchesProperty, ___NS__max, ___NS__maxBy, ___NS__mean, ___NS__meanBy, ___NS__memoize, ___NS__merge, ___NS__mergeWith, ___NS__method, ___NS__methodOf, ___NS__min, ___NS__minBy, ___NS__mixin, ___NS__multiply, ___NS__negate, ___NS__noop, ___NS__now, ___NS__nth, ___NS__nthArg, ___NS__omit, ___NS__omitBy, ___NS__once, ___NS__orderBy, ___NS__over, ___NS__overArgs, ___NS__overEvery, ___NS__overSome, ___NS__pad, ___NS__padEnd, ___NS__padStart, ___NS__parseInt, ___NS__partial, ___NS__partialRight, ___NS__partition, ___NS__pick, ___NS__pickBy, ___NS__property, ___NS__propertyOf, ___NS__pull, ___NS__pullAll, ___NS__pullAllBy, ___NS__pullAllWith, ___NS__pullAt, ___NS__random, ___NS__range, ___NS__rangeRight, ___NS__rearg, ___NS__reduce, ___NS__reduceRight, ___NS__reject, ___NS__remove, ___NS__repeat, ___NS__replace, ___NS__rest, ___NS__result, ___NS__reverse, ___NS__round, ___NS__sample, ___NS__sampleSize, ___NS__set, ___NS__setWith, ___NS__shuffle, ___NS__size, ___NS__slice, ___NS__snakeCase, ___NS__some, ___NS__sortBy, ___NS__sortedIndex, ___NS__sortedIndexBy, ___NS__sortedIndexOf, ___NS__sortedLastIndex, ___NS__sortedLastIndexBy, ___NS__sortedLastIndexOf, ___NS__sortedUniq, ___NS__sortedUniqBy, ___NS__split, ___NS__spread, ___NS__startCase, ___NS__startsWith, ___NS__stubArray, ___NS__stubFalse, ___NS__stubObject, ___NS__stubString, ___NS__stubTrue, ___NS__subtract, ___NS__sum, ___NS__sumBy, ___NS__tail, ___NS__take, ___NS__takeRight, ___NS__takeRightWhile, ___NS__takeWhile, ___NS__tap, ___NS__template, ___NS__templateSettings, ___NS__throttle, ___NS__thru, ___NS__times, ___NS__toArray, ___NS__toFinite, ___NS__toInteger, ___NS__toLength, ___NS__toLower, ___NS__toNumber, ___NS__toPairs, ___NS__toPairsIn, ___NS__toPath, ___NS__toPlainObject, ___NS__toSafeInteger, ___NS__toString, ___NS__toUpper, ___NS__transform, ___NS__trim, ___NS__trimEnd, ___NS__trimStart, ___NS__truncate, ___NS__unary, ___NS__unescape, ___NS__union, ___NS__unionBy, ___NS__unionWith, ___NS__uniq, ___NS__uniqBy, ___NS__uniqueId, ___NS__uniqWith, ___NS__unset, ___NS__unzip, ___NS__unzipWith, ___NS__update, ___NS__updateWith, ___NS__upperCase, ___NS__upperFirst, ___NS__values, ___NS__valuesIn, ___NS__without, ___NS__words, ___NS__wrap, ___NS__xor, ___NS__xorBy, ___NS__xorWith, ___NS__zip, ___NS__zipObject, ___NS__zipObjectDeep, ___NS__zipWith, UtilsOs__NS__commandExistsAsync, UtilsOs__NS__commandExistsSync, UtilsOs__NS__detectEditor, UtilsOs__NS__Editor, UtilsOs__NS__EDITOR_PROCESSES, UtilsOs__NS__EditorArr, UtilsOs__NS__EditorProcess, UtilsOs__NS__getEditorSettingsJsonPath, UtilsOs__NS__getRealHomeDir, UtilsOs__NS__isBrowser, UtilsOs__NS__isDockerAvailable, UtilsOs__NS__isElectron, UtilsOs__NS__isNode, UtilsOs__NS__isNodeVersionOk, UtilsOs__NS__isPortInUse, UtilsOs__NS__isRunningInBrowser, UtilsOs__NS__isRunningInCliMode, UtilsOs__NS__isRunningInDocker, UtilsOs__NS__isRunningInElectron, UtilsOs__NS__isRunningInLinuxGraphicsCapableEnvironment, UtilsOs__NS__isRunningInMochaTest, UtilsOs__NS__isRunningInNode, UtilsOs__NS__isRunningInOsWithGraphicsCapableEnvironment, UtilsOs__NS__isRunningInSSRMode, UtilsOs__NS__isRunningInVscodeExtension, UtilsOs__NS__isRunningInWebSQL, UtilsOs__NS__isRunningInWindows, UtilsOs__NS__isRunningInWindowsCmd, UtilsOs__NS__isRunningInWindowsPowerShell, UtilsOs__NS__isRunningInWsl, UtilsOs__NS__isRunningNodeDebugger, UtilsOs__NS__isSSRMode, UtilsOs__NS__isVscodeExtension, UtilsOs__NS__isWebSQL, UtilsOs__NS__killAllEditor, UtilsOs__NS__openFolderInFileExplorer, UtilsOs__NS__openFolderInVSCode, UtilsOs__NS__pipxNestedPackageExists, UtilsOs__NS__pipxPackageExists, UtilsOs__NS__pythonModuleExists, UtilsOs__NS__UnknownEditor } from 'tnp-core/lib-prod';
+export type StorageEngine = 'localstorage' | 'indexeddb' | 'file' | 'json';
+
+export interface StorOptions<T = any> {
+  defaultValue?: T;
+  transformFrom?: (valueFromDb: any) => T;
+  transformTo?: (valueToDb: T) => any;
+}
+
+export interface PendingOperation {
+  engine: StorageEngine;
+  id: string;
+  isDone: boolean;
+}
+
+type ClassLike = Function | { name: string } | undefined;
+
+const isBrowser =
+  typeof window !== 'undefined' &&
+  typeof document !== 'undefined' &&
+  typeof navigator !== 'undefined';
+
+function safeLocationPort(): string {
+  try {
+    return (globalThis as any)?.location?.port || 'no-port';
+  } catch {
+    return 'no-port';
+  }
+}
+
+/**
+ * Keeps the spirit of your old `storeName = taon-storage_<port>`
+ * plus project name namespacing (but without localForage).
+ */
+export const storeName = `taon-storage_${safeLocationPort()}`;
+
+function defaultNamespace(): string {
+  const project = ___NS__kebabCase(globalThis['CURRENT_PROJECT_GENERIC_NAME'] ?? '');
+  return project ? `${storeName}_${project}` : storeName;
+}
+
+/**
+ * Central config (optional).
+ * You can set it once at app bootstrap if you want a stable namespace.
+ */
+export const StorConfig = {
+  namespace: defaultNamespace(),
+  indexedDb: {
+    dbName: `${defaultNamespace()}_INDEXEDDB`,
+    storeName: 'keyvaluepairs',
+  },
+};
+
+function normalizeScopeClass(cls: ClassLike): { name: string } {
+  if (!cls) return { name: '__GLOBAL_NAMESPACE__' };
+  // if it's a function/class
+  if (typeof cls === 'function')
+    return { name: (cls as any).name || '__ANON__' };
+  // if it's already object with name
+  return { name: (cls as any).name || '__ANON__' };
+}
+
+export function keyValue(scopeClass: ClassLike, memberName: string) {
+  const c = normalizeScopeClass(scopeClass);
+  return `${StorConfig.namespace}::taon.storage.class.${c.name}.prop.${memberName}`;
+}
+
+export function keyDefaultValueAlreadySet(
+  scopeClass: ClassLike,
+  memberName: string,
+) {
+  return `${keyValue(scopeClass, memberName)}::defaultvalueisset`;
+}
+
+/** Back-compat alias (your old typo) */
+export const keyDefaultValueAreadySet = keyDefaultValueAlreadySet;
+
+/* ---------------------------
+ * Stores
+ * -------------------------- */
+
+interface AsyncKVStore {
+  getItem<T = any>(key: string): Promise<T | undefined>;
+  setItem<T = any>(key: string, value: T): Promise<void>;
+  removeItem(key: string): Promise<void>;
+}
+
+class NoopStore implements AsyncKVStore {
+  async getItem<T>(_key: string): Promise<T | undefined> {
+    return undefined;
+  }
+  async setItem<T>(_key: string, _value: T): Promise<void> {
+    // noop
+  }
+  async removeItem(_key: string): Promise<void> {
+    // noop
+  }
+}
+
+class BrowserLocalStorageStore implements AsyncKVStore {
+  private ls(): Storage | undefined {
+    if (!isBrowser) return undefined;
+    try {
+      return window.localStorage;
+    } catch {
+      return undefined;
+    }
+  }
+
+  async getItem<T>(key: string): Promise<T | undefined> {
+    const ls = this.ls();
+    if (!ls) return undefined;
+
+    const raw = ls.getItem(key);
+    if (raw === null) return undefined;
+
+    try {
+      return JSON.parse(raw) as T;
+    } catch {
+      // if something stored plain string by older versions
+      return raw as unknown as T;
+    }
+  }
+
+  async setItem<T>(key: string, value: T): Promise<void> {
+    const ls = this.ls();
+    if (!ls) return;
+
+    try {
+      ls.setItem(key, JSON.stringify(value));
+    } catch {
+      // last resort: try as string
+      try {
+        ls.setItem(key, String(value));
+      } catch {
+        // ignore (quota/private mode)
+      }
+    }
+  }
+
+  async removeItem(key: string): Promise<void> {
+    const ls = this.ls();
+    if (!ls) return;
+    try {
+      ls.removeItem(key);
+    } catch {
+      // ignore
+    }
+  }
+}
+
+class BrowserIndexedDbStore implements AsyncKVStore {
+  private dbPromise: Promise<IDBDatabase> | null = null;
+
+  private openDb(): Promise<IDBDatabase> {
+    if (!isBrowser || !(window as any).indexedDB) {
+      return Promise.reject(new Error('IndexedDB not available'));
+    }
+    if (this.dbPromise) return this.dbPromise;
+
+    const { dbName, storeName } = StorConfig.indexedDb;
+
+    this.dbPromise = new Promise<IDBDatabase>((resolve, reject) => {
+      const req = indexedDB.open(dbName, 1);
+
+      req.onupgradeneeded = () => {
+        const db = req.result;
+        if (!db.objectStoreNames.contains(storeName)) {
+          db.createObjectStore(storeName);
+        }
+      };
+
+      req.onsuccess = () => resolve(req.result);
+      req.onerror = () => reject(req.error);
+    });
+
+    return this.dbPromise;
+  }
+
+  private async withStore<T>(
+    mode: IDBTransactionMode,
+    fn: (store: IDBObjectStore) => IDBRequest<T>,
+  ): Promise<T> {
+    const db = await this.openDb();
+    const { storeName } = StorConfig.indexedDb;
+
+    return await new Promise<T>((resolve, reject) => {
+      const tx = db.transaction(storeName, mode);
+      const store = tx.objectStore(storeName);
+      const req = fn(store);
+
+      req.onsuccess = () => resolve(req.result);
+      req.onerror = () => reject(req.error);
+
+      tx.onabort = () => reject(tx.error);
+      // tx.oncomplete => nothing
+    });
+  }
+
+  async getItem<T>(key: string): Promise<T | undefined> {
+    try {
+      const result = await this.withStore('readonly', s => s.get(key));
+      return (result as any) === undefined ? undefined : (result as any);
+    } catch {
+      return undefined;
+    }
+  }
+
+  async setItem<T>(key: string, value: T): Promise<void> {
+    try {
+      await this.withStore('readwrite', s => s.put(value as any, key));
+    } catch {
+      // ignore
+    }
+  }
+
+  async removeItem(key: string): Promise<void> {
+    try {
+      await this.withStore('readwrite', s => s.delete(key) as any);
+    } catch {
+      // ignore
+    }
+  }
+}
+
+/**
+ * Node-side file storage (optional). No top-level node imports (Angular-safe).
+ * Works only when executed in Node.
+ */
+class FileStor implements AsyncKVStore {
+  constructor(
+    private filePath: string,
+    private useJSON = false,
+  ) {}
+
+  private isNodeRuntime() {
+    return UtilsOs__NS__isNode;
+    // return (
+    //   typeof process !== 'undefined' &&
+    //   !!(process as any).versions?.node &&
+    //   typeof (globalThis as any).window === 'undefined'
+    // );
+  }
+
+  async setItem<T>(_key: string, value: T): Promise<void> {
+    if (!this.isNodeRuntime()) return;
+    //#region @backendFunc
+    const fs = await import('node:fs/promises');
+    const data = this.useJSON ? JSON.stringify(value, null, 2) : (value as any);
+
+    if (this.useJSON) {
+      await fs.writeFile(this.filePath, String(data), 'utf8');
+    } else {
+      await fs.writeFile(this.filePath, String(data), 'utf8');
+    }
+    //#endregion
+  }
+
+  async getItem<T>(_key: string): Promise<T | undefined> {
+    if (!this.isNodeRuntime()) return undefined;
+    //#region @backendFunc
+    const fs = await import('node:fs/promises');
+
+    try {
+      const buf = await fs.readFile(this.filePath, 'utf8');
+      if (!this.useJSON) return buf as any as T;
+      return JSON.parse(buf) as T;
+    } catch {
+      return undefined;
+    }
+    //#endregion
+  }
+
+  async removeItem(_key: string): Promise<void> {
+    if (!this.isNodeRuntime()) return;
+    //#region @backendFunc
+    const fs = await import('node:fs/promises');
+    try {
+      await fs.rm(this.filePath, { force: true });
+    } catch {
+      // ignore
+    }
+    //#endregion
+  }
+}
+
+/* ---------------------------
+ * Pending ops (so you can still await)
+ * -------------------------- */
+
+class StorPending {
+  static pending: PendingOperation[] = [];
+  static id = 0;
+  static AWAITING_INTERVAL_TIME = 200;
+
+  static async awaitPendingOperations(id = StorPending.id++): Promise<void> {
+    if (id > Number.MAX_SAFE_INTEGER - 2) {
+      StorPending.id = 0;
+      id = StorPending.id++;
+    }
+
+    const pending = StorPending.pending;
+
+    for (const op of pending) {
+      if (!op.isDone) {
+        await new Promise<void>(resolve => {
+          setTimeout(async () => {
+            await StorPending.awaitPendingOperations(id);
+            resolve();
+          }, StorPending.AWAITING_INTERVAL_TIME);
+        });
+        return;
+      }
+    }
+
+    // cleanup
+    StorPending.pending = pending.filter(p => !p.isDone);
+  }
+
+  static start(engine: StorageEngine, id: string): PendingOperation {
+    const op: PendingOperation = { engine, id, isDone: false };
+    StorPending.pending.push(op);
+    return op;
+  }
+
+  static done(op: PendingOperation) {
+    op.isDone = true;
+  }
+}
+
+/* ---------------------------
+ * Decorator builder
+ * -------------------------- */
+
+class StorPropertyBuilder {
+  private scopeClass?: ClassLike;
+  private engine: StorageEngine;
+  private store: AsyncKVStore;
+  private filePath?: string;
+  private useJsonFile = false;
+
+  constructor(engine: StorageEngine, store: AsyncKVStore) {
+    this.engine = engine;
+    this.store = store;
+  }
+
+  for(scopeClass?: ClassLike) {
+    this.scopeClass = scopeClass;
+    return this;
+  }
+
+  withDefaultValue<T = any>(defaultValue: T) {
+    return this.withOptions<T>({ defaultValue });
+  }
+
+  withOptions<T = any>(options: StorOptions<T>) {
+    const scopeClass = this.scopeClass;
+
+    // per-instance state (fixes prototype-closure sharing)
+    const values = new WeakMap<object, T>();
+    const initStarted = new WeakMap<object, Promise<void>>();
+
+    const ensureInit = (instance: object) => {
+      if (initStarted.has(instance)) return;
+
+      const op = StorPending.start(this.engine, 'init');
+      const p = (async () => {
+        const memberName = (ensureInit as any).__memberName as string;
+
+        const kVal = keyValue(scopeClass, memberName);
+        const kDef = keyDefaultValueAlreadySet(scopeClass, memberName);
+
+        const defProvided = options.defaultValue !== undefined;
+
+        if (
+          !isBrowser &&
+          (this.engine === 'localstorage' || this.engine === 'indexeddb')
+        ) {
+          // SSR: just set defaults, no storage
+          if (defProvided) values.set(instance, options.defaultValue as T);
+          return;
+        }
+
+        // Browser (or node file/json)
+        if (defProvided) {
+          const already = await this.store.getItem<boolean>(kDef);
+          if (already) {
+            const stored = await this.store.getItem<any>(kVal);
+            const v = options.transformFrom
+              ? options.transformFrom(stored)
+              : stored;
+            if (v !== undefined) values.set(instance, v as T);
+            else values.set(instance, options.defaultValue as T);
+          } else {
+            await this.store.setItem(kDef, true);
+            const toDb = options.transformTo
+              ? options.transformTo(options.defaultValue as T)
+              : (options.defaultValue as any);
+            await this.store.setItem(kVal, toDb);
+            values.set(instance, options.defaultValue as T);
+          }
+        } else {
+          const stored = await this.store.getItem<any>(kVal);
+          const v = options.transformFrom
+            ? options.transformFrom(stored)
+            : stored;
+          if (v !== undefined) values.set(instance, v as T);
+        }
+      })()
+        .catch(() => {
+          // swallow, keep app alive
+        })
+        .finally(() => StorPending.done(op));
+
+      initStarted.set(instance, p);
+    };
+
+    return (target: any, memberName: string) => {
+      (ensureInit as any).__memberName = memberName;
+
+      Object.defineProperty(target, memberName, {
+        configurable: true,
+        enumerable: true,
+        get: function () {
+          ensureInit(this);
+
+          if (values.has(this)) return values.get(this);
+          if (options.defaultValue !== undefined) return options.defaultValue;
+          return undefined;
+        },
+        set: function (newValue: T) {
+          values.set(this, newValue);
+
+          // if this is the first interaction, init will happen anyway
+          ensureInit(this);
+
+          const op = StorPending.start(
+            (target as any)?.engine ?? 'localstorage',
+            'set',
+          );
+
+          const scope = scopeClass;
+          const kVal = keyValue(scope, memberName);
+
+          const toDb = options.transformTo
+            ? options.transformTo(newValue)
+            : (newValue as any);
+
+          Promise.resolve()
+            .then(() => target as any)
+            .then(() => this as any)
+            .then(() => this as any)
+            .then(async () => {
+              // If we are SSR + browser engine => no-op
+              if (!isBrowser && (options as any)) return;
+              await (options as any); // no-op line to keep TS happy about chaining in some builds
+            })
+            .catch(() => {
+              // ignore
+            });
+
+          // do real store write (async)
+          Promise.resolve()
+            .then(async () => {
+              // SSR guard for browser engines
+              if (!isBrowser && (StorPropertyInLocalStorage as any)) {
+                return;
+              }
+              await thisStoreForEngineWrite(this, kVal, toDb);
+            })
+            .catch(() => {
+              // ignore
+            })
+            .finally(() => StorPending.done(op));
+        },
+      });
+
+      // small helper to keep closure clean
+      const builderStore = this.store;
+      const builderEngine = this.engine;
+
+      async function thisStoreForEngineWrite(
+        _instance: any,
+        key: string,
+        value: any,
+      ) {
+        // If browser engines but not browser, skip.
+        if (
+          !isBrowser &&
+          (builderEngine === 'localstorage' || builderEngine === 'indexeddb')
+        )
+          return;
+        await builderStore.setItem(key, value);
+      }
+    };
+  }
+
+  /* optional node-only engines (same builder) */
+  file(filePath: string) {
+    this.engine = 'file';
+    this.filePath = filePath;
+    this.useJsonFile = false;
+    this.store = new FileStor(filePath, false);
+    return this;
+  }
+
+  jsonFile(filePath: string) {
+    this.engine = 'json';
+    this.filePath = filePath;
+    this.useJsonFile = true;
+    this.store = new FileStor(filePath, true);
+    return this;
+  }
+}
+
+/* ---------------------------
+ * Public: clean API exports
+ * -------------------------- */
+
+const localStorageStore: AsyncKVStore = isBrowser
+  ? new BrowserLocalStorageStore()
+  : new NoopStore();
+const indexedDbStore: AsyncKVStore = isBrowser
+  ? new BrowserIndexedDbStore()
+  : new NoopStore();
+
+export class StorPropertyInLocalStorage {
+  static for(scopeClass?: ClassLike) {
+    return new StorPropertyBuilder('localstorage', localStorageStore).for(
+      scopeClass,
+    );
+  }
+}
+
+export class StorPropertyInIndexedDb {
+  static for(scopeClass?: ClassLike) {
+    return new StorPropertyBuilder('indexeddb', indexedDbStore).for(scopeClass);
+  }
+}
+
+/**
+ * Helpers
+ */
+export async function uncache<CLASS_FUNCTION = any>(
+  onlyInThisComponentClass: CLASS_FUNCTION,
+  propertyValueToDeleteFromCache: keyof CLASS_FUNCTION,
+) {
+  const scope =
+    onlyInThisComponentClass || ({ name: '__GLOBAL_NAMESPACE__' } as any);
+  const prop = String(propertyValueToDeleteFromCache);
+
+  await Promise.all([
+    localStorageStore.removeItem(keyValue(scope as any, prop)),
+    localStorageStore.removeItem(keyDefaultValueAlreadySet(scope as any, prop)),
+    indexedDbStore.removeItem(keyValue(scope as any, prop)),
+    indexedDbStore.removeItem(keyDefaultValueAlreadySet(scope as any, prop)),
+  ]);
+}
+
+/**
+ * Backwards-compatible facade:
+ * Stor.property.in.localstorage.for(...).withDefaultValue(...)
+ */
+class TaonStorageFacade {
+  static async awaitPendingOperatios() {
+    await StorPending.awaitPendingOperations();
+  }
+
+  static get property() {
+    return {
+      in: {
+        get localstorage() {
+          return new StorPropertyBuilder('localstorage', localStorageStore);
+        },
+        get indexedb() {
+          return new StorPropertyBuilder('indexeddb', indexedDbStore);
+        },
+        // node-only (safe: dynamic import inside FileStor)
+        file(filePath: string) {
+          return new StorPropertyBuilder('file', new FileStor(filePath, false));
+        },
+        jsonFile(filePath: string) {
+          return new StorPropertyBuilder('json', new FileStor(filePath, true));
+        },
+      },
+    };
+  }
+}
+
+export const Stor = TaonStorageFacade;

package/lib-prod.re-export.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taon-storage",
-  "version": "21.0.15",
+  "version": "21.0.18",
   "scripts": {
     "taon init": "taon init",
     "taon start": "taon start",
@@ -31,6 +31,7 @@
   "optionalDependencies": {},
   "bin": {},
   "peerDependencies": {},
+  "devDependencies": {},
   "repository": {
     "type": "git",
     "url": "https://github.com/darekf77/taon-storage.git"

package/websql/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taon-storage/websql",
-  "version": "21.0.15",
+  "version": "21.0.18",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0"

package/websql-prod/fesm2022/taon-storage-websql.mjs

@@ -1,7 +1,7 @@
 import * as i0 from '@angular/core';
 import { ChangeDetectionStrategy, Component } from '@angular/core';
 import { CommonModule } from '@angular/common';
-import { _, UtilsOs_isNode } from 'tnp-core/websql-prod';
+import { ___NS__kebabCase, UtilsOs__NS__isNode } from 'tnp-core/websql-prod';
 
 class SampleLogCmpComponent {
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.9", ngImport: i0, type: SampleLogCmpComponent, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
@@ -30,7 +30,7 @@ function safeLocationPort() {
  */
 const storeName = `taon-storage_${safeLocationPort()}`;
 function defaultNamespace() {
-    const project = _.kebabCase(globalThis['CURRENT_PROJECT_GENERIC_NAME'] ?? '');
+    const project = ___NS__kebabCase(globalThis['CURRENT_PROJECT_GENERIC_NAME'] ?? '');
     return project ? `${storeName}_${project}` : storeName;
 }
 /**
@@ -201,7 +201,7 @@ class FileStor {
         this.useJSON = useJSON;
     }
     isNodeRuntime() {
-        return UtilsOs_isNode;
+        return UtilsOs__NS__isNode;
         // return (
         //   typeof process !== 'undefined' &&
         //   !!(process as any).versions?.node &&