@apifuse/provider-sdk 2.1.0-beta.9 → 2.2.0-beta.10

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;

package/dist/contract.d.ts

@@ -1,6 +1,6 @@
-import { canonicalJson, type JsonPrimitive, type JsonValue } from "./contract-json";
-import { PROVIDER_CONTRACT_SCHEMA_VERSION, type ProviderContractOperation, type ProviderContractSnapshot } from "./contract-types";
-import type { ProviderDefinition } from "./types";
+import { canonicalJson, type JsonPrimitive, type JsonValue } from "./contract-json.js";
+import { PROVIDER_CONTRACT_SCHEMA_VERSION, type ProviderContractOperation, type ProviderContractSnapshot } from "./contract-types.js";
+import type { ProviderDefinition } from "./types.js";
 export { canonicalJson, type JsonPrimitive, type JsonValue, PROVIDER_CONTRACT_SCHEMA_VERSION, type ProviderContractOperation, type ProviderContractSnapshot, };
 export declare function extractProviderContract(provider: ProviderDefinition): ProviderContractSnapshot;
 export declare function digestProviderContract(snapshot: ProviderContractSnapshot): string;

package/dist/contract.js

@@ -1,7 +1,7 @@
 import { createHash } from "node:crypto";
-import { canonicalJson, compactObject, copyRecordWithout, toJsonValue, } from "./contract-json";
-import { describeSchema, serializeSmsMatcher } from "./contract-serialization";
-import { PROVIDER_CONTRACT_SCHEMA_VERSION, } from "./contract-types";
+import { canonicalJson, compactObject, copyRecordWithout, toJsonValue, } from "./contract-json.js";
+import { describeSchema, serializeSmsMatcher } from "./contract-serialization.js";
+import { PROVIDER_CONTRACT_SCHEMA_VERSION, } from "./contract-types.js";
 export { canonicalJson, PROVIDER_CONTRACT_SCHEMA_VERSION, };
 export function extractProviderContract(provider) {
     const auth = extractAuth(provider.auth);
@@ -27,9 +27,7 @@ export function extractProviderContract(provider) {
         operations: Object.entries(provider.operations)
             .sort(([leftId], [rightId]) => leftId.localeCompare(rightId))
             .map(([operationId, operation]) => extractOperation(operationId, operation)),
-        ...(provider.allowedHosts
-            ? { allowedHosts: [...provider.allowedHosts].sort() }
-            : {}),
+        ...(provider.allowedHosts ? { allowedHosts: [...provider.allowedHosts].sort() } : {}),
         ...(stealth === undefined ? {} : { stealth }),
         ...(proxy === undefined ? {} : { proxy }),
         ...(stt === undefined ? {} : { stt }),
@@ -122,6 +120,7 @@ function extractHealthCheck(value) {
         return undefined;
     return compactObject({
         interval: value.interval,
+        schedule: toJsonValue(value.schedule),
         timeoutMs: value.timeoutMs,
         degradedThresholdMs: value.degradedThresholdMs,
         requiresConnection: value.requiresConnection,

package/dist/define.d.ts

@@ -1,4 +1,4 @@
-import type { AuthConfig, BrowserEngine, ContextDeclaration, CredentialDeclaration, HealthJourneyDefinition, HealthJourneySchedule, InferSchemaOutput, OperationDefinition, OperationHandlerResult, OperationHttpStreamTransport, OperationSseTransport, OperationWebSocketTransport, ProviderAccessConfig, ProviderDefinition, ProviderHealthMonitorConfig, ProviderProxyConfig, ProviderPublicProfile, ProviderReviewed, ProviderSecretDeclaration, ProviderStreamEvent, ProviderSttConfig, SchemaLike, SmsOtpMatcherDefinition, StealthPlatform } from "./types";
+import type { AuthConfig, BrowserEngine, ContextDeclaration, CredentialDeclaration, HealthJourneyDefinition, HealthJourneySchedule, HealthScheduleRandomization, InferSchemaOutput, OperationDefinition, OperationHandlerResult, OperationHttpStreamTransport, OperationSseTransport, OperationWebSocketTransport, ProviderAccessConfig, ProviderDefinition, ProviderDeploymentOverrides, ProviderHealthMonitorConfig, ProviderProxyConfig, ProviderPublicProfile, ProviderReviewed, ProviderSecretDeclaration, ProviderStreamEvent, ProviderSttConfig, SchemaLike, SmsOtpMatcherDefinition, StealthPlatform } from "./types.js";
 type ProviderImplementationSourceAccess = "official_api" | "private_api" | "browser_flow" | "hybrid";
 type ProviderImplementationCredentialStrategy = "apifuse_managed" | "workspace_secret" | "user_oauth" | "user_session" | "none";
 interface ProviderImplementationProfile {
@@ -41,6 +41,13 @@ export interface ProviderConfig<TOperations extends Record<string, ProviderOpera
     id: string;
     version: string;
     runtime: "standard" | "shared" | "browser";
+    /**
+     * Optional deployment overrides, passed through verbatim onto the returned
+     * provider definition. The SDK types this field but does not deep-validate
+     * it — the APIFuse registry builder owns deployment validation and
+     * resolves omitted fields against the runtime deployment profiles.
+     */
+    deployment?: ProviderDeploymentOverrides;
     allowedHosts?: string[];
     stealth?: {
         profile: string;
@@ -80,6 +87,8 @@ export interface ProviderConfig<TOperations extends Record<string, ProviderOpera
     };
     operations: OperationMapConfig<TOperations>;
     healthMonitor?: ProviderHealthMonitorConfig;
+    /** New name for `healthMonitor` (transitional alias); declaring both is a ValidationError. */
+    healthProbe?: ProviderHealthMonitorConfig;
     healthJourneys?: readonly HealthJourneyDefinition[];
 }
 /** Define one provider operation with schema-driven handler inference. */
@@ -88,7 +97,10 @@ export declare function defineOperation<TInput extends SchemaLike, TOutput exten
 export declare function defineStreamOperation<TInput extends SchemaLike, TOutput extends SchemaLike>(operation: StreamOperationConfig<TInput, TOutput>): OperationDefinition<TInput, TOutput>;
 export declare function every(interval: string, options?: {
     jitter?: string;
+    randomize?: HealthScheduleRandomization;
 }): HealthJourneySchedule;
+export declare function centered(maxOffset: string): HealthScheduleRandomization;
+export declare function delayed(maxDelay: string): HealthScheduleRandomization;
 export declare function defineSmsOtpMatcher(config: Omit<SmsOtpMatcherDefinition, "extractOtp">): SmsOtpMatcherDefinition;
 export declare function defineHealthJourney(config: HealthJourneyDefinition): HealthJourneyDefinition;
 export declare function defineProvider<TOperations extends Record<string, ProviderOperation>, TConfig extends ProviderConfig<TOperations>>(config: TConfig & AuthStartNoInputGuard<TConfig>): ProviderDefinition & {