@mailshot/cdk 0.2.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 (41) hide show
  1. package/dist/bin/app.d.ts +3 -0
  2. package/dist/bin/app.d.ts.map +1 -0
  3. package/dist/bin/app.js +94 -0
  4. package/dist/bin/app.js.map +1 -0
  5. package/dist/lib/constructs/event-bus.d.ts +16 -0
  6. package/dist/lib/constructs/event-bus.d.ts.map +1 -0
  7. package/dist/lib/constructs/event-bus.js +119 -0
  8. package/dist/lib/constructs/event-bus.js.map +1 -0
  9. package/dist/lib/constructs/lambdas.d.ts +26 -0
  10. package/dist/lib/constructs/lambdas.d.ts.map +1 -0
  11. package/dist/lib/constructs/lambdas.js +178 -0
  12. package/dist/lib/constructs/lambdas.js.map +1 -0
  13. package/dist/lib/constructs/ses-config.d.ts +14 -0
  14. package/dist/lib/constructs/ses-config.d.ts.map +1 -0
  15. package/dist/lib/constructs/ses-config.js +75 -0
  16. package/dist/lib/constructs/ses-config.js.map +1 -0
  17. package/dist/lib/constructs/ssm-params.d.ts +17 -0
  18. package/dist/lib/constructs/ssm-params.d.ts.map +1 -0
  19. package/dist/lib/constructs/ssm-params.js +63 -0
  20. package/dist/lib/constructs/ssm-params.js.map +1 -0
  21. package/dist/lib/constructs/state-machines.d.ts +21 -0
  22. package/dist/lib/constructs/state-machines.d.ts.map +1 -0
  23. package/dist/lib/constructs/state-machines.js +216 -0
  24. package/dist/lib/constructs/state-machines.js.map +1 -0
  25. package/dist/lib/constructs/storage.d.ts +17 -0
  26. package/dist/lib/constructs/storage.d.ts.map +1 -0
  27. package/dist/lib/constructs/storage.js +91 -0
  28. package/dist/lib/constructs/storage.js.map +1 -0
  29. package/dist/lib/load-sequences.d.ts +7 -0
  30. package/dist/lib/load-sequences.d.ts.map +1 -0
  31. package/dist/lib/load-sequences.js +76 -0
  32. package/dist/lib/load-sequences.js.map +1 -0
  33. package/dist/lib/mailshot-stack.d.ts +13 -0
  34. package/dist/lib/mailshot-stack.d.ts.map +1 -0
  35. package/dist/lib/mailshot-stack.js +155 -0
  36. package/dist/lib/mailshot-stack.js.map +1 -0
  37. package/dist/lib/step-func-emailer-stack.d.ts +13 -0
  38. package/dist/lib/step-func-emailer-stack.d.ts.map +1 -0
  39. package/dist/lib/step-func-emailer-stack.js +155 -0
  40. package/dist/lib/step-func-emailer-stack.js.map +1 -0
  41. package/package.json +55 -0
@@ -0,0 +1,155 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.MailshotStack = void 0;
37
+ const path = __importStar(require("node:path"));
38
+ const cdk = __importStar(require("aws-cdk-lib"));
39
+ const storage_js_1 = require("./constructs/storage.js");
40
+ const ssm_params_js_1 = require("./constructs/ssm-params.js");
41
+ const lambdas_js_1 = require("./constructs/lambdas.js");
42
+ const ses_config_js_1 = require("./constructs/ses-config.js");
43
+ const state_machines_js_1 = require("./constructs/state-machines.js");
44
+ const event_bus_js_1 = require("./constructs/event-bus.js");
45
+ class MailshotStack extends cdk.Stack {
46
+ constructor(scope, id, props) {
47
+ super(scope, id, props);
48
+ const { config, definitions } = props;
49
+ // ── Storage (DynamoDB + S3) ──────────────────────────────────────────
50
+ const storage = new storage_js_1.StorageConstruct(this, "Storage", {
51
+ tableName: config.tableName,
52
+ eventsTableName: config.eventsTableName,
53
+ templateBucketName: config.templateBucketName,
54
+ sequenceIds: definitions.map((d) => d.id),
55
+ templateBuildDir: props.templateBuildDir ?? path.resolve(process.cwd(), "build"),
56
+ });
57
+ // ── SES configuration ────────────────────────────────────────────────
58
+ const sesConfig = new ses_config_js_1.SesConfigConstruct(this, "SesConfig", {
59
+ configSetName: config.sesConfigSetName,
60
+ snsTopicName: config.snsTopicName,
61
+ });
62
+ // ── Lambdas ──────────────────────────────────────────────────────────
63
+ const lambdas = new lambdas_js_1.LambdasConstruct(this, "Lambdas", {
64
+ table: storage.table,
65
+ eventsTable: storage.eventsTable,
66
+ templateBucket: storage.templateBucket,
67
+ ssmPrefix: config.ssmPrefix,
68
+ snsTopic: sesConfig.snsTopic,
69
+ sesConfigSetName: config.sesConfigSetName,
70
+ handlersPath: props.handlersPath,
71
+ });
72
+ // Subscribe engagement handler to engagement events
73
+ sesConfig.engagementTopic.addSubscription(new cdk.aws_sns_subscriptions.LambdaSubscription(lambdas.engagementHandlerFn));
74
+ // ── SSM Parameters ───────────────────────────────────────────────────
75
+ new ssm_params_js_1.SsmConstruct(this, "SsmParams", {
76
+ prefix: config.ssmPrefix,
77
+ tableName: storage.table.tableName,
78
+ eventsTableName: storage.eventsTable.tableName,
79
+ templateBucketName: storage.templateBucket.bucketName,
80
+ defaultFromEmail: config.defaultFromEmail,
81
+ defaultFromName: config.defaultFromName,
82
+ replyToEmail: config.replyToEmail,
83
+ sesConfigSetName: config.sesConfigSetName,
84
+ unsubscribeBaseUrl: lambdas.unsubscribeFnUrl,
85
+ unsubscribeSecret: config.unsubscribeSecret,
86
+ });
87
+ // ── State machines ───────────────────────────────────────────────────
88
+ const stateMachines = new state_machines_js_1.StateMachinesConstruct(this, "StateMachines", {
89
+ sendEmailFn: lambdas.sendEmailFn,
90
+ checkConditionFn: lambdas.checkConditionFn,
91
+ sequences: definitions,
92
+ });
93
+ // Grant permissions to stop executions.
94
+ // states:StopExecution targets execution ARNs which contain random IDs —
95
+ // scoping to arn:aws:states:*:*:execution:* is functionally equivalent to *,
96
+ // so we keep * for clarity.
97
+ lambdas.sendEmailFn.addToRolePolicy(new cdk.aws_iam.PolicyStatement({
98
+ actions: ["states:StopExecution"],
99
+ resources: ["*"],
100
+ }));
101
+ lambdas.unsubscribeFn.addToRolePolicy(new cdk.aws_iam.PolicyStatement({
102
+ actions: ["states:StopExecution"],
103
+ resources: ["*"],
104
+ }));
105
+ lambdas.bounceHandlerFn.addToRolePolicy(new cdk.aws_iam.PolicyStatement({
106
+ actions: ["states:StopExecution"],
107
+ resources: ["*"],
108
+ }));
109
+ // Grant read on state machines — construct ARNs manually to avoid circular
110
+ // dependency between StateMachine → Lambda → StateMachine via EventBridge
111
+ const smArns = definitions.map((d) => {
112
+ const name = d.id
113
+ .split(/[-_]/)
114
+ .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
115
+ .join("") + "Sequence";
116
+ return this.formatArn({
117
+ service: "states",
118
+ resource: "stateMachine",
119
+ resourceName: name,
120
+ arnFormat: cdk.ArnFormat.COLON_RESOURCE_NAME,
121
+ });
122
+ });
123
+ const smExecArns = smArns.map((arn) => arn.replace(":stateMachine:", ":execution:") + ":*");
124
+ lambdas.sendEmailFn.addToRolePolicy(new cdk.aws_iam.PolicyStatement({
125
+ actions: ["states:DescribeStateMachine", "states:ListExecutions"],
126
+ resources: smArns,
127
+ }));
128
+ lambdas.sendEmailFn.addToRolePolicy(new cdk.aws_iam.PolicyStatement({
129
+ actions: ["states:DescribeExecution", "states:GetExecutionHistory"],
130
+ resources: smExecArns,
131
+ }));
132
+ // ── EventBridge ──────────────────────────────────────────────────────
133
+ new event_bus_js_1.EventBusConstruct(this, "EventBus", {
134
+ eventBusName: config.eventBusName,
135
+ definitions,
136
+ stateMachines: stateMachines.stateMachines,
137
+ sendEmailFn: lambdas.sendEmailFn,
138
+ });
139
+ // ── Outputs ──────────────────────────────────────────────────────────
140
+ new cdk.CfnOutput(this, "TableName", {
141
+ value: storage.table.tableName,
142
+ });
143
+ new cdk.CfnOutput(this, "TemplateBucket", {
144
+ value: storage.templateBucket.bucketName,
145
+ });
146
+ new cdk.CfnOutput(this, "UnsubscribeUrl", {
147
+ value: lambdas.unsubscribeFnUrl,
148
+ });
149
+ new cdk.CfnOutput(this, "EventBusName", {
150
+ value: config.eventBusName,
151
+ });
152
+ }
153
+ }
154
+ exports.MailshotStack = MailshotStack;
155
+ //# sourceMappingURL=mailshot-stack.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mailshot-stack.js","sourceRoot":"","sources":["../../lib/mailshot-stack.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import * as cdk from "aws-cdk-lib";
2
+ import type { Construct } from "constructs";
3
+ import type { StepFuncEmailerConfig, SequenceDefinition } from "@step-func-emailer/shared";
4
+ export interface StepFuncEmailerStackProps extends cdk.StackProps {
5
+ config: StepFuncEmailerConfig;
6
+ definitions: SequenceDefinition[];
7
+ handlersPath?: string;
8
+ templateBuildDir?: string;
9
+ }
10
+ export declare class StepFuncEmailerStack extends cdk.Stack {
11
+ constructor(scope: Construct, id: string, props: StepFuncEmailerStackProps);
12
+ }
13
+ //# sourceMappingURL=step-func-emailer-stack.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"step-func-emailer-stack.d.ts","sourceRoot":"","sources":["../../lib/step-func-emailer-stack.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAQ3F,MAAM,WAAW,yBAA0B,SAAQ,GAAG,CAAC,UAAU;IAC/D,MAAM,EAAE,qBAAqB,CAAC;IAC9B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,oBAAqB,SAAQ,GAAG,CAAC,KAAK;gBACrC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,yBAAyB;CAmI3E"}
@@ -0,0 +1,155 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || (function () {
19
+ var ownKeys = function(o) {
20
+ ownKeys = Object.getOwnPropertyNames || function (o) {
21
+ var ar = [];
22
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
23
+ return ar;
24
+ };
25
+ return ownKeys(o);
26
+ };
27
+ return function (mod) {
28
+ if (mod && mod.__esModule) return mod;
29
+ var result = {};
30
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
31
+ __setModuleDefault(result, mod);
32
+ return result;
33
+ };
34
+ })();
35
+ Object.defineProperty(exports, "__esModule", { value: true });
36
+ exports.StepFuncEmailerStack = void 0;
37
+ const path = __importStar(require("node:path"));
38
+ const cdk = __importStar(require("aws-cdk-lib"));
39
+ const storage_js_1 = require("./constructs/storage.js");
40
+ const ssm_params_js_1 = require("./constructs/ssm-params.js");
41
+ const lambdas_js_1 = require("./constructs/lambdas.js");
42
+ const ses_config_js_1 = require("./constructs/ses-config.js");
43
+ const state_machines_js_1 = require("./constructs/state-machines.js");
44
+ const event_bus_js_1 = require("./constructs/event-bus.js");
45
+ class StepFuncEmailerStack extends cdk.Stack {
46
+ constructor(scope, id, props) {
47
+ super(scope, id, props);
48
+ const { config, definitions } = props;
49
+ // ── Storage (DynamoDB + S3) ──────────────────────────────────────────
50
+ const storage = new storage_js_1.StorageConstruct(this, "Storage", {
51
+ tableName: config.tableName,
52
+ eventsTableName: config.eventsTableName,
53
+ templateBucketName: config.templateBucketName,
54
+ sequenceIds: definitions.map((d) => d.id),
55
+ templateBuildDir: props.templateBuildDir ?? path.resolve(process.cwd(), "build"),
56
+ });
57
+ // ── SES configuration ────────────────────────────────────────────────
58
+ const sesConfig = new ses_config_js_1.SesConfigConstruct(this, "SesConfig", {
59
+ configSetName: config.sesConfigSetName,
60
+ snsTopicName: config.snsTopicName,
61
+ });
62
+ // ── Lambdas ──────────────────────────────────────────────────────────
63
+ const lambdas = new lambdas_js_1.LambdasConstruct(this, "Lambdas", {
64
+ table: storage.table,
65
+ eventsTable: storage.eventsTable,
66
+ templateBucket: storage.templateBucket,
67
+ ssmPrefix: config.ssmPrefix,
68
+ snsTopic: sesConfig.snsTopic,
69
+ sesConfigSetName: config.sesConfigSetName,
70
+ handlersPath: props.handlersPath,
71
+ });
72
+ // Subscribe engagement handler to engagement events
73
+ sesConfig.engagementTopic.addSubscription(new cdk.aws_sns_subscriptions.LambdaSubscription(lambdas.engagementHandlerFn));
74
+ // ── SSM Parameters ───────────────────────────────────────────────────
75
+ new ssm_params_js_1.SsmConstruct(this, "SsmParams", {
76
+ prefix: config.ssmPrefix,
77
+ tableName: storage.table.tableName,
78
+ eventsTableName: storage.eventsTable.tableName,
79
+ templateBucketName: storage.templateBucket.bucketName,
80
+ defaultFromEmail: config.defaultFromEmail,
81
+ defaultFromName: config.defaultFromName,
82
+ replyToEmail: config.replyToEmail,
83
+ sesConfigSetName: config.sesConfigSetName,
84
+ unsubscribeBaseUrl: lambdas.unsubscribeFnUrl,
85
+ unsubscribeSecret: config.unsubscribeSecret,
86
+ });
87
+ // ── State machines ───────────────────────────────────────────────────
88
+ const stateMachines = new state_machines_js_1.StateMachinesConstruct(this, "StateMachines", {
89
+ sendEmailFn: lambdas.sendEmailFn,
90
+ checkConditionFn: lambdas.checkConditionFn,
91
+ sequences: definitions,
92
+ });
93
+ // Grant permissions to stop executions.
94
+ // states:StopExecution targets execution ARNs which contain random IDs —
95
+ // scoping to arn:aws:states:*:*:execution:* is functionally equivalent to *,
96
+ // so we keep * for clarity.
97
+ lambdas.sendEmailFn.addToRolePolicy(new cdk.aws_iam.PolicyStatement({
98
+ actions: ["states:StopExecution"],
99
+ resources: ["*"],
100
+ }));
101
+ lambdas.unsubscribeFn.addToRolePolicy(new cdk.aws_iam.PolicyStatement({
102
+ actions: ["states:StopExecution"],
103
+ resources: ["*"],
104
+ }));
105
+ lambdas.bounceHandlerFn.addToRolePolicy(new cdk.aws_iam.PolicyStatement({
106
+ actions: ["states:StopExecution"],
107
+ resources: ["*"],
108
+ }));
109
+ // Grant read on state machines — construct ARNs manually to avoid circular
110
+ // dependency between StateMachine → Lambda → StateMachine via EventBridge
111
+ const smArns = definitions.map((d) => {
112
+ const name = d.id
113
+ .split(/[-_]/)
114
+ .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
115
+ .join("") + "Sequence";
116
+ return this.formatArn({
117
+ service: "states",
118
+ resource: "stateMachine",
119
+ resourceName: name,
120
+ arnFormat: cdk.ArnFormat.COLON_RESOURCE_NAME,
121
+ });
122
+ });
123
+ const smExecArns = smArns.map((arn) => arn.replace(":stateMachine:", ":execution:") + ":*");
124
+ lambdas.sendEmailFn.addToRolePolicy(new cdk.aws_iam.PolicyStatement({
125
+ actions: ["states:DescribeStateMachine", "states:ListExecutions"],
126
+ resources: smArns,
127
+ }));
128
+ lambdas.sendEmailFn.addToRolePolicy(new cdk.aws_iam.PolicyStatement({
129
+ actions: ["states:DescribeExecution", "states:GetExecutionHistory"],
130
+ resources: smExecArns,
131
+ }));
132
+ // ── EventBridge ──────────────────────────────────────────────────────
133
+ new event_bus_js_1.EventBusConstruct(this, "EventBus", {
134
+ eventBusName: config.eventBusName,
135
+ definitions,
136
+ stateMachines: stateMachines.stateMachines,
137
+ sendEmailFn: lambdas.sendEmailFn,
138
+ });
139
+ // ── Outputs ──────────────────────────────────────────────────────────
140
+ new cdk.CfnOutput(this, "TableName", {
141
+ value: storage.table.tableName,
142
+ });
143
+ new cdk.CfnOutput(this, "TemplateBucket", {
144
+ value: storage.templateBucket.bucketName,
145
+ });
146
+ new cdk.CfnOutput(this, "UnsubscribeUrl", {
147
+ value: lambdas.unsubscribeFnUrl,
148
+ });
149
+ new cdk.CfnOutput(this, "EventBusName", {
150
+ value: config.eventBusName,
151
+ });
152
+ }
153
+ }
154
+ exports.StepFuncEmailerStack = StepFuncEmailerStack;
155
+ //# sourceMappingURL=step-func-emailer-stack.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"step-func-emailer-stack.js","sourceRoot":"","sources":["../../lib/step-func-emailer-stack.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,55 @@
1
+ {
2
+ "name": "@mailshot/cdk",
3
+ "version": "0.2.0",
4
+ "description": "AWS CDK constructs for mailshot",
5
+ "license": "MIT",
6
+ "type": "commonjs",
7
+ "main": "dist/lib/mailshot-stack.js",
8
+ "types": "dist/lib/mailshot-stack.d.ts",
9
+ "files": [
10
+ "dist"
11
+ ],
12
+ "publishConfig": {
13
+ "access": "public"
14
+ },
15
+ "repository": {
16
+ "type": "git",
17
+ "url": "https://github.com/mdwt/mailshot.git",
18
+ "directory": "packages/cdk"
19
+ },
20
+ "exports": {
21
+ ".": {
22
+ "types": "./dist/lib/mailshot-stack.d.ts",
23
+ "default": "./dist/lib/mailshot-stack.js"
24
+ },
25
+ "./load-sequences": {
26
+ "types": "./dist/lib/load-sequences.d.ts",
27
+ "default": "./dist/lib/load-sequences.js"
28
+ }
29
+ },
30
+ "scripts": {
31
+ "build": "tsc",
32
+ "typecheck": "tsc --noEmit",
33
+ "test": "vitest run --passWithNoTests",
34
+ "lint": "eslint bin lib",
35
+ "cdk": "cdk",
36
+ "synth": "cdk synth",
37
+ "deploy": "cdk deploy"
38
+ },
39
+ "dependencies": {
40
+ "@mailshot/handlers": "workspace:*",
41
+ "@mailshot/shared": "workspace:*",
42
+ "source-map-support": "^0.5.21"
43
+ },
44
+ "peerDependencies": {
45
+ "aws-cdk-lib": "^2.243.0",
46
+ "constructs": "^10.5.1"
47
+ },
48
+ "devDependencies": {
49
+ "@types/source-map-support": "^0.5.10",
50
+ "aws-cdk": "^2.1111.0",
51
+ "aws-cdk-lib": "^2.243.0",
52
+ "constructs": "^10.5.1",
53
+ "ts-node": "^10.9.2"
54
+ }
55
+ }