@stacksjs/ts-cloud 0.1.3 → 0.1.5

package/dist/aws/transcribe.d.ts

@@ -0,0 +1,60 @@
+import { AWSClient } from './client';
+export declare interface TranscriptionJob {
+  TranscriptionJobName: string
+  TranscriptionJobStatus: 'QUEUED' | 'IN_PROGRESS' | 'FAILED' | 'COMPLETED'
+  LanguageCode?: string
+  MediaSampleRateHertz?: number
+  MediaFormat?: string
+  Media?: {
+    MediaFileUri?: string
+  }
+  Transcript?: {
+    TranscriptFileUri?: string
+  }
+  StartTime?: string
+  CreationTime?: string
+  CompletionTime?: string
+  FailureReason?: string
+}
+/**
+ * Transcribe client for direct API calls
+ */
+export declare class TranscribeClient {
+  private client: AWSClient;
+  private region: string;
+  constructor(region?: string);
+  private request<T>(action: string, params: Record<string, any>): Promise<T>;
+  startTranscriptionJob(params: {
+    TranscriptionJobName: string
+    LanguageCode: string
+    MediaFormat?: 'mp3' | 'mp4' | 'wav' | 'flac' | 'ogg' | 'amr' | 'webm'
+    Media: {
+      MediaFileUri: string
+    }
+    OutputBucketName?: string
+    OutputKey?: string
+    Settings?: {
+      ShowSpeakerLabels?: boolean
+      MaxSpeakerLabels?: number
+      ChannelIdentification?: boolean
+      ShowAlternatives?: boolean
+      MaxAlternatives?: number
+    }
+  }): Promise<{ TranscriptionJob: TranscriptionJob }>;
+  getTranscriptionJob(params: {
+    TranscriptionJobName: string
+  }): Promise<{ TranscriptionJob: TranscriptionJob }>;
+  listTranscriptionJobs(params?: {
+    Status?: 'QUEUED' | 'IN_PROGRESS' | 'FAILED' | 'COMPLETED'
+    JobNameContains?: string
+    NextToken?: string
+    MaxResults?: number
+  }): Promise<{
+    Status?: string
+    NextToken?: string
+    TranscriptionJobSummaries: TranscriptionJob[]
+  }>;
+  deleteTranscriptionJob(params: {
+    TranscriptionJobName: string
+  }): Promise<void>;
+}

package/dist/aws/translate.d.ts

@@ -0,0 +1,358 @@
+import { AWSClient } from './client';
+/**
+ * Quick translation
+ */
+export declare function translate(text: string, targetLanguage: string, options?: {
+    sourceLanguage?: string
+    region?: string
+  }): Promise<string>;
+/**
+ * Translate to multiple languages
+ */
+export declare function translateToMultiple(text: string, targetLanguages: string[], options?: {
+    sourceLanguage?: string
+    region?: string
+  }): Promise<Record<string, string>>;
+/**
+ * List supported languages
+ */
+export declare function listLanguages(region?: string): Promise<Language[]>;
+// ============================================================================
+// Types
+// ============================================================================
+export declare interface TranslateTextCommandInput {
+  Text: string
+  SourceLanguageCode: string
+  TargetLanguageCode: string
+  TerminologyNames?: string[]
+  Settings?: {
+    Formality?: 'FORMAL' | 'INFORMAL'
+    Profanity?: 'MASK'
+    Brevity?: 'ON'
+  }
+}
+export declare interface TranslatedDocument {
+  Content: Uint8Array
+}
+export declare interface AppliedTerminology {
+  Name?: string
+  Terms?: Array<{
+    SourceText?: string
+    TargetText?: string
+  }>
+}
+export declare interface TranslateTextCommandOutput {
+  TranslatedText: string
+  SourceLanguageCode: string
+  TargetLanguageCode: string
+  AppliedTerminologies?: AppliedTerminology[]
+  AppliedSettings?: {
+    Formality?: 'FORMAL' | 'INFORMAL'
+    Profanity?: 'MASK'
+    Brevity?: 'ON'
+  }
+}
+export declare interface TranslateDocumentCommandInput {
+  Document: {
+    Content: Uint8Array
+    ContentType: 'text/html' | 'text/plain' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
+  }
+  SourceLanguageCode: string
+  TargetLanguageCode: string
+  TerminologyNames?: string[]
+  Settings?: {
+    Formality?: 'FORMAL' | 'INFORMAL'
+    Profanity?: 'MASK'
+    Brevity?: 'ON'
+  }
+}
+export declare interface TranslateDocumentCommandOutput {
+  TranslatedDocument: TranslatedDocument
+  SourceLanguageCode: string
+  TargetLanguageCode: string
+  AppliedTerminologies?: AppliedTerminology[]
+  AppliedSettings?: {
+    Formality?: 'FORMAL' | 'INFORMAL'
+    Profanity?: 'MASK'
+    Brevity?: 'ON'
+  }
+}
+export declare interface StartTextTranslationJobCommandInput {
+  JobName?: string
+  InputDataConfig: {
+    S3Uri: string
+    ContentType: 'text/html' | 'text/plain' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/x-xliff+xml'
+  }
+  OutputDataConfig: {
+    S3Uri: string
+    EncryptionKey?: {
+      Type: 'KMS'
+      Id: string
+    }
+  }
+  DataAccessRoleArn: string
+  SourceLanguageCode: string
+  TargetLanguageCodes: string[]
+  TerminologyNames?: string[]
+  ParallelDataNames?: string[]
+  ClientToken?: string
+  Settings?: {
+    Formality?: 'FORMAL' | 'INFORMAL'
+    Profanity?: 'MASK'
+    Brevity?: 'ON'
+  }
+}
+export declare interface StartTextTranslationJobCommandOutput {
+  JobId?: string
+  JobStatus?: 'SUBMITTED' | 'IN_PROGRESS' | 'COMPLETED' | 'COMPLETED_WITH_ERROR' | 'FAILED' | 'STOP_REQUESTED' | 'STOPPED'
+}
+export declare interface DescribeTextTranslationJobCommandInput {
+  JobId: string
+}
+export declare interface TextTranslationJobProperties {
+  JobId?: string
+  JobName?: string
+  JobStatus?: 'SUBMITTED' | 'IN_PROGRESS' | 'COMPLETED' | 'COMPLETED_WITH_ERROR' | 'FAILED' | 'STOP_REQUESTED' | 'STOPPED'
+  JobDetails?: {
+    TranslatedDocumentsCount?: number
+    DocumentsWithErrorsCount?: number
+    InputDocumentsCount?: number
+  }
+  SourceLanguageCode?: string
+  TargetLanguageCodes?: string[]
+  TerminologyNames?: string[]
+  ParallelDataNames?: string[]
+  Message?: string
+  SubmittedTime?: string
+  EndTime?: string
+  InputDataConfig?: {
+    S3Uri?: string
+    ContentType?: string
+  }
+  OutputDataConfig?: {
+    S3Uri?: string
+    EncryptionKey?: {
+      Type?: string
+      Id?: string
+    }
+  }
+  DataAccessRoleArn?: string
+  Settings?: {
+    Formality?: 'FORMAL' | 'INFORMAL'
+    Profanity?: 'MASK'
+    Brevity?: 'ON'
+  }
+}
+export declare interface DescribeTextTranslationJobCommandOutput {
+  TextTranslationJobProperties?: TextTranslationJobProperties
+}
+export declare interface ListTextTranslationJobsCommandInput {
+  Filter?: {
+    JobName?: string
+    JobStatus?: 'SUBMITTED' | 'IN_PROGRESS' | 'COMPLETED' | 'COMPLETED_WITH_ERROR' | 'FAILED' | 'STOP_REQUESTED' | 'STOPPED'
+    SubmittedBeforeTime?: string
+    SubmittedAfterTime?: string
+  }
+  NextToken?: string
+  MaxResults?: number
+}
+export declare interface ListTextTranslationJobsCommandOutput {
+  TextTranslationJobPropertiesList?: TextTranslationJobProperties[]
+  NextToken?: string
+}
+export declare interface StopTextTranslationJobCommandInput {
+  JobId: string
+}
+export declare interface StopTextTranslationJobCommandOutput {
+  JobId?: string
+  JobStatus?: 'SUBMITTED' | 'IN_PROGRESS' | 'COMPLETED' | 'COMPLETED_WITH_ERROR' | 'FAILED' | 'STOP_REQUESTED' | 'STOPPED'
+}
+export declare interface ListLanguagesCommandInput {
+  DisplayLanguageCode?: string
+  NextToken?: string
+  MaxResults?: number
+}
+export declare interface Language {
+  LanguageName?: string
+  LanguageCode?: string
+}
+export declare interface ListLanguagesCommandOutput {
+  Languages?: Language[]
+  DisplayLanguageCode?: string
+  NextToken?: string
+}
+export declare interface ImportTerminologyCommandInput {
+  Name: string
+  MergeStrategy: 'OVERWRITE'
+  Description?: string
+  TerminologyData: {
+    File: Uint8Array
+    Format: 'CSV' | 'TMX' | 'TSV'
+    Directionality?: 'UNI' | 'MULTI'
+  }
+  EncryptionKey?: {
+    Type: 'KMS'
+    Id: string
+  }
+  Tags?: Array<{ Key: string; Value: string }>
+}
+export declare interface TerminologyProperties {
+  Name?: string
+  Description?: string
+  Arn?: string
+  SourceLanguageCode?: string
+  TargetLanguageCodes?: string[]
+  EncryptionKey?: {
+    Type?: string
+    Id?: string
+  }
+  SizeBytes?: number
+  TermCount?: number
+  CreatedAt?: string
+  LastUpdatedAt?: string
+  Directionality?: 'UNI' | 'MULTI'
+  Message?: string
+  SkippedTermCount?: number
+  Format?: 'CSV' | 'TMX' | 'TSV'
+}
+export declare interface ImportTerminologyCommandOutput {
+  TerminologyProperties?: TerminologyProperties
+  AuxiliaryDataLocation?: {
+    RepositoryType?: string
+    Location?: string
+  }
+}
+export declare interface GetTerminologyCommandInput {
+  Name: string
+  TerminologyDataFormat?: 'CSV' | 'TMX' | 'TSV'
+}
+export declare interface GetTerminologyCommandOutput {
+  TerminologyProperties?: TerminologyProperties
+  TerminologyDataLocation?: {
+    RepositoryType?: string
+    Location?: string
+  }
+  AuxiliaryDataLocation?: {
+    RepositoryType?: string
+    Location?: string
+  }
+}
+export declare interface ListTerminologiesCommandInput {
+  NextToken?: string
+  MaxResults?: number
+}
+export declare interface ListTerminologiesCommandOutput {
+  TerminologyPropertiesList?: TerminologyProperties[]
+  NextToken?: string
+}
+export declare interface DeleteTerminologyCommandInput {
+  Name: string
+}
+export declare interface DeleteTerminologyCommandOutput {
+
+}
+export declare interface CreateParallelDataCommandInput {
+  Name: string
+  Description?: string
+  ParallelDataConfig: {
+    S3Uri: string
+    Format: 'TSV' | 'CSV' | 'TMX'
+  }
+  EncryptionKey?: {
+    Type: 'KMS'
+    Id: string
+  }
+  ClientToken?: string
+  Tags?: Array<{ Key: string; Value: string }>
+}
+export declare interface ParallelDataProperties {
+  Name?: string
+  Arn?: string
+  Description?: string
+  Status?: 'CREATING' | 'UPDATING' | 'ACTIVE' | 'DELETING' | 'FAILED'
+  SourceLanguageCode?: string
+  TargetLanguageCodes?: string[]
+  ParallelDataConfig?: {
+    S3Uri?: string
+    Format?: 'TSV' | 'CSV' | 'TMX'
+  }
+  Message?: string
+  ImportedDataSize?: number
+  ImportedRecordCount?: number
+  FailedRecordCount?: number
+  SkippedRecordCount?: number
+  EncryptionKey?: {
+    Type?: string
+    Id?: string
+  }
+  CreatedAt?: string
+  LastUpdatedAt?: string
+  LatestUpdateAttemptStatus?: 'CREATING' | 'UPDATING' | 'ACTIVE' | 'DELETING' | 'FAILED'
+  LatestUpdateAttemptAt?: string
+}
+export declare interface CreateParallelDataCommandOutput {
+  Name?: string
+  Status?: 'CREATING' | 'UPDATING' | 'ACTIVE' | 'DELETING' | 'FAILED'
+}
+export declare interface GetParallelDataCommandInput {
+  Name: string
+}
+export declare interface GetParallelDataCommandOutput {
+  ParallelDataProperties?: ParallelDataProperties
+  DataLocation?: {
+    RepositoryType?: string
+    Location?: string
+  }
+  AuxiliaryDataLocation?: {
+    RepositoryType?: string
+    Location?: string
+  }
+  LatestUpdateAttemptAuxiliaryDataLocation?: {
+    RepositoryType?: string
+    Location?: string
+  }
+}
+export declare interface ListParallelDataCommandInput {
+  NextToken?: string
+  MaxResults?: number
+}
+export declare interface ListParallelDataCommandOutput {
+  ParallelDataPropertiesList?: ParallelDataProperties[]
+  NextToken?: string
+}
+export declare interface DeleteParallelDataCommandInput {
+  Name: string
+}
+export declare interface DeleteParallelDataCommandOutput {
+  Name?: string
+  Status?: 'CREATING' | 'UPDATING' | 'ACTIVE' | 'DELETING' | 'FAILED'
+}
+// ============================================================================
+// Translate Client
+// ============================================================================
+export declare class TranslateClient {
+  private client: AWSClient;
+  private region: string;
+  constructor(region?: string);
+  private request<T>(action: string, params: Record<string, unknown>): Promise<T>;
+  translateText(params: TranslateTextCommandInput): Promise<TranslateTextCommandOutput>;
+  translateDocument(params: TranslateDocumentCommandInput): Promise<TranslateDocumentCommandOutput>;
+  startTextTranslationJob(params: StartTextTranslationJobCommandInput): Promise<StartTextTranslationJobCommandOutput>;
+  describeTextTranslationJob(params: DescribeTextTranslationJobCommandInput): Promise<DescribeTextTranslationJobCommandOutput>;
+  listTextTranslationJobs(params?: ListTextTranslationJobsCommandInput): Promise<ListTextTranslationJobsCommandOutput>;
+  stopTextTranslationJob(params: StopTextTranslationJobCommandInput): Promise<StopTextTranslationJobCommandOutput>;
+  listLanguages(params?: ListLanguagesCommandInput): Promise<ListLanguagesCommandOutput>;
+  importTerminology(params: ImportTerminologyCommandInput): Promise<ImportTerminologyCommandOutput>;
+  getTerminology(params: GetTerminologyCommandInput): Promise<GetTerminologyCommandOutput>;
+  listTerminologies(params?: ListTerminologiesCommandInput): Promise<ListTerminologiesCommandOutput>;
+  deleteTerminology(params: DeleteTerminologyCommandInput): Promise<DeleteTerminologyCommandOutput>;
+  createParallelData(params: CreateParallelDataCommandInput): Promise<CreateParallelDataCommandOutput>;
+  getParallelData(params: GetParallelDataCommandInput): Promise<GetParallelDataCommandOutput>;
+  listParallelData(params?: ListParallelDataCommandInput): Promise<ListParallelDataCommandOutput>;
+  deleteParallelData(params: DeleteParallelDataCommandInput): Promise<DeleteParallelDataCommandOutput>;
+  translate(text: string, targetLanguage: string, sourceLanguage?: string): Promise<string>;
+  translateFormal(text: string, targetLanguage: string, sourceLanguage?: string, formality?: 'FORMAL' | 'INFORMAL'): Promise<string>;
+  translateToMultiple(text: string, targetLanguages: string[], sourceLanguage?: string): Promise<Record<string, string>>;
+  waitForJob(jobId: string, options?: { maxWaitMs?: number; pollIntervalMs?: number }): Promise<TextTranslationJobProperties>;
+  getSupportedLanguages(): Promise<string[]>;
+}

package/dist/aws/voice.d.ts

@@ -0,0 +1,219 @@
+import { ConnectClient } from './connect';
+import { S3Client } from './s3';
+import { TranscribeClient } from './transcribe';
+/**
+ * Create a Lambda handler for processing incoming voicemails
+ * Use this with Connect's voicemail feature or custom IVR
+ *
+ * @example
+ * ```typescript
+ * // lambda.ts
+ * import { createVoicemailHandler } from 'ts-cloud/aws/voice'
+ *
+ * export const handler = createVoicemailHandler({
+ *   bucket: 'my-voicemail-bucket',
+ *   prefix: 'voicemail/',
+ *   region: 'us-east-1',
+ * })
+ * ```
+ */
+export declare function createVoicemailHandler(config: {
+  bucket: string
+  prefix?: string
+  region?: string
+  onVoicemail?: (voicemail: Voicemail) => Promise<void>
+}): void;
+/**
+ * Create a Lambda handler for Connect recording events
+ * This processes call recordings uploaded to S3 by Connect
+ */
+export declare function createRecordingHandler(config: {
+  bucket: string
+  prefix?: string
+  region?: string
+  onRecording?: (recording: CallRecording) => Promise<void>
+}): void;
+/**
+ * Convenience function to create a voice client
+ */
+export declare function createVoiceClient(config?: VoiceClientConfig): VoiceClient;
+export declare interface VoiceClientConfig {
+  region?: string
+  voicemailBucket?: string
+  voicemailPrefix?: string
+  recordingsPrefix?: string
+  connectInstanceId?: string
+  connectContactFlowId?: string
+  defaultCallerId?: string
+  enableTranscription?: boolean
+  transcriptionLanguage?: string
+}
+export declare interface Voicemail {
+  key: string
+  from: string
+  to: string
+  duration: number
+  timestamp: Date
+  transcription?: string
+  transcriptionStatus?: 'pending' | 'processing' | 'completed' | 'failed'
+  transcriptionJobName?: string
+  audioUrl?: string
+  read?: boolean
+  readAt?: Date
+  contentType?: string
+  size?: number
+  raw?: any
+}
+export declare interface CallRecording {
+  key: string
+  contactId: string
+  from?: string
+  to?: string
+  duration: number
+  timestamp: Date
+  audioUrl?: string
+  contentType?: string
+  size?: number
+}
+export declare interface MakeCallOptions {
+  to: string
+  from?: string
+  message?: string
+  voiceId?: string
+  audioUrl?: string
+  contactFlowId?: string
+  attributes?: Record<string, string>
+}
+export declare interface SendVoiceMessageOptions {
+  to: string
+  from?: string
+  message: string
+  voiceId?: string
+  languageCode?: string
+}
+export declare interface VoicemailGreeting {
+  id: string
+  name: string
+  type: 'default' | 'busy' | 'unavailable' | 'custom'
+  text?: string
+  audioKey?: string
+  audioUrl?: string
+  voiceId?: string
+  languageCode?: string
+  isActive: boolean
+  createdAt: Date
+  updatedAt?: Date
+}
+export declare interface CallForwardingRule {
+  id: string
+  name: string
+  enabled: boolean
+  condition: 'always' | 'busy' | 'no_answer' | 'unreachable' | 'after_hours'
+  forwardTo: string
+  ringTimeout?: number
+  businessHours?: {
+    timezone: string
+    schedule: Array<{
+      day: 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' | 'sun'
+      start: string // HH:MM format
+      end: string
+    }>
+  }
+  priority: number
+  createdAt: Date
+  updatedAt?: Date
+}
+/**
+ * Voice Client with S3 voicemail storage
+ */
+export declare class VoiceClient {
+  private config: VoiceClientConfig;
+  private connect?: ConnectClient;
+  private s3?: S3Client;
+  private transcribe?: TranscribeClient;
+  constructor(config?: VoiceClientConfig);
+  call(options: MakeCallOptions): Promise<{ callId: string }>;
+  sendVoiceMessage(options: SendVoiceMessageOptions): Promise<{ messageId: string }>;
+  speak(to: string, message: string, voiceId?: string): Promise<{ messageId: string }>;
+  getVoicemails(options?: {
+    prefix?: string
+    maxResults?: number
+  }): Promise<Voicemail[]>;
+  getVoicemail(key: string): Promise<Voicemail | null>;
+  getVoicemailAudioUrl(key: string, expiresIn?: number): Promise<string>;
+  deleteVoicemail(key: string): Promise<void>;
+  archiveVoicemail(key: string): Promise<string>;
+  getVoicemailCount(): Promise<number>;
+  getUnreadCount(): Promise<number>;
+  markAsRead(key: string): Promise<void>;
+  markAsUnread(key: string): Promise<void>;
+  markManyAsRead(keys: string[]): Promise<void>;
+  deleteMany(keys: string[]): Promise<void>;
+  transcribeVoicemail(key: string): Promise<{ jobName: string }>;
+  getTranscriptionStatus(jobName: string): Promise<{
+    status: 'IN_PROGRESS' | 'COMPLETED' | 'FAILED'
+    transcription?: string
+  }>;
+  updateTranscription(key: string, transcription: string): Promise<void>;
+  createGreeting(greeting: {
+    name: string
+    type: 'default' | 'busy' | 'unavailable' | 'custom'
+    text?: string
+    audioData?: Buffer | string
+    voiceId?: string
+    languageCode?: string
+    setActive?: boolean
+  }): Promise<VoicemailGreeting>;
+  getGreetings(): Promise<VoicemailGreeting[]>;
+  getGreeting(id: string): Promise<VoicemailGreeting | null>;
+  getActiveGreeting(type: 'default' | 'busy' | 'unavailable' | 'custom'): Promise<VoicemailGreeting | null>;
+  setActiveGreeting(id: string): Promise<void>;
+  private deactivateGreetingsOfType(type: string): Promise<void>;
+  updateGreeting(id: string, updates: { name?: string; text?: string; audioData?: Buffer | string }): Promise<VoicemailGreeting>;
+  deleteGreeting(id: string): Promise<void>;
+  getGreetingAudioUrl(id: string, expiresIn?: number): Promise<string | null>;
+  createForwardingRule(rule: {
+    name: string
+    condition: 'always' | 'busy' | 'no_answer' | 'unreachable' | 'after_hours'
+    forwardTo: string
+    ringTimeout?: number
+    businessHours?: CallForwardingRule['businessHours']
+    priority?: number
+    enabled?: boolean
+  }): Promise<CallForwardingRule>;
+  getForwardingRules(): Promise<CallForwardingRule[]>;
+  getForwardingRule(id: string): Promise<CallForwardingRule | null>;
+  updateForwardingRule(id: string, updates: Partial<Omit<CallForwardingRule, 'id' | 'createdAt' | 'updatedAt'>>): Promise<CallForwardingRule>;
+  setForwardingRuleEnabled(id: string, enabled: boolean): Promise<void>;
+  deleteForwardingRule(id: string): Promise<void>;
+  getApplicableForwardingRule(currentConditions?: {
+      isBusy?: boolean
+      isUnreachable?: boolean
+      noAnswer?: boolean
+    }): Promise<CallForwardingRule | null>;
+  private isWithinBusinessHours(date: Date, businessHours: NonNullable<CallForwardingRule['businessHours']>): boolean;
+  getRecordings(options?: {
+    prefix?: string
+    maxResults?: number
+  }): Promise<CallRecording[]>;
+  getRecordingUrl(key: string, expiresIn?: number): Promise<string>;
+  storeVoicemail(voicemail: {
+    from: string
+    to: string
+    audioData: Buffer | string
+    duration?: number
+    transcription?: string
+    contentType?: string
+    timestamp?: Date
+  }): Promise<string>;
+  storeRecording(recording: {
+    contactId: string
+    from?: string
+    to?: string
+    audioData: Buffer | string
+    duration?: number
+    contentType?: string
+    timestamp?: Date
+  }): Promise<string>;
+  private getVoicemailMetadata(audioKey: string): Promise<Voicemail | null>;
+}