@contractspec/example.integration-hub 1.57.0 → 1.58.0

package/dist/node/integration/index.js

@@ -0,0 +1,92 @@
+// src/integration/integration.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var IntegrationStatusEnum = defineEnum("IntegrationStatus", [
+  "DRAFT",
+  "ACTIVE",
+  "PAUSED",
+  "ERROR",
+  "ARCHIVED"
+]);
+
+// src/integration/integration.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var IntegrationModel = defineSchemaModel({
+  name: "IntegrationModel",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    provider: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: IntegrationStatusEnum, isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var CreateIntegrationInputModel = defineSchemaModel({
+  name: "CreateIntegrationInput",
+  fields: {
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    provider: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    config: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    featureFlagKey: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    }
+  }
+});
+
+// src/integration/integration.operations.ts
+import { defineCommand } from "@contractspec/lib.contracts/operations";
+var CreateIntegrationContract = defineCommand({
+  meta: {
+    key: "integration.create",
+    version: "1.0.0",
+    stability: "stable",
+    owners: ["@example.integration-hub"],
+    tags: ["integration", "create"],
+    description: "Create a new integration.",
+    goal: "Allow users to set up integrations with external systems.",
+    context: "Integration setup."
+  },
+  io: { input: CreateIntegrationInputModel, output: IntegrationModel },
+  policy: { auth: "user" },
+  sideEffects: {
+    emits: [
+      {
+        key: "integration.created",
+        version: "1.0.0",
+        when: "Integration created",
+        payload: IntegrationModel
+      }
+    ],
+    audit: ["integration.created"]
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "create-integration-happy-path",
+        given: ["User is admin"],
+        when: ["User defines new integration type"],
+        then: [
+          "Integration definition is created",
+          "IntegrationCreated event is emitted"
+        ]
+      }
+    ],
+    examples: [
+      {
+        key: "create-slack",
+        input: { name: "Slack", category: "communication", authType: "oauth2" },
+        output: { id: "slack", status: "active" }
+      }
+    ]
+  }
+});
+export {
+  IntegrationStatusEnum,
+  IntegrationModel,
+  CreateIntegrationInputModel,
+  CreateIntegrationContract
+};

package/dist/node/integration/integration.enum.js

@@ -0,0 +1,12 @@
+// src/integration/integration.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var IntegrationStatusEnum = defineEnum("IntegrationStatus", [
+  "DRAFT",
+  "ACTIVE",
+  "PAUSED",
+  "ERROR",
+  "ARCHIVED"
+]);
+export {
+  IntegrationStatusEnum
+};

package/dist/node/integration/integration.operations.js

@@ -0,0 +1,89 @@
+// src/integration/integration.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var IntegrationStatusEnum = defineEnum("IntegrationStatus", [
+  "DRAFT",
+  "ACTIVE",
+  "PAUSED",
+  "ERROR",
+  "ARCHIVED"
+]);
+
+// src/integration/integration.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var IntegrationModel = defineSchemaModel({
+  name: "IntegrationModel",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    provider: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: IntegrationStatusEnum, isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var CreateIntegrationInputModel = defineSchemaModel({
+  name: "CreateIntegrationInput",
+  fields: {
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    provider: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    config: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    featureFlagKey: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    }
+  }
+});
+
+// src/integration/integration.operations.ts
+import { defineCommand } from "@contractspec/lib.contracts/operations";
+var CreateIntegrationContract = defineCommand({
+  meta: {
+    key: "integration.create",
+    version: "1.0.0",
+    stability: "stable",
+    owners: ["@example.integration-hub"],
+    tags: ["integration", "create"],
+    description: "Create a new integration.",
+    goal: "Allow users to set up integrations with external systems.",
+    context: "Integration setup."
+  },
+  io: { input: CreateIntegrationInputModel, output: IntegrationModel },
+  policy: { auth: "user" },
+  sideEffects: {
+    emits: [
+      {
+        key: "integration.created",
+        version: "1.0.0",
+        when: "Integration created",
+        payload: IntegrationModel
+      }
+    ],
+    audit: ["integration.created"]
+  },
+  acceptance: {
+    scenarios: [
+      {
+        key: "create-integration-happy-path",
+        given: ["User is admin"],
+        when: ["User defines new integration type"],
+        then: [
+          "Integration definition is created",
+          "IntegrationCreated event is emitted"
+        ]
+      }
+    ],
+    examples: [
+      {
+        key: "create-slack",
+        input: { name: "Slack", category: "communication", authType: "oauth2" },
+        output: { id: "slack", status: "active" }
+      }
+    ]
+  }
+});
+export {
+  CreateIntegrationContract
+};

package/dist/node/integration/integration.presentation.js

@@ -0,0 +1,117 @@
+// src/integration/integration.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var IntegrationStatusEnum = defineEnum("IntegrationStatus", [
+  "DRAFT",
+  "ACTIVE",
+  "PAUSED",
+  "ERROR",
+  "ARCHIVED"
+]);
+
+// src/integration/integration.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var IntegrationModel = defineSchemaModel({
+  name: "IntegrationModel",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    provider: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: IntegrationStatusEnum, isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var CreateIntegrationInputModel = defineSchemaModel({
+  name: "CreateIntegrationInput",
+  fields: {
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    provider: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    config: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    featureFlagKey: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    }
+  }
+});
+
+// src/integration/integration.presentation.ts
+import { definePresentation, StabilityEnum } from "@contractspec/lib.contracts";
+var IntegrationListPresentation = definePresentation({
+  meta: {
+    key: "integration.list",
+    version: "1.0.0",
+    title: "Integration List",
+    description: "List of available integrations",
+    domain: "integration",
+    owners: ["@integration-team"],
+    tags: ["integration", "list"],
+    stability: StabilityEnum.Experimental,
+    goal: "Show users available integrations they can connect to.",
+    context: "The marketplace of integrations within the hub."
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "IntegrationList",
+    props: IntegrationModel
+  },
+  targets: ["react", "markdown"],
+  policy: {
+    flags: ["integration.enabled"]
+  }
+});
+var IntegrationDetailPresentation = definePresentation({
+  meta: {
+    key: "integration.detail",
+    version: "1.0.0",
+    title: "Integration Details",
+    description: "Detailed view of an integration",
+    domain: "integration",
+    owners: ["@integration-team"],
+    tags: ["integration", "detail"],
+    stability: StabilityEnum.Experimental,
+    goal: "Show capabilities and documentation for a specific integration.",
+    context: "Integration showcase and support page."
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "IntegrationDetail",
+    props: IntegrationModel
+  },
+  targets: ["react", "markdown"],
+  policy: {
+    flags: ["integration.enabled"]
+  }
+});
+var IntegrationHealthPresentation = definePresentation({
+  meta: {
+    key: "integration.health",
+    version: "1.0.0",
+    title: "Integration Health",
+    description: "Integration health monitoring dashboard",
+    domain: "integration",
+    owners: ["@integration-team"],
+    tags: ["integration", "health", "monitoring"],
+    stability: StabilityEnum.Experimental,
+    goal: "Monitor connectivity and error rates for active integrations.",
+    context: "Operations dashboard for integration hub health."
+  },
+  source: {
+    type: "component",
+    framework: "react",
+    componentKey: "IntegrationHealth"
+  },
+  targets: ["react", "markdown"],
+  policy: {
+    flags: ["integration.monitoring.enabled"]
+  }
+});
+export {
+  IntegrationListPresentation,
+  IntegrationHealthPresentation,
+  IntegrationDetailPresentation
+};

package/dist/node/integration/integration.schema.js

@@ -0,0 +1,42 @@
+// src/integration/integration.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var IntegrationStatusEnum = defineEnum("IntegrationStatus", [
+  "DRAFT",
+  "ACTIVE",
+  "PAUSED",
+  "ERROR",
+  "ARCHIVED"
+]);
+
+// src/integration/integration.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var IntegrationModel = defineSchemaModel({
+  name: "IntegrationModel",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    slug: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    provider: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: IntegrationStatusEnum, isOptional: false },
+    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false }
+  }
+});
+var CreateIntegrationInputModel = defineSchemaModel({
+  name: "CreateIntegrationInput",
+  fields: {
+    name: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    slug: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    provider: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },
+    config: { type: ScalarTypeEnum.JSON(), isOptional: true },
+    featureFlagKey: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true
+    }
+  }
+});
+export {
+  IntegrationModel,
+  CreateIntegrationInputModel
+};

package/dist/node/integration-hub.capability.js

@@ -0,0 +1,40 @@
+// src/integration-hub.capability.ts
+import { defineCapability, StabilityEnum } from "@contractspec/lib.contracts";
+var IntegrationCapability = defineCapability({
+  meta: {
+    key: "integration",
+    version: "1.0.0",
+    kind: "integration",
+    stability: StabilityEnum.Experimental,
+    description: "Third-party integration connections",
+    owners: ["platform.core"],
+    tags: ["integration", "connections"]
+  }
+});
+var SyncCapability = defineCapability({
+  meta: {
+    key: "sync",
+    version: "1.0.0",
+    kind: "api",
+    stability: StabilityEnum.Experimental,
+    description: "Data synchronization between systems",
+    owners: ["platform.core"],
+    tags: ["sync", "data"]
+  }
+});
+var EtlCapability = defineCapability({
+  meta: {
+    key: "etl",
+    version: "1.0.0",
+    kind: "api",
+    stability: StabilityEnum.Experimental,
+    description: "Extract, transform, load data pipelines",
+    owners: ["platform.core"],
+    tags: ["etl", "data", "pipeline"]
+  }
+});
+export {
+  SyncCapability,
+  IntegrationCapability,
+  EtlCapability
+};

package/dist/node/integration-hub.feature.js

@@ -0,0 +1,114 @@
+// src/integration-hub.feature.ts
+import { defineFeature } from "@contractspec/lib.contracts";
+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" }
+    ]
+  }
+});
+export {
+  IntegrationHubFeature
+};

package/dist/node/seeders/index.js

@@ -0,0 +1,60 @@
+// src/seeders/index.ts
+async function seedIntegrationHub(params) {
+  const { projectId, db } = params;
+  const existing = await db.query(`SELECT COUNT(*) as count FROM integration WHERE "projectId" = $1`, [projectId]);
+  if (existing.rows[0]?.count > 0)
+    return;
+  await db.execute(`INSERT INTO integration (id, "projectId", "organizationId", name, description, type, status)
+     VALUES ($1, $2, $3, $4, $5, $6, $7)`, [
+    "int_1",
+    projectId,
+    "org_demo",
+    "Salesforce",
+    "Salesforce CRM integration",
+    "CRM",
+    "ACTIVE"
+  ]);
+  await db.execute(`INSERT INTO integration (id, "projectId", "organizationId", name, description, type, status)
+     VALUES ($1, $2, $3, $4, $5, $6, $7)`, [
+    "int_2",
+    projectId,
+    "org_demo",
+    "Meeting Recorder",
+    "Meeting recorder transcripts and metadata",
+    "DATA",
+    "ACTIVE"
+  ]);
+  await db.execute(`INSERT INTO integration (id, "projectId", "organizationId", name, description, type, status)
+     VALUES ($1, $2, $3, $4, $5, $6, $7)`, [
+    "int_3",
+    projectId,
+    "org_demo",
+    "Gradium Voice",
+    "Gradium low-latency text-to-speech integration",
+    "COMMUNICATION",
+    "ACTIVE"
+  ]);
+  await db.execute(`INSERT INTO integration (id, "projectId", "organizationId", name, description, type, status)
+     VALUES ($1, $2, $3, $4, $5, $6, $7)`, [
+    "int_4",
+    projectId,
+    "org_demo",
+    "Fal Chatterbox Voice",
+    "Fal Chatterbox text-to-speech integration",
+    "COMMUNICATION",
+    "ACTIVE"
+  ]);
+  await db.execute(`INSERT INTO integration (id, "projectId", "organizationId", name, description, type, status)
+     VALUES ($1, $2, $3, $4, $5, $6, $7)`, [
+    "int_5",
+    projectId,
+    "org_demo",
+    "PostHog Analytics",
+    "Product analytics and event capture",
+    "ANALYTICS",
+    "ACTIVE"
+  ]);
+}
+export {
+  seedIntegrationHub
+};