Skip to content
DomainKit
Esc
navigateopen⌘Jpreview
On this page

Verification

Observe provider and public-DNS evidence for each required record without collapsing propagation or product readiness into a single boolean.

Verification.Status requests fresh observations through the host transport and presents provider readback separately from public DNS.

import { Verification } from "@domainkit/react";

export function DnsVerification({ connection, domain, records }) {
  return (
    <Verification.Status config={{ connection, domain, records }} />
  );
}

Installation

npm install @domainkit/react domainkit effect @effect/atom-react react react-dom
pnpm add @domainkit/react domainkit effect @effect/atom-react react react-dom
yarn add @domainkit/react domainkit effect @effect/atom-react react react-dom
bun add @domainkit/react domainkit effect @effect/atom-react react react-dom

For model-free status and asynchronous-state primitives, use the registry:

npx shadcn@latest add https://domain-kit.dev/r/dns-status.json https://domain-kit.dev/r/async-state.json
pnpm dlx shadcn@latest add https://domain-kit.dev/r/dns-status.json https://domain-kit.dev/r/async-state.json
yarn dlx shadcn@latest add https://domain-kit.dev/r/dns-status.json https://domain-kit.dev/r/async-state.json
bunx shadcn@latest add https://domain-kit.dev/r/dns-status.json https://domain-kit.dev/r/async-state.json

Those copied components are presentation-only. They do not call the DomainKit transport or interpret observation evidence.

Observation states

State Meaning
Idle No observation has been requested in this mounted controller.
Observing The host is reading provider and public-DNS evidence.
Observation Tagged evidence is available for the requested records.
Failed Observation failed; previous evidence may still be shown.

Found, Missing, Mismatch, and provider failures are evidence about individual records. Your application decides whether that evidence makes the product feature ready.

Usage

Include the connected provider context when available. Without it, the host can still perform public DNS observation according to its transport implementation.

<Verification.Status config={{ connection, domain, records }} />

Accessibility

The observe action exposes its busy state and prevents duplicate requests. Keep evidence notes and failure messages visible; color alone cannot distinguish missing, mismatched, or unavailable DNS.

API reference

Verification.Status

PropType
configVerification.ObserveConfig

Observation inputs used by the status controller.

TypeVerification.ObserveConfig

Verification.ObserveConfig

PropType
connection?Transport.Connected

Optional connected attachment used for provider-side observation.

TypeTransport.Connected
domainstring

Customer domain whose records are observed.

Typestring
recordsReadonlyArray<Transport.DnsRecord>

DNS records to compare against provider and public-DNS evidence.

TypeReadonlyArray<Transport.DnsRecord>
sources?{ provider?: boolean; publicDns?: boolean }

Select observation sources; provider follows connection presence and public DNS defaults to true.

Type{ provider?: boolean; publicDns?: boolean }

Verification.ObserveAction

PropType
controllerVerification.Controller

Controller whose observe command the action invokes.

TypeVerification.Controller

Read Provider evidence and public DNS for the observation model.

Was this page helpful?