@contractspec/example.integration-hub 1.57.0 → 1.58.0

package/dist/integration-hub.feature.js

@@ -1,244 +1,115 @@
+// @bun
+// src/integration-hub.feature.ts
 import { defineFeature } from "@contractspec/lib.contracts";
-
-//#region src/integration-hub.feature.ts
-/**
-* Integration Hub Feature Module Specification
-*/
-const IntegrationHubFeature = defineFeature({
-	meta: {
-		key: "integration-hub",
-		version: "1.0.0",
-		title: "Integration Hub",
-		description: "Connect and sync data with external systems through configurable integrations",
-		domain: "integration",
-		owners: ["@integration-team"],
-		tags: [
-			"integration",
-			"sync",
-			"etl",
-			"connectors"
-		],
-		stability: "experimental"
-	},
-	operations: [
-		{
-			key: "integration.create",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.connection.create",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.syncConfig.create",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.fieldMapping.add",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.sync.trigger",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.syncRun.list",
-			version: "1.0.0"
-		}
-	],
-	events: [
-		{
-			key: "integration.created",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.connection.created",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.connection.statusChanged",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.syncConfig.created",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.sync.started",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.sync.completed",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.sync.failed",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.record.synced",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.fieldMapping.added",
-			version: "1.0.0"
-		}
-	],
-	presentations: [
-		{
-			key: "integration.list",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.detail",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.connection.list",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.connection.setup",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.syncConfig.list",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.syncConfig.editor",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.fieldMapping.editor",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.syncRun.viewList",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.syncRun.detail",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.health",
-			version: "1.0.0"
-		},
-		{
-			key: "integration.sync.activity",
-			version: "1.0.0"
-		}
-	],
-	opToPresentation: [
-		{
-			op: {
-				key: "integration.syncConfig.create",
-				version: "1.0.0"
-			},
-			pres: {
-				key: "integration.syncConfig.editor",
-				version: "1.0.0"
-			}
-		},
-		{
-			op: {
-				key: "integration.fieldMapping.add",
-				version: "1.0.0"
-			},
-			pres: {
-				key: "integration.fieldMapping.editor",
-				version: "1.0.0"
-			}
-		},
-		{
-			op: {
-				key: "integration.syncRun.list",
-				version: "1.0.0"
-			},
-			pres: {
-				key: "integration.syncRun.viewList",
-				version: "1.0.0"
-			}
-		}
-	],
-	presentationsTargets: [
-		{
-			key: "integration.list",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		},
-		{
-			key: "integration.detail",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		},
-		{
-			key: "integration.syncConfig.list",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		},
-		{
-			key: "integration.syncConfig.editor",
-			version: "1.0.0",
-			targets: ["react"]
-		},
-		{
-			key: "integration.fieldMapping.editor",
-			version: "1.0.0",
-			targets: ["react"]
-		},
-		{
-			key: "integration.syncRun.viewList",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		},
-		{
-			key: "integration.syncRun.detail",
-			version: "1.0.0",
-			targets: ["react", "markdown"]
-		}
-	],
-	capabilities: {
-		requires: [
-			{
-				key: "identity",
-				version: "1.0.0"
-			},
-			{
-				key: "audit-trail",
-				version: "1.0.0"
-			},
-			{
-				key: "feature-flags",
-				version: "1.0.0"
-			},
-			{
-				key: "jobs",
-				version: "1.0.0"
-			},
-			{
-				key: "files",
-				version: "1.0.0"
-			}
-		],
-		provides: [
-			{
-				key: "integration",
-				version: "1.0.0"
-			},
-			{
-				key: "sync",
-				version: "1.0.0"
-			},
-			{
-				key: "etl",
-				version: "1.0.0"
-			}
-		]
-	}
+var IntegrationHubFeature = defineFeature({
+  meta: {
+    key: "integration-hub",
+    version: "1.0.0",
+    title: "Integration Hub",
+    description: "Connect and sync data with external systems through configurable integrations",
+    domain: "integration",
+    owners: ["@integration-team"],
+    tags: ["integration", "sync", "etl", "connectors"],
+    stability: "experimental"
+  },
+  operations: [
+    { key: "integration.create", version: "1.0.0" },
+    { key: "integration.connection.create", version: "1.0.0" },
+    { key: "integration.syncConfig.create", version: "1.0.0" },
+    { key: "integration.fieldMapping.add", version: "1.0.0" },
+    { key: "integration.sync.trigger", version: "1.0.0" },
+    { key: "integration.syncRun.list", version: "1.0.0" }
+  ],
+  events: [
+    { key: "integration.created", version: "1.0.0" },
+    { key: "integration.connection.created", version: "1.0.0" },
+    { key: "integration.connection.statusChanged", version: "1.0.0" },
+    { key: "integration.syncConfig.created", version: "1.0.0" },
+    { key: "integration.sync.started", version: "1.0.0" },
+    { key: "integration.sync.completed", version: "1.0.0" },
+    { key: "integration.sync.failed", version: "1.0.0" },
+    { key: "integration.record.synced", version: "1.0.0" },
+    { key: "integration.fieldMapping.added", version: "1.0.0" }
+  ],
+  presentations: [
+    { key: "integration.list", version: "1.0.0" },
+    { key: "integration.detail", version: "1.0.0" },
+    { key: "integration.connection.list", version: "1.0.0" },
+    { key: "integration.connection.setup", version: "1.0.0" },
+    { key: "integration.syncConfig.list", version: "1.0.0" },
+    { key: "integration.syncConfig.editor", version: "1.0.0" },
+    { key: "integration.fieldMapping.editor", version: "1.0.0" },
+    { key: "integration.syncRun.viewList", version: "1.0.0" },
+    { key: "integration.syncRun.detail", version: "1.0.0" },
+    { key: "integration.health", version: "1.0.0" },
+    { key: "integration.sync.activity", version: "1.0.0" }
+  ],
+  opToPresentation: [
+    {
+      op: { key: "integration.syncConfig.create", version: "1.0.0" },
+      pres: { key: "integration.syncConfig.editor", version: "1.0.0" }
+    },
+    {
+      op: { key: "integration.fieldMapping.add", version: "1.0.0" },
+      pres: { key: "integration.fieldMapping.editor", version: "1.0.0" }
+    },
+    {
+      op: { key: "integration.syncRun.list", version: "1.0.0" },
+      pres: { key: "integration.syncRun.viewList", version: "1.0.0" }
+    }
+  ],
+  presentationsTargets: [
+    {
+      key: "integration.list",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    },
+    {
+      key: "integration.detail",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    },
+    {
+      key: "integration.syncConfig.list",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    },
+    {
+      key: "integration.syncConfig.editor",
+      version: "1.0.0",
+      targets: ["react"]
+    },
+    {
+      key: "integration.fieldMapping.editor",
+      version: "1.0.0",
+      targets: ["react"]
+    },
+    {
+      key: "integration.syncRun.viewList",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    },
+    {
+      key: "integration.syncRun.detail",
+      version: "1.0.0",
+      targets: ["react", "markdown"]
+    }
+  ],
+  capabilities: {
+    requires: [
+      { key: "identity", version: "1.0.0" },
+      { key: "audit-trail", version: "1.0.0" },
+      { key: "feature-flags", version: "1.0.0" },
+      { key: "jobs", version: "1.0.0" },
+      { key: "files", version: "1.0.0" }
+    ],
+    provides: [
+      { key: "integration", version: "1.0.0" },
+      { key: "sync", version: "1.0.0" },
+      { key: "etl", version: "1.0.0" }
+    ]
+  }
 });
-
-//#endregion
-export { IntegrationHubFeature };
-//# sourceMappingURL=integration-hub.feature.js.map
+export {
+  IntegrationHubFeature
+};

package/dist/node/connection/connection.enum.js

@@ -0,0 +1,12 @@
+// src/connection/connection.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
+  "PENDING",
+  "CONNECTED",
+  "DISCONNECTED",
+  "ERROR",
+  "EXPIRED"
+]);
+export {
+  ConnectionStatusEnum
+};

package/dist/node/connection/connection.operation.js

@@ -0,0 +1,101 @@
+// src/connection/connection.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
+  "PENDING",
+  "CONNECTED",
+  "DISCONNECTED",
+  "ERROR",
+  "EXPIRED"
+]);
+
+// src/connection/connection.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var ConnectionModel = defineSchemaModel({
+  name: "ConnectionModel",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    integrationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: ConnectionStatusEnum, isOptional: false },
+    authType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    externalAccountName: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+var CreateConnectionInputModel = defineSchemaModel({
+  name: "CreateConnectionInput",
+  fields: {
+    integrationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true }
+  }
+});
+
+// src/connection/connection.operation.ts
+import { defineCommand } from "@contractspec/lib.contracts/operations";
+var OWNERS = ["@example.integration-hub"];
+var CreateConnectionContract = defineCommand({
+  meta: {
+    key: "integration.connection.create",
+    version: "1.0.0",
+    stability: "stable",
+    owners: [...OWNERS],
+    tags: ["integration", "connection", "create"],
+    description: "Create a connection to an external system.",
+    goal: "Authenticate with external systems.",
+    context: "Connection setup."
+  },
+  io: { input: CreateConnectionInputModel, output: ConnectionModel },
+  policy: { auth: "user" },
+  sideEffects: {
+    emits: [
+      {
+        key: "integration.connection.created",
+        version: "1.0.0",
+        when: "Connection created",
+        payload: ConnectionModel
+      }
+    ],
+    audit: ["integration.connection.created"]
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "create-connection-happy-path",
+        given: ["User is authenticated"],
+        when: ["User creates connection with valid credentials"],
+        then: ["Connection is created", "ConnectionCreated event is emitted"]
+      }
+    ],
+    examples: [
+      {
+        key: "connect-crm",
+        input: {
+          name: "Salesforce Prod",
+          integrationId: "salesforce",
+          credentials: { clientId: "xxx" }
+        },
+        output: {
+          id: "conn-123",
+          status: "connected",
+          connectedAt: "2025-01-01T12:00:00Z"
+        }
+      }
+    ]
+  }
+});
+export {
+  CreateConnectionContract
+};

package/dist/node/connection/connection.presentation.js

@@ -0,0 +1,99 @@
+// src/connection/connection.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
+  "PENDING",
+  "CONNECTED",
+  "DISCONNECTED",
+  "ERROR",
+  "EXPIRED"
+]);
+
+// src/connection/connection.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var ConnectionModel = defineSchemaModel({
+  name: "ConnectionModel",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    integrationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: ConnectionStatusEnum, isOptional: false },
+    authType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    externalAccountName: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+var CreateConnectionInputModel = defineSchemaModel({
+  name: "CreateConnectionInput",
+  fields: {
+    integrationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true }
+  }
+});
+
+// src/connection/connection.presentation.ts
+import { definePresentation, StabilityEnum } from "@contractspec/lib.contracts";
+var ConnectionListPresentation = definePresentation({
+  meta: {
+    key: "integration.connection.list",
+    version: "1.0.0",
+    title: "Connection List",
+    description: "List of integration connections",
+    domain: "integration",
+    owners: ["@integration-team"],
+    tags: ["integration", "connection", "list"],
+    stability: StabilityEnum.Experimental,
+    goal: "Provide an overview of all established integration connections.",
+    context: "The primary management view for integration hubs."
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "ConnectionList",
+    props: ConnectionModel
+  },
+  targets: ["react", "markdown"],
+  policy: {
+    flags: ["integration.enabled"]
+  }
+});
+var ConnectionSetupPresentation = definePresentation({
+  meta: {
+    key: "integration.connection.setup",
+    version: "1.0.0",
+    title: "Connection Setup",
+    description: "Setup wizard for creating integration connections",
+    domain: "integration",
+    owners: ["@integration-team"],
+    tags: ["integration", "connection", "setup"],
+    stability: StabilityEnum.Experimental,
+    goal: "Guide users through the multi-step process of connecting to a new integration.",
+    context: "The onboarding flow for new integrations."
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "ConnectionSetup",
+    props: ConnectionModel
+  },
+  targets: ["react"],
+  policy: {
+    flags: ["integration.enabled"]
+  }
+});
+export {
+  ConnectionSetupPresentation,
+  ConnectionListPresentation
+};

package/dist/node/connection/connection.schema.js

@@ -0,0 +1,48 @@
+// src/connection/connection.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var ConnectionStatusEnum = defineEnum("ConnectionStatus", [
+  "PENDING",
+  "CONNECTED",
+  "DISCONNECTED",
+  "ERROR",
+  "EXPIRED"
+]);
+
+// src/connection/connection.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var ConnectionModel = defineSchemaModel({
+  name: "ConnectionModel",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    integrationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: ConnectionStatusEnum, isOptional: false },
+    authType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    externalAccountName: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    },
+    connectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    lastHealthCheck: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    healthStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
+});
+var CreateConnectionInputModel = defineSchemaModel({
+  name: "CreateConnectionInput",
+  fields: {
+    integrationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    authType: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    credentials: { type: ScalarTypeEnum.JSON(), isOptional: true }
+  }
+});
+export {
+  CreateConnectionInputModel,
+  ConnectionModel
+};