@friggframework/devtools 2.0.0--canary.490.feacde9.0 → 2.0.0--canary.497.a3f25f9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (26) hide show
  1. package/frigg-cli/deploy-command/index.js +3 -9
  2. package/infrastructure/README.md +0 -28
  3. package/infrastructure/domains/database/migration-builder.js +13 -19
  4. package/infrastructure/domains/database/migration-builder.test.js +0 -57
  5. package/infrastructure/domains/integration/integration-builder.js +14 -19
  6. package/infrastructure/domains/integration/integration-builder.test.js +74 -0
  7. package/infrastructure/domains/networking/vpc-builder.js +18 -240
  8. package/infrastructure/domains/networking/vpc-builder.test.js +13 -711
  9. package/infrastructure/domains/networking/vpc-resolver.js +40 -221
  10. package/infrastructure/domains/networking/vpc-resolver.test.js +18 -318
  11. package/infrastructure/domains/security/kms-builder.js +6 -55
  12. package/infrastructure/domains/security/kms-builder.test.js +1 -19
  13. package/infrastructure/domains/shared/cloudformation-discovery.js +13 -310
  14. package/infrastructure/domains/shared/cloudformation-discovery.test.js +0 -395
  15. package/infrastructure/domains/shared/providers/aws-provider-adapter.js +6 -41
  16. package/infrastructure/domains/shared/providers/aws-provider-adapter.test.js +0 -39
  17. package/infrastructure/domains/shared/resource-discovery.js +5 -17
  18. package/infrastructure/domains/shared/resource-discovery.test.js +0 -36
  19. package/infrastructure/domains/shared/utilities/base-definition-factory.js +17 -27
  20. package/infrastructure/domains/shared/utilities/base-definition-factory.test.js +0 -73
  21. package/infrastructure/infrastructure-composer.js +3 -11
  22. package/infrastructure/scripts/build-prisma-layer.js +81 -8
  23. package/infrastructure/scripts/build-prisma-layer.test.js +53 -1
  24. package/infrastructure/scripts/verify-prisma-layer.js +72 -0
  25. package/package.json +7 -7
  26. package/layers/prisma/.build-complete +0 -3
@@ -284,13 +284,8 @@ async function deployCommand(options) {
284
284
 
285
285
  console.log('\n✓ Deployment completed successfully!');
286
286
 
287
- // Run post-deployment health check (unless disabled)
288
- // Can be disabled via:
289
- // 1. CLI flag: --skip-doctor
290
- // 2. AppDefinition: deployment.skipPostDeploymentHealthCheck: true
291
- const skipHealthCheck = options.skipDoctor || appDefinition?.deployment?.skipPostDeploymentHealthCheck;
292
-
293
- if (!skipHealthCheck) {
287
+ // Run post-deployment health check (unless --skip-doctor)
288
+ if (!options.skipDoctor) {
294
289
  const stackName = getStackName(appDefinition, options);
295
290
 
296
291
  if (stackName) {
@@ -300,8 +295,7 @@ async function deployCommand(options) {
300
295
  console.log(' Run "frigg doctor <stack-name>" manually to check stack health');
301
296
  }
302
297
  } else {
303
- const reason = options.skipDoctor ? '--skip-doctor flag' : 'deployment.skipPostDeploymentHealthCheck: true';
304
- console.log(`\n⏭️ Skipping post-deployment health check (${reason})`);
298
+ console.log('\n⏭️ Skipping post-deployment health check (--skip-doctor)');
305
299
  }
306
300
  }
307
301
 
@@ -257,34 +257,6 @@ aws lambda get-function-configuration \
257
257
  --query 'Layers[*].Arn'
258
258
  ```
259
259
 
260
- **Disabling Prisma Layer (Bundle with Functions):**
261
-
262
- By default, Frigg uses a Lambda Layer for Prisma. You can disable this and bundle Prisma directly with each function:
263
-
264
- ```javascript
265
- const appDefinition = {
266
- name: 'my-app',
267
- usePrismaLambdaLayer: false, // Bundle Prisma with each function
268
- integrations: [{ Definition: { name: 'asana' } }],
269
- };
270
- ```
271
-
272
- **When to disable the Prisma Layer:**
273
-
274
- - ✅ CI/CD IAM user lacks `lambda:PublishLayerVersion` permission
275
- - ✅ Deploying to environments with Lambda layer restrictions
276
- - ✅ Prefer simpler deployment without layer management
277
- - ✅ Debugging Prisma client loading issues
278
-
279
- **Trade-offs:**
280
-
281
- | Mode | Function Size | Deploy Speed | IAM Permissions Required |
282
- |------|--------------|--------------|-------------------------|
283
- | **Layer (default)** | ~45MB per function | Faster (layer cached) | `lambda:PublishLayerVersion` |
284
- | **Bundled** | ~80MB per function | Slower (Prisma uploaded 5x) | None (layer-related) |
285
-
286
- **Note:** When `usePrismaLambdaLayer: false`, Prisma client automatically detects the bundled location at runtime. No additional configuration needed.
287
-
288
260
  ## Usage Examples
289
261
 
290
262
  ### Basic Deployment
@@ -57,9 +57,6 @@ class MigrationBuilder extends InfrastructureBuilder {
57
57
  // Backwards compatibility: Translate old schema to new ownership schema
58
58
  appDefinition = this.translateLegacyConfig(appDefinition, discoveredResources);
59
59
 
60
- // Determine if using Prisma Lambda Layer
61
- const usePrismaLayer = appDefinition.usePrismaLambdaLayer !== false;
62
-
63
60
  const result = {
64
61
  functions: {}, // Lambda function definitions
65
62
  resources: {},
@@ -79,7 +76,7 @@ class MigrationBuilder extends InfrastructureBuilder {
79
76
  console.log(` Queue: ${decisions.queue.ownership} - ${decisions.queue.reason}`);
80
77
 
81
78
  // Build resources based on ownership decisions
82
- await this.buildFromDecisions(decisions, appDefinition, discoveredResources, result, usePrismaLayer);
79
+ await this.buildFromDecisions(decisions, appDefinition, discoveredResources, result);
83
80
 
84
81
  console.log(`[${this.name}] ✅ Migration infrastructure configuration completed`);
85
82
  return result;
@@ -210,7 +207,7 @@ class MigrationBuilder extends InfrastructureBuilder {
210
207
  /**
211
208
  * Build migration resources based on ownership decisions
212
209
  */
213
- async buildFromDecisions(decisions, appDefinition, discoveredResources, result, usePrismaLayer = true) {
210
+ async buildFromDecisions(decisions, appDefinition, discoveredResources, result) {
214
211
  // Determine if we need to create resources or use existing ones
215
212
  const shouldCreateBucket = decisions.bucket.ownership === ResourceOwnership.STACK;
216
213
  const shouldCreateQueue = decisions.queue.ownership === ResourceOwnership.STACK;
@@ -218,12 +215,12 @@ class MigrationBuilder extends InfrastructureBuilder {
218
215
  if (shouldCreateBucket && shouldCreateQueue && !decisions.bucket.physicalId && !decisions.queue.physicalId) {
219
216
  // Create all new migration infrastructure
220
217
  console.log(' → Creating new migration infrastructure in stack');
221
- await this.createMigrationInfrastructure(appDefinition, result, usePrismaLayer);
218
+ await this.createMigrationInfrastructure(appDefinition, result);
222
219
  } else if ((decisions.bucket.ownership === ResourceOwnership.STACK && decisions.bucket.physicalId) ||
223
220
  (decisions.queue.ownership === ResourceOwnership.STACK && decisions.queue.physicalId)) {
224
221
  // Resources exist in stack - add definitions (CloudFormation idempotency)
225
222
  console.log(' → Adding migration definitions to template (existing in stack)');
226
- await this.createMigrationInfrastructure(appDefinition, result, usePrismaLayer);
223
+ await this.createMigrationInfrastructure(appDefinition, result);
227
224
  } else {
228
225
  // Use external resources
229
226
  console.log(' → Using external migration resources');
@@ -235,21 +232,18 @@ class MigrationBuilder extends InfrastructureBuilder {
235
232
  * Create Lambda function definitions for database migrations
236
233
  * Based on refactor/add-better-support-for-commands branch implementation
237
234
  */
238
- async createFunctionDefinitions(result, usePrismaLayer = true) {
235
+ async createFunctionDefinitions(result) {
239
236
  console.log(' 🔍 DEBUG: createFunctionDefinitions called');
240
237
  console.log(' 🔍 DEBUG: result.functions is:', typeof result.functions, result.functions);
241
238
  // Migration WORKER package config (needs Prisma CLI WASM files)
242
239
  const migrationWorkerPackageConfig = {
243
240
  individually: true,
244
241
  exclude: [
245
- // Conditionally exclude Prisma (only if using layer)
246
- ...(usePrismaLayer ? [
247
- // Exclude Prisma runtime client - it's in the Lambda Layer
248
- 'node_modules/@prisma/client/**',
249
- 'node_modules/.prisma/**',
250
- 'node_modules/@friggframework/core/generated/**',
251
- // But KEEP node_modules/prisma/** (the CLI with WASM)
252
- ] : []),
242
+ // Exclude Prisma runtime client - it's in the Lambda Layer
243
+ 'node_modules/@prisma/client/**',
244
+ 'node_modules/.prisma/**',
245
+ 'node_modules/@friggframework/core/generated/**',
246
+ // But KEEP node_modules/prisma/** (the CLI with WASM)
253
247
 
254
248
  // Exclude ALL nested node_modules
255
249
  'node_modules/**/node_modules/**',
@@ -428,7 +422,7 @@ class MigrationBuilder extends InfrastructureBuilder {
428
422
  console.log(' 🔍 DEBUG: About to create dbMigrationWorker...');
429
423
  result.functions.dbMigrationWorker = {
430
424
  handler: 'node_modules/@friggframework/core/handlers/workers/db-migration.handler',
431
- ...(usePrismaLayer && { layers: [{ Ref: 'PrismaLambdaLayer' }] }), // Conditionally use layer
425
+ layers: [{ Ref: 'PrismaLambdaLayer' }], // Use layer for Prisma client runtime
432
426
  skipEsbuild: true,
433
427
  timeout: 900, // 15 minutes for long migrations
434
428
  memorySize: 1024, // Extra memory for Prisma operations
@@ -490,12 +484,12 @@ class MigrationBuilder extends InfrastructureBuilder {
490
484
  * Create migration infrastructure CloudFormation resources
491
485
  * Creates S3 bucket, SQS queue, and Lambda function definitions
492
486
  */
493
- async createMigrationInfrastructure(appDefinition, result, usePrismaLayer = true) {
487
+ async createMigrationInfrastructure(appDefinition, result) {
494
488
  console.log(' 🔍 DEBUG: createMigrationInfrastructure called');
495
489
  console.log(' 🔍 DEBUG: result object before createFunctionDefinitions:', Object.keys(result));
496
490
 
497
491
  // Create Lambda function definitions first (they reference the queue)
498
- await this.createFunctionDefinitions(result, usePrismaLayer);
492
+ await this.createFunctionDefinitions(result);
499
493
 
500
494
  console.log(' 🔍 DEBUG: result.functions after createFunctionDefinitions:', Object.keys(result.functions || {}));
501
495
 
@@ -290,62 +290,5 @@ describe('MigrationBuilder', () => {
290
290
  expect(builder.getName()).toBe('MigrationBuilder');
291
291
  });
292
292
  });
293
-
294
- describe('usePrismaLayer configuration', () => {
295
- it('should include Prisma layer in migration worker when usePrismaLayer=true (default)', async () => {
296
- const appDef = {
297
- database: {
298
- postgres: { enable: true },
299
- },
300
- usePrismaLambdaLayer: true,
301
- };
302
-
303
- const result = await builder.build(appDef, {});
304
-
305
- expect(result.functions.dbMigrationWorker.layers).toEqual([{ Ref: 'PrismaLambdaLayer' }]);
306
-
307
- // Prisma client should be excluded from package (but not CLI)
308
- expect(result.functions.dbMigrationWorker.package.exclude).toEqual(
309
- expect.arrayContaining([
310
- 'node_modules/@prisma/client/**',
311
- 'node_modules/.prisma/**',
312
- 'node_modules/@friggframework/core/generated/**',
313
- ])
314
- );
315
- });
316
-
317
- it('should NOT include Prisma layer when usePrismaLayer=false', async () => {
318
- const appDef = {
319
- database: {
320
- postgres: { enable: true },
321
- },
322
- usePrismaLambdaLayer: false,
323
- };
324
-
325
- const result = await builder.build(appDef, {});
326
-
327
- expect(result.functions.dbMigrationWorker.layers).toBeUndefined();
328
- });
329
-
330
- it('should bundle Prisma CLI with migration worker when usePrismaLayer=false', async () => {
331
- const appDef = {
332
- database: {
333
- postgres: { enable: true },
334
- },
335
- usePrismaLambdaLayer: false,
336
- };
337
-
338
- const result = await builder.build(appDef, {});
339
-
340
- // Prisma should NOT be excluded from package (will be bundled)
341
- expect(result.functions.dbMigrationWorker.package.exclude).not.toEqual(
342
- expect.arrayContaining([
343
- 'node_modules/@prisma/client/**',
344
- 'node_modules/.prisma/**',
345
- 'node_modules/@friggframework/core/generated/**',
346
- ])
347
- );
348
- });
349
- });
350
293
  });
351
294
 
@@ -62,9 +62,6 @@ class IntegrationBuilder extends InfrastructureBuilder {
62
62
  console.log(`\n[${this.name}] Configuring integrations...`);
63
63
  console.log(` Processing ${appDefinition.integrations.length} integrations...`);
64
64
 
65
- // Determine if using Prisma Lambda Layer
66
- const usePrismaLayer = appDefinition.usePrismaLambdaLayer !== false;
67
-
68
65
  const result = {
69
66
  functions: {},
70
67
  resources: {},
@@ -90,7 +87,7 @@ class IntegrationBuilder extends InfrastructureBuilder {
90
87
  });
91
88
 
92
89
  // Build resources based on ownership decisions
93
- await this.buildFromDecisions(decisions, appDefinition, result, usePrismaLayer);
90
+ await this.buildFromDecisions(decisions, appDefinition, result);
94
91
 
95
92
  console.log(`[${this.name}] ✅ Integration configuration completed`);
96
93
  return result;
@@ -145,7 +142,7 @@ class IntegrationBuilder extends InfrastructureBuilder {
145
142
  /**
146
143
  * Build integration resources based on ownership decisions
147
144
  */
148
- async buildFromDecisions(decisions, appDefinition, result, usePrismaLayer = true) {
145
+ async buildFromDecisions(decisions, appDefinition, result) {
149
146
  // Create InternalErrorQueue if ownership = STACK
150
147
  const shouldCreateInternalErrorQueue = decisions.internalErrorQueue.ownership === ResourceOwnership.STACK;
151
148
 
@@ -158,7 +155,7 @@ class IntegrationBuilder extends InfrastructureBuilder {
158
155
  }
159
156
 
160
157
  // Create Lambda function definitions and queue resources for each integration
161
- const functionPackageConfig = this.createFunctionPackageConfig(usePrismaLayer);
158
+ const functionPackageConfig = this.createFunctionPackageConfig();
162
159
 
163
160
  for (const integration of appDefinition.integrations) {
164
161
  const integrationName = integration.Definition.name;
@@ -167,7 +164,7 @@ class IntegrationBuilder extends InfrastructureBuilder {
167
164
  console.log(`\n Adding integration: ${integrationName}`);
168
165
 
169
166
  // Create Lambda function definitions (serverless template code)
170
- await this.createFunctionDefinitions(integration, functionPackageConfig, result, usePrismaLayer);
167
+ await this.createFunctionDefinitions(integration, functionPackageConfig, result);
171
168
 
172
169
  // Create or reference SQS queue based on ownership decision
173
170
  const shouldCreateQueue = queueDecision.ownership === ResourceOwnership.STACK;
@@ -185,20 +182,18 @@ class IntegrationBuilder extends InfrastructureBuilder {
185
182
  /**
186
183
  * Create function package exclusion configuration
187
184
  */
188
- createFunctionPackageConfig(usePrismaLayer = true) {
185
+ createFunctionPackageConfig() {
189
186
  return {
190
187
  exclude: [
191
188
  // Exclude AWS SDK (provided by Lambda runtime)
192
189
  'node_modules/aws-sdk/**',
193
190
  'node_modules/@aws-sdk/**',
194
191
 
195
- // Conditionally exclude Prisma (only if using Lambda Layer)
196
- ...(usePrismaLayer ? [
197
- 'node_modules/@prisma/**',
198
- 'node_modules/.prisma/**',
199
- 'node_modules/prisma/**',
200
- 'node_modules/@friggframework/core/generated/**',
201
- ] : []),
192
+ // Exclude Prisma (provided via Lambda Layer)
193
+ 'node_modules/@prisma/**',
194
+ 'node_modules/.prisma/**',
195
+ 'node_modules/prisma/**',
196
+ 'node_modules/@friggframework/core/generated/**',
202
197
 
203
198
  // Exclude ALL nested node_modules
204
199
  'node_modules/**/node_modules/**',
@@ -254,7 +249,7 @@ class IntegrationBuilder extends InfrastructureBuilder {
254
249
  * Create Lambda function definitions for an integration
255
250
  * These are serverless framework template function definitions
256
251
  */
257
- async createFunctionDefinitions(integration, functionPackageConfig, result, usePrismaLayer = true) {
252
+ async createFunctionDefinitions(integration, functionPackageConfig, result) {
258
253
  const integrationName = integration.Definition.name;
259
254
 
260
255
  // Add webhook handler if enabled (BEFORE catch-all proxy route)
@@ -266,9 +261,9 @@ class IntegrationBuilder extends InfrastructureBuilder {
266
261
 
267
262
  result.functions[webhookFunctionName] = {
268
263
  handler: `node_modules/@friggframework/core/handlers/routers/integration-webhook-routers.handlers.${integrationName}Webhook.handler`,
269
- ...(usePrismaLayer && { layers: [{ Ref: 'PrismaLambdaLayer' }] }),
270
264
  skipEsbuild: true, // Nested exports in node_modules - skip esbuild bundling
271
265
  package: functionPackageConfig,
266
+ layers: [{ Ref: 'PrismaLambdaLayer' }], // Webhook handlers need Prisma for credential lookups
272
267
  events: [
273
268
  {
274
269
  httpApi: {
@@ -290,9 +285,9 @@ class IntegrationBuilder extends InfrastructureBuilder {
290
285
  // Create HTTP API handler for integration (catch-all route AFTER webhooks)
291
286
  result.functions[integrationName] = {
292
287
  handler: `node_modules/@friggframework/core/handlers/routers/integration-defined-routers.handlers.${integrationName}.handler`,
293
- ...(usePrismaLayer && { layers: [{ Ref: 'PrismaLambdaLayer' }] }),
294
288
  skipEsbuild: true, // Nested exports in node_modules - skip esbuild bundling
295
289
  package: functionPackageConfig,
290
+ layers: [{ Ref: 'PrismaLambdaLayer' }], // HTTP handlers need Prisma for integration queries
296
291
  events: [
297
292
  {
298
293
  httpApi: {
@@ -308,9 +303,9 @@ class IntegrationBuilder extends InfrastructureBuilder {
308
303
  const queueWorkerName = `${integrationName}QueueWorker`;
309
304
  result.functions[queueWorkerName] = {
310
305
  handler: `node_modules/@friggframework/core/handlers/workers/integration-defined-workers.handlers.${integrationName}.queueWorker`,
311
- ...(usePrismaLayer && { layers: [{ Ref: 'PrismaLambdaLayer' }] }),
312
306
  skipEsbuild: true, // Nested exports in node_modules - skip esbuild bundling
313
307
  package: functionPackageConfig,
308
+ layers: [{ Ref: 'PrismaLambdaLayer' }], // Queue workers need Prisma for database operations
314
309
  reservedConcurrency: 5,
315
310
  events: [
316
311
  {
@@ -589,5 +589,79 @@ describe('IntegrationBuilder', () => {
589
589
  expect(result.functions.testWebhook.package.exclude).toContain('node_modules/@prisma/**');
590
590
  });
591
591
  });
592
+
593
+ describe('Prisma Layer Configuration', () => {
594
+ it('should attach Prisma Lambda layer to queue worker functions', async () => {
595
+ const appDefinition = {
596
+ integrations: [
597
+ { Definition: { name: 'hubspot' } },
598
+ ],
599
+ };
600
+
601
+ const result = await integrationBuilder.build(appDefinition, {});
602
+
603
+ // Queue workers need Prisma layer for database operations
604
+ expect(result.functions.hubspotQueueWorker.layers).toEqual([
605
+ { Ref: 'PrismaLambdaLayer' }
606
+ ]);
607
+ });
608
+
609
+ it('should attach Prisma layer to multiple queue workers', async () => {
610
+ const appDefinition = {
611
+ integrations: [
612
+ { Definition: { name: 'hubspot' } },
613
+ { Definition: { name: 'salesforce' } },
614
+ { Definition: { name: 'slack' } },
615
+ ],
616
+ };
617
+
618
+ const result = await integrationBuilder.build(appDefinition, {});
619
+
620
+ expect(result.functions.hubspotQueueWorker.layers).toEqual([
621
+ { Ref: 'PrismaLambdaLayer' }
622
+ ]);
623
+ expect(result.functions.salesforceQueueWorker.layers).toEqual([
624
+ { Ref: 'PrismaLambdaLayer' }
625
+ ]);
626
+ expect(result.functions.slackQueueWorker.layers).toEqual([
627
+ { Ref: 'PrismaLambdaLayer' }
628
+ ]);
629
+ });
630
+
631
+ it('should attach Prisma layer to HTTP handlers for database access', async () => {
632
+ const appDefinition = {
633
+ integrations: [
634
+ { Definition: { name: 'stripe' } },
635
+ ],
636
+ };
637
+
638
+ const result = await integrationBuilder.build(appDefinition, {});
639
+
640
+ // HTTP handlers also need Prisma for integration queries
641
+ expect(result.functions.stripe.layers).toEqual([
642
+ { Ref: 'PrismaLambdaLayer' }
643
+ ]);
644
+ });
645
+
646
+ it('should attach Prisma layer to webhook handlers', async () => {
647
+ const appDefinition = {
648
+ integrations: [
649
+ {
650
+ Definition: {
651
+ name: 'hubspot',
652
+ webhooks: true,
653
+ }
654
+ },
655
+ ],
656
+ };
657
+
658
+ const result = await integrationBuilder.build(appDefinition, {});
659
+
660
+ // Webhook handlers need Prisma for credential lookups
661
+ expect(result.functions.hubspotWebhook.layers).toEqual([
662
+ { Ref: 'PrismaLambdaLayer' }
663
+ ]);
664
+ });
665
+ });
592
666
  });
593
667