Skip to content

docs: in-process transport guide and API reference#34

Open
intech wants to merge 4 commits into
mainfrom
feature/in-process-transport
Open

docs: in-process transport guide and API reference#34
intech wants to merge 4 commits into
mainfrom
feature/in-process-transport

Conversation

@intech

@intech intech commented May 16, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the new in-process transport in @connectum/core and regenerates the
TypeDoc-driven API reference to cover the added surface.

  • New guide: en/guide/production/in-process-transport.md — rationale, when to use it, registry-based auto-routing, parity guarantees, and the OTEL connectum.transport attribute.
  • Updated package pages: en/packages/core.md (new client/localClient/hasService APIs), en/packages/otel.md (new attribute / metric label).
  • Architecture page: en/guide/production/architecture.md updated to show the in-process transport as a first-class peer of the HTTP/2 transport.
  • Contributing: en/contributing/parity-invariant.md (the structural-diff invariant the parity-gate CI workflow enforces) and en/contributing/parity-coverage.md (matrix of covered scenarios).
  • API reference: regenerated TypeDoc output under en/api/ — adds createLocalTransport, LOCAL_TRANSPORT_HEADER/VALUE, ServerClientOptions, ATTR_CONNECTUM_TRANSPORT, detectConnectumTransport, the new @connectum/test-fixtures package, and parity utilities under @connectum/testing.

Test plan

  • pnpm docs:build — green (no dead links, sitemap generated)
  • All cross-links between guide / packages / contributing pages resolve

Related

Companion to the framework PR adding the in-process transport. The branch also contains the pnpm 11 migration commits.

🤖 Generated with Claude Code

intech and others added 4 commits May 5, 2026 00:49
Migrate package manager from pnpm 10.23.0 to pnpm 11.0.4 (stable).

Changes:
- package.json: bump packageManager; remove pnpm field (pnpm 11 no
  longer reads it from package.json)
- pnpm-workspace.yaml (new): move overrides (3 rules: lodash-es, rollup,
  minimatch) and replace onlyBuiltDependencies with allowBuilds map
  (esbuild)
- pnpm-lock.yaml: regenerate under pnpm 11 (lockfileVersion 9.0 retained)

Tested locally:
- pnpm install: clean, no warnings
- pnpm docs:build: VitePress build complete (109s, all API md files
  processed)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Side-effect of running gen-api-docs.sh during pnpm 11 migration smoke
tests. TypeDoc output normalized to current source state across all 13
@connectum/* packages.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Mirror the integrity-pinned packageManager value from connectum
(PR #111) for consistency across the framework's repos. SHA512 hex
digest sourced from npm registry metadata for the pnpm@11.0.4 tarball.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- guide: en/guide/production/in-process-transport.md (rationale, usage, parity guarantees)
- update: en/packages/core.md, en/packages/otel.md, en/guide/production/architecture.md
- contributing: en/contributing/parity-invariant.md, en/contributing/parity-coverage.md
- API reference regenerated via TypeDoc (covers new createLocalTransport, server.client,
  connectum.transport OTEL attribute, and new @connectum/test-fixtures package surface)
@intech intech self-assigned this May 17, 2026
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.

1 participant