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

package/package/lib/util/fileHelper.js

@@ -34,34 +34,41 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileHelper = void 0;
-const YAML = __importStar(require("yaml"));
 const TOML = __importStar(require("@iarna/toml"));
+const fast_xml_parser_1 = require("fast-xml-parser");
 const INI = __importStar(require("ini"));
 const fs = __importStar(require("node:fs/promises"));
+const YAML = __importStar(require("yaml"));
+const zod_1 = require("zod");
 const util_1 = require("../../../base/lib/util");
+const Watchable_1 = require("../../../base/lib/util/Watchable");
 const previousPath = /(.+?)\/([^/]*)$/;
 const exists = (path) => fs.access(path).then(() => true, () => false);
 async function onCreated(path) {
-    if (path === "/")
+    if (path === '/')
         return;
-    if (!path.startsWith("/"))
+    if (!path.startsWith('/'))
         path = `${process.cwd()}/${path}`;
     if (await exists(path)) {
         return;
     }
-    const split = path.split("/");
+    const split = path.split('/');
     const filename = split.pop();
-    const parent = split.join("/");
+    const parent = split.join('/');
     await onCreated(parent);
     const ctrl = new AbortController();
     const watch = fs.watch(parent, { persistent: false, signal: ctrl.signal });
+    if (await exists(path)) {
+        ctrl.abort();
+        return;
+    }
     if (await fs.access(path).then(() => true, () => false)) {
-        ctrl.abort("finished");
+        ctrl.abort();
         return;
     }
     for await (let event of watch) {
         if (event.filename === filename) {
-            ctrl.abort("finished");
+            ctrl.abort('finished');
             return;
         }
     }
@@ -71,8 +78,10 @@ function fileMerge(...args) {
     for (const arg of args) {
         if (res === arg)
             continue;
-        else if (typeof res === "object" &&
-            typeof arg === "object" &&
+        else if (res &&
+            arg &&
+            typeof res === 'object' &&
+            typeof arg === 'object' &&
             !Array.isArray(res) &&
             !Array.isArray(arg)) {
             for (const key of Object.keys(arg)) {
@@ -84,6 +93,26 @@ function fileMerge(...args) {
     }
     return res;
 }
+function filterUndefined(a) {
+    if (a && typeof a === 'object') {
+        if (Array.isArray(a)) {
+            return a.map(filterUndefined);
+        }
+        return Object.entries(a).reduce((acc, [k, v]) => {
+            if (v !== undefined) {
+                acc[k] = filterUndefined(v);
+            }
+            return acc;
+        }, {});
+    }
+    return a;
+}
+function toPath(path) {
+    if (typeof path === 'string') {
+        return path;
+    }
+    return path.base.subpath(path.subpath);
+}
 /**
  * @description Use this class to read/write an underlying configuration file belonging to the upstream service.
  *
@@ -150,7 +179,7 @@ class FileHelper {
         if (!(await exists(this.path))) {
             return null;
         }
-        return await fs.readFile(this.path).then((data) => data.toString("utf-8"));
+        return await fs.readFile(this.path).then((data) => data.toString('utf-8'));
     }
     async readFile() {
         const raw = await this.readFileRaw();
@@ -162,89 +191,107 @@ class FileHelper {
     /**
      * Reads the file from disk and converts it to structured data.
      */
-    async readOnce() {
+    async readOnce(map) {
         const data = await this.readFile();
         if (!data)
             return null;
-        return this.validate(data);
-    }
-    async readConst(effects) {
-        const watch = this.readWatch(effects);
-        const res = await watch.next();
-        if (effects.constRetry) {
-            if (!this.consts.includes(effects.constRetry))
-                this.consts.push(effects.constRetry);
-            watch.next().then(() => {
-                this.consts = this.consts.filter((a) => a === effects.constRetry);
-                effects.constRetry && effects.constRetry();
-            });
-        }
-        return res.value;
+        return map(this.validate(data));
     }
-    async *readWatch(effects) {
-        let res;
-        while (effects.isInContext) {
-            if (await exists(this.path)) {
-                const ctrl = new AbortController();
-                const watch = fs.watch(this.path, {
-                    persistent: false,
-                    signal: ctrl.signal,
-                });
-                res = await this.readOnce();
-                const listen = Promise.resolve()
-                    .then(async () => {
-                    for await (const _ of watch) {
-                        ctrl.abort("finished");
-                        return null;
-                    }
-                })
-                    .catch((e) => console.error((0, util_1.asError)(e)));
-                yield res;
-                await listen;
+    createFileWatchable(effects, map, eq) {
+        const doRead = async () => {
+            const data = await this.readFile();
+            if (!data)
+                return null;
+            return this.validate(data);
+        };
+        const filePath = this.path;
+        const fileHelper = this;
+        const wrappedMap = (raw) => {
+            if (raw === null)
+                return null;
+            return map(raw);
+        };
+        return new (class extends Watchable_1.Watchable {
+            constructor() {
+                super(...arguments);
+                this.label = 'FileHelper';
             }
-            else {
-                yield null;
-                await onCreated(this.path).catch((e) => console.error((0, util_1.asError)(e)));
+            async fetch() {
+                return doRead();
             }
-        }
-        return null;
-    }
-    readOnChange(effects, callback) {
-        ;
-        (async () => {
-            for await (const value of this.readWatch(effects)) {
-                try {
-                    await callback(value);
-                }
-                catch (e) {
-                    console.error("callback function threw an error @ FileHelper.read.onChange", e);
+            async *produce(abort) {
+                while (this.effects.isInContext && !abort.aborted) {
+                    if (await exists(filePath)) {
+                        const ctrl = new AbortController();
+                        abort.addEventListener('abort', () => ctrl.abort());
+                        const watch = fs.watch(filePath, {
+                            persistent: false,
+                            signal: ctrl.signal,
+                        });
+                        yield await doRead();
+                        await Promise.resolve()
+                            .then(async () => {
+                            for await (const _ of watch) {
+                                ctrl.abort();
+                                return null;
+                            }
+                        })
+                            .catch((e) => console.error((0, util_1.asError)(e)));
+                    }
+                    else {
+                        yield null;
+                        await onCreated(filePath).catch((e) => console.error((0, util_1.asError)(e)));
+                    }
                 }
             }
-        })()
-            .catch((e) => callback(null, e))
-            .catch((e) => console.error("callback function threw an error @ FileHelper.read.onChange", e));
+            onConstRegistered(value) {
+                if (!this.effects.constRetry)
+                    return;
+                const record = [
+                    this.effects.constRetry,
+                    value,
+                    wrappedMap,
+                    eq,
+                ];
+                fileHelper.consts.push(record);
+                return () => {
+                    fileHelper.consts = fileHelper.consts.filter((r) => r !== record);
+                };
+            }
+        })(effects, { map: wrappedMap, eq });
     }
-    get read() {
+    read(map, eq) {
+        map = map ?? ((a) => a);
+        eq = eq ?? util_1.deepEqual;
         return {
-            once: () => this.readOnce(),
-            const: (effects) => this.readConst(effects),
-            watch: (effects) => this.readWatch(effects),
-            onChange: (effects, callback) => this.readOnChange(effects, callback),
+            once: () => this.readOnce(map),
+            const: (effects) => this.createFileWatchable(effects, map, eq).const(),
+            watch: (effects, abort) => this.createFileWatchable(effects, map, eq).watch(abort),
+            onChange: (effects, callback) => this.createFileWatchable(effects, map, eq).onChange(callback),
+            waitFor: (effects, pred) => this.createFileWatchable(effects, map, eq).waitFor(pred),
         };
     }
     /**
      * Accepts full structured data and overwrites the existing file on disk if it exists.
      */
-    async write(effects, data) {
-        await this.writeFile(this.validate(data));
-        if (effects.constRetry && this.consts.includes(effects.constRetry))
-            throw new Error(`Canceled: write after const: ${this.path}`);
+    async write(effects, data, options = {}) {
+        const newData = this.validate(data);
+        await this.writeFile(newData);
+        if (!options.allowWriteAfterConst && effects.constRetry) {
+            const records = this.consts.filter(([c]) => c === effects.constRetry);
+            for (const record of records) {
+                const [_, prev, map, eq] = record;
+                if (!eq(prev, map(newData))) {
+                    throw new Error(`Canceled: write after const: ${this.path}`);
+                }
+            }
+        }
         return null;
     }
     /**
      * Accepts partial structured data and performs a merge with the existing file on disk.
      */
-    async merge(effects, data) {
+    async merge(effects, data, options = {}) {
         const fileDataRaw = await this.readFileRaw();
         let fileData = fileDataRaw === null ? null : this.readData(fileDataRaw);
         try {
@@ -254,13 +301,15 @@ class FileHelper {
         const mergeData = this.validate(fileMerge({}, fileData, data));
         const toWrite = this.writeData(mergeData);
         if (toWrite !== fileDataRaw) {
-            this.writeFile(mergeData);
-            if (effects.constRetry && this.consts.includes(effects.constRetry)) {
-                const diff = (0, util_1.partialDiff)(fileData, mergeData);
-                if (!diff) {
-                    return null;
+            await this.writeFile(mergeData);
+            if (!options.allowWriteAfterConst && effects.constRetry) {
+                const records = this.consts.filter(([c]) => c === effects.constRetry);
+                for (const record of records) {
+                    const [_, prev, map, eq] = record;
+                    if (!eq(prev, map(mergeData))) {
+                        throw new Error(`Canceled: write after const: ${this.path}`);
+                    }
                 }
-                throw new Error(`Canceled: write after const: ${this.path}`);
             }
         }
         return null;
@@ -270,7 +319,7 @@ class FileHelper {
      * Like one behavior of another dependency or something similar.
      */
     withPath(path) {
-        return new FileHelper(path, this.writeData, this.readData, this.validate);
+        return new FileHelper(toPath(path), this.writeData, this.readData, this.validate);
     }
     /**
      * Create a File Helper for an arbitrary file type.
@@ -278,37 +327,52 @@ class FileHelper {
      * Provide custom functions for translating data to/from the file format.
      */
     static raw(path, toFile, fromFile, validate) {
-        return new FileHelper(path, toFile, fromFile, validate);
+        return new FileHelper(toPath(path), toFile, fromFile, validate);
     }
-    /**
-     * Create a File Helper for a .json file.
-     */
-    static json(path, shape) {
-        return new FileHelper(path, (inData) => JSON.stringify(inData, null, 2), (inString) => JSON.parse(inString), (data) => shape.unsafeCast(data));
+    static rawTransformed(path, toFile, fromFile, validate, transformers) {
+        return FileHelper.raw(path, (inData) => {
+            if (transformers) {
+                return toFile(transformers.onWrite(inData));
+            }
+            return toFile(inData);
+        }, (fileData) => {
+            if (transformers) {
+                return transformers.onRead(fromFile(fileData));
+            }
+            return fromFile(fileData);
+        }, validate);
     }
-    /**
-     * Create a File Helper for a .toml file
-     */
-    static toml(path, shape) {
-        return new FileHelper(path, (inData) => TOML.stringify(inData), (inString) => TOML.parse(inString), (data) => shape.unsafeCast(data));
+    static string(path, shape, transformers) {
+        return FileHelper.rawTransformed(path, (inData) => inData, (inString) => inString, (data) => (shape || zod_1.z.string()).parse(data), transformers);
     }
-    /**
-     * Create a File Helper for a .yaml file
-     */
-    static yaml(path, shape) {
-        return new FileHelper(path, (inData) => YAML.stringify(inData, null, 2), (inString) => YAML.parse(inString), (data) => shape.unsafeCast(data));
+    static json(path, shape, transformers) {
+        return FileHelper.rawTransformed(path, (inData) => JSON.stringify(inData, null, 2), (inString) => JSON.parse(inString), (data) => shape.parse(data), transformers);
+    }
+    static yaml(path, shape, transformers) {
+        return FileHelper.rawTransformed(path, (inData) => YAML.stringify(inData, null, 2), (inString) => YAML.parse(inString), (data) => shape.parse(data), transformers);
     }
-    static ini(path, shape, options) {
-        return new FileHelper(path, (inData) => INI.stringify(inData, options), (inString) => INI.parse(inString, options), (data) => shape.unsafeCast(data));
+    static toml(path, shape, transformers) {
+        return FileHelper.rawTransformed(path, (inData) => TOML.stringify(inData), (inString) => TOML.parse(inString), (data) => shape.parse(data), transformers);
     }
-    static env(path, shape) {
-        return new FileHelper(path, (inData) => Object.entries(inData)
+    static ini(path, shape, options, transformers) {
+        return FileHelper.rawTransformed(path, (inData) => INI.stringify(filterUndefined(inData), options), (inString) => INI.parse(inString, options), (data) => shape.parse(data), transformers);
+    }
+    static env(path, shape, transformers) {
+        return FileHelper.rawTransformed(path, (inData) => Object.entries(inData)
             .map(([k, v]) => `${k}=${v}`)
-            .join("\n"), (inString) => Object.fromEntries(inString
-            .split("\n")
+            .join('\n'), (inString) => Object.fromEntries(inString
+            .split('\n')
             .map((line) => line.trim())
-            .filter((line) => !line.startsWith("#") && line.includes("="))
-            .map((line) => line.split("=", 2))), (data) => shape.unsafeCast(data));
+            .filter((line) => !line.startsWith('#') && line.includes('='))
+            .map((line) => {
+            const pos = line.indexOf('=');
+            return [line.slice(0, pos), line.slice(pos + 1)];
+        })), (data) => shape.parse(data), transformers);
+    }
+    static xml(path, shape, options, transformers) {
+        const parser = new fast_xml_parser_1.XMLParser(options?.parser);
+        const builder = new fast_xml_parser_1.XMLBuilder(options?.builder);
+        return FileHelper.rawTransformed(path, (inData) => builder.build(inData), (inString) => parser.parse(inString), (data) => shape.parse(data), transformers);
     }
 }
 exports.FileHelper = FileHelper;

package/package/lib/util/fileHelper.js.map

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

package/package/lib/util/index.d.ts

@@ -1,4 +1,3 @@
-export * from "../../../base/lib/util";
-export { GetSslCertificate } from "./GetSslCertificate";
-export { hostnameInfoToAddress } from "../../../base/lib/util/Hostname";
-export { Drop } from "./Drop";
+export * from '../../../base/lib/util';
+export { Drop } from '../../../base/lib/util/Drop';
+export { Volume, Volumes } from './Volume';

package/package/lib/util/index.js

@@ -14,12 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Drop = exports.hostnameInfoToAddress = exports.GetSslCertificate = void 0;
+exports.Volume = exports.Drop = void 0;
 __exportStar(require("../../../base/lib/util"), exports);
-var GetSslCertificate_1 = require("./GetSslCertificate");
-Object.defineProperty(exports, "GetSslCertificate", { enumerable: true, get: function () { return GetSslCertificate_1.GetSslCertificate; } });
-var Hostname_1 = require("../../../base/lib/util/Hostname");
-Object.defineProperty(exports, "hostnameInfoToAddress", { enumerable: true, get: function () { return Hostname_1.hostnameInfoToAddress; } });
-var Drop_1 = require("./Drop");
+var Drop_1 = require("../../../base/lib/util/Drop");
 Object.defineProperty(exports, "Drop", { enumerable: true, get: function () { return Drop_1.Drop; } });
+var Volume_1 = require("./Volume");
+Object.defineProperty(exports, "Volume", { enumerable: true, get: function () { return Volume_1.Volume; } });
 //# sourceMappingURL=index.js.map

package/package/lib/util/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../package/lib/util/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,yDAAsC;AACtC,yDAAuD;AAA9C,sHAAA,iBAAiB,OAAA;AAE1B,4DAAuE;AAA9D,iHAAA,qBAAqB,OAAA;AAC9B,+BAA6B;AAApB,4FAAA,IAAI,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../package/lib/util/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,yDAAsC;AAEtC,oDAAkD;AAAzC,4FAAA,IAAI,OAAA;AACb,mCAA0C;AAAjC,gGAAA,MAAM,OAAA"}

package/package/lib/version/VersionGraph.d.ts

@@ -1,9 +1,45 @@
-import { ExtendedVersion, VersionRange } from "../../../base/lib/exver";
-import * as T from "../../../base/lib/types";
-import { VersionInfo } from "./VersionInfo";
-export declare class VersionGraph<CurrentVersion extends string> {
+import { ExtendedVersion, VersionRange } from '../../../base/lib/exver';
+import * as T from '../../../base/lib/types';
+import { InitScript, UninitScript } from '../../../base/lib/inits';
+import { VersionInfo } from './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
+ */
+export declare function getDataVersion(effects: T.Effects): Promise<ExtendedVersion | VersionRange | null>;
+/**
+ * Persist a data version to the effects system.
+ * @param effects - The effects context
+ * @param version - The version to set, or null to clear it
+ */
+export declare function setDataVersion(effects: T.Effects, version: ExtendedVersion | VersionRange | null): Promise<null>;
+/**
+ * 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
+ */
+export declare function overlaps(a: ExtendedVersion | VersionRange, b: ExtendedVersion | VersionRange): boolean;
+/**
+ * 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
+ */
+export declare class VersionGraph<CurrentVersion extends string> implements InitScript, UninitScript {
     readonly current: VersionInfo<CurrentVersion>;
+    protected initFn: (effects: T.Effects) => Promise<void>;
+    protected uninitFn: (effects: T.Effects, target: VersionRange | ExtendedVersion | null) => Promise<void>;
     private readonly graph;
+    /** Dump the version graph as a human-readable string for debugging */
+    dump(): string;
     private constructor();
     currentVersion: () => ExtendedVersion;
     /**
@@ -11,13 +47,50 @@ export declare class VersionGraph<CurrentVersion extends string> {
      *
      * ** The current version must be the FIRST argument. **
      */
-    static of<CurrentVersion extends string, OtherVersions extends Array<VersionInfo<any>>>(currentVersion: VersionInfo<CurrentVersion>, ...other: EnsureUniqueId<OtherVersions, OtherVersions, CurrentVersion>): VersionGraph<CurrentVersion>;
+    static of<CurrentVersion extends string, OtherVersions extends Array<VersionInfo<any>>>(options: {
+        current: VersionInfo<CurrentVersion>;
+        other: OtherVersions;
+    }): VersionGraph<CurrentVersion>;
+    /**
+     * 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
+     */
     migrate({ effects, from, to, }: {
         effects: T.Effects;
-        from: ExtendedVersion;
-        to: ExtendedVersion;
-    }): Promise<void>;
+        from: ExtendedVersion | VersionRange;
+        to: ExtendedVersion | VersionRange;
+    }): Promise<ExtendedVersion | 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.
+     */
     canMigrateFrom: () => VersionRange;
+    /**
+     * Compute the version range that the current version can migrate to.
+     * Uses forward breadth-first search from the current version vertex.
+     */
     canMigrateTo: () => VersionRange;
+    /**
+     * 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
+     */
+    init(effects: T.Effects): Promise<void>;
+    /**
+     * 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
+     */
+    uninit(effects: T.Effects, target: VersionRange | ExtendedVersion | null): Promise<void>;
 }
 export type EnsureUniqueId<A, B = A, OtherVersions = never> = B extends [] ? A : B extends [VersionInfo<infer Version>, ...infer Rest] ? (Version extends OtherVersions ? "One or more versions are not unique"[] : EnsureUniqueId<A, Rest, Version | OtherVersions>) : "There exists a migration that is not a Migration"[];