@start9labs/start-sdk 0.3.6-alpha8 → 0.3.6-alpha9

package/package/lib/util/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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.hostnameInfoToAddress = exports.GetSslCertificate = 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; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,23 @@
+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> {
+    readonly current: VersionInfo<CurrentVersion>;
+    private readonly graph;
+    private constructor();
+    currentVersion: () => ExtendedVersion;
+    /**
+     * Each exported `VersionInfo.of()` should be imported and provided as an argument to this function.
+     *
+     * ** 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>;
+    migrate({ effects, from, to, }: {
+        effects: T.Effects;
+        from: ExtendedVersion;
+        to: ExtendedVersion;
+    }): Promise<void>;
+    canMigrateFrom: () => VersionRange;
+    canMigrateTo: () => VersionRange;
+}
+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"[];

package/package/lib/version/VersionGraph.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionGraph = void 0;
+const exver_1 = require("../../../base/lib/exver");
+const util_1 = require("../util");
+const VersionInfo_1 = require("./VersionInfo");
+class VersionGraph {
+    constructor(current, versions) {
+        this.current = current;
+        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
+            ? x.metadata
+            : exver_1.VersionRange.anchor("=", x.metadata)), exver_1.VersionRange.none()));
+        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
+            ? x.metadata
+            : exver_1.VersionRange.anchor("=", x.metadata)), exver_1.VersionRange.none()));
+        this.graph = (0, util_1.once)(() => {
+            const graph = new util_1.Graph();
+            const flavorMap = {};
+            for (let version of [current, ...versions]) {
+                const v = exver_1.ExtendedVersion.parse(version.options.version);
+                const vertex = graph.addVertex(v, [], []);
+                const flavor = v.flavor || "";
+                if (!flavorMap[flavor]) {
+                    flavorMap[flavor] = [];
+                }
+                flavorMap[flavor].push([v, version, vertex]);
+            }
+            for (let flavor in flavorMap) {
+                flavorMap[flavor].sort((a, b) => a[0].compareForSort(b[0]));
+                let prev = undefined;
+                for (let [v, version, vertex] of flavorMap[flavor]) {
+                    if (version.options.migrations.up !== VersionInfo_1.IMPOSSIBLE) {
+                        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));
+                        }
+                        else {
+                            range = exver_1.VersionRange.anchor("<", v);
+                        }
+                        const vRange = graph.addVertex(range, [], []);
+                        graph.addEdge(version.options.migrations.up, vRange, vertex);
+                    }
+                    if (version.options.migrations.down !== VersionInfo_1.IMPOSSIBLE) {
+                        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));
+                        }
+                        else {
+                            range = exver_1.VersionRange.anchor("<", v);
+                        }
+                        const vRange = graph.addVertex(range, [], []);
+                        graph.addEdge(version.options.migrations.down, vertex, vRange);
+                    }
+                    if (version.options.migrations.other) {
+                        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);
+                            }
+                        }
+                    }
+                }
+            }
+            return graph;
+        });
+    }
+    /**
+     * Each exported `VersionInfo.of()` should be imported and provided as an argument to this function.
+     *
+     * ** The current version must be the FIRST argument. **
+     */
+    static of(currentVersion, ...other) {
+        return new VersionGraph(currentVersion, other);
+    }
+    async migrate({ effects, from, to, }) {
+        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)));
+            if (path) {
+                for (let edge of path) {
+                    if (edge.metadata) {
+                        await edge.metadata({ effects });
+                    }
+                    await effects.setDataVersion({ version: edge.to.metadata.toString() });
+                }
+                return;
+            }
+        }
+        throw new Error();
+    }
+}
+exports.VersionGraph = VersionGraph;
+//# sourceMappingURL=VersionGraph.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,49 @@
+import { ValidateExVer } from "../../../base/lib/exver";
+import * as T from "../../../base/lib/types";
+export declare const IMPOSSIBLE: unique symbol;
+export type VersionOptions<Version extends string> = {
+    /** The exver-compliant version number */
+    version: Version & ValidateExVer<Version>;
+    /** The release notes for this version */
+    releaseNotes: string;
+    /** Data migrations for this version */
+    migrations: {
+        /**
+         * A migration from the previous version. Leave empty to indicate no migration is necessary.
+         * Set to `IMPOSSIBLE` to indicate migrating from the previous version is not possible.
+         */
+        up?: ((opts: {
+            effects: T.Effects;
+        }) => Promise<void>) | typeof IMPOSSIBLE;
+        /**
+         * A migration to the previous version. Leave blank to indicate no migration is necessary.
+         * Set to `IMPOSSIBLE` to indicate downgrades are prohibited
+         */
+        down?: ((opts: {
+            effects: T.Effects;
+        }) => Promise<void>) | typeof IMPOSSIBLE;
+        /**
+         * Additional migrations, such as fast-forward migrations, or migrations from other flavors.
+         */
+        other?: Record<string, (opts: {
+            effects: T.Effects;
+        }) => Promise<void>>;
+    };
+};
+export declare class VersionInfo<Version extends string> {
+    readonly options: VersionOptions<Version> & {
+        satisfies: string[];
+    };
+    private _version;
+    private constructor();
+    /**
+     * @description Use this function to define a new version of the service. By convention, each version should receive its own file.
+     * @property {string} version
+     * @property {string} releaseNotes
+     * @property {object} migrations
+     * @returns A VersionInfo class instance that is exported, then imported into versions/index.ts.
+     */
+    static of<Version extends string>(options: VersionOptions<Version>): VersionInfo<Version>;
+    /** Specify a version that this version is 100% backwards compatible to */
+    satisfies<V extends string>(version: V & ValidateExVer<V>): VersionInfo<Version>;
+}

package/package/lib/version/VersionInfo.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionInfo = exports.IMPOSSIBLE = void 0;
+exports.IMPOSSIBLE = Symbol("IMPOSSIBLE");
+class VersionInfo {
+    constructor(options) {
+        this.options = options;
+        this._version = null;
+    }
+    /**
+     * @description Use this function to define a new version of the service. By convention, each version should receive its own file.
+     * @property {string} version
+     * @property {string} releaseNotes
+     * @property {object} migrations
+     * @returns A VersionInfo class instance that is exported, then imported into versions/index.ts.
+     */
+    static of(options) {
+        return new VersionInfo({ ...options, satisfies: [] });
+    }
+    /** Specify a version that this version is 100% backwards compatible to */
+    satisfies(version) {
+        return new VersionInfo({
+            ...this.options,
+            satisfies: [...this.options.satisfies, version],
+        });
+    }
+}
+exports.VersionInfo = VersionInfo;
+function __type_tests() {
+    const version = VersionInfo.of({
+        version: "1.0.0:0",
+        releaseNotes: "",
+        migrations: {},
+    })
+        .satisfies("#other:1.0.0:0")
+        .satisfies("#other:2.0.0:0")
+        // @ts-expect-error
+        .satisfies("#other:2.f.0:0");
+    let a = version;
+    // @ts-expect-error
+    let b = version;
+    VersionInfo.of({
+        // @ts-expect-error
+        version: "test",
+        releaseNotes: "",
+        migrations: {},
+    });
+    VersionInfo.of({
+        // @ts-expect-error
+        version: "test",
+        releaseNotes: "",
+        migrations: {},
+    });
+}
+//# sourceMappingURL=VersionInfo.js.map

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

@@ -0,0 +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"}

package/package/lib/version/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../package/lib/version/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA8B;AAC9B,gDAA6B"}

package/package/scripts/oldSpecToBuilder.js

@@ -0,0 +1,343 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.oldSpecToBuilder = exports.camelCase = void 0;
+const fs = __importStar(require("fs"));
+// https://stackoverflow.com/questions/2970525/converting-any-string-into-camel-case
+function camelCase(value) {
+    return value
+        .replace(/([\(\)\[\]])/g, "")
+        .replace(/^([A-Z])|[\s-_](\w)/g, function (match, p1, p2, offset) {
+        if (p2)
+            return p2.toUpperCase();
+        return p1.toLowerCase();
+    });
+}
+exports.camelCase = camelCase;
+async function oldSpecToBuilder(file, inputData, options) {
+    await fs.writeFile(file, await makeFileContentFromOld(inputData, options), (err) => console.error(err));
+}
+exports.oldSpecToBuilder = oldSpecToBuilder;
+function isString(x) {
+    return typeof x === "string";
+}
+async function makeFileContentFromOld(inputData, { StartSdk = "start-sdk", nested = true } = {}) {
+    const outputLines = [];
+    outputLines.push(`
+import { sdk } from "${StartSdk}"
+const {InputSpec, List, Value, Variants} = sdk
+`);
+    const data = await inputData;
+    const namedConsts = new Set(["InputSpec", "Value", "List"]);
+    const inputSpecName = newConst("inputSpecSpec", convertInputSpec(data));
+    const inputSpecMatcherName = newConst("matchInputSpecSpec", `${inputSpecName}.validator`);
+    outputLines.push(`export type InputSpecSpec = typeof ${inputSpecMatcherName}._TYPE;`);
+    return outputLines.join("\n");
+    function newConst(key, data, type) {
+        const variableName = getNextConstName(camelCase(key));
+        outputLines.push(`export const ${variableName}${!type ? "" : `: ${type}`} = ${data};`);
+        return variableName;
+    }
+    function maybeNewConst(key, data) {
+        if (nested)
+            return data;
+        return newConst(key, data);
+    }
+    function convertInputSpecInner(data) {
+        let answer = "{";
+        for (const [key, value] of Object.entries(data)) {
+            const variableName = maybeNewConst(key, convertValueSpec(value));
+            answer += `${JSON.stringify(key)}: ${variableName},`;
+        }
+        return `${answer}}`;
+    }
+    function convertInputSpec(data) {
+        return `InputSpec.of(${convertInputSpecInner(data)})`;
+    }
+    function convertValueSpec(value) {
+        var _a, _b, _c;
+        switch (value.type) {
+            case "string": {
+                if (value.textarea) {
+                    return `${rangeToTodoComment(value === null || value === void 0 ? void 0 : value.range)}Value.textarea(${JSON.stringify({
+                        name: value.name || null,
+                        description: value.description || null,
+                        warning: value.warning || null,
+                        required: !(value.nullable || false),
+                        placeholder: value.placeholder || null,
+                        maxLength: null,
+                        minLength: null,
+                    }, null, 2)})`;
+                }
+                return `${rangeToTodoComment(value === null || value === void 0 ? void 0 : value.range)}Value.text(${JSON.stringify({
+                    name: value.name || null,
+                    // prettier-ignore
+                    required: (value.default != null ? { default: value.default } :
+                        value.nullable === false ? { default: null } :
+                            !value.nullable),
+                    description: value.description || null,
+                    warning: value.warning || null,
+                    masked: value.masked || false,
+                    placeholder: value.placeholder || null,
+                    inputmode: "text",
+                    patterns: value.pattern
+                        ? [
+                            {
+                                regex: value.pattern,
+                                description: value["pattern-description"],
+                            },
+                        ]
+                        : [],
+                    minLength: null,
+                    maxLength: null,
+                }, null, 2)})`;
+            }
+            case "number": {
+                return `${rangeToTodoComment(value === null || value === void 0 ? void 0 : value.range)}Value.number(${JSON.stringify({
+                    name: value.name || null,
+                    description: value.description || null,
+                    warning: value.warning || null,
+                    // prettier-ignore
+                    required: (value.default != null ? { default: value.default } :
+                        value.nullable === false ? { default: null } :
+                            !value.nullable),
+                    min: null,
+                    max: null,
+                    step: null,
+                    integer: value.integral || false,
+                    units: value.units || null,
+                    placeholder: value.placeholder || null,
+                }, null, 2)})`;
+            }
+            case "boolean": {
+                return `Value.toggle(${JSON.stringify({
+                    name: value.name || null,
+                    default: value.default || false,
+                    description: value.description || null,
+                    warning: value.warning || null,
+                }, null, 2)})`;
+            }
+            case "enum": {
+                const allValueNames = new Set([
+                    ...((value === null || value === void 0 ? void 0 : value["values"]) || []),
+                    ...Object.keys((value === null || value === void 0 ? void 0 : value["value-names"]) || {}),
+                ]);
+                const values = Object.fromEntries(Array.from(allValueNames)
+                    .filter(isString)
+                    .map((key) => { var _a, _b; return [key, ((_b = (_a = value === null || value === void 0 ? void 0 : value.spec) === null || _a === void 0 ? void 0 : _a["value-names"]) === null || _b === void 0 ? void 0 : _b[key]) || key]; }));
+                return `Value.select(${JSON.stringify({
+                    name: value.name || null,
+                    description: value.description || null,
+                    warning: value.warning || null,
+                    // prettier-ignore
+                    required: (value.default != null ? { default: value.default } :
+                        value.nullable === false ? { default: null } :
+                            !value.nullable),
+                    values,
+                }, null, 2)} as const)`;
+            }
+            case "object": {
+                const specName = maybeNewConst(value.name + "_spec", convertInputSpec(value.spec));
+                return `Value.object({
+        name: ${JSON.stringify(value.name || null)},
+        description: ${JSON.stringify(value.description || null)},
+      }, ${specName})`;
+            }
+            case "union": {
+                const variants = maybeNewConst(value.name + "_variants", convertVariants(value.variants, value.tag["variant-names"] || {}));
+                return `Value.union({
+        name: ${JSON.stringify(value.name || null)},
+        description: ${JSON.stringify(value.tag.description || null)},
+        warning: ${JSON.stringify(value.tag.warning || null)},
+        
+        // prettier-ignore
+        required: ${JSON.stringify(
+                // prettier-ignore
+                value.default != null ? { default: value.default } :
+                    value.nullable === false ? { default: null } :
+                        !value.nullable)},
+      }, ${variants})`;
+            }
+            case "list": {
+                if (value.subtype === "enum") {
+                    const allValueNames = new Set([
+                        ...(((_a = value === null || value === void 0 ? void 0 : value.spec) === null || _a === void 0 ? void 0 : _a["values"]) || []),
+                        ...Object.keys(((_b = value === null || value === void 0 ? void 0 : value.spec) === null || _b === void 0 ? void 0 : _b["value-names"]) || {}),
+                    ]);
+                    const values = Object.fromEntries(Array.from(allValueNames)
+                        .filter(isString)
+                        .map((key) => {
+                        var _a, _b, _c;
+                        return [
+                            key,
+                            (_c = (_b = (_a = value === null || value === void 0 ? void 0 : value.spec) === null || _a === void 0 ? void 0 : _a["value-names"]) === null || _b === void 0 ? void 0 : _b[key]) !== null && _c !== void 0 ? _c : key,
+                        ];
+                    }));
+                    return `Value.multiselect(${JSON.stringify({
+                        name: value.name || null,
+                        minLength: null,
+                        maxLength: null,
+                        default: (_c = value.default) !== null && _c !== void 0 ? _c : null,
+                        description: value.description || null,
+                        warning: value.warning || null,
+                        values,
+                    }, null, 2)})`;
+                }
+                const list = maybeNewConst(value.name + "_list", convertList(value));
+                return `Value.list(${list})`;
+            }
+            case "pointer": {
+                return `/* TODO deal with point removed point "${value.name}" */null as any`;
+            }
+        }
+        throw Error(`Unknown type "${value.type}"`);
+    }
+    function convertList(value) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
+        switch (value.subtype) {
+            case "string": {
+                return `${rangeToTodoComment(value === null || value === void 0 ? void 0 : value.range)}List.text(${JSON.stringify({
+                    name: value.name || null,
+                    minLength: null,
+                    maxLength: null,
+                    default: value.default || null,
+                    description: value.description || null,
+                    warning: value.warning || null,
+                }, null, 2)}, ${JSON.stringify({
+                    masked: ((_a = value === null || value === void 0 ? void 0 : value.spec) === null || _a === void 0 ? void 0 : _a.masked) || false,
+                    placeholder: ((_b = value === null || value === void 0 ? void 0 : value.spec) === null || _b === void 0 ? void 0 : _b.placeholder) || null,
+                    patterns: ((_c = value === null || value === void 0 ? void 0 : value.spec) === null || _c === void 0 ? void 0 : _c.pattern)
+                        ? [
+                            {
+                                regex: value.spec.pattern,
+                                description: (_d = value === null || value === void 0 ? void 0 : value.spec) === null || _d === void 0 ? void 0 : _d["pattern-description"],
+                            },
+                        ]
+                        : [],
+                    minLength: null,
+                    maxLength: null,
+                })})`;
+            }
+            // case "number": {
+            //   return `${rangeToTodoComment(value?.range)}List.number(${JSON.stringify(
+            //     {
+            //       name: value.name || null,
+            //       minLength: null,
+            //       maxLength: null,
+            //       default: value.default || null,
+            //       description: value.description || null,
+            //       warning: value.warning || null,
+            //     },
+            //     null,
+            //     2,
+            //   )}, ${JSON.stringify({
+            //     integer: value?.spec?.integral || false,
+            //     min: null,
+            //     max: null,
+            //     units: value?.spec?.units || null,
+            //     placeholder: value?.spec?.placeholder || null,
+            //   })})`
+            // }
+            case "enum": {
+                return "/* error!! list.enum */";
+            }
+            case "object": {
+                const specName = maybeNewConst(value.name + "_spec", convertInputSpec(value.spec.spec));
+                return `${rangeToTodoComment(value === null || value === void 0 ? void 0 : value.range)}List.obj({
+          name: ${JSON.stringify(value.name || null)},
+          minLength: ${JSON.stringify(null)},
+          maxLength: ${JSON.stringify(null)},
+          default: ${JSON.stringify(value.default || null)},
+          description: ${JSON.stringify(value.description || null)},
+        }, {
+          spec: ${specName},
+          displayAs: ${JSON.stringify(((_e = value === null || value === void 0 ? void 0 : value.spec) === null || _e === void 0 ? void 0 : _e["display-as"]) || null)},
+          uniqueBy: ${JSON.stringify(((_f = value === null || value === void 0 ? void 0 : value.spec) === null || _f === void 0 ? void 0 : _f["unique-by"]) || null)},
+        })`;
+            }
+            case "union": {
+                const variants = maybeNewConst(value.name + "_variants", convertVariants(value.spec.variants, value.spec["variant-names"] || {}));
+                const unionValueName = maybeNewConst(value.name + "_union", `${rangeToTodoComment(value === null || value === void 0 ? void 0 : value.range)}
+          Value.union({
+            name: ${JSON.stringify(((_h = (_g = value === null || value === void 0 ? void 0 : value.spec) === null || _g === void 0 ? void 0 : _g.tag) === null || _h === void 0 ? void 0 : _h.name) || null)},
+            description: ${JSON.stringify(((_k = (_j = value === null || value === void 0 ? void 0 : value.spec) === null || _j === void 0 ? void 0 : _j.tag) === null || _k === void 0 ? void 0 : _k.description) || null)},
+            warning: ${JSON.stringify(((_m = (_l = value === null || value === void 0 ? void 0 : value.spec) === null || _l === void 0 ? void 0 : _l.tag) === null || _m === void 0 ? void 0 : _m.warning) || null)},
+            required: ${JSON.stringify(
+                // prettier-ignore
+                'default' in (value === null || value === void 0 ? void 0 : value.spec) ? { default: (_o = value === null || value === void 0 ? void 0 : value.spec) === null || _o === void 0 ? void 0 : _o.default } :
+                    !!((_q = (_p = value === null || value === void 0 ? void 0 : value.spec) === null || _p === void 0 ? void 0 : _p.tag) === null || _q === void 0 ? void 0 : _q.nullable) || false ? { default: null } :
+                        false)},
+          }, ${variants})
+        `);
+                const listInputSpec = maybeNewConst(value.name + "_list_inputSpec", `
+          InputSpec.of({
+            "union": ${unionValueName}
+          })
+        `);
+                return `${rangeToTodoComment(value === null || value === void 0 ? void 0 : value.range)}List.obj({
+          name:${JSON.stringify(value.name || null)},
+          minLength:${JSON.stringify(null)},
+          maxLength:${JSON.stringify(null)},
+          default: [],
+          description: ${JSON.stringify(value.description || null)},
+          warning: ${JSON.stringify(value.warning || null)},
+        }, {
+          spec: ${listInputSpec},
+          displayAs: ${JSON.stringify(((_r = value === null || value === void 0 ? void 0 : value.spec) === null || _r === void 0 ? void 0 : _r["display-as"]) || null)},
+          uniqueBy: ${JSON.stringify(((_s = value === null || value === void 0 ? void 0 : value.spec) === null || _s === void 0 ? void 0 : _s["unique-by"]) || null)},
+        })`;
+            }
+        }
+        throw new Error(`Unknown subtype "${value.subtype}"`);
+    }
+    function convertVariants(variants, variantNames) {
+        let answer = "Variants.of({";
+        for (const [key, value] of Object.entries(variants)) {
+            const variantSpec = maybeNewConst(key, convertInputSpec(value));
+            answer += `"${key}": {name: "${variantNames[key] || key}", spec: ${variantSpec}},`;
+        }
+        return `${answer}})`;
+    }
+    function getNextConstName(name, i = 0) {
+        const newName = !i ? name : name + i;
+        if (namedConsts.has(newName)) {
+            return getNextConstName(name, i + 1);
+        }
+        namedConsts.add(newName);
+        return newName;
+    }
+}
+exports.default = makeFileContentFromOld;
+function rangeToTodoComment(range) {
+    if (!range)
+        return "";
+    return `/* TODO: Convert range for this value (${range})*/`;
+}
+// oldSpecToBuilder(
+//   "./inputSpec.ts",
+//   // Put inputSpec here
+//   {},
+// )
+//# sourceMappingURL=oldSpecToBuilder.js.map