refactor!: implement brand new cache layer

Author: fraxken

.changeset/forty-vans-live.md

@@ -0,0 +1,6 @@
+---
+"@nodesecure/server": major
+"@nodesecure/cache": major
+---
+
+Major refactor to enhance cache integration

.gitignore

@@ -72,3 +72,4 @@ reports
 # macOS system files
 .DS_Store
 
+.claude

.npmrc

@@ -2,3 +2,4 @@ package-lock=false
 provenance=true
 save-exact=true
 ignore-scripts=true
+allow-git=none

bin/index.js

@@ -126,7 +126,6 @@ prog
   .command("cache")
   .option("-l, --list", i18n.getTokenSync("cli.commands.cache.option_list"), false)
   .option("-c, --clear", i18n.getTokenSync("cli.commands.cache.option_clear"), false)
-  .option("-f, --full", i18n.getTokenSync("cli.commands.cache.option_full"), false)
   .describe(i18n.getTokenSync("cli.commands.cache.desc"))
   .action(commands.cache.main);
 

docs/cli/cache.md

@@ -14,4 +14,3 @@ $ nsecure cache [options]
 |---|---|---|---|
 | `--list` | `-l` | `false` | Display the cache contents in JSON format. Use with `--full` to include scanned payloads stored on disk. |
 | `--clear` | `-c` | `false` | Remove cached entries. Use with `--full` to also delete scanned payloads stored on disk. |
-| `--full` | `-f` | `false` | Extend the scope of `--list` or `--clear` to include scanned payloads stored on disk.|

esbuild.dev.config.ts

@@ -4,7 +4,9 @@ import http from "node:http";
 import path from "node:path";
 
 // Import Third-party Dependencies
-import { getBuildConfiguration } from "@nodesecure/documentation-ui/node";
+import {
+  getBuildConfiguration
+} from "@nodesecure/documentation-ui/node";
 import * as i18n from "@nodesecure/i18n";
 import chokidar from "chokidar";
 import esbuild from "esbuild";
@@ -14,12 +16,17 @@ import sirv from "sirv";
 // Import Internal Dependencies
 import english from "./i18n/english.js";
 import french from "./i18n/french.js";
-import { context as als, type AsyncStoreContext } from "./workspaces/server/src/ALS.ts";
-import { ViewBuilder } from "./workspaces/server/src/ViewBuilder.class.ts";
-import { cache } from "./workspaces/server/src/cache.ts";
-import { getApiRouter } from "./workspaces/server/src/endpoints/index.ts";
-import { logger } from "./workspaces/server/src/logger.ts";
-import { WebSocketServerInstanciator } from "./workspaces/server/src/websocket/index.ts";
+
+import {
+  PayloadCache
+} from "./workspaces/cache/src/index.ts";
+import {
+  WebSocketServerInstanciator,
+  logger,
+  ViewBuilder,
+  getApiRouter,
+  context as als, type AsyncStoreContext
+} from "./workspaces/server/src/index.ts";
 
 // CONSTANTS
 const kPublicDir = path.join(import.meta.dirname, "public");
@@ -73,10 +80,13 @@ const { hosts: esbuildHosts, port: esbuildPort } = await buildContext.serve({
   servedir: kOutDir
 });
 
-const dataFilePath = await fsAsync.access(kDefaultPayloadPath).then(() => kDefaultPayloadPath, () => undefined);
+const dataFilePath = await fsAsync.access(
+  kDefaultPayloadPath
+).then(() => kDefaultPayloadPath, () => undefined);
+const cache = await new PayloadCache().load();
 
 if (dataFilePath === undefined) {
-  cache.startFromZero = true;
+  cache.setCurrentSpec(null);
 }
 
 const store: AsyncStoreContext = {
@@ -85,7 +95,7 @@ const store: AsyncStoreContext = {
     projectRootDir: import.meta.dirname,
     componentsDir: kComponentsDir
   }),
-  dataFilePath
+  cache
 };
 const htmlWatcher = chokidar.watch(kComponentsDir, {
   persistent: false,
@@ -129,7 +139,7 @@ function defaultRoute(req: http.IncomingMessage, res: http.ServerResponse) {
 
 const apiRouter = getApiRouter(defaultRoute);
 
-const httpServer = http.createServer((req, res) => als.run(store, () => apiRouter.lookup(req, res)))
+http.createServer((req, res) => als.run(store, () => apiRouter.lookup(req, res)))
   .listen(kDevPort, () => {
     console.log(`Dev server: http://localhost:${kDevPort}`);
     open(`http://localhost:${kDevPort}`);

i18n/arabic.js

@@ -80,9 +80,7 @@ const cli = {
       missingAction: "لم يتم تحديد إجراء صالح. استخدم --help لرؤية الخيارات.",
       option_list: "عرض ملفات ذاكرة التخزين المؤقت",
       option_clear: "مسح ذاكرة التخزين المؤقت",
-      option_full: "مسح أو عرض ذاكرة التخزين المؤقت الكاملة، بما في ذلك الحمولات",
       cacheTitle: "ذاكرة التخزين المؤقت لـ NodeSecure:",
-      scannedPayloadsTitle: "الحمولات الممسوحة المتاحة على القرص:",
       cleared: "تم مسح ذاكرة التخزين المؤقت بنجاح!"
     },
     extractIntegrity: {
@@ -226,7 +224,6 @@ const ui = {
     "Available licenses": "التراخيص المتاحة",
     "Available flags": "الأعلام المتاحة",
     default: "خيارات البحث",
-    recentPackages: "الحزم الأخيرة",
     packagesCache: "الحزم المتاحة في ذاكرة التخزين المؤقت",
     noPackageFound: "لم يتم العثور على حزمة",
     packageLengthErr: "يجب أن يكون اسم الحزمة بين 2 و 64 حرفاً.",

i18n/english.js

@@ -82,9 +82,7 @@ const cli = {
       missingAction: "No valid action specified. Use --help to see options.",
       option_list: "List cache files",
       option_clear: "Clear the cache",
-      option_full: "Clear or list the full cache, including payloads",
       cacheTitle: "NodeSecure Cache:",
-      scannedPayloadsTitle: "Scanned payloads available on disk:",
       cleared: "Cache cleared successfully!"
     },
     extractIntegrity: {
@@ -223,7 +221,6 @@ const ui = {
     locked: "locked"
   },
   search: {
-    recentPackages: "Recent packages",
     packagesCache: "Packages available in the cache",
     noPackageFound: "No package found",
     packageLengthErr: "Package name must be between 2 and 64 characters.",

i18n/french.js

@@ -82,9 +82,7 @@ const cli = {
       missingAction: "Aucune action valide spécifiée. Utilisez --help pour voir les options.",
       option_list: "Lister les fichiers du cache",
       option_clear: "Nettoyer le cache",
-      option_full: "Nettoyer ou lister le cache complet, y compris les payloads",
       cacheTitle: "Cache NodeSecure:",
-      scannedPayloadsTitle: "Payloads scannés disponibles sur le disque:",
       cleared: "Cache nettoyé avec succès !"
     },
     extractIntegrity: {
@@ -223,7 +221,6 @@ const ui = {
     locked: "Verrouillé"
   },
   search: {
-    recentPackages: "Packages récents",
     packagesCache: "Packages disponibles dans le cache",
     noPackageFound: "Aucun package trouvé",
     packageLengthErr: "Le nom du package doit être compris entre 2 et 64 caractères.",

i18n/turkish.js

@@ -82,9 +82,7 @@ const cli = {
       missingAction: "Geçerli bir işlem belirtilmedi. Seçenekleri görmek için --help kullanın.",
       option_list: "Önbellek dosyalarını listele",
       option_clear: "Önbelleği temizle",
-      option_full: "Yükler dahil tam önbelleği temizle veya listele",
       cacheTitle: "NodeSecure Önbelleği:",
-      scannedPayloadsTitle: "Diskte mevcut taranan yükler:",
       cleared: "Önbellek başarıyla temizlendi!"
     },
     extractIntegrity: {
@@ -228,7 +226,6 @@ const ui = {
     "Available licenses": "Mevcut lisanslar",
     "Available flags": "Mevcut bayraklar",
     default: "Arama seçenekleri",
-    recentPackages: "Son paketler",
     packagesCache: "Önbellekte mevcut paketler",
     noPackageFound: "Paket bulunamadı",
     packageLengthErr: "Paket adı 2 ile 64 karakter arasında olmalıdır.",