Identus integration suite

This repository aggregates the result of end-to-end test between the new components and stable components.

Usage

npm ci
npx tsx cli --component {component} --runner {runner}

Components

Identus components are:

• cloud-agent
• mediator
• sdk-ts
• sdk-kmp
• sdk-swift

Runners

The runners are the SDKs themselves, which runs the end-to-end tests in order to guarantee the platform compatibility.

• sdk-ts
• sdk-kmp
• sdk-swift

Component testing matrix

The following table describes the artifact versioning and testing for the integration

component	cloud-agent	mediator	sdk-ts	sdk-kmp	sdk-swift
cloud-agent	main	release	release	release	release
mediator	release	main	release	release	release
sdk-ts	release	release	main	-	-
sdk-kmp	release	release	-	main	-
sdk-swift	release	release	-	-	main

• main: latest changes
• release: latest stable version

Cronjob testing

In order to test all latest components there's a weekly job.

environment	cloud-agent	mediator	sdk-ts	sdk-kmp	sdk-swift
weekly	main	main	main	main	main

Breaking change flow

When there's an expected breaking change the components will have to be compatible before making a final release. That means the latest test should be green.

Integration

Service integration

sequenceDiagram
    participant service
    participant ci
    participant runners
    service->>ci: version
    Note over ci: start services<br>using new service version
    ci->>runners: run sdk-ts
    ci->>runners: run sdk-kmp
    ci->>runners: run sdk-swift
    runners-->>ci: results
    ci-->>ci: notify slack
    ci-->>ci: update service report on gh pages

Loading

Library integration

sequenceDiagram
    participant library
    participant ci

    library->>ci: notify change
    Note over ci: start released service<br>build library
    ci->>library: run test
    library-->>ci: results
    ci-->>ci: notify slack
    ci-->>ci: update library report on gh pages

Loading

Automatic integration

This event is dispatched when there's a new commit on main branch.

{
    "component": "<component>",
    "version": "<version>"
}

Component should be of of the list and version for services should've been published or a tag/branch for libraries.