stacktape 3.5.7 → 3.6.0-beta.0

package/plain.d.ts

@@ -44,9 +44,9 @@ export type StacktapeResourceDefinition =
   | RemixWeb;
 export type HttpMethod = "*" | "DELETE" | "GET" | "HEAD" | "OPTIONS" | "PATCH" | "POST" | "PUT";
 export type ApplicationLoadBalancerAlarmTrigger =
+  | ApplicationLoadBalancerCustomTrigger
   | ApplicationLoadBalancerErrorRateTrigger
-  | ApplicationLoadBalancerUnhealthyTargetsTrigger
-  | ApplicationLoadBalancerCustomTrigger;
+  | ApplicationLoadBalancerUnhealthyTargetsTrigger;
 export type AlarmUserIntegration = MsTeamsIntegration | SlackIntegration | EmailIntegration;
 export type HttpApiGatewayAlarmTrigger = HttpApiGatewayErrorRateTrigger | HttpApiGatewayLatencyTrigger;
 /**
@@ -4406,58 +4406,6 @@ export interface ApplicationLoadBalancerAlarm {
    */
   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.
-   */
-  onlyIncludeTargets?: string[];
-  /**
-   * #### How to compare the metric value against the threshold.
-   */
-  comparisonOperator?:
-    | "GreaterThanOrEqualToThreshold"
-    | "GreaterThanThreshold"
-    | "LessThanOrEqualToThreshold"
-    | "LessThanThreshold";
-}
 export interface ApplicationLoadBalancerCustomTrigger {
   type: "application-load-balancer-custom";
   properties: ApplicationLoadBalancerCustomTriggerProps;
@@ -4601,6 +4549,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.
  *
@@ -5802,6 +5802,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).
    */
@@ -10500,6 +10509,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 +10610,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).
  *
@@ -11811,6 +11916,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 +12026,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 +12109,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 +12219,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 +12302,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 +12391,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 +12470,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 +12559,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 +12638,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 +12727,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 +12806,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 +12895,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;