@ts-cloud/core 0.5.8 → 0.5.9

package/dist/index.js

@@ -45597,6 +45597,28 @@ function composeServerlessAppTemplate(opts) {
   addFunction("CliFunction", functionNames.cli, handlers.cli, "cli", app.cliMemory ?? 1024, app.cliTimeout ?? 900, undefined, app.cliTmpStorage ?? tmpStorage);
   if (hasQueue)
     addFunction("QueueFunction", functionNames.queue, handlers.queue, "queue", app.queueMemory ?? 1024, app.queueTimeout ?? 120, undefined, app.queueTmpStorage ?? tmpStorage);
+  const pc = (app.provisionedConcurrency ?? 0) > 0 ? app.provisionedConcurrency : 0;
+  const fnLogicalIds = ["HttpFunction", "CliFunction", ...hasQueue ? ["QueueFunction"] : []];
+  if (pc) {
+    for (const L of fnLogicalIds) {
+      resources[`${L}Version`] = {
+        Type: "AWS::Lambda::Version",
+        DeletionPolicy: "Retain",
+        Properties: { FunctionName: Fn2.ref(L) }
+      };
+      resources[`${L}Alias`] = {
+        Type: "AWS::Lambda::Alias",
+        Properties: {
+          FunctionName: Fn2.ref(L),
+          Name: "live",
+          FunctionVersion: Fn2.getAtt(`${L}Version`, "Version"),
+          ProvisionedConcurrencyConfig: { ProvisionedConcurrentExecutions: pc }
+        }
+      };
+    }
+  }
+  const invokeArn = (L) => pc ? Fn2.ref(`${L}Alias`) : Fn2.getAtt(L, "Arn");
+  const invokeName = (L) => pc ? Fn2.ref(`${L}Alias`) : Fn2.ref(L);
   resources.HttpApi = {
     Type: "AWS::ApiGatewayV2::Api",
     Properties: {
@@ -45609,7 +45631,7 @@ function composeServerlessAppTemplate(opts) {
     Properties: {
       ApiId: Fn2.ref("HttpApi"),
       IntegrationType: "AWS_PROXY",
-      IntegrationUri: Fn2.getAtt("HttpFunction", "Arn"),
+      IntegrationUri: invokeArn("HttpFunction"),
       PayloadFormatVersion: "2.0"
     }
   };
@@ -45632,7 +45654,7 @@ function composeServerlessAppTemplate(opts) {
   resources.HttpPermission = {
     Type: "AWS::Lambda::Permission",
     Properties: {
-      FunctionName: Fn2.ref("HttpFunction"),
+      FunctionName: invokeName("HttpFunction"),
       Action: "lambda:InvokeFunction",
       Principal: "apigateway.amazonaws.com",
       SourceArn: Fn2.sub("arn:aws:execute-api:${AWS::Region}:${AWS::AccountId}:${HttpApi}/*/*")
@@ -45723,7 +45745,7 @@ function composeServerlessAppTemplate(opts) {
         Type: "AWS::Lambda::EventSourceMapping",
         Properties: {
           EventSourceArn: Fn2.getAtt(qId, "Arn"),
-          FunctionName: Fn2.ref("QueueFunction"),
+          FunctionName: invokeName("QueueFunction"),
           BatchSize: 1,
           FunctionResponseTypes: ["ReportBatchItemFailures"],
           ...concurrency ? { ScalingConfig: { MaximumConcurrency: Math.max(2, concurrency) } } : {}
@@ -45741,7 +45763,7 @@ function composeServerlessAppTemplate(opts) {
         State: "ENABLED",
         Targets: [{
           Id: "cli",
-          Arn: Fn2.getAtt("CliFunction", "Arn"),
+          Arn: invokeArn("CliFunction"),
           Input: JSON.stringify({ command: "schedule:run" })
         }]
       }
@@ -45749,7 +45771,7 @@ function composeServerlessAppTemplate(opts) {
     resources.SchedulerPermission = {
       Type: "AWS::Lambda::Permission",
       Properties: {
-        FunctionName: Fn2.ref("CliFunction"),
+        FunctionName: invokeName("CliFunction"),
         Action: "lambda:InvokeFunction",
         Principal: "events.amazonaws.com",
         SourceArn: Fn2.getAtt("SchedulerRule", "Arn")

package/dist/types.d.ts

@@ -1585,9 +1585,10 @@ export interface ServerlessAppConfig {
      */
     gatewayVersion?: 1 | 2;
     /**
-     * Keep-warm count. Drives a scheduled EventBridge warmer rule that pings the
-     * HTTP function every few minutes (the runtime short-circuits warmer pings).
-     * 0/undefined disables warming.
+     * Cheap keep-warm count. Drives a scheduled EventBridge warmer rule that pings
+     * the function(s) every few minutes (the runtime short-circuits warmer pings).
+     * Reduces (does not eliminate) cold starts. For zero cold starts use
+     * {@link provisionedConcurrency}. 0/undefined disables ping-warming.
      */
     warm?: number;
     /**
@@ -1595,6 +1596,14 @@ export interface ServerlessAppConfig {
      * (queue/cli are async + latency-tolerant, so HTTP-only is the sensible default).
      */
     warmFunctions?: Array<'http' | 'queue' | 'cli'>;
+    /**
+     * Real provisioned concurrency (zero cold starts for N environments). Opts the
+     * app into the alias/version model: each function gets a `live` alias that
+     * traffic routes through, and every deploy publishes a version + flips the
+     * alias. Costs more than `warm` (you pay for the reserved capacity) but
+     * eliminates cold starts. 0/undefined keeps the default $LATEST model.
+     */
+    provisionedConcurrency?: number;
     /** CloudWatch log retention (days) for all function log groups. @default 14 */
     logRetention?: number;
     /** CLI function memory in MB. @default 1024 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ts-cloud/core",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "type": "module",
   "description": "Core CloudFormation generation library for ts-cloud",
   "author": "Chris Breuer <chris@stacksjs.com>",
@@ -31,7 +31,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@ts-cloud/aws-types": "0.5.8"
+    "@ts-cloud/aws-types": "0.5.9"
   },
   "devDependencies": {
     "typescript": "^5.9.3"