@apifuse/provider-sdk 2.2.0-beta.57 → 2.2.0-beta.59

package/dist/runtime/resolver-vendors/types.js

@@ -1,18 +1,21 @@
+const RESOLVER_VENDOR_POLL_OBSERVER = Symbol.for("@apifuse/provider-sdk/runtime/resolver-vendor-poll-observer");
+/** Internal chain-runner hook; vendor adapters never receive the telemetry sink itself. */
+export function recordResolverVendorPoll(traceRecorder) {
+    traceRecorder?.[RESOLVER_VENDOR_POLL_OBSERVER]?.();
+}
+export function attachResolverVendorPollObserver(traceRecorder, observer) {
+    Object.defineProperty(traceRecorder, RESOLVER_VENDOR_POLL_OBSERVER, { value: observer });
+    return traceRecorder;
+}
 export const RESOLVER_VENDOR_CAPABILITIES = {
     browser: ["aws_waf", "cloudflare_interstitial"],
     // Every kind listed per vendor is implemented by that vendor's adapter; the
     // per-adapter "agrees with every declared capability" tests iterate this
     // table, so adding a kind here without an implementation fails the suite.
-    // 2captcha omits `cloudflare_interstitial`, `akamai_sec_cpt`, and
-    // `akamai_sensor`: their API offers no task type for them, so declaring them
+    // 2captcha omits `cloudflare_interstitial` and every Akamai kind: its API
+    // offers no measured task type for them, so declaring them
     // would route challenges to a vendor that can only refuse.
-    "2captcha": [
-        "turnstile",
-        "recaptcha_v2",
-        "recaptcha_v3",
-        "hcaptcha",
-        "aws_waf",
-    ],
+    "2captcha": ["turnstile", "recaptcha_v2", "recaptcha_v3", "hcaptcha", "aws_waf"],
     capsolver: [
         "turnstile",
         "recaptcha_v2",
@@ -22,6 +25,9 @@ export const RESOLVER_VENDOR_CAPABILITIES = {
         "aws_waf",
     ],
     capmonster: ["turnstile", "recaptcha_v2", "recaptcha_v3", "hcaptcha"],
+    // Hyper's /sbsd envelope is measured. Its sensor endpoint is deliberately
+    // omitted until that separate protocol is implemented and verified.
+    hypersolutions: ["akamai_sbsd"],
     custom: [
         "turnstile",
         "recaptcha_v2",
@@ -31,6 +37,7 @@ export const RESOLVER_VENDOR_CAPABILITIES = {
         "aws_waf",
         "akamai_sec_cpt",
         "akamai_sensor",
+        "akamai_sbsd",
     ],
 };
 /**
@@ -41,6 +48,7 @@ export const RESOLVER_VENDOR_CAPABILITIES = {
 export const DEFAULT_RESOLVER_VENDOR_PREFERENCE = [
     "capsolver",
     "2captcha",
+    "hypersolutions",
 ];
 export function resolverVendorSupports(vendor, kind) {
     return RESOLVER_VENDOR_CAPABILITIES[vendor].includes(kind);
@@ -62,7 +70,9 @@ export class ResolverVendorUnavailableError extends Error {
         const missingFields = reason === "missing_challenge_input"
             ? options.missingFields?.filter((field) => /^[A-Za-z][A-Za-z0-9_]*$/u.test(field))
             : undefined;
-        super(reason === "missing_challenge_input" && missingFields !== undefined && missingFields.length > 0
+        super(reason === "missing_challenge_input" &&
+            missingFields !== undefined &&
+            missingFields.length > 0
             ? `Resolver vendor ${vendor} cannot use incomplete challenge input; missing fields: ${missingFields.join(", ")}`
             : `Resolver vendor ${vendor} is unavailable: ${reason}`);
         this.vendor = vendor;

package/dist/runtime/resolver.d.ts

@@ -2,8 +2,9 @@ import { type ProxyResolutionOptions } from "../config/loader.js";
 import type { ChallengeSolution, ProviderCache, ProviderChallenge, ProviderChallengeKind, ProviderProxyMode, ProviderResolverConfig, ProviderResolverVendor, ResolverContext } from "../types.js";
 import { type ResolverIdentity, type ResolverVendorAdapter, type ResolverVendorTransport } from "./resolver-vendors/types.js";
 import type { TraceRecorder } from "./trace.js";
+import type { ResolverTelemetrySink } from "./resolver-telemetry.js";
 export { createUnsupportedResolverClient, RESOLVER_INSTRUMENTATION_METADATA, } from "./resolver-shared.js";
-export { APIFUSE__CDP_POOL__URL, APIFUSE__RESOLVER__2CAPTCHA__API_KEY, APIFUSE__RESOLVER__CAPMONSTER__API_KEY, APIFUSE__RESOLVER__CAPSOLVER__API_KEY, APIFUSE__RESOLVER__TIMEOUT_MS, DEFAULT_RESOLVER_TIMEOUT_MS, } from "./resolver-config.js";
+export { APIFUSE__CDP_POOL__URL, APIFUSE__RESOLVER__2CAPTCHA__API_KEY, APIFUSE__RESOLVER__CAPMONSTER__API_KEY, APIFUSE__RESOLVER__CAPSOLVER__API_KEY, APIFUSE__RESOLVER__HYPERSOLUTIONS__API_KEY, APIFUSE__RESOLVER__TIMEOUT_MS, DEFAULT_RESOLVER_TIMEOUT_MS, } from "./resolver-config.js";
 export { DEFAULT_RESOLVER_VENDOR_PREFERENCE, resolveProviderResolverVendors, } from "./resolver-vendors/types.js";
 type EnvLike = Record<string, string | undefined>;
 type ResolverChainClient = ResolverContext & {
@@ -12,6 +13,8 @@ type ResolverChainClient = ResolverContext & {
 export interface ResolverRuntimeOptions {
     readonly allowedHosts?: readonly string[];
     readonly cache?: ProviderCache;
+    /** Optional request-scoped observability sink; never used as resolver identity. */
+    readonly telemetry?: ResolverTelemetrySink;
     /** Inputs for SDK-owned lazy proxy resolution. The SDK never accepts a caller-built identity. */
     readonly proxyIntent?: {
         readonly mode: ProviderProxyMode;
@@ -65,6 +68,7 @@ export declare function createResolverClient(options: {
     readonly createTransport?: ResolverRuntimeOptions["createTransport"];
     readonly clientProfile?: string;
     readonly allowedHosts?: readonly string[];
+    readonly telemetry?: ResolverTelemetrySink;
 }): ResolverChainClient;
 export declare function bindResolverSignal(resolver: ResolverContext, defaultSignal: AbortSignal | undefined): ResolverContext;
 export declare function createResolverClientFromEnv(config: ProviderResolverConfig | undefined, env?: EnvLike, options?: ResolverRuntimeOptions): ResolverContext;