@scpxl/nodejs-framework 1.0.30 → 1.0.42

package/dist/cache/manager.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/cache/manager.ts"],
-  "sourcesContent": ["import type RedisManager from '../redis/manager.js';\nimport type RedisInstance from '../redis/instance.js';\nimport { safeSerializeError } from '../error/error-reporter.js';\n\n/**\n * CacheManager\n *\n * Thin abstraction over Redis for basic JSON value caching. Unifies all Redis\n * access through the framework RedisManager / RedisInstance (ioredis) so we\n * avoid maintaining a second client implementation (node-redis).\n *\n * Lazy acquisition: the first call to any cache method will either reuse an\n * existing connected RedisInstance (if already established by application\n * startup) or trigger a connection via RedisManager.\n *\n * **Important:** All values are stored as JSON strings. Only JSON-serializable\n * values are supported. Complex types like Date, Map, Set, RegExp, etc. will\n * lose their type information during serialization:\n * - `Date` objects \u2192 ISO strings\n * - `Map` / `Set` \u2192 empty objects `{}`\n * - `undefined` \u2192 omitted from objects, `null` in arrays\n * - Functions \u2192 omitted\n *\n * @example\n * ```typescript\n * // Supported types\n * await cache.setItem({ key: 'user', value: { id: 1, name: 'John' } }); // \u2713\n * await cache.setItem({ key: 'count', value: 42 }); // \u2713\n * await cache.setItem({ key: 'tags', value: ['a', 'b', 'c'] }); // \u2713\n *\n * // Unsupported types (will lose type information)\n * await cache.setItem({ key: 'date', value: new Date() }); // \u2192 ISO string\n * await cache.setItem({ key: 'map', value: new Map() }); // \u2192 {}\n * ```\n */\n\nexport interface CacheManagerProps {\n  /** Redis manager (shared across the application) */\n  redisManager: RedisManager;\n}\n\nexport default class CacheManager {\n  private redisManager: RedisManager;\n  private redisInstance?: RedisInstance;\n\n  constructor({ redisManager }: CacheManagerProps) {\n    this.redisManager = redisManager;\n  }\n\n  /**\n   * Ensure we have a connected RedisInstance. Reuses the first existing\n   * instance if already connected by the application bootstrap.\n   */\n  private async getRedisInstance(): Promise<RedisInstance> {\n    if (this.redisInstance) return this.redisInstance;\n\n    if (this.redisManager.instances.length > 0) {\n      this.redisInstance = this.redisManager.instances[0];\n      return this.redisInstance;\n    }\n\n    // Lazily connect if no instances yet (e.g., used before app onBeforeStart)\n    this.redisInstance = await this.redisManager.connect();\n    return this.redisInstance;\n  }\n\n  /**\n   * Get a cached JSON value (deserialized) or null if not present.\n   *\n   * @param key - Cache key\n   * @returns Deserialized value or null if not found\n   * @throws {Error} If the cached value is not valid JSON\n   *\n   * @example\n   * ```typescript\n   * const user = await cache.getItem<{ id: number; name: string }>({ key: 'user:123' });\n   * if (user) {\n   *   console.log(user.name);\n   * }\n   * ```\n   */\n  public async getItem<T>({ key }: { key: string }): Promise<T | null> {\n    const instance = await this.getRedisInstance();\n    const raw = await instance.getCache({ key });\n    if (raw === null) return null;\n\n    // Validate that we received a string (Redis should always return string or null)\n    if (typeof raw !== 'string') {\n      throw new Error(`Cache value for key \"${key}\" must be a string, got ${typeof raw}`);\n    }\n\n    try {\n      return JSON.parse(raw) as T;\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : safeSerializeError(error);\n      throw new Error(`Failed to parse cached value for key \"${key}\": ${errorMessage}`);\n    }\n  }\n\n  /**\n   * Set a JSON-serializable value. Optionally specify lifetime (seconds).\n   *\n   * @param key - Cache key\n   * @param value - Value to cache (must be JSON-serializable)\n   * @param lifetime - Optional expiration in seconds\n   *\n   * @example\n   * ```typescript\n   * // Cache with no expiration\n   * await cache.setItem({ key: 'config', value: { theme: 'dark' } });\n   *\n   * // Cache with 1 hour expiration\n   * await cache.setItem({\n   *   key: 'session:abc',\n   *   value: { userId: 123 },\n   *   lifetime: 3600\n   * });\n   * ```\n   */\n  public async setItem<T>({ key, value, lifetime }: { key: string; value: T; lifetime?: number }): Promise<void> {\n    const instance = await this.getRedisInstance();\n    await instance.setCache({ key, value, expiration: lifetime });\n  }\n\n  /**\n   * Delete a cached value.\n   *\n   * @param key - Cache key to delete\n   *\n   * @example\n   * ```typescript\n   * await cache.clearItem({ key: 'session:abc' });\n   * ```\n   */\n  public async clearItem({ key }: { key: string }): Promise<void> {\n    const instance = await this.getRedisInstance();\n    await instance.deleteCache({ key });\n  }\n\n  /**\n   * No-op: lifecycle handles Redis disconnection globally.\n   */\n  public async close(): Promise<void> {\n    // Intentionally empty; RedisManager handles disconnect.\n  }\n}\n"],
-  "mappings": ";;AAEA,SAAS,0BAA0B;AAuCnC,MAAO,aAA2B;AAAA,EAzClC,OAyCkC;AAAA;AAAA;AAAA,EACxB;AAAA,EACA;AAAA,EAER,YAAY,EAAE,aAAa,GAAsB;AAC/C,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,mBAA2C;AACvD,QAAI,KAAK,cAAe,QAAO,KAAK;AAEpC,QAAI,KAAK,aAAa,UAAU,SAAS,GAAG;AAC1C,WAAK,gBAAgB,KAAK,aAAa,UAAU,CAAC;AAClD,aAAO,KAAK;AAAA,IACd;AAGA,SAAK,gBAAgB,MAAM,KAAK,aAAa,QAAQ;AACrD,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,MAAa,QAAW,EAAE,IAAI,GAAuC;AACnE,UAAM,WAAW,MAAM,KAAK,iBAAiB;AAC7C,UAAM,MAAM,MAAM,SAAS,SAAS,EAAE,IAAI,CAAC;AAC3C,QAAI,QAAQ,KAAM,QAAO;AAGzB,QAAI,OAAO,QAAQ,UAAU;AAC3B,YAAM,IAAI,MAAM,wBAAwB,GAAG,2BAA2B,OAAO,GAAG,EAAE;AAAA,IACpF;AAEA,QAAI;AACF,aAAO,KAAK,MAAM,GAAG;AAAA,IACvB,SAAS,OAAO;AACd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,mBAAmB,KAAK;AACtF,YAAM,IAAI,MAAM,yCAAyC,GAAG,MAAM,YAAY,EAAE;AAAA,IAClF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBA,MAAa,QAAW,EAAE,KAAK,OAAO,SAAS,GAAgE;AAC7G,UAAM,WAAW,MAAM,KAAK,iBAAiB;AAC7C,UAAM,SAAS,SAAS,EAAE,KAAK,OAAO,YAAY,SAAS,CAAC;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAa,UAAU,EAAE,IAAI,GAAmC;AAC9D,UAAM,WAAW,MAAM,KAAK,iBAAiB;AAC7C,UAAM,SAAS,YAAY,EAAE,IAAI,CAAC;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,QAAuB;AAAA,EAEpC;AACF;",
+  "sourcesContent": ["import type RedisManager from '../redis/manager.js';\nimport type RedisInstance from '../redis/instance.js';\nimport { safeSerializeError } from '../error/error-reporter.js';\n\n/**\n * CacheManager\n *\n * Thin abstraction over Redis for basic JSON value caching. Unifies all Redis\n * access through the framework RedisManager / RedisInstance (ioredis) so we\n * avoid maintaining a second client implementation (node-redis).\n *\n * Lazy acquisition: the first call to any cache method will either reuse an\n * existing connected RedisInstance (if already established by application\n * startup) or trigger a connection via RedisManager.\n *\n * **Important:** All values are stored as JSON strings. Only JSON-serializable\n * values are supported. Complex types like Date, Map, Set, RegExp, etc. will\n * lose their type information during serialization:\n * - `Date` objects \u2192 ISO strings\n * - `Map` / `Set` \u2192 empty objects `{}`\n * - `undefined` \u2192 omitted from objects, `null` in arrays\n * - Functions \u2192 omitted\n *\n * @example\n * ```typescript\n * // Supported types\n * await cache.setItem({ key: 'user', value: { id: 1, name: 'John' } }); // \u2713\n * await cache.setItem({ key: 'count', value: 42 }); // \u2713\n * await cache.setItem({ key: 'tags', value: ['a', 'b', 'c'] }); // \u2713\n *\n * // Unsupported types (will lose type information)\n * await cache.setItem({ key: 'date', value: new Date() }); // \u2192 ISO string\n * await cache.setItem({ key: 'map', value: new Map() }); // \u2192 {}\n * ```\n */\n\nexport interface CacheManagerProps {\n  /** Redis manager (shared across the application) */\n  redisManager: RedisManager;\n}\n\nexport default class CacheManager {\n  private redisManager: RedisManager;\n  private redisInstance?: RedisInstance;\n  private redisInstancePromise?: Promise<RedisInstance>;\n\n  constructor({ redisManager }: CacheManagerProps) {\n    this.redisManager = redisManager;\n  }\n\n  /**\n   * Ensure we have a connected RedisInstance. Reuses the first existing\n   * instance if already connected by the application bootstrap.\n   */\n  private async getRedisInstance(): Promise<RedisInstance> {\n    if (this.redisInstance) return this.redisInstance;\n    if (this.redisInstancePromise) return this.redisInstancePromise;\n\n    if (this.redisManager.instances.length > 0) {\n      this.redisInstance = this.redisManager.instances[0];\n      return this.redisInstance;\n    }\n\n    // Lazily connect if no instances yet (e.g., used before app onBeforeStart)\n    this.redisInstancePromise = this.redisManager\n      .connect()\n      .then(instance => {\n        this.redisInstance = instance;\n        this.redisInstancePromise = undefined;\n        return instance;\n      })\n      .catch(error => {\n        this.redisInstancePromise = undefined;\n        throw error;\n      });\n\n    return this.redisInstancePromise;\n  }\n\n  /**\n   * Get a cached JSON value (deserialized) or null if not present.\n   *\n   * @param key - Cache key\n   * @returns Deserialized value or null if not found\n   * @throws {Error} If the cached value is not valid JSON\n   *\n   * @example\n   * ```typescript\n   * const user = await cache.getItem<{ id: number; name: string }>({ key: 'user:123' });\n   * if (user) {\n   *   console.log(user.name);\n   * }\n   * ```\n   */\n  public async getItem<T>({ key }: { key: string }): Promise<T | null> {\n    const instance = await this.getRedisInstance();\n    const raw = await instance.getCache({ key });\n    if (raw === null) return null;\n\n    // Validate that we received a string (Redis should always return string or null)\n    if (typeof raw !== 'string') {\n      throw new Error(`Cache value for key \"${key}\" must be a string, got ${typeof raw}`);\n    }\n\n    try {\n      return JSON.parse(raw) as T;\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : safeSerializeError(error);\n      throw new Error(`Failed to parse cached value for key \"${key}\": ${errorMessage}`);\n    }\n  }\n\n  /**\n   * Set a JSON-serializable value. Optionally specify lifetime (seconds).\n   *\n   * @param key - Cache key\n   * @param value - Value to cache (must be JSON-serializable)\n   * @param lifetime - Optional expiration in seconds\n   *\n   * @example\n   * ```typescript\n   * // Cache with no expiration\n   * await cache.setItem({ key: 'config', value: { theme: 'dark' } });\n   *\n   * // Cache with 1 hour expiration\n   * await cache.setItem({\n   *   key: 'session:abc',\n   *   value: { userId: 123 },\n   *   lifetime: 3600\n   * });\n   * ```\n   */\n  public async setItem<T>({ key, value, lifetime }: { key: string; value: T; lifetime?: number }): Promise<void> {\n    const instance = await this.getRedisInstance();\n    await instance.setCache({ key, value, expiration: lifetime });\n  }\n\n  /**\n   * Delete a cached value.\n   *\n   * @param key - Cache key to delete\n   *\n   * @example\n   * ```typescript\n   * await cache.clearItem({ key: 'session:abc' });\n   * ```\n   */\n  public async clearItem({ key }: { key: string }): Promise<void> {\n    const instance = await this.getRedisInstance();\n    await instance.deleteCache({ key });\n  }\n\n  /**\n   * No-op: lifecycle handles Redis disconnection globally.\n   */\n  public async close(): Promise<void> {\n    // Intentionally empty; RedisManager handles disconnect.\n  }\n}\n"],
+  "mappings": ";;AAEA,SAAS,0BAA0B;AAuCnC,MAAO,aAA2B;AAAA,EAzClC,OAyCkC;AAAA;AAAA;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,EAAE,aAAa,GAAsB;AAC/C,SAAK,eAAe;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,mBAA2C;AACvD,QAAI,KAAK,cAAe,QAAO,KAAK;AACpC,QAAI,KAAK,qBAAsB,QAAO,KAAK;AAE3C,QAAI,KAAK,aAAa,UAAU,SAAS,GAAG;AAC1C,WAAK,gBAAgB,KAAK,aAAa,UAAU,CAAC;AAClD,aAAO,KAAK;AAAA,IACd;AAGA,SAAK,uBAAuB,KAAK,aAC9B,QAAQ,EACR,KAAK,cAAY;AAChB,WAAK,gBAAgB;AACrB,WAAK,uBAAuB;AAC5B,aAAO;AAAA,IACT,CAAC,EACA,MAAM,WAAS;AACd,WAAK,uBAAuB;AAC5B,YAAM;AAAA,IACR,CAAC;AAEH,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,MAAa,QAAW,EAAE,IAAI,GAAuC;AACnE,UAAM,WAAW,MAAM,KAAK,iBAAiB;AAC7C,UAAM,MAAM,MAAM,SAAS,SAAS,EAAE,IAAI,CAAC;AAC3C,QAAI,QAAQ,KAAM,QAAO;AAGzB,QAAI,OAAO,QAAQ,UAAU;AAC3B,YAAM,IAAI,MAAM,wBAAwB,GAAG,2BAA2B,OAAO,GAAG,EAAE;AAAA,IACpF;AAEA,QAAI;AACF,aAAO,KAAK,MAAM,GAAG;AAAA,IACvB,SAAS,OAAO;AACd,YAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,mBAAmB,KAAK;AACtF,YAAM,IAAI,MAAM,yCAAyC,GAAG,MAAM,YAAY,EAAE;AAAA,IAClF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBA,MAAa,QAAW,EAAE,KAAK,OAAO,SAAS,GAAgE;AAC7G,UAAM,WAAW,MAAM,KAAK,iBAAiB;AAC7C,UAAM,SAAS,SAAS,EAAE,KAAK,OAAO,YAAY,SAAS,CAAC;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,MAAa,UAAU,EAAE,IAAI,GAAmC;AAC9D,UAAM,WAAW,MAAM,KAAK,iBAAiB;AAC7C,UAAM,SAAS,YAAY,EAAE,IAAI,CAAC;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAa,QAAuB;AAAA,EAEpC;AACF;",
   "names": []
 }

package/dist/cli/index.js

@@ -448,8 +448,11 @@ var unescape;
 var init_unescape = __esm({
   "node_modules/glob/node_modules/minimatch/dist/esm/unescape.js"() {
     "use strict";
-    unescape = /* @__PURE__ */ __name((s, { windowsPathsNoEscape = false } = {}) => {
-      return windowsPathsNoEscape ? s.replace(/\[([^\/\\])\]/g, "$1") : s.replace(/((?!\\).|^)\[([^\/\\])\]/g, "$1$2").replace(/\\([^\/])/g, "$1");
+    unescape = /* @__PURE__ */ __name((s, { windowsPathsNoEscape = false, magicalBraces = true } = {}) => {
+      if (magicalBraces) {
+        return windowsPathsNoEscape ? s.replace(/\[([^\/\\])\]/g, "$1") : s.replace(/((?!\\).|^)\[([^\/\\])\]/g, "$1$2").replace(/\\([^\/])/g, "$1");
+      }
+      return windowsPathsNoEscape ? s.replace(/\[([^\/\\{}])\]/g, "$1") : s.replace(/((?!\\).|^)\[([^\/\\{}])\]/g, "$1$2").replace(/\\([^\/{}])/g, "$1");
     }, "unescape");
   }
 });
@@ -814,7 +817,7 @@ var init_ast = __esm({
         if (this.#root === this)
           this.#fillNegs();
         if (!this.type) {
-          const noEmpty = this.isStart() && this.isEnd();
+          const noEmpty = this.isStart() && this.isEnd() && !this.#parts.some((s) => typeof s !== "string");
           const src = this.#parts.map((p) => {
             const [re, _, hasMagic2, uflag] = typeof p === "string" ? _AST.#parseGlob(p, this.#hasMagic, noEmpty) : p.toRegExpSource(allowDot);
             this.#hasMagic = this.#hasMagic || hasMagic2;
@@ -924,10 +927,7 @@ var init_ast = __esm({
             }
           }
           if (c === "*") {
-            if (noEmpty && glob2 === "*")
-              re += starNoEmpty;
-            else
-              re += star;
+            re += noEmpty && glob2 === "*" ? starNoEmpty : star;
             hasMagic2 = true;
             continue;
           }
@@ -949,7 +949,10 @@ var escape;
 var init_escape = __esm({
   "node_modules/glob/node_modules/minimatch/dist/esm/escape.js"() {
     "use strict";
-    escape = /* @__PURE__ */ __name((s, { windowsPathsNoEscape = false } = {}) => {
+    escape = /* @__PURE__ */ __name((s, { windowsPathsNoEscape = false, magicalBraces = false } = {}) => {
+      if (magicalBraces) {
+        return windowsPathsNoEscape ? s.replace(/[?*()[\]{}]/g, "[$&]") : s.replace(/[?*()[\]\\{}]/g, "\\$&");
+      }
       return windowsPathsNoEscape ? s.replace(/[?*()[\]]/g, "[$&]") : s.replace(/[?*()[\]\\]/g, "\\$&");
     }, "escape");
   }
@@ -1613,16 +1616,27 @@ var init_esm3 = __esm({
                 pp[i] = twoStar;
               }
             } else if (next === void 0) {
-              pp[i - 1] = prev + "(?:\\/|" + twoStar + ")?";
+              pp[i - 1] = prev + "(?:\\/|\\/" + twoStar + ")?";
             } else if (next !== GLOBSTAR) {
               pp[i - 1] = prev + "(?:\\/|\\/" + twoStar + "\\/)" + next;
               pp[i + 1] = GLOBSTAR;
             }
           });
-          return pp.filter((p) => p !== GLOBSTAR).join("/");
+          const filtered = pp.filter((p) => p !== GLOBSTAR);
+          if (this.partial && filtered.length >= 1) {
+            const prefixes = [];
+            for (let i = 1; i <= filtered.length; i++) {
+              prefixes.push(filtered.slice(0, i).join("/"));
+            }
+            return "(?:" + prefixes.join("|") + ")";
+          }
+          return filtered.join("/");
         }).join("|");
         const [open, close] = set.length > 1 ? ["(?:", ")"] : ["", ""];
         re = "^" + open + re + close + "$";
+        if (this.partial) {
+          re = "^(?:\\/|" + open + re.slice(1, -1) + close + ")$";
+        }
         if (this.negate)
           re = "^(?!" + re + ").+$";
         try {