@empire-builder-kit/nx 1.0.0-beta.4

package/src/blueprints/manifest.js

@@ -0,0 +1,369 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blueprintManifestSchema = exports.BLUEPRINT_DATABASE_CHANGE_KINDS = exports.BLUEPRINT_MIGRATION_PLAN_SCHEMA_VERSION = exports.BLUEPRINT_PACKAGE_TYPE = exports.BLUEPRINT_MANIFEST_VERSION = void 0;
+exports.isExactSemanticVersion = isExactSemanticVersion;
+exports.validateBlueprintManifest = validateBlueprintManifest;
+const index_js_1 = require("../foundation/index.js");
+const validation_js_1 = require("../validation.js");
+const semver_1 = require("semver");
+exports.BLUEPRINT_MANIFEST_VERSION = 1;
+exports.BLUEPRINT_PACKAGE_TYPE = 'empire-builder-kit-blueprint';
+exports.BLUEPRINT_MIGRATION_PLAN_SCHEMA_VERSION = 1;
+exports.BLUEPRINT_DATABASE_CHANGE_KINDS = [
+    'none',
+    'ordered',
+    'replacement',
+    'manual',
+];
+const packageNamePattern = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
+const semanticVersionPattern = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+function isExactSemanticVersion(value) {
+    return typeof value === 'string' && semanticVersionPattern.test(value);
+}
+function requireNonEmptyString(value, path, issues) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        issues.push({ message: 'must be a non-empty string', path });
+    }
+}
+function requireRelativePackagePath(value, path, issues) {
+    requireNonEmptyString(value, path, issues);
+    if (typeof value === 'string' && !value.startsWith('./')) {
+        issues.push({
+            message: 'must be a relative package path beginning with ./',
+            path,
+        });
+    }
+}
+function rejectUnexpectedProperties(value, allowed, path, issues) {
+    for (const key of Object.keys(value)) {
+        if (!allowed.includes(key)) {
+            issues.push({
+                message: 'is not an allowed property',
+                path: `${path}.${key}`,
+            });
+        }
+    }
+}
+function validateUniqueStringArray(value, path, issues, options = {}) {
+    if (!Array.isArray(value) || (!options.allowEmpty && value.length === 0)) {
+        issues.push({
+            message: options.allowEmpty
+                ? 'must be an array'
+                : 'must contain at least one non-empty string',
+            path,
+        });
+        return;
+    }
+    value.forEach((entry, index) => requireNonEmptyString(entry, `${path}[${index}]`, issues));
+    if (new Set(value).size !== value.length) {
+        issues.push({ message: 'must not contain duplicates', path });
+    }
+}
+function validateMigrationDeclaration(value, index, manifestVersion, issues) {
+    const path = `manifest.migrations[${index}]`;
+    if (!(0, validation_js_1.isRecord)(value)) {
+        issues.push({ message: 'must be an object', path });
+        return;
+    }
+    rejectUnexpectedProperties(value, [
+        'affectedManagedSurfaces',
+        'contracts',
+        'databaseChange',
+        'dependencyChanges',
+        'executor',
+        'from',
+        'id',
+        'infrastructureChanges',
+        'maintenanceWindowRequired',
+        'manualSuccession',
+        'planSchemaVersion',
+        'preflight',
+        'rollback',
+        'to',
+        'verification',
+    ], path, issues);
+    requireNonEmptyString(value.id, `${path}.id`, issues);
+    if (typeof value.from !== 'string' || (0, semver_1.validRange)(value.from) === null) {
+        issues.push({
+            message: 'must be a valid semantic-version range',
+            path: `${path}.from`,
+        });
+    }
+    if (!isExactSemanticVersion(value.to)) {
+        issues.push({
+            message: 'must be an exact semantic version',
+            path: `${path}.to`,
+        });
+    }
+    else if (value.to !== manifestVersion) {
+        issues.push({
+            message: 'must equal the containing Blueprint version',
+            path: `${path}.to`,
+        });
+    }
+    if (value.planSchemaVersion !== exports.BLUEPRINT_MIGRATION_PLAN_SCHEMA_VERSION) {
+        issues.push({ message: 'must equal 1', path: `${path}.planSchemaVersion` });
+    }
+    validateUniqueStringArray(value.affectedManagedSurfaces, `${path}.affectedManagedSurfaces`, issues);
+    if (!(0, validation_js_1.isRecord)(value.contracts)) {
+        issues.push({ message: 'must be an object', path: `${path}.contracts` });
+    }
+    else {
+        rejectUnexpectedProperties(value.contracts, ['consumes', 'publishes'], `${path}.contracts`, issues);
+        validateUniqueStringArray(value.contracts.consumes, `${path}.contracts.consumes`, issues, { allowEmpty: true });
+        validateUniqueStringArray(value.contracts.publishes, `${path}.contracts.publishes`, issues, { allowEmpty: true });
+    }
+    validateUniqueStringArray(value.dependencyChanges, `${path}.dependencyChanges`, issues, { allowEmpty: true });
+    validateUniqueStringArray(value.infrastructureChanges, `${path}.infrastructureChanges`, issues, { allowEmpty: true });
+    if (typeof value.maintenanceWindowRequired !== 'boolean') {
+        issues.push({
+            message: 'must be a boolean',
+            path: `${path}.maintenanceWindowRequired`,
+        });
+    }
+    if (!exports.BLUEPRINT_DATABASE_CHANGE_KINDS.includes(value.databaseChange)) {
+        issues.push({
+            message: `must equal ${exports.BLUEPRINT_DATABASE_CHANGE_KINDS.join(', ')}`,
+            path: `${path}.databaseChange`,
+        });
+    }
+    validateUniqueStringArray(value.preflight, `${path}.preflight`, issues);
+    validateUniqueStringArray(value.verification, `${path}.verification`, issues);
+    if (!(0, validation_js_1.isRecord)(value.rollback)) {
+        issues.push({ message: 'must be an object', path: `${path}.rollback` });
+    }
+    else {
+        rejectUnexpectedProperties(value.rollback, ['afterPointOfNoReturn', 'beforePointOfNoReturn', 'pointOfNoReturn'], `${path}.rollback`, issues);
+        for (const member of [
+            'afterPointOfNoReturn',
+            'beforePointOfNoReturn',
+            'pointOfNoReturn',
+        ]) {
+            requireNonEmptyString(value.rollback[member], `${path}.rollback.${member}`, issues);
+        }
+    }
+    requireRelativePackagePath(value.manualSuccession, `${path}.manualSuccession`, issues);
+    if (value.executor !== undefined) {
+        requireRelativePackagePath(value.executor, `${path}.executor`, issues);
+    }
+}
+function validateBlueprintManifest(value) {
+    if (!(0, validation_js_1.isRecord)(value)) {
+        return {
+            valid: false,
+            issues: [{ message: 'must be an object', path: 'manifest' }],
+        };
+    }
+    const issues = [];
+    if (value.type !== exports.BLUEPRINT_PACKAGE_TYPE) {
+        issues.push({
+            message: `must equal ${exports.BLUEPRINT_PACKAGE_TYPE}`,
+            path: 'manifest.type',
+        });
+    }
+    if (value.kind !== 'slice') {
+        issues.push({ message: 'must equal slice', path: 'manifest.kind' });
+    }
+    if (typeof value.name !== 'string' || !packageNamePattern.test(value.name)) {
+        issues.push({
+            message: 'must be a valid npm package name',
+            path: 'manifest.name',
+        });
+    }
+    if (!isExactSemanticVersion(value.version)) {
+        issues.push({
+            message: 'must be an exact semantic version',
+            path: 'manifest.version',
+        });
+    }
+    if (typeof value.engine !== 'string' || (0, semver_1.validRange)(value.engine) === null) {
+        issues.push({
+            message: 'must be a valid semantic-version range',
+            path: 'manifest.engine',
+        });
+    }
+    requireRelativePackagePath(value.generator, 'manifest.generator', issues);
+    requireRelativePackagePath(value.inputs, 'manifest.inputs', issues);
+    if (value.migrations !== undefined) {
+        if (!Array.isArray(value.migrations) || value.migrations.length === 0) {
+            issues.push({
+                message: 'must contain at least one migration declaration',
+                path: 'manifest.migrations',
+            });
+        }
+        else {
+            value.migrations.forEach((migration, index) => validateMigrationDeclaration(migration, index, value.version, issues));
+            const ids = value.migrations
+                .filter(validation_js_1.isRecord)
+                .map((migration) => migration.id);
+            if (new Set(ids).size !== ids.length) {
+                issues.push({
+                    message: 'must not contain duplicate migration identifiers',
+                    path: 'manifest.migrations',
+                });
+            }
+        }
+    }
+    const foundation = (0, index_js_1.validateFoundationRequirement)(value.foundation, 'manifest.foundation');
+    if (!foundation.valid) {
+        issues.push(...foundation.issues);
+    }
+    if (!Array.isArray(value.verification) || value.verification.length === 0) {
+        issues.push({
+            message: 'must contain at least one verification target',
+            path: 'manifest.verification',
+        });
+    }
+    else {
+        const seen = new Set();
+        value.verification.forEach((target, index) => {
+            if (typeof target !== 'string' || target.trim() === '') {
+                issues.push({
+                    message: 'must be a non-empty target name',
+                    path: `manifest.verification[${index}]`,
+                });
+            }
+            else if (seen.has(target)) {
+                issues.push({
+                    message: 'must not contain duplicate targets',
+                    path: `manifest.verification[${index}]`,
+                });
+            }
+            if (typeof target === 'string') {
+                seen.add(target);
+            }
+        });
+    }
+    return (0, validation_js_1.validationResult)(value, issues);
+}
+exports.blueprintManifestSchema = {
+    $id: 'https://empirebuilderkit.dev/schemas/blueprint-v1.json',
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    additionalProperties: false,
+    properties: {
+        $schema: { type: 'string' },
+        engine: { minLength: 1, type: 'string' },
+        foundation: index_js_1.foundationRequirementSchema,
+        generator: { pattern: '^\\./', type: 'string' },
+        inputs: { pattern: '^\\./', type: 'string' },
+        kind: { const: 'slice' },
+        migrations: {
+            items: {
+                additionalProperties: false,
+                properties: {
+                    affectedManagedSurfaces: {
+                        items: { minLength: 1, type: 'string' },
+                        minItems: 1,
+                        type: 'array',
+                        uniqueItems: true,
+                    },
+                    contracts: {
+                        additionalProperties: false,
+                        properties: {
+                            consumes: {
+                                items: { minLength: 1, type: 'string' },
+                                type: 'array',
+                                uniqueItems: true,
+                            },
+                            publishes: {
+                                items: { minLength: 1, type: 'string' },
+                                type: 'array',
+                                uniqueItems: true,
+                            },
+                        },
+                        required: ['consumes', 'publishes'],
+                        type: 'object',
+                    },
+                    databaseChange: { enum: [...exports.BLUEPRINT_DATABASE_CHANGE_KINDS] },
+                    dependencyChanges: {
+                        items: { minLength: 1, type: 'string' },
+                        type: 'array',
+                        uniqueItems: true,
+                    },
+                    executor: { pattern: '^\\./', type: 'string' },
+                    from: { minLength: 1, type: 'string' },
+                    id: { minLength: 1, type: 'string' },
+                    infrastructureChanges: {
+                        items: { minLength: 1, type: 'string' },
+                        type: 'array',
+                        uniqueItems: true,
+                    },
+                    maintenanceWindowRequired: { type: 'boolean' },
+                    manualSuccession: { pattern: '^\\./', type: 'string' },
+                    planSchemaVersion: {
+                        const: exports.BLUEPRINT_MIGRATION_PLAN_SCHEMA_VERSION,
+                    },
+                    preflight: {
+                        items: { minLength: 1, type: 'string' },
+                        minItems: 1,
+                        type: 'array',
+                        uniqueItems: true,
+                    },
+                    rollback: {
+                        additionalProperties: false,
+                        properties: {
+                            afterPointOfNoReturn: { minLength: 1, type: 'string' },
+                            beforePointOfNoReturn: { minLength: 1, type: 'string' },
+                            pointOfNoReturn: { minLength: 1, type: 'string' },
+                        },
+                        required: [
+                            'beforePointOfNoReturn',
+                            'pointOfNoReturn',
+                            'afterPointOfNoReturn',
+                        ],
+                        type: 'object',
+                    },
+                    to: { pattern: semanticVersionPattern.source, type: 'string' },
+                    verification: {
+                        items: { minLength: 1, type: 'string' },
+                        minItems: 1,
+                        type: 'array',
+                        uniqueItems: true,
+                    },
+                },
+                required: [
+                    'id',
+                    'from',
+                    'to',
+                    'planSchemaVersion',
+                    'affectedManagedSurfaces',
+                    'contracts',
+                    'dependencyChanges',
+                    'infrastructureChanges',
+                    'maintenanceWindowRequired',
+                    'databaseChange',
+                    'preflight',
+                    'verification',
+                    'rollback',
+                    'manualSuccession',
+                ],
+                type: 'object',
+            },
+            minItems: 1,
+            type: 'array',
+        },
+        name: { pattern: packageNamePattern.source, type: 'string' },
+        type: { const: exports.BLUEPRINT_PACKAGE_TYPE },
+        verification: {
+            items: { minLength: 1, type: 'string' },
+            minItems: 1,
+            type: 'array',
+            uniqueItems: true,
+        },
+        version: { pattern: semanticVersionPattern.source, type: 'string' },
+    },
+    required: [
+        'type',
+        'name',
+        'version',
+        'engine',
+        'kind',
+        'generator',
+        'inputs',
+        'foundation',
+        'verification',
+    ],
+    title: 'Empire Builder Kit Blueprint Manifest v1',
+    type: 'object',
+};
+//# sourceMappingURL=manifest.js.map

package/src/blueprints/manifest.js.map

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

package/src/blueprints/resolver.d.ts

@@ -0,0 +1,28 @@
+import { type BlueprintInputSchema } from './inputs.js';
+import { type BlueprintManifest } from './manifest.js';
+export declare const BUILTIN_BLUEPRINT_REFERENCE: "standard";
+export declare const BUILTIN_BLUEPRINT_NAME: "@empire-builder-kit/blueprint-standard";
+export interface BlueprintPackageReference {
+    name: string;
+    version: string;
+}
+export interface BlueprintTrustPolicy {
+    /** Exact package names or scoped wildcards such as `@vendor/*`. */
+    packages: readonly string[];
+}
+export interface ResolveBlueprintOptions {
+    engineVersion?: string;
+    localPackages?: Readonly<Record<string, string>>;
+    reference?: string;
+    trust?: BlueprintTrustPolicy;
+    workspaceRoot: string;
+}
+export interface ResolvedBlueprint {
+    generatorPath?: string;
+    inputSchema: BlueprintInputSchema;
+    manifest: BlueprintManifest;
+    packageRoot?: string;
+    source: 'built-in' | 'installed' | 'local';
+}
+export declare function parseBlueprintPackageReference(reference: string): BlueprintPackageReference;
+export declare function resolveBlueprint({ engineVersion, localPackages, reference, trust, workspaceRoot, }: ResolveBlueprintOptions): ResolvedBlueprint;

package/src/blueprints/resolver.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_BLUEPRINT_NAME = exports.BUILTIN_BLUEPRINT_REFERENCE = void 0;
+exports.parseBlueprintPackageReference = parseBlueprintPackageReference;
+exports.resolveBlueprint = resolveBlueprint;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const semver_1 = require("semver");
+const inputs_js_1 = require("./inputs.js");
+const manifest_js_1 = require("./manifest.js");
+exports.BUILTIN_BLUEPRINT_REFERENCE = 'standard';
+exports.BUILTIN_BLUEPRINT_NAME = '@empire-builder-kit/blueprint-standard';
+const builtInInputSchema = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    additionalProperties: false,
+    properties: {},
+    type: 'object',
+};
+function readEngineVersion() {
+    const packageJsonPath = (0, node_path_1.join)(__dirname, '../../package.json');
+    const packageJson = readJson(packageJsonPath, '@empire-builder-kit/nx package.json');
+    if (typeof packageJson !== 'object' ||
+        packageJson === null ||
+        !('version' in packageJson) ||
+        !(0, manifest_js_1.isExactSemanticVersion)(packageJson.version)) {
+        throw new Error(`Unable to resolve the installed @empire-builder-kit/nx version from ${packageJsonPath}.`);
+    }
+    return packageJson.version;
+}
+function createBuiltInManifest(engineVersion) {
+    const engine = (0, semver_1.parse)(engineVersion);
+    if (!engine) {
+        throw new Error(`EBK engine version ${engineVersion} is not valid SemVer.`);
+    }
+    return {
+        $schema: 'https://empirebuilderkit.dev/schemas/blueprint-v1.json',
+        engine: engineVersion,
+        foundation: {
+            capabilities: [
+                'network',
+                'routing',
+                'postgres',
+                'identity',
+                'events',
+                'observability',
+                'configuration',
+                'deployment',
+            ],
+            contract: '^1',
+        },
+        generator: './built-in/standard.js',
+        inputs: './built-in/standard-inputs.json',
+        kind: 'slice',
+        ...(engine.major === 1
+            ? {
+                migrations: [
+                    {
+                        affectedManagedSurfaces: ['standard-product-slice'],
+                        contracts: { consumes: [], publishes: [] },
+                        databaseChange: 'manual',
+                        dependencyChanges: [
+                            'Reinstall the v1 framework and adopter dependencies in a clean workspace.',
+                        ],
+                        from: '>=0.0.0-0 <1.0.0-0',
+                        id: 'standard-pre-v1-to-v1',
+                        infrastructureChanges: [
+                            'Deploy a replacement v1 Product Slice before retiring the pre-v1 deployment.',
+                        ],
+                        maintenanceWindowRequired: false,
+                        manualSuccession: './migrations/standard-pre-v1-to-v1.md',
+                        planSchemaVersion: 1,
+                        preflight: ['workspace-health', 'foundation:verify'],
+                        rollback: {
+                            afterPointOfNoReturn: 'Restore from the retained source deployment and database backup.',
+                            beforePointOfNoReturn: 'Route traffic back to the retained pre-v1 deployment.',
+                            pointOfNoReturn: 'Writes resume after traffic moves to the v1 replacement.',
+                        },
+                        to: engineVersion,
+                        verification: ['verify'],
+                    },
+                ],
+            }
+            : {}),
+        name: exports.BUILTIN_BLUEPRINT_NAME,
+        type: manifest_js_1.BLUEPRINT_PACKAGE_TYPE,
+        verification: ['verify'],
+        version: engineVersion,
+    };
+}
+function readJson(filePath, label) {
+    try {
+        return JSON.parse((0, node_fs_1.readFileSync)(filePath, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`Unable to read ${label} at ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function resolvePackageFile(packageRoot, packagePath) {
+    const resolvedRoot = (0, node_path_1.resolve)(packageRoot);
+    const resolvedPath = (0, node_path_1.resolve)(resolvedRoot, packagePath);
+    const relativePath = (0, node_path_1.relative)(resolvedRoot, resolvedPath);
+    if (relativePath === '' ||
+        relativePath.startsWith('..') ||
+        (0, node_path_1.isAbsolute)(relativePath)) {
+        throw new Error(`Blueprint package path ${packagePath} escapes package root ${resolvedRoot}.`);
+    }
+    if (!(0, node_fs_1.existsSync)(resolvedPath)) {
+        throw new Error(`Blueprint package file does not exist: ${resolvedPath}`);
+    }
+    return resolvedPath;
+}
+function isTrusted(name, policy) {
+    return (policy?.packages ?? []).some((entry) => {
+        if (entry.endsWith('/*')) {
+            return name.startsWith(`${entry.slice(0, -1)}`);
+        }
+        return entry === name;
+    });
+}
+function parseBlueprintPackageReference(reference) {
+    const versionSeparator = reference.lastIndexOf('@');
+    if (versionSeparator <= 0) {
+        throw new Error(`Blueprint reference ${reference} must pin an exact version (for example @vendor/ebk-blueprint-billing@1.2.0).`);
+    }
+    const name = reference.slice(0, versionSeparator);
+    const version = reference.slice(versionSeparator + 1);
+    if (!name || !(0, manifest_js_1.isExactSemanticVersion)(version)) {
+        throw new Error(`Blueprint reference ${reference} must contain a valid package name and exact semantic version.`);
+    }
+    return { name, version };
+}
+function resolveBlueprint({ engineVersion, localPackages = {}, reference = exports.BUILTIN_BLUEPRINT_REFERENCE, trust, workspaceRoot, }) {
+    const resolvedEngineVersion = engineVersion ?? readEngineVersion();
+    if (reference === exports.BUILTIN_BLUEPRINT_REFERENCE) {
+        const packageRoot = (0, node_path_1.resolve)(__dirname, '../..');
+        const manifestResult = (0, manifest_js_1.validateBlueprintManifest)(createBuiltInManifest(resolvedEngineVersion));
+        if (!manifestResult.valid) {
+            throw new Error(`Invalid built-in Blueprint manifest:\n${manifestResult.issues
+                .map((issue) => `- ${issue.path}: ${issue.message}`)
+                .join('\n')}`);
+        }
+        const manifest = manifestResult.value;
+        for (const migration of manifest.migrations ?? []) {
+            resolvePackageFile(packageRoot, migration.manualSuccession);
+            if (migration.executor) {
+                resolvePackageFile(packageRoot, migration.executor);
+            }
+        }
+        return {
+            inputSchema: builtInInputSchema,
+            manifest,
+            packageRoot,
+            source: 'built-in',
+        };
+    }
+    const parsed = parseBlueprintPackageReference(reference);
+    if (!isTrusted(parsed.name, trust)) {
+        throw new Error(`Blueprint package ${parsed.name} is not trusted. Add its exact name or scope wildcard to the workspace Blueprint trust policy before generation.`);
+    }
+    const localRoot = localPackages[parsed.name];
+    const packageRoot = localRoot
+        ? (0, node_path_1.resolve)(workspaceRoot, localRoot)
+        : (0, node_path_1.join)(workspaceRoot, 'node_modules', ...parsed.name.split('/'));
+    const packageJsonPath = (0, node_path_1.join)(packageRoot, 'package.json');
+    if (!(0, node_fs_1.existsSync)(packageJsonPath)) {
+        throw new Error(`Blueprint package ${parsed.name}@${parsed.version} is not installed in the workspace and was not provided as a local package.`);
+    }
+    const packageJson = readJson(packageJsonPath, 'Blueprint package.json');
+    if (typeof packageJson !== 'object' ||
+        packageJson === null ||
+        !('name' in packageJson) ||
+        !('version' in packageJson)) {
+        throw new Error(`Blueprint package metadata is malformed: ${packageJsonPath}`);
+    }
+    if (packageJson.name !== parsed.name ||
+        packageJson.version !== parsed.version) {
+        throw new Error(`Resolved Blueprint package identity ${String(packageJson.name)}@${String(packageJson.version)} does not match requested ${parsed.name}@${parsed.version}.`);
+    }
+    const manifestPath = (0, node_path_1.join)((0, node_path_1.dirname)(packageJsonPath), 'ebk-blueprint.json');
+    const manifestResult = (0, manifest_js_1.validateBlueprintManifest)(readJson(manifestPath, 'Blueprint manifest'));
+    if (!manifestResult.valid) {
+        throw new Error(`Invalid Blueprint manifest:\n${manifestResult.issues
+            .map((issue) => `- ${issue.path}: ${issue.message}`)
+            .join('\n')}`);
+    }
+    if (manifestResult.value.name !== parsed.name ||
+        manifestResult.value.version !== parsed.version) {
+        throw new Error(`Blueprint manifest identity ${manifestResult.value.name}@${manifestResult.value.version} does not match requested ${parsed.name}@${parsed.version}.`);
+    }
+    if (!(0, semver_1.satisfies)(resolvedEngineVersion, manifestResult.value.engine)) {
+        throw new Error(`Blueprint ${parsed.name}@${parsed.version} requires EBK engine ${manifestResult.value.engine}, but this workspace provides ${resolvedEngineVersion}.`);
+    }
+    for (const migration of manifestResult.value.migrations ?? []) {
+        resolvePackageFile(packageRoot, migration.manualSuccession);
+        if (migration.executor) {
+            resolvePackageFile(packageRoot, migration.executor);
+        }
+    }
+    const inputSchemaPath = resolvePackageFile(packageRoot, manifestResult.value.inputs);
+    const inputSchemaResult = (0, inputs_js_1.validateBlueprintInputSchema)(readJson(inputSchemaPath, 'Blueprint input schema'));
+    if (!inputSchemaResult.valid) {
+        throw new Error(`Invalid Blueprint input schema:\n${inputSchemaResult.issues
+            .map((issue) => `- ${issue.path}: ${issue.message}`)
+            .join('\n')}`);
+    }
+    return {
+        generatorPath: resolvePackageFile(packageRoot, manifestResult.value.generator),
+        inputSchema: inputSchemaResult.value,
+        manifest: manifestResult.value,
+        packageRoot,
+        source: localRoot ? 'local' : 'installed',
+    };
+}
+//# sourceMappingURL=resolver.js.map

package/src/blueprints/resolver.js.map

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