@stacksjs/ts-cloud 0.1.3 → 0.1.5

package/dist/aws/ssm.d.ts

@@ -0,0 +1,179 @@
+import { AWSClient } from './client';
+export declare interface Parameter {
+  Name?: string
+  Type?: 'String' | 'StringList' | 'SecureString'
+  Value?: string
+  Version?: number
+  LastModifiedDate?: string
+  ARN?: string
+  DataType?: string
+  Description?: string
+  AllowedPattern?: string
+  KeyId?: string
+  Tier?: 'Standard' | 'Advanced' | 'Intelligent-Tiering'
+}
+export declare interface ParameterHistory {
+  Name?: string
+  Type?: 'String' | 'StringList' | 'SecureString'
+  KeyId?: string
+  LastModifiedDate?: string
+  LastModifiedUser?: string
+  Description?: string
+  Value?: string
+  Version?: number
+  Labels?: string[]
+  Tier?: string
+}
+export declare interface PutParameterOptions {
+  Name: string
+  Value: string
+  Type?: 'String' | 'StringList' | 'SecureString'
+  Description?: string
+  KeyId?: string
+  Overwrite?: boolean
+  AllowedPattern?: string
+  Tags?: { Key: string, Value: string }[]
+  Tier?: 'Standard' | 'Advanced' | 'Intelligent-Tiering'
+  DataType?: string
+}
+export declare interface GetParameterOptions {
+  Name: string
+  WithDecryption?: boolean
+}
+export declare interface GetParametersOptions {
+  Names: string[]
+  WithDecryption?: boolean
+}
+export declare interface GetParametersByPathOptions {
+  Path: string
+  Recursive?: boolean
+  WithDecryption?: boolean
+  MaxResults?: number
+  NextToken?: string
+  ParameterFilters?: {
+    Key: string
+    Option?: string
+    Values?: string[]
+  }[]
+}
+export declare interface DeleteParameterOptions {
+  Name: string
+}
+/**
+ * SSM Parameter Store client using direct API calls
+ */
+export declare class SSMClient {
+  private client: AWSClient;
+  private region: string;
+  constructor(region?: string, profile?: string);
+  putParameter(options: PutParameterOptions): Promise<{
+    Version?: number
+    Tier?: string
+  }>;
+  getParameter(options: GetParameterOptions): Promise<{
+    Parameter?: Parameter
+  }>;
+  getParameters(options: GetParametersOptions): Promise<{
+    Parameters?: Parameter[]
+    InvalidParameters?: string[]
+  }>;
+  getParametersByPath(options: GetParametersByPathOptions): Promise<{
+    Parameters?: Parameter[]
+    NextToken?: string
+  }>;
+  deleteParameter(options: DeleteParameterOptions): Promise<void>;
+  deleteParameters(names: string[]): Promise<{
+    DeletedParameters?: string[]
+    InvalidParameters?: string[]
+  }>;
+  describeParameters(options?: {
+    Filters?: { Key: string, Values: string[] }[]
+    ParameterFilters?: { Key: string, Option?: string, Values?: string[] }[]
+    MaxResults?: number
+    NextToken?: string
+  }): Promise<{
+    Parameters?: Parameter[]
+    NextToken?: string
+  }>;
+  getParameterHistory(options: {
+    Name: string
+    WithDecryption?: boolean
+    MaxResults?: number
+    NextToken?: string
+  }): Promise<{
+    Parameters?: ParameterHistory[]
+    NextToken?: string
+  }>;
+  labelParameterVersion(options: {
+    Name: string
+    ParameterVersion?: number
+    Labels: string[]
+  }): Promise<{
+    InvalidLabels?: string[]
+    ParameterVersion?: number
+  }>;
+  addTagsToResource(options: {
+    ResourceType: 'Parameter'
+    ResourceId: string
+    Tags: { Key: string, Value: string }[]
+  }): Promise<void>;
+  removeTagsFromResource(options: {
+    ResourceType: 'Parameter'
+    ResourceId: string
+    TagKeys: string[]
+  }): Promise<void>;
+  listTagsForResource(options: {
+    ResourceType: 'Parameter'
+    ResourceId: string
+  }): Promise<{
+    TagList?: { Key: string, Value: string }[]
+  }>;
+  setString(name: string, value: string, options?: {
+    description?: string
+    overwrite?: boolean
+    tags?: { Key: string, Value: string }[]
+  }): Promise<{ Version?: number }>;
+  setSecureString(name: string, value: string, options?: {
+    description?: string
+    overwrite?: boolean
+    kmsKeyId?: string
+    tags?: { Key: string, Value: string }[]
+  }): Promise<{ Version?: number }>;
+  getValue(name: string): Promise<string | undefined>;
+  getAllByPath(path: string, recursive?: boolean): Promise<Parameter[]>;
+  private parseParameter(p: any): Parameter;
+  sendCommand(options: {
+    InstanceIds: string[]
+    DocumentName: string
+    Parameters?: Record<string, string[]>
+    TimeoutSeconds?: number
+    Comment?: string
+    OutputS3BucketName?: string
+    OutputS3KeyPrefix?: string
+  }): Promise<{
+    CommandId?: string
+    Status?: string
+    StatusDetails?: string
+  }>;
+  getCommandInvocation(options: {
+    CommandId: string
+    InstanceId: string
+  }): Promise<{
+    Status?: string
+    StatusDetails?: string
+    StandardOutputContent?: string
+    StandardErrorContent?: string
+    ResponseCode?: number
+  }>;
+  runShellCommand(instanceId: string, commands: string[], options?: {
+    timeoutSeconds?: number
+    waitForCompletion?: boolean
+    pollIntervalMs?: number
+    maxWaitMs?: number
+  }): Promise<{
+    success: boolean
+    output?: string
+    error?: string
+    status?: string
+  }>;
+}

package/dist/aws/sts.d.ts

@@ -0,0 +1,15 @@
+import { AWSClient } from './client';
+export declare interface CallerIdentity {
+  UserId?: string
+  Account?: string
+  Arn?: string
+}
+/**
+ * STS (Security Token Service) management using direct API calls
+ */
+export declare class STSClient {
+  private client: AWSClient;
+  private region: string;
+  constructor(region?: string, profile?: string);
+  getCallerIdentity(): Promise<CallerIdentity>;
+}

package/dist/aws/support.d.ts

@@ -0,0 +1,104 @@
+import { AWSClient } from './client';
+/**
+ * Pre-built support case templates for common requests
+ */
+export declare const SupportTemplates: {
+  /**
+   * Request to exit SMS sandbox
+   */
+  smsSandboxExit: (params: SmsSandboxExitParams) => any;
+  /**
+   * Request to increase SMS spending limit
+   */
+  smsSpendLimitIncrease: (params: SmsSpendLimitIncreaseParams) => any;
+  /**
+   * Request SES production access (exit sandbox)
+   */
+  sesSandboxExit: (params: SesSandboxExitParams) => any;
+  /**
+   * Request Connect phone number limit increase
+   */
+  connectPhoneNumberIncrease: (params: ConnectPhoneNumberIncreaseParams) => any
+};
+export declare interface SupportCase {
+  caseId?: string
+  displayId?: string
+  subject?: string
+  status?: string
+  serviceCode?: string
+  categoryCode?: string
+  severityCode?: string
+  submittedBy?: string
+  timeCreated?: string
+  recentCommunications?: {
+    communications?: Array<{
+      body?: string
+      submittedBy?: string
+      timeCreated?: string
+    }>
+  }
+}
+export declare interface CreateCaseParams {
+  subject: string
+  communicationBody: string
+  serviceCode: string
+  categoryCode: string
+  severityCode?: 'low' | 'normal' | 'high' | 'urgent' | 'critical'
+  ccEmailAddresses?: string[]
+  language?: string
+  issueType?: 'customer-service' | 'technical'
+  attachmentSetId?: string
+}
+export declare interface SupportService {
+  code: string
+  name: string
+  categories?: Array<{
+    code: string
+    name: string
+  }>
+}
+export declare interface SmsSandboxExitParams {
+  companyName: string
+  useCase: string
+  expectedMonthlyVolume: number
+  websiteUrl?: string
+}
+export declare interface SmsSpendLimitIncreaseParams {
+  companyName: string
+  currentLimit: number
+  requestedLimit: number
+  useCase: string
+}
+export declare interface SesSandboxExitParams {
+  companyName: string
+  websiteUrl: string
+  useCase: string
+  expectedDailyVolume: number
+}
+export declare interface ConnectPhoneNumberIncreaseParams {
+  companyName: string
+  instanceId: string
+  currentLimit: number
+  requestedLimit: number
+  useCase: string
+}
+/**
+ * AWS Support client for creating and managing support cases
+ */
+export declare class SupportClient {
+  private client: AWSClient;
+  private region: string;
+  constructor(region?: string);
+  createCase(params: CreateCaseParams): Promise<{ caseId?: string }>;
+  describeCase(caseId: string): Promise<SupportCase | null>;
+  listCases(options?: {
+    includeResolved?: boolean
+    maxResults?: number
+    nextToken?: string
+  }): Promise<{ cases: SupportCase[], nextToken?: string }>;
+  addCommunication(caseId: string, message: string, ccEmailAddresses?: string[]): Promise<boolean>;
+  resolveCase(caseId: string): Promise<{ initialCaseStatus?: string, finalCaseStatus?: string }>;
+  describeServices(serviceCodeList?: string[]): Promise<SupportService[]>;
+  describeSeverityLevels(): Promise<Array<{ code: string, name: string }>>;
+}
+export default SupportClient;

package/dist/aws/textract.d.ts

@@ -0,0 +1,403 @@
+import { AWSClient } from './client';
+/**
+ * Quick text extraction from S3 document
+ */
+export declare function extractTextFromS3(bucket: string, key: string, region?: string): Promise<string>;
+/**
+ * Quick form extraction from S3 document
+ */
+export declare function extractFormsFromS3(bucket: string, key: string, region?: string): Promise<Record<string, string>>;
+/**
+ * Quick table extraction from S3 document
+ */
+export declare function extractTablesFromS3(bucket: string, key: string, region?: string): Promise<string[][][]>;
+// ============================================================================
+// Types
+// ============================================================================
+export declare interface S3Object {
+  Bucket?: string
+  Name?: string
+  Version?: string
+}
+export declare interface Document {
+  Bytes?: Uint8Array
+  S3Object?: S3Object
+}
+export declare interface BoundingBox {
+  Width?: number
+  Height?: number
+  Left?: number
+  Top?: number
+}
+export declare interface Point {
+  X?: number
+  Y?: number
+}
+export declare interface Geometry {
+  BoundingBox?: BoundingBox
+  Polygon?: Point[]
+}
+export declare interface Relationship {
+  Type?: 'VALUE' | 'CHILD' | 'COMPLEX_FEATURES' | 'MERGED_CELL' | 'TITLE' | 'ANSWER' | 'TABLE' | 'TABLE_TITLE' | 'TABLE_FOOTER'
+  Ids?: string[]
+}
+export declare interface Block {
+  BlockType?: 'KEY_VALUE_SET' | 'PAGE' | 'LINE' | 'WORD' | 'TABLE' | 'CELL' | 'SELECTION_ELEMENT' | 'MERGED_CELL' | 'TITLE' | 'QUERY' | 'QUERY_RESULT' | 'SIGNATURE' | 'TABLE_TITLE' | 'TABLE_FOOTER' | 'LAYOUT_TEXT' | 'LAYOUT_TITLE' | 'LAYOUT_HEADER' | 'LAYOUT_FOOTER' | 'LAYOUT_SECTION_HEADER' | 'LAYOUT_PAGE_NUMBER' | 'LAYOUT_LIST' | 'LAYOUT_FIGURE' | 'LAYOUT_TABLE' | 'LAYOUT_KEY_VALUE'
+  Confidence?: number
+  Text?: string
+  TextType?: 'HANDWRITING' | 'PRINTED'
+  RowIndex?: number
+  ColumnIndex?: number
+  RowSpan?: number
+  ColumnSpan?: number
+  Geometry?: Geometry
+  Id?: string
+  Relationships?: Relationship[]
+  EntityTypes?: ('KEY' | 'VALUE' | 'COLUMN_HEADER' | 'TABLE_TITLE' | 'TABLE_FOOTER' | 'TABLE_SECTION_TITLE' | 'TABLE_SUMMARY' | 'STRUCTURED_TABLE' | 'SEMI_STRUCTURED_TABLE')[]
+  SelectionStatus?: 'SELECTED' | 'NOT_SELECTED'
+  Page?: number
+  Query?: {
+    Text: string
+    Alias?: string
+    Pages?: string[]
+  }
+}
+export declare interface DocumentMetadata {
+  Pages?: number
+}
+export declare interface Warning {
+  ErrorCode?: string
+  Pages?: number[]
+}
+export declare interface DetectDocumentTextCommandInput {
+  Document: Document
+}
+export declare interface DetectDocumentTextCommandOutput {
+  DocumentMetadata?: DocumentMetadata
+  Blocks?: Block[]
+  DetectDocumentTextModelVersion?: string
+}
+export declare interface AnalyzeDocumentCommandInput {
+  Document: Document
+  FeatureTypes: ('TABLES' | 'FORMS' | 'QUERIES' | 'SIGNATURES' | 'LAYOUT')[]
+  HumanLoopConfig?: {
+    HumanLoopName: string
+    FlowDefinitionArn: string
+    DataAttributes?: {
+      ContentClassifiers?: ('FreeOfPersonallyIdentifiableInformation' | 'FreeOfAdultContent')[]
+    }
+  }
+  QueriesConfig?: {
+    Queries: Array<{
+      Text: string
+      Alias?: string
+      Pages?: string[]
+    }>
+  }
+  AdaptersConfig?: {
+    Adapters: Array<{
+      AdapterId: string
+      Pages?: string[]
+      Version: string
+    }>
+  }
+}
+export declare interface AnalyzeDocumentCommandOutput {
+  DocumentMetadata?: DocumentMetadata
+  Blocks?: Block[]
+  HumanLoopActivationOutput?: {
+    HumanLoopArn?: string
+    HumanLoopActivationReasons?: string[]
+    HumanLoopActivationConditionsEvaluationResults?: string
+  }
+  AnalyzeDocumentModelVersion?: string
+}
+export declare interface AnalyzeExpenseCommandInput {
+  Document: Document
+}
+export declare interface ExpenseField {
+  Type?: {
+    Text?: string
+    Confidence?: number
+  }
+  LabelDetection?: {
+    Text?: string
+    Geometry?: Geometry
+    Confidence?: number
+  }
+  ValueDetection?: {
+    Text?: string
+    Geometry?: Geometry
+    Confidence?: number
+  }
+  PageNumber?: number
+  Currency?: {
+    Code?: string
+    Confidence?: number
+  }
+  GroupProperties?: Array<{
+    Types?: string[]
+    Id?: string
+  }>
+}
+export declare interface LineItemGroup {
+  LineItemGroupIndex?: number
+  LineItems?: Array<{
+    LineItemExpenseFields?: ExpenseField[]
+  }>
+}
+export declare interface ExpenseDocument {
+  ExpenseIndex?: number
+  SummaryFields?: ExpenseField[]
+  LineItemGroups?: LineItemGroup[]
+  Blocks?: Block[]
+}
+export declare interface AnalyzeExpenseCommandOutput {
+  DocumentMetadata?: DocumentMetadata
+  ExpenseDocuments?: ExpenseDocument[]
+}
+export declare interface AnalyzeIDCommandInput {
+  DocumentPages: Document[]
+}
+export declare interface IdentityDocument {
+  DocumentIndex?: number
+  IdentityDocumentFields?: Array<{
+    Type?: {
+      Text?: string
+      Confidence?: number
+    }
+    ValueDetection?: {
+      Text?: string
+      NormalizedValue?: {
+        Value?: string
+        ValueType?: 'DATE'
+      }
+      Confidence?: number
+    }
+  }>
+  Blocks?: Block[]
+}
+export declare interface AnalyzeIDCommandOutput {
+  IdentityDocuments?: IdentityDocument[]
+  DocumentMetadata?: DocumentMetadata
+  AnalyzeIDModelVersion?: string
+}
+export declare interface StartDocumentTextDetectionCommandInput {
+  DocumentLocation: {
+    S3Object?: S3Object
+  }
+  ClientRequestToken?: string
+  JobTag?: string
+  NotificationChannel?: {
+    SNSTopicArn: string
+    RoleArn: string
+  }
+  OutputConfig?: {
+    S3Bucket: string
+    S3Prefix?: string
+  }
+  KMSKeyId?: string
+}
+export declare interface StartDocumentTextDetectionCommandOutput {
+  JobId?: string
+}
+export declare interface GetDocumentTextDetectionCommandInput {
+  JobId: string
+  MaxResults?: number
+  NextToken?: string
+}
+export declare interface GetDocumentTextDetectionCommandOutput {
+  DocumentMetadata?: DocumentMetadata
+  JobStatus?: 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'PARTIAL_SUCCESS'
+  NextToken?: string
+  Blocks?: Block[]
+  Warnings?: Warning[]
+  StatusMessage?: string
+  DetectDocumentTextModelVersion?: string
+}
+export declare interface StartDocumentAnalysisCommandInput {
+  DocumentLocation: {
+    S3Object?: S3Object
+  }
+  FeatureTypes: ('TABLES' | 'FORMS' | 'QUERIES' | 'SIGNATURES' | 'LAYOUT')[]
+  ClientRequestToken?: string
+  JobTag?: string
+  NotificationChannel?: {
+    SNSTopicArn: string
+    RoleArn: string
+  }
+  OutputConfig?: {
+    S3Bucket: string
+    S3Prefix?: string
+  }
+  KMSKeyId?: string
+  QueriesConfig?: {
+    Queries: Array<{
+      Text: string
+      Alias?: string
+      Pages?: string[]
+    }>
+  }
+  AdaptersConfig?: {
+    Adapters: Array<{
+      AdapterId: string
+      Pages?: string[]
+      Version: string
+    }>
+  }
+}
+export declare interface StartDocumentAnalysisCommandOutput {
+  JobId?: string
+}
+export declare interface GetDocumentAnalysisCommandInput {
+  JobId: string
+  MaxResults?: number
+  NextToken?: string
+}
+export declare interface GetDocumentAnalysisCommandOutput {
+  DocumentMetadata?: DocumentMetadata
+  JobStatus?: 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'PARTIAL_SUCCESS'
+  NextToken?: string
+  Blocks?: Block[]
+  Warnings?: Warning[]
+  StatusMessage?: string
+  AnalyzeDocumentModelVersion?: string
+}
+export declare interface StartExpenseAnalysisCommandInput {
+  DocumentLocation: {
+    S3Object?: S3Object
+  }
+  ClientRequestToken?: string
+  JobTag?: string
+  NotificationChannel?: {
+    SNSTopicArn: string
+    RoleArn: string
+  }
+  OutputConfig?: {
+    S3Bucket: string
+    S3Prefix?: string
+  }
+  KMSKeyId?: string
+}
+export declare interface StartExpenseAnalysisCommandOutput {
+  JobId?: string
+}
+export declare interface GetExpenseAnalysisCommandInput {
+  JobId: string
+  MaxResults?: number
+  NextToken?: string
+}
+export declare interface GetExpenseAnalysisCommandOutput {
+  DocumentMetadata?: DocumentMetadata
+  JobStatus?: 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'PARTIAL_SUCCESS'
+  NextToken?: string
+  ExpenseDocuments?: ExpenseDocument[]
+  Warnings?: Warning[]
+  StatusMessage?: string
+  AnalyzeExpenseModelVersion?: string
+}
+export declare interface StartLendingAnalysisCommandInput {
+  DocumentLocation: {
+    S3Object?: S3Object
+  }
+  ClientRequestToken?: string
+  JobTag?: string
+  NotificationChannel?: {
+    SNSTopicArn: string
+    RoleArn: string
+  }
+  OutputConfig?: {
+    S3Bucket: string
+    S3Prefix?: string
+  }
+  KMSKeyId?: string
+}
+export declare interface StartLendingAnalysisCommandOutput {
+  JobId?: string
+}
+export declare interface GetLendingAnalysisCommandInput {
+  JobId: string
+  MaxResults?: number
+  NextToken?: string
+}
+export declare interface LendingDocument {
+  LendingFields?: Array<{
+    Type?: string
+    KeyDetection?: {
+      Text?: string
+      Geometry?: Geometry
+      Confidence?: number
+    }
+    ValueDetections?: Array<{
+      Text?: string
+      Geometry?: Geometry
+      Confidence?: number
+      SelectionStatus?: 'SELECTED' | 'NOT_SELECTED'
+    }>
+  }>
+  SignatureDetections?: Array<{
+    Confidence?: number
+    Geometry?: Geometry
+  }>
+}
+export declare interface LendingResult {
+  Page?: number
+  PageClassification?: {
+    PageType?: Array<{
+      Value?: string
+      Confidence?: number
+    }>
+    PageNumber?: Array<{
+      Value?: string
+      Confidence?: number
+    }>
+  }
+  Extractions?: Array<{
+    LendingDocument?: LendingDocument
+    ExpenseDocument?: ExpenseDocument
+    IdentityDocument?: IdentityDocument
+  }>
+}
+export declare interface GetLendingAnalysisCommandOutput {
+  DocumentMetadata?: DocumentMetadata
+  JobStatus?: 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'PARTIAL_SUCCESS'
+  NextToken?: string
+  Results?: LendingResult[]
+  Warnings?: Warning[]
+  StatusMessage?: string
+  AnalyzeLendingModelVersion?: string
+}
+// ============================================================================
+// Textract Client
+// ============================================================================
+export declare class TextractClient {
+  private client: AWSClient;
+  private region: string;
+  constructor(region?: string);
+  private request<T>(action: string, params: Record<string, unknown>): Promise<T>;
+  detectDocumentText(params: DetectDocumentTextCommandInput): Promise<DetectDocumentTextCommandOutput>;
+  analyzeDocument(params: AnalyzeDocumentCommandInput): Promise<AnalyzeDocumentCommandOutput>;
+  analyzeExpense(params: AnalyzeExpenseCommandInput): Promise<AnalyzeExpenseCommandOutput>;
+  analyzeID(params: AnalyzeIDCommandInput): Promise<AnalyzeIDCommandOutput>;
+  startDocumentTextDetection(params: StartDocumentTextDetectionCommandInput): Promise<StartDocumentTextDetectionCommandOutput>;
+  getDocumentTextDetection(params: GetDocumentTextDetectionCommandInput): Promise<GetDocumentTextDetectionCommandOutput>;
+  startDocumentAnalysis(params: StartDocumentAnalysisCommandInput): Promise<StartDocumentAnalysisCommandOutput>;
+  getDocumentAnalysis(params: GetDocumentAnalysisCommandInput): Promise<GetDocumentAnalysisCommandOutput>;
+  startExpenseAnalysis(params: StartExpenseAnalysisCommandInput): Promise<StartExpenseAnalysisCommandOutput>;
+  getExpenseAnalysis(params: GetExpenseAnalysisCommandInput): Promise<GetExpenseAnalysisCommandOutput>;
+  startLendingAnalysis(params: StartLendingAnalysisCommandInput): Promise<StartLendingAnalysisCommandOutput>;
+  getLendingAnalysis(params: GetLendingAnalysisCommandInput): Promise<GetLendingAnalysisCommandOutput>;
+  extractText(document: Document): Promise<string[]>;
+  extractTextFromS3(bucket: string, key: string): Promise<string[]>;
+  extractForms(document: Document): Promise<Array<{ key: string; value: string; confidence: number }>>;
+  extractTables(document: Document): Promise<Array<{ rows: string[][] }>>;
+  extractExpenseSummary(document: Document): Promise<{
+    vendor?: string
+    total?: string
+    date?: string
+    items: Array<{ description?: string; quantity?: string; price?: string }>
+  }>;
+  queryDocument(document: Document, questions: string[]): Promise<Array<{ question: string; answer: string; confidence: number }>>;
+  waitForJob(jobId: string, getJob: (jobId: string) => Promise<{ JobStatus?: string }>, options?: { maxWaitMs?: number; pollIntervalMs?: number }): Promise<void>;
+  private getBlockText(block: Block, blockMap: Map<string, Block>): string;
+}