---
id: TST-PFM-INT-623
title: Integration event declarations
kind: unit
product_area: platform
module: integrations
revision: 1
status: draft
source_sha:
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
  macroservice-libraries: 54536a441935c6e09fdb7f96f0bec71c52ba4e03
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
repository: macroservice-libraries
files:
  - packages/integration-contracts/src/events.spec.ts
implements: []
environment: mock
implementation_state: implemented
latest_result: not-run
latest_run_at: null
latest_run_ref: null
conformance: not-verified
estimated_minutes: 1
isolation: 'The test process owns its inputs, fake clocks and any replaced runtime ports.'
test_cases:
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/events.spec.ts#has a data schema for
      every integration event type, and a type for every schema
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/events.spec.ts#has a projection schema
      for every domain event type, and a type for every schema
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/events.spec.ts#carries a previous image
      exactly when the domain event type includes changes
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/events.spec.ts#projects no sys_* column,
      no actor and no security context
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/events.spec.ts#validates an integration
      event, envelope and data, and refuses an unknown type or a malformed data
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/events.spec.ts#validates a domain-event
      delivery against its projection
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/events.spec.ts#adds the extensibility
      framework's ten business events (0.4.0) with the proposal's fields, required ones and source
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/events.spec.ts#adds the custom objects'
      and Committees' business events (0.5.0) with their owners' fields, every one required
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/events.spec.ts#takes null where an owner
      declared a field nullable, and refuses a missing one
  - provenance: test
    source: >-
      macroservice-libraries:packages/integration-contracts/src/events.spec.ts#validates a delivery of a
      0.4.0 business event, and refuses a buyer of an unknown kind
evidence:
  - 'macroservice-libraries:packages/integration-contracts/src/events.spec.ts'
---
# Integration event declarations

## Verification Boundary

This unit suite exercises integration event declarations within the shared package. It records engineering coverage at the pinned revision without claiming a deployed run.

## What This Suite Proves

The source assertions cover the package behavior under controlled inputs. No detailed capability or feature scenario binding is verified in this registration.

## What It Does Not Prove

The suite does not establish deployed authorization, database behavior, provider effects or a complete customer workflow.

## Real Dependencies and Test Doubles

Imported package functions execute against the source-defined fixtures. Runtime ports, clocks and external transport responses remain controlled wherever the suite replaces them.

## Must Not Be Doubled

The shared function under test and its result assertions must execute. Returning an expected answer from a substitute does not prove the package behavior.