@apifuse/provider-sdk 2.2.0-beta.7 → 2.2.0-beta.70
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/AUTHORING.md +943 -51
- package/CHANGELOG.md +273 -1
- package/LICENSE +21 -0
- package/README.md +117 -29
- package/SUBMISSION.md +3 -2
- package/bin/apifuse-check.ts +293 -13
- package/bin/apifuse-dev.ts +42 -19
- package/bin/apifuse-migrate-deployment.ts +200 -0
- package/bin/apifuse-migrate-operation-declaration.ts +55 -0
- package/bin/apifuse-migrate-shape.ts +202 -0
- package/bin/apifuse-pack-check.ts +19 -6
- package/bin/apifuse-pack-smoke.ts +57 -2
- package/bin/apifuse-pack-types.ts +736 -38
- package/bin/apifuse-perf.ts +59 -23
- package/bin/apifuse-record.ts +923 -94
- package/bin/apifuse-submit-check.ts +2313 -281
- package/bin/apifuse-test.ts +3 -1
- package/bin/submit-check-delimited-text.ts +50 -0
- package/dist/auth-turn/index.d.ts +3 -3
- package/dist/auth-turn/index.js +1 -1
- package/dist/auth.d.ts +14 -0
- package/dist/auth.js +67 -0
- package/dist/ceremonies/index.d.ts +16 -0
- package/dist/ceremonies/index.js +141 -36
- package/dist/cli/commands.d.ts +1 -1
- package/dist/cli/commands.js +30 -0
- package/dist/cli/create.d.ts +1 -1
- package/dist/cli/create.js +8 -2
- package/dist/cli/deployment-intent.d.ts +178 -0
- package/dist/cli/deployment-intent.js +277 -0
- package/dist/cli/local-connection.d.ts +111 -0
- package/dist/cli/local-connection.js +151 -0
- package/dist/cli/migrate-deployment-intent.d.ts +132 -0
- package/dist/cli/migrate-deployment-intent.js +1552 -0
- package/dist/cli/migrate-operation-declaration.d.ts +70 -0
- package/dist/cli/migrate-operation-declaration.js +2206 -0
- package/dist/cli/migrate-operation-shape.d.ts +44 -0
- package/dist/cli/migrate-operation-shape.js +113 -0
- package/dist/cli/migrate-provider-shape.d.ts +56 -0
- package/dist/cli/migrate-provider-shape.js +580 -0
- package/dist/cli/resolver-runtime.d.ts +21 -0
- package/dist/cli/resolver-runtime.js +31 -0
- package/dist/cli/templates/provider/.agents/skills/health-checks-and-fail-closed/SKILL.md.tpl +141 -23
- package/dist/cli/templates/provider/Dockerfile.tpl +1 -1
- package/dist/cli/templates/provider/README.md.tpl +41 -19
- package/dist/cli/templates/provider/index.ts.tpl +6 -3
- package/dist/cli/templates/provider/operations/ping.ts.tpl +4 -1
- package/dist/cli/templates/provider/provider.json.tpl +6 -0
- package/dist/config/loader.d.ts +202 -16
- package/dist/config/loader.js +491 -141
- package/dist/contract-serialization.js +4 -8
- package/dist/contract-types.d.ts +12 -5
- package/dist/contract.js +24 -10
- package/dist/declaration-validation.d.ts +34 -0
- package/dist/declaration-validation.js +305 -0
- package/dist/define.d.ts +71 -29
- package/dist/define.js +807 -69
- package/dist/dev.d.ts +5 -0
- package/dist/dev.js +8 -1
- package/dist/engine.d.ts +129 -0
- package/dist/engine.js +209 -0
- package/dist/error-observability.d.ts +7 -0
- package/dist/error-observability.js +61 -0
- package/dist/error-resolution.d.ts +18 -0
- package/dist/error-resolution.js +243 -0
- package/dist/errors.d.ts +74 -0
- package/dist/errors.js +99 -0
- package/dist/fixture-sanitization.d.ts +28 -0
- package/dist/fixture-sanitization.js +371 -0
- package/dist/handle-meta.d.ts +90 -0
- package/dist/handle-meta.js +73 -0
- package/dist/handle.d.ts +226 -0
- package/dist/handle.js +345 -0
- package/dist/health-scenario.d.ts +1901 -0
- package/dist/health-scenario.js +653 -0
- package/dist/i18n/catalog.js +21 -1
- package/dist/i18n/error-messages.d.ts +86 -0
- package/dist/i18n/error-messages.js +192 -0
- package/dist/i18n/index.d.ts +1 -0
- package/dist/i18n/index.js +1 -0
- package/dist/i18n/keys.d.ts +12 -0
- package/dist/i18n/keys.js +76 -5
- package/dist/i18n/operation-locale-namespace.d.ts +2 -0
- package/dist/i18n/operation-locale-namespace.js +7 -0
- package/dist/index.d.ts +40 -15
- package/dist/index.js +29 -11
- package/dist/lint.d.ts +43 -11
- package/dist/lint.js +2512 -177
- package/dist/native-address.d.ts +43 -0
- package/dist/native-address.js +281 -0
- package/dist/native-egress-policy.d.ts +31 -0
- package/dist/native-egress-policy.js +288 -0
- package/dist/observability.d.ts +5 -2
- package/dist/observability.js +48 -1
- package/dist/provider.d.ts +18 -8
- package/dist/provider.js +11 -6
- package/dist/runtime/auth-flow.d.ts +6 -1
- package/dist/runtime/auth-flow.js +8 -0
- package/dist/runtime/bounded-expiring-map.d.ts +21 -0
- package/dist/runtime/bounded-expiring-map.js +64 -0
- package/dist/runtime/browser-telemetry-binding.d.ts +5 -0
- package/dist/runtime/browser-telemetry-binding.js +83 -0
- package/dist/runtime/browser-telemetry.d.ts +76 -0
- package/dist/runtime/browser-telemetry.js +165 -0
- package/dist/runtime/browser.d.ts +4 -0
- package/dist/runtime/browser.js +688 -83
- package/dist/runtime/cache-telemetry.d.ts +71 -0
- package/dist/runtime/cache-telemetry.js +177 -0
- package/dist/runtime/cache.d.ts +3 -0
- package/dist/runtime/cache.js +245 -23
- package/dist/runtime/capability-response.d.ts +3 -0
- package/dist/runtime/capability-response.js +56 -0
- package/dist/runtime/capability-telemetry.d.ts +46 -0
- package/dist/runtime/capability-telemetry.js +68 -0
- package/dist/runtime/chrome149-header-order.d.ts +58 -0
- package/dist/runtime/chrome149-header-order.js +289 -0
- package/dist/runtime/diagnostic-env-values.d.ts +5 -0
- package/dist/runtime/diagnostic-env-values.js +57 -0
- package/dist/runtime/diagnostic-env.d.ts +14 -0
- package/dist/runtime/diagnostic-env.js +44 -0
- package/dist/runtime/diagnostic-redactor.d.ts +54 -0
- package/dist/runtime/diagnostic-redactor.js +571 -0
- package/dist/runtime/egress-lease.d.ts +65 -0
- package/dist/runtime/egress-lease.js +236 -0
- package/dist/runtime/engine-mode.d.ts +74 -0
- package/dist/runtime/engine-mode.js +152 -0
- package/dist/runtime/env.js +14 -1
- package/dist/runtime/executor.d.ts +3 -2
- package/dist/runtime/executor.js +23 -26
- package/dist/runtime/handle-wordlist.d.ts +43 -0
- package/dist/runtime/handle-wordlist.js +256 -0
- package/dist/runtime/handle.d.ts +71 -0
- package/dist/runtime/handle.js +908 -0
- package/dist/runtime/http-telemetry-binding.d.ts +10 -0
- package/dist/runtime/http-telemetry-binding.js +152 -0
- package/dist/runtime/http-telemetry-guard.d.ts +16 -0
- package/dist/runtime/http-telemetry-guard.js +202 -0
- package/dist/runtime/http-telemetry.d.ts +104 -0
- package/dist/runtime/http-telemetry.js +190 -0
- package/dist/runtime/http.d.ts +34 -0
- package/dist/runtime/http.js +680 -121
- package/dist/runtime/insights.js +2 -2
- package/dist/runtime/instrumentation.d.ts +2 -2
- package/dist/runtime/instrumentation.js +462 -19
- package/dist/runtime/native-network-errors.d.ts +33 -0
- package/dist/runtime/native-network-errors.js +69 -0
- package/dist/runtime/native-network.d.ts +105 -0
- package/dist/runtime/native-network.js +1433 -0
- package/dist/runtime/native-telemetry.d.ts +142 -0
- package/dist/runtime/native-telemetry.js +231 -0
- package/dist/runtime/ocr-telemetry.d.ts +82 -0
- package/dist/runtime/ocr-telemetry.js +192 -0
- package/dist/runtime/ocr.d.ts +29 -0
- package/dist/runtime/ocr.js +468 -0
- package/dist/runtime/otlp.d.ts +71 -2
- package/dist/runtime/otlp.js +398 -16
- package/dist/runtime/provider.d.ts +7 -0
- package/dist/runtime/provider.js +14 -0
- package/dist/runtime/proxy-errors.js +6 -2
- package/dist/runtime/proxy-nodemaven.d.ts +56 -0
- package/dist/runtime/proxy-nodemaven.js +147 -0
- package/dist/runtime/proxy-retry-policy.d.ts +4 -1
- package/dist/runtime/proxy-retry-policy.js +11 -2
- package/dist/runtime/proxy-telemetry.d.ts +133 -3
- package/dist/runtime/proxy-telemetry.js +218 -70
- package/dist/runtime/redirect-hop-headers.d.ts +19 -0
- package/dist/runtime/redirect-hop-headers.js +58 -0
- package/dist/runtime/redirects.d.ts +61 -0
- package/dist/runtime/redirects.js +149 -0
- package/dist/runtime/redis.d.ts +1 -1
- package/dist/runtime/redis.js +4 -2
- package/dist/runtime/request-options.d.ts +75 -1
- package/dist/runtime/request-options.js +588 -0
- package/dist/runtime/request-telemetry.d.ts +70 -0
- package/dist/runtime/request-telemetry.js +229 -0
- package/dist/runtime/resolver-config.d.ts +13 -0
- package/dist/runtime/resolver-config.js +14 -0
- package/dist/runtime/resolver-public.d.ts +3 -0
- package/dist/runtime/resolver-public.js +1 -0
- package/dist/runtime/resolver-runtime-options.d.ts +14 -0
- package/dist/runtime/resolver-runtime-options.js +33 -0
- package/dist/runtime/resolver-shared.d.ts +24 -0
- package/dist/runtime/resolver-shared.js +69 -0
- package/dist/runtime/resolver-span-attributes.d.ts +34 -0
- package/dist/runtime/resolver-span-attributes.js +93 -0
- package/dist/runtime/resolver-telemetry.d.ts +135 -0
- package/dist/runtime/resolver-telemetry.js +204 -0
- package/dist/runtime/resolver-usage.d.ts +32 -0
- package/dist/runtime/resolver-usage.js +54 -0
- package/dist/runtime/resolver-vendors/bindings.d.ts +53 -0
- package/dist/runtime/resolver-vendors/bindings.js +45 -0
- package/dist/runtime/resolver-vendors/browser.d.ts +24 -0
- package/dist/runtime/resolver-vendors/browser.js +423 -0
- package/dist/runtime/resolver-vendors/capsolver.d.ts +22 -0
- package/dist/runtime/resolver-vendors/capsolver.js +544 -0
- package/dist/runtime/resolver-vendors/hosts.d.ts +23 -0
- package/dist/runtime/resolver-vendors/hosts.js +68 -0
- package/dist/runtime/resolver-vendors/hypersolutions.d.ts +27 -0
- package/dist/runtime/resolver-vendors/hypersolutions.js +369 -0
- package/dist/runtime/resolver-vendors/twocaptcha.d.ts +24 -0
- package/dist/runtime/resolver-vendors/twocaptcha.js +425 -0
- package/dist/runtime/resolver-vendors/types.d.ts +125 -0
- package/dist/runtime/resolver-vendors/types.js +106 -0
- package/dist/runtime/resolver.d.ts +79 -0
- package/dist/runtime/resolver.js +1094 -0
- package/dist/runtime/state-telemetry.d.ts +79 -0
- package/dist/runtime/state-telemetry.js +194 -0
- package/dist/runtime/state.d.ts +10 -1
- package/dist/runtime/state.js +322 -82
- package/dist/runtime/stealth-akamai-sbsd.d.ts +54 -0
- package/dist/runtime/stealth-akamai-sbsd.js +142 -0
- package/dist/runtime/stealth-cookies.d.ts +24 -0
- package/dist/runtime/stealth-cookies.js +131 -0
- package/dist/runtime/stealth-owned-headers.d.ts +39 -0
- package/dist/runtime/stealth-owned-headers.js +57 -0
- package/dist/runtime/stealth-telemetry.d.ts +92 -0
- package/dist/runtime/stealth-telemetry.js +179 -0
- package/dist/runtime/stealth.d.ts +45 -6
- package/dist/runtime/stealth.js +1775 -320
- package/dist/runtime/stt-telemetry.d.ts +77 -0
- package/dist/runtime/stt-telemetry.js +176 -0
- package/dist/runtime/stt.js +18 -19
- package/dist/runtime/timeout.d.ts +5 -0
- package/dist/runtime/timeout.js +12 -0
- package/dist/runtime/trace-config.d.ts +12 -0
- package/dist/runtime/trace-config.js +62 -0
- package/dist/runtime/trace.d.ts +17 -0
- package/dist/runtime/trace.js +176 -25
- package/dist/runtime-boundary-lint.d.ts +137 -0
- package/dist/runtime-boundary-lint.js +590 -0
- package/dist/schema.d.ts +20 -0
- package/dist/schema.js +72 -2
- package/dist/serve.d.ts +1 -1
- package/dist/serve.js +1 -1
- package/dist/server/error-observability.d.ts +1 -0
- package/dist/server/error-observability.js +1 -0
- package/dist/server/error-stack-frames.d.ts +35 -0
- package/dist/server/error-stack-frames.js +219 -0
- package/dist/server/index.d.ts +21 -2
- package/dist/server/index.js +11 -2
- package/dist/server/runtime-diagnostics.d.ts +165 -0
- package/dist/server/runtime-diagnostics.js +360 -0
- package/dist/server/sdk-version.d.ts +3 -0
- package/dist/server/sdk-version.js +19 -0
- package/dist/server/self-test-input-tokens.d.ts +2 -1
- package/dist/server/self-test-input-tokens.js +18 -14
- package/dist/server/self-test-redaction.js +8 -33
- package/dist/server/self-test.d.ts +18 -3
- package/dist/server/self-test.js +139 -76
- package/dist/server/sensitive-values.d.ts +26 -0
- package/dist/server/sensitive-values.js +137 -0
- package/dist/server/serve-implementation.d.ts +285 -0
- package/dist/server/serve-implementation.js +3172 -0
- package/dist/server/serve.d.ts +1 -75
- package/dist/server/serve.js +1 -1170
- package/dist/server/state-backend-report.d.ts +70 -0
- package/dist/server/state-backend-report.js +113 -0
- package/dist/server/trace-output.d.ts +7 -0
- package/dist/server/trace-output.js +111 -0
- package/dist/server/types.d.ts +37 -5
- package/dist/server/types.js +34 -1
- package/dist/stateful/errors.d.ts +19 -0
- package/dist/stateful/errors.js +24 -0
- package/dist/stateful/http-provider-event-emitter.d.ts +40 -0
- package/dist/stateful/http-provider-event-emitter.js +237 -0
- package/dist/stateful/http-session-owner-registry.d.ts +44 -0
- package/dist/stateful/http-session-owner-registry.js +210 -0
- package/dist/stateful/index.d.ts +18 -0
- package/dist/stateful/index.js +18 -0
- package/dist/stateful/provider-event-delivery-failures.d.ts +32 -0
- package/dist/stateful/provider-event-delivery-failures.js +43 -0
- package/dist/stateful/provider-event-pipeline-metrics.d.ts +46 -0
- package/dist/stateful/provider-event-pipeline-metrics.js +48 -0
- package/dist/stateful/provider-event-pipeline.d.ts +50 -0
- package/dist/stateful/provider-event-pipeline.js +1 -0
- package/dist/stateful/provider-events.d.ts +101 -0
- package/dist/stateful/provider-events.js +289 -0
- package/dist/stateful/session-key.d.ts +15 -0
- package/dist/stateful/session-key.js +86 -0
- package/dist/stateful/stateful-provider-adapter-context.d.ts +5 -0
- package/dist/stateful/stateful-provider-adapter-context.js +42 -0
- package/dist/stateful/stateful-provider-adapter-metrics.d.ts +15 -0
- package/dist/stateful/stateful-provider-adapter-metrics.js +21 -0
- package/dist/stateful/stateful-provider-adapter.d.ts +98 -0
- package/dist/stateful/stateful-provider-adapter.js +287 -0
- package/dist/stateful/stateful-provider-observability.d.ts +62 -0
- package/dist/stateful/stateful-provider-observability.js +161 -0
- package/dist/stateful/stateful-provider-owner-forwarder.d.ts +41 -0
- package/dist/stateful/stateful-provider-owner-forwarder.js +237 -0
- package/dist/stateful/stateful-provider-runtime-context.d.ts +35 -0
- package/dist/stateful/stateful-provider-runtime-context.js +61 -0
- package/dist/stateful/stateful-provider-runtime-executor.d.ts +34 -0
- package/dist/stateful/stateful-provider-runtime-executor.js +52 -0
- package/dist/stateful/stateful-provider-session-routing.d.ts +67 -0
- package/dist/stateful/stateful-provider-session-routing.js +345 -0
- package/dist/stateful/stateful-provider-session-runtime.d.ts +98 -0
- package/dist/stateful/stateful-provider-session-runtime.js +245 -0
- package/dist/stateful-signing.d.ts +18 -0
- package/dist/stateful-signing.js +27 -0
- package/dist/stealth/profiles.d.ts +15 -4
- package/dist/stealth/profiles.js +169 -211
- package/dist/stream-evidence.d.ts +74 -0
- package/dist/stream-evidence.js +785 -0
- package/dist/stream.js +7 -1
- package/dist/testing/index.d.ts +2 -1
- package/dist/testing/index.js +2 -1
- package/dist/testing/run.d.ts +32 -2
- package/dist/testing/run.js +509 -25
- package/dist/trace-sanitization.d.ts +6 -0
- package/dist/trace-sanitization.js +68 -0
- package/dist/types.d.ts +899 -210
- package/dist/types.js +1 -0
- package/dist/typescript-module.d.ts +39 -0
- package/dist/typescript-module.js +72 -0
- package/package.json +52 -6
- package/src/auth-turn/index.ts +1 -1
- package/src/auth.ts +118 -0
- package/src/ceremonies/index.ts +189 -46
- package/src/cli/commands.ts +37 -0
- package/src/cli/create.ts +8 -2
- package/src/cli/deployment-intent.ts +364 -0
- package/src/cli/local-connection.ts +221 -0
- package/src/cli/migrate-deployment-intent.ts +1908 -0
- package/src/cli/migrate-operation-declaration.ts +3026 -0
- package/src/cli/migrate-operation-shape.ts +184 -0
- package/src/cli/migrate-provider-shape.ts +778 -0
- package/src/cli/resolver-runtime.ts +72 -0
- package/src/cli/templates/provider/.agents/skills/health-checks-and-fail-closed/SKILL.md.tpl +141 -23
- package/src/cli/templates/provider/Dockerfile.tpl +1 -1
- package/src/cli/templates/provider/README.md.tpl +41 -19
- package/src/cli/templates/provider/index.ts.tpl +6 -3
- package/src/cli/templates/provider/operations/ping.ts.tpl +4 -1
- package/src/cli/templates/provider/provider.json.tpl +6 -0
- package/src/config/loader.ts +774 -181
- package/src/contract-serialization.ts +5 -7
- package/src/contract-types.ts +12 -5
- package/src/contract.ts +24 -10
- package/src/declaration-validation.ts +376 -0
- package/src/define.ts +1105 -131
- package/src/dev.ts +13 -1
- package/src/engine.ts +390 -0
- package/src/error-observability.ts +64 -0
- package/src/error-resolution.ts +269 -0
- package/src/errors.ts +157 -0
- package/src/fixture-sanitization.ts +422 -0
- package/src/handle-meta.ts +143 -0
- package/src/handle.ts +694 -0
- package/src/health-scenario.ts +960 -0
- package/src/i18n/catalog.ts +23 -1
- package/src/i18n/error-messages.ts +255 -0
- package/src/i18n/index.ts +1 -0
- package/src/i18n/keys.ts +80 -6
- package/src/i18n/operation-locale-namespace.ts +10 -0
- package/src/index.ts +390 -23
- package/src/lint.ts +2975 -234
- package/src/native-address.ts +340 -0
- package/src/native-egress-policy.ts +358 -0
- package/src/observability.ts +51 -1
- package/src/provider.ts +207 -27
- package/src/runtime/auth-flow.ts +15 -0
- package/src/runtime/bounded-expiring-map.ts +67 -0
- package/src/runtime/browser-telemetry-binding.ts +92 -0
- package/src/runtime/browser-telemetry.ts +289 -0
- package/src/runtime/browser.ts +882 -99
- package/src/runtime/cache-telemetry.ts +247 -0
- package/src/runtime/cache.ts +258 -22
- package/src/runtime/capability-response.ts +53 -0
- package/src/runtime/capability-telemetry.ts +101 -0
- package/src/runtime/chrome149-header-order.ts +330 -0
- package/src/runtime/diagnostic-env-values.ts +56 -0
- package/src/runtime/diagnostic-env.ts +65 -0
- package/src/runtime/diagnostic-redactor.ts +668 -0
- package/src/runtime/egress-lease.ts +341 -0
- package/src/runtime/engine-mode.ts +233 -0
- package/src/runtime/env.ts +15 -1
- package/src/runtime/executor.ts +39 -32
- package/src/runtime/handle-wordlist.ts +266 -0
- package/src/runtime/handle.ts +1180 -0
- package/src/runtime/http-telemetry-binding.ts +162 -0
- package/src/runtime/http-telemetry-guard.ts +208 -0
- package/src/runtime/http-telemetry.ts +292 -0
- package/src/runtime/http.ts +896 -150
- package/src/runtime/insights.ts +2 -2
- package/src/runtime/instrumentation.ts +628 -28
- package/src/runtime/native-network-errors.ts +99 -0
- package/src/runtime/native-network.ts +1853 -0
- package/src/runtime/native-telemetry.ts +366 -0
- package/src/runtime/ocr-telemetry.ts +308 -0
- package/src/runtime/ocr.ts +564 -0
- package/src/runtime/otlp.ts +468 -21
- package/src/runtime/provider.ts +15 -0
- package/src/runtime/proxy-errors.ts +12 -4
- package/src/runtime/proxy-nodemaven.ts +222 -0
- package/src/runtime/proxy-retry-policy.ts +12 -1
- package/src/runtime/proxy-telemetry.ts +358 -103
- package/src/runtime/redirect-hop-headers.ts +71 -0
- package/src/runtime/redirects.ts +215 -0
- package/src/runtime/redis.ts +7 -2
- package/src/runtime/request-options.ts +728 -1
- package/src/runtime/request-telemetry.ts +375 -0
- package/src/runtime/resolver-config.ts +18 -0
- package/src/runtime/resolver-public.ts +44 -0
- package/src/runtime/resolver-runtime-options.ts +50 -0
- package/src/runtime/resolver-shared.ts +113 -0
- package/src/runtime/resolver-span-attributes.ts +139 -0
- package/src/runtime/resolver-telemetry.ts +362 -0
- package/src/runtime/resolver-usage.ts +99 -0
- package/src/runtime/resolver-vendors/bindings.ts +61 -0
- package/src/runtime/resolver-vendors/browser.ts +591 -0
- package/src/runtime/resolver-vendors/capsolver.ts +727 -0
- package/src/runtime/resolver-vendors/hosts.ts +81 -0
- package/src/runtime/resolver-vendors/hypersolutions.ts +480 -0
- package/src/runtime/resolver-vendors/twocaptcha.ts +555 -0
- package/src/runtime/resolver-vendors/types.ts +261 -0
- package/src/runtime/resolver.ts +1543 -0
- package/src/runtime/state-telemetry.ts +298 -0
- package/src/runtime/state.ts +435 -89
- package/src/runtime/stealth-akamai-sbsd.ts +207 -0
- package/src/runtime/stealth-cookies.ts +155 -0
- package/src/runtime/stealth-owned-headers.ts +67 -0
- package/src/runtime/stealth-telemetry.ts +309 -0
- package/src/runtime/stealth.ts +2275 -372
- package/src/runtime/stt-telemetry.ts +282 -0
- package/src/runtime/stt.ts +96 -91
- package/src/runtime/timeout.ts +18 -0
- package/src/runtime/trace-config.ts +78 -0
- package/src/runtime/trace.ts +257 -35
- package/src/runtime-boundary-lint.ts +707 -0
- package/src/schema.ts +80 -2
- package/src/serve.ts +6 -1
- package/src/server/error-observability.ts +1 -0
- package/src/server/error-stack-frames.ts +214 -0
- package/src/server/index.ts +184 -2
- package/src/server/runtime-diagnostics.ts +522 -0
- package/src/server/sdk-version.ts +22 -0
- package/src/server/self-test-input-tokens.ts +29 -14
- package/src/server/self-test-redaction.ts +10 -40
- package/src/server/self-test.ts +205 -89
- package/src/server/sensitive-values.ts +211 -0
- package/src/server/serve-implementation.ts +4596 -0
- package/src/server/serve.ts +1 -1685
- package/src/server/state-backend-report.ts +185 -0
- package/src/server/trace-output.ts +189 -0
- package/src/server/types.ts +34 -1
- package/src/stateful/README.md +146 -0
- package/src/stateful/errors.ts +35 -0
- package/src/stateful/http-provider-event-emitter.ts +314 -0
- package/src/stateful/http-session-owner-registry.ts +306 -0
- package/src/stateful/index.ts +18 -0
- package/src/stateful/provider-event-delivery-failures.ts +80 -0
- package/src/stateful/provider-event-pipeline-metrics.ts +95 -0
- package/src/stateful/provider-event-pipeline.ts +61 -0
- package/src/stateful/provider-events.ts +462 -0
- package/src/stateful/session-key.ts +111 -0
- package/src/stateful/stateful-provider-adapter-context.ts +59 -0
- package/src/stateful/stateful-provider-adapter-metrics.ts +48 -0
- package/src/stateful/stateful-provider-adapter.ts +562 -0
- package/src/stateful/stateful-provider-observability.ts +261 -0
- package/src/stateful/stateful-provider-owner-forwarder.ts +310 -0
- package/src/stateful/stateful-provider-runtime-context.ts +96 -0
- package/src/stateful/stateful-provider-runtime-executor.ts +96 -0
- package/src/stateful/stateful-provider-session-routing.ts +546 -0
- package/src/stateful/stateful-provider-session-runtime.ts +403 -0
- package/src/stateful-signing.ts +46 -0
- package/src/stealth/profiles.ts +212 -231
- package/src/stream-evidence.ts +988 -0
- package/src/stream.ts +8 -1
- package/src/testing/index.ts +10 -1
- package/src/testing/run.ts +685 -19
- package/src/trace-sanitization.ts +110 -0
- package/src/types.ts +1014 -273
- package/src/typescript-module.ts +100 -0
- package/dist/choice-token.d.ts +0 -24
- package/dist/choice-token.js +0 -74
- package/dist/runtime/choice.d.ts +0 -15
- package/dist/runtime/choice.js +0 -413
- package/src/choice-token.ts +0 -165
- package/src/runtime/choice.ts +0 -686
package/src/schema.ts
CHANGED
|
@@ -83,6 +83,8 @@ export function safeParseSchemaSync(
|
|
|
83
83
|
export const APIFUSE_SENSITIVE_META_KEY = "x-apifuse-sensitive";
|
|
84
84
|
export const APIFUSE_SENSITIVE_KIND_META_KEY = "x-apifuse-sensitive-kind";
|
|
85
85
|
export const APIFUSE_DESCRIPTION_KEY_META_KEY = "x-apifuse-description-key";
|
|
86
|
+
export const APIFUSE_CONTENT_TRUST_META_KEY = "x-apifuse-content-trust";
|
|
87
|
+
export const APIFUSE_CONTENT_PROVENANCE_META_KEY = "x-apifuse-content-provenance";
|
|
86
88
|
export const APIFUSE_REDACTION_MARKER = "<redacted>";
|
|
87
89
|
|
|
88
90
|
export type SensitivePathSegment = string | "*";
|
|
@@ -103,6 +105,8 @@ export type SensitiveFieldKind =
|
|
|
103
105
|
export interface SensitiveFieldOptions {
|
|
104
106
|
/**
|
|
105
107
|
* Mark this schema as sensitive. Defaults to true for the helper presets.
|
|
108
|
+
* An explicit `false` emits `x-apifuse-sensitive: false` (reviewed public
|
|
109
|
+
* data, never redacted) and drops any sensitivity kind.
|
|
106
110
|
*/
|
|
107
111
|
sensitive?: boolean;
|
|
108
112
|
/**
|
|
@@ -127,6 +131,21 @@ export function describeKey<TSchema extends ZodType>(
|
|
|
127
131
|
});
|
|
128
132
|
}
|
|
129
133
|
|
|
134
|
+
/**
|
|
135
|
+
* Mark an output field as externally authored text (listing bodies, reviews,
|
|
136
|
+
* posts) that the provider relays verbatim. Sets both content-trust JSON Schema
|
|
137
|
+
* meta keys on the field node so the platform can enforce the boundary when it
|
|
138
|
+
* assembles tool output; validation and the parsed value are unchanged.
|
|
139
|
+
*/
|
|
140
|
+
export function untrustedContent<TSchema extends ZodType>(schema: TSchema): TSchema {
|
|
141
|
+
const metadata = schema.meta() ?? {};
|
|
142
|
+
return schema.meta({
|
|
143
|
+
...metadata,
|
|
144
|
+
[APIFUSE_CONTENT_TRUST_META_KEY]: "untrusted",
|
|
145
|
+
[APIFUSE_CONTENT_PROVENANCE_META_KEY]: "external",
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
|
|
130
149
|
declare module "zod" {
|
|
131
150
|
interface ZodType {
|
|
132
151
|
describeKey(key: ProviderLocaleKey | string): this;
|
|
@@ -191,10 +210,27 @@ export function field<TSchema extends ZodType>(
|
|
|
191
210
|
? schema.describe(options.description)
|
|
192
211
|
: schema;
|
|
193
212
|
const metadata = described.meta() ?? {};
|
|
213
|
+
const isSensitive = options.sensitive ?? true;
|
|
214
|
+
// A public declaration only rewrites the meta of the node it receives;
|
|
215
|
+
// z.toJSONSchema folds that over the inner leaf, so `false` on a wrapper
|
|
216
|
+
// around a sensitive() leaf would publish `false` next to the leaf's kind
|
|
217
|
+
// while collectSensitivePaths() still redacts. Refuse the contradiction.
|
|
218
|
+
if (!isSensitive && wrapsSensitiveDeclaration(described)) {
|
|
219
|
+
throw new TypeError(
|
|
220
|
+
"publicField()/field({ sensitive: false }) wraps a sensitive() declaration; apply it to the leaf, before .optional(), .nullable(), .default(), .pipe(), z.lazy() or similar wrappers.",
|
|
221
|
+
);
|
|
222
|
+
}
|
|
223
|
+
// Zod merges meta with the parent chain, so an inherited kind can only be
|
|
224
|
+
// cleared by writing undefined over it (dropped from JSON Schema output).
|
|
225
|
+
const kind = isSensitive
|
|
226
|
+
? (options.kind ?? Reflect.get(metadata, APIFUSE_SENSITIVE_KIND_META_KEY))
|
|
227
|
+
: undefined;
|
|
194
228
|
return described.meta({
|
|
195
229
|
...metadata,
|
|
196
|
-
|
|
197
|
-
...(
|
|
230
|
+
[APIFUSE_SENSITIVE_META_KEY]: isSensitive,
|
|
231
|
+
...(kind !== undefined || APIFUSE_SENSITIVE_KIND_META_KEY in metadata
|
|
232
|
+
? { [APIFUSE_SENSITIVE_KIND_META_KEY]: kind }
|
|
233
|
+
: {}),
|
|
198
234
|
});
|
|
199
235
|
}
|
|
200
236
|
|
|
@@ -205,6 +241,18 @@ export function sensitive<TSchema extends ZodType>(
|
|
|
205
241
|
return field(schema, { sensitive: true, kind });
|
|
206
242
|
}
|
|
207
243
|
|
|
244
|
+
/**
|
|
245
|
+
* Declare a field as reviewed public data (business, facility, product, or
|
|
246
|
+
* place names and contacts) so a key-based privacy classifier hit counts as
|
|
247
|
+
* declared instead of undeclared. Emits `x-apifuse-sensitive: false` on the
|
|
248
|
+
* JSON Schema leaf; nothing is redacted. Use `sensitive()` for anything that
|
|
249
|
+
* identifies a person. Apply it to the leaf, before `.optional()` or
|
|
250
|
+
* `.nullable()`; wrapping a `sensitive()` declaration throws at definition time.
|
|
251
|
+
*/
|
|
252
|
+
export function publicField<TSchema extends ZodType>(schema: TSchema): TSchema {
|
|
253
|
+
return field(schema, { sensitive: false });
|
|
254
|
+
}
|
|
255
|
+
|
|
208
256
|
function sensitiveString(
|
|
209
257
|
kind: SensitiveFieldKind,
|
|
210
258
|
description: string,
|
|
@@ -365,6 +413,36 @@ function readZodMetadata(schema: unknown): object | undefined {
|
|
|
365
413
|
return metadata && typeof metadata === "object" ? metadata : undefined;
|
|
366
414
|
}
|
|
367
415
|
|
|
416
|
+
// Same-path wrappers (optional, nullable, default, catch, readonly, pipe,
|
|
417
|
+
// lazy, ...) share the JSON Schema leaf with the schema they wrap.
|
|
418
|
+
function wrapsSensitiveDeclaration(schema: unknown, seen = new Set<unknown>()): boolean {
|
|
419
|
+
const def = readZodDef(schema);
|
|
420
|
+
if (!def || seen.has(schema)) return false;
|
|
421
|
+
seen.add(schema);
|
|
422
|
+
return sameLeafChildren(def).some(
|
|
423
|
+
(child) => isSensitiveSchema(child) || wrapsSensitiveDeclaration(child, seen),
|
|
424
|
+
);
|
|
425
|
+
}
|
|
426
|
+
|
|
427
|
+
function sameLeafChildren(def: object): unknown[] {
|
|
428
|
+
switch (Reflect.get(def, "type")) {
|
|
429
|
+
case "pipe":
|
|
430
|
+
return [Reflect.get(def, "in"), Reflect.get(def, "out")];
|
|
431
|
+
case "lazy": {
|
|
432
|
+
// A forward-reference getter can throw before its target is
|
|
433
|
+
// initialised; treat that as no declaration rather than failing.
|
|
434
|
+
const getter = Reflect.get(def, "getter");
|
|
435
|
+
try {
|
|
436
|
+
return typeof getter === "function" ? [getter()] : [];
|
|
437
|
+
} catch {
|
|
438
|
+
return [];
|
|
439
|
+
}
|
|
440
|
+
}
|
|
441
|
+
default:
|
|
442
|
+
return [Reflect.get(def, "innerType")];
|
|
443
|
+
}
|
|
444
|
+
}
|
|
445
|
+
|
|
368
446
|
function readZodDef(schema: unknown): object | undefined {
|
|
369
447
|
if (!schema || typeof schema !== "object") return undefined;
|
|
370
448
|
const def = Reflect.get(schema, "def") ?? Reflect.get(schema, "_def");
|
package/src/serve.ts
CHANGED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { safeProviderErrorObservability } from "../error-observability.js";
|
|
@@ -0,0 +1,214 @@
|
|
|
1
|
+
import { type DiagnosticRedactor, redactDiagnosticText } from "../runtime/diagnostic-redactor.js";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Bounded, whitelist-shaped stack frames for masked (>=500) provider failures.
|
|
5
|
+
*
|
|
6
|
+
* `sanitizeDiagnosticText` is a blacklist scrubber for free text: a V8/Bun
|
|
7
|
+
* frame such as `at inner (/srv/app/probe.ts:3:30)` comes out as
|
|
8
|
+
* `at inner ([REDACTED])`, and even a bare `serve-implementation.ts:2039:12`
|
|
9
|
+
* trips the opaque-token heuristics. Stack frames therefore never go through
|
|
10
|
+
* it. Instead each frame is parsed against a strict grammar and re-emitted
|
|
11
|
+
* from its parts only: an optional `async`/`new` marker, the function name
|
|
12
|
+
* (identifier characters only), the file *basename* (never a filesystem
|
|
13
|
+
* directory, URL, or drive letter) and the numeric line:column. The sole
|
|
14
|
+
* exception is an engine-internal location (`native`, or a `node:` module id
|
|
15
|
+
* of identifier-shaped segments), which is kept verbatim because it names no
|
|
16
|
+
* deployment path. Frames that do not fit the grammar (eval frames, frames
|
|
17
|
+
* without a location, oversized lines) are dropped rather than passed
|
|
18
|
+
* through.
|
|
19
|
+
*/
|
|
20
|
+
export const MAX_PROVIDER_ERROR_STACK_FRAMES = 5;
|
|
21
|
+
const MAX_STACK_SCAN_CHARS = 16 * 1024;
|
|
22
|
+
const MAX_STACK_SCAN_LINES = 64;
|
|
23
|
+
const MAX_STACK_LINE_CHARS = 1024;
|
|
24
|
+
|
|
25
|
+
const FRAME_LINE = /^\s+at\s+(\S.*)$/;
|
|
26
|
+
const FRAME_MODIFIER = /^(async|new)\s+(.*)$/;
|
|
27
|
+
const FRAME_FUNCTION_NAME = /^[\w$.<>[\] #]{1,80}$/;
|
|
28
|
+
const FRAME_LOCATION = /^(.*):(\d{1,7}):(\d{1,7})$/;
|
|
29
|
+
const MAX_NODE_MODULE_ID_CHARS = 128;
|
|
30
|
+
// Engine-internal module ids only: `node:` plus `/`-separated identifier-shaped
|
|
31
|
+
// segments (`node:async_hooks`, `node:internal/process/task_queues`). Every
|
|
32
|
+
// segment must start with a letter or `_`, so `..` traversal and dotfile
|
|
33
|
+
// segments cannot ride through this branch.
|
|
34
|
+
const FRAME_NODE_MODULE = /^node:[A-Za-z_][\w.-]{0,40}(?:\/[A-Za-z_][\w.-]{0,40}){0,7}$/;
|
|
35
|
+
const FRAME_BASENAME = /^[\w.$-]{1,120}$/;
|
|
36
|
+
// A basename of dots only (`.`, `..`, `...`) names no file.
|
|
37
|
+
const FRAME_BASENAME_HAS_NAME = /[^.]/;
|
|
38
|
+
|
|
39
|
+
function parseFunctionName(raw: string): { modifier?: string; name?: string } | undefined {
|
|
40
|
+
let rest = raw.trim();
|
|
41
|
+
let modifier: string | undefined;
|
|
42
|
+
const modified = FRAME_MODIFIER.exec(rest);
|
|
43
|
+
if (modified) {
|
|
44
|
+
modifier = modified[1];
|
|
45
|
+
rest = modified[2].trim();
|
|
46
|
+
}
|
|
47
|
+
if (rest.length === 0) return { modifier };
|
|
48
|
+
if (!FRAME_FUNCTION_NAME.test(rest)) return undefined;
|
|
49
|
+
return { modifier, name: rest };
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
function parseLocation(raw: string): string | undefined {
|
|
53
|
+
if (/[\s()]/.test(raw)) return undefined;
|
|
54
|
+
const located = FRAME_LOCATION.exec(raw);
|
|
55
|
+
if (!located) return undefined;
|
|
56
|
+
const [, path, line, column] = located;
|
|
57
|
+
let file: string;
|
|
58
|
+
if (
|
|
59
|
+
path === "native" ||
|
|
60
|
+
(path.length <= MAX_NODE_MODULE_ID_CHARS && FRAME_NODE_MODULE.test(path))
|
|
61
|
+
) {
|
|
62
|
+
// Not filesystem paths: engine-internal module ids carry no deployment
|
|
63
|
+
// information. This is the one branch that keeps a `/`, and the grammar
|
|
64
|
+
// above bounds it to identifier segments.
|
|
65
|
+
file = path;
|
|
66
|
+
} else {
|
|
67
|
+
const separator = Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"));
|
|
68
|
+
const basename = separator >= 0 ? path.slice(separator + 1) : path;
|
|
69
|
+
if (!FRAME_BASENAME.test(basename)) return undefined;
|
|
70
|
+
// `.` and `..` pass the basename character class but name no file: they
|
|
71
|
+
// are the traversal tokens the grammar exists to exclude, so a path such
|
|
72
|
+
// as `/srv/app/..:1:1` must not be emitted as `..:1:1`.
|
|
73
|
+
if (!FRAME_BASENAME_HAS_NAME.test(basename)) return undefined;
|
|
74
|
+
file = basename;
|
|
75
|
+
}
|
|
76
|
+
return `${file}:${line}:${column}`;
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/** Parses one `at ...` line into `[async |new ][fn ](basename:line:col)`, or undefined. */
|
|
80
|
+
export function parseProviderErrorStackFrame(line: string): string | undefined {
|
|
81
|
+
if (line.length > MAX_STACK_LINE_CHARS) return undefined;
|
|
82
|
+
const frame = FRAME_LINE.exec(line);
|
|
83
|
+
if (!frame) return undefined;
|
|
84
|
+
const rest = frame[1].trimEnd();
|
|
85
|
+
|
|
86
|
+
let functionPart: string;
|
|
87
|
+
let locationPart: string;
|
|
88
|
+
if (rest.endsWith(")")) {
|
|
89
|
+
const open = rest.lastIndexOf("(");
|
|
90
|
+
if (open < 0) return undefined;
|
|
91
|
+
functionPart = rest.slice(0, open);
|
|
92
|
+
locationPart = rest.slice(open + 1, -1);
|
|
93
|
+
} else {
|
|
94
|
+
// A frame with no parenthesized location still carries its `async`/`new`
|
|
95
|
+
// modifier inline (`at async file:///app/index.mjs:12:3`, emitted by V8
|
|
96
|
+
// for an anonymous async frame such as a module's top-level await).
|
|
97
|
+
// Split it off here: `parseLocation` rejects anything containing
|
|
98
|
+
// whitespace, so leaving it attached dropped the whole frame.
|
|
99
|
+
const modified = FRAME_MODIFIER.exec(rest);
|
|
100
|
+
functionPart = modified ? modified[1] : "";
|
|
101
|
+
locationPart = modified ? modified[2].trim() : rest;
|
|
102
|
+
}
|
|
103
|
+
// Eval frames nest parentheses inside the function part; never pass them through.
|
|
104
|
+
if (/[()]/.test(functionPart)) return undefined;
|
|
105
|
+
|
|
106
|
+
const location = parseLocation(locationPart);
|
|
107
|
+
if (!location) return undefined;
|
|
108
|
+
const fn = parseFunctionName(functionPart);
|
|
109
|
+
if (!fn) return undefined;
|
|
110
|
+
|
|
111
|
+
const prefix = [fn.modifier, fn.name].filter((part) => part !== undefined).join(" ");
|
|
112
|
+
return prefix.length > 0 ? `${prefix} (${location})` : `(${location})`;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
// V8 (Node >= 21) installs `stack` as a shared native accessor pair on every
|
|
116
|
+
// Error instance; JSC (Bun) installs a data property. Capture the engine's own
|
|
117
|
+
// accessor once so a provider-defined accessor (a different function object) is
|
|
118
|
+
// still rejected while the engine's is trusted. The engine accessor itself can
|
|
119
|
+
// call a process-global `Error.prepareStackTrace` hook, a process-wide trust
|
|
120
|
+
// boundary this module cannot narrow: a provider that installs one already
|
|
121
|
+
// reshapes `stack` for every consumer, and the whitelist grammar below still
|
|
122
|
+
// bounds what the resulting text can carry.
|
|
123
|
+
const NATIVE_STACK_GETTER = Object.getOwnPropertyDescriptor(new Error(), "stack")?.get;
|
|
124
|
+
|
|
125
|
+
function readOwnStackString(error: unknown): string | undefined {
|
|
126
|
+
// Only engine-captured stacks: a thrown plain object is provider-authored text.
|
|
127
|
+
if (!(error instanceof Error)) return undefined;
|
|
128
|
+
try {
|
|
129
|
+
const descriptor = Object.getOwnPropertyDescriptor(error, "stack");
|
|
130
|
+
if (descriptor === undefined) return undefined;
|
|
131
|
+
let stack: unknown;
|
|
132
|
+
if (Object.hasOwn(descriptor, "value")) {
|
|
133
|
+
stack = descriptor.value;
|
|
134
|
+
} else if (
|
|
135
|
+
typeof NATIVE_STACK_GETTER === "function" &&
|
|
136
|
+
descriptor.get === NATIVE_STACK_GETTER
|
|
137
|
+
) {
|
|
138
|
+
stack = Reflect.apply(NATIVE_STACK_GETTER, error, []);
|
|
139
|
+
} else {
|
|
140
|
+
// A provider-defined accessor must never run inside the logger.
|
|
141
|
+
return undefined;
|
|
142
|
+
}
|
|
143
|
+
return typeof stack === "string" ? stack : undefined;
|
|
144
|
+
} catch {
|
|
145
|
+
return undefined;
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
// Header shapes ahead of the frame block: `Name: message` (V8/JSC),
|
|
150
|
+
// `Name [CODE]: message` (node:assert), `Name` (empty message), or the bare
|
|
151
|
+
// message (Playwright rewrites `stack` as message-first). The message itself
|
|
152
|
+
// is matched verbatim, so anything before it must be a short name-like prefix.
|
|
153
|
+
const HEADER_NAME_PREFIX = /^(?:[\w$][\w$ .[\]-]{0,119}: )?$/;
|
|
154
|
+
const HEADER_NAME_ONLY = /^[\w$][\w$ .[\]-]{0,119}$/;
|
|
155
|
+
|
|
156
|
+
/**
|
|
157
|
+
* The frame block that follows the header, or undefined when the header does
|
|
158
|
+
* not embed the current `message` followed by a newline. Fail closed there: if
|
|
159
|
+
* `message` was mutated after the stack was formatted, the original message
|
|
160
|
+
* lines are still in the string and could be parsed as forged frames. (A
|
|
161
|
+
* mutation that truncates exactly at one of the message's own newlines is
|
|
162
|
+
* indistinguishable from the string alone; the whitelist grammar and the
|
|
163
|
+
* redactor still bound what such a line can carry.)
|
|
164
|
+
*/
|
|
165
|
+
function frameBlock(stack: string, error: object): string | undefined {
|
|
166
|
+
let message: unknown;
|
|
167
|
+
try {
|
|
168
|
+
message = (error as { message?: unknown }).message;
|
|
169
|
+
} catch {
|
|
170
|
+
return undefined;
|
|
171
|
+
}
|
|
172
|
+
if (typeof message !== "string") return undefined;
|
|
173
|
+
if (message.length === 0) {
|
|
174
|
+
const newline = stack.indexOf("\n");
|
|
175
|
+
if (newline < 0 || !HEADER_NAME_ONLY.test(stack.slice(0, newline))) return undefined;
|
|
176
|
+
return stack.slice(newline + 1);
|
|
177
|
+
}
|
|
178
|
+
const at = stack.indexOf(`${message}\n`);
|
|
179
|
+
if (at < 0 || !HEADER_NAME_PREFIX.test(stack.slice(0, at))) return undefined;
|
|
180
|
+
return stack.slice(at + message.length + 1);
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/**
|
|
184
|
+
* Up to {@link MAX_PROVIDER_ERROR_STACK_FRAMES} whitelist-shaped frames from
|
|
185
|
+
* `error.stack`, or undefined when nothing parses. For an engine-formatted
|
|
186
|
+
* stack the header (which embeds the current `message`) is located and
|
|
187
|
+
* stripped first, so a provider-controlled *message* containing newlines
|
|
188
|
+
* cannot inject frame-shaped text (no header match, no frames). A provider
|
|
189
|
+
* that overwrites `stack` or `name` outright can still put grammar-shaped
|
|
190
|
+
* frames in the record: the field is a diagnostic hint, not an attested
|
|
191
|
+
* location, and the whitelist plus the redactor bound what it can carry.
|
|
192
|
+
* Each emitted frame still passes
|
|
193
|
+
* through the request redactor so a registered secret that happens to appear
|
|
194
|
+
* in a function or file name is masked (fail-closed to `[REDACTION_FAILED]`).
|
|
195
|
+
*/
|
|
196
|
+
export function providerErrorStackFrames(
|
|
197
|
+
error: unknown,
|
|
198
|
+
redact?: DiagnosticRedactor,
|
|
199
|
+
): string[] | undefined {
|
|
200
|
+
const stack = readOwnStackString(error);
|
|
201
|
+
if (stack === undefined) return undefined;
|
|
202
|
+
|
|
203
|
+
const body = frameBlock(stack, error as object);
|
|
204
|
+
if (body === undefined) return undefined;
|
|
205
|
+
|
|
206
|
+
const frames: string[] = [];
|
|
207
|
+
const lines = body.slice(0, MAX_STACK_SCAN_CHARS).split("\n", MAX_STACK_SCAN_LINES);
|
|
208
|
+
for (const line of lines) {
|
|
209
|
+
if (frames.length >= MAX_PROVIDER_ERROR_STACK_FRAMES) break;
|
|
210
|
+
const frame = parseProviderErrorStackFrame(line);
|
|
211
|
+
if (frame !== undefined) frames.push(redactDiagnosticText(frame, redact));
|
|
212
|
+
}
|
|
213
|
+
return frames.length > 0 ? frames : undefined;
|
|
214
|
+
}
|
package/src/server/index.ts
CHANGED
|
@@ -1,4 +1,125 @@
|
|
|
1
|
-
export
|
|
1
|
+
export type { ProviderLocaleCatalogMap } from "../i18n/catalog.js";
|
|
2
|
+
export type { ProviderLocale, ProviderLocaleCatalog } from "../i18n/keys.js";
|
|
3
|
+
export type {
|
|
4
|
+
ProxyCacheStatus,
|
|
5
|
+
ProxyProtocol,
|
|
6
|
+
ProxyUserAgentSource,
|
|
7
|
+
ProxyVendorName,
|
|
8
|
+
SmartproxyAllocatorBodyClass,
|
|
9
|
+
} from "../config/loader.js";
|
|
10
|
+
export type {
|
|
11
|
+
ProxyTelemetryHeaderPayload,
|
|
12
|
+
ProxyHash,
|
|
13
|
+
ProxyTelemetryLogPayload,
|
|
14
|
+
ProxyTelemetryResolvedPayload,
|
|
15
|
+
ProxyTelemetryUnresolvedPayload,
|
|
16
|
+
} from "../runtime/proxy-telemetry.js";
|
|
17
|
+
export {
|
|
18
|
+
RequestTelemetry,
|
|
19
|
+
closedEnum,
|
|
20
|
+
type ClosedEnum,
|
|
21
|
+
type GatewayIngestible,
|
|
22
|
+
type RequestTelemetryLogPayload,
|
|
23
|
+
type SpanIndex,
|
|
24
|
+
type TelemetryContributor,
|
|
25
|
+
type TelemetryKey,
|
|
26
|
+
type TenantNeutral,
|
|
27
|
+
} from "../runtime/request-telemetry.js";
|
|
28
|
+
export {
|
|
29
|
+
OcrTelemetryCollector,
|
|
30
|
+
bindOcrTelemetry,
|
|
31
|
+
type OcrTelemetryBackend,
|
|
32
|
+
type OcrTelemetryEngine,
|
|
33
|
+
type OcrTelemetryErrorCode,
|
|
34
|
+
type OcrTelemetryEvent,
|
|
35
|
+
type OcrTelemetryModel,
|
|
36
|
+
type OcrTelemetryFinishReason,
|
|
37
|
+
type OcrTelemetryHeaderPayload,
|
|
38
|
+
type OcrTelemetryLogPayload,
|
|
39
|
+
type OcrTelemetrySink,
|
|
40
|
+
} from "../runtime/ocr-telemetry.js";
|
|
41
|
+
export {
|
|
42
|
+
ResolverTelemetryCollector,
|
|
43
|
+
type ResolverAttemptSample,
|
|
44
|
+
type ResolverCacheReadTelemetryEvent,
|
|
45
|
+
type ResolverCacheWriteTelemetryEvent,
|
|
46
|
+
type ResolverFailoverTelemetryEvent,
|
|
47
|
+
type ResolverIdentityTelemetryEvent,
|
|
48
|
+
type ResolverOutcomeTelemetryEvent,
|
|
49
|
+
type ResolverTelemetryAttemptOutcome,
|
|
50
|
+
type ResolverTelemetryCacheStatus,
|
|
51
|
+
type ResolverTelemetryCacheWriteReason,
|
|
52
|
+
type ResolverTelemetryErrorClass,
|
|
53
|
+
type ResolverTelemetryHeaderPayload,
|
|
54
|
+
type ResolverTelemetryIdentitySource,
|
|
55
|
+
type ResolverTelemetryLogPayload,
|
|
56
|
+
type ResolverTelemetryOutcome,
|
|
57
|
+
type ResolverTelemetryPhase,
|
|
58
|
+
type ResolverTelemetrySink,
|
|
59
|
+
type ResolverVendorAttemptTelemetryEvent,
|
|
60
|
+
} from "../runtime/resolver-telemetry.js";
|
|
61
|
+
export {
|
|
62
|
+
StealthTelemetryCollector,
|
|
63
|
+
type StealthTelemetryAttemptEvent,
|
|
64
|
+
type StealthTelemetryAttemptKind,
|
|
65
|
+
type StealthTelemetryAttemptSample,
|
|
66
|
+
type StealthTelemetryDiagnostics,
|
|
67
|
+
type StealthTelemetryErrorCode,
|
|
68
|
+
type StealthTelemetryHeaderPayload,
|
|
69
|
+
type StealthTelemetryLogPayload,
|
|
70
|
+
type StealthTelemetryRequestClass,
|
|
71
|
+
type StealthTelemetrySbsdEvent,
|
|
72
|
+
type StealthTelemetrySbsdOutcome,
|
|
73
|
+
type StealthTelemetrySink,
|
|
74
|
+
} from "../runtime/stealth-telemetry.js";
|
|
75
|
+
export {
|
|
76
|
+
SttTelemetryCollector,
|
|
77
|
+
bindSttTelemetry,
|
|
78
|
+
type SttTelemetryBackend,
|
|
79
|
+
type SttTelemetryEngine,
|
|
80
|
+
type SttTelemetryErrorCode,
|
|
81
|
+
type SttTelemetryEvent,
|
|
82
|
+
type SttTelemetryModel,
|
|
83
|
+
type SttTelemetryHeaderPayload,
|
|
84
|
+
type SttTelemetryLogPayload,
|
|
85
|
+
type SttTelemetrySink,
|
|
86
|
+
} from "../runtime/stt-telemetry.js";
|
|
87
|
+
|
|
88
|
+
export {
|
|
89
|
+
BrowserTelemetryCollector,
|
|
90
|
+
type BrowserTelemetryErrorCode,
|
|
91
|
+
type BrowserTelemetryHeaderPayload,
|
|
92
|
+
type BrowserTelemetryLogPayload,
|
|
93
|
+
type BrowserTelemetryPoolAcquireOutcome,
|
|
94
|
+
type BrowserTelemetrySink,
|
|
95
|
+
type BrowserTelemetrySampleName,
|
|
96
|
+
type BrowserTelemetryEngine,
|
|
97
|
+
} from "../runtime/browser-telemetry.js";
|
|
98
|
+
export type { ResolverVendorUnavailableReason } from "../runtime/resolver-vendors/types.js";
|
|
99
|
+
export type { Span, TraceContext } from "../runtime/trace.js";
|
|
100
|
+
export type { StealthBrowser, StealthOS, StealthProfileDescriptor } from "../types.js";
|
|
101
|
+
export {
|
|
102
|
+
createServerApp,
|
|
103
|
+
createServerAppAsync,
|
|
104
|
+
ERROR_OBSERVABILITY_HEADER,
|
|
105
|
+
type ErrorObservabilityDetails,
|
|
106
|
+
type ProviderServerCloseOptions,
|
|
107
|
+
type ProviderServerHandle,
|
|
108
|
+
type ProviderErrorCauseFrame,
|
|
109
|
+
type ProviderServerLogEvent,
|
|
110
|
+
type ProviderServerLogger,
|
|
111
|
+
type ProviderServerOperationExecutor,
|
|
112
|
+
type ProviderServerOperationExecutorInput,
|
|
113
|
+
type ProviderServerOptions,
|
|
114
|
+
type ProviderServerStatefulForwardEnvelope,
|
|
115
|
+
type ServeOptions,
|
|
116
|
+
serve,
|
|
117
|
+
} from "./serve.js";
|
|
118
|
+
export type {
|
|
119
|
+
ProviderStateBackendLogEvent,
|
|
120
|
+
ProviderStoreBackendReport,
|
|
121
|
+
} from "./state-backend-report.js";
|
|
122
|
+
export type { ProviderErrorObservability } from "../errors.js";
|
|
2
123
|
export {
|
|
3
124
|
computeSelfTestPlanDigest,
|
|
4
125
|
createSelfTestApp,
|
|
@@ -23,13 +144,44 @@ export {
|
|
|
23
144
|
SelfTestRequestSchema,
|
|
24
145
|
type SelfTestResponse,
|
|
25
146
|
} from "./self-test.js";
|
|
26
|
-
export {
|
|
147
|
+
export {
|
|
148
|
+
type InputDateTokenCalendar,
|
|
149
|
+
resolveHealthCheckInputDateTokens,
|
|
150
|
+
} from "./self-test-input-tokens.js";
|
|
27
151
|
export {
|
|
28
152
|
collectSelfTestSensitiveValues,
|
|
29
153
|
redactSelfTestText,
|
|
30
154
|
SELF_TEST_MAX_TEXT_LENGTH,
|
|
31
155
|
SELF_TEST_REDACTED_PLACEHOLDER,
|
|
32
156
|
} from "./self-test-redaction.js";
|
|
157
|
+
export {
|
|
158
|
+
type CollectRuntimeDiagnosticsInput,
|
|
159
|
+
collectRuntimeDiagnostics,
|
|
160
|
+
DEFAULT_PROCFS_SELF_ROOT,
|
|
161
|
+
DEFAULT_RUNTIME_DIAGNOSTICS_WINDOW_MS,
|
|
162
|
+
MAX_RUNTIME_DIAGNOSTICS_WINDOW_MS,
|
|
163
|
+
MIN_RUNTIME_DIAGNOSTICS_WINDOW_MS,
|
|
164
|
+
normalizeRuntimeDiagnosticsWindowMs,
|
|
165
|
+
PROCFS_CLOCK_TICKS_PER_SECOND,
|
|
166
|
+
resolveRuntimeDiagnosticsWindowMs,
|
|
167
|
+
RUNTIME_DIAGNOSTICS_ROUTE,
|
|
168
|
+
RUNTIME_DIAGNOSTICS_SCHEMA_VERSION,
|
|
169
|
+
RUNTIME_DIAGNOSTICS_WINDOW_QUERY,
|
|
170
|
+
type RuntimeDiagnosticsActiveResources,
|
|
171
|
+
type RuntimeDiagnosticsClock,
|
|
172
|
+
type RuntimeDiagnosticsCpu,
|
|
173
|
+
type RuntimeDiagnosticsCpuTotals,
|
|
174
|
+
type RuntimeDiagnosticsEventLoop,
|
|
175
|
+
type RuntimeDiagnosticsEventLoopUtilization,
|
|
176
|
+
type RuntimeDiagnosticsFdKind,
|
|
177
|
+
type RuntimeDiagnosticsMemory,
|
|
178
|
+
type RuntimeDiagnosticsProcfs,
|
|
179
|
+
type RuntimeDiagnosticsReport,
|
|
180
|
+
type RuntimeDiagnosticsThread,
|
|
181
|
+
type RuntimeDiagnosticsThreadContextSwitches,
|
|
182
|
+
type RuntimeDiagnosticsThreadCpuTicks,
|
|
183
|
+
type RuntimeDiagnosticsThreadWindow,
|
|
184
|
+
} from "./runtime-diagnostics.js";
|
|
33
185
|
export {
|
|
34
186
|
DEFAULT_SELF_TEST_PORT,
|
|
35
187
|
deriveSelfTestToken,
|
|
@@ -61,3 +213,33 @@ export {
|
|
|
61
213
|
OperationRequestSchema,
|
|
62
214
|
OperationSuccessResponseSchema,
|
|
63
215
|
} from "./types.js";
|
|
216
|
+
|
|
217
|
+
export {
|
|
218
|
+
HttpTelemetryCollector,
|
|
219
|
+
type HttpTelemetrySink,
|
|
220
|
+
type HttpTelemetryRequestSink,
|
|
221
|
+
type HttpAttemptTelemetryEvent,
|
|
222
|
+
type HttpAttemptSample,
|
|
223
|
+
type HttpTelemetryErrorCode,
|
|
224
|
+
type HttpTelemetryRetryPayload,
|
|
225
|
+
type HttpTelemetryLogPayload,
|
|
226
|
+
type HttpTelemetryHeaderPayload,
|
|
227
|
+
} from "../runtime/http-telemetry.js";
|
|
228
|
+
export type { HttpRetrySummary } from "../types.js";
|
|
229
|
+
|
|
230
|
+
export {
|
|
231
|
+
NativeTelemetryCollector,
|
|
232
|
+
type NativeAttemptSample,
|
|
233
|
+
type NativeConnectTelemetryEvent,
|
|
234
|
+
type NativeLifecycleTelemetryEvent,
|
|
235
|
+
type NativeTelemetryDiagnostics,
|
|
236
|
+
type NativeTelemetryErrorCode,
|
|
237
|
+
type NativeTelemetryHeaderPayload,
|
|
238
|
+
type NativeTelemetryKind,
|
|
239
|
+
type NativeTelemetryLifecycleKind,
|
|
240
|
+
type NativeTelemetryLogPayload,
|
|
241
|
+
type NativeTelemetryOutcome,
|
|
242
|
+
type NativeTelemetrySink,
|
|
243
|
+
type NativeTelemetryVendorSkipReason,
|
|
244
|
+
type NativeVendorSkipTelemetryEvent,
|
|
245
|
+
} from "../runtime/native-telemetry.js";
|