Skip to content

docs: Documentation and Testing Improvements fixing #387#392

Closed
NiKrause wants to merge 0 commit intostoracha:mainfrom
NiKrause:main
Closed

docs: Documentation and Testing Improvements fixing #387#392
NiKrause wants to merge 0 commit intostoracha:mainfrom
NiKrause:main

Conversation

@NiKrause
Copy link
Contributor

README Overhaul
• Rewrote the README with a focus on consuming UCAN services rather than building them
• Updated example code using latest api
• Structured content: basic usage → delegations → batch operations → advanced patterns
• Added live code links to test files for every example, making docs verifiable
• Enhanced packages/server/README.md with detailed server implementation examples

Test Coverage
• Added new integration tests in packages/server/test/readme-integration.spec.js
• Added new example tests in packages/server/test/readme-examples.spec.js
• All README examples are now automatically tested
• Tests use the recommended server-as-channel pattern

CI/CD Infrastructure
• Added Playwright setup to all GitHub Actions workflows
• Added test status badges for all packages (Core, Principal, Transport, Interface, Server, Client, Validator)
• Improved TypeScript configuration in packages/server/tsconfig.json
• Fixed various test issues and type checking problems
• Updated badge URLs

@NiKrause NiKrause changed the title docs: Documentation and Testing Improvements docs: Documentation and Testing Improvements closing #387 Oct 12, 2025
@NiKrause NiKrause changed the title docs: Documentation and Testing Improvements closing #387 docs: Documentation and Testing Improvements fixing #387 Oct 12, 2025
@Dhruv-Varshney-developer
Copy link
Contributor

Linked to #391 and #388

@NiKrause NiKrause mentioned this pull request Nov 18, 2025
@NiKrause NiKrause closed this Feb 11, 2026
hannahhoward pushed a commit that referenced this pull request Feb 16, 2026
**Addresses @alanshaw recommendations from PR #388**

This branch combines PRs #388 and #392 and addresses all review comments
from @alanshaw.

### Changes

**README updates:**
- Removed mock fetch functions from `@ucanto/client` and
`@ucanto/transport` READMEs
- Updated examples to show real server usage (via environment variables)
- Changed `ed25519.Verifier.parse()` to `DID.parse()` for service DIDs
(as suggested)
- Added notes about using server-as-channel for testing, with links to
server README

**Test improvements:**
- Converted `packages/client/test/client.spec.js` from mock fetch to
server-as-channel pattern
- Tests now validate delegation chains (no bypass)
- Added `@ucanto/server` and `@ucanto/validator` to client
devDependencies

### Benefits

- Examples work with real servers (no mocks)
- Tests properly validate UCAN delegation chains
- Follows recommended patterns from the server package
- All tests passing with 100% coverage maintained

### Related

- Addresses review comments from:
#388
- Should complete work for: #387 (which was respected in #392)

---------

Co-authored-by: Dhruv-Varshney-developer <dhruvvarshney77@gmail.com>
Co-authored-by: ash <alan138@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants