@apifuse/provider-sdk 2.2.0-beta.5 → 2.2.0-beta.51
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 +537 -33
- package/CHANGELOG.md +205 -1
- package/README.md +83 -22
- package/SUBMISSION.md +2 -2
- package/bin/apifuse-check.ts +165 -11
- package/bin/apifuse-dev.ts +57 -13
- package/bin/apifuse-migrate-operation-declaration.ts +55 -0
- package/bin/apifuse-migrate-shape.ts +202 -0
- package/bin/apifuse-pack-check.ts +22 -2
- package/bin/apifuse-pack-smoke.ts +57 -2
- package/bin/apifuse-pack-types.ts +357 -38
- package/bin/apifuse-perf.ts +14 -13
- package/bin/apifuse-record.ts +709 -72
- package/bin/apifuse-submit-check.ts +2344 -324
- package/bin/apifuse-sync-assets.ts +117 -0
- 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 +27 -0
- package/dist/cli/create.d.ts +4 -1
- package/dist/cli/create.js +42 -37
- package/dist/cli/migrate-operation-declaration.d.ts +59 -0
- package/dist/cli/migrate-operation-declaration.js +1249 -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 +52 -0
- package/dist/cli/migrate-provider-shape.js +578 -0
- package/dist/cli/prompt-assets.d.ts +80 -0
- package/dist/cli/prompt-assets.js +743 -0
- package/dist/cli/templates/provider/AGENTS.md.tpl +17 -8
- package/dist/cli/templates/provider/Dockerfile.tpl +1 -1
- package/dist/cli/templates/provider/README.md.tpl +5 -5
- 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 +179 -16
- package/dist/config/loader.js +435 -127
- 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 +33 -0
- package/dist/declaration-validation.js +266 -0
- package/dist/define.d.ts +66 -29
- package/dist/define.js +778 -69
- package/dist/dev.d.ts +3 -0
- package/dist/dev.js +1 -1
- package/dist/engine.d.ts +78 -0
- package/dist/engine.js +133 -0
- package/dist/error-observability.d.ts +7 -0
- package/dist/error-observability.js +61 -0
- package/dist/error-resolution.d.ts +4 -0
- package/dist/error-resolution.js +122 -0
- package/dist/errors.d.ts +33 -0
- package/dist/errors.js +40 -0
- package/dist/fixture-sanitization.d.ts +28 -0
- package/dist/fixture-sanitization.js +227 -0
- package/dist/health-scenario.d.ts +1842 -0
- package/dist/health-scenario.js +624 -0
- package/dist/index.d.ts +21 -10
- package/dist/index.js +12 -7
- package/dist/lint.d.ts +23 -11
- package/dist/lint.js +572 -69
- 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 +10 -2
- package/dist/provider.js +4 -1
- package/dist/runtime/auth-flow.d.ts +5 -1
- package/dist/runtime/auth-flow.js +6 -0
- package/dist/runtime/browser.d.ts +1 -0
- package/dist/runtime/browser.js +492 -49
- package/dist/runtime/cache.d.ts +1 -0
- package/dist/runtime/cache.js +169 -15
- package/dist/runtime/choice-wordlist.d.ts +9 -0
- package/dist/runtime/choice-wordlist.js +138 -0
- package/dist/runtime/choice.d.ts +13 -1
- package/dist/runtime/choice.js +490 -102
- package/dist/runtime/chrome149-header-order.d.ts +58 -0
- package/dist/runtime/chrome149-header-order.js +289 -0
- package/dist/runtime/env.js +12 -0
- package/dist/runtime/executor.d.ts +3 -2
- package/dist/runtime/executor.js +26 -25
- package/dist/runtime/http.d.ts +1 -0
- package/dist/runtime/http.js +515 -53
- package/dist/runtime/insights.js +2 -2
- package/dist/runtime/instrumentation.d.ts +2 -2
- package/dist/runtime/instrumentation.js +366 -8
- 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 +96 -0
- package/dist/runtime/native-network.js +1232 -0
- package/dist/runtime/ocr.d.ts +29 -0
- package/dist/runtime/ocr.js +440 -0
- package/dist/runtime/otlp.d.ts +71 -2
- package/dist/runtime/otlp.js +397 -16
- package/dist/runtime/proxy-errors.js +6 -2
- package/dist/runtime/proxy-nodemaven.d.ts +56 -0
- package/dist/runtime/proxy-nodemaven.js +146 -0
- package/dist/runtime/proxy-telemetry.d.ts +80 -1
- package/dist/runtime/proxy-telemetry.js +154 -47
- package/dist/runtime/redirects.d.ts +29 -0
- package/dist/runtime/redirects.js +36 -0
- package/dist/runtime/redis.d.ts +1 -1
- package/dist/runtime/redis.js +4 -2
- package/dist/runtime/request-options.d.ts +68 -1
- package/dist/runtime/request-options.js +548 -0
- package/dist/runtime/resolver-config.d.ts +6 -0
- package/dist/runtime/resolver-config.js +6 -0
- package/dist/runtime/resolver-public.d.ts +1 -0
- package/dist/runtime/resolver-public.js +1 -0
- package/dist/runtime/resolver-shared.d.ts +14 -0
- package/dist/runtime/resolver-shared.js +12 -0
- package/dist/runtime/resolver-vendors/bindings.d.ts +48 -0
- package/dist/runtime/resolver-vendors/bindings.js +40 -0
- package/dist/runtime/resolver-vendors/browser.d.ts +22 -0
- package/dist/runtime/resolver-vendors/browser.js +377 -0
- package/dist/runtime/resolver-vendors/capsolver.d.ts +22 -0
- package/dist/runtime/resolver-vendors/capsolver.js +531 -0
- package/dist/runtime/resolver-vendors/hosts.d.ts +2 -0
- package/dist/runtime/resolver-vendors/hosts.js +33 -0
- package/dist/runtime/resolver-vendors/twocaptcha.d.ts +24 -0
- package/dist/runtime/resolver-vendors/twocaptcha.js +408 -0
- package/dist/runtime/resolver-vendors/types.d.ts +94 -0
- package/dist/runtime/resolver-vendors/types.js +96 -0
- package/dist/runtime/resolver.d.ts +72 -0
- package/dist/runtime/resolver.js +771 -0
- package/dist/runtime/secrets.d.ts +27 -0
- package/dist/runtime/secrets.js +51 -0
- package/dist/runtime/state.d.ts +3 -0
- package/dist/runtime/state.js +277 -71
- package/dist/runtime/stealth-cookies.d.ts +20 -0
- package/dist/runtime/stealth-cookies.js +111 -0
- package/dist/runtime/stealth.d.ts +41 -5
- package/dist/runtime/stealth.js +997 -291
- package/dist/runtime/stt.js +1 -12
- 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 +5 -0
- package/dist/runtime/trace.js +43 -10
- 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/index.d.ts +5 -2
- package/dist/server/index.js +2 -2
- 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.d.ts +14 -3
- package/dist/server/self-test.js +129 -58
- package/dist/server/serve-implementation.d.ts +230 -0
- package/dist/server/serve-implementation.js +2265 -0
- package/dist/server/serve.d.ts +1 -70
- package/dist/server/serve.js +1 -1131
- package/dist/server/trace-output.d.ts +6 -0
- package/dist/server/trace-output.js +79 -0
- package/dist/server/types.d.ts +30 -5
- package/dist/server/types.js +13 -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 +215 -0
- package/dist/stateful/stateful-provider-runtime-context.d.ts +32 -0
- package/dist/stateful/stateful-provider-runtime-context.js +60 -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 +9 -4
- package/dist/stealth/profiles.js +160 -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 +489 -21
- package/dist/trace-sanitization.d.ts +5 -0
- package/dist/trace-sanitization.js +45 -0
- package/dist/types.d.ts +673 -131
- package/dist/types.js +1 -0
- package/package.json +45 -5
- package/src/auth-turn/index.ts +1 -1
- package/src/auth.ts +118 -0
- package/src/ceremonies/index.ts +189 -46
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/approval-override.ts.txt +6 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/codemod-syntax.ts.txt +3 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/connection-precedence.ts.txt +10 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/docs-conflict.ts.txt +8 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/examples-hoisted-array-spread.ts.txt +15 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/examples-imported-array-spread.ts.txt +9 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/examples-map.ts.txt +5 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/examples-mixed-array-spread.ts.txt +24 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/examples-operation.ts.txt +16 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/factory-map.ts.txt +3 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/hoist-all.ts.txt +31 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/hoisted-const.ts.txt +11 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/imported-spread.ts.txt +11 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/inline-map.ts.txt +11 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/inline-spread-cast-tail.ts.txt +21 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/inline-spread-ekitan.ts.txt +11 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/inline-spread-override.ts.txt +14 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/missing-english-locale.ts.txt +7 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/no-safety.ts.txt +6 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/non-literal.ts.txt +7 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/redundant-approval.ts.txt +6 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/safety-conflict.ts.txt +7 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/stream.ts.txt +7 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/tool-router-spread.ts.txt +15 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/unparseable.ts.txt +4 -0
- package/src/cli/__tests__/fixtures/migrate-operation-declaration/verbatim-template.ts.txt +12 -0
- package/src/cli/commands.ts +33 -0
- package/src/cli/create.ts +50 -37
- package/src/cli/migrate-operation-declaration.ts +1751 -0
- package/src/cli/migrate-operation-shape.ts +184 -0
- package/src/cli/migrate-provider-shape.ts +772 -0
- package/src/cli/prompt-assets.ts +865 -0
- package/src/cli/templates/provider/AGENTS.md.tpl +17 -8
- package/src/cli/templates/provider/Dockerfile.tpl +1 -1
- package/src/cli/templates/provider/README.md.tpl +5 -5
- 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 +690 -163
- 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 +330 -0
- package/src/define.ts +1048 -131
- package/src/dev.ts +4 -1
- package/src/engine.ts +279 -0
- package/src/error-observability.ts +64 -0
- package/src/error-resolution.ts +127 -0
- package/src/errors.ts +68 -0
- package/src/fixture-sanitization.ts +264 -0
- package/src/health-scenario.ts +875 -0
- package/src/index.ts +220 -13
- package/src/lint.ts +698 -90
- 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 +161 -3
- package/src/runtime/auth-flow.ts +12 -0
- package/src/runtime/browser.ts +661 -63
- package/src/runtime/cache.ts +189 -14
- package/src/runtime/choice-wordlist.ts +145 -0
- package/src/runtime/choice.ts +631 -120
- package/src/runtime/chrome149-header-order.ts +330 -0
- package/src/runtime/env.ts +13 -0
- package/src/runtime/executor.ts +43 -31
- package/src/runtime/http.ts +641 -61
- package/src/runtime/insights.ts +2 -2
- package/src/runtime/instrumentation.ts +520 -15
- package/src/runtime/native-network-errors.ts +99 -0
- package/src/runtime/native-network.ts +1605 -0
- package/src/runtime/ocr.ts +523 -0
- package/src/runtime/otlp.ts +467 -21
- package/src/runtime/proxy-errors.ts +12 -4
- package/src/runtime/proxy-nodemaven.ts +221 -0
- package/src/runtime/proxy-telemetry.ts +244 -75
- package/src/runtime/redirects.ts +66 -0
- package/src/runtime/redis.ts +7 -2
- package/src/runtime/request-options.ts +680 -1
- package/src/runtime/resolver-config.ts +6 -0
- package/src/runtime/resolver-public.ts +23 -0
- package/src/runtime/resolver-shared.ts +33 -0
- package/src/runtime/resolver-vendors/bindings.ts +56 -0
- package/src/runtime/resolver-vendors/browser.ts +533 -0
- package/src/runtime/resolver-vendors/capsolver.ts +707 -0
- package/src/runtime/resolver-vendors/hosts.ts +38 -0
- package/src/runtime/resolver-vendors/twocaptcha.ts +540 -0
- package/src/runtime/resolver-vendors/types.ts +212 -0
- package/src/runtime/resolver.ts +1157 -0
- package/src/runtime/secrets.ts +64 -0
- package/src/runtime/state.ts +394 -77
- package/src/runtime/stealth-cookies.ts +132 -0
- package/src/runtime/stealth.ts +1280 -336
- package/src/runtime/stt.ts +1 -19
- package/src/runtime/timeout.ts +18 -0
- package/src/runtime/trace-config.ts +78 -0
- package/src/runtime/trace.ts +57 -17
- package/src/serve.ts +6 -1
- package/src/server/error-observability.ts +1 -0
- package/src/server/index.ts +34 -2
- package/src/server/self-test-input-tokens.ts +29 -14
- package/src/server/self-test.ts +191 -68
- package/src/server/serve-implementation.ts +3378 -0
- package/src/server/serve.ts +1 -1632
- package/src/server/trace-output.ts +129 -0
- package/src/server/types.ts +13 -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 +287 -0
- package/src/stateful/stateful-provider-runtime-context.ts +92 -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 +202 -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 +658 -15
- package/src/trace-sanitization.ts +63 -0
- package/src/types.ts +788 -174
- package/dist/cli/templates/provider/CLAUDE.md.tpl +0 -1
- package/src/cli/templates/provider/CLAUDE.md.tpl +0 -1
- /package/dist/cli/templates/provider/{skills → .agents/skills}/fixtures-and-recording/SKILL.md.tpl +0 -0
- /package/dist/cli/templates/provider/{skills → .agents/skills}/health-checks-and-fail-closed/SKILL.md.tpl +0 -0
- /package/dist/cli/templates/provider/{skills → .agents/skills}/normalization-standards/SKILL.md.tpl +0 -0
- /package/dist/cli/templates/provider/{skills → .agents/skills}/pagination-and-counts/SKILL.md.tpl +0 -0
- /package/dist/cli/templates/provider/{skills → .agents/skills}/upstream-contract-verification/SKILL.md.tpl +0 -0
- /package/dist/cli/templates/provider/{skills → .agents/skills}/upstream-notes/README.md.tpl +0 -0
- /package/src/cli/templates/provider/{skills → .agents/skills}/fixtures-and-recording/SKILL.md.tpl +0 -0
- /package/src/cli/templates/provider/{skills → .agents/skills}/health-checks-and-fail-closed/SKILL.md.tpl +0 -0
- /package/src/cli/templates/provider/{skills → .agents/skills}/normalization-standards/SKILL.md.tpl +0 -0
- /package/src/cli/templates/provider/{skills → .agents/skills}/pagination-and-counts/SKILL.md.tpl +0 -0
- /package/src/cli/templates/provider/{skills → .agents/skills}/upstream-contract-verification/SKILL.md.tpl +0 -0
- /package/src/cli/templates/provider/{skills → .agents/skills}/upstream-notes/README.md.tpl +0 -0
package/src/runtime/otlp.ts
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { AsyncResource } from "node:async_hooks";
|
|
2
|
+
|
|
1
3
|
import type { TraceSpan } from "../types.js";
|
|
2
4
|
|
|
3
5
|
export interface OTLPExportOptions {
|
|
@@ -6,6 +8,221 @@ export interface OTLPExportOptions {
|
|
|
6
8
|
timeout?: number;
|
|
7
9
|
}
|
|
8
10
|
|
|
11
|
+
export const OTEL_EXPORTER_OTLP_TRACES_ENDPOINT = "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT";
|
|
12
|
+
export const OTEL_EXPORTER_OTLP_ENDPOINT = "OTEL_EXPORTER_OTLP_ENDPOINT";
|
|
13
|
+
export const OTEL_EXPORTER_OTLP_TRACES_HEADERS = "OTEL_EXPORTER_OTLP_TRACES_HEADERS";
|
|
14
|
+
export const OTEL_EXPORTER_OTLP_HEADERS = "OTEL_EXPORTER_OTLP_HEADERS";
|
|
15
|
+
export const OTEL_SERVICE_NAME = "OTEL_SERVICE_NAME";
|
|
16
|
+
export const OTEL_RESOURCE_ATTRIBUTES = "OTEL_RESOURCE_ATTRIBUTES";
|
|
17
|
+
|
|
18
|
+
type EnvLike = Record<string, string | undefined>;
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* `invalid` carries a fixed-vocabulary `reason` and the name of the offending
|
|
22
|
+
* source so callers can warn without ever echoing the configured value.
|
|
23
|
+
*/
|
|
24
|
+
export type OTLPExportResolution =
|
|
25
|
+
| { status: "resolved"; options: OTLPExportOptions }
|
|
26
|
+
| { status: "unconfigured" }
|
|
27
|
+
| { status: "invalid"; source: string; reason: string };
|
|
28
|
+
|
|
29
|
+
export type OTLPResourceResolution = {
|
|
30
|
+
attributes: Record<string, string>;
|
|
31
|
+
/** Environment variables whose whole value was discarded because it could not be parsed. */
|
|
32
|
+
discarded: string[];
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
const OTLP_HTTP_PROTOCOLS = new Set(["http:", "https:"]);
|
|
36
|
+
const INVALID_ENDPOINT_URL = "is not an absolute http(s) URL";
|
|
37
|
+
const INVALID_ENDPOINT_CREDENTIALS = `embeds credentials in the URL; send them through ${OTEL_EXPORTER_OTLP_HEADERS} instead`;
|
|
38
|
+
const INVALID_HEADERS = "contains an HTTP header name or value that cannot be sent";
|
|
39
|
+
const EXPLICIT_ENDPOINT_SOURCE = "the configured OTLP endpoint";
|
|
40
|
+
const EXPLICIT_HEADERS_SOURCE = "the configured OTLP headers";
|
|
41
|
+
|
|
42
|
+
/** Only an unset or empty variable is absent (OTel env rules); whitespace is a value and is validated as one. */
|
|
43
|
+
function presentValue(value: string | undefined): string | undefined {
|
|
44
|
+
return value === undefined || value === "" ? undefined : value;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function parseHttpUrl(value: string): { url: URL } | { reason: string } {
|
|
48
|
+
let url: URL;
|
|
49
|
+
try {
|
|
50
|
+
url = new URL(value);
|
|
51
|
+
} catch {
|
|
52
|
+
return { reason: INVALID_ENDPOINT_URL };
|
|
53
|
+
}
|
|
54
|
+
if (!OTLP_HTTP_PROTOCOLS.has(url.protocol)) return { reason: INVALID_ENDPOINT_URL };
|
|
55
|
+
if (url.username || url.password) return { reason: INVALID_ENDPOINT_CREDENTIALS };
|
|
56
|
+
return { url };
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** fetch() rejects malformed header names/values per request; catch that once at resolve time instead. */
|
|
60
|
+
function headersAreSendable(headers: Record<string, string>): boolean {
|
|
61
|
+
try {
|
|
62
|
+
new Headers(headers);
|
|
63
|
+
return true;
|
|
64
|
+
} catch {
|
|
65
|
+
return false;
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** Appends the traces signal path to a base URL, keeping every configured path byte and adding only the separator. */
|
|
70
|
+
function appendTracesPath(base: URL): string {
|
|
71
|
+
const endpoint = new URL(base.toString());
|
|
72
|
+
const separator = endpoint.pathname.endsWith("/") ? "" : "/";
|
|
73
|
+
endpoint.pathname = `${endpoint.pathname}${separator}v1/traces`;
|
|
74
|
+
return endpoint.toString();
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/** HTTP header names are case-insensitive: a later source replaces an earlier one whatever its casing. */
|
|
78
|
+
function mergeHeaders(
|
|
79
|
+
...sources: Array<Record<string, string> | undefined>
|
|
80
|
+
): Record<string, string> {
|
|
81
|
+
const merged = new Map<string, [string, string]>();
|
|
82
|
+
for (const source of sources) {
|
|
83
|
+
for (const [key, value] of Object.entries(source ?? {})) {
|
|
84
|
+
merged.set(key.toLowerCase(), [key, value]);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
return Object.fromEntries(merged.values());
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
function decodeHeaderMember(value: string): string {
|
|
91
|
+
try {
|
|
92
|
+
return decodeURIComponent(value);
|
|
93
|
+
} catch {
|
|
94
|
+
// A literal "%" that is not a valid escape is passed through rather than dropping the header.
|
|
95
|
+
return value;
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** Baggage-style header list: malformed members are skipped and an invalid percent-escape keeps the raw text. */
|
|
100
|
+
function parseHeaderList(value: string | undefined): Record<string, string> {
|
|
101
|
+
const entries: Array<[string, string]> = [];
|
|
102
|
+
for (const member of value?.split(",") ?? []) {
|
|
103
|
+
const separator = member.indexOf("=");
|
|
104
|
+
if (separator <= 0) continue;
|
|
105
|
+
const key = decodeHeaderMember(member.slice(0, separator).trim());
|
|
106
|
+
if (!key) continue;
|
|
107
|
+
entries.push([key, decodeHeaderMember(member.slice(separator + 1).trim())]);
|
|
108
|
+
}
|
|
109
|
+
return mergeHeaders(Object.fromEntries(entries));
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* OTel resource list: a member without `key=value` or with an invalid
|
|
114
|
+
* percent-escape discards the whole value, as the Resource SDK spec requires,
|
|
115
|
+
* so a partially malformed variable can never export a wrong identity.
|
|
116
|
+
*/
|
|
117
|
+
function parseResourceAttributeList(value: string): Record<string, string> | undefined {
|
|
118
|
+
const entries: Array<[string, string]> = [];
|
|
119
|
+
for (const member of value.split(",")) {
|
|
120
|
+
// Every member must be `key=value`; an empty member (`a=b,,c=d`, a trailing comma, a
|
|
121
|
+
// whitespace-only value) is a parse error and discards the whole variable.
|
|
122
|
+
const separator = member.indexOf("=");
|
|
123
|
+
if (separator <= 0) return undefined;
|
|
124
|
+
try {
|
|
125
|
+
const key = decodeURIComponent(member.slice(0, separator).trim());
|
|
126
|
+
if (!key) return undefined;
|
|
127
|
+
entries.push([key, decodeURIComponent(member.slice(separator + 1).trim())]);
|
|
128
|
+
} catch {
|
|
129
|
+
return undefined;
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
return Object.fromEntries(entries);
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* Resolves the OTLP/HTTP export target from explicit configuration and the
|
|
137
|
+
* standard OpenTelemetry environment contract. Endpoint precedence is explicit
|
|
138
|
+
* config, then OTEL_EXPORTER_OTLP_TRACES_ENDPOINT verbatim, then
|
|
139
|
+
* OTEL_EXPORTER_OTLP_ENDPOINT with `/v1/traces` appended. The winning candidate
|
|
140
|
+
* must be an absolute http(s) URL; an invalid one fails closed instead of
|
|
141
|
+
* falling through to a lower-precedence destination. Header values are never
|
|
142
|
+
* surfaced in the result beyond the request options themselves.
|
|
143
|
+
*/
|
|
144
|
+
export function resolveOTLPExportOptions(
|
|
145
|
+
explicit: {
|
|
146
|
+
endpoint?: string;
|
|
147
|
+
headers?: Record<string, string>;
|
|
148
|
+
timeout?: number;
|
|
149
|
+
},
|
|
150
|
+
env: EnvLike = process.env,
|
|
151
|
+
): OTLPExportResolution {
|
|
152
|
+
const candidates = [
|
|
153
|
+
{ source: EXPLICIT_ENDPOINT_SOURCE, value: explicit.endpoint, appendPath: false },
|
|
154
|
+
{
|
|
155
|
+
source: OTEL_EXPORTER_OTLP_TRACES_ENDPOINT,
|
|
156
|
+
value: env[OTEL_EXPORTER_OTLP_TRACES_ENDPOINT],
|
|
157
|
+
appendPath: false,
|
|
158
|
+
},
|
|
159
|
+
{
|
|
160
|
+
source: OTEL_EXPORTER_OTLP_ENDPOINT,
|
|
161
|
+
value: env[OTEL_EXPORTER_OTLP_ENDPOINT],
|
|
162
|
+
appendPath: true,
|
|
163
|
+
},
|
|
164
|
+
];
|
|
165
|
+
const candidate = candidates
|
|
166
|
+
.map((entry) => ({ ...entry, value: presentValue(entry.value) }))
|
|
167
|
+
.find((entry): entry is typeof entry & { value: string } => entry.value !== undefined);
|
|
168
|
+
if (!candidate) return { status: "unconfigured" };
|
|
169
|
+
|
|
170
|
+
const parsed = parseHttpUrl(candidate.value);
|
|
171
|
+
if ("reason" in parsed) {
|
|
172
|
+
return { status: "invalid", source: candidate.source, reason: parsed.reason };
|
|
173
|
+
}
|
|
174
|
+
const endpoint = candidate.appendPath ? appendTracesPath(parsed.url) : candidate.value;
|
|
175
|
+
|
|
176
|
+
const tracesHeaders = presentValue(env[OTEL_EXPORTER_OTLP_TRACES_HEADERS]);
|
|
177
|
+
const headersSource =
|
|
178
|
+
tracesHeaders !== undefined ? OTEL_EXPORTER_OTLP_TRACES_HEADERS : OTEL_EXPORTER_OTLP_HEADERS;
|
|
179
|
+
const envHeaders = parseHeaderList(
|
|
180
|
+
tracesHeaders ?? presentValue(env[OTEL_EXPORTER_OTLP_HEADERS]),
|
|
181
|
+
);
|
|
182
|
+
if (!headersAreSendable(envHeaders)) {
|
|
183
|
+
return { status: "invalid", source: headersSource, reason: INVALID_HEADERS };
|
|
184
|
+
}
|
|
185
|
+
const headers = mergeHeaders(envHeaders, explicit.headers);
|
|
186
|
+
if (!headersAreSendable(headers)) {
|
|
187
|
+
return { status: "invalid", source: EXPLICIT_HEADERS_SOURCE, reason: INVALID_HEADERS };
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
return {
|
|
191
|
+
status: "resolved",
|
|
192
|
+
options: {
|
|
193
|
+
endpoint,
|
|
194
|
+
...(Object.keys(headers).length > 0 ? { headers } : {}),
|
|
195
|
+
...(explicit.timeout !== undefined ? { timeout: explicit.timeout } : {}),
|
|
196
|
+
},
|
|
197
|
+
};
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* Merges OTEL_RESOURCE_ATTRIBUTES and OTEL_SERVICE_NAME under the caller's
|
|
202
|
+
* explicit resource attributes: explicit wins per key, OTEL_SERVICE_NAME wins
|
|
203
|
+
* over a `service.name` inside OTEL_RESOURCE_ATTRIBUTES. An unparseable
|
|
204
|
+
* OTEL_RESOURCE_ATTRIBUTES value is discarded as a unit and reported in `discarded`.
|
|
205
|
+
*/
|
|
206
|
+
export function resolveOTLPResourceAttributes(
|
|
207
|
+
explicit: Record<string, string>,
|
|
208
|
+
env: EnvLike = process.env,
|
|
209
|
+
): OTLPResourceResolution {
|
|
210
|
+
const discarded: string[] = [];
|
|
211
|
+
const resourceList = presentValue(env[OTEL_RESOURCE_ATTRIBUTES]);
|
|
212
|
+
const resourceAttributes =
|
|
213
|
+
resourceList === undefined ? {} : parseResourceAttributeList(resourceList);
|
|
214
|
+
if (resourceAttributes === undefined) discarded.push(OTEL_RESOURCE_ATTRIBUTES);
|
|
215
|
+
const serviceName = presentValue(env[OTEL_SERVICE_NAME]);
|
|
216
|
+
return {
|
|
217
|
+
attributes: {
|
|
218
|
+
...resourceAttributes,
|
|
219
|
+
...(serviceName ? { "service.name": serviceName } : {}),
|
|
220
|
+
...explicit,
|
|
221
|
+
},
|
|
222
|
+
discarded,
|
|
223
|
+
};
|
|
224
|
+
}
|
|
225
|
+
|
|
9
226
|
let nextTraceId = 1n;
|
|
10
227
|
let replayableTraceId: { signature: string; traceId: string } | null = null;
|
|
11
228
|
|
|
@@ -60,6 +277,7 @@ function toAttributeValue(value: unknown): Record<string, string | number | bool
|
|
|
60
277
|
export function spansToOTLP(
|
|
61
278
|
spans: TraceSpan[],
|
|
62
279
|
resourceAttributes?: Record<string, string>,
|
|
280
|
+
traceId?: string,
|
|
63
281
|
): {
|
|
64
282
|
resourceSpans: Array<{
|
|
65
283
|
resource: {
|
|
@@ -87,7 +305,7 @@ export function spansToOTLP(
|
|
|
87
305
|
}>;
|
|
88
306
|
}>;
|
|
89
307
|
} {
|
|
90
|
-
const
|
|
308
|
+
const batchTraceId = traceId ?? createTraceId(createBatchSignature(spans, resourceAttributes));
|
|
91
309
|
|
|
92
310
|
return {
|
|
93
311
|
resourceSpans: [
|
|
@@ -105,7 +323,7 @@ export function spansToOTLP(
|
|
|
105
323
|
version: "0.1.0",
|
|
106
324
|
},
|
|
107
325
|
spans: spans.map((span) => ({
|
|
108
|
-
traceId,
|
|
326
|
+
traceId: batchTraceId,
|
|
109
327
|
spanId: normalizeHexId(span.id, 16) ?? "0000000000000001",
|
|
110
328
|
parentSpanId: normalizeHexId(span.parentId, 16),
|
|
111
329
|
name: span.name,
|
|
@@ -125,36 +343,264 @@ export function spansToOTLP(
|
|
|
125
343
|
};
|
|
126
344
|
}
|
|
127
345
|
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
346
|
+
type ExportTransport = typeof fetch;
|
|
347
|
+
|
|
348
|
+
/**
|
|
349
|
+
* Binds the transport that carries collector credentials.
|
|
350
|
+
*
|
|
351
|
+
* Trust model: in production the provider's own entry file is the process entry, so
|
|
352
|
+
* provider-controlled code (its earlier imports, a `bun --preload`, or a bunfig preload) can run
|
|
353
|
+
* before any SDK module evaluates; capture timing alone therefore cannot establish trust. On Bun
|
|
354
|
+
* the native fetch is also exposed as `Bun.fetch`, and both the `Bun` global and its `fetch`
|
|
355
|
+
* property are read-only and non-configurable, so no JavaScript in the process can replace that
|
|
356
|
+
* reference at any point. The engine binds it here and never consults `globalThis.fetch`.
|
|
357
|
+
*
|
|
358
|
+
* Residual assumptions: on a runtime without `Bun.fetch` the fallback is `globalThis.fetch` as
|
|
359
|
+
* seen when this module first evaluates, which code that runs earlier in the same process can
|
|
360
|
+
* have replaced (or can have forged a `Bun` global). Code with process authority can also patch
|
|
361
|
+
* other builtins on this path (Map, Object.fromEntries, Headers, AbortController, setTimeout),
|
|
362
|
+
* install module loader plugins, or reach the internal test seam below by importing this module
|
|
363
|
+
* by path; an in-process boundary cannot defend against any of that. The CLI flows load provider
|
|
364
|
+
* modules only after the engine has loaded.
|
|
365
|
+
*/
|
|
366
|
+
function bindEngineTransport(): ExportTransport {
|
|
367
|
+
const bunFetch: unknown = typeof Bun !== "undefined" ? Bun.fetch : undefined;
|
|
368
|
+
return typeof bunFetch === "function" ? (bunFetch as ExportTransport) : globalThis.fetch;
|
|
369
|
+
}
|
|
370
|
+
|
|
371
|
+
const engineTransport: ExportTransport = bindEngineTransport();
|
|
372
|
+
let transport: ExportTransport = engineTransport;
|
|
373
|
+
|
|
374
|
+
// Deliveries run inside this engine-owned async scope, created while the module evaluates, so a
|
|
375
|
+
// batch admitted from another batch's completion never inherits that request's async context.
|
|
376
|
+
// (The scope snapshots the async context active at module load: empty under the static imports
|
|
377
|
+
// the engine uses.)
|
|
378
|
+
const exportScope = new AsyncResource("apifuse.otlp.export");
|
|
379
|
+
|
|
380
|
+
/** Process-wide bounds so a collector outage can never turn into unbounded sockets, memory, or log volume. */
|
|
381
|
+
export const OTLP_EXPORT_LIMITS = {
|
|
382
|
+
maxInFlight: 4,
|
|
383
|
+
maxQueued: 64,
|
|
384
|
+
maxAttempts: 3,
|
|
385
|
+
retryBaseDelayMs: 200,
|
|
386
|
+
retryMaxDelayMs: 2_000,
|
|
387
|
+
warningCooldownMs: 10_000,
|
|
388
|
+
} as const;
|
|
389
|
+
|
|
390
|
+
const RETRYABLE_STATUSES = new Set([408, 429, 502, 503, 504]);
|
|
391
|
+
const TIMEOUT_ERROR_NAMES = new Set(["AbortError", "TimeoutError"]);
|
|
392
|
+
/** Certificate failures do not clear up on retry; they are reported once and the batch dropped. */
|
|
393
|
+
const CERTIFICATE_ERROR_CODES = new Set([
|
|
394
|
+
"CERT_HAS_EXPIRED",
|
|
395
|
+
"DEPTH_ZERO_SELF_SIGNED_CERT",
|
|
396
|
+
"SELF_SIGNED_CERT_IN_CHAIN",
|
|
397
|
+
"UNABLE_TO_VERIFY_LEAF_SIGNATURE",
|
|
398
|
+
"ERR_TLS_CERT_ALTNAME_INVALID",
|
|
399
|
+
]);
|
|
400
|
+
/** Only these system codes are ever echoed; anything else is reported as a plain network error. */
|
|
401
|
+
const NETWORK_ERROR_CODES = new Set([
|
|
402
|
+
"ECONNREFUSED",
|
|
403
|
+
"ECONNRESET",
|
|
404
|
+
"ECONNABORTED",
|
|
405
|
+
"ENOTFOUND",
|
|
406
|
+
"EAI_AGAIN",
|
|
407
|
+
"ETIMEDOUT",
|
|
408
|
+
"EHOSTUNREACH",
|
|
409
|
+
"ENETUNREACH",
|
|
410
|
+
"EPIPE",
|
|
411
|
+
"CERT_HAS_EXPIRED",
|
|
412
|
+
"DEPTH_ZERO_SELF_SIGNED_CERT",
|
|
413
|
+
"SELF_SIGNED_CERT_IN_CHAIN",
|
|
414
|
+
"UNABLE_TO_VERIFY_LEAF_SIGNATURE",
|
|
415
|
+
"ERR_TLS_CERT_ALTNAME_INVALID",
|
|
416
|
+
"ConnectionRefused",
|
|
417
|
+
"ConnectionClosed",
|
|
418
|
+
"FailedToOpenSocket",
|
|
419
|
+
]);
|
|
420
|
+
|
|
421
|
+
type ExportOutcome = { ok: true } | { ok: false; reason: string; retryable: boolean };
|
|
422
|
+
|
|
423
|
+
type ExportBatch = {
|
|
424
|
+
body: string;
|
|
425
|
+
options: OTLPExportOptions;
|
|
426
|
+
settle: () => void;
|
|
427
|
+
};
|
|
428
|
+
|
|
429
|
+
const queue: ExportBatch[] = [];
|
|
430
|
+
let inFlight = 0;
|
|
431
|
+
let lastWarningAt = Number.NEGATIVE_INFINITY;
|
|
432
|
+
let suppressedDrops = 0;
|
|
433
|
+
let suppressedFlush: ReturnType<typeof setTimeout> | undefined;
|
|
434
|
+
|
|
435
|
+
function errorCode(error: unknown): string | undefined {
|
|
436
|
+
const own = (error as { code?: unknown } | null)?.code;
|
|
437
|
+
if (typeof own === "string") return own;
|
|
438
|
+
const cause = (error as { cause?: { code?: unknown } } | null)?.cause?.code;
|
|
439
|
+
return typeof cause === "string" ? cause : undefined;
|
|
440
|
+
}
|
|
441
|
+
|
|
442
|
+
/** Maps a transport failure onto a fixed vocabulary; nothing from the error object is interpolated. */
|
|
443
|
+
function describeExportFailure(error: unknown): { reason: string; retryable: boolean } {
|
|
444
|
+
if (error instanceof Error && TIMEOUT_ERROR_NAMES.has(error.name)) {
|
|
445
|
+
return { reason: "timeout", retryable: true };
|
|
446
|
+
}
|
|
447
|
+
const code = errorCode(error);
|
|
448
|
+
if (code !== undefined && CERTIFICATE_ERROR_CODES.has(code)) {
|
|
449
|
+
return { reason: `certificate error: ${code}`, retryable: false };
|
|
450
|
+
}
|
|
451
|
+
return {
|
|
452
|
+
reason:
|
|
453
|
+
code !== undefined && NETWORK_ERROR_CODES.has(code)
|
|
454
|
+
? `network error: ${code}`
|
|
455
|
+
: "network error",
|
|
456
|
+
retryable: true,
|
|
457
|
+
};
|
|
458
|
+
}
|
|
459
|
+
|
|
460
|
+
function batchesLabel(count: number): string {
|
|
461
|
+
return `${count} ${count === 1 ? "batch" : "batches"}`;
|
|
462
|
+
}
|
|
463
|
+
|
|
464
|
+
/** Emits the count of drops suppressed during a cooldown once it ends, so a burst is never under-reported. */
|
|
465
|
+
function flushSuppressedDrops(): void {
|
|
466
|
+
suppressedFlush = undefined;
|
|
467
|
+
if (suppressedDrops === 0) return;
|
|
468
|
+
const dropped = suppressedDrops;
|
|
469
|
+
suppressedDrops = 0;
|
|
470
|
+
lastWarningAt = Date.now();
|
|
471
|
+
console.warn(
|
|
472
|
+
`[apifuse] OTLP export: ${batchesLabel(dropped)} more dropped since the last warning.`,
|
|
473
|
+
);
|
|
474
|
+
}
|
|
475
|
+
|
|
476
|
+
function noteDroppedBatch(reason: string): void {
|
|
477
|
+
const now = Date.now();
|
|
478
|
+
const sinceLastWarning = now - lastWarningAt;
|
|
479
|
+
if (sinceLastWarning < OTLP_EXPORT_LIMITS.warningCooldownMs) {
|
|
480
|
+
suppressedDrops += 1;
|
|
481
|
+
if (suppressedFlush === undefined) {
|
|
482
|
+
suppressedFlush = setTimeout(
|
|
483
|
+
flushSuppressedDrops,
|
|
484
|
+
OTLP_EXPORT_LIMITS.warningCooldownMs - sinceLastWarning,
|
|
485
|
+
);
|
|
486
|
+
suppressedFlush.unref?.();
|
|
487
|
+
}
|
|
134
488
|
return;
|
|
135
489
|
}
|
|
490
|
+
lastWarningAt = now;
|
|
491
|
+
console.warn(`[apifuse] OTLP export failed (${reason}); ${batchesLabel(1)} dropped.`);
|
|
492
|
+
}
|
|
136
493
|
|
|
494
|
+
async function sendBatch(batch: ExportBatch): Promise<ExportOutcome> {
|
|
137
495
|
const controller = new AbortController();
|
|
138
|
-
const timer = setTimeout(() => controller.abort(), options.timeout ?? 5_000);
|
|
139
|
-
|
|
496
|
+
const timer = setTimeout(() => controller.abort(), batch.options.timeout ?? 5_000);
|
|
140
497
|
try {
|
|
141
|
-
const response = await
|
|
498
|
+
const response = await transport(batch.options.endpoint, {
|
|
142
499
|
method: "POST",
|
|
143
|
-
headers: {
|
|
144
|
-
|
|
145
|
-
...options.headers,
|
|
146
|
-
},
|
|
147
|
-
body: JSON.stringify(spansToOTLP(spans, resourceAttributes)),
|
|
500
|
+
headers: mergeHeaders(batch.options.headers, { "Content-Type": "application/json" }),
|
|
501
|
+
body: batch.body,
|
|
148
502
|
signal: controller.signal,
|
|
149
503
|
});
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
504
|
+
// The reply body is not needed; cancel it while the abort timer still bounds the socket.
|
|
505
|
+
try {
|
|
506
|
+
await response.body?.cancel();
|
|
507
|
+
} catch {
|
|
508
|
+
// A body that cannot be cancelled does not change the outcome of the export.
|
|
153
509
|
}
|
|
510
|
+
if (response.ok) return { ok: true };
|
|
511
|
+
return {
|
|
512
|
+
ok: false,
|
|
513
|
+
reason: `HTTP ${response.status}`,
|
|
514
|
+
retryable: RETRYABLE_STATUSES.has(response.status),
|
|
515
|
+
};
|
|
154
516
|
} catch (error) {
|
|
155
|
-
|
|
156
|
-
console.warn("[apifuse] OTLP export failed:", message);
|
|
517
|
+
return { ok: false, ...describeExportFailure(error) };
|
|
157
518
|
} finally {
|
|
158
519
|
clearTimeout(timer);
|
|
159
520
|
}
|
|
160
521
|
}
|
|
522
|
+
|
|
523
|
+
/** Exponential backoff between attempts: base * 2^(attempt-1), capped at the maximum delay. */
|
|
524
|
+
export function retryDelayMs(attempt: number): number {
|
|
525
|
+
return Math.min(
|
|
526
|
+
OTLP_EXPORT_LIMITS.retryBaseDelayMs * 2 ** (attempt - 1),
|
|
527
|
+
OTLP_EXPORT_LIMITS.retryMaxDelayMs,
|
|
528
|
+
);
|
|
529
|
+
}
|
|
530
|
+
|
|
531
|
+
async function deliverBatch(batch: ExportBatch): Promise<void> {
|
|
532
|
+
for (let attempt = 1; ; attempt += 1) {
|
|
533
|
+
const outcome = await sendBatch(batch);
|
|
534
|
+
if (outcome.ok) return;
|
|
535
|
+
if (!outcome.retryable || attempt >= OTLP_EXPORT_LIMITS.maxAttempts) {
|
|
536
|
+
noteDroppedBatch(
|
|
537
|
+
attempt > 1 ? `${outcome.reason} after ${attempt} attempts` : outcome.reason,
|
|
538
|
+
);
|
|
539
|
+
return;
|
|
540
|
+
}
|
|
541
|
+
await new Promise<void>((resolve) => {
|
|
542
|
+
setTimeout(resolve, retryDelayMs(attempt)).unref?.();
|
|
543
|
+
});
|
|
544
|
+
}
|
|
545
|
+
}
|
|
546
|
+
|
|
547
|
+
function pumpQueue(): void {
|
|
548
|
+
while (inFlight < OTLP_EXPORT_LIMITS.maxInFlight && queue.length > 0) {
|
|
549
|
+
const batch = queue.shift();
|
|
550
|
+
if (!batch) return;
|
|
551
|
+
inFlight += 1;
|
|
552
|
+
void exportScope
|
|
553
|
+
.runInAsyncScope(() => deliverBatch(batch))
|
|
554
|
+
.finally(() => {
|
|
555
|
+
inFlight -= 1;
|
|
556
|
+
batch.settle();
|
|
557
|
+
pumpQueue();
|
|
558
|
+
});
|
|
559
|
+
}
|
|
560
|
+
}
|
|
561
|
+
|
|
562
|
+
/**
|
|
563
|
+
* Queues one export batch behind the process-wide concurrency and queue bounds.
|
|
564
|
+
* Resolves once the batch has been delivered or dropped; it never rejects, so
|
|
565
|
+
* callers can fire and forget.
|
|
566
|
+
*/
|
|
567
|
+
export function exportSpansOTLP(
|
|
568
|
+
spans: TraceSpan[],
|
|
569
|
+
options: OTLPExportOptions,
|
|
570
|
+
resourceAttributes?: Record<string, string>,
|
|
571
|
+
traceId?: string,
|
|
572
|
+
): Promise<void> {
|
|
573
|
+
if (spans.length === 0) {
|
|
574
|
+
return Promise.resolve();
|
|
575
|
+
}
|
|
576
|
+
if (queue.length >= OTLP_EXPORT_LIMITS.maxQueued) {
|
|
577
|
+
noteDroppedBatch("export queue is full");
|
|
578
|
+
return Promise.resolve();
|
|
579
|
+
}
|
|
580
|
+
let body: string;
|
|
581
|
+
try {
|
|
582
|
+
body = JSON.stringify(spansToOTLP(spans, resourceAttributes, traceId));
|
|
583
|
+
} catch {
|
|
584
|
+
noteDroppedBatch("span serialization failed");
|
|
585
|
+
return Promise.resolve();
|
|
586
|
+
}
|
|
587
|
+
return new Promise<void>((settle) => {
|
|
588
|
+
queue.push({ body, options, settle });
|
|
589
|
+
pumpQueue();
|
|
590
|
+
});
|
|
591
|
+
}
|
|
592
|
+
|
|
593
|
+
/** Test seam (not re-exported from any package entry point): substitute the engine transport. */
|
|
594
|
+
export function swapOTLPTransportForTests(next?: ExportTransport): void {
|
|
595
|
+
transport = next ?? engineTransport;
|
|
596
|
+
}
|
|
597
|
+
|
|
598
|
+
/** Test seam: drop queued batches, clear the warning throttle, and restore the engine transport. */
|
|
599
|
+
export function resetOTLPExportForTests(): void {
|
|
600
|
+
for (const batch of queue.splice(0)) batch.settle();
|
|
601
|
+
if (suppressedFlush !== undefined) clearTimeout(suppressedFlush);
|
|
602
|
+
suppressedFlush = undefined;
|
|
603
|
+
lastWarningAt = Number.NEGATIVE_INFINITY;
|
|
604
|
+
suppressedDrops = 0;
|
|
605
|
+
transport = engineTransport;
|
|
606
|
+
}
|
|
@@ -19,10 +19,18 @@ const PROXY_AUTH_IP_DENIED_PATTERN =
|
|
|
19
19
|
/\b(?:source|egress|client)\s+ip\b.{0,120}\b(?:deny|denied|unauthori[sz]ed|not\s+authori[sz]ed|white\s*list|allow\s*list)\b|\b(?:white\s*list|allow\s*list)\b.{0,120}\b(?:source|egress|client)\s+ip\b/i;
|
|
20
20
|
const PROXY_EDGE_AUTH_REJECTED_PATTERN =
|
|
21
21
|
/\bauth\s+ip\s+err\b|\bproxy\b.{0,120}\bauth(?:entication)?\b.{0,120}\b(?:reject(?:ed)?|fail(?:ed)?|invalid|den(?:y|ied)|unauthori[sz]ed)\b|\bauth(?:entication)?\b.{0,120}\b(?:reject(?:ed)?|fail(?:ed)?|invalid|den(?:y|ied)|unauthori[sz]ed)\b.{0,120}\bproxy\b/i;
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
22
|
+
// Vendor host tokens that can appear in upstream error strings. Adding a proxy
|
|
23
|
+
// vendor updates every classifier below in one place. `proxy` is the generic
|
|
24
|
+
// fallback so vendor-agnostic messages still classify.
|
|
25
|
+
const PROXY_VENDOR_ALTERNATION = "smartproxy|nodemaven|proxy";
|
|
26
|
+
const PROXY_POOL_STALE_MESSAGE_PATTERN = new RegExp(
|
|
27
|
+
`\\bproxy\\b.{0,120}\\b(?:pool|lease|expired|unavailable|exhausted|non[\\s-]?200\\s+code:\\s*(?:509|512))\\b|\\bnon[\\s-]?200\\s+code:\\s*(?:509|512)\\b.{0,120}\\bproxy\\b|\\b(?:${PROXY_VENDOR_ALTERNATION})\\b.{0,120}\\b(?:509|512)\\b`,
|
|
28
|
+
"i",
|
|
29
|
+
);
|
|
30
|
+
const PROXY_EDGE_TLS_REJECTED_MESSAGE_PATTERN = new RegExp(
|
|
31
|
+
`\\b(?:${PROXY_VENDOR_ALTERNATION})\\b.{0,160}\\b(?:495|ssl|tls|cert(?:ificate)?|handshake|edge|connect|non[\\s-]?200)\\b|\\b(?:495|ssl|tls|cert(?:ificate)?|handshake|edge|connect|non[\\s-]?200)\\b.{0,160}\\b(?:${PROXY_VENDOR_ALTERNATION})\\b`,
|
|
32
|
+
"i",
|
|
33
|
+
);
|
|
26
34
|
|
|
27
35
|
export function isProxyAuthIpDeniedMessage(message: string): boolean {
|
|
28
36
|
return PROXY_AUTH_IP_DENIED_PATTERN.test(message);
|