@stacksjs/ts-cloud-core 0.1.3 → 0.1.7

package/dist/phone/advanced/callbacks.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Callback Requests and Queue Management
+ *
+ * Provides callback scheduling and queue management
+ */
+export declare interface CallbackRequest {
+  id: string
+  phoneNumber: string
+  customerName?: string
+  reason?: string
+  preferredTime?: string
+  queueId?: string
+  priority: number
+  status: 'pending' | 'scheduled' | 'in-progress' | 'completed' | 'failed' | 'cancelled'
+  attempts: number
+  maxAttempts: number
+  createdAt: string
+  scheduledFor?: string
+  completedAt?: string
+  notes?: string
+}
+export declare interface QueuePosition {
+  position: number
+  estimatedWaitTime: number
+  callersAhead: number
+}
+/**
+ * Callback Module
+ */
+export declare class Callbacks {
+  static CallbackRequestCode: any;
+  static CallbackProcessorCode: any;
+  static createCallbacksTable(config: { slug: string }): Record<string, any>;
+  static createCallbackRequestLambda(config: {
+    slug: string
+    roleArn: string
+    callbacksTable: string
+    notificationTopicArn?: string
+  }): Record<string, any>;
+  static createCallbackProcessorLambda(config: {
+    slug: string
+    roleArn: string
+    callbacksTable: string
+    connectInstanceId: string
+    contactFlowId: string
+    sourcePhoneNumber: string
+    queueId?: string
+  }): Record<string, any>;
+}
+export default Callbacks;

package/dist/phone/advanced/index.d.ts

@@ -0,0 +1,4 @@
+export * from './recording';
+export * from './ivr-builder';
+export * from './analytics';
+export * from './callbacks';

package/dist/phone/advanced/ivr-builder.d.ts

@@ -0,0 +1,83 @@
+/**
+ * IVR Builder (Visual Contact Flow Editor)
+ *
+ * Provides a programmatic way to build Amazon Connect contact flows
+ */
+export declare interface IVRFlow {
+  id: string
+  name: string
+  description?: string
+  nodes: IVRNode[]
+  connections: IVRConnection[]
+  startNodeId: string
+  version: number
+  createdAt: string
+  updatedAt: string
+}
+export declare interface IVRNode {
+  id: string
+  type: IVRNodeType
+  position: { x: number; y: number }
+  config: Record<string, any>
+  label?: string
+}
+export declare interface IVRConnection {
+  id: string
+  sourceNodeId: string
+  targetNodeId: string
+  sourcePort: string
+  label?: string
+}
+export type IVRNodeType = | 'start'
+  | 'play-prompt'
+  | 'get-input'
+  | 'menu'
+  | 'transfer-queue'
+  | 'transfer-agent'
+  | 'transfer-phone'
+  | 'invoke-lambda'
+  | 'set-attribute'
+  | 'check-attribute'
+  | 'check-hours'
+  | 'check-queue'
+  | 'record-voicemail'
+  | 'disconnect'
+  | 'loop'
+  | 'wait'
+/**
+ * IVR Builder Module
+ */
+export declare class IVRBuilder {
+  private nodes: IVRNode[];
+  private connections: IVRConnection[];
+  private startNodeId: string;
+  static create(name: string): IVRBuilder;
+  start(): this;
+  playPrompt(text: string, options?: { ssml?: boolean; voice?: string }): this;
+  getInput(prompt: string, options?: {
+    maxDigits?: number
+    timeout?: number
+    errorPrompt?: string
+  }): this;
+  menu(prompt: string, options: Record<string, string>): this;
+  transferToQueue(queueArn: string, options?: { priority?: number }): this;
+  transferToPhone(phoneNumber: string): this;
+  invokeLambda(functionArn: string, options?: { timeout?: number }): this;
+  setAttribute(key: string, value: string): this;
+  checkHours(hoursOfOperationArn: string): this;
+  recordVoicemail(options?: {
+    maxDuration?: number
+    greeting?: string
+    beep?: boolean
+  }): this;
+  wait(seconds: number): this;
+  disconnect(): this;
+  build(): IVRFlow;
+  toContactFlow(): string;
+  private nodeToAction(node: IVRNode, nodeMap: Map<string, IVRNode>): any;
+  private connectToLast(targetId: string): void;
+  private getNextNodeId(nodeId: string): string | null;
+  private generateId(): string;
+  static readonly Templates: any;
+}
+export default IVRBuilder;

package/dist/phone/advanced/recording.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Call Recording with Transcription
+ *
+ * Provides call recording storage and transcription
+ */
+export declare interface CallRecording {
+  recordingId: string
+  contactId: string
+  startTime: string
+  endTime: string
+  duration: number
+  participants: string[]
+  recordingUrl: string
+  transcription?: CallTranscription
+  status: 'recording' | 'processing' | 'completed' | 'failed'
+  createdAt: string
+}
+export declare interface CallTranscription {
+  transcriptId: string
+  text: string
+  segments: TranscriptionSegment[]
+  language: string
+  confidence: number
+  status: 'pending' | 'processing' | 'completed' | 'failed'
+}
+export declare interface TranscriptionSegment {
+  speaker: string
+  startTime: number
+  endTime: number
+  text: string
+  confidence: number
+  sentiment?: 'positive' | 'neutral' | 'negative'
+}
+/**
+ * Call Recording Module
+ */
+export declare class CallRecording {
+  static RecordingProcessorCode: any;
+  static TranscriptionCompleteCode: any;
+  static createRecordingsTable(config: { slug: string }): Record<string, any>;
+  static createRecordingProcessorLambda(config: {
+    slug: string
+    roleArn: string
+    recordingBucket: string
+    recordingsTable: string
+  }): Record<string, any>;
+}
+export default CallRecording;

package/{src/phone/handlers/incoming-call.ts → dist/phone/handlers/incoming-call.d.ts}

@@ -6,8 +6,7 @@
  * - Sends notifications (SNS, webhook)
  * - Routes based on caller ID
  */
-
-export const handler = `
+export declare const handler: `
 const { SNSClient, PublishCommand } = require('@aws-sdk/client-sns');
 const { DynamoDBClient, PutItemCommand } = require('@aws-sdk/client-dynamodb');
 
@@ -112,6 +111,5 @@ exports.handler = async (event) => {
     };
   }
 };
-`
-
-export default handler
+`;
+export default handler;

package/{src/phone/handlers/missed-call.ts → dist/phone/handlers/missed-call.d.ts}

@@ -5,8 +5,7 @@
  * - Logs missed call
  * - Sends notification
  */
-
-export const handler = `
+export declare const handler: `
 const { SNSClient, PublishCommand } = require('@aws-sdk/client-sns');
 const { DynamoDBClient, UpdateItemCommand } = require('@aws-sdk/client-dynamodb');
 
@@ -111,6 +110,5 @@ exports.handler = async (event) => {
     };
   }
 };
-`
-
-export default handler
+`;
+export default handler;

package/{src/phone/handlers/voicemail.ts → dist/phone/handlers/voicemail.d.ts}

@@ -6,8 +6,7 @@
  * - Transcribes using Amazon Transcribe
  * - Sends notification with transcription
  */
-
-export const handler = `
+export declare const handler: `
 const { S3Client, GetObjectCommand, PutObjectCommand } = require('@aws-sdk/client-s3');
 const { TranscribeClient, StartTranscriptionJobCommand, GetTranscriptionJobCommand } = require('@aws-sdk/client-transcribe');
 const { SNSClient, PublishCommand } = require('@aws-sdk/client-sns');
@@ -174,6 +173,5 @@ exports.handler = async (event) => {
 
   return { statusCode: 200, body: 'OK' };
 };
-`
-
-export default handler
+`;
+export default handler;

package/dist/phone/index.d.ts

@@ -0,0 +1,2 @@
+export * as PhoneAdvanced from './advanced';
+export * as PhoneHandlers from './handlers/incoming-call';

package/dist/presets/api-backend.d.ts

@@ -0,0 +1,11 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * API-Only Backend Preset
+ * Perfect for: REST APIs, GraphQL APIs, mobile backends
+ * Includes: API Gateway + Lambda functions + DynamoDB
+ */
+export declare function createApiBackendPreset(options: {
+  name: string
+  slug: string
+  domain?: string
+}): Partial<CloudConfig>;

package/dist/presets/data-pipeline.d.ts

@@ -0,0 +1,11 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * Data Pipeline Preset
+ * Perfect for: ETL pipelines, data processing, analytics workflows
+ * Includes: Kinesis + Lambda + S3 + Athena + Glue
+ */
+export declare function createDataPipelinePreset(options: {
+  name: string
+  slug: string
+  retentionDays?: number
+}): Partial<CloudConfig>;

package/{src/presets/extend.ts → dist/presets/extend.d.ts}

@@ -1,43 +1,4 @@
-import type { CloudConfig } from '@stacksjs/ts-cloud-types'
-
-/**
- * Deep merge utility for combining CloudConfig objects
- */
-function deepMerge<T extends Record<string, any>>(target: T, source: Partial<T>): T {
-  const result = { ...target }
-
-  for (const key in source) {
-    const sourceValue = source[key]
-    const targetValue = result[key]
-
-    if (sourceValue === undefined) {
-      continue
-    }
-
-    if (Array.isArray(sourceValue) && Array.isArray(targetValue)) {
-      // Merge arrays by concatenating
-      result[key] = [...targetValue, ...sourceValue] as any
-    }
-    else if (
-      typeof sourceValue === 'object'
-      && sourceValue !== null
-      && !Array.isArray(sourceValue)
-      && typeof targetValue === 'object'
-      && targetValue !== null
-      && !Array.isArray(targetValue)
-    ) {
-      // Recursively merge objects
-      result[key] = deepMerge(targetValue, sourceValue)
-    }
-    else {
-      // Override primitive values
-      result[key] = sourceValue as any
-    }
-  }
-
-  return result
-}
-
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
 /**
  * Extend a base preset with custom configuration
  *
@@ -65,13 +26,7 @@ function deepMerge<T extends Record<string, any>>(target: T, source: Partial<T>)
  * )
  * ```
  */
-export function extendPreset(
-  basePreset: Partial<CloudConfig>,
-  extensions: Partial<CloudConfig>,
-): Partial<CloudConfig> {
-  return deepMerge(basePreset as Record<string, any>, extensions as Record<string, any>) as Partial<CloudConfig>
-}
-
+export declare function extendPreset(basePreset: Partial<CloudConfig>, extensions: Partial<CloudConfig>): Partial<CloudConfig>;
 /**
  * Compose multiple presets together
  * Later presets override earlier ones
@@ -92,15 +47,7 @@ export function extendPreset(
  * )
  * ```
  */
-export function composePresets(
-  ...presets: Partial<CloudConfig>[]
-): Partial<CloudConfig> {
-  return presets.reduce(
-    (acc, preset) => deepMerge(acc as Record<string, any>, preset as Record<string, any>),
-    {} as Record<string, any>,
-  ) as Partial<CloudConfig>
-}
-
+export declare function composePresets(...presets: Partial<CloudConfig>[]): Partial<CloudConfig>;
 /**
  * Create a custom preset by extending an existing one
  *
@@ -124,21 +71,7 @@ export function composePresets(
  * const myPreset = createMyCustomPreset({ name: 'App', slug: 'app' })
  * ```
  */
-export function createPreset<TOptions extends Record<string, any>>(
-  basePresetFn: (options: TOptions) => Partial<CloudConfig>,
-  extensions: Partial<CloudConfig> | ((config: Partial<CloudConfig>, options: TOptions) => Partial<CloudConfig>),
-): (options: TOptions) => Partial<CloudConfig> {
-  return (options: TOptions) => {
-    const baseConfig = basePresetFn(options)
-
-    if (typeof extensions === 'function') {
-      return extendPreset(baseConfig, extensions(baseConfig, options))
-    }
-
-    return extendPreset(baseConfig, extensions)
-  }
-}
-
+export declare function createPreset<TOptions extends Record<string, any>>(basePresetFn: (options: TOptions) => Partial<CloudConfig>, extensions: Partial<CloudConfig> | ((config: Partial<CloudConfig>, options: TOptions) => Partial<CloudConfig>)): (options: TOptions) => Partial<CloudConfig>;
 /**
  * Merge infrastructure configurations selectively
  * Useful for adding specific infrastructure to existing presets
@@ -160,14 +93,7 @@ export function createPreset<TOptions extends Record<string, any>>(
  * )
  * ```
  */
-export function mergeInfrastructure(
-  infrastructure: Partial<CloudConfig['infrastructure']>,
-): Partial<CloudConfig> {
-  return {
-    infrastructure,
-  }
-}
-
+export declare function mergeInfrastructure(infrastructure: Partial<CloudConfig['infrastructure']>): Partial<CloudConfig>;
 /**
  * Add monitoring configuration to any preset
  *
@@ -182,12 +108,7 @@ export function mergeInfrastructure(
  * )
  * ```
  */
-export function withMonitoring(
-  monitoring: NonNullable<CloudConfig['infrastructure']>['monitoring'],
-): Partial<CloudConfig> {
-  return mergeInfrastructure({ monitoring })
-}
-
+export declare function withMonitoring(monitoring: NonNullable<CloudConfig['infrastructure']>['monitoring']): Partial<CloudConfig>;
 /**
  * Add security configuration to any preset
  *
@@ -201,12 +122,7 @@ export function withMonitoring(
  * )
  * ```
  */
-export function withSecurity(
-  security: NonNullable<CloudConfig['infrastructure']>['security'],
-): Partial<CloudConfig> {
-  return mergeInfrastructure({ security })
-}
-
+export declare function withSecurity(security: NonNullable<CloudConfig['infrastructure']>['security']): Partial<CloudConfig>;
 /**
  * Add database configuration to any preset
  *
@@ -225,12 +141,7 @@ export function withSecurity(
  * )
  * ```
  */
-export function withDatabase(
-  databases: NonNullable<CloudConfig['infrastructure']>['databases'],
-): Partial<CloudConfig> {
-  return mergeInfrastructure({ databases })
-}
-
+export declare function withDatabase(databases: NonNullable<CloudConfig['infrastructure']>['databases']): Partial<CloudConfig>;
 /**
  * Add cache configuration to any preset
  *
@@ -247,12 +158,7 @@ export function withDatabase(
  * )
  * ```
  */
-export function withCache(
-  cache: NonNullable<CloudConfig['infrastructure']>['cache'],
-): Partial<CloudConfig> {
-  return mergeInfrastructure({ cache })
-}
-
+export declare function withCache(cache: NonNullable<CloudConfig['infrastructure']>['cache']): Partial<CloudConfig>;
 /**
  * Add CDN configuration to any preset
  *
@@ -268,12 +174,7 @@ export function withCache(
  * )
  * ```
  */
-export function withCDN(
-  cdn: NonNullable<CloudConfig['infrastructure']>['cdn'],
-): Partial<CloudConfig> {
-  return mergeInfrastructure({ cdn })
-}
-
+export declare function withCDN(cdn: NonNullable<CloudConfig['infrastructure']>['cdn']): Partial<CloudConfig>;
 /**
  * Add queue configuration to any preset
  *
@@ -290,8 +191,4 @@ export function withCDN(
  * )
  * ```
  */
-export function withQueue(
-  queues: NonNullable<CloudConfig['infrastructure']>['queues'],
-): Partial<CloudConfig> {
-  return mergeInfrastructure({ queues })
-}
+export declare function withQueue(queues: NonNullable<CloudConfig['infrastructure']>['queues']): Partial<CloudConfig>;

package/dist/presets/fullstack-app.d.ts

@@ -0,0 +1,12 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * Full Stack App Preset
+ * Perfect for: Complete web applications with frontend and API
+ * Includes: S3 + CloudFront (frontend) + ECS Fargate (API) + RDS + Redis
+ */
+export declare function createFullStackAppPreset(options: {
+  name: string
+  slug: string
+  domain: string
+  apiSubdomain?: string
+}): Partial<CloudConfig>;

package/dist/presets/index.d.ts

@@ -0,0 +1,24 @@
+export { createStaticSitePreset } from './static-site';
+export { createNodeJsServerPreset } from './nodejs-server';
+export { createNodeJsServerlessPreset } from './nodejs-serverless';
+export { createFullStackAppPreset } from './fullstack-app';
+export { createApiBackendPreset } from './api-backend';
+export { createWordPressPreset } from './wordpress';
+export { createJamstackPreset } from './jamstack';
+export { createMicroservicesPreset } from './microservices';
+export { createRealtimeAppPreset } from './realtime-app';
+export { createDataPipelinePreset } from './data-pipeline';
+export { createMLApiPreset } from './ml-api';
+export { createTraditionalWebAppPreset } from './traditional-web-app';
+export {
+  extendPreset,
+  composePresets,
+  createPreset,
+  mergeInfrastructure,
+  withMonitoring,
+  withSecurity,
+  withDatabase,
+  withCache,
+  withCDN,
+  withQueue,
+} from './extend';

package/dist/presets/jamstack.d.ts

@@ -0,0 +1,12 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * Jamstack Site Preset
+ * Perfect for: Modern static sites with API routes, Next.js, Astro, SvelteKit
+ * Includes: S3 + CloudFront + Lambda@Edge for SSR/ISR
+ */
+export declare function createJamstackPreset(options: {
+  name: string
+  slug: string
+  domain: string
+  apiDomain?: string
+}): Partial<CloudConfig>;

package/dist/presets/microservices.d.ts

@@ -0,0 +1,18 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * Microservices Preset
+ * Perfect for: Service-oriented architectures, distributed systems
+ * Includes: Multiple ECS services + API Gateway + Service Discovery + DynamoDB
+ */
+export declare function createMicroservicesPreset(options: {
+  name: string
+  slug: string
+  domain: string
+  services: Array<{
+    name: string
+    port: number
+    cpu?: string
+    memory?: string
+    desiredCount?: number
+  }>
+}): Partial<CloudConfig>;

package/dist/presets/ml-api.d.ts

@@ -0,0 +1,13 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * Machine Learning API Preset
+ * Perfect for: ML inference APIs, AI-powered applications
+ * Includes: SageMaker + API Gateway + Lambda + S3
+ */
+export declare function createMLApiPreset(options: {
+  name: string
+  slug: string
+  domain?: string
+  modelS3Path?: string
+  instanceType?: string
+}): Partial<CloudConfig>;

package/dist/presets/nodejs-server.d.ts

@@ -0,0 +1,14 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * Node.js Server Preset
+ * Perfect for: Traditional Node.js applications, API servers
+ * Includes: EC2 instances + ALB + Auto Scaling + RDS + Redis
+ */
+export declare function createNodeJsServerPreset(options: {
+  name: string
+  slug: string
+  domain?: string
+  instanceType?: string
+  minInstances?: number
+  maxInstances?: number
+}): Partial<CloudConfig>;

package/dist/presets/nodejs-serverless.d.ts

@@ -0,0 +1,14 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * Node.js Serverless Preset
+ * Perfect for: Serverless APIs, microservices
+ * Includes: ECS Fargate + ALB + DynamoDB + Lambda functions
+ */
+export declare function createNodeJsServerlessPreset(options: {
+  name: string
+  slug: string
+  domain?: string
+  taskCpu?: string
+  taskMemory?: string
+  desiredCount?: number
+}): Partial<CloudConfig>;

package/dist/presets/realtime-app.d.ts

@@ -0,0 +1,11 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * Real-time App Preset
+ * Perfect for: Chat apps, collaborative tools, live dashboards, gaming backends
+ * Includes: API Gateway WebSocket + Lambda + DynamoDB Streams
+ */
+export declare function createRealtimeAppPreset(options: {
+  name: string
+  slug: string
+  domain?: string
+}): Partial<CloudConfig>;

package/dist/presets/static-site.d.ts

@@ -0,0 +1,12 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * Static Site Preset
+ * Perfect for: Static websites, SPAs, documentation sites
+ * Includes: S3 bucket + CloudFront CDN
+ */
+export declare function createStaticSitePreset(options: {
+  name: string
+  slug: string
+  domain?: string
+  subdomain?: string
+}): Partial<CloudConfig>;

package/dist/presets/traditional-web-app.d.ts

@@ -0,0 +1,16 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * Traditional Web App Preset
+ * Perfect for: Server-rendered web apps, CMS platforms, admin panels
+ * Includes: EC2 + ALB + RDS + Redis + EFS (for session storage and uploads)
+ */
+export declare function createTraditionalWebAppPreset(options: {
+  name: string
+  slug: string
+  domain?: string
+  instanceType?: string
+  minInstances?: number
+  maxInstances?: number
+  databaseEngine?: 'mysql' | 'postgres'
+  sessionStore?: 'redis' | 'database'
+}): Partial<CloudConfig>;

package/dist/presets/wordpress.d.ts

@@ -0,0 +1,12 @@
+import type { CloudConfig } from '@stacksjs/ts-cloud-types';
+/**
+ * WordPress Preset
+ * Perfect for: WordPress sites, blogs, CMS-based sites
+ * Includes: EC2 + RDS MySQL + EFS + CloudFront
+ */
+export declare function createWordPressPreset(options: {
+  name: string
+  slug: string
+  domain: string
+  instanceType?: string
+}): Partial<CloudConfig>;

package/dist/preview/github.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Generate GitHub Actions workflow for preview environments
+ */
+export declare function generatePreviewWorkflow(options?: GitHubWorkflowOptions): string;
+/**
+ * Generate scheduled cleanup workflow
+ */
+export declare function generateCleanupWorkflow(options?: {
+  schedule?: string
+  maxAge?: number
+  keepCount?: number
+}): string;
+/**
+ * Generate cost report workflow
+ */
+export declare function generateCostReportWorkflow(options?: {
+  schedule?: string
+  webhookUrl?: string
+}): string;
+/**
+ * GitHub integration for preview environments
+ * Generates GitHub Actions workflows for automated preview deployments
+ */
+export declare interface GitHubWorkflowOptions {
+  workflowName?: string
+  trigger?: 'pull_request' | 'push' | 'workflow_dispatch'
+  branches?: string[]
+  awsRegion?: string
+  awsRole?: string
+  configFile?: string
+  ttl?: number
+}