@contractspec/integration.runtime 3.0.0 → 3.2.0

package/dist/transport/auth-resolver.js

@@ -0,0 +1,52 @@
+// @bun
+// src/transport/auth-resolver.ts
+import { findAuthConfig } from "@contractspec/lib.contracts-integrations/integrations/auth";
+import {
+  buildAuthHeaders,
+  refreshOAuth2Token,
+  isOAuth2TokenExpired
+} from "@contractspec/lib.contracts-integrations/integrations/auth-helpers";
+async function resolveAuth(options) {
+  const authConfig = findAuthConfig(options.supportedAuthMethods, options.activeAuthMethod);
+  if (!authConfig) {
+    return { headers: {}, tokenRefreshed: false };
+  }
+  if (authConfig.type === "oauth2" && options.oauth2State) {
+    if (isOAuth2TokenExpired(options.oauth2State)) {
+      const clientId = options.secrets.clientId ?? "";
+      const clientSecret = options.secrets.clientSecret ?? "";
+      try {
+        const newState = await refreshOAuth2Token(authConfig, options.oauth2State, { clientId, clientSecret }, options.fetchFn);
+        const mergedSecrets2 = {
+          ...options.secrets,
+          accessToken: newState.accessToken
+        };
+        return {
+          headers: buildAuthHeaders(authConfig, mergedSecrets2),
+          tokenRefreshed: true,
+          updatedOAuth2State: newState
+        };
+      } catch {
+        return {
+          headers: buildAuthHeaders(authConfig, options.secrets),
+          tokenRefreshed: false
+        };
+      }
+    }
+    const mergedSecrets = {
+      ...options.secrets,
+      accessToken: options.oauth2State.accessToken
+    };
+    return {
+      headers: buildAuthHeaders(authConfig, mergedSecrets),
+      tokenRefreshed: false
+    };
+  }
+  return {
+    headers: buildAuthHeaders(authConfig, options.secrets),
+    tokenRefreshed: false
+  };
+}
+export {
+  resolveAuth
+};

package/dist/transport/index.d.ts

@@ -0,0 +1,3 @@
+export * from './transport-factory';
+export * from './auth-resolver';
+export * from './version-negotiator';

package/dist/transport/index.js

@@ -0,0 +1,163 @@
+// @bun
+// src/transport/transport-factory.ts
+import { findTransportConfig } from "@contractspec/lib.contracts-integrations/integrations/transport";
+
+class RestTransportClient {
+  config;
+  authHeaders;
+  fetchFn;
+  type = "rest";
+  constructor(config, authHeaders = {}, fetchFn = globalThis.fetch) {
+    this.config = config;
+    this.authHeaders = authHeaders;
+    this.fetchFn = fetchFn;
+  }
+  async request(method, path, options) {
+    const url = new URL(path, this.config.baseUrl ?? "https://localhost");
+    if (options?.queryParams) {
+      for (const [key, value] of Object.entries(options.queryParams)) {
+        url.searchParams.set(key, value);
+      }
+    }
+    const headers = {
+      ...this.config.defaultHeaders,
+      ...this.authHeaders,
+      ...options?.headers
+    };
+    if (options?.body && !headers["Content-Type"]) {
+      headers["Content-Type"] = "application/json";
+    }
+    const response = await this.fetchFn(url.toString(), {
+      method,
+      headers,
+      body: options?.body ? JSON.stringify(options.body) : undefined,
+      signal: options?.signal
+    });
+    const responseHeaders = {};
+    response.headers.forEach((value, key) => {
+      responseHeaders[key] = value;
+    });
+    const data = await response.json().catch(() => null);
+    let rateLimitRemaining;
+    let rateLimitReset;
+    if (this.config.rateLimitHeaders) {
+      const remaining = responseHeaders[this.config.rateLimitHeaders.remaining];
+      const reset = responseHeaders[this.config.rateLimitHeaders.reset];
+      if (remaining)
+        rateLimitRemaining = Number(remaining);
+      if (reset)
+        rateLimitReset = Number(reset);
+    }
+    return {
+      data,
+      status: response.status,
+      headers: responseHeaders,
+      rateLimitRemaining,
+      rateLimitReset
+    };
+  }
+}
+function createTransportClient(transports, targetType, authHeaders = {}, fetchFn) {
+  const config = findTransportConfig(transports, targetType);
+  if (!config)
+    return;
+  switch (config.type) {
+    case "rest":
+      return new RestTransportClient(config, authHeaders, fetchFn);
+    case "mcp":
+    case "webhook":
+    case "sdk":
+      return;
+    default:
+      return;
+  }
+}
+
+// src/transport/auth-resolver.ts
+import { findAuthConfig } from "@contractspec/lib.contracts-integrations/integrations/auth";
+import {
+  buildAuthHeaders,
+  refreshOAuth2Token,
+  isOAuth2TokenExpired
+} from "@contractspec/lib.contracts-integrations/integrations/auth-helpers";
+async function resolveAuth(options) {
+  const authConfig = findAuthConfig(options.supportedAuthMethods, options.activeAuthMethod);
+  if (!authConfig) {
+    return { headers: {}, tokenRefreshed: false };
+  }
+  if (authConfig.type === "oauth2" && options.oauth2State) {
+    if (isOAuth2TokenExpired(options.oauth2State)) {
+      const clientId = options.secrets.clientId ?? "";
+      const clientSecret = options.secrets.clientSecret ?? "";
+      try {
+        const newState = await refreshOAuth2Token(authConfig, options.oauth2State, { clientId, clientSecret }, options.fetchFn);
+        const mergedSecrets2 = {
+          ...options.secrets,
+          accessToken: newState.accessToken
+        };
+        return {
+          headers: buildAuthHeaders(authConfig, mergedSecrets2),
+          tokenRefreshed: true,
+          updatedOAuth2State: newState
+        };
+      } catch {
+        return {
+          headers: buildAuthHeaders(authConfig, options.secrets),
+          tokenRefreshed: false
+        };
+      }
+    }
+    const mergedSecrets = {
+      ...options.secrets,
+      accessToken: options.oauth2State.accessToken
+    };
+    return {
+      headers: buildAuthHeaders(authConfig, mergedSecrets),
+      tokenRefreshed: false
+    };
+  }
+  return {
+    headers: buildAuthHeaders(authConfig, options.secrets),
+    tokenRefreshed: false
+  };
+}
+
+// src/transport/version-negotiator.ts
+import {
+  resolveApiVersion,
+  isVersionDeprecated
+} from "@contractspec/lib.contracts-integrations/integrations/versioning";
+function negotiateVersion(policy, connectionOverride) {
+  if (!policy) {
+    return {
+      resolvedVersion: undefined,
+      deprecated: false,
+      versionHeaders: {},
+      versionQueryParams: {}
+    };
+  }
+  const version = resolveApiVersion(policy, connectionOverride);
+  const deprecated = version ? isVersionDeprecated(policy, version) : false;
+  const versionHeaders = {};
+  const versionQueryParams = {};
+  if (version) {
+    if (policy.versionHeader) {
+      versionHeaders[policy.versionHeader] = version;
+    }
+    if (policy.versionQueryParam) {
+      versionQueryParams[policy.versionQueryParam] = version;
+    }
+  }
+  return {
+    resolvedVersion: version,
+    deprecated,
+    versionHeaders,
+    versionQueryParams
+  };
+}
+export {
+  resolveAuth,
+  negotiateVersion,
+  createTransportClient,
+  RestTransportClient
+};

package/dist/transport/transport-factory.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Factory for creating transport clients from integration transport configs.
+ */
+import type { IntegrationTransportConfig, IntegrationTransportType, RestTransportConfig } from '@contractspec/lib.contracts-integrations/integrations/transport';
+export interface TransportClient {
+    readonly type: IntegrationTransportType;
+    request<T>(method: string, path: string, options?: TransportRequestOptions): Promise<TransportResponse<T>>;
+}
+export interface TransportRequestOptions {
+    body?: unknown;
+    headers?: Record<string, string>;
+    queryParams?: Record<string, string>;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface TransportResponse<T> {
+    data: T;
+    status: number;
+    headers: Record<string, string>;
+    rateLimitRemaining?: number;
+    rateLimitReset?: number;
+}
+export declare class RestTransportClient implements TransportClient {
+    private readonly config;
+    private readonly authHeaders;
+    private readonly fetchFn;
+    readonly type: "rest";
+    constructor(config: RestTransportConfig, authHeaders?: Record<string, string>, fetchFn?: typeof globalThis.fetch);
+    request<T>(method: string, path: string, options?: TransportRequestOptions): Promise<TransportResponse<T>>;
+}
+export declare function createTransportClient(transports: IntegrationTransportConfig[], targetType: IntegrationTransportType, authHeaders?: Record<string, string>, fetchFn?: typeof globalThis.fetch): TransportClient | undefined;

package/dist/transport/transport-factory.js

@@ -0,0 +1,78 @@
+// @bun
+// src/transport/transport-factory.ts
+import { findTransportConfig } from "@contractspec/lib.contracts-integrations/integrations/transport";
+
+class RestTransportClient {
+  config;
+  authHeaders;
+  fetchFn;
+  type = "rest";
+  constructor(config, authHeaders = {}, fetchFn = globalThis.fetch) {
+    this.config = config;
+    this.authHeaders = authHeaders;
+    this.fetchFn = fetchFn;
+  }
+  async request(method, path, options) {
+    const url = new URL(path, this.config.baseUrl ?? "https://localhost");
+    if (options?.queryParams) {
+      for (const [key, value] of Object.entries(options.queryParams)) {
+        url.searchParams.set(key, value);
+      }
+    }
+    const headers = {
+      ...this.config.defaultHeaders,
+      ...this.authHeaders,
+      ...options?.headers
+    };
+    if (options?.body && !headers["Content-Type"]) {
+      headers["Content-Type"] = "application/json";
+    }
+    const response = await this.fetchFn(url.toString(), {
+      method,
+      headers,
+      body: options?.body ? JSON.stringify(options.body) : undefined,
+      signal: options?.signal
+    });
+    const responseHeaders = {};
+    response.headers.forEach((value, key) => {
+      responseHeaders[key] = value;
+    });
+    const data = await response.json().catch(() => null);
+    let rateLimitRemaining;
+    let rateLimitReset;
+    if (this.config.rateLimitHeaders) {
+      const remaining = responseHeaders[this.config.rateLimitHeaders.remaining];
+      const reset = responseHeaders[this.config.rateLimitHeaders.reset];
+      if (remaining)
+        rateLimitRemaining = Number(remaining);
+      if (reset)
+        rateLimitReset = Number(reset);
+    }
+    return {
+      data,
+      status: response.status,
+      headers: responseHeaders,
+      rateLimitRemaining,
+      rateLimitReset
+    };
+  }
+}
+function createTransportClient(transports, targetType, authHeaders = {}, fetchFn) {
+  const config = findTransportConfig(transports, targetType);
+  if (!config)
+    return;
+  switch (config.type) {
+    case "rest":
+      return new RestTransportClient(config, authHeaders, fetchFn);
+    case "mcp":
+    case "webhook":
+    case "sdk":
+      return;
+    default:
+      return;
+  }
+}
+export {
+  createTransportClient,
+  RestTransportClient
+};

package/dist/transport/version-negotiator.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Negotiates and applies API versioning for integration requests.
+ */
+import type { IntegrationVersionPolicy } from '@contractspec/lib.contracts-integrations/integrations/versioning';
+export interface VersionNegotiationResult {
+    resolvedVersion: string | undefined;
+    deprecated: boolean;
+    versionHeaders: Record<string, string>;
+    versionQueryParams: Record<string, string>;
+}
+/**
+ * Negotiate the API version and produce headers/params to include in requests.
+ */
+export declare function negotiateVersion(policy: IntegrationVersionPolicy | undefined, connectionOverride?: string): VersionNegotiationResult;

package/dist/transport/version-negotiator.js

@@ -0,0 +1,37 @@
+// @bun
+// src/transport/version-negotiator.ts
+import {
+  resolveApiVersion,
+  isVersionDeprecated
+} from "@contractspec/lib.contracts-integrations/integrations/versioning";
+function negotiateVersion(policy, connectionOverride) {
+  if (!policy) {
+    return {
+      resolvedVersion: undefined,
+      deprecated: false,
+      versionHeaders: {},
+      versionQueryParams: {}
+    };
+  }
+  const version = resolveApiVersion(policy, connectionOverride);
+  const deprecated = version ? isVersionDeprecated(policy, version) : false;
+  const versionHeaders = {};
+  const versionQueryParams = {};
+  if (version) {
+    if (policy.versionHeader) {
+      versionHeaders[policy.versionHeader] = version;
+    }
+    if (policy.versionQueryParam) {
+      versionQueryParams[policy.versionQueryParam] = version;
+    }
+  }
+  return {
+    resolvedVersion: version,
+    deprecated,
+    versionHeaders,
+    versionQueryParams
+  };
+}
+export {
+  negotiateVersion
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/integration.runtime",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "Runtime integration with secret management",
   "keywords": [
     "contractspec",
@@ -31,19 +31,19 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "3.0.0",
-    "@contractspec/lib.contracts-integrations": "3.0.0",
-    "@contractspec/lib.logger": "3.0.0",
+    "@contractspec/lib.contracts-spec": "3.2.0",
+    "@contractspec/lib.contracts-integrations": "3.2.0",
+    "@contractspec/lib.logger": "3.2.0",
     "@google-cloud/secret-manager": "^6.1.1",
     "google-gax": "^5.0.0"
   },
   "optionalDependencies": {
-    "pg": "^8.19.0"
+    "pg": "^8.20.0"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.0.0",
+    "@contractspec/tool.typescript": "3.2.0",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.0.0"
+    "@contractspec/tool.bun": "3.2.0"
   },
   "exports": {
     ".": {
@@ -201,6 +201,36 @@
       "bun": "./dist/secrets/provider.js",
       "node": "./dist/node/secrets/provider.js",
       "default": "./dist/secrets/provider.js"
+    },
+    "./transport": {
+      "types": "./dist/transport/index.d.ts",
+      "bun": "./dist/transport/index.js",
+      "node": "./dist/node/transport/index.js",
+      "default": "./dist/transport/index.js"
+    },
+    "./transport/auth-resolver": {
+      "types": "./dist/transport/auth-resolver.d.ts",
+      "bun": "./dist/transport/auth-resolver.js",
+      "node": "./dist/node/transport/auth-resolver.js",
+      "default": "./dist/transport/auth-resolver.js"
+    },
+    "./transport/index": {
+      "types": "./dist/transport/index.d.ts",
+      "bun": "./dist/transport/index.js",
+      "node": "./dist/node/transport/index.js",
+      "default": "./dist/transport/index.js"
+    },
+    "./transport/transport-factory": {
+      "types": "./dist/transport/transport-factory.d.ts",
+      "bun": "./dist/transport/transport-factory.js",
+      "node": "./dist/node/transport/transport-factory.js",
+      "default": "./dist/transport/transport-factory.js"
+    },
+    "./transport/version-negotiator": {
+      "types": "./dist/transport/version-negotiator.d.ts",
+      "bun": "./dist/transport/version-negotiator.js",
+      "node": "./dist/node/transport/version-negotiator.js",
+      "default": "./dist/transport/version-negotiator.js"
     }
   },
   "publishConfig": {
@@ -361,6 +391,36 @@
         "bun": "./dist/secrets/provider.js",
         "node": "./dist/node/secrets/provider.js",
         "default": "./dist/secrets/provider.js"
+      },
+      "./transport": {
+        "types": "./dist/transport/index.d.ts",
+        "bun": "./dist/transport/index.js",
+        "node": "./dist/node/transport/index.js",
+        "default": "./dist/transport/index.js"
+      },
+      "./transport/auth-resolver": {
+        "types": "./dist/transport/auth-resolver.d.ts",
+        "bun": "./dist/transport/auth-resolver.js",
+        "node": "./dist/node/transport/auth-resolver.js",
+        "default": "./dist/transport/auth-resolver.js"
+      },
+      "./transport/index": {
+        "types": "./dist/transport/index.d.ts",
+        "bun": "./dist/transport/index.js",
+        "node": "./dist/node/transport/index.js",
+        "default": "./dist/transport/index.js"
+      },
+      "./transport/transport-factory": {
+        "types": "./dist/transport/transport-factory.d.ts",
+        "bun": "./dist/transport/transport-factory.js",
+        "node": "./dist/node/transport/transport-factory.js",
+        "default": "./dist/transport/transport-factory.js"
+      },
+      "./transport/version-negotiator": {
+        "types": "./dist/transport/version-negotiator.d.ts",
+        "bun": "./dist/transport/version-negotiator.js",
+        "node": "./dist/node/transport/version-negotiator.js",
+        "default": "./dist/transport/version-negotiator.js"
       }
     },
     "registry": "https://registry.npmjs.org/"