npm - @hyperdrive.bot/cli - Versions diffs - 1.0.2 - Mend

@hyperdrive.bot/cli 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (127) hide show

package/README.md +1598 -0
package/bin/dev.cmd +3 -0
package/bin/dev.js +3 -0
package/bin/run.cmd +3 -0
package/bin/run.js +5 -0
package/dist/commands/account/add.d.ts +16 -0
package/dist/commands/account/add.js +185 -0
package/dist/commands/account/list.d.ts +6 -0
package/dist/commands/account/list.js +37 -0
package/dist/commands/account/remove.d.ts +11 -0
package/dist/commands/account/remove.js +57 -0
package/dist/commands/auth/login.d.ts +16 -0
package/dist/commands/auth/login.js +178 -0
package/dist/commands/auth/logout.d.ts +6 -0
package/dist/commands/auth/logout.js +39 -0
package/dist/commands/auth/refresh.d.ts +6 -0
package/dist/commands/auth/refresh.js +66 -0
package/dist/commands/auth/status.d.ts +6 -0
package/dist/commands/auth/status.js +63 -0
package/dist/commands/ci/account/create.d.ts +16 -0
package/dist/commands/ci/account/create.js +158 -0
package/dist/commands/ci/account/delete.d.ts +14 -0
package/dist/commands/ci/account/delete.js +88 -0
package/dist/commands/ci/account/list.d.ts +10 -0
package/dist/commands/ci/account/list.js +65 -0
package/dist/commands/config/get.d.ts +9 -0
package/dist/commands/config/get.js +37 -0
package/dist/commands/config/set.d.ts +10 -0
package/dist/commands/config/set.js +48 -0
package/dist/commands/config/show.d.ts +6 -0
package/dist/commands/config/show.js +10 -0
package/dist/commands/deployment/create.d.ts +30 -0
package/dist/commands/deployment/create.js +188 -0
package/dist/commands/deployment/get.d.ts +13 -0
package/dist/commands/deployment/get.js +101 -0
package/dist/commands/deployment/launch.d.ts +15 -0
package/dist/commands/deployment/launch.js +105 -0
package/dist/commands/deployment/list.d.ts +11 -0
package/dist/commands/deployment/list.js +91 -0
package/dist/commands/domain/current.d.ts +6 -0
package/dist/commands/domain/current.js +18 -0
package/dist/commands/domain/list.d.ts +6 -0
package/dist/commands/domain/list.js +42 -0
package/dist/commands/domain/switch.d.ts +9 -0
package/dist/commands/domain/switch.js +40 -0
package/dist/commands/example.d.ts +13 -0
package/dist/commands/example.js +24 -0
package/dist/commands/git/connect.d.ts +10 -0
package/dist/commands/git/connect.js +56 -0
package/dist/commands/git/disconnect.d.ts +11 -0
package/dist/commands/git/disconnect.js +93 -0
package/dist/commands/git/list.d.ts +10 -0
package/dist/commands/git/list.js +53 -0
package/dist/commands/git/sync.d.ts +18 -0
package/dist/commands/git/sync.js +235 -0
package/dist/commands/init.d.ts +188 -0
package/dist/commands/init.js +817 -0
package/dist/commands/jira/connect.d.ts +9 -0
package/dist/commands/jira/connect.js +141 -0
package/dist/commands/jira/status.d.ts +9 -0
package/dist/commands/jira/status.js +118 -0
package/dist/commands/module/analyze.d.ts +29 -0
package/dist/commands/module/analyze.js +201 -0
package/dist/commands/module/create.d.ts +42 -0
package/dist/commands/module/create.js +498 -0
package/dist/commands/module/destroy.d.ts +11 -0
package/dist/commands/module/destroy.js +77 -0
package/dist/commands/module/get.d.ts +10 -0
package/dist/commands/module/get.js +43 -0
package/dist/commands/module/link.d.ts +15 -0
package/dist/commands/module/link.js +175 -0
package/dist/commands/module/list.d.ts +9 -0
package/dist/commands/module/list.js +51 -0
package/dist/commands/module/reanalyze.d.ts +30 -0
package/dist/commands/module/reanalyze.js +206 -0
package/dist/commands/module/update.d.ts +27 -0
package/dist/commands/module/update.js +102 -0
package/dist/commands/parameter/add.d.ts +15 -0
package/dist/commands/parameter/add.js +99 -0
package/dist/commands/parameter/backfill.d.ts +12 -0
package/dist/commands/parameter/backfill.js +113 -0
package/dist/commands/parameter/clear.d.ts +14 -0
package/dist/commands/parameter/clear.js +95 -0
package/dist/commands/parameter/list.d.ts +14 -0
package/dist/commands/parameter/list.js +92 -0
package/dist/commands/parameter/pull.d.ts +14 -0
package/dist/commands/parameter/pull.js +124 -0
package/dist/commands/parameter/remove.d.ts +15 -0
package/dist/commands/parameter/remove.js +90 -0
package/dist/commands/parameter/sync.d.ts +14 -0
package/dist/commands/parameter/sync.js +153 -0
package/dist/commands/parameter/update.d.ts +15 -0
package/dist/commands/parameter/update.js +100 -0
package/dist/commands/stage/create.d.ts +28 -0
package/dist/commands/stage/create.js +312 -0
package/dist/commands/stage/list.d.ts +9 -0
package/dist/commands/stage/list.js +63 -0
package/dist/commands/test-api.d.ts +9 -0
package/dist/commands/test-api.js +40 -0
package/dist/index.d.ts +1 -0
package/dist/index.js +1 -0
package/dist/services/auth-service.d.ts +84 -0
package/dist/services/auth-service.js +240 -0
package/dist/services/git.d.ts +46 -0
package/dist/services/git.js +409 -0
package/dist/services/hyperdrive-sigv4.d.ts +449 -0
package/dist/services/hyperdrive-sigv4.js +375 -0
package/dist/services/hyperdrive.d.ts +87 -0
package/dist/services/hyperdrive.js +108 -0
package/dist/services/log-tailer.d.ts +95 -0
package/dist/services/log-tailer.js +242 -0
package/dist/services/tenant-service.d.ts +106 -0
package/dist/services/tenant-service.js +332 -0
package/dist/utils/account-flow.d.ts +74 -0
package/dist/utils/account-flow.js +228 -0
package/dist/utils/auth-flow.d.ts +146 -0
package/dist/utils/auth-flow.js +477 -0
package/dist/utils/git-flow.d.ts +72 -0
package/dist/utils/git-flow.js +232 -0
package/dist/utils/jira-flow.d.ts +71 -0
package/dist/utils/jira-flow.js +120 -0
package/dist/utils/summary-display.d.ts +59 -0
package/dist/utils/summary-display.js +140 -0
package/dist/utils/validation.d.ts +15 -0
package/dist/utils/validation.js +32 -0
package/oclif.manifest.json +2819 -0
package/package.json +112 -0

package/dist/utils/git-flow.js ADDED Viewed

@@ -0,0 +1,232 @@
+import inquirer from 'inquirer';
+import http from 'node:http';
+import open from 'open';
+import { HyperdriveSigV4Service } from '../services/hyperdrive-sigv4.js';
+// Module-level callback server instance for cleanup
+let callbackServer = null;
+/**
+ * Prompt user to select a Git provider
+ *
+ * @param includeSkip - Whether to include a "Skip for now" option
+ * @returns Selected provider or 'skip'
+ */
+export async function promptGitProvider(includeSkip = false) {
+    const choices = [
+        { name: 'GitHub', value: 'github' },
+        { name: 'GitLab', value: 'gitlab' },
+    ];
+    if (includeSkip) {
+        choices.push({ name: 'Skip for now', value: 'skip' });
+    }
+    const response = await inquirer.prompt([{
+            choices,
+            message: 'Which Git provider would you like to connect?',
+            name: 'provider',
+            type: 'list',
+        }]);
+    return response.provider;
+}
+/**
+ * Generate HTML response for callback page
+ */
+function getCallbackHtml(success, error) {
+    const title = success ? 'Authorization Successful' : 'Authorization Failed';
+    const message = success
+        ? 'You can close this window and return to the CLI.'
+        : `Error: ${error || 'Unknown error'}. Please try again.`;
+    const color = success ? '#22c55e' : '#ef4444';
+    return `
+<!DOCTYPE html>
+<html>
+<head>
+  <title>${title}</title>
+  <style>
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      min-height: 100vh;
+      margin: 0;
+      background: #1a1a2e;
+      color: #fff;
+    }
+    .container {
+      text-align: center;
+      padding: 2rem;
+    }
+    .icon {
+      font-size: 4rem;
+      margin-bottom: 1rem;
+    }
+    h1 {
+      color: ${color};
+      margin-bottom: 0.5rem;
+    }
+    p {
+      color: #a0a0a0;
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="icon">${success ? '✅' : '❌'}</div>
+    <h1>${title}</h1>
+    <p>${message}</p>
+  </div>
+</body>
+</html>
+  `;
+}
+/**
+ * Stop the callback server if running
+ */
+export function stopCallbackServer() {
+    if (callbackServer) {
+        callbackServer.close();
+        callbackServer = null;
+    }
+}
+/**
+ * Start local HTTP server to receive OAuth callback
+ *
+ * @param expectedState - State parameter to validate against
+ * @param port - Port to listen on (default: 8765)
+ * @param timeout - Timeout in milliseconds (default: 5 minutes)
+ * @param logger - Optional logging function
+ * @returns Promise resolving with callback result
+ */
+export function waitForCallback(expectedState, port = 8765, timeout = 5 * 60 * 1000, logger) {
+    return new Promise((resolve) => {
+        const timeoutId = setTimeout(() => {
+            stopCallbackServer();
+            resolve({ error: 'Timeout waiting for callback', success: false });
+        }, timeout);
+        callbackServer = http.createServer((req, res) => {
+            const url = new URL(req.url || '', `http://localhost:${port}`);
+            if (url.pathname === '/callback' || url.pathname === '/git/callback') {
+                const state = url.searchParams.get('state');
+                const error = url.searchParams.get('error');
+                const success = url.searchParams.get('success');
+                clearTimeout(timeoutId);
+                if (error) {
+                    res.writeHead(200, { 'Content-Type': 'text/html' });
+                    res.end(getCallbackHtml(false, error));
+                    resolve({ error, success: false });
+                }
+                else if (state !== expectedState) {
+                    res.writeHead(200, { 'Content-Type': 'text/html' });
+                    res.end(getCallbackHtml(false, 'Invalid state parameter'));
+                    resolve({ error: 'Invalid state', success: false });
+                }
+                else if (success === 'true') {
+                    res.writeHead(200, { 'Content-Type': 'text/html' });
+                    res.end(getCallbackHtml(true));
+                    resolve({ success: true });
+                }
+                else {
+                    res.writeHead(200, { 'Content-Type': 'text/html' });
+                    res.end(getCallbackHtml(false, 'Unknown error'));
+                    resolve({ error: 'Unknown error', success: false });
+                }
+                // Give time for the response to be sent before shutting down
+                setTimeout(() => stopCallbackServer(), 1000);
+            }
+            else {
+                res.writeHead(404);
+                res.end('Not found');
+            }
+        });
+        callbackServer.listen(port, () => {
+            if (logger) {
+                logger(`Waiting for authorization callback on http://localhost:${port}...`);
+            }
+        });
+    });
+}
+/**
+ * Execute the Git provider OAuth connection flow
+ *
+ * This function handles:
+ * 1. Provider selection (if not specified)
+ * 2. OAuth initiation via API
+ * 3. Starting local callback server
+ * 4. Opening browser for authorization
+ * 5. Waiting for callback with timeout
+ * 6. Fetching and returning connected installations
+ *
+ * @param options - Configuration options for the Git connect flow
+ * @returns GitConnectResult indicating success or failure
+ */
+export async function executeGitConnect(options = {}) {
+    const { callbackPort = 8765, logger = () => { }, // No-op by default
+    provider: initialProvider, timeout = 5 * 60 * 1000, } = options;
+    try {
+        // Step 1: Determine provider (prompt if not specified)
+        let provider;
+        if (initialProvider) {
+            provider = initialProvider;
+        }
+        else {
+            const selected = await promptGitProvider(false);
+            if (selected === 'skip') {
+                return { skipped: true, success: false };
+            }
+            provider = selected;
+        }
+        // Step 2: Initialize API service
+        const service = new HyperdriveSigV4Service();
+        // Step 3: Initiate OAuth flow via API
+        const authResponse = await service.gitAuthInitiate(provider);
+        logger(`Opening browser for ${provider === 'github' ? 'GitHub' : 'GitLab'} authorization...`);
+        logger(`If browser doesn't open or opens in wrong profile, copy this URL:`);
+        logger(`  ${authResponse.installUrl}`);
+        // Step 4: Start callback server and wait for result
+        const callbackPromise = waitForCallback(authResponse.state, callbackPort, timeout, logger);
+        // Step 5: Open browser
+        await open(authResponse.installUrl);
+        // Step 6: Wait for callback
+        const result = await callbackPromise;
+        if (result.success) {
+            // Step 7: Fetch installations to get account name
+            const installationsResponse = await service.gitListInstallations(provider);
+            const installations = installationsResponse.installations || [];
+            // Determine primary account name from first installation
+            let accountName;
+            if (installations.length > 0) {
+                const firstInstall = installations[0];
+                accountName = firstInstall.accountLogin || firstInstall.gitlabUsername || undefined;
+            }
+            // Map installations to simplified format
+            const installationInfos = installations.map(inst => ({
+                accountLogin: inst.accountLogin,
+                gitlabUsername: inst.gitlabUsername,
+                provider: inst.provider,
+            }));
+            return {
+                accountName,
+                installations: installationInfos,
+                provider,
+                success: true,
+            };
+        }
+        else {
+            return {
+                error: result.error || 'Unknown error during authorization',
+                provider,
+                success: false,
+            };
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            error: errorMessage,
+            success: false,
+        };
+    }
+    finally {
+        // Ensure server is stopped
+        stopCallbackServer();
+    }
+}

package/dist/utils/jira-flow.d.ts ADDED Viewed

@@ -0,0 +1,71 @@
+/**
+ * Response from Jira pre-registration API
+ */
+export interface PreRegisterResponse {
+    nextSteps: {
+        instructions: string[];
+        marketplaceUrl: string;
+    };
+    registration: {
+        jiraDomain: string;
+        status: string;
+        tenantId: string;
+        token: string;
+    };
+    success: boolean;
+}
+/**
+ * Result of the Jira connect flow
+ */
+export interface JiraConnectResult {
+    error?: string;
+    jiraDomain?: string;
+    marketplaceUrl?: string;
+    registrationToken?: string;
+    success: boolean;
+}
+/**
+ * Jira domain data
+ */
+export interface JiraDomainData {
+    jiraDomain: string;
+}
+/**
+ * Validate and normalize Jira domain
+ *
+ * Ensures domain matches pattern: subdomain.atlassian.net
+ * - Must have subdomain (alphanumeric + hyphens)
+ * - Must end with .atlassian.net exactly
+ * - No additional paths or domains
+ */
+export declare function validateJiraDomain(input: string): boolean | string;
+/**
+ * Normalize Jira domain input
+ */
+export declare function normalizeJiraDomain(input: string): string;
+/**
+ * Prompt user for Jira domain
+ *
+ * Separated from API call to allow proper spinner timing
+ */
+export declare function promptJiraDomain(): Promise<JiraDomainData>;
+/**
+ * Prompt for whether to connect Jira (with skip option)
+ */
+export declare function promptJiraConnect(includeSkip?: boolean): Promise<'skip' | 'yes'>;
+/**
+ * Register Jira domain with Hyperdrive API (no user prompts)
+ *
+ * This function is separated from user input collection to allow
+ * proper spinner timing and better separation of concerns.
+ */
+export declare function registerJiraDomain(jiraDomain: string): Promise<JiraConnectResult>;
+/**
+ * Execute the Jira connect flow
+ *
+ * This function handles:
+ * 1. Prompting for Jira domain
+ * 2. Pre-registering the domain with Hyperdrive API
+ * 3. Returning result with marketplace URL
+ */
+export declare function executeJiraConnect(): Promise<JiraConnectResult>;

package/dist/utils/jira-flow.js ADDED Viewed

@@ -0,0 +1,120 @@
+import inquirer from 'inquirer';
+import { HyperdriveSigV4Service } from '../services/hyperdrive-sigv4.js';
+/**
+ * Validate and normalize Jira domain
+ *
+ * Ensures domain matches pattern: subdomain.atlassian.net
+ * - Must have subdomain (alphanumeric + hyphens)
+ * - Must end with .atlassian.net exactly
+ * - No additional paths or domains
+ */
+export function validateJiraDomain(input) {
+    const normalized = normalizeJiraDomain(input);
+    // Regex: subdomain.atlassian.net (subdomain can contain alphanumeric and hyphens)
+    const jiraPattern = /^[a-z0-9]([a-z0-9-]*[a-z0-9])?\.atlassian\.net$/i;
+    if (!jiraPattern.test(normalized)) {
+        return 'Invalid Jira domain. Expected format: your-company.atlassian.net';
+    }
+    return true;
+}
+/**
+ * Normalize Jira domain input
+ */
+export function normalizeJiraDomain(input) {
+    return input
+        .replace(/^https?:\/\//, '')
+        .replace(/\/$/, '')
+        .toLowerCase();
+}
+/**
+ * Prompt user for Jira domain
+ *
+ * Separated from API call to allow proper spinner timing
+ */
+export async function promptJiraDomain() {
+    const answers = await inquirer.prompt([
+        {
+            default: 'your-company.atlassian.net',
+            filter: normalizeJiraDomain,
+            message: 'Enter your Jira domain:',
+            name: 'jiraDomain',
+            type: 'input',
+            validate: validateJiraDomain,
+        },
+    ]);
+    return { jiraDomain: answers.jiraDomain };
+}
+/**
+ * Prompt for whether to connect Jira (with skip option)
+ */
+export async function promptJiraConnect(includeSkip = false) {
+    if (!includeSkip) {
+        const { connect } = await inquirer.prompt([{
+                default: false,
+                message: 'Would you like to connect Jira?',
+                name: 'connect',
+                type: 'confirm',
+            }]);
+        return connect ? 'yes' : 'skip';
+    }
+    const { action } = await inquirer.prompt([{
+            choices: [
+                { name: 'Yes, connect Jira now', value: 'yes' },
+                { name: 'Skip for now', value: 'skip' },
+            ],
+            default: 'skip',
+            message: 'Would you like to connect Jira?',
+            name: 'action',
+            type: 'list',
+        }]);
+    return action;
+}
+/**
+ * Register Jira domain with Hyperdrive API (no user prompts)
+ *
+ * This function is separated from user input collection to allow
+ * proper spinner timing and better separation of concerns.
+ */
+export async function registerJiraDomain(jiraDomain) {
+    try {
+        const service = new HyperdriveSigV4Service();
+        // Use the public API method instead of accessing private method
+        const response = await service.jiraPreRegister({ jiraDomain });
+        return {
+            jiraDomain: response.registration.jiraDomain,
+            marketplaceUrl: response.nextSteps.marketplaceUrl,
+            registrationToken: response.registration.token,
+            success: true,
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            error: errorMessage,
+            success: false,
+        };
+    }
+}
+/**
+ * Execute the Jira connect flow
+ *
+ * This function handles:
+ * 1. Prompting for Jira domain
+ * 2. Pre-registering the domain with Hyperdrive API
+ * 3. Returning result with marketplace URL
+ */
+export async function executeJiraConnect() {
+    try {
+        // Step 1: Prompt for Jira domain (no spinner - user needs to see prompts)
+        const domainData = await promptJiraDomain();
+        // Step 2: Register domain with API (caller should wrap this with spinner)
+        return await registerJiraDomain(domainData.jiraDomain);
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            error: errorMessage,
+            success: false,
+        };
+    }
+}

package/dist/utils/summary-display.d.ts ADDED Viewed

@@ -0,0 +1,59 @@
+/**
+ * Represents a connected AWS account
+ */
+export interface ConnectedAccount {
+    accountId: string;
+    alias?: string;
+}
+/**
+ * Results from the setup wizard steps
+ */
+export interface SetupResults {
+    /** Whether AWS account setup was skipped */
+    accountsSkipped: boolean;
+    /** Whether authentication completed successfully */
+    authCompleted: boolean;
+    /** Whether authentication was skipped */
+    authSkipped: boolean;
+    /** List of connected AWS accounts */
+    connectedAccounts: ConnectedAccount[];
+    /** Git account/organization name */
+    gitAccountName?: string;
+    /** Git provider that was connected */
+    gitProvider?: 'github' | 'gitlab';
+    /** Whether Git provider setup was skipped */
+    gitSkipped: boolean;
+    /** Jira domain that was connected */
+    jiraDomain?: string;
+    /** Whether Jira integration was skipped */
+    jiraSkipped: boolean;
+    /** Tenant domain that was configured */
+    tenantDomain: string;
+    /** Email of authenticated user (if available) */
+    userEmail?: string;
+}
+/**
+ * Represents a recommended next step
+ */
+export interface NextStep {
+    /** Command to run */
+    command: string;
+    /** Description of what the command does */
+    description: string;
+    /** Priority (lower = higher priority) */
+    priority: number;
+}
+/**
+ * Get the list of recommended next steps based on setup results
+ *
+ * @param results - The setup results from the wizard
+ * @returns Array of next steps sorted by priority
+ */
+export declare function getNextSteps(results: SetupResults): NextStep[];
+/**
+ * Display the setup summary with status and next steps
+ *
+ * @param results - The setup results from the wizard
+ * @param logger - Function to log output (defaults to console.log)
+ */
+export declare function displaySetupSummary(results: SetupResults, logger?: (message: string) => void): void;

package/dist/utils/summary-display.js ADDED Viewed

@@ -0,0 +1,140 @@
+import chalk from 'chalk';
+/** Width for status labels in the summary display */
+const STATUS_LABEL_WIDTH = 16;
+/**
+ * Format a status label with consistent width
+ */
+const formatLabel = (label) => label.padEnd(STATUS_LABEL_WIDTH);
+/**
+ * Get the list of recommended next steps based on setup results
+ *
+ * @param results - The setup results from the wizard
+ * @returns Array of next steps sorted by priority
+ */
+export function getNextSteps(results) {
+    const steps = [];
+    // Authentication is highest priority if skipped
+    if (results.authSkipped) {
+        steps.push({
+            command: 'hd auth login',
+            description: 'Required for CLI operations',
+            priority: 1,
+        });
+    }
+    // AWS accounts are second priority
+    if (results.accountsSkipped || results.connectedAccounts.length === 0) {
+        steps.push({
+            command: 'hd account add',
+            description: 'Connect AWS accounts for deployments',
+            priority: 2,
+        });
+    }
+    // Git provider is third priority
+    if (results.gitSkipped) {
+        steps.push({
+            command: 'hd git connect',
+            description: 'Link your Git provider for CI/CD',
+            priority: 3,
+        });
+    }
+    // Jira integration is fourth priority
+    if (results.jiraSkipped) {
+        steps.push({
+            command: 'hd jira connect',
+            description: 'Connect Jira for project management',
+            priority: 4,
+        });
+    }
+    // If all steps completed, suggest module create
+    if (steps.length === 0) {
+        steps.push({
+            command: 'hd module create',
+            description: 'Create your first serverless module',
+            priority: 1,
+        });
+    }
+    // Sort by priority
+    return steps.sort((a, b) => a.priority - b.priority);
+}
+/**
+ * Display the setup summary with status and next steps
+ *
+ * @param results - The setup results from the wizard
+ * @param logger - Function to log output (defaults to console.log)
+ */
+export function displaySetupSummary(results, logger = console.log) {
+    // Display header
+    logger('');
+    logger(chalk.blue('╔═══════════════════════════════════════════════════════════════╗'));
+    logger(chalk.blue('║') + chalk.white.bold('                    Hyperdrive Setup Complete                   ') + chalk.blue('║'));
+    logger(chalk.blue('╚═══════════════════════════════════════════════════════════════╝'));
+    logger('');
+    // Display tenant domain status (always completed)
+    logger(`  ${chalk.green('✓')}  ${formatLabel('Tenant:')} ${chalk.cyan(results.tenantDomain)}`);
+    // Display authentication status
+    if (results.authCompleted) {
+        const authInfo = results.userEmail
+            ? `Logged in as ${results.userEmail}`
+            : 'Complete';
+        logger(`  ${chalk.green('✓')}  ${formatLabel('Authentication:')} ${authInfo}`);
+    }
+    else if (results.authSkipped) {
+        logger(`  ${chalk.gray('–')}  ${formatLabel('Authentication:')} ${chalk.gray('Skipped (required for most commands)')}`);
+    }
+    // Display AWS accounts status
+    if (results.connectedAccounts.length > 0) {
+        const accountCount = results.connectedAccounts.length;
+        const accountText = accountCount === 1 ? '1 account connected' : `${accountCount} accounts connected`;
+        logger(`  ${chalk.green('✓')}  ${formatLabel('AWS Accounts:')} ${accountText}`);
+    }
+    else {
+        logger(`  ${chalk.gray('–')}  ${formatLabel('AWS Accounts:')} ${chalk.gray('None connected')}`);
+    }
+    // Display Git provider status
+    if (results.gitProvider && !results.gitSkipped) {
+        const providerName = results.gitProvider === 'github' ? 'GitHub' : 'GitLab';
+        const accountInfo = results.gitAccountName ? ` (${results.gitAccountName})` : '';
+        logger(`  ${chalk.green('✓')}  ${formatLabel('Git Provider:')} ${providerName}${accountInfo}`);
+    }
+    else {
+        logger(`  ${chalk.gray('–')}  ${formatLabel('Git Provider:')} ${chalk.gray('Not connected')}`);
+    }
+    // Display Jira integration status
+    if (results.jiraDomain && !results.jiraSkipped) {
+        logger(`  ${chalk.green('✓')}  ${formatLabel('Jira:')} ${results.jiraDomain}`);
+    }
+    else {
+        logger(`  ${chalk.gray('–')}  ${formatLabel('Jira:')} ${chalk.gray('Not connected')}`);
+    }
+    logger('');
+    // Check if all steps are completed
+    const allComplete = results.authCompleted
+        && results.connectedAccounts.length > 0
+        && results.gitProvider
+        && !results.gitSkipped
+        && results.jiraDomain
+        && !results.jiraSkipped;
+    // Display success/warning message
+    if (allComplete) {
+        logger(chalk.green('🎉 Setup complete! You\'re ready to start building.'));
+    }
+    else if (results.authSkipped) {
+        logger(chalk.yellow('⚠️  Authentication is required for most CLI operations.'));
+    }
+    logger('');
+    // Get and display next steps
+    const nextSteps = getNextSteps(results);
+    logger(chalk.blue('Next Steps:'));
+    if (allComplete) {
+        // All complete - show module create suggestion
+        logger(`  Run ${chalk.cyan('`hd module create`')} to create your first serverless module`);
+    }
+    else {
+        // Show numbered list of recommendations
+        nextSteps.forEach((step, index) => {
+            logger(`  ${index + 1}. Run ${chalk.cyan(`\`${step.command}\``)} - ${step.description}`);
+        });
+    }
+    logger('');
+    logger(chalk.gray('For help with any command, run `hd <command> --help`'));
+}

package/dist/utils/validation.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+/**
+ * Validate tenant domain format
+ *
+ * @param domain - The domain string to validate
+ * @returns true if domain format is valid, false otherwise
+ *
+ * @example
+ * validateTenantDomain('acme.hyperdrive.bot') // true
+ * validateTenantDomain('my-company.hyperdrive.bot') // true
+ * validateTenantDomain('client.example.com') // true
+ * validateTenantDomain('subdomain.client.example.io') // true
+ * validateTenantDomain('acme') // false (no TLD)
+ * validateTenantDomain('.hyperdrive.bot') // false (starts with dot)
+ */
+export declare function validateTenantDomain(domain: string): boolean;

package/dist/utils/validation.js ADDED Viewed

@@ -0,0 +1,32 @@
+/**
+ * Domain validation regex pattern
+ *
+ * Accepts:
+ * - subdomain.hyperdrive.bot (official Hyperdrive domains)
+ * - custom domains like client.example.com
+ *
+ * Pattern breakdown:
+ * - ^[a-z0-9-]+\.hyperdrive\.bot$ - Matches hyperdrive.bot subdomains
+ * - ^[a-z0-9][a-z0-9.-]*\.[a-z]{2,}$ - Matches custom domains with valid TLD
+ */
+const DOMAIN_REGEX = /^[a-z0-9-]+\.hyperdrive\.bot$|^[a-z0-9][a-z0-9.-]*\.[a-z]{2,}$/i;
+/**
+ * Validate tenant domain format
+ *
+ * @param domain - The domain string to validate
+ * @returns true if domain format is valid, false otherwise
+ *
+ * @example
+ * validateTenantDomain('acme.hyperdrive.bot') // true
+ * validateTenantDomain('my-company.hyperdrive.bot') // true
+ * validateTenantDomain('client.example.com') // true
+ * validateTenantDomain('subdomain.client.example.io') // true
+ * validateTenantDomain('acme') // false (no TLD)
+ * validateTenantDomain('.hyperdrive.bot') // false (starts with dot)
+ */
+export function validateTenantDomain(domain) {
+    if (!domain || typeof domain !== 'string') {
+        return false;
+    }
+    return DOMAIN_REGEX.test(domain.trim());
+}