open-matrix

Repositories

1

Projects Packages

@open-matrix/federation (0.2.14)

Published 2026-09-22 02:11:01 +00:00 by hivecast-admin

Installation

Setup this registry in your project .npmrc file:

@open-matrix:registry=

To install the package using npm, run the following command:

npm install @open-matrix/federation@0.2.14

or add it to the package.json file:

"@open-matrix/federation": "0.2.14"

For more information on the npm registry, see the documentation.

About this package

@open-matrix/federation

Matrix federation layer for cross-realm messaging with:

• Tolerant MXURI parsing (legacy compact + segmented /-/ form)
• Dual mailbox namespaces (Strangler Fig)
  • legacy: public.ingress.<realm> (Matrix-3 compatibility)
  • mx ingress: mx/in/1/<realm>/<shard> (MXINGRESS/1)
• Dual envelope profiles (Strategy)
  • legacy: Matrix-3 request/reply envelopes
  • mxenv1: MXENV/1 envelopes (Cmd|Evt|Result|Sub|Unsub|Nack)
• Edge gateway bridging mailbox messages ↔ internal bus (mx/1/<realm>/<toPath>)
• Federation subscription leasing (streaming Evt forwarding)
• Session directory (principal → active tab realms) for unsolicited push
• Hierarchical routing overlay (MXROUTE-style route inbox forwarding)
• Pluggable transport with in-memory brokers for deterministic tests

No external npm dependencies are required to run unit + integration tests.

Run

npm test

Read the full design

Start with DESIGN.md.

Code map

• Encoding + routing primitives

  • src/uri.ts — tolerant MXURI parsing + canonicalization
  • src/topics.ts — mailbox topics + internal topics + route inbox topics
  • src/envelope.ts + src/envelope_codec.ts — legacy + MXENV/1 envelopes, tolerant decoding, profile-specific encoding

• Transports

  • src/transport/base.ts — transport port
  • src/transport/inmem.ts — in-memory exact-match broker + wildcard-filter broker

• Runtime components

  • src/runtime/edge_gateway.ts — mailbox ↔ internal bus bridge
  • src/runtime/component_host.ts — helper for registering internal "accepts" handlers
  • src/runtime/federation.ts — subscription leases + Evt forwarding
  • src/runtime/directory.ts — session directory + protocol facade
  • src/runtime/router.ts — hierarchical routing overlay bridge
  • src/runtime/discovery.ts + src/runtime/resolved_client.ts — endpoint resolution + fallback client

• Security building blocks

  • src/security/* — replay cache, rate limiter, policy hooks, principal derivation

• Tests

  • tests/unit/* — codecs and matching
  • tests/integration/* — end-to-end request/reply, subscriptions, directory push, discovery fallback, routing overlay, security

Legacy fixture typecheck quarantine (R7)

pnpm build:tests compiles the current test surface. The 18 files explicitly listed in tsconfig.legacy-tests.json are excluded from that compilation and from the production reference graph. pnpm type-check:legacy reproduces their 180 baseline diagnostics (2026-09-09): required root fields, obsolete nats endpoint kinds, and removed dualRail. Runtime unit/integration test selections are unchanged; this quarantine is not a runtime-test pass claim.

TODO — sdk/federation owner: migrate each named fixture to the current contracts, pass its typecheck, then remove its explicit exclusion from tsconfig.tests.json and its entry in the legacy config.

Dependencies

Development Dependencies

ID	Version
@types/node	^25.0.10
tsx	4.15.6
typescript	^5.6.3

Details

npm

2026-09-22 02:11:01 +00:00

2

UNLICENSED

56 KiB

Assets (1)

federation-0.2.14.tgz 56 KiB

Versions (15) View all

1.1.33 2026-10-24

1.1.32 2026-10-24

1.1.2 2026-09-22

1.1.1 2026-09-22

0.2.14 2026-09-22