{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-integration-events",
  "id": "integration-events",
  "kind": "pattern",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-execution-core",
    "json": "https://banes-lab.com/json/records/layer/execution-core",
    "label": "Execution Core",
    "markdown": "https://banes-lab.com/records/layer/execution-core.md",
    "ref": "layer:execution-core"
  },
  "name": "Integration Events",
  "ref": "architecture:integration-events",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-message-contract",
          "json": "https://banes-lab.com/json/records/lexicon/message-contract",
          "label": "Message Contract",
          "markdown": "https://banes-lab.com/records/lexicon/message-contract.md",
          "ref": "lexicon:message-contract"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-versioning",
          "json": "https://banes-lab.com/json/records/architecture/versioning",
          "label": "Versioning",
          "markdown": "https://banes-lab.com/records/architecture/versioning.md",
          "ref": "architecture:versioning"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-interoperability",
          "json": "https://banes-lab.com/json/records/architecture/interoperability",
          "label": "Interoperability",
          "markdown": "https://banes-lab.com/records/architecture/interoperability.md",
          "ref": "architecture:interoperability"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-cross-service-communication",
          "json": "https://banes-lab.com/json/records/lexicon/cross-service-communication",
          "label": "Cross-Service Communication",
          "markdown": "https://banes-lab.com/records/lexicon/cross-service-communication.md",
          "ref": "lexicon:cross-service-communication"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-internal-domain-event-leakage",
          "json": "https://banes-lab.com/json/records/lexicon/internal-domain-event-leakage",
          "label": "Internal Domain Event Leakage",
          "markdown": "https://banes-lab.com/records/lexicon/internal-domain-event-leakage.md",
          "ref": "lexicon:internal-domain-event-leakage"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-duplication-with-domain-events",
          "json": "https://banes-lab.com/json/records/lexicon/duplication-with-domain-events",
          "label": "Duplication with Domain Events",
          "markdown": "https://banes-lab.com/records/lexicon/duplication-with-domain-events.md",
          "ref": "lexicon:duplication-with-domain-events"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-duplication-with-domain-events-integration-events",
          "json": "https://banes-lab.com/json/records/tension/duplication-with-domain-events-integration-events",
          "label": "Integration Events / Duplication with Domain Events",
          "markdown": "https://banes-lab.com/records/tension/duplication-with-domain-events-integration-events.md",
          "ref": "tension:duplication-with-domain-events-integration-events"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-internal-domain-event-leakage",
          "json": "https://banes-lab.com/json/records/lexicon/internal-domain-event-leakage",
          "label": "Internal Domain Event Leakage",
          "markdown": "https://banes-lab.com/records/lexicon/internal-domain-event-leakage.md",
          "ref": "lexicon:internal-domain-event-leakage"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-recommended",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-recommended",
          "label": "recommended",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-recommended.md",
          "ref": "vocabulary:severity-recommended"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-event-messaging-asynchronous-architecture",
          "json": "https://banes-lab.com/json/records/architecture-category/event-messaging-asynchronous-architecture",
          "label": "Event / Messaging / Asynchronous Architecture",
          "markdown": "https://banes-lab.com/records/architecture-category/event-messaging-asynchronous-architecture.md",
          "ref": "architecture-category:event-messaging-asynchronous-architecture"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-contracts-interfaces-compatibility",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-contracts-interfaces-compatibility",
          "label": "Contracts / Interfaces / Compatibility",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-contracts-interfaces-compatibility.md",
          "ref": "chapter:/ontology#architecture-category-contracts-interfaces-compatibility"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-core-vocabulary",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-core-vocabulary",
          "label": "Core Vocabulary",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-core-vocabulary.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-core-vocabulary"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-event-messaging-async",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-event-messaging-async",
          "label": "Event Messaging Async",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-event-messaging-async.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-event-messaging-async"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "A design pattern that publishes a versioned public event, mapped from an internal domain event, for consumers outside the service.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-asynchronous-communication",
      "json": "https://banes-lab.com/json/records/architecture/asynchronous-communication",
      "label": "Asynchronous Communication",
      "markdown": "https://banes-lab.com/records/architecture/asynchronous-communication.md",
      "ref": "architecture:asynchronous-communication"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-domain-events",
      "json": "https://banes-lab.com/json/records/architecture/domain-events",
      "label": "Domain Events",
      "markdown": "https://banes-lab.com/records/architecture/domain-events.md",
      "ref": "architecture:domain-events"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [],
  "exemplar": {
    "after": "const integrationEvent: FooCreatedV1 = {\n  type: \"com.example.foo-created.v1\",\n  fooId: event.fooId,\n  occurredAt: clock.now().toISOString(),\n};\nintegrationBus.publish(integrationEvent);",
    "before": "barService.consume(fooDomainEvent);",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "service boundary",
    "messaging"
  ],
  "severity": "recommended"
}