@msn-control/liftoff 0.6.2 → 0.8.0

package/dist/self-upgrade.js

@@ -0,0 +1,499 @@
+import { lstat, mkdtemp, readFile, realpath, rm } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { canonicalManualInstallCommand, canonicalNpmRegistry, exactGlobalInstallCommand, liftoffBinaryName, liftoffPackageName, npmExecutableForPlatform } from './package-identity.js';
+import { isStableSemver, lookupStableRelease, stableReleaseLookupTimeoutMs, StableReleaseLookupError } from './stable-release.js';
+import { NodeCommandRunner } from './process-runner.js';
+import { compareSemver } from './semver.js';
+export const selfUpgradeSchemaVersion = 1;
+export const selfUpgradeInstallTimeoutMs = 10 * 60_000;
+export const selfUpgradeProbeTimeoutMs = 30_000;
+export const selfUpgradeVerificationTimeoutMs = 15_000;
+class SelfUpgradeFailure extends Error {
+    status;
+    reasonCode;
+    registryKind;
+    constructor(status, reasonCode, registryKind) {
+        super(reasonCode);
+        this.status = status;
+        this.reasonCode = reasonCode;
+        this.registryKind = registryKind;
+        this.name = 'SelfUpgradeFailure';
+    }
+}
+const sourcePackageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+function pathApiForPlatform(platform) {
+    return platform === 'win32' ? path.win32 : path.posix;
+}
+function comparisonPath(value, platform) {
+    const normalized = pathApiForPlatform(platform).resolve(value);
+    return platform === 'win32' ? normalized.toLowerCase() : normalized;
+}
+export function pathIsContained(root, candidate, platform) {
+    const api = pathApiForPlatform(platform);
+    const relative = api.relative(comparisonPath(root, platform), comparisonPath(candidate, platform));
+    return relative === '' || (relative !== '..' &&
+        !relative.startsWith(`..${api.sep}`) &&
+        !api.isAbsolute(relative));
+}
+export function expectedGlobalPackageRoot(globalRoot, platform) {
+    return pathApiForPlatform(platform).join(globalRoot, ...liftoffPackageName.split('/'));
+}
+export function buildGlobalNpmInstallCommand(targetVersion, platform) {
+    return {
+        executable: npmExecutableForPlatform(platform),
+        args: [
+            'install',
+            '--global',
+            '--ignore-scripts',
+            '--no-audit',
+            '--no-fund',
+            `${liftoffPackageName}@${targetVersion}`
+        ]
+    };
+}
+function result(request, status, reasonCode, details = {}) {
+    return {
+        schemaVersion: selfUpgradeSchemaVersion,
+        mode: request.mode,
+        status,
+        currentVersion: request.currentVersion,
+        reasonCode,
+        ...(details.targetVersion ? { targetVersion: details.targetVersion } : {}),
+        ...(details.registryKind ? { registryKind: details.registryKind } : {})
+    };
+}
+function assertNever(value) {
+    throw new Error(`Unhandled self-upgrade state: ${String(value)}`);
+}
+export function selfUpgradeExitCode(value) {
+    switch (value.status) {
+        case 'current':
+        case 'upgraded':
+            return 0;
+        case 'update-available':
+            return 2;
+        case 'blocked':
+        case 'failed':
+            return 1;
+        default:
+            return assertNever(value);
+    }
+}
+export function selfUpgradeRemedy(value) {
+    switch (value.reasonCode) {
+        case 'current':
+        case 'update_available':
+        case 'upgrade_complete':
+            return undefined;
+        case 'registry_stale':
+            return 'Ask the managed registry owner to synchronize or approve the canonical target, then retry.';
+        case 'npm_install_failed':
+        case 'npm_install_timeout':
+        case 'verification_failed':
+            return value.targetVersion
+                ? `Run the exact repair command manually: ${exactGlobalInstallCommand(value.targetVersion)}`
+                : undefined;
+        case 'unsupported_installation':
+        case 'invalid_global_root':
+        case 'invalid_package':
+        case 'npm_unavailable':
+            return `Use a supported global npm installation: ${canonicalManualInstallCommand()}`;
+        case 'canonical_invalid':
+        case 'canonical_timeout':
+        case 'canonical_unavailable':
+            return 'Retry after canonical npm is reachable and exposes valid stable Liftoff metadata.';
+        case 'registry_invalid':
+        case 'registry_unavailable':
+            return 'Repair the approved npm registry configuration without placing credentials in the registry URL, then retry.';
+        case 'downgrade_refused':
+            return 'Keep the newer installed CLI; Liftoff does not perform automatic downgrades.';
+        default:
+            return assertNever(value);
+    }
+}
+export function selfUpgradeSummary(value) {
+    switch (value.status) {
+        case 'current':
+            return `Liftoff ${value.currentVersion} is already the canonical stable release.`;
+        case 'update-available':
+            return `Liftoff ${value.targetVersion} is available for this supported global npm installation.`;
+        case 'upgraded':
+            return `Liftoff ${value.targetVersion} was installed and verified.`;
+        case 'blocked':
+            return `CLI upgrade was blocked (${value.reasonCode}).`;
+        case 'failed':
+            return `CLI upgrade failed (${value.reasonCode}).`;
+        default:
+            return assertNever(value);
+    }
+}
+function readOnlyEnvironment(dependencies, neutralDirectory) {
+    return {
+        ...dependencies.environment,
+        npm_config_cache: path.join(neutralDirectory, 'npm-cache')
+    };
+}
+function commandFailed(command) {
+    return command.errorCode !== undefined ||
+        command.errorMessage !== undefined ||
+        command.timedOut ||
+        command.signal !== null ||
+        command.status !== 0;
+}
+async function inspectGlobalInstallation(request, neutralDirectory, dependencies) {
+    const npmExecutable = npmExecutableForPlatform(dependencies.platform);
+    const rootResult = await dependencies.runner.run({ executable: npmExecutable, args: ['root', '--global'] }, {
+        cwd: neutralDirectory,
+        env: readOnlyEnvironment(dependencies, neutralDirectory),
+        timeoutMs: selfUpgradeProbeTimeoutMs
+    });
+    if (rootResult.errorCode === 'ENOENT') {
+        throw new SelfUpgradeFailure('blocked', 'npm_unavailable');
+    }
+    if (commandFailed(rootResult)) {
+        throw new SelfUpgradeFailure('failed', 'invalid_global_root');
+    }
+    const rootLines = rootResult.stdout.trim().split(/\r?\n/).filter(Boolean);
+    if (rootLines.length !== 1) {
+        throw new SelfUpgradeFailure('blocked', 'invalid_global_root');
+    }
+    const pathApi = pathApiForPlatform(dependencies.platform);
+    const reportedRoot = rootLines[0];
+    if (!pathApi.isAbsolute(reportedRoot)) {
+        throw new SelfUpgradeFailure('blocked', 'invalid_global_root');
+    }
+    let globalRoot;
+    let runningRoot;
+    try {
+        globalRoot = await dependencies.realpath(reportedRoot);
+        runningRoot = await dependencies.realpath(request.runningPackageRoot ?? sourcePackageRoot);
+    }
+    catch {
+        throw new SelfUpgradeFailure('blocked', 'invalid_global_root');
+    }
+    const packageRoot = expectedGlobalPackageRoot(globalRoot, dependencies.platform);
+    if (!pathIsContained(globalRoot, packageRoot, dependencies.platform) ||
+        comparisonPath(packageRoot, dependencies.platform) !==
+            comparisonPath(runningRoot, dependencies.platform)) {
+        throw new SelfUpgradeFailure('blocked', 'unsupported_installation');
+    }
+    let packageDetails;
+    let metadata;
+    try {
+        packageDetails = await dependencies.lstat(packageRoot);
+        metadata = await dependencies.readJson(pathApi.join(packageRoot, 'package.json'));
+    }
+    catch {
+        throw new SelfUpgradeFailure('blocked', 'invalid_package');
+    }
+    if (packageDetails.isSymbolicLink() || !packageDetails.isDirectory()) {
+        throw new SelfUpgradeFailure('blocked', 'unsupported_installation');
+    }
+    if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata)) {
+        throw new SelfUpgradeFailure('blocked', 'invalid_package');
+    }
+    const packageMetadata = metadata;
+    if (packageMetadata.name !== liftoffPackageName ||
+        packageMetadata.version !== request.currentVersion) {
+        throw new SelfUpgradeFailure('blocked', 'invalid_package');
+    }
+    return { npmExecutable, packageRoot };
+}
+function registryKind(value) {
+    let parsed;
+    try {
+        parsed = new URL(value);
+    }
+    catch {
+        throw new SelfUpgradeFailure('blocked', 'registry_invalid');
+    }
+    if (parsed.protocol !== 'https:' ||
+        parsed.username ||
+        parsed.password ||
+        parsed.search ||
+        parsed.hash) {
+        throw new SelfUpgradeFailure('blocked', 'registry_invalid');
+    }
+    const normalized = parsed.toString().replace(/\/$/, '');
+    return normalized === canonicalNpmRegistry ? 'canonical' : 'configured';
+}
+async function inspectRegistryParity(targetVersion, npmExecutable, neutralDirectory, dependencies, timeoutMs = selfUpgradeProbeTimeoutMs) {
+    const options = {
+        cwd: neutralDirectory,
+        env: readOnlyEnvironment(dependencies, neutralDirectory),
+        timeoutMs
+    };
+    const registryResult = await dependencies.runner.run({ executable: npmExecutable, args: ['config', 'get', 'registry'] }, options);
+    if (commandFailed(registryResult)) {
+        throw new SelfUpgradeFailure('failed', 'registry_unavailable');
+    }
+    const configuredRegistry = registryResult.stdout.trim();
+    const kind = registryKind(configuredRegistry);
+    const targetResult = await dependencies.runner.run({
+        executable: npmExecutable,
+        args: [
+            'view',
+            `${liftoffPackageName}@${targetVersion}`,
+            'name',
+            'version',
+            '--json'
+        ]
+    }, options);
+    if (commandFailed(targetResult)) {
+        const notFound = targetResult.status === 1 &&
+            /\b(?:E404|404|not found|no match)\b/i.test(targetResult.stderr);
+        throw new SelfUpgradeFailure(notFound ? 'blocked' : 'failed', notFound ? 'registry_stale' : 'registry_unavailable', kind);
+    }
+    let metadata;
+    try {
+        metadata = JSON.parse(targetResult.stdout);
+    }
+    catch {
+        throw new SelfUpgradeFailure('failed', 'registry_invalid', kind);
+    }
+    if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata)) {
+        throw new SelfUpgradeFailure('failed', 'registry_invalid', kind);
+    }
+    const record = metadata;
+    if (record.name !== liftoffPackageName || record.version !== targetVersion) {
+        throw new SelfUpgradeFailure('blocked', 'registry_stale', kind);
+    }
+    return { kind };
+}
+export async function checkConfiguredRegistryTarget(targetVersion, overrides = {}) {
+    const dependencies = {
+        ...defaultSelfUpgradeDependencies(),
+        ...overrides
+    };
+    let neutralDirectory;
+    try {
+        neutralDirectory = await dependencies.makeNeutralDirectory();
+    }
+    catch {
+        return { status: 'unavailable' };
+    }
+    try {
+        const inspection = await inspectRegistryParity(targetVersion, npmExecutableForPlatform(dependencies.platform), neutralDirectory, dependencies, stableReleaseLookupTimeoutMs);
+        return { status: 'available', registryKind: inspection.kind };
+    }
+    catch (error) {
+        if (error instanceof SelfUpgradeFailure &&
+            error.reasonCode === 'registry_stale') {
+            return { status: 'stale' };
+        }
+        return { status: 'unavailable' };
+    }
+    finally {
+        await dependencies.removeNeutralDirectory(neutralDirectory);
+    }
+}
+async function npmGlobalRoot(npmExecutable, neutralDirectory, dependencies) {
+    const rootResult = await dependencies.runner.run({ executable: npmExecutable, args: ['root', '--global'] }, {
+        cwd: neutralDirectory,
+        env: readOnlyEnvironment(dependencies, neutralDirectory),
+        timeoutMs: selfUpgradeProbeTimeoutMs
+    });
+    if (commandFailed(rootResult)) {
+        throw new SelfUpgradeFailure('failed', 'verification_failed');
+    }
+    const lines = rootResult.stdout.trim().split(/\r?\n/).filter(Boolean);
+    if (lines.length !== 1 || !pathApiForPlatform(dependencies.platform).isAbsolute(lines[0])) {
+        throw new SelfUpgradeFailure('failed', 'verification_failed');
+    }
+    try {
+        return await dependencies.realpath(lines[0]);
+    }
+    catch {
+        throw new SelfUpgradeFailure('failed', 'verification_failed');
+    }
+}
+async function verifyReplacement(targetVersion, npmExecutable, neutralDirectory, dependencies) {
+    const pathApi = pathApiForPlatform(dependencies.platform);
+    const globalRoot = await npmGlobalRoot(npmExecutable, neutralDirectory, dependencies);
+    const packageRoot = expectedGlobalPackageRoot(globalRoot, dependencies.platform);
+    let packageDetails;
+    let metadata;
+    try {
+        packageDetails = await dependencies.lstat(packageRoot);
+        metadata = await dependencies.readJson(pathApi.join(packageRoot, 'package.json'));
+    }
+    catch {
+        throw new SelfUpgradeFailure('failed', 'verification_failed');
+    }
+    if (packageDetails.isSymbolicLink() ||
+        !packageDetails.isDirectory() ||
+        !metadata ||
+        typeof metadata !== 'object' ||
+        Array.isArray(metadata)) {
+        throw new SelfUpgradeFailure('failed', 'verification_failed');
+    }
+    const record = metadata;
+    const bin = record.bin;
+    if (record.name !== liftoffPackageName ||
+        record.version !== targetVersion ||
+        !bin ||
+        typeof bin !== 'object' ||
+        Array.isArray(bin) ||
+        typeof bin[liftoffBinaryName] !== 'string') {
+        throw new SelfUpgradeFailure('failed', 'verification_failed');
+    }
+    const declaredBin = bin[liftoffBinaryName];
+    if (pathApi.isAbsolute(declaredBin)) {
+        throw new SelfUpgradeFailure('failed', 'verification_failed');
+    }
+    const binaryPath = pathApi.resolve(packageRoot, declaredBin);
+    if (!pathIsContained(packageRoot, binaryPath, dependencies.platform)) {
+        throw new SelfUpgradeFailure('failed', 'verification_failed');
+    }
+    let binaryDetails;
+    let canonicalBinary;
+    try {
+        binaryDetails = await dependencies.lstat(binaryPath);
+        canonicalBinary = await dependencies.realpath(binaryPath);
+    }
+    catch {
+        throw new SelfUpgradeFailure('failed', 'verification_failed');
+    }
+    if (binaryDetails.isSymbolicLink() ||
+        !binaryDetails.isFile() ||
+        !pathIsContained(packageRoot, canonicalBinary, dependencies.platform)) {
+        throw new SelfUpgradeFailure('failed', 'verification_failed');
+    }
+    const versionResult = await dependencies.runner.run({
+        executable: dependencies.execPath,
+        args: [canonicalBinary, '--version']
+    }, {
+        cwd: neutralDirectory,
+        env: {
+            ...dependencies.environment,
+            CI: 'true',
+            DO_NOT_TRACK: '1',
+            LIFTOFF_TELEMETRY: '0'
+        },
+        timeoutMs: selfUpgradeVerificationTimeoutMs
+    });
+    if (commandFailed(versionResult) ||
+        versionResult.stdout.trim() !== `Liftoff ${targetVersion}`) {
+        throw new SelfUpgradeFailure('failed', 'verification_failed');
+    }
+}
+function canonicalFailureReason(error) {
+    switch (error.code) {
+        case 'invalid_metadata':
+            return 'canonical_invalid';
+        case 'timeout':
+            return 'canonical_timeout';
+        case 'http_failure':
+        case 'network_failure':
+            return 'canonical_unavailable';
+        default:
+            return assertNever(error.code);
+    }
+}
+export async function runSelfUpgrade(request, overrides = {}) {
+    const dependencies = {
+        ...defaultSelfUpgradeDependencies(),
+        ...overrides
+    };
+    const neutralDirectory = await dependencies.makeNeutralDirectory();
+    let targetVersion;
+    let registry;
+    try {
+        request.onStage?.('Inspect global installation');
+        const installation = await inspectGlobalInstallation(request, neutralDirectory, dependencies);
+        request.onStage?.('Resolve canonical stable target');
+        let stable;
+        try {
+            stable = await dependencies.lookupStableRelease();
+        }
+        catch (error) {
+            if (error instanceof StableReleaseLookupError) {
+                return result(request, 'failed', canonicalFailureReason(error));
+            }
+            return result(request, 'failed', 'canonical_unavailable');
+        }
+        if (stable.name !== liftoffPackageName || !isStableSemver(stable.version)) {
+            return result(request, 'failed', 'canonical_invalid');
+        }
+        targetVersion = stable.version;
+        const comparison = compareSemver(targetVersion, request.currentVersion);
+        if (comparison === 0) {
+            return result(request, 'current', 'current');
+        }
+        if (comparison < 0) {
+            return result(request, 'blocked', 'downgrade_refused', { targetVersion });
+        }
+        request.onStage?.('Verify configured registry parity');
+        const registryInspection = await inspectRegistryParity(targetVersion, installation.npmExecutable, neutralDirectory, dependencies);
+        registry = registryInspection.kind;
+        if (request.mode === 'check') {
+            return result(request, 'update-available', 'update_available', {
+                targetVersion,
+                registryKind: registry
+            });
+        }
+        request.onStage?.('Install exact Liftoff release', targetVersion);
+        const installCommand = buildGlobalNpmInstallCommand(targetVersion, dependencies.platform);
+        request.onInstallCommand?.(installCommand);
+        const installResult = await dependencies.runner.run(installCommand, {
+            cwd: neutralDirectory,
+            env: dependencies.environment,
+            timeoutMs: selfUpgradeInstallTimeoutMs,
+            stream: true,
+            stdout: request.json ? request.stderr : request.stdout,
+            stderr: request.stderr
+        });
+        if (installResult.timedOut) {
+            return result(request, 'failed', 'npm_install_timeout', {
+                targetVersion,
+                registryKind: registry
+            });
+        }
+        if (commandFailed(installResult)) {
+            return result(request, 'failed', 'npm_install_failed', {
+                targetVersion,
+                registryKind: registry
+            });
+        }
+        request.onStage?.('Verify replacement', targetVersion);
+        await verifyReplacement(targetVersion, installation.npmExecutable, neutralDirectory, dependencies);
+        return result(request, 'upgraded', 'upgrade_complete', {
+            targetVersion,
+            registryKind: registry
+        });
+    }
+    catch (error) {
+        if (error instanceof SelfUpgradeFailure) {
+            return result(request, error.status, error.reasonCode, {
+                ...(targetVersion ? { targetVersion } : {}),
+                ...(registry ?? error.registryKind
+                    ? { registryKind: registry ?? error.registryKind }
+                    : {})
+            });
+        }
+        return result(request, 'failed', 'verification_failed', {
+            ...(targetVersion ? { targetVersion } : {}),
+            ...(registry ? { registryKind: registry } : {})
+        });
+    }
+    finally {
+        await dependencies.removeNeutralDirectory(neutralDirectory);
+    }
+}
+function defaultSelfUpgradeDependencies() {
+    return {
+        runner: new NodeCommandRunner(),
+        lookupStableRelease,
+        makeNeutralDirectory: () => mkdtemp(path.join(os.tmpdir(), 'liftoff-upgrade-')),
+        removeNeutralDirectory: (directory) => rm(directory, { recursive: true, force: true }),
+        readJson: async (filePath) => JSON.parse(await readFile(filePath, 'utf8')),
+        lstat,
+        realpath,
+        platform: process.platform,
+        execPath: process.execPath,
+        environment: process.env
+    };
+}
+//# sourceMappingURL=self-upgrade.js.map

package/dist/self-upgrade.js.map

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

package/dist/stable-release.d.ts

@@ -0,0 +1,18 @@
+import { liftoffPackageName } from './package-identity.js';
+export declare const stableReleaseLookupTimeoutMs = 2000;
+export type StableReleaseFailureCode = 'http_failure' | 'invalid_metadata' | 'network_failure' | 'timeout';
+export declare class StableReleaseLookupError extends Error {
+    readonly code: StableReleaseFailureCode;
+    constructor(code: StableReleaseFailureCode, message: string);
+}
+export interface StableRelease {
+    name: typeof liftoffPackageName;
+    version: string;
+}
+export interface StableReleaseLookupOptions {
+    fetch?: typeof globalThis.fetch;
+    registry?: string;
+    timeoutMs?: number;
+}
+export declare function isStableSemver(value: unknown): value is string;
+export declare function lookupStableRelease(options?: StableReleaseLookupOptions): Promise<StableRelease>;

package/dist/stable-release.js

@@ -0,0 +1,66 @@
+import { canonicalNpmRegistry, liftoffPackageName, stableNpmTag } from './package-identity.js';
+export const stableReleaseLookupTimeoutMs = 2_000;
+export class StableReleaseLookupError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'StableReleaseLookupError';
+    }
+}
+export function isStableSemver(value) {
+    return typeof value === 'string' &&
+        /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/.test(value);
+}
+function packageMetadataUrl(registry) {
+    const base = new URL(registry);
+    const normalized = base.toString().endsWith('/') ? base : new URL(`${base.toString()}/`);
+    return new URL(`${encodeURIComponent(liftoffPackageName)}/${stableNpmTag}`, normalized);
+}
+export async function lookupStableRelease(options = {}) {
+    const fetchRelease = options.fetch ?? globalThis.fetch.bind(globalThis);
+    const timeoutMs = options.timeoutMs ?? stableReleaseLookupTimeoutMs;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0) {
+        throw new StableReleaseLookupError('invalid_metadata', 'Stable release timeout must be positive.');
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchRelease(packageMetadataUrl(options.registry ?? canonicalNpmRegistry), {
+            headers: { accept: 'application/vnd.npm.install-v1+json' },
+            redirect: 'error',
+            signal: controller.signal
+        });
+        if (!response.ok) {
+            throw new StableReleaseLookupError('http_failure', `Canonical npm stable release lookup returned HTTP ${response.status}.`);
+        }
+        let value;
+        try {
+            value = await response.json();
+        }
+        catch {
+            throw new StableReleaseLookupError('invalid_metadata', 'Canonical npm stable release metadata was not valid JSON.');
+        }
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            throw new StableReleaseLookupError('invalid_metadata', 'Canonical npm stable release metadata must be an object.');
+        }
+        const metadata = value;
+        if (metadata.name !== liftoffPackageName || !isStableSemver(metadata.version)) {
+            throw new StableReleaseLookupError('invalid_metadata', 'Canonical npm stable release metadata has an invalid package name or version.');
+        }
+        return { name: liftoffPackageName, version: metadata.version };
+    }
+    catch (error) {
+        if (error instanceof StableReleaseLookupError) {
+            throw error;
+        }
+        if (controller.signal.aborted) {
+            throw new StableReleaseLookupError('timeout', 'Canonical npm stable release lookup timed out.');
+        }
+        throw new StableReleaseLookupError('network_failure', 'Canonical npm stable release lookup failed.');
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=stable-release.js.map

package/dist/stable-release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-release.js","sourceRoot":"","sources":["../src/stable-release.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAQlD,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAEtC,IAAI;IADf,YACW,IAA8B,EACvC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;oBAHN,IAAI;QAIb,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAaD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ;QAC9B,4CAA4C,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzF,OAAO,IAAI,GAAG,CAAC,GAAG,kBAAkB,CAAC,kBAAkB,CAAC,IAAI,YAAY,EAAE,EAAE,UAAU,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAO,GAA+B,EAAE;IAExC,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,4BAA4B,CAAC;IACpE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,wBAAwB,CAAC,kBAAkB,EAAE,0CAA0C,CAAC,CAAC;IACrG,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CACjC,kBAAkB,CAAC,OAAO,CAAC,QAAQ,IAAI,oBAAoB,CAAC,EAC5D;YACE,OAAO,EAAE,EAAE,MAAM,EAAE,qCAAqC,EAAE;YAC1D,QAAQ,EAAE,OAAO;YACjB,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CACF,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,wBAAwB,CAChC,cAAc,EACd,qDAAqD,QAAQ,CAAC,MAAM,GAAG,CACxE,CAAC;QACJ,CAAC;QACD,IAAI,KAAc,CAAC;QACnB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,wBAAwB,CAChC,kBAAkB,EAClB,2DAA2D,CAC5D,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,wBAAwB,CAChC,kBAAkB,EAClB,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,KAAgC,CAAC;QAClD,IAAI,QAAQ,CAAC,IAAI,KAAK,kBAAkB,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,wBAAwB,CAChC,kBAAkB,EAClB,+EAA+E,CAChF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,wBAAwB,EAAE,CAAC;YAC9C,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,wBAAwB,CAAC,SAAS,EAAE,gDAAgD,CAAC,CAAC;QAClG,CAAC;QACD,MAAM,IAAI,wBAAwB,CAAC,iBAAiB,EAAE,6CAA6C,CAAC,CAAC;IACvG,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}