@xcelsior/support-api 0.1.1

package/stacks/SupportStack.ts

@@ -0,0 +1,387 @@
+import 'dotenv/config';
+import {
+    ApiGatewayV1Api,
+    Bucket,
+    Cron,
+    Function,
+    Queue,
+    Table,
+    type StackContext,
+} from 'sst/constructs';
+import { Duration } from 'aws-cdk-lib';
+import * as cloudfront from 'aws-cdk-lib/aws-cloudfront';
+import * as origins from 'aws-cdk-lib/aws-cloudfront-origins';
+
+export function SupportStack({ stack }: StackContext) {
+    const domainName = process.env.API_DOMAIN_NAME! || 'xcelsior.co';
+    const apiSubdomain =
+        stack.stage === 'production'
+            ? `support.api.${domainName}`
+            : `${stack.stage}-support.api.${domainName}`;
+
+    const ticketSearchIndexName =
+        process.env.TICKETS_SEARCH_INDEX ?? `${stack.stage}-support-tickets`;
+
+    const supportConfigTable = new Table(stack, 'support-config', {
+        fields: {
+            id: 'string',
+            updatedAt: 'string',
+        },
+        primaryIndex: { partitionKey: 'id' },
+    });
+
+    const categoriesTable = new Table(stack, 'support-categories', {
+        fields: {
+            id: 'string',
+            name: 'string',
+            createdAt: 'string',
+        },
+        primaryIndex: { partitionKey: 'id' },
+    });
+
+    const teamsTable = new Table(stack, 'support-teams', {
+        fields: {
+            id: 'string',
+            name: 'string',
+            createdAt: 'string',
+        },
+        primaryIndex: { partitionKey: 'id' },
+    });
+
+    const ticketsTable = new Table(stack, 'support-tickets', {
+        fields: {
+            id: 'string',
+            ticketNumber: 'number',
+            categoryId: 'string',
+            teamId: 'string',
+            subject: 'string',
+            status: 'string',
+            priority: 'string',
+            assigneeUserId: 'string',
+            requesterEmail: 'string',
+            reminderAt: 'string',
+            createdAt: 'string',
+        },
+        primaryIndex: { partitionKey: 'id' },
+        globalIndexes: {
+            StatusIndex: { partitionKey: 'status', sortKey: 'createdAt' },
+            ReminderIndex: { partitionKey: 'priority', sortKey: 'reminderAt' },
+        },
+        stream: 'new_and_old_images',
+    });
+
+    const ticketEventsTable = new Table(stack, 'support-ticket-events', {
+        fields: {
+            id: 'string',
+            ticketId: 'string',
+            createdAt: 'string',
+        },
+        primaryIndex: { partitionKey: 'id' },
+        globalIndexes: {
+            TicketIndex: { partitionKey: 'ticketId', sortKey: 'createdAt' },
+        },
+    });
+
+    const attachmentsBucket = new Bucket(stack, 'support-attachments', {
+        cors: [
+            {
+                allowedOrigins: ['*'],
+                allowedHeaders: ['*'],
+                allowedMethods: ['GET', 'PUT', 'POST', 'DELETE', 'HEAD'],
+                maxAge: '1 day',
+            },
+        ],
+    });
+
+    // Create CloudFront distribution for serving attachments
+    const attachmentsDistribution = new cloudfront.Distribution(
+        stack,
+        'support-attachments-distribution',
+        {
+            defaultBehavior: {
+                origin: new origins.S3Origin(attachmentsBucket.cdk.bucket),
+                viewerProtocolPolicy: cloudfront.ViewerProtocolPolicy.REDIRECT_TO_HTTPS,
+                cachePolicy: cloudfront.CachePolicy.CACHING_OPTIMIZED,
+                allowedMethods: cloudfront.AllowedMethods.ALLOW_GET_HEAD_OPTIONS,
+                cachedMethods: cloudfront.CachedMethods.CACHE_GET_HEAD_OPTIONS,
+            },
+            comment: `CloudFront distribution for support attachments - ${stack.stage}`,
+        }
+    );
+
+    const baseFunctionEnv = {
+        MONITORING_PROVIDER: process.env.MONITORING_PROVIDER ?? '',
+        SENTRY_DSN: process.env.SENTRY_DSN ?? '',
+        ROLLBAR_ACCESS_TOKEN: process.env.ROLLBAR_ACCESS_TOKEN ?? '',
+        POWERTOOLS_SERVICE_NAME: '@xcelsior/support',
+        POWERTOOLS_METRICS_NAMESPACE: 'ExcelsiorSupport',
+        LOGTAIL_TOKEN: process.env.LOGTAIL_TOKEN ?? '',
+        LOGTAIL_HTTP_API_URL: process.env.LOGTAIL_HTTP_API_URL ?? '',
+        POWERTOOLS_LOGGER_LOG_LEVEL: 'INFO',
+        POWERTOOLS_LOGGER_LOG_EVENT: 'true',
+        APP_ENV: stack.stage,
+        POWERTOOLS_DEV: stack.stage === 'dev' ? 'true' : '',
+        NODE_ENV: stack.stage === 'dev' ? 'development' : 'production',
+        AWS_NODEJS_CONNECTION_REUSE_ENABLED: '1',
+        MEILISEARCH_HOST: process.env.MEILISEARCH_HOST ?? 'http://localhost:7700',
+        MEILISEARCH_API_KEY: process.env.MEILISEARCH_API_KEY ?? 'meili_master_key',
+        TICKETS_SEARCH_INDEX: ticketSearchIndexName,
+        CLOUDFRONT_DOMAIN: attachmentsDistribution.distributionDomainName,
+        // Email configuration (optional - emails will be skipped if not configured)
+        EMAIL_TRANSPORT: process.env.EMAIL_TRANSPORT ?? '',
+        EMAIL_SENDER: process.env.EMAIL_SENDER ?? '',
+        EMAIL_SOURCE_ARN: process.env.EMAIL_SOURCE_ARN ?? '',
+        SMTP_HOST: process.env.SMTP_HOST ?? '',
+        SMTP_PORT: process.env.SMTP_PORT ?? '',
+        SMTP_USER: process.env.SMTP_USER ?? '',
+        SMTP_PASSWORD: process.env.SMTP_PASSWORD ?? '',
+        APP_URL: process.env.APP_URL ?? '',
+    };
+
+    const reminderQueue = new Queue(stack, 'support-reminder-queue', {
+        cdk: {
+            queue: {
+                visibilityTimeout: Duration.minutes(1),
+                retentionPeriod: Duration.days(14),
+            },
+        },
+    });
+
+    const notificationWorker = new Function(stack, 'support-notification-worker', {
+        handler: 'packages/functions/workers/notificationWorker.handler',
+        bind: [supportConfigTable, ticketsTable, ticketEventsTable, reminderQueue],
+        functionName: `${stack.stage}-support-notification-worker`,
+        environment: {
+            ...baseFunctionEnv,
+        },
+        nodejs: {
+            esbuild: { minify: true },
+        },
+        runtime: 'nodejs18.x',
+        tracing: 'active',
+    });
+
+    reminderQueue.addConsumer(stack, {
+        cdk: {
+            eventSource: {
+                batchSize: 5,
+                maxConcurrency: 4,
+            },
+        },
+        function: notificationWorker,
+    });
+
+    // Cron job to scan for tickets needing reminders (runs every hour)
+    new Cron(stack, 'support-reminder-scanner', {
+        schedule: 'rate(1 hour)',
+        job: {
+            function: {
+                handler: 'packages/functions/workers/reminderScanner.handler',
+                bind: [supportConfigTable, ticketsTable, reminderQueue],
+                functionName: `${stack.stage}-support-reminder-scanner`,
+                environment: baseFunctionEnv,
+                timeout: '5 minutes',
+                nodejs: {
+                    esbuild: { minify: true },
+                },
+                runtime: 'nodejs18.x',
+                tracing: 'active',
+            },
+        },
+    });
+
+    ticketsTable.addConsumers(stack, {
+        'ticket-search-sync': {
+            function: {
+                handler: 'packages/functions/tickets/searchSync.handler',
+                bind: [
+                    supportConfigTable,
+                    categoriesTable,
+                    teamsTable,
+                    ticketsTable,
+                    ticketEventsTable,
+                    attachmentsBucket,
+                ],
+                functionName: `${stack.stage}-support-ticket-search-sync`,
+                environment: baseFunctionEnv,
+                nodejs: {
+                    esbuild: { minify: true },
+                },
+                runtime: 'nodejs18.x',
+                tracing: 'active',
+            },
+        },
+    });
+
+    const api = new ApiGatewayV1Api(stack, 'support-api', {
+        customDomain: {
+            domainName: apiSubdomain,
+            hostedZone: domainName,
+        },
+        defaults: {
+            function: {
+                bind: [
+                    supportConfigTable,
+                    categoriesTable,
+                    teamsTable,
+                    ticketsTable,
+                    ticketEventsTable,
+                    attachmentsBucket,
+                    reminderQueue,
+                ],
+                environment: {
+                    ...baseFunctionEnv,
+                },
+                nodejs: {
+                    esbuild: { minify: true },
+                },
+                runtime: 'nodejs18.x',
+                tracing: 'active',
+            },
+        },
+        cors: true,
+        routes: {
+            'GET /api/admin/support/config': {
+                function: {
+                    handler: 'packages/functions/config/get.handler',
+                    functionName: `${stack.stage}-support-get-config`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'PUT /api/admin/support/config': {
+                function: {
+                    handler: 'packages/functions/config/update.handler',
+                    functionName: `${stack.stage}-support-update-config`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'GET /api/admin/categories': {
+                function: {
+                    handler: 'packages/functions/categories/list.handler',
+                    functionName: `${stack.stage}-support-list-categories`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'POST /api/admin/categories': {
+                function: {
+                    handler: 'packages/functions/categories/create.handler',
+                    functionName: `${stack.stage}-support-create-category`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'PATCH /api/admin/categories/{id}': {
+                function: {
+                    handler: 'packages/functions/categories/update.handler',
+                    functionName: `${stack.stage}-support-update-category`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'POST /api/admin/categories/{id}/archive': {
+                function: {
+                    handler: 'packages/functions/categories/archive.handler',
+                    functionName: `${stack.stage}-support-archive-category`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'GET /api/admin/teams': {
+                function: {
+                    handler: 'packages/functions/teams/list.handler',
+                    functionName: `${stack.stage}-support-list-teams`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'POST /api/admin/teams': {
+                function: {
+                    handler: 'packages/functions/teams/create.handler',
+                    functionName: `${stack.stage}-support-create-team`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'POST /api/admin/teams/{id}/members': {
+                function: {
+                    handler: 'packages/functions/teams/addMember.handler',
+                    functionName: `${stack.stage}-support-add-team-member`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'DELETE /api/admin/teams/{id}/members/{userId}': {
+                function: {
+                    handler: 'packages/functions/teams/removeMember.handler',
+                    functionName: `${stack.stage}-support-remove-team-member`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'POST /api/tickets': {
+                function: {
+                    handler: 'packages/functions/tickets/create.handler',
+                    functionName: `${stack.stage}-support-create-ticket`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'GET /api/tickets/{id}': {
+                function: {
+                    handler: 'packages/functions/tickets/get.handler',
+                    functionName: `${stack.stage}-support-get-ticket`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'PATCH /api/tickets/{id}': {
+                function: {
+                    handler: 'packages/functions/tickets/update.handler',
+                    functionName: `${stack.stage}-support-update-ticket`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'GET /api/tickets': {
+                function: {
+                    handler: 'packages/functions/tickets/list.handler',
+                    functionName: `${stack.stage}-support-list-tickets`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'GET /api/stats/tickets': {
+                function: {
+                    handler: 'packages/functions/tickets/statusFacets.handler',
+                    functionName: `${stack.stage}-support-ticket-status-facets`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'GET /api/tickets/{id}/events': {
+                function: {
+                    handler: 'packages/functions/events/list.handler',
+                    functionName: `${stack.stage}-support-list-ticket-events`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+            'POST /api/attachments/upload-url': {
+                function: {
+                    handler: 'packages/functions/attachments/generateUploadUrl.handler',
+                    functionName: `${stack.stage}-support-generate-attachment-upload-url`,
+                },
+                cdk: { method: { apiKeyRequired: true } },
+            },
+        },
+    });
+
+    const apiKey = api.cdk.restApi.addApiKey('support-api-key', {
+        apiKeyName: `support-api-key-${stack.stage}`,
+    });
+
+    const usagePlan = api.cdk.restApi.addUsagePlan('support-api-usage', {
+        name: `support-usage-plan-${stack.stage}`,
+        apiStages: [
+            {
+                api: api.cdk.restApi,
+                stage: api.cdk.restApi.deploymentStage,
+            },
+        ],
+    });
+
+    usagePlan.addApiKey(apiKey);
+
+    stack.addOutputs({
+        ApiEndpoint: api.url,
+        AttachmentsBucket: attachmentsBucket.bucketName,
+        CloudFrontDomain: attachmentsDistribution.distributionDomainName,
+    });
+}

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+    "extends": "../../packages/config/typescript/node.json",
+    "compilerOptions": {
+        "module": "ESNext",
+        "moduleResolution": "Node",
+        "noEmit": true,
+        "strict": true,
+        "skipLibCheck": true,
+        "types": ["@types/aws-lambda"]
+    },
+    "include": ["./packages/**/*.ts", "./stacks/**/*.ts", "./sst.config.ts"]
+}