@stacksjs/ts-cloud 0.2.3 → 0.2.5

package/dist/ssl/letsencrypt.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Let's Encrypt Integration for Stacks
+ *
+ * Provides utilities for obtaining and managing Let's Encrypt certificates.
+ * Supports both HTTP-01 and DNS-01 challenges with multiple DNS providers.
+ */
+import type { DnsProviderConfig } from '../dns/types';
+export interface LetsEncryptConfig {
+    /**
+     * Domain names to obtain certificate for
+     */
+    domains: string[];
+    /**
+     * Email for Let's Encrypt notifications
+     */
+    email: string;
+    /**
+     * Use staging server for testing
+     * @default false
+     */
+    staging?: boolean;
+    /**
+     * Challenge type
+     * - 'http-01': Serve challenge file via HTTP (requires port 80)
+     * - 'dns-01': Add TXT record to DNS (works behind load balancers)
+     * @default 'http-01'
+     */
+    challengeType?: 'http-01' | 'dns-01';
+    /**
+     * Route53 hosted zone ID (required for dns-01 challenge with Route53)
+     * @deprecated Use dnsProvider config instead
+     */
+    hostedZoneId?: string;
+    /**
+     * DNS provider configuration for dns-01 challenge
+     * Supports: route53, porkbun, godaddy
+     */
+    dnsProvider?: DnsProviderConfig;
+    /**
+     * Certificate storage path
+     * @default '/etc/letsencrypt/live'
+     */
+    certPath?: string;
+    /**
+     * Auto-renew certificates
+     * @default true
+     */
+    autoRenew?: boolean;
+}
+/**
+ * DNS-01 challenge configuration for programmatic use
+ */
+export interface Dns01ChallengeConfig {
+    domain: string;
+    challengeValue: string;
+    /**
+     * Route53 hosted zone ID (legacy, use dnsProvider instead)
+     * @deprecated Use dnsProvider config instead
+     */
+    hostedZoneId?: string;
+    /**
+     * DNS provider configuration
+     */
+    dnsProvider?: DnsProviderConfig;
+    /**
+     * AWS region (only for Route53)
+     */
+    region?: string;
+}
+/**
+ * Generate UserData script for Let's Encrypt certificate setup on EC2
+ * This creates a complete setup that handles certificate acquisition and renewal
+ */
+export declare function generateLetsEncryptUserData(config: LetsEncryptConfig): string;
+/**
+ * Generate server configuration for HTTPS with Let's Encrypt
+ */
+export declare function generateHttpsServerCode(options: {
+    httpPort?: number;
+    httpsPort?: number;
+    certPath?: string;
+    redirectHttp?: boolean;
+}): string;
+/**
+ * Setup DNS-01 challenge programmatically using any DNS provider
+ * This is the unified API that works with Route53, Porkbun, GoDaddy, etc.
+ */
+export declare function setupDns01Challenge(options: Dns01ChallengeConfig): Promise<void>;
+/**
+ * Clean up DNS-01 challenge record using any DNS provider
+ */
+export declare function cleanupDns01Challenge(options: Dns01ChallengeConfig): Promise<void>;
+/**
+ * Check if certificates need renewal (< 30 days until expiry)
+ */
+export declare function needsRenewal(certPath: string): boolean;

package/dist/utils/cli.d.ts

@@ -0,0 +1,121 @@
+/**
+ * CLI Utility Functions
+ * Helpers for colored output, spinners, prompts, and formatting
+ */
+export declare const colors: {
+    reset: string;
+    bright: string;
+    dim: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+};
+/**
+ * Colorize text
+ */
+export declare function colorize(text: string, color: keyof typeof colors): string;
+/**
+ * Success message
+ */
+export declare function success(message: string): void;
+/**
+ * Error message
+ */
+export declare function error(message: string): void;
+/**
+ * Warning message
+ */
+export declare function warn(message: string): void;
+/**
+ * Warning message (alias)
+ */
+export declare const warning: typeof warn;
+/**
+ * Info message
+ */
+export declare function info(message: string): void;
+/**
+ * Step message
+ */
+export declare function step(message: string): void;
+/**
+ * Header message
+ */
+export declare function header(message: string): void;
+export declare class Spinner {
+    private frames;
+    private interval;
+    private currentFrame;
+    private message;
+    constructor(message: string);
+    get text(): string;
+    set text(value: string);
+    start(): void;
+    succeed(message?: string): void;
+    fail(message?: string): void;
+    warn(message?: string): void;
+    stop(): void;
+}
+/**
+ * Progress bar
+ */
+export declare class ProgressBar {
+    private total;
+    private current;
+    private width;
+    constructor(total: number);
+    update(current: number): void;
+    increment(): void;
+    private render;
+}
+/**
+ * Prompt for user input
+ */
+export declare function prompt(message: string, defaultValue?: string): Promise<string>;
+/**
+ * Prompt for confirmation (yes/no)
+ */
+export declare function confirm(message: string, defaultValue?: boolean): Promise<boolean>;
+/**
+ * Select from a list of options
+ */
+export declare function select(message: string, options: string[]): Promise<string>;
+/**
+ * Format a table
+ */
+export declare function table(headers: string[], rows: string[][]): void;
+/**
+ * Format bytes to human readable
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Format duration to human readable
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Box a message
+ */
+export declare function box(message: string, color?: keyof typeof colors): void;
+/**
+ * Check if AWS CLI is installed (deprecated - no longer required)
+ * @deprecated AWS CLI is no longer required. Use checkAwsCredentials() instead.
+ */
+export declare function checkAwsCli(): Promise<boolean>;
+/**
+ * Check if AWS credentials are configured
+ * Uses direct API call to STS GetCallerIdentity
+ */
+export declare function checkAwsCredentials(): Promise<boolean>;
+/**
+ * Get AWS account ID using direct STS API call
+ */
+export declare function getAwsAccountId(): Promise<string | null>;
+/**
+ * Get AWS regions using direct EC2 API call
+ */
+export declare function getAwsRegions(): Promise<string[]>;

package/dist/validation/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Template and Configuration Validation
+ */
+export * from './template';

package/dist/validation/template.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CloudFormation Template Validation
+ * Validates templates before deployment
+ */
+import type { CloudFormationTemplate } from '@ts-cloud/aws-types';
+export interface ValidationError {
+    path: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+}
+/**
+ * Validate a CloudFormation template
+ */
+export declare function validateTemplate(template: CloudFormationTemplate): ValidationResult;
+/**
+ * Validate template size
+ */
+export declare function validateTemplateSize(templateBody: string): ValidationResult;
+/**
+ * Validate template resource limits
+ */
+export declare function validateResourceLimits(template: CloudFormationTemplate): ValidationResult;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/ts-cloud",
   "type": "module",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "A lightweight, performant infrastructure-as-code library and CLI for deploying both server-based (EC2) and serverless applications.",
   "author": "Chris Breuer <chris@stacksjs.com>",
   "license": "MIT",
@@ -61,7 +61,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "bun --bun build.ts && bun run compile",
+    "build": "bun --bun build.ts",
     "compile": "bun build ./bin/cli.ts --compile --minify --outfile bin/cloud",
     "compile:all": "bun run compile:linux-x64 && bun run compile:linux-arm64 && bun run compile:windows-x64 && bun run compile:darwin-x64 && bun run compile:darwin-arm64",
     "compile:linux-x64": "bun build ./bin/cli.ts --compile --minify --target=bun-linux-x64 --outfile bin/cloud-linux-x64",
@@ -81,17 +81,17 @@
     "format": "bunx --bun pickier format .",
     "format:fix": "bunx --bun pickier format . --write",
     "fresh": "bunx rimraf node_modules/ bun.lock && bun i",
-    "prepublishOnly": "bun --bun run build && bun run compile:all && bun run zip",
+    "prepublishOnly": "bun --bun run build",
     "test": "bun test"
   },
   "dependencies": {
-    "@ts-cloud/aws-types": "0.2.3",
-    "@ts-cloud/core": "0.2.3",
+    "@ts-cloud/aws-types": "0.2.5",
+    "@ts-cloud/core": "0.2.5",
     "@stacksjs/ts-xml": "^0.1.0"
   },
   "devDependencies": {
     "bunfig": "^0.15.6",
-    "better-dx": "^0.2.6"
+    "better-dx": "^0.2.12"
   },
   "lint-staged": {
     "*.{js,ts,json,yaml,yml,md}": "bunx --bun pickier lint --fix"