Testing Components

Components have three tiers of testing: local validation, doctor diagnostics, and end-to-end verification.

Local Validation

Before installing, validate the manifest offline:

wh component validate ./my-component

This checks:

1. Schema validation — component.json and manifest.json structure
2. Cross-reference validation — subscriptions reference existing credential sets, seeds reference declared or built-in shapes, and CLI methods reference existing credential sets
3. ID format validation — reverse-DNS format check
4. Consistency check — component.json id/name must match manifest.json component section

Validation does not read or check any action references or action file paths — the manifest format has no actions section.

Install for Testing

Components install by identity, so register the manifest, then install by <org>/<name> against a test repo:

wh component register my-component --org org --manifest ./my-component/warmhub/manifest.json
wh component install org/my-component --repo org/test-repo

Note

Components install by registered identity or bundled system id. After editing the manifest, bump component.version (re-publishing requires a strictly-greater semver), re-publish with wh component registry update <org/name> --manifest <path>, and re-run wh component update <name> (or reinstall) to pick up the change.

Doctor Diagnostics

After install, run doctor to verify all declared resources exist:

wh component doctor my-component --repo org/test-repo

Doctor checks:

• Shapes — exist and are active
• Subscriptions — exist and are active
• Credential sets — exist with all required keys populated

Doctor operates on the installed manifest snapshot. It does not compare against the source or auto-remediate. If resources are missing, reinstall or create them manually.

End-to-End Testing

The full verification path:

1. Install the Component

# Register the manifest, then install by identity
wh component register my-component --org org --manifest ./my-component/warmhub/manifest.json
wh component install org/my-component --repo org/test-repo

2. Bind Credentials

wh credential set my-creds api_key --value "sk-..." --repo org/test-repo

3. Verify Doctor

wh component doctor my-component --repo org/test-repo
# Should report "ready"

4. Trigger the Action

For event-driven subscriptions, create a thing on the trigger shape:

wh commit submit --repo org/test-repo \
  --ops '[{"operation":"add","kind":"thing","name":"Echo/test-1","data":{"message":"hello","tags":["test"]}}]'

5. Verify Output

Check that the expected output things were created:

wh thing query --shape EchoResult --repo org/test-repo

Check subscription delivery logs:

wh sub log se/echo-handler --repo org/test-repo

Update Test

After install passes, verify the update path picks up manifest changes:

# Bump component.version in the manifest (re-publish requires a higher semver),
# then re-publish to the registry
wh component registry update org/my-component --manifest ./my-component/warmhub/manifest.json

# Pull the latest published manifest into the install
wh component update my-component --repo org/test-repo

# Run doctor again
wh component doctor my-component --repo org/test-repo