@friggframework/devtools 2.0.0-next.69 → 2.0.0-next.70

package/infrastructure/domains/scheduler/scheduler-builder.js

@@ -0,0 +1,211 @@
+/**
+ * Scheduler Builder
+ *
+ * Domain Layer - Hexagonal Architecture
+ *
+ * Responsible for:
+ * - Creating EventBridge Scheduler ScheduleGroup resource
+ * - Creating IAM Role for EventBridge Scheduler to send messages to SQS
+ * - Adding necessary IAM statements for Lambda to create/delete schedules
+ *
+ * This builder enables integrations to schedule one-time jobs (e.g., webhook renewals)
+ * using AWS EventBridge Scheduler.
+ */
+
+const { InfrastructureBuilder, ValidationResult } = require('../shared/base-builder');
+
+class SchedulerBuilder extends InfrastructureBuilder {
+    constructor() {
+        super();
+        this.name = 'SchedulerBuilder';
+    }
+
+    shouldExecute(appDefinition) {
+        // Enable scheduler if explicitly enabled or if any integration has webhooks
+        // (webhooks often need renewal scheduling)
+        if (appDefinition.scheduler?.enable === true) {
+            return true;
+        }
+
+        // Check if any integration has webhooks enabled
+        if (Array.isArray(appDefinition.integrations)) {
+            return appDefinition.integrations.some(
+                (integration) =>
+                    integration?.Definition?.webhooks?.enabled === true ||
+                    integration?.Definition?.webhooks === true
+            );
+        }
+
+        return false;
+    }
+
+    getDependencies() {
+        return ['IntegrationBuilder']; // Needs integration queues to exist
+    }
+
+    validate(appDefinition) {
+        const result = new ValidationResult();
+        // No validation required - scheduler is optional
+        return result;
+    }
+
+    async build(appDefinition, discoveredResources) {
+        console.log(`\n[${this.name}] Configuring EventBridge Scheduler...`);
+
+        const result = {
+            functions: {},
+            resources: {},
+            environment: {},
+            custom: {},
+            iamStatements: [],
+        };
+
+        // Create ScheduleGroup resource
+        this.createScheduleGroup(result);
+
+        // Create IAM Role for EventBridge Scheduler
+        this.createSchedulerExecutionRole(appDefinition, result);
+
+        // Add IAM statements for Lambda to manage schedules
+        this.addSchedulerIamStatements(result);
+
+        // Add environment variables
+        this.addEnvironmentVariables(result);
+
+        console.log(`[${this.name}] ✅ Scheduler configuration completed`);
+        return result;
+    }
+
+    /**
+     * Create EventBridge Scheduler ScheduleGroup
+     * Uses stage-specific naming to allow multiple deployments in same AWS account
+     */
+    createScheduleGroup(result) {
+        const scheduleGroupName = '${self:service}-${self:provider.stage}-schedules';
+
+        result.resources.FriggScheduleGroup = {
+            Type: 'AWS::Scheduler::ScheduleGroup',
+            Properties: {
+                Name: scheduleGroupName,
+            },
+        };
+
+        console.log(`  ✓ Created ScheduleGroup: ${scheduleGroupName}`);
+    }
+
+    /**
+     * Create IAM Role for EventBridge Scheduler to send messages to SQS
+     */
+    createSchedulerExecutionRole(appDefinition, result) {
+        // Collect all integration queue ARNs
+        const queueArns = [];
+        if (Array.isArray(appDefinition.integrations)) {
+            appDefinition.integrations.forEach((integration) => {
+                const integrationName = integration?.Definition?.name;
+                if (integrationName) {
+                    const capitalizedName =
+                        integrationName.charAt(0).toUpperCase() +
+                        integrationName.slice(1);
+                    queueArns.push({
+                        'Fn::GetAtt': [`${capitalizedName}Queue`, 'Arn'],
+                    });
+                }
+            });
+        }
+
+        // If no queues found, use a placeholder (shouldn't happen if IntegrationBuilder ran)
+        if (queueArns.length === 0) {
+            console.warn(
+                '  ⚠ No integration queues found for scheduler role'
+            );
+            queueArns.push('arn:aws:sqs:*:*:*'); // Fallback
+        }
+
+        result.resources.SchedulerExecutionRole = {
+            Type: 'AWS::IAM::Role',
+            Properties: {
+                RoleName:
+                    '${self:service}-${self:provider.stage}-scheduler-role',
+                AssumeRolePolicyDocument: {
+                    Version: '2012-10-17',
+                    Statement: [
+                        {
+                            Effect: 'Allow',
+                            Principal: {
+                                Service: 'scheduler.amazonaws.com',
+                            },
+                            Action: 'sts:AssumeRole',
+                        },
+                    ],
+                },
+                Policies: [
+                    {
+                        PolicyName: 'SchedulerSQSPolicy',
+                        PolicyDocument: {
+                            Version: '2012-10-17',
+                            Statement: [
+                                {
+                                    Effect: 'Allow',
+                                    Action: ['sqs:SendMessage'],
+                                    Resource: queueArns,
+                                },
+                            ],
+                        },
+                    },
+                ],
+            },
+        };
+
+        console.log('  ✓ Created SchedulerExecutionRole');
+    }
+
+    /**
+     * Add IAM statements for Lambda functions to manage schedules
+     */
+    addSchedulerIamStatements(result) {
+        result.iamStatements.push(
+            {
+                Effect: 'Allow',
+                Action: [
+                    'scheduler:CreateSchedule',
+                    'scheduler:DeleteSchedule',
+                    'scheduler:GetSchedule',
+                ],
+                Resource: {
+                    'Fn::Sub': [
+                        'arn:aws:scheduler:${AWS::Region}:${AWS::AccountId}:schedule/${GroupName}/*',
+                        { GroupName: { Ref: 'FriggScheduleGroup' } },
+                    ],
+                },
+            },
+            {
+                Effect: 'Allow',
+                Action: ['iam:PassRole'],
+                Resource: { 'Fn::GetAtt': ['SchedulerExecutionRole', 'Arn'] },
+                Condition: {
+                    StringEquals: {
+                        'iam:PassedToService': 'scheduler.amazonaws.com',
+                    },
+                },
+            }
+        );
+
+        console.log('  ✓ Added scheduler IAM statements');
+    }
+
+    /**
+     * Add environment variables for scheduler configuration
+     */
+    addEnvironmentVariables(result) {
+        result.environment.SCHEDULER_ROLE_ARN = {
+            'Fn::GetAtt': ['SchedulerExecutionRole', 'Arn'],
+        };
+        result.environment.SCHEDULE_GROUP_NAME = {
+            Ref: 'FriggScheduleGroup',
+        };
+
+        console.log('  ✓ Added scheduler environment variables');
+    }
+}
+
+module.exports = { SchedulerBuilder };

package/infrastructure/infrastructure-composer.js

@@ -16,6 +16,7 @@ const { MigrationBuilder } = require('./domains/database/migration-builder');
 const { SsmBuilder } = require('./domains/parameters/ssm-builder');
 const { WebsocketBuilder } = require('./domains/integration/websocket-builder');
 const { IntegrationBuilder } = require('./domains/integration/integration-builder');
+const { SchedulerBuilder } = require('./domains/scheduler/scheduler-builder');
 
 // Utilities
 const { modifyHandlerPaths } = require('./domains/shared/utilities/handler-path-resolver');
@@ -51,6 +52,7 @@ const composeServerlessDefinition = async (AppDefinition) => {
         new SsmBuilder(),
         new WebsocketBuilder(),
         new IntegrationBuilder(),
+        new SchedulerBuilder(), // Add scheduler after IntegrationBuilder (depends on it)
     ]);
 
     // Build all infrastructure (orchestrator handles validation, dependencies, parallel execution)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@friggframework/devtools",
   "prettier": "@friggframework/prettier-config",
-  "version": "2.0.0-next.69",
+  "version": "2.0.0-next.70",
   "bin": {
     "frigg": "./frigg-cli/index.js"
   },
@@ -25,9 +25,9 @@
     "@babel/eslint-parser": "^7.18.9",
     "@babel/parser": "^7.25.3",
     "@babel/traverse": "^7.25.3",
-    "@friggframework/core": "2.0.0-next.69",
-    "@friggframework/schemas": "2.0.0-next.69",
-    "@friggframework/test": "2.0.0-next.69",
+    "@friggframework/core": "2.0.0-next.70",
+    "@friggframework/schemas": "2.0.0-next.70",
+    "@friggframework/test": "2.0.0-next.70",
     "@hapi/boom": "^10.0.1",
     "@inquirer/prompts": "^5.3.8",
     "axios": "^1.7.2",
@@ -55,8 +55,8 @@
     "validate-npm-package-name": "^5.0.0"
   },
   "devDependencies": {
-    "@friggframework/eslint-config": "2.0.0-next.69",
-    "@friggframework/prettier-config": "2.0.0-next.69",
+    "@friggframework/eslint-config": "2.0.0-next.70",
+    "@friggframework/prettier-config": "2.0.0-next.70",
     "aws-sdk-client-mock": "^4.1.0",
     "aws-sdk-client-mock-jest": "^4.1.0",
     "jest": "^30.1.3",
@@ -88,5 +88,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "018c93f98b5f14786d016a4f621adef10ad27597"
+  "gitHead": "dee1112300e01813e68b2598c3a722d1a31e1677"
 }