@continuous-excellence/ze-great-dashboard-aws 0.1.33 → 0.3.0

package/dist/guided.d.ts

@@ -0,0 +1,32 @@
+import type { BootstrapConfig } from './bootstrap.js';
+import { type BootstrapProvider, bootstrapHandoff, type CommandRunner } from './handoff.js';
+export type BootstrapCheckStatus = 'ready' | 'missing' | 'mismatch' | 'unverified';
+export type BootstrapPreflightCheck = {
+    name: string;
+    status: BootstrapCheckStatus;
+    detail: string;
+};
+export type BootstrapPreflight = {
+    ready: boolean;
+    checks: BootstrapPreflightCheck[];
+};
+export type BootstrapInitInput = {
+    slug: string;
+    repository: string;
+    environment: string;
+    providerArn: string;
+    region?: string;
+    accountId?: string;
+    ownerId?: string;
+    repositoryId?: string;
+    runner?: CommandRunner;
+};
+/** Creates the non-secret manifest data; callers control where (and whether) it is written. */
+export declare function scaffoldBootstrapManifest(input: BootstrapInitInput): Promise<BootstrapConfig>;
+/** Runs only named read-only discovery checks. Network/auth failures remain usable offline. */
+export declare function bootstrapPreflight(input: {
+    config: BootstrapConfig;
+    runner?: CommandRunner;
+    provider?: BootstrapProvider;
+}): Promise<BootstrapPreflight>;
+export declare function bootstrapGuide(input: Parameters<typeof bootstrapHandoff>[0]): Promise<string>;

package/dist/handoff.d.ts

@@ -0,0 +1,61 @@
+import { type BootstrapConfig } from './bootstrap.js';
+export type BootstrapPhase = 'core' | 'github-oidc' | 'github-environment' | 'application-gateway';
+export type CommandRunner = {
+    execute(command: string, args: string[]): Promise<string>;
+};
+export type BootstrapProvider = {
+    readonly name: string;
+    prerequisite(config: BootstrapConfig, runner?: CommandRunner): Promise<ProviderPrerequisite>;
+};
+export type ProviderPrerequisite = {
+    status: 'ready' | 'immutable-subject-required' | 'unverified';
+    blocking: boolean;
+    detail: string;
+};
+export type HandoffCommand = {
+    name: string;
+    args: string[];
+    captureFile?: string;
+};
+export type BootstrapHandoff = {
+    phase: BootstrapPhase;
+    expectedContracts: {
+        core: string;
+        githubOidc: string;
+    };
+    templatePath?: string;
+    parameterPath?: string;
+    expectedOutputs: string[];
+    requiredCapturedFiles: string[];
+    reviewCheckpoints: string[];
+    commands: HandoffCommand[];
+    prerequisite?: ProviderPrerequisite;
+};
+export type BootstrapVerification = {
+    verified: true;
+    immutableSubject: string;
+    environmentVariables: {
+        AWS_DEPLOY_ROLE_ARN: string;
+        AWS_CLOUDFORMATION_EXECUTION_ROLE_ARN: string;
+    };
+    reviewedArns: {
+        githubDeployRoleArn: string;
+        cloudFormationExecutionRoleArn: string;
+    };
+    githubEnvironmentInstructions: string[][];
+};
+export declare const githubOidcProvider: BootstrapProvider;
+export declare function bootstrapHandoff(input: {
+    config: BootstrapConfig;
+    configPath: string;
+    coreStack?: unknown;
+    coreStackPath?: string;
+    githubOidcStack?: unknown;
+    provider?: BootstrapProvider;
+    runner?: CommandRunner;
+}): Promise<BootstrapHandoff>;
+export declare function verifyBootstrap(input: {
+    config: BootstrapConfig;
+    coreStack: unknown;
+    githubOidcStack: unknown;
+}): Promise<BootstrapVerification>;

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { type BootstrapConfig, type BootstrapKind, bootstrapContractVersion, bootstrapTemplate, bootstrapTemplatePath, type CloudFormationParameterValue, coreBootstrapOutputs, type DeployedBootstrapStack, deployedBootstrapStack, mergeBootstrapParameters, requiredBootstrapParameters, } from './bootstrap.js';
+export { type BootstrapCheckStatus, type BootstrapInitInput, type BootstrapPreflight, type BootstrapPreflightCheck, bootstrapGuide, bootstrapPreflight, scaffoldBootstrapManifest, } from './guided.js';
+export { type BootstrapHandoff, type BootstrapPhase, type BootstrapProvider, type BootstrapVerification, bootstrapHandoff, type CommandRunner, githubOidcProvider, verifyBootstrap, } from './handoff.js';
 export type ReleaseMetadata = {
     dashboardVersion: string;
     clientAssetUrl: string;