@contractspec/integration.runtime 2.10.0 → 3.1.1

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": "2.10.0",
+  "version": "3.1.1",
   "description": "Runtime integration with secret management",
   "keywords": [
     "contractspec",
@@ -31,16 +31,19 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "2.10.0",
-    "@contractspec/lib.contracts-integrations": "2.10.0",
-    "@contractspec/lib.logger": "2.9.0",
+    "@contractspec/lib.contracts-spec": "3.1.1",
+    "@contractspec/lib.contracts-integrations": "3.1.1",
+    "@contractspec/lib.logger": "3.1.0",
     "@google-cloud/secret-manager": "^6.1.1",
     "google-gax": "^5.0.0"
   },
+  "optionalDependencies": {
+    "pg": "^8.20.0"
+  },
   "devDependencies": {
-    "@contractspec/tool.typescript": "2.9.0",
+    "@contractspec/tool.typescript": "3.1.0",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "2.9.0"
+    "@contractspec/tool.bun": "3.1.0"
   },
   "exports": {
     ".": {
@@ -49,6 +52,108 @@
       "node": "./dist/node/index.js",
       "default": "./dist/index.js"
     },
+    "./channel": {
+      "types": "./dist/channel/index.d.ts",
+      "bun": "./dist/channel/index.js",
+      "node": "./dist/node/channel/index.js",
+      "default": "./dist/channel/index.js"
+    },
+    "./channel/dispatcher": {
+      "types": "./dist/channel/dispatcher.d.ts",
+      "bun": "./dist/channel/dispatcher.js",
+      "node": "./dist/node/channel/dispatcher.js",
+      "default": "./dist/channel/dispatcher.js"
+    },
+    "./channel/github": {
+      "types": "./dist/channel/github.d.ts",
+      "bun": "./dist/channel/github.js",
+      "node": "./dist/node/channel/github.js",
+      "default": "./dist/channel/github.js"
+    },
+    "./channel/index": {
+      "types": "./dist/channel/index.d.ts",
+      "bun": "./dist/channel/index.js",
+      "node": "./dist/node/channel/index.js",
+      "default": "./dist/channel/index.js"
+    },
+    "./channel/memory-store": {
+      "types": "./dist/channel/memory-store.d.ts",
+      "bun": "./dist/channel/memory-store.js",
+      "node": "./dist/node/channel/memory-store.js",
+      "default": "./dist/channel/memory-store.js"
+    },
+    "./channel/policy": {
+      "types": "./dist/channel/policy.d.ts",
+      "bun": "./dist/channel/policy.js",
+      "node": "./dist/node/channel/policy.js",
+      "default": "./dist/channel/policy.js"
+    },
+    "./channel/postgres-queries": {
+      "types": "./dist/channel/postgres-queries.d.ts",
+      "bun": "./dist/channel/postgres-queries.js",
+      "node": "./dist/node/channel/postgres-queries.js",
+      "default": "./dist/channel/postgres-queries.js"
+    },
+    "./channel/postgres-schema": {
+      "types": "./dist/channel/postgres-schema.d.ts",
+      "bun": "./dist/channel/postgres-schema.js",
+      "node": "./dist/node/channel/postgres-schema.js",
+      "default": "./dist/channel/postgres-schema.js"
+    },
+    "./channel/postgres-store": {
+      "types": "./dist/channel/postgres-store.d.ts",
+      "bun": "./dist/channel/postgres-store.js",
+      "node": "./dist/node/channel/postgres-store.js",
+      "default": "./dist/channel/postgres-store.js"
+    },
+    "./channel/replay-fixtures": {
+      "types": "./dist/channel/replay-fixtures.d.ts",
+      "bun": "./dist/channel/replay-fixtures.js",
+      "node": "./dist/node/channel/replay-fixtures.js",
+      "default": "./dist/channel/replay-fixtures.js"
+    },
+    "./channel/service": {
+      "types": "./dist/channel/service.d.ts",
+      "bun": "./dist/channel/service.js",
+      "node": "./dist/node/channel/service.js",
+      "default": "./dist/channel/service.js"
+    },
+    "./channel/slack": {
+      "types": "./dist/channel/slack.d.ts",
+      "bun": "./dist/channel/slack.js",
+      "node": "./dist/node/channel/slack.js",
+      "default": "./dist/channel/slack.js"
+    },
+    "./channel/store": {
+      "types": "./dist/channel/store.d.ts",
+      "bun": "./dist/channel/store.js",
+      "node": "./dist/node/channel/store.js",
+      "default": "./dist/channel/store.js"
+    },
+    "./channel/telemetry": {
+      "types": "./dist/channel/telemetry.d.ts",
+      "bun": "./dist/channel/telemetry.js",
+      "node": "./dist/node/channel/telemetry.js",
+      "default": "./dist/channel/telemetry.js"
+    },
+    "./channel/types": {
+      "types": "./dist/channel/types.d.ts",
+      "bun": "./dist/channel/types.js",
+      "node": "./dist/node/channel/types.js",
+      "default": "./dist/channel/types.js"
+    },
+    "./channel/whatsapp-meta": {
+      "types": "./dist/channel/whatsapp-meta.d.ts",
+      "bun": "./dist/channel/whatsapp-meta.js",
+      "node": "./dist/node/channel/whatsapp-meta.js",
+      "default": "./dist/channel/whatsapp-meta.js"
+    },
+    "./channel/whatsapp-twilio": {
+      "types": "./dist/channel/whatsapp-twilio.d.ts",
+      "bun": "./dist/channel/whatsapp-twilio.js",
+      "node": "./dist/node/channel/whatsapp-twilio.js",
+      "default": "./dist/channel/whatsapp-twilio.js"
+    },
     "./health": {
       "types": "./dist/health.d.ts",
       "bun": "./dist/health.js",
@@ -96,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": {
@@ -107,6 +242,108 @@
         "node": "./dist/node/index.js",
         "default": "./dist/index.js"
       },
+      "./channel": {
+        "types": "./dist/channel/index.d.ts",
+        "bun": "./dist/channel/index.js",
+        "node": "./dist/node/channel/index.js",
+        "default": "./dist/channel/index.js"
+      },
+      "./channel/dispatcher": {
+        "types": "./dist/channel/dispatcher.d.ts",
+        "bun": "./dist/channel/dispatcher.js",
+        "node": "./dist/node/channel/dispatcher.js",
+        "default": "./dist/channel/dispatcher.js"
+      },
+      "./channel/github": {
+        "types": "./dist/channel/github.d.ts",
+        "bun": "./dist/channel/github.js",
+        "node": "./dist/node/channel/github.js",
+        "default": "./dist/channel/github.js"
+      },
+      "./channel/index": {
+        "types": "./dist/channel/index.d.ts",
+        "bun": "./dist/channel/index.js",
+        "node": "./dist/node/channel/index.js",
+        "default": "./dist/channel/index.js"
+      },
+      "./channel/memory-store": {
+        "types": "./dist/channel/memory-store.d.ts",
+        "bun": "./dist/channel/memory-store.js",
+        "node": "./dist/node/channel/memory-store.js",
+        "default": "./dist/channel/memory-store.js"
+      },
+      "./channel/policy": {
+        "types": "./dist/channel/policy.d.ts",
+        "bun": "./dist/channel/policy.js",
+        "node": "./dist/node/channel/policy.js",
+        "default": "./dist/channel/policy.js"
+      },
+      "./channel/postgres-queries": {
+        "types": "./dist/channel/postgres-queries.d.ts",
+        "bun": "./dist/channel/postgres-queries.js",
+        "node": "./dist/node/channel/postgres-queries.js",
+        "default": "./dist/channel/postgres-queries.js"
+      },
+      "./channel/postgres-schema": {
+        "types": "./dist/channel/postgres-schema.d.ts",
+        "bun": "./dist/channel/postgres-schema.js",
+        "node": "./dist/node/channel/postgres-schema.js",
+        "default": "./dist/channel/postgres-schema.js"
+      },
+      "./channel/postgres-store": {
+        "types": "./dist/channel/postgres-store.d.ts",
+        "bun": "./dist/channel/postgres-store.js",
+        "node": "./dist/node/channel/postgres-store.js",
+        "default": "./dist/channel/postgres-store.js"
+      },
+      "./channel/replay-fixtures": {
+        "types": "./dist/channel/replay-fixtures.d.ts",
+        "bun": "./dist/channel/replay-fixtures.js",
+        "node": "./dist/node/channel/replay-fixtures.js",
+        "default": "./dist/channel/replay-fixtures.js"
+      },
+      "./channel/service": {
+        "types": "./dist/channel/service.d.ts",
+        "bun": "./dist/channel/service.js",
+        "node": "./dist/node/channel/service.js",
+        "default": "./dist/channel/service.js"
+      },
+      "./channel/slack": {
+        "types": "./dist/channel/slack.d.ts",
+        "bun": "./dist/channel/slack.js",
+        "node": "./dist/node/channel/slack.js",
+        "default": "./dist/channel/slack.js"
+      },
+      "./channel/store": {
+        "types": "./dist/channel/store.d.ts",
+        "bun": "./dist/channel/store.js",
+        "node": "./dist/node/channel/store.js",
+        "default": "./dist/channel/store.js"
+      },
+      "./channel/telemetry": {
+        "types": "./dist/channel/telemetry.d.ts",
+        "bun": "./dist/channel/telemetry.js",
+        "node": "./dist/node/channel/telemetry.js",
+        "default": "./dist/channel/telemetry.js"
+      },
+      "./channel/types": {
+        "types": "./dist/channel/types.d.ts",
+        "bun": "./dist/channel/types.js",
+        "node": "./dist/node/channel/types.js",
+        "default": "./dist/channel/types.js"
+      },
+      "./channel/whatsapp-meta": {
+        "types": "./dist/channel/whatsapp-meta.d.ts",
+        "bun": "./dist/channel/whatsapp-meta.js",
+        "node": "./dist/node/channel/whatsapp-meta.js",
+        "default": "./dist/channel/whatsapp-meta.js"
+      },
+      "./channel/whatsapp-twilio": {
+        "types": "./dist/channel/whatsapp-twilio.d.ts",
+        "bun": "./dist/channel/whatsapp-twilio.js",
+        "node": "./dist/node/channel/whatsapp-twilio.js",
+        "default": "./dist/channel/whatsapp-twilio.js"
+      },
       "./health": {
         "types": "./dist/health.d.ts",
         "bun": "./dist/health.js",
@@ -154,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/"