create-step-func-emailer 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable no-console */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const projectName = process.argv[2];
+if (!projectName) {
+    console.error("Usage: npx create-step-func-emailer <project-name>");
+    process.exit(1);
+}
+const targetDir = path.resolve(process.cwd(), projectName);
+if (fs.existsSync(targetDir)) {
+    console.error(`Directory ${projectName} already exists.`);
+    process.exit(1);
+}
+const templateDir = path.join(__dirname, "../template");
+function copyDir(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = path.join(src, entry.name);
+        // Rename _gitignore → .gitignore (npm strips dotfiles)
+        const destName = entry.name === "_gitignore" ? ".gitignore" : entry.name;
+        const destPath = path.join(dest, destName);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+console.log(`Creating ${projectName}...`);
+copyDir(templateDir, targetDir);
+// Install dependencies
+console.log("\nInstalling dependencies...");
+try {
+    (0, node_child_process_1.execSync)("pnpm install", { cwd: targetDir, stdio: "inherit" });
+}
+catch {
+    console.log("pnpm not found, trying npm...");
+    (0, node_child_process_1.execSync)("npm install", { cwd: targetDir, stdio: "inherit" });
+}
+// Git init + initial commit
+console.log("\nInitializing git repository...");
+(0, node_child_process_1.execSync)("git init", { cwd: targetDir, stdio: "inherit" });
+(0, node_child_process_1.execSync)("git add -A", { cwd: targetDir, stdio: "inherit" });
+(0, node_child_process_1.execSync)('git commit -m "Initial project scaffold"', {
+    cwd: targetDir,
+    stdio: "inherit",
+});
+console.log(`
+Done! Created ${projectName}
+
+Next steps:
+  cd ${projectName}
+  claude                    # Open Claude Code
+  /setup-env                # Configure AWS environment
+  /create-sequence          # Create your first email sequence
+  /deploy                   # Deploy to AWS
+`);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "create-step-func-emailer",
+  "version": "0.2.0",
+  "description": "Create a new step-func-emailer project",
+  "license": "MIT",
+  "type": "commonjs",
+  "bin": {
+    "create-step-func-emailer": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "template"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mdwt/step-func-emailer.git",
+    "directory": "packages/create"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/template/.env.example

@@ -0,0 +1,15 @@
+AWS_PROFILE=default
+ACCOUNT=123456789012
+REGION=us-east-1
+STACK_NAME=StepFuncEmailer
+TABLE_NAME=StepFuncEmailer
+EVENTS_TABLE_NAME=StepFuncEmailer-events
+TEMPLATE_BUCKET_NAME=step-func-emailer-templates-mycompany
+EVENT_BUS_NAME=step-func-emailer-bus
+SES_CONFIG_SET_NAME=step-func-emailer-config
+SNS_TOPIC_NAME=step-func-emailer-ses-notifications
+DEFAULT_FROM_EMAIL=hello@example.com
+DEFAULT_FROM_NAME=MyCompany
+REPLY_TO_EMAIL=support@example.com
+UNSUBSCRIBE_SECRET=replace-with-a-real-secret
+SSM_PREFIX=/step-func-emailer

package/template/CLAUDE.md

@@ -0,0 +1,17 @@
+# Email Sequences Project
+
+Built with [step-func-emailer](https://github.com/mdwt/step-func-emailer).
+
+## Commands
+
+- `pnpm build` — build all sequences
+- `pnpm deploy` — deploy to AWS
+- `/create-sequence` — create a new email sequence
+- `/setup-env` — configure AWS environment
+- `/deploy` — build and deploy
+
+## Structure
+
+- `sequences/` — email sequences (auto-discovered by CDK)
+- `bin/app.ts` — CDK entry point
+- `.env` — AWS configuration

package/template/_gitignore

@@ -0,0 +1,10 @@
+node_modules/
+dist/
+build/
+cdk.out/
+.env
+*.js
+*.d.ts
+*.js.map
+*.d.ts.map
+!bin/app.ts

package/template/bin/app.ts

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import "source-map-support/register";
+import * as path from "node:path";
+import * as fs from "node:fs";
+import * as cdk from "aws-cdk-lib";
+import type { StepFuncEmailerConfig } from "@step-func-emailer/shared";
+import { StepFuncEmailerStack } from "@step-func-emailer/cdk";
+import { loadSequenceConfigs } from "@step-func-emailer/cdk/load-sequences";
+
+// Load .env from project root
+const envPath = path.join(__dirname, "../.env");
+if (fs.existsSync(envPath)) {
+  for (const line of fs.readFileSync(envPath, "utf-8").split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const idx = trimmed.indexOf("=");
+    if (idx === -1) continue;
+    const key = trimmed.slice(0, idx);
+    const value = trimmed.slice(idx + 1);
+    if (!(key in process.env)) process.env[key] = value;
+  }
+}
+
+function required(name: string): string {
+  const val = process.env[name];
+  if (!val) throw new Error(`Missing env var ${name}. Run /setup-env in Claude Code.`);
+  return val;
+}
+
+const config: StepFuncEmailerConfig = {
+  account: required("ACCOUNT"),
+  region: required("REGION"),
+  stackName: required("STACK_NAME"),
+  tableName: required("TABLE_NAME"),
+  eventsTableName: required("EVENTS_TABLE_NAME"),
+  templateBucketName: required("TEMPLATE_BUCKET_NAME"),
+  eventBusName: required("EVENT_BUS_NAME"),
+  sesConfigSetName: required("SES_CONFIG_SET_NAME"),
+  snsTopicName: required("SNS_TOPIC_NAME"),
+  defaultFromEmail: required("DEFAULT_FROM_EMAIL"),
+  defaultFromName: required("DEFAULT_FROM_NAME"),
+  replyToEmail: process.env.REPLY_TO_EMAIL || undefined,
+  unsubscribeSecret: required("UNSUBSCRIBE_SECRET"),
+  ssmPrefix: required("SSM_PREFIX"),
+};
+
+const definitions = loadSequenceConfigs();
+const app = new cdk.App();
+new StepFuncEmailerStack(app, config.stackName, {
+  env: { account: config.account, region: config.region },
+  config,
+  definitions,
+});

package/template/cdk.json

@@ -0,0 +1 @@
+{ "app": "npx tsx bin/app.ts" }

package/template/package.json

@@ -0,0 +1,19 @@
+{
+  "private": true,
+  "scripts": {
+    "build": "pnpm -r build",
+    "synth": "npx cdk synth",
+    "deploy": "npx cdk deploy --require-approval never",
+    "typecheck": "pnpm -r typecheck"
+  },
+  "devDependencies": {
+    "@step-func-emailer/cdk": "^0.1.0",
+    "@step-func-emailer/shared": "^0.1.0",
+    "aws-cdk": "^2.1111.0",
+    "aws-cdk-lib": "^2.243.0",
+    "constructs": "^10.5.1",
+    "source-map-support": "^0.5.21",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.0"
+  }
+}

package/template/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - sequences/*

package/template/tsconfig.base.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ES2022"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "outDir": "dist",
+    "rootDir": "src"
+  }
+}