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

package/src/blueprints/resolver.js

@@ -0,0 +1,218 @@
+"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 resolveManifestAssets(packageRoot, manifest) {
+    for (const migration of manifest.migrations ?? []) {
+        resolvePackageFile(packageRoot, migration.manualSuccession);
+        if (migration.executor) {
+            resolvePackageFile(packageRoot, migration.executor);
+        }
+    }
+    for (const secret of manifest.secrets ?? []) {
+        resolvePackageFile(packageRoot, secret.documentation);
+        if (secret.schema) {
+            resolvePackageFile(packageRoot, secret.schema);
+        }
+    }
+}
+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;
+        resolveManifestAssets(packageRoot, manifest);
+        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}.`);
+    }
+    resolveManifestAssets(packageRoot, manifestResult.value);
+    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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"}

package/src/blueprints/transitions.d.ts

@@ -0,0 +1,20 @@
+import type { BlueprintManifest, BlueprintMigrationDeclaration } from './manifest.js';
+export interface BlueprintIdentity {
+    name: string;
+    version: string;
+}
+export type BlueprintTransitionResult = {
+    compatibilityLine: string;
+    kind: 'compatible';
+} | {
+    compatibilityLine: string;
+    kind: 'manual-succession';
+    migration: BlueprintMigrationDeclaration;
+} | {
+    availableMigrations: BlueprintMigrationDeclaration[];
+    compatibilityLine: string;
+    kind: 'blocked';
+    reason: 'ambiguous-migrations' | 'blueprint-identity-change' | 'source-range-mismatch' | 'undeclared';
+};
+export declare function blueprintCompatibilityLine(version: string): string;
+export declare function classifyBlueprintTransition(current: BlueprintIdentity, target: BlueprintManifest): BlueprintTransitionResult;

package/src/blueprints/transitions.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blueprintCompatibilityLine = blueprintCompatibilityLine;
+exports.classifyBlueprintTransition = classifyBlueprintTransition;
+const semver_1 = require("semver");
+function blueprintCompatibilityLine(version) {
+    const parsed = (0, semver_1.parse)(version);
+    if (!parsed) {
+        throw new Error(`Blueprint version ${version} is not valid SemVer.`);
+    }
+    return parsed.major === 0 ? `0.${parsed.minor}.x` : `${parsed.major}.x`;
+}
+function classifyBlueprintTransition(current, target) {
+    const currentVersion = (0, semver_1.parse)(current.version);
+    const targetVersion = (0, semver_1.parse)(target.version);
+    if (!currentVersion) {
+        throw new Error(`Recorded Blueprint version ${current.version} is not valid SemVer.`);
+    }
+    if (!targetVersion) {
+        throw new Error(`Requested Blueprint version ${target.version} is not valid SemVer.`);
+    }
+    const compatibilityLine = blueprintCompatibilityLine(current.version);
+    if (current.name !== target.name) {
+        return {
+            availableMigrations: target.migrations ?? [],
+            compatibilityLine,
+            kind: 'blocked',
+            reason: 'blueprint-identity-change',
+        };
+    }
+    const compatible = currentVersion.major === targetVersion.major &&
+        (currentVersion.major !== 0 ||
+            currentVersion.minor === targetVersion.minor);
+    if (compatible)
+        return { compatibilityLine, kind: 'compatible' };
+    const migrations = target.migrations ?? [];
+    if (migrations.length === 0) {
+        return {
+            availableMigrations: [],
+            compatibilityLine,
+            kind: 'blocked',
+            reason: 'undeclared',
+        };
+    }
+    const matches = migrations.filter((migration) => migration.to === target.version &&
+        (0, semver_1.satisfies)(current.version, migration.from, { includePrerelease: true }));
+    if (matches.length === 1) {
+        return {
+            compatibilityLine,
+            kind: 'manual-succession',
+            migration: matches[0],
+        };
+    }
+    return {
+        availableMigrations: migrations,
+        compatibilityLine,
+        kind: 'blocked',
+        reason: matches.length > 1 ? 'ambiguous-migrations' : 'source-range-mismatch',
+    };
+}
+//# sourceMappingURL=transitions.js.map

package/src/blueprints/transitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transitions.js","sourceRoot":"","sources":["../../../../../packages/nx/src/blueprints/transitions.ts"],"names":[],"mappings":";;AAgCA,gEAMC;AAED,kEA2DC;AAnGD,mCAA0C;AAgC1C,SAAgB,0BAA0B,CAAC,OAAe;IACxD,MAAM,MAAM,GAAG,IAAA,cAAK,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,OAAO,uBAAuB,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC;AAC1E,CAAC;AAED,SAAgB,2BAA2B,CACzC,OAA0B,EAC1B,MAAyB;IAEzB,MAAM,cAAc,GAAG,IAAA,cAAK,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAA,cAAK,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,8BAA8B,OAAO,CAAC,OAAO,uBAAuB,CACrE,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,+BAA+B,MAAM,CAAC,OAAO,uBAAuB,CACrE,CAAC;IACJ,CAAC;IACD,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC;QACjC,OAAO;YACL,mBAAmB,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE;YAC5C,iBAAiB;YACjB,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,2BAA2B;SACpC,CAAC;IACJ,CAAC;IACD,MAAM,UAAU,GACd,cAAc,CAAC,KAAK,KAAK,aAAa,CAAC,KAAK;QAC5C,CAAC,cAAc,CAAC,KAAK,KAAK,CAAC;YACzB,cAAc,CAAC,KAAK,KAAK,aAAa,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,UAAU;QAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAEjE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IAC3C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,mBAAmB,EAAE,EAAE;YACvB,iBAAiB;YACjB,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,YAAY;SACrB,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAC/B,CAAC,SAAS,EAAE,EAAE,CACZ,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO;QAC/B,IAAA,kBAAS,EAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAC1E,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,iBAAiB;YACjB,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;SACtB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,mBAAmB,EAAE,UAAU;QAC/B,iBAAiB;QACjB,IAAI,EAAE,SAAS;QACf,MAAM,EACJ,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,uBAAuB;KACxE,CAAC;AACJ,CAAC"}

package/src/executors/deploy/deploy.d.ts

@@ -0,0 +1,4 @@
+import type { PromiseExecutor } from '@nx/devkit';
+import { type SstLifecycleOptions } from '../sst-lifecycle/run-sst-command.js';
+declare const executor: PromiseExecutor<SstLifecycleOptions>;
+export default executor;

package/src/executors/deploy/deploy.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const run_sst_command_js_1 = require("../sst-lifecycle/run-sst-command.js");
+const executor = (options, context) => (0, run_sst_command_js_1.runSstCommand)('deploy', options, context);
+exports.default = executor;
+//# sourceMappingURL=deploy.js.map

package/src/executors/deploy/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../../../../../packages/nx/src/executors/deploy/deploy.ts"],"names":[],"mappings":";;AACA,4EAG6C;AAE7C,MAAM,QAAQ,GAAyC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAC1E,IAAA,kCAAa,EAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAE5C,kBAAe,QAAQ,CAAC"}

package/src/executors/deployment-plan/deployment-plan.d.ts

@@ -0,0 +1,9 @@
+import { type PromiseExecutor } from '@nx/devkit';
+import { type ProtectedDeploymentAction, type ProtectedDeploymentStage } from '../../repository-policy/index.js';
+interface DeploymentPlanOptions {
+    action: ProtectedDeploymentAction;
+    project?: string;
+    stage: ProtectedDeploymentStage;
+}
+declare const executor: PromiseExecutor<DeploymentPlanOptions>;
+export default executor;

package/src/executors/deployment-plan/deployment-plan.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = require("node:fs");
+const devkit_1 = require("@nx/devkit");
+const index_js_1 = require("../../repository-policy/index.js");
+const index_js_2 = require("../../work-markers/index.js");
+function writeGithubOutputs(plan) {
+    const output = process.env.GITHUB_OUTPUT?.trim();
+    if (!output)
+        return;
+    (0, node_fs_1.appendFileSync)(output, [
+        `foundation_project=${plan.foundationProject ?? ''}`,
+        `foundation_profile=${plan.effectiveProductionProfile ?? ''}`,
+        `has_slices=${plan.sliceProjects.length > 0 ? 'true' : 'false'}`,
+        `ordered_projects=${plan.orderedProjects.join(',')}`,
+        `slice_projects=${plan.sliceProjects.join(',')}`,
+        '',
+    ].join('\n'), 'utf8');
+}
+const executor = async (options, context) => {
+    try {
+        if (options.action === 'deploy' || options.action === 'refresh') {
+            const markerReport = (0, index_js_2.scanWorkMarkers)(context.root);
+            devkit_1.logger.info((0, index_js_2.formatWorkMarkerReport)(markerReport));
+            (0, index_js_2.assertWorkMarkerReport)(markerReport, { protectedPromotion: true });
+        }
+        const policy = (0, index_js_1.readRepositoryOperatingPolicy)(context.root);
+        const plan = (0, index_js_1.createProtectedDeploymentPlan)(policy, {
+            action: options.action,
+            projects: Object.entries(context.projectsConfigurations?.projects ?? {}).map(([name, project]) => ({
+                name,
+                tags: project.tags,
+                targets: project.targets,
+            })),
+            ...(options.project?.trim()
+                ? { requestedProject: options.project.trim() }
+                : {}),
+            stage: options.stage,
+        });
+        devkit_1.logger.info(`[ebk-deployment-plan] validated before AWS access\n${JSON.stringify(plan, null, 2)}`);
+        writeGithubOutputs(plan);
+        return { success: true };
+    }
+    catch (error) {
+        devkit_1.logger.error(error instanceof Error ? error.message : String(error));
+        return { success: false };
+    }
+};
+exports.default = executor;
+//# sourceMappingURL=deployment-plan.js.map

package/src/executors/deployment-plan/deployment-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-plan.js","sourceRoot":"","sources":["../../../../../../packages/nx/src/executors/deployment-plan/deployment-plan.ts"],"names":[],"mappings":";;AAAA,qCAAyC;AACzC,uCAA0D;AAC1D,+DAK0C;AAC1C,0DAIqC;AAQrC,SAAS,kBAAkB,CAAC,IAK3B;IACC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAA,wBAAc,EACZ,MAAM,EACN;QACE,sBAAsB,IAAI,CAAC,iBAAiB,IAAI,EAAE,EAAE;QACpD,sBAAsB,IAAI,CAAC,0BAA0B,IAAI,EAAE,EAAE;QAC7D,cAAc,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE;QAChE,oBAAoB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACpD,kBAAkB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAChD,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ,MAAM,CACP,CAAC;AACJ,CAAC;AAED,MAAM,QAAQ,GAA2C,KAAK,EAC5D,OAAO,EACP,OAAO,EACP,EAAE;IACF,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChE,MAAM,YAAY,GAAG,IAAA,0BAAe,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnD,eAAM,CAAC,IAAI,CAAC,IAAA,iCAAsB,EAAC,YAAY,CAAC,CAAC,CAAC;YAClD,IAAA,iCAAsB,EAAC,YAAY,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,MAAM,GAAG,IAAA,wCAA6B,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,IAAA,wCAA6B,EAAC,MAAM,EAAE;YACjD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,MAAM,CAAC,OAAO,CACtB,OAAO,CAAC,sBAAsB,EAAE,QAAQ,IAAI,EAAE,CAC/C,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC1B,IAAI;gBACJ,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;aACzB,CAAC,CAAC;YACH,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE;gBACzB,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE;gBAC9C,CAAC,CAAC,EAAE,CAAC;YACP,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,eAAM,CAAC,IAAI,CACT,sDAAsD,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CACtF,CAAC;QACF,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAM,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC,CAAC;AAEF,kBAAe,QAAQ,CAAC"}

package/src/executors/deployment-plan/schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "version": 2,
+  "title": "Empire Builder Kit protected deployment plan",
+  "description": "Validate the complete protected project set before any AWS credentials or mutation are available.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "action": {
+      "type": "string",
+      "enum": ["deploy", "refresh", "remove", "unlock"]
+    },
+    "stage": {
+      "type": "string",
+      "enum": ["staging", "production"]
+    },
+    "project": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "description": "Required only for explicit remove or unlock recovery. Deploy and refresh derive their complete set from policy."
+    }
+  },
+  "required": ["action", "stage"]
+}

package/src/executors/dev/dev.d.ts

@@ -0,0 +1,4 @@
+import type { PromiseExecutor } from '@nx/devkit';
+import { type SstLifecycleOptions } from '../sst-lifecycle/run-sst-command.js';
+declare const executor: PromiseExecutor<SstLifecycleOptions>;
+export default executor;

package/src/executors/dev/dev.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const run_sst_command_js_1 = require("../sst-lifecycle/run-sst-command.js");
+const executor = (options, context) => (0, run_sst_command_js_1.runSstCommand)('dev', options, context);
+exports.default = executor;
+//# sourceMappingURL=dev.js.map

package/src/executors/dev/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../../../../../packages/nx/src/executors/dev/dev.ts"],"names":[],"mappings":";;AACA,4EAG6C;AAE7C,MAAM,QAAQ,GAAyC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAC1E,IAAA,kCAAa,EAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAEzC,kBAAe,QAAQ,CAAC"}

package/src/executors/dev-doctor/dev-doctor.d.ts

@@ -0,0 +1,31 @@
+import { type ExecutorContext, type PromiseExecutor } from '@nx/devkit';
+import { probeEphemeralTlsEndpoint, probeTlsEndpoint } from '../../local-dev/effects.js';
+import { sendGatewayCommand } from '../../local-dev/gateway.js';
+import { resolveFleetHostname } from '../../local-dev/identity.js';
+interface DevDoctorOptions {
+    appData?: string;
+    hostname?: string;
+    stage?: string;
+}
+export interface DevDoctorResult {
+    certificateExpires?: string;
+    connectivity: 'missing' | 'ready';
+    gateway: 'missing' | 'ready';
+    hostname: string;
+    issues: readonly string[];
+    portless: 'not-configured' | 'ready' | 'unreachable';
+    resolver: readonly string[];
+    tls: 'missing' | 'ready';
+    trust: 'missing' | 'ready';
+}
+interface DevDoctorDependencies {
+    inspectTrust?: typeof inspectCertificateTrust;
+    probeExplicitTls?: typeof probeEphemeralTlsEndpoint;
+    probePortlessTls?: typeof probeTlsEndpoint;
+    resolveHostname?: typeof resolveFleetHostname;
+    send?: typeof sendGatewayCommand;
+}
+export declare function inspectCertificateTrust(rootCertificatePath: string, intermediateCertificatePath: string, leafCertificatePath: string, hostname: string): DevDoctorResult['trust'];
+export declare function inspectLocalDevelopment(options: DevDoctorOptions, context: Pick<ExecutorContext, 'projectName' | 'root'>, dependencies?: DevDoctorDependencies): Promise<DevDoctorResult>;
+declare const executor: PromiseExecutor<DevDoctorOptions>;
+export default executor;