stacktape 3.5.8 → 3.6.0

package/plain.d.ts

@@ -44,10 +44,15 @@ export type StacktapeResourceDefinition =
   | RemixWeb;
 export type HttpMethod = "*" | "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
 export type ApplicationLoadBalancerAlarmTrigger =
+  | ApplicationLoadBalancerCustomTrigger
   | ApplicationLoadBalancerErrorRateTrigger
-  | ApplicationLoadBalancerUnhealthyTargetsTrigger
-  | ApplicationLoadBalancerCustomTrigger;
-export type AlarmUserIntegration = MsTeamsIntegration | SlackIntegration | EmailIntegration;
+  | ApplicationLoadBalancerUnhealthyTargetsTrigger;
+export type AlarmUserIntegration =
+  | MsTeamsIntegration
+  | SlackIntegration
+  | EmailIntegration
+  | DiscordIntegration
+  | WebhookIntegration;
 export type HttpApiGatewayAlarmTrigger = HttpApiGatewayErrorRateTrigger | HttpApiGatewayLatencyTrigger;
 /**
  * #### How traffic reaches this service from other resources.
@@ -180,7 +185,6 @@ export interface StacktapeConfig {
    * ```
    */
   variables?: any;
-  budgetControl?: BudgetControl;
   hooks?: Hooks;
   /**
    * #### Custom shell commands or code you can run manually or as lifecycle hooks.
@@ -310,61 +314,6 @@ export interface UpstashProvider {
    */
   apiKey: string;
 }
-/**
- * #### Set a monthly spending limit and get email alerts when costs approach it.
- *
- * ---
- *
- * The budget resets at the start of each calendar month. You can configure alerts
- * based on actual spend or AWS-forecasted spend.
- *
- * > Not available in all regions (e.g., `ap-east-1`, `af-south-1`).
- */
-export interface BudgetControl {
-  /**
-   * #### Monthly spending limit in USD.
-   *
-   * ---
-   *
-   * Notification thresholds are calculated as a percentage of this amount.
-   * Resets at the start of each calendar month.
-   */
-  limit: number;
-  /**
-   * #### Email alerts when spending approaches the limit.
-   *
-   * ---
-   *
-   * Each notification fires at a percentage threshold of the `limit`, based on
-   * actual or forecasted spend. Max 5 notifications.
-   */
-  notifications?: BudgetNotification[];
-}
-export interface BudgetNotification {
-  /**
-   * #### Whether to alert on actual or forecasted spend.
-   *
-   * ---
-   *
-   * - `ACTUAL` — fires when you've already spent past the threshold.
-   * - `FORECASTED` — fires when AWS predicts you'll exceed the threshold by month-end.
-   *
-   * Forecasts need ~5 weeks of usage data before they work.
-   */
-  budgetType?: "ACTUAL" | "FORECASTED";
-  /**
-   * #### Percentage of the budget limit that triggers this alert.
-   *
-   * ---
-   *
-   * Example: limit = $200, threshold = 80 → alert fires at $160.
-   */
-  thresholdPercentage?: number;
-  /**
-   * #### Email addresses that receive the alert. Max 10.
-   */
-  emails: string[];
-}
 /**
  * #### Run scripts automatically before/after deploy, delete, or dev commands.
  *
@@ -4402,61 +4351,13 @@ export interface ApplicationLoadBalancerAlarm {
    */
   notificationTargets?: AlarmUserIntegration[];
   /**
-   * #### Custom alarm description used in notification messages and the AWS console.
-   */
-  description?: string;
-}
-export interface ApplicationLoadBalancerErrorRateTrigger {
-  type: "application-load-balancer-error-rate";
-  properties: ApplicationLoadBalancerErrorRateTriggerProps;
-}
-export interface ApplicationLoadBalancerErrorRateTriggerProps {
-  /**
-   * #### Fires when 4xx/5xx error rate exceeds this percentage.
-   *
-   * ---
-   *
-   * Example: `5` fires the alarm if more than 5% of requests return errors.
-   */
-  thresholdPercent: number;
-  /**
-   * #### How to compare the metric value against the threshold.
-   */
-  comparisonOperator?:
-    | "GreaterThanOrEqualToThreshold"
-    | "GreaterThanThreshold"
-    | "LessThanOrEqualToThreshold"
-    | "LessThanThreshold";
-}
-export interface ApplicationLoadBalancerUnhealthyTargetsTrigger {
-  type: "application-load-balancer-unhealthy-targets";
-  properties: ApplicationLoadBalancerUnhealthyTargetsTriggerProps;
-}
-export interface ApplicationLoadBalancerUnhealthyTargetsTriggerProps {
-  /**
-   * #### Fires when the percentage of unhealthy targets exceeds this value.
-   *
-   * ---
-   *
-   * If the load balancer has multiple target groups, the alarm fires if *any* group breaches the threshold.
-   */
-  thresholdPercent: number;
-  /**
-   * #### Only monitor health of these target container services. If omitted, monitors all targets.
-   *
-   * ---
-   *
-   * Only services actually targeted by the load balancer can be listed.
+   * #### Whether alarm state changes should appear in monitoring history.
    */
-  onlyIncludeTargets?: string[];
+  includeInHistory?: boolean;
   /**
-   * #### How to compare the metric value against the threshold.
+   * #### Custom alarm description used in notification messages and the AWS console.
    */
-  comparisonOperator?:
-    | "GreaterThanOrEqualToThreshold"
-    | "GreaterThanThreshold"
-    | "LessThanOrEqualToThreshold"
-    | "LessThanThreshold";
+  description?: string;
 }
 export interface ApplicationLoadBalancerCustomTrigger {
   type: "application-load-balancer-custom";
@@ -4601,6 +4502,58 @@ export interface ApplicationLoadBalancerCustomTriggerProps {
     | "LessThanOrEqualToThreshold"
     | "LessThanThreshold";
 }
+export interface ApplicationLoadBalancerErrorRateTrigger {
+  type: "application-load-balancer-error-rate";
+  properties: ApplicationLoadBalancerErrorRateTriggerProps;
+}
+export interface ApplicationLoadBalancerErrorRateTriggerProps {
+  /**
+   * #### Fires when 4xx/5xx error rate exceeds this percentage.
+   *
+   * ---
+   *
+   * Example: `5` fires the alarm if more than 5% of requests return errors.
+   */
+  thresholdPercent: number;
+  /**
+   * #### How to compare the metric value against the threshold.
+   */
+  comparisonOperator?:
+    | "GreaterThanOrEqualToThreshold"
+    | "GreaterThanThreshold"
+    | "LessThanOrEqualToThreshold"
+    | "LessThanThreshold";
+}
+export interface ApplicationLoadBalancerUnhealthyTargetsTrigger {
+  type: "application-load-balancer-unhealthy-targets";
+  properties: ApplicationLoadBalancerUnhealthyTargetsTriggerProps;
+}
+export interface ApplicationLoadBalancerUnhealthyTargetsTriggerProps {
+  /**
+   * #### Fires when the percentage of unhealthy targets exceeds this value.
+   *
+   * ---
+   *
+   * If the load balancer has multiple target groups, the alarm fires if *any* group breaches the threshold.
+   */
+  thresholdPercent: number;
+  /**
+   * #### Only monitor health of these target container services. If omitted, monitors all targets.
+   *
+   * ---
+   *
+   * Only services actually targeted by the load balancer can be listed.
+   */
+  onlyIncludeTargets?: string[];
+  /**
+   * #### How to compare the metric value against the threshold.
+   */
+  comparisonOperator?:
+    | "GreaterThanOrEqualToThreshold"
+    | "GreaterThanThreshold"
+    | "LessThanOrEqualToThreshold"
+    | "LessThanThreshold";
+}
 /**
  * #### How long and how often to evaluate the metric before triggering.
  *
@@ -4682,6 +4635,43 @@ export interface EmailIntegrationProps {
    */
   recipient: string;
 }
+export interface DiscordIntegration {
+  type: "discord";
+  properties?: DiscordIntegrationProps;
+}
+export interface DiscordIntegrationProps {
+  /**
+   * #### Discord Webhook URL for the channel. Store as `$Secret()` for security.
+   *
+   * ---
+   *
+   * Create a webhook in your Discord channel settings (Edit Channel → Integrations → Webhooks).
+   */
+  webhookUrl: string;
+}
+export interface WebhookIntegration {
+  type: "webhook";
+  properties?: WebhookIntegrationProps;
+}
+export interface WebhookIntegrationProps {
+  /**
+   * #### The URL to send webhook POST requests to.
+   */
+  url: string;
+  /**
+   * #### Optional signing secret for HMAC-SHA256 payload verification.
+   *
+   * ---
+   *
+   * If provided, each request includes an `X-Stacktape-Signature` header.
+   */
+  secret?: string;
+  headers?: RecordStringString;
+}
+/**
+ * #### Optional custom headers to include in each request.
+ */
+export interface RecordStringString {}
 export interface HttpApiGatewayAlarm {
   trigger: HttpApiGatewayAlarmTrigger;
   evaluation?: AlarmEvaluation1;
@@ -4689,6 +4679,10 @@ export interface HttpApiGatewayAlarm {
    * #### Where to send notifications when the alarm fires — Slack, MS Teams, or email.
    */
   notificationTargets?: AlarmUserIntegration[];
+  /**
+   * #### Whether alarm state changes should appear in monitoring history.
+   */
+  includeInHistory?: boolean;
   /**
    * #### Custom alarm description used in notification messages and the AWS console.
    */
@@ -5802,6 +5796,15 @@ export interface AuroraServerlessV2EngineProperties {
    * #### Maximum ACUs (0.5-128 in 0.5 increments). Caps your scaling and cost.
    */
   maxCapacity?: number;
+  /**
+   * #### Number of reader instances in the Aurora Serverless v2 cluster.
+   *
+   * ---
+   *
+   * Aurora Serverless v2 always has one writer instance. This value adds additional readers
+   * (`0` means writer only, `2` means writer + 2 readers).
+   */
+  serverlessReadersCount?: number;
   /**
    * #### Engine version (e.g., `16.6` for PostgreSQL, `8.0.36` for MySQL).
    */
@@ -5976,6 +5979,10 @@ export interface RelationalDatabaseAlarm {
    * #### Where to send notifications when the alarm fires — Slack, MS Teams, or email.
    */
   notificationTargets?: AlarmUserIntegration[];
+  /**
+   * #### Whether alarm state changes should appear in monitoring history.
+   */
+  includeInHistory?: boolean;
   /**
    * #### Custom alarm description used in notification messages and the AWS console.
    */
@@ -9687,6 +9694,10 @@ export interface SqsQueueAlarm {
    * #### Where to send notifications when the alarm fires — Slack, MS Teams, or email.
    */
   notificationTargets?: AlarmUserIntegration[];
+  /**
+   * #### Whether alarm state changes should appear in monitoring history.
+   */
+  includeInHistory?: boolean;
   /**
    * #### Custom alarm description used in notification messages and the AWS console.
    */
@@ -10500,6 +10511,7 @@ export interface NextjsWebProps {
    * Not compatible with `useEdgeLambda: true`.
    */
   streamingEnabled?: boolean;
+  cdn?: SsrWebCdnConfig;
   /**
    * #### Give this resource access to other resources in your stack.
    *
@@ -10600,6 +10612,101 @@ export interface LambdaFunctionLogging {
    */
   logForwarding?: HttpEndpointLogForwarding | HighlightLogForwarding | DatadogLogForwarding;
 }
+/**
+ * #### CDN cache controls for SSR routes and specific path patterns.
+ */
+export interface SsrWebCdnConfig {
+  /**
+   * #### Skip clearing the CDN cache after each deploy.
+   *
+   * ---
+   *
+   * By default, all cached content is flushed on every deploy so users see the latest version.
+   * Set to `true` if you manage cache invalidation yourself or want to keep cached content between deploys.
+   */
+  disableInvalidationAfterDeploy?: boolean;
+  defaultCachingOptions?: CdnCachingOptions4;
+  /**
+   * #### Override caching for specific CDN path patterns.
+   *
+   * ---
+   *
+   * Matches existing framework-managed paths (e.g. `_astro/*`, `_next/data/*`) or adds
+   * new server-path caching rules (e.g. `/_server-islands/*`) while preserving managed routing.
+   */
+  pathCachingOverrides?: SsrWebPathCachingOverride[];
+}
+/**
+ * #### Override default SSR caching behavior for all routes handled by the server.
+ *
+ * ---
+ *
+ * Useful when you want to cache SSR responses longer than the framework defaults.
+ */
+export interface CdnCachingOptions4 {
+  /**
+   * #### HTTP methods to cache. Use `['GET', 'HEAD', 'OPTIONS']` if your API uses CORS preflight.
+   */
+  cacheMethods?: ("GET" | "HEAD" | "OPTIONS")[];
+  /**
+   * #### Minimum cache time (seconds). Overrides `Cache-Control: max-age` if the origin sets a lower value.
+   */
+  minTTL?: number;
+  /**
+   * #### Maximum cache time (seconds). Caps how long the CDN caches content, even if the origin says longer.
+   */
+  maxTTL?: number;
+  /**
+   * #### Default cache time (seconds). Used when the origin response has no `Cache-Control` or `Expires` header.
+   */
+  defaultTTL?: number;
+  /**
+   * #### Disable automatic Gzip/Brotli compression. Compression is on by default and reduces transfer size/cost.
+   */
+  disableCompression?: boolean;
+  cacheKeyParameters?: CdnCacheKey;
+  /**
+   * #### Use a pre-existing AWS cache policy ID instead of configuring TTL and cache key options here.
+   */
+  cachePolicyId?: string;
+}
+export interface SsrWebPathCachingOverride {
+  /**
+   * #### URL path pattern to match (e.g., `/api/*`, `/_server-islands/*`).
+   */
+  path: string;
+  cachingOptions: CdnCachingOptions5;
+}
+/**
+ * #### Caching behavior override for this path pattern.
+ */
+export interface CdnCachingOptions5 {
+  /**
+   * #### HTTP methods to cache. Use `['GET', 'HEAD', 'OPTIONS']` if your API uses CORS preflight.
+   */
+  cacheMethods?: ("GET" | "HEAD" | "OPTIONS")[];
+  /**
+   * #### Minimum cache time (seconds). Overrides `Cache-Control: max-age` if the origin sets a lower value.
+   */
+  minTTL?: number;
+  /**
+   * #### Maximum cache time (seconds). Caps how long the CDN caches content, even if the origin says longer.
+   */
+  maxTTL?: number;
+  /**
+   * #### Default cache time (seconds). Used when the origin response has no `Cache-Control` or `Expires` header.
+   */
+  defaultTTL?: number;
+  /**
+   * #### Disable automatic Gzip/Brotli compression. Compression is on by default and reduces transfer size/cost.
+   */
+  disableCompression?: boolean;
+  cacheKeyParameters?: CdnCacheKey;
+  /**
+   * #### Use a pre-existing AWS cache policy ID instead of configuring TTL and cache key options here.
+   */
+  cachePolicyId?: string;
+}
 /**
  * #### Managed search and analytics engine (OpenSearch/Elasticsearch compatible).
  *
@@ -11411,6 +11518,10 @@ export interface LambdaAlarm {
    * #### Where to send notifications when the alarm fires — Slack, MS Teams, or email.
    */
   notificationTargets?: AlarmUserIntegration[];
+  /**
+   * #### Whether alarm state changes should appear in monitoring history.
+   */
+  includeInHistory?: boolean;
   /**
    * #### Custom alarm description used in notification messages and the AWS console.
    */
@@ -11811,6 +11922,7 @@ export interface AstroWebProps {
    * #### Set custom headers (e.g., `Cache-Control`) for static files matching a pattern.
    */
   fileOptions?: DirectoryUploadFilter[];
+  cdn?: SsrWebCdnConfig1;
   /**
    * #### Give this resource access to other resources in your stack.
    *
@@ -11920,6 +12032,30 @@ export interface AstroWebDevConfig {
    */
   workingDirectory?: string;
 }
+/**
+ * #### CDN cache controls for SSR routes and specific path patterns.
+ */
+export interface SsrWebCdnConfig1 {
+  /**
+   * #### Skip clearing the CDN cache after each deploy.
+   *
+   * ---
+   *
+   * By default, all cached content is flushed on every deploy so users see the latest version.
+   * Set to `true` if you manage cache invalidation yourself or want to keep cached content between deploys.
+   */
+  disableInvalidationAfterDeploy?: boolean;
+  defaultCachingOptions?: CdnCachingOptions4;
+  /**
+   * #### Override caching for specific CDN path patterns.
+   *
+   * ---
+   *
+   * Matches existing framework-managed paths (e.g. `_astro/*`, `_next/data/*`) or adds
+   * new server-path caching rules (e.g. `/_server-islands/*`) while preserving managed routing.
+   */
+  pathCachingOverrides?: SsrWebPathCachingOverride[];
+}
 /**
  * #### Deploy a Nuxt SSR app with Lambda (Nitro aws-lambda preset), S3 for static assets, and CloudFront CDN.
  *
@@ -11979,6 +12115,7 @@ export interface NuxtWebProps {
    * #### Set custom headers (e.g., `Cache-Control`) for static files matching a pattern.
    */
   fileOptions?: DirectoryUploadFilter[];
+  cdn?: SsrWebCdnConfig2;
   /**
    * #### Give this resource access to other resources in your stack.
    *
@@ -12088,6 +12225,30 @@ export interface SsrWebDevConfig {
    */
   workingDirectory?: string;
 }
+/**
+ * #### CDN cache controls for SSR routes and specific path patterns.
+ */
+export interface SsrWebCdnConfig2 {
+  /**
+   * #### Skip clearing the CDN cache after each deploy.
+   *
+   * ---
+   *
+   * By default, all cached content is flushed on every deploy so users see the latest version.
+   * Set to `true` if you manage cache invalidation yourself or want to keep cached content between deploys.
+   */
+  disableInvalidationAfterDeploy?: boolean;
+  defaultCachingOptions?: CdnCachingOptions4;
+  /**
+   * #### Override caching for specific CDN path patterns.
+   *
+   * ---
+   *
+   * Matches existing framework-managed paths (e.g. `_astro/*`, `_next/data/*`) or adds
+   * new server-path caching rules (e.g. `/_server-islands/*`) while preserving managed routing.
+   */
+  pathCachingOverrides?: SsrWebPathCachingOverride[];
+}
 /**
  * #### Deploy a SvelteKit SSR app with Lambda (AWS adapter), S3 for static assets, and CloudFront CDN.
  *
@@ -12147,6 +12308,7 @@ export interface SvelteKitWebProps {
    * #### Set custom headers (e.g., `Cache-Control`) for static files matching a pattern.
    */
   fileOptions?: DirectoryUploadFilter[];
+  cdn?: SsrWebCdnConfig3;
   /**
    * #### Give this resource access to other resources in your stack.
    *
@@ -12235,6 +12397,30 @@ export interface SsrWebDevConfig1 {
    */
   workingDirectory?: string;
 }
+/**
+ * #### CDN cache controls for SSR routes and specific path patterns.
+ */
+export interface SsrWebCdnConfig3 {
+  /**
+   * #### Skip clearing the CDN cache after each deploy.
+   *
+   * ---
+   *
+   * By default, all cached content is flushed on every deploy so users see the latest version.
+   * Set to `true` if you manage cache invalidation yourself or want to keep cached content between deploys.
+   */
+  disableInvalidationAfterDeploy?: boolean;
+  defaultCachingOptions?: CdnCachingOptions4;
+  /**
+   * #### Override caching for specific CDN path patterns.
+   *
+   * ---
+   *
+   * Matches existing framework-managed paths (e.g. `_astro/*`, `_next/data/*`) or adds
+   * new server-path caching rules (e.g. `/_server-islands/*`) while preserving managed routing.
+   */
+  pathCachingOverrides?: SsrWebPathCachingOverride[];
+}
 /**
  * #### Deploy a SolidStart SSR app with Lambda (AWS adapter), S3 for static assets, and CloudFront CDN.
  */
@@ -12290,6 +12476,7 @@ export interface SolidStartWebProps {
    * #### Set custom headers (e.g., `Cache-Control`) for static files matching a pattern.
    */
   fileOptions?: DirectoryUploadFilter[];
+  cdn?: SsrWebCdnConfig4;
   /**
    * #### Give this resource access to other resources in your stack.
    *
@@ -12378,6 +12565,30 @@ export interface SsrWebDevConfig2 {
    */
   workingDirectory?: string;
 }
+/**
+ * #### CDN cache controls for SSR routes and specific path patterns.
+ */
+export interface SsrWebCdnConfig4 {
+  /**
+   * #### Skip clearing the CDN cache after each deploy.
+   *
+   * ---
+   *
+   * By default, all cached content is flushed on every deploy so users see the latest version.
+   * Set to `true` if you manage cache invalidation yourself or want to keep cached content between deploys.
+   */
+  disableInvalidationAfterDeploy?: boolean;
+  defaultCachingOptions?: CdnCachingOptions4;
+  /**
+   * #### Override caching for specific CDN path patterns.
+   *
+   * ---
+   *
+   * Matches existing framework-managed paths (e.g. `_astro/*`, `_next/data/*`) or adds
+   * new server-path caching rules (e.g. `/_server-islands/*`) while preserving managed routing.
+   */
+  pathCachingOverrides?: SsrWebPathCachingOverride[];
+}
 /**
  * #### Deploy a TanStack Start SSR app with Lambda (Nitro aws-lambda preset), S3 for static assets, and CloudFront CDN.
  */
@@ -12433,6 +12644,7 @@ export interface TanStackWebProps {
    * #### Set custom headers (e.g., `Cache-Control`) for static files matching a pattern.
    */
   fileOptions?: DirectoryUploadFilter[];
+  cdn?: SsrWebCdnConfig5;
   /**
    * #### Give this resource access to other resources in your stack.
    *
@@ -12521,6 +12733,30 @@ export interface SsrWebDevConfig3 {
    */
   workingDirectory?: string;
 }
+/**
+ * #### CDN cache controls for SSR routes and specific path patterns.
+ */
+export interface SsrWebCdnConfig5 {
+  /**
+   * #### Skip clearing the CDN cache after each deploy.
+   *
+   * ---
+   *
+   * By default, all cached content is flushed on every deploy so users see the latest version.
+   * Set to `true` if you manage cache invalidation yourself or want to keep cached content between deploys.
+   */
+  disableInvalidationAfterDeploy?: boolean;
+  defaultCachingOptions?: CdnCachingOptions4;
+  /**
+   * #### Override caching for specific CDN path patterns.
+   *
+   * ---
+   *
+   * Matches existing framework-managed paths (e.g. `_astro/*`, `_next/data/*`) or adds
+   * new server-path caching rules (e.g. `/_server-islands/*`) while preserving managed routing.
+   */
+  pathCachingOverrides?: SsrWebPathCachingOverride[];
+}
 /**
  * #### Deploy a Remix SSR app with Lambda for server rendering, S3 for static assets, and CloudFront CDN.
  */
@@ -12576,6 +12812,7 @@ export interface RemixWebProps {
    * #### Set custom headers (e.g., `Cache-Control`) for static files matching a pattern.
    */
   fileOptions?: DirectoryUploadFilter[];
+  cdn?: SsrWebCdnConfig6;
   /**
    * #### Give this resource access to other resources in your stack.
    *
@@ -12664,6 +12901,30 @@ export interface SsrWebDevConfig4 {
    */
   workingDirectory?: string;
 }
+/**
+ * #### CDN cache controls for SSR routes and specific path patterns.
+ */
+export interface SsrWebCdnConfig6 {
+  /**
+   * #### Skip clearing the CDN cache after each deploy.
+   *
+   * ---
+   *
+   * By default, all cached content is flushed on every deploy so users see the latest version.
+   * Set to `true` if you manage cache invalidation yourself or want to keep cached content between deploys.
+   */
+  disableInvalidationAfterDeploy?: boolean;
+  defaultCachingOptions?: CdnCachingOptions4;
+  /**
+   * #### Override caching for specific CDN path patterns.
+   *
+   * ---
+   *
+   * Matches existing framework-managed paths (e.g. `_astro/*`, `_next/data/*`) or adds
+   * new server-path caching rules (e.g. `/_server-islands/*`) while preserving managed routing.
+   */
+  pathCachingOverrides?: SsrWebPathCachingOverride[];
+}
 export interface Default {
   Type: string;
   DependsOn?: string[] | IntrinsicFunction | string;