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.
- package/docs/ai-gateway/apps.mdx +2 -2
- package/docs/ai-gateway/custom-policies.mdx +3 -3
- package/docs/ai-gateway/fallback.mdx +13 -12
- package/docs/ai-gateway/getting-started.mdx +10 -9
- package/docs/ai-gateway/introduction.mdx +19 -18
- package/docs/ai-gateway/managing-apps.mdx +9 -7
- package/docs/ai-gateway/policy-chains.mdx +13 -7
- package/docs/ai-gateway/policy-templates.mdx +4 -3
- package/docs/ai-gateway/usage-limits.mdx +8 -10
- package/docs/api-management/introduction.md +1 -1
- package/docs/articles/api-key-api.mdx +3 -3
- package/docs/articles/custom-ci-cd-azure.mdx +1 -1
- package/docs/articles/custom-ci-cd-bitbucket.mdx +2 -2
- package/docs/articles/custom-code-patterns.md +1 -1
- package/docs/articles/custom-domains.mdx +2 -2
- package/docs/articles/development-options.mdx +4 -4
- package/docs/articles/fastly-zuplo-host-setup.mdx +5 -5
- package/docs/articles/feature-flags.mdx +442 -0
- package/docs/articles/gke-with-upstream-auth-policy.mdx +7 -7
- package/docs/articles/health-checks.mdx +4 -4
- package/docs/articles/hosting-options.mdx +2 -2
- package/docs/articles/local-development-env-variables.mdx +1 -1
- package/docs/articles/metrics-plugins.mdx +1 -1
- package/docs/articles/migration-overview.md +1 -1
- package/docs/articles/monorepo-deployment.mdx +10 -10
- package/docs/articles/performance-testing.mdx +10 -9
- package/docs/articles/plugin-azure-blob.mdx +1 -1
- package/docs/articles/plugin-azure-event-hubs.mdx +2 -2
- package/docs/articles/policies.mdx +2 -2
- package/docs/articles/securing-backend-mtls.mdx +3 -3
- package/docs/articles/securing-the-gateway-with-client-mtls.mdx +3 -3
- package/docs/articles/securing-your-backend.mdx +1 -1
- package/docs/articles/security.mdx +1 -1
- package/docs/articles/terraform.mdx +2 -2
- package/docs/articles/testing.mdx +6 -6
- package/docs/articles/troubleshooting-slow-responses.mdx +5 -6
- package/docs/articles/troubleshooting.md +1 -1
- package/docs/articles/use-openapi-extension-data.mdx +4 -4
- package/docs/articles/waf-ddos-akamai.md +13 -13
- package/docs/articles/waf-ddos-aws-waf-shield.mdx +14 -14
- package/docs/articles/waf-ddos-fastly.mdx +14 -14
- package/docs/articles/waf-ddos.mdx +7 -7
- package/docs/cli/authentication.mdx +1 -1
- package/docs/cli/lint.mdx +103 -0
- package/docs/concepts/how-zuplo-works.mdx +5 -4
- package/docs/concepts/upstream-credentials.mdx +1 -1
- package/docs/dedicated/akamai/architecture.mdx +23 -24
- package/docs/dedicated/akamai/cdn.mdx +20 -20
- package/docs/dedicated/architecture.mdx +28 -27
- package/docs/dedicated/custom-domains.mdx +3 -4
- package/docs/dedicated/federated-gateways.mdx +1 -1
- package/docs/dedicated/networking.mdx +10 -10
- package/docs/dedicated/overview.mdx +3 -3
- package/docs/dedicated/source-control.mdx +6 -5
- package/docs/handlers/custom-handler.mdx +4 -4
- package/docs/handlers/mcp-server.mdx +1 -1
- package/docs/handlers/url-forward.mdx +1 -2
- package/docs/mcp-server/introduction.mdx +4 -4
- package/docs/policies/_index.md +2 -2
- package/docs/policies/ai-gateway-configuration-executor-v2-inbound/schema.json +1 -1
- package/docs/policies/ai-gateway-dlp-inbound/doc.md +79 -45
- package/docs/policies/ai-gateway-dlp-inbound/schema.json +5679 -3359
- package/docs/policies/ai-gateway-metering-v2-inbound/doc.md +13 -13
- package/docs/policies/ai-gateway-metering-v2-inbound/schema.json +1 -1
- package/docs/programmable-api/environment.mdx +1 -1
- package/docs/programmable-api/jwt-service-plugin.mdx +1 -1
- package/docs/programmable-api/logger.mdx +1 -1
- package/docs/programmable-api/runtime-errors.mdx +1 -1
- package/docs/programmable-api/zuplo-context.mdx +3 -3
- package/docs/self-hosted/overview.md +3 -3
- package/package.json +5 -5
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# AI Gateway Metering
|
|
2
2
|
|
|
3
|
-
AI Gateway Metering records application usage and
|
|
4
|
-
provider request runs. It meters spend, tokens, and requests.
|
|
5
|
-
independent daily and monthly periods and an optional warning
|
|
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
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
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
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
6
|
+
Zuplo Gateway. The logger is accessible via the `context.log` property and
|
|
7
7
|
supports multiple log levels.
|
|
8
8
|
|
|
9
9
|
## Interface
|
|
@@ -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
|
|
270
|
-
and composition of multiple routes. The invoked route runs with a new
|
|
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
|
|
8
|
-
|
|
9
|
-
|
|
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
|
|
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
|
|
23
|
-
"@zuplo/core": "7.3
|
|
24
|
-
"@zuplo/runtime": "7.3
|
|
25
|
-
"@zuplo/test": "7.3
|
|
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
|
}
|