@stacksjs/ts-cloud 0.2.2 → 0.2.5

package/dist/aws/client.d.ts

@@ -0,0 +1,181 @@
+/**
+ * AWS API Client - Direct API calls without AWS CLI
+ * Implements AWS Signature Version 4 for authentication
+ */
+export interface AWSCredentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+}
+export interface AWSRequestOptions {
+    service: string;
+    region: string;
+    method: string;
+    path: string;
+    queryParams?: Record<string, string>;
+    headers?: Record<string, string>;
+    body?: string;
+    credentials?: AWSCredentials;
+    retries?: number;
+    cacheKey?: string;
+    cacheTTL?: number;
+    returnHeaders?: boolean;
+    rawResponse?: boolean;
+    /** S3 bucket name for virtual-hosted style URLs */
+    bucket?: string;
+}
+export interface AWSClientConfig {
+    maxRetries?: number;
+    retryDelay?: number;
+    cacheEnabled?: boolean;
+    defaultCacheTTL?: number;
+}
+export interface AWSError extends Error {
+    code?: string;
+    statusCode?: number;
+    requestId?: string;
+    type?: string;
+}
+/**
+ * AWS API Client - Makes authenticated requests to AWS services
+ */
+export declare class AWSClient {
+    private credentials?;
+    private config;
+    private cache;
+    private xmlParser;
+    constructor(credentials?: AWSCredentials, config?: AWSClientConfig);
+    /**
+     * Load AWS credentials from environment variables, credentials file, or EC2 instance metadata
+     */
+    private loadCredentials;
+    /**
+     * Load credentials from ~/.aws/credentials file
+     */
+    private loadCredentialsFromFile;
+    /**
+     * Parse AWS credentials file (INI format)
+     */
+    private parseCredentialsFile;
+    /**
+     * Cache for EC2 instance metadata credentials
+     */
+    private ec2CredentialsCache?;
+    /**
+     * Get credentials, fetching from credentials file or EC2 metadata if needed
+     */
+    private getCredentials;
+    /**
+     * Make a signed AWS API request with retry logic and caching
+     */
+    request(options: AWSRequestOptions): Promise<any>;
+    /**
+     * Make the actual HTTP request
+     */
+    private makeRequest;
+    /**
+     * Convert Headers object to plain object
+     */
+    private headersToObject;
+    /**
+     * Build the full URL for the request
+     */
+    private buildUrl;
+    /**
+     * Sign the request using AWS Signature Version 4
+     */
+    private signRequest;
+    /**
+     * Get AMZ date format (YYYYMMDDTHHMMSSZ)
+     */
+    private getAmzDate;
+    /**
+     * Get date stamp (YYYYMMDD)
+     */
+    private getDateStamp;
+    /**
+     * URI-encode a string per RFC 3986
+     */
+    private uriEncode;
+    /**
+     * SHA256 hash
+     */
+    private sha256;
+    /**
+     * HMAC SHA256
+     */
+    private hmac;
+    /**
+     * Get signature key
+     */
+    private getSignatureKey;
+    /**
+     * Parse XML response using ts-xml
+     */
+    private parseXmlResponse;
+    /**
+     * Parse error response and create detailed error object
+     */
+    private parseError;
+    /**
+     * Create error from XML error object
+     */
+    private createErrorFromXml;
+    /**
+     * Check if error code is retryable
+     */
+    private isRetryableError;
+    /**
+     * Check if HTTP status code is retryable
+     */
+    private isRetryableStatusCode;
+    /**
+     * Determine if an error should be retried
+     */
+    private shouldRetry;
+    /**
+     * Calculate retry delay with exponential backoff
+     */
+    private calculateRetryDelay;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Get value from cache
+     */
+    private getFromCache;
+    /**
+     * Set value in cache
+     */
+    private setInCache;
+    /**
+     * Clear cache
+     */
+    clearCache(): void;
+    /**
+     * Clear expired cache entries
+     */
+    clearExpiredCache(): void;
+}
+/**
+ * Build query string for AWS API calls
+ */
+export declare function buildQueryParams(params: Record<string, any>): Record<string, string>;
+/**
+ * Describes where AWS credentials will be loaded from based on current env state.
+ * Useful for diagnostics — surfaces which source the deploy will actually use
+ * before any AWS calls happen.
+ */
+export interface CredentialSourceInfo {
+    source: 'env' | 'file' | 'ec2' | 'none';
+    /** Profile name when source is 'file' */
+    profile?: string;
+    /** Empty AWS_ACCESS_KEY_ID env var was found — likely a misconfigured .env */
+    emptyEnvKey?: boolean;
+    /** Empty AWS_SECRET_ACCESS_KEY env var was found */
+    emptyEnvSecret?: boolean;
+    /** Human-readable description */
+    description: string;
+}
+export declare function detectCredentialSource(): CredentialSourceInfo;

package/dist/aws/cloudformation.d.ts

@@ -0,0 +1,187 @@
+/**
+ * AWS CloudFormation Operations
+ * Direct API calls without AWS CLI dependency
+ */
+export interface StackParameter {
+    ParameterKey: string;
+    ParameterValue: string;
+    UsePreviousValue?: boolean;
+}
+export interface StackTag {
+    Key: string;
+    Value: string;
+}
+export interface CreateStackOptions {
+    stackName: string;
+    templateBody?: string;
+    templateUrl?: string;
+    parameters?: StackParameter[];
+    capabilities?: string[];
+    roleArn?: string;
+    tags?: StackTag[];
+    timeoutInMinutes?: number;
+    onFailure?: 'DO_NOTHING' | 'ROLLBACK' | 'DELETE';
+}
+export interface UpdateStackOptions {
+    stackName: string;
+    templateBody?: string;
+    templateUrl?: string;
+    parameters?: StackParameter[];
+    capabilities?: string[];
+    roleArn?: string;
+    tags?: StackTag[];
+}
+export interface DescribeStacksOptions {
+    stackName?: string;
+}
+export interface StackEvent {
+    Timestamp: string;
+    ResourceType: string;
+    LogicalResourceId: string;
+    ResourceStatus: string;
+    ResourceStatusReason?: string;
+}
+export interface Stack {
+    StackId: string;
+    StackName: string;
+    StackStatus: string;
+    StackStatusReason?: string;
+    CreationTime: string;
+    LastUpdatedTime?: string;
+    Parameters?: StackParameter[];
+    Outputs?: Array<{
+        OutputKey: string;
+        OutputValue: string;
+        Description?: string;
+        ExportName?: string;
+    }>;
+    Tags?: StackTag[];
+}
+/**
+ * CloudFormation stack management using direct API calls
+ */
+export declare class CloudFormationClient {
+    private client;
+    private region;
+    constructor(region?: string, profile?: string);
+    /**
+     * Create a new CloudFormation stack
+     */
+    createStack(options: CreateStackOptions): Promise<{
+        StackId: string;
+    }>;
+    /**
+     * Update an existing CloudFormation stack
+     */
+    updateStack(options: UpdateStackOptions): Promise<{
+        StackId: string;
+    }>;
+    /**
+     * Delete a CloudFormation stack
+     */
+    deleteStack(stackName: string, roleArn?: string, retainResources?: string[]): Promise<void>;
+    /**
+     * Describe CloudFormation stacks
+     */
+    describeStacks(options?: DescribeStacksOptions): Promise<{
+        Stacks: Stack[];
+    }>;
+    /**
+     * Get stack events
+     */
+    describeStackEvents(stackName: string): Promise<{
+        StackEvents: StackEvent[];
+    }>;
+    /**
+     * List stack resources
+     */
+    listStackResources(stackName: string): Promise<{
+        StackResourceSummaries: any[];
+    }>;
+    /**
+     * Wait for stack to reach a specific status
+     */
+    waitForStack(stackName: string, waitType: 'stack-create-complete' | 'stack-update-complete' | 'stack-delete-complete'): Promise<void>;
+    /**
+     * Validate CloudFormation template
+     */
+    validateTemplate(templateBody: string): Promise<any>;
+    /**
+     * List all stacks
+     */
+    listStacks(statusFilter?: string[]): Promise<{
+        StackSummaries: Array<{
+            StackId: string;
+            StackName: string;
+            TemplateDescription?: string;
+            CreationTime: string;
+            LastUpdatedTime?: string;
+            DeletionTime?: string;
+            StackStatus: string;
+        }>;
+    }>;
+    /**
+     * Create change set (for preview before updating)
+     */
+    createChangeSet(options: {
+        stackName: string;
+        changeSetName: string;
+        templateBody?: string;
+        templateUrl?: string;
+        parameters?: StackParameter[];
+        capabilities?: string[];
+        changeSetType?: 'CREATE' | 'UPDATE';
+    }): Promise<{
+        Id: string;
+        StackId: string;
+    }>;
+    /**
+     * Describe change set
+     */
+    describeChangeSet(stackName: string, changeSetName: string): Promise<any>;
+    /**
+     * Execute change set
+     */
+    executeChangeSet(stackName: string, changeSetName: string): Promise<void>;
+    /**
+     * Delete change set
+     */
+    deleteChangeSet(stackName: string, changeSetName: string): Promise<void>;
+    /**
+     * Get stack outputs as key-value pairs
+     */
+    getStackOutputs(stackName: string): Promise<Record<string, string>>;
+    /**
+     * Get stack template
+     */
+    getTemplate(stackName: string): Promise<{
+        TemplateBody: string;
+    }>;
+    /**
+     * Parse stacks response
+     */
+    private parseStacksResponse;
+    /**
+     * Parse stack events response
+     */
+    private parseStackEvents;
+    /**
+     * Wait for stack with real-time progress output (CDK-style)
+     */
+    waitForStackWithProgress(stackName: string, waitType: 'stack-create-complete' | 'stack-update-complete' | 'stack-delete-complete', onProgress?: (event: {
+        resourceId: string;
+        resourceType: string;
+        status: string;
+        reason?: string;
+        timestamp: string;
+    }) => void): Promise<void>;
+    /**
+     * Wait for stack operation to complete (create, update, or delete)
+     * Returns a result object with success status
+     */
+    waitForStackComplete(stackName: string, maxAttempts?: number, delayMs?: number): Promise<{
+        success: boolean;
+        status: string;
+        reason?: string;
+    }>;
+}