@venturekit/infra 0.0.0-dev.20260312012510 → 0.0.0-dev.20260329102450

package/dist/cdk/index.js

@@ -1,11 +1,7 @@
-"use strict";
 /**
  * CDK constructs for VentureKit infrastructure.
  *
  * Exported for use by the generated CDK app in .vk/cdk/.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VentureStack = void 0;
-var stack_js_1 = require("./stack.js");
-Object.defineProperty(exports, "VentureStack", { enumerable: true, get: function () { return stack_js_1.VentureStack; } });
+export { VentureStack } from './stack.js';
 //# sourceMappingURL=index.js.map

package/dist/cdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cdk/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,uCAA0C;AAAjC,wGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cdk/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/cdk/stack.d.ts

@@ -8,22 +8,154 @@
  */
 import * as cdk from 'aws-cdk-lib';
 import { Construct } from 'constructs';
-import type { VentureIntent } from '@venturekit/core';
+import type { VentureIntent, EnvConfig } from '@venturekit/core';
 export interface VentureStackProps extends cdk.StackProps {
     projectName: string;
     stage: string;
     routesDir: string;
+    /** Directory containing standalone Lambda functions */
+    functionsDir?: string;
+    /** Directory containing queue consumer handlers */
+    queuesDir?: string;
+    /** Directory containing cron/scheduled task handlers */
+    cronsDir?: string;
     infrastructure?: VentureIntent;
     projectDir: string;
+    /** Preset name — when 'free', uses only free-tier AWS resources */
+    preset?: string;
+    /**
+     * Fully resolved environment configuration from presets + user overrides.
+     * When provided, all resource sizing is driven by this config.
+     * When absent, falls back to legacy behavior using `preset` string.
+     */
+    envConfig?: EnvConfig;
 }
 export declare class VentureStack extends cdk.Stack {
     readonly outputs: Record<string, cdk.CfnOutput>;
+    /** Resolved environment configuration driving all resource sizing */
+    private readonly envConfig;
+    /** Data safety configuration for removal policies */
+    private readonly dataSafetyConfig;
+    /** Whether this is a free-tier deployment */
+    private readonly isFreeTier;
+    /** Standard tags applied to all taggable resources */
+    private readonly standardTags;
     constructor(scope: Construct, id: string, props: VentureStackProps);
+    /**
+     * Well-Architected: Reliability — RDS with stable logical ID so preset
+     * changes (e.g. nano→medium) perform an in-place instance class modify,
+     * not a replacement. Data is preserved because the CloudFormation resource
+     * identity stays the same.
+     *
+     * Well-Architected: Security — encrypted at rest, credentials in Secrets Manager
+     * Well-Architected: Reliability — automated backups, optional multi-AZ
+     * Well-Architected: Performance — instance type driven by intent.size
+     * Well-Architected: Operational Excellence — auto minor version upgrades
+     */
     private createDatabase;
+    /**
+     * Well-Architected: Security — block public access by default, SSE encryption
+     * Well-Architected: Reliability — versioning for backups, dataSafety removal policy
+     * Well-Architected: Cost — lifecycle rules for logs/backups to reduce storage cost
+     * Well-Architected: Sustainability — intelligent tiering for infrequent access
+     */
     private createStorage;
+    /**
+     * Well-Architected: Security — Cognito with advanced security features,
+     * stable logical ID for safe preset upgrades.
+     * Well-Architected: Reliability — dataSafety-driven removal policy
+     */
     private createAuth;
+    /**
+     * Well-Architected: Reliability — DLQ by default, stable logical ID
+     * Well-Architected: Security — encryption at rest with SQS managed keys
+     * Well-Architected: Performance — visibility timeout derived from handler timeout
+     */
     private createQueue;
+    /**
+     * Well-Architected: Security — VPC-only access, SG least-privilege
+     * Well-Architected: Performance — cache node type driven by intent.size
+     * Well-Architected: Reliability — encrypted in transit, snapshot retention for prod
+     */
     private createCache;
+    private createMonitoring;
+    private createSecret;
+    private createDomain;
+    /**
+     * Free-tier alternative to RDS: create a DynamoDB table.
+     * DynamoDB offers 25 GB + 25 RCU/WCU in the always-free tier.
+     *
+     * Well-Architected: Security — encryption at rest (default)
+     * Well-Architected: Reliability — PITR for strict dataSafety
+     * Well-Architected: Cost — PAY_PER_REQUEST for unpredictable workloads
+     */
+    private createDynamoDBTable;
+    /**
+     * Free-tier rate limit table using DynamoDB (always-free tier).
+     * Used by createDefaultRateLimiter() from @venturekit/runtime.
+     */
+    private createRateLimitTable;
+    /**
+     * Map ResourceSize to RDS instance type.
+     * Uses Graviton (T4G) instances for cost efficiency.
+     * Changing size triggers an in-place modify, NOT a replacement.
+     */
     private sizeToInstanceType;
+    /**
+     * Map ResourceSize to ElastiCache node type.
+     * Uses Graviton (T4G) instances for cost efficiency.
+     * Changing size triggers an in-place modify, NOT a replacement.
+     */
+    private sizeToCacheNodeType;
+    /**
+     * Convert dataSafety config to CDK RemovalPolicy.
+     * Well-Architected: Reliability — prevent accidental data loss.
+     */
+    private toRemovalPolicy;
+    /**
+     * Convert days to CDK logs.RetentionDays enum.
+     * Well-Architected: Cost — don't over-retain logs.
+     */
+    private toLogRetention;
+    /**
+     * Resolve Lambda runtime from preset config.
+     */
+    private toLambdaRuntime;
+    /**
+     * Resolve Lambda architecture from preset config.
+     */
+    private toLambdaArchitecture;
+    /**
+     * Recursively discover function files under the functions directory.
+     * Returns an array of { name, handlerFile } where name is the
+     * dash-delimited path (e.g. `order/create-order.ts` → `order-create-order`).
+     */
+    private discoverFunctionFiles;
+    /**
+     * Create a standalone Lambda function.
+     * Naming convention: {project}-{stage}-fn-{name}
+     *
+     * Well-Architected: Performance — memory/timeout from preset config
+     * Well-Architected: Sustainability — ARM64 Graviton by default
+     * Well-Architected: Operational Excellence — structured env vars, log retention from preset
+     * Well-Architected: Security — X-Ray tracing from preset config
+     */
+    private createStandaloneFunction;
+    /**
+     * Create a queue consumer Lambda function wired to an SQS queue.
+     * Naming convention: {project}-{stage}-queue-{name}
+     *
+     * Well-Architected: Reliability — DLQ on consumer queue, encrypted
+     * Well-Architected: Performance — batch size and visibility timeout
+     */
+    private createQueueConsumer;
+    /**
+     * Create a cron/scheduled task Lambda function wired to an EventBridge rule.
+     * Naming convention: {project}-{stage}-cron-{name}
+     *
+     * Well-Architected: Performance — memory/timeout from preset
+     * Well-Architected: Operational Excellence — log retention, tracing from preset
+     */
+    private createCronHandler;
 }
 //# sourceMappingURL=stack.d.ts.map

package/dist/cdk/stack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../src/cdk/stack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AAanC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAiB,MAAM,kBAAkB,CAAC;AAErE,MAAM,WAAW,iBAAkB,SAAQ,GAAG,CAAC,UAAU;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,YAAa,SAAQ,GAAG,CAAC,KAAK;IACzC,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,CAAM;gBAEhD,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB;IAkFlE,OAAO,CAAC,cAAc;IAuCtB,OAAO,CAAC,aAAa;IAwCrB,OAAO,CAAC,UAAU;IAiElB,OAAO,CAAC,WAAW;IAiCnB,OAAO,CAAC,WAAW;IA0CnB,OAAO,CAAC,kBAAkB;CAU3B"}
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../../src/cdk/stack.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AAuBnC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,KAAK,EACV,aAAa,EAKb,SAAS,EAMV,MAAM,kBAAkB,CAAC;AAK1B,MAAM,WAAW,iBAAkB,SAAQ,GAAG,CAAC,UAAU;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,aAAa,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,qBAAa,YAAa,SAAQ,GAAG,CAAC,KAAK;IACzC,SAAgB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,SAAS,CAAC,CAAM;IAE5D,qEAAqE;IACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuE;IACxG,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAE1C,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB;IA+RlE;;;;;;;;;;OAUG;IACH,OAAO,CAAC,cAAc;IAiEtB;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAsErB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAiFlB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IA4CnB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAyDnB,OAAO,CAAC,gBAAgB;IAgExB,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,YAAY;IA+EpB;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAgD3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAMvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA4B7B;;;;;;;;OAQG;IACH,OAAO,CAAC,wBAAwB;IA4DhC;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAkF3B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;CA0E1B"}