adapter_sdk

Ecosystem adapter SDK contracts and reference adapters for M41.

Types

AdapterContract

One adapter contract.

pub type AdapterContract {
  AdapterContract(
    name: String,
    boundary: Boundary,
    provider_module: String,
    sdk_version: Semver,
    adapter_version: Semver,
    capabilities: List(Capability),
    verification_steps: List(VerificationStep),
    support_tier: String,
    migration_guide: String,
  )
}

Constructors

AdapterContract(
  name: String,
  boundary: Boundary,
  provider_module: String,
  sdk_version: Semver,
  adapter_version: Semver,
  capabilities: List(Capability),
  verification_steps: List(VerificationStep),
  support_tier: String,
  migration_guide: String,
)

Boundary

Adapter boundary class.

pub type Boundary {
  DatabaseSource
  ObjectStoreSource
  QueueSource
  BillingService
  IdentityService
}

Constructors

```
DatabaseSource
```
```
ObjectStoreSource
```
```
QueueSource
```
```
BillingService
```
```
IdentityService
```

Capability

Adapter capability contract.

pub type Capability {
  PullBatch
  PushBatch
  AckCheckpoint
  ReplayCheckpoint
  IdempotentWrites
  WebhookVerification
  TenantScopedAuth
  HealthProbe
}

Constructors

```
PullBatch
```
```
PushBatch
```
```
AckCheckpoint
```
```
ReplayCheckpoint
```
```
IdempotentWrites
```
```
WebhookVerification
```
```
TenantScopedAuth
```
```
HealthProbe
```

CompatibilityPolicy

Compatibility guarantees for adapter boundaries.

pub type CompatibilityPolicy {
  CompatibilityPolicy(
    sdk_major: Int,
    adapter_major: Int,
    min_adapter_minor: Int,
    max_adapter_minor: Int,
    deprecation_window_days: Int,
  )
}

Constructors

CompatibilityPolicy(
  sdk_major: Int,
  adapter_major: Int,
  min_adapter_minor: Int,
  max_adapter_minor: Int,
  deprecation_window_days: Int,
)

Semver

Stable SDK semantic version.

pub type Semver {
  Semver(major: Int, minor: Int, patch: Int)
}

Constructors

Semver(major: Int, minor: Int, patch: Int)

VerificationStep

Verification step for developer/operator integration checks.

pub type VerificationStep {
  VerificationStep(
    id: String,
    instruction: String,
    expected_evidence: String,
  )
}

Constructors

VerificationStep(
  id: String,
  instruction: String,
  expected_evidence: String,
)

Values

adapter_signature

pub fn adapter_signature(adapter: AdapterContract) -> String

Stable adapter signature.

billing_service_adapter

pub fn billing_service_adapter() -> AdapterContract

Reference adapter: billing service.

boundary

pub fn boundary(adapter: AdapterContract) -> Boundary

Adapter boundary accessor.

boundary_label

pub fn boundary_label(boundary: Boundary) -> String

Stable boundary label.

capabilities

pub fn capabilities(adapter: AdapterContract) -> List(Capability)

Adapter capability accessor.

capability_label

pub fn capability_label(capability: Capability) -> String

Stable capability label.

compatibility_policy

pub fn compatibility_policy() -> CompatibilityPolicy

Current adapter compatibility policy.

compatibility_policy_label

pub fn compatibility_policy_label(
  policy: CompatibilityPolicy,
) -> String

Stable compatibility policy label.

compatibility_signature

pub fn compatibility_signature(
  policy: CompatibilityPolicy,
) -> String

Stable compatibility signature across all reference adapters.

compatible

pub fn compatible(
  adapter: AdapterContract,
  policy: CompatibilityPolicy,
) -> Bool

Validate adapter compatibility against one policy.

identity_service_adapter

pub fn identity_service_adapter() -> AdapterContract

Reference adapter: identity provider.

name

pub fn name(adapter: AdapterContract) -> String

Adapter name accessor.

object_store_source_adapter

pub fn object_store_source_adapter() -> AdapterContract

Reference adapter: object-store batch source.

postgres_cdc_source_adapter

pub fn postgres_cdc_source_adapter() -> AdapterContract

Reference adapter: Postgres CDC source.

queue_source_adapter

pub fn queue_source_adapter() -> AdapterContract

Reference adapter: queue source.

reference_adapters

pub fn reference_adapters() -> List(AdapterContract)

Reference M41 adapters.

reference_adapters_compatible

pub fn reference_adapters_compatible(
  policy: CompatibilityPolicy,
) -> Bool

Validate all reference adapters against one policy.

sdk_version

pub fn sdk_version() -> Semver

Current stable SDK version.

semver_label

pub fn semver_label(version: Semver) -> String

Stable semver label.

valid

pub fn valid(adapter: AdapterContract) -> Bool

Validate one adapter contract.

verification_signature

pub fn verification_signature(
  steps: List(VerificationStep),
) -> String

Stable verification signature.

verification_step_signature

pub fn verification_step_signature(
  step: VerificationStep,
) -> String

Stable verification step signature.

verification_steps

pub fn verification_steps(
  adapter: AdapterContract,
) -> List(VerificationStep)

Adapter verification steps accessor.