@stacksjs/ts-cloud 0.1.2 → 0.1.5

package/dist/aws/client.d.ts

@@ -0,0 +1,79 @@
+import { XMLParser } from 'fast-xml-parser';
+/**
+ * Build query string for AWS API calls
+ */
+export declare function buildQueryParams(params: Record<string, any>): Record<string, string>;
+export declare interface AWSCredentials {
+  accessKeyId: string
+  secretAccessKey: string
+  sessionToken?: string
+}
+export declare 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
+  bucket?: string
+}
+export declare interface AWSClientConfig {
+  maxRetries?: number
+  retryDelay?: number
+  cacheEnabled?: boolean
+  defaultCacheTTL?: number
+}
+export declare 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?: AWSCredentials;
+  private config: AWSClientConfig;
+  private cache: Map<string, CacheEntry>;
+  private xmlParser: XMLParser;
+  constructor(credentials?: AWSCredentials, config?: AWSClientConfig);
+  private loadCredentials(): AWSCredentials;
+  private loadCredentialsFromFile(): AWSCredentials | null;
+  private parseCredentialsFile(content: string, profile: string): AWSCredentials;
+  private ec2CredentialsCache?: {
+    credentials: AWSCredentials
+    expiration: number
+  };
+  private getCredentials(): Promise<AWSCredentials>;
+  request(options: AWSRequestOptions): Promise<any>;
+  private makeRequest(options: AWSRequestOptions): Promise<any>;
+  private headersToObject(headers: Headers): Record<string, string>;
+  private buildUrl(options: AWSRequestOptions): string;
+  private signRequest(options: AWSRequestOptions, credentials: AWSCredentials): Record<string, string>;
+  private getAmzDate(date: Date): string;
+  private getDateStamp(date: Date): string;
+  private uriEncode(str: string): string;
+  private sha256(data: string): string;
+  private hmac(key: Buffer | string, data: string): string;
+  private getSignatureKey(key: string, dateStamp: string, region: string, service: string): Buffer;
+  private parseXmlResponse(xml: string): any;
+  private parseError(responseText: string, statusCode: number, headers: Headers): AWSError;
+  private createErrorFromXml(errorData: any): AWSError;
+  private isRetryableError(code: string): boolean;
+  private isRetryableStatusCode(statusCode: number): boolean;
+  private shouldRetry(error: any): boolean;
+  private calculateRetryDelay(attempt: number): number;
+  private sleep(ms: number): Promise<void>;
+  private getFromCache(key: string): any | null;
+  private setInCache(key: string, data: any, ttl: number): void;
+  clearCache(): void;
+  clearExpiredCache(): void;
+}

package/dist/aws/cloudformation.d.ts

@@ -0,0 +1,105 @@
+import { AWSClient } from './client';
+export declare interface StackParameter {
+  ParameterKey: string
+  ParameterValue: string
+  UsePreviousValue?: boolean
+}
+export declare interface StackTag {
+  Key: string
+  Value: string
+}
+export declare interface CreateStackOptions {
+  stackName: string
+  templateBody?: string
+  templateUrl?: string
+  parameters?: StackParameter[]
+  capabilities?: string[]
+  roleArn?: string
+  tags?: StackTag[]
+  timeoutInMinutes?: number
+  onFailure?: 'DO_NOTHING' | 'ROLLBACK' | 'DELETE'
+}
+export declare interface UpdateStackOptions {
+  stackName: string
+  templateBody?: string
+  templateUrl?: string
+  parameters?: StackParameter[]
+  capabilities?: string[]
+  roleArn?: string
+  tags?: StackTag[]
+}
+export declare interface DescribeStacksOptions {
+  stackName?: string
+}
+export declare interface StackEvent {
+  Timestamp: string
+  ResourceType: string
+  LogicalResourceId: string
+  ResourceStatus: string
+  ResourceStatusReason?: string
+}
+export declare 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: AWSClient;
+  private region: string;
+  constructor(region?: string, profile?: string);
+  createStack(options: CreateStackOptions): Promise<{ StackId: string }>;
+  updateStack(options: UpdateStackOptions): Promise<{ StackId: string }>;
+  deleteStack(stackName: string, roleArn?: string, retainResources?: string[]): Promise<void>;
+  describeStacks(options?: DescribeStacksOptions): Promise<{ Stacks: Stack[] }>;
+  describeStackEvents(stackName: string): Promise<{ StackEvents: StackEvent[] }>;
+  listStackResources(stackName: string): Promise<{ StackResourceSummaries: any[] }>;
+  waitForStack(stackName: string, waitType: 'stack-create-complete' | 'stack-update-complete' | 'stack-delete-complete'): Promise<void>;
+  validateTemplate(templateBody: string): Promise<any>;
+  listStacks(statusFilter?: string[]): Promise<{ StackSummaries: Array<{
+    StackId: string
+    StackName: string
+    TemplateDescription?: string
+    CreationTime: string
+    LastUpdatedTime?: string
+    DeletionTime?: string
+    StackStatus: string
+  }> }>;
+  createChangeSet(options: {
+    stackName: string
+    changeSetName: string
+    templateBody?: string
+    templateUrl?: string
+    parameters?: StackParameter[]
+    capabilities?: string[]
+    changeSetType?: 'CREATE' | 'UPDATE'
+  }): Promise<{ Id: string, StackId: string }>;
+  describeChangeSet(stackName: string, changeSetName: string): Promise<any>;
+  executeChangeSet(stackName: string, changeSetName: string): Promise<void>;
+  deleteChangeSet(stackName: string, changeSetName: string): Promise<void>;
+  getStackOutputs(stackName: string): Promise<Record<string, string>>;
+  getTemplate(stackName: string): Promise<{ TemplateBody: string }>;
+  private parseStacksResponse(result: any): Stack[];
+  private parseStackEvents(result: any): StackEvent[];
+  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>;
+  waitForStackComplete(stackName: string, maxAttempts?: number, delayMs?: number): Promise<{ success: boolean; status: string; reason?: string }>;
+}

package/dist/aws/cloudfront.d.ts

@@ -0,0 +1,265 @@
+import { AWSClient } from './client';
+export declare interface InvalidationOptions {
+  distributionId: string
+  paths: string[]
+  callerReference?: string
+}
+export declare interface Distribution {
+  Id: string
+  ARN: string
+  Status: string
+  DomainName: string
+  Aliases?: { Quantity?: number; Items?: string[] }
+  Enabled: boolean
+}
+/**
+ * CloudFront client using direct API calls
+ */
+export declare class CloudFrontClient {
+  private client: AWSClient;
+  constructor(profile?: string);
+  createInvalidation(options: InvalidationOptions): Promise<{
+    Id: string
+    Status: string
+    CreateTime: string
+  }>;
+  getInvalidation(distributionId: string, invalidationId: string): Promise<{
+    Id: string
+    Status: string
+    CreateTime: string
+  }>;
+  listInvalidations(distributionId: string): Promise<Array<{
+    Id: string
+    Status: string
+    CreateTime: string
+  }>>;
+  waitForInvalidation(distributionId: string, invalidationId: string): Promise<void>;
+  listDistributions(): Promise<Distribution[]>;
+  getDistribution(distributionId: string): Promise<Distribution>;
+  getDistributionConfig(distributionId: string): Promise<{
+    ETag: string
+    DistributionConfig: {
+      Origins: {
+        Quantity: number
+        Items: any
+      }
+      DefaultCacheBehavior: {
+        TargetOriginId: string
+        ViewerProtocolPolicy: string
+        AllowedMethods?: { Quantity: number, Items: string[] }
+        CachedMethods?: { Quantity: number, Items: string[] }
+        ForwardedValues?: any
+        TrustedSigners?: any
+        MinTTL?: number
+        DefaultTTL?: number
+        MaxTTL?: number
+      }
+      CacheBehaviors?: {
+        Quantity: number
+        Items: Array<{
+          PathPattern: string
+          TargetOriginId: string
+          ViewerProtocolPolicy: string
+          AllowedMethods?: { Quantity: number, Items: string[] }
+          CachedMethods?: { Quantity: number, Items: string[] }
+          ForwardedValues?: any
+          MinTTL?: number
+          DefaultTTL?: number
+          MaxTTL?: number
+        }>
+      }
+      Aliases?: { Quantity: number, Items: string[] }
+      Comment?: string
+      Enabled: boolean
+    }
+  }>;
+  invalidateAll(distributionId: string): Promise<{
+    Id: string
+    Status: string
+    CreateTime: string
+  }>;
+  invalidatePaths(distributionId: string, paths: string[]): Promise<{
+    Id: string
+    Status: string
+    CreateTime: string
+  }>;
+  invalidatePattern(distributionId: string, pattern: string): Promise<{
+    Id: string
+    Status: string
+    CreateTime: string
+  }>;
+  invalidateAfterDeployment(options: {
+    distributionId: string
+    changedPaths?: string[]
+    invalidateAll?: boolean
+    wait?: boolean
+  }): Promise<{
+    invalidationId: string
+    status: string
+  }>;
+  findDistributionByDomain(domain: string): Promise<Distribution | null>;
+  batchInvalidate(distributionIds: string[], paths?: string[]): Promise<Array<{
+    distributionId: string
+    invalidationId: string
+    status: string
+  }>>;
+  updateCustomErrorResponses(options: {
+    distributionId: string
+    customErrorResponses: Array<{
+      errorCode: number
+      responsePagePath?: string
+      responseCode?: number
+      errorCachingMinTTL?: number
+    }>
+  }): Promise<{
+    Distribution: Distribution
+    ETag: string
+  }>;
+  removeCustomErrorResponses(distributionId: string): Promise<{
+    Distribution: Distribution
+    ETag: string
+  }>;
+  updateDistribution(options: {
+    distributionId: string
+    aliases?: string[]
+    certificateArn?: string
+    comment?: string
+  }): Promise<{
+    Distribution: Distribution
+    ETag: string
+  }>;
+  private buildDistributionConfigXml(config: any): string;
+  addAliases(distributionId: string, aliases: string[], certificateArn: string): Promise<{
+    Distribution: Distribution
+    ETag: string
+  }>;
+  createFunction(options: {
+    name: string
+    code: string
+    comment?: string
+    runtime?: 'cloudfront-js-1.0' | 'cloudfront-js-2.0'
+  }): Promise<{
+    FunctionARN: string
+    Name: string
+    Stage: string
+    ETag: string
+  }>;
+  listFunctions(): Promise<Array<{
+    Name: string
+    FunctionARN: string
+    Stage: string
+    CreatedTime: string
+    LastModifiedTime: string
+  }>>;
+  getFunction(name: string, stage?: 'DEVELOPMENT' | 'LIVE'): Promise<{
+    FunctionARN: string
+    Name: string
+    Stage: string
+    ETag: string
+    FunctionCode?: string
+  } | null>;
+  publishFunction(nameOrOptions: string | { Name: string, IfMatch: string }, etag?: string): Promise<{
+    FunctionARN: string
+    Stage: string
+    FunctionSummary?: {
+      Name: string
+      FunctionMetadata: {
+        FunctionARN: string
+        Stage: string
+      }
+    }
+  }>;
+  describeFunction(options: { Name: string, Stage?: 'DEVELOPMENT' | 'LIVE' }): Promise<{
+    ETag: string
+    FunctionSummary: {
+      Name: string
+      Status: string
+      FunctionConfig: {
+        Comment: string
+        Runtime: string
+      }
+      FunctionMetadata: {
+        FunctionARN: string
+        Stage: string
+        CreatedTime: string
+        LastModifiedTime: string
+      }
+    }
+  }>;
+  updateFunction(options: {
+    Name: string
+    FunctionCode: string
+    FunctionConfig: {
+      Comment: string
+      Runtime: 'cloudfront-js-1.0' | 'cloudfront-js-2.0'
+    }
+    IfMatch: string
+  }): Promise<{
+    ETag: string
+    FunctionSummary: {
+      Name: string
+      FunctionMetadata: {
+        FunctionARN: string
+        Stage: string
+      }
+    }
+  }>;
+  deleteFunction(name: string, etag?: string): Promise<void>;
+  createIndexRewriteFunction(name: string): Promise<{
+    FunctionARN: string
+    Name: string
+    Stage: string
+    ETag: string
+  }>;
+  listOriginAccessControls(): Promise<Array<{
+    Id: string
+    Name: string
+    Description?: string
+    SigningProtocol: string
+    SigningBehavior: string
+    OriginAccessControlOriginType: string
+  }>>;
+  createOriginAccessControl(options: {
+    name: string
+    description?: string
+    signingProtocol?: 'sigv4'
+    signingBehavior?: 'always' | 'never' | 'no-override'
+    originType?: 's3'
+  }): Promise<{
+    Id: string
+    Name: string
+    Description: string
+    SigningProtocol: string
+    SigningBehavior: string
+    OriginAccessControlOriginType: string
+    ETag: string
+  }>;
+  findOrCreateOriginAccessControl(name: string): Promise<{
+    Id: string
+    Name: string
+    isNew: boolean
+  }>;
+  createDistributionForS3(options: {
+    bucketName: string
+    bucketRegion: string
+    originAccessControlId: string
+    aliases?: string[]
+    certificateArn?: string
+    defaultRootObject?: string
+    comment?: string
+    priceClass?: 'PriceClass_100' | 'PriceClass_200' | 'PriceClass_All'
+    enabled?: boolean
+  }): Promise<{
+    Id: string
+    ARN: string
+    DomainName: string
+    Status: string
+    ETag: string
+  }>;
+  static getS3BucketPolicyForCloudFront(bucketName: string, distributionArn: string): object;
+  waitForDistributionDeployed(distributionId: string, maxAttempts?: any): Promise<boolean>;
+  disableDistribution(distributionId: string): Promise<{ ETag: string }>;
+  deleteDistribution(distributionId: string, etag?: string): Promise<void>;
+  waitForDistributionDisabled(distributionId: string, maxAttempts?: any): Promise<boolean>;
+  removeAlias(distributionId: string, alias: string): Promise<{ ETag: string }>;
+}

package/dist/aws/cloudwatch-logs.d.ts

@@ -0,0 +1,48 @@
+import { AWSClient } from './client';
+export declare interface LogEvent {
+  timestamp?: number
+  message?: string
+  ingestionTime?: number
+}
+export declare interface LogStream {
+  logStreamName?: string
+  creationTime?: number
+  firstEventTimestamp?: number
+  lastEventTimestamp?: number
+  lastIngestionTime?: number
+  uploadSequenceToken?: string
+  arn?: string
+  storedBytes?: number
+}
+export declare class CloudWatchLogsClient {
+  private client: AWSClient;
+  private region: string;
+  constructor(region?: string, profile?: string);
+  describeLogStreams(options: {
+    logGroupName: string
+    logStreamNamePrefix?: string
+    orderBy?: 'LogStreamName' | 'LastEventTime'
+    descending?: boolean
+    limit?: number
+  }): Promise<{ logStreams?: LogStream[], nextToken?: string }>;
+  getLogEvents(options: {
+    logGroupName: string
+    logStreamName: string
+    startTime?: number
+    endTime?: number
+    limit?: number
+    startFromHead?: boolean
+  }): Promise<{ events?: LogEvent[], nextForwardToken?: string, nextBackwardToken?: string }>;
+  describeLogGroups(options?: {
+    logGroupNamePrefix?: string
+    limit?: number
+  }): Promise<{ logGroups?: { logGroupName?: string, arn?: string, creationTime?: number }[], nextToken?: string }>;
+  filterLogEvents(options: {
+    logGroupName: string
+    logStreamNames?: string[]
+    startTime?: number
+    endTime?: number
+    filterPattern?: string
+    limit?: number
+  }): Promise<{ events?: LogEvent[], searchedLogStreams?: any[], nextToken?: string }>;
+}