@xemahq/xema 0.13.0 → 0.14.0

package/dist/runtime/installation/diff.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InstallationChangeClass = void 0;
+exports.diffInstallationPlans = diffInstallationPlans;
+const serialization_1 = require("./serialization");
+var InstallationChangeClass;
+(function (InstallationChangeClass) {
+    InstallationChangeClass["SafeInPlace"] = "safe-in-place";
+    InstallationChangeClass["RequiresRollout"] = "requires-rollout";
+    InstallationChangeClass["Destructive"] = "destructive";
+    InstallationChangeClass["Rejected"] = "rejected";
+})(InstallationChangeClass || (exports.InstallationChangeClass = InstallationChangeClass = {}));
+const CLASS_RANK = {
+    [InstallationChangeClass.SafeInPlace]: 0,
+    [InstallationChangeClass.RequiresRollout]: 1,
+    [InstallationChangeClass.Destructive]: 2,
+    [InstallationChangeClass.Rejected]: 3,
+};
+function diffInstallationPlans(current, desired) {
+    const paths = changedPaths(withoutHash(current), withoutHash(desired));
+    const changes = paths.map((path) => ({
+        path,
+        classification: classifyChange(path, valueAtPath(current, path), valueAtPath(desired, path)),
+    }));
+    const classification = changes.reduce((highest, change) => CLASS_RANK[change.classification] > CLASS_RANK[highest]
+        ? change.classification
+        : highest, InstallationChangeClass.SafeInPlace);
+    return { classification, changes };
+}
+function withoutHash(plan) {
+    const { planHash: _planHash, ...payload } = plan;
+    return payload;
+}
+function changedPaths(current, desired, path = '') {
+    if (current === undefined || desired === undefined) {
+        return current === desired ? [] : [path];
+    }
+    if ((0, serialization_1.serializeInstallation)(current) === (0, serialization_1.serializeInstallation)(desired)) {
+        return [];
+    }
+    if (current === null ||
+        desired === null ||
+        typeof current !== 'object' ||
+        typeof desired !== 'object' ||
+        Array.isArray(current) ||
+        Array.isArray(desired)) {
+        return [path];
+    }
+    const left = current;
+    const right = desired;
+    const keys = new Set([...Object.keys(left), ...Object.keys(right)]);
+    return [...keys]
+        .sort()
+        .flatMap((key) => changedPaths(left[key], right[key], path.length === 0 ? key : `${path}.${key}`));
+}
+function classifyChange(path, current, desired) {
+    if (path === 'installationId' || path === 'schemaVersion') {
+        return InstallationChangeClass.Rejected;
+    }
+    if (path === 'infrastructure' ||
+        path.startsWith('tenancy.') ||
+        path === 'storage.class' ||
+        path === 'storage.externalBinding' ||
+        path === 'storage.workspaceDriver' ||
+        path.startsWith('storage.backup.') ||
+        path === 'deployment.profile' ||
+        path === 'deployment.substrate' ||
+        path === 'deployment.regions') {
+        return InstallationChangeClass.Destructive;
+    }
+    if (path === 'capacity.maxOrganizations' ||
+        path === 'capacity.maxConcurrentSessions') {
+        return numericIncrease(current, desired)
+            ? InstallationChangeClass.SafeInPlace
+            : InstallationChangeClass.Destructive;
+    }
+    if (path === 'capacity.maxReplicas') {
+        return numericIncrease(current, desired)
+            ? InstallationChangeClass.SafeInPlace
+            : InstallationChangeClass.RequiresRollout;
+    }
+    return InstallationChangeClass.RequiresRollout;
+}
+function numericIncrease(current, desired) {
+    return (typeof current === 'number' &&
+        typeof desired === 'number' &&
+        desired >= current);
+}
+function valueAtPath(value, path) {
+    let cursor = value;
+    for (const segment of path.split('.')) {
+        if (cursor === null || typeof cursor !== 'object') {
+            return undefined;
+        }
+        cursor = cursor[segment];
+    }
+    return cursor;
+}
+//# sourceMappingURL=diff.js.map

package/dist/runtime/installation/diff.js.map

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

package/dist/runtime/installation/format.d.ts

@@ -0,0 +1,3 @@
+import type { InstallationPlanResult } from './lifecycle';
+export declare function formatInstallationPlan(plan: InstallationPlanResult): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/runtime/installation/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/runtime/installation/format.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAoB3E"}

package/dist/runtime/installation/format.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatInstallationPlan = formatInstallationPlan;
+const support_bundle_1 = require("./support-bundle");
+function formatInstallationPlan(plan) {
+    const changes = plan.diff.changes.length === 0
+        ? '  = no changes'
+        : plan.diff.changes
+            .map((change) => `  ${change.classification.padEnd(17, ' ')} ${change.path}`)
+            .join('\n');
+    return [
+        `Installation: ${plan.desired.installationId}`,
+        `Plan hash   : ${plan.desired.planHash}`,
+        `Applied hash: ${plan.applied?.planHash ?? '<none>'}`,
+        `Change class: ${plan.diff.classification}`,
+        'Changes:',
+        changes,
+        'Desired (redacted):',
+        JSON.stringify((0, support_bundle_1.redactSupportValue)(plan.desired), null, 2),
+    ].join('\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/runtime/installation/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/runtime/installation/format.ts"],"names":[],"mappings":";;AAIA,wDAoBC;AAxBD,qDAAsD;AAItD,SAAgB,sBAAsB,CAAC,IAA4B;IACjE,MAAM,OAAO,GACX,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAC5B,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;aACd,GAAG,CACF,CAAC,MAAM,EAAE,EAAE,CACT,KAAK,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAC9D;aACA,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO;QACL,iBAAiB,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE;QAC9C,iBAAiB,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE;QACxC,iBAAiB,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,QAAQ,EAAE;QACrD,iBAAiB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;QAC3C,UAAU;QACV,OAAO;QACP,qBAAqB;QACrB,IAAI,CAAC,SAAS,CAAC,IAAA,mCAAkB,EAAC,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;KAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/runtime/installation/from-current-config.d.ts

@@ -0,0 +1,8 @@
+import { InstallationDeploymentProfile, type XemaInstallation } from './contract';
+import { type XemaConfig } from '../config/schema';
+export interface CurrentConfigInstallationContext {
+    readonly installationId: string;
+    readonly profile?: InstallationDeploymentProfile;
+}
+export declare function installationFromCurrentConfig(config: XemaConfig, context: CurrentConfigInstallationContext): XemaInstallation;
+//# sourceMappingURL=from-current-config.d.ts.map

package/dist/runtime/installation/from-current-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"from-current-config.d.ts","sourceRoot":"","sources":["../../../src/runtime/installation/from-current-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,6BAA6B,EAE7B,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAC;CAClD;AAOD,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,gCAAgC,GACxC,gBAAgB,CAqClB"}

package/dist/runtime/installation/from-current-config.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installationFromCurrentConfig = installationFromCurrentConfig;
+const contract_1 = require("./contract");
+const serialization_1 = require("./serialization");
+const schema_1 = require("../config/schema");
+const infra_catalog_1 = require("../infra/infra-catalog");
+function installationFromCurrentConfig(config, context) {
+    const profile = context.profile ?? profileForSubstrate(config.app.substrate);
+    return {
+        schemaVersion: 1,
+        installationId: context.installationId,
+        sourceConfigHash: (0, serialization_1.hashInstallation)(config),
+        distribution: {
+            kind: contract_1.DistributionReferenceKind.Edition,
+            edition: config.edition,
+        },
+        deployment: {
+            profile,
+            substrate: installationSubstrate(config.app.substrate),
+        },
+        infrastructure: infra_catalog_1.INFRA_COMPONENTS.map((component) => {
+            const current = config.infra[component] ?? { mode: schema_1.InfraMode.Managed };
+            return {
+                component,
+                ownership: current.mode,
+                ...(current.url === undefined ? {} : { endpoint: current.url }),
+                ...(current.secretRef === undefined
+                    ? {}
+                    : { secretRefs: [current.secretRef] }),
+            };
+        }),
+        secrets: Object.entries(config.secrets).map(([name, secret]) => ({
+            name,
+            provider: contract_1.CURRENT_SECRET_SOURCE_PROVIDER[secret.from],
+            ...secretLocator(name, secret.from, secret.env, secret.path),
+        })),
+        storage: {
+            ...(config.state.workspaces.driver === undefined
+                ? {}
+                : { workspaceDriver: config.state.workspaces.driver }),
+        },
+    };
+}
+function profileForSubstrate(substrate) {
+    switch (substrate) {
+        case schema_1.Substrate.Native:
+            return contract_1.InstallationDeploymentProfile.Developer;
+        case schema_1.Substrate.Container:
+            return contract_1.InstallationDeploymentProfile.StarterPme;
+        case schema_1.Substrate.Helm:
+            return contract_1.InstallationDeploymentProfile.HighAvailability;
+    }
+}
+function installationSubstrate(substrate) {
+    switch (substrate) {
+        case schema_1.Substrate.Native:
+            return contract_1.InstallationSubstrate.Local;
+        case schema_1.Substrate.Container:
+            return contract_1.InstallationSubstrate.SingleNode;
+        case schema_1.Substrate.Helm:
+            return contract_1.InstallationSubstrate.Cluster;
+    }
+}
+function secretLocator(name, source, env, path) {
+    switch (source) {
+        case schema_1.SecretSource.Env:
+            return { locator: env ?? name };
+        case schema_1.SecretSource.File:
+            return path === undefined ? {} : { locator: path };
+        case schema_1.SecretSource.Prompt:
+            return {};
+    }
+}
+//# sourceMappingURL=from-current-config.js.map

package/dist/runtime/installation/from-current-config.js.map

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

package/dist/runtime/installation/index.d.ts

@@ -0,0 +1,13 @@
+export * from './compiler';
+export * from './contract';
+export * from './diagnostics';
+export * from './diff';
+export * from './from-current-config';
+export * from './format';
+export * from './lifecycle';
+export * from './serialization';
+export * from './state-store';
+export * from './status';
+export * from './support-bundle';
+export * from './validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/installation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/installation/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}

package/dist/runtime/installation/index.js

@@ -0,0 +1,29 @@
+"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 });
+__exportStar(require("./compiler"), exports);
+__exportStar(require("./contract"), exports);
+__exportStar(require("./diagnostics"), exports);
+__exportStar(require("./diff"), exports);
+__exportStar(require("./from-current-config"), exports);
+__exportStar(require("./format"), exports);
+__exportStar(require("./lifecycle"), exports);
+__exportStar(require("./serialization"), exports);
+__exportStar(require("./state-store"), exports);
+__exportStar(require("./status"), exports);
+__exportStar(require("./support-bundle"), exports);
+__exportStar(require("./validation"), exports);
+//# sourceMappingURL=index.js.map

package/dist/runtime/installation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/installation/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,6CAA2B;AAC3B,gDAA8B;AAC9B,yCAAuB;AACvB,wDAAsC;AACtC,2CAAyB;AACzB,8CAA4B;AAC5B,kDAAgC;AAChC,gDAA8B;AAC9B,2CAAyB;AACzB,mDAAiC;AACjC,+CAA6B"}

package/dist/runtime/installation/lifecycle.d.ts

@@ -0,0 +1,23 @@
+import { type CompiledXemaInstallation } from './compiler';
+import { type InstallationPlanDiff } from './diff';
+import { type CurrentConfigInstallationContext } from './from-current-config';
+import type { InstallationStateStore } from './state-store';
+import type { XemaConfig } from '../config/schema';
+export interface InstallationPlanResult {
+    readonly desired: CompiledXemaInstallation;
+    readonly applied?: CompiledXemaInstallation;
+    readonly diff: InstallationPlanDiff;
+}
+export interface InstallationApplyOptions {
+    readonly allowDestructive?: boolean;
+    readonly forceExecution?: boolean;
+}
+export interface InstallationApplyResult extends InstallationPlanResult {
+    readonly executed: boolean;
+}
+export type InstallationExecutor = (onReady: () => Promise<void>) => Promise<void>;
+export declare function installationContext(installationIdentity: string): CurrentConfigInstallationContext;
+export declare function compileCurrentInstallation(config: XemaConfig, installationIdentity: string): CompiledXemaInstallation;
+export declare function planInstallation(desired: CompiledXemaInstallation, store: InstallationStateStore): InstallationPlanResult;
+export declare function applyInstallation(desired: CompiledXemaInstallation, store: InstallationStateStore, executor: InstallationExecutor, opts?: InstallationApplyOptions): Promise<InstallationApplyResult>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/runtime/installation/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/runtime/installation/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,QAAQ,CAAC;AAChB,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;CACrC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACzB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,wBAAgB,mBAAmB,CACjC,oBAAoB,EAAE,MAAM,GAC3B,gCAAgC,CAIlC;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,UAAU,EAClB,oBAAoB,EAAE,MAAM,GAC3B,wBAAwB,CAO1B;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE,sBAAsB,GAC5B,sBAAsB,CAmBxB;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,EACjC,KAAK,EAAE,sBAAsB,EAC7B,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC,uBAAuB,CAAC,CAwBlC"}

package/dist/runtime/installation/lifecycle.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installationContext = installationContext;
+exports.compileCurrentInstallation = compileCurrentInstallation;
+exports.planInstallation = planInstallation;
+exports.applyInstallation = applyInstallation;
+const compiler_1 = require("./compiler");
+const diff_1 = require("./diff");
+const from_current_config_1 = require("./from-current-config");
+const serialization_1 = require("./serialization");
+function installationContext(installationIdentity) {
+    return {
+        installationId: `local-${(0, serialization_1.hashInstallation)(installationIdentity).slice(0, 20)}`,
+    };
+}
+function compileCurrentInstallation(config, installationIdentity) {
+    return (0, compiler_1.compileXemaInstallation)((0, from_current_config_1.installationFromCurrentConfig)(config, installationContext(installationIdentity)));
+}
+function planInstallation(desired, store) {
+    const appliedState = store.read(desired.installationId);
+    const applied = appliedState?.plan;
+    return {
+        desired,
+        ...(applied === undefined ? {} : { applied }),
+        diff: applied === undefined
+            ? {
+                classification: diff_1.InstallationChangeClass.RequiresRollout,
+                changes: [
+                    {
+                        path: '<installation>',
+                        classification: diff_1.InstallationChangeClass.RequiresRollout,
+                    },
+                ],
+            }
+            : (0, diff_1.diffInstallationPlans)(applied, desired),
+    };
+}
+async function applyInstallation(desired, store, executor, opts = {}) {
+    const release = store.acquireApplyLock(desired.installationId);
+    let ready = false;
+    try {
+        const planned = planInstallation(desired, store);
+        assertChangeAuthorized(planned.diff, opts);
+        if (planned.diff.changes.length === 0 && opts.forceExecution !== true) {
+            return { ...planned, executed: false };
+        }
+        await executor(async () => {
+            store.write(desired);
+            ready = true;
+            release();
+        });
+        if (!ready) {
+            throw new Error('Installation executor completed without reporting a ready installation.');
+        }
+        return { ...planned, executed: true };
+    }
+    finally {
+        release();
+    }
+}
+function assertChangeAuthorized(diff, opts) {
+    if (diff.classification === diff_1.InstallationChangeClass.Rejected) {
+        throw new Error('Installation apply rejected this identity/schema transition. Create a distinct installation or restore the previous desired state.');
+    }
+    if (diff.classification === diff_1.InstallationChangeClass.Destructive &&
+        opts.allowDestructive !== true) {
+        throw new Error('Installation plan contains destructive changes. Re-run with --allow-destructive after reviewing the plan.');
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/runtime/installation/lifecycle.js.map

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

package/dist/runtime/installation/serialization.d.ts

@@ -0,0 +1,3 @@
+export declare function serializeInstallation(value: unknown): string;
+export declare function hashInstallation(value: unknown): string;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/runtime/installation/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../../src/runtime/installation/serialization.ts"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE5D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIvD"}

package/dist/runtime/installation/serialization.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeInstallation = serializeInstallation;
+exports.hashInstallation = hashInstallation;
+const node_crypto_1 = require("node:crypto");
+function serializeInstallation(value) {
+    return serializeValue(value);
+}
+function hashInstallation(value) {
+    return (0, node_crypto_1.createHash)('sha256')
+        .update(serializeInstallation(value))
+        .digest('hex');
+}
+function serializeValue(value) {
+    if (value === null ||
+        typeof value === 'boolean' ||
+        typeof value === 'string') {
+        return JSON.stringify(value);
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value)) {
+            throw new Error('Installation plans cannot contain non-finite numbers');
+        }
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((entry) => serializeValue(entry)).join(',')}]`;
+    }
+    if (typeof value === 'object') {
+        const record = value;
+        return `{${Object.keys(record)
+            .filter((key) => record[key] !== undefined)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${serializeValue(record[key])}`)
+            .join(',')}}`;
+    }
+    throw new Error(`Installation plans cannot contain values of type ${typeof value}`);
+}
+//# sourceMappingURL=serialization.js.map

package/dist/runtime/installation/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../../src/runtime/installation/serialization.ts"],"names":[],"mappings":";;AAEA,sDAEC;AAED,4CAIC;AAVD,6CAAyC;AAEzC,SAAgB,qBAAqB,CAAC,KAAc;IAClD,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,OAAO,IAAA,wBAAU,EAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;SACpC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,SAAS;QAC1B,OAAO,KAAK,KAAK,QAAQ,EACzB,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACtE,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,KAA0C,CAAC;QAC1D,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aAC3B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;aAC1C,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;aACrE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,oDAAoD,OAAO,KAAK,EAAE,CACnE,CAAC;AACJ,CAAC"}

package/dist/runtime/installation/state-store.d.ts

@@ -0,0 +1,20 @@
+import { type CompiledXemaInstallation } from './compiler';
+export interface AppliedInstallationState {
+    readonly schemaVersion: 1;
+    readonly appliedAt: string;
+    readonly planHash: string;
+    readonly plan: CompiledXemaInstallation;
+}
+export interface InstallationStateStoreOptions {
+    readonly root?: string;
+}
+export declare class InstallationStateStore {
+    private readonly root;
+    constructor(opts?: InstallationStateStoreOptions);
+    read(installationId: string): AppliedInstallationState | undefined;
+    write(plan: CompiledXemaInstallation, appliedAt?: string): AppliedInstallationState;
+    acquireApplyLock(installationId: string): () => void;
+    private appliedPath;
+    private installationDirectory;
+}
+//# sourceMappingURL=state-store.d.ts.map

package/dist/runtime/installation/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../../src/runtime/installation/state-store.ts"],"names":[],"mappings":"AAkBA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;CACzC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAWD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAEX,IAAI,GAAE,6BAAkC;IAIpD,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS;IAclE,KAAK,CACV,IAAI,EAAE,wBAAwB,EAC9B,SAAS,SAA2B,GACnC,wBAAwB;IAWpB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,IAAI;IA8D3D,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,qBAAqB;CAQ9B"}