cdk-nextjs 0.5.13 → 0.5.15

package/.jsii

@@ -11348,7 +11348,7 @@
         },
         "locationInModule": {
           "filename": "src/root-constructs/nextjs-global-containers.ts",
-          "line": 86
+          "line": 89
         },
         "parameters": [
           {
@@ -11374,7 +11374,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-containers.ts",
-        "line": 76
+        "line": 79
       },
       "name": "NextjsGlobalContainers",
       "properties": [
@@ -11385,7 +11385,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 80
+            "line": 83
           },
           "name": "url",
           "overrides": "cdk-nextjs.NextjsBaseConstruct",
@@ -11399,7 +11399,7 @@
           },
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 77
+            "line": 80
           },
           "name": "nextjsContainers",
           "type": {
@@ -11412,7 +11412,7 @@
           },
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 78
+            "line": 81
           },
           "name": "nextjsDistribution",
           "type": {
@@ -11425,7 +11425,7 @@
           },
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 79
+            "line": 82
           },
           "name": "nextjsPostDeploy",
           "type": {
@@ -11448,7 +11448,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-containers.ts",
-        "line": 28
+        "line": 31
       },
       "name": "NextjsGlobalContainersConstructOverrides",
       "properties": [
@@ -11460,7 +11460,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 29
+            "line": 32
           },
           "name": "nextjsContainersProps",
           "optional": true,
@@ -11476,7 +11476,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 30
+            "line": 33
           },
           "name": "nextjsDistributionProps",
           "optional": true,
@@ -11492,7 +11492,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 31
+            "line": 34
           },
           "name": "nextjsPostDeployProps",
           "optional": true,
@@ -11518,7 +11518,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-containers.ts",
-        "line": 39
+        "line": 42
       },
       "name": "NextjsGlobalContainersOverrides",
       "properties": [
@@ -11530,7 +11530,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 41
+            "line": 44
           },
           "name": "nextjsContainers",
           "optional": true,
@@ -11546,7 +11546,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 42
+            "line": 45
           },
           "name": "nextjsDistribution",
           "optional": true,
@@ -11562,7 +11562,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 40
+            "line": 43
           },
           "name": "nextjsGlobalContainers",
           "optional": true,
@@ -11578,7 +11578,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 43
+            "line": 46
           },
           "name": "nextjsPostDeploy",
           "optional": true,
@@ -11602,7 +11602,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-containers.ts",
-        "line": 46
+        "line": 49
       },
       "name": "NextjsGlobalContainersProps",
       "properties": [
@@ -11616,7 +11616,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 53
+            "line": 56
           },
           "name": "alb",
           "optional": true,
@@ -11634,7 +11634,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 58
+            "line": 61
           },
           "name": "distribution",
           "optional": true,
@@ -11652,7 +11652,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 63
+            "line": 66
           },
           "name": "ecsCluster",
           "optional": true,
@@ -11669,7 +11669,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-containers.ts",
-            "line": 67
+            "line": 70
           },
           "name": "overrides",
           "optional": true,
@@ -11694,7 +11694,7 @@
         },
         "locationInModule": {
           "filename": "src/root-constructs/nextjs-global-functions.ts",
-          "line": 72
+          "line": 75
         },
         "parameters": [
           {
@@ -11720,7 +11720,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-functions.ts",
-        "line": 62
+        "line": 65
       },
       "name": "NextjsGlobalFunctions",
       "properties": [
@@ -11731,7 +11731,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 66
+            "line": 69
           },
           "name": "url",
           "overrides": "cdk-nextjs.NextjsBaseConstruct",
@@ -11745,7 +11745,7 @@
           },
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 64
+            "line": 67
           },
           "name": "nextjsDistribution",
           "type": {
@@ -11758,7 +11758,7 @@
           },
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 63
+            "line": 66
           },
           "name": "nextjsFunctions",
           "type": {
@@ -11771,7 +11771,7 @@
           },
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 65
+            "line": 68
           },
           "name": "nextjsPostDeploy",
           "type": {
@@ -11794,7 +11794,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-functions.ts",
-        "line": 26
+        "line": 29
       },
       "name": "NextjsGlobalFunctionsConstructOverrides",
       "properties": [
@@ -11806,7 +11806,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 28
+            "line": 31
           },
           "name": "nextjsDistributionProps",
           "optional": true,
@@ -11822,7 +11822,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 27
+            "line": 30
           },
           "name": "nextjsFunctionsProps",
           "optional": true,
@@ -11838,7 +11838,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 29
+            "line": 32
           },
           "name": "nextjsPostDeployProps",
           "optional": true,
@@ -11864,7 +11864,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-functions.ts",
-        "line": 37
+        "line": 40
       },
       "name": "NextjsGlobalFunctionsOverrides",
       "properties": [
@@ -11876,7 +11876,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 40
+            "line": 43
           },
           "name": "nextjsDistribution",
           "optional": true,
@@ -11892,7 +11892,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 39
+            "line": 42
           },
           "name": "nextjsFunctions",
           "optional": true,
@@ -11908,7 +11908,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 38
+            "line": 41
           },
           "name": "nextjsGlobalFunctions",
           "optional": true,
@@ -11924,7 +11924,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 41
+            "line": 44
           },
           "name": "nextjsPostDeploy",
           "optional": true,
@@ -11948,7 +11948,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/root-constructs/nextjs-global-functions.ts",
-        "line": 44
+        "line": 47
       },
       "name": "NextjsGlobalFunctionsProps",
       "properties": [
@@ -11962,7 +11962,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 49
+            "line": 52
           },
           "name": "distribution",
           "optional": true,
@@ -11979,7 +11979,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/root-constructs/nextjs-global-functions.ts",
-            "line": 53
+            "line": 56
           },
           "name": "overrides",
           "optional": true,
@@ -19554,6 +19554,6 @@
       "symbolId": "src/nextjs-build/nextjs-build:PublicDirEntry"
     }
   },
-  "version": "0.5.13",
-  "fingerprint": "rinKD9C/3UO0mHPW5KEaJYVnLIlloOJzwqXaLyt+aA0="
+  "version": "0.5.15",
+  "fingerprint": "DMoS9TQb/ztX0/p0bSS/Ug+kTveffvmQcgdonowYG90="
 }

package/docs/caching-guide.md

@@ -409,6 +409,7 @@ When `revalidateTag("user-profile")` is called:
 1. **Query DynamoDB**: Find all cache keys tagged with `pk = {buildId} and sk starts_with user-profile`
 2. **Update Timestamps**: Mark revalidation time in DynamoDB for each cache entry
 3. **Delete S3 Objects**: Remove corresponding cache files from S3
+4. **Invalidate CloudFront** (`NextjsGlobalFunctions`/`NextjsGlobalContainers` only): Evict the corresponding paths from the CDN edge cache too, so the origin's now-fresh state isn't masked by a still-cached edge response. This is best-effort and asynchronous (`cloudfront:CreateInvalidation` has no bounded completion SLA), so a client may briefly still observe stale content immediately after revalidation.
 
 **Revalidation Safety**: Even if S3 deletions fail due to network issues or race conditions, the cache handler will detect stale data during the next `get()` operation by comparing timestamps and automatically remove invalid entries.
 
@@ -428,6 +429,8 @@ For routes with time-based revalidation (e.g., `revalidate: 3600`):
 - Triggers background regeneration when expired
 - Updates cache files in S3 automatically
 
+**Known limitation on Lambda**: this background regeneration is Next.js's own fire-and-forget work, not something cdk-nextjs's cache handler is invoked to await — the same "no signal for when background work is complete" gap that led to `NextjsRevalidation` (an SQS-based workaround) being removed in favor of waiting for Next.js's [Deployment Adapters `waitFor` API](https://github.com/vercel/next.js/discussions/77740) (see `docs/breaking-changes.md` 0.4.0). Until cdk-nextjs adopts `waitFor`, time-based revalidation on Lambda may occasionally not complete before the execution environment spins down, unrelated to the CloudFront-edge-cache invalidation described below (which only fires for explicit tag/path revalidation, not time-based expiry).
+
 ### Tag-based Revalidation
 
 ```typescript