Skip to content

[epic] Framework Integrations (beta) - #81

Open
arpit-bruno wants to merge 31 commits into
release/integrations-0.1.0from
epic/framework-integrations-beta
Open

arpit-bruno wants to merge 31 commits into
release/integrations-0.1.0from
epic/framework-integrations-beta

Conversation

@arpit-bruno

@arpit-bruno arpit-bruno commented Sep 14, 2026

Copy link
Copy Markdown
Collaborator

This adds the framework integrations for the beta: a Node core and wrappers for Express, Fastify and NestJS. One line and a Bruno collection is served as API docs from the same process, behind whatever auth the app already has.

Everything lives under integrations/. Self-contained with its own lockfile and with its lint config and Node versioned pinned.

What is in here

  • core: walks the collection, filters environments and tags on the server by whole file, serves the page, shell.js and collection.yml. A broken setup fails at the mount and not at boot.
  • express, fastify, nestjs: thin wrappers with no logic of their own. embed( ) for a block inside your own page.
  • examples for each framework: quickstart, auth, csp, embed and for NestJS also global prefix and the fastify adapter.

Tests

  • unit tests for the core
  • a contract suite run over HTTP against every framework
  • every example is booted and checked
  • browser tests against the live renderer
  • a matrix: every framework major on Node 22 and 24, installed from the packed tarballs. Label run-integrations-matrix-tests to run it on a PR and the result table lands as a comment.

@changeset-bot

changeset-bot Bot commented Sep 14, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 6bb450b

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@arpit-bruno arpit-bruno added the run-integrations-matrix-tests run the full framework x node matrix on this PR label Sep 21, 2026
@arpit-bruno
arpit-bruno marked this pull request as ready for review September 21, 2026 05:39
@github-actions

github-actions Bot commented Sep 21, 2026

Copy link
Copy Markdown

Integrations matrix

cell node 20 node 22 node 24
express@4 ✓ 122 ✓ 122 ✓ 122
express@5 ✓ 122 ✓ 122 ✓ 122
fastify@4 ✓ 119 ✓ 119 ✓ 119
fastify@5 ✓ 119 ✓ 119 ✓ 119
nestjs@10 (platform-express) ✓ 117 ✓ 117 ✓ 117
nestjs@10 (platform-fastify) ✓ 117 ✓ 117 ✓ 117
nestjs@11 (platform-express) ✓ 117 ✓ 117 ✓ 117
nestjs@11 (platform-fastify) ✓ 117 ✓ 117 ✓ 117
nestjs@12 (platform-express) ✓ 117 ✓ 117 ✓ 117
nestjs@12 (platform-fastify) ✓ 117 ✓ 117 ✓ 117

30 suites green across node 20, 22, 24 · 3552 assertions

0c5b7b3 · node 20 is informational

Comment thread integrations/nodejs/core/test/collection.test.mjs
Comment thread integrations/nodejs/nestjs/src/index.ts Outdated
Comment thread integrations/nodejs/nestjs/test/sub-path.test.mjs
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

run-integrations-matrix-tests run the full framework x node matrix on this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants