@ts-cloud/core 0.5.7 → 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")
@@ -45758,34 +45780,39 @@ function composeServerlessAppTemplate(opts) {
   }
   if (app.warm && app.warm > 0) {
     const TARGETS_PER_RULE = 5;
-    const ruleCount = Math.ceil(app.warm / TARGETS_PER_RULE);
-    let warmed = 0;
-    for (let r = 0;r < ruleCount; r++) {
-      const targets = Math.min(TARGETS_PER_RULE, app.warm - warmed);
-      resources[`WarmerRule${r}`] = {
-        Type: "AWS::Events::Rule",
+    const fnResource = { http: "HttpFunction", queue: "QueueFunction", cli: "CliFunction" };
+    const warmModes = (app.warmFunctions ?? ["http"]).filter((m) => m !== "queue" || hasQueue);
+    for (const mode of warmModes) {
+      const cap = mode.charAt(0).toUpperCase() + mode.slice(1);
+      const ruleCount = Math.ceil(app.warm / TARGETS_PER_RULE);
+      let warmed = 0;
+      for (let r = 0;r < ruleCount; r++) {
+        const targets = Math.min(TARGETS_PER_RULE, app.warm - warmed);
+        resources[`Warmer${cap}Rule${r}`] = {
+          Type: "AWS::Events::Rule",
+          Properties: {
+            Name: `${slug}-${environment}-warmer-${mode}-${r}`,
+            ScheduleExpression: "rate(5 minutes)",
+            State: "ENABLED",
+            Targets: Array.from({ length: targets }, (_, i) => ({
+              Id: `warm-${mode}-${r}-${i}`,
+              Arn: Fn2.getAtt(fnResource[mode], "Arn"),
+              Input: JSON.stringify({ warmer: true })
+            }))
+          }
+        };
+        warmed += targets;
+      }
+      resources[`Warmer${cap}Permission`] = {
+        Type: "AWS::Lambda::Permission",
         Properties: {
-          Name: `${slug}-${environment}-warmer-${r}`,
-          ScheduleExpression: "rate(5 minutes)",
-          State: "ENABLED",
-          Targets: Array.from({ length: targets }, (_, i) => ({
-            Id: `warm-${r}-${i}`,
-            Arn: Fn2.getAtt("HttpFunction", "Arn"),
-            Input: JSON.stringify({ warmer: true })
-          }))
+          FunctionName: Fn2.ref(fnResource[mode]),
+          Action: "lambda:InvokeFunction",
+          Principal: "events.amazonaws.com",
+          SourceArn: Fn2.sub("arn:aws:events:${AWS::Region}:${AWS::AccountId}:rule/" + `${slug}-${environment}-warmer-${mode}-*`)
         }
       };
-      warmed += targets;
     }
-    resources.WarmerPermission = {
-      Type: "AWS::Lambda::Permission",
-      Properties: {
-        FunctionName: Fn2.ref("HttpFunction"),
-        Action: "lambda:InvokeFunction",
-        Principal: "events.amazonaws.com",
-        SourceArn: Fn2.sub("arn:aws:events:${AWS::Region}:${AWS::AccountId}:rule/" + `${slug}-${environment}-warmer-*`)
-      }
-    };
   }
   if (cacheEnabled) {
     resources.CacheTable = {
@@ -46407,6 +46434,8 @@ function parseRecordBody(body) {
 function createQueueHandler(handler8) {
   return async (event) => {
     const batchItemFailures = [];
+    if (event.warmer)
+      return { batchItemFailures };
     if (!handler8)
       return { batchItemFailures };
     for (const record of event.Records ?? []) {
@@ -46421,6 +46450,8 @@ function createQueueHandler(handler8) {
 }
 function createCliHandler(handler8) {
   return async (event) => {
+    if (event.warmer)
+      return { statusCode: 0, output: "warm" };
     if (!handler8)
       return { statusCode: 501, output: "No CLI handler configured" };
     return handler8(event);

package/dist/runtime/adapter.ts

@@ -245,6 +245,9 @@ function parseRecordBody(body: string): unknown {
 export function createQueueHandler(handler: JobHandler | undefined): LambdaQueueHandler {
   return async (event: SqsEvent): Promise<SqsBatchResponse> => {
     const batchItemFailures: Array<{ itemIdentifier: string }> = []
+    // Warmer pings invoke the function directly (no SQS Records) — keep the
+    // container warm without treating the ping as a job.
+    if ((event as unknown as { warmer?: boolean }).warmer) return { batchItemFailures }
     if (!handler) return { batchItemFailures }
 
     for (const record of event.Records ?? []) {
@@ -268,6 +271,8 @@ export function createQueueHandler(handler: JobHandler | undefined): LambdaQueue
  */
 export function createCliHandler(handler: CommandHandler | undefined): LambdaCliHandler {
   return async (event: CliEvent): Promise<CliResult> => {
+    // Warmer pings keep the container warm without running a command.
+    if ((event as unknown as { warmer?: boolean }).warmer) return { statusCode: 0, output: 'warm' }
     if (!handler) return { statusCode: 501, output: 'No CLI handler configured' }
     return handler(event)
   }

package/dist/runtime-assets/cli-runtime.php

@@ -36,6 +36,11 @@ while (true) {
 
 function dispatch(array $event, string $artisan, string $queueCommand): array
 {
+    // Warmer pings keep the container warm without running anything.
+    if (($event['warmer'] ?? false) === true) {
+        return ['warm' => true];
+    }
+
     // SQS queue event.
     if (isset($event['Records']) && is_array($event['Records'])) {
         $failures = [];

package/dist/types.d.ts

@@ -1585,11 +1585,25 @@ 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;
+    /**
+     * Which functions the warmer keeps warm. @default ['http']
+     * (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.7",
+  "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.7"
+    "@ts-cloud/aws-types": "0.5.9"
   },
   "devDependencies": {
     "typescript": "^5.9.3"