@modularizer/plat 0.8.0 → 0.10.0

package/dist/static/virtual-file-system.js

@@ -0,0 +1,100 @@
+/**
+ * Check if a value implements the VirtualFileSystem interface.
+ */
+export function isVirtualFileSystem(value) {
+    return (value != null &&
+        typeof value === 'object' &&
+        'list' in value && typeof value.list === 'function' &&
+        'read' in value && typeof value.read === 'function');
+}
+/**
+ * VFS backed by Node.js filesystem. Used when StaticFolder is given a directory path string.
+ */
+export class NodeFileSystem {
+    root;
+    constructor(directory) {
+        // Resolve to absolute path at construction time
+        const path = require('node:path');
+        this.root = path.resolve(directory);
+    }
+    resolveSafe(subPath) {
+        const path = require('node:path');
+        // Reject paths with .. segments to prevent directory traversal
+        const normalized = path.normalize(subPath);
+        if (normalized.startsWith('..') || path.isAbsolute(normalized)) {
+            return null;
+        }
+        const resolved = path.resolve(this.root, normalized);
+        // Verify the resolved path is still within root
+        if (!resolved.startsWith(this.root + path.sep) && resolved !== this.root) {
+            return null;
+        }
+        return resolved;
+    }
+    async list(subPath) {
+        const fs = require('node:fs/promises');
+        const path = require('node:path');
+        const dir = subPath ? this.resolveSafe(subPath) : this.root;
+        if (!dir)
+            return [];
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            return entries.map((e) => e.isDirectory() ? e.name + '/' : e.name);
+        }
+        catch {
+            return [];
+        }
+    }
+    async read(subPath) {
+        const fs = require('node:fs/promises');
+        const resolved = this.resolveSafe(subPath);
+        if (!resolved)
+            return null;
+        try {
+            return await fs.readFile(resolved);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * VFS backed by an in-memory file map.
+ * Keys are paths like 'index.html' or 'css/style.css'.
+ * Values can be raw content or objects with a read() method for lazy evaluation.
+ */
+export class MemoryFileSystem {
+    files;
+    constructor(files) {
+        this.files = files;
+    }
+    list(subPath) {
+        const prefix = subPath ? (subPath.endsWith('/') ? subPath : subPath + '/') : '';
+        const seen = new Set();
+        for (const key of Object.keys(this.files)) {
+            if (!key.startsWith(prefix))
+                continue;
+            const rest = key.slice(prefix.length);
+            const slashIndex = rest.indexOf('/');
+            if (slashIndex === -1) {
+                // Direct file in this directory
+                seen.add(rest);
+            }
+            else {
+                // Subdirectory
+                seen.add(rest.slice(0, slashIndex) + '/');
+            }
+        }
+        return Array.from(seen);
+    }
+    async read(subPath) {
+        const entry = this.files[subPath];
+        if (entry === undefined)
+            return null;
+        if (typeof entry === 'string' || entry instanceof Uint8Array)
+            return entry;
+        // Lazy read() object
+        return entry.read();
+    }
+}
+//# sourceMappingURL=virtual-file-system.js.map

package/dist/static/virtual-file-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-file-system.js","sourceRoot":"","sources":["../../src/static/virtual-file-system.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modularizer/plat",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Protocol and Language Agnostic Tooling Yielding Universal Semantics",
   "type": "module",
   "author": {
@@ -38,6 +38,10 @@
     "./python-browser": {
       "import": "./dist/python-browser-entry.js",
       "types": "./dist/python-browser-entry.d.ts"
+    },
+    "./static": {
+      "import": "./dist/static/index.js",
+      "types": "./dist/static/index.d.ts"
     }
   },
   "files": [