@start9labs/start-sdk 0.4.0-beta.9 → 0.4.0

package/package/lib/version/VersionGraph.js

@@ -1,28 +1,93 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VersionGraph = void 0;
+exports.getDataVersion = getDataVersion;
+exports.setDataVersion = setDataVersion;
+exports.overlaps = overlaps;
 const exver_1 = require("../../../base/lib/exver");
 const util_1 = require("../util");
 const VersionInfo_1 = require("./VersionInfo");
+/**
+ * Read the current data version from the effects system.
+ * @param effects - The effects context
+ * @returns The parsed ExtendedVersion or VersionRange, or null if no version is set
+ */
+async function getDataVersion(effects) {
+    const versionStr = await effects.getDataVersion();
+    if (!versionStr)
+        return null;
+    try {
+        return exver_1.ExtendedVersion.parse(versionStr);
+    }
+    catch (_) {
+        return exver_1.VersionRange.parse(versionStr);
+    }
+}
+/**
+ * Persist a data version to the effects system.
+ * @param effects - The effects context
+ * @param version - The version to set, or null to clear it
+ */
+async function setDataVersion(effects, version) {
+    return effects.setDataVersion({ version: version?.toString() || null });
+}
+function isExver(v) {
+    return 'satisfies' in v;
+}
+function isRange(v) {
+    return 'satisfiedBy' in v;
+}
+/**
+ * Check whether two version specifiers overlap (i.e. share at least one common version).
+ * Works with any combination of ExtendedVersion and VersionRange.
+ *
+ * @param a - First version or range
+ * @param b - Second version or range
+ * @returns True if the two specifiers overlap
+ */
+function overlaps(a, b) {
+    return ((isRange(a) && isRange(b) && a.intersects(b)) ||
+        (isRange(a) && isExver(b) && a.satisfiedBy(b)) ||
+        (isExver(a) && isRange(b) && a.satisfies(b)) ||
+        (isExver(a) && isExver(b) && a.equals(b)));
+}
+/**
+ * A directed graph of service versions and their migration paths.
+ *
+ * Builds a graph from {@link VersionInfo} definitions, then uses shortest-path
+ * search to find and execute migration sequences between any two versions.
+ * Implements both {@link InitScript} (for install/update migrations) and
+ * {@link UninitScript} (for uninstall/downgrade migrations).
+ *
+ * @typeParam CurrentVersion - The string literal type of the current service version
+ */
 class VersionGraph {
+    /** Dump the version graph as a human-readable string for debugging */
+    dump() {
+        return this.graph().dump((metadata) => metadata?.toString());
+    }
     constructor(current, versions) {
         this.current = current;
+        this.initFn = this.init.bind(this);
+        this.uninitFn = this.uninit.bind(this);
         this.currentVersion = (0, util_1.once)(() => exver_1.ExtendedVersion.parse(this.current.options.version));
-        this.canMigrateFrom = (0, util_1.once)(() => Array.from(this.graph().reverseBreadthFirstSearch((v) => (v.metadata instanceof exver_1.VersionRange &&
-            v.metadata.satisfiedBy(this.currentVersion())) ||
-            (v.metadata instanceof exver_1.ExtendedVersion &&
-                v.metadata.equals(this.currentVersion()))))
-            .reduce((acc, x) => acc.or(x.metadata instanceof exver_1.VersionRange
+        /**
+         * Compute the version range from which the current version can be reached via migration.
+         * Uses reverse breadth-first search from the current version vertex.
+         */
+        this.canMigrateFrom = (0, util_1.once)(() => Array.from(this.graph().reverseBreadthFirstSearch((v) => overlaps(v.metadata, this.currentVersion())))
+            .reduce((acc, x) => acc.or(isRange(x.metadata)
             ? x.metadata
-            : exver_1.VersionRange.anchor("=", x.metadata)), exver_1.VersionRange.none())
+            : exver_1.VersionRange.anchor('=', x.metadata)), exver_1.VersionRange.none())
             .normalize());
-        this.canMigrateTo = (0, util_1.once)(() => Array.from(this.graph().breadthFirstSearch((v) => (v.metadata instanceof exver_1.VersionRange &&
-            v.metadata.satisfiedBy(this.currentVersion())) ||
-            (v.metadata instanceof exver_1.ExtendedVersion &&
-                v.metadata.equals(this.currentVersion()))))
-            .reduce((acc, x) => acc.or(x.metadata instanceof exver_1.VersionRange
+        /**
+         * Compute the version range that the current version can migrate to.
+         * Uses forward breadth-first search from the current version vertex.
+         */
+        this.canMigrateTo = (0, util_1.once)(() => Array.from(this.graph().breadthFirstSearch((v) => overlaps(v.metadata, this.currentVersion())))
+            .reduce((acc, x) => acc.or(isRange(x.metadata)
             ? x.metadata
-            : exver_1.VersionRange.anchor("=", x.metadata)), exver_1.VersionRange.none())
+            : exver_1.VersionRange.anchor('=', x.metadata)), exver_1.VersionRange.none())
             .normalize());
         this.graph = (0, util_1.once)(() => {
             const graph = new util_1.Graph();
@@ -30,7 +95,7 @@ class VersionGraph {
             for (let version of [current, ...versions]) {
                 const v = exver_1.ExtendedVersion.parse(version.options.version);
                 const vertex = graph.addVertex(v, [], []);
-                const flavor = v.flavor || "";
+                const flavor = v.flavor || '';
                 if (!flavorMap[flavor]) {
                     flavorMap[flavor] = [];
                 }
@@ -44,10 +109,10 @@ class VersionGraph {
                         let range;
                         if (prev) {
                             graph.addEdge(version.options.migrations.up, prev[2], vertex);
-                            range = exver_1.VersionRange.anchor(">=", prev[0]).and(exver_1.VersionRange.anchor("<", v));
+                            range = exver_1.VersionRange.anchor('>=', prev[0]).and(exver_1.VersionRange.anchor('<', v));
                         }
                         else {
-                            range = exver_1.VersionRange.anchor("<", v);
+                            range = exver_1.VersionRange.anchor('<', v);
                         }
                         const vRange = graph.addVertex(range, [], []);
                         graph.addEdge(version.options.migrations.up, vRange, vertex);
@@ -56,10 +121,10 @@ class VersionGraph {
                         let range;
                         if (prev) {
                             graph.addEdge(version.options.migrations.down, vertex, prev[2]);
-                            range = exver_1.VersionRange.anchor(">=", prev[0]).and(exver_1.VersionRange.anchor("<", v));
+                            range = exver_1.VersionRange.anchor('>=', prev[0]).and(exver_1.VersionRange.anchor('<', v));
                         }
                         else {
-                            range = exver_1.VersionRange.anchor("<", v);
+                            range = exver_1.VersionRange.anchor('<', v);
                         }
                         const vRange = graph.addVertex(range, [], []);
                         graph.addEdge(version.options.migrations.down, vertex, vRange);
@@ -68,13 +133,20 @@ class VersionGraph {
                         for (let rangeStr in version.options.migrations.other) {
                             const range = exver_1.VersionRange.parse(rangeStr);
                             const vRange = graph.addVertex(range, [], []);
-                            graph.addEdge(version.options.migrations.other[rangeStr], vRange, vertex);
-                            for (let matching of graph.findVertex((v) => v.metadata instanceof exver_1.ExtendedVersion &&
-                                v.metadata.satisfies(range))) {
-                                graph.addEdge(version.options.migrations.other[rangeStr], matching, vertex);
+                            const migration = version.options.migrations.other[rangeStr];
+                            if (migration.up)
+                                graph.addEdge(migration.up, vRange, vertex);
+                            if (migration.down)
+                                graph.addEdge(migration.down, vertex, vRange);
+                            for (let matching of graph.findVertex((v) => isExver(v.metadata) && v.metadata.satisfies(range))) {
+                                if (migration.up)
+                                    graph.addEdge(migration.up, matching, vertex);
+                                if (migration.down)
+                                    graph.addEdge(migration.down, vertex, matching);
                             }
                         }
                     }
+                    prev = [v, version, vertex];
                 }
             }
             return graph;
@@ -85,27 +157,90 @@ class VersionGraph {
      *
      * ** The current version must be the FIRST argument. **
      */
-    static of(currentVersion, ...other) {
-        return new VersionGraph(currentVersion, other);
+    static of(options) {
+        return new VersionGraph(options.current, options.other);
     }
+    /**
+     * Execute the shortest migration path between two versions.
+     *
+     * Finds the shortest path in the version graph from `from` to `to`,
+     * executes each migration step in order, and updates the data version after each step.
+     *
+     * @param options.effects - The effects context
+     * @param options.from - The source version or range
+     * @param options.to - The target version or range
+     * @returns The final data version after migration
+     * @throws If no migration path exists between the two versions
+     */
     async migrate({ effects, from, to, }) {
+        if (overlaps(from, to))
+            return from;
         const graph = this.graph();
         if (from && to) {
-            const path = graph.shortestPath((v) => (v.metadata instanceof exver_1.VersionRange &&
-                v.metadata.satisfiedBy(from)) ||
-                (v.metadata instanceof exver_1.ExtendedVersion && v.metadata.equals(from)), (v) => (v.metadata instanceof exver_1.VersionRange && v.metadata.satisfiedBy(to)) ||
-                (v.metadata instanceof exver_1.ExtendedVersion && v.metadata.equals(to)));
+            const path = graph.shortestPath((v) => overlaps(v.metadata, from), (v) => overlaps(v.metadata, to));
             if (path) {
+                console.log(`Migrating ${path.reduce(({ acc, prev }, x) => ({
+                    acc: acc +
+                        (prev && prev != x.from.metadata.toString()
+                            ? ` (as ${prev})`
+                            : '') +
+                        ' -> ' +
+                        x.to.metadata.toString(),
+                    prev: x.to.metadata.toString(),
+                }), { acc: from.toString(), prev: null }).acc}`);
+                let dataVersion = from;
                 for (let edge of path) {
                     if (edge.metadata) {
                         await edge.metadata({ effects });
                     }
-                    await effects.setDataVersion({ version: edge.to.metadata.toString() });
+                    dataVersion = edge.to.metadata;
+                    await setDataVersion(effects, edge.to.metadata);
                 }
+                return dataVersion;
+            }
+        }
+        throw new Error(`cannot migrate from ${from.toString()} to ${to.toString()}`);
+    }
+    /**
+     * InitScript implementation: migrate from the stored data version to the current version.
+     * If no data version exists (fresh install), sets it to the current version.
+     * @param effects - The effects context
+     */
+    async init(effects) {
+        const from = await getDataVersion(effects);
+        if (from) {
+            await this.migrate({
+                effects,
+                from,
+                to: this.currentVersion(),
+            });
+        }
+        else {
+            await effects.setDataVersion({ version: this.current.options.version });
+        }
+    }
+    /**
+     * UninitScript implementation: migrate from the current data version to the target version.
+     * Used during uninstall or downgrade to prepare data for the target version.
+     *
+     * @param effects - The effects context
+     * @param target - The target version to migrate to, or null to clear the data version
+     */
+    async uninit(effects, target) {
+        if (target) {
+            if (isRange(target) && !target.satisfiable()) {
                 return;
             }
+            const from = await getDataVersion(effects);
+            if (from) {
+                target = await this.migrate({
+                    effects,
+                    from,
+                    to: target,
+                });
+            }
         }
-        throw new Error();
+        await setDataVersion(effects, target);
     }
 }
 exports.VersionGraph = VersionGraph;

package/package/lib/version/VersionGraph.js.map

@@ -1 +1 @@
-{"version":3,"file":"VersionGraph.js","sourceRoot":"","sources":["../../../../package/lib/version/VersionGraph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"VersionGraph.js","sourceRoot":"","sources":["../../../../package/lib/version/VersionGraph.ts"],"names":[],"mappings":"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"}

package/package/lib/version/VersionInfo.d.ts

@@ -1,11 +1,20 @@
-import { ValidateExVer } from "../../../base/lib/exver";
-import * as T from "../../../base/lib/types";
+import { ValidateExVer } from '../../../base/lib/exver';
+import * as T from '../../../base/lib/types';
+/**
+ * Sentinel value indicating that a migration in a given direction is not possible.
+ * Use this for `migrations.up` or `migrations.down` to prevent migration.
+ */
 export declare const IMPOSSIBLE: unique symbol;
+/**
+ * Configuration options for a single service version definition.
+ *
+ * @typeParam Version - The string literal exver version number
+ */
 export type VersionOptions<Version extends string> = {
     /** The exver-compliant version number */
     version: Version & ValidateExVer<Version>;
     /** The release notes for this version */
-    releaseNotes: string;
+    releaseNotes: T.LocaleString;
     /** Data migrations for this version */
     migrations: {
         /**
@@ -25,11 +34,24 @@ export type VersionOptions<Version extends string> = {
         /**
          * Additional migrations, such as fast-forward migrations, or migrations from other flavors.
          */
-        other?: Record<string, (opts: {
-            effects: T.Effects;
-        }) => Promise<void>>;
+        other?: Record<string, {
+            up?: (opts: {
+                effects: T.Effects;
+            }) => Promise<void>;
+            down?: (opts: {
+                effects: T.Effects;
+            }) => Promise<void>;
+        }>;
     };
 };
+/**
+ * Represents a single version of the service, including its release notes,
+ * migration scripts, and backwards-compatibility declarations.
+ *
+ * By convention, each version gets its own file (e.g. `versions/v1_0_0.ts`).
+ *
+ * @typeParam Version - The string literal exver version number
+ */
 export declare class VersionInfo<Version extends string> {
     readonly options: VersionOptions<Version> & {
         satisfies: string[];

package/package/lib/version/VersionInfo.js

@@ -1,7 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VersionInfo = exports.IMPOSSIBLE = void 0;
-exports.IMPOSSIBLE = Symbol("IMPOSSIBLE");
+/**
+ * Sentinel value indicating that a migration in a given direction is not possible.
+ * Use this for `migrations.up` or `migrations.down` to prevent migration.
+ */
+exports.IMPOSSIBLE = Symbol('IMPOSSIBLE');
+/**
+ * Represents a single version of the service, including its release notes,
+ * migration scripts, and backwards-compatibility declarations.
+ *
+ * By convention, each version gets its own file (e.g. `versions/v1_0_0.ts`).
+ *
+ * @typeParam Version - The string literal exver version number
+ */
 class VersionInfo {
     constructor(options) {
         this.options = options;
@@ -28,27 +40,27 @@ class VersionInfo {
 exports.VersionInfo = VersionInfo;
 function __type_tests() {
     const version = VersionInfo.of({
-        version: "1.0.0:0",
-        releaseNotes: "",
+        version: '1.0.0:0',
+        releaseNotes: '',
         migrations: {},
     })
-        .satisfies("#other:1.0.0:0")
-        .satisfies("#other:2.0.0:0")
+        .satisfies('#other:1.0.0:0')
+        .satisfies('#other:2.0.0:0')
         // @ts-expect-error
-        .satisfies("#other:2.f.0:0");
+        .satisfies('#other:2.f.0:0');
     let a = version;
     // @ts-expect-error
     let b = version;
     VersionInfo.of({
         // @ts-expect-error
-        version: "test",
-        releaseNotes: "",
+        version: 'test',
+        releaseNotes: '',
         migrations: {},
     });
     VersionInfo.of({
         // @ts-expect-error
-        version: "test",
-        releaseNotes: "",
+        version: 'test',
+        releaseNotes: '',
         migrations: {},
     });
 }

package/package/lib/version/VersionInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"VersionInfo.js","sourceRoot":"","sources":["../../../../package/lib/version/VersionInfo.ts"],"names":[],"mappings":";;;AAGa,QAAA,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;AA0B9C,MAAa,WAAW;IAEtB,YACW,OAA0D;QAA1D,YAAO,GAAP,OAAO,CAAmD;QAF7D,aAAQ,GAAmB,IAAI,CAAA;IAGpC,CAAC;IACJ;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAyB,OAAgC;QAChE,OAAO,IAAI,WAAW,CAAU,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAA;IAChE,CAAC;IACD,0EAA0E;IAC1E,SAAS,CACP,OAA6B;QAE7B,OAAO,IAAI,WAAW,CAAC;YACrB,GAAG,IAAI,CAAC,OAAO;YACf,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;SAChD,CAAC,CAAA;IACJ,CAAC;CACF;AAxBD,kCAwBC;AAED,SAAS,YAAY;IACnB,MAAM,OAAO,GAA2B,WAAW,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,SAAS;QAClB,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,EAAE;KACf,CAAC;SACC,SAAS,CAAC,gBAAgB,CAAC;SAC3B,SAAS,CAAC,gBAAgB,CAAC;QAC5B,mBAAmB;SAClB,SAAS,CAAC,gBAAgB,CAAC,CAAA;IAE9B,IAAI,CAAC,GAA2B,OAAO,CAAA;IACvC,mBAAmB;IACnB,IAAI,CAAC,GAA2B,OAAO,CAAA;IAEvC,WAAW,CAAC,EAAE,CAAC;QACb,mBAAmB;QACnB,OAAO,EAAE,MAAM;QACf,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,EAAE;KACf,CAAC,CAAA;IACF,WAAW,CAAC,EAAE,CAAC;QACb,mBAAmB;QACnB,OAAO,EAAE,MAAgB;QACzB,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,EAAE;KACf,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"VersionInfo.js","sourceRoot":"","sources":["../../../../package/lib/version/VersionInfo.ts"],"names":[],"mappings":";;;AAGA;;;GAGG;AACU,QAAA,UAAU,GAAkB,MAAM,CAAC,YAAY,CAAC,CAAA;AAqC7D;;;;;;;GAOG;AACH,MAAa,WAAW;IAEtB,YACW,OAA0D;QAA1D,YAAO,GAAP,OAAO,CAAmD;QAF7D,aAAQ,GAAmB,IAAI,CAAA;IAGpC,CAAC;IACJ;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAyB,OAAgC;QAChE,OAAO,IAAI,WAAW,CAAU,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAA;IAChE,CAAC;IACD,0EAA0E;IAC1E,SAAS,CACP,OAA6B;QAE7B,OAAO,IAAI,WAAW,CAAC;YACrB,GAAG,IAAI,CAAC,OAAO;YACf,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;SAChD,CAAC,CAAA;IACJ,CAAC;CACF;AAxBD,kCAwBC;AAED,SAAS,YAAY;IACnB,MAAM,OAAO,GAA2B,WAAW,CAAC,EAAE,CAAC;QACrD,OAAO,EAAE,SAAS;QAClB,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,EAAE;KACf,CAAC;SACC,SAAS,CAAC,gBAAgB,CAAC;SAC3B,SAAS,CAAC,gBAAgB,CAAC;QAC5B,mBAAmB;SAClB,SAAS,CAAC,gBAAgB,CAAC,CAAA;IAE9B,IAAI,CAAC,GAA2B,OAAO,CAAA;IACvC,mBAAmB;IACnB,IAAI,CAAC,GAA2B,OAAO,CAAA;IAEvC,WAAW,CAAC,EAAE,CAAC;QACb,mBAAmB;QACnB,OAAO,EAAE,MAAM;QACf,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,EAAE;KACf,CAAC,CAAA;IACF,WAAW,CAAC,EAAE,CAAC;QACb,mBAAmB;QACnB,OAAO,EAAE,MAAgB;QACzB,YAAY,EAAE,EAAE;QAChB,UAAU,EAAE,EAAE;KACf,CAAC,CAAA;AACJ,CAAC"}

package/package/lib/version/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./VersionGraph";
-export * from "./VersionInfo";
+export * from './VersionGraph';
+export * from './VersionInfo';

package/package/package.json

@@ -0,0 +1,65 @@
+{
+    "name": "@start9labs/start-sdk",
+    "version": "0.4.0",
+    "description": "Software development kit to facilitate packaging services for StartOS",
+    "main": "./package/lib/index.js",
+    "types": "./package/lib/index.d.ts",
+    "sideEffects": true,
+    "typesVersion": {
+        ">=3.1": {
+            "*": [
+                "package/lib/*",
+                "base/lib/*"
+            ]
+        }
+    },
+    "scripts": {
+        "build": "tsc && tsc --project tsconfig-cjs.json && copyfiles package.json dist",
+        "test": "jest -c ./jest.config.js --coverage",
+        "buildOutput": "ts-node ./lib/test/makeOutput.ts && npx prettier --write \"**/*.ts\"",
+        "check": "tsc --noEmit",
+        "tsc": "tsc"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/Start9Labs/start-os.git"
+    },
+    "author": "Start9 Labs",
+    "license": "MIT",
+    "bugs": {
+        "url": "https://github.com/Start9Labs/start-os/issues"
+    },
+    "homepage": "https://github.com/Start9Labs/start-os#readme",
+    "dependencies": {
+        "@iarna/toml": "^3.0.0",
+        "@noble/curves": "^1.8.2",
+        "@noble/hashes": "^1.7.2",
+        "@types/ini": "^4.1.1",
+        "deep-equality-data-structures": "^2.0.0",
+        "fast-xml-parser": "^5.5.6",
+        "ini": "^5.0.0",
+        "isomorphic-fetch": "^3.0.0",
+        "mime": "^4.0.7",
+        "yaml": "^2.7.1",
+        "zod": "^4.3.6",
+        "zod-deep-partial": "^1.2.0"
+    },
+    "prettier": {
+        "trailingComma": "all",
+        "tabWidth": 2,
+        "semi": false,
+        "singleQuote": true
+    },
+    "devDependencies": {
+        "@types/jest": "^29.4.0",
+        "copyfiles": "^2.4.1",
+        "jest": "^29.4.3",
+        "peggy": "^3.0.2",
+        "prettier": "^3.2.5",
+        "ts-jest": "^29.0.5",
+        "ts-node": "^10.9.1",
+        "ts-pegjs": "^4.2.1",
+        "tsx": "^4.7.1",
+        "typescript": "^5.7.3"
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@start9labs/start-sdk",
-  "version": "0.4.0-beta.9",
+  "version": "0.4.0",
   "description": "Software development kit to facilitate packaging services for StartOS",
   "main": "./package/lib/index.js",
   "types": "./package/lib/index.d.ts",
@@ -22,35 +22,36 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Start9Labs/start-sdk.git"
+    "url": "git+https://github.com/Start9Labs/start-os.git"
   },
   "author": "Start9 Labs",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/Start9Labs/start-sdk/issues"
+    "url": "https://github.com/Start9Labs/start-os/issues"
   },
-  "homepage": "https://github.com/Start9Labs/start-sdk#readme",
+  "homepage": "https://github.com/Start9Labs/start-os#readme",
   "dependencies": {
-    "isomorphic-fetch": "^3.0.0",
-    "mime-types": "^3.0.1",
-    "ts-matches": "^6.3.0",
-    "yaml": "^2.7.1",
-    "deep-equality-data-structures": "^2.0.0",
-    "ini": "^5.0.0",
     "@iarna/toml": "^3.0.0",
     "@noble/curves": "^1.8.2",
-    "@noble/hashes": "^1.7.2"
+    "@noble/hashes": "^1.7.2",
+    "@types/ini": "^4.1.1",
+    "deep-equality-data-structures": "^2.0.0",
+    "fast-xml-parser": "^5.5.6",
+    "ini": "^5.0.0",
+    "isomorphic-fetch": "^3.0.0",
+    "mime": "^4.0.7",
+    "yaml": "^2.7.1",
+    "zod": "^4.3.6",
+    "zod-deep-partial": "^1.2.0"
   },
   "prettier": {
     "trailingComma": "all",
     "tabWidth": 2,
     "semi": false,
-    "singleQuote": false
+    "singleQuote": true
   },
   "devDependencies": {
-    "@iarna/toml": "^2.2.5",
     "@types/jest": "^29.4.0",
-    "@types/ini": "^4.1.1",
     "copyfiles": "^2.4.1",
     "jest": "^29.4.3",
     "peggy": "^3.0.2",

package/base/lib/osBindings/ActionRequest.d.ts

@@ -1,13 +0,0 @@
-import type { ActionId } from "./ActionId";
-import type { ActionRequestInput } from "./ActionRequestInput";
-import type { ActionRequestTrigger } from "./ActionRequestTrigger";
-import type { ActionSeverity } from "./ActionSeverity";
-import type { PackageId } from "./PackageId";
-export type ActionRequest = {
-    packageId: PackageId;
-    actionId: ActionId;
-    severity: ActionSeverity;
-    reason?: string;
-    when?: ActionRequestTrigger;
-    input?: ActionRequestInput;
-};

package/base/lib/osBindings/ActionRequest.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ActionRequest.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/ActionRequest.ts"],"names":[],"mappings":""}

package/base/lib/osBindings/ActionRequestCondition.d.ts

@@ -1 +0,0 @@
-export type ActionRequestCondition = "input-not-matches";

package/base/lib/osBindings/ActionRequestCondition.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ActionRequestCondition.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/ActionRequestCondition.ts"],"names":[],"mappings":";AAAA,4GAA4G"}

package/base/lib/osBindings/ActionRequestEntry.d.ts

@@ -1,5 +0,0 @@
-import type { ActionRequest } from "./ActionRequest";
-export type ActionRequestEntry = {
-    request: ActionRequest;
-    active: boolean;
-};

package/base/lib/osBindings/ActionRequestEntry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ActionRequestEntry.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/ActionRequestEntry.ts"],"names":[],"mappings":""}

package/base/lib/osBindings/ActionRequestInput.d.ts

@@ -1,4 +0,0 @@
-export type ActionRequestInput = {
-    kind: "partial";
-    value: Record<string, unknown>;
-};

package/base/lib/osBindings/ActionRequestInput.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ActionRequestInput.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/ActionRequestInput.ts"],"names":[],"mappings":";AAAA,4GAA4G"}

package/base/lib/osBindings/ActionRequestTrigger.d.ts

@@ -1,5 +0,0 @@
-import type { ActionRequestCondition } from "./ActionRequestCondition";
-export type ActionRequestTrigger = {
-    once: boolean;
-    condition: ActionRequestCondition;
-};

package/base/lib/osBindings/ActionRequestTrigger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ActionRequestTrigger.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/ActionRequestTrigger.ts"],"names":[],"mappings":""}

package/base/lib/osBindings/ActionSeverity.d.ts

@@ -1 +0,0 @@
-export type ActionSeverity = "critical" | "important";

package/base/lib/osBindings/ActionSeverity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ActionSeverity.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/ActionSeverity.ts"],"names":[],"mappings":";AAAA,4GAA4G"}

package/base/lib/osBindings/BindingSetPublicParams.d.ts

@@ -1,4 +0,0 @@
-export type BindingSetPublicParams = {
-    internalPort: number;
-    public: boolean | null;
-};

package/base/lib/osBindings/BindingSetPublicParams.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"BindingSetPublicParams.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/BindingSetPublicParams.ts"],"names":[],"mappings":";AAAA,4GAA4G"}

package/base/lib/osBindings/ClearActionRequestsParams.js

@@ -1,4 +0,0 @@
-"use strict";
-// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=ClearActionRequestsParams.js.map

package/base/lib/osBindings/ClearActionRequestsParams.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ClearActionRequestsParams.js","sourceRoot":"","sources":["../../../../base/lib/osBindings/ClearActionRequestsParams.ts"],"names":[],"mappings":";AAAA,4GAA4G"}

package/base/lib/osBindings/DependencyKind.d.ts

@@ -1 +0,0 @@
-export type DependencyKind = "exists" | "running";