@antelopejs/dms 0.9.0 → 0.9.1

package/dist/store/tarball.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readTarFile = readTarFile;
+exports.readPublishedFiles = readPublishedFiles;
+const node_child_process_1 = require("node:child_process");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_path_1 = __importDefault(require("node:path"));
+const node_util_1 = require("node:util");
+const node_zlib_1 = require("node:zlib");
+const execFileAsync = (0, node_util_1.promisify)(node_child_process_1.execFile);
+const NPM_PACK_TIMEOUT_MS = 60_000;
+const TAR_BLOCK_SIZE = 512;
+const TAR_NAME_LENGTH = 100;
+const TAR_SIZE_OFFSET = 124;
+const TAR_SIZE_LENGTH = 12;
+const TAR_TYPE_OFFSET = 156;
+const TAR_PREFIX_OFFSET = 345;
+const TAR_PREFIX_LENGTH = 155;
+const OCTAL = 8;
+const PACKAGE_ROOT = "package/";
+const TEMP_PREFIX = "dms-store-pack-";
+function readString(block, offset, length) {
+    const raw = block.subarray(offset, offset + length);
+    const end = raw.indexOf(0);
+    return raw.subarray(0, end === -1 ? raw.length : end).toString("utf-8");
+}
+function readHeader(block) {
+    const name = readString(block, 0, TAR_NAME_LENGTH);
+    if (!name)
+        return undefined;
+    const prefix = readString(block, TAR_PREFIX_OFFSET, TAR_PREFIX_LENGTH);
+    return {
+        name: prefix ? `${prefix}/${name}` : name,
+        size: Number.parseInt(readString(block, TAR_SIZE_OFFSET, TAR_SIZE_LENGTH).trim(), OCTAL) || 0,
+        type: readString(block, TAR_TYPE_OFFSET, 1),
+    };
+}
+function readTarFile(archive, filePath) {
+    const wanted = `${PACKAGE_ROOT}${filePath}`;
+    let offset = 0;
+    while (offset + TAR_BLOCK_SIZE <= archive.length) {
+        const header = readHeader(archive.subarray(offset, offset + TAR_BLOCK_SIZE));
+        if (!header)
+            return undefined;
+        const start = offset + TAR_BLOCK_SIZE;
+        if (header.name === wanted) {
+            return archive.subarray(start, start + header.size);
+        }
+        offset = start + Math.ceil(header.size / TAR_BLOCK_SIZE) * TAR_BLOCK_SIZE;
+    }
+    return undefined;
+}
+async function packRelease(spec, projectPath, destination) {
+    await execFileAsync("npm", ["pack", spec, "--pack-destination", destination, "--silent"], { cwd: projectPath, timeout: NPM_PACK_TIMEOUT_MS });
+    const [file] = await (0, promises_1.readdir)(destination);
+    if (!file)
+        throw new Error(`npm pack ${spec} wrote no archive`);
+    return (0, node_zlib_1.gunzipSync)(await (0, promises_1.readFile)(node_path_1.default.join(destination, file)));
+}
+async function readPublishedFiles(packageName, version, projectPath, filePaths) {
+    const destination = await (0, promises_1.mkdtemp)(node_path_1.default.join((0, node_os_1.tmpdir)(), TEMP_PREFIX));
+    try {
+        const archive = await packRelease(`${packageName}@${version}`, projectPath, destination);
+        const files = new Map();
+        for (const filePath of filePaths) {
+            const content = readTarFile(archive, filePath);
+            if (content)
+                files.set(filePath, content.toString("utf-8"));
+        }
+        return files;
+    }
+    finally {
+        await (0, promises_1.rm)(destination, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=tarball.js.map

package/dist/store/tarball.js.map

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

package/dist/store/types.d.ts

@@ -0,0 +1,98 @@
+export interface StoreCatalogEntry {
+    id: string;
+    package: string;
+    icon: string;
+    category: string;
+}
+export interface StoreCatalog {
+    version: number;
+    modules: StoreCatalogEntry[];
+}
+export interface StoreDeclaration {
+    key: string;
+    package: string;
+    range: string;
+    disabled: boolean;
+    config?: unknown;
+}
+export interface PackageRelease {
+    version: string;
+    interfaceRange?: string;
+    dependencies?: Record<string, string>;
+    implements?: string[];
+}
+export interface RuntimeModule {
+    id: string;
+    packageName?: string;
+    version?: string;
+    status: string;
+    localPath: string;
+}
+export type StoreOperationKind = "install" | "update" | "enable" | "disable" | "uninstall" | "apply";
+export type StoreOperationStep = "resolve" | "dependencies" | "unload" | "load" | "save";
+export interface StoreOperation {
+    moduleId: string;
+    kind: StoreOperationKind;
+    step: StoreOperationStep;
+    targetVersion?: string;
+    startedAt: number;
+}
+export type StoreModuleState = "available" | "busy" | "active" | "disabled" | "error" | "pending";
+export type StoreFrontendState = "none" | "synced" | "pending" | "unknown";
+export interface InterfaceImplementation {
+    name: string;
+    package: string;
+}
+export interface MissingInterface {
+    interfacePackage: string;
+    candidates: InterfaceImplementation[];
+}
+export interface FrontendBreak {
+    name: string;
+    range: string;
+}
+export interface FrontendRequirement {
+    range: string;
+    running: string;
+    target?: string;
+    command?: string;
+    breaks: FrontendBreak[];
+}
+export type FrontendVersionSource = "reported" | "project";
+export interface StoreListingEntry {
+    id: string;
+    package: string;
+    icon: string;
+    category: string;
+    title: string;
+    description: string;
+    state: StoreModuleState;
+    installedVersion?: string;
+    declaredRange?: string;
+    latestVersion?: string;
+    updateAvailable: boolean;
+    compatible: boolean;
+    requiredInterfaceRange?: string;
+    error?: string;
+    operation?: StoreOperation;
+    frontend: StoreFrontendState;
+    frontendRange?: string;
+    frontendRequirement?: FrontendRequirement;
+    missingInterfaces: MissingInterface[];
+    dependents: string[];
+}
+export interface StoreListing {
+    enabled: boolean;
+    modules: StoreListingEntry[];
+    busy: boolean;
+    interfaceVersion: string;
+    dev: boolean;
+    configError?: string;
+    frontendVersion?: string;
+    frontendVersionSource?: FrontendVersionSource;
+}
+export interface StoreDependencyChoice {
+    interfacePackage: string;
+    package: string;
+    config?: Record<string, unknown>;
+}

package/dist/store/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/store/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":""}

package/dist/test/unit/store/store.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/unit/store/store.test.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const config_1 = require("../../../config");
+const catalog_1 = require("../../../store/catalog");
+const compatibility_1 = require("../../../store/compatibility");
+const declarations_1 = require("../../../store/declarations");
+const frontend_compatibility_1 = require("../../../store/frontend-compatibility");
+const runtime_1 = require("../../../store/runtime");
+const tarball_1 = require("../../../store/tarball");
+const store_schema_1 = require("../../../validation/store.schema");
+function runtimeModule(status) {
+    return {
+        id: "@antelopejs/dms-lang",
+        packageName: "@antelopejs/dms-lang",
+        status,
+        localPath: "/modules/dms-lang",
+    };
+}
+describe("[unit] store/catalog", () => {
+    it("reads the bundled catalog, one entry per official module", async () => {
+        const catalog = await (0, catalog_1.loadStoreCatalog)();
+        const ids = catalog.map((entry) => entry.id);
+        (0, chai_1.expect)(ids).to.include.members(["lang", "media", "database"]);
+        (0, chai_1.expect)(new Set(ids).size).to.equal(ids.length);
+    });
+    it("drops an entry missing a field rather than half-reading it", () => {
+        const entries = (0, catalog_1.readCatalogDocument)({
+            version: 1,
+            modules: [
+                {
+                    id: "lang",
+                    package: "@antelopejs/dms-lang",
+                    icon: "i",
+                    category: "content",
+                },
+                { id: "nameless", icon: "i", category: "content" },
+            ],
+        });
+        (0, chai_1.expect)(entries.map((entry) => entry.id)).to.deep.equal(["lang"]);
+    });
+    it("refuses a catalog of another version", () => {
+        (0, chai_1.expect)(() => (0, catalog_1.readCatalogDocument)({ version: 2, modules: [] })).to.throw(/Unsupported module catalog version/);
+    });
+});
+describe("[unit] store/compatibility", () => {
+    it("follows the interface range a release depends on", () => {
+        const release = { version: "1.0.0", interfaceRange: ">=0.6.0 <1.0.0" };
+        (0, chai_1.expect)((0, compatibility_1.isCompatible)(release, "0.6.1")).to.equal(true);
+        (0, chai_1.expect)((0, compatibility_1.isCompatible)(release, "0.5.9")).to.equal(false);
+    });
+    it("does not hold back a release that names no range", () => {
+        (0, chai_1.expect)((0, compatibility_1.isCompatible)({ version: "1.0.0" }, "0.6.1")).to.equal(true);
+    });
+});
+describe("[unit] store/runtime", () => {
+    it("counts a module as running only while it holds an instance", () => {
+        (0, chai_1.expect)((0, runtime_1.isLive)(runtimeModule("active"))).to.equal(true);
+        (0, chai_1.expect)((0, runtime_1.isLive)(runtimeModule("constructed"))).to.equal(true);
+        (0, chai_1.expect)((0, runtime_1.isLive)(runtimeModule("loaded"))).to.equal(false);
+        (0, chai_1.expect)((0, runtime_1.isLive)(undefined)).to.equal(false);
+    });
+});
+describe("[unit] store/declarations", () => {
+    it("writes a package source at the given range", () => {
+        (0, chai_1.expect)((0, declarations_1.packageDeclarationSource)("@antelopejs/dms-lang", "^0.1.1")).to.deep.equal({
+            type: "package",
+            package: "@antelopejs/dms-lang",
+            version: "^0.1.1",
+        });
+    });
+});
+describe("[unit] store/editable", () => {
+    it("follows the runtime mode by default", () => {
+        (0, chai_1.expect)((0, config_1.isStoreEditable)(true)).to.equal(true);
+        (0, chai_1.expect)((0, config_1.isStoreEditable)(false)).to.equal(false);
+    });
+});
+function tarEntry(name, content) {
+    const header = Buffer.alloc(512);
+    header.write(name, 0);
+    header.write(`${content.length.toString(8).padStart(11, "0")}\0`, 124);
+    header.write("0", 156);
+    const body = Buffer.alloc(Math.ceil(content.length / 512) * 512);
+    body.write(content);
+    return Buffer.concat([header, body]);
+}
+describe("[unit] store/tarball", () => {
+    it("reads one file of an npm archive by its path in the package", () => {
+        const archive = Buffer.concat([
+            tarEntry("package/package.json", '{"name":"a"}'),
+            tarEntry("package/frontend-vue/package.json", '{"engines":{}}'),
+            Buffer.alloc(1024),
+        ]);
+        (0, chai_1.expect)((0, tarball_1.readTarFile)(archive, "frontend-vue/package.json")?.toString()).to.equal('{"engines":{}}');
+        (0, chai_1.expect)((0, tarball_1.readTarFile)(archive, "missing.json")).to.equal(undefined);
+    });
+});
+describe("[unit] store/frontend-compatibility", () => {
+    it("checks a prerelease as the release it leads to", () => {
+        (0, chai_1.expect)((0, frontend_compatibility_1.supportsFrontend)(">=0.6.0 <0.7.0", "0.6.0")).to.equal(true);
+        (0, chai_1.expect)((0, frontend_compatibility_1.supportsFrontend)(">=0.6.0 <0.7.0", "0.7.0-next.1")).to.equal(false);
+        (0, chai_1.expect)((0, frontend_compatibility_1.supportsFrontend)("<0.6.0", "0.6.0")).to.equal(false);
+    });
+});
+describe("[unit] validation/store", () => {
+    const install = (packageName) => store_schema_1.storeInstallSchema.safeParse({
+        id: "lang",
+        dependencies: [
+            {
+                interfacePackage: "@antelopejs/interface-redis",
+                package: packageName,
+            },
+        ],
+    }).success;
+    it("takes an npm package for a dependency", () => {
+        (0, chai_1.expect)(install("@antelopejs/redis")).to.equal(true);
+        (0, chai_1.expect)(install("redis-module")).to.equal(true);
+    });
+    it("refuses a git, URL or local source for a dependency", () => {
+        (0, chai_1.expect)(install("git+https://github.com/a/b.git")).to.equal(false);
+        (0, chai_1.expect)(install("../redis")).to.equal(false);
+        (0, chai_1.expect)(install("file:/tmp/redis")).to.equal(false);
+        (0, chai_1.expect)(install("github:a/b")).to.equal(false);
+    });
+});
+//# sourceMappingURL=store.test.js.map

package/dist/test/unit/store/store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.test.js","sourceRoot":"","sources":["../../../../src/test/unit/store/store.test.ts"],"names":[],"mappings":";;AAAA,+BAA8B;AAC9B,4CAAkD;AAClD,oDAA+E;AAC/E,gEAA4D;AAC5D,8DAAuE;AACvE,kFAAyE;AACzE,oDAAgD;AAChD,oDAAqD;AACrD,mEAAsE;AAGtE,SAAS,aAAa,CAAC,MAAc;IACnC,OAAO;QACL,EAAE,EAAE,sBAAsB;QAC1B,WAAW,EAAE,sBAAsB;QACnC,MAAM;QACN,SAAS,EAAE,mBAAmB;KAC/B,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,MAAM,OAAO,GAAG,MAAM,IAAA,0BAAgB,GAAE,CAAC;QACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAA,aAAM,EAAC,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;QAC9D,IAAA,aAAM,EAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,OAAO,GAAG,IAAA,6BAAmB,EAAC;YAClC,OAAO,EAAE,CAAC;YACV,OAAO,EAAE;gBACP;oBACE,EAAE,EAAE,MAAM;oBACV,OAAO,EAAE,sBAAsB;oBAC/B,IAAI,EAAE,GAAG;oBACT,QAAQ,EAAE,SAAS;iBACpB;gBACD,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE;aACnD;SACF,CAAC,CAAC;QACH,IAAA,aAAM,EAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,IAAA,aAAM,EAAC,GAAG,EAAE,CAAC,IAAA,6BAAmB,EAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CACrE,oCAAoC,CACrC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;QACvE,IAAA,aAAM,EAAC,IAAA,4BAAY,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtD,IAAA,aAAM,EAAC,IAAA,4BAAY,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,IAAA,aAAM,EAAC,IAAA,4BAAY,EAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,IAAA,aAAM,EAAC,IAAA,gBAAM,EAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvD,IAAA,aAAM,EAAC,IAAA,gBAAM,EAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAA,aAAM,EAAC,IAAA,gBAAM,EAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxD,IAAA,aAAM,EAAC,IAAA,gBAAM,EAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,IAAA,aAAM,EACJ,IAAA,uCAAwB,EAAC,sBAAsB,EAAE,QAAQ,CAAC,CAC3D,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,sBAAsB;YAC/B,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,IAAA,aAAM,EAAC,IAAA,wBAAe,EAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAA,aAAM,EAAC,IAAA,wBAAe,EAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,IAAY,EAAE,OAAe;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtB,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpB,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;YAC5B,QAAQ,CAAC,sBAAsB,EAAE,cAAc,CAAC;YAChD,QAAQ,CAAC,mCAAmC,EAAE,gBAAgB,CAAC;YAC/D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;SACnB,CAAC,CAAC;QACH,IAAA,aAAM,EACJ,IAAA,qBAAW,EAAC,OAAO,EAAE,2BAA2B,CAAC,EAAE,QAAQ,EAAE,CAC9D,CAAC,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC7B,IAAA,aAAM,EAAC,IAAA,qBAAW,EAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,IAAA,aAAM,EAAC,IAAA,yCAAgB,EAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnE,IAAA,aAAM,EAAC,IAAA,yCAAgB,EAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3E,IAAA,aAAM,EAAC,IAAA,yCAAgB,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,MAAM,OAAO,GAAG,CAAC,WAAmB,EAAE,EAAE,CACtC,iCAAkB,CAAC,SAAS,CAAC;QAC3B,EAAE,EAAE,MAAM;QACV,YAAY,EAAE;YACZ;gBACE,gBAAgB,EAAE,6BAA6B;gBAC/C,OAAO,EAAE,WAAW;aACrB;SACF;KACF,CAAC,CAAC,OAAO,CAAC;IAEb,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,IAAA,aAAM,EAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,IAAA,aAAM,EAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,IAAA,aAAM,EAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClE,IAAA,aAAM,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAA,aAAM,EAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnD,IAAA,aAAM,EAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/validation/store.schema.d.ts

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export declare const storeOperationSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare const storeInstallSchema: z.ZodObject<{
+    id: z.ZodString;
+} & {
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        interfacePackage: z.ZodString;
+        package: z.ZodString;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        package: string;
+        interfacePackage: string;
+        config?: Record<string, unknown> | undefined;
+    }, {
+        package: string;
+        interfacePackage: string;
+        config?: Record<string, unknown> | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    dependencies?: {
+        package: string;
+        interfacePackage: string;
+        config?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}, {
+    id: string;
+    dependencies?: {
+        package: string;
+        interfacePackage: string;
+        config?: Record<string, unknown> | undefined;
+    }[] | undefined;
+}>;

package/dist/validation/store.schema.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storeInstallSchema = exports.storeOperationSchema = void 0;
+const zod_1 = require("zod");
+const CATALOG_ID_PATTERN = /^[a-z0-9][a-z0-9-]*$/;
+const CATALOG_ID_MAX_LENGTH = 64;
+exports.storeOperationSchema = zod_1.z.object({
+    id: zod_1.z.string().max(CATALOG_ID_MAX_LENGTH).regex(CATALOG_ID_PATTERN),
+});
+const NPM_PACKAGE_PATTERN = /^(?:@[a-z0-9][a-z0-9._~-]*\/)?[a-z0-9][a-z0-9._~-]*$/;
+const NPM_PACKAGE_MAX_LENGTH = 214;
+const MAX_DEPENDENCIES = 20;
+const npmPackageSchema = zod_1.z
+    .string()
+    .max(NPM_PACKAGE_MAX_LENGTH)
+    .regex(NPM_PACKAGE_PATTERN);
+exports.storeInstallSchema = exports.storeOperationSchema.extend({
+    dependencies: zod_1.z
+        .array(zod_1.z.object({
+        interfacePackage: npmPackageSchema,
+        package: npmPackageSchema,
+        config: zod_1.z.record(zod_1.z.unknown()).optional(),
+    }))
+        .max(MAX_DEPENDENCIES)
+        .optional(),
+});
+//# sourceMappingURL=store.schema.js.map

package/dist/validation/store.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.schema.js","sourceRoot":"","sources":["../../src/validation/store.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAClD,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAGpB,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;CACpE,CAAC,CAAC;AAMH,MAAM,mBAAmB,GACvB,sDAAsD,CAAC;AACzD,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,MAAM,gBAAgB,GAAG,OAAC;KACvB,MAAM,EAAE;KACR,GAAG,CAAC,sBAAsB,CAAC;KAC3B,KAAK,CAAC,mBAAmB,CAAC,CAAC;AAMjB,QAAA,kBAAkB,GAAG,4BAAoB,CAAC,MAAM,CAAC;IAC5D,YAAY,EAAE,OAAC;SACZ,KAAK,CACJ,OAAC,CAAC,MAAM,CAAC;QACP,gBAAgB,EAAE,gBAAgB;QAClC,OAAO,EAAE,gBAAgB;QACzB,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;KACzC,CAAC,CACH;SACA,GAAG,CAAC,gBAAgB,CAAC;SACrB,QAAQ,EAAE;CACd,CAAC,CAAC"}

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleStoreDependencyPicker.vue

@@ -0,0 +1,136 @@
+<script setup lang="ts">
+import { MONO_CHIP_CLASS } from "#dms-ui/app/build/utils/monoChip";
+import type { MissingInterface } from "../../../../types/module-store";
+import {
+  type DependencyDraft,
+  type DependencyDraftError,
+  OTHER_PACKAGE_CHOICE,
+  validateDependencyDraft,
+} from "../../../utils/module-store-install";
+
+interface ModuleStoreDependencyPickerProps {
+  /** The interfaces the release needs and no running module implements. */
+  missing: MissingInterface[];
+  /** One draft per missing interface, in the same order. */
+  drafts: DependencyDraft[];
+  /** Confirm was tried: the fields say what is wrong. */
+  showErrors?: boolean;
+}
+
+interface ModuleStoreDependencyPickerEmits {
+  update: [index: number, patch: Partial<DependencyDraft>];
+}
+
+const props = withDefaults(defineProps<ModuleStoreDependencyPickerProps>(), {
+  showErrors: false,
+});
+const emit = defineEmits<ModuleStoreDependencyPickerEmits>();
+const { t } = useI18n();
+
+const CONFIG_PLACEHOLDER = "{}";
+const CONFIG_ROWS = 3;
+
+const groups = computed(() =>
+  props.missing.map((missing, index) => {
+    const draft = props.drafts[index];
+    const errors =
+      props.showErrors && draft ? validateDependencyDraft(draft) : {};
+    return {
+      missing,
+      draft,
+      errors,
+      items: [
+        ...missing.candidates.map((candidate) => ({
+          label: candidate.name,
+          description: candidate.package,
+          value: candidate.package,
+        })),
+        {
+          label: t("modules.store.install_dialog.other"),
+          value: OTHER_PACKAGE_CHOICE,
+        },
+      ],
+    };
+  }),
+);
+
+function errorText(error: DependencyDraftError | undefined) {
+  return error ? t(`modules.store.install_dialog.errors.${error}`) : undefined;
+}
+
+/** Sends `field` of draft `index` as the control typed it. */
+function updateField(
+  index: number,
+  field: keyof DependencyDraft,
+  value: unknown,
+): void {
+  emit("update", index, { [field]: String(value ?? "") });
+}
+
+function fieldId(index: number, field: string): string {
+  return `store-dependency-${index}-${field}`;
+}
+</script>
+
+<template>
+  <div class="flex flex-col gap-4">
+    <section
+      v-for="(group, index) in groups"
+      :key="group.missing.interfacePackage"
+      class="flex flex-col gap-2.5"
+      :aria-labelledby="fieldId(index, 'title')"
+    >
+      <h4
+        :id="fieldId(index, 'title')"
+        class="text-highlighted text-[13px] font-semibold"
+      >
+        <code :class="[MONO_CHIP_CLASS, 'bg-elevated text-xs']">
+          {{ group.missing.interfacePackage }}
+        </code>
+      </h4>
+      <template v-if="group.draft">
+        <URadioGroup
+          :model-value="group.draft.choice"
+          :items="group.items"
+          size="sm"
+          :aria-labelledby="fieldId(index, 'title')"
+          @update:model-value="updateField(index, 'choice', $event)"
+        />
+        <UFormField
+          v-if="group.draft.choice === OTHER_PACKAGE_CHOICE"
+          :label="t('modules.store.install_dialog.package_label')"
+          :error="errorText(group.errors.package)"
+        >
+          <UInput
+            :id="fieldId(index, 'package')"
+            :model-value="group.draft.otherPackage"
+            class="w-full font-mono"
+            autocomplete="off"
+            spellcheck="false"
+            :placeholder="t('modules.store.install_dialog.package_placeholder')"
+            @update:model-value="updateField(index, 'otherPackage', $event)"
+          />
+        </UFormField>
+        <UFormField
+          :label="t('modules.store.install_dialog.config_label')"
+          :hint="t('modules.store.install_dialog.config_hint')"
+          :error="errorText(group.errors.config)"
+        >
+          <UTextarea
+            :id="fieldId(index, 'config')"
+            :model-value="group.draft.config"
+            class="w-full font-mono text-xs"
+            :rows="CONFIG_ROWS"
+            autoresize
+            spellcheck="false"
+            :placeholder="CONFIG_PLACEHOLDER"
+            @update:model-value="updateField(index, 'config', $event)"
+          />
+        </UFormField>
+      </template>
+    </section>
+    <p class="text-muted text-xs">
+      {{ t("modules.store.install_dialog.note") }}
+    </p>
+  </div>
+</template>

package/frontend-vue/layers/dms-layout/app/build/components/pages/modules/ModuleStoreRequirements.vue

@@ -0,0 +1,98 @@
+<script setup lang="ts">
+import DmsCopyButton from "#dms-ui/app/components/copy/CopyButton.vue";
+import type { StoreListingEntry } from "../../../../types/module-store";
+
+interface ModuleStoreRequirementsProps {
+  /** The store module whose requirements the tile spells out. */
+  entry: StoreListingEntry;
+}
+
+const props = defineProps<ModuleStoreRequirementsProps>();
+const { t } = useI18n();
+
+const LIST_SEPARATOR = ", ";
+
+const requirement = computed(() => props.entry.frontendRequirement);
+const missingInterfaces = computed(() =>
+  props.entry.missingInterfaces
+    .map((missing) => missing.interfacePackage)
+    .join(LIST_SEPARATOR),
+);
+const dependents = computed(() => props.entry.dependents.join(LIST_SEPARATOR));
+</script>
+
+<template>
+  <!-- The release needs another dms-frontend: what to run, what it breaks.
+       The store never moves dms-frontend itself. -->
+  <div
+    v-if="requirement"
+    class="flex flex-col gap-1.5 rounded-[8px] bg-(--ui-warning)/8 px-2.5 py-1.5 text-xs text-(--ui-warning)"
+  >
+    <p>
+      {{
+        t("modules.store.frontend_requirement.needs", {
+          range: requirement.range,
+          running: requirement.running,
+        })
+      }}
+    </p>
+    <template v-if="requirement.target">
+      <p v-if="requirement.command" class="text-toned">
+        {{
+          t("modules.store.frontend_requirement.run", {
+            target: requirement.target,
+          })
+        }}
+      </p>
+      <div
+        v-if="requirement.command"
+        class="text-highlighted flex min-w-0 items-center gap-1 rounded-[6px] border border-(--ui-border) bg-(--dms-bg-muted) ps-2 font-mono text-[11px]"
+      >
+        <code class="min-w-0 flex-1 truncate" :title="requirement.command">
+          {{ requirement.command }}
+        </code>
+        <DmsCopyButton :value="requirement.command" />
+      </div>
+      <template v-if="requirement.breaks.length > 0">
+        <p>
+          {{
+            t("modules.store.frontend_requirement.breaks", {
+              target: requirement.target,
+            })
+          }}
+        </p>
+        <ul class="text-toned flex flex-col gap-0.5">
+          <li
+            v-for="layer in requirement.breaks"
+            :key="layer.name"
+            class="flex min-w-0 items-baseline gap-1.5"
+          >
+            <span class="truncate font-mono">{{ layer.name }}</span>
+            <span class="text-dimmed shrink-0">
+              {{
+                t("modules.store.frontend_requirement.supports", {
+                  range: layer.range,
+                })
+              }}
+            </span>
+          </li>
+        </ul>
+      </template>
+    </template>
+    <p v-else class="text-toned">
+      {{ t("modules.store.frontend_requirement.no_target") }}
+    </p>
+  </div>
+
+  <p
+    v-if="missingInterfaces"
+    class="text-toned truncate text-xs"
+    :title="missingInterfaces"
+  >
+    {{ t("modules.store.requires", { interfaces: missingInterfaces }) }}
+  </p>
+
+  <p v-if="dependents" class="text-xs text-(--ui-warning)">
+    {{ t("modules.store.used_by", { modules: dependents }) }}
+  </p>
+</template>