@apifuse/provider-sdk 2.2.0-beta.3 → 2.2.0-beta.4

package/bin/apifuse-record.ts

@@ -20,8 +20,8 @@ import {
 	type StealthClient,
 	TransportError,
 	ValidationError,
-} from "../src";
-import { createMemoryProviderRuntimeState } from "../src/runtime/state";
+} from "../src/index.js";
+import { createMemoryProviderRuntimeState } from "../src/runtime/state.js";
 
 type CliArgs = {
 	append: boolean;
@@ -64,31 +64,18 @@ export async function main() {
 			resolveOperationBaseUrl(provider, operationName),
 		);
 
-		console.log(
-			`[apifuse record] Calling ${operationName} on ${provider.id}...`,
-		);
+		console.log(`[apifuse record] Calling ${operationName} on ${provider.id}...`);
 
-		const result = await executeOperation(
-			provider,
-			operationName,
-			capture.ctx,
-			parsedParams,
-		);
+		const result = await executeOperation(provider, operationName, capture.ctx, parsedParams);
 		const captured = capture.getCapturedRaw();
 
 		if (captured === undefined) {
-			throw new Error(
-				`No upstream response was captured for ${provider.id}.${operationName}.`,
-			);
+			throw new Error(`No upstream response was captured for ${provider.id}.${operationName}.`);
 		}
 
 		const rawPayload = args.sanitize ? sanitizeFixture(captured) : captured;
 		const fixturePath = resolve(location.rootDir, "__fixtures__", "raw.json");
-		const nextPayload = await prepareFixturePayload(
-			fixturePath,
-			rawPayload,
-			args.append,
-		);
+		const nextPayload = await prepareFixturePayload(fixturePath, rawPayload, args.append);
 
 		await mkdir(dirname(fixturePath), { recursive: true });
 		await writeFile(fixturePath, `${JSON.stringify(nextPayload, null, 2)}\n`);
@@ -98,9 +85,7 @@ export async function main() {
 				Buffer.byteLength(JSON.stringify(rawPayload)),
 			)})`,
 		);
-		console.log(
-			`[apifuse record] Saved to ${relative(process.cwd(), fixturePath)}`,
-		);
+		console.log(`[apifuse record] Saved to ${relative(process.cwd(), fixturePath)}`);
 
 		void result;
 	} catch (error) {
@@ -210,11 +195,7 @@ function formatCliError(error: unknown): string {
 	}
 
 	if (error instanceof ProviderError || error instanceof ValidationError) {
-		return [
-			error.message,
-			error.code ? `code=${error.code}` : undefined,
-			error.fix,
-		]
+		return [error.message, error.code ? `code=${error.code}` : undefined, error.fix]
 			.filter(Boolean)
 			.join(" ");
 	}
@@ -269,8 +250,7 @@ function findProviderRoot(startDirectory: string): string | undefined {
 
 function looksLikeProviderRoot(directory: string): boolean {
 	return (
-		existsSync(resolve(directory, "index.ts")) &&
-		existsSync(resolve(directory, "package.json"))
+		existsSync(resolve(directory, "index.ts")) && existsSync(resolve(directory, "package.json"))
 	);
 }
 
@@ -287,15 +267,10 @@ async function loadProvider(rootDir: string): Promise<ProviderRuntime> {
 	return module.default;
 }
 
-function resolveOperationName(
-	provider: ProviderRuntime,
-	operationName?: string,
-): string {
+function resolveOperationName(provider: ProviderRuntime, operationName?: string): string {
 	if (operationName) {
 		if (!(operationName in provider.operations)) {
-			throw new Error(
-				`Unknown operation "${operationName}" for provider "${provider.id}".`,
-			);
+			throw new Error(`Unknown operation "${operationName}" for provider "${provider.id}".`);
 		}
 
 		return operationName;
@@ -309,10 +284,7 @@ function resolveOperationName(
 	return firstOperation;
 }
 
-function parseParams(
-	operation: ProviderRuntime["operations"][string],
-	value: string,
-): unknown {
+function parseParams(operation: ProviderRuntime["operations"][string], value: string): unknown {
 	let parsed: unknown;
 
 	try {
@@ -326,10 +298,7 @@ function parseParams(
 	return operation.input ? operation.input.parse(parsed) : parsed;
 }
 
-function resolveOperationBaseUrl(
-	provider: ProviderRuntime,
-	operationName: string,
-): string {
+function resolveOperationBaseUrl(provider: ProviderRuntime, operationName: string): string {
 	const baseUrl = provider.operations[operationName]?.upstream?.baseUrl;
 	if (!baseUrl) {
 		throw new Error(
@@ -346,12 +315,9 @@ function createCaptureContext(provider: ProviderRuntime, baseUrl: string) {
 	const http = proxyHttpClient(createHttpClient(baseUrl), (response) => {
 		capturedRaw = response.data;
 	});
-	const stealth = proxyStealthClient(
-		createStealthClient(baseUrl),
-		(response) => {
-			capturedRaw = normalizeCapturedStealthResponse(response);
-		},
-	);
+	const stealth = proxyStealthClient(createStealthClient(baseUrl), (response) => {
+		capturedRaw = normalizeCapturedStealthResponse(response);
+	});
 
 	const env = {
 		get: (key: string) => process.env[key],
@@ -464,9 +430,7 @@ function proxyStealthSession(
 	};
 }
 
-function normalizeCapturedStealthResponse(
-	response: Awaited<ReturnType<StealthClient["fetch"]>>,
-) {
+function normalizeCapturedStealthResponse(response: Awaited<ReturnType<StealthClient["fetch"]>>) {
 	try {
 		return JSON.parse(response.body);
 	} catch {
@@ -483,15 +447,13 @@ function sanitizeFixture(value: unknown): unknown {
 		return value;
 	}
 
-	const entries = Object.entries(value as MutableRecord).map(
-		([key, entryValue]) => {
-			if (isSensitiveKey(key)) {
-				return [key, "[REDACTED]"] as const;
-			}
+	const entries = Object.entries(value as MutableRecord).map(([key, entryValue]) => {
+		if (isSensitiveKey(key)) {
+			return [key, "[REDACTED]"] as const;
+		}
 
-			return [key, sanitizeFixture(entryValue)] as const;
-		},
-	);
+		return [key, sanitizeFixture(entryValue)] as const;
+	});
 
 	return Object.fromEntries(entries);
 }

package/bin/apifuse-submit-check.ts

@@ -11,16 +11,16 @@ import * as acorn from "acorn";
 import { z } from "zod";
 
 import packageJson from "../package.json";
-import type { ProviderDefinition } from "../src";
+import type { ProviderDefinition } from "../src/index.js";
 import {
 	loadProviderLocaleCatalogs,
 	type ProviderLocale,
 	validateProviderLocaleCatalogs,
-} from "../src/i18n";
-import { APIFUSE_DESCRIPTION_KEY_META_KEY } from "../src/schema";
-import { safeParseSchemaSync } from "../src/schema";
-import { type CheckResult, runChecks } from "./apifuse-check";
-import { hasSubstantiveXmlStructure } from "./submit-check-xml";
+} from "../src/i18n/index.js";
+import { APIFUSE_DESCRIPTION_KEY_META_KEY } from "../src/schema.js";
+import { safeParseSchemaSync } from "../src/schema.js";
+import { type CheckResult, runChecks } from "./apifuse-check.js";
+import { hasSubstantiveXmlStructure } from "./submit-check-xml.js";
 
 const TIERS = ["bronze", "silver", "gold", "diamond"] as const;
 const TIER_VALUES: ReadonlySet<string> = new Set(TIERS);
@@ -1980,10 +1980,7 @@ function scoreFixtureCoverage(provider: ProviderDefinition): SubmitCheck {
 
 const GENERATED_LOCAL_ONLY_SCAFFOLD_REASON = /generated local-only scaffold/i;
 
-function scoreFixtureProvenance(
-	providerRoot: string,
-	provider: ProviderDefinition,
-): SubmitCheck {
+function scoreFixtureProvenance(providerRoot: string, provider: ProviderDefinition): SubmitCheck {
 	const rawPath = resolve(providerRoot, "__fixtures__", "raw.json");
 	let hasRecordedEvidence = false;
 	if (existsSync(rawPath)) {
@@ -2090,12 +2087,17 @@ function allOperationsAreGeneratedLocalScaffold(provider: ProviderDefinition): b
 }
 
 function scoreVendorKeyLeak(providerRoot: string): SubmitCheck {
-	return escapeHatchResult(providerRoot, "vendor-key-leak", findVendorKeyLeakFindings(providerRoot), {
-		blockerMessage: "Public schema keys leak raw vendor field names.",
-		remediation:
-			"Normalize public request/response fields to APIFuse-standard lowerCamelCase names (e.g. isOpen24h, latitude); keep raw vendor keys only in upstream-parsing schemas (const upstream... = z.object(...)). Add `// @apifuse-allow vendor-key-leak` only with a comment explaining why the vendor name is genuinely canonical.",
-		passMessage: "No vendor field-name leaks detected in public schemas.",
-	});
+	return escapeHatchResult(
+		providerRoot,
+		"vendor-key-leak",
+		findVendorKeyLeakFindings(providerRoot),
+		{
+			blockerMessage: "Public schema keys leak raw vendor field names.",
+			remediation:
+				"Normalize public request/response fields to APIFuse-standard lowerCamelCase names (e.g. isOpen24h, latitude); keep raw vendor keys only in upstream-parsing schemas (const upstream... = z.object(...)). Add `// @apifuse-allow vendor-key-leak` only with a comment explaining why the vendor name is genuinely canonical.",
+			passMessage: "No vendor field-name leaks detected in public schemas.",
+		},
+	);
 }
 
 function scoreVendorTimestampLeak(providerRoot: string): SubmitCheck {
@@ -2282,9 +2284,7 @@ function collectTopLevelObjectKeys(
 			if (computedQuote === '"' || computedQuote === "'") {
 				const literalEnd = findStringEnd(source, literalStart);
 				const afterLiteral =
-					literalEnd === -1
-						? -1
-						: skipWhitespaceAndComments(masked, literalEnd + 1, computedEnd);
+					literalEnd === -1 ? -1 : skipWhitespaceAndComments(masked, literalEnd + 1, computedEnd);
 				if (literalEnd !== -1 && afterLiteral === computedEnd) {
 					key = source.slice(literalStart + 1, literalEnd);
 				}
@@ -2402,8 +2402,13 @@ function findNamedConstValueRanges(source: string): NamedObjectRange[] {
 	return ranges;
 }
 
-function findConstValueRangeContaining(source: string, offset: number): NamedObjectRange | undefined {
-	return findNamedConstValueRanges(source).find((range) => offset >= range.start && offset <= range.end);
+function findConstValueRangeContaining(
+	source: string,
+	offset: number,
+): NamedObjectRange | undefined {
+	return findNamedConstValueRanges(source).find(
+		(range) => offset >= range.start && offset <= range.end,
+	);
 }
 
 function findStringLiteralsInRange(

package/bin/apifuse.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 
 import packageJson from "../package.json";
-import { COMMAND_MANIFEST, COMMAND_ORDER } from "../src/cli/commands";
+import { COMMAND_MANIFEST, COMMAND_ORDER } from "../src/cli/commands.js";
 
 const command = process.argv[2];
 

package/bin/submit-check-xml.ts

@@ -14,7 +14,7 @@ import {
 	normalizedXmlName,
 	rootXmlContext,
 	type XmlSemanticBranch,
-} from "./submit-check-xml-semantics";
+} from "./submit-check-xml-semantics.js";
 
 const MIN_RECORDED_XML_LENGTH = 128;
 // Recorded fixtures must remain reviewable; this pre-allocation cap also bounds the parser tree.

package/dist/auth-turn/index.d.ts

@@ -1,4 +1,4 @@
-import type { AuthTurn } from "../types";
+import type { AuthTurn } from "../types.js";
 export type { AuthTurn };
 /**
  * Major version of the AuthTurn envelope contract.

package/dist/auth.d.ts

@@ -1,5 +1,5 @@
-import { AuthError } from "./errors";
-import type { AuthConfig, AuthFlowTerminalContext, AuthTurn, ContextDeclaration, CredentialDeclaration, FlowContext, ProviderLocaleKeyInput } from "./types";
+import { AuthError } from "./errors.js";
+import type { AuthConfig, AuthFlowTerminalContext, AuthTurn, ContextDeclaration, CredentialDeclaration, FlowContext, ProviderLocaleKeyInput } from "./types.js";
 export type CredentialsAuthFieldType = "string" | "email" | "password" | "otp";
 export interface CredentialsAuthField {
     type?: CredentialsAuthFieldType;

package/dist/auth.js

@@ -1,4 +1,4 @@
-import { AuthError, ProviderError } from "./errors";
+import { AuthError, ProviderError } from "./errors.js";
 const CREDENTIALS_AUTH_CHALLENGE_CONTEXT_KEY = "__credentialsAuthChallenge";
 const DEFAULT_COMPLETE_TURN_ID = "auth.complete";
 const DEFAULT_ABORT_TURN_ID = "auth.abort";
@@ -97,7 +97,7 @@ export function createAuthFlowHelpers(options = {}) {
                 },
             };
         },
-        abort({ code, message, retry, actionHint, fieldErrors, data, turnId, expiresAt, }) {
+        abort({ code, message, retry, actionHint, fieldErrors, data, turnId, expiresAt }) {
             return {
                 kind: "abort",
                 ...authTurnBase({ turnId, defaultTurnId: DEFAULT_ABORT_TURN_ID, expiresAt }),
@@ -169,12 +169,8 @@ function expectedInputFromFields(fields) {
                 ...(field.type === "password" ? { format: "password" } : {}),
                 ...(field.type === "otp" ? { format: "otp" } : {}),
                 ...(field.labelKey ? { nameKey: field.labelKey } : {}),
-                ...(field.descriptionKey
-                    ? { descriptionKey: field.descriptionKey }
-                    : {}),
-                ...(field.placeholderKey
-                    ? { placeholderKey: field.placeholderKey }
-                    : {}),
+                ...(field.descriptionKey ? { descriptionKey: field.descriptionKey } : {}),
+                ...(field.placeholderKey ? { placeholderKey: field.placeholderKey } : {}),
                 ...(field.sensitive || field.type === "password" || field.type === "otp"
                     ? { sensitive: true }
                     : {}),
@@ -291,17 +287,15 @@ function completeTurn(credentialKeys, result, defaultTurnId) {
     };
 }
 function challengeTurn(definition, request) {
-    const expectedInput = definition.fields
-        ? expectedInputFromFields(definition.fields)
-        : undefined;
+    const expectedInput = definition.fields ? expectedInputFromFields(definition.fields) : undefined;
     return {
         kind: expectedInput ? "form" : "pending",
         turnId: request.turnId ?? definition.turnId ?? `credentials.${request.challengeId}`,
         ...(request.expiresAt ? { expiresAt: request.expiresAt } : {}),
-        ...(request.hintKey ?? definition.hintKey
+        ...((request.hintKey ?? definition.hintKey)
             ? { hintKey: request.hintKey ?? definition.hintKey }
             : {}),
-        ...(request.timing ?? definition.timing
+        ...((request.timing ?? definition.timing)
             ? { timing: request.timing ?? definition.timing }
             : {}),
         ...(expectedInput ? { expectedInput } : {}),
@@ -378,7 +372,7 @@ async function pollPendingChallenge(ctx, credentialKeys, challenges, pending, co
 export function defineCredentialsAuth(options) {
     if (Object.keys(options.fields).length === 0) {
         throw new ProviderError("defineCredentialsAuth requires at least one field", {
-            fix: "Pass fields such as { email: { type: \"email\" }, password: { type: \"password\" } }.",
+            fix: 'Pass fields such as { email: { type: "email" }, password: { type: "password" } }.',
         });
     }
     const expectedInput = expectedInputFromFields(options.fields);
@@ -427,10 +421,7 @@ export function defineCredentialsAuth(options) {
             ...(options.justification ? { justification: options.justification } : {}),
         },
         context: {
-            keys: Array.from(new Set([
-                CREDENTIALS_AUTH_CHALLENGE_CONTEXT_KEY,
-                ...(options.contextKeys ?? []),
-            ])),
+            keys: Array.from(new Set([CREDENTIALS_AUTH_CHALLENGE_CONTEXT_KEY, ...(options.contextKeys ?? [])])),
         },
     };
 }

package/dist/ceremonies/index.d.ts

@@ -1,4 +1,4 @@
-import type { AuthFlowDefinition, AuthTurn } from "../types";
+import type { AuthFlowDefinition, AuthTurn } from "../types.js";
 type JsonObject = Record<string, unknown>;
 export declare function validateCeremonyOutput(turn: unknown): AuthTurn;
 export declare function createOAuth2Ceremony(options: {

package/dist/ceremonies/index.js

@@ -1,7 +1,7 @@
 import { createHash, randomBytes, randomUUID } from "node:crypto";
 import Ajv2020 from "ajv/dist/2020.js";
-import { AUTH_TURN_SCHEMA } from "../auth-turn";
-import { FlowExpiredError, ProviderSecretError, TurnValidationError, ValidationError, } from "../errors";
+import { AUTH_TURN_SCHEMA } from "../auth-turn/index.js";
+import { FlowExpiredError, ProviderSecretError, TurnValidationError, ValidationError, } from "../errors.js";
 const ajv = new Ajv2020({ allErrors: true, strict: true, strictSchema: true });
 // Runtime ceremony-output validation derives from the exported versioned
 // contract: it compiles the exact AUTH_TURN_SCHEMA document shipped at
@@ -38,11 +38,7 @@ function getRequiredEnv(ctx, key) {
     return value;
 }
 function toBase64Url(input) {
-    return input
-        .toString("base64")
-        .replace(/\+/g, "-")
-        .replace(/\//g, "_")
-        .replace(/=+$/g, "");
+    return input.toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/g, "");
 }
 function createCodeVerifier() {
     return toBase64Url(randomBytes(32));
@@ -100,8 +96,7 @@ function withDeclaredFormFieldOrder(expectedInput) {
         return expectedInput;
     }
     const existingOrder = expectedInput[FORM_FIELD_ORDER_EXTENSION];
-    if (Array.isArray(existingOrder) &&
-        existingOrder.every((value) => typeof value === "string")) {
+    if (Array.isArray(existingOrder) && existingOrder.every((value) => typeof value === "string")) {
         return expectedInput;
     }
     return {
@@ -218,8 +213,7 @@ export function createDeviceFlowCeremony(options) {
             });
             const data = ensureRecord(response.data);
             const errorCode = getString(data, "error");
-            if (errorCode === "authorization_pending" ||
-                errorCode === "slow_down") {
+            if (errorCode === "authorization_pending" || errorCode === "slow_down") {
                 return createTurn("poll", {
                     data,
                     hint: "Authorization pending.",
@@ -345,7 +339,7 @@ export function createFormCeremony(options) {
     return {
         start: async () => validateCeremonyOutput(buildJsonSchemaForm(options.schema, options.hint ?? "Provide the required input to continue.")),
         continue: (ctx, input = {}) => runCeremonyHandler(async () => {
-            const { prevalidate } = await import("../runtime/prevalidate");
+            const { prevalidate } = await import("../runtime/prevalidate.js");
             const result = prevalidate(options.schema, input);
             if (!result.valid) {
                 throw new ValidationError("Form input failed validation.", {
@@ -354,9 +348,7 @@ export function createFormCeremony(options) {
             }
             return createTurn("complete", {
                 data: {
-                    credential: options.mapCredential
-                        ? options.mapCredential(input)
-                        : input,
+                    credential: options.mapCredential ? options.mapCredential(input) : input,
                 },
                 hint: "Form completed.",
             });
@@ -428,9 +420,7 @@ export function createSwitchCeremony(options) {
         })),
         continue: (ctx, input = {}) => runCeremonyHandler(async () => {
             const storedChoice = ctx.context.get(SWITCH_SELECTION_KEY);
-            const choice = typeof storedChoice === "string"
-                ? storedChoice
-                : getString(input, "choice");
+            const choice = typeof storedChoice === "string" ? storedChoice : getString(input, "choice");
             if (!choice || !options.choices[choice]) {
                 throw new ValidationError("A valid choice is required.");
             }

package/dist/config/loader.d.ts

@@ -1,5 +1,5 @@
-import Redis from "ioredis";
-import type { ProviderProxyPolicy, TraceConfig } from "../types";
+import { Redis } from "ioredis";
+import type { ProviderProxyPolicy, TraceConfig } from "../types.js";
 export declare const SMARTPROXY_APP_KEY_ENV = "APIFUSE__PROXY__SMARTPROXY_APP_KEY";
 export declare const SMARTPROXY_MAX_LIFETIME_MINUTES = 2000;
 export declare const DEFAULT_SMARTPROXY_POOL_SIZE = 20;

package/dist/config/loader.js

@@ -1,7 +1,7 @@
 import { createHash, randomUUID } from "node:crypto";
 import { existsSync } from "node:fs";
 import path from "node:path";
-import Redis from "ioredis";
+import { Redis } from "ioredis";
 export const SMARTPROXY_APP_KEY_ENV = "APIFUSE__PROXY__SMARTPROXY_APP_KEY";
 export const SMARTPROXY_MAX_LIFETIME_MINUTES = 2000;
 export const DEFAULT_SMARTPROXY_POOL_SIZE = 20;
@@ -160,9 +160,7 @@ function toProxyDiagnostics(value) {
         return undefined;
     const diagnostics = {};
     for (const [key, item] of Object.entries(value)) {
-        if (typeof item === "string" ||
-            typeof item === "number" ||
-            typeof item === "boolean") {
+        if (typeof item === "string" || typeof item === "number" || typeof item === "boolean") {
             diagnostics[key] = item;
         }
     }
@@ -249,9 +247,7 @@ function applyStickyProxySession(proxyUrl) {
 }
 function buildSmartproxyUsername(username, sessionId, sessionDuration) {
     const parts = username.split("_");
-    const configuredLife = parts
-        .find((part) => part.startsWith("life-"))
-        ?.slice("life-".length);
+    const configuredLife = parts.find((part) => part.startsWith("life-"))?.slice("life-".length);
     const baseUsername = parts
         .filter((part) => !part.startsWith("session-") && !part.startsWith("life-"))
         .join("_");
@@ -259,9 +255,7 @@ function buildSmartproxyUsername(username, sessionId, sessionDuration) {
 }
 function buildDecodoUsername(username, sessionId, sessionDuration) {
     const withoutSticky = username.replace(/-session-.+-sessionduration-\d+$/, "");
-    const baseUsername = withoutSticky.startsWith("user-")
-        ? withoutSticky
-        : `user-${withoutSticky}`;
+    const baseUsername = withoutSticky.startsWith("user-") ? withoutSticky : `user-${withoutSticky}`;
     return `${baseUsername}-session-${sessionId}-sessionduration-${sessionDuration}`;
 }
 function syncProxyEnv(config) {
@@ -358,18 +352,13 @@ function resolvePolicy(options) {
     return undefined;
 }
 function resolveProxyProvider(policy) {
-    return (policy.provider ??
-        process.env[DEFAULT_PROXY_PROVIDER_ENV]?.trim().toLowerCase() ??
-        "custom");
+    return (policy.provider ?? process.env[DEFAULT_PROXY_PROVIDER_ENV]?.trim().toLowerCase() ?? "custom");
 }
 function resolveSmartproxyCountry(policy) {
-    return (policy.geo?.country ??
-        process.env[DEFAULT_PROXY_COUNTRY_ENV]?.trim().toUpperCase() ??
-        undefined);
+    return (policy.geo?.country ?? process.env[DEFAULT_PROXY_COUNTRY_ENV]?.trim().toUpperCase() ?? undefined);
 }
 function resolveSmartproxyLifetime(policy) {
-    const configuredLifetime = policy.session?.lifetimeMinutes ??
-        readPositiveNumberEnv(DEFAULT_PROXY_LIFETIME_ENV, 30);
+    const configuredLifetime = policy.session?.lifetimeMinutes ?? readPositiveNumberEnv(DEFAULT_PROXY_LIFETIME_ENV, 30);
     return Math.min(SMARTPROXY_MAX_LIFETIME_MINUTES, Math.max(1, Math.floor(configuredLifetime)));
 }
 function readPositiveNumberEnv(name, fallback) {
@@ -389,9 +378,7 @@ function selectProxyPoolIndex(poolSize, attempt = 0) {
     if (poolSize <= 1) {
         return 0;
     }
-    const normalizedAttempt = Number.isFinite(attempt)
-        ? Math.max(0, Math.floor(attempt))
-        : 0;
+    const normalizedAttempt = Number.isFinite(attempt) ? Math.max(0, Math.floor(attempt)) : 0;
     return normalizedAttempt % poolSize;
 }
 function buildSmartproxyCacheKey(policy, affinityKey, lifetimeMinutes) {
@@ -400,9 +387,7 @@ function buildSmartproxyCacheKey(policy, affinityKey, lifetimeMinutes) {
         provider: "smartproxy",
         country: resolveSmartproxyCountry(policy),
         affinity: policy.session?.affinity ?? "request",
-        affinityKey: (policy.session?.affinity ?? "request") === "request"
-            ? undefined
-            : affinityKey,
+        affinityKey: (policy.session?.affinity ?? "request") === "request" ? undefined : affinityKey,
         lifetimeMinutes,
         poolSize,
     });
@@ -499,9 +484,7 @@ async function allocateSmartproxyShared(cacheKey, policy, appKey, lifetimeMinute
         if (acquired === "OK") {
             try {
                 return await allocateAndStoreSmartproxyPool(cacheKey, policy, appKey, lifetimeMinutes, startedAt, {
-                    cacheStatus: options.background
-                        ? "soft_stale_refresh"
-                        : "allocator",
+                    cacheStatus: options.background ? "soft_stale_refresh" : "allocator",
                     redis,
                     poolKey,
                 });
@@ -526,8 +509,7 @@ async function allocateSmartproxyShared(cacheKey, policy, appKey, lifetimeMinute
         if (typeof pttl === "number" && pttl <= 0) {
             continue;
         }
-        if (Date.now() - startedAt >
-            SMARTPROXY_LOCK_POLL_MAX_MS - SMARTPROXY_DEADLINE_MARGIN_MS) {
+        if (Date.now() - startedAt > SMARTPROXY_LOCK_POLL_MAX_MS - SMARTPROXY_DEADLINE_MARGIN_MS) {
             break;
         }
         await sleep(Math.min(500, Math.max(50, typeof pttl === "number" ? pttl : 100)));
@@ -559,7 +541,7 @@ function sleep(ms, signal) {
     });
 }
 function smartproxyAllocatorDeadlineMs() {
-    return (smartproxyAllocatorDeadlineMsForTests ?? SMARTPROXY_ALLOCATOR_DEADLINE_MS);
+    return smartproxyAllocatorDeadlineMsForTests ?? SMARTPROXY_ALLOCATOR_DEADLINE_MS;
 }
 function createDeadlineAbortController(deadlineAt) {
     const controller = new AbortController();
@@ -649,9 +631,7 @@ async function allocateAndStoreSmartproxyPool(cacheKey, policy, appKey, lifetime
         }
     }
     const allocatorMs = Math.max(0, Date.now() - allocatorStartedAt);
-    const allocatorAttempts = allocation?.attempt ??
-        lastFailure?.attempt ??
-        SMARTPROXY_ALLOCATOR_MAX_ATTEMPTS;
+    const allocatorAttempts = allocation?.attempt ?? lastFailure?.attempt ?? SMARTPROXY_ALLOCATOR_MAX_ATTEMPTS;
     const allocatorBodyClass = lastFailure?.bodyClass ?? allocation?.bodyClass ?? "usable_proxy_endpoints";
     const allocatorStatus = lastFailure ? lastFailure.status : allocation?.status;
     if (!allocation) {
@@ -804,7 +784,9 @@ function buildSmartproxyAllocatorUrl(policy, appKey, lifetimeMinutes, poolSize)
     if (country) {
         params.set("cc", country);
     }
-    return `https://www.smartproxy.org/web_v1/ip/get-ip-v3?${params.toString()}`;
+    // www.smartproxy.org stopped serving the extraction API on 2026-07-21 (the
+    // old path 404s into the marketing site); the API lives on the api host.
+    return `https://api.smartproxy.org/web_v1/ip/get-ip-v3?${params.toString()}`;
 }
 function parseSmartproxyAllocatorProxies(body) {
     const trimmed = body.trim();
@@ -813,12 +795,8 @@ function parseSmartproxyAllocatorProxies(body) {
     }
     try {
         const parsed = JSON.parse(trimmed);
-        const data = parsed && typeof parsed === "object" && "data" in parsed
-            ? parsed.data
-            : undefined;
-        const list = data && typeof data === "object" && "list" in data
-            ? data.list
-            : undefined;
+        const data = parsed && typeof parsed === "object" && "data" in parsed ? parsed.data : undefined;
+        const list = data && typeof data === "object" && "list" in data ? data.list : undefined;
         if (Array.isArray(list)) {
             return list
                 .map((item) => {
@@ -826,8 +804,7 @@ function parseSmartproxyAllocatorProxies(body) {
                     return null;
                 }
                 const ip = "ip" in item && typeof item.ip === "string" ? item.ip : "";
-                const port = "port" in item &&
-                    (typeof item.port === "string" || typeof item.port === "number")
+                const port = "port" in item && (typeof item.port === "string" || typeof item.port === "number")
                     ? item.port
                     : "";
                 return ip && port ? `http://${ip}:${port}` : null;

package/dist/contract-serialization.d.ts

@@ -1,4 +1,4 @@
-import { type JsonValue } from "./contract-json";
-import type { SchemaLike } from "./types";
+import { type JsonValue } from "./contract-json.js";
+import type { SchemaLike } from "./types.js";
 export declare function describeSchema(schema: SchemaLike): JsonValue;
 export declare function serializeSmsMatcher(value: Record<string, unknown>): Record<string, unknown>;

package/dist/contract-serialization.js

@@ -1,6 +1,6 @@
 import { createHash } from "node:crypto";
 import { z } from "zod";
-import { canonicalJson, compactObject, isRecord, toJsonValue, } from "./contract-json";
+import { canonicalJson, compactObject, isRecord, toJsonValue, } from "./contract-json.js";
 export function describeSchema(schema) {
     if (isZodSchema(schema)) {
         const jsonSchema = zodJsonSchema(schema);
@@ -9,9 +9,7 @@ export function describeSchema(schema) {
             vendor: "zod",
             typeName: getSchemaTypeName(schema),
             jsonSchema,
-            jsonSchemaHash: jsonSchema === undefined
-                ? undefined
-                : digest(canonicalJson(jsonSchema)),
+            jsonSchemaHash: jsonSchema === undefined ? undefined : digest(canonicalJson(jsonSchema)),
         });
     }
     const standard = isRecord(schema) ? schema["~standard"] : undefined;
@@ -20,8 +18,7 @@ export function describeSchema(schema) {
             kind: "schema",
             standard: "standard-schema-v1",
             vendor: typeof standard.vendor === "string" ? standard.vendor : "unknown",
-            version: typeof standard.version === "number" ||
-                typeof standard.version === "string"
+            version: typeof standard.version === "number" || typeof standard.version === "string"
                 ? standard.version
                 : undefined,
         });

package/dist/contract-types.d.ts

@@ -1,5 +1,5 @@
-import type { JsonValue } from "./contract-json";
-import type { ProviderDefinition } from "./types";
+import type { JsonValue } from "./contract-json.js";
+import type { ProviderDefinition } from "./types.js";
 export declare const PROVIDER_CONTRACT_SCHEMA_VERSION = "2026-06-23";
 export interface ProviderContractSnapshot {
     readonly schemaVersion: typeof PROVIDER_CONTRACT_SCHEMA_VERSION;