@contractspec/example.integration-hub 3.0.0 → 3.1.1

package/dist/connection/connection.enum.d.ts

@@ -2,3 +2,11 @@
  * Connection status enum.
  */
 export declare const ConnectionStatusEnum: import("@contractspec/lib.schema").EnumType<[string, string, string, string, string]>;
+/**
+ * Authentication method used by a connection.
+ */
+export declare const AuthTypeEnum: import("@contractspec/lib.schema").EnumType<[string, string, string, string, string, string, string]>;
+/**
+ * Transport protocol for communicating with the external system.
+ */
+export declare const TransportTypeEnum: import("@contractspec/lib.schema").EnumType<[string, string, string, string]>;

package/dist/connection/connection.enum.js

@@ -8,6 +8,23 @@ var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
   "ERROR",
   "EXPIRED"
 ]);
+var AuthTypeEnum = defineEnum("AuthType", [
+  "api_key",
+  "oauth2",
+  "bearer",
+  "header",
+  "basic",
+  "webhook_signing",
+  "service_account"
+]);
+var TransportTypeEnum = defineEnum("TransportType", [
+  "rest",
+  "mcp",
+  "webhook",
+  "sdk"
+]);
 export {
-  ConnectionStatusEnum
+  TransportTypeEnum,
+  ConnectionStatusEnum,
+  AuthTypeEnum
 };

package/dist/connection/connection.operation.d.ts

@@ -18,6 +18,22 @@ export declare const CreateConnectionContract: import("@contractspec/lib.contrac
         type: import("@contractspec/lib.schema").FieldType<unknown, unknown>;
         isOptional: true;
     };
+    transport: {
+        type: import("@contractspec/lib.schema").EnumType<[string, string, string, string]>;
+        isOptional: true;
+    };
+    authMethod: {
+        type: import("@contractspec/lib.schema").EnumType<[string, string, string, string, string, string, string]>;
+        isOptional: true;
+    };
+    apiVersion: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    ownershipMode: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
 }>, import("@contractspec/lib.schema").SchemaModel<{
     id: {
         type: import("@contractspec/lib.schema").FieldType<string, string>;
@@ -55,6 +71,22 @@ export declare const CreateConnectionContract: import("@contractspec/lib.contrac
         type: import("@contractspec/lib.schema").FieldType<string, string>;
         isOptional: true;
     };
+    transport: {
+        type: import("@contractspec/lib.schema").EnumType<[string, string, string, string]>;
+        isOptional: true;
+    };
+    authMethod: {
+        type: import("@contractspec/lib.schema").EnumType<[string, string, string, string, string, string, string]>;
+        isOptional: true;
+    };
+    apiVersion: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    ownershipMode: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
 }>, {
     key: string;
     version: string;
@@ -96,5 +128,21 @@ export declare const CreateConnectionContract: import("@contractspec/lib.contrac
             type: import("@contractspec/lib.schema").FieldType<string, string>;
             isOptional: true;
         };
+        transport: {
+            type: import("@contractspec/lib.schema").EnumType<[string, string, string, string]>;
+            isOptional: true;
+        };
+        authMethod: {
+            type: import("@contractspec/lib.schema").EnumType<[string, string, string, string, string, string, string]>;
+            isOptional: true;
+        };
+        apiVersion: {
+            type: import("@contractspec/lib.schema").FieldType<string, string>;
+            isOptional: true;
+        };
+        ownershipMode: {
+            type: import("@contractspec/lib.schema").FieldType<string, string>;
+            isOptional: true;
+        };
     }>;
 }[]>;

package/dist/connection/connection.operation.js

@@ -8,6 +8,21 @@ var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
   "ERROR",
   "EXPIRED"
 ]);
+var AuthTypeEnum = defineEnum("AuthType", [
+  "api_key",
+  "oauth2",
+  "bearer",
+  "header",
+  "basic",
+  "webhook_signing",
+  "service_account"
+]);
+var TransportTypeEnum = defineEnum("TransportType", [
+  "rest",
+  "mcp",
+  "webhook",
+  "sdk"
+]);
 
 // src/connection/connection.schema.ts
 import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
@@ -28,7 +43,11 @@ var ConnectionModel = defineSchemaModel({
     },
     connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
     lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    transport: { type: TransportTypeEnum, isOptional: true },
+    authMethod: { type: AuthTypeEnum, isOptional: true },
+    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
   }
 });
 var CreateConnectionInputModel = defineSchemaModel({
@@ -40,7 +59,11 @@ var CreateConnectionInputModel = defineSchemaModel({
     },
     name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
     authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true }
+    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    transport: { type: TransportTypeEnum, isOptional: true },
+    authMethod: { type: AuthTypeEnum, isOptional: true },
+    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
   }
 });
 

package/dist/connection/connection.presentation.js

@@ -8,6 +8,21 @@ var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
   "ERROR",
   "EXPIRED"
 ]);
+var AuthTypeEnum = defineEnum("AuthType", [
+  "api_key",
+  "oauth2",
+  "bearer",
+  "header",
+  "basic",
+  "webhook_signing",
+  "service_account"
+]);
+var TransportTypeEnum = defineEnum("TransportType", [
+  "rest",
+  "mcp",
+  "webhook",
+  "sdk"
+]);
 
 // src/connection/connection.schema.ts
 import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
@@ -28,7 +43,11 @@ var ConnectionModel = defineSchemaModel({
     },
     connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
     lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    transport: { type: TransportTypeEnum, isOptional: true },
+    authMethod: { type: AuthTypeEnum, isOptional: true },
+    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
   }
 });
 var CreateConnectionInputModel = defineSchemaModel({
@@ -40,7 +59,11 @@ var CreateConnectionInputModel = defineSchemaModel({
     },
     name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
     authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true }
+    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    transport: { type: TransportTypeEnum, isOptional: true },
+    authMethod: { type: AuthTypeEnum, isOptional: true },
+    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
   }
 });
 

package/dist/connection/connection.schema.d.ts

@@ -38,6 +38,22 @@ export declare const ConnectionModel: import("@contractspec/lib.schema").SchemaM
         type: import("@contractspec/lib.schema").FieldType<string, string>;
         isOptional: true;
     };
+    transport: {
+        type: import("@contractspec/lib.schema").EnumType<[string, string, string, string]>;
+        isOptional: true;
+    };
+    authMethod: {
+        type: import("@contractspec/lib.schema").EnumType<[string, string, string, string, string, string, string]>;
+        isOptional: true;
+    };
+    apiVersion: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    ownershipMode: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
 }>;
 /**
  * Input for creating a connection.
@@ -59,4 +75,20 @@ export declare const CreateConnectionInputModel: import("@contractspec/lib.schem
         type: import("@contractspec/lib.schema").FieldType<unknown, unknown>;
         isOptional: true;
     };
+    transport: {
+        type: import("@contractspec/lib.schema").EnumType<[string, string, string, string]>;
+        isOptional: true;
+    };
+    authMethod: {
+        type: import("@contractspec/lib.schema").EnumType<[string, string, string, string, string, string, string]>;
+        isOptional: true;
+    };
+    apiVersion: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
+    ownershipMode: {
+        type: import("@contractspec/lib.schema").FieldType<string, string>;
+        isOptional: true;
+    };
 }>;

package/dist/connection/connection.schema.js

@@ -8,6 +8,21 @@ var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
   "ERROR",
   "EXPIRED"
 ]);
+var AuthTypeEnum = defineEnum("AuthType", [
+  "api_key",
+  "oauth2",
+  "bearer",
+  "header",
+  "basic",
+  "webhook_signing",
+  "service_account"
+]);
+var TransportTypeEnum = defineEnum("TransportType", [
+  "rest",
+  "mcp",
+  "webhook",
+  "sdk"
+]);
 
 // src/connection/connection.schema.ts
 import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
@@ -28,7 +43,11 @@ var ConnectionModel = defineSchemaModel({
     },
     connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
     lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    transport: { type: TransportTypeEnum, isOptional: true },
+    authMethod: { type: AuthTypeEnum, isOptional: true },
+    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
   }
 });
 var CreateConnectionInputModel = defineSchemaModel({
@@ -40,7 +59,11 @@ var CreateConnectionInputModel = defineSchemaModel({
     },
     name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
     authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true }
+    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    transport: { type: TransportTypeEnum, isOptional: true },
+    authMethod: { type: AuthTypeEnum, isOptional: true },
+    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
   }
 });
 export {

package/dist/connection/index.js

@@ -8,6 +8,21 @@ var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
   "ERROR",
   "EXPIRED"
 ]);
+var AuthTypeEnum = defineEnum("AuthType", [
+  "api_key",
+  "oauth2",
+  "bearer",
+  "header",
+  "basic",
+  "webhook_signing",
+  "service_account"
+]);
+var TransportTypeEnum = defineEnum("TransportType", [
+  "rest",
+  "mcp",
+  "webhook",
+  "sdk"
+]);
 
 // src/connection/connection.schema.ts
 import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
@@ -28,7 +43,11 @@ var ConnectionModel = defineSchemaModel({
     },
     connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
     lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    transport: { type: TransportTypeEnum, isOptional: true },
+    authMethod: { type: AuthTypeEnum, isOptional: true },
+    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
   }
 });
 var CreateConnectionInputModel = defineSchemaModel({
@@ -40,7 +59,11 @@ var CreateConnectionInputModel = defineSchemaModel({
     },
     name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
     authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true }
+    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    transport: { type: TransportTypeEnum, isOptional: true },
+    authMethod: { type: AuthTypeEnum, isOptional: true },
+    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
   }
 });
 

package/dist/handlers/index.js

@@ -229,6 +229,49 @@ function createIntegrationHandlers(db) {
     ])).rows;
     return rowToSyncConfig(rows[0]);
   }
+  async function validateByokKey(input) {
+    const rows = (await db.query(`SELECT * FROM integration_connection WHERE id = ?`, [
+      input.connectionId
+    ])).rows;
+    if (!rows[0]) {
+      return {
+        valid: false,
+        provider: "unknown",
+        keyPrefix: "",
+        error: `Connection ${input.connectionId} not found`
+      };
+    }
+    const keyPrefix = input.providerKey.slice(0, 8);
+    const looksValid = input.providerKey.length >= 16;
+    return {
+      valid: looksValid,
+      provider: rows[0].name,
+      keyPrefix: `${keyPrefix}...`,
+      expiresAt: looksValid ? new Date(Date.now() + 90 * 24 * 60 * 60 * 1000).toISOString() : undefined,
+      error: looksValid ? undefined : "Key must be at least 16 characters"
+    };
+  }
+  async function refreshOAuth2Token(input) {
+    const now = new Date().toISOString();
+    await db.execute(`UPDATE integration_connection SET updatedAt = ? WHERE id = ?`, [now, input.connectionId]);
+    return {
+      refreshed: true,
+      expiresAt: new Date(Date.now() + 3600 * 1000).toISOString(),
+      tokenType: "Bearer",
+      scopes: ["read", "write", "sync"]
+    };
+  }
+  async function getTransportOptions(input) {
+    return {
+      integrationId: input.integrationId,
+      transports: [
+        { transport: "rest", supported: true, defaultVersion: "v2" },
+        { transport: "mcp", supported: true, defaultVersion: "v1" },
+        { transport: "webhook", supported: true },
+        { transport: "sdk", supported: false }
+      ]
+    };
+  }
   return {
     listIntegrations,
     createIntegration,
@@ -239,7 +282,10 @@ function createIntegrationHandlers(db) {
     configureSync,
     mapFields,
     getFieldMappings,
-    runSync
+    runSync,
+    validateByokKey,
+    refreshOAuth2Token,
+    getTransportOptions
   };
 }
 export {

package/dist/handlers/integration.handlers.d.ts

@@ -111,6 +111,38 @@ export interface ListSyncConfigsOutput {
     configs: SyncConfig[];
     total: number;
 }
+export interface ValidateByokKeyInput {
+    connectionId: string;
+    providerKey: string;
+}
+export interface ValidateByokKeyOutput {
+    valid: boolean;
+    provider: string;
+    keyPrefix: string;
+    expiresAt?: string;
+    error?: string;
+}
+export interface RefreshOAuth2TokenInput {
+    connectionId: string;
+}
+export interface RefreshOAuth2TokenOutput {
+    refreshed: boolean;
+    expiresAt: string;
+    tokenType: string;
+    scopes: string[];
+}
+export interface TransportOption {
+    transport: 'rest' | 'mcp' | 'webhook' | 'sdk';
+    supported: boolean;
+    defaultVersion?: string;
+}
+export interface GetTransportOptionsInput {
+    integrationId: string;
+}
+export interface GetTransportOptionsOutput {
+    integrationId: string;
+    transports: TransportOption[];
+}
 export declare function createIntegrationHandlers(db: DatabasePort): {
     listIntegrations: (input: ListIntegrationsInput) => Promise<ListIntegrationsOutput>;
     createIntegration: (input: CreateIntegrationInput, context: {
@@ -125,5 +157,8 @@ export declare function createIntegrationHandlers(db: DatabasePort): {
     mapFields: (input: MapFieldsInput) => Promise<FieldMapping[]>;
     getFieldMappings: (syncConfigId: string) => Promise<FieldMapping[]>;
     runSync: (syncConfigId: string) => Promise<SyncConfig>;
+    validateByokKey: (input: ValidateByokKeyInput) => Promise<ValidateByokKeyOutput>;
+    refreshOAuth2Token: (input: RefreshOAuth2TokenInput) => Promise<RefreshOAuth2TokenOutput>;
+    getTransportOptions: (input: GetTransportOptionsInput) => Promise<GetTransportOptionsOutput>;
 };
 export type IntegrationHandlers = ReturnType<typeof createIntegrationHandlers>;

package/dist/handlers/integration.handlers.js

@@ -229,6 +229,49 @@ function createIntegrationHandlers(db) {
     ])).rows;
     return rowToSyncConfig(rows[0]);
   }
+  async function validateByokKey(input) {
+    const rows = (await db.query(`SELECT * FROM integration_connection WHERE id = ?`, [
+      input.connectionId
+    ])).rows;
+    if (!rows[0]) {
+      return {
+        valid: false,
+        provider: "unknown",
+        keyPrefix: "",
+        error: `Connection ${input.connectionId} not found`
+      };
+    }
+    const keyPrefix = input.providerKey.slice(0, 8);
+    const looksValid = input.providerKey.length >= 16;
+    return {
+      valid: looksValid,
+      provider: rows[0].name,
+      keyPrefix: `${keyPrefix}...`,
+      expiresAt: looksValid ? new Date(Date.now() + 90 * 24 * 60 * 60 * 1000).toISOString() : undefined,
+      error: looksValid ? undefined : "Key must be at least 16 characters"
+    };
+  }
+  async function refreshOAuth2Token(input) {
+    const now = new Date().toISOString();
+    await db.execute(`UPDATE integration_connection SET updatedAt = ? WHERE id = ?`, [now, input.connectionId]);
+    return {
+      refreshed: true,
+      expiresAt: new Date(Date.now() + 3600 * 1000).toISOString(),
+      tokenType: "Bearer",
+      scopes: ["read", "write", "sync"]
+    };
+  }
+  async function getTransportOptions(input) {
+    return {
+      integrationId: input.integrationId,
+      transports: [
+        { transport: "rest", supported: true, defaultVersion: "v2" },
+        { transport: "mcp", supported: true, defaultVersion: "v1" },
+        { transport: "webhook", supported: true },
+        { transport: "sdk", supported: false }
+      ]
+    };
+  }
   return {
     listIntegrations,
     createIntegration,
@@ -239,7 +282,10 @@ function createIntegrationHandlers(db) {
     configureSync,
     mapFields,
     getFieldMappings,
-    runSync
+    runSync,
+    validateByokKey,
+    refreshOAuth2Token,
+    getTransportOptions
   };
 }
 export {

package/dist/index.js

@@ -8,6 +8,21 @@ var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
   "ERROR",
   "EXPIRED"
 ]);
+var AuthTypeEnum = defineEnum("AuthType", [
+  "api_key",
+  "oauth2",
+  "bearer",
+  "header",
+  "basic",
+  "webhook_signing",
+  "service_account"
+]);
+var TransportTypeEnum = defineEnum("TransportType", [
+  "rest",
+  "mcp",
+  "webhook",
+  "sdk"
+]);
 
 // src/connection/connection.schema.ts
 import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
@@ -28,7 +43,11 @@ var ConnectionModel = defineSchemaModel({
     },
     connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
     lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },
-    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    transport: { type: TransportTypeEnum, isOptional: true },
+    authMethod: { type: AuthTypeEnum, isOptional: true },
+    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
   }
 });
 var CreateConnectionInputModel = defineSchemaModel({
@@ -40,7 +59,11 @@ var CreateConnectionInputModel = defineSchemaModel({
     },
     name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
     authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
-    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true }
+    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    transport: { type: TransportTypeEnum, isOptional: true },
+    authMethod: { type: AuthTypeEnum, isOptional: true },
+    apiVersion: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    ownershipMode: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
   }
 });
 
@@ -327,6 +350,49 @@ function createIntegrationHandlers(db) {
     ])).rows;
     return rowToSyncConfig(rows[0]);
   }
+  async function validateByokKey(input) {
+    const rows = (await db.query(`SELECT * FROM integration_connection WHERE id = ?`, [
+      input.connectionId
+    ])).rows;
+    if (!rows[0]) {
+      return {
+        valid: false,
+        provider: "unknown",
+        keyPrefix: "",
+        error: `Connection ${input.connectionId} not found`
+      };
+    }
+    const keyPrefix = input.providerKey.slice(0, 8);
+    const looksValid = input.providerKey.length >= 16;
+    return {
+      valid: looksValid,
+      provider: rows[0].name,
+      keyPrefix: `${keyPrefix}...`,
+      expiresAt: looksValid ? new Date(Date.now() + 90 * 24 * 60 * 60 * 1000).toISOString() : undefined,
+      error: looksValid ? undefined : "Key must be at least 16 characters"
+    };
+  }
+  async function refreshOAuth2Token(input) {
+    const now = new Date().toISOString();
+    await db.execute(`UPDATE integration_connection SET updatedAt = ? WHERE id = ?`, [now, input.connectionId]);
+    return {
+      refreshed: true,
+      expiresAt: new Date(Date.now() + 3600 * 1000).toISOString(),
+      tokenType: "Bearer",
+      scopes: ["read", "write", "sync"]
+    };
+  }
+  async function getTransportOptions(input) {
+    return {
+      integrationId: input.integrationId,
+      transports: [
+        { transport: "rest", supported: true, defaultVersion: "v2" },
+        { transport: "mcp", supported: true, defaultVersion: "v1" },
+        { transport: "webhook", supported: true },
+        { transport: "sdk", supported: false }
+      ]
+    };
+  }
   return {
     listIntegrations,
     createIntegration,
@@ -337,7 +403,10 @@ function createIntegrationHandlers(db) {
     configureSync,
     mapFields,
     getFieldMappings,
-    runSync
+    runSync,
+    validateByokKey,
+    refreshOAuth2Token,
+    getTransportOptions
   };
 }
 
@@ -1571,6 +1640,7 @@ var DEFAULT_STDIO_ARGS = [
 ];
 async function runIntegrationHubMcpExampleFromEnv() {
   const mode = resolveMode();
+  const transport = resolveTransport();
   const config = buildMcpConfigFromEnv();
   const toolset = await createMcpToolsets([config], {
     onNameCollision: "error"
@@ -1581,8 +1651,10 @@ async function runIntegrationHubMcpExampleFromEnv() {
       mode,
       server: {
         name: config.name,
-        transport: config.transport ?? "stdio"
+        transport
       },
+      authMethod: process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_AUTH_METHOD,
+      apiVersion: process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_API_VERSION,
       tools: toolNames
     };
     if (mode === "call") {
@@ -1624,9 +1696,10 @@ function buildMcpConfigFromEnv() {
   }
   const accessToken = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN;
   const accessTokenEnvVar = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN_ENV;
+  const mcpTransport = transport === "webhook" || transport === "http" ? "http" : "sse";
   return {
     name,
-    transport,
+    transport: mcpTransport,
     url: requireEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_URL"),
     headers: parseStringRecordEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_HEADERS_JSON"),
     accessToken,
@@ -1643,10 +1716,10 @@ function resolveMode() {
 }
 function resolveTransport() {
   const rawTransport = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT?.toLowerCase() ?? "stdio";
-  if (rawTransport === "stdio" || rawTransport === "http" || rawTransport === "sse") {
+  if (rawTransport === "stdio" || rawTransport === "http" || rawTransport === "sse" || rawTransport === "webhook") {
     return rawTransport;
   }
-  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT: ${rawTransport}. Use "stdio", "http", or "sse".`);
+  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT: ${rawTransport}. Use "stdio", "http", "sse", or "webhook".`);
 }
 function parseStringArrayEnv(key, fallback) {
   const raw = process.env[key];

package/dist/mcp-example.d.ts

@@ -3,8 +3,10 @@ interface IntegrationHubMcpOutput {
     mode: IntegrationHubMcpMode;
     server: {
         name: string;
-        transport: 'stdio' | 'http' | 'sse';
+        transport: 'stdio' | 'http' | 'sse' | 'webhook';
     };
+    authMethod?: string;
+    apiVersion?: string;
     tools: string[];
     toolCall?: {
         name: string;