zuplo 7.3.2 → 7.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/docs/ai-gateway/apps.mdx +2 -2
  2. package/docs/ai-gateway/custom-policies.mdx +3 -3
  3. package/docs/ai-gateway/fallback.mdx +13 -12
  4. package/docs/ai-gateway/getting-started.mdx +10 -9
  5. package/docs/ai-gateway/introduction.mdx +19 -18
  6. package/docs/ai-gateway/managing-apps.mdx +9 -7
  7. package/docs/ai-gateway/policy-chains.mdx +13 -7
  8. package/docs/ai-gateway/policy-templates.mdx +4 -3
  9. package/docs/ai-gateway/usage-limits.mdx +8 -10
  10. package/docs/api-management/introduction.md +1 -1
  11. package/docs/articles/api-key-api.mdx +3 -3
  12. package/docs/articles/custom-ci-cd-azure.mdx +1 -1
  13. package/docs/articles/custom-ci-cd-bitbucket.mdx +2 -2
  14. package/docs/articles/custom-code-patterns.md +1 -1
  15. package/docs/articles/custom-domains.mdx +2 -2
  16. package/docs/articles/development-options.mdx +4 -4
  17. package/docs/articles/fastly-zuplo-host-setup.mdx +5 -5
  18. package/docs/articles/feature-flags.mdx +442 -0
  19. package/docs/articles/gke-with-upstream-auth-policy.mdx +7 -7
  20. package/docs/articles/health-checks.mdx +4 -4
  21. package/docs/articles/hosting-options.mdx +2 -2
  22. package/docs/articles/local-development-env-variables.mdx +1 -1
  23. package/docs/articles/metrics-plugins.mdx +1 -1
  24. package/docs/articles/migration-overview.md +1 -1
  25. package/docs/articles/monorepo-deployment.mdx +10 -10
  26. package/docs/articles/performance-testing.mdx +10 -9
  27. package/docs/articles/plugin-azure-blob.mdx +1 -1
  28. package/docs/articles/plugin-azure-event-hubs.mdx +2 -2
  29. package/docs/articles/policies.mdx +2 -2
  30. package/docs/articles/securing-backend-mtls.mdx +3 -3
  31. package/docs/articles/securing-the-gateway-with-client-mtls.mdx +3 -3
  32. package/docs/articles/securing-your-backend.mdx +1 -1
  33. package/docs/articles/security.mdx +1 -1
  34. package/docs/articles/terraform.mdx +2 -2
  35. package/docs/articles/testing.mdx +6 -6
  36. package/docs/articles/troubleshooting-slow-responses.mdx +5 -6
  37. package/docs/articles/troubleshooting.md +1 -1
  38. package/docs/articles/use-openapi-extension-data.mdx +4 -4
  39. package/docs/articles/waf-ddos-akamai.md +13 -13
  40. package/docs/articles/waf-ddos-aws-waf-shield.mdx +14 -14
  41. package/docs/articles/waf-ddos-fastly.mdx +14 -14
  42. package/docs/articles/waf-ddos.mdx +7 -7
  43. package/docs/cli/authentication.mdx +1 -1
  44. package/docs/cli/lint.mdx +103 -0
  45. package/docs/concepts/how-zuplo-works.mdx +5 -4
  46. package/docs/concepts/upstream-credentials.mdx +1 -1
  47. package/docs/dedicated/akamai/architecture.mdx +23 -24
  48. package/docs/dedicated/akamai/cdn.mdx +20 -20
  49. package/docs/dedicated/architecture.mdx +28 -27
  50. package/docs/dedicated/custom-domains.mdx +3 -4
  51. package/docs/dedicated/federated-gateways.mdx +1 -1
  52. package/docs/dedicated/networking.mdx +10 -10
  53. package/docs/dedicated/overview.mdx +3 -3
  54. package/docs/dedicated/source-control.mdx +6 -5
  55. package/docs/handlers/custom-handler.mdx +4 -4
  56. package/docs/handlers/mcp-server.mdx +1 -1
  57. package/docs/handlers/url-forward.mdx +1 -2
  58. package/docs/mcp-server/introduction.mdx +4 -4
  59. package/docs/policies/_index.md +2 -2
  60. package/docs/policies/ai-gateway-configuration-executor-v2-inbound/schema.json +1 -1
  61. package/docs/policies/ai-gateway-dlp-inbound/doc.md +79 -45
  62. package/docs/policies/ai-gateway-dlp-inbound/schema.json +5679 -3359
  63. package/docs/policies/ai-gateway-metering-v2-inbound/doc.md +13 -13
  64. package/docs/policies/ai-gateway-metering-v2-inbound/schema.json +1 -1
  65. package/docs/programmable-api/environment.mdx +1 -1
  66. package/docs/programmable-api/jwt-service-plugin.mdx +1 -1
  67. package/docs/programmable-api/logger.mdx +1 -1
  68. package/docs/programmable-api/runtime-errors.mdx +1 -1
  69. package/docs/programmable-api/zuplo-context.mdx +3 -3
  70. package/docs/self-hosted/overview.md +3 -3
  71. package/package.json +5 -5
@@ -1,9 +1,9 @@
1
1
  # AI Gateway Metering
2
2
 
3
- AI Gateway Metering records application usage and enforces budgets before the
4
- provider request runs. It meters spend, tokens, and requests. Each meter has
5
- independent daily and monthly periods and an optional warning threshold that
6
- notifies without blocking.
3
+ AI Gateway Metering records application usage and configures the app's own
4
+ budgets before the provider request runs. It meters spend, tokens, and requests.
5
+ Each meter has independent daily and monthly periods and an optional warning
6
+ threshold that notifies without blocking.
7
7
 
8
8
  When a limit is exceeded, the policy activates the model selection's
9
9
  `quotaFallback` when AI Gateway Fallback Model supplied one. Otherwise it
@@ -52,16 +52,16 @@ The supported meters are `costs`, `tokens`, and `requests`. Each meter can have
52
52
 
53
53
  ## Team limits
54
54
 
55
- Limits configured on a parent team or the bucket root are enforced automatically
56
- through a server-side hierarchical check against aggregated usage. The
57
- `options.limits` settings govern only the app running this policy; the server
58
- walks the ancestor chain and reports the first exceeded limit.
55
+ The `options.limits` settings govern only the app running this policy. Limits
56
+ configured on a parent team or the gateway root are enforced centrally after the
57
+ application's policy chain, whether or not this policy appears in that chain. An
58
+ inherited limit activates the selected model's quota fallback when available and
59
+ otherwise returns `429 Too Many Requests`.
59
60
 
60
- An exceeded team or gateway limit follows the same configured model-fallback or
61
- 429 response path as an app limit. Ancestor enforcement cannot be disabled from
62
- the app's policy-chain entry. When the hierarchical check is unavailable,
63
- `throwOnFailure` controls the behavior: the default skips enforcement for that
64
- request while continuing to meter it, and `true` fails the request.
61
+ An application cannot disable inherited enforcement through its policy chain. If
62
+ the central hierarchical check is unavailable, the request proceeds. The
63
+ policy's `throwOnFailure` option controls failures while checking or recording
64
+ the app's own limits; it does not change inherited-limit behavior.
65
65
 
66
66
  ## Set limits from custom code
67
67
 
@@ -12,7 +12,7 @@
12
12
  "requiresAI": true,
13
13
  "policyType": "ai-gateway-metering-v2",
14
14
  "products": ["ai-gateway"],
15
- "description": "Meters AI Gateway usage and enforces app and ancestor usage limits.\n\nLimits configured on parent teams or the bucket root are enforced through a server-side hierarchical check.\n\nThe authentication policy must run before this policy so the app configuration id is available for meter storage and analytics.",
15
+ "description": "Meters AI Gateway usage and enforces limits configured by the application.\n\nThe authentication policy must run before this policy so the app configuration id is available for meter storage and analytics.",
16
16
  "deprecatedMessage": "",
17
17
  "required": ["handler"],
18
18
  "properties": {
@@ -4,7 +4,7 @@ sidebar_label: Environment Variables
4
4
  ---
5
5
 
6
6
  The `environment` object provides access to environment variables in your Zuplo
7
- API gateway. It returns a record of environment variable names to their values.
7
+ Gateway. It returns a record of environment variable names to their values.
8
8
 
9
9
  :::info{title="Configuration Guide"}
10
10
 
@@ -30,7 +30,7 @@ Some of the common use cases for the JWT service plugin include:
30
30
 
31
31
  - Securing downstream APIs by issuing JWTs that can be used to verify that the
32
32
  request is coming from your Zuplo API
33
- - Securing requests to other Zuplo API gateways (for example, when using the
33
+ - Securing requests to other Zuplo Gateways (for example, when using the
34
34
  [Federated Gateway](../dedicated/federated-gateways.mdx) capability on Zuplo
35
35
  managed dedicated deployments.)
36
36
  - Calling third-party APIs that can be configured with federated identity such
@@ -3,7 +3,7 @@ title: Logger
3
3
  ---
4
4
 
5
5
  The `Logger` interface provides structured logging capabilities throughout your
6
- Zuplo API gateway. The logger is accessible via the `context.log` property and
6
+ Zuplo Gateway. The logger is accessible via the `context.log` property and
7
7
  supports multiple log levels.
8
8
 
9
9
  ## Interface
@@ -3,7 +3,7 @@ title: Runtime Errors
3
3
  ---
4
4
 
5
5
  Zuplo provides specialized error classes for handling runtime and configuration
6
- errors in your API gateway.
6
+ errors in your Zuplo Gateway.
7
7
 
8
8
  ## RuntimeError
9
9
 
@@ -266,9 +266,9 @@ export default async function (request: ZuploRequest, context: ZuploContext) {
266
266
 
267
267
  ### `invokeRoute`
268
268
 
269
- Invokes another route within the same API gateway. This enables internal routing
270
- and composition of multiple routes. The invoked route runs with a new context
271
- that has `parentContext` set to the current context.
269
+ Invokes another route within the same Zuplo Gateway. This enables internal
270
+ routing and composition of multiple routes. The invoked route runs with a new
271
+ context that has `parentContext` set to the current context.
272
272
 
273
273
  ```ts
274
274
  export default async function (request: ZuploRequest, context: ZuploContext) {
@@ -4,9 +4,9 @@ sidebar_label: Overview
4
4
  ---
5
5
 
6
6
  Zuplo Self-Hosted (also known as on-prem) is a deployment model where you run
7
- the Zuplo API Gateway on your own infrastructure — any cloud or private data
8
- center. Zuplo Self-Hosted runs exclusively on Kubernetes and is installed with a
9
- single Helm chart into your cluster.
7
+ the Zuplo Gateway on your own infrastructure — any cloud or private data center.
8
+ Zuplo Self-Hosted runs exclusively on Kubernetes and is installed with a single
9
+ Helm chart into your cluster.
10
10
 
11
11
  Self-hosted deployment might be the right choice for you if you need:
12
12
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "zuplo",
3
- "version": "7.3.2",
3
+ "version": "7.4.3",
4
4
  "type": "module",
5
5
  "description": "The programmable API Gateway",
6
6
  "author": "Zuplo, Inc.",
@@ -19,9 +19,9 @@
19
19
  "zuplo": "zuplo.js"
20
20
  },
21
21
  "dependencies": {
22
- "@zuplo/cli": "7.3.2",
23
- "@zuplo/core": "7.3.2",
24
- "@zuplo/runtime": "7.3.2",
25
- "@zuplo/test": "7.3.2"
22
+ "@zuplo/cli": "7.4.3",
23
+ "@zuplo/core": "7.4.3",
24
+ "@zuplo/runtime": "7.4.3",
25
+ "@zuplo/test": "7.4.3"
26
26
  }
27
27
  }