zuplo 6.74.15 → 7.0.1

package/docs/articles/ci-cd-azure/basic-deployment.mdx

@@ -15,7 +15,7 @@ pool:
 steps:
   - task: NodeTool@0
     inputs:
-      versionSpec: "20.x"
+      versionSpec: "24.x"
     displayName: "Install Node.js"
 
   - script: npm install
@@ -28,7 +28,7 @@ steps:
 This pipeline:
 
 1. Triggers on pushes to the `main` branch
-2. Sets up Node.js 20
+2. Sets up Node.js 24
 3. Installs dependencies
 4. Deploys to Zuplo using the branch name as the environment name
 

package/docs/articles/ci-cd-azure/deploy-and-test.mdx

@@ -18,7 +18,7 @@ pool:
 steps:
   - task: NodeTool@0
     inputs:
-      versionSpec: "20.x"
+      versionSpec: "24.x"
     displayName: "Install Node.js"
 
   - script: npm install

package/docs/articles/ci-cd-azure/local-testing.mdx

@@ -20,7 +20,7 @@ stages:
         steps:
           - task: NodeTool@0
             inputs:
-              versionSpec: "20.x"
+              versionSpec: "24.x"
             displayName: "Install Node.js"
 
           - script: npm install
@@ -44,7 +44,7 @@ stages:
         steps:
           - task: NodeTool@0
             inputs:
-              versionSpec: "20.x"
+              versionSpec: "24.x"
 
           - script: npm install
 

package/docs/articles/ci-cd-azure/multi-stage-deployment.mdx

@@ -20,7 +20,7 @@ stages:
         steps:
           - task: NodeTool@0
             inputs:
-              versionSpec: "20.x"
+              versionSpec: "24.x"
 
           - script: npm install
 
@@ -45,7 +45,7 @@ stages:
         steps:
           - task: NodeTool@0
             inputs:
-              versionSpec: "20.x"
+              versionSpec: "24.x"
 
           - script: npm install
 
@@ -66,7 +66,7 @@ stages:
 
                 - task: NodeTool@0
                   inputs:
-                    versionSpec: "20.x"
+                    versionSpec: "24.x"
 
                 - script: npm install
 

package/docs/articles/ci-cd-azure/pr-preview-environments.mdx

@@ -18,7 +18,7 @@ pool:
 steps:
   - task: NodeTool@0
     inputs:
-      versionSpec: "20.x"
+      versionSpec: "24.x"
     displayName: "Install Node.js"
 
   - script: npm install

package/docs/articles/ci-cd-azure/tag-based-releases.mdx

@@ -17,7 +17,7 @@ pool:
 steps:
   - task: NodeTool@0
     inputs:
-      versionSpec: "20.x"
+      versionSpec: "24.x"
     displayName: "Install Node.js"
 
   - script: npm install

package/docs/articles/ci-cd-bitbucket/basic-deployment.mdx

@@ -6,7 +6,7 @@ sidebar_label: Basic Deployment
 The simplest pipeline deploys your API to Zuplo on every push to main.
 
 ```yaml title="bitbucket-pipelines.yml"
-image: node:20
+image: node:24
 
 pipelines:
   branches:

package/docs/articles/ci-cd-bitbucket/deploy-and-test.mdx

@@ -6,7 +6,7 @@ sidebar_label: Deploy and Test
 Run your test suite against the deployed environment to validate changes.
 
 ```yaml title="bitbucket-pipelines.yml"
-image: node:20
+image: node:24
 
 pipelines:
   default:

package/docs/articles/ci-cd-bitbucket/local-testing.mdx

@@ -6,7 +6,7 @@ sidebar_label: Local Testing in CI
 Test against a local Zuplo server before deploying anywhere.
 
 ```yaml title="bitbucket-pipelines.yml"
-image: node:20
+image: node:24
 
 pipelines:
   branches:

package/docs/articles/ci-cd-bitbucket/multi-stage-deployment.mdx

@@ -6,7 +6,7 @@ sidebar_label: Multi-Stage Deployment
 Deploy to staging, test, then promote to production with approval.
 
 ```yaml title="bitbucket-pipelines.yml"
-image: node:20
+image: node:24
 
 pipelines:
   branches:

package/docs/articles/ci-cd-bitbucket/pr-preview-environments.mdx

@@ -6,7 +6,7 @@ sidebar_label: PR Preview Environments
 Deploy preview environments for pull requests and clean up when they close.
 
 ```yaml title="bitbucket-pipelines.yml"
-image: node:20
+image: node:24
 
 pipelines:
   pull-requests:

package/docs/articles/ci-cd-bitbucket/tag-based-releases.mdx

@@ -6,7 +6,7 @@ sidebar_label: Tag-Based Releases
 Deploy only when tags are pushed for controlled releases.
 
 ```yaml title="bitbucket-pipelines.yml"
-image: node:20
+image: node:24
 
 pipelines:
   tags:

package/docs/articles/ci-cd-circleci/basic-deployment.mdx

@@ -11,7 +11,7 @@ version: 2.1
 jobs:
   deploy:
     docker:
-      - image: cimg/node:20.0
+      - image: cimg/node:24.0
     steps:
       - checkout
       - run: npm install

package/docs/articles/ci-cd-circleci/deploy-and-test.mdx

@@ -11,7 +11,7 @@ version: 2.1
 jobs:
   deploy:
     docker:
-      - image: cimg/node:20.0
+      - image: cimg/node:24.0
     steps:
       - checkout
       - run: npm install

package/docs/articles/ci-cd-circleci/local-testing.mdx

@@ -11,7 +11,7 @@ version: 2.1
 jobs:
   local-test:
     docker:
-      - image: cimg/node:20.0
+      - image: cimg/node:24.0
     steps:
       - checkout
       - run: npm install
@@ -25,7 +25,7 @@ jobs:
 
   deploy:
     docker:
-      - image: cimg/node:20.0
+      - image: cimg/node:24.0
     steps:
       - checkout
       - run: npm install

package/docs/articles/ci-cd-circleci/multi-stage-deployment.mdx

@@ -11,7 +11,7 @@ version: 2.1
 jobs:
   deploy-staging:
     docker:
-      - image: cimg/node:20.0
+      - image: cimg/node:24.0
     steps:
       - checkout
       - run: npm install
@@ -30,7 +30,7 @@ jobs:
 
   test-staging:
     docker:
-      - image: cimg/node:20.0
+      - image: cimg/node:24.0
     steps:
       - checkout
       - attach_workspace:
@@ -44,7 +44,7 @@ jobs:
 
   deploy-production:
     docker:
-      - image: cimg/node:20.0
+      - image: cimg/node:24.0
     steps:
       - checkout
       - run: npm install

package/docs/articles/ci-cd-circleci/pr-preview-environments.mdx

@@ -11,7 +11,7 @@ version: 2.1
 jobs:
   deploy-and-test:
     docker:
-      - image: cimg/node:20.0
+      - image: cimg/node:24.0
     steps:
       - checkout
       - run: npm install

package/docs/articles/ci-cd-circleci/tag-based-releases.mdx

@@ -11,7 +11,7 @@ version: 2.1
 jobs:
   deploy:
     docker:
-      - image: cimg/node:20.0
+      - image: cimg/node:24.0
     steps:
       - checkout
       - run: npm install

package/docs/articles/ci-cd-github/basic-deployment.mdx

@@ -21,7 +21,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install

package/docs/articles/ci-cd-github/cleanup-on-branch-delete.mdx

@@ -25,7 +25,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install
@@ -93,7 +93,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install

package/docs/articles/ci-cd-github/deploy-and-test.mdx

@@ -26,7 +26,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install

package/docs/articles/ci-cd-github/local-testing.mdx

@@ -24,7 +24,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install
@@ -58,7 +58,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install

package/docs/articles/ci-cd-github/multi-stage-deployment.mdx

@@ -27,7 +27,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install
@@ -50,7 +50,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install
@@ -73,7 +73,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install

package/docs/articles/ci-cd-github/pr-preview-environments.mdx

@@ -45,7 +45,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install
@@ -89,7 +89,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install

package/docs/articles/ci-cd-github/tag-based-releases.mdx

@@ -25,7 +25,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install

package/docs/articles/ci-cd-gitlab/basic-deployment.mdx

@@ -6,7 +6,7 @@ sidebar_label: Basic Deployment
 The simplest pipeline deploys your API to Zuplo on every push to main.
 
 ```yaml title=".gitlab-ci.yml"
-image: node:20
+image: node:24
 
 stages:
   - deploy

package/docs/articles/ci-cd-gitlab/deploy-and-test.mdx

@@ -6,7 +6,7 @@ sidebar_label: Deploy and Test
 Run your test suite against the deployed environment to validate changes.
 
 ```yaml title=".gitlab-ci.yml"
-image: node:20
+image: node:24
 
 stages:
   - deploy

package/docs/articles/ci-cd-gitlab/local-testing.mdx

@@ -6,7 +6,7 @@ sidebar_label: Local Testing in CI
 Test against a local Zuplo server before deploying anywhere.
 
 ```yaml title=".gitlab-ci.yml"
-image: node:20
+image: node:24
 
 stages:
   - test

package/docs/articles/ci-cd-gitlab/mr-preview-environments.mdx

@@ -6,7 +6,7 @@ sidebar_label: MR Preview Environments
 Deploy preview environments for merge requests and clean up when they close.
 
 ```yaml title=".gitlab-ci.yml"
-image: node:20
+image: node:24
 
 stages:
   - deploy

package/docs/articles/ci-cd-gitlab/multi-stage-deployment.mdx

@@ -6,7 +6,7 @@ sidebar_label: Multi-Stage Deployment
 Deploy to staging, test, then promote to production with approval.
 
 ```yaml title=".gitlab-ci.yml"
-image: node:20
+image: node:24
 
 stages:
   - deploy-staging

package/docs/articles/ci-cd-gitlab/tag-based-releases.mdx

@@ -6,7 +6,7 @@ sidebar_label: Tag-Based Releases
 Deploy only when tags are pushed for controlled releases.
 
 ```yaml title=".gitlab-ci.yml"
-image: node:20
+image: node:24
 
 stages:
   - deploy

package/docs/articles/github-deployment-testing.mdx

@@ -43,7 +43,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install

package/docs/articles/graphql-caching.mdx

@@ -94,3 +94,5 @@ for the full option matrix, including how credentialed requests fail safe.
 - [GraphQL on Zuplo](./graphql.mdx) — set up the endpoint and Dev Portal docs
 - [GraphQL analytics](../analytics/tabs/graphql.md) — watch hit rates and
   latency once traffic flows
+- [Caching in Zuplo](../caching/overview.mdx) — the other caching layers a
+  GraphQL API can use, and when each one wins

package/docs/articles/local-development.mdx

@@ -8,7 +8,7 @@ development purposes using your favorite code editor.
 
 ## Requirements
 
-- [Node.js](https://nodejs.org/en/download) 20.0.0 or higher
+- [Node.js](https://nodejs.org/en/download) 24.0.0 or higher
 - Linux, Mac OS X, Windows, or Windows Subsystem for Linux (WSL)
 
 ## Getting Started
@@ -36,12 +36,12 @@ development purposes using your favorite code editor.
 
 ### Import your existing project
 
-If you have been using Zuplo using the _Zuplo Web Portal_, you can import your
-project into your local machine.
+If you have been working in the _Zuplo Portal_, you can import your project into
+your local machine.
 
 <Stepper>
 
-1. Connect your project to a Git repository from the _Zuplo Web Portal_.
+1. Connect your project to a Git repository from the _Zuplo Portal_.
    ![Connect repository](../../public/media/local-development/3bd6b736-20d7-4ac4-805c-d7fd810dea28.png)
 1. Clone your project from your Git provider to your local machine.
 1. Install the necessary dependencies:

package/docs/articles/monorepo-deployment.mdx

@@ -108,7 +108,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install
@@ -165,7 +165,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install
@@ -207,7 +207,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install dependencies
         run: npm install

package/docs/articles/sharing-code-across-projects.mdx

@@ -69,10 +69,10 @@ Configure your `package.json` to include the TypeScript source files and a
     "postinstall": "node ./scripts/copy-to-modules.mjs"
   },
   "peerDependencies": {
-    "@zuplo/runtime": "^1.0.0"
+    "@zuplo/runtime": "^7.0.0"
   },
   "devDependencies": {
-    "@zuplo/runtime": "^1.0.0",
+    "@zuplo/runtime": "^7.0.0",
     "typescript": "^5.0.0"
   }
 }

package/docs/articles/step-1-setup-basic-gateway-local.mdx

@@ -14,7 +14,7 @@ template, which ships with a working todo API.
 
 ## Requirements
 
-- [Node.js](https://nodejs.org/en/download) 20.0.0 or higher
+- [Node.js](https://nodejs.org/en/download) 24.0.0 or higher
 
 <Stepper>
 

package/docs/articles/testing.mdx

@@ -222,7 +222,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
       - name: Install dependencies
         run: npm install
       - name: Start local server and run tests
@@ -244,7 +244,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
       - name: Install dependencies
         run: npm install
       - name: Deploy to Zuplo
@@ -511,9 +511,9 @@ If you are running unit tests in a Node.js environment, you may need to polyfill
 some globals. Zuplo itself doesn't run on Node.js, but because Zuplo is built on
 standard API, testing in Node.js is possible.
 
-If you are running on Node.js 20 or later, you can use the `webcrypto` module to
-polyfill the `crypto` global. You must register this polyfill before any Zuplo
-code runs.
+Node.js 24, the minimum version the Zuplo CLI supports, includes the `webcrypto`
+module, which polyfills the `crypto` global. You must register this polyfill
+before any Zuplo code runs.
 
 ```js
 import { webcrypto } from "node:crypto";

package/docs/articles/troubleshooting-slow-responses.mdx

@@ -135,6 +135,9 @@ from it. If latency scales with geographic distance, this is the cause.
 - Deploy your backend in multiple regions
 - Use Zuplo's [Caching policy](../policies/caching-inbound.mdx) to serve cached
   responses from the edge without reaching the backend
+- Put a CDN in front of the gateway so a hit returns from a POP near the caller
+  and never crosses the distance at all — see
+  [Cache at the CDN](../caching/cdn-caching.mdx)
 - For internal or single-cloud traffic, consider
   [Managed Dedicated](../dedicated/overview.mdx) deployment, which runs Zuplo
   within your cloud provider's network for reduced latency by keeping traffic
@@ -367,6 +370,8 @@ back-and-forth diagnostic questions.
   benchmark and compare gateway performance accurately
 - [Proactive Monitoring](./monitoring-your-gateway.mdx) — Setting up health
   checks and monitoring for your gateway
+- [Caching in Zuplo](../caching/overview.mdx) — Picking the caching layer that
+  removes the latency instead of moving it
 - [ZoneCache](../programmable-api/zone-cache.mdx) — Low-latency caching API for
   frequently accessed data
 - [Caching Policy](../policies/caching-inbound.mdx) — Built-in response caching

package/docs/articles/update-zup-in-github-action.mdx

@@ -60,7 +60,7 @@ jobs:
       - name: Use Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20.x
+          node-version: 24.x
           cache: "npm"
 
       # Run your build/generate scripts here to generate the OpenAPI file