@contractspec/integration.providers-impls 2.10.0 → 3.0.0

package/README.md

@@ -75,7 +75,8 @@ Connection config example:
   "allowUnofficial": false,
   "unofficialAllowList": ["health.peloton"],
   "apiBaseUrl": "https://api.provider.example",
-  "mcpUrl": "https://mcp.provider.example"
+  "mcpUrl": "https://mcp.provider.example",
+  "oauthTokenUrl": "https://api.provider.example/oauth/token"
 }
 ```
 
@@ -85,6 +86,10 @@ Secret payload example (`secretRef` target value):
 {
   "apiKey": "provider-api-key",
   "accessToken": "oauth-access-token",
+  "refreshToken": "oauth-refresh-token",
+  "clientId": "oauth-client-id",
+  "clientSecret": "oauth-client-secret",
+  "tokenExpiresAt": "2026-02-01T00:00:00.000Z",
   "mcpAccessToken": "mcp-access-token",
   "webhookSecret": "webhook-signature-secret"
 }
@@ -94,6 +99,7 @@ Notes:
 
 - Unofficial routing is disabled unless `allowUnofficial: true`.
 - When `unofficialAllowList` is provided, only listed `health.*` keys can use unofficial routing.
+- Unofficial routing expects MCP transport (`mcpUrl`) plus either `mcpAccessToken` or automation credentials.
 - If a selected strategy is unavailable, the resolver falls through `strategyOrder`.
 
 ## Supabase integrations

package/dist/impls/async-event-queue.d.ts

@@ -0,0 +1,8 @@
+export declare class AsyncEventQueue<T> implements AsyncIterable<T> {
+    private readonly values;
+    private readonly waiters;
+    private done;
+    push(value: T): void;
+    close(): void;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}

package/dist/impls/async-event-queue.js

@@ -0,0 +1,47 @@
+// @bun
+// src/impls/async-event-queue.ts
+class AsyncEventQueue {
+  values = [];
+  waiters = [];
+  done = false;
+  push(value) {
+    if (this.done) {
+      return;
+    }
+    const waiter = this.waiters.shift();
+    if (waiter) {
+      waiter({ value, done: false });
+      return;
+    }
+    this.values.push(value);
+  }
+  close() {
+    if (this.done) {
+      return;
+    }
+    this.done = true;
+    for (const waiter of this.waiters) {
+      waiter({ value: undefined, done: true });
+    }
+    this.waiters.length = 0;
+  }
+  [Symbol.asyncIterator]() {
+    return {
+      next: async () => {
+        const value = this.values.shift();
+        if (value != null) {
+          return { value, done: false };
+        }
+        if (this.done) {
+          return { value: undefined, done: true };
+        }
+        return new Promise((resolve) => {
+          this.waiters.push(resolve);
+        });
+      }
+    };
+  }
+}
+export {
+  AsyncEventQueue
+};

package/dist/impls/health/base-health-provider.d.ts

@@ -1,5 +1,13 @@
-import type { HealthConnectionStatus, HealthDataSource, HealthListActivitiesParams, HealthListActivitiesResult, HealthListBiometricsParams, HealthListBiometricsResult, HealthListNutritionParams, HealthListNutritionResult, HealthListSleepParams, HealthListSleepResult, HealthListWorkoutsParams, HealthListWorkoutsResult, HealthProvider, HealthSyncRequest, HealthSyncResult, HealthWebhookEvent, HealthWebhookRequest } from '../../health';
+import type { HealthActivity, HealthBiometric, HealthConnectionStatus, HealthDataSource, HealthListActivitiesParams, HealthListActivitiesResult, HealthListBiometricsParams, HealthListBiometricsResult, HealthListNutritionParams, HealthListNutritionResult, HealthListSleepParams, HealthListSleepResult, HealthListWorkoutsParams, HealthListWorkoutsResult, HealthNutrition, HealthProvider, HealthSleep, HealthSyncRequest, HealthSyncResult, HealthWebhookEvent, HealthWebhookRequest, HealthWorkout } from '../../health';
 import type { HealthTransportStrategy } from '@contractspec/integration.runtime/runtime';
+type UnknownRecord = Record<string, unknown>;
+interface OAuthOptions {
+    tokenUrl?: string;
+    refreshToken?: string;
+    clientId?: string;
+    clientSecret?: string;
+    tokenExpiresAt?: string;
+}
 export interface BaseHealthProviderOptions {
     providerKey: string;
     transport: HealthTransportStrategy;
@@ -9,25 +17,51 @@ export interface BaseHealthProviderOptions {
     accessToken?: string;
     mcpAccessToken?: string;
     webhookSecret?: string;
+    webhookSignatureHeader?: string;
+    route?: 'primary' | 'fallback';
+    aggregatorKey?: string;
+    oauth?: OAuthOptions;
     fetchFn?: typeof fetch;
 }
+interface DatasetFetchConfig<P, T> {
+    apiPath?: string;
+    mcpTool: string;
+    listKeys?: readonly string[];
+    method?: 'GET' | 'POST';
+    buildQuery?: (params: P) => UnknownRecord;
+    buildBody?: (params: P) => UnknownRecord;
+    mapItem: (item: UnknownRecord, params: P) => T | undefined;
+}
+interface ConnectionStatusConfig {
+    apiPath?: string;
+    mcpTool: string;
+}
+export declare class HealthProviderCapabilityError extends Error {
+    readonly code = "NOT_SUPPORTED";
+    constructor(message: string);
+}
 export declare class BaseHealthProvider implements HealthProvider {
-    private readonly providerKey;
-    private readonly transport;
-    private readonly apiBaseUrl;
+    protected readonly providerKey: string;
+    protected readonly transport: HealthTransportStrategy;
+    private readonly apiBaseUrl?;
     private readonly mcpUrl?;
     private readonly apiKey?;
-    private readonly accessToken?;
+    private accessToken?;
+    private refreshToken?;
     private readonly mcpAccessToken?;
     private readonly webhookSecret?;
+    private readonly webhookSignatureHeader;
+    private readonly route;
+    private readonly aggregatorKey?;
+    private readonly oauth;
     private readonly fetchFn;
     private mcpRequestId;
     constructor(options: BaseHealthProviderOptions);
-    listActivities(params: HealthListActivitiesParams): Promise<HealthListActivitiesResult>;
-    listWorkouts(params: HealthListWorkoutsParams): Promise<HealthListWorkoutsResult>;
-    listSleep(params: HealthListSleepParams): Promise<HealthListSleepResult>;
-    listBiometrics(params: HealthListBiometricsParams): Promise<HealthListBiometricsResult>;
-    listNutrition(params: HealthListNutritionParams): Promise<HealthListNutritionResult>;
+    listActivities(_params: HealthListActivitiesParams): Promise<HealthListActivitiesResult>;
+    listWorkouts(_params: HealthListWorkoutsParams): Promise<HealthListWorkoutsResult>;
+    listSleep(_params: HealthListSleepParams): Promise<HealthListSleepResult>;
+    listBiometrics(_params: HealthListBiometricsParams): Promise<HealthListBiometricsResult>;
+    listNutrition(_params: HealthListNutritionParams): Promise<HealthListNutritionResult>;
     getConnectionStatus(params: {
         tenantId: string;
         connectionId: string;
@@ -39,9 +73,26 @@ export declare class BaseHealthProvider implements HealthProvider {
     syncNutrition(params: HealthSyncRequest): Promise<HealthSyncResult>;
     parseWebhook(request: HealthWebhookRequest): Promise<HealthWebhookEvent>;
     verifyWebhook(request: HealthWebhookRequest): Promise<boolean>;
+    protected fetchActivities(params: HealthListActivitiesParams, config: DatasetFetchConfig<HealthListActivitiesParams, HealthActivity>): Promise<HealthListActivitiesResult>;
+    protected fetchWorkouts(params: HealthListWorkoutsParams, config: DatasetFetchConfig<HealthListWorkoutsParams, HealthWorkout>): Promise<HealthListWorkoutsResult>;
+    protected fetchSleep(params: HealthListSleepParams, config: DatasetFetchConfig<HealthListSleepParams, HealthSleep>): Promise<HealthListSleepResult>;
+    protected fetchBiometrics(params: HealthListBiometricsParams, config: DatasetFetchConfig<HealthListBiometricsParams, HealthBiometric>): Promise<HealthListBiometricsResult>;
+    protected fetchNutrition(params: HealthListNutritionParams, config: DatasetFetchConfig<HealthListNutritionParams, HealthNutrition>): Promise<HealthListNutritionResult>;
+    protected fetchConnectionStatus(params: {
+        tenantId: string;
+        connectionId: string;
+    }, config: ConnectionStatusConfig): Promise<HealthConnectionStatus>;
+    protected currentSource(): HealthDataSource;
+    protected providerSlug(): string;
+    protected unsupported(capability: string): HealthProviderCapabilityError;
+    private syncFromList;
     private fetchList;
-    private sync;
-    private fetchRecord;
+    private fetchPayload;
+    private isMcpTransport;
+    private requestApi;
     private callMcpTool;
-    protected currentSource(): HealthDataSource;
+    private authorizationHeaders;
+    private refreshAccessToken;
+    private readResponsePayload;
 }
+export {};