@apifuse/provider-sdk 2.2.0-beta.7 → 2.2.0-beta.70

package/src/index.ts

@@ -2,14 +2,20 @@
 
 export * from "./auth.js";
 export * from "./ceremonies/index.js";
-export * from "./choice-token.js";
 export type {
 	ApiFuseConfig,
 	BrowserConfig,
-	ProxyConfig,
+	ProxyCacheStatus,
+	ProxyProtocol,
+	ProxyResolutionOptions,
+	ProxyResolutionSource,
+	ProxyUserAgentSource,
+	ProxyVendorName,
+	ResolvedProxyConfig,
 	SessionConfig,
+	SmartproxyAllocatorBodyClass,
 } from "./config/loader.js";
-export { defineConfig, loadApiFuseConfig } from "./config/loader.js";
+export { defineConfig, loadApiFuseConfig, resolveProxy } from "./config/loader.js";
 export {
 	canonicalJson,
 	digestProviderContract,
@@ -29,35 +35,140 @@ export {
 	defineSmsOtpMatcher,
 	defineStreamOperation,
 	every,
-	type ProviderConfig,
+	type AuthStartNoInputGuard,
+	type OperationDefinitionFor,
+	type ProviderBuilder,
+	type ProviderContextOf,
+	type ProviderDeclaration,
+	type ProviderDefinitionFor,
 } from "./define.js";
+export {
+	AssertionExpressionSchema,
+	AssertionPredicateSchema,
+	AssertStepSchema,
+	BoundedJsonPathSchema,
+	CandidateBlockSchema,
+	CandidatePolicySchema,
+	CredentialRefDeclarationSchema,
+	defineHealthScenario,
+	HealthScenarioSchema,
+	HealthStepSchema,
+	ExtractStepSchema,
+	FindFirstSchema,
+	GUARD_REASON_CODES,
+	GuardStepSchema,
+	JournalPolicySchema,
+	JsonTemplateSchema,
+	ManualTriggerPolicySchema,
+	OperandSchema,
+	OperationStepSchema,
+	QuantifierSchema,
+	ReferenceSchema,
+	RetryPolicySchema,
+	SafeRegexSchema,
+	ScopedAssertionExpressionSchema,
+	ScopedAssertionPredicateSchema,
+	ScopedItemReferenceSchema,
+	ScopedOperandSchema,
+	StepReferenceSchema,
+	RelativeDateNodeSchema,
+	ValueTypeSchema,
+} from "./health-scenario.js";
+export type {
+	AssertionExpression,
+	AssertionPredicate,
+	AttemptReference,
+	AssertResult,
+	AssertStep,
+	BoundedJsonPath,
+	CandidateBlock,
+	CandidatePolicy,
+	CandidateReference,
+	CredentialReference,
+	CredentialRefDeclaration,
+	EstablishedConnectionReference,
+	ExtractStep,
+	FindFirst,
+	GuardAttribution,
+	GuardReasonCode,
+	GuardResult,
+	GuardStep,
+	HealthScenario,
+	HealthStep,
+	JsonTemplate,
+	JournalPolicy,
+	ManualTriggerPolicy,
+	NonEmpty,
+	OperationResult,
+	OperationStep,
+	Operand,
+	Quantifier,
+	ReferenceNode,
+	Reference,
+	RelativeDateNode,
+	RetryPolicy,
+	SafeRegex,
+	ScopedAssertionExpression,
+	ScopedAssertionPredicate,
+	ScopedItemReference,
+	ScopedOperand,
+	StepBase,
+	StepReference,
+	ExtractResult,
+	ValueType,
+} from "./health-scenario.js";
 export type { DevServerOptions } from "./dev.js";
 export { createDevServer, startDevServer } from "./dev.js";
 export * from "./errors.js";
+export * from "./engine.js";
+export * from "./observability.js";
 export * from "./user-input.js";
 export * from "./i18n/index.js";
 export {
 	type LintDiagnostic,
 	lintOperation,
 	lintProvider,
+	type ProviderLintInformation,
+	type ProviderLintResult,
 } from "./lint.js";
+export {
+	type LintRuntimeBoundarySourcesOptions,
+	lintRuntimeBoundarySources,
+	RUNTIME_BOUNDARY_RULES,
+	type RuntimeBoundaryRule,
+} from "./runtime-boundary-lint.js";
+export {
+	TYPESCRIPT_COMPILER_MODULE_SPECIFIERS,
+	type TypeScriptCompilerModuleLike,
+} from "./typescript-module.js";
 export * from "./recipes/gov-api.js";
 export * from "./recipes/rest-api.js";
 export { createFlowContext, createScratchpad } from "./runtime/auth-flow.js";
 export type { BrowserClientOptions } from "./runtime/browser.js";
-export { BrowserClient, createBrowserClient } from "./runtime/browser.js";
 export {
+	APIFUSE__CACHE__KEY_PEPPER_ENV,
 	createBypassProviderCache,
 	createProviderCache,
 	type ProviderCacheOptions,
-	resetProviderCacheForTests,
 } from "./runtime/cache.js";
+export * from "./handle.js";
 export {
-	type CreateProviderChoiceContextOptions,
-	createProviderChoiceContext,
-	createTestProviderChoiceContext,
-	PROVIDER_RUNTIME_CHOICE_TOKEN_MASTER_SECRET_ENV,
-} from "./runtime/choice.js";
+	APIFUSE_HANDLE_META_KEY,
+	HANDLE_KIND_NAME_PATTERN,
+	handleFieldDescription,
+	handleFieldNameFor,
+	handleHasDirectionalFieldNames,
+	isHandleFieldMeta,
+} from "./handle-meta.js";
+export {
+	type CreateHandleContextOptions,
+	type CreateTestHandleContextOptions,
+	createHandleContext,
+	createTestHandleContext,
+	type HandleNormalizationClass,
+	type NormalizedHandle,
+	normalizeHandle,
+} from "./runtime/handle.js";
 export {
 	type CreateCredentialContextOptions,
 	createCredentialContext,
@@ -65,6 +176,38 @@ export {
 export { createEnvContext } from "./runtime/env.js";
 export { executeOperation } from "./runtime/executor.js";
 export { createHttpClient } from "./runtime/http.js";
+export {
+	OcrTelemetryCollector,
+	bindOcrTelemetry,
+	type OcrTelemetryBackend,
+	type OcrTelemetryEngine,
+	type OcrTelemetryErrorCode,
+	type OcrTelemetryEvent,
+	type OcrTelemetryFinishReason,
+	type OcrTelemetryHeaderPayload,
+	type OcrTelemetryLogPayload,
+	type OcrTelemetryModel,
+	type OcrTelemetrySink,
+} from "./runtime/ocr-telemetry.js";
+export {
+	NativeEgressGrantExpiredError,
+	NativeEgressNotDeclaredError,
+	NativeIdleTimeoutError,
+	NativeNetworkError,
+	NativeProxyExpiredError,
+} from "./runtime/native-network-errors.js";
+export type {
+	NativeGatewayProxy,
+	NativeGatewayProxyResolutionInput,
+	NativeGatewayProxySkipReason,
+	NativeGatewayProxySynthesizer,
+	NativeGatewayProxySynthesisResult,
+	NativeGatewayProxySynthesisInput,
+	NativeNetworkClientOptions,
+	NativeNetworkErrorCode,
+	VendorCredentialLookup,
+	VendorCredentialResolver,
+} from "./runtime/native-network.js";
 export type { Insight, InsightSeverity } from "./runtime/insights.js";
 export { generateInsights } from "./runtime/insights.js";
 export {
@@ -72,18 +215,126 @@ export {
 	type InstrumentedProviderContext,
 	wrapWithInstrumentation,
 } from "./runtime/instrumentation.js";
-export { type PrevalidateResult, prevalidate } from "./runtime/prevalidate.js";
+export type { PrevalidateResult } from "./runtime/prevalidate.js";
 export { getProviderBaseUrl } from "./runtime/provider.js";
+export type {
+	ProxyTelemetryHeaderPayload,
+	ProxyHash,
+	ProxyTelemetryLogPayload,
+	ProxyTelemetryResolvedPayload,
+	ProxyTelemetryUnresolvedPayload,
+} from "./runtime/proxy-telemetry.js";
+export {
+	RequestTelemetry,
+	closedEnum,
+	type ClosedEnum,
+	type GatewayIngestible,
+	type RequestTelemetryLogPayload,
+	type SpanIndex,
+	type TelemetryContributor,
+	type TelemetryKey,
+	type TenantNeutral,
+} from "./runtime/request-telemetry.js";
+export { APIFUSE__ENGINE__CEREMONY_LEASE_KEY } from "./runtime/egress-lease.js";
+export {
+	ResolverTelemetryCollector,
+	type ResolverCacheReadTelemetryEvent,
+	type ResolverCacheWriteTelemetryEvent,
+	type ResolverFailoverTelemetryEvent,
+	type ResolverIdentityTelemetryEvent,
+	type ResolverOutcomeTelemetryEvent,
+	type ResolverTelemetryAttemptOutcome,
+	type ResolverAttemptSample,
+	type ResolverTelemetryCacheStatus,
+	type ResolverTelemetryCacheWriteReason,
+	type ResolverTelemetryErrorClass,
+	type ResolverTelemetryHeaderPayload,
+	type ResolverTelemetryIdentitySource,
+	type ResolverTelemetryLogPayload,
+	type ResolverTelemetryOutcome,
+	type ResolverTelemetryPhase,
+	type ResolverTelemetrySink,
+	type ResolverVendorAttemptTelemetryEvent,
+} from "./runtime/resolver-telemetry.js";
+export {
+	StealthTelemetryCollector,
+	type StealthTelemetryAttemptEvent,
+	type StealthTelemetryAttemptKind,
+	type StealthTelemetryAttemptSample,
+	type StealthTelemetryDiagnostics,
+	type StealthTelemetryErrorCode,
+	type StealthTelemetryHeaderPayload,
+	type StealthTelemetryLogPayload,
+	type StealthTelemetryRequestClass,
+	type StealthTelemetrySbsdEvent,
+	type StealthTelemetrySbsdOutcome,
+	type StealthTelemetrySink,
+} from "./runtime/stealth-telemetry.js";
+export {
+	SttTelemetryCollector,
+	bindSttTelemetry,
+	type SttTelemetryBackend,
+	type SttTelemetryEngine,
+	type SttTelemetryModel,
+	type SttTelemetryErrorCode,
+	type SttTelemetryEvent,
+	type SttTelemetryHeaderPayload,
+	type SttTelemetryLogPayload,
+	type SttTelemetrySink,
+} from "./runtime/stt-telemetry.js";
+
+export {
+	BrowserTelemetryCollector,
+	type BrowserTelemetryErrorCode,
+	type BrowserTelemetryHeaderPayload,
+	type BrowserTelemetryLogPayload,
+	type BrowserTelemetryPoolAcquireOutcome,
+	type BrowserTelemetrySink,
+	type BrowserTelemetrySampleName,
+	type BrowserTelemetryEngine,
+} from "./runtime/browser-telemetry.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 "./runtime/resolver-config.js";
+export { createUnsupportedResolverClient } from "./runtime/resolver-shared.js";
+export type { ResolverRuntimeOptions } from "./runtime/resolver.js";
+export type {
+	ResolverPaidUsageContext,
+	ResolverVendorTransport,
+	ResolverVendorUnavailableReason,
+} from "./runtime/resolver-vendors/types.js";
 export {
 	assertRequiredSecretsPresent,
 	listMissingRequiredSecrets,
 	MISSING_SECRET_CODE,
 } from "./runtime/secrets.js";
 export {
+	createMemoryProviderRuntimeState,
 	createUnsupportedProviderRuntimeState,
 	UnsupportedProviderStateError,
 } from "./runtime/state.js";
-export { createStealthClient } from "./runtime/stealth.js";
+export {
+	APIFUSE__OCR__API_KEY_ENV,
+	APIFUSE__OCR__BACKEND_ENV,
+	APIFUSE__OCR__BASE_URL_ENV,
+	APIFUSE__OCR__CLOUDFLARE_API_TOKEN_ENV,
+	APIFUSE__OCR__MODEL_ENV,
+	CLOUDFLARE_ACCOUNT_ID_ENV,
+	CLOUDFLARE_WORKERS_AI_OCR_BACKEND,
+	createCloudflareWorkersAiOcrClient,
+	createOcrClientFromEnv,
+	createOpenAiCompatibleOcrClient,
+	createUnsupportedOcrClient,
+	DEFAULT_CLOUDFLARE_WORKERS_AI_OCR_MODEL,
+	extractCaptchaCandidates,
+	OPENAI_COMPATIBLE_OCR_BACKEND,
+} from "./runtime/ocr.js";
 export {
 	APIFUSE__STT__BACKEND_ENV,
 	APIFUSE__STT__CLOUDFLARE_API_TOKEN_ENV,
@@ -99,7 +350,10 @@ export {
 	type Span,
 	type TraceContext,
 } from "./runtime/trace.js";
+export type { DiagnosticRedactor } from "./runtime/diagnostic-redactor.js";
 export {
+	APIFUSE_CONTENT_PROVENANCE_META_KEY,
+	APIFUSE_CONTENT_TRUST_META_KEY,
 	APIFUSE_DESCRIPTION_KEY_META_KEY,
 	APIFUSE_REDACTION_MARKER,
 	APIFUSE_SENSITIVE_KIND_META_KEY,
@@ -109,15 +363,29 @@ export {
 	field,
 	fields,
 	isSensitiveSchema,
+	publicField,
 	redactPayload,
 	type SensitiveFieldKind,
 	type SensitiveFieldOptions,
 	type SensitivePath,
 	sensitive,
+	untrustedContent,
 	z,
 } from "./schema.js";
-export { createServerApp, type ServeOptions, serve } from "./server/index.js";
-export { getStealthProfile, listStealthProfiles } from "./stealth/profiles.js";
+export {
+	createServerApp,
+	createServerAppAsync,
+	ERROR_OBSERVABILITY_HEADER,
+	type ProviderErrorCauseFrame,
+	type ServeOptions,
+	serve,
+} from "./server/serve.js";
+export {
+	DEFAULT_STEALTH_BROWSER,
+	DEFAULT_STEALTH_OS,
+	getStealthProfile,
+	listStealthProfiles,
+} from "./stealth/profiles.js";
 export * from "./stream.js";
 export type {
 	ApiFuseResponse,
@@ -129,6 +397,7 @@ export type {
 	AuthMode,
 	AuthTurn,
 	Bcp47Locale,
+	BrowserCookie,
 	BrowserEngine,
 	BrowserOptions,
 	BrowserResourceBody,
@@ -137,6 +406,7 @@ export type {
 	BrowserResourcePolicy,
 	BrowserResourceRequest,
 	BrowserResourceRoute,
+	ChallengeSolution,
 	ConnectionMode,
 	ContextDeclaration,
 	CookieJar,
@@ -163,8 +433,13 @@ export type {
 	HealthScheduleRandomization,
 	HealthJourneySmsContext,
 	HealthJourneyStep,
+	HttpAttemptContext,
 	HttpClient,
+	HttpHeadersFactory,
 	HttpMethod,
+	HttpRedirectFailureReason,
+	HttpRedirectPolicy,
+	HttpRedirectPolicyMode,
 	HttpResponse,
 	HttpRetryOptions,
 	HttpRetrySummary,
@@ -174,22 +449,47 @@ export type {
 	Iso3166Alpha2CountryCode,
 	Iso4217CurrencyCode,
 	Iso8601Duration,
-	OperationAnnotations,
+	NativeContext,
+	NativeNetworkClient,
+	NativeNetworkCloseReason,
+	NativeNetworkConnection,
+	NativeNetworkConnectInput,
+	NativeNetworkConnectOptions,
+	NativeNetworkDynamicGrantOptions,
+	NativeNetworkEgressGrant,
+	NativeProviderConfig,
+	NativeProxyDrainHandler,
+	NativeProxyEgressInfo,
+	NativeProxyExpiringEvent,
+	NativeProxyExpiringReason,
+	NativeTcpDynamicEgressRule,
+	NativeTcpEgressGrant,
+	NativeTcpEgressRule,
+	NativeTcpPortRange,
+	NativeTcpTlsMode,
+	NativeTlsConnectOptions,
+	OcrCaptchaCandidate,
+	OcrCaptchaOptions,
+	OcrCaptchaResult,
+	OcrContext,
+	OcrImageInput,
+	OcrRecognizeRequest,
+	OcrResult,
+	OcrWarning,
 	OperationApprovalPolicy,
 	OperationContractMetadata,
 	OperationDefinition,
 	OperationDeprecationMetadata,
-	OperationDocMeta,
+	OperationExample,
 	OperationErrorCode,
+	ProviderErrorStatus,
 	OperationHandlerResult,
-	OperationInputExample,
 	OperationLifecycle,
 	OperationObservabilityConfig,
 	OperationObservabilitySensitiveConfig,
 	OperationRelationships,
 	OperationRiskClass,
 	OperationSensitivePath,
-	OperationToolRouterMetadata,
 	OperationTransport,
 	OperationTransportKind,
 	ProbeInterval,
@@ -201,13 +501,14 @@ export type {
 	ProviderCacheLookupMeta,
 	ProviderCacheResponseMeta,
 	ProviderCacheResult,
-	ProviderChoiceBindingOptions,
-	ProviderChoiceContext,
-	ProviderChoiceIssueOptions,
-	ProviderChoiceParseOptions,
+	ProviderChallenge,
+	ProviderChallengeKind,
 	ProviderContext,
+	ProviderContextFor,
 	ProviderDefinition,
 	ProviderDeploymentOverrides,
+	ProviderFileRef,
+	ProviderFilesContext,
 	ProviderHealthMonitorConfig,
 	ProviderHealthProbeConfig,
 	ProviderLocale,
@@ -216,16 +517,24 @@ export type {
 	ProviderLogoProfile,
 	ProviderLogoSource,
 	ProviderMeta,
+	ProviderOcrConfig,
 	ProviderProxyConfig,
 	ProviderProxyMode,
 	ProviderProxyPolicy,
+	ProxiedOAuthConfig,
 	ProviderProxyProvider,
 	ProviderProxySessionAffinity,
 	ProviderPublicConnectionMode,
 	ProviderPublicProfile,
 	ProviderReviewed,
+	ProviderResolvedFile,
+	ProviderResolverConfig,
+	ProviderResolverVendor,
+	ProviderRuntimeTarget,
 	ProviderRuntimeState,
 	ProviderSecretDeclaration,
+	ProviderSecretIssuer,
+	ProviderStealthConfig,
 	ProviderStateDurationString,
 	ProviderStateNamespace,
 	ProviderStreamEvent,
@@ -233,6 +542,8 @@ export type {
 	ProviderSttMode,
 	ProviderSupportLevel,
 	RequestOptions,
+	RedirectRunReason,
+	ResolverContext,
 	Rfc3339Instant,
 	SchemaLike,
 	SmsOrigin,
@@ -242,12 +553,20 @@ export type {
 	StandardSchemaV1,
 	StateCasResult,
 	StateNamespaceOptions,
+	StateNamespaceScope,
 	StateValue,
 	StateWriteOptions,
 	StealthClient,
+	StealthBrowser,
+	StealthChallengeClassification,
+	StealthCookieStore,
+	StealthCookieStoreV1,
 	StealthFetchOptions,
 	StealthPlatform,
 	StealthProfile,
+	StealthProfileDescriptor,
+	StealthProfileSelection,
+	StealthOS,
 	StealthRedirectHop,
 	StealthRedirectRunOptions,
 	StealthRedirectRunResult,
@@ -292,3 +611,51 @@ export * from "./utils/date.js";
 export * from "./utils/parse.js";
 export * from "./utils/text.js";
 export * from "./utils/transform.js";
+
+export {
+	HttpTelemetryCollector,
+	type HttpTelemetrySink,
+	type HttpTelemetryRequestSink,
+	type HttpAttemptTelemetryEvent,
+	type HttpAttemptSample,
+	type HttpTelemetryErrorCode,
+	type HttpTelemetryRetryPayload,
+	type HttpTelemetryLogPayload,
+	type HttpTelemetryHeaderPayload,
+} from "./runtime/http-telemetry.js";
+
+export {
+	NativeTelemetryCollector,
+	type NativeAttemptSample,
+	type NativeConnectTelemetryEvent,
+	type NativeLifecycleTelemetryEvent,
+	type NativeTelemetryDiagnostics,
+	type NativeTelemetryErrorCode,
+	type NativeTelemetryHeaderPayload,
+	type NativeTelemetryKind,
+	type NativeTelemetryLifecycleKind,
+	type NativeTelemetryLogPayload,
+	type NativeTelemetryOutcome,
+	type NativeTelemetrySink,
+	type NativeTelemetryVendorSkipReason,
+	type NativeVendorSkipTelemetryEvent,
+} from "./runtime/native-telemetry.js";
+export {
+	CacheTelemetryCollector,
+	type CacheTelemetryHeaderPayload,
+	type CacheTelemetryLogPayload,
+	type CacheTelemetrySample,
+	type CacheTelemetrySink,
+	type CacheTelemetrySource,
+} from "./runtime/cache-telemetry.js";
+export {
+	StateTelemetryCollector,
+	instrumentProviderRuntimeState,
+	type StateTelemetryBackend,
+	type StateTelemetryHeaderPayload,
+	type StateTelemetryLogPayload,
+	type StateTelemetryOperation,
+	type StateTelemetrySample,
+	type StateTelemetrySink,
+	type StateTelemetryViolation,
+} from "./runtime/state-telemetry.js";