h1v3 0.1.0

package/src/schema.js

@@ -0,0 +1,66 @@
+// Does the schema contain this dot-notated path?
+export function schemaAllowsPath(schema, path) {
+
+    const parts = path.split('.');
+    let cur = schema;
+
+    for (let i = 0; i < parts.length; i++) {
+        const key = parts[i];
+
+        // must be an object schema at this step
+        if (cur && typeof cur === 'object' && !Array.isArray(cur)) {
+            if (!(key in cur)) return false;
+            cur = cur[key];
+        } else {
+            // if we hit a leaf constructor (String/Number/...) before the end, it's invalid
+            return i === parts.length - 1 && typeof cur === 'function';
+        }
+    }
+    // valid if leaf is a constructor or object schema
+    return typeof cur === 'function' || (cur && typeof cur === 'object');
+
+}
+
+// Delete a value by dot-notated path (no-ops if missing)
+export function deleteByPath(obj, path) {
+
+    const parts = path.split('.');
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+
+        if (!cur || typeof cur !== 'object') return; // nothing to delete
+        cur = cur[parts[i]];
+
+    }
+    if (cur && typeof cur === 'object') delete cur[parts[parts.length - 1]];
+
+}
+
+export function filterBySchema(schema, obj) {
+
+    const result = {};
+    for (const key in schema) {
+
+        const expected = schema[key];
+        const value = obj[key];
+
+        if (expected === String) {
+            if (typeof value === "string") result[key] = value;
+        } else if (expected === Number) {
+            if (typeof value === "number") result[key] = value;
+        } else if (expected === Boolean) {
+            if (typeof value === "boolean") result[key] = value;
+        } else if (expected === Array) {
+            if (Array.isArray(value)) result[key] = value;
+        } else if (expected && typeof expected === "object") {
+            // nested schema
+            if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+                const nested = filterBySchema(expected, value);
+                if (Object.keys(nested).length > 0) result[key] = nested;
+            }
+        }
+
+    }
+    return result;
+
+}

package/src/system/json.js

@@ -0,0 +1,23 @@
+import { readFileSync } from "fs";
+
+export function readJSON(path) {
+
+    try {
+
+        return JSON.parse(readFileSync(path));
+
+    } catch (err) {
+
+        if (err?.code === "ENOENT") {
+
+            return {};
+
+        } else {
+
+            throw err;
+
+        }
+
+    }
+
+}

package/src/system/main.js

@@ -0,0 +1,76 @@
+import minimist from "minimist";
+import { loadConfiguration } from "../load-configuration.js";
+
+export async function main(commands) {
+
+    const argv = minimist(process.argv.slice(2));
+    if (argv._.length) {
+
+        for (const verb of argv._) {
+
+            await invoke(commands, verb, argv);
+
+        }
+
+    } else {
+
+        displayHelp(commands);
+
+    }
+
+}
+
+async function invoke(commands, verb, argv) {
+
+    if (!(verb in commands)) {
+
+        displayHelp(commands);
+        console.log("");
+        console.error(`Unknown command: ${verb}`);
+        process.exit(1);
+
+    }
+    if (commands[verb].loadConfig === false) {
+
+        commands[verb].strategy(argv);
+
+    } else {
+
+        const config = await loadConfiguration(argv);
+        commands[verb].strategy(argv, config);
+
+    }
+
+}
+
+function displayHelp(commands) {
+
+    console.log("Help:");
+    console.log("");
+
+    Object.entries(commands).forEach(([name, { description, parameters } = {}] = []) => {
+
+        let indent = "   ";
+        console.log(`${indent}${name}: ${description}`);
+        indent += " ".repeat(name.length + 2);
+        Object.entries(parameters).forEach(([name, { description, defaultValue, examples }]) => {
+
+            const maybeExamples = examples?.length ?examples.map(x => `--${name}="${x}"`).join(", ") : "";
+            console.log(`${indent}--${name}: ${description}`);
+            indent += " ".repeat(name.length + 4);
+            if (maybeExamples) {
+
+                console.log(`${indent}(e.g. ${maybeExamples})`);
+
+            }
+            if (defaultValue) {
+
+                console.log(`${indent}DEFAULT: ${defaultValue}`);
+
+            }
+
+        });
+
+    });
+
+}